该技能面向使用 Jetpack Compose 构建生产级 Android 应用的开发者,提供从项目配置到架构、状态管理、导航与性能优化的系统性指导。
一、用途与适用场景
- 新建基于 Jetpack Compose 的 Android 项目时参考依赖与结构配置。
- 将传统 XML 布局迁移到 Compose。
- 实现复杂 UI 状态管理与副作用处理。
- 优化 Compose 性能,关注重组次数与稳定性。
- 配置类型安全导航。
二、主要能力
- 项目配置:说明在 libs.versions.toml 中声明 Compose BOM 及相关库,资料给出 Compose BOM 2024.02.01、activity-compose 1.8.2 的版本示例,以及 compose-bom、ui、ui-graphics、ui-tooling-preview、material3、activity-compose 等库条目写法。
- 状态管理:推荐 ViewModel 配合 StateFlow 暴露 UI 状态,避免直接暴露 MutableStateFlow;示例包含 UserUiState 数据类、UserViewModel 中通过 viewModelScope 与 _uiState.update 加载数据并处理异常。
- 界面分层:以 Screen 组合函数消费状态,将数据与回调下传给无状态组件;示例使用 collectAsStateWithLifecycle 收集状态,并在 Scaffold 中按加载、错误、数据三种状态分支渲染。
- 类型安全导航:示例定义 @Serializable 的 Home 与 Profile(userId) 目标,在 NavHost 中使用 composable<Home> 与 composable<Profile>,并通过 backStackEntry.toRoute() 取参数。
三、使用方式与最佳实践
- 使用 remember 与 derivedStateOf 减少重组中的重复计算。
- 对包含 List 等不稳定类型的 UI 状态数据类标注 @Immutable 或 @Stable,以支持智能重组跳过。
- 使用 LaunchedEffect 处理由状态变化触发的一次性副作用(如显示 Snackbar)。
- 避免在组合函数体内直接执行排序等昂贵操作而不加 remember。
- 不向子组件传递 ViewModel 实例,只传状态数据与 lambda 回调。
四、问题排查 资料给出无限重组循环的排查思路:检查是否在组合中未使用 remember 创建新对象(如 List 或 Modifier),或在组合阶段而非副作用/回调中更新状态;可借助 Layout Inspector 调试重组次数。
五、限制 该技能仅在任务明确匹配上述范围时使用;其输出不能替代针对具体环境的验证、测试或专家评审;当缺少必要输入、权限、安全边界或成功标准时,应停止并请求澄清。