Distribuir uma aplicação WinUI 3 não embalada

A distribuição não empacotada permite-lhe lançar uma aplicação WinUI 3 sem MSIX — útil para cenários empresariais onde a implementação MSIX não está disponível, ou para programadores que preferem uma instalação tradicional baseada em pastas.

Para detalhes sobre todas as opções de embalagem, consulte Vantagens e desvantagens de embalar a sua aplicação.

Se optar por desempacotar uma aplicação WinUI nova ou existente, siga estes passos:

<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 Bootstrapper

Definir a propriedade de projeto <WindowsPackageType>None</WindowsPackageType> faz com que o autoinicializador localize e carregue uma versão do SDK de Aplicações Windows mais adequada para a sua aplicação.

Se tiver necessidades avançadas (como gestão personalizada de erros ou carregar uma versão específica do SDK de Aplicações Windows), então pode chamar explicitamente a API do bootstrapper. Para obter mais informações, consulte Use o runtime do SDK de Aplicações Windows para aplicações empacotadas com localização externa ou não empacotadas, e Tutorial: Use a API de bootstrapper numa aplicação empacotada com localização externa ou não empacotada que usa o SDK de Aplicações Windows.

Para mais informações sobre o bootstrapper, consulte Arquitetura de implementação e visão geral para aplicações dependentes do framework.

Implementação do runtime do SDK de Aplicações Windows

As aplicações WinUI 3 não embaladas dependem do tempo de execução do SDK de Aplicações Windows estar instalado na máquina do utilizador. Tem duas opções para garantir que o tempo de execução está presente:

Opção 1: instalador de tempo de execução SDK de Aplicações Windows (.exe) (recomendado)

Inclua o instalador de runtime do SDK de Aplicações Windows ao lado da sua aplicação. O instalador em tempo de execução é um .exe redistribuível que instala os pacotes de SDK de Aplicações Windows de execução necessários. Descarrega-o da página de lançamentos SDK de Aplicações Windows e inclua-o com o teu próprio instalador ou script de configuração. Para orientações completas, veja Use o tempo de execução SDK de Aplicações Windows para aplicações empacotadas com localização externa ou não empacotadas.

Os utilizadores devem executar o instalador do runtime uma única vez. As atualizações subsequentes da aplicação não requerem a reinstalação do runtime, a menos que a versão necessária do SDK de Aplicações Windows mude.

Opção 2: Implantação autónoma

Define <WindowsAppSDKSelfContained>true</WindowsAppSDKSelfContained> no ficheiro do teu projeto para agrupar o runtime SDK de Aplicações Windows diretamente na pasta de saída da tua app. Isto elimina a dependência do tempo de execução — os utilizadores não precisam de instalar nada separadamente.

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

A contrapartida: a tua pasta de saída é significativamente maior (o tempo de execução completo está incluído), e cada atualização da aplicação transporta toda a carga útil do tempo de execução. Use esta opção para cenários simples de distribuição ou quando não pode controlar o que está instalado na máquina alvo.

→ Implante aplicações não empacotadas que usem o SDK de Aplicações Windows para a referência completa de implementação em tempo de execução.

Limitações dos ficheiros EXE únicos

Se a experiência de distribuição de ficheiros únicos for importante para o seu caso, considere estas alternativas:

• Use o pacote MSIX — os utilizadores têm uma experiência de instalador único (o App Installer trata de todos os ficheiros), e obtêm elegibilidade para a Loja, identidade do pacote e atualizações integradas
• Use um instalador tradicional (WiX, Inno Setup) — envolva a pasta de saída num único instalador EXE que extraia e instale todos os ficheiros necessários de forma transparente
• Usa um framework diferente — WPF e aplicações WinForms com dotnet publish --self-contained -p:PublishSingleFile=truepodem produzir um EXE de ficheiro único, embora algumas dependências nativas ainda possam ser extraídas em tempo de execução

Considerações de distribuição para aplicações não embaladas

As aplicações WinUI 3 não integradas não têm identidade de pacote, o que significa que não podem aceder a certas funcionalidades do Windows:

• Sem atualização automática via App Installer ou Windows Store
• Sem registo de tarefas em segundo plano via manifesto de pacote
• Sem associações de tipos de ficheiro ou manipuladores de protocolo via manifesto de pacote
• Sem personalização de blocos do menu Iniciar através de manifesto de pacote

Se precisar destas funcionalidades, considere o empacotamento com localização externa como um caminho intermédio que adiciona identidade ao pacote sem exigir conversão completa em MSIX.

→ Publique a sua primeira Windows app para uma visão geral completa das opções de distribuição para o WinUI 3 e outros frameworks de Windows app.