Skip to content
Back to search

android-reverse-engineering-skill

Claude Code plugins for Android reverse engineering

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/credittone--android-reverse-engineering-skill/badge.svg)](/listings/credittone--android-reverse-engineering-skill)

HTML

<a href="/listings/credittone--android-reverse-engineering-skill"><img src="/api/listings/credittone--android-reverse-engineering-skill/badge.svg" alt="findsafeskills safety rating" /></a>

Install

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

# 克隆仓库
git clone https://github.com/SimoneAvogadro/android-reverse-engineering-skill.git

# 创建技能符号链接
mkdir -p ~/.claude/skills
ln -sfn $(pwd)/android-reverse-engineering-skill/android-reverse-engineering/skills/android-reverse-engineering ~/.claude/skills/android-reverse-engineering

# 创建命令符号链接
mkdir -p ~/.claude/commands
ln -sfn $(pwd)/android-reverse-engineering-skill/android-reverse-engineering/commands/decompile.md ~/.claude/commands/decompile.md

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

.claude-plugin/marketplace.json · Manifest · 27 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. {
  2. "$schema": "https://anthropic.com/claude-code/marketplace.schema.json",
  3. "name": "android-reverse-engineering-skill",
  4. "description": "Claude Code plugins for Android reverse engineering",
  5. "owner": {
  6. "name": "Simone Avogadro"
  7. },
  8. "metadata": {
  9. "description": "Claude Code plugins for Android reverse engineering",
  10. "version": "1.0.0"
  11. },
  12. "plugins": [
  13. {
  14. "name": "android-reverse-engineering",
  15. "source": "./android-reverse-engineering",
  16. "description": "Decompile Android APK/JAR/AAR with jadx, trace call flows through libraries, and document extracted APIs.",
  17. "version": "1.0.0",
  18. "author": {
  19. "name": "Simone Avogadro"
  20. },
  21. "repository": "https://github.com/SimoneAvogadro/android-reverse-engineering-skill",
  22. "license": "Apache-2.0",
  23. "keywords": ["android", "reverse-engineering", "apk", "jadx", "decompile", "api-extraction"],
  24. "category": "security"
  25. }
  26. ]
  27. }
README.md · README · 281 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. # android-reverse-engineering-skill
  2. Android 逆向分析全家桶 — 从 APK 反编译到 Frida 动态插桩、从 HTTP 接口提取到 JNI/SO 原生层逆向,覆盖静态分析→动态分析→流量解密→签名追踪的完整链路。支持 Claude Code / Codex 双平台,兼容 macOS、Linux、Windows(PowerShell),一套技能打通 Android 安全研究与授权渗透测试的绝大部分需求。
  3. ## 亮点
  4. - **双引擎反编译**:jadx + Fernflower/Vineflower,自动对比、择优输出
  5. - **完整调用链追踪**:从 Activity/Fragment → ViewModel → Repository → Retrofit/OkHttp,一路不迷路
  6. - **API 全量提取**:Retrofit 接口、OkHttp 请求、硬编码 URL、鉴权头、Token、签名参数一键搜出
  7. - **Frida 脚本武装**:9 个实战级 Frida 脚本开箱即用 — SSL 日志、DEX/SO dump、JNI 追踪、加密 hook、Root/Frida 检测绕过、KeyStore 证书导出
  8. - **Native 层分析**:JNI 注册追踪、SO 符号/导出分析、签名/加密边界定位、unidbg 模拟前的完整静态侦察
  9. - **XAPK / 套壳 APK 自动解包**:自动识别分包结构,直取业务核心 base.apk
  10. - **跨平台**:Bash 脚本 + PowerShell 脚本双栈,macOS/Linux/Windows 通吃
  11. - **智能依赖安装**:一键检查 + 自动安装缺失工具,无 sudo 时自动降级为手动指引
  12. ## 与原项目的差异
  13. 基于 [SimoneAvogadro/android-reverse-engineering-skill](https://github.com/SimoneAvogadro/android-reverse-engineering-skill) 做了大幅扩展:
  14. | 方面 | 原项目 | 本仓库 |
  15. |---|---|---|
  16. | 平台支持 | Claude Code | Claude Code + Codex 双平台 |
  17. | 反编译引擎 | jadx | jadx + Fernflower/Vineflower 双引擎对比 |
  18. | 动态分析 | 概念提及 | 完整 Frida 实战指导 + 9 个开箱即用脚本 |
  19. | Native 分析 | 无 | JNI/SO 完整分析流程 + rizin 命令参考 |
  20. | Windows 支持 | 无 | 完整 PowerShell 脚本栈 |
  21. | XAPK/套壳 | 基础支持 | 自动递归解包 + 分包识别 |
  22. | 依赖管理 | 手动 | 一键检查 + 跨平台自动安装 |
  23. | Frida 脚本 | 无 | 9 个实战脚本(SSL、DEX dump、SO dump、JNI trace、加密 hook、检测绕过、证书导出) |
  24. | 文档语言 | 英文 | 中文 |
  25. ## 功能总览
  26. ### 静态分析
  27. - jadx / Fernflower / Vineflower 三种引擎反编译 APK、XAPK、JAR、AAR
  28. - 自动解析 AndroidManifest.xml、包结构、架构模式(MVP/MVVM/Clean Architecture)
  29. - 混淆代码处理:ProGuard/R8 混淆下的字符串锚点定位策略
  30. ### API 与网络层
  31. - 自动提取 Retrofit 接口、OkHttp 调用、硬编码 URL、鉴权头、Token
  32. - 请求/响应结构还原,Base URL + Path + Headers + Body 完整文档化
  33. - 签名参数与加密入口定位
  34. ### 调用链追踪
  35. - Activity → ViewModel/Presenter → Repository → API Service → HTTP Call
  36. - Dagger/Hilt 依赖注入绑定映射
  37. - 混淆类名下的 Retrofit 注解锚点导航
  38. ### Frida 动态插桩(9 个脚本开箱即用)
  39. | 脚本 | 功能 |
  40. |---|---|
  41. | `ssl_log.js` | TLS 密钥日志导出,解密 HTTPS 流量 |
  42. | `dump_dex.js` | 内存 DEX dump,对抗加固/动态加载 |
  43. | `dump_so.js` | 内存 SO dump,保留完整 ELF 结构 |
  44. | `jni_method_trace.js` | JNI 调用全量追踪,可指定目标 SO |
  45. | `hook_artmethod_register.js` | ART Method 注册 hook,追踪 Native→Java 绑定 |
  46. | `hook_encryption_algo.js` | AES/DES/RSA/哈希等加密算法调用拦截 |
  47. | `keystore_dump.js` | 双向认证场景下客户端证书导出为 p12 |
  48. | `bypass_root_detect.js` | 通用 Root 检测绕过(含 Magisk 检测) |
  49. | `bypass_frida_svc_detect.js` | Frida SVC 指令级检测绕过(ARM32/ARM64) |
  50. ### Native / JNI / SO 分析
  51. - `native` 方法声明 → `System.loadLibrary` → SO 定位
  52. - `JNI_OnLoad` → `RegisterNatives` 动态注册追踪
  53. - rizin/readelf/nm/objdump 多工具栈 SO 分析
  54. - 签名/加密生成边界判断:Java 层还是 Native 层?
  55. ## 依赖要求
  56. **必需:**
  57. - Java JDK 17+
  58. - [jadx](https://github.com/skylot/jadx) 命令行工具
  59. **可选但推荐:**
  60. - [Vineflower](https://github.com/Vineflower/vineflower) / [Fernflower](https://github.com/JetBrains/fernflower) — 复杂 Java 代码更优输出
  61. - [dex2jar](https://github.com/pxb1988/dex2jar) — APK/DEX 配合 Fernflower 使用
  62. - [Rizin](https://rizin.re/) — SO / JNI / Native 导出符号与反汇编
  63. - [Frida](https://frida.re/) — 运行时动态插桩
  64. - [adb](https://developer.android.com/tools/adb) — 设备连接与脚本推送
  65. ## 安装
  66. ```bash
  67. # 克隆仓库
  68. git clone https://github.com/SimoneAvogadro/android-reverse-engineering-skill.git
  69. # 创建技能符号链接
  70. mkdir -p ~/.claude/skills
  71. ln -sfn $(pwd)/android-reverse-engineering-skill/android-reverse-engineering/skills/android-reverse-engineering ~/.claude/skills/android-reverse-engineering
  72. # 创建命令符号链接
  73. mkdir -p ~/.claude/commands
  74. ln -sfn $(pwd)/android-reverse-engineering-skill/android-reverse-engineering/commands/decompile.md ~/.claude/commands/decompile.md
  75. ```
  76. ## 使用方式
  77. ### Slash 命令
  78. ```
  79. /decompile path/to/app.apk
  80. ```
  81. 自动完成:依赖检查 → 反编译 → 结构分析 → 下一步建议。
  82. ### 自然语言触发
  83. - "反编译这个 APK"
  84. - "逆向分析这个应用"
  85. - "提取这个应用的接口和签名"
  86. - "从 LoginActivity 开始跟调用链"
  87. - "分析这个 AAR/JAR 库"
  88. - "找出这个 sign 是在 Java 还是 native 层生成的"
  89. - "用 Frida 分析请求加密链路"
  90. - "dump 这个加固应用的 DEX"
  91. - "绕过这个 app 的 SSL pinning 和 root 检测"
  92. - "分析这个 SO 的 JNI 导出函数"
  93. ### 手动执行脚本
  94. ```bash
  95. SKILL_DIR="android-reverse-engineering/skills/android-reverse-engineering/scripts"
  96. # === 依赖管理 ===
  97. bash $SKILL_DIR/check-deps.sh
  98. bash $SKILL_DIR/install-dep.sh jadx
  99. bash $SKILL_DIR/install-dep.sh vineflower
  100. bash $SKILL_DIR/install-dep.sh rizin
  101. # === 反编译 ===
  102. bash $SKILL_DIR/decompile.sh app.apk # jadx 默认
  103. bash $SKILL_DIR/decompile.sh --engine fernflower library.jar # Fernflower
  104. bash $SKILL_DIR/decompile.sh --engine both app.apk # 双引擎对比
  105. bash $SKILL_DIR/decompile.sh app-bundle.xapk # XAPK 自动解包
  106. # === API 提取 ===
  107. bash $SKILL_DIR/find-api-calls.sh output/sources/
  108. bash $SKILL_DIR/find-api-calls.sh output/sources/ --retrofit
  109. bash $SKILL_DIR/find-api-calls.sh output/sources/ --urls
  110. bash $SKILL_DIR/find-api-calls.sh output/sources/ --auth
  111. ```
  112. ### Windows / PowerShell
  113. ```powershell
  114. $SKILL_DIR="android-reverse-engineering/skills/android-reverse-engineering/scripts"
  115. & "$SKILL_DIR/check-deps.ps1"
  116. & "$SKILL_DIR/install-dep.ps1" jadx
  117. & "$SKILL_DIR/decompile.ps1" app.apk
  118. & "$SKILL_DIR/find-api-calls.ps1" output/sources/ -Retrofit
  119. ```
  120. ### Frida 脚本使用
  121. ```bash
  122. # SSL 密钥日志(配合 Wireshark 解密 HTTPS)
  123. frida -U -f com.example.app -l ssl_log.js --no-pause
  124. # Dump 内存中的 DEX(对抗加固/动态加载)
  125. frida -U -f com.example.app -l dump_dex.js --no-pause
  126. # Dump 内存中的 SO(保留 ELF 完整结构)
  127. frida -U -f com.example.app -l dump_so.js --no-pause
  128. # 追踪指定 SO 的 JNI 调用
  129. frida -U -f com.example.app -l jni_method_trace.js --no-pause
  130. # Hook 加密/解密算法调用
  131. frida -U -f com.example.app -l hook_encryption_algo.js --no-pause
  132. # 绕过 Root 检测
  133. frida -U -f com.example.app -l bypass_root_detect.js --no-pause
  134. # 绕过 Frida SVC 指令级检测
  135. frida -U -f com.example.app -l bypass_frida_svc_detect.js --no-pause
  136. # 导出双向认证客户端证书
  137. frida -U -f com.example.app -l keystore_dump.js --no-pause
  138. # Hook ART Method 注册(追踪 Native→Java 绑定)
  139. frida -U -f com.example.app -l hook_artmethod_register.js --no-pause
  140. ```
  141. ## SO / Native 分析
  142. 当 Java 层分析看到 `native` 方法、`System.loadLibrary()` 或 `RegisterNatives` 时:
  143. ```bash
  144. # ELF 元数据
  145. rz-bin -I libfoo.so && rz-bin -s libfoo.so && rz-bin -i libfoo.so
  146. # 字符串速查
  147. rz-strings -a libfoo.so | rg 'http|https|Java_|JNI_OnLoad|encrypt|sign|ssl|socket'
  148. # JNI_OnLoad 反汇编
  149. rizin -qc "aaa; pdf @ sym.JNI_OnLoad; q" libfoo.so
  150. # 无 rizin 时回退
  151. readelf -Ws libfoo.so && nm -D libfoo.so | rg 'JNI_OnLoad|Java_'
  152. objdump -d libfoo.so > libfoo.asm
  153. ```
  154. ## 反编译命名策略
  155. 首次反编译**不要加 `--deobf`**:
  156. - 类名更接近 dex 运行时真实名称
  157. - 适合后续 `FindClass`、`Class.forName`、Frida hook、unidbg 模拟
  158. `--deobf` 适用于:
  159. - 代码严重混淆,优先提升阅读体验
  160. - 纯静态分析、不需要对接运行时类名
  161. - 作为第二份输出与原始版本对照
  162. ## 仓库结构
  163. ```
  164. android-reverse-engineering-skill/
  165. ├── .claude-plugin/
  166. │ └── marketplace.json
  167. ├── android-reverse-engineering/
  168. │ ├── .codex-plugin/
  169. │ │ └── plugin.json
  170. │ ├── .claude-plugin/
  171. │ │ └── plugin.json
  172. │ ├── commands/
  173. │ │ └── decompile.md
  174. │ └── skills/
  175. │ └── android-reverse-engineering/
  176. │ ├── SKILL.md
  177. │ ├── references/
  178. │ │ ├── setup-guide.md
  179. │ │ ├── jadx-usage.md
  180. │ │ ├── fernflower-usage.md
  181. │ │ ├── api-extraction-patterns.md
  182. │ │ ├── call-flow-analysis.md
  183. │ │ ├── dynamic-analysis.md
  184. │ │ └── native-analysis.md
  185. │ └── scripts/
  186. │ ├── check-deps.sh / .ps1 # 依赖检查
  187. │ ├── install-dep.sh / .ps1 # 自动安装
  188. │ ├── decompile.sh / .ps1 # 反编译
  189. │ ├── find-api-calls.sh / .ps1 # API 提取
  190. │ ├── ssl_log.js # TLS 密钥导出
  191. │ ├── dump_dex.js # 内存 DEX dump
  192. │ ├── dump_so.js # 内存 SO dump
  193. │ ├── jni_method_trace.js # JNI 调用追踪
  194. │ ├── hook_artmethod_register.js # ART 注册 hook
  195. │ ├── hook_encryption_algo.js # 加密算法 hook
  196. │ ├── keystore_dump.js # 证书导出
  197. │ ├── bypass_root_detect.js # Root 检测绕过
  198. │ └── bypass_frida_svc_detect.js # Frida 检测绕过
  199. ├── LICENSE
  200. └── README.md
  201. ```
  202. ## 参考项目
  203. - [jadx](https://github.com/skylot/jadx) — DEX to Java 反编译器
  204. - [Fernflower](https://github.com/JetBrains/fernflower) — JetBrains 反编译器
  205. - [Vineflower](https://github.com/Vineflower/vineflower) — Fernflower 社区分支
  206. - [dex2jar](https://github.com/ThexXTURBOXx/dex2jar) — DEX 转 JAR
  207. - [apktool](https://apktool.org/) — Android 资源解码
  208. - [Rizin](https://rizin.re/) — 开源二进制逆向工具链
  209. - [Frida](https://frida.re/) — 动态插桩框架
  210. - [unidbg](https://github.com/zhkl0228/unidbg) — 无设备 SO 模拟执行
  211. ## 免责声明
  212. 本工具仅可用于**合法用途**:
  213. - 安全研究与经授权的渗透测试
  214. - 适用法律范围内的互操作性分析
  215. - 恶意软件分析与应急响应
  216. - 教学用途与 CTF 比赛
  217. **你需自行确保**使用行为符合所在司法辖区法律、法规及目标软件服务条款。对未授权软件进行逆向可能触犯知识产权或计算机相关法律。作者不对任何滥用行为承担责任。
  218. ## 许可证
  219. Apache 2.0,见 [LICENSE](LICENSE)

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.