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

  • Статья

Внимание

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

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

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

Последний экспериментальный выпуск канала:

Последний выпуск стабильного канала:

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

Это последний выпуск экспериментального канала. Чтобы скачать, перенаправьте версию 1.3.230202101-experimental1NuGet WinAppSDK в .

API фона XAML

Благодаря свойствам, встроенным в окно XAML, mica и фоновые акриловые фоны теперь проще использовать в приложении WinUI 3.

Дополнительные сведения о свойстве Window.SystemBackdrop см. в спецификации API фона Xaml на сайте GitHub.

Обратите внимание, что в этом выпуске вы можете задать фон только в коде программной части, как показано ниже. Установка <Window.SystemBackdrop> разметки приводит к ошибке компиляции.

Кроме того, API-интерфейсы фона Xaml в настоящее время отсутствуют экспериментальный тег, так как они находятся в активной разработке.

public MainWindow()
{
    this.InitializeComponent();

    this.SystemBackdrop = new MicaBackdrop();
}

Window.AppWindow

Замена нескольких строк стандартного кода теперь позволяет использовать API AppWindow непосредственно из окна.Window.AppWindow Дополнительные сведения о фоновом и использовании см. в спецификации API Window.AppWindow на сайте GitHub.

Новые возможности из WinAppSDK

  • ApplicationModel.DynamicDependency: PackageDependency.PackageGraphRevisionId заменяет устаревший mddGetGenerationId.
  • Environment Manager: EnvironmentManager.AreChangesTracked чтобы сообщить, могут ли изменения в диспетчере среды отслеживаться в приложении. Дополнительные сведения см. в спецификации API Environment Manager на сайте GitHub.
  • MRT Core: новое событие позволяет Application.ResourceManagerInitializing приложению предоставлять собственную реализацию IResourceManager интерфейса и предоставлять доступ к ResourceManager, который WinUI использует для разрешения URI ресурсов.
  • С помощью последней экспериментальной ВЕРСИИ VSIX теперь вы можете преобразовать приложение между распаковкой и упакованным с помощью меню Visual Studio вместо файла проекта.
  • Новое событие возникает, DebugSettings.XamlResourceReferenceFailed когда не удается устранить ссылку static/ThemeResource. Это событие предоставляет доступ к трассировке, в которой платформа ищет этот ключ, чтобы лучше разрешить отладку сбоев статических и подстановок ThemeResource. Дополнительные сведения см. в проблемах 4972, 2350 и 6073 на GitHub.

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

  • Исправлены проблемы с сенсорным вводом, что приводит к неявной клавиатуре в текстовых полях. Дополнительные сведения см. в статье о проблеме 6291 на сайте GitHub.
  • Исправлена проблема, из-за которой ItemsRepeater с IElementFactory в качестве элемента ItemTemplate вызывает исключение ArgumentException. Дополнительные сведения см. в статье 4705 на сайте GitHub.

Дополнительные экспериментальные API

Этот выпуск также включает несколько API, которые находятся в начале разработки.

В приведенном ниже списке описаны API, представленные в этом экспериментальном выпуске, которые мы не планируем отправлять в стабильном выпуске 1.3.0.

**Microsoft.UI.Content**

    DesktopSiteBridge
        GetInputEnabledToRoot
        GetVisibleToRoot
        InputEnabled

**Microsoft.UI.Dispatching**

    DispatcherQueue
        FrameworkShutdownStarting

**Microsoft.UI.Input**

    InputLightDismissAction
        GetForIsland

    InputNonClientPointerSource
    InputPointerActivationBehavior
    InputPointerSource
        ActivationBehavior

    NonClientRegionCaptionTappedEventArgs
    NonClientRegionHoverEventArgs
    NonClientRegionKind

**Microsoft.UI.Input.DragDrop**

    DragDropManager
    DragDropModifiers
    DragInfo
    DragOperation
    DragUIContentMode
    DragUIOverride
    DropOperationTargetRequestedEventArgs
    IDropOperationTarget

**Microsoft.UI.Xaml.Automation.Peers**

    ItemContainerAutomationPeer
    ItemsViewAutomationPeer

**Microsoft.UI.Xaml.Controls**

    AnnotatedScrollBar
    AnnotatedScrollBarLabel
    AnnotatedScrollBarScrollEventArgs
    AnnotatedScrollBarScrollEventType
    AnnotatedScrollBarScrollOffsetRequestedEventArgs
    AnnotatedScrollBarSubLabelRequestedEventArgs
    AnnotatedScrollBarValueRequestedEventArgs
    ElementFactory
        GetElement
        GetElementCore
        RecycleElement
        RecycleElementCore

    IndexBasedLayoutOrientation
    ItemContainer
    ItemContainerInteractionTrigger
    ItemContainerInvokedEventArgs
    ItemContainerMultiSelectMode
    ItemContainerUserInvokeMode
    ItemContainerUserSelectMode
    ItemsView
    ItemsViewItemInvokedEventArgs
    ItemsViewItemInvokeMode
    ItemsViewSelectionMode
    Layout
        IndexBasedLayoutOrientation

    NonVirtualizingLayout
        IndexBasedLayoutOrientationCore

    RiverFlowLayout
    RiverFlowLayoutItemsInfoRequestedEventArgs
    RiverFlowLayoutItemsJustification
    RiverFlowLayoutItemsStretch
    VirtualizingLayout
        IndexBasedLayoutOrientationCore

    VirtualizingLayoutContext
        VisibleRect
        VisibleRectCore

**Microsoft.Graphics.Display**

    DisplayInformation
        AngularOffsetFromNativeOrientation
        DpiChanged
        OrientationChanged
        RawDpi
        RawPixelsPerViewPixel

    DisplayOrientation

**Microsoft.UI.Xaml.Hosting**

    DesktopWindowXamlSource
        CreateSiteBridge
        SiteBridge
        SystemBackdrop