メインコンテンツまでスキップ

Manage Your Build

Last updated on February 12, 2024

概要

このガイドでは、Unreal ゲームビルドの登録と検索、およびビルドチャネルの設定を行う方法を説明します。ADT CLI を使用して、これらの値を設定および取得します。 ビルドは固有であるため、クラッシュなどの他のアセットをアタッチできます。

手順

ビルドを登録

ゲームをビルドする前に、そのゲームビルドを出荷用ビルドに登録します。

register コマンドでビルドを作成する場合、システムではビルド名が生成されません。つまり、ビルドを後で 検索できなくなります。そのため、find-or-register コマンド (下記参照) を使用して、検索可能なビルド名を登録します。

ビルドを登録するには、次のコマンドを実行します。

インライン設定なし

BlackBoxCLI.exe build register --platform-name <platform> --platform-arch x64

インライン設定あり

BlackBoxCLI.exe build register --namespace myawesomegame--apikey asdf1234 --game-project D:\path\to\myawesomegame --platform-arch x64 --platform-name <platform> --game-engine D:\UnrealEngine\UE4.25

有効なプラットフォーム名

次のプラットフォーム名について --platform-name コマンドを使用します。

  • windows
  • windows-server
  • windows-editor-ue5
  • linux
  • linux-server
  • xboxonegdk
  • xsx
  • ps4
  • ps5

有効なプラットフォームアーキテクチャ

現在は x64 のみサポートされています。

Editor ビルドを登録 (Windows のみ)

スタンドアロンビルドではなく、Unreal Editor ビルドで作業したい場合も あるでしょう。ここからは、そのワークフローについて説明します。

登録できるのは、Windows プラットフォーム用の Unreal Editor ビルドのみです。 これを行うには、build register コマンドの呼び出し時に --editor-build を追加します。 有効なビルドを生成するには、Windows プラットフォーム名を追加します。

インライン設定なしの場合の例を挙げます。

BlackBoxCLI.exe build register --platform-name <platform> --platform-arch x64 --editor-build

有効なプラットフォーム名

使用できるプラットフォーム名は、windows のみです。

有効なプラットフォームアーキテクチャ

サポートしているのは x64 のみです。

ビルドを検索または登録

find-or-register コマンドを使用してビルド名を登録してから、これを検索します。

例:

インライン設定なし

BlackBoxCLI.exe build find-or-register --name <build name> --platform-name <platform> --platform-arch x64

インライン設定あり

BlackBoxCLI.exe build find-or-register --game-engine <path to engine> --name <build name> --game-project D:\path\to\myawesomegame --platform-name <platform> --platform-arch x64

ビルド ID を設定

ビルド ID を設定するには、次のコマンドを使用します。

インライン設定なし

BlackBoxCLI.exe build set --id <build id uuid>

インライン設定あり

BlackBoxCLI.exe build set --id <build id uuid> --namespace myawesomegame --apikey asdf1234  --game-project D:\path\to\myawesomegame

ADT CLI は、ゲームのビルドに使用できるビルド ID 情報を BlackBox.ini ファイルに追加します。

ビルド ID を取得

次のコマンドを使用して、既存ビルドのビルド ID を取得します。

インライン設定なし

BlackBoxCLI.exe build get

インライン設定あり

BlackBoxCLI.exe build get --game-project D:\path\to\myawesomegame

ビルドチャネルを設定

現在のビルドのビルドチャネルを設定するには、set-stream コマンドを使用します。

インライン設定なし

BlackBoxCLI.exe build set-stream --stream-id xxx-xxx

インライン設定あり

BlackBoxCLI.exe build set-stream --version-id xxx-xxx --build-id xxx-xxx --stream-id xxx-xxx --apikey asdf1234 --namespace myawesomegame

次の表は、set-stream サブコマンドを使用してビルドバイナリをアップロードするのに役立ちます。

メインコマンドサブコマンドオプションとパラメータ
名前説明
buildset-stream--apikey[インライン設定の一部] API キーを設定する
--namespace[インライン設定の一部] 名前空間を設定する
--game-project[インライン設定の一部] ゲームプロジェクトのディレクトリを設定する
--version-idバージョン ID を設定する。値は --game-project の上書きから
--build-idビルド ID を設定する。値は --game-project の上書きから
--stream-id現在のビルド ID をストリームのヘッドとして設定する

ブランチと設定のメタデータを設定

ブランチと設定のメタデータを設定するには、次のコマンドを使用します。

ブランチ名を追加します。

BlackBoxCLI.exe build register --platform-arch x64 --platform-name <platform> --branch-name <branch name>

ビルド名で設定を追加します。

BlackBoxCLI.exe build add-metadata --key <configuration> --value <Test, Development, Shipping> --build-id <build id> --version-id <version id>

ブランチ名を追加できるのは、build register コマンドを使用するときのみです。ビルドの登録後は、使用できなくなります。