教程：在打包到外部位置的应用中使用捆绑器 API，或者在使用 Windows 应用 SDK 的未打包应用中使用它。

按照以下说明配置 C# WinUI 项目，该项目可以打包存储在外部位置，也可以不打包。

1. 在 Visual Studio 中，创建新的 C# Console App project。 将 project DynamicDependenciesTest 命名。 创建项目后，您应该有一个“Hello，World！”的C#控制台应用程序。

2. 接下来，配置您的项目。

   1. 在 Solution Explorer 中，右键单击project并选择 Edit Project File。
   2. 将 TargetFramework 元素的值替换为目标框架标识符。 例如，如果你的应用面向版本 2004 Windows 10，请使用以下内容。

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

   1. 保存并关闭项目文件。

3. 将解决方案的平台更改为 x64。 .NET project中的默认值为 AnyCPU，但 WinUI 不支持该平台。

   1. 选择 Build>Configuration Manager。
   2. 选择“活动解决方案平台”下的下拉列表，单击“新建”选项以打开“新建解决方案平台”对话框。
   3. 在“键入或选择新平台”下的下拉菜单中，选择“x64”。
   4. 选择“确定”以关闭“新建解决方案平台”对话框。
   5. 在 Configuration Manager 中，单击 Close。

4. 在project中安装 Windows App SDK NuGet 包。

   1. 在 Solution Explorer 中，右键单击 Dependencies 节点，然后选择 Manage Nuget Packages。
   2. 在 NuGet Package Manager 窗口中，选择 Browse 选项卡，然后安装 Microsoft.WindowsAppSDK 包。

5. 现在，您已准备好使用引导程序 API（请参阅 将 Windows 应用 SDK 运行时用于打包到外部位置的应用或未打包的应用），以动态依赖 Windows 应用 SDK 框架包。 这样，便可以在应用中使用Windows App SDK API。

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

   引导程序接口本质上是一个本机 C/C++ API，支持你在应用中使用 Windows App SDK 的 API。 但在使用 Windows App SDK 1.0 或更高版本的 .NET 应用中，可以使用引导程序 API 的 .NET 包装器。 该封装器提供了一种在 .NET 应用中更简便地调用引导程序 API 的方法，而不必直接调用本机 C/C++ 函数。 前面的代码示例调用了引导程序 API 的 .NET 封装器中 Bootstrap 类的静态方法 Initialize 和 Shutdown。

6. 为了演示如何正确加载Windows App SDK运行时组件，请添加一些代码，这些代码使用 Windows App SDK 中的 ResourceManager 类来加载字符串资源。

   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! 已成功显示。

请按照以下说明配置 C++ WinUI 项目，无论项目是打包到外部位置还是未打包的。

1. 在 Visual Studio 中，创建新的 C++ Console App project。 将 project DynamicDependenciesTest 命名。

   在 Visual Studio 中命名新的 C++ 应用程序时的屏幕截图

   创建项目后，您将会有一个“Hello, World!” C++ 控制台应用。

2. 接下来，在project中安装 Windows App SDK NuGet 包。

   1. 在 Solution Explorer 中，右键单击 References 节点，然后选择 Manage Nuget Packages。
   2. 在 NuGet Package Manager 窗口中，选择Browse选项卡，然后搜索 Microsoft.WindowsAppSDK。

3. 现在，你可以使用引导程序 API（请参阅 为定位在外部或未打包的应用使用 Windows App SDK 运行时）来初始化你应用中的 Windows App SDK 运行时。 这样，便可以在应用中使用Windows App SDK API。

   1. 将以下包含文件添加到 DynamicDependenciesTest.cpp 文件顶部。 mddbootstrap.h 标头可通过 Windows App SDK NuGet 包获得。

   #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. 单击“启动而不调试”（或“开始调试”）生成并运行你的应用。