ビルドを管理する
概要
このガイドでは、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 コマンドを使用します。
windowswindows-serverwindows-editor-ue5linuxlinux-serverxboxonegdkxsxps4ps5
有効なプラットフォームアーキテクチャ
現在は 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 サブコマンドを使用してビルドバイナリをアップロードするのに役立ちます。
| メインコマンド | サブコマンド | オプションとパラメータ | |
|---|---|---|---|
| 名前 | 説明 | ||
build | set-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 コマンドを使用するときのみです。ビルドの登録後は、使用できなくなります。