apkbox 2.1.0__tar.gz

apkbox-2.1.0/PKG-INFO

@@ -0,0 +1,174 @@
+Metadata-Version: 2.4
+Name: apkbox
+Version: 2.1.0
+Summary: APK 工具集: 转成可引入的 AAR, 或反编译出 .java(工具自动下载)
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+
+# apkbox
+
+APK 工具箱：把 APK 转成能直接引入工程的 AAR，或反编译出 `.java`。
+
+```bash
+apkbox app.apk                 # app.apk → app.aar（aar 是默认子命令）
+apkbox java app.apk -o src/    # 整个 APK 反编译成 .java
+```
+
+## 依赖
+
+- Python 3.9+
+- JDK 8+（`java` 要在 `PATH` 里）
+- 可选：Android SDK —— 提供 `android.jar` 做 AAR 的资源 link 自检，也是 aapt2 的首选来源（见下文）
+
+就这些。wheel 只有约 40 KB、Python 侧无第三方依赖；apktool / dex-tools / aapt2 /
+jadx 这些工具**不在包里**，系统装过就直接用，没有的话首次用到时自动下载到缓存
+（约 110 MB，一次性）。
+
+## 安装
+
+```bash
+pip install apkbox            # 从 PyPI 装
+
+# 或从源码 / wheel 装
+pip install --break-system-packages .
+pip install --break-system-packages dist/apkbox-2.1.0-py3-none-any.whl
+
+# 不想安装，直接在源码目录跑
+python3 -m apkbox --version
+```
+
+> Debian/Ubuntu 的系统 Python 是 externally-managed，所以要加 `--break-system-packages`；
+> 在 venv 里装则不需要这个参数。
+
+## 工具从哪来
+
+每个工具按这个顺序解析，**找到就用，不重复造轮子**：
+
+```
+命令行参数 > 环境变量 > 系统 PATH / Android SDK > apkbox 缓存 > 自动下载
+```
+
+- 缓存目录默认 `~/.cache/apkbox`（遵循 `XDG_CACHE_HOME`），下载前先比对
+  sha256，装一次后续直接复用。
+- 下载先走官方直链（GitHub releases、Google Maven），不通再换内置镜像；
+  设置 `APKBOX_MIRROR` 可以指定自己的镜像（此时镜像优先、直链兜底）。
+- 首次运行会看到类似输出，之后都是 `✓`：
+
+  ```
+  tools  : apktool ✓, dex2jar 已下载, aapt2 ✓
+  ```
+
+- 想提前把工具备齐（离线机、CI 预热）：
+
+  ```bash
+  apkbox fetch                  # 全部：apktool / dex2jar / aapt2 / jadx
+  apkbox fetch jadx apktool     # 指定几个
+  ```
+
+环境变量：
+
+| 变量 | 作用 |
+| --- | --- |
+| `APKBOX_MIRROR` | 镜像前缀，逗号分隔，下载地址 = 前缀 + 官方 URL（与 gh-proxy.com 同规则）；设为空则只走直链 |
+| `APKBOX_OFFLINE=1` | 禁止联网，缺工具直接报错并给出手动下载地址 |
+| `APKBOX_CACHE` | 缓存目录（默认 `~/.cache/apkbox`） |
+| `APKBOX_NO_VERIFY=1` | 跳过 sha256 校验（慎用） |
+| `APKBOX_APKTOOL` / `APKBOX_DEX2JAR` / `APKBOX_AAPT2` / `APKBOX_JADX` | 分别指定工具路径 |
+| `ANDROID_HOME` / `ANDROID_SDK_ROOT` | 找 aapt2 和 android.jar |
+| `APKBOX_LANG` | 界面语言 `zh` / `en` |
+
+当前自动下载的版本（升级时改 `apkbox/fetch.py` 里的 `SPECS`）：
+
+| 工具 | 版本 | 来源 |
+| --- | --- | --- |
+| apktool | 2.7.0 | GitHub releases（单个 fat jar） |
+| dex-tools | 2.4 | GitHub releases |
+| jadx | 1.5.6 | GitHub releases |
+| aapt2 | 9.4.1-15978811 | Google Maven（`dl.google.com`） |
+
+## 转 AAR
+
+```bash
+apkbox app.apk                                  # → app.aar（和输入同目录）
+apkbox aar app.apk -o dist/app.aar --keep        # 指定输出，保留中间文件
+apkbox app.apk --code-only                       # 只要 classes.jar，不带 res/assets/jni
+apkbox app.apk -w work/ --skip-decode            # 复用 work/ 里已有的解包结果
+```
+
+流程：apktool 解包 → dex2jar 出 classes.jar → 组装 res/assets/jni（`public.xml` 钉死资源 id）→ 裁剪 AndroidManifest → aapt2 compile + link 自检 → 打包 `.aar`。
+
+常用选项：
+
+| 选项 | 说明 |
+| --- | --- |
+| `-o, --output` | 输出 `.aar` 路径（默认与 apk 同名） |
+| `-w, --work-dir` | 中间文件目录（默认临时目录，指定后保留） |
+| `--code-only` | 只要 classes.jar，不带 res/assets/jni |
+| `--keep-app-attrs` | 保留 `<application>` 的属性（默认清空以免与宿主合并冲突） |
+| `--skip-decode` | 复用 `-w` 目录里已有的 apktool 解包结果 |
+| `--keep` | 保留临时目录 |
+| `--apktool` / `--dex2jar` / `--aapt2` | 手动指定工具（默认按上面的顺序自动解析） |
+| `--android-jar` | android.jar 路径（用于 link 自检，缺省自动找 SDK） |
+| `-v, --verbose` | 打印每步实际执行的子命令 |
+
+### 产物注意事项
+
+- 打印的 `可能与宿主 Duplicate class: androidx …` 是提示：这些包宿主大概率已有，合并前先看一眼。
+- `<application>` 的 `android:name/icon/label/theme` 默认被清空（避免和宿主合并冲突），图标、label、主题、Application 类要宿主自己设置；确实想带上用 `--keep-app-attrs`。
+- 没找到 android.jar 时跳过 link 自检，`R.txt` 按原 APK 的资源 id 生成，`minCompileSdk` 取原 APK 的 `compileSdkVersion`；找到时会尝试各平台，取能通过的最低版本。
+- native 库按 APK 原样携带：APK 里有哪些 ABI，AAR 的 `jni/` 就有哪些；只有 arm 库的话 x86 模拟器跑不起来（会打印警告）。
+
+## 反编译成 .java
+
+```bash
+apkbox java app.apk -o src/          # APK → src/**/*.java + resources/
+apkbox java classes.dex              # 单个 dex → classes-java/
+apkbox java ./smali_out/ -o src/     # 目录里挑 classes*.dex
+apkbox java app.apk -r               # --no-res：只要代码，不解资源
+apkbox java app.apk -j 4 --deobf     # 4 线程 + 反混淆
+```
+
+| 选项 | 说明 |
+| --- | --- |
+| `-o, --output` | 输出目录（默认 `<输入名>-java`） |
+| `-r, --no-res` | 不反编译资源，只出 `.java` |
+| `-j, --jobs` | 线程数（默认用 jadx 的） |
+| `--deobf` | 反混淆：太短/太长的类名重新命名 |
+| `-e, --export-gradle` | 输出成 Android/Java gradle 工程 |
+| `--show-bad-code` | 反编译不出来的代码也照样输出（带注释标记） |
+| `--jadx` | jadx 可执行文件/jar（默认自动解析/下载） |
+
+- 有反编译错误时会在输出旁写一份 `<输出名>.log`（混淆过的 APK 出现几百处错误很常见）。
+- 进度行只在终端里刷，重定向到文件时不会刷屏。
+
+## 界面语言
+
+按系统 locale 自动选中文/英文，也可以强制指定：
+
+```bash
+apkbox --lang en java app.apk      # --lang 放子命令前后都行
+APKBOX_LANG=en apkbox app.apk      # 环境变量
+```
+
+## Python API
+
+```python
+from apkbox import convert, decompile_to_java, ToolError
+
+convert("app.apk")                                   # → app.aar，返回退出码
+convert("app.apk", "dist/app.aar", code_only=True)   # 只要 classes.jar
+info = decompile_to_java("app.apk", "src/")          # 返回统计 dict
+print(info["java_files"], info["errors"], info["log_file"])
+```
+
+参数与命令行同名（`convert` 的 `work_dir/code_only/keep/skip_decode/...`，
+`decompile_to_java` 的 `no_res/deobf/jobs/show_bad_code/...`）。
+工具级失败抛 `ToolError`；API 和命令行一样，缺工具会自动下载（`APKBOX_OFFLINE=1` 可禁止）。
+
+## 退出码
+
+| 码 | 含义 |
+| --- | --- |
+| 0 | 成功 |
+| 1 | 工具执行失败（外部命令报错，已打印 `error: …`） |
+| 2 | 参数/输入文件问题 |

apkbox-2.1.0/README.md

@@ -0,0 +1,167 @@
+# apkbox
+
+APK 工具箱：把 APK 转成能直接引入工程的 AAR，或反编译出 `.java`。
+
+```bash
+apkbox app.apk                 # app.apk → app.aar（aar 是默认子命令）
+apkbox java app.apk -o src/    # 整个 APK 反编译成 .java
+```
+
+## 依赖
+
+- Python 3.9+
+- JDK 8+（`java` 要在 `PATH` 里）
+- 可选：Android SDK —— 提供 `android.jar` 做 AAR 的资源 link 自检，也是 aapt2 的首选来源（见下文）
+
+就这些。wheel 只有约 40 KB、Python 侧无第三方依赖；apktool / dex-tools / aapt2 /
+jadx 这些工具**不在包里**，系统装过就直接用，没有的话首次用到时自动下载到缓存
+（约 110 MB，一次性）。
+
+## 安装
+
+```bash
+pip install apkbox            # 从 PyPI 装
+
+# 或从源码 / wheel 装
+pip install --break-system-packages .
+pip install --break-system-packages dist/apkbox-2.1.0-py3-none-any.whl
+
+# 不想安装，直接在源码目录跑
+python3 -m apkbox --version
+```
+
+> Debian/Ubuntu 的系统 Python 是 externally-managed，所以要加 `--break-system-packages`；
+> 在 venv 里装则不需要这个参数。
+
+## 工具从哪来
+
+每个工具按这个顺序解析，**找到就用，不重复造轮子**：
+
+```
+命令行参数 > 环境变量 > 系统 PATH / Android SDK > apkbox 缓存 > 自动下载
+```
+
+- 缓存目录默认 `~/.cache/apkbox`（遵循 `XDG_CACHE_HOME`），下载前先比对
+  sha256，装一次后续直接复用。
+- 下载先走官方直链（GitHub releases、Google Maven），不通再换内置镜像；
+  设置 `APKBOX_MIRROR` 可以指定自己的镜像（此时镜像优先、直链兜底）。
+- 首次运行会看到类似输出，之后都是 `✓`：
+
+  ```
+  tools  : apktool ✓, dex2jar 已下载, aapt2 ✓
+  ```
+
+- 想提前把工具备齐（离线机、CI 预热）：
+
+  ```bash
+  apkbox fetch                  # 全部：apktool / dex2jar / aapt2 / jadx
+  apkbox fetch jadx apktool     # 指定几个
+  ```
+
+环境变量：
+
+| 变量 | 作用 |
+| --- | --- |
+| `APKBOX_MIRROR` | 镜像前缀，逗号分隔，下载地址 = 前缀 + 官方 URL（与 gh-proxy.com 同规则）；设为空则只走直链 |
+| `APKBOX_OFFLINE=1` | 禁止联网，缺工具直接报错并给出手动下载地址 |
+| `APKBOX_CACHE` | 缓存目录（默认 `~/.cache/apkbox`） |
+| `APKBOX_NO_VERIFY=1` | 跳过 sha256 校验（慎用） |
+| `APKBOX_APKTOOL` / `APKBOX_DEX2JAR` / `APKBOX_AAPT2` / `APKBOX_JADX` | 分别指定工具路径 |
+| `ANDROID_HOME` / `ANDROID_SDK_ROOT` | 找 aapt2 和 android.jar |
+| `APKBOX_LANG` | 界面语言 `zh` / `en` |
+
+当前自动下载的版本（升级时改 `apkbox/fetch.py` 里的 `SPECS`）：
+
+| 工具 | 版本 | 来源 |
+| --- | --- | --- |
+| apktool | 2.7.0 | GitHub releases（单个 fat jar） |
+| dex-tools | 2.4 | GitHub releases |
+| jadx | 1.5.6 | GitHub releases |
+| aapt2 | 9.4.1-15978811 | Google Maven（`dl.google.com`） |
+
+## 转 AAR
+
+```bash
+apkbox app.apk                                  # → app.aar（和输入同目录）
+apkbox aar app.apk -o dist/app.aar --keep        # 指定输出，保留中间文件
+apkbox app.apk --code-only                       # 只要 classes.jar，不带 res/assets/jni
+apkbox app.apk -w work/ --skip-decode            # 复用 work/ 里已有的解包结果
+```
+
+流程：apktool 解包 → dex2jar 出 classes.jar → 组装 res/assets/jni（`public.xml` 钉死资源 id）→ 裁剪 AndroidManifest → aapt2 compile + link 自检 → 打包 `.aar`。
+
+常用选项：
+
+| 选项 | 说明 |
+| --- | --- |
+| `-o, --output` | 输出 `.aar` 路径（默认与 apk 同名） |
+| `-w, --work-dir` | 中间文件目录（默认临时目录，指定后保留） |
+| `--code-only` | 只要 classes.jar，不带 res/assets/jni |
+| `--keep-app-attrs` | 保留 `<application>` 的属性（默认清空以免与宿主合并冲突） |
+| `--skip-decode` | 复用 `-w` 目录里已有的 apktool 解包结果 |
+| `--keep` | 保留临时目录 |
+| `--apktool` / `--dex2jar` / `--aapt2` | 手动指定工具（默认按上面的顺序自动解析） |
+| `--android-jar` | android.jar 路径（用于 link 自检，缺省自动找 SDK） |
+| `-v, --verbose` | 打印每步实际执行的子命令 |
+
+### 产物注意事项
+
+- 打印的 `可能与宿主 Duplicate class: androidx …` 是提示：这些包宿主大概率已有，合并前先看一眼。
+- `<application>` 的 `android:name/icon/label/theme` 默认被清空（避免和宿主合并冲突），图标、label、主题、Application 类要宿主自己设置；确实想带上用 `--keep-app-attrs`。
+- 没找到 android.jar 时跳过 link 自检，`R.txt` 按原 APK 的资源 id 生成，`minCompileSdk` 取原 APK 的 `compileSdkVersion`；找到时会尝试各平台，取能通过的最低版本。
+- native 库按 APK 原样携带：APK 里有哪些 ABI，AAR 的 `jni/` 就有哪些；只有 arm 库的话 x86 模拟器跑不起来（会打印警告）。
+
+## 反编译成 .java
+
+```bash
+apkbox java app.apk -o src/          # APK → src/**/*.java + resources/
+apkbox java classes.dex              # 单个 dex → classes-java/
+apkbox java ./smali_out/ -o src/     # 目录里挑 classes*.dex
+apkbox java app.apk -r               # --no-res：只要代码，不解资源
+apkbox java app.apk -j 4 --deobf     # 4 线程 + 反混淆
+```
+
+| 选项 | 说明 |
+| --- | --- |
+| `-o, --output` | 输出目录（默认 `<输入名>-java`） |
+| `-r, --no-res` | 不反编译资源，只出 `.java` |
+| `-j, --jobs` | 线程数（默认用 jadx 的） |
+| `--deobf` | 反混淆：太短/太长的类名重新命名 |
+| `-e, --export-gradle` | 输出成 Android/Java gradle 工程 |
+| `--show-bad-code` | 反编译不出来的代码也照样输出（带注释标记） |
+| `--jadx` | jadx 可执行文件/jar（默认自动解析/下载） |
+
+- 有反编译错误时会在输出旁写一份 `<输出名>.log`（混淆过的 APK 出现几百处错误很常见）。
+- 进度行只在终端里刷，重定向到文件时不会刷屏。
+
+## 界面语言
+
+按系统 locale 自动选中文/英文，也可以强制指定：
+
+```bash
+apkbox --lang en java app.apk      # --lang 放子命令前后都行
+APKBOX_LANG=en apkbox app.apk      # 环境变量
+```
+
+## Python API
+
+```python
+from apkbox import convert, decompile_to_java, ToolError
+
+convert("app.apk")                                   # → app.aar，返回退出码
+convert("app.apk", "dist/app.aar", code_only=True)   # 只要 classes.jar
+info = decompile_to_java("app.apk", "src/")          # 返回统计 dict
+print(info["java_files"], info["errors"], info["log_file"])
+```
+
+参数与命令行同名（`convert` 的 `work_dir/code_only/keep/skip_decode/...`，
+`decompile_to_java` 的 `no_res/deobf/jobs/show_bad_code/...`）。
+工具级失败抛 `ToolError`；API 和命令行一样，缺工具会自动下载（`APKBOX_OFFLINE=1` 可禁止）。
+
+## 退出码
+
+| 码 | 含义 |
+| --- | --- |
+| 0 | 成功 |
+| 1 | 工具执行失败（外部命令报错，已打印 `error: …`） |
+| 2 | 参数/输入文件问题 |

apkbox-2.1.0/apkbox/__init__.py

@@ -0,0 +1,23 @@
+"""apkbox — APK 工具集: 转成 AAR, 或反编译出 .java 源码。
+
+    from apkbox import convert, decompile_to_java
+
+    convert("app.apk")                                  # → app.aar
+    convert("app.apk", "dist/app.aar", code_only=True)  # 只要 classes.jar
+    decompile_to_java("app.apk", "src/")                # → src/**/*.java
+
+流程: apktool 解包 → dex2jar 出 classes.jar → 组装 res/assets/jni +
+public.xml 固定资源 id → 裁剪 AndroidManifest → aapt2 自检 → 打包 .aar。
+反编译走 jadx。
+
+工具(apktool / dex-tools / aapt2 / jadx)按 显式参数 > 环境变量 > 系统
+PATH/SDK > 缓存 > 自动下载 的顺序解析: 系统里装过就直接用, 没有的话首次
+用到时下载到 ~/.cache/apkbox(sha256 校验; 镜像前缀用 APKBOX_MIRROR 配,
+APKBOX_OFFLINE=1 禁止联网), 只需系统有 Java。
+"""
+from .core import convert
+from .decompile import decompile_to_java
+from .errors import ToolError
+from .version import __version__
+
+__all__ = ["convert", "decompile_to_java", "ToolError", "__version__"]

apkbox-2.1.0/apkbox/__main__.py

@@ -0,0 +1,5 @@
+import sys
+
+from .cli import main
+
+sys.exit(main())

apkbox-2.1.0/apkbox/cli.py

@@ -0,0 +1,209 @@
+"""命令行入口: apkbox {aar,java} ..."""
+from __future__ import annotations
+
+import argparse
+import sys
+import time
+
+from . import fetch
+from .core import convert
+from .decompile import decompile_to_java, print_report
+from .errors import ToolError
+from .i18n import get_lang, set_lang, t
+from .locate import find_jadx
+from .version import __version__
+
+ROOT_EPILOG_ZH = """示例:
+  apkbox app.apk                        # APK → AAR(aar 是默认子命令)
+  apkbox aar app.apk -o dist/app.aar --keep
+  apkbox java app.apk -o src/           # 整个 APK 反编译成 .java
+  apkbox java ./smali_out/ -o src/      # 目录里的 classes*.dex
+  apkbox java classes.dex -r            # 只要代码, 不解资源
+  apkbox fetch                          # 预下载 apktool/dex2jar/aapt2/jadx
+
+工具(apktool / dex-tools / aapt2 / jadx)系统里有就直接用, 没有则首次用到时
+下载到 ~/.cache/apkbox(镜像用 APKBOX_MIRROR 配), 只需系统有 Java。
+资源 link 自检需要 android.jar, 找不到就跳过(R.txt 按原 APK 的 id 生成)。
+"""
+
+ROOT_EPILOG_EN = """examples:
+  apkbox app.apk                        # APK -> AAR (aar is the default subcommand)
+  apkbox aar app.apk -o dist/app.aar --keep
+  apkbox java app.apk -o src/           # decompile a whole APK into .java
+  apkbox java ./smali_out/ -o src/      # classes*.dex inside a directory
+  apkbox java classes.dex -r            # code only, skip resources
+  apkbox fetch                          # pre-download apktool/dex2jar/aapt2/jadx
+
+Tools (apktool / dex-tools / aapt2 / jadx): system installs are used as-is,
+otherwise downloaded into ~/.cache/apkbox on first use (configure mirrors
+with APKBOX_MIRROR). Only Java is required on the system.
+The resource link check needs android.jar; it is skipped if not found
+(R.txt is then generated from the ids of the original APK).
+"""
+
+
+def _root_epilog() -> str:
+    return ROOT_EPILOG_EN if get_lang() == "en" else ROOT_EPILOG_ZH
+
+
+def _add_aar_args(ap: argparse.ArgumentParser) -> None:
+    ap.add_argument("apk", help=t("输入的 .apk 文件"))
+    ap.add_argument("-o", "--output", help=t("输出 .aar 路径(默认与 apk 同名)"))
+    ap.add_argument("-w", "--work-dir",
+                    help=t("中间文件目录(默认临时目录, 指定后保留)"))
+    ap.add_argument("--apktool", help=t("apktool 可执行文件/目录/jar(没有会自动下载)"))
+    ap.add_argument("--dex2jar",
+                    help=t("dex-tools 目录(含 d2j-dex2jar.sh, 没有会自动下载)"))
+    ap.add_argument("--aapt2", help=t("aapt2 可执行文件(没有会自动下载)"))
+    ap.add_argument("--android-jar",
+                    help=t("android.jar 路径(用于 link 自检, 缺省自动找 SDK)"))
+    ap.add_argument("--code-only", action="store_true",
+                    help=t("只要 classes.jar, 不带 res/assets/jni"))
+    ap.add_argument("--keep-app-attrs", action="store_true",
+                    help=t("保留 <application> 的属性(默认清空以免与宿主合并冲突)"))
+    ap.add_argument("--skip-decode", action="store_true",
+                    help=t("复用 -w 目录里已有的 apktool 解包结果, 跳过解包"))
+    ap.add_argument("--keep", action="store_true", help=t("保留临时目录"))
+    ap.add_argument("-v", "--verbose", action="store_true", help=t("打印子命令"))
+
+
+def _add_java_args(ap: argparse.ArgumentParser) -> None:
+    ap.add_argument("input", help=t(".apk / .dex / .jar / .zip, 或含 classes*.dex 的目录"))
+    ap.add_argument("-o", "--output", help=t("输出目录(默认 <输入名>-java)"))
+    ap.add_argument("-r", "--no-res", action="store_true",
+                    help=t("不反编译资源, 只出 .java"))
+    ap.add_argument("--deobf", action="store_true",
+                    help=t("反混淆: 太短/太长的类名重新命名"))
+    ap.add_argument("-e", "--export-gradle", action="store_true",
+                    help=t("输出成 Android/Java gradle 工程"))
+    ap.add_argument("--show-bad-code", action="store_true",
+                    help=t("反编译不出来的代码也照样输出(带注释标记)"))
+    ap.add_argument("-j", "--jobs", type=int, help=t("线程数(默认用 jadx 的)"))
+    ap.add_argument("--jadx", help=t("jadx 可执行文件/jar(没有会自动下载)"))
+    ap.add_argument("-v", "--verbose", action="store_true", help=t("打印子命令"))
+
+
+def build_parser() -> argparse.ArgumentParser:
+    ap = argparse.ArgumentParser(
+        prog="apkbox",
+        description=t("APK 工具集: 转 AAR、反编译成 .java。"),
+        formatter_class=argparse.RawDescriptionHelpFormatter,
+        epilog=_root_epilog())
+    ap.add_argument("--version", action="version", version=f"apkbox {__version__}")
+    ap.add_argument("--lang", choices=("zh", "en"), default=argparse.SUPPRESS,
+                    help=t("界面语言: zh / en(默认跟随系统)"))
+    sub = ap.add_subparsers(dest="cmd", metavar="{aar,java,fetch}")
+    pa = sub.add_parser("aar", help=t("APK → AAR(默认子命令)"))
+    pa.add_argument("--lang", choices=("zh", "en"), default=argparse.SUPPRESS,
+                    help=t("界面语言: zh / en(默认跟随系统)"))
+    _add_aar_args(pa)
+    pj = sub.add_parser("java", help=t("dex/apk → .java 源码(自动下载 jadx)"))
+    pj.add_argument("--lang", choices=("zh", "en"), default=argparse.SUPPRESS,
+                    help=t("界面语言: zh / en(默认跟随系统)"))
+    _add_java_args(pj)
+    pf = sub.add_parser("fetch", help=t("预下载工具到缓存(缺什么下什么)"))
+    pf.add_argument("--lang", choices=("zh", "en"), default=argparse.SUPPRESS,
+                    help=t("界面语言: zh / en(默认跟随系统)"))
+    pf.add_argument("names", nargs="*", metavar="name", choices=fetch.NAMES,
+                    help=t("工具名(缺省全部: {names})", names=", ".join(fetch.NAMES)))
+    return ap
+
+
+def _extract_lang(argv: list[str]) -> tuple[list[str], str | None]:
+    """把 --lang [zh|en] 从 argv 里摘出来: 语言要在建 parser(生成帮助文本)前定好。"""
+    out, val = [], None
+    i = 0
+    while i < len(argv):
+        a = argv[i]
+        if a == "--lang" and i + 1 < len(argv):
+            val = argv[i + 1]
+            i += 2
+            continue
+        if a.startswith("--lang="):
+            val = a.split("=", 1)[1]
+            i += 1
+            continue
+        out.append(a)
+        i += 1
+    return out, val
+
+
+def _run_java(args) -> int:
+    print(f"apkbox java v{__version__}")
+    src = args.input
+    print(f"  input : {src}")
+    print(f"  output: {args.output or t('(默认 <输入名>-java)')}")
+    t0 = time.time()
+    try:
+        jadx_ready = bool(find_jadx(args.jadx, download=False))
+        find_jadx(args.jadx)
+        print(f"  tools : jadx {'✓' if jadx_ready else t('已下载')}")
+        print("[1] " + t("jadx 反编译") + " ... ", end="", flush=True)
+        info = decompile_to_java(
+            src, args.output, no_res=args.no_res, deobf=args.deobf,
+            jobs=args.jobs, show_bad_code=args.show_bad_code,
+            export_gradle=args.export_gradle, jadx=args.jadx,
+            verbose=args.verbose)
+    except ToolError as e:
+        print(t("失败"))
+        sys.stdout.flush()          # 免得重定向时 error 抢在 "失败" 前面
+        print(f"\nerror: {e}", file=sys.stderr)
+        return 1
+    print(f"ok ({t('{n} 个 .java', n=info['java_files'])}) "
+          f"[{time.time() - t0:.1f}s]")
+    print_report(info)
+    return 0
+
+
+def _run_fetch(args) -> int:
+    try:
+        results = fetch.ensure_all(args.names)
+    except ToolError as e:
+        print(f"error: {e}", file=sys.stderr)
+        return 1
+    for name, path, downloaded in results:
+        print(f"  {name}: {t('已下载') if downloaded else '✓'} {path}")
+    print(t("工具已就绪, 缓存目录: {d}", d=fetch.cache_root()))
+    return 0
+
+
+def main(argv=None) -> int:
+    argv = list(sys.argv[1:] if argv is None else list(argv))
+    argv, lang = _extract_lang(argv)
+    if lang is not None:
+        tag = lang.split(".")[0].split("-")[0].split("_")[0].lower()
+        if tag not in ("zh", "en"):
+            print(t("error: --lang 只支持 zh / en, 收到 {lang}",
+                    lang=repr(lang)), file=sys.stderr)
+            return 2
+        lang = tag
+    set_lang(lang)
+    # 兼容老用法: apkbox app.apk 等价于 apkbox aar app.apk
+    if argv and argv[0] not in {"aar", "java", "fetch", "-h", "--help", "--version"}:
+        argv.insert(0, "aar")
+    ap = build_parser()
+    args = ap.parse_args(argv)
+    if not args.cmd:
+        ap.print_help()
+        return 2
+    if args.cmd == "fetch":
+        return _run_fetch(args)
+    if args.cmd == "java":
+        return _run_java(args)
+    return convert(
+        args.apk, args.output,
+        work_dir=args.work_dir,
+        code_only=args.code_only,
+        keep=args.keep,
+        keep_app_attrs=args.keep_app_attrs,
+        skip_decode=args.skip_decode,
+        verbose=args.verbose,
+        apktool=args.apktool,
+        dex2jar=args.dex2jar,
+        aapt2=args.aapt2,
+        android_jar=args.android_jar,
+    )
+
+
+if __name__ == "__main__":
+    sys.exit(main())