難読化されたスタックトレースを Gemini に渡していました — retrace を前段に置くまで、診断はもっともらしく外れ続けます

# mapping ファイルは release ビルドの出力に生成されます
ls app/build/outputs/mapping/release/mapping.txt
 
# トレースを渡すと、名前を復元して返します
$ANDROID_HOME/cmdline-tools/latest/bin/retrace \
  app/build/outputs/mapping/release/mapping.txt \
  crash.txt
 
# ファイルを渡さない場合は標準入力から読みます
cat crash.txt | $ANDROID_HOME/cmdline-tools/latest/bin/retrace mapping.txt

# Before（Gemini に渡していたもの）
java.lang.NullPointerException
    at a.a.a.b(SourceFile:0)
    at a.a.c.a(SourceFile:0)
 
# After（retrace を通したもの）
java.lang.NullPointerException
    at net.dolice.wallpapers.cache.WallpaperCacheKeyBuilder.append(WallpaperCacheKeyBuilder.kt:47)
    at net.dolice.wallpapers.cache.DiskCacheWriter.write(DiskCacheWriter.kt:112)

// proguard-rules.pro — 既定ファイルに入っているものを、
// 自分で上書きしたり消したりしていないかをまず確認します
-keepattributes SourceFile,LineNumberTable
-renamesourcefileattribute SourceFile

android {
    buildTypes {
        release {
            isMinifyEnabled = true
            proguardFiles(
                getDefaultProguardFile("proguard-android-optimize.txt"),
                "proguard-rules.pro"
            )
            // Crashlytics 画面での復元用。自前パイプラインはこれとは無関係に
            // mapping.txt を versionCode つきで保管する必要があります
            configure<com.google.firebase.crashlytics.buildtools.gradle.CrashlyticsExtension> {
                mappingFileUploadEnabled = true
            }
        }
    }
}

from google import genai
from google.genai import types
 
client = genai.Client()  # 環境変数 GEMINI_API_KEY を参照します
 
DIAGNOSIS_SCHEMA = {
    "type": "object",
    "properties": {
        # 復元済みトレースの、実在する行だけを引用させます。
        # 難読化済みなら a.a.a.b がそのまま入り、後段で弾けます
        "evidence_frames": {
            "type": "array",
            "items": {"type": "string"},
            "minItems": 1,
        },
        "root_cause": {"type": "string"},
        # 難読化済みのときは low 以外を選べないよう、指示側で縛ります
        "confidence": {"type": "string", "enum": ["high", "medium", "low"]},
        # low のときは、原因ではなく「確認すべき箇所」を返させます
        "next_checks": {"type": "array", "items": {"type": "string"}},
    },
    "required": ["evidence_frames", "root_cause", "confidence", "next_checks"],
}
 
DEOBFUSCATED_INSTRUCTION = (
    "あなたは Android の例外を診断します。"
    "スタックトレースは R8 の mapping で復元済みで、クラス名とメソッド名は実名です。"
    "evidence_frames には、渡されたトレースに実在する行だけをそのまま引用してください。"
    "引用できない推測は書かないでください。"
)
 
OBFUSCATED_INSTRUCTION = (
    "あなたは Android の例外を診断します。"
    "以下のスタックトレースは R8 で難読化されており、クラス名とメソッド名は失われています。"
    "実名を推測してはいけません。RecyclerView や Glide など、"
    "具体的なライブラリ名を根拠なく挙げることを禁じます。"
    "confidence は必ず low とし、root_cause には "
    "『難読化のため特定不可』と書き、next_checks に "
    "『どの mapping を探せば復元できるか』の観点のみを列挙してください。"
)
 
def diagnose(stack_trace: str, deobfuscated: bool) -> dict:
    resp = client.models.generate_content(
        model="gemini-3.5-flash",
        contents=stack_trace,
        config=types.GenerateContentConfig(
            system_instruction=(
                DEOBFUSCATED_INSTRUCTION if deobfuscated else OBFUSCATED_INSTRUCTION
            ),
            response_mime_type="application/json",
            response_schema=DIAGNOSIS_SCHEMA,
            temperature=0.0,
        ),
    )
    return resp.parsed

def verify(result: dict, stack_trace: str) -> tuple[bool, str]:
    """トレースに実在しない行を引用していたら、その診断は採用しません。"""
    for frame in result["evidence_frames"]:
        if frame.strip() not in stack_trace:
            return False, f"実在しない行を引用しています: {frame}"
    if not result["evidence_frames"]:
        return False, "根拠が空です"
    return True, "ok"

import subprocess, pathlib
 
MAPPING_DIR = pathlib.Path("mapping")   # mapping/{versionCode}.txt を置いた場所
RETRACE = pathlib.Path("/opt/android-sdk/cmdline-tools/latest/bin/retrace")
 
def resolve_mapping(version_code: int) -> pathlib.Path | None:
    """近いバージョンでの代用はしません。完全一致だけを返します。"""
    path = MAPPING_DIR / f"{version_code}.txt"
    return path if path.exists() else None
 
def retrace(stack_trace: str, mapping: pathlib.Path) -> str:
    proc = subprocess.run(
        [str(RETRACE), str(mapping)],
        input=stack_trace, capture_output=True, text=True, timeout=30,
    )
    if proc.returncode != 0:
        raise RuntimeError(f"retrace failed: {proc.stderr.strip()}")
    return proc.stdout
 
def analyze(payload: dict) -> dict:
    mapping = resolve_mapping(payload["versionCode"])
    if mapping is None:
        # 復元できない：断定を禁じたまま、観点だけ受け取ります
        return diagnose(payload["stackTrace"], deobfuscated=False)
 
    restored = retrace(payload["stackTrace"], mapping)
    result = diagnose(restored, deobfuscated=True)
    ok, reason = verify(result, restored)
    if not ok:
        result["confidence"] = "low"
        result["next_checks"].insert(0, f"根拠の照合に失敗しました: {reason}")
    return result