Versionshinweise zum experimentelle Kanal für das Windows App SDK

  • 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:

Experimenteller Versionskanal:

Version 1.5 Experimental (1.5.0-experimental2)

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

Fehlerkorrekturen

Die folgenden Fehlerkorrekturen sind in diesem Release enthalten:

  • Das Problem, das dazu führte, dass Apps beim Start abstürzen, wenn sie eine benutzerdefinierte NavigationViewItem verwenden, wurde behoben. Weitere Informationen finden Sie im GitHub-Issue #8814.
  • Das Problem mit NavigationView wurde behoben, bei dem die Schaltfläche mit den Auslassungspunkten fälschlicherweise einen Fehler generierte. Weitere Informationen finden Sie im GitHub-Issue #8380.
  • Es wurde ein Problem behoben, bei dem SystemBackdrop nicht ordnungsgemäß in einer App mit mehreren Fenstern gerendert wurde. Weitere Informationen finden Sie im GitHub-Issue #8423.
  • Ein Duplizierungsproblem beim Einfügen an den Anfang von ObservableCollection wurde behoben. Weitere Informationen finden Sie im GitHub-Issue #8370.

Neue APIs

1.5-experimental2 enthält die folgenden neuen APIs. Diese APIs sind nicht experimentell, aber noch nicht in einer stabilen Version von WinAppSDK enthalten.

Microsoft.Graphics.DirectX
 
    DirectXPixelFormat
        A4B4G4R4

Microsoft.UI.Xaml
 
    DebugSettings
        LayoutCycleDebugBreakLevel
        LayoutCycleTracingLevel
 
    LayoutCycleDebugBreakLevel
    LayoutCycleTracingLevel

Microsoft.UI.Xaml.Automation.Peers
 
    SelectorBarItemAutomationPeer

Microsoft.UI.Xaml.Controls
 
    MapControl
    MapControlMapServiceErrorOccurredEventArgs
    MapElement
    MapElementClickEventArgs
    MapElementsLayer
    MapIcon
    MapLayer
    SelectorBar
    SelectorBarItem
    SelectorBarSelectionChangedEventArgs
    WebView2
        EnsureCoreWebView2Async
        EnsureCoreWebView2Async

Microsoft.Windows.Management.Deployment
 
    EnsureReadyOptions
    PackageDeploymentManager
        AddPackageSetAsync
        DeprovisionPackageAsync
        DeprovisionPackageByUriAsync
        DeprovisionPackageSetAsync
        EnsurePackageReadyAsync
        EnsurePackageReadyByUriAsync
        EnsurePackageSetReadyAsync
        IsPackageReady
        IsPackageReadyByUri
        IsPackageRegistrationPending
        IsPackageRegistrationPendingForUser
        ProvisionPackageAsync
        ProvisionPackageByUriAsync
        ProvisionPackageSetAsync
        RegisterPackageAsync
        RegisterPackageByUriAsync
        RegisterPackageSetAsync
        RemovePackageByUriAsync
        RepairPackageAsync
        RepairPackageByUriAsync
        RepairPackageSetAsync
        ResetPackageAsync
        ResetPackageByUriAsync
        ResetPackageSetAsync
        StagePackageAsync
        StagePackageByUriAsync
        StagePackageSetAsync
 
    PackageDeploymentProgress
    PackageDeploymentResult
        Error
        ErrorText
 
    PackageSet
        Items
        PackageUri
 
    PackageVolume
        FindPackageVolumeByName
        FindPackageVolumeByPath
        FindPackageVolumes
        IsRepairNeeded
        Repair
 
    ProvisionPackageOptions
    RegisterPackageOptions
        DependencyPackageFamilyNames
 
    RemovePackageOptions
        FailIfNotFound

Zusätzliche experimentelle APIs

Diese Version enthält die folgenden neuen und geänderten experimentellen APIs:

Microsoft.UI.Xaml
 
    Application
        DispatcherShutdownMode
 
    DispatcherShutdownMode
    XamlIsland
        SystemBackdrop

Microsoft.UI.Xaml.Hosting
 
    WindowsXamlManager
        IsXamlRunningOnCurrentThread
        XamlShutdownCompletedOnThread
 
    XamlShutdownCompletedOnThreadEventArgs

Microsoft.Windows.System.Workloads
 
    IWorkloadHandler
    Workload
    WorkloadManager
    WorkloadProgress
    WorkloadProgressStatus
    WorkloadResult
    WorkloadsContract
    WorkloadStatus

Version 1.5 Experimental (1.5.0-experimental1)

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

Neue APIs

1.5-experimental1 enthält die folgenden neuen APIs. Diese APIs sind nicht experimentell, aber noch nicht in einer stabilen Version von WinAppSDK enthalten.

Microsoft.Windows.Widgets.Feeds.Providers
    CustomQueryParametersRequestedArgs
    CustomQueryParametersUpdateOptions
    FeedDisabledArgs
    FeedEnabledArgs
    FeedManager
    FeedProviderDisabledArgs
    FeedProviderEnabledArgs
    FeedProviderInfo
    IFeedManager
    IFeedProvider

Zusätzliche experimentelle APIs

Diese Version enthält die folgenden neuen und geänderten experimentellen APIs:

Microsoft.UI.Content
 
    ContentIsland
        ConnectionInfo
        ConnectRemoteEndpoint
        IsRemoteEndpointConnected
 
    ContentIslandEnvironment
        CurrentOrientation
        DisplayScale
        NativeOrientation
        ThemeChanged
 
    ContentSiteEnvironment
        CurrentOrientation
        DisplayScale
        NativeOrientation
        NotifyThemeChanged
 
    DesktopChildSiteBridge
        AcceptRemoteEndpoint
        ConnectionInfo
        IsRemoteEndpointConnected
        RemoteEndpointConnecting
        RemoteEndpointDisconnected
        RemoteEndpointRequestedStateChanged
 
    EndpointConnectionEventArgs
    EndpointRequestedStateChangedEventArgs
    IContentIslandEndpointConnectionPrivate
    IContentSiteBridgeEndpointConnectionPrivate
    ProcessStarter
    SystemVisualSiteBridge
        IsClosed

Microsoft.UI.Input
 
    FocusNavigationReason
    FocusNavigationRequest
    FocusNavigationRequestEventArgs
    FocusNavigationResult
    InputFocusController
        DepartFocus
        NavigateFocusRequested
 
    InputFocusNavigationHost

Microsoft.UI.Xaml
 
    DebugSettings
        LayoutCycleDebugBreaks
        LayoutCycleTracing
 
    LayoutCycleDebugBreakLevel
    LayoutCycleTracingLevel
    XamlIsland

Microsoft.UI.Xaml.Controls
 
    SelectionModel
        SelectAllFlat

Microsoft.UI.Xaml.Core.Direct
 
    XamlPropertyIndex
        FlyoutBase_SystemBackdrop
        Popup_SystemBackdrop

Microsoft.Windows.Management.Deployment
 
    AddPackageOptions
    AddPackageSetOptions
    DeploymentPriority
    DeploymentProcessingModel
    EnsureIsReadyOptions
    FindPackageSetOptions
    PackageDeploymentContract
    PackageDeploymentManager
    PackageDeploymentProgress
    PackageDeploymentProgressStatus
    PackageDeploymentResult
    PackageDeploymentStatus
    PackageRuntimeManager
    PackageSet
    PackageSetItem
    PackageSetItemRuntimeDisposition
    PackageSetManager
    PackageSetRuntimeDisposition
    PackageVolume
    PackageVolumeManager
    PackageVolumeStatus
    RegisterPackageOptions
    RemovePackageOptions
    StagePackageOptions
    StubPackageOption

Version 1.4 Experimental (1.4.0-experimental1)

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

Fehlerkorrekturen

Diese Version enthält verschiedene Fixes, einschließlich der folgenden:

  • Es wurde ein Problem behoben, bei dem das Aktivieren des Frameratezählers für Debugeinstellungen in einer neuen WinUI-Desktopanwendung zu einer Zugriffsverletzung führte. Weitere Informationen finden Sie im Issue 2835 auf GitHub.
  • Es wurde ein Problem behoben, bei dem ein horizontaler Bildlauf auf einem Touchpad auf einer WebView2-Webseite nicht funktionierte. Weitere Informationen finden Sie im Issue 7772 auf GitHub.

Zusätzliche experimentelle APIs

Diese Version enthält die folgenden neuen und geänderten experimentellen APIs:

Microsoft.UI

   IClosableNotifier

Microsoft.UI.Composition.SystemBackdrops

   DesktopAcrylicController
       Closed
       FrameworkClosed
       Kind

   DesktopAcrylicKind
   MicaController
       Closed
       FrameworkClosed

Microsoft.UI.Content

   ContentAppWindowBridge
       SettingChanged

   ContentEnvironmentSettingChangedEventArgs
   ContentExternalBackdropLink
   ContentExternalOutputLink
       ExternalOutputBorderMode

   ContentIsland
       FrameworkClosed

   ContentIslandWindow
       SettingChanged

   ContentSite
       FrameworkClosed

   ContentSiteWindow
       NotifySettingChanged
       SettingChanged

   CoreWindowTopLevelWindowBridge
       SettingChanged

   DesktopSiteBridge
       Closed
       FrameworkClosed

   IContentWindow
       SettingChanged

   SystemVisualSiteBridge
       Closed
       FrameworkClosed

Microsoft.UI.Input

   InputLayoutPolicy
   InputNonClientPointerSource
       ConfigurationChanged
       GetForWindowId

   NonClientRegionConfigurationChangedEventArgs

Microsoft.UI.System

   ThemeSettings

Microsoft.UI.Windowing

   DisplayArea
       GetMetricsFromWindowId

Microsoft.UI.Xaml

   XamlRoot
       ContentWindow

Microsoft.UI.Xaml.Controls

   ItemContainer
       Child
       ChildProperty

   ItemContainerMultiSelectMode
       Extended

   ItemsView
       Animator
       AnimatorProperty

   MenuFlyoutPresenter
       SystemBackdrop
       SystemBackdropProperty

   RiverFlowLayout
       InvalidateItemsInfo
       RequestedRangeCount
       RequestedRangeStartIndex

   RiverFlowLayoutElementAnimator

Microsoft.UI.Xaml.Controls.Primitives

   CommandBarFlyoutCommandBar
       SystemBackdrop
       SystemBackdropProperty

Microsoft.UI.Xaml.Input

   AccessKeyManager
       EnterDisplayMode

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

Durch Ersetzen mehrerer Zeilen mit Codebausteinen können Sie AppWindow-APIs jetzt über Window.AppWindow direkt aus einem Fenster verwenden. Weitere Hintergrund- und Nutzungsinformationen finden Sie in der Windows.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

Version 1.2 Experimental (1.2.0-experimental2)

Dies ist die neueste Version des experimentellen Kanals. Es unterstützt alle experimentellen Kanalfeatures und Features von 1.2.0-preview 1.

Um sie herunterzuladen, richten Sie Ihre WinAppSDK NuGet-Version neu aus, auf 1.2.220909.2-experimental2.

Behobenes Problem

In anstehenden Windows Insider Preview-Builds können Anwendungen, die das Windows App SDK verwenden, nicht gestartet werden.

Version 1.2 Experimental (1.2.0-experimental1)

Dies ist die neueste Version des experimentellen Kanals. Es unterstützt alle experimentellen Kanalfeatures.

Um sie herunterzuladen, richten Sie Ihre WinAppSDK NuGet-Version neu aus, auf 1.2.220727.1-experimental1.

Eingabe und Anordnung

Erstmals in Windows App SDK 0.8 eingeführt, gibt es mehrere experimentelle Klassen in den Namespaces Microsoft.UI.Input.Experimental und Microsoft.UI.Composition.Experimental.

In dieser Version neu:

Inhalt

Neu in dieser Version stellen die experimentellen Klassen im Microsoft.UI.Content-Namespace die Bausteine interaktiver Inhalte bereit. Dies sind Grundtypen auf niedriger Ebene, die in Inhalten zusammengefasst werden können, um die interaktive Benutzeroberfläche für einen Endbenutzer bereitzustellen. Der Inhalt definiert die Struktur für: Rendern der Ausgabe mit Animationen, Verarbeiten von Eingaben für verschiedene Ziele, Bereitstellen von Barrierefreiheitsdarstellung und Behandeln von Hoststatusänderungen.

Erwähnenswerte APIs:

  • ContentIsland - vereint Ausgabe, Eingabe und Barrierefreiheit und bietet die Abstraktion für interaktive Inhalte. Mit diesen APIs kann eine benutzerdefinierte visuelle Struktur erstellt und interaktiv gestaltet werden.
  • DesktopChildSiteBridge – ermöglicht die ContentIsland Verbindung mit einer HWND-basierten Hierarchie.

Weitere Informationen finden Sie unter dem vollständigen Beispiel auf GitHub.

Dispatcher

DispatcherQueue versendet jetzt als Eintrittsinvarianz. Bisher konnte nicht mehr als ein einzelner DispatcherQueueHandler-Rückruf in einem einzelnen Thread gleichzeitig aktiv sein. Wenn nun ein Handler eine geschachtelte Nachrichtenpumpe startet, werden als erneute Rückrufe zusätzliche Rückrufe versendet. Dies entspricht dem Win32-Verhalten rund um Fenstermeldungen und geschachtelte Nachrichtenpumpen.

Benachrichtigungen

Das Registrieren des App-Anzeigenamens und -Symbols für die App-Benachrichtigung wird jetzt unterstützt. Weitere Informationen finden Sie in der Spezifikation auf GitHub .

WinUI 3

  • Steuerelemente und Stile sind mit der WinUI 2.8-Version auf dem neuesten Stand.
  • UWP wird in den experimentellen Versionen nicht mehr unterstützt.

Weitere Einschränkungen und bekannte Probleme

  • Apps müssen nach dem Update auf Windows App SDK 1.2-experimental1 aufgrund einer in der ABI eingeführten Änderung neu erstellt werden.
  • Apps, die auf ein Paket verweisen, das WebView2 erfordert (z.B. Microsoft.Identity.Client), können nicht kompiliert werden. Dies wird durch miteinander in Konflikt stehende Binärdateien zur Buildzeit verursacht. Weitere Informationen finden Sie im Issue 2492 auf GitHub.
  • Bei Verwendung von dotnet build mit einem WinAppSDK C#-Klassenbibliothek-Projekt kann der Build-Fehler „Microsoft.Build.Packaging.Pri.Tasks.ExpandPriContent task could not be loaded“ auftreten. Um dieses Problem zu beheben, legen Sie <EnableMsixTooling>true</EnableMsixTooling> in Ihrer Projektdatei fest.
  • Die WinAppSDK-Standardvorlagen enthalten diesen Hinweis: MaxVersionTested="10.0.19041.0". Es sollte sich aber um 10.0.22000.0 handeln. Aktualisieren Sie MaxVersionTested in Ihrer Projektdatei auf 10.0.22000.0, um die vollständige Unterstützung für einige Features zu erhalten, insbesondere UnlockedDEHs.

Version 1.0 Experimental (1.0.0-experimental1)

Diese Version unterstützt alle Features des experementelle Kanals.

Download

In den folgenden Abschnitten werden neue und aktualisierte Features, Einschränkungen und bekannte Probleme für diese Version beschrieben.

WinUI 3

Diese Version von WinUI 3 konzentriert sich auf das Erstellen neuer Features für 1.0 stabile und Beheben von Fehlern.

  • Neue Features: Unterstützung für die Anzeige eines Inhaltsdialogs pro Fenster und nicht pro Thread.
  • Bugs: Eine vollständige Liste der in dieser Version behobenen Fehler finden Sie in unserem GitHub-Repository.
  • Bildpunkte: Um die WinUI 3-Steuerelemente und -Features in Aktion zu sehen, können Sie die WinUI 3-Gallery-App von GitHub klonen und kompilieren oder aus dem Microsoft Store herunterladen.

Weitere Informationen sowie die ersten Schritte zur Entwicklung mit WinUI finden Sie unter:

Pushbenachrichtigung (experimentelle Feature)

In dieser Version wird eine Pushbenachrichtigungs-API eingeführt, die von verpackten Desktop-Apps mit registrierungsbasierten Azure-App-Identitäten verwendet werden kann. Um dieses Feature zu verwenden, müssen Sie sich für unsere private Vorschau registrieren.

Wichtige Einschränkungen:

  • Pushbenachrichtigungen werden nur in MSIX-gepackten Apps unterstützt, die unter Windows 10, Version 2004 (Build 19041) oder höher, ausgeführt werden.
  • Microsoft behält sich das Recht vor, Apps während der privaten Vorschau für Pushbenachrichtigungen zu deaktivieren oder zu einzustellen.
  • Microsoft garantiert nicht die Zuverlässigkeit oder Latenz von Pushbenachrichtigungen.
  • Während der privaten Vorschau ist das Pushbenachrichtigungsvolumen auf 1 Million pro Monat beschränkt.

Zusätzliche Informationen finden Sie unter Pushbenachrichtigungen.

Windowing

Diese Version enthält die folgenden Updates für Windows-API. AppWindow ist eine allgemeine API für Fensterfunktionen, die benutzerfreundliche Fensterszenarien ermöglicht, die sich gut in die Windows-Benutzeroberfläche und andere Apps integrieren lassen. Dies ist ähnlich wie die UWP-AppWindow, aber nicht die gleiche.

Wichtige Einschränkungen:

  • Diese Version von AppWindow ist derzeit nur für Win32-Apps verfügbar (sowohl verpackt als auch entpackt).
  • Das Windows App SDK bietet derzeit keine Methoden zum Anfügen von UI-Framework-Inhalten an. AppWindowSie sind auf die Verwendung der HWND Interop-Zugriffsmethoden beschränkt.
  • Die Windowing-API funktioniert derzeit nicht unter Windows, Version 1809 und 1903 für AMD64.

Weitere Informationen finden Sie unter Verwalten von App-Fenstern.

Bereitstellung für nicht gepackte Apps

In dieser Version werden Updates für das Feature dynamische Abhängigkeiten eingeführt, einschließlich der Bootstrapper-API.

Wichtige Einschränkungen:

  • Das Feature für dynamische Abhängigkeiten wird nur für entpackte Apps unterstützt.
  • Hochgestellte Aufrufe werden nicht unterstützt.

Weitere Informationen finden Sie in den folgenden Artikeln:

Weitere Einschränkungen und bekannte Probleme

  • Keine Unterstützung für eine CPU-Buildkonfiguration: Das Windows App SDK ist in systemeigenem Code geschrieben und unterstützt somit keine CPU-Buildkonfigurationen . Die WinUI 3-Vorlagen in Visual Studio lassen nur architekturspezifische Builds zu. Beim Hinzufügen des Windows App SDK zu einer vorhandenen .NET-Anwendung oder -Komponente, die Beliebige CPU unterstützt, müssen Sie die gewünschte Architektur angeben: x86, x64 oder arm64.
  • .NET-Apps müssen auf Build 18362 oder höher ausgerichtet sein: Ihr TFM muss auf net6.0-windows10.0.18362 oder höher festgelegt sein, und die <TargetPlatformVersion> Ihres Paketprojekts muss auf 18362 oder höher festgelegt sein. Weitere Informationen finden Sie in diesem bekannten Issue auf GitHub.
  • C#-Apps mit 1.0 Experimental müssen eines der folgenden .NET-SDKs verwenden:

Vorschau auf Version 0.8 (0.8.0-preview)

Diese Version unterstützt alle Features des experementelle Kanals.

Download

In den folgenden Abschnitten werden neue und aktualisierte Features, Einschränkungen und bekannte Probleme für diese Version beschrieben.

WinUI 3

In dieser Version werden wichtige Fehlerkorrekturen (einschließlich der in 0.5-Wartungsversionen behobenen) und andere Änderungen für WinUI eingeführt. Eine vollständige Liste finden Sie in den Versionshinweisen für WinUI 3 – Windows App SDK 0.8.

Lebenszyklus der App (experimentelle Feature)

In dieser Version werden neue experimentelle Features eingeführt, die sich auf die Verwaltung des App-Lebenszyklus Ihrer App beziehen.

  • Alle Apps (verpackt und entpackt) können GetActivatedEventArgs verwenden (verpackte Apps können jedoch bereits die Implementierung dieser App auf der Plattform verwenden).
  • Nur entpackte Apps können die RegisterForXXXActivation-Funktionen verwenden.
  • Verpackte Desktop-Apps können die App-Lebenszyklus-Instancing verwenden.

Weitere Informationen finden Sie unter App-Instancing und Rich-Aktivierung.

Bereitstellung für entpackte Apps (experimentelles Feature)

In dieser Version werden neue experimentelle Bereitstellungsfeatures für entpackte Apps eingeführt. Entpackte Apps können jetzt dynamisch von den Windows App SDK-Laufzeitpaketen abhängig sein, damit Sie ihr vorhandenes MSI- oder Setupprogramm für die App-Bereitstellung weiterhin verwenden können. Diese ist für die folgenden SKUs verfügbar:

  • Eigenständiges Installationsprogramm für das Windows App SDK.
  • MSIX-Paketbundle, das dynamische Abhängigkeitsfunktionen enthält.

Weitere Informationen finden Sie im Windows App SDK-Bereitstellungsleitfaden für von Framework abhängige gepackte Apps mit externem Speicherort oder nicht gepackte Apps.

DWriteCore

Mit dieser Version werden außerdem die folgenden Features hinzugefügt:

  • Text-Dekorationen (Unterstrichen und Durchgestrichen in der Textlayout-API)
  • Vertikales Text-Layout
  • Schriftart-Kerning-API
  • Experimentelle Unterstützung für entpackte Apps

Weitere Informationen finden Sie unter Rendertext mit DWriteCore.

MRT Core

Mit dieser Version werden außerdem die folgenden Features hinzugefügt:

  • Die Buildaktion für Ressourcen wird automatisch festgelegt, hinzufügen dadurch ist weniger manuelle Projektkonfiguration erforderlich.
  • Experimentelle Unterstützung für entpackte Apps.

Weitere Informationen finden Sie unter Verwalten von Ressourcen mit MRT Core.

Einschränkungen und bekannte Probleme

  • Keine Unterstützung für eine CPU-Buildkonfiguration: Das Windows App SDK ist in systemeigenem Code geschrieben und unterstützt somit keine CPU-Buildkonfigurationen . Die WinUI 3-Vorlagen in Visual Studio lassen nur architekturspezifische Builds zu. Beim Hinzufügen des Windows App SDK zu einer vorhandenen .NET-Anwendung oder -Komponente, die Beliebige CPU unterstützt, müssen Sie die gewünschte Architektur angeben: x86, x64 oder arm64.
  • .NET-Apps müssen auf Build 18362 oder höher ausgerichtet sein: Ihr TFM muss auf net6.0-windows10.0.18362 oder höher festgelegt sein, und die <TargetPlatformVersion> Ihres Paketprojekts muss auf 18362 oder höher festgelegt sein. Weitere Informationen finden Sie in diesem bekannten Issue auf GitHub.

Beispiele

Die Beispiele für das Windows App SDK funktionieren mit dieser Version noch nicht. Neue und aktualisierte Beispiele, einschließlich Beispiele, die neue Features wie die entpackte App-Bereitstellung veranschaulichen, werden in Kürze verfügbar sein.