Windows 应用 SDK 的最新试验通道发行说明

重要

不支持在生产环境中使用试验通道，并且无法将使用试验版本的应用发布到 Microsoft Store。

此试验通道包含 Windows 应用 SDK 的多个版本，其中附带了处于开发早期阶段的试验通道功能。 用于试验功能的 API 具有试验特性。 如果在代码中调用试验 API，会收到生成时警告。 试验通道中的所有 API 均可能出现大量修订和重大更改。 试验功能和 API 可随时从后续版本中删除。

重要链接：

• 如果要将现有应用从较旧版本的 Windows App SDK 升级到较新版本，请参阅将现有项目更新到 Windows App SDK 的最新版本。
• 有关试验版本的文档，请参阅安装 Windows App SDK 的预览和试验通道工具。

试验通道发行说明存档：

• Windows 应用 SDK 1.6 的实验频道发行说明
• Windows 应用 SDK 1.5 的实验频道发行说明
• Windows 应用 SDK 1.4 的试验通道发行说明
• Windows 应用 SDK 1.3 的试验通道发行说明
• Windows 应用 SDK 1.2 的试验通道发行说明
• Windows 应用 SDK 1.0 的试验通道发行说明
• Windows 应用 SDK 0.8 的试验通道发行说明

版本 1.7 实验版 （1.7.0-experimental1）

这是试验通道的最新版本。

若要下载，请将 WinAppSDK NuGet 版本重新定目标到 1.7.241114004-experimental1。

新的 CameraCaptureUI API

使用新的 CameraCaptureUI API，可以更轻松地在 WinAppSDK 应用中捕获照片和视频。 有关详细信息，请参阅 GitHub 问题 #4721。

新的身份验证 API

新的 OAuth2Manager API 为 Web 身份验证提供了简化的解决方案，为 OAuth 2.0 功能提供 WinAppSDK 支持的所有 Windows 平台的完整功能奇偶校验。 有关详细信息，请参阅 GitHub 问题 #4772。

新的后台任务支持

新的 BackgroundTaskBuilder API 为 WinAppSDK 应用提供后台任务注册的集成支持。 有关详细信息，请参阅 GitHub 问题 #4822。

适用于 1.7 实验性 1 的新 API

此版本包括以下新的和经过修改的实验 API：

Microsoft.Security.Authentication.OAuth

    AuthFailure
    AuthRequestParams
    AuthRequestResult
    AuthResponse
    ClientAuthentication
    CodeChallengeMethodKind
    OAuth2Manager
    OAuthContract
    TokenFailure
    TokenFailureKind
    TokenRequestParams
    TokenRequestResult
    TokenResponse

Microsoft.UI.Composition

    CompositionNotificationDeferral
    CompositionProjectedShadow
        MaxOpacity
        MinOpacity
        OpacityFalloff

    CompositionProjectedShadowCaster
        AncestorClip
        Mask

    CompositionProjectedShadowDrawOrder
    CompositionProjectedShadowReceiver
        DrawOrder
        Mask

Microsoft.UI.Composition.Experimental

    ExpCompositionVisualSurface
    ExpExpressionNotificationProperty
    IExpCompositionPropertyChanged
    IExpCompositionPropertyChangedListener
    IExpCompositor
    IExpVisual

Microsoft.UI.Content

    AutomationOptions
    ChildContentLink
    ContentAppWindowBridge
    ContentDisplayOrientations
    ContentEnvironmentStateChangedEventArgs
        DidDisplayScaleChange

    ContentExternalBackdropLink
    ContentExternalOutputLink
    ContentIsland
        Children
        Compositor
        Connected
        ConnectionInfo
        ConnectRemoteEndpoint
        Create
        Disconnected
        FindAllForCompositor
        FragmentRootAutomationProvider
        GetByVisual
        IsRemoteEndpointConnected
        NextSiblingAutomationProvider
        ParentAutomationProvider
        PreviousSiblingAutomationProvider
        Root
        TransformMatrix

    ContentIslandEnvironment
        AutomationOption
        CurrentOrientation
        DisplayScale
        NativeOrientation
        ThemeChanged

    ContentSite
        Compositor
        SetContentNodeParent
        SetIsInputPassThrough
        SiteVisual
        TransformMatrix
        TryGetAutomationProvider

    ContentSiteAutomationProviderRequestedEventArgs
    ContentSiteEnvironment
        CurrentOrientation
        DisplayScale
        NativeOrientation
        NotifyThemeChanged

    ContentSiteView
        TransformMatrix

    CoreWindowSiteBridge
    CoreWindowTopLevelWindowBridge
    DesktopChildSiteBridge
        AcceptRemoteEndpoint
        ConnectionInfo
        IsRemoteEndpointConnected
        RemoteEndpointConnecting
        RemoteEndpointDisconnected
        RemoteEndpointRequestedStateChanged

    DesktopSiteBridge
        TryCreatePopupSiteBridge

    EndpointConnectionEventArgs
    EndpointRequestedStateChangedEventArgs
    IContentIslandEndpointConnectionPrivate
    IContentLink
    IContentNodeOwner
    IContentSiteBridge2
    IContentSiteBridgeAutomation
    IContentSiteBridgeEndpointConnectionPrivate
    PopupWindowSiteBridge
    ProcessStarter
    ReadOnlyDesktopSiteBridge
    SystemVisualSiteBridge

Microsoft.UI.Input

    InputKeyboardSource
        GetForWindowId

    InputLayoutPolicy
    InputLightDismissAction
        GetForIsland

    InputPointerActivationBehavior
    InputPointerSource
        ActivationBehavior
        DirectManipulationHitTest
        GetForVisual
        GetForWindowId
        RemoveForVisual
        TouchHitTesting
        TrySetDeviceKinds

    ProximityEvaluation
    TouchHitTestingEventArgs

Microsoft.UI.Input.Experimental

    ExpInputSite
    ExpPointerPoint

Microsoft.UI.Windowing

    AppWindow
        DefaultTitleBarShouldMatchAppModeTheme

    DisplayArea
        GetMetricsFromWindowId

Microsoft.UI.Xaml

    XamlIsland
    XamlRoot
        TryGetContentIsland

Microsoft.UI.Xaml.Automation.Peers

    AutomationEvents
        Notification

    InkCanvasAutomationPeer
    PagerControlAutomationPeer

Microsoft.UI.Xaml.Controls

    ContentDialogPlacement
        UnconstrainedPopup

    DoInkPresenterWork
    ElementFactory
    FlowLayout
    FlowLayoutAnchorInfo
    FlowLayoutLineAlignment
    FlowLayoutState
    IApplicationViewSpanningRects
    IndexPath
    InkCanvas
    ISelfPlayingAnimatedVisual
    ItemContainer
        CanUserInvoke
        CanUserInvokeProperty
        CanUserSelect
        CanUserSelectProperty
        ItemInvoked
        MultiSelectMode
        MultiSelectModeProperty

    ItemContainerInteractionTrigger
    ItemContainerInvokedEventArgs
    ItemContainerMultiSelectMode
    ItemContainerUserInvokeMode
    ItemContainerUserSelectMode
    LayoutPanel
    NumberBox
        InputScope
        InputScopeProperty
        TextAlignment
        TextAlignmentProperty

    PagerControl
    PagerControlButtonVisibility
    PagerControlDisplayMode
    PagerControlSelectedIndexChangedEventArgs
    PagerControlTemplateSettings
    ProgressRing
        DeterminateSource
        DeterminateSourceProperty
        IndeterminateSource
        IndeterminateSourceProperty

    RecyclePool
    RecyclingElementFactory
    ScrollingScrollStartingEventArgs
    ScrollingZoomStartingEventArgs
    ScrollView
        ScrollStarting
        ZoomStarting

    SelectionModel
    SelectionModelChildrenRequestedEventArgs
    SelectionModelSelectionChangedEventArgs
    SelectTemplateEventArgs
    StackLayout
        IsVirtualizationEnabled
        IsVirtualizationEnabledProperty

    StackLayoutState
    TitleBar
    TitleBarAutomationPeer
    TitleBarTemplateSettings
    UniformGridLayoutState

Microsoft.UI.Xaml.Controls.Primitives

    ScrollPresenter
        ScrollStarting
        ZoomStarting

Microsoft.Windows.ApplicationModel.Background

    BackgroundTaskBuilder
    BackgroundTaskContract

Microsoft.Windows.ApplicationModel.Background.UniversalBGTask

    Task

Microsoft.Windows.ApplicationModel.WindowsAppRuntime

    DeploymentManager
        Repair

    DeploymentStatus
        PackageRepairFailed

    ReleaseInfo
    RuntimeInfo
    VersionInfoContract

Microsoft.Windows.Media.Capture

    CameraCaptureUI
    CameraCaptureUIContract
    CameraCaptureUIMaxPhotoResolution
    CameraCaptureUIMaxVideoResolution
    CameraCaptureUIMode
    CameraCaptureUIPhotoCaptureSettings
    CameraCaptureUIPhotoFormat
    CameraCaptureUIVideoCaptureSettings
    CameraCaptureUIVideoFormat

Microsoft.Windows.Storage

    ApplicationData
        GetForUnpackaged

Bug 修复

此版本中包含以下 bug 修复：

• 更改后 SplitButton ，触摸输入现在与鼠标输入的行为匹配。 有关详细信息，请参阅 GitHub 问题 #178。
• 更改了级联菜单，因此子菜单现在会立即打开（如果单击）。 有关详细信息，请参阅 GitHub 问题 #939。
• 修复了打开 ComboBox 浮出控件中某个控件会关闭所有浮出控件的问题。 有关详细信息，请参阅 GitHub 问题 #1467。
• 修复了在一个ListView中随机崩溃的问题SwipeControl。 有关详细信息，请参阅 GitHub 问题 #2527。
• 修复了以下问题：仅 ListViewItem 拖放操作会使它处于错误的视觉状态。 有关详细信息，请参阅 GitHub 问题 #3458。
• 修复了以下问题 StackLayout ：它遵循 ItemsRepeater.HorizontalAlignment 和 ItemsRepeater.VerticalAlignment 属性（当 StackLayout.Orientation 分别为垂直和水平时）。 旧布局的行为就像 ItemsRepeater 对齐方式是 Stretch。 使用修补程序时，布局会导致使用右对齐时与右侧对齐的项，例如。 有关详细信息，请参阅 GitHub 问题 #3842。
• 修复了以下问题：删除源中的 ItemsRepeater项不会生成移动到视图中的项。 有关详细信息，请参阅 GitHub 问题 #6661。
• 修复了右 Alt 键不显示访问密钥的键提示的问题。 有关详细信息，请参阅 GitHub 问题 #8447。 注意： 这可能会导致右 Alt 键的键事件不再传递到应用或控件中的句柄。
• 修复了崩溃 UniformGridLayout ，有时会选取错误的布局定位点，并在向后滚动时导致无限布局传递。 有关详细信息，请参阅 GitHub 问题 #9199。
• 修复了设置为 NavigationFailedEventArgs.Handled True 仍会引发异常的问题。 有关详细信息，请参阅 GitHub 问题 #9632。
• 修复了不应用任何指定CornerRadius项的问题TabView。 有关详细信息，请参阅 GitHub 问题 #9846。
• 修复了可能的布局周期崩溃。StackLayout 有关详细信息，请参阅 GitHub 问题 #9852。
• 修复了删除项时可能出现的崩溃 ItemsView 。 有关详细信息，请参阅 GitHub 问题 #9868。

相关主题

• 稳定版通道
• 预览通道
• 安装适用于 Windows 应用 SDK 的工具
• 创建你的第一个 WinUI 3 项目
• 在现有项目中使用 Windows 应用 SDK
• 部署使用 Windows 应用 SDK 的应用