介绍
R8 Assistant 面向 release 混淆流程，帮助你在开启 minifyEnabled 后处理 keep 规则、字典、mapping 和堆栈反混淆。
为什么使用 R8 Assistant
R8 混淆能减小体积并保护代码，但 keep 规则不足会导致反射、序列化、Room、Gson、Parcelable 或第三方 SDK 在 release 环境崩溃。
核心能力
- 扫描常见反射、序列化、数据库实体和 SDK 模式。
- 生成或补充 R8 / ProGuard keep 规则建议。
- 分析 mapping.txt，确认类名、方法名和字典输出是否符合预期。
- 对混淆后的 stack trace 做还原，帮助定位线上崩溃。
功能细节
能力 1
扫描常见反射、序列化、数据库实体和 SDK 模式。
能力 2
生成或补充 R8 / ProGuard keep 规则建议。
能力 3
分析 mapping.txt，确认类名、方法名和字典输出是否符合预期。
能力 4
对混淆后的 stack trace 做还原，帮助定位线上崩溃。
典型工作流
- 扫描项目依赖和源码中可能需要 keep 的模式。
- 审查并应用推荐 R8 / ProGuard 规则。
- 选择混淆字典并运行 release 构建。
- 使用 mapping 分析和 stack trace 反混淆排查问题。
适合的使用场景
- 首次开启 minifyEnabled true。
- 排查 release 包才出现的反射或序列化崩溃。
- 配置 ProGuard obfuscation dictionary、class dictionary 或 package dictionary。
开始使用
- 在 ADB Pro 工具窗口中打开 R8 Assistant 标签页。
- 确认当前 Android 项目已经完成 Gradle 同步，并选择需要处理的模块或产物。
- 按页面提示执行扫描、分析或生成操作。
- 查看结果、日志和建议，再决定是否应用到项目配置中。
验证方式
- 重新执行相关 Gradle 构建或分析任务，确认没有新的错误。
- 检查输出日志和 IDE 面板结果，确认状态、路径和产物符合预期。
- 如果改动会影响 release 包，建议结合 Release Readiness 再做一次发布前检查。
常见问题
这个功能会直接修改项目文件吗？
默认以扫描、分析和结果展示为主。只有在你明确执行应用、生成或注入配置等操作时，才会修改项目文件。
适合在发版前什么时候运行？
建议在 release 构建产物生成后运行，并在上传应用商店或交给 QA 前结合 Release Readiness 做一次完整确认。
它和其他 ADB Pro 功能如何配合？
这个功能通常和 Build Tools、AAB Tools、Signing Tools 或 Release Readiness 串联使用，用来把单点操作放进完整 Android 发版流程。