WinUI

Gerar um aplicativo criado com o WinUI 3 para que ele possa ser executado em um formato EXE autônomo

Página atualizada :
Data de criação de página :

Ambiente operacional

Windows
  • janelas 11
Visual Studio
  • Visual Studio 2022 versão 17.12.3
.REDE
  • .NET 8
WinUI
  • WinUI 3
SDK do Aplicativo Windows
  • 1.6.3 (1.6.241114003)

Pré-requisitos

Em alguns casos, versões inferiores também podem funcionar.

Windows
  • janelas 10
  • janelas 11
Visual Studio
  • Visual Studio 2022 versão 17.12 ou posterior
.REDE
  • .NET 8 ou posterior
SDK do Aplicativo Windows
  • 1.6.0 ou posterior

Inicialmente

Os aplicativos criados com o WinUI 3 normalmente são aplicativos empacotados que só podem ser executados em circunstâncias especiais. Para executá-lo, você precisa baixá-lo e instalá-lo na Microsoft Store. Há também um método de distribuição de arquivos diretamente, mas requer procedimentos e configurações um tanto complicados e não é adequado para distribuição a um número não especificado de pessoas. Em vez disso, você pode executar seu aplicativo em um ambiente altamente seguro.

O método introduzido desta vez permite que você crie um arquivo EXE por método não empacotado, para que você possa distribuir o arquivo EXE para o usuário como está e executá-lo. Se você quiser fazer com que um aplicativo escrito com WindowsForm ou WPF tenha a mesma aparência que você deseja que ele seja distribuído, essa abordagem é o caminho a seguir.

Atenção

Os produtos relacionados ao WinUI 3 estão sendo atualizados constantemente, portanto, podem não funcionar bem devido a versões diferentes. Acho que esse procedimento funcionará se você corresponder às versões do IDE e do SDK, mas se não funcionar bem, preste atenção às várias versões.

Além disso, os programas escritos com unpackaged têm algumas funcionalidades limitadas em comparação com os programas empacotados. É difícil explicar os detalhes, portanto, verifique se funciona de acordo com o programa que você criou.

pré-condição

Atualizar o Visual Studio 2022

Basicamente, não há problema, desde que você tenha a versão mais recente. Pelo menos a versão no início deste artigo. Execute-o no menu do Visual Studio ou inicie o "Instalador do Visual Studio" no menu Iniciar para atualizá-lo.

Instalar o SDK do Aplicativo Windows (SDK do Aplicativo Windows)

O SDK do Aplicativo Windows incluído na instalação do Visual Studio está desatualizado e deve estar atualizado. Faça o download e instale-o no site a seguir.

Quando executado, o lote será lançado e atualizado sem questionamento.

Criar um projeto

Depois disso, crie o programa que deseja criar. Esta seção descreve o estado do novo projeto.

Atualizar a versão do pacote com o NuGet

Verifique se a versão de "Microsoft.WindowsAppSDK" é pelo menos a versão no início deste artigo. Não há problema com o "Microsoft.Windows.SDK.BuildTools" incluído estar atualizado.

Se você quiser atualizar, poderá fazer isso no pacote gerenciado do NuGet.

Desabilitar o pacote

Abra as propriedades do projeto.

Na categoria "Application > Packaging", há um item chamado "Empacotamento MSIX habilitado para este projeto", então desmarque-o.

Experimente

Se você olhar para a execução de depuração da barra de ferramentas, acho que é "XXXX (Pacote)". Você pode alterá-lo para "XXXX (Unpackaged)" da escolha, portanto, altere-o para Unpackaged.

Depois de alterá-lo, tente executá-lo. Se você puder executá-lo sem erros, não há problema.

Gerando um arquivo EXE

Você pode distribuir o arquivo EXE que é gerado após a construção, mas desta vez vou gerar o arquivo executável no menu "Publicar".

A propósito, para que o processo de "publicação" seja executado com sucesso com o unpackaged, você precisa usar o comando ". NET Desenvolvimento de Área de Trabalho.

Clique com o botão direito do mouse no projeto e escolha Publicar.

Se você estiver começando com um novo projeto, terá três perfis criados desde o início, para que possa selecionar o ambiente no qual deseja implantar. Se você estiver atualizando um projeto, etc., pode não haver um perfil, portanto, nesse caso, crie um novo perfil.

Em Mais ações, selecione Editar.

Por algum motivo, as configurações são diferentes do perfil, como as configurações iniciais, portanto, corresponda ao perfil da seguinte maneira.

Nome do parâmetro, valor de configuração, comentários
configuração Lançamento xXX Por favor, altere-o de acordo com o seu perfil. Se for win-x64, é Release x64.
Estrutura de destino Alinhe-se com seu projeto atual
Modos de implantação Independente Na especificação atual, apenas "independente" funciona.
Tempo de execução de destino vitória-xXX Por favor, altere-o de acordo com o seu perfil. Se for win-x64, torne-o win-x64.
Local de destino Deixe o valor padrão
Criando um único arquivo desligado De acordo com a especificação atual, ele não pode ser executado mesmo que seja criado em um único arquivo.
ReadyToRun arbitrário Confira se você deseja melhorar o desempenho.
Cortando código não utilizado arbitrário Marque se quiser reduzir o tamanho do arquivo. Observe que ele não funcionará dependendo da criação do programa.

Quando terminar, clique no botão "Enviar".

Verifique se a publicação foi bem-sucedida sem erros.

Você pode abrir o arquivo publicado clicando no link Local de destino.

Se você puder executar o arquivo EXE e iniciá-lo, você está pronto para ir. Se você deseja distribuir, precisa pegar o conjunto completo de arquivos nesta pasta. 「. Não há problema em excluir arquivos que não são necessários para a execução, como arquivos ".pdb".

Prepare-se para desenvolver com o WinUI 3