Androidへのエクスポート

Android向けのエクスポートは、Godotをコンパイルするよりも要件が少ないです。次の手順では、SDKとエンジンのセットアップに必要なものについて詳しく説明します。

Android SDKをダウンロード

Download and install the Android SDK from developer.android.com.

If you install Android Studio, you need to run it once to complete the SDK setup.

OpenJDKまたはOracleJDKのインストール

OpenJDK または Oracle JDK をダウンロードしてインストールします。 JDK 8以下のバージョンは動作しない可能性があります。一部のユーザーは、JDK 7の jarsigner (APKの署名に使用)の問題を報告しています。

If you install OpenJDK, choose 1.8. Don't choose the openjdk-jre files as that only contains the JRE, not the JDK which is required here.

デバッグキーストアを作成する

Androidでは、デバイスにインストールし、リリースされていないAPKを配布するためのデバッグキーストアファイルが必要です。以前にSDKを使用してプロジェクトをビルドしたことがある場合は、antまたはeclipseによってプロジェクトが生成される可能性があります(LinuxとmacOSの場合、~/.androidディレクトリに見つけることができます)。

If you can't find it or need to generate one, the keytool command from the JDK can be used for this purpose:

keytool -keyalg RSA -genkeypair -alias androiddebugkey -keypass android -keystore debug.keystore -storepass android -dname "CN=Android Debug,O=Android,C=US" -validity 9999

This will create a debug.keystore file in your current directory. You should move it to a memorable location such as %USERPROFILE%\.android\, because you will need its location in a later step. For more information on keytool usage, see this Q&A article.

アンドロイドデバッグブリッジ(adb)を持っていることを確認します

Android Debug Bridge (adb) is the command line tool used to communicate with Android devices. It's installed with the SDK, but you may need to install one (any) of the Android API levels for it to be installed in the SDK directory.

Godotで設定する

[エディタ設定]画面に入力します。この画面には、コンピュータのユーザー アカウントのエディタ設定が含まれます (プロジェクトから独立しています)。

../../../_images/editorsettings.png

Androidの設定が配置されているセクションまで下にスクロールします:

../../../_images/androidsdk.png

この画面では、3つのファイルへのパスを設定する必要があります:

  • The adb executable (adb.exe on Windows) - It can usually be found at %LOCALAPPDATA%\Android\Sdk\platform-tools\adb.exe.
  • The jarsigner executable (from JDK 6 or 8) - On Windows, OpenJDK installs to a dir like %PROGRAMFILES%\ojdkbuild\java-1.8.0-openjdk-1.8.0.232-2\bin. The exact path may vary depending on the OpenJDK update you've installed.
  • The debug .keystore file - It can be found in the folder where you put the debug.keystore file you created above.

設定が完了すれば、Androidにエクスポートできるようになります!

ランチャーアイコンの提供

ランチャーアイコンは、Androidランチャーアプリでユーザーにアプリケーションを表すために使用されます。 Godotは高解像度アイコン(xxxhdpi 密度画面用)のみを必要とし、低解像度のバリアントを自動的に生成します。

Godotに必要なアイコンには2つのタイプがあります:

  • Main Icon: 『クラシック版』のアイコン。これはAndroid 8 (Oreo) 未満の全Androidバージョンにて使用されます。最低でも 192x192 ピクセルが必要。
  • Adaptive Icons: Android 8 からは、アダプティブ アイコンが導入されています。ネイティブの見た目にするには、アプリケーションはアイコンを前面と背景に分けて含める必要があります。アイコンのアニメーションとマスキングは、ランチャーによってコントロールされます。最低でも 432x432 ピクセルが必要。

参考

アダプティブ アイコンをデザインする際は、いくつかのルールに従うことが重要です。Google Designが、それらのルールとアダプティブ アイコンの機能について解説するすばらしい記事を公開 (英語)しています。

ご用心

アダプティブ アイコンでの一番重要なデザインルールは、ランチャーで切り取られないようにするため、アイコンの重要な要素をセーフゾーンの内側に配置することです。セーフゾーンは中心から半径 66dp (xxxhdpiで264ピクセル) の円形です。

もし要求されるアイコンを指定しなかった場合、Godotは失敗するたびにフォールバック チェーンから次のものを試し、置き換えます:

  • Main Icon: 指定されたメイン アイコン -> プロジェクト アイコン -> デフォルトのGodotメインアイコン。
  • Adaptive Icon Foreground: 指定された前面アイコン -> 指定されたメイン アイコン -> プロジェクト アイコン -> デフォルトのGodot前面アイコン。
  • Adaptive Icon Background: 指定された背景アイコン -> デフォルトのGodot背景アイコン。

要求されたアイコンを、解像度の基準を満たした上で、すべて用意することを強く推奨します。それがAndroidの全デバイスおよび全バージョンで、あなたのアプリケーションが良く見えるようにする唯一の方法です。

Google Playストア用にエクスポート

APKをGoogleのPlayストアにアップロードするには、デバッグ以外のキーストアファイルを使用して署名する必要があります。このようなファイルは次のように生成できます。

keytool -v -genkey -v -keystore mygame.keystore -alias mygame -keyalg RSA -validity 10000

このキーストアとキーは、開発者の身元を確認し、パスワードを記憶し、安全な場所に保管するために使用されます。GoogleのAndroidデベロッパー ガイドを使用して、APK 署名 の詳細をご覧ください。

次に、Android エクスポートプリセットで次のフォームに入力します:

../../../_images/editor-export-presets-android.png
  • Release: 生成したばかりのキーストアファイルへのパスを入力します。
  • Release User: キーエイリアスで置き換えます。
  • Release Password: キーパスワード。現在、キーストアのパスワードとキーのパスワードは同じでなければならないことに注意してください。

export_presets.cfgファイルには機密情報が含まれるようになりました。 バージョン管理システムを使用する場合は、パブリックリポジトリから削除し、 .gitignore ファイルまたは同等のファイルに追加する必要があります。

APKの名前を選択する際は、[** Export with Debug **]チェックボックスをオフにすることを忘れないでください。

../../../_images/export-with-debug-button.png

APKサイズの最適化

デフォルトでは、APKにはARMv7アーキテクチャとARMv8アーキテクチャの両方のネイティブライブラリが含まれます。これにより、サイズが大幅に増加します。より小さなAPKを作成するには、プロジェクトのAndroidエクスポートプリセットで Armeabi-v 7a または Arm 64 -v 8a のチェックを外します。これにより、単一のアーキテクチャのライブラリのみを含むAPKが作成されます。 ARMv7をターゲットとするアプリケーションはARMv8デバイスでも実行できますが、その逆は当てはまりません。

2019年8月以降、Google Playではすべてのアプリケーションを64ビット形式で利用可能である必要があります。これは、 ARMV7ライブラリ*のみ* を含むAPKはアップロードできないことを意味します。これを解決するには、Multiple APK support を使用して、いくつかのAPKをGoogle Playにアップロードできます。各APKは単一のアーキテクチャをターゲットにする必要があります。通常、ARMv7およびARMv8用のAPKを作成するだけで、現在使用されているほとんどのデバイスをカバーできます。

必要な機能のみを使用してAndroidエクスポートテンプレートをコンパイルすることにより、サイズをさらに最適化できます。詳細については、ビルドのサイズを最適化する を参照してください。