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

• Publicar para distribuição ad hoc
• Publicar usando a linha de comando

A abordagem mais comum para distribuir aplicativos Android aos usuários é por meio do Google Play. A primeira vez que um aplicativo é enviado ao Google Play, ele deve ser enviado por meio do Google Play Console. Versões subsequentes do aplicativo podem ser enviadas por meio do Visual Studio. Em ambos os casos, é necessária uma conta de Desenvolvedor do Google Play. Os aplicativos enviados ao Google Play exigem aprovação do Google.

Para distribuir um aplicativo Android de UI de aplicativo multiplataforma .NET (.NET MAUI), você precisará assiná-lo com uma chave do seu keystore antes de carregá-lo no 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 AAB (Pacote de Aplicativos Android). O Google Play usa seu pacote de aplicativos para gerar e fornecer pacotes Android (APK) otimizados para cada configuração de dispositivo, de modo 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, veja Sobre Android App Bundles em developer.android.com.

O processo para distribuição de um aplicativo .NET MAUI para Android por meio do Google Play é o seguinte:

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

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

Crie uma conta de Desenvolvedor do Google Play

Para publicar aplicativos Android no Google Play, você precisará criar uma conta de Desenvolvedor 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, você precisará revisar e aceitar o Contrato de distribuição do Desenvolvedor do Google Play.
4. Pague a taxa única de inscrição no valor de $25.
5. Verifique sua identidade seguindo as instruções no seu email de verificação.

Importante

A verificação de identidade precisa ser concluída antes que você possa publicar aplicativos no Google Play. Além disso, os novos titulares de contas pessoais terão que verificar se têm acesso a um dispositivo Android real. Para obter mais informações, veja Requisitos de verificação de dispositivos para novas contas de desenvolvedor em support.google.com.

Depois que sua conta de Desenvolvedor do Google Play for criada, você poderá iniciar o processo de publicação de um aplicativo no Google Play.

Para obter mais informações, veja Registrar uma conta de Desenvolvedor do Google Play em 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. Faça login em sua conta de Desenvolvedor do Google Play.

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

   

3. Na página Criar aplicativo, insira os detalhes do seu aplicativo e selecione o botão Criar aplicativo:

   

Para obter mais informações sobre como criar um aplicativo no Google Play Console veja Criar e configurar seu aplicativo em support.google.com.

Configure seu aplicativo no Google Play Console

Depois de criar seu aplicativo, você deverá configurá-lo. O painel do seu aplicativo irá guiá-lo por todas as etapas mais importantes.

Para começar a configurar seu aplicativo, selecione Painel no menu esquerdo. Nos detalhes do seu aplicativo, na parte superior da página, você encontrará diferentes categorias e tarefas relacionadas à configuração e ao lançamento do aplicativo. Você deve concluir as tarefas obrigatórias antes de iniciar seu aplicativo no Google Play. Ao concluir uma tarefa, você verá uma marca verde e um texto tachado. A barra de progresso no topo da seção também será atualizada. Para obter mais informações, veja Configurar seu aplicativo no painel do aplicativo em support.google.com.

Garanta 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 versões de lançamento. Para verificar se o formato do pacote do seu aplicativo está definido corretamente:

1. No Gerenciador de Soluções do Visual Studio, clique com o botão direito em seu projeto de aplicativo .NET MAUI e selecione Propriedades. Em seguida, navegue até a guia Android > Options e certifique-se de que o valor do campo Release esteja definido como bundle:

   Publicar

Distribua seu aplicativo pelo Google Play Console

Na primeira vez que um AAB é enviado ao Google Play, ele deve ser carregado manualmente por meio do Google Play Console. Isso permite que o Google Play corresponda a assinatura da chave em todos os pacotes futuros à chave original usada na primeira versão do aplicativo. Para fazer upload do aplicativo por meio do Google Play Console, primeiro ele deve ser criado e assinado no Visual Studio.

Para compilar e assinar seu aplicativo no Visual Studio:

1. Na barra de ferramentas do Visual Studio, use o menu suspenso Destino de Depuração para selecionar Emulador de Android e, em seguida, o emulador escolhido:

   

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

   

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

   

   O Gerenciador de arquivos será aberto e o Visual Studio começará a arquivar o pacote do aplicativo:

   

4. No Archive Manager, depois que o arquivamento for concluído com sucesso, certifique-se de que seu arquivo esteja selecionado e selecione o botão Distribuir ... para iniciar o processo de distribuição de seu aplicativo:

   

   A caixa de diálogo Distribuir – selecionar canal será exibida.

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

   

6. Na caixa de diálogo Distribuir - Identidade de Assinatura, selecione o botão + para criar uma nova identidade de assinatura:

   

   A caixa de diálogo Criar Android Keystore será exibida.

   Observação

   Alternativamente, uma identidade de assinatura existente pode ser usada selecionando o botão Importar.

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

   • Alias. Insira um nome de identificação para sua chave.
   • Senha. Crie e confirme uma senha segura para sua chave.
   • Validade. Defina por quanto tempo, em anos, 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 no seu aplicativo, mas estão incluídas no seu certificado.

   

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

   Importante

   O keystore e a senha não são salvos na sua solução Visual Studio. Portanto, certifique-se de fazer backup desses dados. Se você perdê-lo, não será possível assinar seu aplicativo com a mesma identidade de assinatura.

8. Na caixa de diálogo Distribuir - Identidade de assinatura, selecione sua identidade de assinatura recém-criada e selecione o botão Salvar como:

   

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

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

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

    

11. No Archive Manager, selecione o botão Open Distribution quando o processo de publicação for concluído:

    

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

O aplicativo publicado pode então ser lançado no Google Play por meio do Google Play Console. Para fazer isso, primeiro você deve criar uma versão no Google Play Console. Um lançamento é uma combinação de uma ou mais versões de aplicativo que você preparará para lançar um aplicativo ou lançar uma atualização. Você pode criar um lançamento nas seguintes faixas:

• Testes internos. Versões de testes internos estão disponíveis para até 100 testadores à sua escolha.
• Teste fechado. As versões de teste fechado estão disponíveis para um número limitado de testadores de sua escolha, que podem testar uma versão de pré-lançamento do seu aplicativo e enviar feedback.
• Teste aberto. Versões de testes abertos estão disponíveis para testadores no Google Play. Os usuários podem participar de testes na listagem da sua Store.
• Produção. As versões de produção estão disponíveis para todos os usuários do Google Play nos países escolhidos.

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

Importante

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

Distribua seu aplicativo por meio do Visual Studio

Um AAB já deve ter sido enviado ao Google Play e aprovado na revisão antes que você possa distribuí-lo no 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 exige que você carregue manualmente seu primeiro pacote (APK/AAB) para esse aplicativo. Você pode usar um pacote ad-hoc para isso.

Quando esse erro ocorrer, carregue manualmente um AAB por meio do Google Play Console. As versões subsequentes do aplicativo poderão ser publicadas por meio do Visual Studio. Porém, você deve alterar o código da versão do aplicativo a cada upload, caso contrário ocorrerá o seguinte erro:

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

Para resolver esse erro, recrie o aplicativo com um número de versão diferente e reenvie-o ao Google Play por meio do Visual Studio.

Observação

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

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

Habilitar o acesso à API do Google

A API de publicação do Desenvolvedor do Google Play permite que o Visual Studio carregue novas versões de um aplicativo no 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 Google Play Developer Publishing com um cliente OAuth.

Para habilitar o acesso à API do Google:

1. Faça login em sua conta de Desenvolvedor do Google Play.

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

   

   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 Acesso à API, selecione o botão de opção Criar um novo projeto do Google Cloud seguido do botão Salvar:

   

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

4. Na página Acesso à API, na seção Clientes OAuth, selecione Configurar tela de consentimento do OAuth:

   

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

   

   Para obter mais informações sobre os tipos de usuário, veja Tipo de usuário em support.google.com.

6. Na página Editar cadastro do aplicativo, preencha os campos marcados como obrigatórios e em seguida selecione o botão SALVE E CONTINUE:

   

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

   

8. No menu desdobrável Atualizar escopos selecionados, selecione o escopo na ./auth/androidpublisher tabela e, em seguida, selecione o botão ATUALIZAR:

   

   Observação

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

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

   

10. Na página Credenciais, selecione o botão + CRIAR CREDENCIAIS e em seguida o item ID do cliente OAuth:

    

11. Na página Criar ID do cliente OAuth, escolha Aplicativo de desktop no menu suspenso Tipo de aplicativo, insira Visual Studio no campo Nome e selecione o botão CRIAR:

    

12. Na caixa de diálogo Cliente OAuth criado, selecione o botão BAIXAR JSON data para fazer download do ID do cliente e do segredo do cliente. Isso será necessário mais tarde. Em seguida, clique no botão OK para fechar a caixa de diálogo.

Para obter mais informações sobre como habilitar o acesso à API do Google para sua conta de Desenvolvedor do Google Play, veja Introdução em developers.google.com. Para obter mais informações sobre como configurar a tela de consentimento do OAuth, veja Configurar a tela de consentimento do OAuth em support.google.com.

Carregue seu aplicativo por meio do Visual Studio

Para compilar e assinar seu aplicativo no Visual Studio:

1. Na barra de ferramentas do Visual Studio, use o menu suspenso Destino de Depuração para selecionar Emulador de Android e, em seguida, o emulador escolhido:

   

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

   

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

   

   O Gerenciador de arquivos será aberto e o Visual Studio começará a arquivar o pacote do aplicativo:

   

4. No Archive Manager, depois que o arquivamento for concluído com sucesso, certifique-se de que seu arquivo esteja selecionado e selecione o botão Distribuir ... para iniciar o processo de distribuição de seu aplicativo:

   

   A caixa de diálogo Distribuir – selecionar canal será exibida.

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

   

6. Na caixa de diálogo Distribuir - Identidade de assinatura, selecione a identidade de assinatura que você criou ao criar o aplicativo para distribuição por meio do Google Play Console e selecione o botão Continuar:

   

7. 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:

   

8. Na caixa de diálogo Registrar acesso à API do Google, insira uma descrição, seu ID de cliente OAuth e segredo do cliente e clique no botão Registrar:

   

   Observação

   A descrição da conta permite registrar mais de uma conta de desenvolvedor do Google Play e fazer upload de aplicativos para diferentes contas de Desenvolvedor do Google Play.

   Um navegador da web será aberto.

9. No navegador da web, faça login em sua conta de Desenvolvedor do Google Play. Depois de fazer login, uma mensagem poderá ser exibida informando que o Google não verificou o aplicativo. Se isso ocorrer selecione o botão Continuar:

   

10. No navegador da web, selecione o botão Continuar para autorizar o aplicativo:

    

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

    Importante

    Não feche o navegador da web.

11. No Visual Studio, na caixa de diálogo Distribuir - Conta do Google Play, selecione Continuar:

    

12. Na caixa de diálogo Distribuir - Faixa do Google Play, selecione a faixa para a qual enviar seu aplicativo. O Google Play oferece cinco faixas para enviar 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 enviar uma versão inicial do seu aplicativo para um pequeno grupo de testadores.
    • Beta deve ser usado para enviar uma versão inicial do seu aplicativo para um grupo maior de testadores.
    • A produção deverá ser utilizada para distribuição completa na loja Google Play.
    • 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ço de email.

    Importante

    Se você não vir a faixa personalizada, certifique-se de ter criado uma versão para essa faixa no Google Play Console. Para obter mais informações, veja Preparar e lançar uma versão em support.google.com.

    Selecione a faixa para fazer upload do seu aplicativo e selecione o botão Upload:

    

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

13. O Visual Studio começará a publicar seu aplicativo no Google Play. Na caixa de diálogo Senha de assinatura, insira a senha que você criou para a identidade de assinatura e selecione o botão OK:

    

    O Visual Studio assinará seu pacote de aplicativos e fará upload dele no Google Play.

    Importante

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