准备使用 WinUI 3 进行开发
操作环境
- 窗户
-
- 窗户11
- Visual Studio的
-
- Visual Studio 2022 版本 17.9.3
- 。网
-
- .NET 6
- （.NET 8）
- WinUI的
-
- WinUI 3的
- Windows 应用 SDK
-
- 1.4.230913002
先决条件
在某些情况下，较低版本也可以使用。
- 窗户
-
- 窗户10
- 窗户11
- Visual Studio的
-
- Visual Studio 2022 版本 17.9.3 或更高版本
- 。网
-
- .NET 6
- （.NET 8）
- Windows 应用 SDK
-
- 1.4.230913002 或更高版本
安装 Visual Studio 并设置 WinUI
WinUI 3 开发项目可以通过 Visual Studio 安装进行添加。 本部分提供 Visual Studio 安装过程的简化说明。 有关详细说明，请参阅以下提示。
从 Internet 或媒体启动 Visual Studio 2022 安装程序。 它支持 Community、Professional 或更高版本。
在工作负载选择中，选择 。 NET 桌面开发。
「. NET 桌面开发，然后从右侧的“安装详细信息”中检查 Windows 应用 SDK C# 模板。
现在只需开始安装。 还有其他屏幕，但在他们创建项目之前，我不会解释它们。
安装完成后，创建一个新项目。
右上角的搜索项中有一个， winui 因此当您选择它时，将显示 WinUI 3 项目模板，因此请选择任何模板并创建一个项目。
现在可以使用 WinUI 3 开发应用程序。
如果看到“面向未安装的 .NET 版本”
从 Visual Studio 2022 版本 17.9.1 开始，.NET for WinUI 3 面向 .NET 6。
如果未在 Visual Studio 2022 中选择任何其他运行时，则只会安装 .NET 8 运行时，并且可能会看到如下所示的警告。
如果您担心，可以安装 .NET 6 运行时，或者直接关闭警告。 无需安装 .NET 6 运行时即可进行调试。
如果以后想要添加 WinUI 3 开发环境
如果先安装 Visual Studio，则可以稍后添加 WinUI 3 开发环境。
启动 Visual Studio，然后从菜单中选择“工具”>“获取工具和功能”。
将显示与安装 Visual Studio 时相同的屏幕，因此可以使用 . 确保选中“.NET 桌面开发”，并从右侧的“安装详细信息”中选中“Windows 应用 SDK C# 模板”。
启用开发人员模式
与其他桌面应用程序不同，WinUI 应用程序在安全性增强的环境中运行。 因此，它不能按原样运行。 当您尝试运行它时，您将看到一个如下所示的对话框，系统将提示您启用“开发人员模式”。 如果您单击链接，将显示设置屏幕，因此请启用“开发者模式”。
即使您未使用 Visual Studio，也可以从设置屏幕启用或禁用“开发人员模式”。 从“开始”菜单中选择“设置”。
从“系统”菜单中，选择“面向开发人员”。
有一个“对于开发人员”的切换开关，因此请将其设置为“开”。 将显示一条注释，因此请选择“是”以启用它。
如果要更改为 .NET 8If you want to change to .NET 8
如果使用此模板创建项目，它将默认为 .NET 6。 即使我从项目属性将目标框架更改为 .NET 8，构建仍然显示错误和警告。 但是，在 2024 年 3 月 13 日左右，Windows 应用 SDK 将更新为正式支持 .NET 8。
但是，该模板仍在 .NET 6 中，因此在创建项目后，需要在 .NET 8 上工作。 在未来的版本升级中可能会支持它。
首先，创建一个项目，然后使用 NuGet 更新 Windows 应用 SDK 相关的版本。
除非另有说明，否则一切都是最新的。 Microsoft.WindowsAppSDK 必须至少为 1.5.XXXX。
从项目属性将目标框架更改为 .NET 8。
即使您在此状态下构建，也会显示错误，因为项目设置已过时。
将项目文件作为代码打开。
RuntimeIdentifiers由于有一个参数，请删除如下字符10 Win10 。
修改前
<RuntimeIdentifiers>win10-x86;win10-x64;win10-arm64</RuntimeIdentifiers>
↓
修复后
<RuntimeIdentifiers>win-x86;win-x64;win-arm64</RuntimeIdentifiers>
它还会重写程序的发布设置。
打开 PublishProfiles 文件夹中的“属性”>每个 .pubxml 文件。
RuntimeIdentifier 同样，删除 的参数中的Win10字符10。
之后，重建并验证没有错误或警告。
.pubxml （文件中会有一个警告，但您不必担心它，因为它与此问题的语法不同。 )
但是，出于某种原因，即使您执行与上述相同的操作，WinUI 类库仍会继续发出警告。 目前，您可以运行它，所以让我们等到这个问题得到解决。