共用方式為

Windows 應用程式 SDK 1.3 實驗通道版本資訊

  • 發行項

重要

實驗通道不支援在生產環境中使用，並且使用實驗版本的應用程式無法發佈到 Microsoft Store。

實驗通道提供 Windows 應用程式 SDK 版本，其中包括處於開發早期階段的實驗通道功能。 實驗性功能的 API 具有 Experimental 屬性。 如果您在程式碼中呼叫實驗性 API，您將收到建置時警告。 實驗通道中的所有 API 在未來版本中可能都會發生重大更改，但實驗 API 尤其容易發生更改。 實驗性功能可能會從下一個版本中移除，或永遠不會發行。

重要連結：

最新實驗通道版本：

最新穩定通道版本：

1.3 實驗版本 (1.3.0-experimental1)

這是實驗通道的最新版本。 要下載，請將您的 WinAppSDK NuGet 版本重新定位為 1.3.230202101-experimental1。

XAML 背景 API

透過 XAML 視窗中內建的屬性，Mica & Background Acrylic 背景現在可以更輕鬆地在 WinUI 3 應用程式中使用。

有關 Window.SystemBackdrop 屬性的詳細信息，請參閱 GitHub 上的 Xaml Backdrop API 規範。

值得注意的是，在此版本中，您只能在程式碼隱藏中設定背景，如下所示。 在標記中設定 <Window.SystemBackdrop> 會導致編譯錯誤。

此外，Xaml Backdrop API 目前缺少「實驗」標籤，因為它們正在積極開發中。

public MainWindow()
{
    this.InitializeComponent();

    this.SystemBackdrop = new MicaBackdrop();
}

Window.AppWindow

取代數行未定案程序代碼，您現在可以透過 直接從 Window Window.AppWindow使用 AppWindow API。 有關其他背景和使用信息，請參閱 GitHub 上的 Window.AppWindow API 規格。

來自 WinAppSDK 的新功能

  • ApplicationModel.DynamicDependency：PackageDependency.PackageGraphRevisionId 替換已棄用的 MddGetGenerationId。
  • 環境管理員：EnvironmentManager.AreChangesTracked 告知您是否能夠在應用程式中追蹤環境管理員的變更。 如需詳細資訊，請參閱 GitHub 上的環境管理員 API 規格。
  • MRT Core：一個新事件，Application.ResourceManagerInitializing 允許您的應用程式提供自己的 IResourceManager 介面實現，並允許您存取 WinUI 用於解析資源 URI 的 ResourceManager。
  • 借助最新的實驗性 VSIX，您現在可以透過 Visual Studio 選單 (而不是在專案文件中) 在未打包和打包的應用程式之間進行轉換。
  • 現在，當 DebugSettings.XamlResourceReferenceFailed 無法解析引用的 Static/ThemeResource 查找時，會引發一個新事件。 此事件允許存取詳細說明架構在何處搜尋該金鑰的追蹤，以便您更好地調試 Static & ThemeResource 查找失敗。 有關更多資訊，請參閱 GitHub 上的問題 4972、2350 和 6073。

錯誤修正

  • 修正了觸控輸入導致軟鍵盤不出現在文字方塊上的問題。 如需詳細資訊，請參閱 GitHub 上的 6291。
  • 修正了導致以 IElementFactory 為 ItemTemplate 的 ItemsRepeater 引發 ArgumentException 的問題。 如需詳細資訊，請參閱 GitHub 上的問題 4705。

其他實驗性 API

此版本還包括幾個處於早期開發階段的 API。

下面的清單詳細介紹了此實驗版本中引入的 API，我們不打算在 1.3.0 穩定版本中提供這些 API。

**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