📚 课程目录第3章环境准备

环境准备：AGP版本要求与Profile Installer配置

说到Baseline Profile，很多人一上来就开干，结果编译失败。为什么？因为环境没搭对。

我个人习惯是把环境准备工作放在第一步。AGP版本、Profile Installer库的版本，这两个东西不匹配，后面全白搭。今天咱们就把这块掰开了聊。

AGP版本要求

Android Gradle Plugin的版本直接影响Baseline Profile的生成流程。不是所有AGP都支持，你想想看，谷歌每年都在改API。

我从Android Studio Arctic Fox（2020.3.1）开始接触这个功能。当时AGP 7.0刚出，我试了试，发现默认就支持了Profile Installer。但坑也来了——如果用旧版AGP，连profileinstaller这个artifact都找不到。

目前支持的AGP版本范围是这样的：

AGP版本	是否支持Baseline Profile	最低Profile Installer版本	备注
4.2.x	❌ 不支持	—	无法生成，需升级
7.0.x – 7.4.x	✅ 支持（需手动配置）	1.2.0+	我在这版踩过不少坑
8.0.x – 8.3.x	✅ 原生支持	1.3.0+	开箱即用，推荐
8.4+	✅ 强化支持	1.4.0+	支持多模块增量

⚠️ 我曾经遇到的问题：AGP 7.0刚发布时，默认没有启用Profile Installer。你需要显式地在build.gradle里添加enableProfileInstaller = true，否则运行时Profile根本不会被收集。如果你还在用7.0，别忘了加这行。

Profile Installer库的依赖配置

说白了，Profile Installer就是AndroidX里的一个库，负责在安装时把生成好的Baseline Profile文件推送到设备上。没有它，你的规则表就是一张废纸。

我在项目中习惯用Kotlin DSL写依赖，清晰又好维护。下面是标准配置：

// 模块级 build.gradle.kts
dependencies {
    // Profile Installer 核心库
    implementation("androidx.profileinstaller:profileinstaller:1.4.0")

    // 可选的：用于在调试时观察Profile状态
    debugImplementation("androidx.profileinstaller:profileinstaller-benchmark:1.4.0")
}

注意看，debugImplementation只用于调试构建。生产环境里不要带benechmark依赖，否则会增加APK体积。我曾经见过有人直接把所有配置都写成implementation，结果release包多出几KB，其实完全没必要。

✅ 核心要点：

Profile Installer版本必须与AGP版本对应（参考上表）
只在debug变体下添加benchmark依赖
如果使用多模块，每个模块都需要单独添加依赖

Gradle属性配置

到这里还没完。你还需要在gradle.properties里开启Profile生成功能。我习惯把这行加在项目根目录的properties文件里：

android.experimental.enableNewProfileGuidedOptimization=true
android.experimental.enableNewProfileGuidedOptimization.agp8=true

嗯，这里要注意：AGP 8.0以后第一个属性就足够了，第二个是留给旧项目的兼容开关。我自己在升级到AGP 8.2时，发现如果只开第一个，某些低版本设备上Profile没生效，后来加上第二个就好了。具体情况你可以去踩一下试试。

版本依赖冲突与避坑

另一个常见问题是依赖冲突。比如你用了一个老版本的AppCompat，它可能也引用了Profile Installer，但版本不一致。怎么办？

我个人的做法是使用BOM（Bill of Materials）统一管理版本：

dependencies {
    implementation(platform("androidx.compose:compose-bom:2024.12.01"))
    implementation("androidx.profileinstaller:profileinstaller")
}

这样所有AndroidX库版本都对齐，省心。如果没有用BOM，那就得手动强制统一：

configurations.all {
    resolutionStrategy {
        force("androidx.profileinstaller:profileinstaller:1.4.0")
    }
}

我踩过的坑：有一次第三方SDK依赖了一个旧版Profile Installer（1.1.0），结果生成的Baseline Profile在Android 12上根本没用。排查了两天才发现是版本冲突导致低版本库覆盖了高版本的功能。所以，统一版本真的很重要。

环境准备全流程

把上面所有点串起来，就是一张环境准备流程图。我画了个SVG，帮你快速建立全局认知：

💡 个人经验：在AGP 7.0到7.4这个区间，我建议你升级到AGP 7.4.2，稳定且Profile支持完整。如果不小心用了7.0.0，记得手动开enableProfileInstaller，否则你辛辛苦苦生成的Baseline Profile不会被安装到设备上。另外，Profile Installer 1.3.0以后引入了增量编译优化，推荐直接上最新版。

好了，环境准备这块儿做到位，后续生成Baseline Profile就是水到渠成的事。别嫌麻烦，环境配好了后面的课才能跑通。如果你在配置中遇到其他诡异问题，不妨回头看看AGP版本和依赖版本是否对齐，八成就是这里出的问题。