Android 逆向工程环境搭建完全指南Java、jadx、Vineflower 与 dex2jar 安装配置详解【免费下载链接】android-reverse-engineering-skillClaude Code skill to support Android apps reverse engineering项目地址: https://gitcode.com/GitHub_Trending/an/android-reverse-engineering-skill本篇技术指南以 Android 逆向工程技能android-reverse-engineering-skill的 setup-guide.md 为骨架系统讲解逆向分析 APK/XAPK/JAR/AAR 所需的完整工具链安装Java JDK 17、jadx 反编译器、Fernflower/Vineflower 反编译器、dex2jar 转换器以及 apktool、adb 等辅助工具。读者学完本文后将能够针对 Ubuntu/Debian、Fedora、Arch Linux、macOS 与 Windows 环境从零搭建一套可用的 Android 逆向环境并通过仓库自带的依赖检查与自动安装脚本一键完成配置与验证。一、工具链全景与依赖关系在动手安装之前先明确这套工具链中每个组件的角色及其上下游依赖关系。整个逆向流程是一条清晰的数据流水线组件角色必需性Java JDK 17jadx、Vineflower、dex2jar 全部基于 JVM 运行必需jadx将 APK/JAR/AAR/DEX 直接反编译为可读 Java 源码并解码资源必需Fernflower / VineflowerJetBrains 系反编译器对复杂 Java 结构lambda、泛型、stream输出质量更高可选推荐dex2jar将 DEX 字节码转换为标准 JAR是 Fernflower 处理 APK 文件的必经中间步骤可选配合 Fernflower 时必需apktool解码 XML 布局、drawable 等资源弥补 jadx 在部分资源上的不足可选adb从已连接的真机/模拟器直接拉取 APK 文件可选值得注意的是仓库源码对依赖的定位与本文档完全一致。check-deps.sh 中将java与jadx归为必需依赖缺失即返回退出码 1而将vineflower、dex2jar、apktool、adb归为可选依赖缺失仅打印INSTALL_OPTIONAL:提示不阻塞流程。这套必需 可选的双层模型贯穿整个技能工作流安装时建议遵循同样的优先级。二、安装前置Java JDK 17jadx 要求 Java 17 或更高版本这是整个工具链的硬性前提。若 Java 版本过低或缺失后续所有工具都无法启动最常见的报错即为Error: Could not find or load main class。2.1 各平台安装命令Ubuntu / Debianaptsudo apt update sudo apt install openjdk-17-jdkFedoradnfsudo dnf install java-17-openjdk-develArch Linuxpacmansudo pacman -S jdk17-openjdkmacOSHomebrewbrew install openjdk17macOS 下 Homebrew 的 openjdk17 是 keg-only 安装不会自动进入 PATH。安装完成后请按照 Homebrew 输出的 symlink 提示操作或手动将以下行加入 shell 配置文件export PATH/opt/homebrew/opt/openjdk17/bin:$PATHWindows 用户仓库提供了 PowerShell 版本脚本安装逻辑等价于 Unix 平台。install-dep.ps1 中 Java 的安装顺序是 wingetMicrosoft.OpenJDK.17→ scoopopenjdk17→ chocoopenjdk17三者均不可用时才提示手动安装。2.2 验证安装java -version # Should show version 17.x or higher从源码看check-deps.sh 中定义了硬性阈值REQUIRED_JAVA_MAJOR17脚本会解析java -version输出的主版本号兼容17.0.1与旧式1.8.0两种格式只有主版本号 ≥ 17 时才判定为[OK]版本不足或解析失败都会计入错误并输出INSTALL_REQUIRED:java。若你的环境同时安装了多个 JDK可通过update-alternatives --config javaDebian 系或archlinux-java set java-17-openjdkArch切换默认版本。三、jadx核心反编译器jadx 是一个 Dex 到 Java 的反编译器负责将 APK/JAR/AAR 文件转换为可读的 Java 源码同时解码 AndroidManifest.xml、布局等资源。它是整套技能的主引擎默认的decompile.sh调用即使用 jadx输出结构为output/sources/Java 源码与output/resources/解码资源。3.1 方式一GitHub Releases 安装推荐前往 jadx 官方 Releases 页面下载jadx-version.zip发行包注意不要下载源码压缩包解压并加入 PATHunzip jadx-*.zip -d ~/jadx export PATH$HOME/jadx/bin:$PATH # Add the export line to your ~/.bashrc or ~/.zshrc for persistencebin/目录下同时包含命令行工具jadx与图形界面jadx-gui。3.2 方式二HomebrewmacOS / Linuxbrew install jadx3.3 方式三源码构建git clone https://github.com/skylot/jadx.git cd jadx ./gradlew dist # Binaries will be in build/jadx/bin/ export PATH$(pwd)/build/jadx/bin:$PATH源码构建适合需要调试 jadx 本身或体验最新未发布特性的场景。3.4 自动安装与验证仓库提供的 install-dep.sh 封装了 jadx 的自动安装在 macOS 上优先走 Homebrew在其他 Linux 发行版上则自动从 GitHub Releases 查询最新 tag下载 zip 解压到~/.local/share/jadx/并在~/.local/bin/中创建jadx与jadx-gui的符号链接全程无需 sudo。安装完成后验证jadx --version若输出jadx: command not found说明bin/目录或~/.local/bin/尚未加入$PATH请检查 shell 配置文件中的 export 行。四、Fernflower / Vineflower高质量反编译引擎可选推荐Fernflower 是 JetBrains 出品的 Java 反编译器在复杂 Java 结构lambda、泛型、stream上的输出质量优于 jadx。Vineflower 是社区持续维护的 Fernflower 分支提供官方 Releases 发布建议优先选择 Vineflower 而非上游 Fernflower——两者共享完全相同的 CLI 接口Vineflower 是 drop-in replacement同时改进了对现代 Java 特性record、sealed class、pattern matching的处理。4.1 方式一Vineflower 官方 Release推荐前往 Vineflower Releases 页面下载vineflower-version.jar存放 JAR 并设置环境变量mkdir -p ~/vineflower mv vineflower-*.jar ~/vineflower/vineflower.jar export FERNFLOWER_JAR_PATH$HOME/vineflower/vineflower.jar # Add the export to ~/.bashrc or ~/.zshrc for persistenceFERNFLOWER_JAR_PATH环境变量是仓库脚本定位 JAR 的关键decompile.sh与check-deps.sh都会优先读取该变量随后依次探测~/fernflower/build/libs/fernflower.jar、~/vineflower/build/libs/vineflower.jar、~/fernflower/fernflower.jar、~/vineflower/vineflower.jar等常见位置。4.2 方式二源码构建 Fernflowergit clone https://github.com/JetBrains/fernflower.git cd fernflower ./gradlew jar # Produces: build/libs/fernflower.jar export FERNFLOWER_JAR_PATH$(pwd)/build/libs/fernflower.jar4.3 方式三HomebrewVineflowerbrew install vineflower4.4 验证java -jar $FERNFLOWER_JAR_PATH --version重要限制Fernflower 只能处理 JVM 字节码JAR、class 文件。对于 APK/DEX 文件必须先用 dex2jar 完成 DEX → JAR 的中间转换详见下一节。这一限制在 check-deps.sh 中也有体现——dex2jar 被明确标注为optional — needed to use Fernflower on APK/DEX files。4.5 推荐 CLI 预设Fernflower 的选项格式为-keyvalue布尔值1表示启用、0表示禁用。常用预设组合如下常规使用java -jar fernflower.jar -dgs1 -mpm60 input.jar output/混淆代码java -jar fernflower.jar -dgs1 -ren1 -mpm60 input.jar output/最大信息量java -jar fernflower.jar -dgs1 -hes0 -hdc0 -mpm60 input.jar output/带 Android SDK 上下文提升类型解析准确度java -jar fernflower.jar -dgs1 -mpm60 -e$ANDROID_HOME/platforms/android-34/android.jar input.jar output/其中-dgs1反编译泛型签名、-mpm60为每个方法设置 60 秒超时防止挂死、-ren1重命名混淆标识符。decompile.sh在调用 Fernflower 时自动注入-dgs1 -mpm60并在指定--deobf时追加-ren1与上述预设完全对齐。五、dex2jarDEX 转 JAR 转换器可选配合 Fernflower 使用 APK 必需dex2jar 将 Android DEX 字节码转换为标准 Java JAR 文件是 Fernflower 处理 APK 时不可绕过的中间环节。5.1 GitHub Releases 安装前往 dex2jar 维护分支的 Releases 页面下载发行包解压并加入 PATHunzip dex-tools-*.zip -d ~/dex2jar export PATH$HOME/dex2jar:$PATH5.2 Homebrew 安装brew install dex2jar5.3 验证d2j-dex2jar --help注意脚本同时接受d2j-dex2jar与d2j-dex2jar.sh两种命令名对应 Unix 与部分发行版包管理器安装的差异check-deps.sh对两者都做了探测。5.4 典型用法# Convert APK (or DEX) to JAR d2j-dex2jar -f -o output.jar app.apk # Then decompile with Fernflower java -jar vineflower.jar output.jar decompiled/在仓库的完整 APK 工作流中decompile.sh 使用--engine fernflower处理 APK/AAR 时会自动执行dex2jar 转换 → Fernflower 反编译 → 解包源码 JAR三步转换产物存放在output/intermediate/中间目录成功后自动清理。六、可选辅助工具apktool 与 adb6.1 apktool资源解码器jadx 对部分 XML 布局、drawable 等资源的处理效果不佳此时 apktool 是有效的补充手段。# Ubuntu/Debian sudo apt install apktool # macOS brew install apktoolapktool 在 check-deps.sh 中被归为可选依赖主要用于资源解码场景。6.2 adb从设备拉取 APK当目标 APK 不在本地、仅存在于已连接的 Android 设备时adb 是从设备提取 APK 的标准途径。# Ubuntu/Debian sudo apt install adb # macOS brew install android-platform-tools从设备拉取 APK 的完整三步流程# 1. 列出已安装的应用包名按关键词过滤 adb shell pm list packages | grep keyword # 2. 获取目标应用的 APK 路径 adb shell pm path com.example.app # 3. 拉取 APK 到本地 adb pull /data/app/com.example.app-xxxx/base.apk ./app.apk对于采用 split APK 架构的应用pm path会输出多个路径需要逐个拉取 base APK 与各 split APK。七、依赖检查与自动安装把环境配置脚本化仅靠手工逐条安装命令效率不高且容易遗漏可选组件。仓库为此提供了完整的自动化配套脚本与 setup-guide 相辅相成7.1 一键检查check-depsbash plugins/android-reverse-engineering/skills/android-reverse-engineering/scripts/check-deps.shWindows PowerShell 对应版本 plugins/android-reverse-engineering/skills/android-reverse-engineering/scripts/check-deps.ps1脚本输出人类可读的[OK]/[MISSING]逐项状态并附上机器可解析的摘要行INSTALL_REQUIRED:dep表示必需依赖缺失阻塞流程INSTALL_OPTIONAL:dep表示可选依赖缺失不阻塞。检查项覆盖 Java、jadx、Vineflower/Fernflower含FERNFLOWER_JAR_PATH与常见 JAR 路径探测、dex2jar、apktool、adb 共六类。任何必需依赖缺失时脚本以退出码 1 结束。7.2 一键安装install-depbash plugins/android-reverse-engineering/skills/android-reverse-engineering/scripts/install-dep.sh dep支持的依赖名java、jadx、vineflower或fernflower、dex2jar、apktool、adb。脚本自动探测操作系统与包管理器brew / apt / dnf / pacman其安装策略为优先免 sudo 安装从 GitHub Releases 下载到~/.local/share/在~/.local/bin/建立符号链接并将 PATH 写入 shell 配置文件依次尝试~/.zshrc、~/.bashrc、~/.profile必要时使用系统包管理器通过sudo apt-get/dnf/pacman安装前提是 sudo 可用两者都不可行时打印精确的手工安装命令并以退出码 2 结束等待用户手动处理。Windows 上 install-dep.ps1 采用 winget → scoop → choco 的探测顺序均不可用时直接下载到%USERPROFILE%\.local\share\并写入用户 PATH。安装完成后需重新运行check-deps确认全部就绪——PowerShell 版本的 check 脚本会自动从用户环境刷新 PATH无需重启终端。八、故障排查速查表问题解决方案jadx: command not found确认 jadx 的bin/目录或~/.local/bin/已加入$PATHError: Could not find or load main classJava 缺失或版本错误——用java -version验证是否为 17大 APK 反编译时 jadx 内存不足增加堆内存jadx -Xmx4g -d output app.apk或设置JAVA_OPTS-Xmx4g反编译结果大量// Error注释尝试--show-bad-code查看部分输出混淆应用可加--deobfFernflower 在某个方法上挂死使用-mpm60为每个方法设置 60 秒超时Fernflower JAR 找不到将FERNFLOWER_JAR_PATH环境变量设为 JAR 的完整路径dex2jar 报ZipExceptionAPK 可能是非标准 ZIP 结构——改用 jadx 处理8.1 排查要点补充说明内存参数jadx 的-Xmx是 JVM 堆参数可直接与-d等选项混用jadx-usage.md 中还记录了--threads-count N默认按 CPU 数用于控制并发线程数。--show-bad-code让 jadx 输出部分反编译代码而非错误注释配合--no-res可快速获取仅源码的概览。混淆处理对于 R8/ProGuard 混淆应用--deobf会生成deobf-mapping.txt映射文件若持有官方 ProGuard mapping 文件可用--deobf-map mapping.txt直接导入。Fernflower 超时兜底decompile.sh还会用 GNUtimeout对整个 Fernflower 进程设置总超时默认 900 秒可用FERNFLOWER_TIMEOUT_SECONDS覆盖双保险防止卡死。九、安装后的完整工作流验证环境就绪后可结合技能工作流做一次端到端验证。在 Claude Code 中执行/decompile path/to/app.apk或在命令行手动串联以下步骤# 1. 依赖检查应全部 OK 或仅剩可选项 bash plugins/android-reverse-engineering/skills/android-reverse-engineering/scripts/check-deps.sh # 2. 反编译前的快速指纹识别可选但强烈推荐 bash plugins/android-reverse-engineering/skills/android-reverse-engineering/scripts/fingerprint.sh app.apk # 3. 用 jadx 反编译 bash plugins/android-reverse-engineering/skills/android-reverse-engineering/scripts/decompile.sh app.apk # 4. 双引擎对比安装 Vineflower dex2jar 后 bash plugins/android-reverse-engineering/skills/android-reverse-engineering/scripts/decompile.sh --engine both --deobf app.apk对于 Flutter、React Native、Cordova、Xamarin 应用指纹脚本会直接建议改用框架对应工具如 Flutter 使用 blutter /strings libapp.so因为 Java 反编译几乎拿不到真正的应用逻辑——这是避免在错误方向浪费时间的关键前置判断。结语本文完整覆盖了 Android 逆向工程技能android-reverse-engineering-skill的环境搭建链路从 Java JDK 17 这一硬性前提出发依次部署 jadx 核心反编译器、Vineflower/Fernflower 高质量反编译引擎、dex2jar 中间转换器以及 apktool、adb 辅助工具。结合仓库自带的 check-deps.sh 与 install-dep.sh 脚本可实现对多平台Linux 发行版、macOS、Windows依赖的自动检测与免 sudo 安装。工具链就绪后即可按技能文档中定义的工作流指纹识别 → 反编译 → 结构分析 → Kotlin 名称恢复 → 调用链追踪 → API 提取开展后续的逆向分析工作。【免费下载链接】android-reverse-engineering-skillClaude Code skill to support Android apps reverse engineering项目地址: https://gitcode.com/GitHub_Trending/an/android-reverse-engineering-skill创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 Android 逆向工程环境搭建完全指南：Java、jadx、Vineflower 与 dex2jar 安装配置详解
Android 逆向工程环境搭建完全指南Java、jadx、Vineflower 与 dex2jar 安装配置详解【免费下载链接】android-reverse-engineering-skillClaude Code skill to support Android apps reverse engineering项目地址: https://gitcode.com/GitHub_Trending/an/android-reverse-engineering-skill本篇技术指南以 Android 逆向工程技能android-reverse-engineering-skill的 setup-guide.md 为骨架系统讲解逆向分析 APK/XAPK/JAR/AAR 所需的完整工具链安装Java JDK 17、jadx 反编译器、Fernflower/Vineflower 反编译器、dex2jar 转换器以及 apktool、adb 等辅助工具。读者学完本文后将能够针对 Ubuntu/Debian、Fedora、Arch Linux、macOS 与 Windows 环境从零搭建一套可用的 Android 逆向环境并通过仓库自带的依赖检查与自动安装脚本一键完成配置与验证。一、工具链全景与依赖关系在动手安装之前先明确这套工具链中每个组件的角色及其上下游依赖关系。整个逆向流程是一条清晰的数据流水线组件角色必需性Java JDK 17jadx、Vineflower、dex2jar 全部基于 JVM 运行必需jadx将 APK/JAR/AAR/DEX 直接反编译为可读 Java 源码并解码资源必需Fernflower / VineflowerJetBrains 系反编译器对复杂 Java 结构lambda、泛型、stream输出质量更高可选推荐dex2jar将 DEX 字节码转换为标准 JAR是 Fernflower 处理 APK 文件的必经中间步骤可选配合 Fernflower 时必需apktool解码 XML 布局、drawable 等资源弥补 jadx 在部分资源上的不足可选adb从已连接的真机/模拟器直接拉取 APK 文件可选值得注意的是仓库源码对依赖的定位与本文档完全一致。check-deps.sh 中将java与jadx归为必需依赖缺失即返回退出码 1而将vineflower、dex2jar、apktool、adb归为可选依赖缺失仅打印INSTALL_OPTIONAL:提示不阻塞流程。这套必需 可选的双层模型贯穿整个技能工作流安装时建议遵循同样的优先级。二、安装前置Java JDK 17jadx 要求 Java 17 或更高版本这是整个工具链的硬性前提。若 Java 版本过低或缺失后续所有工具都无法启动最常见的报错即为Error: Could not find or load main class。2.1 各平台安装命令Ubuntu / Debianaptsudo apt update sudo apt install openjdk-17-jdkFedoradnfsudo dnf install java-17-openjdk-develArch Linuxpacmansudo pacman -S jdk17-openjdkmacOSHomebrewbrew install openjdk17macOS 下 Homebrew 的 openjdk17 是 keg-only 安装不会自动进入 PATH。安装完成后请按照 Homebrew 输出的 symlink 提示操作或手动将以下行加入 shell 配置文件export PATH/opt/homebrew/opt/openjdk17/bin:$PATHWindows 用户仓库提供了 PowerShell 版本脚本安装逻辑等价于 Unix 平台。install-dep.ps1 中 Java 的安装顺序是 wingetMicrosoft.OpenJDK.17→ scoopopenjdk17→ chocoopenjdk17三者均不可用时才提示手动安装。2.2 验证安装java -version # Should show version 17.x or higher从源码看check-deps.sh 中定义了硬性阈值REQUIRED_JAVA_MAJOR17脚本会解析java -version输出的主版本号兼容17.0.1与旧式1.8.0两种格式只有主版本号 ≥ 17 时才判定为[OK]版本不足或解析失败都会计入错误并输出INSTALL_REQUIRED:java。若你的环境同时安装了多个 JDK可通过update-alternatives --config javaDebian 系或archlinux-java set java-17-openjdkArch切换默认版本。三、jadx核心反编译器jadx 是一个 Dex 到 Java 的反编译器负责将 APK/JAR/AAR 文件转换为可读的 Java 源码同时解码 AndroidManifest.xml、布局等资源。它是整套技能的主引擎默认的decompile.sh调用即使用 jadx输出结构为output/sources/Java 源码与output/resources/解码资源。3.1 方式一GitHub Releases 安装推荐前往 jadx 官方 Releases 页面下载jadx-version.zip发行包注意不要下载源码压缩包解压并加入 PATHunzip jadx-*.zip -d ~/jadx export PATH$HOME/jadx/bin:$PATH # Add the export line to your ~/.bashrc or ~/.zshrc for persistencebin/目录下同时包含命令行工具jadx与图形界面jadx-gui。3.2 方式二HomebrewmacOS / Linuxbrew install jadx3.3 方式三源码构建git clone https://github.com/skylot/jadx.git cd jadx ./gradlew dist # Binaries will be in build/jadx/bin/ export PATH$(pwd)/build/jadx/bin:$PATH源码构建适合需要调试 jadx 本身或体验最新未发布特性的场景。3.4 自动安装与验证仓库提供的 install-dep.sh 封装了 jadx 的自动安装在 macOS 上优先走 Homebrew在其他 Linux 发行版上则自动从 GitHub Releases 查询最新 tag下载 zip 解压到~/.local/share/jadx/并在~/.local/bin/中创建jadx与jadx-gui的符号链接全程无需 sudo。安装完成后验证jadx --version若输出jadx: command not found说明bin/目录或~/.local/bin/尚未加入$PATH请检查 shell 配置文件中的 export 行。四、Fernflower / Vineflower高质量反编译引擎可选推荐Fernflower 是 JetBrains 出品的 Java 反编译器在复杂 Java 结构lambda、泛型、stream上的输出质量优于 jadx。Vineflower 是社区持续维护的 Fernflower 分支提供官方 Releases 发布建议优先选择 Vineflower 而非上游 Fernflower——两者共享完全相同的 CLI 接口Vineflower 是 drop-in replacement同时改进了对现代 Java 特性record、sealed class、pattern matching的处理。4.1 方式一Vineflower 官方 Release推荐前往 Vineflower Releases 页面下载vineflower-version.jar存放 JAR 并设置环境变量mkdir -p ~/vineflower mv vineflower-*.jar ~/vineflower/vineflower.jar export FERNFLOWER_JAR_PATH$HOME/vineflower/vineflower.jar # Add the export to ~/.bashrc or ~/.zshrc for persistenceFERNFLOWER_JAR_PATH环境变量是仓库脚本定位 JAR 的关键decompile.sh与check-deps.sh都会优先读取该变量随后依次探测~/fernflower/build/libs/fernflower.jar、~/vineflower/build/libs/vineflower.jar、~/fernflower/fernflower.jar、~/vineflower/vineflower.jar等常见位置。4.2 方式二源码构建 Fernflowergit clone https://github.com/JetBrains/fernflower.git cd fernflower ./gradlew jar # Produces: build/libs/fernflower.jar export FERNFLOWER_JAR_PATH$(pwd)/build/libs/fernflower.jar4.3 方式三HomebrewVineflowerbrew install vineflower4.4 验证java -jar $FERNFLOWER_JAR_PATH --version重要限制Fernflower 只能处理 JVM 字节码JAR、class 文件。对于 APK/DEX 文件必须先用 dex2jar 完成 DEX → JAR 的中间转换详见下一节。这一限制在 check-deps.sh 中也有体现——dex2jar 被明确标注为optional — needed to use Fernflower on APK/DEX files。4.5 推荐 CLI 预设Fernflower 的选项格式为-keyvalue布尔值1表示启用、0表示禁用。常用预设组合如下常规使用java -jar fernflower.jar -dgs1 -mpm60 input.jar output/混淆代码java -jar fernflower.jar -dgs1 -ren1 -mpm60 input.jar output/最大信息量java -jar fernflower.jar -dgs1 -hes0 -hdc0 -mpm60 input.jar output/带 Android SDK 上下文提升类型解析准确度java -jar fernflower.jar -dgs1 -mpm60 -e$ANDROID_HOME/platforms/android-34/android.jar input.jar output/其中-dgs1反编译泛型签名、-mpm60为每个方法设置 60 秒超时防止挂死、-ren1重命名混淆标识符。decompile.sh在调用 Fernflower 时自动注入-dgs1 -mpm60并在指定--deobf时追加-ren1与上述预设完全对齐。五、dex2jarDEX 转 JAR 转换器可选配合 Fernflower 使用 APK 必需dex2jar 将 Android DEX 字节码转换为标准 Java JAR 文件是 Fernflower 处理 APK 时不可绕过的中间环节。5.1 GitHub Releases 安装前往 dex2jar 维护分支的 Releases 页面下载发行包解压并加入 PATHunzip dex-tools-*.zip -d ~/dex2jar export PATH$HOME/dex2jar:$PATH5.2 Homebrew 安装brew install dex2jar5.3 验证d2j-dex2jar --help注意脚本同时接受d2j-dex2jar与d2j-dex2jar.sh两种命令名对应 Unix 与部分发行版包管理器安装的差异check-deps.sh对两者都做了探测。5.4 典型用法# Convert APK (or DEX) to JAR d2j-dex2jar -f -o output.jar app.apk # Then decompile with Fernflower java -jar vineflower.jar output.jar decompiled/在仓库的完整 APK 工作流中decompile.sh 使用--engine fernflower处理 APK/AAR 时会自动执行dex2jar 转换 → Fernflower 反编译 → 解包源码 JAR三步转换产物存放在output/intermediate/中间目录成功后自动清理。六、可选辅助工具apktool 与 adb6.1 apktool资源解码器jadx 对部分 XML 布局、drawable 等资源的处理效果不佳此时 apktool 是有效的补充手段。# Ubuntu/Debian sudo apt install apktool # macOS brew install apktoolapktool 在 check-deps.sh 中被归为可选依赖主要用于资源解码场景。6.2 adb从设备拉取 APK当目标 APK 不在本地、仅存在于已连接的 Android 设备时adb 是从设备提取 APK 的标准途径。# Ubuntu/Debian sudo apt install adb # macOS brew install android-platform-tools从设备拉取 APK 的完整三步流程# 1. 列出已安装的应用包名按关键词过滤 adb shell pm list packages | grep keyword # 2. 获取目标应用的 APK 路径 adb shell pm path com.example.app # 3. 拉取 APK 到本地 adb pull /data/app/com.example.app-xxxx/base.apk ./app.apk对于采用 split APK 架构的应用pm path会输出多个路径需要逐个拉取 base APK 与各 split APK。七、依赖检查与自动安装把环境配置脚本化仅靠手工逐条安装命令效率不高且容易遗漏可选组件。仓库为此提供了完整的自动化配套脚本与 setup-guide 相辅相成7.1 一键检查check-depsbash plugins/android-reverse-engineering/skills/android-reverse-engineering/scripts/check-deps.shWindows PowerShell 对应版本 plugins/android-reverse-engineering/skills/android-reverse-engineering/scripts/check-deps.ps1脚本输出人类可读的[OK]/[MISSING]逐项状态并附上机器可解析的摘要行INSTALL_REQUIRED:dep表示必需依赖缺失阻塞流程INSTALL_OPTIONAL:dep表示可选依赖缺失不阻塞。检查项覆盖 Java、jadx、Vineflower/Fernflower含FERNFLOWER_JAR_PATH与常见 JAR 路径探测、dex2jar、apktool、adb 共六类。任何必需依赖缺失时脚本以退出码 1 结束。7.2 一键安装install-depbash plugins/android-reverse-engineering/skills/android-reverse-engineering/scripts/install-dep.sh dep支持的依赖名java、jadx、vineflower或fernflower、dex2jar、apktool、adb。脚本自动探测操作系统与包管理器brew / apt / dnf / pacman其安装策略为优先免 sudo 安装从 GitHub Releases 下载到~/.local/share/在~/.local/bin/建立符号链接并将 PATH 写入 shell 配置文件依次尝试~/.zshrc、~/.bashrc、~/.profile必要时使用系统包管理器通过sudo apt-get/dnf/pacman安装前提是 sudo 可用两者都不可行时打印精确的手工安装命令并以退出码 2 结束等待用户手动处理。Windows 上 install-dep.ps1 采用 winget → scoop → choco 的探测顺序均不可用时直接下载到%USERPROFILE%\.local\share\并写入用户 PATH。安装完成后需重新运行check-deps确认全部就绪——PowerShell 版本的 check 脚本会自动从用户环境刷新 PATH无需重启终端。八、故障排查速查表问题解决方案jadx: command not found确认 jadx 的bin/目录或~/.local/bin/已加入$PATHError: Could not find or load main classJava 缺失或版本错误——用java -version验证是否为 17大 APK 反编译时 jadx 内存不足增加堆内存jadx -Xmx4g -d output app.apk或设置JAVA_OPTS-Xmx4g反编译结果大量// Error注释尝试--show-bad-code查看部分输出混淆应用可加--deobfFernflower 在某个方法上挂死使用-mpm60为每个方法设置 60 秒超时Fernflower JAR 找不到将FERNFLOWER_JAR_PATH环境变量设为 JAR 的完整路径dex2jar 报ZipExceptionAPK 可能是非标准 ZIP 结构——改用 jadx 处理8.1 排查要点补充说明内存参数jadx 的-Xmx是 JVM 堆参数可直接与-d等选项混用jadx-usage.md 中还记录了--threads-count N默认按 CPU 数用于控制并发线程数。--show-bad-code让 jadx 输出部分反编译代码而非错误注释配合--no-res可快速获取仅源码的概览。混淆处理对于 R8/ProGuard 混淆应用--deobf会生成deobf-mapping.txt映射文件若持有官方 ProGuard mapping 文件可用--deobf-map mapping.txt直接导入。Fernflower 超时兜底decompile.sh还会用 GNUtimeout对整个 Fernflower 进程设置总超时默认 900 秒可用FERNFLOWER_TIMEOUT_SECONDS覆盖双保险防止卡死。九、安装后的完整工作流验证环境就绪后可结合技能工作流做一次端到端验证。在 Claude Code 中执行/decompile path/to/app.apk或在命令行手动串联以下步骤# 1. 依赖检查应全部 OK 或仅剩可选项 bash plugins/android-reverse-engineering/skills/android-reverse-engineering/scripts/check-deps.sh # 2. 反编译前的快速指纹识别可选但强烈推荐 bash plugins/android-reverse-engineering/skills/android-reverse-engineering/scripts/fingerprint.sh app.apk # 3. 用 jadx 反编译 bash plugins/android-reverse-engineering/skills/android-reverse-engineering/scripts/decompile.sh app.apk # 4. 双引擎对比安装 Vineflower dex2jar 后 bash plugins/android-reverse-engineering/skills/android-reverse-engineering/scripts/decompile.sh --engine both --deobf app.apk对于 Flutter、React Native、Cordova、Xamarin 应用指纹脚本会直接建议改用框架对应工具如 Flutter 使用 blutter /strings libapp.so因为 Java 反编译几乎拿不到真正的应用逻辑——这是避免在错误方向浪费时间的关键前置判断。结语本文完整覆盖了 Android 逆向工程技能android-reverse-engineering-skill的环境搭建链路从 Java JDK 17 这一硬性前提出发依次部署 jadx 核心反编译器、Vineflower/Fernflower 高质量反编译引擎、dex2jar 中间转换器以及 apktool、adb 辅助工具。结合仓库自带的 check-deps.sh 与 install-dep.sh 脚本可实现对多平台Linux 发行版、macOS、Windows依赖的自动检测与免 sudo 安装。工具链就绪后即可按技能文档中定义的工作流指纹识别 → 反编译 → 结构分析 → Kotlin 名称恢复 → 调用链追踪 → API 提取开展后续的逆向分析工作。【免费下载链接】android-reverse-engineering-skillClaude Code skill to support Android apps reverse engineering项目地址: https://gitcode.com/GitHub_Trending/an/android-reverse-engineering-skill创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考