元ドキュメント: CLI Tool User Guide

CLI ツール ご利用ガイド

概要

CLI版ハードニングツールは、コマンドラインインターフェースを通じてAndroidゲームパッケージ（APK/AAB）のセキュリティハードニングを実行するためのツールです。CI/CDパイプラインに統合可能で、自動化ビルドフローの一部としてハードニング処理を効率的に行うことができます。

前提条件

• ACEコンソールアカウントの取得
• ゲームIDの登録完了
• ハードニングツールパッケージのダウンロード
• 対応する証明書ファイル（Game_ID.cert）の取得

インストールと環境設定

対応OS

OS	アーキテクチャ	備考
Windows	x86 / x64	OS構成に合わせてバージョンを選択
macOS	x64 / ARM64	—
Linux	x86 / x64	OS構成に合わせてバージョンを選択

権限設定（Mac / Linux）

ツールを使用する前に、以下のコマンドで実行権限を付与してください：

cd where_your_mtpclientconsole_dir
chmod -R 777 ./*

基本的な使用方法

APKハードニング

MTPClientConsole.exe -d <gameId> <apkPath> <outDir> <certPath> -c <configPath>

App Bundleハードニング

MTPClientConsole.exe -a <gameId> <aabPath> <outDir> <certPath> -c <configPath>

パラメータ説明

パラメータ	説明
-d	APKハードニングモード（デフォルト）
-a	App Bundleハードニングモード
gameId	ゲームID（コンソールで登録）
apkPath / aabPath	ハードニング対象ファイルの完全パス
outDir	ハードニング後ファイルの出力先パス
certPath	証明書ファイルのパス（Game_ID.cert）
-c	設定ファイル指定オプション
configPath	tpshell-config.xml設定ファイルのパス

設定ファイル（tpshell-config.xml）

<?xml version="1.0" encoding="utf-8"?>
<Config>
    <TPVersion>default</TPVersion>
    <ToolPath>your_tool_absolute_path</ToolPath>
    <Sign>
        <sign-argument name="keystorePath" value="your_keystore_path"/>
        <sign-argument name="keypass" value="your_key_password"/>
        <sign-argument name="storepass" value="your_store_password"/>
        <sign-argument name="alianame" value="your_alias"/>
    </Sign>
    <EncSo>libil2cpp.so</EncSo>
    <extparams>{
        "enable_globalmetadata_enc": true
    }</extparams>
</Config>

設定項目

項目	説明
TPVersion	ハードニングバージョン番号
ToolPath	toolsディレクトリの絶対パス
Sign	署名証明書情報（任意）
EncSo	暗号化対象.soファイル名
enable_globalmetadata_enc	global-metadata.dat暗号化の有効化

ハードニング結果

返却メッセージ	説明
The shelling task was finished	ハードニングタスク正常完了
Shell failed for time out	タイムアウトエラー
Configuration error	設定解析エラー
Command line parameter error	パラメータエラー
Shelling error	ハードニングエラー

バッチ処理

複数のAPKファイルをバッチ処理する場合、以下のディレクトリ構造を参照してください：

注意事項

1. パス名に非ASCII文字を含めないでください
2. 設定ファイルのタグペアは同一行に配置してください
3. ハードニング前後で署名方式を同一バージョンに維持してください
4. 同時実行プロセス数は10個以下を推奨します