Windows 應用程式 SDK 2.0 發布說明

新增對 windows.diagnosticServiceModule package-manifest 擴充功能的支援。 自含式 .NET MSIX 應用程式可以使用此擴充功能來宣告診斷模組，讓 Windows 錯誤回報得以載入這些模組，並收集可供分析的當機傾印檔。

新的 AppContentIndex API 現已作為有限存取功能（LAF）提供給已取得 LAF 權杖的應用程式使用。 這些 API 讓應用程式提供文字與圖片內容以進行索引，並透過詞彙匹配以及在支援的 NPU 裝置上進行語意匹配來查詢這些內容。 AppContentIndex 支援語意搜尋與檢索增強生成（RAG）場景。 （執行時相容性變更：AppContentSearchNewAPI_LafCheck）

• 修正了視窗式彈出視窗輸入處理中的當機問題：當彈出視窗的 island 已釋放後，若仍處理焦點或指標事件，就會發生當機。 （執行相容性變更：PointerInputProcessor_ReleaseCaptureOnDisposedIsland）
• 修正了 NavigationView 中的一個當機問題：調整控制項大小時，可能會產生負值的窗格 MaxHeight。 （執行階段相容性變更：NavigationView_UpdatePaneLayoutNegativeMaxHeight）
• 修正了在指標處於按下狀態時，由 ElementCompositionPreview.GetPointerPositionPropertySet 傳回的屬性集停止更新的問題。 （執行階段相容性變更：PointerPositionPropertySet_UpdateWhilePressed）
• 修正了 NavigationView 在項目已收合或回收後顯示其彈出式視窗時，已展開項目發生的當機問題。 （執行階段相容性變更：NavigationViewItem_DeferredFlyoutShowStaleState）
• 修正了當 KeyboardAccelerator 使用 OEM 鍵或標點鍵（例如逗號、分號或方括號鍵）並顯示快速鍵標籤時發生的快速失敗問題。 （執行階段相容性變更：KeyboardAccelerator_OemKeyNoFailFast）
• 修正了在多個 UI 執行緒上架 WinUI 3 的應用程式中，XAML 關機時可能發生的致命程序退出問題。 （執行階段相容性變更：WindowsXamlManager_ActivationFactoryCacheResetRace）
• 修正了一個問題：在非整數顯示縮放比例（例如 175%）下，沒有次要指令的 CommandBar 可能會顯示空白的溢出按鈕。 （執行階段相容性變更：CommandBar_SpuriousOverflowButtonAtFractionalScale）
• 修正了使用系統合成引擎的應用程式無法呼叫 VisualInteractionSource.CreateFromIVisualElement的問題。 （執行階段相容性變更：CompositionEngine_SwitcherSeptemberFixes）
• 用於使用 System Composition Engine 的應用程式的固定效果圖表與 SceneLighting 渲染。 （執行階段相容性變更：CompositionEngine_SwitcherSeptemberFixes）
• 已修正使用系統組合引擎時，NoActivate未遵循 InputPointerSource.ActivationBehavior 的問題。 （執行階段相容性變更：CompositionEngine_SwitcherSeptemberFixes）
• 對於空輸入與 no-op 選擇的固定 CompositionEngine 選擇行為。 （執行階段相容性變更：CompositionEngine_SwitcherSeptemberFixes）
• 修正了使用系統合成引擎時，抬起輸入的游標自訂問題。 （執行階段相容性變更：CompositionEngine_SwitcherSeptemberFixes）
• 已修正使用系統組合引擎時查詢漸層停駐點集合的問題。 （RuntimeCompatibilityChange：不適用，作業系統組合修正）
• 已修正使用系統組合引擎時 ContentExternalOutputLink 邊框與背景的行為。 （RuntimeCompatibilityChange：不適用，作業系統組合修正）
• 使用系統合成引擎時，固定存取 VisualReferenceController 權限。 （RuntimeCompatibilityChange：不適用，作業系統組合修正）
• 已修正安裝 Windows 應用程式 SDK 時可能出現的註冊問題。 （RuntimeCompatibilityChange：不適用，部署註冊修正）
• 修正了在使用更新後的 ONNX Runtime 相依套件時，Video Super Resolution 在初始化或推論期間可能失敗的問題。 （RuntimeCompatibilityChange：不適用，相依相容性更新）

本版本與 2.4.0 版本相比，包含以下新 API：

Microsoft.Windows.Search.AppContentIndex

    AppIndexContentRegion
        CreateFromBitmap
        CreateFromImageStream

    AppManagedIndexableAppContent
        CreateFromBitmap
        CreateFromImageStream

    ContentRegionImageOptions

    ContentRegionTextOptions
        AllowSemanticIndexing

    ImageOcrIndexingOptions

WinUI 3 應用程式現在支援作業系統觸控板與滑鼠觸覺， Windows.Devices.Haptics並支援觸控板單指平移，前提是作業系統與硬體支援。 （執行階段相容性變更：InputPointerSource_OSHaptics）

• 修正了當觸控或手寫筆接觸點在時機恰當時離開可捲動區域時，可能發生的當機問題。 （執行階段相容性變更：InputPointerSource_DepartingScrollInputCrashFix）
• 修正了以下問題：檔案對話方塊關閉後，儲存體選擇器（FileOpenPicker、FileSavePicker 和 FolderPicker）會使呼叫端 WinUI 應用程式視窗失去鍵盤焦點。 對話結束後，應用程式會恢復先前的焦點。 更多資訊請參閱 GitHub 第 #6505 號。 （執行階段相容性變更：StoragePickers_RestoreFocusAfterDialogCloses）
• 修正了一個回歸問題：當 PRI 檔案不存在時，MrmGetFilePathFromName 會回傳 ERROR_FILE_NOT_FOUND，而不是回傳文件中記載的後援路徑。 欲了解更多資訊，請參閱 GitHub 第 #5940 號。 （執行階段相容性變更：ResourceManager_RestoreDefaultFallbackPath）
• 修正 MICROSOFT_WINDOWSAPPRUNTIME_BASE_DIRECTORY 了可能被子程序繼承的問題，這會干擾 MRT Core 和目錄查詢。 更多資訊請參見 GitHub issue #5987。 （執行階段相容性變更：WindowsAppRuntime_BaseDirectoryIsolation）
• 修正了因 LanguageModel 不支援語言或輸入輸出語言不匹配而回傳為通用 Error 狀態的問題。 這些條件分別返回 LanguageModelResponseStatus.UnsupportedLanguage 和 LanguageModelResponseStatus.LanguageMismatch。 （執行階段相容性變更：LanguageModel_LanguageDetectionStatus）
• 修正了當使用 System Composition Engine 的應用程式呼叫 VisualInteractionSource.TryRedirectForManipulation 時發生的當機問題。 （RuntimeCompatibilityChange：不適用，作業系統組合橋接修正）
• 修正了在定義 DISABLE_XAML_GENERATED_MAIN 時所產生的 C# 進入點輔助程式上的存取修飾詞。 更多資訊請參見 GitHub issue #11245。 （RuntimeCompatibilityChange：無，建置時工具變更）

本版本與 2.3.1 版本相比，新增了以下 API：

Microsoft.Windows.AI.Text

    LanguageModelResponseStatus
        LanguageMismatch
        UnsupportedLanguage

新增結構化 JSON 輸出 API（Microsoft.Windows.AI.Text.LanguageModel.GenerateStructuredJsonResponseAsync），可產生受限於呼叫者提供的 JSON 架構的語言模型回應。 （執行階段相容性變更：LanguageModel_StructuredJsonOutput）

新增了 XamlOptionalChanges API，讓應用程式在 XAML 初始化前能選擇選擇性破壞性變更。 更多資訊請參見 GitHub PR microsoft/microsoft-ui-xaml#11110。 （執行階段相容性變更：XamlSettings_OptionalChangesApi）

改變了預處理器常數的 DISABLE_XAML_GENERATED_MAIN 行為，使得定義後會重新命名產生 main() 的方法（C#： XamlGeneratedProgram.XamlGeneratedMain();C++/WinRT： wXamlGeneratedMain()） 而非完全移除。 這讓自訂 main() 方法能夠呼叫預設實作。

新增了 CompositionEngine API 作為不穩定 的有限存取功能（LAF），允許應用程式選擇使用該作業系統作為 Composition API 的引擎。 （執行相容性變更：CompositionEngine_API）

修正了 NPU 偵測，增加了 CPU 支援，並提升了影片超解析度的效能。 （執行階段相容性變更：VideoSuperResolution_HardwareDetection）

• 特定情境下的固定執行提供者枚舉。 （執行階段相容性變更：WindowsML_ExecutionProviderEnumerationUpdate）
• 新增ARM64EC對Windows機器學習的支援。

新增了 Microsoft.WindowsAppSDK.AI NuGet 套件中穩定 API 的 IntelliSense 說明文件。

以下多項最佳化功能需主動啟用。 若要啟用這些功能，請如各項目所述設定指定的 XamlChangeId。

• 新增了新的最佳化 XamlControlsResources 樣式，包括最佳化的 ScrollBar 範本。 使用 DefaultStyleOptimizations XamlChangeID 來選擇這些風格。 （執行相容性變更：Xaml_DefaultStyleOptimizations）
• FontIcon並BitmapIcon避免在視覺樹中為選擇使用 Grid XamlChangeID 的應用程式插入額外IconNoGridOptimization內容。 （執行相容性變更：Xaml_IconNoGridOptimization）
• 停止載入 Style 不套用值的屬性設定器。 使用 OptimizeApplyStyles XamlChangeId 來啟用此功能。 （執行相容性變更：Xaml_DeferStylePropertySetters）
• 延遲套用 FrameworkElement 和 Control 樣式，直到元素進入樹中。 使用 OptimizeApplyStyles XamlChangeId 來啟用此功能。 （執行階段相容性變更：Xaml_DelayApplyStylesAfterCreationComplete）
• CommandBar優化初始化，不再載入整個視覺狀態管理器狀態。 （執行階段相容性變更：Xaml_OptimizedCommandBarInitialization）
• 提升了對 CommandBarFlyout和 PrimaryCommandsSecondaryCommands的加法效能。 （執行階段相容性變更：Xaml_OptimizedCommandBarFlyoutUpdateCommands）
• 為 ResourceDictionary 使用了效能更佳的雜湊表。 （執行相容性變更：Xaml_FasterResourceDictionary）
• 在載入延後載入的資源時，省去了資源鍵字串的複製與比較作業。 （執行階段相容性變更：Xaml_LoadDeferredResourceOptimization）
• 透過減少字串比較，提升 ThemeResource 查找的效能。 （執行階段相容性變更：Xaml_ThemeResourceUseResourceKeys）
• 透過降低資源金鑰雜湊負擔，提升 XAML 主題資源查詢時的 CPU 效能。 （執行階段相容性變更：Xaml_ReduceThemeResourceLookupHashing）
• 提升在 UIElement 和 FrameworkElement 上進行常見內部 XAML 類型檢查時的 CPU 效能。 （執行階段相容性變更：Xaml_CachedTypeChecks）
• 提升內部啟用工廠查詢路徑中的 CPU 效能。 （執行階段相容性變更：Xaml_ActivationFactoryFastPaths）
• 提升了解碼儲存在 XBF 檔案中的整數的效能。 （執行相容性變更：Xaml_FasterXbfIntLoading）
• 透過保留向量記憶體並優化 RAII 輔助工具，減少啟動路徑與樹狀遍歷的堆積分配。 （執行相容性變更：Xaml_ReserveVectorSpace）
• 透過在追蹤器集合中預先保留空間，再新增多個項目，以提升效能。 （執行相容性變更：Xaml_ReserveTrackerCollectionSpace）
• 針對 XamlUICommand 屬性繫結的最佳化綁定。 （執行階段相容性變更：XamlUICommand_LightweightBindings）
• 綁定未定義鍵盤快速鍵的 XamlUICommand 時，效能有所提升。 （執行階段相容性變更：XamlUICommand_SkipEmptyKeyboardAcceleratorBinding）
• 在標記中初始化 TintLuminosityOpacity 屬性，用於預設樣式的 AcrylicBrush 物件，而非在程式碼中初始化，以避免強制具現化。 （執行階段相容性變更：AcrylicBrush_InitializePropertyInMarkup）
• 避免在進入或離開元素樹時，對 ContextFlyout 和 TextBlock 進行不必要的預設 RichTextBlock 初始化。 使用 DeferContextFlyoutInit XamlChangeId 來啟用此功能。 （執行階段相容性變更：Xaml_DeferContextFlyoutInit）
• 透過在背景裝置建立時註冊 XAML 的 D3D 裝置移除事件，而非在 UI 執行緒中稍後登錄，減少了 Direct3D 鎖爭用的啟動等待時間。 （執行階段相容性變更：Xaml_EagerDeviceRemovedEventRegistration）
• 移除了RefreshRateInfo中的冗餘電源通知註冊，以降低啟動額外負荷。 （執行階段相容性變更：RefreshRateInfo_RemovePowerNotification）
• 透過在編譯時期計算記錄的執行階段版本，移除了 WinUI 啟動路徑中多餘的 version.dll 相依性。 （執行相容性變更：XamlInit_GetMuxVersionCompileTime）

• 修正了 CPopupRoot::ReplayPointerUpdate 在指標事件重播期間，彈出式視窗同步關閉時發生的「釋放後使用」當機問題。 （執行階段相容性變更：CPopupRoot_ReplayPointerUpdateCrash）
• 已修正在 XAML 島嶼拆除期間，因 使用者介面自動化 重複查詢而觸發的存取違規CXamlIslandRoot::GetScreenOffset。 （執行階段相容性變更：XamlIslandRoot_UiaTeardownReentrancyCrash）
• 修正了 ModernCollectionBasePanel 中的當機問題：由同層版面配置階段回收的視區追蹤容器或標頭，可能會留下失效的錨點，並在下一次測量時觸發快速失敗機制。 （執行相容性變更：ModernCollectionBasePanel_StaleViewportAnchorRecycle）
• 修正了 CPopup::RemoveChild 中的一個 fail-fast 問題：當 ToolTip 的 close 處理訊息並重新進入關閉路徑時，便會觸發此問題。 （執行相容性變更：Popup_RemoveChildIdempotentWhenClosing）
• 修正了在 使用者介面自動化 用戶端處於作用中時，CXcpDispatcher 的解構函式觸發 Popup 時於 UIADisconnectAllProviders 中發生的可重入性崩潰。 （執行階段相容性變更：UIAWindow_PauseNewDispatchOnDisconnectProviders）
• 修正了當級聯選單或 AutoSuggestBox 延遲開啟計時器在其所屬 island 或 dispatcher 開始卸載後觸發時發生的當機問題。 （執行相容性變更：CascadingMenuHelper_DelayOpenTimerTickAfterUnload）
• 修正了在 DLL 卸載期間，當自訂中繼資料類型中的 COM 指標未正確釋放時，可能發生的釋放後使用當機。 （執行階段相容性變更：CustomMetadataTypes_InvalidateUseAfterFree）
• 修正了在焦點變更期間，因調度器重入而從 Popup 回呼開啟 CompositionTarget.Rendering 時發生的當機。 （執行階段相容性變更：CPopup_OpenSetFocusReentrancy）
• 已修正 MediaPlayerPresenter 在處理媒體播放事件期間，GPU 裝置遺失時發生的當機問題。 （執行階段相容性變更：MediaPlayerPresenter_DeviceLostCrash）
• 修正了在字形序列紋理建構期間發生裝置遺失復原時，Direct2D 文字轉譯中可能發生的存取違規。 （執行階段相容性變更：HWBuildGlyphRunTextures_DeviceGuardScope）
• 修正了在 CFocusRectManager::FindFocusRectHost 或 InlineUIContainer 中，當焦點落在透過 RichTextBlock 以內嵌方式裝載的控制項上時，TextBlock 發生的當機問題。 （執行階段相容性變更：FocusRectManager_FindFocusRectHostCrash）
• 修正了當背景工作沒有已儲存的 CLSID 時，可能反覆導致 backgroundTaskHost.exe 當機的問題，並在 CoCreateInstance 失敗時新增了更妥善的處理機制。 更多資訊請參見 GitHub issue #5870。 （執行階段相容性變更：UniversalBGTask_RunCrash）
• 修正了視窗式與非視窗式飛出視窗在螢幕底部附近向上開啟時，於側邊顯示會出現位置偏移的問題（約位於父項目上方一個項目高度的位置）。 （執行階段相容性變更：Flyout_SidePlacementFlipUpAlignmentFix）
• 修正了 LayoutState 和 UniformGridLayout 中的當機問題（null FlowLayout 解參考）；當已不再載入的 ItemsRepeater 上引發集合變更時，可能會發生此問題。 （執行階段相容性變更：UniformGridLayoutFlowLayout_OnItemsChangedNullLayoutStateCrash）
• 修正了 ApplicationData.GetForUnpackaged().LocalSettings() 在錯誤的路徑開啟登錄機碼的問題（HKCU\SOFTWARE\publisher\product 而非 HKCU\SOFTWARE\Classes\Local Settings\Software\publisher\product）；該路徑屬於漫遊設定檔位置，而不是該機器的本機位置。 欲了解更多資訊，請參閱 GitHub 第 #6559 號。 （執行階段相容性變更：ApplicationData_GetForUnpackaged_LocalSettings）
• 修正了鍵盤修飾鍵狀態處理中的競態條件，該問題可能在 UI 執行緒並發輸入時造成應用程式當機。 （執行階段相容性變更：WindowsServices_GetKeyboardModifiersStateRace）
• 已修正在套件安裝、更新或卸載時可能發生的 AppxSvc 當機。 （RuntimeCompatibilityChange：不適用，修正服務主機程序當機問題）

此版本與 2.2.0 版本相比，包含以下新的 API：

Microsoft.UI.Composition

    CompositionEngine
    CompositionEngineType

Microsoft.UI.Xaml.Settings

    XamlChangeId
    XamlOptionalChanges

Microsoft.Windows.AI.Text

    GenerateStructuredJsonResponseResult
    GenerateStructuredJsonResponseStatus
    LanguageModel
        GenerateStructuredJsonResponseAsync

該 Microsoft.Windows.AI.Video.VideoScaler API 通過先進的 AI 升級提供實時視頻增強，針對對話中的人流進行了優化。 它使開發人員能夠在會議、串流媒體和編輯平台上提供更清晰、更清晰的視覺效果，即使在網路條件不佳的情況下也是如此。 該 API 支持自定義輸出分辨率、幀速率和感興趣區域，兼容多種視頻格式，包括 BGR、RGB 和 NV12。

VideoScaler 是一次性的，並包含能力檢查，讓應用程式能在執行時驗證 VSR 支援。 不要求明確的 Windows 機器學習初始化。

新的 Microsoft.Windows.Storage.ApplicationData.GetForUnpackaged() API 為未封裝應用程式提供一流的 WinRT 入口，存取每位使用者/每台機器的應用程式資料，與過去僅有封裝應用程式可用的 Surface 相匹配。 這可簡化未來已封裝↔未封裝的遷移作業，並且不再需要 Registry API 的變通做法。

已將不需裝箱的值設定器多載新增至 XamlBindingHelper（SetPropertyFromThickness、SetPropertyFromCornerRadius、SetPropertyFromColor），並公開了 Setter.ValueProperty 相依屬性。

• 修正了 RenderTargetBitmap 中的一個當目標元素在 PreCommit 完成之前離開視覺樹時（例如快顯視窗關閉）發生的崩潰問題。 RenderAsync 現在會傳回 E_ABORT，而不是當機。 （執行相容性變更：RenderTargetBitmap_PreCommitCrashOnTreeLeave）
• 修正了 ScrollView 在其隱藏指示器計時器的 tick 事件仍在等待處理時控制項即遭銷毀，所導致的 use-after-free 當機問題。 欲了解更多資訊，請參閱GitHub期#10514。 （執行階段相容性變更：ScrollView_HideIndicatorsTimerUseAfterFree）
• 修正了 Microsoft.UI.Xaml.dll!DirectUI::DXamlCore::GetPeerPrivate 中因嘗試存取預定被釋放物件而可能發生的當機問題。 （執行階段相容性變更：GetPeerPrivate_UseAfterFree）
• 修正了一個問題：Microsoft.UI.System.ThemeSettings 如果應用程式在背景執行緒中被摧毀（例如被 .NET 垃圾回收器摧毀時），可能會當機。 （執行階段相容性變更：ThemeSettings_OffThreadDestructorFix）
• 修正了某些裝置上在作用中的觸控接點遭輸入硬體取消時可能發生的當機問題，例如觸控筆輸入取代這些觸控接點時。 （執行相容性變更：InputPointerSource_PointerCancelCrashFix）
• 修正了稀疏封裝應用程式無法發現特定模組 PRI 檔案的問題。 更多資訊請參見GitHub期#6375。 （執行階段相容性變更：MRTCore_SparsePackagedPriFallback）
• 已修正使用 Flat-C Windows ML 目錄 API 時字串所有權的錯誤。 （執行階段相容性變更：WindowsMLFlatCCatalog_CallbackStringOwnership）
• 在程序關機時，已修正 Windows ML 中可能出現的問題。 （執行階段相容性變更：WindowsML_ComRundownFix）
• 已修正 Windows ML 中潛在的 COM 初始化與拆解問題。 （執行階段相容性變更：WindowsML_ComInitializationFix）

本版本相較於 2.1.3 版本新增以下 API：

Microsoft.UI.Xaml

    Setter
        ValueProperty

Microsoft.UI.Xaml.Markup

    XamlBindingHelper
        SetPropertyFromColor
        SetPropertyFromCornerRadius
        SetPropertyFromThickness

Microsoft.Windows.AI.Video

    VideoScaler
    VideoScalerOptions
    VideoScalerResult
    VideoScalerStatus

Microsoft.Windows.Storage

    ApplicationData
        GetForUnpackaged

改進 TitleBar 了決定哪些部分 TitleBar.Content 可拖曳的方式，並新增了讓開發者明確控制拖曳區域的 API。 請參閱 PR microsoft/microsoft-ui-xaml#10936 及追蹤問題 #10421。

變更的內容

• 新的預設行為 — 框架現在會遞迴地走過視覺樹，並自動只排除拖曳區域中的 互動控制 項。 空白的空隙和非互動視覺效果 預設可拖曳，無需更改標記。
• 新的明確控制 API：
  • TitleBar.IsDragRegion — 附加可為 Null 的布林值，以將元素標記為可拖曳（True）、可點擊（False），或由框架決定（未設定）。
  • TitleBar.AutoRefreshDragRegions — 當 True，拖曳區域會在版面更新時自動刷新。
  • TitleBar.RecomputeDragRegions() — 在動態內容變更後手動重新計算拖曳區域。

為什麼

自訂標題列常將互動式控制項與非互動式視覺元素混合在版面中 Grid/StackPanel 。 先前「從整個內容區域挖洞」的做法，會在具有留白、間距不均或動態 UI 的版面配置中留下 意料之外的無法拖曳空隙。

視覺比較

預設（先前）行為 — 不可拖曳的間隙：

空的中間區域 無法 拖曳。

目前（新）行為 — 空白區域可拖曳，不包括互動控制項：

空白區域可拖曳；互動式控制項已正確排除。 （執行階段相容性變更：TitleBar_ContentDragRegions）

Phi Silica 的 Low-Rank Adapter（LoRA）API 已升級為穩定版。

LoRA 允許開發者用自己的自訂資料微調裝置上的 Phi Silica 語言模型，針對特定情境（如財務、醫療和教育）進行對齊。 使用 LanguageModelLowRankAdapter.CreateFromPath 載入轉接器，並在呼叫 LanguageModelOptions.LowRankAdapter 時透過 GenerateResponseAsync 傳遞它。 如需詳細數據，請參閱 菲矽洛拉 。

新的 AICapabilities.HasAICapability API 讓第三方應用程式能判斷該裝置是否為Copilot+ PC。

ONNX 執行環境版本已更新至 1.24.6。 更多資訊請參閱 ONNX 執行時版本 。

• 新增支援單一 MSIX 套件中的多個執行提供者。 （執行相容性變更：WindowsML_MultiEpPerPackage）
• 新增了以框架套件形式提供的執行提供者發現支援。 （執行階段相容性變更：WindowsML_FrameworkEpEnumeration）
• 新增執行提供者選擇模式，以提供靈活的部署配置。 （執行階段相容性變更：WindowsML_EpSelectionMode）

• 修正了 ItemsRepeater 中的記憶體洩漏問題，因為已回收的元素經由 RecyclePool 的參考循環而始終未被垃圾回收，這也可能導致 InvalidateChildrenMeasure 發生當機。 （執行相容性變更：ItemTemplateWrapper_RecyclePoolLeak）
• 修正了一個當機問題：隱式的 Show/Hide 動畫完成回呼可能會存取已遭銷毀的 CUIElement，導致存取違規。 回調現在會用弱參考來安全地處理元素在動畫完成前被銷毀的情況。 （執行階段相容性變更：Animation_FixImplicitHideAnimationCrash）
• 修正了在 XAML 島中開啟的視窗彈出內容不符合 OverrideScale 的規範，導致內容顯示過大且被剪裁的問題。 更多資訊請參見GitHub期#11000。 （執行時相容性變更：Popup_WindowedPopupOverrideScale）
• 修正了由於跨線程單元 COM 釋放操作期間的重入調度所造成的快速失敗崩潰。 （與執行時相容性變更：UIAffinityReleaseQueue_PauseDispatchDuringCleanup）
• WinUI：修正了在同一程序中載入多個同名模組時的模糊模組查詢。 GetModuleHandleW 被替換為 GetModuleHandleExW ，因此正確模組由位址解析。 （執行階段相容性變更：GetModuleHandle_FixAmbiguousModuleLookup）
• 修正了在可用寬度窄於單一項目次要步距時，對 UniformGridLayout::GetMajorSize 進行版面配置會導致 ItemsRepeater 因整數除以零而當機的問題。 （執行相容性變更：UniformGridLayout_GetItemsPerLineDivideByZero）
• 修正了套件在處理前被卸載時可能發生的當機問題。 （執行時間相容性變更：PackageManager_FixCrash）
• 修正了GetReadyState當所需套件尚未部署時，可能會回傳錯誤錯誤碼（例如DisabledByUserNotSupportedOnCurrentSystem）的問題。 API 現在能在此情境中正確回報 NotReady ，提升診斷清晰度。 （執行相容性變更：ModelInitialization_GetReadyStateAvailabilityGuard）
• 改進 LanguageModel.GenerateResponseAsync 的內部效能診斷，以便在第一個令牌回傳之前更好地識別延遲來源。 （執行相容性變更：LanguageModelInsights_GetPartialResultLatency）
• 當使用 XAML 編譯器時，修正了導致錯誤訊息未被顯示且僅顯示 dotnet build 而非實際錯誤訊息的問題。 欲了解更多資訊，請參閱GitHub期 #9813。 （執行階段相容性變更：不適用，建置階段 XAML 編譯器工具變更）
• 已修正 Microsoft.Windows.Workloads.dll 在 22000 之前的 Windows 建置中無法載入的問題，原因是動態相依 API 的靜態匯入，而這些 API 在這些作業系統版本中無法使用。 函式現在以動態方式解析，因此不支援作業系統版本的故障會以正常 HRESULT 方式顯示，而非載入錯誤對話框。 （RuntimeCompatibilityChange：無，無包含）

本版本與 2.0.1 版本相比，包含以下新 API：

Microsoft.UI.Xaml.Controls

    TitleBar
        AutoRefreshDragRegions
        AutoRefreshDragRegionsProperty
        GetIsDragRegion
        IsDragRegionProperty
        RecomputeDragRegions
        SetIsDragRegion

Microsoft.Windows.AI

    AICapabilities

    AICapabilityCategory

Microsoft.Windows.AI.Text

    LanguageModelLowRankAdapter

    LanguageModelLowRankAdapterResult

    LanguageModelOptions
        LowRankAdapter

    LanguageModelResponseStatus
        IncompatibleLowRankAdapter

Windows 應用程式 SDK 2.0 是新 Windows 應用程式 SDK 版本控制方案的首個版本，標準採用 語意版本管理 2.0.0。 這也是我們第一次增加主要版本號。

新方案簡化了版本管理，將 Windows 應用程式 SDK 版本與 NuGet 套件版本對齊。 現在在專案中引用 Windows 應用程式 SDK 2.0，代表你會使用對應的 NuGet 版本，且不會有獨立的基於日期的建置號需要追蹤：

<PackageDependency Name="Microsoft.WindowsAppSDK" Version="2.0.1" />

套件名稱也與主要版本對齊，而非次要版本，因此下一個並排版本的 Windows 應用程式 SDK 將是 3.0.0。 在 SemVer 下，破壞性變更僅允許在主要版本更新期間進行（參見 Windows 應用程式 SDK部署架構）。

Microsoft.WindowsAppSDK.ML NuGet 套件已重構，新增了一個基礎相依性。 現有的 ML NuGet 套件功能保持不變，但核心Windows ML 功能已重構為一個名為 Microsoft.Windows.AI.MachineLearning 的基礎套件。 這個新套件包含一組極少的相依關係;支援至 Windows 10 v1903 的應用程式。 如果你需要Windows 10 v1809 支援，請繼續使用現有的 Microsoft.WindowsAppSDK.ML 套件。

ONNX Runtime 隨 Windows ML 附帶的 ONNX 執行時版本已更新至 1.24.5。 更多資訊請參閱 ONNX 執行時版本 。 此版本同時包含一項增強性的 ORT API 變更，以支援使用 OrtModelEditor API 產生的圖形來編譯模型（這是先前 OrtCompileApi 表面的功能差距）。 這項變更是不會造成中斷的，旨在解鎖即將支援的 WebNN 瀏覽器應用情境。詳情請參閱底層ONNX 執行時 PR #27332。

授權。 Windows ML 授權協議已簡化，對 ISV 條款更為明確：

• 為了清晰度，重新結構化的安裝、資料及可散發程式碼部分。
• 新的執行提供者（EP）合規通知章節明確說明開發者在硬體加速執行提供者上的責任。
• 直接連結至 NVIDIA TensorRT、Intel OpenVINO 及 Qualcomm QNN（Qualcomm 神經網路 SDK）的廠商授權協議。

• Phi Silica API 現已作為有限存取功能（LAF）的一部分強制執行。 詳情請參見 Phi Silica 。
• 新增了新的狀態至 AIFeatureReadyState 以協助應用程式解釋 AI 模型擷取過程中的暫時性與持久性失敗：CapabilityMissing、NotCompatibleWithSystemHardware 和 OSUpdateNeeded。 應用程式可以利用這些狀態，為使用者提供可行的指引，而非將每一個「未準備好」的狀況視為通用失敗。
• 新增了 AI 模型安裝過程中各種網路及 Windows Update 錯誤的檢查功能，標記持久性失敗，讓使用者了解模型套件為何無法安裝。
• 提升 Windows AI 情境中使用的文字智慧 API 診斷性。

啟用 WinUI 3 應用程式中託管的 WebView2 內容拖曳支援。 此功能先前未被支援，現在無需引入新的公開 API 即可使用。 （從外部來源直接插入 WebView2 控制項已支援。）

支援的案例：

• 標準拖放內容。 支援拖曳文字、HTML、圖片及網址。 目前拖曳圖片離開應用程式時，放入檔案總管時會顯示預設的檔名（例如 download.jpg）。
• 拖曳取消。 應用程式支援按需取消主動拖曳操作，因此在拖曳啟動後，應用程式可以有條件地阻擋受限或短暫內容的拖曳操作。
• 自訂拖曳視覺效果。 支援自訂拖曳介面，如圖示或預覽，幫助使用者清楚辨識被拖曳的內容。
• 可自訂拖曳資料。 支援編輯與自訂拖曳資料，支援應用程式專屬情境，例如在應用程式內拖曳訊息，或附加上下文中繼資料（例如「來自 <應用程式名稱>」），讓目的地可即時讀取。

Limitations:

• 目前不支援一些額外的拖曳資料類型，包括 DownloadURL。

Requirements:

• 最低 WebView2 執行版本（Edge Beta 頻道）：144.0.3719.11。

Microsoft.Windows.Storage.Pickers API（Windows 應用程式 SDK 1.8 引入）已擴充，讓開發者能設定初始與持久資料夾位置，並以清晰標籤分組檔案類型篩選，方便導航。

• FileOpenPicker添加FileTypeChoices、InitialFileTypeIndex、SettingsIdentifier、SuggestedFolder、SuggestedStartFolder 和Title。
• FileSavePicker加上InitialFileTypeIndex、SettingsIdentifier、ShowOverwritePrompt、SuggestedStartFolder和Title。
• FolderPicker加上PickMultipleFoldersAsync、SettingsIdentifier、SuggestedFolder、SuggestedStartFolder和Title。

• 相對位置的彈出視窗定位。 新 PopupAnchor API 允許 DesktopPopupSiteBridge 透過錨定於其擁有視窗或島嶼來支援相對位置，解決了彈出視窗只能絕對使用螢幕座標定位的限制。 新 DesktopPopupSiteBridge.AnchoringBehavior 和 DesktopPopupSiteBridge.AnchoringPixelAlignment 屬性控制錨定行為。
• 鍵盤提示指南。 這個新 InputFocusController.ShouldShowKeyboardCues 特性指導開發者是否在建立 ContentIsland 後顯示鍵盤提示。
• PointerPoint 便利 API。 新的 PointerPoint.GetCurrentPoint 方法允許開發者從提供的 PointerPoint 中獲取活躍的 pointerId 資料。

新的 Microsoft.UI.Xaml.Controls.SystemBackdropElement 是一款輕量級的 FrameworkElement，讓應用程式能在 XAML 佈局中任意位置放置系統背景，例如雲母或壓克力，並擁有 CornerRadius 屬性用於圓潤背景區域。 這填補了 WinUI 3 長期以來的空白，因為應用程式內的壓克力效果在 WinUI 2 中很容易實現，但在 WinUI 3 中缺乏直接對應的功能。

Microsoft.Windows.Management.Deployment 命名空間新增了套件驗證框架和 PackageVolume API，用於管理套件暫存的儲存卷。

• 驗證者。 新增IPackageValidator介面，附有三個內建驗證器（PackageCertificateEkuValidator、PackageFamilyNameValidator、PackageMinimumVersionValidator），可以透過新AddPackageOptions屬性附加到 / StagePackageOptionsPackageValidators。 PackageValidationEventArgs, PackageValidationEventSource, PackageValidationHandler 帶有驗證事件；IsPackageValidationSupported 和 GetValidationEventSourceForUri 讓呼叫者在呼叫部署前測試支援。
• 包裹體積 新 PackageVolume 型為 GetDefault、GetPackageVolumeByName、GetPackageVolumeByPath、AddAsync、RemoveAsync、GetAvailableSpaceAsync、IsOffline、SetDefault、SetOfflineAsync、SetOnlineAsync、IsFeatureSupported ，以及用於執行時能力偵測 PackageVolumeFeature。

新 IXamlCondition 介面允許開發者定義與 XAML 條件命名空間語法整合的自訂條件，並在 XAML 解析時進行評估。 這取代了實驗性IXamlPredicate介面。 自訂條件可根據特定應用因素（如功能標誌、裝置能力、業務邏輯、設定及其他執行環境條件）實現條件式 XAML 情境。

• 修正了安裝過程中 WindowsAppSDK 安裝程式沒有進度的問題，導致安裝程式看起來卡住。 安裝人員現在能提供更清晰的進度回饋。
• 在啟用 WindowsAppSDKSelfContained 的類別函式庫場景中，改進了錯誤處理。
• 修正了因 Windows 應用程式 SDK NuGet MSB8027 檔案中的重複 LNK4042 項目所造成的 ClCompile 和 .targets 建置警告，方法是將預處理器定義從 <Target> 區塊移至 <ItemDefinitionGroup>。 對於 ARM64EC+LTCG 建置，包含一個選擇退出的解決方法（WindowsAppSDK_Arm64EcCompilerWorkaround），以避免已知的 MSVC 內部編譯錯誤。
• 修正了在更新項目清單後，鍵盤導覽（Tab/Shift+Tab）時可能發生的清單檢視當機。
• 修正了 WinUI 3 在控制器不可見且焦點移到 CoreWebView2Controller 時可能崩潰的問題。
• 改進 DeleteIndex 的可靠性，使其在某些情況下不再與 ERROR_SHARING_VIOLATION 失敗（App Content Search；仍處於實驗性頻道）。
• 固定的 OCR 邊界框在某些邊緣情況下會回傳負值。
• 修正了Windows機器學習的錯誤，在同一程序中再次呼叫 RegisterCertifiedAsync 時錯誤回傳 0 執行提供者（EP）。

本版本包含 NuGet 傳遞引用的重構。 要升級現有的 C++ 專案，我們建議使用工具（nuget.exe 或 Visual Studio）移除現有的 Windows 應用程式 SDK 套件參考並新增新的參考。 這能解決 packages.config 專案的升級問題。

從 2.0 Experimental7 升級。 實驗性的 Microsoft.WindowsAppSDK.ML 套件附帶的補丁號高於 2.0.0 穩定版，這在 C++ 專案中可能會出現 NuGet 降級錯誤。 如果你用的是 Experimental7，請依照 NuGet Uninstall 指南移除實驗套件，再參考 2.0.0。

• 應用程式內容搜尋仍處於實驗階段。 為了提升基礎功能並確保未來相容性，Microsoft.Windows.Search.AppContentIndex API 表面（App Content Search）在 2.0-Preview2 中被移除。 它 未 包含在 2.0.1 穩定版中。 要嘗試，繼續使用實驗性版本。 如果你之前安裝了實驗性的 Microsoft.Windows.Search 套件，請依照 NuGet Uninstall 指南卸載，再升級到 2.0.1 穩定版。
• API 已經在 1.8 維護版本中出貨。 部分在 2.0 週期中預覽的實驗性功能在 1.8 服務版本中被提升為穩定 API，因此在 2.0.1 中並非新穎。 它們包括 ModelCatalog （1.8.3）、 TextRewriter.RewriteCustomAsync （1.8.4）和 SplitMenuFlyoutItem plus SplitMenuFlyoutItemAutomationPeer （1.8.6）。 詳情請參閱 1.8 版本的發行說明 。

• AICapabilities 在 2.0.1 版本中缺少。 Microsoft.Windows.AI.AICapabilities 和 AICapabilityCategory.CopilotPlusPCCapable（Copilot+ PC 功能檢查）在 1.8.7 版本中推出，但未包含在 2.0.1 版本中。 我們計劃在五月版本中恢復這些內容。

本版本與穩定版 1.8.7 版本相比，新增以下 API：

Microsoft.Graphics.Imaging

    ImageBufferPixelFormat
        Bgr8

Microsoft.UI.Content

    DesktopPopupSiteBridge
        AnchoringBehavior
        AnchoringPixelAlignment

    PopupAnchor

Microsoft.UI.Input

    InputFocusController
        ShouldShowKeyboardCues

    PointerPoint
        GetCurrentPoint

Microsoft.UI.Xaml.Controls

    SystemBackdropElement

Microsoft.UI.Xaml.Markup

    IXamlCondition

Microsoft.Windows.AI

    AIFeatureReadyState
        CapabilityMissing
        NotCompatibleWithSystemHardware
        OSUpdateNeeded

Microsoft.Windows.Management.Deployment

    AddPackageOptions
        GetValidationEventSourceForUri
        IsPackageValidationSupported
        PackageValidators

    IPackageValidator
    PackageCertificateEkuValidator
    PackageFamilyNameValidator
    PackageMinimumVersionValidator
    PackageValidationEventArgs
    PackageValidationEventSource
    PackageValidationHandler
    PackageVolume
        AddAsync
        GetAvailableSpaceAsync
        GetDefault
        GetPackageVolumeByName
        GetPackageVolumeByPath
        IsFeatureSupported
        IsOffline
        RemoveAsync
        SetDefault
        SetOfflineAsync
        SetOnlineAsync

    PackageVolumeFeature
    StagePackageOptions
        GetValidationEventSourceForUri
        IsPackageValidationSupported
        PackageValidators

Microsoft.Windows.SemanticSearch

    EmbeddingVector
    SemanticSearchContract

Microsoft.Windows.Storage.Pickers

    FileOpenPicker
        FileTypeChoices
        InitialFileTypeIndex
        SettingsIdentifier
        SuggestedFolder
        SuggestedStartFolder
        Title

    FileSavePicker
        InitialFileTypeIndex
        SettingsIdentifier
        ShowOverwritePrompt
        SuggestedStartFolder
        Title

    FolderPicker
        PickMultipleFoldersAsync
        SettingsIdentifier
        SuggestedFolder
        SuggestedStartFolder
        Title

Microsoft.Windows.Vision

    ScreenRegionBoundingBox
    ScreenRegionDetectionContract
    ScreenRegionLabel

Microsoft.Windows.AI

    AIFeatureReadyState
        CapabilityMissing
        NotCompatibleWithSystemHardware
        OSUpdateNeeded

Microsoft.WindowsAppSDK.ML NuGet 套件已被重構，添加了一個新的基礎相依性。 現有的 ML NuGet 套件功能不變，但核心 Windows ML 功能已重構成一個基底相依套件，稱為 Microsoft.Windows。AI。機器學習。 此新套件包含極少的相依性，但在 C#/WinRT 或 C++/WinRT 上僅支援至 Windows 10 18362。 如果你需要Windows 10 17763 支援，請使用現有的 Microsoft.WindowsAppSDK.ML 套件。

對於新的傳遞依賴，我們建議使用工具來升級套件（nuget.exe 或 VS）。 另見：Windows 應用程式 SDK 1.6 版本釋出說明。

ONNX 執行時版本已更新至 1.24.4。 更多資訊請參閱 ONNX 執行時版本 。

強制將 Phi Silica API 納入有限存取功能。

新增了 AI 模型安裝過程中各種網路及 Windows Update 錯誤的檢查功能，標記持久性失敗，讓使用者了解模型套件為何無法安裝。

提升 Windows AI 情境中使用的文字智慧 API 診斷性。

應用程式內容搜尋已從 2.0 預覽版中移除，我們正努力提升基礎架構並確保隨著底層 AI 模型變化，未來的相容性。在此同時，請繼續使用實驗頻道嘗試最新的變更。

啟用 WinUI 3 應用程式中託管的 WebView2 內容拖曳支援。 此功能先前未被支援，現在無需引入新的公開 API 即可使用。 注意：從外部來源直接插入 WebView2 已經支援。

支援的案例

• 標準拖放內容 支援拖曳文字、HTML、圖片及網址。 根據目前的行為，將圖片拖出應用程式時，放入檔案總管時會顯示預設的檔名（例如 download.jpg）。 範例情境： 使用者在 WebView2 中選擇文字或圖片，並拖曳到應用程式內或其他目的地（如檔案總管）。

• 阻力抵消 支援即時取消主動拖曳作業。 範例情境： 應用程式會條件性地阻擋特定內容類型（如受限或短暫內容）的拖曳操作，方法是在拖曳啟動後取消。

• 自訂拖曳視覺 支援自訂拖曳介面，如圖示或預覽，幫助使用者清楚辨識被拖曳的內容。 範例情境： 應用程式會顯示縮圖預覽或圖示，使用者拖曳媒體內容，清楚顯示目前正在移動的項目。

• Customizable drag data 支援編輯與自訂拖曳資料，支援應用程式專屬情境，例如在應用程式內拖曳訊息（例如作為訊息轉寄的替代互動）。 範例情境： 應用程式會自訂拖曳有效載荷，包含上下文中繼資料，例如原始應用程式名稱。 當內容被丟棄時，目的地可以顯示或處理像是「From <app name>」這類資訊，以標示被拖曳內容的來源。

局限性

• 對額外拖曳資料型態的支援有限。 以下格式目前不支援：
  • DownloadURL

要求

• 最低 WebView2 執行版本（Edge Beta 頻道）： 144.0.3719.11

此 IXamlCondition 介面允許開發者定義自訂條件，整合於 XAML 的條件命名空間語法，並在 XAML 解析時進行評估。 這是實驗介面的更名與升級 IXamlPredicate 。 自訂條件可根據特定應用因素（如功能標誌、裝置能力、業務邏輯、設定及其他執行環境條件）實現條件式 XAML 情境。

• 透過將預處理器定義從 <Target> 區塊移至 <ItemDefinitionGroup>，修正了 NuGet .targets 檔案Windows 應用程式 SDK中因重複 ClCompile 項目而產生的 MSB8027 與 LNK4042 建置警告。 對於 ARM64EC+LTCG 建置，包含一個選擇退出的解決方法（WindowsAppSDK_Arm64EcCompilerWorkaround），以避免已知的 MSVC 內部編譯錯誤。
• 修正了在更新項目清單後，鍵盤導覽（Tab/Shift+Tab）時可能發生的清單檢視當機。
• 修正了一個問題，就是如果焦點移到 CoreWebView2Controller 上，而控制器卻看不到，WinUI 3 可能會當機。

本版本包含以下與 2.0-Preview1 相比的新且修改過的 API：

Microsoft.UI.Xaml.Markup

    IXamlCondition

• Windows ML 中的 ONNX 執行環境版本已更新至 1.24 RC 版本
• 修正了一個錯誤，即如果在同一進程中再次呼叫 RegisterCertifiedAsync，會錯誤地回傳 0 個執行提供者（EP）

• 新增 InputFocusController.ShouldShowKeyboardCues 屬性，以指導開發者在建立 ContentIsland 後是否顯示鍵盤提示。
• 新的便利 API PointerPoint.GetCurrentPoint，以便開發者能從提供的 PointerPoint 取得 pointerId 的活動數據。

• 可靠性 DeleteIndex 提升。 有時候 DeleteIndex 會因為 ERROR_SHARING_VIOLATION 而失敗。

• 修正 OCR 邊界框在某些邊緣情況下回傳負值的問題。

• App Content Search 並不是 Microsoft.Windows.Search 的一部分，而是獨立的 Microsoft.Windows.AI package 套件的一部分。

• 修正前綴搜尋無法在短查詢字串下運作的問題。

• 根據官方 API 審查，新增新的 API 並重新命名。

  • AppContentIndexer
    • 取得需重新索引的內容項目
    • 移除 -> 消除內容項目
    • 刪除多個項目 -> 移除內容項目
    • 移除所有內容項目
    • 取得內容索引狀態 -> 取得內容項目狀態
    • 取得多個內容索引狀態 -> 取得內容項目狀態
    • GetContentItems
  • AppContentIndexListener
    • 索引狀態變更 -> 內容項目狀態變更
  • AppIndex文本查詢會話
    • 更新查詢 -> 更新查詢短語
    • 最近結果 -> 取得結果
    • 最近結果變更 -> 結果變更
  • AppIndexImageQuerySession
    • 更新查詢 -> 更新查詢短語
    • 最近結果 -> 取得結果
    • 最近結果變更 -> 結果變更
  • AppManagedImageQueryMatch
    • 子區域 -> 興趣區域
  • 內容項目狀態結果
    • 重新索引狀態 * 內容項目重新索引狀態
  • TextQuerySessionResult
    • IsValid
  • ImageQuerySessionResult
    • IsValid
  • 查詢內容項目篩選標記

• 修正了安裝過程中 WindowsAppSDK 安裝程式沒有進度的問題，導致安裝程式看起來卡住。 安裝人員現在能提供更清晰的進度回饋。
• 在類別函式庫啟用 WindowsAppSDKSelfContained 的情境下，改進錯誤處理。

本版本包含以下與 1.8.5 版本相比的新且修改過的實驗性 API：

---

Microsoft.Graphics.Imaging

    ImageBufferPixelFormat
        Bgr8

Microsoft.UI.Content

    DesktopPopupSiteBridge
        AnchoringBehavior
        AnchoringPixelAlignment

    PopupAnchor

Microsoft.UI.Input

    InputFocusController
        ShouldShowKeyboardCues

    PointerPoint
        GetCurrentPoint

Microsoft.UI.Xaml.Automation.Peers

    SplitMenuFlyoutItemAutomationPeer

Microsoft.UI.Xaml.Controls

    SplitMenuFlyoutItem
    SystemBackdropElement

Microsoft.Windows.Management.Deployment

    AddPackageOptions
        GetValidationEventSourceForUri
        IsPackageValidationSupported
        PackageValidators

    IPackageValidator
    PackageCertificateEkuValidator
    PackageFamilyNameValidator
    PackageMinimumVersionValidator
    PackageValidationEventArgs
    PackageValidationEventSource
    PackageValidationHandler
    PackageVolume
        AddAsync
        GetAvailableSpaceAsync
        GetDefault
        GetPackageVolumeByName
        GetPackageVolumeByPath
        IsFeatureSupported
        IsOffline
        RemoveAsync
        SetDefault
        SetOfflineAsync
        SetOnlineAsync

    PackageVolumeFeature
    StagePackageOptions
        GetValidationEventSourceForUri
        IsPackageValidationSupported
        PackageValidators

Microsoft.Windows.Search.AppContentIndex

    AppContentIndexContract
    AppContentIndexer
    AppContentIndexListener
    AppIndexContentRegion
    AppIndexImageQuery
    AppIndexImageQuerySession
    AppIndexQueryMatch
    AppIndexTextQuery
    AppIndexTextQuerySession
    AppIndexTextStreamEncoding
    AppManagedImageQueryMatch
    AppManagedIndexableAppContent
    AppManagedTextQueryMatch
    ContentItemErrorDetail
    ContentItemReader
    ContentItemReindexingStatus
    ContentItemStatus
    ContentItemStatusResult
    ContentRegionTextOptions
    DeleteIndexResult
    DeleteIndexStatus
    DeleteIndexWhileInUseBehavior
    GetOrCreateIndexOptions
    GetOrCreateIndexResult
    GetOrCreateIndexStatus
    ImageQueryMatch
    ImageQueryOptions
    ImageQuerySessionResult
    IndexableAppContent
    IndexCapabilities
    IndexCapabilitiesOfCurrentSystem
    IndexCapability
    IndexCapabilityInitializationStatus
    IndexCapabilityLanguageStatus
    IndexCapabilityOfCurrentSystemStatus
    IndexCapabilityRequirement
    IndexCapabilityState
    IndexStatistics
    QueryContentItemsFilterFlags
    QueryMatchContentKind
    QueryMatchScope
    RegionContentKind
    TextLexicalMatchType
    TextQueryMatch
    TextQueryOptions
    TextQuerySessionResult

Microsoft.Windows.SemanticSearch

    EmbeddingVector
    SemanticSearchContract

Microsoft.Windows.Storage.Pickers

    FileOpenPicker
        FileTypeChoices
        InitialFileTypeIndex
        SettingsIdentifier
        SuggestedFolder
        SuggestedStartFolder
        Title

    FileSavePicker
        InitialFileTypeIndex
        SettingsIdentifier
        ShowOverwritePrompt
        SuggestedStartFolder
        Title

    FolderPicker
        PickMultipleFoldersAsync
        SettingsIdentifier
        SuggestedFolder
        SuggestedStartFolder
        Title

Microsoft.Windows.Vision

    ScreenRegionBoundingBox
    ScreenRegionDetectionContract
    ScreenRegionLabel

• 新的 AIComputeDevice API 讓應用程式在建立 文字識別器時，選擇預設的執行裝置、CPU 或 NPU 執行裝置。 ContentRegionImageOptions.PreferredTextRecognizerDevice 會為 App Content Index 影像索引期間執行的 OCR 提供相同的裝置偏好設定。
• AI 語音現在使用 SpeechRecognitionModelFactory 和 SpeechRecognitionModelFactoryOptions 來配置和建立語音辨識模型。 音訊輸入法現在接受 16 位元取樣緩衝區，連續識別會非同步停止，串流識別事件則會暴露提供者專屬的特性。
• LanguageModel.ModelName、 LanguageModel.ModelVersion 和 LanguageModelLowRankAdapterStatus 讓應用程式在載入低階介面卡時，辨識已安裝的語言模型並檢查相容性結果。
• LanguageModelResponseStatus.BlockedByGameMode 與 LanguageModelResponseStatus.LowOnVram 表示回應因為已啟用遊戲模式或可用顯示記憶體不足而無法完成。

新的實驗性 FrameworkElement.SetThemeResourceBinding API 可讓應用程式透過程式碼建立等同於 {ThemeResource} 繫結的效果。 （執行階段相容性變更：WinUI_SetThemeResourceBinding）

一個新的實驗性 DataTemplate 建構器接受應用程式提供的代理，該代理會建立模板的元素子樹。 （執行階段相容性變更：WinUI_DataTemplateFromDelegate）

實驗性的 TableView 控制項現已公開於 WinMD 中取得。 它支援用模板化的群組標頭進行分組，並以欄頭排序指示器進行排序與篩選，指標與鍵盤欄位大小調整，以及儲存格與欄標頭的可選工具提示。 （執行階段相容性變更：TableView_TabularBinaryActivation）

此版本新增了實驗性的 WinUI 3 圖表 控制項，可將笛卡兒資料呈現為線列、面積與長條列。 此控制器支援可設定的軸、圖例、資料標籤及資料標記。 （執行階段相容性變更：Charts_ExperimentalControlApi）

• 新增了 InkPresenter.ActivateCustomDrying 和 InkSynchronizer，讓應用程式能透過 BeginDry 和 EndDry 自行渲染已承諾的墨水。
• 修正了在自訂乾燥啟動時讀取 InkPresenter.StrokeContainer 可能發生的存取違規。
• 在 RenderTransform 下固定了 InkCanvas presenter 的大小。
• 將實驗性的 InkToolbar API 與審查設計對齊。 工具列現在可直接以 InkPresenter 為目標，而不再需要 InkCanvas。 （執行相容性變更：InkCanvas_InkingSupport）

• 修正了 WinUI 資源追蹤問題，當應用程式反覆建立視覺狀態分鏡或解析靜態或主題資源時，可能導致記憶體使用增加。 （執行階段相容性變更：WinUI_ResourceGraphExpiredDependencyPruning）
• 改善了 .NET 應用程式中，在索引標籤或頁面關閉後，對無法存取的原生 WinUI 物件的清理。 (執行階段相容性變更: WinUI_OrphanedObjectGCCollection)

本版本包含以下與 2.4 實驗 版本相比的新且更新的 API：

Microsoft.UI.Xaml

    DataTemplate
        DataTemplate (elementFactory)

    DataTemplateElementFactory

    FrameworkElement
        SetThemeResourceBinding

Microsoft.UI.Xaml.Controls

    InkPresenter
        ActivateCustomDrying
        HighContrastAdjustment

    InkToolbar
        TargetInkPresenter

    InkStrokeInput
        InkPresenter

    InkSynchronizer

    InkUnprocessedInput
        InkPresenter

Microsoft.UI.Xaml.Controls.Charts

    AreaSeries
    Axis
    BarOrientation
    BarSeries
    CartesianAxis
    CartesianSeries
    CategoryAxis
    CategorySortKey
    Chart
    DataLabelOverride
    DataMarkerOverride
    DateTimeAxis
    DateTimeIntervalType
    GridLines
    LinearAxis
    LineSeries
    MarkerShape
    Samples
    SortOrder
    StrokeDashStyle
    WinUIChartingContract
    XamlChartsResources

Microsoft.UI.Xaml.Controls.Tabular

    ITableViewSortComparer
    SortDirection
    TableView
    TableViewAutomationPeer
    TableViewBeginningEditEventArgs
    TableViewCellAutomationPeer
    TableViewCellEditEndingEventArgs
    TableViewCellsPanel
    TableViewColumn
    TableViewColumnHeaderAutomationPeer
    TableViewDensity
    TableViewEditAction
    TableViewFrozenEdge
    TableViewGridLinesVisibility
    TableViewGroupHeader
    TableViewGroupHeaderAutomationPeer
    TableViewGroupHeaderToggleRequestedEventArgs
    TableViewGroupInfo
    TableViewHeadersVisibility
    TableViewIdentitySelector
    TableViewKeySelector
    TableViewPredicate
    TableViewRow
    TableViewRowAutomationPeer
    TableViewRowTemplateSelector
    TableViewSelectionMode
    TableViewSortCycle
    TableViewSortedEventArgs
    TableViewSortingEventArgs
    TableViewSource
    TableViewTemplateColumn
    TableViewTextColumn
    TabularControlsResources

Microsoft.UI.Xaml.XamlTypeInfo

    XamlControlsChartsXamlMetaDataProvider
    XamlControlsTabularXamlMetaDataProvider

Microsoft.Windows.AI

    AIComputeContract
    AIComputeDevice

Microsoft.Windows.AI.Imaging

    TextRecognizer
        CreateAsync
        EnsureReadyAsync
        GetReadyState

Microsoft.Windows.AI.Speech

    BatchRecognition
        Recognize

    SpeechAudioProvider
        PushData

    SpeechRecognitionModelFactory
    SpeechRecognitionModelFactoryOptions

    StreamingRecognition
        StopContinuousRecognitionAsync

    StreamingRecognizedEventArgs
        GetProperty

    StreamingRecognizingEventArgs
        GetProperty

Microsoft.Windows.AI.Text

    LanguageModel
        ModelName
        ModelVersion

    LanguageModelLowRankAdapterResult
        Status

    LanguageModelLowRankAdapterStatus

    LanguageModelResponseStatus
        BlockedByGameMode
        LowOnVram

Microsoft.Windows.Search.AppContentIndex

    ContentRegionImageOptions
        PreferredTextRecognizerDevice

此版本新增了 WinUI 3 透過 InkCanvas、 InkToolbar 和 InkPresenter 的墨線支援，包括筆與觸控輸入、剪貼簿支援、高對比度支援、筆劃輸入及未處理的輸入。 （執行相容性變更：InkCanvas_InkingSupport）

此版本包含以下與 2.3 實驗 A 版本相比的新 API：

Microsoft.UI.Xaml.Automation.Peers

    InkToolbarAutomationPeer
    InkToolbarFlyoutItemAutomationPeer
    InkToolbarMenuButtonAutomationPeer
    InkToolbarToolButtonAutomationPeer

Microsoft.UI.Xaml.Controls

    InkCanvas
        InkPresenter

    InkHighContrastAdjustment
    InkInputConfiguration
    InkInputProcessingConfiguration
    InkInputProcessingMode
    InkInputRightDragAction
    InkPresenter
    InkStrokeContainer
    InkStrokeInput
    InkStrokesCollectedEventArgs
    InkStrokesErasedEventArgs
    InkToolbar
    InkToolbarBallpointPenButton
    InkToolbarButtonFlyoutPlacement
    InkToolbarCustomPen
    InkToolbarCustomPenButton
    InkToolbarCustomToggleButton
    InkToolbarCustomToolButton
    InkToolbarEraserButton
    InkToolbarEraserFlyoutItemClickedEventArgs
    InkToolbarEraserFlyoutItemKind
    InkToolbarEraserKind
    InkToolbarFlyoutItem
    InkToolbarFlyoutItemKind
    InkToolbarHighlighterButton
    InkToolbarInitialControls
    InkToolbarIsStencilButtonCheckedChangedEventArgs
    InkToolbarMenuButton
    InkToolbarMenuKind
    InkToolbarPenButton
    InkToolbarPencilButton
    InkToolbarPenConfigurationControl
    InkToolbarRulerButton
    InkToolbarStencilButton
    InkToolbarStencilKind
    InkToolbarToggle
    InkToolbarToggleButton
    InkToolbarTool
    InkToolbarToolButton
    InkUnprocessedInput

Microsoft.Windows.AI.Text

    LanguageModelResponseStatus
        LanguageMismatch
        UnsupportedLanguage

新的實驗性 Window.Width 和 Window.Height 屬性，為應用程式提供了一種可感知 DPI 的方式，讓它們可直接從程式碼或標記語言中，以邏輯（用戶端）像素取得及設定視窗大小，而無須透過 Window.AppWindow 並手動進行從邏輯像素到實體像素的 DPI 轉換。 Companion Window.MinWidth、 Window.MinHeight、 Window.MaxWidth 和 Window.MaxHeight 屬性會限制視窗大小。 歡迎您提供意見反應。

實驗性的 SpeechAudioProvider （用於將 16 kHz、16 位元、單聲道 PCM 音訊推入語音辨識）現已實作 IClosable，應用程式可在完成串流音訊後，確定性地以 Close/Dispose 釋放提供者。

實驗性的應用程式內容索引 API 在此版本中新增索引功能，並大幅提升了可靠性與效能：

• 更快的批次索引。 新的 AppContentIndexer.BatchAddOrUpdate API 允許多個項目同時被索引。 索引管線也重新設計，以支援平行階段執行及更有效率的批次處理。
• 改進的多語言分詞化。 App Content Index 現在使用以 ICU 為基礎的斷詞器，提升跨語言的分詞正確性，同時移除對 WinRT WordsSegmenter 的依賴。
• 提升索引與查詢效能。 索引更新現在可避免不必要的詞彙層級重寫、讓批次清理作業更有效率，並在不同查詢之間快取索引能力，從而大幅降低常見查詢與索引處理路徑中的額外負擔。
• 詞彙排名更穩定。 BM25 評分現在會獨立維護文件長度統計資料，因此在內容逐步更新或移除時，仍可維持一致的排名結果。
• 自動毀損復原。 App Content Index 在開啟索引時偵測資料庫損壞及不相容的結構變更，並透過重新索引自動恢復，而非讓索引無法使用。 GetOrCreateIndexStatus.RecoveredFromCorruption 會標示復原發生的時間。
• 靜態排名加權。 新的 API 讓應用程式能對個別內容項目或區域施加排名提升，並利用應用程式提供的訊號來調整結果。 當您的應用程式了解內容本身無法反映的內容相對重要性時，請使用靜態提升；例如，這可協助讓特別重要或您的使用者經常查找的文件更容易顯示出來。
• 圖片內容索引。 應用程式現在可以直接索引點陣圖或影像串流內容，並可控制擷取後的 OCR 擷取與語意索引。 當圖片中包含有意義的可搜尋資訊，而非已以文字形式取得時，請使用圖片索引，例如截圖、掃描文件或其他視覺內容。
• 文字的語意索引控制。 新增 的 ContentRegionTextOptions.AllowSemanticIndexing 功能讓應用程式可以選擇個別文本區域退出語意索引。 這對於應該在詞彙上仍可搜尋但語意匹配不太可能受益的文字非常有用，讓應用程式能更好地控制哪些內容參與語意檢索。

本版本與 2.2 Experimental 9 版本相比，包含以下新 API：

Microsoft.UI.Composition

    CompositionEngine
    CompositionEngineType

Microsoft.UI.Xaml

    Window
        Height
        MaxHeight
        MaxWidth
        MinHeight
        MinWidth
        Width

Microsoft.UI.Xaml.Settings

    XamlChangeId
    XamlOptionalChanges

Microsoft.Windows.AI.Speech

    SpeechAudioProvider
        Dispose

Microsoft.Windows.AI.Text

    GenerateStructuredJsonResponseResult
    GenerateStructuredJsonResponseStatus
    LanguageModel
        GenerateStructuredJsonResponseAsync

Microsoft.Windows.Search.AppContentIndex

    AppContentIndexer
        BatchAddOrUpdate
        GetContentStaticBoost
        GetRegionStaticBoost
        ResetAllStaticBoosts
        SetContentStaticBoost
        SetRegionStaticBoost

    AppIndexContentRegion
        CreateFromBitmap
        CreateFromImageStream
        StaticBoost

    AppManagedIndexableAppContent
        CreateFromBitmap
        CreateFromImageStream

    BatchAddOrUpdateItemResult
    BatchAddOrUpdateResult
    ContentRegionImageOptions
    ContentRegionTextOptions
        AllowSemanticIndexing

    GetOrCreateIndexStatus
        RecoveredFromCorruption

    ImageOcrIndexingOptions
    IndexableAppContent
        StaticBoost

語言模型 API 現已可在配備支援 GPU 的非 Copilot+ PCs 上運行，將本地語言模型功能帶給更廣泛的 Windows 11 裝置。 支援硬體包括 NVIDIA GeForce RTX 30 系列及更新版本，配備 6+ GB 顯存。 GPU 推論需要啟用開發者模式並建立 Windows Insider Experimental Channel 版本。

GPU 型號並非預裝。 可透過 EnsureReadyAsync 至 Windows Update 隨需下載。 應用程式在觸發下載前應該檢查 GetReadyState 並顯示同意對話框。 使用者可在設定>>系統 AI 元件中管理模型。

如需了解負責任 AI 的相關指引，請參閱新的透明度附註：非 Copilot+ PC 上的語言模型 API。

Microsoft.Windows.AI.Speech 的全新裝置語音辨識 API 支援批次與串流語音轉文字。 BatchRecognition可在單次呼叫中辨識完整的音訊來源，而StreamingRecognition會引發Recognizing和Recognized事件。 音訊可從裝置AudioConfiguration.FromAudioDevice（）、檔案（FromFile）、輸入串流（FromStream）來源，或由呼叫者透過 SpeechAudioProvider （16 kHz、16位元、單聲道 PCM）推送。 裝置端模型透過 SpeechRecognitionModel.EnsureReadyAsync / TryCreateAsync 進行管理，而下載與載入進度則透過 SpeechRecognitionModelProgress 回報。

新的 Microsoft.Windows.Workloads.NpuType 枚舉會顯示目前裝置上的 NPU 類別（例如 Qnn、Lnl、Stx、Win365、Unknown、None），因此應用程式與工作負載基礎設施能將 AI 工作負載導向適當的執行路徑。

此版本與 2.1 Experimental 8 版本相比，包含以下新 API：

Microsoft.UI.Xaml

    Setter
        ValueProperty

Microsoft.UI.Xaml.Markup

    XamlBindingHelper
        SetPropertyFromColor
        SetPropertyFromCornerRadius
        SetPropertyFromThickness

Microsoft.Windows.AI.Speech

    AudioConfiguration
    BatchRecognition
    SpeechAudioProvider
    SpeechContract
    SpeechRecognitionModel
    SpeechRecognitionModelProgress
    SpeechRecognitionModelProgressStatus
    SpeechRecognitionModelResult
    StreamingRecognition
    StreamingRecognizedEventArgs
    StreamingRecognizingEventArgs

Microsoft.Windows.AI.Text.Experimental

    LanguageModelExperimental
        CompressPromptAsync
        GenerateResponseAsync
        GenerateResponseFromEmbeddingsAsync

    LanguageModelOptionsExperimental
        PreferredRetentionRatio

Microsoft.Windows.Workloads

    NpuType

LanguageModelExperimental.GenerateStructuredJsonResponseAsync（在 2.0 Experimental 7 中引入）現在會回傳具有 GenerateStructuredJsonResponseResult 屬性的專用 GenerateStructuredJsonResponseStatus 型別，而不是通用的 LanguageModelResponseResult / LanguageModelResponseStatus 配對。 新的狀態列舉專用於受結構描述約束的生成：其中包含一個 ResponseInvalidJson 值，用於表示模型輸出未滿足所要求的 JSON 結構描述的情況，並與一般性的語言模型回應失敗分開。

作為這次拆分的一部分，該 ResponseInvalidJson 值已 從 穩定 LanguageModelResponseStatus 枚舉中移除（該值先前是為了支援結構化 JSON 輸出而新增的）。 處理來自 ResponseInvalidJson 的 LanguageModelResponseStatus 的應用程式，應將該處理移至由 GenerateStructuredJsonResponseStatus 傳回的新 GenerateStructuredJsonResponseAsync。 呼叫 LanguageModelResponseStatus 的其他程式不再需要處理 JSON 專用的失敗值。

本版本包含以下與 2.0 Experimental 7 版本相比的新 API：

Microsoft.UI.Xaml.Controls

    TitleBar
        AutoRefreshDragRegions
        AutoRefreshDragRegionsProperty
        GetIsDragRegion
        IsDragRegionProperty
        RecomputeDragRegions
        SetIsDragRegion

Microsoft.Windows.AI

    AICapabilities

    AICapabilityCategory

Microsoft.Windows.AI.Text

    LanguageModelLowRankAdapter

    LanguageModelLowRankAdapterResult

    LanguageModelOptions
        LowRankAdapter

    LanguageModelResponseStatus
        IncompatibleLowRankAdapter

Microsoft.Windows.AI.Text.Experimental

    GenerateStructuredJsonResponseResult

    GenerateStructuredJsonResponseStatus

    LanguageModelOptionsExperimental
        LowRankAdapter [Experimental]

Windows 應用程式 SDK 2.0.0-experimental7 引入了實驗性的 CMake 支援（目前仍在開發中），使 C++ 開發者能夠從基於 CMake 的專案中使用 Windows 應用程式 SDK NuGet 套件。

CMake 整合建立在 NuGetCMakePackage 上，這是一個開源的 CMake 模組，橋接了 NuGet 套件管理與 CMake 原生 find_package() 工作流程之間的橋樑。 NuGetCMakePackage 在配置時透過add_nuget_packages()下載並還原 NuGet 套件，探測每個套件中的內嵌 CMake 設定（在build/cmake/<package>-config.cmake），並將套件的標頭、匯入函式庫、執行時 DLL 和 WinRT 元資料公開為標準 CMake 目標。

每個 Windows 應用程式 SDK NuGet 元件與相依套件現在會在 build/cmake/ 下嵌入 CMake 設定檔，藉由 NuGetCMakePackage 函式庫，讓 CMake 的 find_package() 能自動發現目標、標頭、函式庫及執行時 DLL，無需手動設定路徑。 這涵蓋所有元件套件，包括 Foundation、InteractiveExperiences、DWrite、Widgets、AI、ML 和 WinUI，以及像 Base 和 Runtime 這類相依性。

關於 CMake 消費模式的概述及入門指引，請參閱 CMake 登陸頁面。

此功能仍屬實驗性質，並提前發布以收集社群回饋。 目標命名慣例與配置模式會根據開發者輸入而調整。 由於這是早期飛行，會有一些儀式與設定——請參閱 CMake 範例應用程式 ，該範例展示了四種部署情境SelfContained|FrameworkDependent 下的端到端配置與使用方式（x Packaged|Unpackaged）。

歡迎您提供相關資訊！ 如果你遇到目前未涵蓋的情況、有改善開發者體驗的建議，或遇到問題，請在Windows 應用程式 SDK開源倉庫的 Issues 標籤下提交回饋，或在 Discussions 發起討論。 你的意見將直接影響此功能的積極開發。

這個實驗性版本整合了 2.0-Preview1 和 2.0-Preview2 中發布的變更與修正。 以下為所提出的事項摘要;完整詳情請參閱連結的預覽版發行說明。

從 2.0 到 預覽1：

• Windows ML：修復 RegisterCertifiedAsync 在同一程序中再次呼叫時返回 0 執行提供者的問題。
• Microsoft。UI。Content：新增 InputFocusController.ShouldShowKeyboardCues 屬性及新的便利 API PointerPoint.GetCurrentPoint。
• Microsoft.Windows。Management.Deployment：新增 PackageVolume API，支援 parity+ 與 Windows.Management.Deployment（包括 AddAsync、GetDefault、GetAvailableSpaceAsync、IsAppxInstallSupported、IsOffline、IsFeatureSupported 等）。 在IPackageValidator和AddPackageOptions以及StagePackageOptions上新增的可擴展點，內建三個驗證器：PackageCertificateEkuValidator、PackageFamilyNameValidator和PackageMinimumVersionValidator。
• Microsoft.Windows.Storage.Pickers：
  • Title、FileOpenPicker、FileSavePicker和FolderPicker新增了屬性，允許自訂對話標題。
  • 在 SettingsIdentifier、FileOpenPicker、FileSavePicker 和 FolderPicker 上新增屬性，允許跨會話維持選擇器實例的特定狀態。
  • InitialFileTypeIndex屬性新增於FileOpenPicker和FileSavePicker，允許開發者依索引（以 0 為基礎）設定預設的檔案類型過濾器。
  • 新ShowOverwritePrompt屬性在FileSavePicker上。 預設為true，並控制使用者透過FileSavePicker選擇現有檔案時，選擇器是否警告要覆寫該檔案。
  • 更改預設行為： FileSavePicker從 WindowsAppSDK 2.0 開始， FileSavePicker 使用者選擇不存在的檔案時不會產生空檔，讓開發者自行決定何時建立該檔案。
  • 新 PickMultipleFoldersAsync 方法在 FolderPicker 上，允許在一次操作中選擇多個資料夾。
• 錯誤修正：安裝程式進度回報;類別函式庫的錯誤處理 WindowsAppSDKSelfContained 改進。

從 2.0 到預覽版 2：

• Windows AI APIs：Phi Silica APIs 被強制設為有限存取功能；新的 AIFeatureReadyState 數值呈現出模型擷取問題，如功能不足、硬體不相容以及需要作業系統更新；持續安裝網路/Windows Update失敗現已被標記；文字智能 API 的診斷能力提升。
• 自訂 XAML 條件句： IXamlCondition 實驗介面升級並重新命名 IXamlPredicate ，使得在 XAML 解析時能評估自訂條件。
• WebView2（WinUI 3）：支援 WebView2 中託管內容的拖曳（文字、HTML、圖片、URL）、拖曳取消、自訂拖曳視覺化及可自訂拖曳資料。 需 WebView2 執行時間 144.0.3719.11 或更新版本。 （DownloadURL 功能尚未支援。）
• 錯誤修正：MSB8027/LNK4042 來自 .targets 檔案中重複的 ClCompile 項目引起的建置警告（有一個 opts-out 的解決方法 WindowsAppSDK_Arm64EcCompilerWorkaround，適用於 ARM64EC+LTCG）。在項目列表更新後，於鍵盤導航時的 ListView 當機。當焦點移動到一個非可見的 CoreWebView2Controller 時，WinUI 3 當機。

• 為了清晰與一致性，API 重新命名通過：
  • ScaleFrameStatus → VideoScalerStatus
  • VideoScalerOptions.RegionOfInterests → VideoScalerOptions.RegionsOfInterest
  • VideoScaler.ScaleFrame → VideoScaler.Scale 和 VideoScaler.ScaleImageBuffer
• VSR 的各種錯誤修正與品質提升。

• 新的 LanguageModelExperimental.GenerateStructuredJsonResponseAsync API 在 Microsoft.Windows.AI.Text.Experimental 之下，用於從語言模型生成結構化的 JSON 輸出。
• 新的 LanguageModelResponseStatus.ResponseInvalidJson 狀態值表示模型回傳的回應未被解析為有效 JSON。

• 新版 AppContentIndexer.GetExistingIndexes 和 AppContentIndexer.IsContentKindSupported API。
• 新增 AppManagedOcrTextQueryMatch 類型與 QueryMatchContentKind.AppManagedOcrText 價值，支援透過 OCR 衍生文字查詢應用程式內容。
• 強制建立全新索引GetOrCreateIndexOptions.CreateAlways。
• 新ContentItemErrorDetail.InsufficientDiskSpace使低磁碟空間問題在索引時顯現出來。

本版本包含以下與 2.0.0-experimental6 相比的新且修改過的實驗 API：

Microsoft.UI.Input

    InputFocusController
        ShouldShowKeyboardCues

    PointerPoint
        GetCurrentPoint

Microsoft.UI.Xaml.Markup

    IXamlCondition

Microsoft.Windows.AI

    AIFeatureReadyResult
        PackageInstallationFailed

    AIFeatureReadyState
        CapabilityMissing
        NotCompatibleWithSystemHardware
        OSUpdateNeeded

Microsoft.Windows.AI.Text

    LanguageModelResponseStatus
        ResponseInvalidJson

Microsoft.Windows.AI.Text.Experimental

    LanguageModelExperimental
        GenerateStructuredJsonResponseAsync

Microsoft.Windows.AI.Video

    VideoScaler
        Scale
        ScaleImageBuffer

    VideoScalerOptions
        RegionsOfInterest

    VideoScalerStatus

Microsoft.Windows.Management.Deployment

    AddPackageOptions
        GetValidationEventSourceForUri
        IsPackageValidationSupported
        PackageValidators

    IPackageValidator
    PackageCertificateEkuValidator
    PackageFamilyNameValidator
    PackageMinimumVersionValidator
    PackageValidationEventArgs
    PackageValidationEventSource
    PackageValidationHandler
    PackageVolume
        AddAsync
        GetAvailableSpaceAsync
        GetDefault
        GetPackageVolumeByName
        GetPackageVolumeByPath
        IsFeatureSupported
        IsOffline
        RemoveAsync
        SetDefault
        SetOfflineAsync
        SetOnlineAsync

    PackageVolumeFeature
    StagePackageOptions
        GetValidationEventSourceForUri
        IsPackageValidationSupported
        PackageValidators

Microsoft.Windows.Search.AppContentIndex

    AppContentIndexer
        GetExistingIndexes
        IsContentKindSupported

    AppManagedOcrTextQueryMatch
    ContentItemErrorDetail
        InsufficientDiskSpace

    GetOrCreateIndexOptions
        CreateAlways

    QueryMatchContentKind
        AppManagedOcrText

Microsoft.Windows.Storage.Pickers

    FileOpenPicker
        InitialFileTypeIndex
        SettingsIdentifier
        Title

    FileSavePicker
        InitialFileTypeIndex
        SettingsIdentifier
        ShowOverwritePrompt
        Title

    FolderPicker
        PickMultipleFoldersAsync
        SettingsIdentifier
        Title

現在可以透過 CMake 從 C++ 專案使用 Windows ML。 請參考 「開始」頁面 了解更多。

ONNX 執行版本已更新至 1.24.2。 更多資訊請參閱 ONNX 執行時版本 。

• NPUPowerMode 已被取代，取而代之的是更新的電源管理 API。
• GetReadyState 現在當 session broker 無法使用時，它會優雅地返回 NotSupported ，而不是拋出例外。

• 新增 NV12 輸出格式支援以支援影片超高解析度。

• 可靠性 DeleteIndex 提升。 有時候 DeleteIndex 會因為 ERROR_SHARING_VIOLATION 而失敗。

• 修正 OCR 邊界框在某些邊緣情況下回傳負值的問題。

• App Content Search 並不是 Microsoft.Windows.Search 的一部分，而是獨立的 Microsoft.Windows.AI package 套件的一部分。

• 修正前綴搜尋無法在短查詢字串下運作的問題。

• 根據官方 API 審查，新增新的 API 並重新命名。

  • AppContentIndexer
    • 取得需重新索引的內容項目
    • 移除 -> 消除內容項目
    • 刪除多個項目 -> 移除內容項目
    • 移除所有內容項目
    • 取得內容索引狀態 -> 取得內容項目狀態
    • 取得多個內容索引狀態 -> 取得內容項目狀態
    • GetContentItems
  • AppCOntentIndexListener
    • 索引狀態變更 -> 內容項目狀態變更
  • AppIndex文本查詢會話
    • 更新查詢 -> 更新查詢短語
    • 最近結果 -> 取得結果
    • 最近結果變更 -> 結果變更
  • AppIndexImageQuerySession
    • 更新查詢 -> 更新查詢短語
    • 最近結果 -> 取得結果
    • 最近結果變更 -> 結果變更
  • AppManagedImageQueryMatch
    • 子區域 -> 興趣區域
  • 內容項目狀態結果
    • 重新索引狀態 * 內容項目重新索引狀態
  • TextQuerySessionResult
    • IsValid
  • ImageQuerySessionResult
    • IsValid
  • 查詢內容項目篩選標記

• 修正了因競爭條件導致 ImageDescription.DescribeAsync 和 InternalError 故障的問題。

此版本包含以下與 2.0.0-experimental5 相比的新且修改過的實驗性 API：

Microsoft.Windows.Search.AppContentIndex

    AppContentIndexer
        GetContentItems
        GetContentItemStatus
        GetContentItemStatuses
        RemoveAllContentItems
        RemoveContentItem
        RemoveContentItems

    AppContentIndexListener
        ContentItemStatusChanged

    AppManagedImageQueryMatch
    ContentItemErrorDetail
        IndexCorruption

    ContentItemReindexingStatus
        Unspecified

    QueryContentItemsFilterFlags

• 簡化授權協議，條款更明確，適用於使用 Windows ML 建置應用程式的 ISV。
• 重新結構化的章節涵蓋安裝、資料及可發佈程式碼，並以更清晰的語言呈現。
• 新執行提供者（EP）合規通知章節釐清開發者對硬體加速執行提供者的責任。
• 直接連結至 NVIDIA TensorRT、Intel OpenVINO 及 Qualcomm QNN（Qualcomm 神經網路 SDK）的廠商授權協議。

• Windows ML 實驗版本與 ONNX 執行時主線版本 1.24 對齊，以提升相容性與穩定性。
• 穩定應用二進位介面（ABI）執行提供者被強制執行，以確保各裝置間的行為可預測，非穩定執行提供者則被排除在擷取之外。
  • 目前僅支援 OpenVINO 執行提供者，隨著符合穩定性要求，未來會陸續新增執行提供者。
• Microsoft.Windows.AI.MachineLearning.dll 的大小縮減約 160 KB。

• 新的實驗性 API 用來查詢被索引項目的統計數據。 這讓你能清楚看到索引中發生的事情。
• 支援查詢取消功能，讓應用程式能執行查詢，並在存在新查詢前更新該查詢。 這讓使用者能更快回應查詢，因為使用者在輸入查詢字串時會更快回應。
• 支援短字串的前綴匹配，以提升使用者輸入時的結果。

• VideoScaler 現在已成為一次性產品，提升了資源管理與生命週期控制。
• VSR 模型現已編譯並快取，以提升效能並降低重複初始化成本。
• 在使用前新增了一個功能檢查來驗證 VSR 支援。
• 使用視訊超解析度時不再需要明確的 WinML 初始化。

• FlowLayout控制項現在使用物品間距（ItemSpacing）和行間距（LineSpacing）術語，取代水平與垂直間距特性。 對齊命名提升了現代版面配置模式在不同 UI 框架中的清晰度與一致性。

• WrapPanel控制現在改用 ItemSpacing 和 LineSpacing 命名法，取代先前的水平與垂直間距特性。

• 已實作 IXamlPredicate 介面，以定義能無縫整合 XAML 的條件命名空間語法的自訂謂詞，並在 XAML 解析時進行評估。
• 自訂謂詞可根據應用特定因素實現條件式 XAML 情境，例如：
  • 功能標幟
  • 裝置功能
  • 業務邏輯
  • 組態設定
  • 其他執行條件

• 更新套件以實現外部可用性，包含以下變更：
  • Microsoft。UI。DCPP。依賴性。極少
  • Microsoft.UI.DCPP.Dependencies.Edge
  • ExpPointerPointStatics
• 新增 Visual Studio 2026 建置支援
• 引入外部開發者用來建置與測試 WinUI 的工具與腳本。

• [已棄用]DependencyObject.Dispatcher
• [已棄用]目前視窗
• [已棄用]FocusManager.GetFocusedElement
• [更名]SystemBackdropHost 為 SystemBackdropElement

• [更名] Microsoft.Windows.AI.Search.Experimental.AppContentIndex 轉為 Microsoft.Windows.Search.AppContentIndex

• 修正了在使用 Windows ML 的自包含部署時出現的「類別未註冊」錯誤。 使用自包含部署的開發者不再需要註冊所有內部使用的可啟用的 Foundation 套件類別。
• 修正了使用 Windows ML 時程序關機時可能發生的當機問題。
• 修正了 ImageForegroundExtractor API 路由路徑，讓呼叫能到達正確的端點。
• 確保執行提供者的安裝與下載進度在套件部署時正確轉發給應用程式。
• 修正了當目標斷線時 SystemBackdrop 的崩潰問題，方法是保護無效斷線路徑。
• 修正了一個導致部分應用程式無法使用 Windows AI API 的問題。

本版本包含以下與 2.0.0-experimental3 相比的新且修改過的實驗性 API：

Microsoft.UI.Content

    ChildSiteLink
        IsHitTestVisible

Microsoft.UI.Xaml.Controls

    FlowLayout
        LineSpacing
        LineSpacingProperty
        MinItemSpacing
        MinItemSpacingProperty

    SystemBackdropElement
    WrapPanel
        ItemSpacing
        ItemSpacingProperty
        ItemsStretch
        ItemsStretchProperty
        LineSpacing
        LineSpacingProperty

    WrapPanelItemsStretch

Microsoft.UI.Xaml.Markup

    IXamlPredicate

Microsoft.Windows.AI.Video

    VideoScaler
        Dispose

Microsoft.Windows.Search.AppContentIndex

    AppContentIndexContract
    AppContentIndexer
    AppContentIndexListener
    AppIndexContentRegion
    AppIndexImageQuery
    AppIndexImageQuerySession
    AppIndexQueryMatch
    AppIndexTextQuery
    AppIndexTextQuerySession
    AppIndexTextStreamEncoding
    AppManagedImageQueryMatch
    AppManagedIndexableAppContent
    AppManagedTextQueryMatch
    ContentItemErrorDetail
    ContentItemReader
    ContentItemReindexingStatus
    ContentItemStatus
    ContentItemStatusResult
    ContentRegionTextOptions
    DeleteIndexResult
    DeleteIndexStatus
    DeleteIndexWhileInUseBehavior
    GetOrCreateIndexOptions
    GetOrCreateIndexResult
    GetOrCreateIndexStatus
    ImageQueryMatch
    ImageQueryOptions
    ImageQuerySessionResult
    IndexableAppContent
    IndexCapabilities
    IndexCapabilitiesOfCurrentSystem
    IndexCapability
    IndexCapabilityInitializationStatus
    IndexCapabilityLanguageStatus
    IndexCapabilityOfCurrentSystemStatus
    IndexCapabilityRequirement
    IndexCapabilityState
    IndexStatistics
    QueryMatchContentKind
    QueryMatchScope
    RegionContentKind
    TextLexicalMatchType
    TextQueryMatch
    TextQueryOptions
    TextQuerySessionResult

• ONNX 執行時迴歸會導致 Qualcomm 裝置上的視訊超解析度失效。 Qualcomm NPU 執行提供者的待更新已解決此問題。

新的實驗性 SplitMenuFlyoutItem 控制項旨在在功能表快顯中提供分割按鈕的互動體驗。 此控制項將使開發人員能夠公開預設的主要操作，同時還透過子選單提供其他選項，非常適合將複雜的功能壓縮到更小的佔用空間中並節省整體選單長度。

除了 MenuFlyoutItem 和 MenuFlyoutSubItem 的功能之外，控制項還帶有另外兩個屬性：SubMenuPresenterStyle 和 SubMenuItemStyle，可以自訂子功能表，例如將 GridView 用於子功能表的呈現器。

    <Button Content="Open file">
        <Button.Flyout>
            <MenuFlyout>
                <SplitMenuFlyoutItem Text="Open with Notepad">
                    <MenuFlyoutItem Text="Visual Studio" />
                    <MenuFlyoutItem Text="VS Code" />
                    <MenuFlyoutItem Text="Word" />
                </SplitMenuFlyoutItem>
            </MenuFlyout>
        </Button.Flyout>
    </Button>

重新命名的類型

• 已重新 WinMLCatalogModel 命名為 ModelCatalog
• 已重新 CatalogModelSource 命名為 ModelCatalogSource

方法更新

• CatalogModelInfo：重新命名 GetInstance 為 GetInstanceAsync
• ModelCatalogSource：重新命名 CreateFromUri 為 CreateFromUriAsync
• ModelCatalog：重新命名 FindModel 為 FindModelAsync
• ModelCatalog：重新命名 FindAllModels 為 FindAllModelsAsync

屬性變更

• 將CatalogModelInfo.Size更新為CatalogModelInfo.ModelSizeInBytes

行為更新

• 從 CatalogModelInstanceResult 使用 .GetInstance() 擷取執行個體。
• CatalogModelStatus 現在會根據本機可用性返回 Ready 或 NotReady
• 已新增 CatalogModelInstanceStatus 以將實例狀態與模型狀態分開

CatalogModelInfo 增強功能

• 已重新 Alias 命名為 Name
• 已重新 Revision 命名為 Version
• 新增 Publisher
• 已移除 DisplayName

JSON 變更

• 將 alias 更名為 id。
• 已移除 modelType 與 description。
• 將 executionProvider 更名為 executionProviders。
• 更新 executionProviders 為 JSON 物件陣列，而不是逗號分隔的清單。

其他變更

• ModelCatalog 現在會在建立執行個體時傳回執行提供者 （EP） 的清單。
• 新增對 Windows 10（1809）及以上版本的支援。
• 新增了對本機檔案的支援，包括一般檔案和 MSIX 套件。
• 修正因無效目錄 JSON 所導致的當機問題。

• 先前 AppIndexQuery 的類型（包括 GetNextTextMatches 和 GetNextImageMatches 方法）已分為兩種不同的類型： AppIndexTextQuery 和 AppIndexImageQuery。 該 AppContentIndexer.CreateQuery 方法已替換為： CreateTextQuery 和 CreateImageQuery。

• 這些方法現在分別傳回 AppIndexTextQuery 和 AppIndexImageQuery 。 為了簡化使用，選項類型也已更新：

  • 已移除：AppIndexQueryOptions、TextMatchOptions及ImageMatchOptions
  • 新增： TextQueryOptions 和 ImageQueryOptions

• 命名空間中 AppContentIndex 先前傳回陣列的 API 現在會傳回 IVectorView ，以改善一致性和效能。

• 該 AppContentIndexer.WaitForIndexingIdleAsync 方法已更新為接受 TimeSpan 參數而不是整數，從而提供更清晰、更靈活的逾時處理。

該 VideoScaler API 通過先進的 AI 升級提供實時視頻增強，針對對話中的人流進行了優化。 它使開發人員能夠在會議、串流媒體和編輯平台上提供更清晰、更清晰的視覺效果，即使在網路條件不佳的情況下也是如此。 該 API 支持自定義輸出分辨率、幀速率和感興趣區域，兼容多種視頻格式，包括 BGR、RGB 和 NV12。

新的 RewriteCustomAsync API 可讓您提供輸入字串，以引導 Phi Silica 重寫選取的文字。 您可以嘗試新的創意風格，如「搞笑」或「海盜」，以立即改變您的內容。

該 ImageGenerator 課程利用穩定擴散模型提供強大的圖像生成功能。 它支援多個生成場景：

• 文字轉圖像： 從描述性文字提示產生圖像。

• 圖像到圖像： 根據文字描述轉換現有影像。

• 魔法填充： 用 AI 生成的內容填充圖像的遮罩區域。

• 圖畫書風格： 生成著色書風格的圖像。

• 重新設計： 改變現有圖像的藝術風格，同時保留結構。

所有產生的影像都會透過 ImageBuffer 物件以 RGB8 格式傳回。 該 API 包括內置 的內容安全過濾器 ，並支持可自定義的生成參數。

using Microsoft.Windows.AI.Imaging;
using Microsoft.Graphics.Imaging;
 
public async Task GenerateImageFromText()
{
    var readyState = ImageGenerator.GetReadyState();
    if (readyState != AIFeatureReadyState.Ready)
    {
        var progress = new Progress<double>(p => Console.WriteLine($"Download progress: {p:P}"));
        var result = await ImageGenerator.EnsureReadyAsync();
        if (result.Status != AIFeatureReadyResultState.Success)
        {
            Console.WriteLine("Failed to prepare models");
            return;
        }
    }
 
    using var generator = await ImageGenerator.CreateAsync();
 
    var options = new ImageGenerationOptions
    {
        MaxInferenceSteps = 6,
        Creativity = 0.8,
        Seed = 42
    };
 
    var result = generator.GenerateImageFromTextPrompt("A beautiful sunset over a mountain lake", options);
 
    if (result.Status == ImageGeneratorResultStatus.Success)
    {
        await SaveImageBufferAsync(result.Image, "generated_image.png");
    }
}

與 2.0-experimental2 相比，此版本包含下列新的和修改的實驗性 API：

Microsoft.Graphics.Imaging

    ImageBufferPixelFormat
        Bgr8

Microsoft.UI.Xaml.Automation.Peers

    SplitMenuFlyoutItemAutomationPeer

Microsoft.UI.Xaml.Controls

    SplitMenuFlyoutItem

Microsoft.Windows.AI.Imaging

    ImageFromImageGenerationOptions
    ImageFromImageGenerationStyle
    ImageFromTextGenerationOptions
    ImageFromTextGenerationStyle
    ImageGenerationOptions
    ImageGenerator
    ImageGeneratorContract
    ImageGeneratorResult
    ImageGeneratorResultStatus
    TextRecognizer
        RecognizeTextFromImage
        RecognizeTextFromImageAsync

    TextRecognizerOptions

Microsoft.Windows.AI.MachineLearning

    CatalogModelInfo
    CatalogModelInstance
    CatalogModelInstanceResult
    CatalogModelInstanceStatus
    CatalogModelStatus
    ModelCatalog
    ModelCatalogSource

Microsoft.Windows.AI.Search.Experimental.AppContentIndex

    AppContentIndexer
        CreateImageQuery
        CreateTextQuery
        WaitForIndexingIdleAsync

    AppIndexImageQuery
    AppIndexTextQuery
    ImageQueryOptions
    TextQueryOptions

Microsoft.Windows.AI.Text

    TextRewriter
        RewriteCustomAsync

Microsoft.Windows.AI.Video

    ScaleFrameStatus
    VideoScaler
    VideoScalerOptions
    VideoScalerResult

• 修正文字旋轉時的邊界框計算。 在某些情況下，影像內的 OCR 文字比對會在文字旋轉時報告區域邊界不準確或空白。

AppContentIndexer API 可讓開發人員有效率地索引應用程式內容，包括文字和影像，以快速且相關的擷取。 這些 API 支援詞彙（基於關鍵字）和語義（基於含義）搜索，允許應用程式根據使用者意圖和上下文（而不僅僅是確切的關鍵字）提供快速、相關的結果。

此功能開啟下列進階情境：

• 語意搜尋
  應用程式可以根據意圖和意義傳回結果，而不是完全匹配的關鍵字。
  範例： 查詢 「專案時間軸」 可能會出現提到 「排程」 或 「交付日期 」的內容，即使這些詞彙並非明確使用。
• 檢索增強生成（RAG）
  索引內容可以作為生成式 AI 模型的知識庫。 當用戶提出問題時，應用程序會從其索引中檢索最相關的文檔或片段，並將其輸入模型，從而實現基於真實數據的準確、上下文感知的響應。

Windows ML 模型目錄 API 讓你的應用程式或函式庫能動態發現並下載來自自有線上模型目錄的大型 AI 模型檔案，免除了直接將這些大型檔案打包到應用程式或函式庫中的需求。 型號目錄透過篩選型號並僅下載適用於特定 Windows 裝置的型號，協助確保裝置相容性。

最新的 Microsoft.Windows.Storage.Pickers 更新簡化了檔案與資料夾選擇，讓開發者能設定初始與持久資料夾位置，並將檔案類型篩選器分組並以清晰標籤，方便導航。

該 PopupAnchor API 現在允許 DesktopPopupSiteBridge 透過錨定到其擁有的視窗或島來支援相對定位，從而解決了彈出視窗只能使用螢幕座標絕對定位的限制。

API InputUnderlyingWindowController 可讓開發人員指定目標 HWND，以接收最初傳送至從 SystemVisual 建立的 ContentIsland 的輸入訊息 （請參閱 ContentIsland.CreateForSystemVisual） 。

SystemBackdropHost 允許將系統背景（壓克力/雲母）放置在應用程序視覺樹中的任何位置。

這 WrapPanel 是 WinUI XAML 布局面板，負責以從左到右的次序排列子元素，當項目超出行末時，會在包含面板的末尾自動換行至下一行。 它對於響應式佈局很有用。

這是現有 Windows Community Toolkit 控制 的移植版本。

與 2.0-experimental1 相比，此版本包含下列新的和修改的實驗性 API：

Microsoft.UI.Content

    PopupAnchor

Microsoft.UI.Input

    InputUnderlyingWindowController

Microsoft.UI.Xaml.Controls

    StretchChild
    SystemBackdropHost
    WrapPanel

Microsoft.Windows.AI.Imaging

    ImageForegroundExtractor
    ImageForegroundExtractorContract

Microsoft.Windows.AI.Search.Experimental.AppContentIndex

    AppContentIndexContract
    AppContentIndexer
    AppContentIndexListener
    AppIndexContentRegion
    AppIndexQuery
    AppIndexQueryMatch
    AppIndexQueryOptions
    AppIndexTextStreamEncoding
    AppManagedImageQueryMatch
    AppManagedIndexableAppContent
    AppManagedTextQueryMatch
    ContentItemReader
    ContentItemStatus
    ContentItemStatusResult
    ContentRegionTextOptions
    DeleteIndexResult
    DeleteIndexStatus
    DeleteIndexWhileInUseBehavior
    GetOrCreateIndexOptions
    GetOrCreateIndexResult
    GetOrCreateIndexStatus
    ImageMatchOptions
    ImageQueryMatch
    IndexableAppContent
    IndexCapabilities
    IndexCapabilitiesOfCurrentSystem
    IndexCapability
    IndexCapabilityInitializationStatus
    IndexCapabilityLanguageStatus
    IndexCapabilityOfCurrentSystemStatus
    IndexCapabilityRequirement
    IndexCapabilityState
    IndexStatistics
    QueryMatchContentKind
    QueryMatchScope
    RegionContentKind
    TextLexicalMatchType
    TextMatchOptions
    TextQueryMatch

Microsoft.Windows.AI.Text.Experimental

    LanguageModelExperimental
    LanguageModelExperimentalContract
    LanguageModelOptionsExperimental
    LowRankAdaptation

Microsoft.Windows.Storage.Pickers

    FileOpenPicker
        FileTypeChoices
        SuggestedFolder
        SuggestedStartFolder

    FileSavePicker
        SuggestedStartFolder

    FolderPicker
        SuggestedFolder
        SuggestedStartFolder

• AppContentIndexer API 應該從背景執行緒呼叫。 在 UI 執行緒中使用它可能會當機或導致長時間的暫停，從而影響使用者體驗。
• 如果沒有相符項目，則使用AppIndexQuery.GetNextTextMatches和AppIndexQuery.GetNextImageMatches的查詢結果將為 null，而不是空清單。
• 使用基於 OCR 值的 AppManagedImageQueryMatch.Subregion 影像比對有時可能不準確，尤其是當文字旋轉或傾斜時。
• 利用AppManagedImageQueryMatch.Subregion進行圖像匹配時，有可能包含零尺寸或極小的矩形，導致結果不準確。
• AppContentIndex.CreateQuery 空的查詢可能會拋出異常。

Windows ML 模型目錄 API 允許您的應用程式或資料庫動態下載大型 AI 模型檔案，無需直接將這些大型檔案與應用程式或資料庫一同運送。 此外，型號目錄還能篩選哪些型號與Windows裝置相容，確保正確型號下載到該裝置。

主要優點：

• 新增目錄：新增一或多個線上目錄
• 發現兼容模型： 自動查找與用戶硬件和執行提供商配合使用的模型
• 下載模型： 從各種來源下載和存儲模型
• 跨應用程式共用模型：如果多個應用程式使用相同的目錄來源，則模型會在磁碟上共用，而不會重複下載

• 修正 DeploymentManager 中的問題，該問題導致在某些情況下錯誤地報告 PackageInstallRequired。

此版本包含下列新的和已修改的實驗 API：

Microsoft.UI.Composition

    CompositionNotificationDeferral
    CompositionProjectedShadow
        MaxOpacity
        MinOpacity
        OpacityFalloff

    CompositionProjectedShadowCaster
        AncestorClip
        Mask

    CompositionProjectedShadowDrawOrder
    CompositionProjectedShadowReceiver
        DrawOrder
        Mask

Microsoft.UI.Composition.Experimental

    ExpCompositionVisualSurface
    ExpExpressionNotificationProperty
    IExpCompositionPropertyChanged
    IExpCompositionPropertyChangedListener
    IExpCompositor
    IExpVisual

Microsoft.UI.Content

    ChildSiteLink
        IsBelowContent

    ContentAppWindowBridge
    ContentDisplayOrientations
    ContentExternalBackdropLink
    ContentExternalOutputLink
    ContentIsland
        Connected
        ConnectionInfo
        ConnectRemoteEndpoint
        Disconnected
        IsRemoteEndpointConnected
        Root

    ContentIslandEnvironment
        CurrentOrientation
        NativeOrientation
        ThemeChanged

    ContentSite
        TryGetAutomationProvider

    ContentSiteEnvironment
        CurrentOrientation
        NativeOrientation
        NotifyThemeChanged

    CoreWindowSiteBridge
    CoreWindowTopLevelWindowBridge
    DesktopChildSiteBridge
        AcceptRemoteEndpoint
        ConnectionInfo
        IsRemoteEndpointConnected
        RemoteEndpointConnecting
        RemoteEndpointDisconnected
        RemoteEndpointRequestedStateChanged

    DesktopPopupSiteBridge
        AnchoringBehavior
        AnchoringPixelAlignment

    DesktopSiteBridge
        TryCreatePopupSiteBridge

    EndpointConnectionEventArgs
    EndpointRequestedStateChangedEventArgs
    IContentIslandEndpointConnectionPrivate
    IContentSiteBridgeEndpointConnectionPrivate
    PopupAnchoringOptions
    PopupWindowSiteBridge
    ProcessStarter
    SystemVisualSiteBridge

Microsoft.UI.Input

    InputKeyboardSource
        GetForWindowId

    InputLayoutPolicy
    InputLightDismissAction
        GetForIsland

    InputLightDismissEventArgs
    InputPointerActivationBehavior
    InputPointerSource
        ActivationBehavior
        DirectManipulationHitTest
        GetForVisual
        GetForWindowId
        RemoveForVisual
        TouchHitTesting
        TrySetDeviceKinds

    InputPopupController
    LightDismissReason
    PopupPointerMode
    ProximityEvaluation
    TouchHitTestingEventArgs

Microsoft.UI.Input.Experimental

    ExpInputSite
    ExpPointerPoint

Microsoft.UI.Windowing

    AppWindow
        GetCurrentPlacement
        PersistedStateId
        PlacementRestorationBehavior
        SaveCurrentPlacement
        SaveCurrentPlacementForAllPersistedStateIds
        SetCurrentPlacement

    AppWindowPlacementDetails
    DisplayArea
        GetMetricsFromWindowId

    PlacementInfo
    PlacementRestorationBehavior

Microsoft.UI.Xaml

    XamlIsland
        ShouldConstrainPopupsToWorkArea

Microsoft.UI.Xaml.Automation.Peers

    AutomationEvents
        Notification

    InkCanvasAutomationPeer
    PagerControlAutomationPeer

Microsoft.UI.Xaml.Controls

    ContentDialogPlacement
        UnconstrainedPopup

    DoInkPresenterWork
    ElementFactory
    FlowLayout
    FlowLayoutAnchorInfo
    FlowLayoutLineAlignment
    FlowLayoutState
    IApplicationViewSpanningRects
    IndexPath
    InfoBar
        Opened

    InfoBarOpenedEventArgs
    InkCanvas
    ISelfPlayingAnimatedVisual
    ItemContainer
        CanUserInvoke
        CanUserInvokeProperty
        CanUserSelect
        CanUserSelectProperty
        ItemInvoked
        MultiSelectMode
        MultiSelectModeProperty

    ItemContainerInteractionTrigger
    ItemContainerInvokedEventArgs
    ItemContainerMultiSelectMode
    ItemContainerUserInvokeMode
    ItemContainerUserSelectMode
    LayoutPanel
    NumberBox
        InputScope
        InputScopeProperty
        TextAlignment
        TextAlignmentProperty

    PagerControl
    PagerControlButtonVisibility
    PagerControlDisplayMode
    PagerControlSelectedIndexChangedEventArgs
    PagerControlTemplateSettings
    ProgressRing
        DeterminateSource
        DeterminateSourceProperty
        IndeterminateSource
        IndeterminateSourceProperty

    RecyclePool
    RecyclingElementFactory
    ScrollingScrollStartingEventArgs
    ScrollingZoomStartingEventArgs
    ScrollView
        ScrollStarting
        ZoomStarting

    SelectionModel
    SelectionModelChildrenRequestedEventArgs
    SelectionModelSelectionChangedEventArgs
    SelectTemplateEventArgs
    StackLayout
        IsVirtualizationEnabled
        IsVirtualizationEnabledProperty

    StackLayoutState
    TeachingTip
        Opened

    TeachingTipOpenedEventArgs
    UniformGridLayoutState

Microsoft.UI.Xaml.Controls.Primitives

    ScrollPresenter
        ScrollStarting
        ZoomStarting

Microsoft.Windows.AI.MachineLearning

    CatalogModelInfo
    CatalogModelInstance
    CatalogModelInstanceResult
    CatalogModelSource
    CatalogModelStatus
    WinMLModelCatalog

Microsoft.Windows.ApplicationModel.WindowsAppRuntime

    DeploymentManager
        Repair

    DeploymentStatus
        PackageRepairFailed

Microsoft.Windows.AppNotifications

    AppNotification
        ConferencingConfig

    AppNotificationConferencingConfig

Microsoft.Windows.AppNotifications.Builder

    AppNotificationBuilder
        AddCameraPreview

    AppNotificationButton
        SetSettingStyle

    AppNotificationButtonSettingStyle

Microsoft.Windows.SemanticSearch

    EmbeddingVector
    SemanticSearchContract

Microsoft.Windows.Storage

    ApplicationData
        GetForUnpackaged

Microsoft.Windows.Vision

    ScreenRegionBoundingBox
    ScreenRegionDetectionContract
    ScreenRegionLabel