Publicar no Google Play Store

Importante

O Visual Studio App Center foi desativado em 31 de março de 2025, com exceção dos recursos de Análise e Diagnóstico, que continuarão com suporte até 30 de junho de 2026. Saiba mais.

Publique uma atualização no Google Play Store, incluindo as faixas Alfa e Beta do App Center.

Pré-requisitos

• O Google exige que a primeira versão do aplicativo Google Play seja publicada em produção por meio do console do Google.
• Uma conta do Desenvolvedor do Google Play. Se você não tiver um, poderá se inscrever no portal da conta de desenvolvedor do Google.
• Verifique se você tem um projeto de API e uma conta de serviço do App Center para criar uma conexão da Google Store e acessar as APIs do Google em seu nome.

• Consulte Publicar seu aplicativo para obter mais informações sobre esses caminhos.
• Configure a assinatura de aplicativo pelo Google para publicar arquivos de pacotes .aab de aplicativos Android.

Para obter mais informações, examine Como usar o console do Google Play.

Vinculando seu projeto de API

Para acessar a API do Google, vincule seu Console do Google Play a um projeto de API do Google. Na maioria dos casos, recomendamos que você crie um novo projeto de API, embora os usuários atuais da API possam vincular a um projeto de API existente. Tenha em mente que cada projeto de API só pode ser vinculado a uma única conta do Google Play Console.

Criando um novo projeto de API

• Vá para a página acesso à API do Google no Console do Google Play.
• Aceite os Termos de Serviço.
• Clique em Criar novo projeto.
• Um projeto de API é gerado automaticamente e vinculado ao Console do Google Play.

Usando um projeto de API existente

• Se você já for um usuário da API de Desenvolvedor do Google Play, poderá vincular ao seu projeto de API existente seguindo estas etapas. Se o projeto de API ao qual vincular não estiver listado, verifique se sua conta do Google Play Console está designada como proprietário e se a API de Desenvolvedor do Google Play está habilitada.
• Vá para a página acesso à API do Google no Console do Google Play.
• Aceite os Termos de Serviço da API.
• Escolha o projeto que você deseja vincular.
• Clique no Link.

Configurando clientes de acesso à API

Um dos benefícios adicionais da criação de uma conta de serviço do Google é o acesso à API de um servidor de build sem fornecer suas credenciais pessoais de usuário, abaixo está um guia passo a passo sobre como configurar a conta de serviço do Google:

Vá para a página acesso à API do Google no Console do Google Play.

Em Contas de Serviço, clique no botão Criar Conta de Serviço para iniciar o processo.

Nas instruções, clique no link para o Console da API do Google.

Clique no botão CRIAR CONTA DE SERVIÇO , na página recém-aberta.

A página Criar conta de serviço é aberta.

Escolha um nome para a nova Conta de Serviço e clique em Criar.

Clique na opção Selecionar uma função no menu suspenso. Selecione Projeto e, em seguida, Proprietário. Navegue até a próxima etapa clicando em Continuar.

Observação

Alguns usuários não podem baixar o arquivo .json usando o Edge e o Internet Explorer.

Na nova página, clique em + Criar Chave (opcional) e um modal é exibido.

Selecione JSON e clique em CREATE e um arquivo com a .json extensão será baixado em seu sistema; esse arquivo será usado no App Center para estabelecer a conexão com o Google Play.

Depois de criar a conta de serviço no Console de Desenvolvedores do Google, clique em Concluído. A página acesso à API é atualizada automaticamente e sua conta de serviço será listada.

Feche a janela e a nova conta de serviço será exibida na página original. Clique no botão Conceder Acesso para concluir o processo. Na próxima seção, você aprenderá a conectar o App Center ao Google Play.

Configurar a assinatura do aplicativo pelo Google

1. Selecione seu aplicativo no Console do Desenvolvedor do Google Play
2. Selecione Assinatura do aplicativo no menu à esquerda
3. Você pode escolher entre três opções:
   1. Carregar uma chave exportada do Android Studio
   2. Exportar e carregar uma chave de um repositório de chaves Java
   3. Exportar e carregar uma chave (não usando um repositório de chaves Java)
   4. Assinatura de aplicativo pelo Google Play (Recomendado)
4. Clique em finalizar

Criar uma conexão do Google Play no App Center

1. Clique em Lojas em Distribuir no menu à esquerda.
2. No meio da página, clique no botão Conectar à Loja .
3. Selecione Google Play Store .
4. Clique em Avançar.
5. Carregue o arquivo JSON de chave privada , que você baixou ao criar a conta de serviço. Se os campos JSON forem editados para valores incorretos, a criação do repositório poderá falhar. Verifique se você tem a conta de serviço vinculada ao console do Desenvolvedor do Google Play de acordo com a seção de pré-requisitos acima.
6. Depois que o arquivo for carregado, clique em Conectar.
7. Uma conexão do Google Play agora deve estar visível com os três canais, Produção, Alfa e Beta na página inicial das Lojas. Configurar essa conexão é um processo único para um aplicativo no App Center.

Publique seu AAB na Loja Google Play

1. Na página inicial das Lojas, selecione qualquer uma das trilhas criadas acima.
2. Clique em Publicar na Loja no botão no canto superior direito.
3. Carregue o pacote do aplicativo. Alguns pontos a serem observados:
   • O aplicativo deve estar preparado para lançamento e assinado com um repositório de chaves válido antes de carregar.
   • A Google Play Store dá suporte a pacotes de aplicativos android de até um máximo de 2 GB. .apk os arquivos gerados a partir do .aab não podem exceder 150 MB. Você pode ler mais sobre suas opções nos documentos do Google para a AAB.
   • A versão do .aab deve ser estritamente maior do que a versão atual em produção.
   • Se você tiver versões de aplicativo em outras faixas, como Alpha e Beta, sua versão de lançamento deverá ser estritamente menor que as versões das faixas Alpha e Beta.
   • O App Center não dá suporte à promoção de um aplicativo de uma faixa para outra. Você não pode promover uma versão do estágio alfa para o estágio beta ou do estágio beta para o ambiente de produção.
   • Se você tiver uma versão de rascunho na faixa na qual publicará, essa versão de rascunho desaparecerá em favor da nova versão publicada.
4. Depois de carregar o pacote, você pode ver alguns detalhes do aplicativo. Clique em Próximo.
5. Clique em Publicar para enviar o aplicativo por push para a Google Play Store. O status desta versão na página de Detalhes da Distribuição da Loja será exibido como Enviado.
6. Depois que o App Center concluir a entrega do aplicativo para o Google, o status do aplicativo será alterado para Publicado. O Google pode levar até 24 horas para mostrar o aplicativo na Play Store.
7. Caso a publicação pelo Google falhe, o proprietário do aplicativo receberá uma notificação para o email registrado do Google.

Publique seu APK no Google Play

1. Na página inicial Lojas, selecione qualquer uma das faixas criadas acima.
2. Clique em Publicar na Loja no botão no canto superior direito.
3. Carregue o pacote do aplicativo. Alguns pontos a serem observados:
   • O aplicativo deve estar preparado para lançamento e assinado com um repositório de chaves válido antes de carregar.
   • A Google Play Store dá suporte a pacotes de aplicativos de até um máximo de 100 MB. Carregue arquivos de expansão diretamente no Console do Google Play se o aplicativo exceder 100 MB. Leia o documento do Google sobre arquivos de expansão para configurá-lo.
   • Deve .apk ser zipaligned durante o processo de criação do aplicativo.
   • A versão do .apk deve ser estritamente maior do que a versão atual em produção.
   • Se você tiver versões de aplicativo em outras faixas, como Alpha e Beta, sua versão de lançamento deverá ser estritamente menor que as versões em versões alfa e beta.
   • O App Center não dá suporte à promoção de um aplicativo de uma faixa para outra. Você não pode promover uma versão do estágio alfa para o estágio beta ou do estágio beta para o ambiente de produção.
   • Se você tiver uma versão de rascunho na faixa onde irá publicar, ela será substituída pela nova versão.
4. Depois de carregar o pacote, você pode ver alguns detalhes do aplicativo. Clique em Próximo.
5. Clique em Publicar para enviar o aplicativo por push para a Google Play Store. O status desta versão na página Detalhes da Loja de Distribuição será exibido como Enviado.
6. Depois que o App Center concluir a entrega do aplicativo para o Google, o status do aplicativo será alterado para Publicado. O Google pode levar até 24 horas para mostrar o aplicativo na Play Store.
7. Caso a publicação pelo Google falhe, o proprietário do aplicativo receberá uma notificação para o email registrado do Google.

Publicação por meio da CLI

Aviso

Você precisa da CLI do App Center 2.7 ou mais recente para usar esse recurso.

Usar a CLI é uma maneira fácil de integrar a conexão de repositório do App Center como parte da configuração de CI/CD, como Jenkins ou Go CI.

Antes de usar a CLI, você precisará estabelecer uma conexão com um destino, ou seja, Google Play, App Store ou Intune no App Center. E compile um binário que funcione com seu destino.

Você pode listar seus repositórios usando o comando de lista assim:

appcenter distribute stores list \
--app {app_owner}/{app_name} \
--output json

Você obterá um resultado como este:

[["Alpha","googleplay","alpha"],["Beta","googleplay","beta"],["Production","googleplay","production"]

E é a coluna "Store" que usaremos na etapa final.

A etapa final é publicar seu aplicativo executando:

appcenter distribute stores publish \
--file /path/to/file.aab \
--store Production \
--app {app_owner}/{app_name} \
--release-notes "Some note."

Você precisará preencher os espaços em branco, assim como faz o comando listar. Em vez de ter uma nota de versão estática, é possível usar o --release-notes-file em vez disso. Um arquivo de anotação de versão é um arquivo de texto sem formatação codificado com UTF-8.