如何对已上传至Maven Central的自研Android库进行R8反混淆？

一、混淆后的库部署到Maven Central后代码会不可读吗？ #

没错，只要你正确配置了Gradle的Minify和ProGuard规则，编译出的AAR/JAR库字节码会被混淆处理：原始类名、方法名、变量名会被替换成无意义的短标识（比如a、b、c），冗余代码会被剔除，未被引用的类/方法会被删除，同时还会做字节码层面的优化。其他人拿到你的库反编译后，得到的是逻辑混乱、难以理解的代码，能有效保护你的源码逻辑。

需要注意的是：如果ProGuard规则配置有误（比如不小心保留了过多内部类或方法名），混淆效果会大打折扣。所以针对库的场景，一定要确保规则只保留对外暴露的API类、方法和必要的组件，避免影响调用方的正常使用。

二、用mapping.txt反混淆崩溃日志的方法 #

mapping.txt是ProGuard混淆时生成的映射文件，记录了原始代码元素和混淆后名称的对应关系。每个版本的混淆库都对应唯一的mapping.txt，必须妥善保存，丢了就没法恢复原始信息了。下面是几种常用的反混淆方法：

1. Android Studio自带工具快速处理 #

• 打开Android Studio，点击顶部菜单栏的 Tools > Analyze > Analyze Stacktrace
• 在弹出的窗口里粘贴混淆后的崩溃日志，然后点击底部的 Load mapping，选择对应版本的mapping.txt
• 点击OK，工具会自动把混淆后的日志转换成带原始类名、方法名和行号的清晰日志

2. 用retrace命令行工具处理 #

Android SDK自带了retrace工具，路径一般是<SDK目录>/tools/proguard/bin/下的retrace.sh（Mac/Linux）或retrace.bat（Windows）：

• 处理日志文件的命令：

  retrace.sh -verbose mapping.txt 混淆日志文件.txt > 反混淆结果.txt
  

• 直接输入日志内容的方式：

  retrace.sh mapping.txt
  

  粘贴混淆日志后，按Ctrl+D（Mac/Linux）或Ctrl+Z（Windows）结束输入，工具会实时输出反混淆后的内容

3. 手动查找映射（仅适合简单场景） #

直接打开mapping.txt，搜索混淆后的类名/方法名，找到对应的原始名称。mapping.txt的格式大概是：

com.example.MySdkClass -> a:
    java.lang.String mySdkParam -> a
    void initSdk() -> a

这种方式效率低，只适合单条日志的快速查询，大规模日志还是用工具更靠谱

关键注意点 #

• 每个版本的库都要对应保存好mapping.txt，建议和版本号绑定归档（比如上传到Maven Central时，可以把mapping.txt作为附属构件上传，或者存到自己的版本控制系统里）
• 千万别泄露mapping.txt，否则别人可以用它完全反混淆你的库，混淆就失去意义了
• 发布到Maven Central的库，一定要提前做好mapping.txt的备份，方便后续调试用户反馈的崩溃问题

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