构建环境准备：AGP版本、R8/ProGuard配置

说实话，Baseline Profile 编译出问题，十有八九是构建环境没搭对。我见过不少朋友上来就对着规则撸，结果编译报错一头雾水……其实只要把 AGP 和 R8 这两个东西理清楚，起码能避开 80% 的坑。

AGP 版本——决定 Baseline Profile 能走多远

Baseline Profile 是在 AGP 7.2 之后才正式支持的。但不同版本的行为差异挺大，我习惯先拿一张表记下来：

我个人建议用 AGP 8.1 或 8.2，比较稳定。有一次我项目用的 AGP 8.0，R8 版本没跟上，结果 Baseline Profile 一直报 ProfileInstaller 找不到符号……后来查了半天才发现是版本组合不兼容。你想想看，AGP 和 R8 的版本其实是绑定的，升级 AGP 的同时最好也把 androidx.baselineprofile 的版本提上去。

R8 / ProGuard 配置——踩过的坑最多

Baseline Profile 本质上是一组 class 和方法的引用列表，最终要嵌入到 APK 里。如果 R8 或 ProGuard 把关键的类混淆了、移除了，那 Profile 就废了。

必须保留的规则

我记得第一次集成时，编译通过了，但运行时 Profile 没被加载。排查发现 R8 把 ProfileInstaller 的构造函数给优化掉了。所以下面这几条规则，强烈建议加到你的 proguard-rules.pro 里：

-keep class androidx.profileinstaller.ProfileInstallerInitializer { *; }
-keep class androidx.baselineprofile.** { *; }
-keepclassmembers class * {
    @androidx.baselineprofile.BaselineProfile public *;
}

另外，如果你的 Baseline Profile 是通过 -include 引用的，记得确保 R8 不会内联这些路径。我曾经遇到过因为 -dontoptimize 没写，导致 Profile 文件被当成无用资源删掉的情况……嗯，那一次排查花了整整半天。

混淆与 Baseline Profile 的冲突

开混淆的情况下，R8 会重命名类名和方法名。如果你的 Baseline Profile 配置里写的是原始类名（比如 com.example.MainActivity），那最后生成的 Profile 会引用一个已经不存在的新名字——运行时自然就失效了。解决办法有两个：

1. 在生成 Baseline Profile 时，把混淆关掉（minifyEnabled false），生成后再开混淆
2. 或者在混淆规则里 -keep 需要被 Profile 覆盖的类

坦白说，第一种方案更省事。我自己的项目就是这么干的——debug 构建不混淆生成 Profile，release 构建再开混淆。不过要注意：Profiles 文件本身不需要混淆，所以推荐用 minifyEnabled = true 的同时，在 proguard-rules.pro 里加上 -keep class **.baselineprofiles.** { *; }。

AGP + R8 版本兼容性速查

下面是我整理的一个版本组合表，基本能覆盖大多数场景：

构建环境配置总览

这一套东西我画了一张图，方便你对照检查自己的项目配置：

构建环境这部分，你只要把 AGP 和 R8 这两块锁死，后面编译错误排查就能少走很多弯路。我曾经踩过一个坑：AGP 8.1 + R8 3.2.0，结果 Profile 生成时总是报 MethodHandle.invokeExact 相关错误，因为当时的 R8 还无法正确处理 Lambda 表达式……后来升级到 3.3.0 就解决了。所以版本这东西，真的不能差一点点。