Android Compose Reference

Jetpack Compose 官方参考索引

安卓开发第一要义：参考官方文档和案例！

Compose 是现代 Android UI 开发的推荐方式。以下仓库由 Android 团队维护， 是学习 Compose 最佳实践的第一手资料。

📦 核心官方仓库

1. compose-samples ⭐23.2k

官方的 Jetpack Compose 示例集合 — Compose 学习首选仓库。

内含多个完整应用示例：

关键学习路径：

compose-samples/
├── JetNews/       # 💡 新手入门：基础 Compose
├── Crane/         # 🎨 Material3 + 自定义主题
├── Jetchat/       # 🚀 进阶：动画 + 状态管理
├── Reply/         # 📱 自适应布局
└── Owl/           # 🎭 高级主题定制

2. nowinandroid ⭐21.4k

生产级 Compose 应用 — 架构参考首选。

展示内容：

• 完整的 Compose + Material3 应用
• 模块化架构（:core:ui, :feature:*, :core:data 等）
• UDF (Unidirectional Data Flow) 模式
• Gradle 版本目录（Version Catalog）
• 完整的 CI/CD 流程
• Compose 测试（UI 测试 + 截图测试）

3. architecture-samples ⭐45.7k

架构模式演进 — 理解 Compose 时代的架构。

关键分支：

• main：UDF + StateFlow，当前推荐
• views：经典 View 架构
• compose：Compose 架构演进

4. sunflower ⭐17.8k

View → Compose 迁移 — 适合从 View 迁移到 Compose 的项目。

展示 View 代码如何逐步迁移到 Compose。

5. user-interface-samples ⭐4.6k

UI 专项示例 — 深入 UI 细节。

关键示例：

• WindowInsetsAnimation — 键盘动画、系统栏适配
• MotionLayout — 复杂交互动画
• CustomLayout — 自定义 Compose Layout
• Accessibility — 无障碍
• Insets — WindowInsets 处理

🧭 导航 (Navigation)

Navigation3 类型安全导航（推荐）：

// 定义路由（类型安全，无需字符串）
@Serializable data class Profile(val id: String)

// 导航
navController.navigate(Profile(id = "123"))

🎨 Material3 主题

参考仓库：

• compose-samples/Crane — Material3 颜色方案
• compose-samples/Owl — 自定义主题
• nowinandroid — 生产级主题配置

官方文档：Material Design 3 for Compose

🎬 动画

参考仓库：

• compose-samples/Jetchat — 复杂动画
• user-interface-samples — WindowInsetsAnimation

Compose 动画 API 层级：

animate*AsState       → 简单属性动画（推荐起手）
AnimatedVisibility    → 显示/隐藏动画
AnimatedContent       → 内容切换动画
Crossfade            → 淡入淡出
updateTransition      → 多属性协同动画
rememberInfiniteTransition → 无限循环动画
AnimationSpec        → 自定义动画曲线（tween, spring, keyframes）

🧪 Compose 测试

参考仓库：testing-samples ⭐9.3k

Compose 测试三件套：

// 1. 元素查找
composeTestRule.onNodeWithText("Submit")

// 2. 交互
composeTestRule.onNodeWithText("Submit").performClick()

// 3. 断言
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. 在官方实现基础上适配 → 而非从零开始

禁止：从非官方博客/教程中复制代码而不验证。任何第三方方案都要和官方示例对比。

📚 补充链接

• Compose 官方文档
• Compose API 参考
• Compose Material3
• Compose 路线图
• Compose 性能指南