Последние заметки о выпуске экспериментального канала для пакета SDK для приложений Windows

Внимание

Экспериментальный канал не поддерживается для использования в рабочих средах, а приложения, использующие экспериментальные выпуски, не могут быть опубликованы в Microsoft Store.

Экспериментальный канал включает выпуски пакета SDK для приложений Windows с функциями экспериментального канала на ранних этапах разработки. API для экспериментальных функций имеют экспериментальный атрибут. При вызове экспериментального API в коде вы получите предупреждение во время сборки. Все API-интерфейсы в экспериментальном канале подвергаются обширным исправлениям и критическим изменениям. Экспериментальные функции и API могут быть удалены из последующих выпусков в любое время.

Важные ссылки:

• Если вы хотите обновить существующее приложение с более старой версии пакета SDK для приложений Windows до более новой версии, ознакомьтесь с обновлением существующих проектов до последнего выпуска пакета SDK для приложений Windows.
• Документация по экспериментальным выпускам см. в разделе "Установка средств для предварительной версии и экспериментальных каналов" пакета SDK для приложений Windows.

Архив заметки о выпуске экспериментального канала:

• Заметки о выпуске экспериментального канала для пакета SDK для приложений Windows 1.6
• Заметки о выпуске экспериментального канала для пакета SDK для приложений Windows 1.5
• Заметки о выпуске экспериментального канала для пакета SDK для приложений Windows 1.4
• Заметки о выпуске экспериментального канала для пакета SDK для приложений Windows 1.3
• Заметки о выпуске экспериментального канала для пакета SDK для приложений Windows 1.2
• Заметки о выпуске экспериментального канала для пакета SDK для приложений Windows 1.0
• Заметки о выпуске экспериментального канала для пакета SDK для приложений Windows 0.8

Экспериментальная версия 1.7 (1.7.0-экспериментальная2)

Регистрация фоновых задач

Новый API BackgroundTaskBuilder позволяет зарегистрировать фоновые задачи для приложений Windows App SDK. Дополнительные сведения см. в разделе GitHub #4831.

Новые функции уведомлений

Новая поддержка уведомлений в виде значков позволяет отображать цифру или символ на значке вашего приложения на панели задач. Дополнительные сведения см. в разделе GitHub #4926.

Внимание

В этом выпуске проекции C# отсутствуют для новых API-интерфейсов BadgeNotifications, которые не позволяют использовать их из C#. API доступны в C++.

Видео или аудиозвонки могут иметь расширенный пользовательский интерфейс в уведомлениях. Дополнительные сведения см. в разделе GitHub #4783.

Внимание

Эта функция доступна только в последних выпусках Программы предварительной оценки Windows.

Другие заметные изменения

• RichEditBox теперь поддерживает математический режим с помощью RichEditTextDocument.SetMathMode и RichEditTextDocument.SetMath.
• Новая поддержка CompatibilityOptions позволит более контролировать, как изменения обслуживания влияют на приложения. Дополнительные сведения см. в разделе GitHub #4976.

Новые 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

    AutomationTreeOptions
    ChildSiteLink
    ContentAppWindowBridge
    ContentDisplayOrientations
    ContentEnvironmentStateChangedEventArgs
        DidDisplayScaleChange

    ContentExternalBackdropLink
    ContentExternalOutputLink
    ContentIsland
        AutomationTreeOption
        Children
        Connected
        ConnectionInfo
        ConnectRemoteEndpoint
        CreateForSystemVisual
        Disconnected
        FindAllForSystemCompositor
        FragmentRootAutomationProvider
        GetBySystemVisual
        InputCapabilities
        IsRemoteEndpointConnected
        LocalToClientTransformMatrix
        LocalToParentTransformMatrix
        NextSiblingAutomationProvider
        ParentAutomationProvider
        Popups
        PreviousSiblingAutomationProvider
        Root

    ContentIslandEnvironment
        CurrentOrientation
        DisplayScale
        NativeOrientation
        ThemeChanged

    ContentIslandStateChangedEventArgs
        DidLocalToClientTransformMatrixChange
        DidLocalToParentTransformMatrixChange

    ContentSite
        InputCapabilities
        LocalToClientTransformMatrix
        LocalToParentTransformMatrix
        SetContentNodeParent
        TryGetAutomationProvider

    ContentSiteAutomationProviderRequestedEventArgs
    ContentSiteEnvironment
        CurrentOrientation
        DisplayScale
        NativeOrientation
        NotifyThemeChanged

    ContentSiteEnvironmentView
        DisplayScale

    ContentSiteView
        AutomationTreeOption
        InputCapabilities
        LocalToClientTransformMatrix
        LocalToParentTransformMatrix

    CoreWindowSiteBridge
    CoreWindowTopLevelWindowBridge
    DesktopChildSiteBridge
        AcceptRemoteEndpoint
        ConnectionInfo
        CreateWithDispatcherQueue
        IsRemoteEndpointConnected
        RemoteEndpointConnecting
        RemoteEndpointDisconnected
        RemoteEndpointRequestedStateChanged

    DesktopPopupSiteBridge
    DesktopSiteBridge
        TryCreatePopupSiteBridge

    EndpointConnectionEventArgs
    EndpointRequestedStateChangedEventArgs
    IContentIslandEndpointConnectionPrivate
    IContentNodeOwner
    IContentSiteAutomation
    IContentSiteBridgeEndpointConnectionPrivate
    IContentSiteInput
    IContentSiteLink
    IContentSiteLink2
    InputCapabilities
    PopupWindowSiteBridge
    ProcessStarter
    ReadOnlyDesktopSiteBridge
    SystemVisualSiteBridge

Microsoft.UI.Input

    InputFocusNavigationHost
        GetForSiteLink

    InputKeyboardSource
        GetForWindowId

    InputLayoutPolicy
    InputLightDismissAction
        GetForIsland

    InputPointerActivationBehavior
    InputPointerSource
        ActivationBehavior
        DirectManipulationHitTest
        GetForVisual
        GetForWindowId
        RemoveForVisual
        TouchHitTesting
        TrySetDeviceKinds

    ProximityEvaluation
    TouchHitTestingEventArgs

Microsoft.UI.Input.Experimental

    ExpInputSite
    ExpPointerPoint

Microsoft.UI.Text

    RichEditTextDocument
        GetMath
        SetMath
        SetMathMode

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

    CompatibilityChange
    CompatibilityContract
    CompatibilityOptions
    DeploymentManager
        Repair

    DeploymentStatus
        PackageRepairFailed

    ReleaseInfo
    RuntimeInfo
    VersionInfoContract
    WindowsAppRuntimeVersion

Microsoft.Windows.AppNotifications

    AppNotification
        ConferencingConfig

    AppNotificationConferencingConfig

Microsoft.Windows.AppNotifications.Builder

    AppNotificationBuilder
        AddCameraPreview

    AppNotificationButton
        SetSettingStyle

    AppNotificationButtonSettingStyle

Microsoft.Windows.BadgeNotifications

    BadgeNotificationGlyph
    BadgeNotificationManager
    BadgeNotificationsContract

Microsoft.Windows.Media.Capture

    CameraCaptureUI
    CameraCaptureUIContract
    CameraCaptureUIMaxPhotoResolution
    CameraCaptureUIMaxVideoResolution
    CameraCaptureUIMode
    CameraCaptureUIPhotoCaptureSettings
    CameraCaptureUIPhotoFormat
    CameraCaptureUIVideoCaptureSettings
    CameraCaptureUIVideoFormat

Microsoft.Windows.Storage

    ApplicationData
        GetForUnpackaged

Экспериментальная версия 1.7 (1.7.0-experimental1)

Это последний выпуск экспериментального канала.

Чтобы скачать, перенаправьте версию 1.7.241114004-experimental1NuGet WinAppSDK в .

Новый API CameraCaptureUI

Новый API CameraCaptureUI упрощает запись фотографий и видео в приложении WinAppSDK. Дополнительные сведения см. в статье о проблеме GitHub #4721.

Новый API проверки подлинности

Новый OAuth2Manager API предоставляет упрощенное решение для веб-проверки подлинности, предлагая возможности OAuth 2.0 с полным четностью функций на всех платформах Windows, поддерживаемых WinAppSDK. Дополнительные сведения см. в статье о проблеме GitHub #4772.

Поддержка новой фоновой задачи

Новый BackgroundTaskBuilder API обеспечивает встроенную поддержку фоновой регистрации задач в приложениях WinAppSDK. Дополнительные сведения см. в статье GitHub о проблеме 4822.

Новые API для 1.7-экспериментальных

Этот выпуск включает следующие новые и измененные экспериментальные 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

Исправления ошибок

В этом выпуске содержатся следующие исправления ошибок:

• Изменено SplitButton , поэтому сенсорные входные данные теперь соответствуют поведению входных данных мыши. Дополнительные сведения см. в статье о проблеме GitHub #178.
• Изменены каскадные меню, поэтому вложенные меню теперь открываются немедленно, если щелкнуть. Дополнительные сведения см. в статье о проблеме GitHub #939.
• Исправлена проблема, из-за которой открытие ComboBox всплывающего элемента закрывает все всплывающие элементы. Дополнительные сведения см. в статье о проблеме GitHub #1467.
• Исправлена проблема, из-за которой SwipeControl случайно произошел сбой ListView. Дополнительные сведения см. в статье о проблеме 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.
• Исправлена проблема, из-за которой TabView не применялось ни одно указанное CornerRadius. Дополнительные сведения см. в статье о проблеме GitHub #9846.
• Исправлена потенциальная сбой StackLayoutцикла макета. Дополнительные сведения см. в статье о проблеме GitHub #9852.
• Исправлен потенциальный сбой ItemsView при удалении элементов. Дополнительные сведения см. в статье о проблеме GitHub #9868.

См. также

• Стабильный канал
• предварительная версия;
• Установка инструментов для Windows App SDK
• Создание простого проекта WinUI 3
• Использование пакета Windows App SDK в существующем проекте
• Развертывание приложений, использующих пакет SDK для приложений для Windows