关于从 UWP 迁移到 Windows 应用 SDK

  • 项目

如果对通用 Windows 平台 (UWP) 中的当前功能感到满意，则无需迁移项目类型。 WinUI 2.x 和 Windows SDK 支持 UWP 项目类型。

但是，如果已决定将应用从 UWP 迁移到 Windows 应用 SDK，则在大多数情况下，UI 代码只需要更改几个命名空间。 大部分平台代码都可以保持不变。 由于桌面应用与 UWP 应用之间的差异，你将需要调整一些代码。 但是，我们预计，对于大多数应用而言（当然，这取决于代码库大小），迁移将按天数而不是周数的顺序进行。 大致来看，这些步骤如下：

  1. 创建你的第一个 WinUI 3 项目打包桌面项目。 这可能进入现有解决方案。
  2. 复制 XAML/UI 代码。 在许多情况下，只需更改命名空间（例如，将 Windows.UI.* 更改为 Microsoft.UI.*）。
  3. 复制应用逻辑代码。 某些 API 需要调整，例如 Popup、Picker 和 SecondaryTile。

注意

如果 UWP 源代码是在已取代的 C ++/CX 中编写的，则将涉及一些源代码移植。 请参阅从 C++/CX 移动到 C++/WinRT。

有关完整的详细信息，请参阅从 UWP 迁移到 Windows 应用 SDK。 该迁移文档介绍如何在任何差异之间进行迁移。

在该内容中，请特别注意从 UWP 迁移到 WinUI 3 时支持的功能。 本主题介绍 WinUI 3 和 Windows 应用 SDK 尚不支持的任何功能。 如果应用需要这些功能/库中的任何一个，请考虑等待迁移。