# Python 3.7+ 標準ライブラリのみ必要、追加依存なし
python3 --version  # Python バージョンの確認

# ステップ 1: テストを実行
python test_demo.py

# ステップ 2: 単一 APK を検出
python unity_vulnerability_checker.py your_game.apk

# ステップ 3: 一括検出
python unity_vulnerability_checker.py --batch /path/to/apks

# ステップ 4: 使用例を確認
python usage_examples.py

from unity_vulnerability_checker import check_unity_vulnerability

# 単一の APK ファイルを検出
result = check_unity_vulnerability("your_game.apk")

# 方法 1: 便利なプロパティを使用
if result.is_vulnerable:
    print(f"⚠️  アプリが影響を受けています！({result.version})")
    print(f"推奨：{result.recommendation}")
elif result.is_safe:
    print(f"✅ アプリは安全です")
    print(f"理由：{result.message}")
else:
    print(f"❓ 手動確認が必要です")
    print(f"理由：{result.message}")

# 方法 2: status フィールドを使用
if result.status == "positive":
    print(f"影響あり：{result.version}")

from unity_vulnerability_checker import batch_check

# ディレクトリを一括スキャン
results = batch_check("/path/to/apk/folder")

# 影響を受けるアプリをフィルタリング
vulnerable_apps = [
    (name, result) 
    for name, result in results.items() 
    if result.is_vulnerable
]
print(f"{len(vulnerable_apps)} 個の影響を受けるアプリを発見")
for name, result in vulnerable_apps:
    print(f"  - {name}: {result.version}")

from unity_vulnerability_checker import UnityVulnerabilityChecker

class MyPlatform:
    """あなたのゲームプラットフォームシステム"""

    def __init__(self):
        self.checker = UnityVulnerabilityChecker()

    def check_new_upload(self, apk_path: str) -> bool:
        """新しくアップロードされた APK をチェックし、公開可能かどうかを返す"""
        result = self.checker.check_apk(apk_path)

        if result.is_vulnerable:
            # 影響あり - 公開を拒否
            self.notify_developer(
                f"あなたのアプリは Unity の脆弱性の影響を受けています\n"
                f"バージョン：{result.version}\n"
                f"推奨：{result.recommendation}"
            )
            return False
        elif result.is_safe:
            # 安全 - 公開を承認
            return True
        else:
            # 判断不能 - 手動確認
            self.queue_manual_review(apk_path, result.message)
            return False

    def notify_developer(self, message: str):
        """開発者に通知（通知ロジックを実装）"""
        pass

    def queue_manual_review(self, apk_path: str):
        """手動確認キューに追加（ロジックを実装）"""
        pass

# 影響を受けるアプリ
⚠️  このアプリは CVE-2025-59489 の影響を受けています (Unity 2019.2.6f1)

# 安全なアプリ（3 つのケース）
✅ このアプリは安全です - Unity アプリではありません
✅ このアプリは安全です - Unity patcher ツールで修正済み
✅ このアプリは安全です - 修正済みバージョン (2019.4.41f1)

# 判断不能
❓ 判断不能 - Unity アプリですがバージョンを抽出できません。パッキングや難読化の可能性があり、手動確認を推奨します
⚠️  ファイルが大きすぎて処理できません (1500.0MB、制限 1024MB) - コードの 15 行目の MAX_APK_SIZE_MB をより大きな値に変更してください

.
├── unity_vulnerability_checker.py  # コアモジュール
│   ├─ UnityVulnerabilityChecker クラス - 脆弱性検出コアエンジン
│   ├─ check_unity_vulnerability() - 簡略化された検出関数
│   ├─ batch_check() - 一括検出機能
│   └─ 完全なバージョン解析・判定ロジック
│
├── usage_examples.py               # 使用例
│   ├─ 基本的な使用例
│   ├─ 一括検出の例
│   ├─ プラットフォーム統合の例
│   ├─ 自動応答の例
│   └─ Flask API 統合の例
│
├── test_demo.py                    # テストデモ
│   ├─ バージョン番号解析テスト
│   ├─ バージョン抽出テスト
│   ├─ 修正判定テスト
│   ├─ APK スキャンシナリオシミュレーション
│   └─ パフォーマンスベンチマークテスト
│
├── test_version_detection.py       # ユニットテスト（33 テストケース）
│
├── README.md                       # 完全なドキュメント（クイックスタートガイドを含む）
│
└── CLAUDE.md                       # 開発規約

# 単一ファイルの検出
python unity_vulnerability_checker.py game.apk

# 詳細ログモード
python unity_vulnerability_checker.py game.apk -v

# ディレクトリの一括検出
python unity_vulnerability_checker.py --batch /path/to/apk/folder

# 一括検出（詳細モード）
python unity_vulnerability_checker.py --batch /path/to/apk/folder -v

from unity_vulnerability_checker import batch_check

results = batch_check("/path/to/apk/directory", verbose=True)

# 影響を受けるアプリをフィルタリング
vulnerable = {name: result for name, result in results.items()
              if result.is_vulnerable}

print(f"{len(vulnerable)} 個の影響を受けるアプリを発見")

from unity_vulnerability_checker import UnityVulnerabilityChecker

class AppReviewSystem:
    def __init__(self):
        self.checker = UnityVulnerabilityChecker(verbose=False)

    def review_upload(self, apk_path: str) -> str:
        result = self.checker.check_apk(apk_path)

        if result.is_vulnerable:
            return "REJECT"  # 公開を拒否
        elif result.is_safe:
            return "APPROVE"  # 承認
        else:
            return "MANUAL_REVIEW"  # 手動確認

reviewer = AppReviewSystem()
decision = reviewer.review_upload("new_game.apk")

from flask import Flask, request, jsonify
from unity_vulnerability_checker import check_unity_vulnerability

app = Flask(__name__)

@app.route('/api/scan', methods=['POST'])
def scan_apk():
    file = request.files['file']
    temp_path = f"/tmp/{file.filename}"
    file.save(temp_path)

    result = check_unity_vulnerability(temp_path)

    # to_dict() メソッドを使用して直接 JSON に変換
    response = result.to_dict()
    response["filename"] = file.filename
    response["vulnerable"] = result.is_vulnerable
    
    return jsonify(response)

          ┌─────────────────┐
          │   APK ファイルを読込  │
          └────────┬─────────┘
                   │
                   ▼
          ┌─────────────────┐
          │ Unity アプリか?  │──NO──> negative
          └────────┬─────────┘
                   │ YES
                   ▼
          ┌─────────────────────┐
          │ patcher パッチ検出? │──YES──> negative
          └────────┬─────────────┘
                   │ NO
                   ▼
          ┌─────────────────┐
          │ Unity バージョン抽出 │──失敗──> inconclusive
          └────────┬─────────┘
                   │ 成功
                   ▼
          ┌─────────────────┐
          │ バージョン < 2017.1 ? │──YES──> negative
          └────────┬─────────┘
                   │ NO
                   ▼
          ┌─────────────────┐
          │  修正済みバージョン？ │──YES──> negative
          └────────┬─────────┘
                   │ NO
                   ▼
               positive

from unity_vulnerability_checker import check_unity_vulnerability

def pre_publish_check(apk_path):
    result = check_unity_vulnerability(apk_path)
    if result.is_vulnerable:
        return {
            "approved": False, 
            "reason": f"CVE-2025-59489 vulnerability detected ({result.version})",
            "recommendation": result.recommendation
        }
    return {"approved": True, "message": result.message}

python unity_vulnerability_checker.py --batch /data/published_apps > scan_report.txt

import schedule
from unity_vulnerability_checker import batch_check

def daily_scan():
    results = batch_check("/data/new_uploads")
    vulnerable = [(name, result) for name, result in results.items() if result.is_vulnerable]
    if vulnerable:
        # 詳細情報を含む通知を送信
        for name, result in vulnerable:
            send_notification(name, result.version, result.message)

schedule.every().day.at("02:00").do(daily_scan)

from unity_vulnerability_checker import batch_check
import json

results = batch_check("/data/all_apps")
report = {
    "total": len(results),
    "vulnerable": sum(1 for r in results.values() if r.is_vulnerable),
    "safe": sum(1 for r in results.values() if r.is_safe),
    "unclear": sum(1 for r in results.values() if r.is_uncertain),
    # 詳細リスト
    "vulnerable_apps": [
        {"name": name, "version": r.version, "message": r.message}
        for name, r in results.items() if r.is_vulnerable
    ]
}

with open("security_report.json", "w") as f:
    json.dump(report, f, indent=2)

#!/bin/bash
# CI パイプラインで使用

python unity_vulnerability_checker.py build/output.apk
result=$(python unity_vulnerability_checker.py build/output.apk | grep "検出結果")

if echo "$result" | grep -q "positive"; then
    echo "Security check failed: CVE-2025-59489 detected"
    exit 1
fi

echo "Security check passed"

# 依存関係のインストール
pip install ruff pre-commit

# pre-commit hooks のインストール
pre-commit install

# すべてのチェックを手動実行
pre-commit run --all-files

# pre-commit が失敗した場合、一部の問題は自動修正されます
# 修正後は再度 git add してコミットする必要があります
git add .
git commit -m "your message"

# Python ファイルのみチェック
ruff check *.py

# 問題を自動修正
ruff check --fix *.py

# コードをフォーマット
ruff format *.py