Skip to content

Bump Microsoft.WindowsAppSDK from 1.7.260224002 to 2.6.5 - #17

Open
dependabot[bot] wants to merge 1 commit into
mainfrom
dependabot/nuget/Microsoft.WindowsAppSDK-2.6.5
Open

dependabot[bot] wants to merge 1 commit into
mainfrom
dependabot/nuget/Microsoft.WindowsAppSDK-2.6.5

Conversation

@dependabot

@dependabot dependabot Bot commented on behalf of github Nov 14, 2026

Copy link
Copy Markdown
Contributor

Updated Microsoft.WindowsAppSDK from 1.7.260224002 to 2.6.5.

Release notes

Sourced from Microsoft.WindowsAppSDK's releases.

2.6.5

Windows App SDK 2.6.5 delivers targeted fixes for rendering, window composition, system backdrops, and packaged app installation.

Bug fixes

Bug fix Runtime Compatibility Change
Fixed rendering corruption that could occur on systems with multiple graphics adapters or monitors. N/A, rendering-region fix
Fixed an E_NOINTERFACE crash when enabling the System Composition Engine on Windows builds that lack the required interfaces. The runtime now uses the lifted compositor on those builds. N/A, operating system capability detection fix
Fixed an issue where window backgrounds and GDI controls could become unexpectedly transparent on Windows 10, including apps hosting XAML islands. N/A, window composition ABI fix
Reverted the system backdrop change introduced in 2.6.4 to address wrong-thread exceptions. System backdrops for content islands and XAML windows are not supported when using the System Composition Engine in this release. N/A, revert of a previously contained change
Fixed an issue where app-extension registration metadata generation returned E_NOTIMPL, which could prevent packaged apps from installing. N/A, missing implementation fix

For details, see the full Windows App SDK 2.6.5 release notes.

Try it out

Getting started

To get started using Windows App SDK to develop Windows apps, check out the following documentation:

2.6.4

Windows App SDK 2.6.4 removes the Limited Access Feature requirement for the Language Model APIs, updates ONNX Runtime to 1.27.1, and includes reliability fixes across WinUI 3, app lifecycle, notifications, DispatcherQueue, Content, composition, and Windows AI.

What's new in WinAppSDK 2.6.4:

  • Language Model APIs no longer require a Limited Access Feature unlock. Apps can call the Language Model APIs without first unlocking the Language Model Limited Access Feature. Apps using earlier Windows App SDK versions must continue to follow the LAF requirements for their target Windows versions.
  • Updated ONNX Runtime. The version of ONNX Runtime has been updated to 1.27.1. See ONNX Runtime versions for more info.

Bug fixes:

Bug Fix Runtime Compatibility Change
Fixed an access violation crash that could occur during app shutdown when a text control, such as a TextBox or RichEditBox, was still alive while the XAML core was being torn down. CCoreServices_InputServicesTeardownOrder
Fixed an issue where AppInstance.GetInstances could fail with E_INVALIDARG while enumerating application instances. AppLifecycle_GetInstancesProcessHandleFix
Fixed a crash when calling some AppNotificationManager and AppInstance APIs. AppNotification_AppInstance_FixStackOverflowCrash
Fixed an issue where self-contained apps could fail to load Microsoft.WindowsAppRuntime.Insights.Resource.dll when using the VersionInfo APIs or registering an AppNotification callback (microsoft/WindowsAppSDK#​6071, microsoft/WindowsAppSDK#​6387). VersionInfo_MissingInsightsResourceDll
Fixed an issue where an unhandled exception in a DispatcherQueue callback could produce a crash dump with only the HRESULT, omitting the app's original exception type, message, and stack trace. DispatcherQueue_CaptureCallbackErrorContext
Fixed the same crash dump issue for unhandled exceptions in DispatcherQueueTimer.Tick event handlers. DispatcherQueueTimer_CaptureTickErrorContext
Fixed an issue where a failure while creating a ContentIsland or other Content object immediately terminated the app. The original error is now returned to the calling code instead. ContentIsland_InitializationFailureCleanup
Fixed system backdrop support for lifted content islands and XAML windows when using the System Composition Engine. SwitcherSystemBackdropBrushSupport
Fixed projection of compatible Windows.UI.Composition objects into Microsoft.UI.Composition, preserving object identity, when using the System Composition Engine. SwitcherColdWrappingWUCToMUC
Fixed a crash in ItemsView when the target of StartBringItemIntoView was collapsed or recycled before the scroll completed (microsoft/microsoft-ui-xaml#​11865). ItemsView_InvalidBringIntoViewAnchor
Fixed a crash that could occur when a WebView2 control received focus while still initializing and its parent window was temporarily disabled when initialization finished. WebView2_HandleMoveFocusInvalidArgument
Improved diagnosability for Windows AI model initialization APIs. AIFabric_Tip_APIClassName_ReasonName
Fixed false IntelliSense errors on XAML-generated members, such as InitializeComponent and x:Name fields, in WinUI 3 C# projects edited in VS Code with C# Dev Kit. To opt out, set the EnableWinUIDesignTimeGeneratedXamlCompileItems property to false. N/A, build .targets change

To see everything that's new and changed, see the full Windows App SDK 2.6.4 release notes.

Try it out

  • Download the 2.6.4 NuGet package to use WinAppSDK 2.6 in your app.
  • Download and update the WinUI Gallery to see the WinUI 3 updates firsthand.

Getting started

To get started using Windows App SDK to develop Windows apps, check out the following documentation:

2.5.4-exp

Windows App SDK 2.5 Experimental is the latest experimental release, adding new Windows AI capabilities, code-based theme resource bindings and DataTemplate construction, the new TableView and Chart controls, and expanded WinUI 3 inking support. It follows Windows App SDK 2.5.1 stable and brings forward the changes from that release alongside the experimental-only additions below.

What's new in WinAppSDK 2.5 Experimental:

  • Windows AI device selection. New AIComputeDevice APIs let apps choose the default, CPU, or NPU execution device for text recognition. App Content Index image indexing can use the same preference for OCR through ContentRegionImageOptions.PreferredTextRecognizerDevice.
  • AI Speech and language model updates. New speech recognition factories improve model configuration and creation, while updated audio, streaming, and continuous recognition APIs expand speech scenarios. Language model APIs now expose model identity, low-rank adapter compatibility, and response statuses for game mode and low video memory.
  • Theme resource binding from code. The experimental FrameworkElement.SetThemeResourceBinding API lets apps create the equivalent of a {ThemeResource} binding programmatically.
  • Delegate-based DataTemplate construction. A new experimental DataTemplate constructor accepts an app-provided delegate that creates the template's element subtree.
  • TableView control. The experimental TableView control is now available in the public WinMDs, with grouping, templated group headers, sorting and filtering, resizable columns, and optional cell and header tooltips.
  • Chart control. A new experimental WinUI 3 Chart control presents Cartesian data as line, area, and bar series, with configurable axes, legends, labels, and markers.
  • WinUI 3 inking updates. New InkPresenter.ActivateCustomDrying and InkSynchronizer APIs let apps render committed ink themselves, and InkToolbar now targets an InkPresenter directly.

Bugs fixed:

  • Fixed an access violation that could occur when reading InkPresenter.StrokeContainer while custom drying was active.
  • Fixed InkCanvas presenter sizing under a RenderTransform.
  • Fixed a WinUI resource-tracking issue that could cause memory usage to grow when apps repeatedly created visual-state storyboards or resolved static or theme resources.
  • Improved cleanup of unreachable native WinUI objects in .NET apps after tab or page teardown.

To see everything that's new and changed, see the full Windows App SDK 2.5 Experimental release notes.

Try it out

Getting started

To get started using Windows App SDK to develop Windows apps, check out the following documentation:

2.5.1

Windows App SDK 2.5.1 adds Windows Error Reporting support for self-contained .NET MSIX apps, introduces limited-access app content search APIs, and includes reliability fixes across WinUI 3, input, composition, deployment, and Windows AI.

What's new in WinAppSDK 2.5.1:

  • Windows Error Reporting support. Self-contained .NET MSIX apps can now use the windows.diagnosticServiceModule package-manifest extension to declare diagnostic modules, allowing Windows Error Reporting to load them and collect actionable crash dumps.
  • Limited-access AppContentSearch APIs. Apps with a limited-access feature token can use the new AppContentIndex APIs to index text and images, perform lexical queries, and use semantic matching on supported NPU-enabled devices. The APIs support semantic search and retrieval-augmented generation scenarios.

Bug fixes:

Bug Fix Runtime Compatibility Change
Fixed a crash in windowed-popup input handling when a focus or pointer event was processed after the popup's island had been disposed. PointerInputProcessor_ReleaseCaptureOnDisposedIsland
Fixed a crash in NavigationView when resizing the control could produce a negative pane MaxHeight. NavigationView_UpdatePaneLayoutNegativeMaxHeight
Fixed an issue where the property set returned by ElementCompositionPreview.GetPointerPositionPropertySet stopped updating while a pointer was pressed. PointerPositionPropertySet_UpdateWhilePressed
Fixed a crash in NavigationView when an expanded item's flyout was shown after the item had been collapsed or recycled. NavigationViewItem_DeferredFlyoutShowStaleState
Fixed a fail-fast when a KeyboardAccelerator used an OEM or punctuation key and displayed the accelerator shortcut label. KeyboardAccelerator_OemKeyNoFailFast
Fixed a fatal process exit during XAML shutdown in apps hosting WinUI 3 on more than one UI thread. WindowsXamlManager_ActivationFactoryCacheResetRace
Fixed an issue where a CommandBar with no secondary commands could show an empty overflow button at fractional display scales such as 175%. CommandBar_SpuriousOverflowButtonAtFractionalScale
Fixed an issue that prevented apps using the System Composition Engine from calling VisualInteractionSource.CreateFromIVisualElement. CompositionEngine_SwitcherSeptemberFixes
Fixed effect graphs and SceneLighting rendering for apps using the System Composition Engine. CompositionEngine_SwitcherSeptemberFixes
Fixed InputPointerSource.ActivationBehavior not honoring NoActivate when using the System Composition Engine. CompositionEngine_SwitcherSeptemberFixes
Fixed CompositionEngine selection behavior for null inputs and no-op selections. CompositionEngine_SwitcherSeptemberFixes
Fixed cursor customization for lifted input when using the System Composition Engine. CompositionEngine_SwitcherSeptemberFixes
Fixed ICompositionObject queries on gradient stop collections when using the System Composition Engine. N/A, operating system composition fix
Fixed ContentExternalOutputLink border and background behavior when using the System Composition Engine. N/A, operating system composition fix
Fixed access to VisualReferenceController when using the System Composition Engine. N/A, operating system composition fix
Fixed a registration issue that could occur when installing the Windows App SDK. N/A, deployment registration fix
Fixed an issue where Video Super Resolution could fail during initialization or inference with the updated ONNX Runtime dependency. N/A, dependency compatibility update

To see everything that's new and changed, see the full Windows App SDK 2.5.1 release notes.

Try it out

  • Download the 2.5.1 NuGet package to use WinAppSDK 2.5 in your app.
  • Download and update the WinUI Gallery to see the WinUI 3 updates firsthand.

Getting started

To get started using Windows App SDK to develop Windows apps, check out the following documentation:

2.4.1-exp

Windows App SDK 2.4 Experimental (2.4.1-experimental) 🧪

Windows App SDK 2.4 Experimental is the latest experimental release, headlined by inking support for WinUI 3. It follows Windows App SDK 2.4.0 stable and generally brings forward the changes from that release alongside the experimental-only addition below.

What's new in WinAppSDK 2.4 Experimental:

  • Inking support for WinUI 3. The new InkCanvas, InkToolbar, and InkPresenter APIs add pen and touch input, clipboard and high-contrast support, stroke input, and unprocessed input to WinUI 3 apps.

To see everything that's new and changed, see the full Windows App SDK 2.4 Experimental release notes.

Try it out

Getting started

To get started using Windows App SDK to develop Windows apps, check out the following documentation:

2.4.0

Windows App SDK 2.4.0

Windows App SDK 2.4.0 is the latest stable release on the 2.x line, adding expanded input support, more precise LanguageModel response statuses, and targeted reliability fixes across input, Storage Pickers, MRT Core, app runtime isolation, composition, and XAML tooling.

What's new in WinAppSDK 2.4.0:

  • Expanded input support. WinUI 3 apps can now use operating system touchpad and mouse haptics through Windows.Devices.Haptics, along with touchpad single-finger panning, when supported by the operating system and hardware.
  • More precise LanguageModel response statuses. The new LanguageModelResponseStatus.UnsupportedLanguage and LanguageModelResponseStatus.LanguageMismatch values let apps distinguish unsupported-language and input/output-language mismatch conditions from generic errors.

Bug fixes:

Bug Fix Runtime Compatibility Change
Fixed a crash that could occur when a touch or pen contact left a scrollable area with precise timing. InputPointerSource_DepartingScrollInputCrashFix
Fixed an issue where the Storage Pickers left the calling WinUI app window without keyboard focus after the file dialog closed. The app now restores its previous focus. See GitHub issue microsoft/WindowsAppSDK#​6505. StoragePickers_RestoreFocusAfterDialogCloses
Fixed a regression where MrmGetFilePathFromName returned ERROR_FILE_NOT_FOUND when the PRI file didn't exist instead of returning the documented fallback path. See GitHub issue microsoft/WindowsAppSDK#​5940. ResourceManager_RestoreDefaultFallbackPath
Fixed an issue where MICROSOFT_WINDOWSAPPRUNTIME_BASE_DIRECTORY could be inherited by child processes, disrupting MRT Core and catalog lookups. See GitHub issue microsoft/WindowsAppSDK#​5987. WindowsAppRuntime_BaseDirectoryIsolation
Fixed a crash when apps using the System Composition Engine called VisualInteractionSource.TryRedirectForManipulation. N/A, operating system composition bridge fix
Fixed the access modifier on the generated C# entry point helper when DISABLE_XAML_GENERATED_MAIN is defined. See GitHub issue microsoft/microsoft-ui-xaml#​11245. N/A, build-time tooling change

To see everything that's new and changed, see the full Windows App SDK 2.4.0 release notes.

Try it out

  • Download the 2.4.0 NuGet package to use WinAppSDK 2.4 in your app.
  • Download and update the WinUI Gallery to see the WinUI 3 updates firsthand.

Getting started

To get started using Windows App SDK to develop Windows apps, check out the following documentation:

2.3.2-expA

Windows App SDK 2.3 Experimental A (2.3.2-experimentalA) 🧪

Windows App SDK 2.3 Experimental A is the latest experimental release, headlined by new DPI-aware window sizing from XAML, a substantial round of App Content Index indexing and reliability improvements, and additional Windows AI and speech APIs. It builds on the Windows App SDK 2.3.1 stable release and adds the experimental-only work described below.

What's new in WinAppSDK 2.3 Experimental A:

  • Window.Width and Window.Height. New properties give apps a DPI-aware way to get and set a window's size in logical (client) pixels directly from code or markup, without reaching through Window.AppWindow and doing manual logical-to-physical DPI conversion. Companion Window.MinWidth, Window.MinHeight, Window.MaxWidth, and Window.MaxHeight properties constrain the window's size.
  • App Content Index improvements. The experimental App Content Index APIs add faster batch indexing via AppContentIndexer.BatchAddOrUpdate, direct indexing of bitmap and image-stream content (with OCR and semantic options), static ranking boosts for individual content items or regions, ICU-based multilingual tokenization, and automatic recovery from index corruption. Indexing and query paths are also substantially faster, with more stable lexical ranking.
  • Structured JSON generation. A new LanguageModel.GenerateStructuredJsonResponseAsync API lets apps generate structured JSON output from the on-device language model, making it easier to get typed, machine-readable results back from a prompt.
  • Speech recognition cleanup. The experimental SpeechAudioProvider now implements IClosable, so apps can deterministically release the provider with Close/Dispose when they finish streaming audio.

To see everything that's new and changed, see the full Windows App SDK 2.3 Experimental A release notes.

Try it out

Getting started

To get started using Windows App SDK to develop Windows apps, check out the following documentation:

2.3.1

Windows App SDK 2.3.1

Windows App SDK 2.3.1 is the latest stable release on the 2.x line, with a new structured JSON output API for Phi Silica, the XamlOptionalChanges API for opting into XAML breaking changes, an unstable CompositionEngine Limited Access Feature, Video Super Resolution improvements, ARM64EC support for Windows ML, a broad set of XAML performance optimizations, and a batch of reliability fixes.

What's new in WinAppSDK 2.3.1:

  • Structured JSON output for Phi Silica. The new LanguageModel.GenerateStructuredJsonResponseAsync API generates language-model responses constrained to a caller-supplied JSON Schema, so apps get well-formed, schema-conformant output instead of free-form text they have to parse themselves.
  • XamlOptionalChanges. A new API that lets apps opt into optional breaking changes before XAML initialization. In the same release, the DISABLE_XAML_GENERATED_MAIN preprocessor constant now renames the generated main() method (C#: XamlGeneratedProgram.XamlGeneratedMain(); C++/WinRT: wXamlGeneratedMain()) instead of removing it, so a custom main() can invoke the default implementation. See PR microsoft/microsoft-ui-xaml#​11110.
  • CompositionEngine (Limited Access Feature). A new, unstable Limited Access Feature that lets apps opt into using the OS as the engine for the Composition APIs.
  • Video Super Resolution improvements. Fixed NPU detection, added CPU support, and improved performance for Video Super Resolution.
  • Windows ML: ARM64EC support. Windows ML now supports ARM64EC, alongside a fix to execution-provider enumeration in certain scenarios.
  • XAML performance optimizations. This release adds a broad set of startup, styling, and resource-lookup optimizations. Several are opt-in through the DefaultStyleOptimizations and OptimizeApplyStyles XamlChangeIds, including optimized XamlControlsResources styles, a lighter FontIcon/BitmapIcon visual tree, and faster ThemeResource and ResourceDictionary lookups.
  • AI IntelliSense documentation. Added IntelliSense documentation for the stable APIs in the Microsoft.WindowsAppSDK.AI NuGet package.

Bug fixes:

Bug Fix Runtime Compatibility Change
Fixed ApplicationData.GetForUnpackaged().LocalSettings() opening a registry key at a roaming path (HKCU\SOFTWARE\publisher\product) instead of a machine-local one, so unpackaged app settings now persist in the correct location. See GitHub issue microsoft/WindowsAppSDK#​6559. ApplicationData_GetForUnpackaged_LocalSettings
Fixed a crash that could repeatedly bring down backgroundTaskHost.exe when a background task had no stored CLSID, and added graceful handling when CoCreateInstance fails. See GitHub issue microsoft/WindowsAppSDK#​5870. UniversalBGTask_RunCrash
Fixed windowed and non-windowed flyouts appearing misaligned (about one item-height above the parent item) for side placements when they open upward near the bottom of the screen. Flyout_SidePlacementFlipUpAlignmentFix
Fixed a crash in MediaPlayerPresenter when the GPU device is lost during media playback event handling. MediaPlayerPresenter_DeviceLostCrash
Fixed a use-after-free crash in CPopupRoot::ReplayPointerUpdate when a popup is closed synchronously during pointer-event replay. CPopupRoot_ReplayPointerUpdateCrash
Fixed a crash (null LayoutState dereference) in UniformGridLayout and FlowLayout that could occur when a collection change was raised on an ItemsRepeater that was no longer loaded. UniformGridLayoutFlowLayout_OnItemsChangedNullLayoutStateCrash

To see everything that's new and changed, see the full Windows App SDK 2.3.1 release notes.

Try it out

  • Download the 2.3.1 NuGet package to use WinAppSDK 2.3 in your app.
  • Download and update the WinUI Gallery to see the WinUI 3 updates firsthand.

Getting started

To get started using Windows App SDK to develop Windows apps, check out the following documentation:

2.2.2-exp9

Windows App SDK 2.2 Experimental 9 (2.2.2-experimental9) 🧪

Windows App SDK 2.2 Experimental 9 is the latest experimental release. It ships alongside Windows App SDK 2.2.0 stable and generally brings over the changes from that release; the highlights below describe the experimental-only additions.

What's new in WinAppSDK 2.2 Experimental 9:

  • Language Model APIs on GPU [Experimental]. The Language Model APIs now run on non-Copilot+ PCs equipped with a supported GPU, bringing local language model capabilities to a broader range of Windows 11 devices. Supported hardware includes NVIDIA GeForce RTX 30 series and newer with 6+ GB vRAM. GPU inference requires Developer Mode to be enabled and a Windows Insider Experimental Channel build. The GPU model is not pre-installed; it is downloaded on demand via EnsureReadyAsync through Windows Update. Apps should check GetReadyState and display a consent dialog before triggering the download. Users can manage the model at Settings > System > AI Components. For responsible AI guidance, see the new Transparency Note: Language Model APIs on Non-Copilot+ PCs.
  • Speech Recognition APIs [Experimental]. New on-device speech recognition APIs in Microsoft.Windows.AI.Speech enable both batch and streaming speech-to-text. BatchRecognition recognizes a complete audio source in a single call, and StreamingRecognition raises Recognizing and Recognized events. Audio can be sourced from a device (AudioConfiguration.FromAudioDevice), file (FromFile), input stream (FromStream), or pushed by the caller via SpeechAudioProvider (16 kHz, 16-bit, single-channel PCM). The on-device model is managed via SpeechRecognitionModel.EnsureReadyAsync / TryCreateAsync, with download and load progress reported through SpeechRecognitionModelProgress.
  • New NpuType API. A new Microsoft.Windows.Workloads.NpuType enum surfaces the NPU class on the current device (for example, Qnn, Lnl, Stx, Win365, Unknown, None), so apps and Workloads infrastructure can route AI workloads to the appropriate execution path.

This release also rolls forward all changes from the 2.2.0 stable release: the new Microsoft.Windows.AI.Video.VideoScaler Video Super Resolution API, the new Microsoft.Windows.Storage.ApplicationData.GetForUnpackaged() entry point for unpackaged apps, the new XamlBindingHelper boxing-free setter overloads, and the WinUI / Windows ML reliability fixes shipped in 2.2.0.

New or updated APIs (since 2.1 Experimental 8):

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
 ... (truncated)

## 2.2.0

## Windows App SDK 2.2.0

WinAppSDK 2.2.0 is the latest stable servicing release for 2.0, with a new Windows AI video upscaling API, a first-class `ApplicationData` entry point for unpackaged apps, additions to `XamlBindingHelper`, and a batch of WinUI and Windows ML reliability fixes.

### What's new in WinAppSDK 2.2.0:

- **Video Super Resolution AI API.** The new `Microsoft.Windows.AI.Video.VideoScaler` API delivers real-time video enhancement through advanced AI upscaling, optimized for streams featuring people in conversation. It enables developers to provide sharper, clearer visuals across conferencing, streaming, and editing platforms, even under poor network conditions. The API supports customization of output resolution, frame rate, and regions of interest, with compatibility for multiple video formats including BGR, RGB, and NV12. `VideoScaler` is disposable, and includes a capability check so apps can validate VSR support at runtime. Explicit Windows ML initialization is not required.
- **New `ApplicationData` API for unpackaged apps.** `Microsoft.Windows.Storage.ApplicationData.GetForUnpackaged()` gives unpackaged apps a first-class WinRT entry point to per-user / per-machine application data, matching the surface previously available only to packaged apps. This simplifies future packaged ↔ unpackaged migration and removes the need for Registry-API workarounds.
- **New `XamlBindingHelper` APIs.** Added boxing-free value setter overloads to `XamlBindingHelper` (`SetPropertyFromThickness`, `SetPropertyFromCornerRadius`, `SetPropertyFromColor`) and exposed the `Setter.ValueProperty` dependency property.

### Bug fixes:

| Bug fix | [Runtime Compatibility Change](https://learn.microsoft.com/en-us/windows/windows-app-sdk/api/winrt/microsoft.windows.applicationmodel.windowsappruntime.runtimecompatibilityoptions.disabledchanges?view=windows-app-sdk-2.0) |
|---------|------------------------------------|
| Fixed a crash in `RenderTargetBitmap` when the target element leaves the visual tree (for example, a popup closes) before `PreCommit` completes. `RenderAsync` now returns `E_ABORT` instead of crashing. | RenderTargetBitmap_PreCommitCrashOnTreeLeave |
| Fixed a use-after-free crash in `ScrollView` when the control is destroyed while its hide-indicators timer tick is still pending. See [microsoft/microsoft-ui-xaml#​10514](https://github.com/microsoft/microsoft-ui-xaml/issues/10514). | ScrollView_HideIndicatorsTimerUseAfterFree |
| Fixed a potential crash in `Microsoft.UI.Xaml.dll!DirectUI::DXamlCore::GetPeerPrivate` caused by attempting to access an object scheduled to be freed. | GetPeerPrivate_UseAfterFree |
| Fixed an issue where `Microsoft.UI.System.ThemeSettings` could crash an app if it was destroyed on a background thread (for example, when destroyed by the .NET garbage collector). | ThemeSettings_OffThreadDestructorFix |
| Fixed a crash that could occur on certain devices when active touch contacts were canceled by input hardware, such as when pen input overrides them. | InputPointerSource_PointerCancelCrashFix |
| Fixed an issue where sparse-packaged apps were unable to discover module-specific PRI files. See [microsoft/WindowsAppSDK#​6375](https://github.com/microsoft/WindowsAppSDK/issues/6375). | MRTCore_SparsePackagedPriFallback |
| Fixed a string ownership bug when using the Flat-C Windows ML Catalog API. | WindowsMLFlatCCatalog_CallbackStringOwnership |
| Fixed a potential issue in Windows ML during process shutdown. | WindowsML_ComRundownFix |
| Fixed potential COM initialization and teardown issues in Windows ML. | WindowsML_ComInitializationFix |

### New or updated APIs (since 2.1.3):

Microsoft.UI.Xaml

Setter
    ValueProperty

Microsoft.UI.Xaml.Markup

XamlBindingHelper
    SetPropertyFromColor
    SetPropertyFromCornerRadius
    SetPropertyFromThickness

Microsoft.Windows.AI.Video

VideoScaler
VideoScalerOptions
VideoScalerResult
VideoScalerStatus

Microsoft.Windows.Storage
... (truncated)

2.1.4-exp8

Windows App SDK 2.1.4-Experimental8 (2.1.4-experimental8) 🧪

Windows App SDK 2.1 Experimental 8 ships alongside Windows App SDK 2.1.3 stable. It generally brings forward the changes in 2.1.3 (TitleBar custom drag-region APIs, the Phi Silica LoRA API on the stable surface, AICapabilities.HasAICapability, expanded Windows ML execution-provider support, ONNX Runtime 1.24.6, and the 2.1.3 bug fix batch) and adds one experimental-only refinement to the Phi Silica structured JSON output API.

What's new in WinAppSDK 2.1 Experimental 8:

  • Strongly typed result and status for structured JSON responses [Experimental]. LanguageModelExperimental.GenerateStructuredJsonResponseAsync (introduced in 2.0 Experimental 7) now returns a dedicated GenerateStructuredJsonResponseResult type with a GenerateStructuredJsonResponseStatus property, instead of the generic LanguageModelResponseResult / LanguageModelResponseStatus pair. The new status enum is specific to schema-constrained generation: it includes a ResponseInvalidJson value for cases where the model output did not satisfy the requested JSON schema, separate from generic language-model response failures.
  • As part of that split, the ResponseInvalidJson value has been removed from the stable LanguageModelResponseStatus enum. Apps that handled ResponseInvalidJson from LanguageModelResponseStatus should move that handling onto the new GenerateStructuredJsonResponseStatus returned by GenerateStructuredJsonResponseAsync.

Brought forward from 2.1.3 stable

This experimental release also rolls forward the 2.1.3 stable changes, including the new TitleBar custom drag-region APIs, the Phi Silica LoRA API on the stable surface, AICapabilities.HasAICapability, the Windows ML execution-provider improvements, the ONNX Runtime 1.24.6 bump, and the full 2.1.3 bug fix batch. See the Windows App SDK 2.1.3 release notes for details.

To see everything that's new and changed, see the full Windows App SDK 2.1 Experimental 8 release notes.

Try it out

Getting Started

To get started using Windows App SDK to develop Windows apps, check out the following documentation:

2.1.3

Windows App SDK 2.1.3

Windows App SDK 2.1.3 is the latest stable servicing release on the 2.x line, with new TitleBar drag-region APIs in WinUI, the LoRA API for Phi Silica promoted to the stable surface, a new Copilot+ PC detection API, expanded Windows ML execution-provider support, an ONNX Runtime update, and a batch of reliability fixes.

What's new in WinAppSDK 2.1.3:

  • TitleBar custom drag regions. TitleBar now recursively walks TitleBar.Content and automatically excludes interactive controls from the drag region while keeping empty gaps draggable by default. Three new APIs (TitleBar.IsDragRegion attached property, TitleBar.AutoRefreshDragRegions, and TitleBar.RecomputeDragRegions()) give developers explicit control when the default behavior isn't sufficient. See PR microsoft/microsoft-ui-xaml#​10936 and tracking issue microsoft/microsoft-ui-xaml#​10421.
  • Phi Silica LoRA API on the stable surface. Developers can now fine-tune the on-device Phi Silica language model with their own LoRA adapters from the stable API surface, using LanguageModelLowRankAdapter.CreateFromPath and LanguageModelOptions.LowRankAdapter. See Phi Silica LoRA for details.
  • AICapabilities.HasAICapability is a new API that lets third-party applications determine whether the device is a Copilot+ PC.
  • Windows ML execution-provider improvements. This release adds support for multiple execution providers within a single MSIX package, discovery of execution providers delivered as framework packages, and a new selection mode for more flexible deployment configurations.
  • The version of ONNX Runtime has been updated to 1.24.6.

Bug fixes:

Bug Fix Runtime Compatibility Change
Fixed a memory leak in ItemsRepeater where recycled elements were never garbage collected due to a reference cycle through the RecyclePool, which could also cause crashes in InvalidateChildrenMeasure. ItemTemplateWrapper_RecyclePoolLeak
Fixed a crash where an implicit Show/Hide animation completion callback could access a destroyed CUIElement, causing an access violation. The callback now uses a weak reference to safely handle the case where the element is destroyed before the animation completes. Animation_FixImplicitHideAnimationCrash
Fixed an issue where windowed popup content opened in a XAML Island did not respect OverrideScale, causing content to appear oversized and clipped. See GitHub issue microsoft/microsoft-ui-xaml#​11000. Popup_WindowedPopupOverrideScale
Fixed a fail-fast crash caused by re-entrant dispatch during cross-apartment COM release operations in UIAffinityReleaseQueue::DoCleanup. UIAffinityReleaseQueue_PauseDispatchDuringCleanup
Fixed ambiguous module lookup in WinUI when multiple modules with the same name are loaded in the same process. GetModuleHandleW has been replaced with GetModuleHandleExW so the correct module is resolved by address. GetModuleHandle_FixAmbiguousModuleLookup
Fixed an integer divide-by-zero crash in UniformGridLayout::GetMajorSize when an ItemsRepeater is laid out in an available width narrower than one item's minor stride. UniformGridLayout_GetItemsPerLineDivideByZero
Fixed a potential crash when a package has been uninstalled prior to being processed. PackageManager_FixCrash
Fixed an issue where GetReadyState could return incorrect error codes (for example, DisabledByUser or NotSupportedOnCurrentSystem) when required packages were not yet deployed. The API now correctly reports NotReady in this scenario, improving diagnostic clarity. ModelInitialization_GetReadyStateAvailabilityGuard
Fixed an issue where XAML compiler errors were silently lost when using dotnet build, showing only MSB3073: exited with code 1 instead of the actual error messages. See GitHub issue microsoft/microsoft-ui-xaml#​9813. N/A, build-time XAML compiler tooling change

To see everything that's new and changed, see the full Windows App SDK 2.1.3 release notes.

Try it out

  • Download the 2.1.3 NuGet package to use WinAppSDK 2.1 in your app.
  • Download and update the WinUI Gallery to see the WinUI 3 updates firsthand.

Getting started

To get started using Windows App SDK to develop Windows apps, check out the following documentation:

2.0.1

WinAppSDK 2.0 is the next major release of the Windows App SDK, the first major version update since 1.0 (November 2021) and the first release on the new Semantic Versioning scheme. It ships new XAML capabilities, a modernized Storage Pickers surface, expanded popup and anchoring APIs in Microsoft.UI.Content, a new package deployment and validation framework, a refactored Windows ML stack, and additions across the Windows AI surface.

What's new in WinAppSDK 2.0:

  • Semantic Versioning. Windows App SDK 2.0 standardizes on SemVer 2.0.0 and aligns the SDK version with the NuGet package version, so there's no separate date-based build number to track. The package family name now aligns with the major version, so the next side-by-side release will be 3.0.0.
  • WebView2 (WinUI 3) drag support. Dragging text, HTML, images, and URLs out of WebView2 content hosted in WinUI 3 is now supported, along with drag cancellation, custom drag visuals, and customizable drag data. (Requires WebView2 Runtime 144.0.3719.11 or higher.)
  • Package deployment and validation. The Microsoft.Windows.Management.Deployment namespace adds a new IPackageValidator framework with three built-in validators (PackageCertificateEkuValidator, PackageFamilyNameValidator, PackageMinimumVersionValidator), plus a new PackageVolume API for managing the storage volumes that packages are staged onto.
  • Windows ML refactor. Core Windows ML features have been refactored into a new base package, Microsoft.Windows.AI.MachineLearning, with a minimal set of dependencies that supports apps down to Windows 10 v1903. The existing Microsoft.WindowsAppSDK.ML package continues to support Windows 10 v1809. The included ONNX Runtime version has been updated to 1.24.5.
  • Windows AI additions. New AIFeatureReadyState values (CapabilityMissing, NotCompatibleWithSystemHardware, OSUpdateNeeded) help apps explain transient and durable failures during AI model acquisition so users get actionable guidance instead of a generic "not ready" condition. Phi Silica APIs are now enforced as part of a Limited Access Feature (LAF); see Phi Silica for details.
  • Storage Pickers updates. The Microsoft.Windows.Storage.Pickers API (introduced in 1.8) is extended with file type choice grouping, persistent settings identifiers, suggested start folders, custom titles, multi-folder picking, and more, across FileOpenPicker,
    FileSavePicker, and FolderPicker.
  • SystemBackdropElement is a new lightweight FrameworkElement that lets apps place a system backdrop such as Mica or Acrylic anywhere within the XAML layout, with a CornerRadius property for rounded backdrop areas. It closes a long-standing WinUI 3 gap where in-app acrylic effects (previously straightforward in WinUI 2 via AcrylicBrush.BackgroundSource) had no direct equivalent.
  • Custom XAML Conditionals (IXamlCondition) enable developers to define custom conditions that integrate with XAML's conditional namespace syntax and are evaluated at XAML parse time. This replaces the experimental IXamlPredicate interface and unlocks conditional XAML based on feature flags, device capabilities, business logic, configuration settings, and other runtime conditions.
  • Relative popup positioning in Microsoft.UI.Content. The new PopupAnchor API allows DesktopPopupSiteBridge to anchor to its owning window or island instead of being limited to absolute screen coordinates, with new AnchoringBehavior and AnchoringPixelAlignment properties to control the behavior.

Notable bug fixes:

  • Fixed an issue where the WindowsAppSDK installer showed no progress during installation, making it appear stalled. The installer now provides clearer progress feedback.
  • Fixed MSB8027 and LNK4042 build warnings caused by duplicate ClCompile items in Windows App SDK NuGet .targets files.
  • Fixed a ListView crash that could occur during keyboard navigation (Tab/Shift+Tab) after the items list was updated.
  • Fixed an issue where WinUI 3 could crash if focus was moved to the CoreWebView2Controller while the controller was not visible.
  • Fixed a Windows ML bug where calling RegisterCertifiedAsync again in the same process incorrectly returned 0 execution providers (EP).

To see everything that's new and changed, including upgrade guidance and known issues, see the full Windows App SDK 2.0 release notes.

Try it out

  • Download the 2.0.1 NuGet package to use WinAppSDK 2.0 in your app.
  • Download and update the WinUI Gallery to see the WinUI 3 updates firsthand.

Getting started

To get started using Windows App SDK to develop Windows apps, check out the following documentation:

2.0-preview1

2.0 Preview 1 (2.0-preview1) 🔃

The first preview of WinAppSDK 2.0 is now available! Check out the release notes for more information on the new & updated features and known issues.

Updates to this version:

  • Updated ONNX Runtime version to 1.24 RC.

  • New InputFocusController.ShouldShowKeyboardCues property to guide developers on whether to show keyboard cues right after the creation of a ContentIsland.

  • New convenience API PointerPoint.GetCurrentPoint, to allow developers to get the active PointerPoint data from the provided pointerId.

  • Improved DeleteIndex reliability. Sometimes DeleteIndex would fail with ERROR_SHARING_VIOLATION.

  • App Content Search are part of a separate Microsoft.Windows.Search package instead of being part of Microsoft.Windows.AI package.

  • New AppContentIndexer APIs and renamed AppContentIndexer APIs.

Bugs fixed in the new WinAppSDK Release:

  • Fix for prefix search not working with short query strings.
  • Fix for OCR Bounding boxes returning negative values in some edge cases.
  • Fixed bug where if RegisterCertifiedAsync is called again in the same process, it incorrectly returns 0 execution providers (EP).
  • Fixed an issue where the WindowsAppSDK installer showed no progress during installation, making it appear stalled. The installer now provides clearer progress feedback.
  • Improved error handling of scenarios where WindowsAppSDKSelfContained is enabled for class libraries.

Providing feedback

As we introduce new & upcoming features in our preview releases, we appreciate all of your feedback as we work towards a stable release:

  • For WinUI 3 feedback, please open an issue on the WinUI repo.
  • For feedback regarding all other Windows App SDK components, please open an issue here, on the Windows App SDK repo.

2.0-exp7

Windows App SDK 2.0-Experimental7 (2.0.0-experimental7) 🧪

Windows App SDK 2.0 Experimental 7 is the latest experimental release, headlined by experimental CMake support for
C++ developers and rolling forward all changes from 2.0-Preview1 and 2.0-Preview2 alongside additional experimental
work.

What's new in WinAppSDK 2.0 Experimental 7:

  • CMake support [Experimental] for consuming Windows App SDK from C++ CMake-based projects. Each Windows App SDK NuGet component now embeds a CMake configuration file so that find_package() can automatically discover targets, headers, libraries, and runtime DLLs without manual path configuration. This is an early flight to gather community feedback, so naming conventions and configuration patterns may change based on developer input. See the full release notes for the overview, sample apps, and how to share feedback.
  • Windows AI Language Model API additions for generating structured JSON output and other scenarios.
  • App Content Indexer API additions including new APIs for managing content items and indexing status.
  • Video Super Resolution (VSR) API rename pass for clarity and consistency, plus various bug fixes and quality
    improvements.
  • Brings forward all changes shipped in 2.0-Preview1 and 2.0-Preview2, including new Microsoft.Windows.Management.Deployment (PackageVolume, IPackageValidator) and Microsoft.Windows.Storage.Pickers (custom dialog titles, persistent settings, multi-folder picker, and more) APIs.

Bugs fixed:

  • Fixed ImageDescription.DescribeAsync failing with InternalError when called concurrently from multiple threads.
  • Various bug fixes and quality improvements in Video Super Resolution.
  • Bug fixes brought forward from 2.0-Preview1 and 2.0-Preview2.

To see everything that's new and changed, see the full Windows App SDK 2.0 Experimental release notes.

Try it out

  • Download the 2.0.0-experimental7 NuGet package to use WinAppSDK 2.0 in your app.
  • For CMake, see the CMake samples for end-to-end configuration across all four deployment scenarios (SelfContained|FrameworkDependent x Packaged|Unpackaged).

Getting Started

To get started using Windows App SDK to develop Windows apps, check out the following documentation:

2.0-exp6

Windows App SDK 2.0-Experimental6 (2.0.0-experimental6)

WinAppSDK 2.0.0 Experimental 6 is the latest experimental version of WinAppSDK providing new features and improvements to the platform.

What's new in WinAppSDK 2.0 Experimental 6:

  • The version of ONNX Runtime has been updated to 1.24.2.
  • NPUPowerMode has been deprecated in favor of newer power management APIs.
  • GetReadyState now gracefully returns NotSupported when the session broker is unavailable, instead of throwing an exception.
  • Added NV12 output format support for Video Super Resolution.
  • Improved DeleteIndex reliability.
  • App Content Search are part of a separate Microsoft.Windows.Search package instead of being part of Microsoft.Windows.AI package.

Bugs fixed:

  • Fixed ImageDescription.DescribeAsync failing with InternalError due to a race condition
  • Fix for OCR Bounding boxes returning negative values in some edge cases.

To see everything that's new and changed, see the full Windows App SDK 2.0 Experimental release notes.

Try it out

Getting Started

To get started using Windows App SDK to develop Windows apps, check out the following documentation:

2.0-exp5

Windows App SDK 2.0-Experimental5 (2.0.0-experimental5)

WinAppSDK 2.0.0 Experimental 5 is the latest experimental version of WinAppSDK providing new features and improvements to the platform.

What's new in WinAppSDK 2.0 Experimental 5:

  • Simplified license agreement with clearer terms for ISVs building applications with Windows ML.

Bugs fixed:

  • Fixed a bug where progress callbacks weren't working during execution provider installation. Applications calling ExecutionProvider.EnsureReadyAsync with a progress handler now correctly receive progress updates throughout the download and installation process.
  • Resolved issues where publish operations would fail or produce incorrect output structures.
  • Fixed build and publish failures when referencing Windows App SDK in .NET class library projects.

To see everything that's new and changed, see the full Windows App SDK 2.0 Experimental release notes.

Try it out

Getting Started

To get started using Windows App SDK to develop Windows apps, check out the following documentation:

2.0-exp4

Windows App SDK 2.0-Experimental4 (2.0.0-experimental4)

WinAppSDK 2.0.0 Experimental 4 is the latest experimental version of WinAppSDK providing new features and improvements to the platform.

What's new in WinAppSDK 2.0 Experimental 4:

  • Onnx Runtime updated to mainline version 1.24 for improved compatibility and stability.
  • Decreased the size of Microsoft.Windows.AI.MachineLearning.dll by approximately 160 KB
  • Introduced new APIs to lookup statistics of items being indexed.
  • New support for query cancellation to allow apps to run a query and update it if there is a new query.
  • Video Scaler is now disposable, improving resource management and lifecycle control.
  • The Video Super Resolution model is now compiled and cached to improve performance and reduce repeated initialization costs.
  • Removed the requirement for explicit WinML initialization when using Video Super Resolution.
  • The FlowLayout control now uses ItemSpacing and LineSpacing terminology.
  • The WrapPanel control now uses ItemSpacing and LineSpacing terminology.
  • Implemented the IXamlPredicate interface to define custom predicates that integrate seemlessly with XAML's conditional namespace syntax.
  • Added WinUI tools and scripts for use by external developers to build and test Windows.
  • Deprecated the DependencyObject.Dispatcher API in WinUI.
  • Deprecated the Window.Current API in WinUI.
  • Deprecated FocusManager.GetFocusedElement API in WinUI.
  • Renamed the SystemBackdropHost to SystemBackdropElement in WinUI.
  • Renamed the Microsoft.Windows.AI.Search.Experimental.AppContentIndex namespace to Microsoft.Windows.Search.AppContentIndex.

Bugs fixed:

  • Fixed “Class not registered” errors when using self-contained deployment with Windows ML. Developers using self-contained deployment no longer need to register all the Foundation package activatable classes that were used internally.
  • Fixed a potential crash occurring on process shutdown when using Windows ML.
  • Fixed the ImageForegroundExtractor API routing path so calls reach the correct endpoint.
  • Ensured execution provider install and download progress is correctly forwarded to apps during package deployment.
  • Fixed a crash in SystemBackdrop when the target disconnects by guarding invalid disconnection paths.
  • Fixed an issue that prevented Windows AI APIs from being available for some devices.

To see everything that's new and changed, see the full Windows App SDK 2.0 Experimental release notes.

Try it out

Getting Started

To get started using Windows App SDK to develop Windows apps, check out the following documentation:

2.0-exp3

Windows App SDK 2.0-Experimental3 (2.0.0-experimental3)

WinAppSDK 2.0.0 Experimental 3 is the latest experimental version of WinAppSDK providing new features and improvements to the platform.

What's new in WinAppSDK 2.0 Experimental 3:

  • AppIndexQuery type has been split into two distinct types: AppIndexTextQuery and AppIndexImageQuery.
  • The AppContentIndexer.CreateQuery method has been replaced with: CreateTextQuery and CreateImageQuery
  • The CreateTextQuery method now returns AppIndexTextQuery
  • The CreateImageQuery method now returns AppIndexImageQuery
  • The AppContentIndex namespace now returns IVectorView
  • The AppContentIndexer.WaitForIndexingIdleAsync method now accepts a TimeSpan parameter instead of an integer
  • The VideoScaler delivers real-time video enhancements, enabling developers to provide sharper, clearer visuals across conferencing, steaming and editing platforms even under poor network conditions.
  • The TextRewriter includes new create styles like "Goofy" or "Pirate"
  • The new SplitMenuFlyoutItem provides a split button experience within a menu flyout.
  • The new ImageGenerator provides powerful image generation capabilities for Text-to-Image, Image-to-Image, Magic fill, Coloring book, and restyle.
  • Renamed WinMLCatalogModel to ModelCatalog
  • Renamed CatalogModelSource to ModelCatalogSource
  • WinMLModelCatalog
    • Renamed FindModel to FindModelAsync
    • Renamed FindAllModel to FindAllModelsAsync
  • CatalogModelInfo
    • Updated CatalogModelInfo.Size to `CatalogModelInfo.ModelSizeInBytes
    • Renamed CreateFromUri method to CreateFromUriAsync
    • Renamed GetInstance method to GetInstanceAsync
    • Renamed Revision to Version
    • Renamed Alias to Name
    • Removed DisplayName
    • Added Publisher
  • ModelCatalog now returns a list of Execution Providers (EPs) when an instance is created.
  • Added support for Windows 10 (1809) and above
  • Added support for local files, including both regular files and MSIX packages
  • Fixed crashes caused by invalid catalog JSON
  • Updated behaviour of CatalogModelInstanceResult to use .GetInstalnce()` to retrieve instance
  • Updated behaviour of CatalogModelStatus to now return Ready or NotReady based on local availability
  • Added CatalogModelInstanceStatus to separate instance status from model status

Bugs fixed:

  • Fixed bounding box calculation when text is rotated. In some circumstances, the OCR text matches within images reported inaccurate or empty region bounds when the text was rotated.

To see everything that's new and changed, see the full Windows App SDK 2.0 Experimental release notes.

Try it out

Getting Started ...

_...

Description has been truncated

---
updated-dependencies:
- dependency-name: Microsoft.WindowsAppSDK
  dependency-version: 2.6.5
  dependency-type: direct:production
  update-type: version-update:semver-major
...

Signed-off-by: dependabot[bot] <support@github.com>
@dependabot @github

dependabot Bot commented on behalf of github Nov 14, 2026

Copy link
Copy Markdown
Contributor Author

Labels

The following labels could not be found: dependencies. Please create it before Dependabot can add it to a pull request.

Please fix the above issues or remove invalid values from dependabot.yml.

This branch has not been deployed

No deployments
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

0 participants