
apk-info v1.0.13
Parser completo de APK
Parser rápido e robusto contra malware para arquivos Android apk/xapk/apkm/apks.
Documentação: 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
Recursos
- Um leitor de zip compatível com malware que lê arquivos da mesma forma que o Android, incluindo a técnica
BadPack(excelente artigo sobre isso) e ZIP64; - Contêineres XAPK, APKM e APKS, abertos através do seu APK base;
- Uma implementação completa de AXML (Android Binary XML) e ARSC (Android Resource), robusta contra chunks corrompidos;
- Suporte para extrair informações contidas no
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 (apenas presença, sua estrutura não é pública);
- Extração correta da MainActivity com base em como o SO Android faz isso;
- Bindings para python 3.11+ com tipagens - chega de
# type: ignore; o parsing libera o GIL, então as threads rodam em paralelo; - E, claro, apenas um parser rápido - 🙃
Primeiros passos
cli
Instalação
Com Homebrew:
brew install delvinru/tap/apk-info
Ou com cargo:
cargo install apk-info-cli
Ajuda
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
Instalação
uv pip install apk-info
Obter informações básicas sobre o 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]}")
Obter informações sobre assinaturas
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()
Análise de Desempenho
Uma thread, cache de página frio, os mesmos metadados lidos por cada ferramenta a partir do Python. Apple M3 Pro, macOS 26.6.1.
Aplicativos limpos: 5.714 arquivos APK e XAPK de lojas de aplicativos, 429 GB.
| Tempo | Arquivos/s | Memória de pico | Falhas | |
|---|---|---|---|---|
| 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 |
Malware: 23.745 arquivos da coleção Android do VirusShare, 106 GB.
| Tempo | Arquivos/s | Memória de pico | Falhas | |
|---|---|---|---|---|
| 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 |
Metodologia, tempos por arquivo e motivos de falha: Benchmarks.
FAQ
- Por que não usar apenas o androguard?
Quase todos os meus projetos nascem de algo que é inconveniente de usar. O Androguard é uma ótima ferramenta por si só, mas, na minha opinião, simplesmente não é possível mantê-la, e ela não é adequada para código pronto para produção. Também não é adequada para analisar um grande número de arquivos, porque sua lógica não é bem otimizada.
- Quero modificar um APK. Como faço isso com esta biblioteca?
A biblioteca é somente leitura por design: eu precisava de uma boa ferramenta para extrair informações de um APK de forma fácil e rápida. Existem muitas outras boas ferramentas para modificar APKs.
- Eu repackagei um APK. Como faço para assiná-lo?
O comando repack produz um APK não assinado. Para reassiná-lo, recomendo o uber-apk-signer, uma ferramenta simples de um único comando que assina com v1/v2/v3 e executa o zipalign em uma única passagem:
java -jar uber-apk-signer.jar --apks ./malware.repacked.apk