Unity には、アプリケーションを設定するための Player Settings と Build settings があります。Unity はプロジェクトをビルドするときに、これらの設定オプションを使用して Gradle プロジェクトファイルを生成します。ただし、場合によっては Gradle プロジェクトファイルをより細かく制御する必要があります。
Gradle プロジェクトファイルの内容を変更するために使用できる方法について説明します。すべての方法がすべての Gradle プロジェクトファイルと互換性があるわけではありません。以下の表は、各 Gradle プロジェクトファイルを変更するために使用できる方法を示しています。
| Gradle プロジェクトファイル | Gradle テンプレート | Android Studio |
|---|---|---|
| Main Manifest | サポートあり | サポートあり |
| Android Launcher Manifest | サポートあり | サポートあり |
| Main Gradle | サポートあり | サポートあり |
| Launcher Gradle | サポートあり | サポートあり |
| Base Gradle | サポートあり | サポートあり |
| Gradle Properties Template | サポートあり | サポートあり |
| Proguard File | サポートあり | サポートあり |
Android Project Configuration Manager を使用して、カスタム Android Gradle プロジェクトファイルを変更できます。この方法を使用して、デフォルトの unityLibrary モジュールと launcher モジュールにビルドされた Gradle プロジェクトファイルを変更することはできません。
Unity はテンプレートを使用して、最終的な Gradle プロジェクトファイルを生成します。これらのテンプレートをオーバーライドして、Unity が最終ファイルを生成する方法を制御できます。Gradle は、Android ライブラリからのマニフェストをこのメインマニフェスト内にマージし、最終的な構成が正しいことを保証します。
重要: カスタム Gradle テンプレートファイルを使用する場合に、Unity プロジェクトを、異なるデフォルトテンプレートファイルを使用するバージョンの Unity にアップグレードすると、カスタム Gradle テンプレートファイルの書き換えが必要になることに注意してください。
この方法を使用して Gradle プロジェクトファイルを変更する方法については、Gradle テンプレートファイルを使用した Gradle プロジェクトファイルの変更を参照してください。
Android 用 Unity プロジェクトをエクスポートする場合、Unity は Gradle プロジェクトファイルを生成し、エクスポートしたプロジェクトに配置します。エクスポートしたプロジェクトを Android Studio で開くと、Gradle プロジェクトファイルを確認することができます。これは、Gradle テンプレートまたは Android Project Configuration Manager を使用して行った変更の検証や、ファイル自体の直接編集にも役立ちます。
ヒント: Unity プロジェクトをエクスポートまたはビルドするたびに Gradle プロジェクトファイルを変更する必要がないようにするには、(Gradle テンプレートファイルまたは Android Project Configuration Manager のいずれかを使用して) Unity 内で Gradle プロジェクトファイルを変更することをお勧めします。
この方法を使用して Gradle プロジェクトファイルを変更する方法については、Android Studio での Gradle プロジェクトファイルの変更を参照してください。
Android Project Configuration Manager は、C# でカスタム Gradle プロジェクトファイルを設定および変更するために使用できる一連のクラスです。ビルドプロセスによってデフォルトの unityLibrary モジュールと launcher モジュールに作成される Gradle プロジェクトファイルは、直接変更することはできません。これらのモジュール内にカスタムモジュールを作成して、カスタム Gradle プロジェクトファイルを設定し、必要に応じて変更できます。
Unity はビルドのポストプロセス中に変更を適用します。そのため、Unity エディターが設定する値を確認し、必要に応じて変更できます。Android Project Configuration Manager のエントリーポイントは、AndroidProjectFilesModifier インターフェースの OnModifyAndroidProjectFiles メソッドです。
このメソッドを使用して Gradle プロジェクトファイルを変更する方法については、Android Project Configuration Manager を使用した Gradle プロジェクトファイルの変更を参照してください。