Unity が Android アプリケーションをビルドする方法

Unity uses Gradle to build Android applications so it’s useful to understand the build process and how Unity interacts with Gradle. Gradle lets you use Player Settings and other Unity windows to configure most aspects of the final build, however for more control, you must overwrite manifest and template files, or export your project and edit it in Android Studio.

ビルドプロセス

Android アプリケーションは、以下のようにビルドされます。

1. Unity calls AndroidProjectFilesModifier.Setup for all AndroidProjectFilesModifier interfaces. You can use this callback to set up prerequisites for modifying Android Gradle project files. For more information, refer to AndroidProjectFilesModifier.Setup.
2. Unity collects project resources, code libraries, plug-ins, Gradle templates, and manifest templates from your Unity project and uses them to create a valid Gradle project.
3. Unity adds and updates values inside Gradle templates and manifest files based on the Unity project’s Player Settings and Build Settings.
4. If you chose to export the project and not build it, and use the IL2CPP scripting backend, Unity places C++ source files produced from your C# scripts into the Gradle project. Otherwise, if you chose to build the project, Unity places the libil2cpp.so library into the Gradle project.
5. Unity calls OnModifyAndroidProjectFiles for all AndroidProjectFilesModifier interfaces. You can use this callback to modify Gradle project file values. For more information, refer to Modify Gradle project files with the Android Project Configuration Manager.
6. Unity calls OnPostGenerateGradleAndroidProject for all IPostGenerateGradleAndroidProject interfaces. You can use this callback to modify or move files before Gradle builds the application. Note: OnPostGenerateGradleAndroidProject is deprecated, use OnModifyAndroidProjectFiles instead.
7. Unity runs Gradle to build the application from the Gradle project. Gradle merges the Unity Library Manifest, Unity Launcher Manifest, and plug-in manifests into one Android App Manifest file.

インクリメンタルビルドパイプライン

Unity は、Android 用のプレイヤーをビルドする際に インクリメンタルビルドパイプライン を使用します。Android 固有のインクリメンタルビルドパイプラインの動作に関しては、以下を参照してください。

• Unity は、以下の増分をビルド/生成します。
  • Gradle ファイル
  • マニフェストファイル
  • アセットパック
  • APK 拡張ファイル (obbs)
  • 非圧縮の分割アセット
  • Android シンボルの ZIP ファイル
• Unity は以下の増分をコピーします。
  • プレイヤーバイナリ
  • Gradle のリソース
• ビルドプロセス の最後のステップは、Gradle の実行です。これ以降のビルドプロセスにはインクリメンタルビルドパイプラインは使用されず、依存関係のトラッキングは Gradle によって行われます。

If you implement IPostGenerateGradleAndroidProject and modify or move any Android file or asset that the incremental build pipeline uses, it can cause issues when you build your project. If you only want to modify Gradle project files, it’s best practice to use the Android Project Configuration Manager instead of IPostGenerateGradleAndroidProject. If you must use IPostGenerateGradleAndroidProject for your use case and need to work around incremental build pipeline issues, refer to Creating non-incremental builds.