Gradle テンプレート

Gradle テンプレートは、Gradle で Android アプリケーションをビルドする方法を設定します。各 Gradle テンプレートは 1 つの Gradle プロジェクトを表します。Gradle プロジェクトは他の Gradle プロジェクトを含むことや、他の Gradle プロジェクトに依存することができます。

Gradle テンプレートファイル

Gradle テンプレートは以下のファイルで構成されています。

Gradle のカスタムテンプレートの使用

Unity が生成する Gradle プロジェクトファイルをより細かく制御するには、Unity のデフォルトの Gradle テンプレートファイルを上書きします。これは、以下のように行います。

1. Edit > Project Settings の順に選択して Project Settings ウィンドウを開きます。
2. Player タブを選択し、Android の Player 設定 を開きます。
   
3. Publishing Settings セクションで、カスタムテンプレートを作成したい Gradle プロジェクトファイルタイプに対応するチェックボックスを有効にします。これにより、Gradle プロジェクトのテンプレートファイルが作成され、ファイルへのパスが表示されます。
4. テンプレートファイルを修正して、最終的な Gradle プロジェクトファイルの形式と内容を制御します。

テンプレート変数

以下の変数をカスタム Gradle テンプレートファイルで使用できます。

カスタムの settingsTemplate.gradle ファイルには、以下の変数を加えることもできます。

カスタムの gradleTemplate.properties ファイルには、以下の変数を加えることもできます。

エクスポートされた Gradle プロジェクトを C# を使用して修正する

Unity が組み立てた後に Gradle プロジェクトを変更するには、IPostGenerateGradleAndroidProject を継承するクラスを作成し、OnPostGenerateGradleAndroidProject 関数をオーバーライドしてください。この関数は、パラメーターとして unityLibrary モジュールへのパスを受け取り、それを使って C# スクリプトを通してアプリケーションのマニフェストとリソースにアクセスできます。

注意: Unity はインクリメンタルな (増分) ビルドパイプラインを使用するようになり、同じ Gradle プロジェクトを連続したビルドに再利用するようになりました。これは、Unity がビルドごとに新しい Gradle プロジェクトを作成しなくなったため、この API を使用して行った変更が蓄積されることを意味します。例えば、この API を使って Gradle プロジェクトにファイルを追加する場合、最初のビルドは期待通りに動作しますが、2 回目のビルドではそのファイルはすでに存在しています。2 つ目の例は、この API を使用して特定のファイルに許可を追加する場合です。各連続するビルドは、許可のための別のエントリーを追加します。行いたい変更が、まだビルドに存在しないことを確認することが非常に重要です。