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

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 Explorador de Soluções, 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>Gestor de Configuração.
   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 Gestor de Configuração, clique em Fechar.

4. Instale o pacote NuGet do SDK de Aplicações Windows no seu projecto.

   1. Em Explorador de Soluções, clique com o botão direito no nó Dependências e escolha Gerir Pacotes Nuget.
   2. Na janela NuGet Gestor de Pacotes, 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 SDK de Aplicações Windows para aplicações com localização externa ou não empacotadas) para adquirir dinamicamente uma dependência do pacote de framework do SDK de Aplicações Windows. Isto permite-lhe usar as APIs do SDK de Aplicações Windows 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 SDK de Aplicações Windows 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 SDK de Aplicações Windows 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 SDK de Aplicações Windows na sua aplicação. Mas numa aplicação .NET que usa a SDK de Aplicações Windows 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 SDK de Aplicações Windows foram carregados corretamente, adicione algum código que utilize a classe ResourceManager na SDK de Aplicações Windows 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 SDK de Aplicações Windows no seu projecto.

   1. Em Explorador de Soluções, clique com o botão direito no nó References e escolha Gerir Pacotes Nuget.
   2. Na janela NuGet Gestor de Pacotes, selecione o separador Browse e procure por Microsoft.WindowsAppSDK.

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