O seu jogo no Google Play

Um jogo publicado aqui já se instala em um celular (botão Instalar da página dele). Para que ele esteja também na Play Store, o JumPHP o transforma em um verdadeiro aplicativo Android: uma Trusted Web Activity. É a página do jogo no Chrome, em tela cheia, sem barra de endereço, com o ícone e o nome dele; o jogo continua sendo o do site (uma atualização publicada aqui chega na hora ao aplicativo). Para um aplicativo que funciona sem rede e sem navegador: o aplicativo Android nativo.

Você precisa de: um projeto JumPHP no seu computador (no seu computador), Docker e uma conta de desenvolvedor do Google Play (US$ 25, uma única vez). O seu Claude pode fazer tudo por você: peça a ele “coloque o meu jogo no Google Play”.

1. Gerar o aplicativo

bin/jumphp twa meu-jogo --url https://jumphp.net/meu-jogo

Na primeira vez, o comando pergunta:

• o nome do pacote do aplicativo (por exemplo io.github.eu.meu_jogo): o identificador dele na Play Store, que nunca mais muda;
• se você aceita a licença do SDK do Android do Google (ele é baixado uma vez, ~1 GB, em ~/.jumphp).

Ele cria a sua chave de envio (~/.jumphp/android/keys/, com a senha dela: faça backup e nunca as coloque no git) e depois gera em games/meu-jogo/dist/android/:

Ele exibe a impressão digital SHA-256 da sua chave. O nome sob o ícone é o nome curto do jogo (pwa: {short_name: …} no game.yaml, senão o título dele).

2. Dizer ao site que o aplicativo é seu

Sem isso, o aplicativo abre com uma barra de endereço. No Studio, na página do seu jogo, na seção Aplicativo Android: o nome do pacote e a impressão digital. O site os publica em https://jumphp.net/.well-known/assetlinks.json, que o Android verifica.

O seu Claude faz isso com update_project (android_package, android_fingerprints). No seu próprio servidor, coloque o assetlinks.json no endereço https://seu-dominio/.well-known/assetlinks.json.

3. Publicá-lo no Google Play

Todos os detalhes (chaves, testes no celular, cada declaração do Play Console, análise, versões seguintes, armadilhas): Publicando na Play Store, passo a passo. Em resumo:

1. No Play Console: Criar app, com o mesmo nome de pacote.
2. Testes internos primeiro: envie o .aab e instale-o pelo link de teste.
3. Assinatura de apps (Configuração): o Google assina o aplicativo com a própria chave dele; copie a impressão digital SHA-256 e adicione-a ao lado da sua (etapa 2); do contrário, a barra de endereço volta.
4. A ficha (capturas: bin/jumphp shot), a classificação do conteúdo e depois a produção.

As versões seguintes

O código do jogo se atualiza sozinho (é o site). Para mudar o próprio aplicativo (nome, ícone, cores):

bin/jumphp twa meu-jogo      # o número da versão sobe 1

games/meu-jogo/android/twa-manifest.json guarda o pacote, o endereço e a versão: ele vai para o git.