
apk-info v1.0.13
Analyseur APK complet
Parseur rapide et robuste face aux malwares pour les fichiers Android apk/xapk/apkm/apks.
Documentation : 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
Fonctionnalités
- Un lecteur de zip adapté aux malwares qui lit les archives de la même manière qu'Android, y compris la technique
BadPack(excellent article à ce sujet) et ZIP64 ; - Conteneurs XAPK, APKM et APKS, ouverts via leur APK de base ;
- Une implémentation complète d'AXML (Android Binary XML) et d'ARSC (Android Resource), robuste face aux chunks corrompus ;
- Prise en charge de l'extraction des informations contenues dans le
APK Signing Block:- APK Signature scheme v1 ;
- APK Signature scheme v2 ;
- APK Signature scheme v3 ;
- APK Signature scheme v3.1 ;
- APK Signature scheme v3.2 ;
- Stamp Block v1 & v2 ;
- Channel blocks : Walle, VasDolly v2, Packer NG v2, ByteDance ;
- Google Play Frosting (présence uniquement, sa structure n'est pas publique) ;
- Extraction correcte de la MainActivity en se basant sur la façon dont le système Android procède ;
- Bindings pour python 3.11+ avec typages - fini les
# type: ignore; l'analyse libère le GIL, ce qui permet aux threads de s'exécuter en parallèle ; - Et bien sûr, juste un parseur rapide - 🙃
Pour commencer
cli
Installation
Avec Homebrew :
brew install delvinru/tap/apk-info
Ou avec cargo :
cargo install apk-info-cli
Aide
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
Installation
uv pip install apk-info
Obtenir des informations de base sur l'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]}")
Obtenir des informations sur les signatures
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()
Analyse des performances
Un seul thread, cache de pages froid, les mêmes métadonnées lues par chaque outil depuis Python. Apple M3 Pro, macOS 26.6.1.
Applications propres : 5 714 fichiers APK et XAPK provenant de boutiques d'applications, 429 Go.
| Temps | Fichiers/s | Mémoire de pointe | Échecs | |
|---|---|---|---|---|
| apk-info 1.1.0 | 29,7 s | 192 | 745 Mo | 0 |
| apk-info 1.0.13 | 71,4 s | 80 | 770 Mo | 0 |
| androguard 4.1.4 | 926,3 s | 6 | 5,8 Go | 784 |
Logiciels malveillants : 23 745 fichiers issus de la collection Android de VirusShare, 106 Go.
| Temps | Fichiers/s | Mémoire de pointe | Échecs | |
|---|---|---|---|---|
| apk-info 1.1.0 | 44,7 s | 531 | 88 Mo | 692 |
| apk-info 1.0.13 | 76,0 s | 312 | 87 Mo | 691 |
| androguard 4.1.4 | 362,6 s | 65 | 794 Mo | 737 |
Méthodologie, temps par fichier et raisons des échecs : Benchmarks.
FAQ
- Pourquoi ne pas simplement utiliser androguard ?
La quasi-totalité de mes projets naissent d'un outil dont l'utilisation est peu pratique. Androguard est un excellent outil en soi, mais à mon avis il n'est tout simplement pas possible de le maintenir, et il ne convient pas à du code prêt pour la production. Il ne convient pas non plus à l'analyse d'un grand nombre de fichiers, car sa logique n'est pas bien optimisée.
- Je veux modifier un APK. Comment faire avec cette bibliothèque ?
La bibliothèque est en lecture seule par conception : j'avais besoin d'un bon outil pour extraire facilement et rapidement des informations d'un APK. Il existe de nombreux autres bons outils pour modifier les APK.
- J'ai repacké un APK. Comment le signer ?
La commande repack produit un APK non signé. Pour le re-signer, je recommande uber-apk-signer, un outil simple en une seule commande qui signe en v1/v2/v3 et effectue le zipalign en une seule passe :
java -jar uber-apk-signer.jar --apks ./malware.repacked.apk