8、Android Gradle Plugin基础：AGP的作用、版本对应关系与配置块详解

聊到Android开发，Gradle是绕不开的话题。而AGP，也就是Android Gradle Plugin，更是整个构建流程的核心。今天我就带你把它彻底搞明白。

AGP到底是什么？它解决了什么问题？

AGP，全称Android Gradle Plugin。说白了，它就是Gradle世界里的一个“翻译官”。

Gradle本身是一个通用的构建工具，它不知道什么是Android。你想想看，Gradle怎么知道APK该怎么打包？怎么知道资源文件要合并？怎么知道要生成R.java？这些它统统不知道。

AGP的作用，就是把这些Android特有的构建逻辑注入到Gradle中。它告诉Gradle：

• 怎么编译Kotlin/Java代码
• 怎么处理资源文件
• 怎么生成Manifest合并
• 怎么签名、对齐、打包APK
• 怎么处理多模块依赖

我个人习惯把AGP理解成一个“构建引擎的插件包”。没有它，Gradle就是个空壳子，干不了Android的活。

AGP版本与Gradle版本对应关系

这里有个坑，我当年踩过。AGP和Gradle的版本不是随便配的。它们之间有严格的对应关系。你配错了，项目直接报错，而且错误信息往往很隐晦。

为什么会这样？因为AGP内部依赖了Gradle的某些API。Gradle版本升级，API可能变了，AGP就得跟着适配。所以Google官方维护了一张版本对应表。

AGP版本	最低Gradle版本	推荐Gradle版本
8.7	8.9	8.9
8.6	8.7	8.7
8.5	8.7	8.7
8.4	8.6	8.6
8.3	8.4	8.4
8.2	8.2	8.2
8.1	8.0	8.1-8.2
8.0	8.0	8.0
7.4	7.5	7.5-7.6
7.3	7.4	7.4-7.6
7.2	7.3.3	7.3.3-7.4
7.1	7.2	7.2-7.4
7.0	7.0	7.0-7.4

apply plugin: 'com.android.application' 的含义

在项目的build.gradle文件里，你肯定见过这行代码：

plugins {
    id 'com.android.application'
}

或者老式的写法：

apply plugin: 'com.android.application'

这行代码到底干了什么？

它告诉Gradle：我要使用Android Application插件。这个插件是AGP的一部分。应用之后，Gradle就知道了：

• 这是一个Android应用模块
• 我需要加载Android构建任务（assembleDebug、assembleRelease等）
• 我需要提供android {} 配置块
• 我需要处理APK打包流程

与之对应的是 com.android.library 插件。它用于构建Android库模块，输出的是AAR文件，而不是APK。

android {} 配置块详解

这是每个Android开发者最熟悉的配置块。但你真的了解它里面的每一项吗？

android {} 是一个扩展配置块。它由AGP提供，用于配置Android构建的所有参数。我把它分成几个核心部分来讲。

compileSdk 与 buildToolsVersion

android {
    compileSdk 34
    buildToolsVersion "34.0.0"
}

compileSdk 告诉Gradle：用哪个版本的Android SDK来编译代码。它决定了你能使用哪些API。比如你设置成34，就可以用Android 14的新特性。

buildToolsVersion 指定构建工具的版本。它包含了aapt、dx/d8、zipalign等工具。嗯，这里要注意：从AGP 3.6.0开始，这个字段可以省略了。AGP会自动使用合适的版本。

defaultConfig 默认配置

android {
    defaultConfig {
        applicationId "com.example.myapp"
        minSdk 21
        targetSdk 34
        versionCode 1
        versionName "1.0"
        testInstrumentationRunner "androidx.test.runner.AndroidJUnitRunner"
    }
}

这里定义了应用的默认配置。每个字段都很关键：

• applicationId：应用的唯一标识。就是你在Google Play上的包名。注意，它和代码里的package名可以不同。
• minSdk：最低支持的Android版本。我建议保持在21以上，因为Android 5.0以下的设备已经很少了。
• targetSdk：目标SDK版本。表示你在这个版本上做过充分测试。每次Android大版本更新，Google都会要求你更新targetSdk。
• versionCode：内部版本号。必须是整数，每次更新都要递增。
• versionName：展示给用户的版本名。比如"1.0.0"。

buildTypes 构建类型

android {
    buildTypes {
        release {
            minifyEnabled true
            proguardFiles getDefaultProguardFile('proguard-android-optimize.txt'), 'proguard-rules.pro'
            signingConfig signingConfigs.release
        }
        debug {
            debuggable true
            applicationIdSuffix ".debug"
        }
    }
}

buildTypes定义了不同的构建变体。默认有release和debug两种。你可以自定义更多。

release类型通常用于发布：开启混淆、配置签名、移除调试信息。debug类型用于开发：可调试、包名加后缀方便区分。

signingConfigs 签名配置

android {
    signingConfigs {
        release {
            storeFile file("my-release-key.jks")
            storePassword "password"
            keyAlias "my-alias"
            keyPassword "password"
        }
    }
}

签名是Android应用的重要环节。没有签名的APK无法安装。release版本必须签名，debug版本Android SDK会自动用debug签名。

productFlavors 产品风味

android {
    flavorDimensions "version"
    productFlavors {
        demo {
            dimension "version"
            applicationIdSuffix ".demo"
            versionNameSuffix "-demo"
        }
        full {
            dimension "version"
            applicationIdSuffix ".full"
            versionNameSuffix "-full"
        }
    }
}

productFlavors用于创建不同版本的应用。比如免费版和付费版。它们共享同一套代码，但可以有不同的配置、资源和依赖。

结合buildTypes，你会得到多个构建变体。比如demoDebug、demoRelease、fullDebug、fullRelease。每个变体都可以独立配置。

知识体系总览

下面这张图，帮你把AGP的核心知识串起来：

AGP的知识点其实就围绕这三个方面展开：它是什么、版本怎么配、配置怎么写。把这三点吃透了，Android构建对你来说就不再是黑盒。

---

公众号:蓝海资料掘金营，微信deep3321