建立您的第一個 WinUI 3 專案 教學

在微軟開發文件中看了半天,找不到 WinUI 3 專案的選項
上網晃了半天,發現原來要先安裝 Project Reunion 點擊 Download 之後會下載一個 ProjectReunion.Extension.vsix 檔案 點兩下開啟之後點選 Install 安裝,在安裝過程中記得要把 VS 或是有用 Rider 之類的開發工具都要關閉(筆者安裝了大約 10 分鐘...)
此時再開啟 Visual Studio,點選「建立新專案」,在專案類型的下拉式選單中就會看到 WinUI 的選項了!
我們要建立應用程式,而不是類別庫,所以選擇下面那個

這裡多了一個最低平台版本選擇的視窗,告訴我們目前開發的軟體未來最低只能在 1809 組件 17763上面執行
注意!這裡請一定要選擇 18362 以上,不然會有許多問題,因為在筆者撰文的當下,只能下載到 Windows 10 SDK (10.0.18362.0),如果選擇低於這個版本非常可能會冒出下列錯誤:
    
嚴重性	程式碼	說明	專案	檔案	行	隱藏項目狀態
錯誤	NU1202	封裝 Microsoft.ProjectReunion.InteractiveExperiences 0.8.10 與 net5.0 (.NETCoreApp,Version=v5.0) 不相容。 封裝
Microsoft.ProjectReunion.InteractiveExperiences 0.8.10 不支援任何目標架構。	RuyutWinUI3Test
C:\Users\Ruyut\source\repos\test\RuyutWinUI3Test\RuyutWinUI3Test\RuyutWinUI3Test\RuyutWinUI3Test.csproj	1
    

或是
    
專案 'RuyutWinUI3Test' 在最後一個作業期間遇到問題: 嘗試對條件 "'$(TargetPlatformVersion)' < '10.0.18362.0'" 中評估為 "" (而非數字) 的 "$(TargetPlatformVersion)" 進行數字比較。  C:\Users\Ruyut\.nuget\packages\microsoft.windowsappsdk\1.1.0\buildTransitive\Microsoft.InteractiveExperiences.Common.targets 在修正問題後可能需要重新載入解決方案。
    

筆者一開始不知道花了很多時間在除錯,建立專案建到懷疑人生...
建立完專案後點選「啟動」,尷尬,無法執行
系統自動開啟設定,原來要把「開發人員模式」開啟
點選「是」
再次「啟動」,也不行,因為筆者現在這台電腦沒有安裝.NET Runtime,還要下載後才能執行
疑,不對阿,怎麼可能沒有安裝? 原來,筆者是安裝 .NET 6 ,在 WinUI 預設是 .NET 5, 所以他才找不到
但是 .NET 5 在 2022 年 5 月 10 日 就不支援了,所以我們可以點擊右側「方案總管」內的 Properties,把裡面的「目標 Framework」改為 .NET 6.0。
改成 .NET 6 之後Microsoft.ProjectReunion.InteractiveExperiences 0.8.10 不支援,所以先暫時繼續使用 .NET 5

目前可以執行了
預設值行畫面:


留言