你可以根據開發需求選擇 穩定、 預覽和 實驗 頻道——從可靠的生產版本到即將推出功能的搶先體驗。 了解更多關於發布頻道。
如需更新的執行階段和 MSIX,請參閱 Windows 應用程式 SDK 的下載項目。
版本 1.2.5 (1.2.230313.1)
錯誤修正
- 已修正導致應用程式在組合關機期間當機的問題。
- 已修正即使螢幕關閉,仍會導致應用程式繼續執行動畫的問題。
- 已修正當滑鼠和鍵盤輸入同時發生時,導致 WebView2 中的滑鼠和觸控輸入失敗的問題。 如需詳細資訊,請參閱 GitHub 問題 #3266。
版本 1.2.4 (1.2.230217.4)
錯誤修正
- 已修正導致獨立應用程式無法設定UAC設定的問題。 如需詳細資訊,請參閱 GitHub 問題 #3376。
- 已修正導致
PushNotificationChannel::ExpirationTime推播通知傳回不正確到期時間的問題。 如需詳細資訊,請參閱 GitHub 問題 #3300。- 修正了在將 double 作為參數傳入 x:Bind 函式時,負數被視為「無效」的問題。
- 更新WinUI VSIX來修正數項問題。 這些更新包括簡化 app.manifest 中的專案範本 dipAwareness、移除 UWP 範本、更新本地化的資源檔、新增手機標識碼以解除封鎖市集提交,以及移除著作權聲明和授權。 如需詳細資訊,請參閱 GitHub 問題 #5659、#3205、#3323、#3322、#3143。
版本 1.2.3 (1.2.230118.102)
錯誤修正
版本 1.2.2 (1.2.221209.1)
錯誤修正
- 已修正導致市集和側載套件(例如從安裝程式、NuGet 和啟動載入器)在已安裝其他套件時無法安裝的問題。 如需詳細資訊,請參閱 GitHub 問題 #3168。
- 已修正使用觸控板捲動時造成遺失彈性效果和動畫曲線的問題。 如需詳細資訊,請參閱 GitHub 問題 #7874。
- 已修正 ListView 造成記憶體流失的問題。
- 當滑鼠懸停後,已修正按鈕範本無法顯示 Foreground 屬性的問題。 如需詳細資訊,請參閱 GitHub 問題 #7208。
- 已修正當 MediaElement 中沒有 MediaPlaybackItem 時,造成不必要的例外狀況的問題。
- 已修正在內容轉換時導致 MediaPlayerElement 中出現白色畫面的問題。
- 已修正導致 App.UnhandledException 無法攔截其他線程的例外狀況的其他問題。 如需詳細資訊,請參閱 GitHub 問題 #1259 和 #5221。
版本 1.2.1 (1.2.221116.1)
1.2 版
Windows 中的第三方小工具
小工具面板最初是在 Windows 11 中引進,而且僅限於顯示內建小工具。 小工具是小型UI容器,可顯示小工具面板上的文字和圖形,並與安裝在裝置上的應用程式相關聯。 使用 Windows 應用程式 SDK,身為第三方開發人員,您現在可以為已封裝的 Win32 應用程式建立小工具,並在 Windows 11 小工具面板本機進行測試。
如需小工具的詳細資訊,請參閱 Widget 概觀。
若要開始開發應用程式的 Widget,請參閱 Widget 服務提供者的開發文件 以及 Widgets 設計基本概念,以取得必要條件、指引和最佳做法。
此版本的必要條件包括:
- 在開發電腦上啟用開發人員模式。
- 開發電腦正在執行 Windows Insider Preview 開發通道的 Windows 版本,其版本號大於或等於 25217,並且所使用的工具板版本為 521.20060.1205.0 或更高版本。
開發 Widget 時的已知限制:
- 第三方小工具只能在已加入此預覽版 WIP 計畫的裝置上進行本機測試。
- 小工具只能針對已封裝的 Win32 應用程式建立。 漸進式 Web 應用程式 (PWA) 的小工具計劃將作為 Microsoft Edge 108 的一部分獲得支援。
顯示資訊
Windows 傳統型應用程式現在可以透過 Windows 應用程式 SDK 中的 DisplayInformation 類別來支援高動態範圍 (HDR) 和 自動色彩管理 (ACM)。 DisplayInformation 類別可讓您監視應用程式檢視的顯示相關信息。 這包括事件,可讓客戶端監視應用程式檢視中可能影響其所在顯示器的變更,以及會影響應用程式檢視的顯示器變更。
WinUI 3
WinUI 應用程式可透過 MediaPlayerElement 與 MediaTransportControls 媒體播放控制來播放音訊與影片。 如需了解如何以及何時使用媒體控制項的詳細資訊,請參閱 媒體播放器。
WinUI 3 已更新為 WinUI 最新的控制項、樣式與行為,適用於 UWP 2.8。 這些更新包括新增 InfoBadge 控件、改善輔助功能和高對比度模式,以及修正跨控件的錯誤。 更多細節請參閱 WinUI for UWP 2.7 和 WinUI for UWP 2.8 的發佈說明。
已修正的問題:
- Windows 10 應用程式現在支援使用 DesktopAcrylicController 的壓克力背景材料。 如需詳細資訊,請參閱 GitHub 上的 問題 7112 。
- 已修正導致 App.UnhandledException 路由失敗的各種問題。 如需詳細資訊,請參閱 GitHub 上的問題 5221 。 關於其餘問題,因應措施會記載於下列 GitHub 問題,並在未來 1.2 版本中解決:
- 已修正導致 ListView 樣式在 Windows 應用程式 SDK 1.1 中退化和變更的問題。 如需詳細資訊,請參閱 GitHub 上的 問題 7666 。
- 已修正當應用程式處於非使用中狀態時,導致出現不正確的Mica後援背景色彩的問題。 如需詳細資訊,請參閱 GitHub 上的 7801 問題。
已知限制:
- 使用 Visual Studio 2022 17.4.0 建立新的 WinUI 3 專案時,它會參考 Windows 應用程式 SDK 的預覽版本。 使用 NuGet 套件管理員來更新此發行版的參考。
- 將 MediaPlayerElement.Source 設定為相對 URI (ms-appx/ms-resource) 會在未封裝的應用程式中失敗。 建議的因應措施是將相對 ms-appx:/// URI 轉換為完全解析的 file:/// URI。
優化使用 .NET 開發的應用程式
.NET 開發人員現在可以發佈修剪後的 Windows 應用程式 SDK 應用程式。 使用 CsWinRT 2.0,現在可以修剪散發在 Windows 應用程式 SDK 中的 C#/WinRT 投影。 發佈已修剪的應用程式可藉由從可修剪的二進位檔中移除任何未使用的程式代碼,以減少應用程式的磁碟使用量。 應用程式也可能看到啟動效能改善。 使用基本的 Hello World 應用程式,我們已觀察到磁碟使用量大約減少 80%,以及在精簡發佈時啟動效能大約提升 7 個%。 透過 WinUI 範例集,我們看到磁碟佔用量改善約 45%。
如需如何啟用修剪、修剪限制(例如可修剪類型的反映)和修剪警告的詳細資訊,請參閱 修剪獨立部署和可執行檔。 開發人員應該在修剪之後徹底測試其應用程式,以確保一切如預期般運作。 如需詳細資訊,請參閱 GitHub 上的 問題 2478 。
Visual Studio Arm64 支援
早在Project Reunion(現為Windows 應用程式 SDK)0.5 時,使用 Windows 應用程式 SDK 開發的應用程式就能夠在 Arm64 上運行。 從 Visual Studio 17.3 預覽版 2 開始,您可以在 Arm64 裝置上使用 Windows 應用程式 SDKpp SDK 開發原生應用程式。
若要開始在 Arm64 裝置上開發,請參閱 Arm 上的 Windows 和 Arm64 Visual Studio。
通知
AppNotificationBuilder 被引入作為 XML 有效載荷的替代方案,用於建立和定義應用程式通知。
如需使用資訊,請參閱 GitHub 上的 AppNotificationBuilder 規格 。
另請參閱 快速入門:Windows 應用程式 SDK 中的應用程式通知 ,以取得如何建立可傳送和接收本機應用程式通知的桌面 Windows 應用程式範例。
重大變更:
針對推播通知,發出通道要求呼叫時,應用程式必須使用 Azure 對象識別碼,而不是 Azure 應用程式識別碼。 如需尋找 Azure 物件識別碼的詳細資訊,請參閱 快速入門:Windows 應用程式 SDK 中的推播通知。
已修正問題:
PushNotificationManager.IsSupported 會執行高權限模式的檢查。 如果應用程式獲得管理員權限,則會傳回
false。已知限制(通知):
- 在 AppNotificationScenario 中,
Urgent僅支援 Windows 組建 19041 和更新版本。 您可以使用 AppNotificationBuilder.IsUrgentScenarioSupported 來檢查功能是否可在運行時間使用。- 在 AppNotificationButton中,
hint-toolTip和hint-buttonStyle僅支援版本 19041 和更新版本。 您可以使用 IsButtonStyleSupported 和 IsToolTipSupported 來檢查功能是否可在運行時間使用。- 在 MediaPlayerElement 中,當用於未封裝應用程式的 XAML 標記時, Source 屬性無法使用 ms-appx 或 ms-resource URI 來設定。 或者,使用檔案 URI 設定來源,或從程式代碼設定。
視窗化
Windows 10 版本 1809 和更新版本現在可透過 AppWindowTitleBar 類別取得完整標題列自定義。 您可以將 AppWindowTitleBar.ExtendsContentIntoTitleBar 設定為
true,以將內容延伸至標題欄區域,以及 SetDragRectangles 來定義拖曳區域(以及其他自定義選項)。如果您使用 AppWindowTitleBar.IsCustomizationSupported 屬性來檢查您是否可以呼叫 AppWindowTitleBar API,它現在在支援的 Windows 應用程式 SDK Windows 10 版本(1809 和更新版本)上返回
true。已知限制(視窗化):
Windows 10 不支援基本標題列自定義。 其中包括 BackgroundColor、 InactiveBackgroundColor、 ForegroundColor、 InactiveForegroundColor 和 IconShowOptions。 如果您呼叫這些屬性,則會以無訊息方式忽略這些屬性。 所有其他 AppWindowTitleBar API 都適用於 Windows 10 版本 1809 和更新版本。 針對標題按鈕顏色 API(以及其他)和 Height,必須將ExtendsContentIntoTitleBar 設定為
true,否則它們將被無提示地忽略。
存取控制
引入 security.accesscontrol.h 和 GetSecurityDescriptorForAppContainerNames 函式,以簡化和優化封裝進程與一般 Win32 API 之間的具名對象共享。 此方法會取得套件系列名稱 (PFN) 和存取掩碼的清單,並傳回安全性描述元。 如需詳細資訊,請參閱 GitHub 上的 GetSecurityDescriptorForAppContainerNames 規格 。
其他限制與已知問題
這很重要
當您從專案參考 Windows 應用程式 SDK 1.2 時,您可能會看到類似「偵測到套件降級:Microsoft.Windows.SDK.BuildTools 從 10.0.22621.1 降級至 10.0.22000.194」的錯誤,這是由於應用程式專案和 Windows 應用程式 SDK 套件對套件的不相容參考所造成。 若要解決此問題,您可以將專案中的參考更新為較新且相容的 Microsoft.Windows.SDK.BuildTools 版本。
- 單元測試可能會失敗,且 Visual Studio 的 [測試輸出] 窗格中發生
REGDB_E_CLASSNOTREG錯誤。 因應措施是,您可以將<WindowsAppContainer>true</WindowsAppContainer>新增至專案檔案。 - 不支援 .NET PublishSingleFile。
- Bootstrapper 和 Undocked RegFree WinRT 自動初始化器預設值現在僅針對產生可執行檔的專案設定(OutputType=Exe 或 WinExe)。 這可預防預設將自動初始化器新增至類別庫 DLL 和其他非可執行檔案。
- 如果您需要非可執行檔中的自動初始化表達式(例如未初始化 Bootstrapper 的泛型可執行檔所載入的測試 DLL),您可以透過
<WindowsAppSdkBootstrapInitialize>true</WindowsAppSdkBootstrapInitialize>或<WindowsAppSdkUndockedRegFreeWinRTInitialize>true</WindowsAppSdkUndockedRegFreeWinRTInitialize>在專案中明確啟用自動初始化表達式。
- 如果您需要非可執行檔中的自動初始化表達式(例如未初始化 Bootstrapper 的泛型可執行檔所載入的測試 DLL),您可以透過
- Microsoft.WindowsAppRuntime.Release.Net.dll 一律是 Arm64 二進位檔,不適用於 x86 和 x64 應用程式。 明確呼叫 Bootstrap API 時,請勿使用 Microsoft.WindowsAppRuntime.Release.Net.dll 元件。 作為因應措施,您可以在以 NuGet 套件散發的這個原始程式檔中包含版本常數:'..\include\WindowsAppSDK-VersionInfo.cs' 或使用自動初始化器。
1.2 版 預覽 2 (1.2.0-preview2)
Windows 中的第三方小工具
小工具面板最初是在 Windows 11 中引進的,僅限於顯示第一方小工具。 小工具是小型UI容器,可顯示小工具面板上的文字和圖形,並與安裝在裝置上的應用程式相關聯。 使用 Windows 應用程式 SDK,身為第三方開發人員,您現在可以為已封裝的 Win32 應用程式建立小工具,並在 Windows 11 小工具面板上進行本機測試。
如需 Widget 的詳細資訊,請參閱 Widget 概觀。
若要開始開發應用程式的 Widget,請參閱 小工具提供者 開發檔,以及 小工具設計必要 條件、指引和最佳做法的基本概念。
此版本的必要條件包括:
- 在開發電腦上啟用開發人員模式。
- 開發機器正在執行 Windows 預覽體驗計畫之開發者通道中的 Windows 版本,版本為 Widgets Board 521.20060.1205.0 或更新版本。
開發 Widget 時的已知限制
- 第三方小工具只能在已加入此預覽版 WIP 計畫的裝置上進行本機測試。 在 Windows 應用程式 SDK 1.2.0 中,使用零售版 Windows 的使用者就可以開始透過 Microsoft 市集提供的應用程式版本取得 3P 小工具。
- 小工具只能針對已封裝的 Win32 應用程式建立。 漸進式 Web 應用程式 (PWA) 的小工具計劃將作為 Microsoft Edge 108 的一部分獲得支援。
優化使用 .NET 開發的應用程式
.NET 開發人員現在可以發佈精簡版的 Windows 應用程式 SDK 應用程式。 使用 CsWinRT 2.0,現在可以修剪散發在 Windows 應用程式 SDK 中的 C#/WinRT 投影。 發佈已修剪的應用程式可藉由從可修剪的二進位檔中移除任何未使用的程式代碼,以減少應用程式的磁碟使用量。 應用程式也可能看到啟動效能改善。 使用基本的 Hello World 應用程式,我們已觀察到磁碟使用量大約減少 80%,以及在精簡發佈時啟動效能大約提升 7 個%。 透過 WinUI 範例集,我們看到磁碟佔用量改善約 45%。
如需如何啟用修剪、修剪限制(例如可修剪類型的反映)和修剪警告的詳細資訊,請參閱 修剪獨立部署和可執行檔。 開發人員應該在修剪之後徹底測試其應用程式,以確保一切如預期般運作。 如需詳細資訊,請參閱 GitHub 上的 問題 2478 。
顯示資訊
Win32 應用程式現在可以透過 Windows 應用程式 SDK 中的 DisplayInformation 類別來支援高動態範圍 (HDR)。 DisplayInformation 類別可讓您監視應用程式檢視的顯示相關信息。 這包括事件,可讓客戶端監視應用程式檢視中可能影響其所在顯示器的變更,以及會影響應用程式檢視的顯示器變更。
已修正 WinUI 3 的問題
- Windows 10 應用程式中現在支援透過 DesktopAcrylicController 的壓克力背景材質。 如需詳細資訊,請參閱 GitHub 上的 問題 7112 。
- 已修正導致 App.UnhandledException 無法路由傳送至應用程式的問題。 如需詳細資訊,請參閱 GitHub 上的問題 5221 。
- 已修正導致 ListView 樣式在 Windows 應用程式 SDK 1.1 中退化和變更的問題。 如需詳細資訊,請參閱 GitHub 上的 問題 7666 。
其他限制與已知問題(1.2.0-preview2)
這很重要
當您從專案參考 Windows 應用程式 SDK 1.2 時,您可能會看到類似「偵測到套件降級:Microsoft.Windows.SDK.BuildTools 從 10.0.22621.1 降級至 10.0.22000.194」的錯誤,這是由於應用程式專案和 Windows 應用程式 SDK 套件對套件的不相容參考所造成。 若要解決此問題,您可以將專案中的參考更新為較新且相容的 Microsoft.Windows.SDK.BuildTools 版本,或只是從專案移除參考。 如果您從專案中移除它,Windows 應用程式 SDK 套件將會隱含地參考相容版本。
- 目前不支援使用 Arm64 Visual Studio 建置。
- Bootstrapper 和 Undocked RegFree WinRT 自動初始化器預設值現在僅針對產生可執行檔的專案設定(OutputType=Exe 或 WinExe)。 這可預防預設將自動初始化器新增至類別庫 DLL 和其他非可執行檔案。
- 如果您需要非可執行檔中的自動初始化表達式(例如未初始化 Bootstrapper 的泛型可執行檔所載入的測試 DLL),您可以透過
<WindowsAppSdkBootstrapInitialize>true</WindowsAppSdkBootstrapInitialize>或<WindowsAppSdkUndockedRegFreeWinRTInitialize>true</WindowsAppSdkUndockedRegFreeWinRTInitialize>在專案中明確啟用自動初始化表達式。
- 如果您需要非可執行檔中的自動初始化表達式(例如未初始化 Bootstrapper 的泛型可執行檔所載入的測試 DLL),您可以透過
- 可以呼叫版本資訊 API(ReleaseInfo 和 RuntimeInfo),但傳回第 0 版(而非實際版本資訊)。
版本 1.2 預覽 1 (1.2.0-preview1)
WinUI 3
WinUI 應用程式可透過 MediaPlayerElement 與 MediaTransportControls 媒體播放控制來播放音訊與影片。 如需了解如何以及何時使用媒體控制項的詳細資訊,請參閱 媒體播放器。
WinUI 3 已更新為 WinUI 最新的控制項、樣式與行為,適用於 UWP 2.8。 這些更新包括新增 InfoBadge 控件、改善輔助功能和高對比度模式,以及修正跨控件的錯誤。 更多細節請參閱 WinUI for UWP 2.7 和 WinUI for UWP 2.8 的發佈說明。
已知問題
ListView 樣式自 Windows 應用程式 SDK 1.1 版本起退步並發生變更。
通知
AppNotificationBuilder 被引入作為 XML 有效載荷的替代方案,用於建立和定義應用程式通知。
如需使用資訊,請參閱 GitHub 上的 AppNotificationBuilder 規格 。
另請參閱 快速入門:Windows 應用程式 SDK 中的應用程式通知 ,以取得如何建立可傳送和接收本機應用程式通知的桌面 Windows 應用程式範例。
重大變更
針對推播通知,發出通道要求呼叫時,應用程式必須使用 Azure 對象識別碼,而不是 Azure 應用程式識別碼。 如需尋找 Azure 物件識別碼的詳細資訊,請參閱 快速入門:Windows 應用程式 SDK 中的推播通知。
已修正問題
PushNotificationManager.IsSupported 會執行高權限模式的檢查。 如果應用程式獲得管理員權限,則會傳回
false。已知限制 (通知)
- 在 AppNotificationScenario 中,
Urgent僅支援 Windows 組建 19041 和更新版本。 您可以使用 AppNotificationBuilder.IsUrgentScenarioSupported 來檢查功能是否可在運行時間使用。- 在 AppNotificationButton中,
hint-toolTip和hint-buttonStyle僅支援版本 19041 和更新版本。 您可以使用 IsButtonStyleSupported 和 IsToolTipSupported 來檢查功能是否可在運行時間使用。- 在 MediaPlayerElement 中,當用於未封裝應用程式的 XAML 標記時, Source 屬性無法使用 ms-appx 或 ms-resource URI 來設定。 或者,使用檔案 URI 設定來源,或從程式代碼設定。
視窗化
Windows 10 版本 1809 和更新版本現在可透過 AppWindowTitleBar 類別取得完整標題列自定義。 您可以將 AppWindowTitleBar.ExtendsContentIntoTitleBar 設定為
true,以將內容延伸至標題欄區域,以及 SetDragRectangles 來定義拖曳區域(以及其他自定義選項)。如果您使用 AppWindowTitleBar.IsCustomizationSupported 屬性來檢查您是否可以呼叫 AppWindowTitleBar API,它現在在支援的 Windows 應用程式 SDK Windows 10 版本(1809 和更新版本)上返回
true。已知限制 (視窗化)
Windows 10 不支援簡單的標題列自定義。 其中包括 BackgroundColor、 InactiveBackgroundColor、 ForegroundColor、 InactiveForegroundColor 和 IconShowOptions。 如果您呼叫這些屬性,則會以無訊息方式忽略這些屬性。 所有其他 AppWindowTitleBar API 都適用於 Windows 10 版本 1809 和更新版本。 針對標題按鈕顏色 API(以及其他)和 Height,必須將ExtendsContentIntoTitleBar 設定為
true,否則它們將被無提示地忽略。
存取控制
引入 security.accesscontrol.h 和 GetSecurityDescriptorForAppContainerNames 函式,以簡化和優化封裝進程與一般 Win32 API 之間的具名對象共享。 此方法會取得套件系列名稱 (PFN) 和存取掩碼的清單,並傳回安全性描述元。 如需詳細資訊,請參閱 GitHub 上的 GetSecurityDescriptorForAppContainerNames 規格 。
其他限制與已知問題(1.2.0-預覽版1)
- 不支援 .NET PublishSingleFile。
1.2 實驗版本 (1.2.0-experimental2)
已解決問題
在即將推出的 Windows Insider Preview 組建中,使用 Windows 應用程式 SDK 的應用程式將無法啟動。
1.2 實驗版本 (1.2.0-experimental1)
輸入與組成
首先在 Windows 應用程式 SDK 0.8 中引進, Microsoft.UI.Input.Experimental & Microsoft.UI.Composition.Experimental 命名空間中有數個實驗類別。
此版本的新功能:
- InputPointerSource 有新的靜態處理站 GetforWindowId。
內容
此版本的新增內容是 Microsoft.UI.Content 命名空間中的實驗類別提供了互動式內容的建置區塊。 這些是低階基本類型,可組合成內容,為終端使用者提供互動式體驗。 內容會定義以下結構:使用動畫渲染輸出、處理不同目標上的輸入、提供可存取表示以及處理主機狀態變更。
值得注意的 API:
ContentIsland- 將輸出、輸入和可存取性結合在一起,並提供互動式內容的抽象。 可以建立自訂視覺化樹並與這些 API 進行互動。DesktopChildSiteBridge- 可讓ContentIsland連接到以 HWND 為基礎的階層。如需詳細資訊,請參閱 GitHub 上的範例 。
調度
DispatcherQueue 現在會以可重入的形式進行分派。 先前,單一執行緒上一次最多只能有一個 DispatcherQueueHandler 回調處於活動狀態。 現在,如果處理程序啟動巢狀訊息泵,則會以可重入的方式調度其他回呼。 這與圍繞視窗訊息和嵌套訊息泵的 Win32 行為相符。
通知
現在支援註冊應用程式通知所需的顯示名稱和圖示。 請查看 GitHub 上的規格 以取得其他資訊。
WinUI 3
- 控制項和樣式已更新至 WinUI for UWP 2.8 的最新版本。
- 實驗性版本不再支援 UWP。
其他限制與已知問題
- 由於 ABI 中引入了重大更改,更新到 Windows 應用程式 SDK 1.2-experimental1 後需要重新建置應用程式。
- 參考相依於 WebView2 套件的應用程式(例如 Microsoft.Identity.Client)會無法建置。 這是因為在建置階段發生衝突的二進位檔所造成。 如需詳細資訊,請參閱 GitHub 上的 問題 2492 。
- 使用
dotnet build搭配 Windows 應用程式 SDK C# 類別庫專案時,可能會遇到組建錯誤:「Microsoft.Build.Packaging.Pri.Tasks.ExpandPriContent 工作無法載入」。 若要解決此問題,請在專案檔中設定<EnableMsixTooling>true</EnableMsixTooling>。- 預設的 Windows 應用程式 SDK 範本會指出 MaxVersionTested=“10.0.19041.0” ,而它應該是 “10.0.22000.0”。 如需某些功能的完整支援,特別是 UnlockedDEHs,請將項目檔中的 MaxVersionTested 更新為 “10.0.22000.0”。