Dein Spiel in Godot 4 für Android exportieren (vollständige Anleitung 2026)

Ein Godot-4-Spiel für Android zu exportieren ist nicht schwer, scheitert aber beim ersten Mal bei fast jedem auf eine ganz bestimmte, vorhersehbare Weise: ein Versionskonflikt zwischen drei Softwarekomponenten, die alle uebereinstimmen müssen. Sobald du verstehst, welche drei das sind und sie aufeinander abstimmst, ist der Export selbst nur ein paar Klicks.

Diese Anleitung führt den gesamten Weg von einem fertigen Spiel zu einer signierten Datei, die du auf einem Telefon installieren oder bei Google Play hochladen kannst. Es wird vorausgesetzt, dass du bereits ein Spiel hast, das du ausliefern möchtest. Wenn du noch eines baust, erstellt Summer Engine echte Projekte, die mit Godot 4 kompatibel sind, sodass die folgenden Exportschritte auf ein Summer-Projekt genauso zutreffen wie auf jedes handgebaute Godot-Projekt. Der kostenlose Tarif deckt den Export ohne Wasserzeichen und ohne Umsatzbeteiligung ab.

Das Eine, das die meisten ersten Exporte scheitern lässt

Android-Export in Godot hängt davon ab, dass drei Dinge uebereinstimmen:

1. Deine Godot-Editor-Version (zum Beispiel 4.5.1)
2. Die Export-Templates, die du installierst (müssen dieselbe Version haben)
3. Das JDK, das Godot zum Bauen des Android-Pakets verwendet (JDK 17 für Godot 4.x)

Wenn dein Editor 4.5.1 ist, du aber 4.5-Templates installierst, oder du Godot auf JDK 21 statt 17 zeigst, wird der Export entweder ausgegraut, wirft einen kryptischen Gradle-Fehler oder erzeugt eine APK, die sich nicht installieren lässt. Kläre diese drei Punkte, bevor du irgendetwas anderes angehst, und du vermeidest den Großteil der Probleme, auf die andere stoßen.

Die Reihenfolge ist also wichtig. Installiere erst die Templates und die Toolchain, konfiguriere danach den Export und baue zuletzt.

Schritt 1: Die passenden Export-Templates installieren

Öffne dein Projekt in Godot. Gehe zu Editor dann Export-Templates verwalten. Wenn das Panel meldet, dass keine Templates installiert sind, klicke auf Herunterladen und installieren. Godot lädt die Templates für deine genaue Editor-Version herunter.

Viele überspringen diesen Schritt, weil das Export-Menu so aussieht, als würde es einfach funktionieren. Tut es aber nicht. Die Templates sind die plattformspezifische Laufzeitumgebung, die mit deinem Spiel gebündelt wird, und ohne das Android-Template hat das Preset nichts zum Bauen. Bei einer Beta- oder Release-Candidate-Version von Godot musst du die Template-Datei möglicherweise manuell herunterladen und Aus Datei installieren verwenden, da der automatische Downloader nur stabile Versionen kennt.

Schritt 2: JDK und Android SDK installieren

Godot liefert die Android-Toolchain nicht mit. Du installierst sie einmal auf deiner Maschine, und Godot verwendet sie für jedes Projekt.

Du brauchst zwei Dinge:

• Ein JDK, Version 17. Android-Gradle-Builds für aktuelles Godot benötigen spezifisch JDK 17. Ein neueres JDK wie 21 schlägt häufig fehl. Temurin (Eclipse Adoptium) ist eine zuverlässige kostenlose Distribution.
• Die Android-SDK-Kommandozeilenwerkzeuge. Der einfachste Weg ist die Installation von Android Studio, das das SDK, die Plattformwerkzeuge und die Build-Tools mitbringt. Wer die vollständige IDE nicht möchte, kann nur die Kommandozeilenwerkzeuge installieren, aber Android Studio ist für einen ersten Export der Weg des geringsten Widerstands.

Notiere nach der Installation zwei Ordnerpfade: wo das JDK liegt und wo das Android SDK liegt. Du wirst beide im nächsten Schritt in Godot eintragen.

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

Schritt 3: Godot auf die Toolchain zeigen

Zurück in Godot, gehe zu Editor dann Editor-Einstellungen und finde im linken Bereich den Abschnitt Export dann Android.

Fülle aus:

• Java SDK-Pfad (oder JDK-Pfad): der JDK-17-Ordner aus Schritt 2
• Android SDK-Pfad: der SDK-Ordner aus Schritt 2

Godot prüft diese Pfade während du tippst. Ist ein Pfad falsch, siehst du sofort eine rote Warnung, die viel einfacher zu beheben ist als später als fehlgeschlagener Export zu debuggen.

Diese Konfiguration gilt global für deine Godot-Installation, nicht pro Projekt, also erledigst du das nur einmal pro Maschine.

Schritt 4: Das Android-Export-Preset erstellen

Jetzt der eigentliche Export. Gehe zu Projekt dann Exportieren. Klicke auf Hinzufügen und wähle Android.

Du wirst wahrscheinlich ein rotes Fehlersymbol oben im Preset sehen. Das ist in diesem Stadium zu erwarten und zeigt dir, was noch fehlt. Fahre mit der Maus darüber, um die Meldung zu lesen. Sie verweist meistens auf das Build-Template oder den Keystore, um die du dich als nächstes kuemmerst.

Bei den Preset-Optionen sind die folgenden Einstellungen für einen ersten Build am wichtigsten:

• Unique Name (die Paket-ID, etwa com.deinstudio.deinspiel). Diese muss im Play Store eindeutig sein, also verwende auch beim Testen einen echten Reverse-Domain-Namen.
• Renderer. Stelle dein Projekt auf den Mobile-Renderer für moderne Telefone oder auf Compatibility für die breiteste Geraeteunterstuetzung einschließlich älterer Hardware. Das stellst du in den Projekteinstellungen unter Rendering ein, und es ist der häufigste Grund, warum ein Spiel im Editor läuft, auf dem Telefon aber einen schwarzen Bildschirm zeigt.
• Architectures. Lass arm64-v8a aktiviert; es deckt nahezu jedes moderne Android-Gerät ab. Du kannst armeabi-v7a deaktivieren, sofern du nicht gezielt sehr alte Telefone ansteuerst.

Schritt 5: Das Android-Build-Template installieren

Im Android-Preset gibt es eine Schaltfläche: Android-Build-Template installieren. Klicke sie an.

Damit wird ein Gradle-Projekt in deinen Spielordner kopiert (ein android/build-Verzeichnis). Godot verwendet es, um das Paket tatsächlich zusammenzubauen. Du brauchst es für Custom-Builds, um später Plugins hinzuzufügen, und es ist für das AAB-Format erforderlich, das Google Play verlangt.

Schlägt dieser Schritt fehl, liegt es fast immer am JDK- oder SDK-Pfad aus Schritt 3, oder ein Gradle-Download wird von einer Firewall blockiert. Lies das Ausgabe-Panel am unteren Rand des Godot-Fensters; der eigentliche Fehler steht dort, nicht im Popup.

Schritt 6: Signierung einrichten (der Keystore)

Android installiert keine unsignierte App, daher benötigt selbst ein Test-Build einen Keystore. Es gibt zwei Fälle.

Für Tests auf dem eigenen Gerät (Debug-Keystore):

Godot kann einen automatisch generierten Debug-Keystore verwenden. Unter Editor dann Editor-Einstellungen dann Export dann Android gibt es Felder für einen Debug-Keystore, Benutzer und Passwort. Godot kann den Debug-Keystore für dich erstellen; die Standard-Debug-Zugangsdaten sind allgemein bekannt (der Keystore-Benutzer ist androiddebugkey). Das ist für die Installation auf Hardware, die du selbst kontrollierst, völlig in Ordnung. Veröffentliche einen debug-signierten Build niemals öffentlich.

Für Release (dein eigener Keystore):

Wenn du bereit bist zu verteilen, erstelle einen Release-Keystore. Das geht im Terminal mit dem keytool-Befehl, der mit deinem JDK mitgeliefert wird:

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

Es fragt nach einem Passwort und einigen Identitaetsangaben. Klappe dann im Android-Export-Preset den Abschnitt Keystore auf und trage den Release-Keystore-Pfad, den Alias und die Passwörter ein.

Entscheidend: Sichere diese Keystore-Datei und ihre Passwörter an einem sicheren Ort. Wenn du im Google Play Store mit diesem Keystore veröffentlichst und ihn dann verlierst, kannst du diese App nie wieder unter derselben Identität aktualisieren. Das ist der eine Fehler beim Mobile-Publishing, der wirklich unwiderruflich ist, also behandle die Datei wie ein Passwort.

Schritt 7: Exportieren

Mit installiertem Build-Template und eingerichteter Signierung sollte der rote Fehler im Preset verschwunden sein. Wähle jetzt deine Ausgabe.

• Projekt exportieren mit einem .apk-Dateinamen gibt dir eine einzelne installierbare Datei. Kopiere sie auf ein Telefon und tippe sie an (du musst möglicherweise Installationen aus unbekannten Quellen erlauben), oder installiere sie über USB. Das verwendest du für Tests und für Veröffentlichungen außerhalb des Stores, etwa auf itch.io.
• Projekt exportieren mit einem .aab-Dateinamen gibt dir ein Android App Bundle für den Google Play Store. Google Play akzeptiert für neue Apps nur AAB.

Für einen schnellen Geraetetest ist One-Click-Deploy der schnellste Weg: Schließe dein Telefon per USB an mit aktiviertem USB-Debugging, und ein kleines Android-Symbol erscheint oben rechts im Godot-Editor. Klicke es an, und Godot baut, installiert und startet das Spiel auf dem verbundenen Gerät in einem Schritt, mit angehängtem Remote-Debugger, sodass du Fehler in Echtzeit lesen kannst.

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

Häufige Fehler und was sie wirklich bedeuten

• Roter Fehler im Preset, "Export templates not found": Schritt 1, die Template-Version stimmt nicht mit deiner Editor-Version überein. Installiere die Templates für die genaue Version neu.
• "No valid Java SDK" oder "JDK not found": Der Pfad in Schritt 3 ist falsch, oder du hast ein anderes JDK als 17 installiert. Installiere JDK 17 und zeige neu darauf.
• Gradle-Build schlägt mit einem langen Stack-Trace fehl: Lies das Godot-Ausgabe-Panel, nicht das Popup. Meistens ein JDK-Versionskonflikt, ein blockierter Download oder ein Paketname mit ungueltigen Zeichen (verwende Kleinschreibung im Reverse-Domain-Format, keine Leerzeichen oder Bindestriche im Identifier).
• Installiert sich, aber schwarzer Bildschirm beim Start: Falscher Renderer für das Gerät (wechsle zu Mobile oder Compatibility) oder Texturen zu groß für die Mobile-GPU. Führe das Spiel über USB mit dem Remote-Debugger aus, um das Android-Log zu lesen.
• "App not installed" auf dem Telefon: Meistens ein Signierproblem, oder du hast bereits eine anders signierte Version desselben Pakets installiert. Deinstalliere zuerst die alte.
• Spiel läuft, aber Steuerung reagiert nicht: Deine Input-Map setzt eine Tastatur voraus. Mobile braucht Touch-Input, was wir als nächstes behandeln.

Was Export nicht löst: das Spiel mit Fingern spielbar machen

Exportieren ist mechanisch. Das schwerere Mobile-Problem ist, dass ein Spiel, das für Tastatur und Maus gebaut wurde, auf einem Touchscreen nicht spielbar ist, und keine Export-Einstellung ändert das. Du brauchst:

• On-Screen-Touch-Steuerung. Einen virtuellen Joystick, Tippen-zum-Handeln-Schaltflächen oder Gestensteuerung, je nach Genre.
• Bildschirmskalierung, die viele Seitenverhältnisse übersteht. Telefone reichen von schmal und hoch bis zu breiten Tablets. Stelle einen Stretch-Modus (canvas_items, Seitenverhältnis beibehalten) ein, damit deine UI nicht abgeschnitten wird oder verloren geht.
• Größere Beruehrungsziele. Schaltflächen, die auf einen Mauszeiger zugeschnitten sind, sind für einen Daumen zu klein.

Hier spart ein KI-nativer Workflow echte Zeit. In Summer beschreibst du die Änderung in einfacher Sprache, etwa für Bewegung einen virtuellen Joystick und unten rechts einen Feuer-Button hinzufügen und den HUD an den Bildschirm anpassen lassen, und es bearbeitet das eigentliche Projekt. Da die Ausgabe ein Standardprojekt ist, das mit Godot 4 kompatibel ist, sind die Touch-Steuerungselemente, die es hinzufügt, normale Godot-Nodes, die du öffnen und von Hand anpassen kannst. Starte ein mobilfreundliches Projekt aus der Vorlagengalerie und passe es an.

Wenn du das Spiel selbst von Grund auf baust, behandelt Wie man ein Spiel mit KI macht den Build-Ablauf, und Wie man ein 2D-Spiel mit KI macht geht ein kleines Projekt von Anfang bis Ende tief durch. Beide erzeugen Projekte, die genau den obigen Exportschritten folgen.

Kostenlos versus bezahlt, ehrlich gesagt

Alles in dieser Anleitung ist kostenlos. Die Godot-Toolchain (Editor, Templates, JDK, SDK) kostet nichts. Das Bauen und Exportieren einer Android-APK oder AAB aus Summer ist im kostenlosen Tarif enthalten, ohne Wasserzeichen und ohne Umsatzbeteiligung; du zahlst nur für mehr KI-Nutzung bei größeren Projekten, und die Limits findest du auf der Preisseite. Die einzige Kosten außerhalb deiner Kontrolle ist das einmalige Google-Play-Entwicklerkonto für 25 Dollar, und nur wenn du im Play Store veröffentlichen möchtest. Sideloading einer APK auf dein eigenes Telefon oder Veröffentlichen auf itch.io ist kostenlos.

Nach Android: der Rest des Launches

Ein signierter Android-Build ist eine Plattform. Wenn du auch Desktop anvisierst, führt Dein Spiel auf Steam veröffentlichen durch die Steam-Seite, die einen eigenen signierungsfreien, aber gebuehrenbasierten Prozess hat. Die gute Nachricht ist, dass das normale Godot 4 aus demselben Menü Projekt dann Exportieren für Windows, macOS, Linux, Web und Android exportiert, sodass du nach Android für die anderen denselben Ablauf mit einem anderen Preset hast. In Summer deckt der Desktop-Export Windows und macOS ab, und der Web-Export deckt GDScript-Projekte ab, die du auf Summer Games veröffentlichen kannst.

Bring die drei Versionen auf einen Stand, installiere das Build-Template, signiere den Build, und du hast ein Spiel, das auf einem echten Telefon läuft. Um von der Idee zu diesem exportierbaren Projekt zu gelangen, ohne den Boilerplate selbst zu schreiben, starte im KI-Spielemacher oder hole dir die Desktop-App von der Download-Seite.