End of Year Sale: 30% off your first year on annual plans. Use code AP5-30-OFF See plans

Publique a sua aplicação Android no Google Play (Passo a passo)

Publish and Grow · Docs AppPresser

Publique a sua aplicação Android no Google Play (Passo a passo)

The English version of this article has changed since it was translated, so this translation may be out of date.

Para que serve

Este artigo é o caminho “Faça o próprio utilizador” Para Android. Ele leva a sua aplicação do AppPresser de “Compila bem” A “Instalado pelos testadores a partir do Google Play”, e depois configura tudo para que cada nova compilação da Play Store seja enviada sozinha ao Google Play.

Na primeira vez leva cerca de 45 minutos. A maior parte é clicar nos ecrãs do Google.

Ao terminar, terá:

  • Um backup do keystore (o ficheiro de assinatura) da sua aplicação e das suas credenciais, guardado em um lugar seguro.
  • A a sua aplicação criado no Google Play Console.
  • A sua primeira compilação enviada para Internal testing (um canal de testes privado para até 100 testadores).
  • Uma Conta de serviço do Google com uma Chave JSON, com permissão para enviar compilações de teste para este aplicação.
  • O AppPresser configurado para enviar automaticamente cada nova compilação da Play Store para Internal testing.

Termos que verá

Swipe sideways to see the rest of this table.

TermoO que significa
Nome do pacoteO ID exclusivo da sua aplicação no Google Play, em formato de domínio invertido, por exemplo com.example.myapp. No AppPresser, é o Bundle ID (Ou Android Bundle ID) em Metadata. Ele não pode ser alterado depois que a sua primeira compilação for enviada.
Ficheiro .aabUm Android Aplicação Bundle. É o ficheiro que o Google Play pede para uma versão. A compilação da Play Store do AppPresser o cria para si.
KeystoreO ficheiro que assina a sua aplicação. O Google o usa para verificar se cada atualização vem realmente de si. O AppPresser cria um para si.
Código de versãoUm número que o Google usa para diferenciar as compilações. Cada envio precisa de um maior que o anterior. O AppPresser o gerencia com o Build Number.
Internal testingUm canal privado do Google Play. Só os testadores que indicar podem instalá-la, e o Google não a revisa antes.
Conta de serviçoUma conta do Google “Robô” Que o AppPresser usa para enviar compilações por você. Ela tem um endereço de e-mail, mas não tem palavra-passe.
Chave JSONO ficheiro que permite ao AppPresser fazer login como a conta de serviço. Trate-o como uma palavra-passe.

Antes de começar

Tenha isto pronto:

1. Uma conta de desenvolvedor do Google Play. Registe-se em play.google.com/console. O Google cobra uma taxa de registo única de US$ 25, que paga ao Google. As contas novas também precisam de uma verificação de identidade, que pode levar alguns dias. Consulte o guia google-01 para mais detalhes.

2. A a sua aplicação do AppPresser, com o Android configurado. Na página Builds , o cartão Android deve conseguir ser validado. O AppPresser cria o seu keystore na primeira vez que valida (o passo 1 mostra onde ele fica).

3. O nome do seu pacote. No AppPresser, abra Metadata e confira o Bundle ID (ou Android Bundle ID). O nome da aplicação e o nome do pacote que usar no Play Console devem coincidir exatamente.

4. Uma conta do Google que possa usar o Google Cloud. Use a mesma conta do Google proprietária da sua conta de desenvolvedor do Play, ou uma que seja administradora dela.

5. Um gerenciador de palavras-passe, para guardar as credenciais do keystore e a chave JSON.

Passo 1: Faça um backup do seu keystore

O seu keystore é o que assina cada versão da sua aplicação. Guarde uma cópia, porque vai precisar dela se algum dia transferir a sua aplicação ou precisar de ajuda do Google.

1. No AppPresser, abra Builds.

2. No cartão Android , clique em Signing & keystore (ou role até Repair Utilities > Android signing & keystore).

3. O botão Android App Signing Setup a janela deve indicar Keystore configured.

4. Clique em Download Keystore e guarde o ficheiro.

5. Clique em Download Credentials (.txt) e guarde também esse ficheiro. Ele contém o alias e as palavras-passe do keystore.


6. Guarde os dois ficheiros no seu gerenciador de palavras-passe (Ou em outro lugar seguro e privado). Nunca os envie por e-mail nem os publique em lugar nenhum.

Por que isso importa: se perder o keystore, não poderá assinar atualizações com ele. O Google Play Aplicação Signing (ativado por padrão para as aplicações novos) mantém a cópia do próprio Google da chave de assinatura da sua aplicação, então pode pedir ao suporte do Google que redefina a sua chave de carregamento, mas isso leva tempo. Um backup guardado evita tudo isso.

Passo 2: Crie a sua aplicação no Google Play Console

1. Faça login no Google Play Console (play.google.com/console) e clique em Create app.

2. Preencha o formulário:

  • Nome da aplicação: o nome da sua aplicação como ele será exibido no Google Play (por exemplo, My Example Aplicação). pode alterá-lo depois.
  • Nome do pacote: o nome do seu pacote no AppPresser, por exemplo com.example.myapp. O Google o verifica e mostra Package name available.
  • Idioma padrão: por exemplo English (United States), en-US.
  • Aplicação ou jogo: Aplicação.
  • Gratuito ou pago: Free (Ou Paid, se pretende cobrar). Depois que uma aplicação gratuito é publicado, ele não pode ser alterado para pago.

3. Role até Declarations e marque as duas caixas: Developer Program Policies e US export laws.

4. Clique em Create app. chegará à página Dashboard.

5. No menu à esquerda, abra Test and release > Testing > Internal testing. Por enquanto, indica No releases . Deixe esta aba aberta; voltará a ela no passo 5.

Passo 3: Execute a sua primeira compilação da Play Store

O Google exige que a sua primeira compilação seja enviada manualmente. A compilação da Play Store do AppPresser cria o ficheiro de que precisa.

1. No AppPresser, abra Builds. Confira Release Details (Aplicação Version, por exemplo 1.0.0) e clique em Save Release Details se alterou algo.

2. Na página Android , clique em Validate Setup.

3. Quando as linhas mostrarem Ready, clique em Build na página Play Store Build . O botão muda para Building e a página indica Build started. Follow its progress below.

4. Aguarde a compilação terminar (Cerca de 3 a 5 minutos). Observe Recent Builds And Logs mais abaixo na página.

É esperado que esta primeira compilação mostre Failed. O AppPresser cria e assina o seu .aab e depois tenta enviá-lo ao Google Play. Essa última parte ainda não pode funcionar, porque o Google só aceita envios automáticos depois do primeiro manual, e ainda não criou a chave do Google (Passos 6 a 9). O seu .aab é criado mesmo assim.

Passo 4: Transfira o seu ficheiro .aab

1. Em Recent Builds And Logs, procure a compilação da Play Store que acabou de executar (fluxo capacitor-android-play-store, status Failed).

2. Na coluna Download/Install , clique em app-release-bitrise-signed.aab e guarde o ficheiro. Este é o ficheiro assinado que o Google pede.

(Na captura, a compilação 9 é a primeira, que falhou, com o link para o .aab. A compilação 10 é a posterior, bem-sucedida, do passo 11.)

Passo 5: Envie manualmente a sua primeira compilação para Internal testing

1. De volta ao Play Console, abra Test and release > Testing > Internal testing e clique em Create new release.

2. Se o Google perguntar sobre Play App Signing, mantenha a opção recomendada pelo Google (o Google gerencia a chave de assinatura da sua aplicação). Para as aplicações novos, nenhuma pergunta aparece, porque eles a usam por padrão.

3. Em App bundles, clique em Upload e escolha o ficheiro app-release-bitrise-signed.aab do passo 4. Ao terminar, verá uma linha com a versão (por exemplo, 9 (1.0.0)), os níveis de API 24+ e o SDK de destino 36.

4. Release name é preenchido sozinho (por exemplo, 9 (1.0.0)). pode deixá-lo assim.

5. Em Release notes, substitua o texto de exemplo entre as tags de idioma. Coloque cada tag na sua própria linha, assim:

<en-US>
First internal test build.
</en-US>

Se colocar tudo em uma única linha, o Google mostra um erro.

6. Clique em Next. O Google mostra Errors, warnings and messages. Dois avisos são normais em uma primeira compilação de teste:

  • Ainda não há testadores. Os adicionará no passo 12.
  • Não há ficheiro de desofuscação. Isso afeta apenas a legibilidade dos relatórios de falhas. Pode ignorá-lo.

7. Clique em Save and publishe depois Save and publish novamente na janela Publish change on Google Play? .

8. A versão agora mostra Available to internal testers. Ela chega apenas aos seus testadores internos, não ao público.

Passo 6: Crie um projeto do Google Cloud e ative a API do Google Play

Os próximos passos criam a conta “Robô” Que o AppPresser usa para enviar compilações futuras. O Google Cloud não cobra nada por isso, e não precisa adicionar uma conta de faturamento.

1. Aceda a console.cloud.google.com e faça login com a conta do Google de “Antes de começar”. O Google pode pedir que digite a sua palavra-passe novamente.

2. Clique no seletor de projetos na parte superior e depois em New project.

3. Dê a ele um nome claro, por exemplo myapp-play-uploads. Deixe a organização e o local como estão, e clique em Create. Depois, confirme que o novo projeto está selecionado no topo da página.

4. Procure Google Play Android Developer API (ou abra APIs & Services > Library e procure lá). Abra-a e clique em Enable.

5. A página da API agora mostra Status: Enabled.

Passo 7: Crie a conta de serviço e a chave JSON dela

1. No menu à esquerda, abra IAM & Admin > Service Accounts e clique em Create service account.

2. Dê a ela um nome que reconheça, por exemplo play-uploads, e uma descrição opcional como “Play uploads from AppPresser”. Clique em Create and continue.

3. Don't give it any roles no Google Cloud. Pule os passos opcionais e clique em Done. (As permissões dela vêm do Play Console no passo 8.)

4. A sua nova conta de serviço aparece na lista com um endereço de e-mail que termina em .iam.gserviceaccount.com. Copie esse e-mail; vai precisar dele no passo 8.

5. Clique no e-mail da conta de serviço, abra a aba Keys e clique em Add key > Create new key.

6. Escolha JSON e clique em Create. O Google baixa um ficheiro .json no seu computador e mostra Private key saved to your computer.

7. Guarde o ficheiro .json no seu gerenciador de palavras-passe ou em outro lugar privado. O Google não pode mostrá-la novamente. Nunca o envie por e-mail nem o coloque em uma pasta compartilhada. Ele-se vazar, exclua essa chave na mesma aba Keys e crie uma nova.

Passo 8: Dê acesso à conta de serviço no Play Console

1. No Play Console, aceda a Users and permissions (na página principal do Play Console, em Manage account) e clique em Invite new users.

2. Em Email address, cole o e-mail da conta de serviço do passo 7.

3. Na página App permissions , clique em Add app, escolha a sua aplicação (por exemplo, My Example Aplicação) e clique em Apply.

4. Na coluna Permissions for , marque apenas estas:

  • View app information (read-only)
  • Release apps to testing tracks
  • Manage testing tracks and edit tester lists

O Google adiciona View app quality information sozinho. Deixe Release to production, Admin e todas as caixas Financial data desmarcadas. Assim, o AppPresser só pode enviar compilações para testes, nunca para a loja pública.

5. Clique em Applye depois Invite usere depois Send invite. A conta de serviço não precisa aceitar nada.

6. Verá Invite sent, e a conta de serviço aparece na sua lista Users.

Passo 9: Envie a chave JSON no AppPresser

1. No AppPresser, abra Builds e role até Repair Utilities.

2. Em Android, clique em Google Play deployment. A janela Google Play Service Account abre e indica que nenhum ficheiro foi enviado ainda.

3. Clique em Choose File e escolha a chave .json do passo 7.

4. Clique em Upload Service Account File. verá Google Play API key uploaded successfully e uma Last uploaded .

Passo 10: Valide a sua configuração do Android

1. Role novamente até o cartão Android e clique em Validate Setup (ou Re-Validate).

2. As três linhas devem mostrar Ready: Debug Build, Ad Hoc Build e Play Store Build, com a mensagem Validation looks good for these builds.

Passo 11: Compile novamente (Desta vez o envio é automático)

1. Clique em Build na página Play Store Build . O botão mostra Building e a página indica Build started.

2. Aguarde cerca de 5 minutos. Em Recent Builds And Logs, a nova compilação mostra Completed.

3. No Play Console, abra Test and release > Testing > Internal testing. A nova versão mostra Available to internal testers, com um código de versão maior que o do seu primeiro envio.

De agora em diante, cada compilação da Play Store que executar no AppPresser vai sozinha para Internal testing. Lembre-se de aumentar a Aplicação Version em Release Details quando publicar algo novo para os seus utilizadores.

Passo 12: Adicione os seus testadores

Os testadores precisam de um telemóvel ou tablet Android e de uma conta do Google.

1. No Play Console, abra Test and release > Testing > Internal testing e clique na aba Testers .

2. Clique em Create email list. Dê a ela um nome (por exemplo, “Team”), adicione os e-mails das contas do Google dos seus testadores (até 100) e clique em Save changes.

3. Confirme que a sua nova lista está marcada e depois clique em Save.

4. Em How testers join your test, clique em Copy link e envie esse link aos seus testadores.

5. Cada testador abre o link no dispositivo Android com login no e-mail que adicionou, toca em Accepte depois instala a aplicação a partir do Google Play.

E se algo der errado?

Swipe sideways to see the rest of this table.

O que vêPor que aconteceO que fazer
A sua primeira compilação da Play Store mostra Failed. O registo menciona JSONKeyPath: required variable is not presentO AppPresser criou o seu .aab, mas não conseguiu enviá-lo ao Google Play, porque nenhuma chave do Google Play foi enviada ainda. Isso é esperado na primeira compilaçãoTransfira o .aab em Recent Builds (Passo 4), envie-o manualmente (Passo 5), depois crie e envie a chave (Passos 6 a 9) e compile novamente
Uma compilação da Play Store falha no envio ao Google Play com Package not found (seguido do nome do seu pacote)O Google ainda não conhece a sua aplicação. Ou nada foi enviado manualmente, ou o nome do pacote no Play Console não coincide com o AppPresserFaça o primeiro envio manualmente (Passos 3 a 5). Confira se o nome do pacote no Play Console coincide exatamente com o Bundle ID em Metadata do AppPresser
O Play Console rejeita o seu Release notesAs tags de idioma (Por exemplo, <en-US>  e </en-US> ) estão na mesma linha que o seu textoColoque a tag de abertura, as suas notas e a tag de fechamento em três linhas separadas (Passo 5)
O envio falha com uma mensagem de permissões como The caller does not have permission, logo depois de convidar a conta de serviçoO Google pode demorar para aplicar as novas permissões do Play Console, ou falta à conta de serviço uma permissão da aplicaçãoAguarde (Pode levar até um dia; para nós, levou cerca de 10 minutos) e compile novamente. Revise o passo 8: A conta de serviço deve ter Release apps to testing tracks para este aplicação, e o e-mail dela deve coincidir com a chave JSON que enviou
Uma compilação da Play Store falha no envio com um código de versão que já foi usadoO Google precisa de um código de versão maior a cada envioCompile novamente para que o AppPresser use um número novo, e não reenvie um .aab antigo
O botão Play Store Build a linha indica Not ValidatedNão validou desde a sua última alteração ou compilaçãoClique em Validate Setup (ou Re-Validate) no cartão do Android e aguarde aparecer Ready antes de clicar em Build
A validação pede que configure a assinatura, ou aparece um erro do keystoreFalta o keystoreAbra Signing & keystore. Para uma aplicação novo, deixe o AppPresser criar um. Se a sua aplicação já está no Google Play, use I have a keystore e envie o que usava antes

Isto foi útil?

Não encontrou?

A nossa equipa de suporte pode ajudar com configuração, builds e dúvidas sobre lojas.