WinUI 的设置和工具

欢迎来到 Windows 应用开发。 本指南将引导你完成开始使用 WinUI 创建第一个应用所需的步骤。 它还会介绍有助于你详细了解 Windows 开发的资源。

1.启用开发人员模式

Windows 为开发人员提供了一种特殊模式,用于调整安全设置,以便你可以运行你正在处理的应用。 在使用 Visual Studio 生成、部署和测试应用之前,需要启用开发人员模式。

提示

如果现在未启用开发人员模式,Visual Studio 会提示你在尝试生成应用时启用它。

若要启用开发人员模式,请执行以下操作:

  • 打开 Windows 设置并导航到 “系统 > 高级 ”页。
  • 开发人员模式 开关切换为 “开” ,并在确认对话框中确认你的选择。

有关开发人员模式的详细信息,请参阅 开发人员的设置

2.安装 Visual Studio 和所需的工作负载

使用 Visual Studio(Microsoft强大的 IDE)生成、调试和部署 WinUI 应用。 它提供适用于 Windows 和其他平台的现成项目模板,可帮助你快速入门。

免费的 Visual Studio Community Edition 包括开发应用所需的所有内容。 大型团队或企业可能需要 专业 版或 企业 版。 详细了解 什么是 Visual Studio? 以及 Windows 应用开发的系统要求

通过在控制台中运行以下命令之一来安装所需的工具和工作负载。
该命令将打开 Visual Studio 安装程序,其中预选了任何缺少的工作负载,只需选择 “修改” 即可安装它们。

如果愿意,可以将 Community 替换为 ProfessionalEnterprise 来安装这些版本。

对于 C# 应用开发

winget install "Visual Studio Community 2022"  --override "--add Microsoft.VisualStudio.Workload.ManagedDesktop Microsoft.VisualStudio.ComponentGroup.WindowsAppSDK.Cs" -s msstore

为了C++应用开发

winget install "Visual Studio Community 2022"  --override "--add Microsoft.VisualStudio.Workload.NativeDesktop  Microsoft.VisualStudio.ComponentGroup.WindowsAppSDK.Cpp"  -s msstore

3. 创建并启动第一个 WinUI 应用

Visual Studio 项目模板包括快速创建应用所需的所有文件。 事实上,从 WinUI 应用模板创建项目后,已有一个可以运行的应用,然后将代码添加到该应用。

使用 WinUI C# 空白应用项目模板创建新项目:

  1. 打开 Visual Studio,然后从启动页面选择创建新项目。 (如果 Visual Studio 已经向编辑器打开,请选择文件>新建>项目):新建项目

  2. WinUI搜索并选择 WinUI Blank App (Packaged) C# 项目模板,然后选择“下一步空白、打包的 WinUI 3 C# 桌面应用

  3. 指定项目名称,然后选择“ 创建”。 可以选择指定解决方案名称和目录,也可以保留默认值。 在此图中, Hello World 项目属于一个 Hello World 解决方案,该解决方案位于 C:\Projects\指定项目详细信息

    注释

    如果你希望使用此项目在“后续步骤”部分中生成完整的应用,请将该项目命名为 WinUINotes

  4. 选择 “调试 ”开始“按钮以生成并运行项目:
    生成并运行项目
    项目将生成,部署到本地计算机,并在调试模式下运行:
    生成并运行 Hello World 项目

  5. 若要停止调试,请关闭应用窗口,或在 Visual Studio 中选择调试“停止”按钮。

恭喜,你刚刚生成了第一个 WinUI 应用! 继续执行下面的后续步骤,了解详细信息。

后续步骤

  • 若要了解 WinUI 提供的内容,请查看 WinUI 库应用。

    WinUI 3 库应用包括大多数 WinUI 3 控件、特性和功能的交互式示例。 通过 Microsoft Store 获取应用,或在 GitHub 上获取源代码

  • 详细了解 WinUI 基础知识
  • 探索 Fluent Design 原则。
  • 查找示例和工具,帮助更高效地开发应用。