Compartilhar via


Empacotar um aplicativo UWP ou da área de trabalho no Visual Studio

Antes de distribuir seu aplicativo, você precisa empacotá-lo. Este artigo descreve o processo de configuração, criação e teste de um pacote MSIX usando o Visual Studio.

Tipos de pacotes do aplicativo

  • Pacote do aplicativo (.msix ou.appx)
    Um único pacote que contém seu aplicativo e os recursos dele, direcionados a uma única arquitetura de dispositivo. Por exemplo, um pacote de aplicativos x64 ou x86. Para direcionar várias arquiteturas com um lote de aplicativo, você precisaria gerar uma para cada arquitetura.

  • Lote de aplicativo (.msixbundle ou .appxbundle)
    Um lote de aplicativo é um tipo de pacote que pode conter vários pacotes do aplicativo. Cada um deles é criado para dar suporte a uma arquitetura de dispositivo específico. Por exemplo, um lote de aplicativo pode conter três pacotes do aplicativo separados para as configurações x86, x64 e ARM. Os lotes de aplicativo devem ser gerados sempre que possível, pois eles permitem que seu aplicativo esteja disponível na maior variedade possível de dispositivos.

  • Arquivo de upload do pacote do aplicativo (.msixupload ou .appxupload) – somente para envio à Store
    Um único arquivo que pode conter vários pacotes do aplicativo ou um lote de aplicativo para dar suporte a várias arquiteturas de processador. O arquivo de upload do pacote do aplicativo também conterá um arquivo de símbolo para Analisar o desempenho do aplicativo depois que seu aplicativo for publicado na Microsoft Store. Este arquivo será automaticamente criado para você se você estiver empacotando seu aplicativo com o Visual Studio com a intenção de enviá-lo ao Partner Center para publicação na Microsoft Store.

Aqui está uma visão geral das etapas de preparação e de criação de um pacote do aplicativo:

  1. Antes de empacotar seu aplicativo. Siga estas etapas para se verificar se seu aplicativo está pronto para ser empacotado.

  2. Configurar seu projeto. Use o designer de manifesto do Visual Studio para configurar o pacote. Por exemplo, adicione imagens de bloco e escolha as orientações que seu aplicativo suporta.

  3. Gerar um pacote do aplicativo. Use o assistente de empacotamento do Visual Studio para criar um pacote do aplicativo.

  4. Executar, depurar e testar um aplicativo empacotado. Execute e depure o pacote do aplicativo do Visual Studio ou instale o pacote diretamente.

Antes de empacotar seu aplicativo

  1. Testar seu aplicativo. Antes de empacotar seu aplicativo, verifique se ele funciona conforme esperado em todas as famílias de dispositivos às quais você pretende dar suporte. Essas famílias de dispositivos podem incluir desktop, celular, Surface Hub, Xbox, dispositivos IoT ou outros. Para obter mais informações sobre como implantar e testar seu aplicativo usando o Visual Studio, confira Implantar e depurar aplicativos UWP (também se aplica a aplicativos da área de trabalho empacotados).

  2. Otimizar seu aplicativo. Você pode usar as ferramentas de criação de perfil e depuração do Visual Studio para otimizar o desempenho do seu aplicativo empacotado. Por exemplo, a ferramenta de Linha do tempo para capacidade de resposta da interface do usuário, a ferramenta de Uso de memória, a ferramenta de Uso da CPU e muito mais. Para obter mais informações sobre essas ferramentas, confira o tópico Tour sobre o recurso de criação de perfil.

  3. Verifique a compatibilidade nativa do .NET (para aplicativos VB e C#). Na Plataforma Universal do Windows, há um compilador nativo que aprimorará o desempenho do runtime do aplicativo. Com essa alteração, você deverá testar seu aplicativo nesse ambiente de compilação. Por padrão, a configuração de compilação de versão habilita a cadeia de ferramentas nativa do .NET, portanto, é importante testar seu aplicativo com essa configuração de versão e verificar se ele se comporta conforme o esperado.

Configurar seu projeto

O arquivo de manifesto do aplicativo (Package.appxmanifest.xml) é um arquivo XML que contém as propriedades e as configurações necessárias para criar o pacote do aplicativo. Por exemplo, as propriedades no arquivo de manifesto do aplicativo descrevem a imagem a ser usada como o bloco do aplicativo e as orientações compatíveis com o aplicativo quando um usuário gira o dispositivo.

O designer de manifesto do Visual Studio permite a atualização do arquivo de manifesto sem a edição do XML bruto do arquivo.

Configurar um pacote com o designer de manifesto

  1. No Gerenciador de Soluções, expanda o nó do projeto do seu projeto de aplicativo.

  2. Clique duas vezes no arquivo Package.appxmanifest . Se o arquivo de manifesto já estiver aberto na exibição de código XML, o Visual Studio solicitará que você feche o arquivo.

  3. Agora você pode decidir como configurar seu aplicativo. Cada guia contém informações que você pode configurar sobre seu aplicativo e links para mais informações, se necessário.

    Manifest designer in Visual Studio

    Verifique se você tem todas as imagens necessárias para um aplicativo na guia Ativos Visuais . É aqui que você forneceria ícones e logotipos de aplicativos.

    Na guia Empacotamento , você pode inserir dados de publicação. É aqui que você pode escolher qual certificado usar para assinar seu aplicativo. Todos os aplicativos MSIX devem ser assinados com um certificado.

    Observação

    Do Visual Studio 2019 em diante, um certificado temporário não é mais gerado nos projetos UWP ou da área de trabalho empacotados. Para criar ou exportar certificados, use os cmdlets do PowerShell descritos neste artigo. Em versões recentes do Visual Studio, você também pode assinar seu aplicativo com um certificado armazenado no Cofre de Chaves do Azure para cenários de desenvolvimento e teste.

    Importante

    Se você estiver publicando seu aplicativo na Microsoft Store, ele será autenticado com um certificado confiável para você. Isso permite que o usuário instale e execute seu aplicativo sem instalar o certificado de autenticação do aplicativo associado.

    Se você estiver instalando o pacote do aplicativo em seu dispositivo, primeiro será necessário confiar no pacote. Para confiar no pacote, o certificado deve estar instalado no dispositivo do usuário.

  4. Salve seu arquivo Package.appxmanifest após fazer as edições necessárias para o aplicativo.

Se você estiver distribuindo seu aplicativo por meio da Microsoft Store, o Visual Studio poderá associar seu pacote à Store. Para fazer isso, clique com o botão direito do mouse no nome do projeto no Gerenciador de Soluções e escolha Publicar-Associar> Aplicativo à Loja (antes do Visual Studio 2019 versão 16.3, o menu Publicar é denominado Loja). Você também pode fazer isso no assistente Criar pacotes do aplicativo, descrito na seção a seguir. Quando você associa seu aplicativo, alguns dos campos na guia Empacotamento do designer de manifesto são atualizados automaticamente.

Gerar um pacote do aplicativo

Os aplicativos podem ser instalados sem serem publicados na Loja, publicando-os em seu site, usando ferramentas de gerenciamento de aplicativos, como o Microsoft Intune e o Configuration Manager, etc. Você também pode instalar diretamente um pacote MSIX para teste em sua máquina local ou remota.

Criar um pacote do aplicativo usando o assistente de empacotamento

Observação

As instruções e capturas de tela a seguir descrevem o processo do Visual Studio 2019 versão 16.3 em diante. Se estiver usando uma versão anterior, algumas interfaces do usuário poderão ter aparência diferente. Se você estiver empacotando um aplicativo da área de trabalho, clique com o botão direito do mouse no nó Projeto de Empacotamento de Aplicativo do Windows.

  1. No Gerenciador de Soluções, abra a solução para seu projeto de aplicativo.

  2. Clique com o botão direito do mouse no projeto e escolha Publicar-Criar> Pacotes de Aplicativo (antes do Visual Studio 2019 versão 16.3, o menu Publicar é denominado Loja).

    Context menu with navigation to Create App Packages

  3. Selecione Sideload na primeira página do assistente e clique em Avançar.

    Create Your Packages dialog window shown with Sideloading

  4. Na página Selecionar método de autenticação, selecione se você deseja ignorar a autenticação do empacotamento ou selecione um certificado para autenticação. Você pode selecionar um certificado em seu repositório de certificados local, selecionar um arquivo de certificado ou criar um certificado. Para um pacote MSIX ser instalado em um computador do usuário final, ele deve ser assinado com um certificado confiável na máquina.

    Create Your Packages dialog window shown with Signing

  5. Preencha a página Selecionar e configurar pacotes conforme descrito na seção Criar seu arquivo de upload do pacote do aplicativo usando o Visual Studio.

Instalar seu pacote do aplicativo clicando duas vezes

Os pacotes do aplicativo podem ser instalados simplesmente clicando duas vezes no arquivo do pacote do aplicativo. Para fazer isso, navegue até o arquivo do pacote do aplicativo ou do lote de aplicativo e clique duas vezes nele. O Instalador de Aplicativo é iniciado e fornece as informações básicas sobre o aplicativo, bem como um botão de instalação, a barra de progresso da instalação e as mensagens de erro relevantes.

Observação

O Instalador de Aplicativo pressupõe que o pacote foi assinado com um certificado confiável no dispositivo. Caso contrário, será necessário instalar o certificado de autenticação no repositório Autoridades de Certificação de Editores ou Pessoas Confiáveis no dispositivo. Se você não tem certeza de como fazer isso, confira Instalar Certificados de Teste.

Instalar seu pacote do aplicativo usando um script de instalação

  1. Abra a pasta *_Test.

  2. Clique com botão direito do mouse no arquivo Add-AppDevPackage.ps1. Escolha Executar com PowerShell e siga os prompts.
    File explorer navigated to PowerShell script shown

    Quando o pacote do aplicativo tiver sido instalado, a janela do PowerShell exibirá esta mensagem: Seu aplicativo foi instalado com êxito.

  3. Clique no botão Iniciar para procurar o aplicativo pelo nome e o inicie.

Próximas etapas: Depurar e testar o pacote do aplicativo

Confira Executar, depurar e testar um pacote do aplicativo para saber como você pode depurar seu aplicativo no Visual Studio ou usando as ferramentas de depuração do Windows.

Gerar um arquivo de upload do pacote do aplicativo para envio à Store

Para distribuir seu aplicativo para a Microsoft Store, recomendamos gerar um arquivo de upload do pacote do aplicativo (.msixupload ou .appxupload) e envie esse arquivo ao Partner Center. Embora seja possível enviar um pacote do aplicativo ou lote de aplicativo ao Partner Center sozinho, recomendamos enviar um arquivo de upload do pacote do aplicativo.

Você pode criar um arquivo de upload do pacote do aplicativo usando o assistente Criar Pacotes do Aplicativo no Visual Studio ou você pode criar um manualmente com base em pacotes do aplicativo ou lotes de aplicativo existentes.

Observação

Se você deseja criar um pacote do aplicativo (.msixbundle ou .appxbundle) manualmente, confira Criar um pacote do aplicativo com a ferramenta MakeAppx.exe.

Criar seu arquivo de upload do pacote do aplicativo usando o Visual Studio

Observação

As instruções e capturas de tela a seguir descrevem o processo do Visual Studio 2019 versão 16.3 em diante. Se estiver usando uma versão anterior, algumas interfaces do usuário poderão ter aparência diferente.

  1. No Gerenciador de Soluções, abra a solução para seu projeto de aplicativo UWP.

  2. Clique com o botão direito do mouse no projeto e escolha Publicar-Criar> Pacotes de Aplicativo (antes do Visual Studio 2019 versão 16.3, o menu Publicar é denominado Loja). Se essa opção estiver desabilitada ou não aparecer, verifique se o projeto é um Projeto universal do Windows.

    Context menu with navigation to Create App Packages

    O assistente Criar pacotes de aplicativo será exibido.

  3. Selecione Microsoft Store usando um novo nome do aplicativo na primeira caixa de diálogo e clique em Avançar.

    Create Your Packages dialog window shown with Microsoft Store

    Se você já tiver associado seu projeto a um aplicativo na Store, também terá uma opção de criar pacotes para o aplicativo da Store associado. Se você escolher Sideload, o Visual Studio não gerará o arquivo (.msixupload ou .appxupload) de upload do pacote do aplicativo para envios ao Partner Center. Se apenas desejar criar um pacote ou lote MSIX para distribuição fora da Store, você poderá selecionar essa opção.

  4. Na próxima página, entre com sua conta de desenvolvedor no Partner Center. Se ainda não tiver uma conta de desenvolvedor, o assistente ajudará você a criar uma.

    Create App Packages window with app name selection shown

  5. Selecione o nome do aplicativo para seu pacote na lista de aplicativos registrados atualmente em sua conta ou reserve um novo se você ainda não reservou um no Partner Center.

  6. Verifique se você selecionou todas as três configurações de arquitetura (x86, x64 e ARM) na caixa de diálogo Selecionar e Configurar Pacotes para verificar se seu aplicativo pode ser implantado na mais ampla variedade de dispositivos. Na caixa de listagem Gerar pacote de aplicativos, selecione Sempre. Um lote de aplicativo (.appxbundle ou .msixbundle) tem preferência sobre um único arquivo de pacote do aplicativo, pois ele contém uma coleção de pacotes do aplicativo configurados para cada tipo de arquitetura do processador. Ao optar por gerar o lote de aplicativo, ele será incluído no arquivo (.appxupload ou .msixupload) de upload do pacote do aplicativo final junto com informações de depuração e análise de falha. Se você não tem certeza de quais arquiteturas escolher ou deseja saber mais sobre quais arquiteturas são usadas por vários dispositivos, confira Arquiteturas do pacote do aplicativo.

    Create App Packages window with package configuration shown

  7. Inclua arquivos de símbolo públicos para Analisar o desempenho do aplicativo no Partner Center depois que seu aplicativo for publicado. Configure detalhes adicionais, como a numeração de versão ou o local de saída do pacote.

  8. Clique em Criar para gerar o pacote do aplicativo. Se você selecionou uma das opções de Desejo criar pacotes para carregar na Microsoft Store na etapa 3 e estiver criando um pacote para envio ao Partner Center, o assistente criará um arquivo (.appxupload ou .msixupload) de upload do pacote. Se você selecionou Desejo criar pacotes para sideload na etapa 3, o assistente criará um único pacote do aplicativo ou um lote de aplicativo com base nas suas seleções na etapa 6.

  9. Quando seu aplicativo for empacotado com êxito, você verá essa caixa de diálogo e poderá recuperar o arquivo de upload do pacote do aplicativo do local de saída especificado. Nesse ponto, você poderá validar seu pacote do aplicativo no computador local ou em um computador remoto e automatizar envios à loja.

    Package creation completed window with validation options shown

Criar seu arquivo de upload do pacote do aplicativo manualmente

  1. Coloque os seguintes arquivos em uma pasta:

    • Um ou mais pacotes do aplicativo (.msix ou .appx) ou um lote de aplicativo (.msixbundle ou .appxbundle).
    • Um arquivo .appxsym. Esse é um arquivo .pdb compactado que contém símbolos públicos do aplicativo usados para a análise de falhas no Partner Center. Você pode omitir esse arquivo, mas, se fizer isso, nenhuma informação de análise de falha ou de depuração estará disponível para seu aplicativo.
  2. Selecione todos os arquivos dentro da pasta, clique com o botão direito do mouse nos arquivos e selecione Enviar para a pasta ->Compressed (zipped).

  3. Altere o nome da extensão do novo arquivo zip de .zip para .msixupload ou .appxupload.

Validar seu pacote do aplicativo

Valide o aplicativo antes de enviá-lo para o Partner Center para certificação em um computador local ou remoto. Você pode validar apenas builds de versão para o pacote do aplicativo, e não builds de depuração. Para obter mais informações sobre como enviar seu aplicativo para o Partner Center, confira Envios de aplicativo.

Validar seu pacote do aplicativo localmente

  1. Na página final Criação do pacote concluída do assistente Criar pacotes do aplicativo, deixe a opção Computador local selecionada e clique em Iniciar Kit de Certificação de Aplicativos Windows. Para obter mais informações sobre como testar seu aplicativo com o Kit de Certificação de Aplicativos Windows, consulte Kit de Certificação de Aplicativos Windows.

    O WACK (Kit de Certificação de Aplicativos Windows) realiza diversos testes e retorna os resultados. Confira Testes do Kit de Certificação de Aplicativos Windows para obter informações mais específicas.

    Se você tiver um dispositivo remoto do Windows 10 que deseja usar para teste, precisará instalar o Kit de Certificação de Aplicativos Windows manualmente nesse dispositivo. A próxima seção irá orientá-lo através destas etapas. Depois de fazer isso, você pode selecionar Computador remoto e clicar em Iniciar o Kit de Certificação de Aplicativos Windows para se conectar ao dispositivo remoto e executar os testes de validação.

  2. Após a conclusão do WACK e a certificação do aplicativo, você estará pronto para enviar seu aplicativo para o Partner Center. Certifique-se de carregar o arquivo correto. O local padrão do arquivo pode ser encontrado na pasta raiz da sua solução \[AppName]\AppPackages e terminará com a extensão de arquivo .msixupload ou .appxupload. O nome será do formulário [AppName]_[AppVersion]_x86_x64_arm_bundle.appxupload ou [AppName]_[AppVersion]_x86_x64_arm_bundle.msixupload se você optar por um lote de aplicativo com todos os pacotes de arquitetura selecionados.

Validar seu pacote do aplicativo em um dispositivo Windows 10 remoto

  1. Habilite seu dispositivo Windows 10 para desenvolvimento seguindo as instruções de Habilitar seu dispositivo para desenvolvimento.

    Importante

    Você não pode validar seu pacote do aplicativo em um dispositivo ARM remoto para Windows 10.

  2. Baixe e instale as ferramentas remotas para Visual Studio. Essas ferramentas são usadas para executar o Kit de Certificação de Aplicativos Windows remotamente. Você pode obter mais informações sobre essas ferramentas, incluindo onde baixá-las, visitando Executar aplicativos MSIX em uma máquina remota.

  3. Baixe o Kit de Certificação de Aplicativos Windows exigido e, depois, instale-o em seu dispositivo Windows 10 remoto.

  4. Na página Criação de Pacotes Concluída do assistente, escolha o botão de opção Máquina Remota e escolha o botão de reticências ao lado do botão Testar Conexão.

    Observação

    O botão de opção Computador Remoto estará disponível somente se você tiver selecionado pelo menos uma configuração de solução compatível com a validação. Para obter mais informações sobre como testar seu aplicativo com o WACK, consulte Kit de Certificação de Aplicativos Windows.

  5. Especifique um formulário de dispositivo dentro da sub-rede ou forneça o nome DNS (Servidor de Nomes de Domínio) ou o endereço IP de um dispositivo que esteja fora da sub-rede.

  6. Na lista Modo de Autenticação, escolha Nenhum se o dispositivo não exigir que você faça logon nele usando suas credenciais do Windows.

  7. Escolha o botão Selecionar e, em seguida, escolha o botão Iniciar o Kit de Certificação de Aplicativos Windows. Se as ferramentas remotas estiverem sendo executadas nesse dispositivo, o Visual Studio se conectará ao aplicativo e, então, realizará os testes de validação. Consulte Testes do Kit de Certificação de Aplicativos Windows.

Automatizar envios à Store

Do Visual Studio 2019 em diante, você pode enviar o arquivo .appxupload gerado à Microsoft Store diretamente do IDE selecionando a opção Enviar automaticamente à Microsoft Store após a validação do Kit de Certificação de Aplicativos Windows no fim do Assistente para Criar pacotes do aplicativo. Esse recurso usa o Azure Active Directory para acessar as informações sobre a conta do Partner Center necessárias para publicar seu aplicativo. Para usar esse recurso, você precisará associar o Azure Active Directory à conta do Partner Center e recuperar várias credenciais necessárias para envios.

Associar o Azure Active Directory à sua conta do Partner Center

Antes de poder recuperar as credenciais necessárias para envios automáticos à Store, primeiro você precisará seguir essas etapas no painel do Partner Center caso não tenha feito isso ainda.

  1. Associar sua conta do Partner Center ao Azure Active Directory de sua organização. Se a sua organização já usa o Office 365 ou outros serviços comerciais da Microsoft, você já tem o Azure AD. Caso contrário, você poderá criar um locatário do Azure AD no Partner Center sem nenhum preço adicional.

  2. Adicionar um aplicativo do Azure AD à sua conta do Partner Center. Esse aplicativo do Azure AD representa o aplicativo ou o serviço que você usará para acessar envios para sua conta do Centro de Desenvolvimento. Você deve atribuir esse aplicativo à função Gerente. Se esse aplicativo já existir no diretório do Azure AD, você poderá selecioná-lo na página Adicionar aplicativos do Azure AD para adicioná-lo à sua conta do Centro de Desenvolvimento. Caso contrário, você pode criar um novo aplicativo do Azure AD na página Adicionar aplicativos do Azure AD.

Recuperar as credenciais necessárias para envios

Em seguida, você poderá recuperar as credenciais do Partner Center necessárias para envios: a ID do Locatário do Azure, a ID do Cliente e a Chave do cliente.

  1. Acesse o painel do Partner Center e entre em com suas credenciais do Azure AD.

  2. No painel do Partner Center, selecione o ícone de engrenagem (ao lado do canto superior direito do painel) e selecione as Configurações do desenvolvedor.

  3. No menu Configurações no painel esquerdo, clique em Usuários.

  4. Clique no nome do seu aplicativo do Azure AD para acessar as configurações do aplicativo. Nesta página, copie os valores da ID do Locatário e da ID do Cliente.

  5. Na seção Chaves, clique em Adicionar nova chave. Na próxima tela, copie o valor Chave, que corresponde ao segredo do cliente. Você não poderá acessar essas informações novamente depois que sair desta página; portanto, não as perca. Para saber mais, veja Gerenciar chaves de um aplicativo do Azure AD.

Configurar envios automáticos à Store no Visual Studio

Após concluir as etapas anteriores, você poderá configurar envios automáticos à Store no Visual Studio 2019.

  1. No fim do assistente para Criar pacotes do aplicativo, selecione Enviar automaticamente para a Microsoft Store após a validação do Kit de Certificação de Aplicativos Windows e clique Reconfigurar.

  2. Na caixa de diálogo Definir configurações de Envio à Microsoft Store, insira a ID do locatário, a ID do Cliente e a chave do Cliente do Azure.

    Configure Microsoft Store Submission settings

    Importante

    Suas credenciais podem ser salvas em seu perfil para serem usados em envios futuros

  3. Clique em OK.

O envio será iniciado depois que o teste de WACK for concluído. Você pode acompanhar o progresso do envio na janela Verificar e Publicar.

Verify and Publish progress