Unity Cloud Build で Addressable を使用する

Addressable Assets are assets that have a unique address which you can use to load them from local or remote AssetBundles.

要件

Cloud Build で Addressable Assets をビルドする前に、以下を行う必要があります。

• ローカルで Addressable を使用するために以下のようにプロジェクトを変換します。
• Install the Addressables package
• アセットを Addressable (アドレス可能) に設定
• 選択したバージョン管理システム (VCS) に更新したプロジェクトをコミットします。

Cloud Build で Addressable をビルドする前に、ローカルで使用に慣れることをお勧めします。

ビルドターゲットの設定

新しい Cloud Build プロジェクトから始める場合は、最初に新しい Build Target を作成する必要があります。

1. From the Cloud Build Dashboard, navigate to the build target Configurations page for your project.
2. Go to the build target that you’d like to build Addressables for.
3. On the build target’s advanced settings, edit the Addressables section.

Use the Addressables section to configure properties that determine how the Addressables build process behaves. Each property is described in more detail with a tooltip.

新しい Addressable ビルドの実行

新しい Addressable のビルドを実行するには、以下の手順を行います。

1. Enable Build Addressables.
2. Click the Save changes button.
3. Build the Target.

Cloud Content Delivery サービスを有効にする

If you want to upload Addressables to the Cloud Content Delivery (CCD) service from Cloud Build:

1. Go to the build target that you’d like to build Addressables for.
2. On the build target’s advanced settings, edit the Addressables section.
3. Enable Upload Addressables to the Cloud Content Delivery service to upload Addressables to CCD.
4. Choose the required CCD bucket in the Content Delivery Bucket drop-down.
5. Your Content Delivery API Key should already be populated in its field. If not, add it.
6. Enable Automatically create a Cloud Content Delivery release from the bucket if you want to automatically create a CCD release from the selected bucket.
7. Click the Save changes button.
8. Build the Target.

See Addressable Asset system with Cloud Content Delivery for more information about using Addressables with CCD.

コンテンツ更新ビルドの実行

コンテンツの更新ビルドは、以前に構築されたプレイヤーを新しいアドレス可能なコンテンツで更新します。

既存のプレイヤーを更新するには、更新ビルドに Content State ファイルが必要です。これにより、更新ビルドのコンテンツを既存のプレイヤーにリンクします。Content State ファイルは、新しい Addressable ビルド を行うときに生成されます。

以前にビルドしたプレイヤーを新しい Addressable アセットで更新するには、以下を行います。

1. On the build target’s advanced settings, edit the Asset bundles section.
2. Enable Make a content-only build.
3. Click the Save changes button.

ビルドの開始

ビルドターゲットを設定したら、新しい Addressable のビルドを開始します。

1. ダッシュボードの Build History ページに移動します。
2. Addressable を設定したターゲットをビルドします。

新しいビルドが正常に完了したら、ビルドのためのその他のメニュー (⋮) で Download Addressable Assets オプションが表示されます。

Cloud Build からホスティングプロバイダーに Addressable コンテンツをコピー

Addressable のビルドが完了したら、Addressable のコンテンツを Cloud Build からホスティングプロバイダーにコピーできます。これは手動で行うことも、ビルド後のスクリプトを使用して行うこともできます。

Addressable コンテンツを手動でコピー

Addressable ビルドを完了したら、その他のメニュー (⋮) から Download Addressables Assets を選択します。 コンテンツをダウンロードしたら、ローカルでビルドする場合と同様に、ホスティングプロバイダーにアップロードできます。

ビルド後のスクリプトで Addressable コンテンツをコピー

Cloud Build は、ビルドの前後にカスタムシェルスクリプトを実行することをサポートしています。ビルド後のスクリプトを作成して、ビルドが正常に完了したときに Addressable コンテンツを自動的にアップロードできます。

ビルド後のスクリプトを有効にするには、以下を行います。

1. Go to the Cloud Build Configurations page.
2. On your build target’s advanced settings, in the Script hooks section,
3. In the Post-Build Script field, enter the path to your script.

スクリプトを作成するときに、以下のヒントが役立つかもしれません。

• ビルドの Addressable なコンテンツは以下にあります。 $WORKSPACE/.build/last/<BUILD_TARGET_ID>/extra_data/addrs/

• You can set environment variables for secret keys in the Build Target Configurations page.

---