构建AOSP引入外部Jar文件时遭遇Proguard错误的解决方法

我之前定制AOSP Framework模块时碰到过完全一样的问题，核心原因是你引入的外部Jar包和AOSP全局构建流程中的Proguard优化逻辑冲突了，先给你拆解问题并给出具体解决步骤：

第一步：解决“library class depends on program class”警告 #

这个警告是因为AOSP构建系统把你的外部Jar标记为了库类（library class），但Jar里的代码却依赖了只能在**程序类（program class）**中存在的逻辑，或者反过来。你需要在framework/opt/你的模块/Android.bp里正确配置外部Jar的属性：

1. 用java_import声明外部Jar时，明确标记它仅用于设备端构建，并且限制可见性：

java_import {
    name: "your-external-lib",
    jars: ["libs/your-external.jar"],
    host_supported: false, // 禁止在主机端构建使用
    visibility: ["//frameworks/opt/your-module"], // 仅当前模块可见
}

2. 在依赖该Jar的Framework模块中，用static_libs引用它，确保Jar中的类会被合并到模块的dex中，而不是作为独立库：

java_library {
    name: "your-framework-opt-module",
    srcs: ["src/**/*.java"],
    static_libs: [
        "your-external-lib",
        // 其他依赖...
    ],
    compile_dex: true, // 强制编译生成dex
    // 其他配置...
}

第二步：修复Proguard的ClassMerger报错 #

“Method must be overridden in [proguard.optimize.peephole.ClassMerger]”这个错误，是因为Proguard的类合并优化插件在处理外部Jar时，发现某个方法不符合它的校验规则。你可以通过以下方式解决：

方案1：精确禁用冲突的Proguard优化 #

不需要完全关闭优化，只禁用类合并相关的规则即可，在你的模块Android.bp中添加：

java_library {
    // 其他配置...
    proguard_flags: [
        "-optimizations !code/simplification/merging/*", // 禁用类合并优化
        "-optimizations !class/merging/*",
    ],
}

方案2：排除外部Jar的Proguard处理 #

如果外部Jar不需要Proguard优化，可以直接告诉Proguard忽略它的所有类：

java_library {
    // 其他配置...
    proguard_flags: [
        "-keep class com.your.external.package.** { *; }", // 保留外部Jar所有类
        "-dontwarn com.your.external.package.**", // 忽略该包下的警告
    ],
}

方案3：清理外部Jar的冲突类 #

如果你的外部Jar里意外包含了Proguard相关的类（比如旧版本的proguard.optimize.*），会和AOSP内置的Proguard版本冲突。这种情况需要重新打包Jar，剔除掉Proguard相关的类文件。

最后验证 #

修改配置后，先执行以下命令清理模块构建缓存：

mmm frameworks/opt/your-module -B

然后再执行全量编译：

make -j4

如果还是有问题，可以尝试make clean后重新构建，确保所有配置生效。

内容的提问来源于stack exchange，提问作者hitwhyyx