Empacotar uma aplicação desktop ou UWP no Visual Studio

Antes de distribuir seu aplicativo, você precisa empacotá-lo. Este artigo descreve o processo de configurar, criar e testar um pacote MSIX usando o Visual Studio.

Tipos de pacotes de aplicativos

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

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

• Arquivo de Upload de Pacote de Aplicativo (.msixupload ou .appxupload) - apenas para Envio na Loja
  Um único arquivo que pode conter vários pacotes de aplicativos ou um pacote de aplicativos para suportar várias arquiteturas de processador. O ficheiro de upload do pacote da aplicação também contém um ficheiro de símbolo para Analisar o desempenho da aplicação depois de a sua aplicação ter sido publicada na Microsoft Store. Este ficheiro será criado automaticamente para si se estiver a embalar a sua aplicação com o Visual Studio com a intenção de a submeter ao Partner Center para publicação na Microsoft Store.

Aqui está uma visão geral das etapas para preparar e criar um pacote de aplicativo:

1. Antes de empacotar seu aplicativo. Siga estas etapas para garantir que seu aplicativo esteja pronto para ser empacotado.

2. Configure seu projeto. Use o designer de manifestos do Visual Studio para configurar o pacote. Por exemplo, adicione imagens de mosaico e escolha as orientações suportadas pela sua aplicação.

3. Gere um pacote de aplicativo. Use o assistente de empacotamento do Visual Studio para criar um pacote de aplicação.

4. Execute, depure e teste um aplicativo empacotado. Execute e depure o pacote da sua aplicação a partir do Visual Studio ou instalando o pacote diretamente.

Antes de empacotar seu aplicativo

1. Teste a aplicação. Antes de empacotar seu aplicativo, verifique se ele funciona como esperado em todas as famílias de dispositivos que você planeja suportar. Estas famílias de dispositivos podem incluir desktop, móveis, Surface Hub, Xbox, dispositivos IoT ou outros. Para mais informações sobre como implementar e testar a sua aplicação usando Visual Studio, veja Deploying and debugging UWP apps (também se aplica a aplicações de desktop empacotadas).

2. Otimize seu aplicativo. Pode usar as ferramentas de perfilagem e depuração do Visual Studio para otimizar o desempenho da sua aplicação empacotada. Por exemplo, a ferramenta Linha do tempo para a capacidade de resposta da interface do usuário, a ferramenta Uso da memória, a ferramenta Uso da CPU e muito mais. Para obter mais informações sobre essas ferramentas, consulte o tópico Profiling Feature Tour .

3. Verifica a compatibilidade nativa .NET (para aplicações VB e C#). Na Plataforma Universal do Windows, existe um compilador nativo que melhora o desempenho em tempo de execução da sua aplicação. Com essa alteração, você deve testar seu aplicativo neste ambiente de compilação. Por defeito, a configuração de compilação Release ativa a cadeia de ferramentas nativa .NET nativa, por isso é importante testar a sua aplicação com esta configuração Release e verificar se a sua aplicação se comporta como esperado.

Configure seu projeto

O arquivo de manifesto do aplicativo (Package.appxmanifest) é 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 seu aplicativo e as orientações que seu aplicativo suporta quando um usuário gira o dispositivo.

O designer de manifestos do Visual Studio permite atualizar o ficheiro manifesto sem editar o XML bruto do ficheiro.

Configurar um pacote com o editor de manifesto

1. Em Explorador de Soluções, expanda o nó do projeto da sua aplicação.

2. Dê um duplo clique no ficheiro Package.appxmanifest. Se o ficheiro manifesto já estiver aberto na vista de código XML, o Visual Studio pede para fechar o ficheiro.

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.

   

   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 Embalagem , 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

   A partir do Visual Studio 2019, um certificado temporário não é mais gerado em projetos de desktop ou UWP empacotados. Para criar ou exportar certificados, use os cmdlets do PowerShell descritos no artigo. Nas versões recentes do Visual Studio, também pode assinar a sua aplicação com um certificado armazenado em Azure Key Vault para cenários de desenvolvimento e testes.

   Importante

   Se estiver a publicar a sua aplicação na Microsoft Store, a sua aplicação será assinada com um certificado de confiança para si. Isso permite que o usuário instale e execute seu aplicativo sem instalar o certificado de assinatura de aplicativo associado.

   Se estiver a instalar o pacote da aplicação no seu dispositivo, primeiro tem de confiar no pacote. Para confiar no pacote, o certificado deve ser instalado no dispositivo do usuário.

4. Salve seu arquivo Package.appxmanifest depois de fazer as edições necessárias para seu aplicativo.

Se estiver a distribuir a sua aplicação através da Microsoft Store, o Visual Studio pode associar o seu pacote à Loja. Para isso, clique com o botão direito no nome do seu projeto em Explorador de Soluções e escolha Publicar->Associar Aplicação à Loja (antes da versão 16.3 de Visual Studio 2019, o menu Publicar chamava-se Loja). Você também pode fazer isso no assistente Criar pacotes de aplicativos , que é 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 de aplicativo

As aplicações podem ser instaladas sem serem publicadas na Loja, publicando-as no seu site, usando ferramentas de gestão de aplicações como Microsoft Intune e Gestor de Configuração, etc. Também pode instalar diretamente um pacote MSIX para testes na sua máquina local ou remota.

Criar um pacote de aplicativo usando o assistente de empacotamento

Observação

As seguintes instruções e capturas de ecrã descrevem o processo conforme o Visual Studio 2019 versão 16.3. Se você estiver usando uma versão anterior, parte da interface do usuário pode ter uma aparência diferente. Se estiver a empacotar uma aplicação de ambiente de trabalho, clique com o botão direito no nó do Windows Application Packaging Project.

1. Em Explorador de Soluções, abra a solução para o seu projeto de aplicação.

2. Clique com o botão direito no projeto e escolha Publicar->Criar Pacotes de Aplicações (antes da versão 16.3 de Visual Studio 2019, o menu Publicar chama-se Store).

   

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

   

4. Na página Selecionar método de assinatura , selecione se deseja ignorar a assinatura de empacotamento ou selecionar um certificado para assinatura. Você pode selecionar um certificado do armazenamento de certificados local, selecionar um arquivo de certificado ou criar um novo certificado. Para que um pacote MSIX seja instalado na máquina de um usuário final, ele deve ser assinado com um certificado confiável na máquina.

   

5. Complete a página Selecionar e configurar pacotes conforme descrito na secção Criar o ficheiro de upload do pacote da sua aplicação usando o Visual Studio.

Instale o pacote do aplicativo clicando duas vezes

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

Observação

O App Installer assume que o pacote foi assinado com um certificado confiável no dispositivo. Se não estiver, você precisará instalar o certificado de assinatura no armazenamento de Pessoas Confiáveis ou Autoridades de Certificação de Editores Confiáveis no dispositivo. Se você não tiver certeza de como fazer isso, consulte Instalando certificados de teste.

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

1. Abra a pasta *_Test.

2. Clique com o botão direito do rato no ficheiro Add-AppDevPackage.ps1 . Escolha Executar com PowerShell e siga os prompts.
   

   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 a aplicação pelo nome e, em seguida, inicie-a.

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

Veja Executar, depurar e testar um pacote de aplicações para saber como pode depurar a sua aplicação no Visual Studio ou usando ferramentas de depuração do Windows.

Gerar um ficheiro de upload de pacote de aplicação para envio na Loja

Para distribuir a sua aplicação para a Microsoft Store, recomendamos que gere um ficheiro de upload do pacote app (.msixupload ou .appxupload) e submeta este ficheiro ao Centro de Parceiros. Embora seja possível enviar um pacote ou conjunto de aplicativos diretamente no Partner Center, recomendamos que envie, em vez disso, um ficheiro de carregamento de pacote de aplicativo.

Pode criar um ficheiro de upload de pacotes de aplicações usando o assistente Criar Pacotes de Aplicações no Visual Studio, ou pode criar manualmente a partir de pacotes ou pacotes de aplicações existentes.

Observação

Se você quiser criar um pacote de aplicativo (.msix or.appx) ou pacote de aplicativos (.msixbundle ou .appxbundle) manualmente, consulte Criar um pacote de aplicativo com a ferramenta MakeAppx.exe.

Crie o ficheiro de upload do pacote da sua aplicação usando o Visual Studio

Observação

As seguintes instruções e capturas de ecrã descrevem o processo conforme o Visual Studio 2019 versão 16.3. Se você estiver usando uma versão anterior, parte da interface do usuário pode ter uma aparência diferente.

1. Em Explorador de Soluções, abra a solução para o seu projeto de aplicação UWP.

2. Clique com o botão direito no projeto e escolha Publicar->Criar Pacotes de Aplicações (antes da versão 16.3 de Visual Studio 2019, o menu Publicar chama-se Store). Se esta opção estiver desativada ou não aparecer de todo, verifique se o projeto é um projeto do Universal Windows.

   

   O assistente Criar Pacotes de Aplicativos é exibido.

3. Selecione Microsoft Store usando um novo nome de app na primeira janela de diálogo e depois clique em Próximo.

   

   Se já tiver associado o seu projeto a uma aplicação na Loja, também tem uma opção para criar pacotes para a aplicação da Loja associada. Se escolher Sideloading, Visual Studio não gerará o ficheiro de upload do pacote da aplicação (.msixupload ou .appxupload) para submissões do Partner Center. Se quiseres apenas criar um pacote MSIX ou bundle para distribuição fora da Microsoft Store, podes selecionar esta opção.

4. Na página seguinte, inicie sessão com a sua conta de programador no Partner Center. Se ainda não tiver uma conta de programador, o assistente ajudá-lo-á a criar uma.

   

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

   Observação

   Se estiver a usar o Visual Studio 2017, não poderá listar as aplicações atualmente registadas na sua conta nem reservar novos nomes de aplicações ao usar uma conta conta Microsoft (MSA), apenas contas Microsoft Entra ID (AAD) funcionarão. As contas MSA são suportadas a partir do Visual Studio 2019.

6. Certifique-se de selecionar todas as três configurações de arquitetura (x86, x64 e ARM) na caixa de diálogo Selecionar e Configurar Pacotes para garantir que seu aplicativo possa ser implantado na maior variedade de dispositivos. Na caixa de listagem Gerar pacote de aplicativos , selecione Sempre. Um pacote de aplicativos (.appxbundle ou .msixbundle) é preferível a um único arquivo de pacote de aplicativo porque contém uma coleção de pacotes de aplicativos configurados para cada tipo de arquitetura de processador. Quando você optar por gerar o pacote de aplicativos, o pacote de aplicativos será incluído no arquivo final de upload do pacote de aplicativos (.appxupload ou .msixupload), juntamente com informações analíticas de depuração e falhas. Se não tiver certeza de quais arquiteturas escolher, ou quiser saber mais sobre quais arquiteturas são usadas por vários dispositivos, consulte Arquiteturas de pacotes de aplicativos.

   

7. Inclua arquivos de símbolos públicos para Analisar o desempenho do aplicativo do Partner Center após a publicação do aplicativo. Configure quaisquer detalhes adicionais, como numeração de versão ou o local de saída do pacote.

8. Clique em Criar para gerar o pacote do aplicativo. Se selecionares uma das opções Quero criar pacotes para carregar para as opções Microsoft Store no passo 3 e estiveres a criar um pacote para submissão ao Centro de Parceiros, o assistente criará um ficheiro de upload de pacote (.appxupload ou .msixupload). Caso tenha selecionado Quero criar pacotes para carregamento lateral na etapa 3, o assistente criará um único pacote de aplicação ou um pacote de múltiplas aplicações com base nas suas seleções na etapa 6.

9. Quando o aplicativo tiver sido empacotado com êxito, você verá essa caixa de diálogo e poderá recuperar o arquivo de carregamento do pacote do aplicativo do local de saída especificado. Neste ponto, você pode validar o pacote do aplicativo na máquina local ou em uma máquina remota e automatizar os envios da loja.

   

Crie o arquivo de upload do pacote do aplicativo manualmente

1. Coloque os seguintes arquivos em uma pasta:

   • Um ou mais pacotes de aplicativos (.msix ou .appx) ou um pacote de aplicativos (.msixbundle ou .appxbundle).
   • Um arquivo .appxsym. Este é um arquivo .pdb compactado que contém símbolos públicos do seu aplicativo usado para análise de falhas no Partner Center. Você pode omitir esse arquivo, mas se fizer isso, nenhuma informação analítica ou de depuração de falhas 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> (zipada).

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

Validar o pacote do aplicativo

Valide seu aplicativo antes de enviá-lo ao Partner Center para certificação em uma máquina local ou remota. Você pode validar apenas compilações de versão para o seu pacote de aplicações, não compilações de depuração. Para obter mais informações sobre como enviar seu aplicativo para o Partner Center, consulte Envios de aplicativos.

Valide o pacote do aplicativo localmente

Observação

O Aplicação do Windows Certification Kit (WACK) está em desuso e já não é mantido, mas ainda pode ser usado para verificações locais opcionais antes da submissão. A certificação oficial é realizada automaticamente quando submete o seu pacote ao Centro de Parceiros. Ver submissões de aplicações.

1. Na página final Criação de Pacotes Concluída do assistente Criar Pacotes, deixe a opção Máquina local selecionada e clique em Iniciar Aplicação do Windows Kit de Certificação. Para mais informações sobre como testar a sua aplicação com o Kit de Certificação Aplicação do Windows, consulte Aplicação do Windows Kit de Certificação.

   O Aplicação do Windows Certification Kit (WACK) realiza vários testes e devolve os resultados. Consulte os testes do Kit de Certificação de Aplicações Windows para informações mais específicas.

   Se tiver um dispositivo Windows 10 remoto que queira usar para testes, terá de instalar manualmente o Aplicação do Windows Certification Kit nesse dispositivo. A próxima secção irá guiá-lo através destes passos. Depois disso, podes selecionar Máquina remota e clicar em Iniciar Aplicação do Windows Kit de Certificação para te ligares ao dispositivo remoto e executar os testes de validação.

2. Depois que o WACK for concluído e seu aplicativo for aprovado na certificação, você estará pronto para enviar seu aplicativo ao 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 .appxupload ou .msixupload. O nome terá a forma [AppName]_[AppVersion]_x86_x64_arm_bundle.appxupload ou [AppName]_[AppVersion]_x86_x64_arm_bundle.msixupload se optares por um conjunto de apps com toda a arquitetura de pacotes selecionada.

Valide o pacote da sua aplicação num dispositivo remoto com Windows 10

1. Ative o seu dispositivo Windows 10 para desenvolvimento seguindo as instruções Ative o seu dispositivo para desenvolvimento.

   Importante

   Não pode validar o pacote da sua aplicação num dispositivo ARM remoto para Windows 10.

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

3. Descarregue o kit de certificação Aplicação do Windows obrigatório e instale-o no seu dispositivo Windows 10 remoto.

4. Na página Criação de Pacote Concluída do assistente, escolha o botão de opção Máquina Remota e, em seguida, escolha o botão de reticência ao lado do botão Testar Ligação.

   Observação

   O botão de opção Máquina Remota só estará disponível se você tiver selecionado pelo menos uma configuração de solução que ofereça suporte à validação. Para mais informações sobre como testar a sua aplicação com o WACK, consulte Aplicação do Windows Kit de Certificação.

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 seu dispositivo não exigir que faça login usando as suas credenciais de Windows.

7. Escolha o botão Select e depois selecione o botão Launch Aplicação do Windows Certification Kit. Se as ferramentas remotas estiverem a correr nesse dispositivo, o Visual Studio liga-se ao dispositivo e depois realiza os testes de validação. Consulte Testes do Kit de Certificação de Aplicativos Windows.

Automatize os envios da Loja

Observação

A partir do Visual Studio 2026, a funcionalidade submissões Automate Store não será mais suportada.

A partir do Visual Studio 2019, pode submeter o ficheiro .appxupload gerado à Microsoft Store diretamente no IDE, selecionando a opção Submeter automaticamente à Microsoft Store após a validação do Kit de Certificação de Aplicativos do Windows no final do assistente Criar Pacotes de Aplicações. Esta funcionalidade aproveita o Microsoft Entra ID para aceder à informação da conta do Partner Center necessária para publicar a sua aplicação. Para usar esta funcionalidade, terá de associar o Microsoft Entra ID à sua conta do Partner Center e recuperar várias credenciais necessárias para submissões.

Associe o Microsoft Entra ID à sua conta do Partner Center

Antes de recuperares as credenciais necessárias para envios automáticos na Loja, deverás realizar estes passos no dashboard do Partner Center caso ainda não o tenhas feito.

1. Associe a sua conta do Centro de Parceiros ao Microsoft Entra ID da sua organização. Se a sua organização já utiliza o Office 365 ou outros serviços empresariais da Microsoft, já tem o Azure AD. Caso contrário, pode criar um novo tenant Azure AD a partir do Centro de Parceiros sem custos adicionais.

2. Adicione uma aplicação de AD Azure à sua conta do Centro de parceiros. Esta aplicação Azure AD representa a aplicação ou serviço que irá usar para aceder a submissões da sua conta do Dev Center. Você deve atribuir este aplicativo à função Gerente . Se esta aplicação já existir no seu diretório Azure AD, pode selecioná-la na página Adicionar Azure aplicações AD para a adicionar à sua conta do Dev Center. Caso contrário, pode criar uma nova aplicação Azure AD na página Add Azure AD applications.

Recupere as credenciais necessárias para submissões

De seguida, pode recuperar as credenciais do Centro de Parceiros necessárias para submissões: o ID de Inquilino Azure/c0>, o ID do Cliente e a chave Cliente.

1. Vai ao painel de Partner Center e inicia sessão com as tuas credenciais Azure AD.

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

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

4. Clique no nome da sua aplicação Azure AD para aceder às definições da aplicação. Nesta página, copie os valores ID do Locatário e ID do Cliente .

5. Na seção Chaves , clique em Adicionar nova chave. Na tela seguinte, copie o valor da chave , que corresponde ao segredo do cliente. Você não poderá acessar essas informações novamente depois de sair desta página, portanto, certifique-se de não perdê-las. Para mais informações, consulte Gerenciar chaves para uma aplicação Azure AD.

Configurar submissões automáticas de Store no Visual Studio

Depois de completar os passos anteriores, pode configurar submissões automáticas da Loja no Visual Studio 2019.

1. No final do assistente Criar Pacotes de Aplicações, selecione Submeter automaticamente para a Microsoft Store após a validação pelo Kit de Certificação de Aplicações Windows e clique em Reconfigurar.

2. No diálogo Configurar definições de submissão do Microsoft Store, introduza o ID do locatário do Azure, o ID do cliente e a chave do cliente.

   

   Importante

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

3. Clique em OK.

A submissão começará após o teste WACK ter terminado. Você pode acompanhar o progresso do envio na janela Verificar e publicar .