用途
本技能用于将 Android XML 布局系统性地转换为符合 Compose 习惯的 Jetpack Compose 代码,在保留原有功能的同时采用 Compose 模式。适用于被要求将 View 迁移到 Compose、把 XML 转换为 Composable,或从 View 系统现代化 UI 的场景。
主要能力
技能提供完整的迁移工作流,包括:分析 XML 布局(识别根布局类型、列出 View 及属性、映射数据绑定或视图绑定、识别自定义 View、注意 include/merge/ViewStub 用法);规划迁移(全量重写或借助 ComposeView/AndroidView 增量迁移、识别状态来源、提取可复用 Composable、规划导航集成);转换布局(依据布局映射表逐项转换);迁移状态(LiveData 观察转为 StateFlow 收集或 observeAsState、用 Compose 状态替代 findViewById/ViewBinding、点击监听转为 lambda 参数);测试验证(对比视觉输出、测试无障碍、验证配置变更时的状态保留)。
技能附带布局映射参考,覆盖容器布局(LinearLayout 转 Column/Row、FrameLayout 转 Box、ConstraintLayout 转 Compose 版 ConstraintLayout、ScrollView 转 Column 加 verticalScroll、RecyclerView 转 LazyColumn/LazyRow/LazyGrid、ViewPager2 转 HorizontalPager 等)和常见控件(TextView 转 Text、EditText 转 TextField/OutlinedTextField、Button、ImageView、CheckBox、Switch、ProgressBar、SeekBar、Spinner、CardView、Toolbar、BottomNavigationView、FloatingActionButton、Divider、Space 等)的对应关系。
属性映射部分列出 XML 属性到 Compose Modifier/属性的转换,如 match_parent 转 fillMaxWidth/fillMaxHeight、layout_weight 转 Modifier.weight、padding、background、visibility 转条件组合或 alpha、clickable、contentDescription 转 semantics、elevation、alpha、rotation、scale、gravity 转 Alignment/Arrangement、layout_gravity 转 Modifier.align 等。
常见模式示例包括:LinearLayout 权重布局、RecyclerView 转 LazyColumn、EditText 双向绑定、ConstraintLayout 迁移、include/merge 提取为可复用 Composable。增量迁移部分展示如何在 XML 中嵌入 ComposeView、在 Compose 中用 AndroidView 嵌入 XML View。状态迁移部分展示 LiveData 到 Compose 收集、点击监听转 lambda。最后提供迁移检查清单。
使用方式
按照工作流逐步执行:先分析 XML 布局,再规划迁移策略,然后依据映射表转换布局,迁移状态与事件,最后测试验证并对照检查清单确认完成。
适用场景
适用于 Android 项目从 View 系统向 Jetpack Compose 迁移,包括全量重写和增量迁移两种方式,以及需要保留原有功能、状态管理和无障碍特性的 UI 现代化改造。
限制
资料未提供该技能的具体安装方式、运行环境要求、支持的 Android 版本或 Compose 版本范围。资料中的映射表和模式为参考性质,实际迁移需结合项目情况判断。未提及收费、价格或效果保证。