用途:以 Jetpack Compose 开发 Android 声明式 UI,遵循“状态向下、事件向上”的单向数据流,保持 Composable 小而稳定可预测。资料说明应用架构与依赖注入属于 android-development,MVVM 属于 mvvm-architecture,视觉风格参考 better-mobile-interface,字符串国际化参考 i18n-mobile。
主要能力:状态方面使用 remember、rememberSaveable、mutableStateOf、collectAsStateWithLifecycle、ViewModel + StateFlow,派生计算用 derivedStateOf;副作用使用 LaunchedEffect、DisposableEffect、SideEffect、rememberCoroutineScope,禁止在 Composable 主体直接做网络或 IO。布局与主题优先 Material 3 的 MaterialTheme,注意 Modifier 顺序,使用 slot API 而非布尔参数,主题通过 colorScheme、typography、shapes 统一。列表用 LazyColumn/LazyRow/LazyGrid 并设置稳定 key,必要时用 contentType,图片用项目既有库并控制尺寸,优化前先用 Layout Inspector 或 Compose metrics 测量重组。导航使用 Navigation Compose 与类型安全路由、可序列化参数、正确的 ViewModel 作用域和深链。互操作可用 AndroidView、AndroidViewBinding、ComposeView。无障碍要求 contentDescription、semantics、role、约 48dp 触控目标、可缩放字体与合理焦点顺序。预览用 @Preview 覆盖 loading、empty、error、content 及明暗主题。
使用方式与限制:资料未提供安装命令、依赖版本、收费或平台信息,暂未提供。资料列出反模式:上帝 Composable、GlobalScope、状态重复、公共组件省略 Modifier、不稳定 List/Map 导致重组、忽略配置变更。完成标准为 UDF 清晰、副作用仅在 effect API、列表有 key、主题走 MaterialTheme、具备基础无障碍与主要状态预览、Composable 主体无 IO,并保留项目原有 ViewModel/DI 集成。