Distribuir um aplicativo WinUI 3 não empacotado

A distribuição não empacotada permite que você envie um aplicativo WinUI 3 sem MSIX — útil para cenários empresariais em que a implantação do MSIX não está disponível ou para desenvolvedores que preferem uma instalação tradicional baseada em pastas.

Para obter detalhes sobre todas as opções de empacotamento, consulte Vantagens e desvantagens de empacotar seu aplicativo.

Se você optar por desempacotar um aplicativo WinUI novo ou existente, siga estas etapas:

<Project ...>
  ...
  <PropertyGroup>
    <WindowsPackageType>None</WindowsPackageType><!-- add this -->
    <OutputType>WinExe</OutputType>
    <TargetFramework>net8.0-windows10.0.19041.0</TargetFramework>
    ...
  </PropertyGroup> 
  ...
</Project>

<Project ...>
  ...
  <PropertyGroup Label="Globals">
    ...
    <AppxPackage>false</AppxPackage><!-- update this -->
    <WindowsPackageType>None</WindowsPackageType><!-- add this -->
    ...
  </PropertyGroup> 
  ...
</Project>

"A API do 'bootstrapper'"

Definir a propriedade de projeto <WindowsPackageType>None</WindowsPackageType> faz com que o auto-initializer localize e carregue uma versão do SDK do Aplicativo Windows mais apropriada para seu aplicativo.

Se você tiver necessidades avançadas (como tratamento de erros personalizados ou carregar uma versão específica do SDK do Aplicativo Windows), poderá chamar explicitamente a API bootstrapper. Para obter mais informações, consulte Use o tempo de execução do SDK do Aplicativo Windows para aplicativos que estão empacotados com local externo ou não empacotados e Tutorial: use a API bootstrapper em um aplicativo que está empacotado com local externo ou não empacotado e que utiliza o SDK do Aplicativo Windows.

Para obter mais informações sobre o bootstrapper, consulte a arquitetura de implantação e a visão geral dos aplicativos dependentes da estrutura.

Implantando o runtime do SDK do Aplicativo Windows

Os aplicativos WinUI 3 não empacotados dependem do SDK do Aplicativo Windows runtime que está sendo instalado no computador do usuário. Você tem duas opções para garantir que o tempo de execução (runtime) esteja presente:

Option 1: SDK do Aplicativo Windows instalador de runtime (.exe) (recomendado)

Inclua o instalador do runtime do SDK do Aplicativo Windows junto com o seu aplicativo. O instalador de runtime é um .exe redistribuível que instala os pacotes de runtime SDK do Aplicativo Windows necessários. Baixe-o na página de versões do SDK do Aplicativo Windows e agrupe-o com seu próprio instalador e script de instalação. Para obter orientação completa, consulte Utilize o runtime do SDK do Aplicativo Windows para aplicativos empacotados com local externo ou não empacotados.

Os usuários devem executar o instalador de runtime uma vez. As atualizações subsequentes do aplicativo não exigem a reinstalação do tempo de execução, a menos que a versão necessária do SDK do Aplicativo Windows mude.

Opção 2: implantação autossuficiente

Defina <WindowsAppSDKSelfContained>true</WindowsAppSDKSelfContained> no arquivo de projeto para agrupar o runtime SDK do Aplicativo Windows diretamente na pasta de saída do aplicativo. Isso remove a dependência de runtime – os usuários não precisam instalar nada separadamente.

<PropertyGroup>
  <WindowsPackageType>None</WindowsPackageType>
  <WindowsAppSDKSelfContained>true</WindowsAppSDKSelfContained>
</PropertyGroup>

A compensação: sua pasta de saída é significativamente maior (o runtime completo está incluído) e cada atualização de aplicativo carrega o conteúdo de tempo de execução completo. Use essa opção para cenários de distribuição simples ou quando não é possível controlar o que está instalado no computador de destino.

Implante aplicativos não empacotados que usam o SDK do Aplicativo Windows para a referência completa de implantação do tempo de execução.

Limitação do EXE de arquivo único

Se uma experiência de distribuição de arquivo único for importante para seu cenário, considere estas alternativas:

• Use o MSIX para empacotamento – os usuários obtêm uma única experiência de instalador (o Instalador de Aplicativo manipula todos os arquivos) e você obtém elegibilidade para a Loja, a identidade do pacote e atualizações integradas
• Usar um instalador tradicional (WiX, Instalação Inno) – encapsular a pasta de saída em um único instalador EXE que extrai e instala todos os arquivos necessários de forma transparente
• Utilize uma estrutura diferente — aplicativos WPF e WinForms com dotnet publish --self-contained -p:PublishSingleFile=truecan produzir um EXE de arquivo único, embora algumas dependências nativas ainda possam ser extraídas no runtime

Considerações de distribuição para aplicativos não empacotados

Os aplicativos WinUI 3 não empacotados não têm identidade de pacote, o que significa que eles não podem acessar determinados recursos de Windows:

• Nenhuma atualização automática por meio do Instalador de Aplicativos ou da Windows Store
• Sem registro de tarefa em segundo plano no manifesto do pacote
• Nenhuma associação de tipo de arquivo ou manipuladores de protocolo no manifesto do pacote
• Sem personalização do bloco do menu Iniciar por meio do manifesto do pacote

Se você precisar desses recursos, considere o empacotamento com localização externa como um caminho intermediário que adiciona a identidade do pacote sem a necessidade de conversão completa do MSIX.

→ Publish seu primeiro aplicativo Windows para obter uma visão geral completa das opções de distribuição para o WinUI 3 e outras estruturas de aplicativos Windows.