R8/ProGuard对Library模块类的混淆报错及consumer-rules.pro规则不生效问题咨询

我搭建了一个包含App模块和Library模块的示例项目：

• App模块直接依赖Library模块
• App模块中有AppModel类，Library模块中有LibraryModel类
• 在App模块的Activity中，我直接实例化并调用了这两个类的run()方法

相关代码如下：

App模块的AppModel类 #

class AppModel {
    fun run() {
        Log.d("mytag", "AppModel run: ${this.javaClass.simpleName}")
    }
}

Library模块的LibraryModel类 #

class LibraryModel {
    fun run() {
        Log.d("mytag", "LibraryModel run: ${this.javaClass.simpleName}")
    }
}

Activity调用代码 #

class MainActivityTwo : AppCompatActivity() {
    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        enableEdgeToEdge()
        setContentView(R.layout.activity_main_two)
        LibraryModel().run()
        AppModel().run()
    }
}

现在我遇到两个问题：

问题1：Release构建时R8报错需要为LibraryModel添加规则，为什么？

我认为这只是个简单类，应该会被正常混淆，但R8不仅报错，还自动生成了错误的dontwarn规则——添加该规则后App运行直接崩溃，日志显示LibraryModel被完全移除了。

问题2：尝试在Library模块的consumer-rules.pro中添加keep规则，但不生效

我理解Gradle会合并App模块的proguard-rules.pro和Library模块的consumer-rules.pro生成最终的R8配置，但添加规则后问题依然存在，只有给LibraryModel加@Keep注解才能解决问题，这显然不是理想方案。

问题解答 #

针对问题1：为什么R8会报错并移除LibraryModel？

这事儿的核心问题出在Kotlin类的默认可见性+R8的静态分析逻辑上：

• 在Kotlin里，顶级类默认是internal可见性——意思是只能在当前模块内访问。你的LibraryModel没加public修饰符，本质上是Library模块的内部类
• 当你在App模块（跨模块）调用这个internal类时，Kotlin编译器会偷偷生成桥接方法/类来实现跨模块访问，这些代码是你看不到的
• R8处理Library模块时，会先做一轮静态分析：它发现LibraryModel是internal类，而且在Library模块内部根本没人用它，就默认标记成了“可以移除的冗余代码”
• 虽然你在App模块里明明调用了这个类，但R8做全局分析时，可能因为那些隐蔽的桥接代码，没正确跟踪到App模块对LibraryModel的引用，最后还是把这个类当成未使用代码给删掉了
• 自动生成的dontwarn规则只是把报错压下去了，根本没解决R8删类的问题，所以运行起来App直接崩了

针对问题2：为什么consumer-rules.pro的keep规则不生效？

你对Gradle合并ProGuard规则的理解是对的，但大概率是这几个细节没做好：

1. 规则的包名写得不全：如果你的consumer-rules.pro里只写了-keep class LibraryModel，R8根本找不到这个类——必须写完整的包名，比如：

   -keep class com.yourlibrary.package.LibraryModel { *; }
   

2. 没覆盖到编译器生成的桥接代码：因为跨模块访问internal类靠的是编译器生成的桥接代码，你只保留LibraryModel本身可能不够，得把桥接代码也保留住
3. 规则放错文件了：你得把规则写在Library模块的consumer-rules.pro里，而不是proguard-rules.pro——后者是Library模块自己构建时用的规则，前者才是给依赖它的App模块用的

最优解决方案 #

推荐优先用第一种，最省心：

1. 直接修正类的可见性：给LibraryModel加上public修饰符，改成真正的公开类。这样编译器不会生成那些麻烦的桥接代码，R8能直接看到App模块对它的引用，默认就不会删这个类，也不用加额外的ProGuard规则
2. 如果必须保留internal可见性：在Library模块的consumer-rules.pro里写完整的保留规则：

   -keep class com.yourlibrary.package.LibraryModel { *; }
   # 保留编译器生成的桥接代码
   -keep class com.yourlibrary.package.LibraryModel$* { *; }
   

内容来源于stack exchange