準備使用 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 類庫仍會繼續發出警告。 目前，您可以運行它，所以讓我們等到這個問題得到解決。