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
* Updating release notes and downloads for 1.4 experimental
* Minor wording revisions
* Release notes for 1.3.2
* Adding first release notes for 1.4-preview1
* Release notes for 1.3.3
* Fixing broken bookmark links
* Updating 1.4-preview1 rel notes
* Removing en-us from link
* Adding release notes and downloads for 1.4-preview2
* Fixing bookmark
* Tweaking wording for XAML Islands section
* Minor wording tweaks
* Clarifying wording for custom titlebar scenarios
* Update preview-channel.md (#3728)
minor revs
* Adding release notes and downloads for WASDK 1.4.0 stable
* Updating wording for ItemsView section
* Removing comment referring to preview release
* Removing duplicate reference to Popup/FlyoutBase.ShouldConstrainToRootBounds
* Adding further detail to the .NET8 RID breaking change note
* Fixing punctuation in formatting
* Updating wording for .NET 8 recommended steps
* Adding rel notes for 1.4.1
* Fixing typo
* Adding rel note for custom titlebar updates in 1.4.0
* Fixing typo
* Adding rel notes for 1.4.2
* Adding link to source for 1.4.1 and 1.4.2
* Merging main
* Moving source links to version column instead of the runtime downloads column
* Adding rel notes for 1.4.3
* Adding release notes for 1.5-experimental1
* Adding note for new non-experimental APIs included in 1.5-experimental1
* Adding link to source for 1.5-exp1
* Adding link to source for 1.5-exp1
* Adding release notes for 1.4.4
* Fixing formatting
* Fixing release date for 1.4.4
* Adding release notes for 1.5-exp2
* Fixing typo from 1 to 2
* Adding initial release notes for 1.5-preview1
* Typo fix and date changes
---------
Co-authored-by: KB <[email protected]>
Co-authored-by: Karl-Bridge-Microsoft <[email protected]>
Copy file name to clipboardExpand all lines: hub/apps/windows-app-sdk/preview-channel.md
+213Lines changed: 213 additions & 0 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -19,6 +19,219 @@ The preview channel provides a preview of the next upcoming stable release. Ther
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 preview releases, see [Install tools for preview and experimental channels of the Windows App SDK](preview-experimental-install.md).
21
21
22
+
## Version 1.5 Preview 1 (1.5.0-preview1)
23
+
24
+
This is the latest release of the preview channel for version 1.5.
25
+
26
+
In an existing Windows App SDK 1.4 (from the stable channel) app, you can update your Nuget package to 1.5.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)).
27
+
28
+
For the updated runtime and MSIX, see [Downloads for the Windows App SDK](./downloads.md).
29
+
30
+
### XAML Islands runtime and shutdown updates
31
+
32
+
- There is a behavioral difference between WinAppSDK 1.4 and WinAppSDK 1.5 for Xaml Islands-based apps when the last Xaml Window on any thread is closed.
33
+
- In WinAppSDK 1.4, the Xaml runtime always exits the thread's event loop when the last Xaml window on a thread is closed.
34
+
- In WinAppSDK 1.5:
35
+
- If your app is a WinUI Desktop app, the default behavior is still the same as in WinAppSDK 1.4.
36
+
- If you're using Xaml for the DesktopWindowXamlSource ("Xaml Islands") API, the default behavior is now that Xaml does not automatically exit the thread's event loop.
37
+
- In both modes, you can change this behavior by setting the `Application.DispatcherShutdownMode` property.
38
+
- For more information, see the documentation for the `Application.DispatcherShutdownMode` property when available.
39
+
- There is a behavioral difference between WinAppSDK 1.4 and WinAppSDK 1.5 for Xaml Islands-based apps in the lifetime of the Xaml runtime:
40
+
- In WinAppSDK 1.4, the Xaml runtime shuts down on a thread if either all `WindowsXamlManager` and `DesktopWindowXamlSource` objects on a given thread are closed or shut down, or the `DispatcherQueue` running on that thread is shut down (the Xaml runtime shuts down during the `DispatcherQueue.FrameworkShutdownStarting` stage).
41
+
- In WinAppSDK 1.5, the Xaml runtime shuts down on a thread only when the DispatcherQueue running on that thread is shut down (the Xaml runtime shuts down during the `DispatcherQueue.FrameworkShutdownStarting` stage).
42
+
- For more information, see the documentation for the `WindowsXamlManager` class when available.
43
+
44
+
### WinUI Maps control
45
+
46
+
The initial release of the WinUI `Maps` control is now available! This control is powered by WebView2 and Azure Maps, providing the following features:
47
+
48
+
- Panning and zooming with either the map buttons or touch.
49
+
- Changing the style of the map to satellite, terrain, or street view.
50
+
- Programatically adding interactable pins with developer-customizable icons to the map.
51
+
- Developer customization for where the map is centered on initial load.
52
+
- Control for developers over hiding or showing the buttons for panning, zooming, and map styles.
53
+
54
+
> [!NOTE]
55
+
> To use the `Maps` control, you'll need an Azure Maps key. To create the key, see the [Azure Maps documentation page for creating a web app](/azure/azure-maps/quick-demo-map-app#get-the-subscription-key-for-your-account).
56
+
57
+
The `Maps` control is entirely new and we welcome your feedback to evaluate its future direction!
58
+
59
+
### Other new features from across the WinAppSDK
60
+
61
+
- Added support for the PublishSingleFile deployment model. For more info about PublishSingleFile, see the [Single-file deployment documentation](/dotnet/core/deploying/single-file/overview).
62
+
63
+
### Bug fixes
64
+
65
+
- Fixed an issue from the 1.5-experimental2 release where the projection DLL was not generated. For more info, see GitHub issue [#4152](https://github.com/microsoft/WindowsAppSDK/issues/4152).
66
+
- Fixed an issue where the ellipsis button on the text formatting popup of the `RichEditBox` was not displaying the list of actions properly. For more info, see GitHub issue [#9140](https://github.com/microsoft/microsoft-ui-xaml/issues/9140).
67
+
- Fixed an issue where `ListView` didn't handle keyboard accelerators properly. For more info, see GitHub issue [#8063](https://github.com/microsoft/microsoft-ui-xaml/issues/8063).
68
+
- Fixed an access violation issue with using `AccessKey` to close a window. For more info, see GitHub issue [#8648](https://github.com/microsoft/microsoft-ui-xaml/issues/8648).
69
+
- Fixed an issue affecting text alignment in a `MenuFlyoutItem` within a `MenuBar`. For more info, see GitHub issue [#8755](https://github.com/microsoft/microsoft-ui-xaml/issues/8755).
70
+
- Fixed an issue where highlighted text would not remain highlighted upon right-click. For more info, see GitHub issue [#1801](https://github.com/microsoft/microsoft-ui-xaml/issues/1801).
71
+
- Fixed an issue causing inactive windows to crash the app when closed. For more info, see GitHub issue [#8913](https://github.com/microsoft/microsoft-ui-xaml/issues/8913).
72
+
- Fixed an issue that could hang applications when scrolling with the middle mouse button and left-clicking immediately afterwards. For more info, see GitHub issue [#9233](https://github.com/microsoft/microsoft-ui-xaml/issues/9233).
73
+
- Fixed an issue where teaching tips did not receive proper focus. For more info, see GitHub issue [#3257](https://github.com/microsoft/microsoft-ui-xaml/issues/3257).
74
+
- Fixed an issue that crashed the application when setting the `TailVibility` of a `TeachingTip` to *Collapsed* on startup. For more info, see GitHub issue [#8731](https://github.com/microsoft/microsoft-ui-xaml/issues/8731).
75
+
76
+
### New APIs in 1.5.0-preview1
77
+
78
+
Version 1.5-preview1 includes the following new APIs compared to the stable 1.4 release:
79
+
80
+
```C#
81
+
Microsoft.Graphics.DirectX
82
+
83
+
DirectXPixelFormat
84
+
A4B4G4R4
85
+
```
86
+
87
+
```C#
88
+
Microsoft.UI.Input
89
+
90
+
FocusNavigationReason
91
+
FocusNavigationRequest
92
+
FocusNavigationRequestEventArgs
93
+
FocusNavigationResult
94
+
InputFocusController
95
+
DepartFocus
96
+
NavigateFocusRequested
97
+
98
+
InputFocusNavigationHost
99
+
```
100
+
101
+
```C#
102
+
Microsoft.UI.Xaml
103
+
104
+
Application
105
+
DispatcherShutdownMode
106
+
107
+
DebugSettings
108
+
LayoutCycleDebugBreakLevel
109
+
LayoutCycleTracingLevel
110
+
111
+
DispatcherShutdownMode
112
+
LayoutCycleDebugBreakLevel
113
+
LayoutCycleTracingLevel
114
+
```
115
+
116
+
```C#
117
+
Microsoft.UI.Xaml.Controls
118
+
119
+
MapControl
120
+
MapControlMapServiceErrorOccurredEventArgs
121
+
MapElement
122
+
MapElementClickEventArgs
123
+
MapElementsLayer
124
+
MapIcon
125
+
MapLayer
126
+
SelectorBar
127
+
SelectorBarItem
128
+
SelectorBarSelectionChangedEventArgs
129
+
WebView2
130
+
EnsureCoreWebView2Async
131
+
EnsureCoreWebView2Async
132
+
```
133
+
134
+
```C#
135
+
Microsoft.UI.Xaml.Hosting
136
+
137
+
WindowsXamlManager
138
+
GetForCurrentThread
139
+
XamlShutdownCompletedOnThread
140
+
141
+
XamlShutdownCompletedOnThreadEventArgs
142
+
```
143
+
144
+
```C#
145
+
Microsoft.Web.WebView2.Core
146
+
147
+
CoreWebView2
148
+
FrameId
149
+
150
+
CoreWebView2AcceleratorKeyPressedEventArgs
151
+
IsBrowserAcceleratorKeyEnabled
152
+
153
+
CoreWebView2BrowserExtension
154
+
CoreWebView2BrowsingDataKinds
155
+
ServiceWorkers
156
+
157
+
CoreWebView2CustomSchemeRegistration
158
+
CoreWebView2CustomSchemeRegistration (String)
159
+
AllowedOrigins
160
+
SchemeName
161
+
162
+
CoreWebView2Environment
163
+
GetProcessExtendedInfosAsync
164
+
165
+
CoreWebView2EnvironmentOptions
166
+
AreBrowserExtensionsEnabled
167
+
CustomSchemeRegistrations
168
+
169
+
CoreWebView2Frame
170
+
FrameId
171
+
172
+
CoreWebView2FrameInfo
173
+
FrameId
174
+
FrameKind
175
+
ParentFrameInfo
176
+
177
+
CoreWebView2FrameKind
178
+
CoreWebView2MouseEventKind
179
+
NonClientRightButtonDown
180
+
NonClientRightButtonUp
181
+
182
+
CoreWebView2NavigationKind
183
+
CoreWebView2NavigationStartingEventArgs
184
+
NavigationKind
185
+
186
+
CoreWebView2NewWindowRequestedEventArgs
187
+
OriginalSourceFrameInfo
188
+
189
+
CoreWebView2ProcessExtendedInfo
190
+
CoreWebView2Profile
191
+
AddBrowserExtensionAsync
192
+
Delete
193
+
Deleted
194
+
```
195
+
196
+
```C#
197
+
Microsoft.Windows.Management.Deployment
198
+
199
+
AddPackageOptions
200
+
EnsureReadyOptions
201
+
PackageDeploymentContract
202
+
PackageDeploymentManager
203
+
PackageDeploymentProgress
204
+
PackageDeploymentProgressStatus
205
+
PackageDeploymentResult
206
+
PackageDeploymentStatus
207
+
PackageRuntimeManager
208
+
PackageSet
209
+
PackageSetItem
210
+
PackageSetItemRuntimeDisposition
211
+
PackageSetRuntimeDisposition
212
+
PackageVolume
213
+
ProvisionPackageOptions
214
+
RegisterPackageOptions
215
+
RemovePackageOptions
216
+
StagePackageOptions
217
+
StubPackageOption
218
+
```
219
+
220
+
```C#
221
+
Microsoft.Windows.Widgets.Feeds.Providers
222
+
223
+
CustomQueryParametersRequestedArgs
224
+
CustomQueryParametersUpdateOptions
225
+
FeedDisabledArgs
226
+
FeedEnabledArgs
227
+
FeedManager
228
+
FeedProviderDisabledArgs
229
+
FeedProviderEnabledArgs
230
+
FeedProviderInfo
231
+
IFeedManager
232
+
IFeedProvider
233
+
```
234
+
22
235
## Version 1.4 Preview 2 (1.4.0-preview2)
23
236
24
237
This is the latest release of the preview channel for version 1.4.
|**✅**| 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.4.4 (1.4.231219000)](stable-channel.md#version-144-14231219000) (01/09/2024) |
19
-
|**❇️**| 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.4.0-preview2](preview-channel.md#version-14-preview-2-140-preview2) (08/15/2023) |
19
+
|**❇️**| 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.5.0-preview1](preview-channel.md#version-15-preview-1-150-preview1) (02/06/2024) |
20
20
|**🔄️**| 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.5.0-experimental2](experimental-channel.md#version-15-experimental-150-experimental2) (01/25/2024) |
0 commit comments