**البرنامج النصي** (يكتشف تلقائيًا نظام التشغيل/الهندسة):```bash
curl -sSL https://raw.githubusercontent.com/JuneLeGency/dexfinder/main/install.sh | bash

**ثنائي**: تنزيل من [Releases](https://github.com/JuneLeGency/dexfinder/releases).

## بداية سريعة```bash
# Show APK overview
dexfinder --dex-file app.apk --stats

# Find all calls to getDeviceId (IMEI)
dexfinder --dex-file app.apk --query "getDeviceId"

# Trace call chains as merged tree
dexfinder --dex-file app.apk --query "getDeviceId" --trace

# Trace as flat call stacks (Java crash style)
dexfinder --dex-file app.apk --query "getDeviceId" --trace --layout list

# Exact JNI signature query
dexfinder --dex-file app.apk \
  --query "Landroid/telephony/TelephonyManager;->getDeviceId()Ljava/lang/String;" \
  --trace --depth 8

# Hidden API detection
dexfinder --dex-file app.apk --api-flags hiddenapi-flags.csv

## التحكم في المخرجات

ثلاثة محاور مستقلة، قابلة للتجميع بحرية:```
--format  (text / json / model / html / sarif)    what to output
--layout  (tree / list)                           how to arrange traces
--style   (java / dex)                            how to display names
--color   (auto / always / never)                 terminal colors

`--scope=all` (الافتراضي) = `callee` + `string`. يتم استبعاد اتجاه `caller` عمدًا من الافتراضي لأنه يجيب على سؤال مختلف جوهريًا. استخدم `--scope=caller` أو `--scope=everything` صراحةً عندما تحتاج ذلك.

**فهم وسوم المخرجات:**

| الوسم | المعنى |
|---|---|
| `[METHOD]` | طريقة **يتم استدعاؤها** تطابق استعلامك (مطابقة المستدعى). الأسطر المسننة هي المستدعون. |
| `[FIELD]` | حقل **يتم الوصول إليه** يطابق استعلامك. الأسطر المسننة هي الوصولات. |
| `[CALLER→]` | طريقة **مستدعية** تطابق استعلامك. يظهر السطر المسنن ما هي واجهة API التي تستدعيها. |
| `[STRING]` | ثابت نصي في الكود يطابق استعلامك. الأسطر المسننة هي مكان استخدامه. |
| `[STRING_TABLE]` | النص موجود في جدول النصوص DEX ولكن ليس له مرجع `const-string` في الكود (قد يكون في التعليقات التوضيحية، أو تم تحسينه بواسطة R8، إلخ). |

## أمثلة

### 1. مسح إحصائيات APK```bash
dexfinder --dex-file app.apk --stats

Loaded 31 DEX file(s): 183913 classes, 1250566 method refs
Method references: 680610
Field references:  625572
String constants:  654353
Referenced types:  192586
Time: 3.9s

### 3. تتبع سلاسل الاستدعاء — عرض شجري```bash
dexfinder --dex-file app.apk \
  --query "Landroid/telephony/TelephonyManager;->getDeviceId()Ljava/lang/String;" \
  --trace --depth 5

android.telephony.TelephonyManager.getDeviceId()
└── com.example.aopsdk.TelephonyManager.getDeviceId(TelephonyManager.java)
    ├── com.example.session.PhoneInfo.getImei(PhoneInfo.java)
    ├── com.example.logging.ClientIdHelper.initClientId(ClientIdHelper.java)
    │   └── com.example.logging.ContextInfo.<init>(ContextInfo.java)
    │       ├── com.example.logging.LogStrategyManager.getInstance(LogStrategyManager.java)
    │       └── com.example.logging.LogContextImpl.<init>(LogContextImpl.java)
    ├── com.example.msp.DeviceInfo.k(DeviceInfo.java)
    │   └── com.example.msp.DeviceInfo.<init>(DeviceInfo.java)
    │       └── com.example.msp.DeviceInfo.getInstance(DeviceInfo.java)
    │           ├── com.example.msp.TidHelper.getIMEI(TidHelper.java)
    │           ├── com.example.msp.TidHelper.getIMSI(TidHelper.java)
    │           └── com.example.msp.DeviceCollector.collectData(DeviceCollector.java)
    └── com.example.weex.WXEnvironment.getDevId(WXEnvironment.java)
        └── com.example.weex.WXEnvironment.<clinit>(WXEnvironment.java)

### 5. تتبع بنمط توقيع DEX```bash
dexfinder --dex-file app.apk --query "getDeviceId" --trace --depth 3 --style dex

Landroid/telephony/TelephonyManager;->getDeviceId()Ljava/lang/String;
└── TelephonyManager.getDeviceId(Landroid/telephony/TelephonyManager;)Ljava/lang/String;
    ├── PhoneInfo.getImei(Landroid/content/Context;)Ljava/lang/String;
    ├── ClientIdHelper.initClientId(Landroid/content/Context;)Ljava/lang/String;
    └── DeviceInfo.k(Landroid/content/Context;)V

```json
{
  "targets": [{
    "api": "android.telephony.TelephonyManager.getDeviceId()",
    "tree": {
      "method": "android.telephony.TelephonyManager.getDeviceId(TelephonyManager.java)",
      "callers": [
        { "method": "com.example.aopsdk.TelephonyManager.getDeviceId(TelephonyManager.java)",
          "callers": [
            { "method": "com.example.session.PhoneInfo.getImei(PhoneInfo.java)" },
            { "method": "com.example.logging.ClientIdHelper.initClientId(ClientIdHelper.java)" }
          ]}
      ]
    }
  }]
}

```json
{
  "targets": [{
    "api": "android.telephony.TelephonyManager.getDeviceId()",
    "chains": [
      ["com.example.session.PhoneInfo.getImei(PhoneInfo.java)",
       "com.example.aopsdk.TelephonyManager.getDeviceId(TelephonyManager.java)",
       "android.telephony.TelephonyManager.getDeviceId(TelephonyManager.java)"],
      ["com.example.logging.ClientIdHelper.initClientId(ClientIdHelper.java)",
       "com.example.aopsdk.TelephonyManager.getDeviceId(TelephonyManager.java)",
       "android.telephony.TelephonyManager.getDeviceId(TelephonyManager.java)"]
    ]
  }]
}

```json
{
  "target": "Landroid/telephony/TelephonyManager;->getDeviceId()Ljava/lang/String;",
  "chain": [
    { "method": { "dex_signature": "...", "class": "...", "name": "getImei",
                   "param_types": ["Landroid/content/Context;"], "return_type": "Ljava/lang/String;",
                   "java_readable": "com.example.session.PhoneInfo.getImei(...)" }},
    { "method": { "dex_signature": "...", "java_readable": "...TelephonyManager.getDeviceId(...)" }},
    { "method": { "dex_signature": "...", "java_readable": "...TelephonyManager.getDeviceId(...)" }}
  ],
  "depth": 2
}

**إخراج الأسماء التي تم إزالة التعتيم عنها في التتبع:**```bash
# Tree trace with deobfuscated names
dexfinder --dex-file app.apk --query "KotlinCases" --mapping mapping.txt --trace --depth 3

com.example.kotlin.KotlinCases$$ExternalSyntheticLambda1.<init>(int)
└── com.example.TestEntry.runAllTests(TestEntry.java)
    └── com.example.MainActivity.onCreate(MainActivity.java)

**جميع التراكيب مع الأعلام الأخرى:**```bash
# Original name + trace as flat list
dexfinder --dex-file app.apk --query "KotlinCases" --mapping mapping.txt --trace --layout list

# Original name + DEX signature style
dexfinder --dex-file app.apk --query "KotlinCases" --mapping mapping.txt --trace --style dex

# Original name + JSON tree + show-obf
dexfinder --dex-file app.apk --query "KotlinCases" --mapping mapping.txt --show-obf --trace --format json

# Original name + reverse direction (what does this class call?)
dexfinder --dex-file app.apk --query "com.example.kotlin.KotlinCases" --mapping mapping.txt --scope caller

### 11. البحث عن ثوابت النصوص (content:// URIs, API keys, etc.)```bash
# Find content:// URIs in code
dexfinder --dex-file app.apk --query "content://com.android.contacts" --scope string

# Include strings only in DEX table (optimized out by R8, annotations, etc.)
dexfinder --dex-file app.apk --query "content://com.android.contacts" --scope everything

[STRING] "content://com.android.contacts/" (1 ref)
       Lcom/example/imageloader/BaseImageDownloader;->getStreamFromContent(Ljava/lang/String;)Ljava/io/InputStream;
[STRING_TABLE] "content://com.android.contacts" (in DEX string table, no code reference found)

### 13. اجمع كل شيء```bash
# Deobfuscated JSON tree of location API usage, filtered to your code
dexfinder --dex-file app.apk \
  --query "android.location.LocationManager#requestLocationUpdates" \
  --trace --depth 8 \
  --format json --layout tree --style java \
  --mapping mapping.txt --show-obf \
  --class-filter "Lcom/mycompany/"

يفتح في أي متصفح — أشجار استدعاء قابلة للطي، شريط بحث، سمة داكنة.

### 15. SARIF لـ GitHub Code Scanning```bash
dexfinder --dex-file app.apk --api-flags hiddenapi-flags.csv --format sarif > results.sarif
# Upload to GitHub:
# gh api repos/OWNER/REPO/code-scanning/sarifs -f "[email protected]"

### 17. بوابة CI مع --fail-on```bash
# Fail CI if any blocked hidden APIs are used
dexfinder --dex-file app.apk --api-flags hiddenapi-flags.csv --fail-on blocked
# Exit code: 0 = clean, 2 = violations found

دائمًا ما تتجاوز أعلام CLI قيم ملف الإعدادات.

## البناء من المصدر```bash
git clone https://github.com/JuneLeGency/dexfinder.git
cd dexfinder
go build -o dexfinder ./cmd/dexfinder/
go test ./...

**تثبيت النصوص البرمجية** (نظام الكشف التلقائي):```bash
curl -sSL https://raw.githubusercontent.com/JuneLeGency/dexfinder/main/install.sh | bash

**تحميل ثنائي**: [Releases](https://github.com/JuneLeGency/dexfinder/releases)

## بداية سريعة```bash
# 查看 APK 概况
dexfinder --dex-file app.apk --stats

# 查找所有 getDeviceId 调用（获取 IMEI）
dexfinder --dex-file app.apk --query "getDeviceId"

# 追踪调用链（合并树形视图）
dexfinder --dex-file app.apk --query "getDeviceId" --trace

# 追踪调用链（展开为独立调用栈）
dexfinder --dex-file app.apk --query "getDeviceId" --trace --layout list

# 用精确 JNI 签名查询
dexfinder --dex-file app.apk \
  --query "Landroid/telephony/TelephonyManager;->getDeviceId()Ljava/lang/String;" \
  --trace --depth 8

### `--layout` 对比（配合 `--trace`）

**tree** — 合并共同路径，一棵树展示全貌。```
android.telephony.TelephonyManager.getDeviceId()
└── ...aopsdk...TelephonyManager.getDeviceId(TelephonyManager.java)
    ├── PhoneInfo.getImei(PhoneInfo.java)
    ├── ClientIdHelper.initClientId(ClientIdHelper.java)
    │   └── ContextInfo.<init>(ContextInfo.java)
    └── DeviceInfo.k(DeviceInfo.java)
        └── DeviceInfo.getInstance(DeviceInfo.java)
            ├── TidHelper.getIMEI(TidHelper.java)
            └── DeviceCollector.collectData(DeviceCollector.java)

### `--style` مقارنة

**java** (افتراضي): `com.example.Foo.method(Foo.java)`
**dex**: `Foo.method(Ljava/lang/String;)V`

### مخرجات JSON```bash
# JSON 树
dexfinder --dex-file app.apk --query "getDeviceId" --trace --format json

# JSON 列表
dexfinder --dex-file app.apk --query "getDeviceId" --trace --format json --layout list

`--scope=all` (افتراضي) = `callee` + `string`. تم استبعاد اتجاه `caller` عمداً من الافتراضي لأنه يجيب على سؤال مختلف تماماً. قم بتمكينه صراحةً باستخدام `--scope=caller` أو `--scope=everything` عند الحاجة.

**معنى العلامات المخرجة:**

| العلامة | المعنى |
|---|---|
| `[METHOD]` | الطريقة التي تبحث عنها **تم استدعاؤها بواسطة آخرين**. السطر البادئ هو المستدعي. |
| `[FIELD]` | الحقل الذي تبحث عنه **تم الوصول إليه بواسطة آخرين**. السطر البادئ هو الواصل. |
| `[CALLER→]` | اسم الطريقة التي تبحث عنها يظهر في **مستدعي** ما، السطر البادئ يظهر أي API تم استدعاؤه. |
| `[STRING]` | تطابق ثابت سلسلة نصية في الكود. السطر البادئ هو الطريقة التي تستخدم هذه السلسلة. |
| `[STRING_TABLE]` | السلسلة موجودة فقط في جدول سلاسل DEX، ولا يوجد مرجع `const-string` في الكود (قد تكون في تعليقات توضيحية، محسّنة بواسطة R8، إلخ). |

## المزيد من الاستخدامات

### إزالة الإبهام (--mapping)

بعد تحميل `--mapping`، يدعم كل من **المدخلات والمخرجات** الأسماء الأصلية (غير المبهمة).

**الاستعلام بالاسم الأصلي → يتم تحويله تلقائياً إلى اسم مبهم للبحث في DEX:**```bash
# 用原始简短类名查（mapping 内部将 "KotlinCases" 转为 "LJ7;"）
dexfinder --dex-file app.apk --query "KotlinCases" --mapping mapping.txt

# 用原始 Java 全名查
dexfinder --dex-file app.apk --query "com.example.app.utils.Helper" --mapping mapping.txt

# 用混淆名查也正常工作
dexfinder --dex-file app.apk --query "LJ7;" --mapping mapping.txt

**عرض الأسماء المبهمة والأسماء الأصلية في نفس الوقت:**```bash
dexfinder --dex-file app.apk --query "KotlinCases" --mapping mapping.txt --show-obf --trace

com.example.KotlinCases.fetchLocationAsync(KotlinCases.java)
└── com.example.KotlinCases$testCoroutines$3.invokeSuspend(KotlinCases.java)  [obf: G7.e]

**مصفوفة الإدخال × الإخراج:**

| مدخل الاستعلام | بدون mapping | `--mapping` | `--mapping --show-obf` |
|---|---|---|---|
| اسم مبهم `LJ7;` | ✓ إخراج مبهم | ✓ إخراج غير مبهم | ✓ كليهما جنبًا إلى جنب |
| اسم قصير أصلي `KotlinCases` | ✗ غير موجود | ✓ تحويل تلقائي + إخراج غير مبهم | ✓ تحويل تلقائي + كليهما جنبًا إلى جنب |
| اسم كامل أصلي `com.example...` | ✗ غير موجود | ✓ تحويل تلقائي + إخراج غير مبهم | ✓ تحويل تلقائي + كليهما جنبًا إلى جنب |

### Hidden API كشف```bash
# 下载 CSV（一次性）
curl -o hiddenapi-flags.csv \
  https://dl.google.com/developers/android/baklava/non-sdk/hiddenapi-flags.csv

# 全量检测（直接链接 + 反射检测）
dexfinder --dex-file app.apk --api-flags hiddenapi-flags.csv

### تصفية حسب اسم الحزمة```bash
# 只扫描自己的代码
dexfinder --dex-file app.apk --query "getDeviceId" --class-filter "Lcom/mycompany/"

### HTML تقرير```bash
dexfinder --dex-file app.apk --query "getDeviceId" --trace --format html --output report.html

### مقارنة إصدارات APK```bash
dexfinder --dex-file new.apk --diff old.apk --query "getDeviceId"

+ 1 added method(s)
  + Lcom/new/Feature;->trackDevice()V

- 1 removed method(s)
  - Lcom/old/Legacy;->getIMEI()V

Summary: +1 added, -1 removed, ~0 changed

## الأداء

على شرائح Apple M، خيط واحد:

| حجم APK | عدد DEX | عدد الفئات | مراجع الطرق | المسح الضوئي | Hidden API |
|---|---|---|---|---|---|
| ~1 MB | 1 | ~2K | ~18K | **24ms** | — |
| ~10 MB | 2 | ~25K | ~100K | **335ms** | — |
| ~300 MB | 30+ | ~180K | ~1.2M | **3.9s** | **5.4s** |

مقارنة مع veridex (C++) على نفس APK ~300MB:
- veridex precise: **27s** (لا يمكنه تتبع انعكاس Binder/AIDL)
- veridex imprecise: **أكثر من 32 دقيقة** (انفجار حاصل ضرب ديكارتي، تم قتله)
- **dexfinder: 5.4s** (تحسين الفهرس العكسي)

## جميع الوسائط

| الوسيط | الوصف | القيمة الافتراضية |
|---|---|---|
| `--dex-file` | مسار ملف APK/DEX/JAR ** (مطلوب)** | — |
| `--query` | كلمة البحث (Java / DEX/JNI / اسم بسيط) | — |
| `--trace` | تفعيل تتبع سلسلة الاستدعاء (يتطلب `--query`) | `false` |
| `--depth` | أقصى عمق لسلسلة الاستدعاء | `5` |
| `--layout` | تخطيط التتبع: `tree` (شجرة مدمجة) أو `list` (قائمة موسعة) | `tree` |
| `--style` | نمط التسمية: `java` (قابل للقراءة) أو `dex` (توقيع JNI) | `java` |
| `--format` | تنسيق الإخراج: `text`، `json`، `model`، `html`، `sarif` | `text` |
| `--output` | إخراج إلى ملف بدلاً من stdout | — |
| `--color` | وضع الألوان: `auto`، `always`، `never` | `auto` |
| `--mapping` | مسار ملف ProGuard/R8 mapping.txt | — |
| `--show-obf` | عرض الأسماء المبهمة وغير المبهمة معًا | `false` |
| `--api-flags` | مسار hiddenapi-flags.csv | — |
| `--class-filter` | تصفية بادئة واصف الفئة (مفصولة بفواصل) | — |
| `--exclude-api-lists` | مستويات API المستبعدة | — |
| `--scope` | نطاق البحث: `all`، `callee`، `caller`، `string`، `string-table`، `everything` | `all` |
| `--diff` | مقارنة مع APK/DEX آخر، عرض اختلافات API | — |
| `--fail-on` | إرجاع رمز خروج غير صفري عند اكتشاف API بمستوى محدد (نقطة تحقق CI) | — |
| `--stats` | عرض ملخص إحصائي فقط | `false` |
| `--version` | عرض رقم الإصدار | `false` |

### ملف التكوين

قم بإنشاء `.dexfinder.yaml` في جذر المشروع لتعيين القيم الافتراضية:```yaml
mapping: ./build/outputs/mapping.txt
class-filter: "Lcom/mycompany/"
api-flags: ./hiddenapi-flags.csv
style: java
depth: 8
color: auto

## الترخيص