Kotlin与Jetpack Compose的详细使用指南，综合最新技术实践和官方文档整理：

一、环境配置与基础架构

1. ‌项目创建‌

   • 在Android Studio中选择Empty Compose Activity模板，默认生成包含@Composable预览的MainActivity2
   • 要求Kotlin版本≥1.8.0，Gradle插件≥8.1.0

2. ‌核心原理‌

   • 采用声明式UI范式，通过@Composable函数描述界面状态与布局
   • 底层维护虚拟树（SlotTable）和真实树（LayoutNode）双树结构实现高效差量更新

二、UI构建规范

1. ‌组件声明‌

   @Composable fun Greeting(name: String) { Text( text = "Hello $name!", modifier = Modifier.padding(16.dp) ) }

   • 所有UI组件必须使用@Composable注解25
   • 通过Modifier链式调用配置布局属性38

2. ‌布局系统‌

   容器	特性	示例
   Column	垂直排列	verticalArrangement控制间距5
   Row	水平排列	horizontalArrangement控制对齐8
   Box	层叠布局	支持Alignment定位3

三、状态管理

1. ‌状态创建‌

   @Composable fun Counter() { var count by remember { mutableStateOf(0) } Button(onClick = { count++ }) { Text("Clicked $count times") } }

   • mutableStateOf创建可观察状态，remember保持重组时的状态持久化
   • 状态变更自动触发相关组件的重组

2. ‌高级状态方案‌

   • ViewModel+mutableState实现业务逻辑分离
   • derivedStateOf处理派生状态，避免无效重组

四、性能优化

1. ‌重组控制‌

   • 使用@Stable注解标记不可变数据类
   • key()函数帮助Compose识别列表项唯一性

2. ‌副作用管理‌

   LaunchedEffect(Unit) { // 协程作用域内执行一次性操作 }

   • 使用LaunchedEffect、DisposableEffect等处理生命周期感知操作

五、跨平台实践

1. ‌KMP集成‌

   • 通过expect/actual机制实现平台特定代码
   • 共享模块中定义通用Compose UI，各平台实现渲染适配

2. ‌多平台组件库‌

   • 使用Kuikly等框架实现DSL统一（iOS需适配UIKit）
   • 鸿蒙平台支持需等待5月开源版本

六、调试技巧

1. ‌实时预览‌

   @Preview(showBackground = true) @Composable fun PreviewGreeting() { Greeting("Android") }

   • 添加@Preview注解可在IDE中实时预览

2. ‌重组监测‌

   • 启用Layout Inspector的Compose模式分析重组次数
   • 使用compositionLocalOf实现深层参数传递

当前最佳实践推荐结合Kotlin 2.0协程和Compose 2.0版本使用，注意鸿蒙平台支持将于2025年5月正式开源。