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

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

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

Para distribuir um aplicativo Android do .NET MAUI, você precisará assiná-lo com uma chave do seu keystore antes de carregá-lo no Google Play. Os repositórios de chaves 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 APK (Pacotes Android) 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 pacotes de aplicativos Android, consulte sobre pacotes de aplicativos Android no developer.android.com.

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

1. Crie uma conta do Desenvolvedor do Google Play. Para obter mais informações, consulte Criar uma conta do 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 Console do Google Play.
4. Verifique se o aplicativo usa o formato de pacote correto. Para obter mais informações, consulte Garantir o formato de pacote correto.
5. Crie e assine seu aplicativo no Visual Studio e distribua-o por meio do 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 do Desenvolvedor do Google Play

Para publicar aplicativos Android no Google Play, você precisará criar uma conta do Desenvolvedor do Google Play:

1. Usando sua conta do Google, inscreva-se em uma conta do Desenvolvedor do Google Play .
2. Insira informações sobre sua identidade de desenvolvedor.
3. Durante o processo de inscrição, você precisará examinar e aceitar o Contrato de Distribuição de Desenvolvedores do Google Play .
4. Pague a taxa de registro única de $25.
5. Verifique sua identidade seguindo as instruções em seu email de verificação.

Importante

A verificação de identidade deve ser concluída antes que você possa publicar aplicativos por meio do Google Play. Além disso, novos titulares de conta pessoal terão que 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.

Depois que sua conta do Desenvolvedor do Google Play tiver sido criada, você poderá iniciar o processo para publicar um aplicativo no Google Play.

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

Criar 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 logon no da conta do Desenvolvedor doGoogle Play.

2. Em do Console do Google Play, na guia Todos os aplicativos, selecione o botão Criar app.

   

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

   

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

Configurar seu aplicativo no Google Play Console

Depois de criar seu aplicativo, você deve configurá-lo. O painel do aplicativo orientará você em todas as etapas mais importantes.

Para começar a configurar seu aplicativo, selecione Painel no menu à esquerda. Nos detalhes do aplicativo na parte superior da página, você encontrará diferentes categorias e tarefas relacionadas à configuração e à versão 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 de verificação 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 de pacote correto

Para publicar um aplicativo Android do .NET MAUI 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 builds de versão. Para verificar se o formato de pacote do aplicativo está definido corretamente:

1. No Gerenciador de Soluções do Visual Studio, clique com o botão direito do mouse no projeto de aplicativo .NET MAUI e selecione Propriedades. Em seguida, navegue até a guia Android > Opções e verifique se o valor do campo Release está definido como bundle:

   Publicar

Distribuir seu aplicativo por meio do Google Play Console

Na primeira vez que um AAB é enviado ao Google Play, ele deve ser carregado manualmente por meio do Console do Google Play. Isso permite que o Google Play verifique a correspondência da assinatura da chave em todos os pacotes futuros com a chave original usada na primeira versão do aplicativo. Para carregar o aplicativo por meio do Google Play Console, ele deve primeiro ser compilado e conectado no Visual Studio.

Para compilar e assinar seu aplicativo no Visual Studio:

1. Na barra de ferramentas do Visual Studio, use a lista suspensa Destino de Depuração para selecionar Os Emuladores do 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 lançamento:

   

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

   

   O Archive Manager será aberto e o Visual Studio iniciará o processo de arquivamento do seu pacote de aplicativos.

   

4. No Gerenciador de Arquivos , depois que o arquivamento for concluído com êxito, verifique se o arquivo de armazenamento está selecionado e selecione o botão Distribuir... para iniciar o processo de distribuição do 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 do Repositório de Chaves do Android será exibida.

   Nota

   Como alternativa, pode-se usar uma identidade de assinatura existente selecionando o botão Importar.

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

   • Apelido Insira um nome de identificação para sua chave.
   • Senha. Crie e confirme uma senha segura para sua chave.
   • Validade. Defina o período de tempo, em anos, que sua chave será válida.
   • Nome completo, unidade da organização, 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 estão incluídas em seu certificado.

   

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

   Importante

   O repositório de chaves e a senha não são salvos na solução do Visual Studio. Portanto, certifique-se de fazer backup dos 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 – Assinar Identidade, 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 pacote estão corretos e selecione o botão Salvar.

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

    

11. No Archive Manager, selecione o botão Abrir Distribuição depois que o processo de publicação for concluído:

    

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

O aplicativo publicado pode 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. Uma versão é uma combinação de uma ou mais versões de aplicativo que você preparará para iniciar um aplicativo ou distribuir uma atualização. Você pode lançar uma versão nos seguintes canais:

• Teste interno. As versões de teste internas estão disponíveis para até 100 testadores que você pode escolher.
• Teste restrito. As versões de teste fechado 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 usuários podem participar de testes na página da loja.
• Produção. As versões de produção estão disponíveis para todos os usuários do Google Play em seus países escolhidos.

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

Importante

O aplicativo enviado para o Google Play normalmente passa 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

Uma AAB já deve ter sido enviada ao Google Play e ter passado por revisão antes de distribuí-la do Visual Studio. Se você tentar distribuir um AAB do Visual Studio que não foi carregado primeiro do Play Console, receberá o seguinte erro:

O Google Play exige que você carregue manualmente seu primeiro pacote (APK/AAB) para este aplicativo. Você pode usar um pacote ad hoc para isso.

Quando esse erro ocorrer, faça o upload manual de um AAB através do Console do Google Play. 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:

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

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

Nota

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

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

Habilitar o acesso à API do Google

A API de Publicação de Desenvolvedores 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 à API, você precisará configurar o acesso à API em sua conta do Desenvolvedor do Google Play. Isso envolve vincular sua conta do Desenvolvedor do Google Play a um projeto do Google Cloud e configurar o acesso à API de Publicação de Desenvolvedores do Google Play com um cliente OAuth.

Para habilitar o acesso à API do Google:

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

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

   

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

   Nota

   Uma conta do 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 do Google Play Developer, todos eles deverão compartilhar o mesmo projeto do Google Cloud.

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

   

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

4. Na página de acesso à API, na seção clientes OAuth, selecione Configurar a tela de consentimento OAuth:

   

5. Na página da tela de consentimento do OAuth, selecione o botão de rádio correspondente ao tipo de usuário desejado e, em seguida, selecione o botão CREATE.

   

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

6. Na página Editar registro de aplicativo, conclua os campos marcados como necessário e selecione o botão SALVAR E CONTINUAR:

   

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

   

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

   

   Nota

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

9. Na página editar registro de aplicativo, selecione a guia credenciais do:

   

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 na lista suspensa Tipo de aplicação, insira Visual Studio no campo Nome e, em seguida, selecione o botão CREATE:

    

12. Na caixa de diálogo cliente OAuth criado, selecione o botão de dados BAIXAR JSON para baixar a ID do cliente e o segredo do cliente. Isso será necessário posteriormente. Em seguida, clique no botão OK para ignorar a caixa de diálogo.

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

Carregar 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 a lista suspensa Destino de Depuração para selecionar Os Emuladores do 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 mudar da configuração de depuração para a configuração de versão:

   

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

   

   O do Archive Manager será aberto e o Visual Studio começará a arquivar seu pacote de aplicativos:

   

4. No Gerenciador de Arquivos , depois que o arquivamento for concluído com êxito, verifique se seu arquivo está selecionado e selecione o botão Distribuir... para iniciar o processo de distribuição do 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 quando você criou o aplicativo para distribuição por meio do Console do Google Play e, em seguida, selecione o botão Continuar:

   

Adicionar detalhes da sua conta do Desenvolvedor 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.

   

2. Na caixa de diálogo Registrar Acesso à API do Google, insira uma descrição, sua ID de cliente OAuth e o segredo do cliente, e em seguida clique no botão Registrar.

   

   Nota

   A descrição da conta possibilita registrar mais de uma conta do Google Play Developer e carregar aplicativos em diferentes contas do Desenvolvedor do Google Play.

   Um navegador da Web será aberto.

3. No navegador da Web, entre em sua conta do Desenvolvedor do Google Play. Depois de entrar, uma mensagem pode ser exibida informando que o Google não verificou o aplicativo. Se isso ocorrer, selecione o botão Continuar:

   

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

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

   

Selecione uma faixa para carregar seu aplicativo

Para selecionar a faixa do Google Play em que enviar seu aplicativo:

1. Na caixa de diálogo Distribuir – Google Play Track, selecione a faixa na qual deseja carregar seu aplicativo. O Google Play oferece cinco faixas para carregar seu aplicativo:

   • O recurso interno deve ser usado para distribuir rapidamente seu aplicativo para testes internos e verificações de qualidade.
   • O Alpha deve ser usado para carregar uma versão inicial do aplicativo em um pequeno grupo de testadores.
   • O Beta deve ser usado para carregar uma versão inicial do aplicativo em um grupo maior de testadores.
   • A produção deve ser usada para distribuição completa na Google Play Store.
   • A função "Personalizado" deve ser usada para testar as versões de pré-lançamento do seu aplicativo com usuários específicos, criando e gerenciando uma lista de testadores por endereço de email.

   Importante

   Se você não vir a faixa personalizada, certifique-se de que você criou uma versão para essa faixa no Console do Google Play. Para obter mais informações, consulte Preparar e implementar uma versão no support.google.com.

   Selecione a faixa para a qual carregar seu aplicativo e selecione o botão Carregar:

   

   Para obter mais informações sobre o teste 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, insira a senha que você criou para a identidade de assinatura e selecione o botão OK:

   

   O Visual Studio assinará o pacote do aplicativo e o carregará no Google Play.

   Importante

   O aplicativo enviado para o Google Play normalmente passa 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.