Je game op Google Play
Een hier gepubliceerde game is al op een telefoon te installeren (knop Installeren op zijn pagina). Om hem ook in de Play Store te krijgen, maakt JumPHP er een echte Android-app van: een Trusted Web Activity. Dat is de pagina van de game in Chrome, op volledig scherm, zonder adresbalk, met zijn pictogram en naam; de game blijft die van de site (een hier gepubliceerde update zit meteen in de app). Voor een app die zonder netwerk en zonder browser werkt: de native Android-app.
Je hebt nodig: een JumPHP-project op je computer (op je computer), Docker en een Google Play-ontwikkelaarsaccount (eenmalig 25 $). Je Claude kan alles voor je doen: vraag hem “zet mijn game op Google Play”.
1. De app maken
bin/jumphp twa mon-jeu --url https://jumphp.net/mon-jeu
De eerste keer vraagt het commando:
- de pakketnaam van de app (bijvoorbeeld
io.github.ik.mon_jeu): zijn identificatie in de Play Store, die verandert nooit meer; - om de licentie van de Android-SDK van Google te accepteren (die wordt één keer gedownload, ~1 GB, in
~/.jumphp).
Het maakt je uploadsleutel aan (~/.jumphp/android/keys/, met zijn wachtwoord: maak er een back-up van, zet ze
nooit in git) en bouwt daarna in games/mon-jeu/dist/android/:
| Bestand | Voor |
|---|---|
mon-jeu-1.aab |
de Play Store |
mon-jeu-1.apk |
uitproberen op je telefoon (adb install, of kopieer het erheen) |
assetlinks.json |
bewijzen dat de site en de app bij elkaar horen (stap 2) |
Het toont de SHA-256-vingerafdruk van je sleutel. De naam onder het pictogram is de korte naam van de game
(pwa: {short_name: …} in game.yaml, anders zijn titel).
2. De site vertellen dat de app van jou is
Zonder dit opent de app met een adresbalk. In de Studio, op de pagina van je game, bij Android-app:
de pakketnaam en de vingerafdruk. De site publiceert ze in
https://jumphp.net/.well-known/assetlinks.json, wat Android controleert.
Je Claude doet dit met update_project (android_package, android_fingerprints). Op je eigen
server zet je assetlinks.json op het adres https://jouw-domein/.well-known/assetlinks.json.
3. Het publiceren op Google Play
Alle details (sleutels, testen op een telefoon, elke verklaring in de Play Console, beoordeling, volgende versies, valkuilen): Publiceren op de Play Store, stap voor stap. In het kort:
- In de Play Console: App maken, met dezelfde pakketnaam.
- Eerst interne tests: upload de
.aab, installeer hem via de testlink. - App-ondertekening (Instellen): Google ondertekent de app met zijn eigen sleutel; kopieer zijn SHA-256-vingerafdruk en voeg hem toe naast die van jou (stap 2), anders komt de adresbalk terug.
- De winkelvermelding (screenshots:
bin/jumphp shot), de contentclassificatie, daarna productie.
De volgende versies
De code van de game wordt vanzelf bijgewerkt (dat is de site). Om de app zelf te veranderen (naam, pictogram, kleuren):
bin/jumphp twa mon-jeu # het versienummer gaat met 1 omhoog
games/mon-jeu/android/twa-manifest.json bewaart het pakket, het adres en de versie: het gaat in git.