Back to Blog
·Summer Team

Godot 4でゲームをAndroidにエクスポートする方法(2026年完全ガイド)

Godot 4のゲームをAndroidに正しくエクスポートする手順を解説します。ビルドテンプレートのインストール、JDKとAndroid SDKの設定、キーストアの作成、よくあるエラーの解決方法、そして署名済みAPKまたはAABのリリースまでを網羅しています。

Godot 4のゲームをAndroidにエクスポートすること自体は難しくありません。ただし、ほぼ全員が初回に同じ場所で、同じ理由で詰まります。3つの異なるソフトウェアのバージョンが一致しなければならない、という点です。この3つが何かを理解して揃えてしまえば、エクスポート自体は数クリックで完了します。

このガイドでは、完成したゲームをスマートフォンにインストールするか、Google Playにアップロードできる署名済みファイルにするまでの全工程を解説します。すでに出荷したいゲームがあることを前提としています。まだ制作中であれば、Summer Engineを使うと標準的なGodot 4互換プロジェクトが生成されるため、以下のエクスポート手順はSummerのプロジェクトにもそのまま適用できます。無料プランではウォーターマークなし、収益分配なしでエクスポートが可能です。

初回エクスポートで詰まる最大の原因

GodotのAndroidエクスポートは、次の3つが一致している必要があります。

  1. Godotエディタのバージョン(例:4.5.1)
  2. インストールするエクスポートテンプレート(同じバージョンでなければなりません)
  3. GodotがAndroidパッケージのビルドに使用するJDK(Godot 4.xにはJDK 17)

エディタが4.5.1なのに4.5のテンプレートをインストールした場合や、JDK 17の代わりにJDK 21を指定した場合、エクスポートはグレーアウトするか、不可解なGradleエラーを吐き出すか、インストールできないAPKを生成します。これ以外の設定に触れる前にこの3つを揃えてしまうと、多くの人が陥る問題を回避できます。

作業の順番が重要です。最初にテンプレートとツールチェーンをインストールし、次にエクスポートを設定し、最後にビルドしてください。

ステップ1:対応するエクスポートテンプレートをインストールする

Godotでプロジェクトを開き、**「エディタ」→「エクスポートテンプレートの管理」に進みます。テンプレートがインストールされていないと表示されたら、「ダウンロードしてインストール」**をクリックします。Godotが現在のエディタバージョンに対応したテンプレートを取得します。

エクスポートメニューだけでそのまま動くように見えるため、このステップを省略する人がいます。実際にはそうはなりません。テンプレートはゲームと一緒にパッケージされるプラットフォーム固有のランタイムです。Androidテンプレートがなければ、プリセットにはビルドするものが何もありません。ベータ版やリリース候補版のGodotを使っている場合は、自動ダウンローダーが安定版しか認識しないため、テンプレートファイルを手動でダウンロードして**「ファイルからインストール」**を使う必要があるかもしれません。

ステップ2:JDKとAndroid SDKをインストールする

GodotはAndroidのツールチェーンを同梱していません。マシンに一度インストールすれば、すべてのプロジェクトでGodotが再利用します。

必要なものは2つです。

  • JDK バージョン17。 現行のGodot向けAndroid Gradleビルドには、特定的にJDK 17が必要です。JDK 21など新しいバージョンは失敗することがよくあります。Temurin(Eclipse Adoptium)は信頼性の高い無料ディストリビューションです。
  • Android SDKコマンドラインツール。 最もシンプルな方法はAndroid Studioをインストールすることで、SDK、プラットフォームツール、ビルドツールがまとめて付属します。完全なIDEが不要であればコマンドラインツールだけをインストールすることもできますが、初めてエクスポートする際はAndroid Studioが最も手間がかかりません。

インストール後、JDKの場所とAndroid SDKの場所、2つのフォルダパスを控えておいてください。次のステップでGodotに貼り付けます。

{/* IMAGE: Android Studio SDK Manager showing installed platform-tools and build-tools, with the SDK location path highlighted. Screenshot, 1200x675. */}

ステップ3:GodotにツールチェーンのパスSを設定する

Godotに戻り、**「エディタ」→「エディタ設定」に進み、左サイドバーの「エクスポート」→「Android」**セクションを開きます。

以下を入力します。

  • Java SDKのパス(またはJDKパス):ステップ2で控えたJDK 17のフォルダ
  • Android SDKのパス:ステップ2で控えたSDKのフォルダ

Godotは入力しながらパスを検証します。パスが間違っていると、その場で赤い警告が表示されます。あとからエクスポートの失敗として調べるより、今ここで修正する方がはるかに簡単です。

この設定はGodotのインストール全体に対してグローバルであり、プロジェクトごとではないため、マシンごとに一度だけ行えば十分です。

ステップ4:Androidエクスポートプリセットを作成する

次にエクスポートの設定です。**「プロジェクト」→「エクスポート」に進み、「追加」をクリックして「Android」**を選択します。

プリセットの上部に赤いエラーアイコンが表示されることがありますが、この段階では想定内です。カーソルを合わせてメッセージを読みましょう。ほとんどの場合、ビルドテンプレートかキーストアを指していますが、それらは次のステップで対処します。

プリセットの設定の中で、初回ビルドにおいて最も重要なものは以下です。

  • ユニーク名com.yourstudio.yourgameのようなパッケージID)。Play Store上でユニークである必要があるため、テスト中であっても本物の逆ドメイン名を使用してください。
  • レンダラー。最新スマートフォン向けにはモバイルレンダラーを設定し、古いハードウェアを含む幅広い端末をサポートするには互換性を選択します。これは「プロジェクト設定」の「レンダリング」で設定するもので、エディタでは動くのにスマートフォンでブラックスクリーンになる最大の原因です。
  • アーキテクチャ。arm64-v8aはそのままオンにしておいてください。これで実質的にすべての最新Androidデバイスをカバーします。非常に古い機種を特定のターゲットとしない限り、armeabi-v7aは無効にしてかまいません。

ステップ5:Androidビルドテンプレートをインストールする

Androidプリセット内に**「Androidビルドテンプレートのインストール」**というボタンがあります。クリックしてください。

これによりゲームフォルダ内にGradleプロジェクト(android/buildディレクトリ)がコピーされます。Godotはこれを使って実際にパッケージを組み立てます。カスタムビルドや後からプラグインを追加する際に必要であり、Google Playが求めるAABフォーマットにも必須です。

このステップでエラーが出る場合は、ほぼ確実にステップ3のJDKまたはSDKのパスが原因か、ファイアウォールによってGradleのダウンロードがブロックされています。Godotウィンドウ下部の出力パネルを確認してください。本当のエラーはポップアップではなくそこに出ています。

ステップ6:署名を設定する(キーストア)

Androidは署名されていないアプリのインストールを拒否するため、テストビルドにもキーストアが必要です。2つのケースがあります。

自分の端末でテストする場合(デバッグキーストア):

Godotは自動生成したデバッグキーストアを使えます。**「エディタ」→「エディタ設定」→「エクスポート」→「Android」**に、デバッグキーストア、ユーザー、パスワードのフィールドがあります。Godotがデバッグキーストアを作成でき、標準的なデバッグの認証情報は広く知られています(キーストアのユーザーはandroiddebugkeyです)。自分が管理する端末へのインストールにはこれで十分です。デバッグ署名のビルドを公開しないでください。

リリース時(独自のキーストア):

配布の準備ができたら、リリースキーストアを生成します。JDKに含まれるkeytoolコマンドをターミナルから実行して作成できます。

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

パスワードといくつかの識別情報の入力を求められます。その後、Androidエクスポートプリセットの**「キーストア」**セクションを展開し、リリースキーストアのパス、エイリアス、パスワードを入力します。

重要:このキーストアファイルとパスワードを安全な場所にバックアップしてください。 このキーストアでGoogle Playに公開した後に紛失した場合、同じIDでそのアプリを二度と更新できなくなります。モバイル開発において本当に取り返しのつかない唯一のミスです。ファイルをパスワードと同じように扱ってください。

ステップ7:エクスポートする

ビルドテンプレートをインストールし署名を設定すれば、プリセットの赤いエラーが消えているはずです。次に出力形式を選択します。

  • .apkファイル名でエクスポートプロジェクトを実行すると、単一のインストール可能なファイルが生成されます。スマートフォンにコピーしてタップするか(提供元不明のアプリのインストールを許可する必要があるかもしれません)、USB経由でインストールします。テストやitch.ioなどの店舗外配布に使います。
  • .aabファイル名でエクスポートプロジェクトを実行すると、Google Play Store向けのAndroid App Bundleが生成されます。Google Playは新しいアプリにAABのみを受け付けます。

端末での素早いテストにはワンクリックデプロイが最速です。USBデバッグを有効にしてスマートフォンを接続すると、Godotエディタの右上に小さなAndroidアイコンが表示されます。クリックするだけで、Godotがビルド、インストール、ゲームの起動を一気に行い、リモートデバッガーが接続された状態でエラーをリアルタイムで確認できます。

{/* IMAGE: Godot editor toolbar showing the one-click Android deploy button (small Android robot icon) lit up with a connected device. Screenshot, 800x400. */}

よくあるエラーとその実際の意味

  • プリセットに赤いエラー「エクスポートテンプレートが見つかりません」: ステップ1の問題で、テンプレートのバージョンがエディタのバージョンと一致していません。正確なバージョン向けにテンプレートを再インストールしてください。
  • 「有効なJava SDKがありません」または「JDKが見つかりません」: ステップ3のパスが間違っているか、JDK 17以外をインストールしています。JDK 17をインストールして再設定してください。
  • 長いスタックトレースを伴うGradleビルドの失敗: ポップアップではなくGodotの出力パネルを読んでください。ほとんどの場合はJDKのバージョン不一致、ダウンロードのブロック、またはパッケージ名に無効な文字(IDは小文字の逆ドメイン形式を使用し、スペースやハイフンは不可)が含まれています。
  • インストールできるが起動時にブラックスクリーン: 端末に合わないレンダラー(モバイルまたは互換性に切り替えてください)か、モバイルGPUには大きすぎるテクスチャが原因です。リモートデバッガーを有効にしてUSB経由で実行し、Androidのログを読んでください。
  • スマートフォンに「アプリがインストールされていません」: 通常は署名の問題か、同じパッケージの別の署名バージョンがすでにインストールされています。まず古いものをアンインストールしてください。
  • ゲームは動くが操作が効かない: 入力マップがキーボードを前提にしています。モバイルにはタッチ入力が必要です。次のセクションで説明します。

エクスポートでは解決しない問題:指で遊べるゲームにする

エクスポート自体は機械的な作業です。モバイルにおける本当の難しさは、キーボードとマウス向けに作られたゲームがタッチスクリーンではプレイできないという点で、エクスポート設定ではどうにもなりません。必要なのは以下の3点です。

  • オンスクリーンタッチコントロール。 ジャンルに応じて、バーチャルジョイスティック、タップアクションボタン、またはジェスチャー入力が必要です。
  • 様々なアスペクト比に対応した画面スケーリング。 スマートフォンは縦長のものからワイドなタブレットまで多種多様です。ストレッチモード(canvas_items、アスペクト比を維持)を設定し、UIが見切れたり孤立したりしないようにしてください。
  • 大きなタップターゲット。 マウスカーソル向けのサイズのボタンは、指には小さすぎます。

ここでAIネイティブなワークフローが真価を発揮します。Summerでは「移動用のバーチャルジョイスティックと右下に攻撃ボタンを追加して、HUDを画面にスケーリングさせてほしい」のように普通の言葉で変更を指示すると、実際のプロジェクトを編集します。出力は標準的なGodot 4互換プロジェクトなので、追加されたタッチコントロールは通常のGodotノードとして開いて手動で調整できます。テンプレートギャラリーからモバイル向けプロジェクトを選んで使い始めてください。

ゲーム自体をゼロから制作する場合は、AIでゲームを作る方法でビルドループを解説しており、AIで2Dゲームを作る方法では小さなプロジェクトをゼロから完成させるまでを詳しく説明しています。どちらも上記のエクスポート手順がそのまま適用できるプロジェクトを生成します。

無料と有料について、正直に

このガイドで説明した内容はすべて無料です。Godotのツールチェーン(エディタ、テンプレート、JDK、SDK)は無料で使えます。SummerからAndroid APKまたはAABをビルドしてエクスポートすることは無料プランで対応しており、ウォーターマークも収益分配もありません。大規模なプロジェクトではより多くのAI使用量が必要になることがあり、上限は料金ページで確認できます。自分では制御できない費用はGoogle Playデベロッパーアカウントの一回限り25ドルの登録料だけで、しかもPlay Storeで公開したい場合のみ必要です。自分のスマートフォンへのサイドロードやitch.ioでの配布は無料です。

Androidの次:残りのリリース作業

署名済みのAndroidビルドはあくまで一つのプラットフォームです。デスクトップもターゲットにするなら、SteamにゲームをPublishする方法でSteam側の手順を解説しています。こちらは署名不要ですが、審査手数料がかかります。Godot 4互換プロジェクトは同じ「プロジェクト」→「エクスポート」メニューからWindows、macOS、Linux、Web、Androidに一括でエクスポートできるため、Androidを一度やり遂げれば、あとは同じ手順に別のプリセットを使うだけです。

3つのバージョンを揃え、ビルドテンプレートをインストールし、ビルドに署名すれば、実機でゲームが動きます。そのエクスポート可能なプロジェクトをゼロから自分で書かずに作りたいなら、AIゲームメーカーから始めるか、ダウンロードページからデスクトップアプリを入手してください。

Frequently asked questions

GodotのAndroidエクスポートがグレーアウトしているか赤いエラーが表示されるのはなぜですか?

Androidプリセットに赤い点が表示される場合、ほぼ確実に次の3つのうちいずれかが欠けているか、バージョンが一致していません。使用しているGodotバージョン向けのエクスポートテンプレートがインストールされていない、「エディタ設定」のJDKまたはAndroid SDKのパスが間違っている、またはキーストアが設定されていない、のいずれかです。赤いアイコンにカーソルを合わせると、Godotが原因を教えてくれます。上から順に修正してください。Godot 4.xにはJDK 17を使用し、エクスポートテンプレートのバージョンはメジャーバージョンだけでなく、エディタのバージョンと完全に一致していることを確認してください。

APKとAABの違いは何ですか?どちらが必要ですか?

APKはテスト用や店舗外での配布に使える、スマートフォンに直接インストールできる単一のファイルです。AAB(Android App Bundle)はGoogle Playが新しいアプリに要求するフォーマットで、Googleが端末ごとに最適化されたダウンロードに分割します。自分の端末でテストする間はデバッグAPKを使用し、Play Storeに提出する準備ができたらリリースAABをビルドしてください。itch.ioや直接配布にはAPKを使います。

スマートフォンでテストするためにGoogle Playデベロッパーアカウントは必要ですか?

必要ありません。自分のAndroid端末にゲームをインストールするには、デバッグAPKとUSBデバッグの有効化(またはAPKをコピーしてタップ)するだけで十分です。25ドルのGoogle Playデベロッパーアカウントが必要なのは、Play Storeで公開したいときだけです。料金を支払う前に、実機でゲームのビルド、署名、プレイをすべて無料で行えます。

Summer EngineはAndroidへのエクスポートに対応していますか?無料で使えますか?

Summerは標準的なGodot 4互換プロジェクトを生成するため、Androidのエクスポート手順はこのガイドと同じです。また、無料プランではウォーターマークなし、収益分配なしでビルドおよびエクスポートが可能です。Summerは最初のモバイルビルドで詰まりやすい部分、つまりタッチ操作、異なるアスペクト比への画面スケーリング、キーボードとマウス前提のプロトタイプのタッチ対応といった作業をサポートします。JDK、SDK、キーストアの一度限りのマシンへのインストールは引き続き必要です。これらはどのエンジンとも独立して管理するものだからです。

エディタでは動くのに、Android上でクラッシュするかブラックスクリーンになるのはなぜですか?

よくある原因は、端末が対応していないレンダラー、モバイルGPUには大きすぎるテクスチャ、またはキーボードを前提とした入力処理です。「プロジェクト設定」でレンダラーを「モバイル」(古い機種には「互換性」)に設定し、テクスチャはできる限り2048以下のべき乗サイズに抑えてください。キーボード入力はオンスクリーンのタッチ操作に置き換えましょう。USBでゲームを実行し、リモートデバッガーを有効にしてAndroidのログを読むことで、推測に頼らず問題を特定できます。

テスト用でもAndroidゲームに署名が必要ですか?

はい。Androidは署名されていないアプリのインストールを拒否するため、デバッグビルドにもキーストアが必要です。Godotはデバッグキーストアを自動生成して「エディタ設定」に設定できるので、自分の端末でのテストにはそれで十分です。Play Storeへの提出や公開ダウンロードを含む配布には、独自のリリースキーストアを作成してバックアップを取る必要があります。紛失した場合、同じIDで同じアプリを二度と更新できなくなります。