元ドキュメント: iOS CLI User Guide
iOS CLI ツール ご利用ガイド
概要
iOS CLI版ハードニングツールは、IPAファイルに対してコマンドラインベースでハードニング処理を実行するためのツールです。CI/CDパイプラインに組み込むことで、ビルドプロセスの一部として自動的にハードニングを実行できます。
前提条件
- macOS環境（推奨：macOS 12以上）
- ACEコンソールアカウントの取得
- ゲームIDの登録完了
- ハードニングツールパッケージのダウンロード
- 対応する証明書ファイルの取得
インストール
ツールのダウンロード
ACEコンソールからiOS CLI版ハードニングツールパッケージをダウンロードし、任意のディレクトリに展開します。
権限設定
bash
cd /path/to/ios-hardening-tool
chmod -R 755 ./*基本的な使用方法
IPAハードニングコマンド
bash
./IPAGuardCLI --game-id <gameId> --input <ipaPath> --output <outDir> --cert <certPath> --config <configPath>パラメータ説明
| パラメータ | 説明 |
|---|---|
--game-id | ゲームID（コンソールで登録） |
--input | ハードニング対象IPAファイルのパス |
--output | 出力先ディレクトリのパス |
--cert | 証明書ファイルのパス |
--config | 設定ファイルのパス |
設定ファイル
設定ファイルでは、保護レベルや対象モジュールを指定できます：
json
{
"protection_level": "high",
"obfuscation": true,
"anti_debug": true,
"anti_hook": true,
"framework_encryption": ["UnityFramework.framework"],
"exclude_classes": []
}設定項目
| 項目 | 説明 | デフォルト値 |
|---|---|---|
| protection_level | 保護レベル（low/medium/high） | medium |
| obfuscation | コード難読化の有効化 | true |
| anti_debug | デバッグ対策の有効化 | true |
| anti_hook | フック対策の有効化 | true |
| framework_encryption | 暗号化対象の.framework | [] |
| exclude_classes | 保護対象外のクラス | [] |
実行結果
| 出力メッセージ | 説明 |
|---|---|
| Hardening completed successfully | ハードニング正常完了 |
| Error: Invalid IPA file | 不正なIPAファイル |
| Error: Certificate mismatch | 証明書不一致 |
| Error: Configuration error | 設定エラー |
ハードニング効果の検証
注意事項
- ハードニング後のIPAはApp Storeへの提出前に十分なテストを実施してください
- プライベートAPIを使用していないため、App Store審査には影響しません
- 処理時間はIPAのサイズと保護レベルにより異なります（一般的に5〜15分）