Script hooks

Script hooks allow you to run custom scripts or Editor code before the build starts or after it is completed.

Pre- and post-export methods

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

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

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

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

To use a pre-export method, create a public static method in your Unity Project that contains the code you want executed before the Unity Editor exports your project but after the Unity Editor script compilation phase.

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 として設定されたメソッドよりも前に実行されます。

Custom scripting #define directives

Using Cloud Build, you can create custom scripting #define directives. On the Unity Developer website, go to the build target’s Advanced Options.

In the Scripting Define Symbols field, you can add your own custom scripting #define directives to the built-in selection available. For each build target, enter the names of the symbols you want to define. You can then use these symbols as the conditions in #if directives, just like the built-in symbols. For more information, see Conditional Compilation.