Visual Studio 中的 WinUI 3 範本

發行項
10/07/2023

設定開發電腦之後 (請參閱安裝 Windows 應用程式 SDK 的工具)，您可以從 Visual Studio 中的其中一個 WinUI 3 專案範本開始建立 WinUI 3 應用程式。本主題描述可用的專案和項目範本。建立您的第一個 WinUI 3 專案會逐步引導您建立專案。

若要存取 WinUI 3 專案範本，請在新增專案對話方塊的下拉式篩選中，分別選取 C#/C++、Windows 和 WinUI。或者，您可以搜尋「WinUI」。並選取其中一個可用的 C# 或 C++ 範本。

WinUI project templates

WinUI 3 的專案範本

您可以使用這些 WinUI 3 專案範本開始建立應用程式。

已封裝的空白應用程式 (WinUI 3 in Desktop)

此專案範本使用以 WinUI 3 為基礎的使用者介面，建立桌面 .NET 5 (C#) 或原生 Win32 (C++) 應用程式。產生的專案包含一個基本視窗，該視窗是從 WinUI 3 程式庫中的 Microsoft.UI.Xaml.Window 類別衍生，您可以用來開始建置您的 UI。如需使用此專案範本的詳細資訊，請參閱建立您的第一個 WinUI 3 專案。

此專案範本的功能會因 Windows App SDK 延伸模組的版本而異。

1.0 版 Preview 2：從此版本開始，此專案範本會產生具有套件資訊清單的應用程式專案，以及將應用程式建置到 MSIX 套件所需的其他支援，而不需要使用不同的封裝專案。若要使用此專案範本，您也必須安裝 Visual Studio 的單一專案 MSIX 封裝工具延伸模組。

注意

在 1.0 版 Preview 2 及更新版本中，此專案範本僅支援所產生 MSIX 套件中的單一可執行檔。如果您需要將多個可執行檔合併成單一 MSIX 套件，則必須使用空白應用程式、使用 Windows 應用程式封裝專案 (WinUI 3 in Desktop) 專案範本，或將 Windows 應用程式封裝專案新增至您的解決方案。
1.0 版 Preview 1 和更早版本：在這些版本中，此專案範本會產生一個解決方案，其中包含設定為將應用程式建置至 MSIX 套件的個別 Windows 應用程式封裝專案。您可以選擇性地安裝 Visual Studio 的單一專案 MSIX 封裝工具延伸模組，並將封裝專案設定合併到您的應用程式專案中，因此您不再需要維護個別的封裝專案。

空白應用程式，使用 Windows 應用程式封裝專案 (WinUI 3 in Desktop) 進行封裝

此專案範本適用於 1.0 版 Preview 1 及更新版本。使用以 WinUI 3 為基礎的使用者介面，建立桌面 .NET (C#) 或原生 Win32 (C++) 應用程式。產生的專案包含一個基本視窗，該視窗是從 WinUI 3 程式庫中的 Microsoft.UI.Xaml.Window 類別衍生，您可以用來開始建置您的 UI。如需使用此專案範本的詳細資訊，請參閱建立您的第一個 WinUI 3 專案。

解決方案也包含個別 Windows 應用程式封裝專案，其已設定為將應用程式建置到 MSIX 套件。您可以選擇性地安裝 Visual Studio 的單一專案 MSIX 封裝工具延伸模組，並將封裝專案設定合併到您的應用程式專案中，因此您不再需要維護個別的封裝專案。

[實驗性] 空白應用程式 (WinUI 3 in UWP)

此專案範本使用以 WinUI 3 為基礎的使用者介面，建立桌面 C# 或 C++ UWP 應用程式。產生的專案包含一個基本頁面，該頁面是從 WinUI 3 程式庫中的 Microsoft.UI.Xaml.Controls.Page 類別衍生，您可以用來開始建置您的 UI。如需此專案範本的詳細資訊，請參閱建立您的第一個 WinUI 3 應用程式。

其他元件的 WinUI 專案範本

您可以使用這些 WinUI 3 專案範本來建置可供以 WinUI 3 為基礎的應用程式載入及使用的元件。

範本	語言	描述
類別庫 (WinUI 3 in Desktop)	僅限 C#	在 C# 中建立 .NET 受控類別庫 (DLL)，可供具有以 WinUI 3 為基礎的使用者介面的其他 .NET 桌面應用程式使用。
[實驗性] 類別庫 (WinUI 3 in UWP)	僅限 C#	在 C# 中建立受控類別程式庫 (DLL)，可供具有以 WinUI 3 為基礎的使用者介面的其他 UWP 應用程式使用。
Windows 執行階段元件 (WinUI 3)	C++	建立以 C++/WinRT 撰寫的 Windows 執行階段元件，可以由具有 WinUI 3 架構使者介面的任何 UWP 或桌面應用程式取用，不論該應用程式是以何種程式設計語言撰寫。
[實驗性] Windows 執行時間元件 (WinUI 3 in UWP)	C#	建立以 C# 撰寫的 Windows 執行階段元件，可以由具有 WinUI 3 架構使者介面的任何 UWP 應用程式取用，不論該應用程式是以何種程式設計語言撰寫。

WinUI 3 的項目範本

您可以在 WinUI 3 專案中使用下列項目範本。若要存取這些 WinUI 3 項目範本，請以滑鼠右鍵按一下 [方案總管] 中的專案節點，選取 [新增] -> [新項目]，然後按一下 [新增新項目] 對話方塊中的 [WinUI]。

WinUI item templates

注意

如果您已安裝實驗通道或較舊的 Windows 應用程式 SDK 預覽版本，可能會看到具有 [實驗性] 前置詞的第二組項目範本。如果您要建置非生產/預覽應用程式，建議您使用這些 [實驗] 項目範本，如果您要建置生產桌面應用程式，請使用穩定且未標記的項目範本。

範本	語言	描述
空白頁面 (WinUI 3)	C# 和 C++	新增 XAML 檔案和程式碼檔案，該檔案會定義衍生自 WinUI 3 程式庫中 Microsoft.UI.Xaml.Controls.Page 類別的新頁面。
空白視窗 (WinUI 3 in Desktop)	C# 和 C++	新增 XAML 檔案和程式碼檔案，該檔案會定義衍生自 WinUI 3 程式庫中 Microsoft.UI.Xaml.Window 類別的新視窗。
自訂控制項 (WinUI 3)	C# 和 C++	新增程式碼檔案，以使用預設樣式建立樣板化控制項。樣板化控制項衍生自 WinUI 3 程式庫中的 Microsoft.UI.Xaml.Controls.Control 類別。如需示範如何使用此項目範本的逐步解說，請參閱 UWP 和 WinUI 3 應用程式的樣板化 XAML 控制項 (使用 C++/WinRT) 和 UWP 和 WinUI 3 應用程式的樣板化 XAML 控制項 (使用 C#)。如需樣板化控制項的詳細資訊，請參閱自訂 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 控制項。