Tutorial: Usar a API bootstrapper em um aplicativo empacotado com localização externa ou não empacotado que usa o SDK do Aplicativo Windows

Siga estas instruções para configurar um projeto C# WinUI 3 empacotado com local externo ou não empacotado.

1. No Visual Studio, crie um novo projeto de Aplicativo de Console C#. Use o nome DynamicDependenciesTest para o projeto. Depois de criar o projeto, você deve ter um "Olá, Mundo!" Aplicativo de console C#.

2. Em seguida, configure seu novo projeto.

   1. No Gerenciador de Soluções, clique com o botão direito do mouse no projeto e escolha Editar Arquivo de Projeto.
   2. Substitua o valor do elemento TargetFramework por um Moniker de Estrutura de Destino. Por exemplo, use o seguinte se seu aplicativo visar o Windows 10, versão 2004.

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

   1. Salve e feche o arquivo de projeto.

3. Altere a plataforma da solução para x64. O valor padrão em um projeto .NET é AnyCPU,, mas WinUI 3 não oferece suporte a essa plataforma.

   1. Selecione Gerencie>Gerenciador de Configuração.
   2. Selecione a lista suspensa em Plataforma de solução ativa e clique em Novo para abrir a caixa de diálogo Nova Plataforma de Solução.
   3. Na caixa suspensa em Digite ou selecione a nova plataforma, selecione x64.
   4. Clique em OK para fechar a caixa de diálogo Nova Plataforma de Solução .
   5. No Gerenciador de Configurações, clique em Fechar.

4. Instale o pacote NuGet do SDK do Aplicativo Windows no projeto.

   1. No Gerenciador de Soluções, clique com o botão direito do mouse no nó Dependências e escolha Gerenciar Pacotes NuGet.
   2. Na janela Gerenciador de Pacotes NuGet, selecione a guia Procurar e instale o pacote Microsoft.WindowsAppSDK.

5. Agora você está pronto para usar a API bootstrapper (consulte Usar o runtime SDK do Aplicativo Windows para aplicativos empacotados com local externo ou não empacotados) para assumir dinamicamente uma dependência do pacote de estrutura SDK do Aplicativo Windows. Isso permite que você use as APIs do SDK do Aplicativo Windows no aplicativo.

   Abra o arquivo de código Program.cs e substitua o código padrão pelo código a seguir para chamar o método Bootstrap.Initialize para inicializar o bootstrapper. Esse código define de qual versão do SDK do Aplicativo Windows o aplicativo depende ao inicializar o bootstrapper.

   Importante

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

   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();
           }
       }
   }
   

   Em sua raiz, a API bootstrapper é uma API C/C++ nativa que permite que você use as APIs SDK do Aplicativo Windows em seu aplicativo. Mas em um aplicativo .NET que usa o SDK do Aplicativo Windows 1.0 ou posterior, você pode usar o wrapper do .NET para a API bootstrapper. Esse wrapper fornece uma maneira mais fácil de chamar a API bootstrapper em um aplicativo .NET do que chamar as funções C/C++ nativas diretamente. O exemplo de código anterior chama os métodos estáticos Initialize e Shutdown da classe Bootstrap no wrapper do .NET para a API bootstrapper.

6. Para demonstrar que os componentes de runtime do SDK do Aplicativo Windows foram carregados corretamente, adicione um código que use a classe ResourceManager no SDK do Aplicativo Windows para carregar o recurso de cadeia de caracteres.

   1. Adicione um novo arquivo de recursos (.resw) ao seu projeto (deixe o nome padrão).

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

      • Nome: Message
      • Valor: Hello, resources!

   3. Salve o arquivo de recursos.

   4. Abra o arquivo de código Program.cs e substitua a Console.WriteLine("Hello, World!"); linha 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 em Iniciar sem depuração (ou Iniciar depuração) para criar e executar seu aplicativo. Você deve ver a cadeia de caracteres Hello, resources! exibida com êxito.

Siga estas instruções para configurar um projeto C++ WinUI 3 empacotado com local externo ou não empacotado.

1. No Visual Studio, crie um projeto de aplicativo de console C++. Use o nome DynamicDependenciesTest para o projeto.

   

   Depois de criar o projeto, você deve ter um "Olá, Mundo!" Aplicativo de console C++.

2. Em seguida, instale o pacote NuGet do SDK do Aplicativo Windows no projeto.

   1. No Gerenciador de Soluções, clique com o botão direito do mouse no nó Referências e escolha Gerenciar Pacotes NuGet.
   2. Na janela Gerenciador de Pacotes NuGet, selecione a guia Procurar e pesquise Microsoft.WindowsAppSDK.

3. Agora você está pronto para usar a API bootstrapper (consulte Usar o runtime SDK do Aplicativo Windows para aplicativos empacotados com local externo ou não empacotados) para inicializar o runtime SDK do Aplicativo Windows em seu aplicativo. Isso permite que você use as APIs SDK do Aplicativo Windows no aplicativo.

   1. Adicione os seguintes arquivos de inclusão à parte superior do arquivo DynamicDependenciesTest.cpp. O cabeçalho mddbootstrap.h está disponível no pacote do NuGet do SDK do Aplicativo Windows.

   #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 lidar com quaisquer erros. Esse código define de qual versão do SDK do Aplicativo Windows o aplicativo depende ao inicializar o bootstrapper.

   Importante

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

   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. Por fim, adicione esse código para exibir a cadeia de caracteres Hello, World! e chame a função MddBootstrapShutdown para cancelar a inicialização do bootstrapper.

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

   1. O 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 em Iniciar sem depuração (ou Iniciar depuração) para criar e executar seu aplicativo.