| name | android-compose-reference |
| description | Jetpack Compose 官方示例与最佳实践参考。涵盖 Compose UI 实现、动画、手势、导航、Material3 主题、 性能优化、测试等所有方面。安卓开发第一要义：参考官方文档和案例！ Triggers: "Compose 怎么写", "Compose 动画", "Compose 导航", "Compose 性能", "Compose 主题", "Jetpack Compose sample", "Material3 Compose", "Compose testing", "Compose best practice"
|
Jetpack Compose 官方参考索引
安卓开发第一要义：参考官方文档和案例！
Compose 是现代 Android UI 开发的推荐方式。以下仓库由 Android 团队维护，
是学习 Compose 最佳实践的第一手资料。
📦 核心官方仓库
官方的 Jetpack Compose 示例集合 — Compose 学习首选仓库。
内含多个完整应用示例：
| 示例应用 | 展示内容 |
|---|
| JetNews | 新闻阅读应用 — Compose 基础：列表、导航、主题 |
| Jetchat | 聊天应用 — 高级 Compose：动画、状态提升、自定义布局 |
| JetSnack | 电商应用 — 复杂布局、图片处理、BottomSheet |
| Crane | 旅行应用 — Material3、自定义绘制、MapView 集成 |
| Owl | 教育应用 — 自定义主题、深色模式、复杂排版 |
| Reply | 邮件应用 — 自适应布局（手机/平板/折叠屏）、WindowSizeClass |
关键学习路径：
compose-samples/
├── JetNews/ # 💡 新手入门：基础 Compose
├── Crane/ # 🎨 Material3 + 自定义主题
├── Jetchat/ # 🚀 进阶：动画 + 状态管理
├── Reply/ # 📱 自适应布局
└── Owl/ # 🎭 高级主题定制
生产级 Compose 应用 — 架构参考首选。
展示内容：
- 完整的 Compose + Material3 应用
- 模块化架构（
:core:ui, :feature:*, :core:data 等）
- UDF (Unidirectional Data Flow) 模式
- Gradle 版本目录（Version Catalog）
- 完整的 CI/CD 流程
- Compose 测试（UI 测试 + 截图测试）
架构模式演进 — 理解 Compose 时代的架构。
关键分支：
main：UDF + StateFlow，当前推荐views：经典 View 架构compose：Compose 架构演进
View → Compose 迁移 — 适合从 View 迁移到 Compose 的项目。
展示 View 代码如何逐步迁移到 Compose。
UI 专项示例 — 深入 UI 细节。
关键示例：
WindowInsetsAnimation — 键盘动画、系统栏适配MotionLayout — 复杂交互动画CustomLayout — 自定义 Compose LayoutAccessibility — 无障碍Insets — WindowInsets 处理
🧭 导航 (Navigation)
Navigation3 类型安全导航（推荐）：
@Serializable data class Profile(val id: String)
navController.navigate(Profile(id = "123"))
🎨 Material3 主题
参考仓库：
官方文档：Material Design 3 for Compose
🎬 动画
参考仓库：
Compose 动画 API 层级：
animate*AsState → 简单属性动画（推荐起手）
AnimatedVisibility → 显示/隐藏动画
AnimatedContent → 内容切换动画
Crossfade → 淡入淡出
updateTransition → 多属性协同动画
rememberInfiniteTransition → 无限循环动画
AnimationSpec → 自定义动画曲线（tween, spring, keyframes）
🧪 Compose 测试
参考仓库：testing-samples ⭐9.3k
Compose 测试三件套：
composeTestRule.onNodeWithText("Submit")
composeTestRule.onNodeWithText("Submit").performClick()
composeTestRule.onNodeWithText("Success").assertIsDisplayed()
含截图测试（Screenshot Testing）、语义测试等高级主题。
⚡ Compose 性能
参考仓库：performance-samples ⭐1.4k
关键主题：
- Baseline Profile — 提升 Compose 首帧速度
- Stability 标记 — 使用
@Stable / @Immutable
- 重组优化 — 减少不必要的重组
- 延迟布局 —
LazyColumn / LazyRow 优化
- remember/derivedStateOf — 状态缓存
- Compose Compiler Metrics — 编译期分析
📱 自适应布局
关键 API：
WindowSizeClass — 根据窗口尺寸调整布局BoxWithConstraints — 约束感知布局LocalConfiguration.current — 配置变化响应
🚀 本项目 (Kototoro) Compose 开发工作流
当需要实现 Compose 相关功能时:
1. compose-samples 中搜索相似 UI → 找到参考实现
2. nowinandroid 中搜索架构模式 → 理解状态管理
3. user-interface-samples 中搜索细节 → 手势/Insets/动画
4. 在官方实现基础上适配 → 而非从零开始
禁止：从非官方博客/教程中复制代码而不验证。任何第三方方案都要和官方示例对比。
📚 补充链接
