Accedi con GitHub
IT

Il tuo gioco su Google Play

Un gioco pubblicato qui si installa già su un telefono (pulsante Installa della sua pagina). Perché sia anche sul Play Store, JumPHP ne fa una vera app Android: una Trusted Web Activity. È la pagina del gioco in Chrome, a schermo intero, senza barra degli indirizzi, con la sua icona e il suo nome; il gioco resta quello del sito (un aggiornamento pubblicato qui è subito nell'app). Per un'app che funziona senza rete e senza browser: l'app Android nativa.

Serve: un progetto JumPHP sul tuo computer (sul tuo computer), Docker e un account sviluppatore Google Play (25 $ una tantum). Il tuo Claude può fare tutto al posto tuo: chiedigli «metti il mio gioco su Google Play».

1. Costruire l'app

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

La prima volta, il comando chiede:

  • il nome del pacchetto dell'app (per esempio io.github.utente.mon_jeu): il suo identificatore sul Play Store, non cambia mai più;
  • di accettare la licenza dell'SDK Android di Google (viene scaricato una volta, ~1 GB, in ~/.jumphp).

Crea la tua chiave di caricamento (~/.jumphp/android/keys/, con la sua password: salvale, non metterle mai in git), poi costruisce in games/mon-jeu/dist/android/:

File Per
mon-jeu-1.aab il Play Store
mon-jeu-1.apk provarla sul tuo telefono (adb install, oppure copiala sopra)
assetlinks.json dimostrare che il sito e l'app vanno insieme (passo 2)

Mostra l'impronta SHA-256 della tua chiave. Il nome sotto l'icona è il nome breve del gioco (pwa: {short_name: …} in game.yaml, altrimenti il suo titolo).

2. Dire al sito che l'app è tua

Senza questo, l'app si apre con una barra degli indirizzi. Nello Studio, nella pagina del tuo gioco, sezione App Android: il nome del pacchetto e l'impronta. Il sito li pubblica in https://jumphp.net/.well-known/assetlinks.json, che Android verifica.

Il tuo Claude lo fa con update_project (android_package, android_fingerprints). Sul tuo server, metti assetlinks.json all'indirizzo https://tuo-dominio/.well-known/assetlinks.json.

3. Pubblicarla su Google Play

Tutti i dettagli (chiavi, prove sul telefono, ogni dichiarazione della Play Console, revisione, versioni successive, trappole): Pubblicare sul Play Store, passo passo. In breve:

  1. Nella Play Console: Crea app, con lo stesso nome di pacchetto.
  2. Prima i test interni: carica il .aab, installalo dal link di test.
  3. Firma dell'app (Configurazione): Google firma l'app con la sua chiave; copia la sua impronta SHA-256 e aggiungila accanto alla tua (passo 2), altrimenti la barra degli indirizzi ricompare.
  4. La scheda dello store (screenshot: bin/jumphp shot), la classificazione dei contenuti, poi la produzione.

Le versioni successive

Il codice del gioco si aggiorna da solo (è il sito). Per cambiare l'app stessa (nome, icona, colori):

bin/jumphp twa mon-jeu      # il numero di versione sale di 1

games/mon-jeu/android/twa-manifest.json conserva il pacchetto, l'indirizzo e la versione: va in git.