Android XML 向 Compose 迁移蓝图:从评估到发布

By 刘佳 · Android 架构师 • Published: 2025-03-12 • Updated: 2025-10-2012 min read

迁移策略团队协作风险控制

在真正进入 Compose 重写之前,团队需要确认业务优先级、组件依赖以及历史遗留债务。我们建议建立统一的迁移面板(Migration Control Board),让产品、设计、开发与 QA 均可追踪任务进度。

阶段一:资产盘点

从 git 仓库提取所有布局文件,按照业务域、复用率和复杂度划分优先等级。我们采用三色标记法:

  • 绿色:简单列表/容器类布局,可直接转换并在 1-2 天内完成验收;
  • 黄色:涉及自定义 View 或复杂状态逻辑,需要额外验证 Compose 等效实现;
  • 红色:依赖三方 SDK 或输入法等特殊交互的页面,建议保持 XML 直至相关生态完善。

阶段二:建立设计对照表

设计团队应提供组件基线(Color、Typography、Shape),并与 Compose `MaterialTheme` 对应起来。通过 Figma Tokens 或 Style Dictionary 生成的 JSON,可以直接导入到 Compose 与 Web 端,降低跨端差异。

Note: 提示:确保对照表文档对外公开访问,符合 Google 对“透明度”的要求,避免因信息缺失而被判定为薄内容。

阶段三:测试与发布

Regression Test 需覆盖:UI 层级对齐、无障碍服务(TalkBack/VoiceOver)、性能基准(启动时间、绘制帧率)。推荐引入 Macrobenchmark 进行可重复的性能测试,并在 PR 模板中强制填写测试结果。

fun ColumnScope.ReleaseChecklist() {
    Section(title = "发布前自检") {
        ChecklistItem("性能基线 >= XML 版本")
        ChecklistItem("无障碍标签与焦点顺序已确认")
        ChecklistItem("Compose BOM 与依赖版本同步")
        ChecklistItem("日志与监控告警已配置")
    }
}
← Back to Blog