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

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

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

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

   1. В Обозреватель решений щелкните проект правой кнопкой мыши и выберите команду "Изменить файл проекта".
   2. Замените значение элемента TargetFramework на Moniker Target Framework. Например, используйте следующий код, если приложение предназначено для Windows 10 версии 2004.

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

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

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

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

4. Установите пакет NuGet пакета Sdk для приложений Windows в проекте.

   1. В Обозреватель решений щелкните правой кнопкой мыши узел зависимостей и выберите пункт "Управление пакетами Nuget".
   2. В окне диспетчер пакетов NuGet выберите вкладку "Обзор" и установите пакет Microsoft.WindowsAppSDK.

5. Теперь вы готовы использовать API начального загрузчика (см . статью "Использование среды выполнения пакета SDK для приложений Windows" для приложений, упакованных с внешним расположением или распаковкой) для динамического использования пакета sdk для приложений Windows. Это позволяет использовать API пакета SDK для приложений Windows в приложении.

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

   Внимание

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

   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 начальной загрузки — это собственный API C/C++, который позволяет использовать API пакета SDK для Приложений Windows в приложении. Но в приложении .NET, использующего пакет SDK для приложений Windows 1.0 или более поздней версии, можно использовать оболочку .NET для API начальной загрузки. Эта оболочка обеспечивает более простой способ вызова API загрузчика в приложении .NET, чем вызов собственных функций C/C++ напрямую. Предыдущий пример кода вызывает статические методы инициализации и завершения класса Bootstrap в оболочке .NET для API начальной загрузки.

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

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

   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 3 C++, который упаковывается с внешним расположением или распаковывается.

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

   

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

2. Затем установите пакет NuGet пакета NuGet пакета Sdk для приложений Windows в проекте.

   1. В Обозреватель решений щелкните правой кнопкой мыши узел "Ссылки" и выберите пункт "Управление пакетами Nuget".
   2. В окне диспетчер пакетов NuGet откройте вкладку "Обзор" и найдите Microsoft.WindowsAppSDK.

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

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

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

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

   Внимание

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

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