环境准备是最被低估的环节#

apktool 依赖 Java + Android build-tools + apktool.jar，三者版本错一个就全崩。install_apktool.sh（289 行）把“装环境”做成可靠操作：

1
./install_apktool.sh --dry-run              # 先看它要干什么
2
./install_apktool.sh --yes                   # 一键装
3
./install_apktool.sh --method manual --version 3.0.3  # 锁定版本

三模式：auto / brew / manual#

• auto：有 Homebrew 就用 brew，没有就 fallback 手动安装，智能但不自作主张
• brew：macOS 最省心的一路
• manual：下载 apktool.jar + 官方 wrapper 脚本，--prefix 指定目录，服务器裸机就用它

两个好习惯：dry-run 与版本 pin#

--dry-run 只打印不执行，跑在客户机器前先看一遍，心里有底。--version 锁定 3.0.3——Dockerfile 里 APKTOOL_VERSION 也是 ARG 固定的，本地、CI、容器三处同版本，排除了“我这能跑”类问题的一大半。

装完还校验 apktool 进没进 PATH，不可用直接报错，不留“好像装好了”的薛定谔状态。

安装脚本是项目的第一印象：新人（或客户）第一条命令就翻车，后面说什么都没用。