Tutorial: Utilize a API bootstrapper numa aplicação com localização externa ou numa aplicação não empacotada que utilize o Windows App SDK.

Siga estas instruções para configurar um project WinUI em C# que seja empacotado com localização externa ou não empacotado.

1. No Visual Studio, crie um novo projeto de aplicação de consola C#. Nomeie o projeto DynamicDependenciesTest. Depois de criares o projeto, deves ter uma aplicação de consola C# "Olá, Mundo!".

2. De seguida, configura o teu projeto.

   1. Em Solution Explorer, clique com o botão direito do rato no seu projeto e escolha Editar ficheiro de projeto.
   2. Substitua o valor do elemento TargetFramework por um Target Framework Moniker. Por exemplo, use o seguinte se a sua aplicação tiver como alvo o Windows 10, versão 2004.

   <TargetFramework>net8.0-windows10.0.19041.0</TargetFramework>
   

   1. Guarde e feche o ficheiro do project.

3. Altere a plataforma da sua solução para x64. O valor predefinido numa .NET project é AnyCPU, mas o WinUI não suporta essa plataforma.

   1. Selecione Build>Configuration Manager.
   2. Selecione a lista suspensa sob Plataforma de solução ativa e clique em Nova para abrir a caixa de diálogo Nova Plataforma de Solução.
   3. Na lista suspensa em , escolha ou introduza a nova plataforma, e selecione x64.
   4. Clique OK para fechar a caixa de diálogo Nova Plataforma de Solução.
   5. Em Configuration Manager, clique em Fechar.

4. Instale o pacote NuGet do Windows App SDK no seu projecto.

   1. Em Solution Explorer, clique com o botão direito no nó Dependências e escolha Gerir Pacotes Nuget.
   2. Na janela NuGet Package Manager, selecione o separador Browse e instale o pacote Microsoft.WindowsAppSDK.

5. Agora está pronto para usar a API do Bootstrapper (veja Use o tempo de execução do Windows App SDK para aplicações com localização externa ou não empacotadas) para adquirir dinamicamente uma dependência do pacote de framework do Windows App SDK. Isto permite-lhe usar as APIs do Windows App SDK na sua aplicação.

   Abra o arquivo de código Program.cs e substitua o código padrão pelo código a seguir para chamar o Bootstrap.Initialize método para inicializar o bootstrapper. Este código define de que versão do Windows App SDK a aplicação depende ao inicializar o bootstrapper.

   Importante

   Você precisará editar o código abaixo para se adequar à sua configuração específica. Veja as descrições dos parâmetros do método Bootstrap.Initialize para que possa especificar uma das versões do Windows App SDK que tem instaladas.

   using System;
   using Microsoft.Windows.ApplicationModel.DynamicDependency;
   
   namespace DynamicDependenciesTest
   {
       class Program
       {
           static void Main(string[] args)
           {
               Bootstrap.Initialize(0x00010002);
               Console.WriteLine("Hello, World!");
   
               // Release the DDLM and clean up.
               Bootstrap.Shutdown();
           }
       }
   }
   

   Na sua essência, a API bootstrapper é uma API nativa C/C++ que lhe permite usar as APIs do Windows App SDK na sua aplicação. Mas numa aplicação .NET que usa a Windows App SDK 1.0 ou posterior, podes usar o wrapper .NET para a API bootstrapper. Esse wrapper oferece uma forma mais fácil de chamar a API bootstrapper numa aplicação .NET do que chamar diretamente as funções nativas C/C++. O exemplo de código anterior invoca os métodos estáticos Initialize e Shutdown da classe Bootstrap na implementação em .NET para a API de arranque.

6. Para demonstrar que os componentes de execução Windows App SDK foram carregados corretamente, adicione algum código que utilize a classe ResourceManager na Windows App SDK para carregar um recurso de cadeia.

   1. Adicione um novo ficheiro Resources (.resw) ao seu project (mantenha o nome predefinido).

   2. Com o arquivo de recursos aberto no editor, crie um novo recurso de cadeia de caracteres com as seguintes propriedades.

      • Nome: Mensagem
      • Valor: Olá, recursos!

   3. Salve o arquivo de recursos.

   4. Abra o arquivo de código Program.cs e substitua a linha Console.WriteLine("Hello, World!"); pelo código a seguir.

   // Create a resource manager using the resource index generated during build.
      var manager = new Microsoft.Windows.ApplicationModel.Resources.ResourceManager("DynamicDependenciesTest.pri");
   
   // Look up a string in the .resw file using its name.
   Console.WriteLine(manager.MainResourceMap.GetValue("Resources/Message").ValueAsString);
   

   1. Clique Iniciar sem depuração (ou Iniciar a depuração) para compilar e executar a sua aplicação. Você deverá ver a string Hello, resources! exibida com êxito.

Siga estas instruções para configurar um projeto WinUI em C++ que seja empacotado com localização externa ou não empacotado.

1. Em Visual Studio, crie um novo projeto de Aplicação de Consola. Nomeie o projeto DynamicDependenciesTest.

   

   Depois de criares o project, deves ter uma aplicação de consola C++ "Olá, Mundo!".

2. De seguida, instale o pacote NuGet do Windows App SDK no seu projecto.

   1. Em Solution Explorer, clique com o botão direito no nó References e escolha Gerir Pacotes Nuget.
   2. Na janela NuGet Package Manager, selecione o separador Browse e procure por Microsoft.WindowsAppSDK.

3. Agora está pronto para usar a API do bootstrapper (veja Use o runtime do Windows App SDK para aplicações empacotadas com localização externa ou não empacotadas) para inicializar o runtime do Windows App SDK na sua aplicação. Isto permite-lhe usar as APIs do Windows App SDK na aplicação.

   1. Adicione os seguintes ficheiros de inclusão à parte superior do seu ficheiro DynamicDependenciesTest.cpp. O cabeçalho mddbootstrap.h está disponível através do pacote Windows App SDK NuGet.

   #include <windows.h>
   #include <MddBootstrap.h>
   

   1. Em seguida, adicione esse código no início do método principal para chamar a função MddBootstrapInitialize para inicializar o bootstrapper e manipular quaisquer erros. Este código define de que versão do Windows App SDK a aplicação depende ao inicializar o bootstrapper.

   Importante

   Você precisará editar o código abaixo para se adequar à sua configuração específica. Veja as descrições dos parâmetros da função MddBootstrapInitialize para que possa especificar uma das versões da Windows App SDK que tem instalada.

   const UINT32 majorMinorVersion{ 0x00010002 }; 
   PCWSTR versionTag{ L"" }; 
   const PACKAGE_VERSION minVersion{};
   
   const HRESULT hr{ MddBootstrapInitialize(majorMinorVersion, versionTag, minVersion) }; 
   
   // Check the return code for errors. If there is an error, display the result.
   if (FAILED(hr)) 
   { 
       wprintf(L"Error 0x%X in MddBootstrapInitialize(0x%08X, %s, %hu.%hu.%hu.%hu)\n", 
           hr, majorMinorVersion, versionTag, minVersion.Major, minVersion.Minor, minVersion.Build, minVersion.Revision); 
       return hr; 
   } 
   

   1. Finalmente, adicione esse código para exibir a cadeia de caracteres Hello, World! e chame a função MddBootstrapShutdown para desinicializar o bootstrapper.

   std::cout << "Hello, World!\n"; 
   
   // Release the DDLM and clean up.
   MddBootstrapShutdown(); 
   

   1. Seu código final deve ter esta aparência.

   #include <iostream> 
   #include <windows.h> 
   #include <MddBootstrap.h>
   
   int main() 
   { 
       // Take a dependency on Windows App SDK Stable.
       const UINT32 majorMinorVersion{ 0x00010002 }; 
       PCWSTR versionTag{ L"" }; 
       const PACKAGE_VERSION minVersion{};
   
       const HRESULT hr{ MddBootstrapInitialize(majorMinorVersion, versionTag, minVersion) }; 
   
       // Check the return code. If there is a failure, display the result.
       if (FAILED(hr)) 
       { 
           wprintf(L"Error 0x%X in MddBootstrapInitialize(0x%08X, %s, %hu.%hu.%hu.%hu)\n", 
               hr, majorMinorVersion, versionTag, minVersion.Major, minVersion.Minor, minVersion.Build, minVersion.Revision); 
           return hr; 
       } 
   
       std::cout << "Hello, World!\n"; 
   
       // Release the DDLM and clean up.
       MddBootstrapShutdown(); 
   } 
   

4. Clique Iniciar sem depuração (ou Iniciar a depuração) para compilar e executar a sua aplicação.