Compartilhar via

Guia de implantação do SDK de Aplicativos do Windows para aplicativos autônomos

Um projeto do SDK de Aplicativo do Windows, por padrão, é dependente de uma estrutura. Para alternar para a implantação autocontida, siga as etapas abaixo (os termos dependente da estrutura e autocontido são descritos na visão geral sobre a implantação do Windows App SDK).

  • No Visual Studio, clique com o botão direito do mouse no nó do projeto do aplicativo e clique em Editar Arquivo de Projeto para abrir o arquivo de projeto do aplicativo para edição. Para um projeto C++, primeiro clique em Descarregar Projeto.
  • No arquivo de projeto do aplicativo, dentro do principal PropertyGroup, adicione <WindowsAppSDKSelfContained>true</WindowsAppSDKSelfContained> conforme mostrado na captura de tela abaixo.

Captura de tela mostrando a propriedade WindowsAppSDKSelfContained definida em um arquivo de projeto.

  • Salve e feche o arquivo de projeto.
  • Clique em Recarregar Projeto.
  • Se você estiver usando o Projeto de Empacotamento de Aplicativos do Windows (em vez do MSIX de projeto único que você obtém com Aplicativo em Branco, Empacotado (WinUI 3 em Desktop)), faça todas as alterações acima também no arquivo de projeto para o projeto de empacotamento.

Observação

Projetos de biblioteca não devem ser alterados. A implantação autocontida só deve ser configurada em projetos de aplicativo (e, quando aplicável, em um Projeto de Empacotamento de Aplicativos Windows ).

Para ver aplicativos de exemplo, consulte exemplos independentes de implantação do SDK de Aplicativos do Windows.

Depois de definir a WindowsAppSDKSelfContained propriedade true no arquivo de projeto, o conteúdo do pacote do Windows App SDK Framework será extraído para o resultado da compilação e implantado como parte do aplicativo.

Observação

Os aplicativos .NET precisam ser publicados como autossuficientes para serem totalmente independentes. Consulte este exemplo para saber como configurar o .NET autossuficiente com perfis de publicação. dotnet publish ainda não é suportado pelo Windows App SDK 1.1.

Observação

Os aplicativos C++ precisam usar o CRT híbrido também para serem totalmente auto-suficientes. Importar HybridCRT.props de Directory.Build.props é a maneira recomendada de configurá-lo para todos os projetos em uma solução (consulte um exemplo em Directory.Build.props). Um aplicativo empacotado também deve definir <UseCrtSDKReferenceStaticWarning>false</UseCrtSDKReferenceStaticWarning> em seu arquivo de projeto. Consulte o exemplo de aplicativo de implantação independente para saber como usar o CRT híbrido.

Se o aplicativo estiver empacotado (para obter mais informações, consulte Visão geral da implantação), as dependências do Windows App SDK serão incluídas como conteúdo dentro do pacote MSIX. A implantação do aplicativo ainda requer o registro do pacote MSIX como qualquer outro aplicativo empacotado.

Se o aplicativo estiver empacotado com local externo ou desempacotado, as dependências do SDK do Aplicativo do Windows serão copiadas ao lado do .exe na saída do build. Você pode implantar os arquivos resultantes usando xcopy ou incluí-los em um instalador personalizado.

Dependências de pacotes MSIX adicionais

Um pequeno número de APIs no SDK de Aplicativo do Windows depende de pacotes MSIX adicionais que representam a funcionalidade crítica do sistema operacional (SO).

Isso significa que, se você quiser usar essas APIs em um aplicativo autossuficiente, terá as seguintes opções:

  1. Você pode tornar sua funcionalidade opcional e ativá-la somente se e quando possível. Chamar o método IsSupported das APIs (PushNotificationManager.IsSupported e AppNotificationManager.IsSupported) permitirá verificar dinamicamente em runtime se as APIs estão disponíveis ou não para o aplicativo de chamada no sistema em que ele está sendo executado.
    • Isso possibilita o uso seguro, condicional e opcional das APIs, sem comprometer a simplicidade da sua implantação independente.
    • Somente se os serviços de sistema operacional estiverem instalados fora da implantação do aplicativo o aplicativo acenderá a funcionalidade apropriada. Mas, na verdade, há alguns casos em que as APIs funcionarão mesmo sem que o pacote Singleton esteja presente; portanto, chamar IsSupported para verificar geralmente é uma boa ideia.
  2. Implante os pacotes MSIX necessários como parte da instalação do aplicativo.
    • Isso permite que você dependa da API em todos os cenários. Mas exigir a implantação de dependências do pacote MSIX como parte da implantação do aplicativo pode comprometer a simplicidade da implantação autocontida.
  3. Não use a API.
    • Considere APIs alternativas que fornecem funcionalidade semelhante sem requisitos de implantação adicionais.

Optar por não participar (ou participar) do suporte automático Desencaixado RegFree WinRT

A propriedade do projeto WindowsAppSdkUndockedRegFreeWinRTInitialize foi introduzida na versão 1.2 do SDK do Aplicativo do Windows (do canal estável). Se essa propriedade estiver definida como verdadeiro, ela garantirá que a implementação do Windows App SDK do Windows Runtime desacoplado sem registro (UndockedRegFreeWinRT) seja ativada automaticamente ao iniciar o aplicativo. Esse suporte é necessário para aplicativos autocontidos não empacotados.

WindowsAppSdkUndockedRegFreeWinRTInitialize padrões para verdadeiro se WindowsAppSDKSelfContained for verdadeiro e WindowsPackageType é None e (a partir da versão 1.2 do SDK do Aplicativo Windows) a propriedade de projeto OutputType está definida como Exe ou WinExe (ou seja, o projeto produz um executável). Essa última condição é para impedir, por padrão, a adição de suporte automático de UndockedRegFreeWinRT a DLLs de bibliotecas de classes e outros arquivos não executáveis. Se você precisar de suporte automático para UndockedRegFreeWinRT em um arquivo que não é executável (por exemplo, uma DLL de teste carregada por um executável de processo de host que não inicializa UndockedRegFreeWinRT), então você pode habilitá-la explicitamente em seu projeto com <WindowsAppSdkUndockedRegFreeWinRTInitialize>true</WindowsAppSdkUndockedRegFreeWinRTInitialize>.

  • Last updated on