Pular para o conteúdo

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)

  1. Secrets no GitHub (Settings › Secrets and variables › Actions › New repository secret):

    • ANDROID_UPLOAD_KEYSTORE_B64: o conteúdo do arquivo ANDROID_UPLOAD_KEYSTORE_B64.txt;
    • ANDROID_UPLOAD_KEYSTORE_SENHA: o conteúdo de ANDROID_UPLOAD_KEYSTORE_SENHA.txt.

    A mesma chave serve os três apps. Guarde o ilarika-upload.jks e 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”.

  2. 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.

  1. 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.
  2. 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”.
  3. GitHub › Secrets › PLAY_SERVICE_ACCOUNT_JSON = o conteúdo do arquivo JSON.
  4. 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.
  5. Para mandar direto ao teste fechado (os testadores dos 14 dias), rode o workflow “Release apps” à mão com destino play, trilha alpha e status completed: a versão vai para a revisão do Google e, aprovada, chega aos testadores. Com draft, ela fica esperando você clicar em “Revisar e lançar” no Console.

Criar cada app no Play Console (uma vez por app)

  1. Criar app: nome (tabela abaixo), idioma padrão Português (Brasil), App, Gratuito.
  2. 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.
  3. 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.png a 05.png: capturas de tela do telefone.
  4. 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 deixe draft) 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.