在线文档：AndroidProject-Compose 在线文档
文档来源：AndroidProject-Compose 文档站
docs/help/收录范围：简介、Core、Navigation、Feature
本目录保存与当前工程配套的本地框架文档，供开发者在 IDE、GitHub 和 AI 编码工具中直接查阅。章节顺序与在线文档保持一致；示例涉及的类型、路径和调用关系应以当前源码为准。
| 开发任务 | 建议阅读顺序 |
|---|---|
| 初次运行项目 | 快速开始 → 环境要求 → 工程组织与模块边界 → 项目架构与职责 |
| 编写主题与通用 UI | 设计系统 → 主题系统 → UI 组件 |
| 编写 Route、Screen 与 Content | Feature 概览 → View 规范 → ViewModel 规范 |
| 接入接口或分页列表 | 数据模型 → 请求结果处理 → 网络请求 → 数据层 → 非分页网络基类或分页列表 |
| 使用数据库、本地存储或全局状态 | 数据层 → Room 数据库、本地存储或全局状态 |
| 配置路由、传参与结果回传 | 导航概览 → 路由配置 → 导航流程 → 登录与路由拦截 → 参数传递与结果回传 |
| 创建完整 Feature 页面 | 目录与命名规范 → View 规范 → ViewModel 规范 → 创建页面流程 → 页面模板 |
| 配置预览与屏幕适配 | 注解 → 数据层的预览数据 → 屏幕适配 → View 预览规范 |
| 使用 AI 工具开发 | AI 辅助开发 → 按任务选择对应的 apc-* Skill → 阅读专项文档并核对源码和测试 |
- Core 核心能力
- 设计系统
- 主题系统
- UI 组件
- 注解
- 屏幕适配
- ViewModel 基类
- 数据模型
- 请求结果处理
- 网络请求
- 数据层
- Room 数据库
- 本地存储
- 全局状态
- 工具类
- 非分页网络基类
- 分页列表
- 修改代码前按任务范围阅读对应章节，再核对真实源码、调用方和测试。
- 文档与源码不一致时，以可运行实现为依据，并同步修正文档站与本地副本。
- 新增、删除或重命名网站章节时，同步更新本目录结构、内部链接和本页索引。
- 项目级高频约束维护在仓库根目录
AGENTS.md，完整概念、流程和示例由本目录统一说明。