AGP

官方文档：Android Gradle Plugin 文档

AGP 是什么？

AGP（Android Gradle Plugin）是 Google 官方为 Android 开发打造的 Gradle 插件，核心作用是将 Gradle 构建系统与 Android 开发流程深度整合，让开发者能通过简洁的配置完成 Android 项目的编译、打包、优化、签名等全流程构建工作。

AGP 是 Android 项目构建的 “核心引擎”，所有 Android 项目的编译、打包、优化流程均由其驱动。开发者无需深入底层工具（如 D8/R8、AAPT2）的细节，只需通过 build.gradle 配置 AGP 参数，即可完成标准化的构建工作。掌握 AGP 的核心配置（如构建变体、依赖管理、混淆）是 Android 开发的基础能力，而关注 AGP 版本升级则能获得更好的构建性能和新特性支持。

简单来说：AGP 是连接 “Android 项目代码” 和 “Gradle 构建工具” 的桥梁，是 Android Studio 构建 APK/AAB 的核心引擎，所有 Android 项目的构建逻辑（如编译 Java/Kotlin、转换 DEX、打包资源、代码混淆等）均由 AGP 封装和管理。

AGP 的核心定位与背景

1. 推出背景

早期 Android 项目使用 Ant、Maven 构建，流程繁琐且扩展性差；Gradle 作为新一代构建工具，支持增量构建、灵活的自定义脚本，Google 因此推出 AGP，将 Android 专属的构建逻辑（如 DEX 编译、资源打包、多渠道打包）封装为 Gradle 插件，降低开发者的构建配置成本。

2. 核心定位

AGP 不是独立工具，而是 Gradle 的 “Android 专属扩展”，主要负责：

• 解析 build.gradle/build.gradle.kts 中的 Android 配置（如编译版本、签名信息、依赖库）；
• 调度底层工具（如 javac/kotlinc、D8/R8、AAPT2、apksigner 等）完成构建；
• 适配不同 Android 版本、构建变体（Debug/Release）、打包格式（APK/AAB）。

3. 版本与兼容性

AGP 版本与 Gradle、Android Studio、compileSdk 强绑定，例如：

AGP 的核心功能

AGP 封装了 Android 构建全流程的核心能力，开发者只需在 build.gradle 中配置简单参数，即可自动完成以下工作：

1. 代码编译与转换

• 调用 javac/kotlinc 编译 Java/Kotlin 代码为 .class 字节码；
• 内置 D8/R8 工具，将 .class 转换为优化后的 DEX 字节码；
• 处理 Java 8+ 特性脱糖、多 DEX 拆分（应对 65536 方法数限制）。

2. 资源处理

• 调用 AAPT2（Android Asset Packaging Tool 2）编译资源文件（布局、字符串、图片等），生成 R 类；
• 压缩、优化资源（如图片压缩、资源混淆）；
• 支持资源本地化、多维度资源变体（如不同分辨率、语言）。

3. 构建变体与多渠道打包

• 支持 Build Type（Debug/Release）、Product Flavor（渠道包）、Build Variant（变体组合）；
• 可针对不同变体配置不同的编译参数、依赖、签名信息；
• 例如：为 “国内渠道” 和 “海外渠道” 生成不同的 APK。

4. 依赖管理

• 解析 Maven/Gradle 依赖（如 AndroidX、第三方库），自动处理依赖冲突；
• 将依赖库打包进 APK/AAB（或配置为动态交付）；
• 支持依赖瘦身（移除未使用的依赖代码 / 资源）。

5. 签名与打包

• 自动完成 APK/AAB 的签名（Debug 签名自动生成，Release 签名手动配置）；
• 支持 V1（Jar 签名）、V2（APK 签名）、V3 签名格式；
• 生成对齐后的 APK（zipalign），提升运行时性能。

6. 优化能力

• 内置 R8 完成代码压缩、混淆、优化；
• 支持 APK 瘦身（如移除无用资源、压缩 DEX）；
• 生成构建报告（如依赖报告、构建速度分析）。

AGP 的核心配置方式

AGP 的配置主要集中在项目的 build.gradle（模块级）中，核心配置示例：

// 模块级 build.gradle (Groovy)
plugins {
    // 应用 AGP 插件（核心）
    id 'com.android.application' // 应用模块（生成APK/AAB）
    // id 'com.android.library' // 库模块（生成AAR）
    id 'org.jetbrains.kotlin.android' // Kotlin 支持
}

android {
    // 编译 SDK 版本
    compileSdk 34

    // 默认配置
    defaultConfig {
        applicationId "com.example.myapp" // 应用包名
        minSdk 21 // 最低兼容 Android 版本
        targetSdk 34 // 目标 Android 版本
        versionCode 1 // 版本号（数字）
        versionName "1.0" // 版本名称（字符串）

        // 多 DEX 支持
        multiDexEnabled true
    }

    // 构建类型（Debug/Release）
    buildTypes {
        release {
            minifyEnabled true // 启用 R8 混淆/压缩
            proguardFiles getDefaultProguardFile('proguard-android-optimize.txt'), 'proguard-rules.pro'
            signingConfig signingConfigs.release // 配置 Release 签名
        }
        debug {
            debuggable true // 可调试
            minifyEnabled false // 禁用混淆
        }
    }

    // 产品风味（多渠道）
    productFlavors {
        google {
            applicationIdSuffix ".google" // 包名后缀
        }
        huawei {
            applicationIdSuffix ".huawei"
        }
    }

    // Java 编译配置
    compileOptions {
        sourceCompatibility JavaVersion.VERSION_1_8
        targetCompatibility JavaVersion.VERSION_1_8
    }
    kotlinOptions {
        jvmTarget = '1.8'
    }
}

dependencies {
    // 依赖配置（AGP 自动解析）
    implementation 'androidx.core:core-ktx:1.12.0'
    implementation 'androidx.appcompat:appcompat:1.6.1'
    implementation 'com.google.android.material:material:1.11.0'
    debugImplementation 'com.squareup.leakcanary:leakcanary-android:2.12' // 仅 Debug 依赖
}

AGP 的关键特性与演进

1. 关键特性

• 增量构建：仅重新编译 / 打包修改过的文件，大幅提升构建速度；
• Build Cache：缓存构建产物，跨项目 / 跨机器复用；
• Configuration Cache：缓存构建配置，进一步提升首次构建速度（AGP 7.0+ 支持）；
• 模块隔离：支持模块化构建，不同模块独立编译；
• Jetpack Compose 支持：内置 Compose 编译插件，适配声明式 UI 构建。

2. 核心演进

• AGP 3.x：引入 D8/R8，替代 dx/ProGuard；
• AGP 4.x：强化增量构建、Build Cache；
• AGP 7.x：与 Android Studio 版本对齐，支持 Configuration Cache、Compose；
• AGP 8.x：提升构建性能，强化 AAB 支持，逐步移除旧版 API；
• AGP 9.x：适配 Android 15，强化模块化、动态交付能力。

开发者常见操作

1. 升级 AGP

在项目根目录的 build.gradle 中修改插件版本：

// 项目级 build.gradle (Groovy)
buildscript {
    repositories {
        google() // 必须添加 Google 仓库
        mavenCentral()
    }
    dependencies {
        classpath 'com.android.tools.build:gradle:8.5.1' // AGP 版本
        classpath 'org.jetbrains.kotlin:kotlin-gradle-plugin:1.9.20' // Kotlin 插件
    }
}

2. 查看 AGP 文档

官方文档：Android Gradle Plugin 文档

3. 调试构建问题

• 使用 ./gradlew assembleDebug --info 查看详细构建日志；
• 使用 Android Studio 的 “Build Analyzer” 分析构建速度 / 问题；
• 检查 AGP 版本与 Gradle/Android Studio 的兼容性。