Compartilhar via


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

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.

    Captura de tela da página todos os aplicativos no Google Play.

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

    Captura de tela da criação de um novo aplicativo no Google Play.

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:

    Captura de tela da alteração do formato de pacote de um aplicativo Android .NET MAUI para APK. 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:

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

  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:

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

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

    Selecione o item de menu Publicar no Visual Studio.

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

    Captura de tela do gerenciador de arquivos no Visual Studio.

  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.

    Captura de tela do gerenciador de arquivos no Visual Studio após a conclusão do arquivamento.

    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 da seleção de um canal de distribuição na caixa de diálogo de distribuição.

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

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

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

    Captura de tela da criação de um repositório de chaves do Android.

    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.

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

    Captura de tela da publicação do aplicativo 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 para Assinatura, insira sua senha para assinatura e selecione o botão OK.

    Captura de tela da inserção da senha de identidade de assinatura.

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

    Captura de tela da abertura da pasta que contém seu aplicativo Android publicado.

    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:

    Captura de tela da página de acesso à API no Google Play Console.

    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:

    Captura de tela da seleção do botão de opção

    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:

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

  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.

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

    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:

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

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

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

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

    Captura de tela da adição do escopo do publicador Android para a tela de consentimento do OAuth.

    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:

    Captura de tela da guia de credenciais.

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

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

  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:

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

  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:

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

  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:

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

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

    Selecione o item de Menu Publicar no Visual Studio.

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

    Captura de tela do gerenciador de arquivos no Visual Studio.

  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:

    Captura de tela do gerenciador de arquivos no Visual Studio após a conclusão do arquivamento.

    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 tela da 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 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:

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

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.

    Captura de tela da adição de uma conta do Desenvolvedor 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, sua ID de cliente OAuth e o segredo do cliente, e em seguida clique no botão Registrar.

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

    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:

    Captura de tela do fazer login no Google mostrando a mensagem 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 do acesso à API do Google.

    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:

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

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:

    Captura de tela da seleção de uma faixa do Google Play antes de carregar seu aplicativo.

    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:

    Captura de tela da inserção de sua senha para sua identidade de assinatura no Visual Studio.

    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.