Geschlossene Tests in Google Play für Godot-Spiele

Google Play braucht eine Signatur, die nicht vom Debug-Schlüssel stammt. Erstelle mit keytool einen Release-Keystore:

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

Fülle im Android-Preset unter Keystore die Felder Release (Dateipfad), Release User (Alias) und Release Password aus. Godot verlangt derzeit, dass Keystore- und Schlüsselpasswort gleich sind, und am sichersten verwendest du nur Buchstaben und Ziffern.

Dieser Keystore ist dein Upload-Schlüssel. Beim ersten Upload wird die Play App-Signatur eingerichtet, und Google verwahrt den App-Signaturschlüssel. Halte in der CI die Geheimnisse aus export_presets.cfg heraus und übergib sie stattdessen als Umgebungsvariablen:

GODOT_ANDROID_KEYSTORE_RELEASE_PATH=/secrets/mygame.keystore
GODOT_ANDROID_KEYSTORE_RELEASE_USER=mygame
GODOT_ANDROID_KEYSTORE_RELEASE_PASSWORD=*****

Im Preset ist Version → Code die Ganzzahl, die Google vergleicht; erhöhe sie bei jedem Upload, denn die Play Console lehnt wiederverwendete Codes ab. Version → Name sehen die Spieler.

Seit dem 31. August 2026 müssen neue Apps und Updates Android 16 (API-Level 36) als Ziel haben. Unter Gradle Build setzt Target SDK die targetSdkVersion; bleibt das Feld leer, gilt der Standard der Vorlage. Liegt der Standard deiner Godot-Version unter 36, setze den Wert ausdrücklich oder aktualisiere Godot und teste den Export dann auf einem aktuellen Gerät.

• Unpassende Vorlagen. Export-Vorlagen und Android-Build-Vorlage müssen zur Editor-Version passen. Installiere nach einem Godot-Upgrade beide neu.
• Export With Debug vergessen. Dann wird das Bundle mit dem Debug-Keystore signiert, und die Play Console lehnt es ab.
• Fehlendes arm64-v8a. Lass unter Architectures die Option arm64-v8a aktiviert; Google Play verlangt 64-Bit-Code.
• Ordner mit Unterstrich am Anfang. Bei Gradle-Builds werden Assets in einem Ordner, dessen Name mit _ beginnt, nicht übernommen. Tester stoßen dann auf fehlende Texturen oder Szenen.
• Sonderzeichen in Passwörtern. Sie können den Export mit unklaren Fehlern scheitern lassen. Nutze Buchstaben und Ziffern.
• C#-Projekte. Den Android-Export für C# gibt es seit Godot 4.2, er ist aber noch experimentell. Teste das Release-Bundle früh auf echten Geräten.

Ein Godot-Export führt deine Skripte auf einer vorkompilierten Engine-Bibliothek aus. Die meisten Testerberichte entpuppen sich daher als Skriptfehler, fehlende Ressourcen oder gerätespezifische Darstellungsprobleme statt als Engine-Abstürze. Am schnellsten siehst du sie auf deinem eigenen Smartphone mit angeschlossenem Editor.

1. 1

   Mit einem Klick bereitstellen

   Aktiviere auf einem Smartphone den Entwicklermodus und USB-Debugging, schließ es an und stell sicher, dass dein Android-Preset als Runnable markiert ist. Dann erscheint oben rechts im Editor ein Android-Button, der mit einem Klick exportiert und installiert.

2. 2

   Remote-Debugging einschalten

   Ist Debug → Deploy with Remote Debug aktiv, verbindet sich das Spiel auf dem Smartphone mit deinem Rechner, sodass Debugger, Breakpoints und Fehlerausgabe des Editors wie am Desktop funktionieren.

3. 3

   Drahtlos arbeiten, wenn USB unzuverlässig ist

   Aktiviere auf dem Smartphone drahtloses Debugging, kopple es per adb pair mit dem angezeigten Code und prüfe mit adb devices. Listet adb devices das Smartphone nicht, sieht Godot es auch nicht.

4. 4

   Nach jedem Upload die Play Console prüfen

   Engine-Abstürze erscheinen unter Beobachten und verbessern → Android Vitals → Abstürze und ANRs. Der Pre-Launch-Bericht installiert außerdem jeden hochgeladenen Build automatisch auf Testgeräten und markiert Abstürze und Kompatibilitätsprobleme.

# Wireless debugging: pair once with the code shown on the phone
adb pair <ip address>:<port>
adb devices

# Watch the device log while you reproduce a tester's report
adb logcat

Ein Build, der ohne Export With Debug exportiert wurde, verbindet sich nicht mit dem Editor. Um zu sehen, warum der Release-Build auf einem bestimmten Smartphone scheitert, installiere ihn dort und beobachte adb logcat, während du die Schritte des Testers nachstellst.

Sobald dein Godot-Bundle gebaut und signiert ist, passiert der Rest in der Play Console und funktioniert für jedes Framework gleich. Hier die Checkliste; jedes Menü und jeden Bildschirm erklärt die vollständige Play-Console-Anleitung.

• App-Einrichtung abschließen: im Dashboard Datenschutzerklärung, App-Zugriff, Werbung, Altersfreigabe, Zielgruppe, Datensicherheit und Store-Eintrag.
• Release für den geschlossenen Test erstellen: unter Testen und veröffentlichen → Tests → Geschlossene Tests die Länder deiner Tester wählen, das .aab hochladen und zur Prüfung senden.
• Tester per Google Group hinzufügen: im Tab Tester die Gruppe eintragen und den Opt-in-Link teilen. Er funktioniert, sobald der Track Veröffentlicht zeigt.
• Mindestens 12 Tester 14 Tage ohne Unterbrechung im Opt-in halten. Interne Tests zählen nicht, und wer austritt und wiederkommt, beginnt seine 14 Tage von vorn.
• Während des Tests mindestens ein Update veröffentlichen und notieren, was Tester gefunden und was du geändert hast.
• Produktionszugang beantragen: im Dashboard den Antrag öffnen und die drei Abschnitte zu deinem Test, deiner App und deiner Produktionsreife beantworten. Die Entscheidung trifft Google; niemand kann eine Freigabe garantieren.

Plane Ausfälle ein: Gewinne mehr als 12 Tester, damit ein Abgang deinen Zeitplan nicht verschiebt. Alle Play-Console-Schritte ansehen.

Erhöhe Version → Code im Preset, exportiere die .aab erneut und lade sie in denselben geschlossenen Track hoch.

Für deine eigenen Testläufe stellt Debug → Small Deploy with Network Filesystem eine minimale ausführbare Datei per USB bereit und streamt die Projektdateien über das Netzwerk aus dem Editor, was bei großen Spielen viel Zeit spart. Das ist rein eine Entwicklungsfunktion: Tester brauchen immer ein vollständig exportiertes .aab im geschlossenen Track.

• Randlos. Die Preset-Option Screen → Edge to Edge lässt das Spiel hinter durchscheinende Systemleisten zeichnen. Wenn du sie aktivierst, halte wichtige UI innerhalb des Bereichs, den DisplayServer.get_display_safe_area() liefert, damit nichts unter einer Leiste oder Kameraaussparung verschwindet.
• Native Bibliotheken unkomprimiert lassen. Gradle Build → Compress Native Libraries verkleinert das Bundle, verlangsamt aber den Start, weil die Bibliotheken vor der Nutzung entpackt werden müssen. Für Google Play empfiehlt die Godot-Dokumentation, die Option auszulassen.
• Export per Skript. Ein Headless-Export mit dem Keystore in Umgebungsvariablen, wie im Signaturabschnitt, erzeugt jedes Mal dasselbe Bundle und macht die Erhöhung des Versionscodes zur Routine.
• Godot nicht mitten im Test aktualisieren. Eine neue Editor-Version bedeutet neue Exportvorlagen, eine neue Android-Build-Vorlage und eine neue Engine-Bibliothek für Tester. Aktualisiere vor dem Test oder nach dem Produktionszugang.