WinAppSDK 1.7 Experimental 3 - Release Notes (#5155)

RDMacLachlan · web-flow · commit 14b7117109a2 · 2025-02-06T15:07:51.000-08:00
* Bulk Edit

Missing the specific Version for the release, as well as the AKA.MS links.

* First round of comments resolved.

Working on the links. Will update the merge with those updates shortly.

* Updated links

Updated links

* Think I fixed the last one
diff --git a/hub/apps/windows-app-sdk/downloads.md b/hub/apps/windows-app-sdk/downloads.md
@@ -42,6 +42,7 @@ For all the latest Windows App SDK downloads, refer to the tables and links belo
 
 | Version | Runtime downloads |
 |---|---|
+| [1.7 Experimental3 (1.7.250127003-experimental3) ](/windows/apps/windows-app-sdk/experimental-channel#version-17-experimental-170-experimental3) <br/> 02/06/2025 <br/> [Release notes](/windows/apps/windows-app-sdk/experimental-channel#version-17-experimental-170-experimental3) <br/> [Source](https://github.com/microsoft/microsoft-ui-xaml/releases/tag/winui3%2Frelease%2F1.7-experimental3) | [Installer (x64)](https://aka.ms/windowsappsdk/1.7/1.7.250127003-experimental3/windowsappruntimeinstall-x64.exe) <br/> [Installer (x86)](https://aka.ms/windowsappsdk/1.7/1.7.250127003-experimental3/windowsappruntimeinstall-x86.exe) <br/> [Installer (arm64)](https://aka.ms/windowsappsdk/1.7/1.7.250127003-experimental3/windowsappruntimeinstall-arm64.exe) <br/> [Redistributable](https://aka.ms/windowsappsdk/1.7/1.7.250127003-experimental3/Microsoft.WindowsAppRuntime.Redist.1.7.zip) |
 | [1.7 Experimental2 (1.7.250109001-experimental2) ](/windows/apps/windows-app-sdk/experimental-channel#version-17-experimental-170-experimental2) <br/> 01/09/2025 <br/> [Release notes](/windows/apps/windows-app-sdk/experimental-channel#version-17-experimental-170-experimental2) <br/> [Source](https://github.com/microsoft/microsoft-ui-xaml/releases/tag/winui3%2Frelease%2F1.7-experimental2) | [Installer (x64)](https://aka.ms/windowsappsdk/1.7/1.7.250109001-experimental2/windowsappruntimeinstall-x64.exe) <br/> [Installer (x86)](https://aka.ms/windowsappsdk/1.7/1.7.250109001-experimental2/windowsappruntimeinstall-x86.exe) <br/> [Installer (arm64)](https://aka.ms/windowsappsdk/1.7/1.7.250109001-experimental2/windowsappruntimeinstall-arm64.exe) <br/> [Redistributable](https://aka.ms/windowsappsdk/1.7/1.7.250109001-experimental2/Microsoft.WindowsAppRuntime.Redist.1.7.zip) |
 | [1.7 Experimental1 (1.7.241114004-experimental1) ](/windows/apps/windows-app-sdk/experimental-channel#version-17-experimental-170-experimental1) <br/> 11/20/2024 <br/> [Release notes](/windows/apps/windows-app-sdk/experimental-channel#version-17-experimental-170-experimental1) <br/> [Source](https://github.com/microsoft/microsoft-ui-xaml/releases/tag/winui3%2Frelease%2F1.7-experimental1) | [Installer (x64)](https://aka.ms/windowsappsdk/1.7/1.7.241114004-experimental1/windowsappruntimeinstall-x64.exe) <br/> [Installer (x86)](https://aka.ms/windowsappsdk/1.7/1.7.241114004-experimental1/windowsappruntimeinstall-x86.exe) <br/> [Installer (arm64)](https://aka.ms/windowsappsdk/1.7/1.7.241114004-experimental1/windowsappruntimeinstall-arm64.exe) <br/> [Redistributable](https://aka.ms/windowsappsdk/1.7/1.7.241114004-experimental1/Microsoft.WindowsAppRuntime.Redist.1.7.zip) |
 
diff --git a/hub/apps/windows-app-sdk/experimental-channel.md b/hub/apps/windows-app-sdk/experimental-channel.md
@@ -29,6 +29,182 @@ The experimental channel includes releases of the Windows App SDK with [experime
 - [Experimental channel release notes for the Windows App SDK 1.0](release-notes-archive/experimental-channel-1.0.md)
 - [Experimental channel release notes for the Windows App SDK 0.8](release-notes-archive/experimental-channel-0.8.md)
 
+## Version 1.7 Experimental (1.7.0-experimental3)
+### Use on-device AI with Windows Copilot Runtime APIs
+
+> [!IMPORTANT]
+> The underlying ML models required for these APIs currently require your device to be running the latest Windows 11 Insider Preview Build on the Dev Channel. Additionally, these APIs require your device to be a Copilot+ PC. See [Copilot+ PCs Developer Guide](/windows/ai/npu-devices) to learn more about these devices. APIs will throw an exception when called on devices lacking the necessary support.
+
+The Windows Copilot Runtime (WCR) offers several AI-powered features and APIs for you to easily, efficiently, and responsibly use on-device AI models in your Windows apps. In this release we are making available several scenario focused APIs for you to leverage powerful capabilities without the need to find, run, or optimize your own Machine Learning (ML) models. 
+
+Learn more about responsible development practices used during WCR API development that you can also apply as you create AI-assisted features in the [Developing Responsible Generative AI Applications and Features on Windows](/windows/ai/rai) guidance.
+
+#### Phi Silica
+
+With [**Phi Silica**](/windows/ai/apis/phi-silica), Microsoft's most powerful NPU-tuned local language model, you can generate text responses to broad user prompts with built in content moderation. You can also specify it to perform common tasks like summarizing a piece of text, rewriting a piece of text for clarity, and converting text to a table format. Phi Silica is optimized for efficiency and performance on Windows Copilot+ PCs devices while still offering many of the capabilities found in Large Language Models (LLMs). 
+
+See [Get started with Phi Silica in the Windows App SDK](/windows/ai/apis/phi-silica) and [API ref for Phi Silica in the Windows App SDK](/windows/ai/apis/phi-silica-api-ref) for more information.
+
+#### Text Recognition (OCR)
+
+Text recognition, also known as optical character recognition (OCR), APIs in Windows Copilot Runtime (WCR) can detect and extract text within images and convert it into machine readable character streams. These APIs can identify characters, words, lines, polygonal text boundaries, and provide confidence levels for each match. The set of WCR AI-assisted APIs benefit from NPU-assisted acceleration to perform faster and more accurately than the legacy [Windows.Media.Ocr.OcrEngine](/uwp/api/windows.media.ocr.ocrengine) APIs.
+
+See [Get Started with Text Recognition (OCR) in the Windows App SDK](/windows/ai/apis/text-recognition) and [API ref for AI-backed Text Recognition (OCR) in the Windows App SDK](/windows/ai/apis/text-recognition-api-ref) for more information.
+
+#### Image Super Resolution
+
+Using the 'ImageScaler' APIs you can increase the sharpness and clarity of an image and upscale the image up to 8x its original resolution.
+
+See [What can I do with Image Super Resolution?](/windows/ai/apis/imaging#what-can-i-do-with-image-super-resolution) and [API ref for AI imaging features in the Windows App SDK](/windows/ai/apis/imaging-api-ref) to get started.
+
+#### Image Description
+
+The Image Description APIs can be used to generate a text description of an image. The APIs are configurable to specify the length and type of the text description. Image descriptions may include a short caption or a long description for users with accessibility needs.
+
+> [!NOTE]
+> When calling ImageDescriptionGenerator.DescribeAsync() in a Debug build, an error may occur that can be mitigated by continuing the build in Visual Studio.
+
+See [What can I do with Image Description?](/windows/ai/apis/imaging#what-can-i-do-with-image-description) and [API ref for AI imaging features in the Windows App SDK](/windows/ai/apis/imaging-api-ref) to learn more.
+
+#### Image Segmentation
+
+Using Image Segmentation APIs you can identify specific objects within an image. The model takes both an image and a "hints" object and returns a mask of the identified object.
+
+See [What can I do with Image Segmentation?](/windows/ai/apis/imaging#what-can-i-do-with-image-segmentation) and [API ref for AI imaging features in the Windows App SDK](/windows/ai/apis/imaging-api-ref) to get started.
+
+### New APIs for Windowing
+
+New `AppWindow` APIs make it easier to control your app windows and create a great experience. New capabilities include using `EnablePlacementPersistence` to automatically remember the size and position of your windows, using `SetTaskBarIcon` and `SetTitleBarIcon` to independently set the taskbar and titlebar icons, using `AppWindowTitleBar.PreferredTheme` to set the light/dark theme of the titlebar, and using `OverlappedPresenter.PreferredMinimum/MaximumSize` to set a minimum or maximum size for the window.
+
+### Other notable changes
+
+* The missing C# projections for the new `BadgeNotifications` have been added so these APIs are now usable from C#.
+* A class registration issue which prevented using the new `AppNotificationConferencingConfig` API has been fixed. Note that this enhanced user experience for video or audio calling in notifications is only available on the latest Windows Insider releases of Windows.
+
+### New APIs
+
+This release includes the following new and modified experimental APIs compared to 1.7-experimental2:
+```
+Microsoft.Graphics.Imaging
+
+    ImageBuffer
+    ImageBufferContract
+    ImageObjectExtractor
+    ImageObjectExtractorContract
+    ImageObjectExtractorHint
+    ImageScaler
+    ImageScalerContract
+    PixelFormat
+```
+```
+Microsoft.UI.Content
+
+    ChildSiteLink
+        AutomationOption
+        ProcessKeyboardInput
+        ProcessPointerInput
+
+    ContentAutomationOptions
+    ContentIsland
+        AutomationOption
+        ProcessKeyboardInput
+        ProcessPointerInput
+
+    ContentSite
+        ProcessKeyboardInput
+        ProcessPointerInput
+
+    ContentSiteView
+        AutomationOption
+        ProcessKeyboardInput
+        ProcessPointerInput
+
+    DesktopPopupSiteBridge
+        AutomationOption
+
+    IContentSiteAutomation
+        AutomationOption
+
+    IContentSiteInput
+    ReadOnlyDesktopSiteBridge
+        ProcessKeyboardInput
+        ProcessPointerInput
+```
+```
+Microsoft.UI.Windowing
+
+    AppWindow
+        EnablePlacementPersistence
+        EnablePlacementPersistence
+        GetCurrentPlacement
+        SaveCurrentPlacement
+        SetPlacement
+        SetTaskBarIcon
+        SetTaskBarIcon
+        SetTitleBarIcon
+        SetTitleBarIcon
+
+    AppWindowTitleBar
+        PreferredTheme
+
+    OverlappedPresenter
+        PreferredMaximumSize
+        PreferredMinimumSize
+        SetPreferredBounds
+
+    PlacementPersistenceBehaviorFlags
+    TitleBarTheme
+```
+```
+Microsoft.Windows.AI.ContentModeration
+
+    ContentFilterOptions
+    ContentFilterOptionsContract
+    ImageContentFilterSeverity
+    SeverityLevel
+    TextContentFilterSeverity
+```
+```
+Microsoft.Windows.AI.Generative
+
+    ImageDescriptionContract
+    ImageDescriptionGenerator
+    ImageDescriptionScenario
+    LanguageModel
+    LanguageModelContext
+    LanguageModelContract
+    LanguageModelOptions
+    LanguageModelResponse
+    LanguageModelResponseStatus
+    LanguageModelSkill
+```
+```
+Microsoft.Windows.SemanticSearch
+
+    EmbeddingVector
+    SemanticSearchContract
+```
+```
+Microsoft.Windows.Vision
+
+    BoundingBox
+    DetectedLineStyle
+    OrientationDetectionOptions
+    RecognizedLine
+    RecognizedLineStyle
+    RecognizedText
+    RecognizedWord
+    TextRecognitionContract
+    TextRecognizer
+    TextRecognizerOptions
+```
+```
+Microsoft.Windows.Workloads
+
+    WorkloadPriority
+    WorkloadsContract
+```
+
 ## Version 1.7 Experimental (1.7.0-experimental2)
 ### Background Task Registration
 
diff --git a/hub/apps/windows-app-sdk/release-channels.md b/hub/apps/windows-app-sdk/release-channels.md
@@ -18,7 +18,7 @@ The latest version of the Windows App SDK ships via three release channels: Expe
 |---------|---------------------------------------------------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------|------------------------------------------------------------------------------------|------------|-----------------------------------------------------------------------------------------------------|
 | **✅**   | Stable ([release notes](stable-channel.md))             | This channel is supported for use by apps in production environments. It includes only stable APIs.                                                                        | No more frequent than every six months<br>(+ servicing)                                   | Yes        | [1.6.4 (1.6.250108002)](stable-channel.md#version-164-16250108002) (01/15/2025)                                                 |
 | **❇️**  | Preview ([release notes](preview-channel.md))           | This channel provides a preview of the next stable release. There may be breaking API changes between a given preview channel release and the next stable release.         | At least one preview per stable version                                           | No         | [1.6.0-preview2](preview-channel.md#version-16-preview-2-160-preview2) (08/22/2024)                 |
-| **🔄️** | Experimental ([release notes](experimental-channel.md)) | This channel includes experimental features that are in early stages of development. Experimental features may be removed from the next release, or may never be released. | As needed when requiring feedback for features in early design or prototype stages | No         | [1.7.0-experimental2](experimental-channel.md#version-17-experimental-170-experimental2) (01/09/2025) |
+| **🔄️** | Experimental ([release notes](experimental-channel.md)) | This channel includes experimental features that are in early stages of development. Experimental features may be removed from the next release, or may never be released. | As needed when requiring feedback for features in early design or prototype stages | No         | [1.7.0-experimental3](experimental-channel.md#version-17-experimental-170-experimental3) (02/06/2025) |
 
 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).
 
