Version: 2021.3
言語: 日本語
開発用ビルド
Xcode フレームワーク

エクスポート前メソッドとエクスポート後メソッド

エクスポート前とエクスポート後のメソッドによって、Unity プロジェクトがビルドされる前と後にアクションを起こすことができます。これらのメソッドは、コードとしてプロジェクト内の Assets/Editor フォルダーに存在する必要があります。Editor フォルダーがディレクトリに存在しない場合は、作成してください。

重要: UnityEngine.CloudBuild.BuildManifestObject クラスは、Cloud Build で実行しているときにのみ使用できます (つまり、ローカルでは使用できません)。コードをローカルにコンパイルするには、エクスポート前とエクスポート後のメソッドを #if UNITY_CLOUD_BUILD ブロックでラップします。

ビルドターゲットの Advanced Options で、エクスポート前と後のメソッドを設定します。

Advanced Options 画面
Advanced Options 画面

エクスポート前のメソッド名

エクスポート前メソッドを使用するには、プロジェクトをエクスポートする前に実行したいコードを含む public static メソッドを Unity プロジェクトに作成します。

public static void PreExport()

Cloud Build を使用可能にし、BuildManifestObject オブジェクトをメソッドシグネチャのパラメーターとして指定して、現在のビルドのビルドマニフェストをエクスポート前のメソッドに渡します。次に、プロジェクトをエクスポートする前に、Project Settings または Player 設定を変更します。

public static void PreExport(UnityEngine.CloudBuild.BuildManifestObject manifest)

Unity Cloud Build がメソッドを呼び出すと、必須でないパラメーターとして BuildManifestObject オブジェクトを渡します。ここで BuildManifestObject は、現在のビルドのビルドマニフェストです。

詳細は、ScriptableObject としてのビルドマニフェスト を参照してください。

エクスポート後のメソッド名

エクスポート後メソッドを使用するには、プロジェクトをエクスポートした後に実行したいコードを含む public static メソッドを Unity プロジェクトに作成します。

public static void PostExport(string exportPath)

Unity Cloud Build がメソッドを呼び出すと、以下のような文字列が渡されます。

  • iOS 以外のビルドターゲットの場合、文字列にはエクスポートしたプロジェクトへのパスが含まれます。
  • iOS プロジェクトの場合、文字列にはエクスポートした Xcode プロジェクトへのパスが含まれます。パスを使用してエクスポートした Xcode プロジェクトの場所を特定し、Xcode を呼び出してビルドプロセスを完了する前に、追加の事前処理を実行できます。

ノート: コード内の Unity PostProcessBuildAttribute でタグを付けたメソッドはすべて、Unity Cloud Build で Post-Export Method として設定されたメソッドよりも前に実行されます。

開発用ビルド
Xcode フレームワーク