Compartilhar via

Publicar um aplicativo UWP WebView2 na Microsoft Store

  • Artigo

Um aplicativo UWP WebView2 é um aplicativo de Plataforma Universal do Windows (UWP) que hospeda o controle WebView2. Para disponibilizar amplamente um aplicativo UWP WebView2, você pode publicá-lo na Microsoft Store seguindo as etapas abaixo.

Para obter informações gerais sobre como publicar na Windows Store, consulte Publicar aplicativos e jogos do Windows na UWP da documentação > do Desenvolvimento de Aplicativos do Windows. As etapas a seguir fornecem os detalhes específicos sobre como publicar um aplicativo UWP WebView2.

Etapa 1: configurar uma conta da Microsoft Store no Visual Studio

  • Verifique se você tem uma conta da Microsoft Store configurada no Microsoft Visual Studio.

    Se necessário, consulte Obter registro, sobre contas de desenvolvedor para a Microsoft Store. Em seguida, continue com as etapas abaixo.

Etapa 2: testar o aplicativo host não empacotado

Teste esses problemas básicos comuns antes de enviar seu aplicativo para a Microsoft Store. Isso ajudará a evitar falhas de certificação da Loja, o que atrasaria a disponibilidade do aplicativo.

  1. Verifique se o aplicativo é executado corretamente na inicialização.

  2. Verifique se o aplicativo funciona corretamente durante o sono de desligamento.

Etapa 3: Empacotar o aplicativo host

A Microsoft Store requer o envio de um aplicativo empacotado. Empacotar seu aplicativo da seguinte maneira:

  1. Atualize o com todo o package.appxmanifest conteúdo necessário, como Ativos Visuais, Nome da embalagem e informações do aplicativo. Se você não fizer isso, a etapa de validação da Microsoft Store falhará. Em seguida, continue com as etapas abaixo.

  2. No Partner Center, selecione Project>Publish e reserve um nome do aplicativo.

  3. Associe o aplicativo ao nome reservado, selecionando Project>Publish>Associate App com a Store.

  4. Crie o pacote de aplicativos selecionandoPacotes de Aplicativos Criar CriarPublicação> do Projeto>. Selecione as configurações de destino:

    Selecionando configurações de destino

    Versões de 32 bits e 64 bits do WebView2 Runtime funcionarão em UWP em plataformas não ARM. Não há suporte para 32 bits para ARM, devido a dependências no Microsoft Edge. Há suporte para 64 Bits no ARM.

  5. Depois que o pacote de aplicativos foi criado para suas configurações, a janela Criar Pacotes de Aplicativo exibe a caixa de diálogo Criar pacotes:

    Kit de certificação de aplicativo do Windows

  6. Na caixa de diálogo, observe onde o pacote de pacotes foi colocado. Essas informações também são mostradas na janela de build.

  7. Clique no botão Fechar .

Etapa 4: testar o pacote

Para garantir que todos os arquivos de conteúdo necessários estejam presentes no pacote e garantir que os arquivos tenham permissões corretas, teste seu aplicativo empacotado da seguinte maneira:

  1. Use o pacote de aplicativo gerado para instalar o aplicativo em seu computador. Procure qualquer estranheza em relação aos pacotes e funcionalidades necessários.

  2. Se possível, instale seu aplicativo em outros computadores também. Procure qualquer estranheza em relação aos pacotes e funcionalidades necessários.

Etapa 5: Executar o Kit de Certificação de Aplicativo do Windows (WACK)

O WACK (Kit de Certificação de Aplicativo do Windows) é um aplicativo que é uma ferramenta de certificação. Essa ferramenta avalia seu aplicativo host em relação aos requisitos da Microsoft Store.

Depois de estar satisfeito que seu aplicativo empacotado funcione, execute o WACK (Kit de Certificação de Aplicativo do Windows):

  1. Gere o pacote de aplicativos novamente, conforme acima. Essa é a maneira mais fácil de chegar ao processo wack (Kit de Certificação de Aplicativo do Windows).

  2. Depois que a criação do pacote for concluída, selecione Iniciar Kit de Certificação de Aplicativo do Windows.

  3. Você deve aprovar a caixa de diálogo UAC (User Controle de Acesso) para que o WACK (Kit de Certificação de Aplicativo do Windows) seja executado corretamente.

  4. Selecione Tudo para o pacote de testes e clique em Avançar.

  5. Após alguns minutos, o WACK (Kit de Certificação de Aplicativo do Windows) mostra uma página de resultados. Se o aplicativo falhou, clique no link para examinar os resultados.

Resolvendo testes

A página de resultados do aplicativo WACK (Kit de Certificação de Aplicativo do Windows) mostra todos os testes que precisam ser resolvidos.

Espaço de nome restrito

Se o aplicativo falhou na verificação de espaço de nome restrito , edite o package.appxmanifest arquivo e remova a restrictedcapabilities linha e todos os recursos que usam rescap.

O WebView2 não deve exigir recursos restritos para operar. Se seu aplicativo precisar de recursos restritos, você precisará solicitar uma exceção de loja por meio do Partner Center ou distribuir apenas o aplicativo por meio de avenidas que não sejam da Loja.

Identidade Visual

Se o aplicativo falhou nas verificações de identidade visual , atualize todos os Ativos Visuais no manifesto, conforme descrito acima.

Funcionalidades do aplicativo

Se o aplicativo falhou nos testes de Recursos de Aplicativo , desative quaisquer recursos desnecessários. Se você precisar de um recurso de uso especial, precisará obter a aprovação da Microsoft Store ou usar métodos de distribuição que não sejam da Loja.

Correção geral de metadados

Se o aplicativo falhou, os testes gerais de correção de metadados com um erro no IPopup4, atualize a microsoft. Pacote NuGet UI.xaml para a versão Microsoft.UI.Xaml.2.8.0-prerelease.220118001 ou superior. Havia um bug nos manifestos, antes dessa versão.

API com suporte

Neste teste, o WACK verifica as APIs do Windows que seu aplicativo host está chamando, para ter certeza de que elas têm suporte.

Se o aplicativo falhou no teste de API com suporte , atualize o SDK do Windows para a versão 22000 ou superior, para obter a versão mais recente da lista de APIs permitidas. Não deve haver APIs de bloqueio para WebView2 no SDK atual do Windows.

Etapa 6: Carregar o pacote do aplicativo

  • Depois que todos os testes do WACK (Kit de Certificação de Aplicativo do Windows) tiverem passado, carregue seu pacote de aplicativos na Windows Store usando uma das seguintes abordagens:

    • Abordagem 1: no Kit de Certificação de Aplicativo do Windows (WACK), selecionePacotes de Aplicativos deUpload de Publicação> do Projeto>.

    • Abordagem 2: vá para o Partner Center e carregue seu pacote de aplicativos na Windows Store por meio do Partner Center.

Confira também