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.
| Termo | O que significa |
|---|---|
| Nome do pacote | O 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 .aab | Um 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. |
| Keystore | O 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ão | Um 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 testing | Um canal privado do Google Play. Só os testadores que indicar podem instalá-la, e o Google não a revisa antes. |
| Conta de serviço | Uma 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 JSON | O 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 acontece | O que fazer |
|---|---|---|
| A sua primeira compilação da Play Store mostra Failed. O registo menciona JSONKeyPath: required variable is not present | O 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ção | Transfira 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 AppPresser | Faç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 notes | As tags de idioma (Por exemplo, <en-US> e </en-US> ) estão na mesma linha que o seu texto | Coloque 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ço | O Google pode demorar para aplicar as novas permissões do Play Console, ou falta à conta de serviço uma permissão da aplicação | Aguarde (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 usado | O Google precisa de um código de versão maior a cada envio | Compile 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 Validated | Não validou desde a sua última alteração ou compilação | Clique 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 keystore | Falta o keystore | Abra 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?
Os resultados atualizam enquanto você digita. Pressione barra para ir à pesquisa.
Não encontrou?
A nossa equipa de suporte pode ajudar com configuração, builds e dúvidas sobre lojas.




























