Version: Unity 6.0 (6000.0)
言語 : 日本語
Android のビルド設定リファレンス
Android プロジェクトのエクスポート

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

Android 用の Unity アプリケーションをビルドする方法と、ビルドする際の考慮点について、以下の説明を参照してください。Android 用のビルドプロセスと、Unity の使用するツールについては、Unity が Android アプリケーションをビルドする方法 を参照してください。

アプリケーションをビルドする代わりに、Unity プロジェクトを Gradle プロジェクトとしてエクスポートし、それを Android Studio にインポートすることもできます。これは、ビルドパイプラインをより精密に制御したい場合や、Unity がアプリケーション用に生成する Android アプリマニフェスト を確認または変更したい場合、あるいは Unity 搭載の機能を別の Android アプリケーションに統合する 場合に役立ちます。詳細は Android プロジェクトのエクスポート を参照してください。

Android アプリケーションをホストするデジタル配信サービスの中には、特定の要件を課しているものがあり、これがビルドプロセスに影響する場合があります。例えば Google Play の場合、アプリケーションは APK ではなく Android App Bundle (AAB) である必要があります。特定のデジタル配信サービスをターゲットにビルドする場合は、まずその デジタル配信サービス のドキュメントを参照し、異なる要件を確認してください。

デジタル配信サービスの中には、アプリケーションの初期インストールサイズに制限を設けているものがあります。Unity には、インストールサイズの最適化に使用できる方法が複数あります。詳細は 配信サイズの最適化 を参照してください。

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

ビルドの設定

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

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

公開形式

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

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

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

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

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

  1. File > Build Profiles を選択します。
  2. Add Build Profile を選択して Platform Browser ウィンドウを開きます。
  3. Platform ペイン内のプラットフォームのリストから Android を選択します。
    Android のオプションがない場合は、Install with Unity Hub を選択し、インストール指示に従います。Android 開発用のプロジェクトの設定 を参照してください。
  4. Add Build Profile を選択します。
  5. Switch Profile を選択して、新しいビルドプロファイルをアクティブなプロファイルとして設定します。
  6. Export Project を無効にします。プロジェクトを Unity 内でビルドするのではなく Android Studio 用にエクスポートしたい場合は、Android プロジェクトのエクスポート を参照してください。
  7. Build and Run オプションを使用してターゲットデバイスで直ちにビルドを実行したい場合は、Run Device をアプリケーションの実行デバイスに設定します。ターゲットデバイスを Unity に接続する方法については、Android デバイスでのデバッグ を参照してください。
  8. Build または Build and Run をクリックします。
  9. Unity がアプリケーションを配置する場所を選択します。Build and Run を選択すると、Run Device にもアプリケーションがインストールされます。
  10. Save をクリックします。これでビルドが開始されます。

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

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

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

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

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

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

カスタム署名情報を提供するには、キーストアを作成 し、Publishing Settings 内に ロード します。

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

追加リソース

Android のビルド設定リファレンス
Android プロジェクトのエクスポート