Visual Studio 中的 WinUI 3 模板
设置开发计算机后（请参阅 WinUI 入门），即可在 Visual Studio 中通过其中一个 WinUI 3 项目模板开始创建 WinUI 3 应用。 本主题介绍可用的项目和项模板。
若要访问 WinUI 3 项目模板，在“新建项目”对话框的下拉筛选器中，分别选择“C#”/“C++”、“Windows”和“WinUI”。 或者可以搜索“WinUI”并选择一个可用的 C# 或 C++ 模板。
适用于 WinUI 3 的项目模板
可以使用这些 WinUI 3 项目模板开始创建应用。
打包的空白应用（桌面版 WinUI 3）
此项目模板使用基于 WinUI 3 的用户界面创建桌面 .NET (C#) 或本机 Win32 (C++) 应用。 生成的项目包括一个基本窗口，该窗口派生自 WinUI 3 库中的 Microsoft.UI.Xaml.Window 类，可用于生成 UI。 若要详细了解如何使用此项目模板，请参阅创建你的第一个 WinUI 3 项目。
此项目模板的功能因 Windows 应用 SDK 扩展的版本而异。
版本 1.0 预览版 2：从此版本开始，此项目模板生成的应用程序项目会具有将应用生成为 MSIX 程序包所需的程序包清单和其他支持，而无需使用单独的打包项目。 若要使用此项目模板，还必须安装适用于 Visual Studio 的单项目 MSIX 打包工具扩展。
注意
在版本 1.0 预览版 2 及更高版本中，此项目模板仅在生成的 MSIX 程序包中支持单个可执行文件。 如果需要将多个可执行文件合并到单个 MSIX 程序包中，则需要使用“使用 Windows 应用程序打包项目打包的空白应用（桌面版 WinUI 3）”项目模板或向解决方案添加 Windows 应用程序打包项目。
版本 1.0 预览版 1 及更早版本：在这些版本中，此项目模板生成的解决方案具有单独的 Windows 应用程序打包项目，它配置为将应用生成为 MSIX 程序包。 可以选择安装适用于 Visual Studio 的单项目 MSIX 打包工具扩展，并将打包项目设置合并到应用程序项目中，以便不再需要维护单独的打包项目。
空白应用，使用 Windows 应用程序打包项目（桌面中的 WinUI 3）打包
此项目模板在版本 1.0 预览版 1 及更高版本中提供。 它使用基于 WinUI 3 的用户界面创建桌面 .NET (C#) 或本机 Win32 (C++) 应用。 生成的项目包括一个基本窗口，该窗口派生自 WinUI 3 库中的 Microsoft.UI.Xaml.Window 类，可用于生成 UI。 若要详细了解如何使用此项目模板，请参阅创建你的第一个 WinUI 3 项目。
此解决方案还包括一个独立的 Windows 应用程序打包项目，该项目经配置后可将应用生成为 MSIX 包。 可以选择安装适用于 Visual Studio 的单项目 MSIX 打包工具扩展，并将打包项目设置合并到应用程序项目中，以便不再需要维护单独的打包项目。
[实验性] 空白应用（UWP 版 WinUI 3）
此项目模板创建具有基于 WinUI 3 的用户界面的 C# 或 C++ UWP 应用。 生成的项目包括一个基础页面，该页面派生自 WinUI 3 库中的 Microsoft.UI.Xaml.Controls.Page 类，可用于生成 UI。 有关此项目模板的详细信息，请参阅创建第一个 WinUI 3 应用。
其他组件的 WinUI 项目模板
可以使用这些 WinUI 3 项目模板来构建可由基于 WinUI 3 的应用加载和使用的组件。
| 模板 | Language | 说明 |
|---|---|---|
| 类库（桌面版 WinUI 3） | 仅限 C# | 使用 C# 创建一个 .NET 托管类库 (DLL)，使其可由具有基于 WinUI 3 的用户界面的其他 .NET 5 桌面应用使用。 |
| [实验性] 类库（UWP 版 WinUI 3） | 仅限 C# | 使用 C# 创建一个托管类库 (DLL)，使其可由具有基于 WinUI 3 的用户界面的其他 UWP 应用使用。 |
| Windows 运行时组件 (WinUI 3) | C++ | 创建一个用 C++/WinRT 编写的 Windows 运行时组件，使其可由任何具有基于 WinUI 3 的用户界面的 UWP 或桌面应用使用，而无论这些应用使用何种编程语言编写。 |
| [实验性] Windows 运行时组件（UWP 版 WinUI 3） | C# | 创建一个用 C# 编写的 Windows 运行时组件，使其可由任何具有基于 WinUI 3 的用户界面的 UWP 应用使用，而无论这些应用使用哪种编程语言编写。 |
适用于 WinUI 3 的项模板
下列项模板适合在 WinUI 3 项目中使用。 若要访问这些 WinUI 3 项模板，请在“解决方案资源管理器”中右键单击项目节点，选择“添加”->“新建项”，然后在“添加新项”对话框中单击“WinUI”。
注意
如果已安装实验性渠道或较旧预览版的 Windows 应用 SDK，你可能会看到另一组具有 [实验性] 前缀的项模板。 如果要生成非生产/预览版应用，我们建议使用这些 [实验性] 项模板，如果要生成生产桌面应用，建议使用未标记的稳定项模板。
| 模板 | Language | 说明 |
|---|---|---|
| 空白页 (WinUI 3) | C# 和 C++ | 添加一个 XAML 文件和定义了新页面的代码文件，该页面派生自 WinUI 3 库中的 Microsoft.UI.Xaml.Controls.Page 类。 |
| 空白窗口（桌面版 WinUI 3） | C# 和 C++ | 添加一个 XAML 文件和定义了新窗口的代码文件，该窗口派生自 WinUI 3 库中的 Microsoft.UI.Xaml.Window 类。 |
| 自定义控件 (WinUI 3) | C# 和 C++ | 添加用于创建具有默认样式的模板化控件的代码文件。 该模板化控件派生自 WinUI 3 库中的 Microsoft.UI.Xaml.Controls.Control 类。有关如何使用该项目模板的演练，请参阅使用 C++/WinRT 将 UWP 和 WinUI 3 应用的 XAML 控件模板化和使用 C# 将 UWP 和 WinUI 3 应用的 XAML 控件模板化。 有关模板化控件的详细信息，请参阅自定义 XAML 控件。 |
| 资源字典 (WinUI 3) | C# 和 C++ | 添加 XAML 资源的空键控集合。 有关详细信息，请参阅 ResourceDictionary 和 XAML 资源参考。 |
| 资源文件 (WinUI 3) | C# 和 C++ | 添加用于存储应用的字符串和条件资源的文件。 可以借助此项对应用程序进行本地化。 有关详细信息，请参阅对 UI 和应用包清单中的字符串进行本地化。 |
| 用户控件 (WinUI 3) | C# 和 C++ | 添加一个 XAML 文件和用于创建用户控件的代码文件，该用户控件派生自 WinUI 3 库中的 Microsoft.UI.Xaml.Controls.UserControl 类。 通常，用户控件封装相关的现有控件并提供其自己的逻辑。有关用户控件的详细信息，请参阅自定义 XAML 控件。 |
