🤖 Obfu[DE]scate：Android APK 的反混淆与对比工具。📱

Obfu[DE]scate 是一个 Python 工具，旨在简化对两个版本 Android APK 进行反混淆和对比的过程——即使函数名已被混淆重命名。通过模糊对比逻辑，Obfu[DE]scate 可以识别函数之间的相似性，帮助您发现 APK 版本之间的变更。

➡️ 开始上手

安装

Obfu[DE]scate 的安装非常简单！请按照以下步骤操作：

1. 将仓库克隆到本地机器。
2. 手动安装依赖项，或通过包含的 requirements 文件使用以下命令安装：

pip install -r REQUIREMENTS.txt

3. 从官网下载适合您系统的 APKTool，并确保已安装且可在 PATH 中找到。

Obfu[DE]scate 已在 Windows 11 上测试过，但也应能在其他系统上运行。

运行

Obfu[DE]scate 提供多个命令行选项来自定义其行为：

要对比两个 APK 文件，只需使用以下命令运行 Obfu[DE]scate：

python ObfuDeScate.py -a1 "old_example.apk" -a2 "new_example.apk" -cp "com.example.path"

在上述示例中，Obfu[DE]scate 将审查 old_example.apk 中位于类路径 com.example.path 的所有函数，并与 new_example.apk 中同一类路径下的所有函数进行对比。

🔎 输出结果

Obfu[DE]scate 生成两个输出文件：一个以换行符分隔的映射文件，以及一个交互式 HTML 文件。这些输出文件包括：

• mapping.txt - 一个换行分隔的文本文件，每一行对应 APK1 和 APK2 中一个方法之间的匹配。行格式如下：com.chess.play.ObserveGameHelperImpl.d -> com.chess.play.ObserveGameHelperImpl.a 。
• output.html - 一个 HTML 文件，在浏览器中打开后会列出 APK1 中的所有函数。这些函数以下拉列表形式呈现，点击后会显示 APK2 中匹配的方法（如有）、匹配的置信度，以及来自 APK1 和 APK2 的 SMALI 代码块。

🙏 贡献

Obfu[DE]scate 是一个开源项目，欢迎社区贡献力量。如果您想为 Obfu[DE]scate 做出贡献，请遵循以下指南：

• 将仓库 fork 到您自己的 GitHub 账户。
• 创建一个具有描述性名称的新分支，用于您的贡献。
• 进行更改并彻底测试。
• 向主仓库提交拉取请求，并附上详细的更改说明及相关文档。
• 等待维护者的反馈，并处理任何评论或建议（如有）。
• 您的更改经过审查和批准后，将被合并到主仓库中。

⚖️ 行为准则

Obfu[DE]scate 遵循贡献者公约行为准则。请在为 Obfu[DE]scate 贡献时查看并遵守该行为准则。

🐛 错误报告与功能请求

如果您遇到错误或有新功能建议，请在 GitHub 仓库中创建一个 issue。请尽可能提供详细信息，包括重现该问题的步骤或对提议功能的清晰描述。您的反馈非常有价值，将有助于改进 Obfu[DE]scate，让每个人受益。

💛 致谢

此工具离不开 APKTool！其次，本 README 中的许多示例以 Chess.com 应用为基础，可在此处查看。

📜 许可证

GNU General Public License v3.0