Partager via

Notes de version de la chaîne expérimentale pour le SDK d'application Windows 1.3

  • Article

Important

Le canal expérimental n’est pas pris en charge pour une utilisation dans les environnements de production, et les applications qui utilisent les versions expérimentales ne peuvent pas être publiées dans la Boutique Microsoft.

Le canal expérimental fournit des versions du SDK d’application Windows qui incluent des caractéristiques de canal expérimental qui sont au début du développement. Les API pour les fonctionnalités expérimentales ont l’attribut Expérimental. Si vous appelez une API expérimentale dans votre code, vous recevrez un avertissement au moment de la génération. Toutes les API du canal expérimental peuvent avoir des changements cassants dans les futures versions, mais les API expérimentales sont particulièrement sujettes à modification. Les fonctionnalités expérimentales peuvent être supprimées de la prochaine version ou ne jamais être publiées.

Liens importants :

Dernière version de la chaîne expérimentale :

Dernière version de la chaîne stable :

Version 1.3 expérimentale (1.3.0-experimental1)

Il s’agit de la dernière version du canal expérimental. Pour télécharger, reciblez votre version NuGet WinAppSDK vers 1.3.230202101-experimental1.

API de toile de fond XAML

Avec les propriétés intégrées à la fenêtre XAML, les toiles de fond Mica et arrière-plan Acrylic sont désormais plus faciles à utiliser dans votre application WinUI 3.

Pour plus d’informations sur la propriété Window.SystemBackdrop, consultez la spécification de l’API de toile de fond Xaml sur GitHub.

Notez que dans cette version, vous pouvez définir la toile de fond uniquement dans le code-behind, comme indiqué ci-dessous. Le paramètre <Window.SystemBackdrop> des résultats des balises entraîne une erreur de compilation.

En outre, les API de toile de fond Xaml manquent actuellement une balise « expérimentale », car elles sont en cours de développement actif.

public MainWindow()
{
    this.InitializeComponent();

    this.SystemBackdrop = new MicaBackdrop();
}

Window.AppWindow

En remplaçant plusieurs lignes de code réutilisable, vous pouvez désormais utiliser des API AppWindow directement à partir d’une fenêtre via Window.AppWindow. Consultez la spécification de l’API Window.AppWindow sur GitHub pour obtenir des informations supplémentaires sur l’arrière-plan et l’utilisation.

Nouvelles fonctionnalités de WinAppSDK

  • ApplicationModel.DynamicDependency : PackageDependency.PackageGraphRevisionId qui remplace le MddGetGenerationId déprécié.
  • Gestionnaire d’environnement : EnvironmentManager.AreChangesTracked pour vous informer si les modifications apportées au gestionnaire d’environnement peuvent être suivies dans votre application. Pour plus d’informations, consultez la spécification de l’API Gestion de l’environnement sur GitHub.
  • MRT Core : un nouvel événement, Application.ResourceManagerInitializing, permet à votre application de fournir sa propre implémentation de l’interface IResourceManager et vous donne accès à ResourceManager que WinUI utilise pour résoudre les URI de ressource.
  • Avec la dernière version expérimentale de VSIX, vous pouvez désormais convertir votre application entre les formats non empaqueté et empaqueté via le menu Visual Studio au lieu d’avoir à passer par votre fichier projet.
  • Un nouvel événement, DebugSettings.XamlResourceReferenceFailed, est maintenant déclenché lorsqu’une recherche Static/ThemeResource référencée ne peut pas être résolue. Cet événement donne accès à une trace qui détaille l’emplacement où le cadre a recherché cette clé afin de mieux vous permettre de déboguer les échecs de recherche de Static et ThemeResource. Pour plus d’informations, consultez les problèmes 4972, 2350 et 6073 sur GitHub.

Résolution des bogues

  • Correction des problèmes liés à l’entrée tactile entraînant l’affichage du clavier logiciel sur les zones de texte. Pour plus d’informations, consultez le problème 6291 sur GitHub.
  • Correction d’un problème à l’origine d’un ItemsRepeater avec un IElementFactory en tant que ItemTemplate pour lever un ArgumentException. Pour plus d’informations, consultez le problème 4705 sur GitHub.

API expérimentales supplémentaires

Cette version inclut également plusieurs API qui sont au début du développement.

La liste ci-dessous détaille les API introduites dans cette version expérimentale que nous ne prévoyons pas d’expédier dans la version stable 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