Руководство: Использование API загрузчика в приложении, упакованном с внешним расположением или без упаковки, использующим Windows App SDK

Следуйте этим инструкциям, чтобы настроить WinUI проект на C#, который либо упакован с внешним местоположением, либо не упакован.

1. В Visual Studio создайте новый проект C# Console App. Назовите project DynamicDependenciesTest. После создания project у вас должно быть консольное приложение "Hello, World!" C#.

2. Затем настройте проект.

   1. В Solution Explorer щелкните правой кнопкой мыши project и выберите Edit Project File.
   2. Замените значение элемента TargetFramework на указатель платформы. Например, используйте следующую команду, если приложение предназначено для Windows 10 версии 2004.

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

   1. Сохраните и закройте файл project.

3. Измените платформу решения на x64. Значение по умолчанию в .NET project равно AnyCPU, но WinUI не поддерживает такую платформу.

   1. Выберите Build>Configuration Manager.
   2. Выберите раскрывающийся список в разделе "Активная платформа решения" и нажмите кнопку "Создать", чтобы открыть диалоговое окно "Новая платформа решения".
   3. В раскрывающемся списке в разделе "Тип" или выберите новую платформу, выберите x64.
   4. Нажмите кнопку "ОК ", чтобы закрыть диалоговое окно "Новая платформа решения".
   5. В Configuration Manager щелкните Close.

4. Установите пакет NuGet Windows App SDK в project.

   1. В Solution Explorer щелкните правой кнопкой мыши узел Dependencies и выберите Управление пакетами Nuget.
   2. В окне NuGet Package Manager выберите вкладку Browse и установите пакет Microsoft.WindowsAppSDK.

5. Теперь вы готовы использовать API Bootstrapper (см. Использование среды выполнения Windows App SDK для приложений, размещенных в сторонних местах или без упаковки), чтобы динамически создавать зависимость от пакета фреймворка Windows App SDK. Это позволяет использовать api Windows App SDK в приложении.

   Откройте файл кода Program.cs и замените код по умолчанию следующим кодом, чтобы вызвать метод Bootstrap.Initialize для инициализации начального загрузчика. Этот код определяет, от какой версии Windows App SDK зависит приложение при инициализации начального загрузчика.

   Внимание

   Чтобы соответствовать определенной конфигурации, необходимо изменить приведенный ниже код. См. описание параметров метода Bootstrap.Initialize, чтобы указать одну из установленных версий Windows App SDK.

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

   API bootstrapper в основе — это собственный API C/C++, который позволяет использовать API Windows App SDK в вашем приложении. Но в приложении .NET, использующего Windows App SDK 1.0 или более поздней версии, можно использовать оболочку .NET для API начальной загрузки. Эта оболочка обеспечивает более простой способ вызова API загрузчика в приложении .NET, чем вызов собственных функций C/C++ напрямую. В предыдущем примере кода вызываются статические методы Initialize и Shutdown класса Bootstrap в оболочке .NET для интерфейса начальной загрузки.

6. Чтобы продемонстрировать правильность загрузки компонентов среды выполнения Windows App SDK, добавьте код, использующий класс ResourceManager в Windows App SDK для загрузки строкового ресурса.

   1. Добавьте новый файл Resources File (RESW) в project (оставьте имя по умолчанию).

   2. Открыв файл ресурсов в редакторе, создайте новый строковый ресурс со следующими свойствами.

      • Имя: сообщение
      • Значение: Hello, resources!

   3. Сохраните файл ресурсов.

   4. Откройте файл кода Program.cs и замените Console.WriteLine("Hello, World!"); строку следующим кодом.

   // 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. Нажмите кнопку "Пуск без отладки " (или "Начать отладку"), чтобы создать и запустить приложение. Должно быть видно, что строка Hello, resources! отображается успешно.

Следуйте этим инструкциям, чтобы настроить WinUI проект C++, который упакован с внешним расположением или не упакован.

1. В Visual Studio создайте новый проект консольного приложения. Назовите project DynamicDependenciesTest.

   

   После создания проекта у вас должно быть консольное приложение "Hello, World!" на C++.

2. Затем установите пакет NuGet Windows App SDK в project.

   1. В Solution Explorer щелкните правой кнопкой мыши узел References и выберите Управление пакетами NuGet.
   2. В окне NuGet Package Manager выберите вкладку Browse и найдите Microsoft.WindowsAppSDK.

3. Теперь вы готовы использовать API Bootstrapper (см. Использование среды выполнения Windows App SDK для приложений, упакованных с внешним расположением или без упаковки) для инициализации среды выполнения Windows App SDK в вашем приложении. Это позволяет использовать Windows App SDK API в приложении.

   1. Добавьте следующие файлы в верхнюю часть файла DynamicDependenciesTest.cpp . Заголовок mddbootstrap.h доступен через пакет NuGet Windows App SDK.

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

   1. Затем добавьте этот код в начале основного метода, чтобы вызвать функцию MddBootstrapInitialize для инициализации начального загрузчика и обработки ошибок. Этот код определяет, от какой версии Windows App SDK зависит приложение при инициализации начального загрузчика.

   Внимание

   Чтобы соответствовать определенной конфигурации, необходимо изменить приведенный ниже код. См. описание параметров функции MddBootstrapInitialize, чтобы указать одну из установленных версий Windows App SDK.

   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. Наконец, добавьте этот код, чтобы отобразить строку Hello, World! и вызвать функцию MddBootstrapShutdown, чтобы деинициализировать загрузчик.

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

   1. Окончательный код должен выглядеть следующим образом.

   #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. Нажмите кнопку "Пуск без отладки " (или "Начать отладку"), чтобы создать и запустить приложение.