apkbox 2.1.0__py3-none-any.whl

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/__main__.py

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

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())