关于从 UWP 迁移到 Windows App SDK

如果对 Universal Windows Platform (UWP) 中的当前功能满意,则无需迁移项目类型。 WinUI 2.x 和 Windows SDK 支持 UWP 项目类型。

但是,如果已决定将应用从 UWP 迁移到 Windows App SDK,则在大多数情况下,UI 代码只需更改几个命名空间。 你的大部分平台代码可以保持不变。 由于桌面应用和 UWP 应用之间的差异,需要调整一些代码。 但是,我们预计对于大多数应用 (代码库大小,当然) ,迁移将按天数(而不是周)顺序进行。 从较高层面来说,这些步骤包括:

  1. 创建第一个 WinUI 3 项目打包 桌面项目。 这可能会进入现有解决方案。
  2. 复制 XAML/UI 代码。 在许多情况下,只需更改命名空间 (例如,Windows。UI.*Microsoft.UI.*) 。
  3. 复制应用逻辑代码。 某些 API 需要调整,例如 PopupPickerSecondaryTiles

有关完整详细信息,请参阅从 UWP 迁移到 Windows App SDK。 该迁移文档介绍了如何跨任何差异进行迁移。

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