UnityゲームプロジェクトのADT CLI

Last updated on February 4, 2026

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

概要​

ADT CLI (Command Line Interface)は元々Unreal Engineプロジェクトをサポートするように設計されたため、その機能はUnrealのファイルとデータ構造に密接に対応しています。

Unityベースのプロジェクトをサポートするために、特定のCLIコマンドでは、動作をUnityの構造に適応させるために--unityフラグが必要です。このフラグは、ADTシステムにパス、ファイル、データ処理をUnity互換の方法で処理するように指示します。

注記

--unityフラグは、build register、upload、game-binary uploadなどの特定のコマンドにのみ適用されます。

Unity関連コマンド​

以下は、Unityゲームプロジェクトで使用する場合に--unityフラグが必要なコマンドのリストです:

1. Build Register プロジェクトの新しいビルドを登録します。これにより、クラッシュレポート、問題、セッションを関連付けるために使用されるbuild IDが生成されます。

./blackboxcli.exe build register --unity 
--platform-name <target_platform>
--platform-arch <platform_architecture>
--game-project <path_to_game_project>
--game-engine <path_to_game_engine>
--smartbuild

2. Game Binary Upload コンパイルされたゲームバイナリをADTにアップロードします。

.\BlackBoxCLI.exe game-binary upload --unity 
--game-project <project_path>
--game-archive <archive_path>
--entry-point <executable_path>
--namespace <namespace>
--apikey <apikey>

3. Game Binary Download 特定のビルドに関連付けられたゲームバイナリをダウンロードします。

.\BlackBoxCLI.exe game-binary download --unity
--build-id <build_id>
--output-path <output_path>
--namespace <namespace>
--apikey <apikey>
--client-id <client_id>
--client-secret <client_secret>
--username <ADT_email>
--password <ADT_password>

4. Smartbuild Upload Smart Buildを使用してビルドをアップロードします。これにより、変更されていないファイルを再利用してデータ転送が最適化されます。

.\BlackBoxCLI.exe smartbuild upload --unity
--build-id <your_target_build_id>
--upload-dir <path_directory_to_upload>
--entry-point <executable_path>
--multipart-size <desired_multipart_size_in_megabytes. Can't_be_less_than_5>
--namespace <namespace>
--apikey <apikey>

5. Smarbuild Download キャッシュサポートを備えたSmart Buildシステムを使用してビルドをダウンロードします。

.\BlackBoxCLI.exe smartbuild download --unity
--build-id <build_id>
--output-path <output_path>
--cache-dir <cache_directory>
--access-token <access_token>
--namespace <namespace>
--apikey <apikey>

6. Upload PDB (Program Database) 実行可能ファイルを解析し、フィルタリングされたPDBファイルをデバッグ目的でADTサーバーにアップロードします。PDBファイルをアップロードしない場合、ADTのすべてのコールスタックは**:0**を返し、デバッグプロセスが完了しません。

.\BlackBoxCLI.exe upload --unity
--game-archive <pdb_folder_path>
--game-engine <game_engine_path>
--game-project <game_project_path>
--recursive <upload_all_symbols_in_game_archive_or_game_engine_directory>
--namespace <namespace>
--apikey <apikey>

7. Upload Binaries 既存のビルドとバージョンIDを参照してバイナリをアップロードする代替方法。

.\BlackBoxCLI.exe build upload-binaries --unity 
--game-archive <archive_path>
--entry-point <relative_executable_path>
--build-id <build_id>
--version-id <version_id>
--namespace <namespace>
--apikey <apikey>

CLIのダウンロード​

ADT CLIはADT Webダウンロードページで入手できます

  1. ADT Webにログインし、サイドバーからDownloadsメニューを選択してから、CLIセクションを見つけます。
  2. オペレーティングシステム(WindowsまたはLinux)を特定します。
  3. OSの下にあるDownloadボタンをクリックして、CLIツールのダウンロードを開始します。
  4. ADT CLIフォルダを解凍します。 Unzip the CLI folder
  5. Powershellアプリケーションを実行し、ディレクトリパスを解凍したAccelbyte Development Toolkit CLIフォルダに設定します。 Set directory path to ADT CLI folder

ADT CLI推奨ワークフロー​

ADT SDKをゲームに統合する前に、ADTの推奨ワークフローに準拠するために次のコマンドを実行する必要があります。

1. ゲームにバージョンを追加する Versionはビルドのコンテナで、複数のビルドとさまざまなプラットフォームを含めることができます。SDKを設定する際に後で追加できるversion idを取得します。これを追加するには、次を実行する必要があります:

./blackboxcli.exe version add
--name <new_version_name>
--namespace <your_namespace>
--apikey <your_game_apikey>
--game-project <your_project_path>

2. ビルドを登録する Buildは、ゲームがADTに関連付けられている場所で、すべてのセッション、クラッシュ、問題がbuild idに関連付けられています。ゲームビルドに変更を加えた後は、必ず新しいビルドを登録してください。SDKを設定する際に後で追加できるbuild idを取得します。

./blackboxcli.exe build register 
--unity 
--platform-name <target_platform>
--platform-arch <platform_architecture>
--game-project <path_to_game_project>
--game-engine <path_to_game_engine>
--smartbuild

3. ゲームをパッケージ化する ターゲットプラットフォームに基づいてゲームビルドをパッケージ化します。

4. PDBをアップロードする システムがADT Webでコールスタックをデバッグして表示できるようにするには、PDBをADTサーバーにアップロードする必要があります。

.\BlackBoxCLI.exe upload --unity
--game-archive <pdb_folder_path>
--game-engine <game_engine_path>
--game-project <game_project_path>
--recursive <upload_all_symbols_in_game_archive_or_game_engine_directory>
--namespace <namespace>
--apikey <apikey>

5. ビルドをアップロードする ビルドをADTにアップロードする必要があります。完了すると、チームメイトはADT Hubから作成したばかりのビルドをダウンロードして、テストやプレイテストを実行できるようになります。

.\BlackBoxCLI.exe smartbuild upload --unity
--build-id <your_target_build_id>
--upload-dir <path_directory_to_upload>
--entry-point <executable_path>
--multipart-size <desired_multipart_size_in_megabytes. Can't_be_less_than_5>
--namespace <namespace>
--apikey <apikey>

以上がADT CLIの推奨ワークフローです。チャネルの作成やトラックへのビルドの割り当てなど、他の多くの機能にもCLIを使用できます。詳細については、CLIを使用したチャネルとトラックの管理のドキュメントを参照してください。

まとめ​

ADT CLIを使用してUnityプロジェクトを操作する場合は、ゲームのバイナリまたはビルド構造と対話するコマンドには常に--unityフラグを含めてください。これにより、Unityのフォルダレイアウトとデータ構造の規則との互換性が保証され、ADTバックエンドがプロジェクトアセットを正しく解析および管理できるようになります。

に最終更新
On this page