Skip to content

Bump Microsoft.WindowsAppSDK from 1.8.260317003 to 2.2.0#22

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

Bump Microsoft.WindowsAppSDK from 1.8.260317003 to 2.2.0#22
dependabot[bot] wants to merge 1 commit into
mainfrom
dependabot/nuget/Microsoft.WindowsAppSDK-2.2.0

Conversation

@dependabot

@dependabot dependabot Bot commented on behalf of github Jun 10, 2026

Copy link
Copy Markdown
Contributor

Updated Microsoft.WindowsAppSDK from 1.8.260317003 to 2.2.0.

Release notes

Sourced from Microsoft.WindowsAppSDK's releases.

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
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. 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. 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](https://learn.microsoft.com/en-us/windows/apps/windows-app-sdk/release-notes/windows-app-sdk-2-0?pivots=stable#version-213-213) for details.

**To see everything that's new and changed, see the full [Windows App SDK 2.1 Experimental 8 release notes](https://learn.microsoft.com/en-us/windows/apps/windows-app-sdk/release-notes/windows-app-sdk-2-0?pivots=experimental#version-21-experimental-8-214-experimental8).**

### Try it out
- Download the [2.1.4-experimental8 NuGet](https://www.nuget.org/packages/Microsoft.WindowsAppSDK/2.1.4-experimental8) package to use WinAppSDK 2.1 Experimental 8 in your app.

### Getting Started

To get started using Windows App SDK to develop Windows apps, check out the following documentation:
- [Install developer tools](https://docs.microsoft.com/windows/apps/windows-app-sdk/set-up-your-development-environment).
- [Create a WinUI 3 app](https://docs.microsoft.com/windows/apps/winui/winui3/create-your-first-winui3-app).
- [Continue your development journey](https://docs.microsoft.com/windows/apps/develop).


## 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](https://github.com/microsoft/microsoft-ui-xaml/pull/10936) and tracking issue [microsoft/microsoft-ui-xaml#​10421](https://github.com/microsoft/microsoft-ui-xaml/issues/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](https://learn.microsoft.com/windows/ai/apis/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](https://learn.microsoft.com/en-us/windows/windows-app-sdk/api/winrt/microsoft.windows.applicationmodel.windowsappruntime.runtimecompatibilityoptions.disabledchanges?view=windows-app-sdk-2.1) |
|---------|------------------------------------|
| 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](https://github.com/microsoft/microsoft-ui-xaml/issues/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](https://github.com/microsoft/microsoft-ui-xaml/issues/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](https://learn.microsoft.com/en-us/windows/apps/windows-app-sdk/release-notes/windows-app-sdk-2-0?pivots=stable#version-213-213).**

### Try it out
- Download the [2.1.3 NuGet](https://www.nuget.org/packages/Microsoft.WindowsAppSDK/2.1.3) package to use WinAppSDK 2.1 in your app.
- Download and update the [WinUI Gallery](https://www.microsoft.com/store/productId/9P3JFPWWDZRC) 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:
- [Install developer tools](https://docs.microsoft.com/windows/apps/windows-app-sdk/set-up-your-development-environment).
- [Create a WinUI 3 app](https://docs.microsoft.com/windows/apps/winui/winui3/create-your-first-winui3-app).
- [Continue your development journey](https://docs.microsoft.com/windows/apps/develop).


## 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](https://semver.org/) 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](https://semver.org/) 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](https://learn.microsoft.com/windows/ai/apis/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](https://learn.microsoft.com/en-us/windows/apps/windows-app-sdk/release-notes/windows-app-sdk-2-0?pivots=stable).**
 
 ### Try it out
 - Download the [2.0.1 NuGet](https://www.nuget.org/packages/Microsoft.WindowsAppSDK/2.0.1) package to use WinAppSDK 2.0 in your app.
 - Download and update the [WinUI Gallery](https://www.microsoft.com/store/productId/9P3JFPWWDZRC) 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:
 - [Install developer tools](https://docs.microsoft.com/windows/apps/windows-app-sdk/set-up-your-development-environment).
 - [Create a WinUI 3 app](https://docs.microsoft.com/windows/apps/winui/winui3/create-your-first-winui3-app).
 - [Continue your development journey](https://docs.microsoft.com/windows/apps/develop).


## 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](https://aka.ms/windowsappsdk/2.0/2.0.0-preview1/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](https://github.com/microsoft/microsoft-ui-xaml/issues/new/choose).
- For feedback regarding all other Windows App SDK components, please open an issue here, on the [Windows App SDK repo](https://github.com/microsoft/WindowsAppSDK/issues/new/choose).

## 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](https://learn.microsoft.com/en-us/windows/apps/windows-app-sdk/release-notes/windows-app-sdk-2-0?pivots=experimental&branch=main#version-20-experimental-7-200-experimental7) 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](https://aka.ms/windowsappsdk/2.0/2.0.0-experimental7/release-notes).**
 
 ### Try it out
 - Download the [2.0.0-experimental7 NuGet](https://www.nuget.org/packages/Microsoft.WindowsAppSDK/2.0.0-experimental7) package to use WinAppSDK 2.0 in your app.
 - For CMake, see the [CMake samples](https://github.com/microsoft/WindowsAppSDK-Samples/tree/release/2.0-experimental/Samples/CMake) 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:
 - [Install developer tools](https://docs.microsoft.com/windows/apps/windows-app-sdk/set-up-your-development-environment).
 - [Create a WinUI 3 app](https://docs.microsoft.com/windows/apps/winui/winui3/create-your-first-winui3-app).
 - [Continue your development journey](https://docs.microsoft.com/windows/apps/develop).


## 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](https://aka.ms/windowsappsdk/2.0/2.0.0-experimental6/release-notes).**  

### Try it out
- Download the [2.0.0-experimental6 NuGet](https://www.nuget.org/packages/Microsoft.WindowsAppSDK/2.0.0-experimental6) package to use WinAppSDK 2.0 in your app.
- Download and update the [WinUI Gallery](https://www.microsoft.com/store/productId/9P3JFPWWDZRC) 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:    
- [Install developer tools ](https://docs.microsoft.com/windows/apps/windows-app-sdk/set-up-your-development-environment).     
- [Create a WinUI 3 app](https://docs.microsoft.com/windows/apps/winui/winui3/create-your-first-winui3-app).   
- [Continue your development journey](https://docs.microsoft.com/windows/apps/develop).   - 

## 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](https://aka.ms/windowsappsdk/2.0/2.0.0-experimental5/release-notes).**  

### Try it out
- Download the [2.0.0-experimental5 NuGet](https://www.nuget.org/packages/Microsoft.WindowsAppSDK/2.0.0-experimental5) package to use WinAppSDK 2.0 in your app.
- Download and update the [WinUI Gallery](https://www.microsoft.com/store/productId/9P3JFPWWDZRC) 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:    
- [Install developer tools ](https://docs.microsoft.com/windows/apps/windows-app-sdk/set-up-your-development-environment).     
- [Create a WinUI 3 app](https://docs.microsoft.com/windows/apps/winui/winui3/create-your-first-winui3-app).   
- [Continue your development journey](https://docs.microsoft.com/windows/apps/develop).   - 

## 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](https://aka.ms/windowsappsdk/2.0/2.0.0-experimental4/release-notes).**  

### Try it out
- Download the [2.0.0-experimental4 NuGet](https://www.nuget.org/packages/Microsoft.WindowsAppSDK/2.0.0-experimental4) package to use WinAppSDK 2.0 in your app.
- Download and update the [WinUI Gallery](https://www.microsoft.com/store/productId/9P3JFPWWDZRC) 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:    
- [Install developer tools ](https://docs.microsoft.com/windows/apps/windows-app-sdk/set-up-your-development-environment).     
- [Create a WinUI 3 app](https://docs.microsoft.com/windows/apps/winui/winui3/create-your-first-winui3-app).   
- [Continue your development journey](https://docs.microsoft.com/windows/apps/develop).   - 

## 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](https://aka.ms/windowsappsdk/2.0/2.0.0-experimental3/release-notes).**  

### Try it out
- Download the [2.0.0-experimental3 NuGet](https://www.nuget.org/packages/Microsoft.WindowsAppSDK/2.0.0-experimental3) package to use WinAppSDK 2.0 in your app.
- Download and update the [WinUI Gallery](https://www.microsoft.com/store/productId/9P3JFPWWDZRC) 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:    
- [Install developer tools ](https://docs.microsoft.com/windows/apps/windows-app-sdk/set-up-your-development-environment).     
 ... (truncated)

## 2.0-exp2

## Windows App SDK 2.0-Experimental2 (2.0.0-experimental2)

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

### What's new in WinAppSDK 2.0.0 Experimental 2:

- **New AppContentIndexer API** enables application to efficiently index their content enabling the following experiences:
  - Semantic Search enables apps to return results based on intent and meaning rather than keyword match
  - Retrieval-Augmented Generation (RAG) allowing indexed content to be served as a knowledge base for generative AI models.
- Windows ML Model Catalog allows apps or libraries to dynamically discover and download large AI model files from your own online model catalogs.
- `InputUnderlyingWindowController` allows callers to specify the HWND that will receive the input messages originally directed to a `ContentIsland` created from a `SystemVisual`
- `SystemBackdropHost` provides XAML-compatible approach to placing a system backdrop anywhere within an application's visual tree.
- `PopupAnchor` now allows `DesktopPopupSiteBridge` to support relative positioning by anchoring to its owning window or island.
- The latest `Storage.Pickers` update streamlines file and folder selection by letting developers set initial and persistent folder locations, and by grouping filetype filters with clear labels for easier navigation.
- `WrapPanel` allows arranging child elements in a sequential position from left to right, items overflowing the line will break to the next line automatically.

**To see everything that's new and changed, see the full [Windows App SDK 2.0 Experimental release notes](https://aka.ms/windowsappsdk/2.0/2.0.0-experimental2/release-notes).**  

### Try it out
- Download the [2.0.0-experimental2 NuGet](https://www.nuget.org/packages/Microsoft.WindowsAppSDK/2.0.0-experimental2) package to use WinAppSDK 2.0 in your app.
- Download and update the [WinUI Gallery](https://www.microsoft.com/store/productId/9P3JFPWWDZRC) 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:    
- [Install developer tools ](https://docs.microsoft.com/windows/apps/windows-app-sdk/set-up-your-development-environment).     
- [Create a WinUI 3 app](https://docs.microsoft.com/windows/apps/winui/winui3/create-your-first-winui3-app).   
- [Continue your development journey](https://docs.microsoft.com/windows/apps/develop).   

## 2.0-exp1

## Windows App SDK 2.0-Experimental1 (2.0.250930001-experimental1)

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

### What's new in WinAppSDK 2.0.0 Experimental 1:

- **The Windows ML Model Catalog APIs** allow your app or library to dynamically download large AI model files from your own online model catalogs without shipping those large files directly with your app or library. Additionally, the model catalog will help filter which models are compatible with the Windows device it's running on, so that the right model is downloaded to the device.

The following bugs have been fixed:

- Fixed an issue in DeploymentManager which resulted in it incorrectly reporting PackageInstallRequired in some cases.

**To see everything that's new and changed, see the full [Windows App SDK 2.0 Experimental release notes](https://aka.ms/windowsappsdk/2.0/2.0.0-experimental1/release-notes).**  

### Try it out
- Download the [2.0.250930001-experimental1 NuGet](https://www.nuget.org/packages/Microsoft.WindowsAppSDK/2.0.250930001-experimental1) package to use WinAppSDK 2.0 in your app.
- Download and update the [WinUI Gallery](https://www.microsoft.com/store/productId/9P3JFPWWDZRC) 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:    
- [Install developer tools ](https://docs.microsoft.com/windows/apps/windows-app-sdk/set-up-your-development-environment).     
- [Create a WinUI 3 app](https://docs.microsoft.com/windows/apps/winui/winui3/create-your-first-winui3-app).   
- [Continue your development journey](https://docs.microsoft.com/windows/apps/develop).   

Commits viewable in [compare view](https://github.com/microsoft/windowsappsdk/commits/v2.2.0).
</details>

[![Dependabot compatibility score](https://dependabot-badges.githubapp.com/badges/compatibility_score?dependency-name=Microsoft.WindowsAppSDK&package-manager=nuget&previous-version=1.8.260317003&new-version=2.2.0)](https://docs.github.com/en/github/managing-security-vulnerabilities/about-dependabot-security-updates#about-compatibility-scores)

Dependabot will resolve any conflicts with this PR as long as you don't alter it yourself. You can also trigger a rebase manually by commenting `@dependabot rebase`.

[//]: # (dependabot-automerge-start)
[//]: # (dependabot-automerge-end)

---

<details>
<summary>Dependabot commands and options</summary>
<br />

You can trigger Dependabot actions by commenting on this PR:
- `@dependabot rebase` will rebase this PR
- `@dependabot recreate` will recreate this PR, overwriting any edits that have been made to it
- `@dependabot show <dependency name> ignore conditions` will show all of the ignore conditions of the specified dependency
- `@dependabot ignore this major version` will close this PR and stop Dependabot creating any more for this major version (unless you reopen the PR or upgrade to it yourself)
- `@dependabot ignore this minor version` will close this PR and stop Dependabot creating any more for this minor version (unless you reopen the PR or upgrade to it yourself)
- `@dependabot ignore this dependency` will close this PR and stop Dependabot creating any more for this dependency (unless you reopen the PR or upgrade to it yourself)


</details>

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

Signed-off-by: dependabot[bot] <support@github.com>
@dependabot dependabot Bot added .NET Pull requests that update .NET code dependencies Pull requests that update a dependency file labels Jun 10, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

dependencies Pull requests that update a dependency file .NET Pull requests that update .NET code

Projects

None yet

Development

Successfully merging this pull request may close these issues.

0 participants