1. AGP构建基础与生命周期：Gradle阶段、Task图、变体维度、构建缓存

AGP（Android Gradle Plugin）构建过程本质上是Gradle构建系统的一个高度定制化实现。理解其生命周期是后续分析构建性能、帧率抖动关联的关键前提。本章从四个核心维度拆解AGP构建基础：Gradle阶段、Task图、变体维度和构建缓存。

1.1 Gradle三阶段生命周期

AGP的构建遵循Gradle标准的三阶段模型：初始化（Initialization） → 配置（Configuration） → 执行（Execution）。每个阶段都有特定的任务和内存/时间开销，直接影响构建速度和产物质量。

排查构建性能或帧率抖动问题时，首先应通过配置阶段耗时分析定位瓶颈。使用--profile参数可以生成构建报告，区分各阶段耗时。

1.2 Task图：构建的执行骨架

AGP将构建过程拆解为上百个Task，它们通过依赖关系（dependsOn/finalizedBy）构成一张有向无环图（DAG）。理解Task图有助于定位哪些Task执行时间过长，从而识别帧率抖动的底层原因（如资源重打包、非增量编译）。

查看当前模块的Task图（依赖树）：

./gradlew :app:tasks --all

单个Task的依赖链：

./gradlew :app:assembleDebug --dry-run

在build.gradle中可以通过afterEvaluate钩子动态调整Task：

android {
    afterEvaluate {
        tasks.matching { it.name.startsWith("merge") }.configureEach {
            // 可以修改输入/输出，或添加finalizedBy
            doLast {
                println("Task ${name} completed")
            }
        }
    }
}

常见错误：Task重写导致缓存失效

如果在build.gradle中手动修改了某个Task的输入或输出路径，但未声明@Input/@OutputDirectory注解，会导致构建缓存完全失效，每次构建都重新执行。错误示例：

tasks.whenTaskAdded { task ->
    if (task.name == "mergeDebugResources") {
        // 直接修改输出目录，但没有指示Gradle该输出是task的输出属性
        task.outputs.dir = file("$buildDir/intermediates/merged")
    }
}

1.3 变体维度：BuildType、Flavor与组合爆炸

AGP的变体（Variant）机制允许同一代码库生成不同配置的APK。变体由三个维度组合而成：BuildType（debug/release）、FlavorDimension（如付费版/免费版）、AbiFilter（arm64/x86）。每个变体对应一套独立的Task链，构建总数 = BuildType数量 × Flavor数量 × Abi数量。

配置示例：

android {
    flavorDimensions "tier", "api"
    productFlavors {
        free {
            dimension "tier"
            versionNameSuffix "-free"
        }
        paid {
            dimension "tier"
            versionNameSuffix "-paid"
        }
        minApi21 {
            dimension "api"
            minSdk 21
        }
        minApi29 {
            dimension "api"
            minSdk 29
        }
    }
    buildTypes {
        debug {
            minifyEnabled false
        }
        release {
            minifyEnabled true
            proguardFiles getDefaultProguardFile('proguard-android-optimize.txt'), 'proguard-rules.pro'
        }
    }
}

此时生成的变体数量 = 2 (tier) × 2 (api) × 2 (buildType) = 8个。每个变体都有自己的assembleTask，如assembleFreeMinApi21Debug。

变体爆炸会显著增加配置阶段的Task图生成时间与内存消耗。常用优化策略：

• 限制flavorDimensions数量（建议≤2）
• 在CI中使用--variant参数仅构建指定变体：

  ./gradlew :app:assembleFreeMinApi21Debug

• 利用android.variantFilter排除不需要的组合：

  android {
      variantFilter { variant ->
          def names = variant.flavors*.name
          if (names.contains("free") && names.contains("minApi29")) {
              ignore = true
          }
      }
  }

1.4 构建缓存：增量与跨项目复用

AGP构建缓存分为三层：本地构建缓存（~/.gradle/caches）、远程缓存（如CI共享）、Gradle Build Cache。其核心原理是：根据Task的输入（源文件、配置、依赖版本）计算哈希，若本次输入哈希与缓存中的一致，则直接复用输出，跳过执行。

启用构建缓存（默认在AGP 7.0+已开启）：

# gradle.properties
org.gradle.caching=true
android.enableBuildCache=true

查看缓存命中情况：

./gradlew assembleDebug --build-cache --info 2>&1 | grep "CACHE"

缓存失效的常见原因：

1.5 AGP构建生命周期整体流程（SVG结构图）

下图展示了从Gradle初始化到APK产出的完整流程，突出三阶段、变体维度与缓存作用点。

图中变体维度子图展示了组合爆炸的成因，而构建缓存区域强调缓存应优先命中执行阶段的Task，减少重复编译、资源处理等耗时操作。

1.6 本章小结