Apktool 安装教程：从零到解包第一条命令

Apktool 安装教程：从零到解包第一条命令

【免费下载链接】ApktoolA tool for reverse engineering Android apk files项目地址: https://gitcode.com/GitHub_Trending/ap/Apktool

Apktool 是一款把 Android APK 拆成可编辑项目、改完再重新打包的逆向工具。跟着下面几步安装并配置好它，你就能把资源文件和 Smali 代码拆开、修改、再合回去，省去手搓 dex 与 XML 的麻烦。这套流程适合想逆向、本地化或调试 App 的新手和普通用户，全程以"能跑起来"为第一目标。

技术栈速览

• Java：核心语言，整个工具链基于 Java 17 编写。
• Gradle：负责拉取依赖、编译并打包出一个可执行的 JAR。
• Smali / Baksmali：负责 Dalvik 字节码的反编译（dex 转 smali）与回编译。
• XmlPullParser：解析并重建 APK 里的 XML 资源文件。
• commons-cli：处理命令行参数与d/b等子命令的解析。

环境准备

必需

• JDK 17 及以上（源码构建的硬性要求）java -version
• 终端：Linux / macOS 自带 Terminal，Windows 用 PowerShell 或 Git Bashecho $SHELL或java -version均能回显即通过

可选

• 如果你要从源码构建而非直接下现成包，则建议装好 Gitgit --version

安装全流程

1. 克隆源码仓库

把代码拉到本地，这是后续构建的原料。

git clone https://gitcode.com/GitHub_Trending/ap/Apktool cd Apktool

2. 运行 Gradle 构建

一条命令完成依赖拉取、编译和打包。

./gradlew build

Windows 下用gradlew.bat build替代。

3. 定位可执行 JAR

构建产物是一个把所有依赖打进去的 fat jar，先找到它。

find . -path '*/build/libs/*-all.jar'

4. 写入全局命令

把 jar 的绝对路径存成别名，以后在任何目录直接敲apktool即可。

JAR=$(realpath "$(find . -path '*/build/libs/*-all.jar' | head -1)") echo "alias apktool=\"java -jar $JAR\"" >> ~/.bashrc source ~/.bashrc

Windows（PowerShell）一行等价写法：Set-Alias apktool "java -jar $JAR"。

5. 验证安装

确认命令已生效。

apktool --version

验证与冒烟测试

最轻量的验证：

apktool --version

看到Apktool v3.1.0这样的版本号即说明装好了（当前源码版本以仓库build.gradle.kts为准）。

再跑一个最小示例，让读者立刻看到工具"活着"：

apktool # 预期输出：打印 Usage 用法，列出 d、b、f 等子命令

常见卡点

• 现象java: command not found→原因JDK 没装或未进 PATH →修复export PATH=$JAVA_HOME/bin:$PATH
• 现象构建报Building Apktool requires JDK 17→原因当前 JVM 版本低于 17 →修复用java -version确认并切换到 JDK 17
• 现象构建后找不到*-all.jar→原因./gradlew build未执行成功 →修复重跑构建并观察末尾BUILD SUCCESSFUL提示

搞定后，apktool d 你的app.apk就能把包拆成可编辑项目了。构建细节可参考仓库内的 脚本说明。

【免费下载链接】ApktoolA tool for reverse engineering Android apk files项目地址: https://gitcode.com/GitHub_Trending/ap/Apktool