Configure seu aplicativo desktop para o empacotamento com MSIX no Visual Studio

• Se o seu aplicativo da área de trabalho for um aplicativo WinUI 3, confira Empacotar seu aplicativo usando o MSIX de projeto único. Um aplicativo WinUI 3 é aquele que usa a estrutura da Biblioteca de Interface do Usuário do Windows (WinUI) 3 para sua interface do usuário (interface do usuário); e usa o SDK do Aplicativo do Windows.
• Mas para todos os outros tipos de aplicativos para computador, continue a leitura deste tópico.

Você pode usar o projeto do Projeto de Empacotamento de Aplicativos do Windows no Visual Studio para gerar um pacote para seu aplicativo da área de trabalho. Em seguida, você pode distribuir seu pacote para a Microsoft Store, na Web, em sua empresa ou em qualquer outro mecanismo de distribuição que você esteja usando.

Carga de trabalho e versão necessárias do Visual Studio

O projeto do Projeto de Empacotamento de Aplicativos do Windows está disponível no Visual Studio 2017 15.5 e posterior.

Para ver o modelo do Projeto de Empacotamento de Aplicativos do Windows no menu 'Adicionar Novo Projeto', você precisa verificar se tem pelo menos uma das seguintes cargas de trabalho do Visual Studio instaladas:

• A carga de trabalho de "desenvolvimento da Plataforma Universal do Windows"
• O Componente Opcional 'Ferramentas de Empacotamento MSIX' na carga de trabalho do .NET Core.
• O Componente Opcional 'Ferramentas de Empacotamento MSIX' na carga de trabalho de desenvolvimento para desktop com .NET.

Para obter a melhor experiência, recomendamos que você use a versão mais recente do Visual Studio.

Importante

O projeto do Projeto de Empacotamento de Aplicativos do Windows no Visual Studio tem suporte no Windows 10, versão 1607 e posterior. Ele só pode ser usado em projetos destinados à Atualização de Aniversário do Windows 10 (10.0; Build 14393) ou uma versão posterior.

Aqui estão algumas outras coisas que você pode fazer no Projeto de Empacotamento de Aplicativos do Visual Studio:

✔️ Gerar ativos visuais automaticamente.

✔️ Faça alterações no manifesto usando um designer visual.

✔️ Gere seu pacote ou agrupamento usando um assistente.

✔️ (Se estiver publicando na Microsoft Store) Atribua facilmente uma identidade ao seu aplicativo de um nome que você já reservou no Partner Center.

Preparar seu aplicativo

Examine este guia antes de começar a criar um pacote para seu aplicativo: Prepare-se para empacotar um aplicativo da área de trabalho.

Configurar o Projeto de Empacotamento de Aplicativos do Windows em sua solução

1. No Visual Studio, abra a solução que contém seu projeto de aplicativo da área de trabalho.

Observação

Se você quiser empacotar seu projeto na configuração x64, verifique se configurou o projeto referenciado para x64. Para confirmar isso, consulte [Notas adicionais](#Additional notes) abaixo.

1. Adicione um projeto do Projeto de Empacotamento de Aplicativos do Windows à sua solução, escolhendo o idioma apropriado (C# ou C++) que corresponde ao idioma do projeto do aplicativo dekstop existente.

   Você não precisará adicionar nenhum código ao projeto de empacotamento. Sua finalidade é apenas gerar e configurar um pacote para você. Vamos nos referir a esse projeto como o projeto de empacotamento.

   

2. Defina a versão de destino deste projeto para qualquer versão desejada, mas certifique-se de definir a Versão Mínima como não inferior à Atualização de Aniversário do Windows 10.

   

3. Defina o projeto do Projeto de Empacotamento de Aplicativos do Windows como o projeto de inicialização (clique com o botão direito do mouse no projeto e selecione Definir como Projeto de Inicialização).

4. No Gerenciador de Soluções, clique com o botão direito do mouse na pasta Dependências no projeto de empacotamento e escolha Adicionar Referência do Projeto....

   

5. Escolha seu projeto de aplicativo da área de trabalho e, em seguida, escolha o botão OK .

   

   Você pode incluir vários aplicativos da área de trabalho em seu pacote, mas apenas um deles pode iniciar quando os usuários escolherem o tile do aplicativo. Na Aplicações, clique com o botão direito do mouse no aplicativo que deseja que os usuários iniciem ao escolherem o tile do app e, em seguida, escolha Definir como Ponto de Entrada.

   

6. Crie o projeto de empacotamento para garantir que nenhum erro apareça. Se você receber erros, abra o Configuration Manager e verifique se seus projetos têm como destino a mesma plataforma.

   

7. Use o assistente Criar Pacotes de Aplicativos para gerar um pacote/pacote MSIX ou um arquivo .msixupload/.appxupload (para publicação na Microsoft Store).

Observações adicionais

Para criar o WAP para a plataforma x64, siga uma das seguintes etapas:

Abordagem 1: Antes de adicionar o projeto WAP em qualquer um dos projetos, adicione a arquitetura x64 por meio do configuration manager (conforme mostrado na captura de tela abaixo).

Abordagem 2: Para os projetos existentes em que o WAP foi adicionado,

1. Remova as entradas x64 da entrada de arquivos .sln manualmente.

_Global_
_GlobalSection(SolutionConfigurationPlatforms) = preSolution_
_Debug|Any CPU = Debug|Any CPU_
_Debug|ARM = Debug|ARM_
_Debug|ARM64 = Debug|ARM64_ (remove)
_Debug|x64 = Debug|x64_ (remove)
_Debug|x86 = Debug|x86_
_Release|Any CPU = Release|Any CPU_
_Release|ARM = Release|ARM_
_Release|ARM64 = Release|ARM64_ (remove)
_Release|x64 = Release|x64_ (remove)
_Release|x86 = Release|x86"_

2. Após a etapa 1, adicione configurações x64 por meio do configuration manager.

Próximas etapas

Empacote seu aplicativo da área de trabalho no Visual Studio

Veja Empacotar um aplicativo Desktop ou UWP no Visual Studio

Executar, depurar ou testar seu aplicativo de desktop

Consulte Executar, depurar e testar um aplicativo empacotado

Recursos adicionais

Melhore seu aplicativo de desktop ao adicionar APIs UWP

Confira Aprimorar seu aplicativo da área de trabalho para Windows 10

Estender seu aplicativo da área de trabalho adicionando projetos UWP e componentes do Windows Runtime

Veja Extenda seu aplicativo de área de trabalho com componentes UWP modernos.

Distribuir seu aplicativo

Confira Distribuir um aplicativo da área de trabalho empacotado