العودة إلى التحديثات
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+ مع typings - لا مزيد من # 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 GB.

الوقتملفات/ثذروة الذاكرةفشل
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 ملفًا من مجموعة VirusShare لأندرويد، 106 GB.

الوقتملفات/ثذروة الذاكرةفشل
apk-info 1.1.044.7 s53188 MB692
apk-info 1.0.1376.0 s31287 MB691
androguard 4.1.4362.6 s65794 MB737

المنهجية، وأوقات كل ملف، وأسباب الفشل: الاختبارات المرجعية.

الأسئلة الشائعة

  • لماذا لا تستخدم androguard فحسب؟

تولدت جميع مشاريعي تقريبًا من شيء غير مريح في الاستخدام. androguard أداة رائعة بحد ذاتها، لكن في رأيي من غير الممكن ببساطة صيانتها، وهي غير مناسبة للكود الجاهز للإنتاج. كما أنها غير مناسبة لتحليل عدد كبير من الملفات، لأن منطقها غير محسّن جيدًا.

  • أريد تعديل ملف APK. كيف أفعل ذلك باستخدام هذه المكتبة؟

المكتبة للقراءة فقط بحكم التصميم: كنت بحاجة إلى أداة جيدة لاستخراج المعلومات من ملف APK بسهولة وسرعة. هناك العديد من الأدوات الجيدة الأخرى لتعديل ملفات APK.

  • أعدت تجميع ملف APK. كيف أوقّعه؟

ينتج أمر repack ملف APK غير موقّع. لإعادة توقيعه، أوصي بـ uber-apk-signer، وهي أداة بسيطة بأمر واحد توقّع بإصدارات v1/v2/v3 وتنفذ zipalign في تمريرة واحدة:

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

الشكر والتقدير

الفئات