第2章：API差异分析工具介绍
说实话，刚开始做Android SDK兼容性回归时，我踩过不少坑。最疼的一次是升级了compileSdk后，线上直接crash了——就因为没做API差异分析。那之后我下定决心，得把工具链捋清楚。
这一章，我们就来聊聊手头有哪些工具，帮你快速定位API行为变化。
官方标配：apkdiff
apkdiff 是 Google 官方推出的命令行工具，集成在 platform-tools 里。它的核心用途就一个：对比两个 APK 的 API 差异。
| 对比维度 | 说明 |
|---|---|
| 新增 API | 新版本中增加的类、方法、字段 |
| 移除 API | 被删除的公共接口（高风险） |
| 修改 API | 签名变更、参数类型变化 |
| 标记变化 | @Deprecated、@Nullable 等注解变更 |
我记得第一次用 apkdiff 时还闹了个笑话：参数顺序写反了，报错半天没反应过来。后来习惯写成：
apkdiff --from old.apk --to new.apk --only-changes加上 --only-changes 能过滤掉没变化的部分，输出瞬间清爽。我个人习惯把它集成到 CI 的 PR 步骤里，每次构建完自动跑一遍，报告直接贴到评论区。
Android Lint 的 API 检查功能
很多人只知道 Lint 用来检查代码规范，其实它还内置了 API 兼容性检查器。你想想看，这个功能默认是开启的，只要你在 build.gradle 里指定了 compileSdk 和 targetSdk，Lint 就会自动对比当前 build target 的 API 版本。
checkReleaseBuilds=true，确保 release 构建时强制检查，避免开发时漏检。
输出结果会标记出类似 NewApi、OldTargetApi 这些问题。我曾在项目中遇到一个隐蔽问题：Build.VERSION_CODES.S 的某个常量在低版本上被错误使用了。Lint 直接给出 warning，帮我提前拦截了一次线上兼容性事故。
Google 的 API diff 清单
这个其实不是工具，而是一份官方维护的文档——API Differences Report。每次发布新 SDK 版本，Google 都会在开发者网站生成一份 diff 页面。内容非常详尽，从包级别到方法级别，连参数默认值变化都列出来了。
- 层级清晰：按包名、类、方法树状展开
- 颜色标注：绿色表示新增，红色表示删除，黄色表示修改
- 可搜索：直接搜类名或者方法名定位变化
讲真，手动通读这份文档会疯掉。我每周只扫一眼“高影响变化”部分，比如 deprecated 的 API 和自己项目里常用的类。结合脚本自动化抓取关键变化，效率更高。
第三方工具：开源的 API diff 方案
除了官方工具，社区也有好用的开源库。比如 apkdiff（第三方同名，注意区分）和 LibRadar。它们能做的更像“差值扫描器”，不只对比 API，还能对比资源文件、清单文件的变化。
为什么还要用第三方？
官方 apkdiff 对 Android 框架层的 API 对比做得很好，但如果你用了厂商定制的 SDK（比如小米、华为的扩展 API），第三方工具能帮你扫描整个 APK 里的所有方法调用，包括三方库。适用范围更广。
我一般在 CI 里加一个 diffjob，同时跑官方和第三方工具，然后合并报告。这么做的好处是：
- 官方工具覆盖框架差异
- 第三方工具覆盖所有代码引用
- 交叉验证，减少漏报
a.a()，你根本不知道对应哪个原始 API。建议在构建产物保留 mapping 文件后用反混淆后的版本对比。
工具选型实战建议
选哪个工具，取决于你的场景。
| 场景 | 推荐工具 | 备注 |
|---|---|---|
| 只关心 framework API 变化 | 官方 apkdiff | 最精确，但只针对 android.* |
| 需要检查所有第三方库兼容性 | 第三方 apkdiff + LibRadar | 覆盖全面，需处理混淆 |
| 快速 CI 集成，最小改动 | Android Lint API 检查 | 零配置，但只报 warning/error |
| 深入分析 API 变更影响面 | 官方 API diff 报告 + 人工 review | 适合大版本升级前 |
我曾经在项目从 API 30 升到 33 时，同时用了三种工具。结果发现 android.app.Notification 的一个方法在 32 上悄悄改了返回值类型。Lint 没有报出来，官方 apkdiff 也没有——因为目标 SDK 当时还兼容低版本。但第三方工具反编译后直接发现了 invoke-virtual 指令的目标方法签名变了。嗯，这种“隐形变化”才是最危险的。
小结
API 差异分析工具不是万能的，但没有它们，你就像在黑夜里过马路。我个人习惯的标准流程是：Lint 打头阵（快），apkdiff 兜底（准），第三方工具做补充（全）。三管齐下，基本能覆盖 99% 的兼容性问题。