Dein Spiel auf Google Play

Ein hier veröffentlichtes Spiel lässt sich bereits auf einem Smartphone installieren (Schaltfläche Installieren auf seiner Seite). Damit es auch im Play Store steht, macht JumPHP daraus eine echte Android-App: eine Trusted Web Activity. Das ist die Spielseite in Chrome, im Vollbild, ohne Adressleiste, mit eigenem Symbol und Namen; das Spiel bleibt das der Website (ein hier veröffentlichtes Update ist sofort in der App). Für eine App, die ohne Netz und ohne Browser funktioniert: die native Android-App.

Du brauchst: ein JumPHP-Projekt auf deinem Computer (auf deinem Computer), Docker und ein Google-Play-Entwicklerkonto (einmalig 25 $). Dein Claude kann alles für dich erledigen: Sag ihm einfach „bring mein Spiel auf Google Play“.

1. Die App bauen

bin/jumphp twa mon-jeu --url https://jumphp.net/mon-jeu

Beim ersten Mal fragt der Befehl nach:

• dem Paketnamen der App (zum Beispiel io.github.ich.mon_jeu): ihrer Kennung im Play Store, die sich nie mehr ändert;
• dem Akzeptieren der Lizenz des Android-SDK von Google (es wird einmal heruntergeladen, ~1 GB, nach ~/.jumphp).

Er erstellt deinen Upload-Schlüssel (~/.jumphp/android/keys/, mit Passwort: Sichere beides, leg sie nie in Git ab) und baut dann in games/mon-jeu/dist/android/:

Er zeigt den SHA-256-Fingerabdruck deines Schlüssels an. Der Name unter dem Symbol ist der Kurzname des Spiels (pwa: {short_name: …} in game.yaml, sonst sein Titel).

2. Der Website mitteilen, dass die App deine ist

Ohne das öffnet sich die App mit einer Adressleiste. Im Studio auf der Seite deines Spiels, im Bereich Android-App: der Paketname und der Fingerabdruck. Die Website veröffentlicht sie unter https://jumphp.net/.well-known/assetlinks.json, was Android überprüft.

Dein Claude erledigt das mit update_project (android_package, android_fingerprints). Auf deinem eigenen Server legst du assetlinks.json unter der Adresse https://deine-domain/.well-known/assetlinks.json ab.

3. Auf Google Play veröffentlichen

Alle Details (Schlüssel, Tests auf dem Smartphone, jede Erklärung der Play Console, Prüfung, Folgeversionen, Stolperfallen): Im Play Store veröffentlichen, Schritt für Schritt. Kurz gefasst:

1. In der Play Console: App erstellen, mit demselben Paketnamen.
2. Zuerst interne Tests: Lade die .aab hoch und installiere sie über den Testlink.
3. App-Signatur (Einrichtung): Google signiert die App mit einem eigenen Schlüssel; kopiere dessen SHA-256-Fingerabdruck und füge ihn neben deinem hinzu (Schritt 2), sonst kommt die Adressleiste zurück.
4. Der Store-Eintrag (Screenshots: bin/jumphp shot), die Inhaltseinstufung, dann die Produktion.

Die Folgeversionen

Der Code des Spiels aktualisiert sich von selbst (das ist die Website). Um die App selbst zu ändern (Name, Symbol, Farben):

bin/jumphp twa mon-jeu      # die Versionsnummer steigt um 1

games/mon-jeu/android/twa-manifest.json enthält Paket, Adresse und Version: Es gehört in Git.