
Androidのapk/xapk/apkm/apksファイルに対応した、高速でマルウェア耐性のあるパーサー。
ドキュメント: https://delvinru.github.io/apk-info/
$ apk-info show apkstest.apk
apkstest.apk
Package io.github.delvinru.apkstest
Label APKS Test
Version 1.0.7 (7)
SDK min 21 · target 35
Main activity io.github.delvinru.apkstest/.MainActivity
ABIs x86_64
BadPack テクニック(これに関する優れた記事)と ZIP64 を含みます。APK Signing Block に含まれる情報の抽出をサポート:
# type: ignore は不要です。パースは GIL を解放するため、スレッドが並列に実行されます;Homebrew を使用する場合:
brew install delvinru/tap/apk-info
またはcargoを使用する場合:
cargo install apk-info-cli
A command-line tool to inspect and extract APK files
Usage: apk-info [COMMAND]
Commands:
show Show basic information about the APK file
extract Unpack apk files as zip archive [alias: x]
axml Read and pretty-print binary AndroidManifest.xml
repack Repack a BadPack-damaged APK into a clean, well-formed zip archive
completion Generate shell completion
help Print this message or the help of the given subcommand(s)
Options:
-h, --help Print help
-V, --version Print version
uv pip install apk-info
from apk_info import APK
apk = APK("./path-to-file.apk")
package_name = apk.get_package_name()
main_activities = apk.get_main_activities()
min_sdk = apk.get_min_sdk_version()
print(f"Package Name: {package_name}")
print(f"Minimal SDK: {min_sdk}")
if not main_activities:
print("apk is not launchable!")
exit()
print(f"Main Activity: {package_name}/{main_activities[0]}")
import sys
from apk_info import APK, Signature
if len(sys.argv) < 2:
print(f"usage: {sys.argv[0]} <apk>")
sys.exit(1)
file = sys.argv[1]
apk = APK(file)
signatures = apk.get_signatures()
for signature in signatures:
match signature:
case Signature.V1() | Signature.V2() | Signature.V3() | Signature.V31() | Signature.V32():
for cert in signature.certificates:
print(f"{cert.subject=} {cert.issuer=} {cert.valid_from=} {cert.valid_until=}")
case Signature.ApkChannelBlock() | Signature.VasDollyV2() | Signature.ByteDance():
print(f"got channel block: {signature.value}")
case _:
print(f"oh, cool, library added some new feature - {signature}")
# For `xapk`/`apkm`/`apks` containers, `get_container_signatures()` returns the
# distributor's signature on the outer archive, separate from the app.
container_signatures = apk.get_container_signatures()
シングルスレッド、コールドページキャッシュ、各ツールがPythonから同じメタデータを読み取った場合の結果です。Apple M3 Pro、macOS 26.6.1。
クリーンなアプリ: アプリストア由来のAPKおよびXAPKファイル5,714件、429 GB。
| 時間 | ファイル/秒 | ピークメモリ | 失敗 | |
|---|---|---|---|---|
| apk-info 1.1.0 | 29.7 s | 192 | 745 MB | 0 |
| apk-info 1.0.13 | 71.4 s | 80 | 770 MB | 0 |
| androguard 4.1.4 | 926.3 s | 6 | 5.8 GB | 784 |
マルウェア: VirusShare Android collection由来のファイル23,745件、106 GB。
| 時間 | ファイル/秒 | ピークメモリ | 失敗 | |
|---|---|---|---|---|
| apk-info 1.1.0 | 44.7 s | 531 | 88 MB | 692 |
| apk-info 1.0.13 | 76.0 s | 312 | 87 MB | 691 |
| androguard 4.1.4 | 362.6 s | 65 | 794 MB | 737 |
手法、ファイルごとのタイミング、失敗理由についてはBenchmarksを参照してください。
私のプロジェクトのほとんどは、使うのが不便な何かから生まれています。 Androguardはそれ自体優れたツールですが、私の意見では、単純にメンテナンスが不可能であり、本番環境向けのコードには適していません。また、そのロジックが十分に最適化されていないため、大量のファイルを分析するのにも適していません。
このライブラリは設計上読み取り専用です。私はAPKから情報を簡単かつ迅速に抽出するための優れたツールを必要としていました。APKを改変するための優れたツールは他にもたくさんあります。
repackコマンドは署名されていないAPKを生成します。再署名にはuber-apk-signerを推奨します。これはv1/v2/v3で署名し、zipalignを1回のパスで実行する、シンプルなワンコマンドツールです:
java -jar uber-apk-signer.jar --apks ./malware.repacked.apk