Para equipe ilarika
Publicar os apps na Google Play
- GitHubSettingsSecrets and variablesActions
- GitHubActionsrelease-appsRun workflow (destino play)
- Google Play Console
Os três apps (iLarika Equipe, iLarika Entregadores e iLarika) vão para a Play como .aab (Android App Bundle) assinado com a chave de envio (upload key). A Play guarda a chave do app (Play App Signing) e reassina o que vai para os celulares.
Por enquanto só o iLarika Equipe e o iLarika (cliente) vão para a Play (decisão de 02/11/2026). O iLarika Entregadores segue no APK de link direto: a localização com o app fechado pede declaração e vídeo na Play. No Equipe, o entregador da casa manda a posição só com o app aberto na tela; o rastreio com a tela bloqueada entra numa versão seguinte, com a declaração de localização em segundo plano.
O APK de teste com link direto continua existindo (destino apk, o padrão). Os dois
usam o mesmo id (br.com.ilarika.<app>), mas assinaturas diferentes: quem instalou o
APK direto precisa desinstalar antes de instalar pela Play.
Antes de começar (uma vez)
-
Secrets no GitHub (Settings › Secrets and variables › Actions › New repository secret):
ANDROID_UPLOAD_KEYSTORE_B64: o conteúdo do arquivoANDROID_UPLOAD_KEYSTORE_B64.txt;ANDROID_UPLOAD_KEYSTORE_SENHA: o conteúdo deANDROID_UPLOAD_KEYSTORE_SENHA.txt.
A mesma chave serve os três apps. Guarde o
ilarika-upload.jkse a senha fora do GitHub (o secret não se lê de volta). Perdeu? No Play Console, Configuração › Integridade do app › Assinatura do app › “Solicitar redefinição da chave de upload”. -
Conta de desenvolvedor pessoal (criada depois de nov/2023): a Play só libera produção depois de um teste fechado com pelo menos 12 testadores, por 14 dias seguidos. Conta de organização não tem essa regra.
Gerar o .aab (e mandar para a Play)
Igual ao iPhone com o [ios], por qualquer um destes caminhos:
| Como | O que sai |
|---|---|
[play] sozinho numa linha da mensagem do commit (ou [play:equipe]) |
.aab dos apps da Play |
[build] sozinho numa linha |
APK dos três + .aab dos apps da Play + TestFlight |
tag equipe-vX.Y.Z / marketplace-vX.Y.Z |
.aab do app da tag + TestFlight |
GitHub › Actions › release-apps › Run workflow, Android = play |
.aab dos apps escolhidos |
“Apps da Play” são os com naGooglePlay: true em packages/mobile-config/apps.json
(hoje Equipe e iLarika). O Entregadores recusa [play:entregadores] e o destino play.
O run confere que o .aab está assinado e sem a permissão de instalar APK (proibida
na Play), deixa o arquivo nos artefatos do run (ilarika-<app>-<versão>-build<N>-play,
90 dias) e, com a conta de serviço (abaixo), sobe sozinho para o teste interno. O
número do build (versionCode) é o número do run: sempre sobe. Sem os secrets da chave,
o passo da Play é pulado com um aviso (o APK e o iOS seguem).
Envio automático para a Play (uma vez)
A Play só aceita envio pela API depois que o app recebeu o 1º .aab à mão no Console.
- Google Cloud Console (mesma conta Google): criar um projeto (ex.:
ilarika-play), ativar a Google Play Android Developer API, criar uma conta de serviço e uma chave JSON para ela. - Play Console › Usuários e permissões › Convidar novos usuários: o e-mail da conta de serviço, com acesso aos dois apps e as permissões “Lançar apps para trilhas de teste” e “Gerenciar trilhas de teste e editar listas de testadores”.
- GitHub › Secrets ›
PLAY_SERVICE_ACCOUNT_JSON= o conteúdo do arquivo JSON. - Enquanto o app nunca foi publicado, a Play só aceita rascunho (padrão). Depois da
1ª publicação no teste interno, crie a variável do repositório
PLAY_STATUS=completed(Settings › Secrets and variables › Actions › Variables): a partir daí cada envio chega na hora aos testadores internos. - Para mandar direto ao teste fechado (os testadores dos 14 dias), rode o workflow
“Release apps” à mão com destino
play, trilhaalphae statuscompleted: a versão vai para a revisão do Google e, aprovada, chega aos testadores. Comdraft, ela fica esperando você clicar em “Revisar e lançar” no Console.
Criar cada app no Play Console (uma vez por app)
- Criar app: nome (tabela abaixo), idioma padrão Português (Brasil), App, Gratuito.
- Testar e lançar › Teste interno › Criar versão: aceite a assinatura pela Google (Play App Signing), envie o .aab do artefato e salve. O 1º envio é sempre à mão.
- Ficha da loja (Aumentar o público › Presença na loja › Ficha principal): textos e
imagens de
docs/apps/ficha-da-play/<app>/:textos.json: título, descrição curta, descrição completa;icone-512.png: ícone do app;grafico-de-destaque.png: gráfico de recurso (1024 × 500);capturas/01.pnga05.png: capturas de tela do telefone.
- Conteúdo do app (Política › Conteúdo do app), um por um:
| Item | Resposta |
|---|---|
| Política de privacidade | https://ilarika.com.br/legal/privacidade-plataforma |
| Acesso ao app | Algumas funcionalidades restritas: login e senha da conta de demonstração da loja Pizza Code (a mesma da revisão da Apple) e o texto instrucoesDeAcesso do textos.json |
| Anúncios | Não tem anúncios |
| Classificação do conteúdo | Categoria “Todos os outros tipos de app”. Violência, sexo, linguagem, drogas, jogos de azar: não em tudo. Interação entre usuários: Equipe sim (conversa com o cliente pelo WhatsApp), iLarika não. Compartilha a localização atual com outros usuários: Equipe sim (entregador da casa com o cliente do pedido), iLarika não. Compra de bens digitais: não |
| Público-alvo | 18 anos ou mais; o app não é voltado para crianças |
| Recursos financeiros | Nenhum (o pagamento do pedido é de bem físico, fora da Play) |
| Segurança dos dados | Ver a seção abaixo |
| Exclusão de conta | https://ajuda.ilarika.com.br/excluir-minha-conta/ |
| App governamental, saúde, notícias, VPN | Não |
| Permissões de serviço em primeiro plano (só Entregadores, depois) | Localização: “a corrida em andamento compartilha a posição com a loja e o cliente”. Pede vídeo curto (iniciar corrida, bloquear a tela, notificação fixa aparecendo) |
| Localização em segundo plano (só Entregadores, depois) | Mesma justificativa e o mesmo vídeo; o texto da tela de divulgação está em packages/mobile-config/apps.json (corrida.divulgacao) |
Segurança dos dados
Perguntas gerais (os dois apps): coleta ou compartilha dados: sim; criptografados em
trânsito: sim; a pessoa pode pedir a exclusão: sim
(https://ajuda.ilarika.com.br/excluir-minha-conta/). Para cada tipo, marque
“coletado”, o “compartilhado” da tabela, finalidade “Funcionalidade do app” (relatório de
erro: “Análise”), “processado de forma efêmera”: não, e “obrigatório/opcional” como
abaixo. Fonte: privacidade/data-safety.<app>.csv, gerado de dados-coletados.md.
| Tipo de dado na Play | Equipe | iLarika (cliente) |
|---|---|---|
| Informações pessoais › Nome | obrigatório | obrigatório |
| Informações pessoais › Endereço de e-mail | obrigatório | obrigatório |
| Informações pessoais › Número de telefone | — | obrigatório, compartilhado (loja do pedido) |
| Informações pessoais › Endereço | — | obrigatório, compartilhado (loja e entregador) |
| Local › Local exato | opcional, compartilhado (cliente do pedido) | opcional, não compartilhado |
| Informações financeiras › Histórico de compras | — | obrigatório, compartilhado (loja do pedido) |
| Mensagens › Outras mensagens no app | opcional | — |
| Áudio › Gravações de voz ou som | opcional | — |
| Informações e desempenho do app › Registros de falhas | obrigatório, compartilhado (Sentry) | obrigatório, compartilhado (Sentry) |
| IDs do dispositivo ou outros | opcional, compartilhado (Google, para a notificação) | opcional, compartilhado (Google, para a notificação) |
Os apps
| App | Nome na Play | Categoria | Id |
|---|---|---|---|
| Equipe | iLarika Equipe | Empresas | br.com.ilarika.equipe |
| Entregadores (depois) | iLarika Entregadores | Empresas | br.com.ilarika.entregadores |
| Cliente | iLarika | Comer e beber | br.com.ilarika.marketplace |
Daí em diante
- Mudança só de tela, texto ou regra (o web): nada a fazer. Os apps instalados pela
Play se atualizam sozinhos a cada deploy, sem passar pela loja
(
atualizacao-automatica.md), igual ao iPhone. - Mudança nativa (permissão, plugin, ícone, versão da casca):
[play]no commit (ou tag). O .aab novo chega ao teste interno sozinho; para produção, no Play Console › Teste interno › Promover versão › Produção. - Refazer as imagens da ficha depois de mudar as capturas da App Store:
node docs/apps/ficha-da-play/gerar.cjs.
Se der errado
- Aviso “Sem os secrets ANDROID_UPLOAD_KEYSTORE_B64…”: cadastre os dois secrets acima.
- Envio recusado: “Only releases with status draft may be created on draft app”: o
app ainda não foi publicado em nenhuma trilha; apague a variável
PLAY_STATUS(ou deixedraft) até a 1ª publicação. - Envio recusado: “Package not found”: o 1º .aab ainda não foi enviado à mão, ou a conta de serviço não tem acesso ao app (Usuários e permissões).
- Play recusa: “assinado com a chave errada”: o 1º envio definiu a chave de envio.
Confira se o secret é o mesmo
ilarika-upload.jks; se perdeu, peça a redefinição. - Play recusa: “código de versão já usado”: rode o workflow de novo (o número sobe).
- Não instala pela Play num celular de teste: desinstale o APK de link direto antes.
