Назад к обновлениям
New releaseSep 11, 2026

apk-info v1.0.13

Полнофункциональный парсер APK

Поделиться

apk-info

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

Быстрый и устойчивый к вредоносному коду парсер файлов 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

Возможности

  • Устойчивый к вредоносному ПО zip-ридер, который читает архивы так же, как это делает Android, включая технику BadPack (отличная статья об этом) и ZIP64;
  • Контейнеры XAPK, APKM и APKS, открываемые через их базовый APK;
  • Полноценная реализация AXML (Android Binary XML) и ARSC (Android Resource), устойчивая к мусорным чанкам;
  • Поддержка извлечения информации, содержащейся в APK Signing Block:
  • Корректное извлечение MainActivity на основе того, как это делает ОС Android;
  • Привязки для python 3.11+ с типизацией — больше никаких # type: ignore; парсинг освобождает GIL, поэтому потоки выполняются параллельно;
  • И, конечно, просто быстрый парсер — 🙃

Начало работы

cli

Установка

С помощью 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

Python

Установка

uv pip install apk-info

Получение базовой информации об 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]}")

Получение информации о сигнатурах

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.

Чистые приложения: 5 714 файлов APK и XAPK из магазинов приложений, 429 ГБ.

ВремяФайлов/сПиковая памятьОшибок
apk-info 1.1.029.7 s192745 MB0
apk-info 1.0.1371.4 s80770 MB0
androguard 4.1.4926.3 s65.8 GB784

Вредоносное ПО: 23 745 файлов из коллекции Android VirusShare, 106 ГБ.

ВремяФайлов/сПиковая памятьОшибок
apk-info 1.1.044.7 s53188 MB692
apk-info 1.0.1376.0 s31287 MB691
androguard 4.1.4362.6 s65794 MB737

Методология, тайминги по каждому файлу и причины ошибок: Benchmarks.

FAQ

  • Почему бы просто не использовать androguard?

Почти все мои проекты рождаются из чего-то, что неудобно использовать. Androguard сам по себе — отличный инструмент, но, на мой взгляд, его просто невозможно поддерживать, и он не подходит для production-ready кода. Он также не подходит для анализа большого количества файлов, поскольку его логика плохо оптимизирована.

  • Я хочу модифицировать APK. Как это сделать с помощью этой библиотеки?

Библиотека по своей архитектуре предназначена только для чтения: мне нужен был хороший инструмент для лёгкого и быстрого извлечения информации из APK. Существует множество других хороших инструментов для модификации APK.

  • Я перепаковал APK. Как мне его подписать?

Команда repack создаёт неподписанный APK. Для повторной подписи я рекомендую uber-apk-signer — простой инструмент для одной команды, который подписывает с помощью v1/v2/v3 и выполняет zipalign за один проход:

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

Благодарности

Категории