Android向けのカスタムビルド

Godotには、カスタムビルド Androidテンプレートを使用するオプションが用意されています。Godotに同梱されている既製のテンプレートを使用する代わりに、実際のAndroid Javaプロジェクトがプロジェクトフォルダにインストールされます。Godotはそれをビルドし、プロジェクトをエクスポートするたびにエクスポートテンプレートとして使用します。

これを行う理由はいくつかあります:

  • ビルドする前にプロジェクトを変更します。
  • プロジェクトでビルドする外部SDKを追加します。

カスタムビルドの設定は、多かれ少なかれ簡単なプロセスですが、Android SDKの動作に慣れるまでに時間がかかる場合があります。

このプロセスを行うための手順は、可能な限り詳細に提供されます。

カスタムビルド環境をセットアップする

[プロジェクト] メニューに移動し、カスタム ビルド テンプレートをインストールします。

../../../_images/custom_build_install_template.png

エクスポート テンプレートがダウンロードされていることを確認します。そうでない場合は、このメニューを使用してダウンロードできます。

これにより、GradleベースのAndroidプロジェクトが res://android/build に作成され、res://android.gdignore ファイルが配置されるため、Godotファイルシステムはこのフォルダを無視します。これらのファイルを編集する必要は、独自のアドオン を作成するか、本当にプロジェクトを変更する必要がない限り必要ありません。

Android SDKのインストール(コマンドラインバージョン)

コマンド ラインを使用してAndroid SDKをインストールする手順を次に示します。このアプローチの利点は、シンプルさと小さなダウンロード/インストールサイズです。しかし、それはかなり挑戦的な作業です。Android Studioのアプローチは簡単ですが、Android Studioのダウンロードとインストールが必要です(1GBを超えるストレージが必要な場合があります)。

JDKのインストール

Android SDKにはJavaが付属していないため、手動でインストールする必要があります。(ランタイムまたはJREだけでなく)Java SDKをインストールする必要があります。OpenJDK 8 <https://adoptopenjdk.net/index.html> が推奨されます。Oracle JDK 8も動作するはずです。それ以降のバージョンは、Androidの開発用途では動作しない可能性があります。

コマンドラインツールをダウンロード

Android Studioダウンロードページ<https://developer.android.com/studio/#command-tools> に移動します。完全なIDEは必要ないので、ディスク容量を節約するために、それはダウンロードしないでください。

注釈

Android Studioが必要な場合は、Android Studioを使用して同じことを行うための手順をさらに読んでください。

コマンドラインツールのみ セクションについては、そのページをご覧ください。現在、それらは ダウンロードオプション の下にリストされています。表示されるまで少し下にスクロールします。

../../../_images/custom_build_command_line.png

使用するプラットフォーム用のZIPファイルをダウンロードすると、内部に単一の tools フォルダがあります。

../../../_images/custom_build_zip.png

これは少しわかりにくいかもしれませんが、次の指示に注意深く従ってください。

任意の場所に android-sdk という名前の新しいフォルダを作成します(空のディレクトリでなければなりません)。 Windowsでは、通常、次のパスで十分です。

C:\users\<yourusername>\Documents\android-sdk

そこにダウンロードしたAndroid SDKのZIPファイルを解凍します。前の手順で作成したディレクトリ内の唯一のものは、次のように、その内容を含む tools フォルダである必要があります。

android-sdk/
android-sdk/tools/
android-sdk/tools/allthefiles

ライセンスへの同意

Android SDKツールを使用できるようにするには、そのライセンスに同意する必要があります。

これを行うには、コマンドラインから特別な引数を指定して sdkmanager を実行する必要があります。SDKフォルダ内の tools/bin ディレクトリに移動します(LinuxおよびmacOSユーザーはコマンドラインナビゲーションのしくみを理解することが求められているため、Windowsユーザー向けの手順を参照してください):

../../../_images/custom_build_bin_folder.png

次に、コマンド ラインウィンドウを開きます:

../../../_images/custom_build_open_shell.png

そこで sdkmanager --licenses を実行します:

../../../_images/custom_build_sdkmanager.png

これにより、複数のライセンスを受け入れるように求められます。y と入力し、完了するまですべてのライセンスでEnterキーを押します。

その後、プラットフォームツールをインストールします(adb をインストールするために必要です):

../../../_images/custom_build_platform_tools.png

キーストアの作成

プラットフォームツール をインストールしたら、最後のステップはデバッグキーストアを生成することです(これはビルドに必要です)。次のように記述して、2つのフォルダに移動します:

cd ..\..

(または android-sdk フォルダで新しいシェルを開きます)。

そして、次の行を入力する必要があります(LinuxおよびmacOSでは、これはそのままで機能するはずです。Windowsの場合、さらに詳しい手順があります)。

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

Windowsでは、Javaへのフルパスを指定する必要があります。 PowerShellを使用する場合は、行の先頭に & を追加する必要があります。通常の cmd.exe コンソールには必要ありません。

わかりやすくするために、PowerShellで機能する行のキャプチャを次に示します(&keytool.exe の前に完全なJavaパスを追加する)。繰り返しますが、Javaをインストールする必要があることに注意してください。

../../../_images/custom_build_command_line.png

(画像が小さすぎる場合は、右クリックして新しいタブで開きます)

ゴドーの設定

エディタ設定に移動し、Export > Android でいくつかのフィールドを設定します。次のように表示されていることを確認します。

../../../_images/custom_build_editor_settings.png

(画像が小さすぎる場合は、右クリックして新しいタブで開きます)

ご覧のように、ほとんどのパスは、最初に作成した android-sdk フォルダ内、またはJavaインストール内にあります。Linuxおよび macOSユーザーの場合、一般的に jarsigner/usr/bin 内にあります。

これで、すべての準備が整います。

Android SDK(Android Studio)のインストール

コマンドラインツールを使用してSDKのインストールを完了している場合は、このセクションを完全にスキップしてください。 Android Studioを使用する道筋は手順が簡単ですが、より多くのディスク容量を占有します。ですが、 Android用のGodotの開発(Javaソースコードの変更)を計画している場合、またはアドオンの開発を計画している場合にも役立ちます。

Android Studioのダウンロードとインストール

Android Studioの最新バージョンをダウンロードします。インストール時に、android-sdk ディレクトリが作成される場所に注意してください。

../../../_images/custom_build_install_android_studio1.png

注釈

これは奇妙な事ですが、デフォルトで提案するパスには空白が含まれています(そして、それについて文句を言います)。なので、変更する必要があります。

いずれにしても、ユーザーフォルダ内で別のパスを選択するほうが良いでしょう。通常は次をお勧めします:

C:\Users\<yourusername>\Documents\android-sdk

Replace yourusername by your actual user name. Once it's correct, select from the list above in the same screen:

  • Android SDK
  • Android SDK Platform

それらを選択した後、インストールに進みます。その他の項目はビルド システムが自動で選択するため、手動での選択は必要ありません。

キーストアの作成

前の手順で android-sdk をインストールしたフォルダに移動し、エクスプローラーを使用してコマンドラインツールを開きます:

../../../_images/custom_build_open_shell.png

入力する実際のコマンドラインは次のとおりです。 LinuxおよびmacOSでは、そのまま使用できますが、Windowsでは、細かい追加が必要です(後ほど説明があります)。

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

Windowsでは、Javaへのフルパスを指定する必要があります(PowerShellを使用する場合は、行の先頭に & を追加する必要があります。通常の cmd.exe コンソールには必要ありません)。WindowsでAndroid Studioを使用すると、最低でもJavaがバンドルされるので、Javaについて心配する必要はありません。

わかりやすくするために、PowerShellで機能する行のスクリーンキャプチャを次に示します(& と、Javaへのフルパスを keytool.exe に追加します。cmd.exe を使用する場合は ``&``を削除します)。このパスにはAndroid Studioに付属しているJavaバージョンへのパスを使用します:

../../../_images/custom_build_command_line2.png

(画像が小さすぎる場合は、右クリックして新しいタブで開きます)

ゴドーの設定

エディタ設定に移動し、Export > Android でいくつかのフィールドを設定します。次のように表示されていることを確認します。

../../../_images/custom_build_editor_settings2.png

(画像が小さすぎる場合は、右クリックして新しいタブで開きます)

ご覧のように、ほとんどのパスは、最初に作成した android-sdk フォルダ内、またはJavaインストール内にあります。Linuxおよび macOSユーザーの場合、一般的に jarsigner/usr/bin 内にあります。

これで、すべての準備が整います。

カスタムビルドとエクスポートの有効化

プロジェクト>エクスポート ダイアログでAndroidプロジェクトを設定する場合、Custom Build を有効にする必要があります。

../../../_images/custom_build_enable.png

今後、プロジェクトのエクスポートまたはワンクリックデプロイを試みると、Gradle <https://gradle.org/> ビルドシステムが呼び出され、新しいテンプレートが生成されます(このウィンドウは毎回表示されます):

../../../_images/custom_build_gradle.png

作成されたテンプレートは後で自動的に使用されるため、それ以上の構成は必要ありません。