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月正式開源。