SuperAPI AI 工具集

android-jetpack-compose-expert

编程与开发

查看项目

更新于 11-11 17:17

技能介绍

该技能面向使用 Jetpack Compose 构建生产级 Android 应用的开发者,提供从项目配置到架构、状态管理、导航与性能优化的系统性指导。

一、用途与适用场景

  • 新建基于 Jetpack Compose 的 Android 项目时参考依赖与结构配置。
  • 将传统 XML 布局迁移到 Compose。
  • 实现复杂 UI 状态管理与副作用处理。
  • 优化 Compose 性能,关注重组次数与稳定性。
  • 配置类型安全导航。

二、主要能力

  1. 项目配置:说明在 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 等库条目写法。
  2. 状态管理:推荐 ViewModel 配合 StateFlow 暴露 UI 状态,避免直接暴露 MutableStateFlow;示例包含 UserUiState 数据类、UserViewModel 中通过 viewModelScope 与 _uiState.update 加载数据并处理异常。
  3. 界面分层:以 Screen 组合函数消费状态,将数据与回调下传给无状态组件;示例使用 collectAsStateWithLifecycle 收集状态,并在 Scaffold 中按加载、错误、数据三种状态分支渲染。
  4. 类型安全导航:示例定义 @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 调试重组次数。

五、限制 该技能仅在任务明确匹配上述范围时使用;其输出不能替代针对具体环境的验证、测试或专家评审;当缺少必要输入、权限、安全边界或成功标准时,应停止并请求澄清。