**スクリプト** (OS/アーキテクチャを自動検出):```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

## 出力制御

3つの独立した軸、自由に組み合わせ可能:```
--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]` | クエリに一致する**呼び出されている**メソッド（calleeマッチ）。インデント行は呼び出し元。 |
| `[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:// URI、APIキーなど）```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 for 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. --fail-on による CI ゲート```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** — 共通パスを統合し、1つのツリーで全体像を表示：```
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 --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 数 | クラス数 | メソッド参照 | スキャン | 隠し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++) と同一の ~300MB APK での比較：
- 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

## 许可证

Apache License 2.0