Skip to content

Deploy do app para testes em Android na Play Store

Requisitos

Para poder fazer o deploy para o Android você tem alguns pré-requisitos mais relacionados a autorização e assinatura:

  • Ter acesso à uma conta com permissões para fazer upload de novas versões
  • Ter Android Studio instalado
  • Ter acesso à internet
  • Configurar a assinatura do app

Assinatura do app

  • Siga esse tutorial para criar uma nova: https://developer.android.com/studio/publish/app-signing?hl=pt-br
  • Se o app já tiver uma chave de upload, acredito que você tenha que usar a mesma, não tentei usar uma diferente ainda. Ela não deve ficar no repositório e você deverá pegar manualmente com o desenvolvedor (ou futuramente um servidor)
  • Conserve bem essa chave de upload

Passos

  1. Ajustar as variáveis de ambiente
  2. Ajustar a versão do app
  3. Compilar o app uma vez
  4. Abrir o Android Studio
  5. Compilar um .aab de release
  6. Faça upload do .aab
  7. Configure os testes

1. Ajustar as variáveis de ambiente

As variáveis de ambiente devem estar ajustadas para compilar corretamente. Nada em específico precisa ser mudado aqui, só garanta que estejam com os valores de produção.

2. Ajustar a versão do app

A versão do app é composta de 2 valores. A versão lógica/de visualização, que geralmente está mais atrelada a features, bugs e breaking changes. E a versão de build que literalmente deve ser diferente toda vez. Para a versão de build só incremente 1. Para a versão lógica refira ao semantic versioning ou aos líderes para decidir se muda, mantém e para qual mudar.

Você deverá mudar a versão em alguns lugares. O jeito mais fácil é pesquisar exatamente pela versão do app e alterar em todos os lugares que ela é mencionada.

Você deverá mudar a versão no package.json mudando o valor de build (incremental) e de version (semantic versioning). Após isso basta rodar o comando npm run update-version e as versões estarão atualizadas tanto para android quanto para ios.

3. Compilar o app uma vez

Para compilar recomenda-se os seguintes comandos:

  • npm run check-all para garantir que o app esteja funcionando bem e com tudo instalado corretamente
  • npm run build para compilar o código web
  • npm run preview:android para testar antes de mandar para a loja
  • npx cap sync para sincronizar o código web compilado e o projeto android (e ios)

4. Abrir o Android Studio

  1. Digite npx cap open android no terminal e rode esse comando para abrir o Android Studio direto no Workspace do app.
  2. Após isso você terá que esperar o Android Studio atualizar índices e importar o projeto. Tenha paciência, tome um cafézinho

5. Compilar um .aab de release

  1. Garanta que sua versão esteja atualizada
  2. Na barra do topo (no MacOS ela fica no topo da tela separada da janela) procure pela opção "Build", abra-a e por fim selecione "Generate Signed Bundle / APK..."
  3. Na janela que abriu selecione "Android App Bundle" e prossiga
  4. Configure sua chave de assinatura usando a sua key store anteriormente criada:
    1. Escolha o arquivo de key store em "Key store path"
    2. Coloque a senha da key store em "Key store password"
    3. Coloque o nome da chave em "Key alias"
    4. Coloque a senha da chave em "Key password"
  5. Selecione "release" e clique em "Finish"
  6. Espere o .aab ser compilado
  7. O .aab deverá ter sido criado em android/app/release/app-release.aab

6. Faça upload do .aab

  1. Faça login no Google Play Console com a conta que tem permissão para fazer o que precisa no navegador
  2. Clique em "Todos os apps" na barra lateral esquerda
  3. Clique no app desejado na lista de apps
  4. Na aba lateral esquerda, procure pela opção em "Versões" > "Teste" > "Teste interno" e clique nela
  5. No topo superior direito selecione "Criar nova versão"
  6. Na seção Pacotes de apps, arraste o arquivo .aab de release gerado
  7. Nomeie a versão se quiser, mas o nome padrão já basta
  8. Adicione notas de versão se puder, isso pode ser alterado posteriormente
  9. Clique em "Próximo"
  10. Inicie o lançamento para teste interno clicando em "Iniciar lançamento para Teste interno"

7. Configure os testes

  1. Na aba lateral esquerda, procure pela opção em "Versões" > "Teste" > "Teste interno" e clique nela
  2. Selecione "Testadores" na parte superior no seletor de abas
  3. Marque as listas de e-mail com acesso à versão
  4. Adicione novos usuários gerenciando as listas de e-mail criando, editando e etc. Confira com o Tech Lead de Mobile quaisquer convenções a seguir
  5. Para as pessoas poderem aceitar o convite de teste, você deverá passar o link disponível em "Copiar link" no fim da página em "Participar na Web"
  6. Instrua as pessoas como instalar usando esse tutorial aqui.