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

Last updated on February 4, 2026

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

概要​

ADT CLI（コマンドラインインターフェース）は、もともと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（プログラムデータベース）
実行可能ファイルを解析し、フィルタリングされた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. ゲームにバージョンを追加
バージョンはビルドのコンテナであり、複数のビルドとさまざまなプラットフォームを含めることができます。SDKを設定するときに後で追加できるversion idを取得します。これを追加するには、次を実行する必要があります：

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

2. ビルドを登録
ビルドは、ADTでゲームが関連付けられている場所であり、すべてのセッション、クラッシュ、イシューはビルド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