Redigera

Dela via

Latest preview channel release notes for the Windows App SDK

  • Artikel

Important

The preview channel is not supported for use in production environments, and apps that use the preview releases cannot be published to the Microsoft Store.

The preview channel includes releases of the Windows App SDK with preview channel features in late stages of development. Preview releases do not include experimental features and APIs but may still be subject to breaking changes before the next stable release.

Important links:

Preview channel release note archive:

Version 1.7 Preview 1 (1.7-preview1)

This is the latest release of the preview channel for version 1.7.

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).

For the updated runtime and MSIX, see Downloads for the Windows App SDK.

New features

New Badge Notifications Feature

New badge notification support allows showing a number or glyph badge on your app in the taskbar. For more info, see GitHub #4926.

New CameraCaptureUI API

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.

New Authentication API

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.

New Background Task support

A new BackgroundTaskBuilder API enables registering background tasks for Windows App SDK apps. For more info, see GitHub #4831.

New TitleBar control

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.

Support for MathML

RichEditBox now supports MathML, via RichEditTextDocument.SetMathMode and RichEditTextDocument.SetMathML. For more info, see GitHub #4196.

Other notable changes

  • New RuntimeCompatibilityOptions support will allow more control over how servicing changes affect apps. For more info, see GitHub #4966.
  • A new ReleaseInfo API provides easy access to the version of the Windows App SDK Runtime in use. For more info, see GitHub #2893.
  • Note: Windows Copilot Runtime APIs are not included this release. To experiment with these APIs, please continue to use the 1.7-experimental3 release and share your feedback!
  • 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!

New APIs

This release includes the following new APIs compared to the stable 1.6 release:

Microsoft.Security.Authentication.OAuth
 
    AuthFailure
    AuthRequestParams
    AuthRequestResult
    AuthResponse
    ClientAuthentication
    CodeChallengeMethodKind
    OAuth2Manager
    OAuthContract
    TokenFailure
    TokenFailureKind
    TokenRequestParams
    TokenRequestResult
    TokenResponse

Microsoft.UI.Text
 
    RichEditTextDocument
        GetMathML
        GetMathMode
        SetMathML
        SetMathMode
 
    TextApiContract

Microsoft.UI.Xaml
 
    XamlIsland
    XamlRoot
        ContentIsland

Microsoft.UI.Xaml.Controls
 
    TitleBar
    TitleBarAutomationPeer
    TitleBarTemplateSettings

Microsoft.Windows.ApplicationModel.Background
 
    BackgroundTaskBuilder
    BackgroundTaskContract

Microsoft.Windows.ApplicationModel.Background.UniversalBGTask
 
    Task
    UniversalBackgroundTaskContract

Microsoft.Windows.ApplicationModel.WindowsAppRuntime
 
    ReleaseInfo
    RuntimeCompatibilityChange
    RuntimeCompatibilityContract
    RuntimeCompatibilityOptions
    RuntimeInfo
    VersionInfoContract
    WindowsAppRuntimeVersion

Microsoft.Windows.BadgeNotifications
 
    BadgeNotificationGlyph
    BadgeNotificationManager
    BadgeNotificationsContract

Microsoft.Windows.Media.Capture
 
    CameraCaptureUI
    CameraCaptureUIContract
    CameraCaptureUIMaxPhotoResolution
    CameraCaptureUIMaxVideoResolution
    CameraCaptureUIMode
    CameraCaptureUIPhotoCaptureSettings
    CameraCaptureUIPhotoFormat
    CameraCaptureUIVideoCaptureSettings
    CameraCaptureUIVideoFormat

Bug fixes

This release includes the following bug fixes:

  • Changed SplitButton so touch input now matches the behavior of mouse input. For more info, see GitHub issue #178.
  • Changed cascading menus so sub menus now open immediately if clicked. For more info, see GitHub issue #939.
  • Fixed an issue where opening a ComboBox which is in a flyout closes all flyouts. For more info, see GitHub issue #1467.
  • Fixed an issue where SwipeControl would randomly crash in a ListView. For more info, see GitHub issue #2527.
  • 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.
  • 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.
  • 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.
  • Fixed an issue where the right Alt key would not show keytips for Access Keys. For more info, see GitHub issue #8447. Note: This may result in key events for the right Alt key no longer being delivered to handles in the app or controls.
  • 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.
  • Fixed an issue where setting NavigationFailedEventArgs.Handled to True would still throw an exception. For more info, see GitHub issue #9632.
  • Fixed an issue where TabView would not apply any specified CornerRadius. For more info, see GitHub issue #9846.
  • Fixed a potential layout cycle crash in StackLayout. For more info, see GitHub issue #9852.
  • Fixed a potential crash in ItemsView when removing items. For more info, see GitHub issue #9868.