Skip to content

Commit ef7d47f

Browse files
RDMacLachlanKarl-Bridge-Microsoft
RDMacLachlan
and
Karl-Bridge-Microsoft
authored
WinAppSDK 1.8 Preview 1 - Release Notes (#5698)
* WinAppSDK 1.8 Preview 1 - Release Notes WinAppSDK 1.8 Preview 1 - Release Notes * Update preview-channel.md * Update preview-channel-1.7.md * Update preview-channel-1.7.md * rename * Updates * Update preview-channel.md * Update release-channels.md * Update downloads.md --------- Co-authored-by: KB <[email protected]>
1 parent 3856e78 commit ef7d47f

File tree

4 files changed

+270
-113
lines changed

4 files changed

+270
-113
lines changed

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

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,7 @@
22
title: Latest Windows App SDK downloads
33
description: This page provides links to the latest downloads of the Windows App SDK (WASDK) for all three release channels (stable, preview, and experimental).
44
ms.topic: article
5-
ms.date: 08/12/2025
5+
ms.date: 08/19/2025
66
keywords: windows, winrt, win32, windows app development, Windows App SDK
77
ms.localizationpriority: medium
88
---
@@ -37,7 +37,7 @@ This page provides links to the *latest* downloads of the [Windows App SDK](inde
3737

3838
| Version | Runtime downloads |
3939
| ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
40-
| [1.7 Preview1 (1.7.250208002-preview1) ](/windows/apps/windows-app-sdk/preview-channel#version-17-preview-1-170-preview1) <br/> 02/11/2025 <br/> [Release notes](/windows/apps/windows-app-sdk/preview-channel#version-17-preview-1-170-preview1) <br/> [Source](https://github.com/microsoft/microsoft-ui-xaml/releases/tag/winui3%2Frelease%2F1.7-preview1) | [Installer (x64)](https://aka.ms/windowsappsdk/1.7/1.7.250208002-preview1/windowsappruntimeinstall-x64.exe) <br/> [Installer (x86)](https://aka.ms/windowsappsdk/1.7/1.7.250208002-preview1/windowsappruntimeinstall-x86.exe) <br/> [Installer (arm64)](https://aka.ms/windowsappsdk/1.7/1.7.250208002-preview1/windowsappruntimeinstall-arm64.exe) <br/> [Redistributable](https://aka.ms/windowsappsdk/1.7/1.7.250208002-preview1/Microsoft.WindowsAppRuntime.Redist.1.7.zip) |
40+
| [1.8 Preview1 (1.8.250814004-preview1) ](/windows/apps/windows-app-sdk/preview-channel#version-18-preview-1-180-preview1) <br/> 08/19/2025 <br/> [Release notes](/windows/apps/windows-app-sdk/preview-channel#version-18-preview-1-180-preview1) <br/> [Source](https://github.com/microsoft/microsoft-ui-xaml/releases/tag/winui3%2Frelease%2F1.8-preview1) | [Installer (x64)](https://aka.ms/windowsappsdk/1.8/1.8.250814004-preview1/windowsappruntimeinstall-x64.exe) <br/> [Installer (x86)](https://aka.ms/windowsappsdk/1.8/1.8.250814004-preview1/windowsappruntimeinstall-x86.exe) <br/> [Installer (arm64)](https://aka.ms/windowsappsdk/1.8/1.8.250814004-preview1/windowsappruntimeinstall-arm64.exe) <br/> [Redistributable](https://aka.ms/windowsappsdk/1.8/1.8.250814004-preview1/Microsoft.WindowsAppRuntime.Redist.1.8.zip) |
4141

4242
> [!NOTE]
4343
> For older releases, see the [Archive of Windows App SDK downloads](downloads-archive.md).

‎hub/apps/windows-app-sdk/preview-channel.md‎

Lines changed: 88 additions & 109 deletions
Original file line numberDiff line numberDiff line change
@@ -1,8 +1,8 @@
11
---
22
title: Preview release channel for the Windows App SDK
33
description: Provides info about the preview release channel for the Windows App SDK.
4-
ms.topic: release-notes
5-
ms.date: 07/14/2025
4+
ms.topic: article
5+
ms.date: 08/19/2025
66
keywords: windows win32, windows app development, Windows App SDK
77
ms.localizationpriority: medium
88
---
@@ -19,161 +19,140 @@ The preview channel includes releases of the Windows App SDK with [preview chann
1919
- 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).
2020
- For documentation on preview releases, see [Install tools for preview and experimental channels of the Windows App SDK](preview-experimental-install.md).
2121

22-
## Version 1.7 Preview 1 (1.7-preview1)
22+
## Version 1.8 Preview 1 (1.8-preview1)
2323

24-
This is the latest release of the preview channel for version 1.7.
24+
This is the latest release of the preview channel for version 1.8.
2525

26-
In an existing Windows App SDK 1.6 (from the stable channel) app, you can update your Nuget package to 1.7.0-preview1 (see the **Update a package** section in [Install and manage packages in Visual Studio using the NuGet Package Manager](/nuget/consume-packages/install-use-packages-visual-studio#update-a-package)).
26+
In an existing Windows App SDK 1.7 (from the stable channel) app, you can update your Nuget package to 1.8.0-preview (see the **Update a package** section in [Install and manage packages in Visual Studio using the NuGet Package Manager](/nuget/consume-packages/install-use-packages-visual-studio#update-a-package)).
2727

2828
For the updated runtime and MSIX, see [Downloads for the Windows App SDK](./downloads.md).
2929

3030
### New features
31-
32-
#### New Badge Notifications Feature
33-
34-
New badge notification support allows showing a number or glyph badge on your app in the taskbar. For more info, see GitHub [#4926](https://github.com/microsoft/WindowsAppSDK/issues/4926).
35-
36-
#### New CameraCaptureUI API
37-
38-
A new CameraCaptureUI API makes it easier to capture photos and videos in your Windows App SDK app. For more info, see GitHub issue [#4721](https://github.com/microsoft/WindowsAppSDK/issues/4721).
39-
40-
#### New Authentication API
41-
42-
A new `OAuth2Manager` API provides a streamlined solution for web authentication, offering OAuth 2.0 capabilities with full feature parity across all Windows platforms supported by Windows App SDK. For more info, see GitHub issue [#4772](https://github.com/microsoft/WindowsAppSDK/issues/4772).
43-
44-
#### New Background Task support
45-
46-
A new `BackgroundTaskBuilder` API enables registering background tasks for Windows App SDK apps. For more info, see GitHub [#4831](https://github.com/microsoft/WindowsAppSDK/issues/4831).
4731

48-
#### New TitleBar control
49-
50-
A new `TitleBar` control makes it much easier to create a great, customizable titlebar for your app. Configure properties such as the titlebar icon, Title, and Subtitle, include an integrated back button, or even add a custom control like a search box! The control includes robust titlebar capabilities like empty-space draggable regions, theme responsiveness, caption buttons, and built-in accessibility support so you can focus on your personalized design and still get the same reliable titlebar as the default experience. For more info, see GitHub [#10056](https://github.com/microsoft/microsoft-ui-xaml/issues/10056).
51-
52-
#### Support for MathML
53-
54-
`RichEditBox` now supports MathML, via `RichEditTextDocument.SetMathMode` and `RichEditTextDocument.SetMathML`. For more info, see GitHub [#4196](https://github.com/microsoft/microsoft-ui-xaml/issues/4196).
32+
#### Prompt Size Limit Reporting
33+
34+
Allows applications to determine if an input exceeds the allowable size for a Text Summarizer call. If the input is too large, the API returns an index indicating the current limit, enabling developers to adjust the input accordingly. This limit is based on token count rather than byte or character length, and it can vary over time due to multiple factors. Therefore, applications should treat the limit as dynamic and subject to change.
35+
36+
#### Text Rewriter Tone
37+
38+
Enables text rewriting with specific tones. The Casual option rephrases content to sound more informal and conversational, using natural, spontaneous phrasing while preserving meaning and format. The Formal option transforms text into a polished, professional version, maintaining the original structure and details with precise language suitable for formal context. The General option retains the original tone and intent, ensuring the meaning remains unchanged.
39+
40+
#### Conversation Summary Options
41+
42+
Enables developers to specify the desired output language for conversation summarization. This allows applications to generate summaries in a targeted language, enhancing localization, and user experience.
5543

5644
#### Other notable changes
5745

58-
* New `RuntimeCompatibilityOptions` support will allow more control over how servicing changes affect apps. For more info, see GitHub [#4966](https://github.com/microsoft/WindowsAppSDK/issues/4966).
59-
* A new `ReleaseInfo` API provides easy access to the version of the Windows App SDK Runtime in use. For more info, see GitHub [#2893](https://github.com/microsoft/WindowsAppSDK/issues/2893).
60-
* Note: Windows AI APIs are not included this release. To experiment with these APIs, please continue to use the 1.7-experimental3 release and share your feedback!
61-
* Note: New APIs for windowing on `AppWindow` are not included in this release. To experiment with these APIs, please continue to use the 1.7-experimental3 release and share your feedback!
46+
* Prior to WinAppSDK 1.8, packaged apps running in the AppContainer did not require the packageManagement capability, due to a DeploymentManager auto-initialization issue. That issue has now been resolved, and in turn, the packageManagement capability is now required for AppContainer-based apps.
6247

6348
### New APIs
6449

65-
This release includes the following new APIs compared to the stable 1.6 release:
50+
This release includes the following new APIs compared to the stable 1.7 release:
6651

6752
```
68-
Microsoft.Security.Authentication.OAuth
69-
70-
AuthFailure
71-
AuthRequestParams
72-
AuthRequestResult
73-
AuthResponse
74-
ClientAuthentication
75-
CodeChallengeMethodKind
76-
OAuth2Manager
77-
OAuthContract
78-
TokenFailure
79-
TokenFailureKind
80-
TokenRequestParams
81-
TokenRequestResult
82-
TokenResponse
83-
```
84-
```
85-
Microsoft.UI.Text
53+
Microsoft.Windows.AI.Foundation
8654
87-
RichEditTextDocument
88-
GetMathML
89-
GetMathMode
90-
SetMathML
91-
SetMathMode
92-
93-
TextApiContract
55+
AIFoundationContract
56+
EmbeddingVector
9457
```
9558
```
96-
Microsoft.UI.Xaml
59+
Microsoft.Windows.AI.Imaging
9760
98-
XamlIsland
99-
XamlRoot
100-
ContentIsland
61+
ImageObjectRemover
62+
ImageObjectRemoverContract
10163
```
10264
```
103-
Microsoft.UI.Xaml.Controls
65+
Microsoft.Windows.AI.Text
10466
105-
TitleBar
106-
TitleBarAutomationPeer
107-
TitleBarTemplateSettings
108-
```
109-
```
110-
Microsoft.Windows.ApplicationModel.Background
67+
ConversationItem
68+
ConversationSummaryOptions
69+
InputKind
70+
LanguageModel
71+
CreateContext
72+
CreateContext
73+
CreateContext
74+
GenerateEmbeddingVectors
75+
GenerateEmbeddingVectors
76+
GenerateResponseAsync
77+
GenerateResponseAsync
78+
GenerateResponseAsync
79+
GenerateResponseFromEmbeddingsAsync
80+
GenerateResponseFromEmbeddingsAsync
81+
GenerateResponseFromEmbeddingsAsync
82+
GetUsablePromptLength
83+
GetUsablePromptLength
84+
GetVectorSpaceId
85+
86+
LanguageModelEmbeddingVectorResult
87+
TextRewriter
88+
RewriteAsync
11189
112-
BackgroundTaskBuilder
113-
BackgroundTaskContract
90+
TextRewriteTone
91+
TextSummarizer
92+
IsPromptLargerThanContext
93+
IsPromptLargerThanContext
94+
SummarizeConversationAsync
11495
```
11596
```
11697
Microsoft.Windows.ApplicationModel.Background.UniversalBGTask
11798
11899
Task
119-
UniversalBackgroundTaskContract
100+
Run
120101
```
121102
```
122-
Microsoft.Windows.ApplicationModel.WindowsAppRuntime
123-
124-
ReleaseInfo
125-
RuntimeCompatibilityChange
126-
RuntimeCompatibilityContract
127-
RuntimeCompatibilityOptions
128-
RuntimeInfo
129-
VersionInfoContract
130-
WindowsAppRuntimeVersion
103+
Microsoft.Windows.Storage.Pickers
104+
105+
FileOpenPicker
106+
FileSavePicker
107+
FolderPicker
108+
PickerLocationId
109+
PickerViewMode
110+
PickFileResult
111+
PickFolderResult
112+
StoragePickersContract
131113
```
132114
```
133-
Microsoft.Windows.BadgeNotifications
115+
Microsoft.Windows.Widgets.Feeds.Providers
134116
135-
BadgeNotificationGlyph
136-
BadgeNotificationManager
137-
BadgeNotificationsContract
117+
FeedManager
118+
TryRemoveAnnouncementById
119+
120+
IFeedManager3
138121
```
122+
123+
### New APIs compared to 1.8-exp4
139124
```
140-
Microsoft.Windows.Media.Capture
141-
142-
CameraCaptureUI
143-
CameraCaptureUIContract
144-
CameraCaptureUIMaxPhotoResolution
145-
CameraCaptureUIMaxVideoResolution
146-
CameraCaptureUIMode
147-
CameraCaptureUIPhotoCaptureSettings
148-
CameraCaptureUIPhotoFormat
149-
CameraCaptureUIVideoCaptureSettings
150-
CameraCaptureUIVideoFormat
125+
Microsoft.Windows.AI.Text
126+
127+
TextSummarizer
128+
IsPromptLargerThanContext
129+
```
130+
```
131+
Microsoft.Windows.Storage.Pickers
132+
133+
FileSavePicker
134+
SuggestedFolder
135+
136+
StoragePickersContract
151137
```
152138

153139
### Bug fixes
154140

155141
This release includes the following bug fixes:
156142

157-
- Changed `SplitButton` so touch input now matches the behavior of mouse input. For more info, see GitHub issue [#178](https://github.com/microsoft/microsoft-ui-xaml/issues/178).
158-
- Changed cascading menus so sub menus now open immediately if clicked. For more info, see GitHub issue [#939](https://github.com/microsoft/microsoft-ui-xaml/issues/939).
159-
- Fixed an issue where opening a `ComboBox` which is in a flyout closes all flyouts. For more info, see GitHub issue [#1467](https://github.com/microsoft/microsoft-ui-xaml/issues/1467).
160-
- Fixed an issue where `SwipeControl` would randomly crash in a `ListView`. For more info, see GitHub issue [#2527](https://github.com/microsoft/microsoft-ui-xaml/issues/2527).
161-
- Fixed an issue where drag-and-drop only a `ListViewItem` would leave it in the wrong visual state. For more info, see GitHub issue [#3458](https://github.com/microsoft/microsoft-ui-xaml/issues/3458).
162-
- Fixed an issue in `StackLayout` so that it respects the ItemsRepeater.HorizontalAlignment and ItemsRepeater.VerticalAlignment properties (when StackLayout.Orientation is Vertical and Horizontal respectively). The old layout behaved as if the ItemsRepeater alignment was Stretch. With the fix, the layout results in items aligned to the right when the Right alignment is used, for example. For more info, see GitHub issue [#3842](https://github.com/microsoft/microsoft-ui-xaml/issues/3842).
163-
- Fixed an issue where deleting items in the `ItemsRepeater`'s source would not generate items which moved up into view. For more info, see GitHub issue [#6661](https://github.com/microsoft/microsoft-ui-xaml/issues/6661).
164-
- Fixed an issue where the right Alt key would not show keytips for Access Keys. For more info, see GitHub issue [#8447](https://github.com/microsoft/microsoft-ui-xaml/issues/8447). **Note:** This may result in key events for the right Alt key no longer being delivered to handles in the app or controls.
165-
- Fixed a crash where `UniformGridLayout` would sometimes pick a wrong layout anchor and cause infinite layout passes when scrolling backwards. For more info, see GitHub issue [#9199](https://github.com/microsoft/microsoft-ui-xaml/issues/9199).
166-
- Fixed an issue where setting `NavigationFailedEventArgs.Handled` to True would still throw an exception. For more info, see GitHub issue [#9632](https://github.com/microsoft/microsoft-ui-xaml/issues/9632).
167-
- Fixed an issue where `TabView` would not apply any specified `CornerRadius`. For more info, see GitHub issue [#9846](https://github.com/microsoft/microsoft-ui-xaml/issues/9846).
168-
- Fixed a potential layout cycle crash in `StackLayout`. For more info, see GitHub issue [#9852](https://github.com/microsoft/microsoft-ui-xaml/issues/9852).
169-
- Fixed a potential crash in `ItemsView` when removing items. For more info, see GitHub issue [#9868](https://github.com/microsoft/microsoft-ui-xaml/issues/9868).
143+
144+
145+
### Known Issues
146+
147+
* Standalone use of component packages (such as Microsoft.WindowsAppSDK.WinUI) will require an app-level package reference to the latest Microsoft.Windows.SDK.BuildTools.MSIX, to address an issue with some wapproj-based solutions breaking due to a "WinAppSdkExpandPriContent" task not found error. Referencing the full top-level Microsoft.WindowsAppSDK package (the common scenario) does not require this.
170148

171149
## Archive of preview channel release notes
172150

173151
<details>
174152

175153
<summary>Expand for links to archived preview channel release notes</summary>
176154

155+
- [Preview channel release notes for the Windows App SDK 1.7](release-notes-archive/preview-channel-1-7.md)
177156
- [Preview channel release notes for the Windows App SDK 1.6](release-notes-archive/preview-channel-1.6.md)
178157
- [Preview channel release notes for the Windows App SDK 1.5](release-notes-archive/preview-channel-1.5.md)
179158
- [Preview channel release notes for the Windows App SDK 1.4](release-notes-archive/preview-channel-1.4.md)

0 commit comments

Comments
 (0)