最近升级agp版本之后,编译有报错,报错信息如下:
ERROR: Missing classes detected while running R8. Please add the missing classes or apply additional keep rules that are generated in /home/yeshen/app/build/outputs/mapping/debug/missing_rules.txt.
错误提示已生成缺失类的规则文件:
/home/yeshen/app/build/outputs/mapping/debug/missing_rules.txt
处理方法
添加缺失的keep规则。打开该文件,将其中的规则复制到项目的 ProGuard/R8规则文件(通常是proguard-rules.pro)中:
参考:
- Open following path and copy the content
build\app\outputs\mapping\release\missing_rules.txt
- Paste content into following file
android/app/proguard-rules.pro
原因
这些缺失的类可能是:
项目自身代码中的类,但可能因为包名变化或代码被删除导致缺失。
第三方库中的类,但该库可能没有正确引入,或者版本不兼容,或者该库的ProGuard规则没有被正确应用。
如何判断缺失的类属于哪个库?
如果类名包含知名库的包名(如com.google.、okhttp3.、retrofit2.等),则很容易识别。
如果类名看起来像是项目自己的代码(如com.yourcompany.yourapp),那么可能是代码被误删或者包名重构导致。
为什么AGP 8.0之后会报错?
AGP 8.0 带来了以下变化:
- 默认启用R8全模式(Full Mode):在AGP 8.0之前,R8运行在兼容模式(兼容ProGuard),而全模式会进行更积极的优化,这可能导致之前被忽略的问题暴露出来(如缺少类或规则)。
- Kotlin元数据处理变化:AGP 8.0要求使用较新版本的Kotlin(至少1.8.0+),如果项目中的Kotlin版本过旧,则可能导致元数据解析问题。
- 构建工具链更新:AGP 8.0使用新版本的Dex和资源处理工具,这些工具对代码和资源的检查更加严格。