Partilhar via

Publicar um aplicativo Android para distribuição do Google Play

A abordagem mais comum para distribuir aplicativos Android para os usuários é através do Google Play. A primeira vez que um aplicativo é enviado para o Google Play, ele deve ser enviado por meio do Google Play Console. As versões subsequentes do aplicativo podem ser enviadas por meio do Visual Studio. Em ambos os casos, é necessária uma conta de programador do Google Play. As aplicações enviadas para o Google Play requerem a aprovação da Google.

Para distribuir um aplicativo .NET Multi-platform App UI (.NET MAUI) Android, você precisará assiná-lo com uma chave do seu keystore antes de fazer o upload para o Google Play. Keystores são arquivos binários que servem como repositórios de certificados e chaves privadas.

O Google Play exige que você envie seu aplicativo como um Android App Bundle (AAB). O Google Play usa seu pacote de aplicativos para gerar e fornecer pacotes Android otimizados (APK) para cada configuração de dispositivo, para que apenas o código e os recursos necessários para um dispositivo específico sejam baixados para executar seu aplicativo. Para obter mais informações sobre Android App Bundles, consulte Sobre Android App Bundles no developer.android.com.

O processo para distribuir um aplicativo .NET MAUI Android através do Google Play é o seguinte:

  1. Crie uma conta de desenvolvedor do Google Play. Para obter mais informações, consulte Criar uma conta de desenvolvedor do Google Play.
  2. Crie seu aplicativo no Google Play Console. Para obter mais informações, consulte Criar seu aplicativo no Google Play Console.
  3. Configure seu aplicativo no Google Play Console. Para obter mais informações, consulte Configurar seu aplicativo no Google Play Console.
  4. Verifique se seu aplicativo usa o formato de pacote correto. Para obter mais informações, consulte Garantir o formato correto do pacote.
  5. Crie e assine seu aplicativo no Visual Studio e distribua-o pelo Google Play Console. Para obter mais informações, consulte Distribuir seu aplicativo por meio do Google Play Console.

Em seguida, as versões subsequentes do seu aplicativo podem ser publicadas por meio do Visual Studio. Para obter mais informações, consulte Distribuir seu aplicativo por meio do Visual Studio.

Criar uma conta de programador do Google Play

Para publicar aplicações Android no Google Play, terá de criar uma conta de programador do Google Play:

  1. Usando sua Conta do Google, inscreva-se em uma conta de desenvolvedor do Google Play .
  2. Insira informações sobre sua identidade de desenvolvedor.
  3. Durante o processo de inscrição, terá de analisar e aceitar o Contrato de Distribuição para Programadores do Google Play.
  4. Pague a taxa de inscrição única de $25.
  5. Verifique a sua identidade seguindo as instruções no seu e-mail de verificação.

Importante

A verificação de identidade tem de estar concluída antes de poder publicar aplicações através do Google Play. Além disso, os novos titulares de contas pessoais terão de verificar se têm acesso a um dispositivo Android real. Para obter mais informações, consulte Requisitos de verificação de dispositivo para novas contas de desenvolvedor no support.google.com.

Assim que a sua conta de programador do Google Play tiver sido criada, poderá iniciar o processo de publicação de uma aplicação no Google Play.

Para obter mais informações, consulte Registe-se para uma conta de programador do Google Play no support.google.com.

Crie seu aplicativo no Google Play Console

Depois de criar sua conta de desenvolvedor do Google Play, você precisará criar um aplicativo no Google Play Console:

  1. Inicie sessão na sua conta de programador do Google Play .

  2. No Google Play Console , na guia Todos os aplicativos, selecione o botão Criar aplicação:

    Captura de ecrã da página de todas as aplicações no Google Play.

  3. Na página Criar aplicação, insira os detalhes da aplicação e selecione o botão Criar aplicação.

    Captura de ecrã a mostrar a criação de uma nova aplicação no Google Play.

Para obter mais informações sobre como criar uma aplicação no Google Play Console, consulte Criar e configurar a sua aplicação no support.google.com.

Configurar seu aplicativo no Google Play Console

Depois de criar seu aplicativo, você deve configurá-lo. O painel do seu aplicativo irá guiá-lo através de todas as etapas mais importantes.

Para começar a configurar o seu aplicativo, selecione Painel no menu à esquerda. Nos detalhes do seu aplicativo, na parte superior da página, você encontrará diferentes categorias e tarefas relacionadas à configuração e lançamento do aplicativo. Tem de concluir as tarefas obrigatórias antes de poder iniciar a sua aplicação no Google Play. Ao concluíres uma tarefa, verás um sinal de visto verde e um texto riscado. A barra de progresso na parte superior da seção também será atualizada. Para obter mais informações, consulte Configurar seu aplicativo no painel do aplicativo no support.google.com.

Garantir o formato correto do pacote

Para publicar um aplicativo .NET MAUI Android para distribuição do Google Play, é necessário que o formato do pacote do aplicativo seja AAB, que é o formato de pacote padrão para compilações de versão. Para verificar se o formato de pacote do seu aplicativo está definido corretamente:

  1. No Gerenciador de Soluções do Visual Studio clique com o botão direito do mouse em seu projeto de aplicativo .NET MAUI e selecione Propriedades. Em seguida, navegue para o separador Opções > do Android e certifique-se de que o valor do campo Release está definido como bundle:

    Captura de tela da alteração do formato de pacote de um aplicativo .NET MAUI Android para APK. Publicar

Distribuir a sua aplicação através da Google Play Console

A primeira vez que um AAB é enviado para o Google Play, ele deve ser carregado manualmente através do Google Play Console. Isso permite que o Google Play faça corresponder a assinatura da chave em todos os pacotes futuros à chave original usada para a primeira versão do aplicativo. Para carregar o aplicativo por meio do Google Play Console, ele deve primeiro ser criado e assinado no Visual Studio.

Para criar e assinar seu aplicativo no Visual Studio:

  1. Na barra de ferramentas do Visual Studio, use a lista suspensa Debug Target para selecionar Emuladores Android e, em seguida, o emulador da sua escolha:

    Selecione um destino de implantação do Android no Visual Studio.

  2. Na barra de ferramentas do Visual Studio, use a lista suspensa Solutions Configuration para alterar da configuração de depuração para a configuração de versão:

    Selecione a configuração de versão no Visual Studio.

  3. No Gerenciador de Soluções, clique com o botão direito do mouse em seu projeto de aplicativo .NET MAUI e selecione Publicar...:

    Selecione o item de menu de publicação no Visual Studio.

    O Archive Manager será aberto e o Visual Studio começará a arquivar o seu pacote de aplicações:

    Captura de tela do gerenciador de arquivos no Visual Studio.

  4. No Archive Manager, assim que o arquivamento for concluído com êxito, verifique se o seu arquivo está selecionado e, em seguida, selecione o botão Distribuir ... para iniciar o processo de distribuição da sua aplicação.

    Captura de ecrã do gestor de arquivo no Visual Studio uma vez que o arquivamento esteja concluído.

    A caixa de diálogo Distribuir - Selecionar Canal será exibida.

  1. Na caixa de diálogo Distribuir - Selecionar Canal, selecione o botão Ad Hoc:

    Captura de tela mostrando a seleção de um canal de distribuição na caixa de diálogo de distribuição.

  2. Na janela de diálogo Distribuir - Identidade de Assinatura Digital, selecione o botão + para criar uma nova identidade de assinatura digital:

    Captura de tela da criação de uma nova identidade de assinatura na caixa de diálogo de distribuição.

    A caixa de diálogo Criar o Keystore Android aparecerá.

    Observação

    Como alternativa, uma identidade de assinatura existente pode ser utilizada selecionando o botão Importar.

  3. Na caixa de diálogo Criar Keystore Android, insira as informações necessárias para criar uma nova identidade de assinatura, conhecida como keystore, e em seguida, selecione o botão Criar:

    • Pseudônimo. Introduza um nome de identificação para a sua chave.
    • Senha. Crie e confirme uma palavra-passe segura para a sua chave.
    • Validade. Defina o período de tempo, em anos, em que a sua chave será válida.
    • Nome completo, unidade organizacional, organização, cidade ou localidade, estado ou província e código do país. Essas informações não são exibidas em seu aplicativo, mas são incluídas em seu certificado.

    Captura de tela da criação de um keystore Android.

    Um novo keystore, que contém um novo certificado, será guardado em C:\Users{Username}\AppData\Local\Xamarin\Mono for Android\Keystore{Alias}{Alias}.keystore.

    Importante

    O armazenamento de chaves e a senha não são salvos em sua solução do Visual Studio. Portanto, certifique-se de fazer backup desses dados. Se o perderes, não conseguirás assinar a tua aplicação com a mesma identidade de assinatura.

  4. Na caixa de diálogo Distribute - Signing Identity, selecione sua identidade de assinatura recém-criada e selecione o botão Salvar como:

    Captura de ecrã a mostrar a publicação da sua aplicação para distribuição ad-hoc.

    O Archive Manager exibe o processo de publicação.

  5. Na caixa de diálogo Salvar como, confirme se o local e o nome do arquivo do pacote estão corretos e selecione o botão Salvar.

  6. Na caixa de diálogo Senha de assinatura, digite sua senha de identidade de assinatura e selecione o botão OK:

    Captura de ecrã a mostrar a introdução da palavra-passe da sua assinatura digital.

  7. No Archive Manager, selecione o botão Open Distribution assim que o processo de publicação for concluído.

    Captura de ecrã da abertura da pasta que contém a sua aplicação Android publicada.

    O Visual Studio abrirá a pasta que contém o aplicativo publicado.

A aplicação publicada pode então ser disponibilizada para o Google Play através da Google Play Console. Para fazer isso, você deve primeiro criar uma versão no Google Play Console. Uma versão é uma combinação de uma ou mais versões de aplicativos que você preparará para iniciar um aplicativo ou implementar uma atualização. Você pode criar um lançamento nas seguintes faixas:

  • Testes internos. As versões de testes internos estão disponíveis para até 100 testadores que você pode escolher.
  • Testes restritos. As versões de teste fechadas estão disponíveis para um número limitado de testadores que você escolher, que podem testar uma versão de pré-lançamento do seu aplicativo e enviar comentários.
  • Testes abertos. As versões de teste abertas estão disponíveis para testadores no Google Play. Os utilizadores podem participar em testes a partir da sua página da loja.
  • Produção. As versões de produção estão disponíveis para todos os utilizadores do Google Play nos países escolhidos.

Para obter mais informações sobre como criar uma versão no Google Play Console, consulte Preparar e implantar uma versão no support.google.com.

Importante

Os aplicativos enviados para o Google Play normalmente passam por um processo de revisão. Para obter mais informações, consulte Preparar seu aplicativo para revisão e Publicar seu aplicativo no support.google.com.

Distribuir seu aplicativo por meio do Visual Studio

Um AAB já deve ter sido enviado ao Google Play e ter passado pela revisão antes de poder distribuí-lo do Visual Studio. Se você tentar distribuir um AAB do Visual Studio que não tenha sido carregado primeiro do Play Console, receberá o seguinte erro:

O Google Play requer que você faça o upload manual do seu primeiro pacote (APK/AAB) para este aplicativo. Você pode usar um pacote ad-hoc para isso.

Quando este erro ocorre, carregue manualmente um AAB através da Google Play Console. As versões subsequentes do aplicativo podem ser publicadas por meio do Visual Studio. No entanto, você deve alterar o código de versão do aplicativo para cada upload, caso contrário, ocorrerá o seguinte erro:

Já foi carregado um AAB com o código de versão (1).

Para resolver esse erro, recrie o aplicativo com um número de versão diferente e, em seguida, reenvie-o para o Google Play via Visual Studio.

Observação

O número da versão do aplicativo pode ser atualizado aumentando o valor da propriedade inteira ApplicationVersion no arquivo de projeto do aplicativo.

Carregar seu aplicativo do Visual Studio para o Google Play primeiro requer que você configure o acesso à API no Google Play Console.

Ativar o acesso à API do Google

A API de publicação para desenvolvedores do Google Play permite que o Visual Studio carregue novas versões de um aplicativo para o Google Play. Antes que o Visual Studio possa começar a fazer chamadas de API, você precisará configurar o acesso à API em sua conta de desenvolvedor do Google Play. Isso envolve vincular sua conta de desenvolvedor do Google Play a um projeto do Google Cloud e configurar o acesso à API de publicação do desenvolvedor do Google Play com um cliente OAuth.

Para ativar o acesso à API do Google:

  1. Inicie sessão na sua conta de programador do Google Play .

  2. Em Google Play Console, expanda o item Configuração e selecione acesso à API. Em seguida, na página de acesso à API, selecione o botão Escolha um projeto para vincular:

    Captura de ecrã da página de acesso à API na Google Play Console.

    Para usar as APIs de desenvolvedor do Google Play, você precisará de um projeto do Google Cloud que deve estar vinculado à sua conta de desenvolvedor do Google Play.

    Observação

    Uma conta de desenvolvedor do Google Play só pode ser vinculada a um único projeto do Google Cloud. Portanto, se você publicar vários aplicativos de uma conta de desenvolvedor do Google Play, todos eles deverão compartilhar o mesmo projeto do Google Cloud.

  3. Na página de acesso à API do, selecione o botão de opção Criar um novo projeto do Google Cloud seguido do botão Salvar:

    Captura de tela mostrando a seleção do botão de opção Criar um novo projeto do Google Cloud.

    Um novo projeto do Google Cloud será criado e vinculado à sua conta de desenvolvedor do Google Play.

  4. Na página de acesso à API , na secção Clientes OAuth , selecione Configurar ecrã de consentimento OAuth :

    Captura de tela da página de acesso à API com o projeto vinculado do Google Cloud.

  5. Na página do ecrã de consentimento OAuth , selecione o botão de opção para o tipo de utilizador necessário e, em seguida, selecione o botão CRIAR:

    Captura de tela mostrando a seleção do tipo de usuário para a tela de consentimento OAuth.

    Para obter mais informações sobre os tipos de utilizador, consulte tipo de utilizador no support.google.com.

  6. Na página de registo de edição da aplicação , preencha os campos marcados como obrigatórios e depois seleccione o botão SALVAR E CONTINUAR:

    Captura de tela da edição dos dados de registro do aplicativo da tela de consentimento OAuth. Captura de tela da edição das informações de contato do desenvolvedor da tela de consentimento OAuth.

  7. Na página Editar registro do aplicativo, selecione o botão ADICIONAR OU REMOVER ESCOPOS:

    Captura de tela da adição de escopos para a tela de consentimento OAuth.

  8. Na janela de seleção Atualizar escopos selecionados, selecione o escopo ./auth/androidpublisher na tabela e, em seguida, selecione o botão ATUALIZAR:

    Captura de ecrã da adição do âmbito do editor Android para a tela de consentimento OAuth.

    Observação

    Os outros escopos na tabela podem ser selecionados opcionalmente, pois são escopos padrão.

  9. Na página Editar de registro do aplicativo, selecione a guia Credenciais:

    Captura de tela mostrando a seleção da guia credenciais.

  10. Na página de Credenciais , selecione o botão + CREATE CREDENTIALS e, em seguida, o item ID do cliente OAuth.

    Captura de tela mostrando a seleção do botão criar credenciais.

  11. Na página Criar ID do cliente OAuth, escolha aplicativo da área de trabalho na lista suspensa Tipo de aplicativo, digite do Visual Studio no campo Nome do e selecione o botão CRIAR:

    Captura de tela da criação de credenciais OAuth.

  12. Na caixa de diálogo cliente OAuth criado, selecione o botão DOWNLOAD JSON dados para descarregar o seu ID de cliente e segredo de cliente. Isso será necessário mais tarde. Em seguida, clique no botão OK para descartar a caixa de diálogo.

Para obter mais informações sobre como ativar o acesso à API do Google na sua conta de programador no Google Play, consulte Primeiros Passos em developers.google.com. Para obter mais informações sobre como configurar sua tela de consentimento OAuth, consulte Configurando sua tela de consentimento OAuth no support.google.com.

Carregar seu aplicativo por meio do Visual Studio

Para criar e assinar seu aplicativo no Visual Studio:

  1. Na barra de ferramentas do Visual Studio, use a lista suspensa Debug Target para selecionar Android Emulators e, em seguida, o emulador escolhido:

    Selecione um destino de implantação do Android no Visual Studio.

  2. Na barra de ferramentas do Visual Studio, use o menu Solutions Configuration para alterar da configuração de depuração para a configuração de versão.

    Selecione a configuração de versão no Visual Studio.

  3. No Gerenciador de Soluções, clique com o botão direito do mouse em seu projeto de aplicativo .NET MAUI e selecione Publicar...:

    Selecione o item de menu de publicação no Visual Studio.

    O Archive Manager será aberto e o Visual Studio começará a arquivar o seu pacote de aplicações:

    Captura de tela do gerenciador de arquivos no Visual Studio.

  4. No Archive Manager, assim que o arquivamento for concluído com êxito, certifique-se de que o arquivo está selecionado e, em seguida, selecione o botão Distribuir ... para iniciar o processo de distribuição da sua aplicação.

    Captura de tela do gerenciador de arquivos no Visual Studio quando a arquivação for concluída.

    A caixa de diálogo Distribuir - Selecionar Canal será exibida.

  1. Na caixa de diálogo Distribuir - Selecionar Canal, selecione o botão Google Play:

    Captura de ecrã que mostra a seleção do canal de distribuição do Google Play na caixa de diálogo de distribuição.

  2. Na caixa de diálogo Distribuir - Identidade de Assinatura, selecione a identidade de assinatura que criou ao criar a aplicação para distribuição através do Google Play Console e, em seguida, selecione o botão Continuar.

    Captura de tela mostrando a seleção da identidade de assinatura recém-criada.

Adicionar os detalhes da sua conta de programador do Google Play

Para adicionar sua conta de desenvolvedor do Google Play ao Visual Studio:

  1. Na caixa de diálogo Distribuir - Conta do Google Play, selecione o botão + para adicionar os detalhes da sua conta de desenvolvedor do Google Play:

    Captura de ecrã a mostrar a adição de uma conta de programador do Google Play na caixa de diálogo de distribuição.

  2. Na caixa de diálogo Registrar acesso à API do Google, insira uma descrição, o ID do cliente OAuth e a chave secreta do cliente, e clique no botão Registar:

    Captura de tela do registro de sua ID de cliente OAuth e segredo do cliente no Visual Studio.

    Observação

    A descrição da conta permite registar mais do que uma conta de programador do Google Play e carregar aplicações para diferentes contas de programador do Google Play.

    Um navegador da Web será aberto.

  3. No navegador da Web, faça login na sua conta de desenvolvedor do Google Play. Depois de iniciar sessão, poderá ser apresentada uma mensagem a informá-lo de que a Google não verificou a aplicação. Se isso ocorrer, selecione o botão Continuar:

    Captura de tela do login do Google dizendo que o aplicativo não foi verificado.

  4. No navegador da Web, selecione o botão Continuar para autorizar o aplicativo:

    Captura de tela da autorização de acesso à API do Google.

    O navegador da Web receberá um código de verificação.

    Importante

    Não feche o navegador da Web.

  5. Em Visual Studio, na caixa de diálogo Distribuir - conta do Google Play, selecione Continuar:

    Captura de tela do acesso autorizado à API do Google no Visual Studio.

Selecione uma faixa para a qual carregar seu aplicativo

Para selecionar a faixa do Google Play para a qual carregar seu aplicativo:

  1. Na caixa de diálogo Distribuir - Faixa do Google Play, selecione a faixa para a qual carregar a aplicação. O Google Play oferece cinco faixas para carregar seu aplicativo:

    • Interno deve ser usado para distribuir rapidamente seu aplicativo para testes internos e verificações de garantia de qualidade.
    • Alpha deve ser usado para carregar uma versão anterior do seu aplicativo para um pequeno grupo de testadores.
    • A versão beta deve ser usada para carregar uma versão anterior do seu aplicativo para um grupo maior de testadores.
    • A produção deve ser usada para distribuição completa na loja Google Play.
    • O modo personalizado deve ser usado para testar versões de pré-lançamento do seu aplicativo com usuários específicos, criando uma lista de testadores por endereços de e-mail.

    Importante

    Se não vir a faixa personalizada, certifique-se de que criou um lançamento para essa faixa na consola do Google Play. Para obter mais informações, consulte Preparar e implantar um de versão no support.google.com.

    Selecione a faixa para a qual carregar a sua aplicação e, em seguida, selecione o botão Carregar:

    Captura de ecrã a mostrar a seleção de uma faixa do Google Play antes de carregar a sua aplicação.

    Para mais informações sobre os testes do Google Play, consulte Configurar um teste aberto, fechado ou interno no support.google.com.

  2. O Visual Studio começará a publicar seu aplicativo no Google Play. Na caixa de diálogo Senha de assinatura, digite sua senha criada para a identidade de assinatura e selecione o botão OK:

    Captura de tela mostrando como inserir sua senha para sua identidade de assinatura no Visual Studio.

    O Visual Studio assinará seu pacote de aplicativos e o carregará no Google Play.

    Importante

    Os aplicativos enviados para o Google Play normalmente passam por um processo de revisão. Para obter mais informações, consulte Preparar seu aplicativo para revisão e Publicar seu aplicativo no support.google.com.