ADT CLI リファレンス

Last updated on April 7, 2026

注釈：本資料はAI技術を用いて翻訳されています。

AccelByte Development Toolkit CLI

ADT SDK の使用をサポートするコマンドラインツールです。バージョン管理、ビルド登録、シンボルのアップロード、バイナリ配布など、ADT を適切に使用するための重要なデータの準備と送信を支援します。

グローバルオプション

これらのオプションは任意のコマンドで使用できます。

オプション	説明
--api-key	認証用の API キー
--base-url	API エンドポイントのベース URL
--cdn-url	CDN URL
--game-archive-path	ゲームアーカイブへのパス
--game-engine-path	ゲームエンジンインストールへのパス
--game-project-path	ゲームプロジェクトへのパス
--game-config-path-override	ゲーム設定パスのオーバーライド
--name-space	ネームスペース識別子
--server-archive-path	サーバーアーカイブへのパス
--proxy	ネットワークリクエスト用のプロキシ URL
--no-log	ログ出力を無効にする
--show-version	CLI バージョン情報を表示する
--unity	Unity エンジンモードを強制する（デフォルトでは、CLI はエンジンを自動検出します）

コマンド

build

ゲームビルドの管理（登録、メタデータ、バイナリアップロード、ステータス管理を含む）。

build register

バックエンドにビルドを登録し、Blackbox.ini ファイルに保存します。

オプション	説明
--platform-arch	ターゲットプラットフォームアーキテクチャ
--platform-name	ターゲットプラットフォーム名
--version-name	ビルドを関連付けるバージョン名
--version-id	ビルドを関連付けるバージョン ID
--branch-name	ソースコントロールブランチ名
--editor-build	これがエディタービルドであることを示すフラグ
--smartbuild	このビルドのスマートビルドを有効にするフラグ
--create-new	新しいビルドを強制的に作成する
--disable-set-game-config	自動ゲーム設定更新を無効にする
--enable-set-data-router	データルーター設定を有効にする
--is-release-candidate	ビルドをリリース候補としてマークする

build set

既存のビルドを確認し、見つかった場合は Blackbox.ini ファイルを設定します。

オプション	説明
--id	設定するビルド ID
--version-name	検索するバージョン名
--version-id	検索するバージョン ID
--enable-set-data-router	データルーター設定を有効にする

build get

Blackbox.ini ファイルを読み取り、BuildId をコンソールに出力します。

オプション	説明
--server-build-id-as-default	サーバービルド ID をデフォルトとして使用する

build upload-metadata

メタデータファイルをアップロードし、現在のビルドに関連付けます。

オプション	説明
--type	メタデータタイプ
--directory	メタデータファイルを含むディレクトリ
--file	アップロードする特定のメタデータファイル
--version-id	バージョン ID
--version-name	バージョン名
--build-id	ビルド ID
--force-parse	メタデータの再解析を強制する
--force-upload	メタデータが既に存在していてもアップロードを強制する
--server-build-id-as-default	サーバービルド ID をデフォルトとして使用する

build add-metadata

キーと値ベースのメタデータをアップロードし、現在のビルドに関連付けます。

オプション	説明
--key	メタデータキー
--value	メタデータ値
--version-id	バージョン ID
--version-name	バージョン名
--build-id	ビルド ID
--server-build-id-as-default	サーバービルド ID をデフォルトとして使用する

build upload-binaries

ゲームバイナリをバックエンドにアップロードします。

オプション	説明
--game-archive	アップロードするゲームアーカイブへのパス
--entry-point	実行可能なエントリーポイント
--build-id	バイナリを関連付けるビルド ID
--version-id	バージョン ID
--launch-arguments	ビルドの起動引数
--ignore-config-filepath	特定のファイルを無視するための設定ファイルパス
--log-level	ログ詳細レベル
--multipart-upload-size	各マルチパートアップロードチャンクのサイズ
--show-confirmation	アップロード確認プロンプトを表示する
--server-build-id-as-default	サーバービルド ID をデフォルトとして使用する
--force-upload	バイナリが既に存在していてもアップロードを強制する
--show-active-diagnostic	アクティブな診断情報を表示する

build set-stream

廃止予定 - 代わりに build-channel コマンドを使用してください。

現在のビルドをストリームに設定します。

オプション	説明
--version-id	バージョン ID
--build-id	ビルド ID
--stream-id	ターゲットストリーム ID
--server-build-id-as-default	サーバービルド ID をデフォルトとして使用する

build find-or-register

既存のビルドを検索し、見つからない場合は新しいビルドを登録します。

オプション	説明
--name	ビルド名
--platform-name	ターゲットプラットフォーム名
--platform-arch	ターゲットプラットフォームアーキテクチャ
--branch-name	ソースコントロールブランチ名
--smartbuild	スマートビルドを有効にする
--editor-build	これがエディタービルドであることを示すフラグ

build find-by-name

名前でビルドを検索します。

オプション	説明
--build-name	検索するビルドの名前
--version-id	検索するバージョン ID

build set-release-notes

現在のビルドのリリースノートを設定します。

オプション	説明
--version-id	バージョン ID
--build-id	ビルド ID
--release-notes-string	インライン文字列としてのリリースノート
--release-notes-path	リリースノートを含むファイルへのパス
--server-build-id-as-default	サーバービルド ID をデフォルトとして使用する

build prepare

ビルド情報を確認し、操作の準備をします。

オプション	説明
--build-id	準備するビルド ID

build set-build-status

現在のビルドのビルドステータスを設定します。

オプション	説明
--version-id	バージョン ID
--build-id	ビルド ID
--build-status	設定する新しいステータス
--server-build-id-as-default	サーバービルド ID をデフォルトとして使用する

build get-list-build-status

利用可能なすべてのビルドステータスのリストを取得します。

追加オプションなし。

build delete

ビルドを削除します。

オプション	説明
--version-id	バージョン ID
--version-name	バージョン名
--build-id	削除するビルド ID
--server-build-id-as-default	サーバービルド ID をデフォルトとして使用する

version

作成、メタデータ、チェンジリスト追跡、ライフサイクル管理を含むゲームバージョンの管理。

version add

バックエンドに新しいバージョンを作成し、Blackbox.ini ファイルに保存します。

オプション	説明
--name	新しいバージョンの名前
--disable-set-game-config	自動ゲーム設定更新を無効にする
--enable-set-data-router	データルーター設定を有効にする

version get

Blackbox.ini ファイルを読み取り、VersionId をコンソールに出力します。

追加オプションなし。

version set

既存のバージョンを確認し、見つかった場合は Blackbox.ini ファイルを設定します。

オプション	説明
--id	設定するバージョン ID
--name	検索するバージョン名
--enable-set-data-router	データルーター設定を有効にする

version list

ゲーム内の既存のバージョンを一覧表示します。

オプション	説明
--page	ページ番号（ページング結果用）
--limit	ページあたりの結果数
--start-time	開始時間でフィルタリングする
--end-time	終了時間でフィルタリングする

version add-changelist-info

Perforce チェンジリスト情報を追加し、現在のバージョンに関連付けます。

オプション	説明
--author	チェンジリストの作成者
--date-time	チェンジリストの日付と時刻
--description	チェンジリストの説明
--changelist-id	Perforce チェンジリスト ID

version add-changelist-bulk

ファイルから複数の Perforce チェンジリストエントリを一括で追加します。

オプション	説明
--file	チェンジリスト情報を含むファイルへのパス

version upload-metadata

メタデータファイルをアップロードし、現在のバージョンに関連付けます。

オプション	説明
--type	メタデータタイプ
--directory	メタデータファイルを含むディレクトリ
--file	アップロードする特定のメタデータファイル
--version-id	バージョン ID
--version-name	バージョン名
--force-parse	メタデータの再解析を強制する
--force-upload	メタデータが既に存在していてもアップロードを強制する

version add-metadata

キーと値ベースのメタデータをアップロードし、現在のバージョンに関連付けます。

オプション	説明
--version-id	バージョン ID
--version-name	バージョン名
--key	メタデータキー
--value	メタデータ値

version delete

バージョンを削除します。

オプション	説明
--version-id	削除するバージョン ID
--version-name	削除するバージョン名

version delete-bulk

日付範囲またはバージョン ID リストに基づいてバージョンを一括削除します。

オプション	説明
--date-start	削除範囲の開始日
--date-end	削除範囲の終了日
--version-ids	削除するバージョン ID のカンマ区切りリスト

version enable-auto-delete

保持期間に基づいてバージョンの自動削除を有効にします。

オプション	説明
--should-enable-auto-delete	自動削除を有効にするフラグ
--retention-period-days	バージョンを保持する日数

version disable-auto-delete

バージョンの自動削除を無効にします。

オプション	説明
--should-enable-auto-delete	自動削除を無効にするフラグ
--retention-period-days	保持期間（日数）

version get-auto-delete-config

現在の自動バージョン削除設定を取得します。

追加オプションなし。

credentials

CLI で使用する認証資格情報を管理します。

credentials set

資格情報エントリの値を設定します。

オプション	説明
--entry	資格情報エントリ名（例: client-id、client-secret、username、password）
--value	資格情報に設定する値

credentials get

資格情報エントリの値を取得します。

オプション	説明
--entry	取得する資格情報エントリ名

credentials list

現在保存されているすべての資格情報を一覧表示します。

追加オプションなし。

config

CLI 設定を管理します。

config set

設定エントリの値を設定します。

オプション	説明
--entry	設定エントリ名
--value	設定する値
--force-recreate	設定ファイルの強制再作成

config get

設定エントリの値を取得します。

オプション	説明
--entry	取得する設定エントリ名
--force-recreate	設定ファイルの強制再作成

config list

現在のすべての設定を一覧表示します。

オプション	説明
--force-recreate	設定ファイルの強制再作成

upload

ゲームの PDB ファイル、実行ファイル、breakpad シンボルファイルをアップロードします。これはデバッグシンボルを送信するための主要なコマンドです。

オプション	説明
--dump-path	ダンプファイルへのパス
--game-build-stamp	ゲームビルドスタンプ識別子
--zip-file-location	zip ファイルの保存場所
--platform-arch	ターゲットプラットフォームアーキテクチャ
--platform-name	ターゲットプラットフォーム名（例: Windows、Linux、MacOS、iOS）
--temp-path	処理用の一時ディレクトリ
--upload-only	解析をスキップし、以前に処理されたファイルをアップロードする
--enable-profiler	アップロード中にプロファイリングを有効にする
--recursive-search	サブディレクトリ内のシンボルファイルを再帰的に検索する
--skip-pdb	PDB ファイルの処理をスキップする
--skip-engine-plugin	エンジンプラグインファイルをスキップする
--skip-all-engine-debug-sym	すべてのエンジンデバッグシンボルファイルをスキップする
--editor-build	これがエディタービルドであることを示す

build-channel

ビルドの整理と配布のためのビルドチャンネルを管理します。

build-channel create

新しいビルドチャンネルを作成します。

オプション	説明
--version-id	バージョン ID
--build-id	ヘッドとして設定するビルド ID
--as-head	ビルドをチャンネルヘッドとして設定する
--name	チャンネル名
--server-build-id-as-default	サーバービルド ID をデフォルトとして使用する
--is-empty-channel	ビルドなしの空のチャンネルを作成する

build-channel create-empty

ビルドを関連付けずに空のビルドチャンネルを作成します。

オプション	説明
--version-id	バージョン ID
--build-id	ビルド ID
--as-head	ビルドをチャンネルヘッドとして設定する
--name	チャンネル名
--server-build-id-as-default	サーバービルド ID をデフォルトとして使用する
--is-empty-channel	空のチャンネルとしてマークする

build-channel update

既存のビルドチャンネルを更新します。

オプション	説明
--version-id	バージョン ID
--build-id	新しいヘッドとして設定するビルド ID
--as-head	チャンネルヘッドを更新する
--build-channel-id	更新するビルドチャンネル ID
--name	新しいチャンネル名
--server-build-id-as-default	サーバービルド ID をデフォルトとして使用する

build-channel list

ネームスペース内のすべてのビルドチャンネルを一覧表示します。

オプション	説明
--version-id	バージョン ID でフィルタリングする
--build-id	ビルド ID でフィルタリングする
--page	ページング用のページ番号
--page-limit	ページあたりの結果数

build-channel head-info

ビルドチャンネルのヘッド情報を取得します。

オプション	説明
--build-channel-id	ビルドチャンネル ID
--build-channel-name	ビルドチャンネル名

stream

ビルド配布用のストリームを管理します。ストリームはビルドチャンネルに似ており、ビルドを整理する方法を提供します。

stream create

新しいストリームを作成します。

オプション	説明
--version-id	バージョン ID
--build-id	関連付けるビルド ID
--as-head	ビルドをストリームヘッドとして設定する
--name	ストリーム名
--server-build-id-as-default	サーバービルド ID をデフォルトとして使用する
--is-empty-channel	空のストリームを作成する

stream update

既存のストリームを更新します。

オプション	説明
--version-id	バージョン ID
--build-id	新しいヘッドとして設定するビルド ID
--as-head	ストリームヘッドを更新する
--build-channel-id	更新するストリーム/チャンネル ID
--name	新しいストリーム名
--server-build-id-as-default	サーバービルド ID をデフォルトとして使用する

stream list

ネームスペース内の利用可能なすべてのストリームを一覧表示します。

オプション	説明
--version-id	バージョン ID でフィルタリングする
--build-id	ビルド ID でフィルタリングする
--page	ページング用のページ番号
--page-limit	ページあたりの結果数

game-binary

ゲームバイナリアーカイブのアップロードとダウンロード。

game-binary upload

ゲームバイナリをバックエンドにアップロードします。

オプション	説明
--client-id	OAuth クライアント ID
--client-secret	OAuth クライアントシークレット
--username	認証用ユーザー名
--password	認証用パスワード
--game-id	ゲーム ID
--version-id	バージョン ID
--build-id	ビルド ID
--bearer-file	ベアラートークンを含むファイルへのパス
--game-archive	アップロードするゲームアーカイブへのパス
--entry-point	実行可能なエントリーポイント
--launch-arguments	起動引数
--ignore-config-filepath	無視ルール用の設定ファイルパス
--log-level	ログ詳細レベル
--multipart-upload-size	各マルチパートアップロードチャンクのサイズ
--show-confirmation	アップロード確認プロンプトを表示する
--server-build-id-as-default	サーバービルド ID をデフォルトとして使用する
--force-upload	バイナリが既に存在していてもアップロードを強制する
--show-active-diagnostic	アクティブな診断情報を表示する

game-binary upload-with-bearer

事前に取得したベアラートークンを使用してゲームバイナリをアップロードします（upload と同じオプション）。

game-binary download

バックエンドからゲームバイナリをダウンロードします。

オプション	説明
--client-id	OAuth クライアント ID
--client-secret	OAuth クライアントシークレット
--username	認証用ユーザー名
--password	認証用パスワード
--build-id	ダウンロードするビルド ID
--download-dir	ダウンロードしたファイルを保存するディレクトリ
--show-confirmation	ダウンロード確認プロンプトを表示する
--log-level	ログ詳細レベル
--local-cache-url	より高速なダウンロード用のローカルキャッシュ URL
--server-build-id-as-default	サーバービルド ID をデフォルトとして使用する

debug-symbol

デバッグシンボルファイルの解析と処理。

debug-symbol parse

PDB ファイルを解析し、情報を JSON ファイルに出力します。

オプション	説明
--symbol-folder	シンボルファイルを含むフォルダー
--save-folder	解析された出力を保存するフォルダー
--platform-name	ターゲットプラットフォーム名

session

セッション関連のデータアップロードを管理します。

session upload-metadata

セッションメタデータファイルをアップロードします。

オプション	説明
--bearer-token	認証用のベアラートークン
--directory	メタデータファイルを含むディレクトリ
--file	アップロードする特定のメタデータファイル
--game-id	ゲーム ID
--version-id	バージョン ID
--build-id	ビルド ID
--session-id	メタデータを関連付けるセッション ID
--maximum-part-size	マルチパートアップロードの最大パートサイズ
--batch-size	各バッチでアップロードするファイル数
--operation-id	追跡用の操作 ID
--show-active-diagnostic	アクティブな診断情報を表示する

diagnostic

CLI 操作のトラブルシューティング用の診断パッケージを作成します。

diagnostic package

操作ログから診断パッケージを作成します。

オプション	説明
--operation-ids	含める 1 つ以上の操作 ID（複数回指定可能）
--target-path	診断パッケージを保存するパス

launch-arguments

ビルドに関連付けられた起動引数を管理します。

launch-arguments update

ビルドの起動引数を更新します。

オプション	説明
--version-id	バージョン ID
--version-name	バージョン名
--build-id	ビルド ID
--build-name	ビルド名
--launch-arguments	新しい起動引数文字列

launch-arguments delete

ビルドから起動引数を削除します。

オプション	説明
--version-id	バージョン ID
--version-name	バージョン名
--build-id	ビルド ID
--build-name	ビルド名

launch-arguments read

ビルドの現在の起動引数を読み取ります。

オプション	説明
--version-id	バージョン ID
--version-name	バージョン名
--build-id	ビルド ID
--build-name	ビルド名

smartbuild

スマートビルドのアップロード、ダウンロード、ステージング、キャッシングを管理します。スマートビルドは効率的な増分ビルド配布を提供します。

smartbuild upload

スマートビルドをバックエンドにアップロードします。

オプション	説明
--access-token	認証用のアクセストークン
--client-id	OAuth クライアント ID
--client-secret	OAuth クライアントシークレット
--username	認証用ユーザー名
--password	認証用パスワード
--game-id	ゲーム ID
--version-id	バージョン ID
--version-name	バージョン名
--build-id	ビルド ID
--upload-dir	アップロードするファイルを含むディレクトリ
--entry-point	実行可能なエントリーポイント
--launch-argument	起動引数
--encryption-key	ビルドの暗号化キー
--multipart-size-mb	MB 単位のマルチパートアップロードチャンクサイズ
--temp-path	処理用の一時ディレクトリ
--ignore-config-path	無視ルール用の設定ファイルパス
--project-dir	プロジェクトディレクトリ
--cache-dir	キャッシュディレクトリ
--operation-id	追跡用の操作 ID
--log-severity	ログ重要度レベル
--show-active-diagnostic	アクティブな診断情報を表示する
--force-upload	ビルドが既に存在していてもアップロードを強制する
--skip-extraction	抽出ステップをスキップする
--disable-progress-log	進行状況ログ出力を無効にする
--priority	アップロード優先度レベル

smartbuild download

バックエンドからスマートビルドをダウンロードします。

オプション	説明
--access-token	認証用のアクセストークン
--game-id	ゲーム ID
--build-id	ダウンロードするビルド ID
--cache-dir	ローカルキャッシュディレクトリ
--block-mb-size	ダウンロードチャンク用の MB 単位のブロックサイズ
--operation-id	追跡用の操作 ID
--local-cache-url	より高速なダウンロード用のローカルキャッシュ URL
--log-severity	ログ重要度レベル
--show-active-diagnostic	アクティブな診断情報を表示する
--disable-progress-log	進行状況ログ出力を無効にする
--priority	ダウンロード優先度レベル

smartbuild download-info

ダウンロードせずにスマートビルドのダウンロード情報を取得します（download と同じオプション）。

smartbuild show-version

スマートビルドライブラリのバージョンを表示します。

追加オプションなし。

smartbuild stage install

スマートビルドをステージングディレクトリにインストールします。

オプション	説明
--access-token	認証用のアクセストークン
--game-ns	ゲームネームスペース
--game-id	ゲーム ID
--build-id	インストールするビルド ID
--stage-dir	ステージングディレクトリパス
--cache-dir	キャッシュディレクトリ
--temp-path	一時ディレクトリ
--operation-id	追跡用の操作 ID
--log-severity	ログ重要度レベル
--should-clean	インストール前にステージングディレクトリをクリーンアップする
--show-active-diagnostic	アクティブな診断情報を表示する
--disable-progress-log	進行状況ログ出力を無効にする
--priority	インストール優先度レベル

smartbuild stage uninstall

ステージングディレクトリからスマートビルドをアンインストールします。

オプション	説明
--stage-dir	アンインストールするステージングディレクトリ
--operation-id	追跡用の操作 ID
--log-severity	ログ重要度レベル
--show-active-diagnostic	アクティブな診断情報を表示する
--disable-progress-log	進行状況ログ出力を無効にする

smartbuild stage verify

ステージングされたスマートビルドの整合性を検証します。

オプション	説明
--access-token	認証用のアクセストークン
--game-id	ゲーム ID
--build-id	検証するビルド ID
--stage-dir	検証するステージングディレクトリ
--cache-dir	キャッシュディレクトリ
--operation-id	追跡用の操作 ID
--log-severity	ログ重要度レベル
--show-active-diagnostic	アクティブな診断情報を表示する
--disable-progress-log	進行状況ログ出力を無効にする

smartbuild stage repair

破損したブロックを再ダウンロードして、損傷したステージングスマートビルドを修復します。

オプション	説明
--access-token	認証用のアクセストークン
--game-id	ゲーム ID
--build-id	修復するビルド ID
--stage-dir	修復するステージングディレクトリ
--cache-dir	キャッシュディレクトリ
--block-mb-size	ダウンロードチャンク用の MB 単位のブロックサイズ
--operation-id	追跡用の操作 ID
--log-severity	ログ重要度レベル
--show-active-diagnostic	アクティブな診断情報を表示する
--disable-progress-log	進行状況ログ出力を無効にする

smartbuild cache purge

ディスクスペースを解放するためにスマートビルドキャッシュをパージします。

オプション	説明
--cache-dir	パージするキャッシュディレクトリ
--operation-id	追跡用の操作 ID
--log-severity	ログ重要度レベル
--cache-size-limit-bytes	保持する最大キャッシュサイズ（バイト単位）
--show-active-diagnostic	アクティブな診断情報を表示する
--disable-progress-log	進行状況ログ出力を無効にする

track

ビルド配布とバージョニングのためのトラックを管理します。

track update

特定のビルドを指すようにトラックのヘッドを更新します。

track update-build

ビルド情報でトラックを更新します。

track list

利用可能なすべてのトラックを一覧表示します。

track head-info

トラックのヘッド情報を取得します。

ps5

PS5 固有の設定を管理します。（UE4 ビルドでのみ利用可能）

ps5 update-url

PS5 アップロード URL を更新します。

オプション	説明
--url	新しい PS5 アップロード URL

ps5 get-url

現在設定されている PS5 アップロード URL を取得します。

追加オプションなし。

sdk

ゲームプロジェクトとの SDK 統合を管理します。（UE4 ビルドでのみ利用可能）

sdk install

ADT SDK をゲームプロジェクトに自動統合します。

オプション	説明
--sdk-path	インストールする SDK へのパス

sdk remove

ゲームプロジェクトから ADT SDK を削除します。

追加オプションなし。

crash-url

ゲームエンジンのクラッシュレポート URL 設定を管理します。

crash-url get

エンジン設定から現在のクラッシュ URL を取得します。

追加オプションなし。

crash-url set

クラッシュレポート収集のために、エンジンのクラッシュ URL を ADT URL に設定します。

追加オプションなし。

エンジンサポート

CLI は 2 つのゲームエンジン実装をサポートしています。

• Unreal Engine 4 (UE4) - PS5 および SDK コマンドを含む完全な機能サポート
• Unity - コア機能サポート。Unity モードを強制するには --unity グローバルフラグを使用してください

エンジンはプロジェクトパスに基づいて自動検出されます。検出をオーバーライドするには --unity を使用してください。

設定ファイル

ファイル	説明
Blackbox.ini	現在のバージョン ID、ビルド ID、その他のセッションデータを保存します
config.ini	CLI 設定を保存します
Credentials store	認証資格情報（クライアント ID、シークレット、ユーザー名、パスワード）を保存します

認証

CLI は複数の認証方法をサポートしています。

1. Credentials コマンド - credentials set を使用して資格情報を永続的に保存する
2. インラインオプション - --client-id、--client-secret、--username、--password を直接渡す
3. API キー - API キーベースの認証には --api-key を使用する
4. ベアラートークン - トークンベースの認証には --bearer-file または --bearer-token を使用する
5. アクセストークン - スマートビルドコマンドには --access-token を使用する