Freigeben über

Versionshinweise zum experimentelle Kanal für das Windows App SDK 1.3

  • Artikel

Wichtig

Der experimentelle Kanal wird nicht für die Verwendung in Produktionsumgebungen unterstützt, und Apps, die die experimentellen Versionen verwenden, können nicht im Microsoft Store veröffentlicht werden.

Der experimentelle Kanal stellt Versionen des Windows App SDK bereit, die experimentelle Kanalfeatures enthalten, die sich in frühen Entwicklungsphasen befinden. APIs für experimentelle Features weisen das Experimental-Attribut auf. Wenn Sie eine experimentelle API in Ihrem Code aufrufen, erhalten Sie eine Buildzeitwarnung. Alle APIs im experimentellen Kanal können Änderungen in zukünftigen Versionen aufweisen, aber experimentelle APIs unterliegen insbesondere Änderungen. Features des Experimental-Releases können aus der nächsten Version entfernt oder überhaupt nicht veröffentlicht werden.

Wichtige Links:

Neuestes experimentelles Kanal-Release:

Release des neuesten stabilen Kanals:

Version 1.3 Experimental (1.3.0-experimental1)

Dies ist die neueste Version des experimentellen Kanals. Um sie herunterzuladen, richten Sie Ihre WinAppSDK NuGet-Version neu aus, auf 1.3.230202101-experimental1.

XAML-Hintergrund-APIs

Mit in das XAML-Fenster integrierten Eigenschaften können Mica- und Background Acrylic-Hintergründe jetzt einfacher in Ihrer WinUI 3-App verwendet werden.

Weitere Informationen zur Window.SystemBackdrop-Eigenschaft finden Sie in der XAML-Hintergrund-API-Spezifikation auf GitHub.

Beachten Sie in dieser Version, dass Sie den Hintergrund nur im CodeBehind wie unten festlegen können. Das Festlegen <Window.SystemBackdrop> im Markup führt zu einem Kompilierungsfehler.

Darüber hinaus fehlen die XAML-Hintergrund-APIs derzeit ein "experimentelles" Tag, da sie aktiv entwickelt werden.

public MainWindow()
{
    this.InitializeComponent();

    this.SystemBackdrop = new MicaBackdrop();
}

Window.AppWindow

Wenn Sie mehrere Codezeilen ersetzen, können Sie jetzt AppWindow-APIs direkt über ein Fenster verwenden Window.AppWindow. Weitere Hintergrund- und Nutzungsinformationen finden Sie in der Window.AppWindow-API-Spezifikation auf GitHub.

Neue Features aus WinAppSDK

  • ApplicationModel.DynamicDependency: PackageDependency.PackageGraphRevisionId ersetzt die veraltete MddGetGenerationId-Funktion.
  • Umgebungs-Manager: EnvironmentManager.AreChangesTracked informiert Sie darüber, ob Änderungen am Umgebungs-Manager in Ihrer Anwendung nachverfolgt werden können. Weitere Informationen finden Sie in der Spezifikation Umgebungs-Manager API auf GitHub.
  • MRT Core: Ein neues Ereignis Application.ResourceManagerInitializing ermöglicht Ihrer App die Bereitstellung einer eigenen Implementierung der IResourceManager Schnittstelle und bietet Ihnen Zugriff auf den ResourceManager, den WinUI zum Auflösen von Ressourcen-URIs verwendet.
  • Mit dem neuesten experimentellen VSIX-Paket können Sie Ihre App jetzt über das Visual Studio-Menü anstatt in Ihrer Projektdatei von der nicht gepackten in die gepackte Version konvertieren.
  • Ein neues Ereignis, DebugSettings.XamlResourceReferenceFailed wird jetzt ausgelöst, wenn ein referenzierter Static-/ThemeResource-Lookup nicht aufgelöst werden kann. Dieses Ereignis gibt Zugriff auf eine Ablaufverfolgung, die angibt, wo das Framework nach diesem Schlüssel gesucht hat, damit Sie Fehler bei Static- und ThemeResource-Lookups besser debuggen können. Weitere Informationen finden Sie im Issues 4972, 2350 und 6073 auf GitHub.

Programmfehlerbehebung

  • Es wurden Probleme mit der Toucheingabe behoben, wodurch die Bildschirmtastatur nicht in Textfeldern angezeigt wird. Weitere Informationen finden Sie im Issue 6291 auf GitHub.
  • Es wurde ein Problem behoben, das dazu führte, dass ein ItemsRepeater-Element mit einer "IElementFactory" als ItemTemplate eine ArgumentException auslöste. Weitere Informationen finden Sie im Issue 4705 auf GitHub.

Zusätzliche experimentelle APIs

Diese Version enthält auch mehrere APIs, die sich in der frühen Entwicklung befinden.

In der nachstehenden Liste werden die Details der in dieser experimentellen Version eingeführten APIs beschrieben, die nicht in der stabilen Version 1.3.0 ausgeliefert werden sollen.

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