Skip to content

Commit c35710a

Browse files
authored
WindowsAppSDK 2.0-experimental7 release notes (#6669)
* WASDK 2.0-experimental7 release notes * formatting and slight reword * update samples link * remove RI entries that were already present/don't apply * Storage.Pickers and Management.Deployment wording updates from author feedback
1 parent 24176f0 commit c35710a

3 files changed

Lines changed: 211 additions & 1 deletion

File tree

hub/apps/windows-app-sdk/downloads.md

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -46,6 +46,7 @@ For older releases, see the [Archive of Windows App SDK downloads](downloads-arc
4646
### Windows App SDK 2.0 Experimental
4747
| Version | Runtime downloads |
4848
|--|--|
49+
| **2.0 Experimental 7 (2.0.0-experimental7)** <br/> 04/21/2026 <br/> [Release notes](./release-notes/windows-app-sdk-2-0.md?pivots=experimental#version-20-experimental-7-200-experimental7) <br/> [Source](https://github.com/microsoft/microsoft-ui-xaml/releases/tag/winui3%2Frelease%2F2.0.0-experimental7) | [Installer (x64)](https://aka.ms/windowsappsdk/2.0/2.0.0-experimental7/windowsappruntimeinstall-x64.exe) <br/> [Installer (x86)](https://aka.ms/windowsappsdk/2.0/2.0.0-experimental7/windowsappruntimeinstall-x86.exe) <br/> [Installer (arm64)](https://aka.ms/windowsappsdk/2.0/2.0.0-experimental7/windowsappruntimeinstall-arm64.exe) <br/> [Redistributable (ZIP)](https://aka.ms/windowsappsdk/2.0/2.0.0-experimental7/Microsoft.WindowsAppRuntime.Redist.2.0.zip) |
4950
| **2.0 Experimental 6 (2.0.0-experimental6)** <br/> 03/13/2026 <br/> [Release notes](./release-notes/windows-app-sdk-2-0.md?pivots=experimental#version-20-experimental-6-200-experimental6) <br/> [Source](https://github.com/microsoft/microsoft-ui-xaml/releases/tag/winui3%2Frelease%2F2.0.0-experimental6) | [Installer (x64)](https://aka.ms/windowsappsdk/2.0/2.0.0-experimental6/windowsappruntimeinstall-x64.exe) <br/> [Installer (x86)](https://aka.ms/windowsappsdk/2.0/2.0.0-experimental6/windowsappruntimeinstall-x86.exe) <br/> [Installer (arm64)](https://aka.ms/windowsappsdk/2.0/2.0.0-experimental6/windowsappruntimeinstall-arm64.exe) <br/> [Redistributable (ZIP)](https://aka.ms/windowsappsdk/2.0/2.0.0-experimental6/Microsoft.WindowsAppRuntime.Redist.2.0.zip) |
5051
| **2.0 Experimental 5 (2.0.0-experimental5)** <br/> 02/13/2026 <br/> [Release notes](./release-notes/windows-app-sdk-2-0.md?pivots=experimental#version-20-experimental-5-200-experimental5) <br/> [Source](https://github.com/microsoft/microsoft-ui-xaml/releases/tag/winui3%2Frelease%2F2.0.0-experimental5) | [Installer (x64)](https://aka.ms/windowsappsdk/2.0/2.0.0-experimental5/windowsappruntimeinstall-x64.exe) <br/> [Installer (x86)](https://aka.ms/windowsappsdk/2.0/2.0.0-experimental5/windowsappruntimeinstall-x86.exe) <br/> [Installer (arm64)](https://aka.ms/windowsappsdk/2.0/2.0.0-experimental5/windowsappruntimeinstall-arm64.exe) <br/> [Redistributable (ZIP)](https://aka.ms/windowsappsdk/2.0/2.0.0-experimental5/Microsoft.WindowsAppRuntime.Redist.2.0.zip) |
5152
| **2.0 Experimental 4 (2.0.0-experimental4)** <br/> 01/13/2026 <br/> [Release notes](./release-notes/windows-app-sdk-2-0.md?pivots=experimental#version-20-experimental-4-200-experimental4) <br/> [Source](https://github.com/microsoft/microsoft-ui-xaml/releases/tag/winui3%2Frelease%2F2.0.0-experimental4) | [Installer (x64)](https://aka.ms/windowsappsdk/2.0/2.0.0-experimental4/windowsappruntimeinstall-x64.exe) <br/> [Installer (x86)](https://aka.ms/windowsappsdk/2.0/2.0.0-experimental4/windowsappruntimeinstall-x86.exe) <br/> [Installer (arm64)](https://aka.ms/windowsappsdk/2.0/2.0.0-experimental4/windowsappruntimeinstall-arm64.exe) <br/> [Redistributable (ZIP)](https://aka.ms/windowsappsdk/2.0/2.0.0-experimental4/Microsoft.WindowsAppRuntime.Redist.2.0.zip) |

hub/apps/windows-app-sdk/release-channels.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -15,7 +15,7 @@ The latest version of the Windows App SDK ships via three release channels: Expe
1515
|--:|--|--|--|:--:|--|
1616
| **** | **Stable** | Production-ready channel intended for apps in market. Includes only stable, supported APIs suitable for long-term use. | No more than every six months <br/> *(plus servicing updates as needed)* | Yes | **1.8.6 (1.8.260317003)** <br/> Released: 03/18/2026 <br/> [Release notes](./release-notes/windows-app-sdk-1-8.md?pivots=stable#version-186-18260317003) |
1717
| **❇️** | **Preview** | Early look at the next Stable release. May introduce breaking API changes before final stabilization. | At least one preview for each Stable release | No | **2.0 Preview2 (2.0.0-preview2)** <br/> Released: 03/31/2026 <br/> [Release notes](./release-notes/windows-app-sdk-2-0.md?pivots=preview#version-20-preview-2-200-preview2) |
18-
| **🔄** | **Experimental** | Early-stage features under active development. APIs may change, be removed, or never ship. Intended for exploration and feedback only. | Published as needed to gather feedback on prototypes and early designs | No | **2.0 Experimental 6 (2.0.0-experimental6)** <br/> Released: 03/13/2026 <br/> [Release notes](./release-notes/windows-app-sdk-2-0.md?pivots=experimental#version-20-experimental-6-200-experimental6) |
18+
| **🔄** | **Experimental** | Early-stage features under active development. APIs may change, be removed, or never ship. Intended for exploration and feedback only. | Published as needed to gather feedback on prototypes and early designs | No | **2.0 Experimental 7 (2.0.0-experimental7)** <br/> Released: 04/21/2026 <br/> [Release notes](./release-notes/windows-app-sdk-2-0.md?pivots=experimental#version-20-experimental-7-200-experimental7) |
1919

2020

2121
For a comprehensive list of all current and previous releases of the Windows App SDK, including download locations, see [Downloads for the Windows App SDK](downloads.md).

hub/apps/windows-app-sdk/release-notes/windows-app-sdk-2-0.md

Lines changed: 209 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -363,6 +363,215 @@ Released: **February 13, 2026** <br><br>
363363
364364
:::zone pivot="experimental"
365365
366+
## Version 2.0 Experimental 7 (2.0.0-Experimental7)
367+
368+
Released: **April 21, 2026** <br><br>
369+
370+
<details><summary>CMake Support [Experimental]</summary>
371+
372+
>
373+
> Windows App SDK 2.0.0-experimental7 introduces experimental CMake support (under active development), enabling C++ developers to consume Windows App SDK NuGet packages from CMake-based projects.
374+
>
375+
> The CMake integration is built on [NuGetCMakePackage](https://github.com/mschofie/NuGetCMakePackage), an open-source CMake module that bridges the gap between NuGet package management and CMake's native `find_package()` workflow. NuGetCMakePackage handles downloading and restoring NuGet packages at configure time via `add_nuget_packages()`, probes each package for an embedded cmake config (at `build/cmake/<package>-config.cmake`), and exposes the package's headers, import libraries, runtime DLLs, and WinRT metadata as standard CMake targets.
376+
>
377+
> Each Windows App SDK NuGet component and dependent package now embeds a CMake configuration file under `build/cmake/`, which with the help of the NuGetCMakePackage library, allows CMake's `find_package()` to automatically discover targets, headers, libraries, and runtime DLLs without manual path configuration. This covers all component packages including Foundation, InteractiveExperiences, DWrite, Widgets, AI, ML, and WinUI, as well as dependencies such as Base and Runtime.
378+
>
379+
> For an overview of the CMake consumption model and getting started guidance, see the [CMake landing page](https://github.com/mschofie/NuGetCMakePackage/blob/develop/.github/copilot-instructions.md).
380+
>
381+
> This feature is experimental and is being flighted early to collect community feedback. The target naming conventions, and configuration patterns are subject to change based on developer input. Because this is an early flight, there is some ceremony and setup involved - please refer to the [CMake sample applications](https://github.com/microsoft/WindowsAppSDK-Samples/tree/release/2.0-experimental/Samples/CMake) which illustrate end-to-end configuration and usage across all four deployment scenarios (`SelfContained|FrameworkDependent` x `Packaged|Unpackaged`).
382+
>
383+
> We want to hear from you! If you encounter a scenario that isn't currently covered, have suggestions for improving the developer experience, or run into issues, please file feedback under the [Issues](https://github.com/microsoft/WindowsAppSDK/issues) tab in the Windows App SDK open-source repository or start a conversation in [Discussions](https://github.com/microsoft/WindowsAppSDK/discussions). Your input will directly shape the active development of this feature.
384+
>
385+
386+
</details>
387+
388+
<details><summary>Changes brought forward from the Preview channel</summary>
389+
390+
>
391+
> This experimental release rolls up the changes and fixes shipped in **[2.0-Preview1](#version-20-preview-1-200-preview1)** and **[2.0-Preview2](#version-20-preview-2-200-preview2)**. Items brought forward are summarized below; refer to the linked Preview release notes for full details.
392+
>
393+
> **From 2.0-Preview1:**
394+
> * **Windows ML**: Fix for `RegisterCertifiedAsync` returning 0 execution providers when called again in the same process.
395+
> * **Microsoft.UI.Content**: New `InputFocusController.ShouldShowKeyboardCues` property and new convenience API `PointerPoint.GetCurrentPoint`.
396+
> * **Microsoft.Windows.Management.Deployment**: New `PackageVolume` APIs for parity+ with `Windows.Management.Deployment` (including `AddAsync`, `GetDefault`, `GetAvailableSpaceAsync`, `IsAppxInstallSupported`, `IsOffline`, `IsFeatureSupported`, and more). New `IPackageValidator` extensibility point on `AddPackageOptions` and `StagePackageOptions`, with three built-in validators: `PackageCertificateEkuValidator`, `PackageFamilyNameValidator`, and `PackageMinimumVersionValidator`.
397+
> * **Microsoft.Windows.Storage.Pickers**:
398+
> * New `Title` properties on `FileOpenPicker`, `FileSavePicker`, and `FolderPicker`, enabling custom dialog titles.
399+
> * New `SettingsIdentifier` properties on `FileOpenPicker`, `FileSavePicker`, and `FolderPicker`, enabling picker instance-specific state across sessions.
400+
> * New `InitialFileTypeIndex` properties on `FileOpenPicker` and `FileSavePicker`, allowing developers to set the default selected file type filter by index (0-based).
401+
> * New `ShowOverwritePrompt` property on `FileSavePicker`. It defaults to `true` and controls whether the picker warns about overwriting when user picks an existing file via `FileSavePicker`.
402+
> * Changed the default behavior of `FileSavePicker`: starting from WindowsAppSDK 2.0, the `FileSavePicker` will NOT create an empty file when the user picks a non-existing file, allowing developers to decide when to make the file.
403+
> * New `PickMultipleFoldersAsync` method on `FolderPicker`, enabling selection of multiple folders in a single operation.
404+
> * **Bug fixes**: Installer progress reporting; improved error handling for `WindowsAppSDKSelfContained` class libraries.
405+
>
406+
> **From 2.0-Preview2:**
407+
> * **Windows AI APIs**: Phi Silica APIs are enforced as a Limited Access Feature; new `AIFeatureReadyState` values surface model-acquisition issues such as missing capabilities, incompatible hardware, and required OS updates; durable network/Windows Update install failures are now flagged; improved diagnosability for Text Intelligence APIs.
408+
> * **Custom XAML Conditionals**: `IXamlCondition` graduates and renames the experimental `IXamlPredicate` interface, enabling custom conditions evaluated at XAML parse time.
409+
> * **WebView2 (WinUI 3)**: Drag support for content hosted in WebView2 (text, HTML, images, URLs), drag cancellation, custom drag visuals, and customizable drag data. Requires WebView2 Runtime 144.0.3719.11 or later. (`DownloadURL` not yet supported.)
410+
> * **Bug fixes**: MSB8027/LNK4042 build warnings from duplicate ClCompile items in `.targets` files (with an opt-out workaround `WindowsAppSDK_Arm64EcCompilerWorkaround` for ARM64EC+LTCG); ListView crash during keyboard navigation after items list updates; WinUI 3 crash when focus moved to a non-visible CoreWebView2Controller.
411+
>
412+
413+
</details>
414+
415+
<details><summary>Video Super Resolution</summary>
416+
417+
>
418+
> * API rename pass for clarity and consistency:
419+
> * `ScaleFrameStatus` → `VideoScalerStatus`
420+
> * `VideoScalerOptions.RegionOfInterests` → `VideoScalerOptions.RegionsOfInterest`
421+
> * `VideoScaler.ScaleFrame` → `VideoScaler.Scale` and `VideoScaler.ScaleImageBuffer`
422+
> * Various bug fixes and quality improvements in VSR.
423+
>
424+
425+
</details>
426+
427+
<details><summary>Windows AI Language Model</summary>
428+
429+
>
430+
> * New `LanguageModelExperimental.GenerateStructuredJsonResponseAsync` API under `Microsoft.Windows.AI.Text.Experimental` for generating structured JSON output from a language model.
431+
> * New `LanguageModelResponseStatus.ResponseInvalidJson` status value to indicate a model returned a response that did not parse as valid JSON.
432+
>
433+
434+
</details>
435+
436+
<details><summary>App Content Indexer</summary>
437+
438+
>
439+
> * New `AppContentIndexer.GetExistingIndexes` and `AppContentIndexer.IsContentKindSupported` APIs.
440+
> * New `AppManagedOcrTextQueryMatch` type and `QueryMatchContentKind.AppManagedOcrText` value to support querying app content via OCR-derived text.
441+
> * New `GetOrCreateIndexOptions.CreateAlways` to force creation of a fresh index.
442+
> * New `ContentItemErrorDetail.InsufficientDiskSpace` to surface low-disk-space failures during indexing.
443+
>
444+
445+
</details>
446+
447+
<details><summary>New or updated APIs</summary>
448+
449+
>
450+
> This release includes the following new and modified experimental APIs compared to 2.0.0-experimental6:
451+
>
452+
> ```
453+
> Microsoft.UI.Input
454+
>
455+
> InputFocusController
456+
> ShouldShowKeyboardCues
457+
>
458+
> PointerPoint
459+
> GetCurrentPoint
460+
> ```
461+
> ```
462+
> Microsoft.UI.Xaml.Markup
463+
>
464+
> IXamlCondition
465+
> ```
466+
> ```
467+
> Microsoft.Windows.AI
468+
>
469+
> AIFeatureReadyResult
470+
> PackageInstallationFailed
471+
>
472+
> AIFeatureReadyState
473+
> CapabilityMissing
474+
> NotCompatibleWithSystemHardware
475+
> OSUpdateNeeded
476+
> ```
477+
> ```
478+
> Microsoft.Windows.AI.Text
479+
>
480+
> LanguageModelResponseStatus
481+
> ResponseInvalidJson
482+
> ```
483+
> ```
484+
> Microsoft.Windows.AI.Text.Experimental
485+
>
486+
> LanguageModelExperimental
487+
> GenerateStructuredJsonResponseAsync
488+
> ```
489+
> ```
490+
> Microsoft.Windows.AI.Video
491+
>
492+
> VideoScaler
493+
> Scale
494+
> ScaleImageBuffer
495+
>
496+
> VideoScalerOptions
497+
> RegionsOfInterest
498+
>
499+
> VideoScalerStatus
500+
> ```
501+
> ```
502+
> Microsoft.Windows.Management.Deployment
503+
>
504+
> AddPackageOptions
505+
> GetValidationEventSourceForUri
506+
> IsPackageValidationSupported
507+
> PackageValidators
508+
>
509+
> IPackageValidator
510+
> PackageCertificateEkuValidator
511+
> PackageFamilyNameValidator
512+
> PackageMinimumVersionValidator
513+
> PackageValidationEventArgs
514+
> PackageValidationEventSource
515+
> PackageValidationHandler
516+
> PackageVolume
517+
> AddAsync
518+
> GetAvailableSpaceAsync
519+
> GetDefault
520+
> GetPackageVolumeByName
521+
> GetPackageVolumeByPath
522+
> IsFeatureSupported
523+
> IsOffline
524+
> RemoveAsync
525+
> SetDefault
526+
> SetOfflineAsync
527+
> SetOnlineAsync
528+
>
529+
> PackageVolumeFeature
530+
> StagePackageOptions
531+
> GetValidationEventSourceForUri
532+
> IsPackageValidationSupported
533+
> PackageValidators
534+
> ```
535+
> ```
536+
> Microsoft.Windows.Search.AppContentIndex
537+
>
538+
> AppContentIndexer
539+
> GetExistingIndexes
540+
> IsContentKindSupported
541+
>
542+
> AppManagedOcrTextQueryMatch
543+
> ContentItemErrorDetail
544+
> InsufficientDiskSpace
545+
>
546+
> GetOrCreateIndexOptions
547+
> CreateAlways
548+
>
549+
> QueryMatchContentKind
550+
> AppManagedOcrText
551+
> ```
552+
> ```
553+
> Microsoft.Windows.Storage.Pickers
554+
>
555+
> FileOpenPicker
556+
> InitialFileTypeIndex
557+
> SettingsIdentifier
558+
> Title
559+
>
560+
> FileSavePicker
561+
> InitialFileTypeIndex
562+
> SettingsIdentifier
563+
> ShowOverwritePrompt
564+
> Title
565+
>
566+
> FolderPicker
567+
> PickMultipleFoldersAsync
568+
> SettingsIdentifier
569+
> Title
570+
> ```
571+
>
572+
573+
</details>
574+
366575
## Version 2.0 Experimental 6 (2.0.0-Experimental6)
367576
368577
Released: **March 13, 2026** <br><br>

0 commit comments

Comments
 (0)