Android 用アプリケーションのビルド

This page contains instructions on how to build your Unity application for Android and considerations to be aware of when you do. For information on the build process for Android and the tools Unity uses, refer to How Unity builds Android applications.

Instead of building your application, you can also export the Unity project as a Gradle project and import that into Android Studio. This is useful if you want more control over the build pipeline, want to see or modify the Android App Manifest that Unity generates for your application, or integrate Unity-powered features into another Android application. For more information, refer to Exporting an Android project.

Some digital distribution services that host Android applications have particular requirements that can change the build process. For example, Google Play requires your application to be an Android App Bundle (AAB) and not an APK. If you are targeting a specific digital distribution service with your build, refer to the documentation for that Digital distribution service first to check if the requirements differ.

Some digital distribution services have a limit on the initial install size of your application. Unity includes multiple methods that you can use to optimize the install size. For more information, refer to Optimize distribution size.

デバッグ目的でアプリケーションをビルドする場合は、アプリケーションにパッチを適用することで、ビルドに掛かる時間を短縮できます。詳細は アプリケーションへのパッチ適用 を参照してください。

ビルドの設定

ビルドを作成する前に、希望のランタイム設定およびビルドシステムプロパティでアプリケーションがビルドされるように、プロジェクトの設定を行ってください。Unity ビルドの設定は、以下の 2 つの設定セットによって構成されます。

• Player Settings (プレイヤー設定): アプリケーションのランタイムおよびビルドの設定を行います。
• Build Settings (ビルド設定): ビルドシステムの設定を行います。

公開形式

Unity は、以下の公開形式で Android アプリケーションをビルドすることができます。

• APK
• Android App Bundle (AAB)

デフォルトでは Unity は APK 公開形式で Android アプリケーションをビルドします。AAB としてAndroid アプリケーションをビルドするための設定は、以下の手順で行えます。

1. File > Build Settings を選択します。
2. Platform ペイン内のプラットフォームのリストから Android を選択します。
3. Build App Bundle (Google Play) を有効にします。プロジェクトをエクスポート して Android Studio でビルドするには、Export Project を有効にし、Export for App Bundle を有効にしてください。

アプリケーションのビルド

Android 用に Unity アプリケーションをビルドするには、以下を行ってください。

1. File > Build Settings を選択します。
2. Platform ペインのプラットフォームリストから Android を選択します。
   ノート: Android がグレー表示されている場合は プロジェクトを Android 開発用に設定してください。
3. Export Project を無効にします。プロジェクトを Unity 内でビルドするのではなく Android Studio 用にエクスポートしたい場合は、Android プロジェクトのエクスポート を参照してください。
4. Build and Run オプションを使用してターゲットデバイスで直ちにビルドを実行したい場合は、Run Device をアプリケーションの実行デバイスに設定します。ターゲットデバイスを Unity に接続する方法については、ビルドするプラットフォームに応じて、Android デバイスでのデバッグ または ChromeOS デバイスでのデバッグ を参照してください。
5. Build または Build and Run をクリックします。
6. アプリケーションの配置場所を選択します。Build and Run を選択すると、Run Device にもアプリケーションがインストールされます。
7. Save をクリックします。これでビルドが開始されます。

Build and Run を選択すると、Unity はビルド作成時に以下を実行します。

• プレイヤー設定の Split Application Binary が有効で、ビルド設定の Build App Bundle (Google Play) が無効になっている場合、Unity は APK 用に Android 拡張ファイル (OBB) を構築し、デバイス上の正しい場所に配置します。
• ビルド設定の Development Build Build Setting が有効になっている場合、Unity は、Profiler トンネルも設定し、アプリケーションを起動する前に CheckJNI を有効にします。

ヒント: 出力パスの初回指定後は、Ctrl+B (macOS では Cmd+B) のキーボードショートカットでアプリケーションをビルドして実行 (Build and Run) できます。

アプリケーションへの署名

Android アプリケーションを Android 端末で実行するには、デジタル署名が必要です。アプリケーションへの署名には、以下の 2 種類があります。

• デバッグ署名: 新規 Unity プロジェクトのデフォルトの署名方式です。デバッグ署名を使用したアプリケーションは、Android 端末で実行することができますが、公開することはできません。
• カスタム署名: カスタム署名情報の提供時に Gradle によって使用される署名方式です。カスタム署名を使用したアプリケーションは、Android デバイス上で実行することも、公開することもできます。

カスタム署名情報を提供するには、キーストアを作成 し、それを Publishing Settings 内に読み込んでください。

カスタム署名情報が提供された際、Unity はセキュリティ上の理由から、キーストアとキーパスワードをディスクに保存しません。つまり、Unity エディターを再起動するたびにキーパスワードを再入力する必要があります。パスワードを入力せずにアプリケーションをビルドしようとすると、ビルドプロセスが失敗します。Unity エディターを開くたびにパスワードを入力しなくて済むようにするには、公開用のアプリケーションをビルドする時にだけカスタム署名情報を提供するのがベストプラクティスです。デバイス上でテストするためのビルドを作成する場合にはカスタム署名情報を提供せず、代わりにデバッグ署名を使用します。

アプリケーションへの署名に関する詳細は、アプリへの署名 を参照してください。