📚 课程目录第1章 AGP编译流程全景与瓶颈识别

1. AGP 编译流程全景与瓶颈识别

Android 构建流程是由 Gradle 驱动的一系列串联与并行任务组成的复杂系统。在大型项目中，一次全量构建往往耗时 5-10 分钟，理解其内部阶段划分、识别关键瓶颈，是性能优化的第一步。本章将系统梳理 AGP 编译流程，并给出可落地的瓶颈分析方法。

1.1 编译阶段划分与职责

AGP（Android Gradle Plugin）将构建过程抽象为若干个可插拔的 Transform 或 Task。按照生命周期，可以划分为以下核心阶段：

阶段	主要任务	关键指标	耗时占比
1. 配置与清单合并	合并多模块 AndroidManifest，处理 BuildConfig 与产品风味	模块数、依赖图大小	5-10%
2. 资源编译 (AAPT2)	编译资源文件，生成 R.java，处理资源链接与 ID 分配	资源文件数、语言区域数	10-15%
3. 源码编译 (Javac/Kotlin)	Java/Kotlin 编译，APT/KSP 注解处理，生成 .class 文件	源文件数、注解处理器数量	15-25%
4. Dexing 与混淆	将 .class 字节码转为 .dex，R8/ProGuard 全量/增量优化	Dex 大小、方法数、R8 规则条数	40-60%
5. 打包与签名	ZIP 对齐，v1/v2/v3/v4 签名，生成 APK/AAB	APK 结构、签名方案	5-10%
6. 安装与部署	ADB 推送、Install 命令、应用重启	APK 体积、设备存储	5-10%

1.2 关键耗时环节深度分析

在以上阶段中，D8/R8 的 Dexing 与混淆通常是最大的构建瓶颈，其耗时占比往往超过 50%。R8 的全量模式（--full）会进行全局分析和跨模块内联，导致大量缓存失效，这是增量编译失效的头号原因。

其次是 Kotlin 编译与注解处理。KAPT 在 Java 互操作和桩代码生成方面存在性能损耗，而 KSP 虽能缓解，但在大型项目中的总耗时仍然可观。

  📊 典型数据（10万+方法数的模块）：
  R8 全量：约 120s
R8 增量：约 30s（受限于全局分析，增量效果不稳定）
KAPT：约 40s
AAPT2：约 15s

⚠️ 注意：R8 的全量模式会进行全局分析，这会导致大部分缓存失效，是增量编译失效的头号原因。在开发过程中，可以临时禁用 R8 或使用 ProGuard 兼容模式来加速构建。

1.3 性能瓶颈分析方法论

要精准定位瓶颈，不能只靠猜测，必须依赖工具和数据。以下是四种经过验证的分析方法：

Gradle 构建扫描： 通过 --scan 参数生成可视化报告，精确展示每个 Task 的耗时和依赖关系。
Android Build Analyzer： Android Studio 4.2+ 内置，无需额外配置即可分析构建时的 Task 耗时和资源处理效率。
Gradle Profiler： 适用于基准测试场景，可以模拟 Clean Build、ABI 变更、API 变更等场景，对比不同配置的性能差异。
自定义计时 & 日志： 在 Gradle 配置中插入监听器，或使用 --info 日志分析 GC 压力和 Task 排队情况。

💡 推荐：启用 Gradle Build Scan（./gradlew assembleDebug --scan）或直接使用 Android Studio 自带的 Build Analyzer，可以在不修改任何代码的情况下，精确得到每个 Task 的耗时分布图。

# 启用 Gradle 构建扫描
./gradlew assembleDebug --scan

# 输出示例
BUILD SUCCESSFUL in 5m 24s
44 actionable tasks: 44 executed
Publishing build scan...
https://gradle.com/s/xxxxxxxxxxxx

// 自定义任务耗时测量（在模块的 build.gradle.kts 中）
tasks.configureEach {
    doLast {
        val start = System.nanoTime()
        // 任务逻辑
        val end = System.nanoTime()
        val durationMs = (end - start) / 1_000_000
        if (durationMs > 100) {
            println("⏱️ Task [${this.path}] took ${durationMs}ms")
        }
    }
}

1.4 构建生命周期总览图

下图直观展示了 AGP 编译流程的核心阶段、并行策略以及关键瓶颈位置：