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.

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

• Download the 2.0.0-experimental5 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:

• Install developer tools .
• Create a WinUI 3 app.
• Continue your development journey. -

Windows App SDK 1.8.5 (1.8.260209005)

WinAppSDK 1.8.5 is the latest stable version of WinAppSDK 1.8 providing new features and improvements to the platform.

Whats new in WinAppSDK 1.8.5:

• The version of ONNX Runtime in Windows ML has been updated to ~1.23.3. Benefits from the latest bug fixes, security updates, and performance improvements across all execution providers (CPU, DirectML, OpenVINO, TensorRT)
• Updated Windows ML License agreement to clarify legal complexities.

Bug fixes:

Try it out

• Download the 1.8.260209005 NuGet package to use WinAppSDK 1.8.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:

• Install developer tools .
• Create a WinUI 3 app.
• Continue your development journey.

Windows App SDK 1.7.8 (1.7.260208002)

WinAppSDK 1.7.8 is the latest stable version of WinAppSDK 1.7 providing new features and improvements to the platform. To see everything that's new and changed, see the full Windows App SDK 1.7.8 release notes.

What's new in WinAppSDK 1.7.8:

• N/A

Bug fixes:

Try it out

• Download the 1.7.260208002 NuGet package to use WinAppSDK 1.7.8 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:

• Install developer tools .
• Create a WinUI 3 app.
• Continue your development journey.

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

• Download the 2.0.0-experimental4 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:

• Install developer tools .
• Create a WinUI 3 app.
• Continue your development journey. -

Windows App SDK 1.8.4 (1.8.260101001)

WinAppSDK 1.8.4 is the latest stable version of WinAppSDK 1.8 providing new features and improvements to the platform.

Whats new in WinAppSDK 1.8.4:

• New TextRewriter tone added for "Rewrite as Shakespeare".
• New TextRewriter tone added for "Rewrite in Sci-fi".
• Decrease the size of Microsoft.Windows.AI.MachineLearning.dll by approximately 160 KB

Bug fixes:

Try it out

• Download the 1.8.260101001 NuGet package to use WinAppSDK 1.8.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:

• Install developer tools .
• Create a WinUI 3 app.
• Continue your development journey.

Windows App SDK 1.7.7 (1.7.251220001)

WinAppSDK 1.7.7 is the latest stable version of WinAppSDK 1.7 providing new features and improvements to the platform. To see everything that's new and changed, see the full Windows App SDK 1.7.7 release notes.

What's new in WinAppSDK 1.7.7:

• N/A

Bug fixes:

Try it out

• Download the 1.7.251220001 NuGet package to use WinAppSDK 1.7.t 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:

• Install developer tools .
• Create a WinUI 3 app.
• Continue your development journey.

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

• Download the 2.0.0-experimental3 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:

• Install developer tools .
• Create a WinUI 3 app.
• Continue your development journey. -

Windows App SDK 1.8.3 (1.8.251106002)

WinAppSDK 1.8.3 is the latest stable version of WinAppSDK 1.8 providing new features and improvements to the platform. To see everything that's new and changed, see the full Windows App SDK 1.8.3 release notes.

Whats new in WinAppSDK 1.8.3:

• Extended support for Windows ML to Windows 10 (Version 1809 and later) for CPU and GPU workloads
• Extended support for Windows ML to Windows Server 2019 and later for CPU and GPU workloads
• Added Support for AMD MiGraphX execution provider.
• New Windows ML Model Catalog APIs enable your app or library to dynamically discover and download large AI model files.

Bug fixes:

Try it out

• Download the 1.8.251106002 NuGet package to use WinAppSDK 1.8.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:

• Install developer tools .
• Create a WinUI 3 app.
• Continue your development journey.

Windows App SDK 1.7.6 (1.7.251107005)

WinAppSDK 1.7.6 is the latest stable version of WinAppSDK 1.7 providing new features and improvements to the platform. To see everything that's new and changed, see the full Windows App SDK 1.7.6 release notes.

What's new in WinAppSDK 1.7.6:

• Object Erase can be used to remove objects from images

Bug fixes:

Try it out

• Download the 1.7.251107005 NuGet package to use WinAppSDK 1.7.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:

• Install developer tools .
• Create a WinUI 3 app.
• Continue your development journey.