Guia de implantação do SDK do Aplicativo Windows para aplicativos autossuficientes

  • Artigo

Um projeto SDK do Aplicativo Windows depende da estrutura por padrão. Para alternar para a implantação independente, siga as etapas abaixo (os termos dependente da estrutura e independente são descritos na visão geral da implantação do SDK do Aplicativo Windows).

  • 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.

  • Para projetos empacotados, no arquivo de projeto do aplicativo, no final do arquivo antes do fechamento </Project>, adicione o Target mostrado abaixo.
  <Target Name="_RemoveFrameworkReferences" BeforeTargets="_ConvertItems;_CalculateInputsForGenerateCurrentProjectAppxManifest">
    <ItemGroup>
      <FrameworkSdkReference Remove="@(FrameworkSdkReference)" Condition="$([System.String]::Copy('%(FrameworkSdkReference.SDKName)').StartsWith('Microsoft.WindowsAppRuntime.'))" />
    </ItemGroup>
  </Target>

Observação

Essa é uma solução alternativa para um bug no SDK do Aplicativo Windows 1.1 e não será necessária com SDK do Aplicativo Windows 1.2. Ele só é necessário para projetos empacotados.

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

Observação

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

Para aplicativos de exemplo, consulte SDK do Aplicativo Windows exemplos de implantação independente.

Depois de definir a WindowsAppSDKSelfContained propriedade como true no arquivo de projeto, o conteúdo do pacote SDK do Aplicativo Windows Framework será extraído para a saída de build e implantado como parte do aplicativo.

Observação

Os aplicativos .NET também precisam ser publicados como independentes para serem totalmente independentes. Consulte este exemplo para saber como configurar o .NET independente com perfis de publicação. dotnet publish ainda não há suporte com SDK do Aplicativo Windows 1.1.

Observação

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

Se o aplicativo for empacotado (para obter mais informações, consulte Visão geral da implantação), as dependências SDK do Aplicativo Windows 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 for empacotado com local externo ou não empacotado, as dependências SDK do Aplicativo Windows serão copiadas ao lado da saída de .exe build. Você pode implantar os arquivos resultantes ou incluí-los em um instalador personalizado.

Dependências em pacotes MSIX adicionais

Um pequeno número de APIs no SDK do Aplicativo 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 independente, terá as seguintes opções:

  1. Você pode tornar sua funcionalidade opcional e acendê-la apenas se e quando possível. Chamar o método IsSupported das APIs (PushNotificationManager.IsSupported e AppNotificationManager.IsSupported) permitirá que você verifique dinamicamente em runtime se as APIs estão ou não disponíveis para o aplicativo de chamada no sistema em que está sendo executado.
    • Isso permite o uso seguro, condicional e opcional das APIs sem comprometer a simplicidade de sua implantação independente.
    • Somente se os serviços do sistema operacional forem instalados fora da implantação do aplicativo, seu aplicativo ativará a funcionalidade apropriada. Mas, na verdade, há alguns casos em que as APIs funcionarão mesmo sem a presença do pacote Singleton; 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 independente.
  3. Não use a API.
    • Considere APIs alternativas que forneçam funcionalidade semelhante sem requisitos adicionais de implantação.

Desativar (ou ativar) no suporte automático ao UndockedRegFreeWinRT

A propriedade do projeto WindowsAppSdkUndockedRegFreeWinRTInitialize foi introduzida na versão 1.2 do SDK do Aplicativo Windows (do canal estável). Se essa propriedade for definida como true , ela garantirá que a implementação do SDK do Aplicativo Windows do Tempo de Execução do Windows sem registro desencaixado (UndockedRegFreeWinRT) seja habilitada automaticamente na inicialização do aplicativo. Esse suporte é necessário para aplicativos independentes não empacotados.

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