欢迎来到 Windows 应用开发。 本指南将引导你完成开始使用最新 Windows 开发框架创建应用所需的步骤:Windows 应用 SDK 和 WinUI。 它还会介绍有助于你详细了解 Windows 开发的资源。 如果需要分步指南设置开发人员环境并使用最新的工具生成第一个 WinUI 应用,请参阅
WinUI 101
。 如果你已经熟悉开发适用于 Windows 的应用,但想要了解有关最新工具的详细信息,请参阅
开发 Windows 桌面应用
。
如果你对开始编写 Windows 应用有疑问,
Microsoft Copilot
是一个很好的资源。
1.启用开发人员模式
Windows 为开发人员提供了一种特殊模式,可调整安全设置,以便运行你正在处理的应用。 在使用 Visual Studio 生成、部署和测试应用之前,需要启用开发人员模式。
如果现在未启用,当你尝试在 Visual Studio 中生成应用时,系统将提示你启用该功能。
若要启用开发人员模式,请执行以下操作:
打开 Windows 设置,并导航到
系统 > 面向开发人员
页。
将开发人员模式开关切换为
开
,并在确认对话框中确认选择。
有关开发人员模式的详细信息,请参阅
启用设备进行开发
。
2.安装 Visual Studio
你将使用
Visual Studio
(Microsoft 的全面的集成开发环境 (IDE))来创建 WinUI 应用。 它是许多 Windows 开发人员的首选开发工具,可帮助编写、调试和部署应用。 Visual Studio 中的项目模板将使你快速开始使用适用于 Windows 和其他许多平台的项目。
在安装这些工具之前,请确保开发计算机满足
Windows 应用开发的系统要求
。
使用以下链接下载并安装最新的 Visual Studio。 安装程序将引导你完成这些步骤;但如果你发现需要详细说明,请参阅
安装 Visual Studio
。
下载 Visual Studio
免费的 Visual Studio Community Edition 包括创建应用所需的一切内容。 如果你与开发团队或企业合作,则可能需要 Visual Studio Professional 或 Visual Studio Enterprise。 有关详细信息,请参阅
什么是 Visual Studio?
。
2.2 所需的工作负载和组件
安装 Visual Studio 时,需要安装使用 WinUI 和 Windows 应用 SDK 进行开发所需的工作负载和组件。 安装后,可以打开 Visual Studio 安装程序应用,并选择
修改
,以添加工作负载和组件。
在 Visual Studio 安装程序应用的
工作负载
选项卡上,选择以下工作负载和组件:
对于使用 Windows 应用 SDK 的
C#
应用开发,请选择
.NET 桌面开发
。
然后,在安装对话框的
安装详细信息
窗格中,选择
Windows 应用 SDK C# 模板
(靠近列表底部)。
对于使用 Windows 应用 SDK 的
C++
应用开发,请选择
使用 C++ 的桌面开发
然后,在安装对话框的“安装详细信息”窗格中,选择“Windows 应用 SDK C++ 模板”(位于列表底部)。
在安装对话框的
单个组件
选项卡上,在
SDK、库和框架
部分,确保选择最新的 Windows SDK。 它将类似于
Windows 11 SDK (10.0.22621.0)
。 在搜索框中键入“Windows SDK”以便于查找。
3. 创建并启动第一个 WinUI 应用
Visual Studio 项目模板包括快速创建应用所需的所有文件。 事实上,在从 WinUI 应用模板创建项目之后,你就已经有了一个可以运行的应用,然后可以将代码添加到该应用。
若要使用 WinUI C# 空白应用项目模板创建新项目,请执行以下操作:
打开 Visual Studio,然后从启动页面选择
创建新项目
。 (如果 Visual Studio 已经向编辑器打开,请选择
文件
>
新建
>
项目
):
搜索
WinUI
,并选择
WinUI Blank App (Packaged)
C# 项目模板,然后单击
下一步
:
指定项目名称,然后单击
创建
。 可以选择指定解决方案名称和目录,也可以保留默认值。 在此图中,
Hello World
项目属于
Hello World
解决方案,该解决方案将位于
C:\Projects\
:
如果你希望使用此项目在“后续步骤”部分中生成完整的应用,请将该项目命名为
WinUINotes
。
单击调试”开始“按钮,生成并运行项目:
项目模板中包含的
MainWindow
类包含一些示例代码,需要删除这些代码才能为内容腾出空间。
双击
MainWindow.xaml
中的
将其打开。 应会看到
StackPanel
控件的 XAML 标记。
删除
StackPanel
的 XAML。 (创建应用时,你将在其位置添加自己的内容。
<!-- ↓ Delete this. ↓ -->
<StackPanel Orientation="Horizontal" HorizontalAlignment="Center" VerticalAlignment="Center">
<Button x:Name="myButton" Click="myButton_Click">Click Me</Button>
</StackPanel>
如果现在尝试运行你的应用,Visual Studio 会抛出一个类似于 The name 'myButton' does not exist in the current context
的错误。 这是因为你删除了名为 Button
的 myButton
控件,但它仍然在 MainPage.xaml.cs
代码隐藏文件中被引用。 也删除代码文件中的引用。
双击MainWindow.xaml.cs
中的 将其打开。
删除 myButton_Click
事件处理程序。
public sealed partial class MainWindow : Window
public MainWindow()
this.InitializeComponent();
// ↓ Delete this. ↓
private void myButton_Click(object sender, RoutedEventArgs e)
myButton.Content = "Clicked";
// End delete.
通过按 CTRL + SHIFT + S、单击工具栏中的“全部保存”图标或选择菜单文件>全部保存来保存文件。
5. 更新到最新的 WinUI/Windows 应用 SDK
Windows 应用 SDK(以及作为其一部分的WinUI)作为 NuGet 包分发。 这意味着更新的发布可能与 Windows 和 Visual Studio 不同步。 因此,用于创建项目的 Visual Studio 模板可能未引用最新的 Windows 应用 SDK NuGet 包。 为了确保拥有最新的功能和修补程序,每次在 Visual Studio 中创建新项目时都应更新 NuGet 包。
要为项目更新 Windows 应用 SDK NuGet 包,请执行以下操作:
在 Visual Studio 解决方案中,加载项目后,选择工具>NuGet 包管理器>管理解决方案的 NuGet 包...。
如果有可用的更新,它将显示在“更新”页面上。 选中所列更新旁的框。 (若要包括预发行版更新,请选中“包括预发行版”选项。若要详细了解更新中包含的内容,请参阅发行说明。)
单击更新按钮,然后在“预览更改”对话框中单击应用,然后接受许可条款以完成更新安装。