You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: hub/apps/windows-app-sdk/experimental-channel.md
+147Lines changed: 147 additions & 0 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -19,6 +19,150 @@ The experimental channel includes releases of the Windows App SDK with [experime
19
19
- If you'd like to upgrade an existing app from an older version of the Windows App SDK to a newer version, see [Update existing projects to the latest release of the Windows App SDK](update-existing-projects-to-the-latest-release.md).
20
20
- For documentation on experimental releases, see [Install tools for preview and experimental channels of the Windows App SDK](preview-experimental-install.md).
21
21
22
+
## Version 2.0 Experimental (2.0.0-Experimental2)
23
+
24
+
> [!IMPORTANT]
25
+
> If you previously installed Windows App SDK 2.0 Experimental 1, follow the [NuGet Uninstall](/nuget/consume-packages/install-use-packages-visual-studio#uninstall-a-package) guide to remove the `Microsoft.WindowsAppSDK` NuGet Metapackage with version `2.0.250930001-experimental1` from your project and the associated WinAppSDK component packages from that release before trying this new version, since the previously released Experimental package has a higher version number than the current one.
26
+
27
+
28
+
#### App Content Search
29
+
30
+
The AppContentIndexer APIs empower developers to efficiently index app content, including text and images for rapid and relevant retrieval. Supporting both lexical (keyword-based) and semantic (meaning-based) searches, these APIs allow apps to deliver fast, relevant results based on user intent and context rather than just exact keywords.
31
+
32
+
This capability unlocks the following advanced scenarios:
33
+
34
+
-**Semantic Search**
35
+
Apps can return results based on intent and meaning rather than exact keyword matches.
36
+
*Example:* A query for **“project timeline”** can surface content that mentions **“schedule”** or **“delivery dates,”** even if those exact words weren’t used.
37
+
-**Retrieval-Augmented Generation (RAG)**
38
+
Indexed content can serve as a knowledge base for generative AI models. When a user asks a question, the app retrieves the most relevant documents or snippets from its index and feeds them into the model, enabling accurate, context-aware responses grounded in real data.
39
+
40
+
#### Windows ML Model Catalog
41
+
42
+
The Windows ML Model Catalog APIs enable your app or library to dynamically discover and download large AI model files from your own online model catalogs, eliminating the need to package these large files directly with your app or library. The model catalog helps ensure device compatibility by filtering models and downloading only those applicable for the specific Windows device in use.
43
+
44
+
#### Persistent File and Folder Locations
45
+
The latest `Microsoft.Windows.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.
46
+
47
+
#### Relative Popup Positioning
48
+
49
+
The `PopupAnchor` API now allows `DesktopPopupSiteBridge` to support relative positioning by anchoring to its owning window or island, addressing the limitation where popups could only be positioned absolutely using screen coordinates.
50
+
51
+
#### Input Routing for SystemVisual ContentIslands
52
+
53
+
The `InputUnderlyingWindowController` API enables developers to designate the target HWND for receiving input messages that were originally sent to a ContentIsland created from a SystemVisual (see [ContentIsland.CreateForSystemVisual](/windows/windows-app-sdk/api/winrt/microsoft.ui.content.contentisland.createforsystemvisual)).
54
+
55
+
#### Flexible System Backdrop Placement
56
+
57
+
`SystemBackdropHost` enables placing a system backdrop (acrylic/mica) anywhere within an application's visual tree.
58
+
59
+
#### XAML Layout Sequential Positioning
60
+
61
+
The `WrapPanel` is a WinUI XAML layout panel that arranges child elements in a sequential position from left to right, items overflowing the line will break to the next line automatically at the end of the containing panel. It is useful for responsive layouts.
62
+
63
+
This is a port of the existing [Windows Community Toolkit control](/dotnet/communitytoolkit/windows/primitives/wrappanel).
64
+
65
+
### New APIs for 2.0-experimental2
66
+
67
+
This release includes the following new and modified experimental APIs compared to 2.0-experimental1:
-`AppContentIndexer` APIs should be called from a background thread. Using it in the UI thread may hang or cause long pauses impacting the user experience.
161
+
- Query results using `AppIndexQuery.GetNextTextMatches` and `AppIndexQuery.GetNextImageMatches` will be null when there are no matches instead of an empty list.
162
+
- Image matches using `AppManagedImageQueryMatch.Subregion` based on OCR values may occasionally be inaccurate, particularly when the text is rotated or skewed.
163
+
- Image matches using `AppManagedImageQueryMatch.Subregion` may sometimes include zero-size or extremely small rectangles, leading to inaccurate results.
164
+
- An Empty query from `AppContentIndex.CreateQuery` can throw an exception.
165
+
22
166
## Version 2.0 Experimental (2.0.0-Experimental1)
23
167
24
168
### Use on-device AI with Windows AI APIs
@@ -365,3 +509,6 @@ Microsoft.Windows.Vision
365
509
-[Create your first WinUI 3 project](../winui/winui3/create-your-first-winui3-app.md)
366
510
-[Use the Windows App SDK in an existing project](use-windows-app-sdk-in-existing-project.md)
367
511
-[Deploy apps that use the Windows App SDK](../package-and-deploy/index.md#use-the-windows-app-sdk)
|**✅**| 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.8.2 (1.8.251003001)](stable-channel.md#version-182-18251003001) (10/14/2025) |
20
20
|**❇️**| 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 |[Version 1.8 Preview (1.8-preview)](preview-channel.md#version-18-preview-18-preview) (08/19/2025) |
21
-
|**🔄️**| 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 |[2.0.0-experimental1](experimental-channel.md#version-20-experimental-200-experimental1) (10/02/2025) |
21
+
|**🔄️**| 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 |[2.0.0-experimental2](experimental-channel.md#version-20-experimental-200-experimental2) (11/05/2025) |
22
22
23
23
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).
0 commit comments