Torna agli aggiornamenti
New releaseSep 11, 2026

apk-info v1.0.13

Parser APK completo

Condividi

apk-info

crates.io rust downloads docs.rs pypi PyPI Downloads license

Parser veloce e robusto contro il malware per file Android apk/xapk/apkm/apks.

Documentazione: 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

Funzionalità

  • Un lettore zip compatibile con i malware che legge gli archivi come fa Android, inclusa la tecnica BadPack (ottimo articolo sull'argomento) e ZIP64;
  • Container XAPK, APKM e APKS, aperti tramite il loro APK di base;
  • Un'implementazione completa di AXML (Android Binary XML) e ARSC (Android Resource), robusta contro chunk corrotti;
  • Supporto per l'estrazione delle informazioni contenute nel APK Signing Block:
  • Estrazione corretta della MainActivity basata su come lo fa il sistema operativo Android (link);
  • Binding per python 3.11+ con typings - niente più # type: ignore; il parsing rilascia il GIL, quindi i thread vengono eseguiti in parallelo;
  • E naturalmente solo un parser veloce - 🙃

Per iniziare

cli

Installazione

Con Homebrew:

brew install delvinru/tap/apk-info

Oppure con cargo:

cargo install apk-info-cli

Aiuto

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

Python

Installazione

uv pip install apk-info

Ottenere informazioni di base sull'APK

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]}")

Ottenere informazioni sulle firme

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

Analisi delle prestazioni

Un thread, cache delle pagine fredda, gli stessi metadati letti da ciascuno strumento da Python. Apple M3 Pro, macOS 26.6.1.

App pulite: 5.714 file APK e XAPK provenienti dagli app store, 429 GB.

TempoFile/sMemoria di piccoNon riusciti
apk-info 1.1.029,7 s192745 MB0
apk-info 1.0.1371,4 s80770 MB0
androguard 4.1.4926,3 s65,8 GB784

Malware: 23.745 file dalla collezione Android di VirusShare, 106 GB.

TempoFile/sMemoria di piccoNon riusciti
apk-info 1.1.044,7 s53188 MB692
apk-info 1.0.1376,0 s31287 MB691
androguard 4.1.4362,6 s65794 MB737

Metodologia, tempi per singolo file e motivi dei fallimenti: Benchmarks.

FAQ

  • Perché non usare semplicemente androguard?

Quasi tutti i miei progetti nascono da qualcosa che è scomodo da usare. Androguard è di per sé un ottimo strumento, ma a mio parere semplicemente non è possibile mantenerlo, e non è adatto a codice pronto per la produzione. Inoltre non è adatto all'analisi di un gran numero di file, perché la sua logica non è ben ottimizzata.

  • Voglio modificare un APK. Come posso farlo con questa libreria?

La libreria è di sola lettura per concezione: avevo bisogno di un buon strumento per estrarre informazioni da un APK in modo semplice e veloce. Ci sono molti altri buoni strumenti per modificare gli APK.

  • Ho ripacchettizzato un APK. Come lo firmo?

Il comando repack produce un APK non firmato. Per firmarlo nuovamente, consiglio uber-apk-signer, un semplice strumento da un solo comando che firma con v1/v2/v3 ed esegue lo zipalign in un'unica passata:

java -jar uber-apk-signer.jar --apks ./malware.repacked.apk

Crediti

Categorie