Share via

Notes de publication du canal expérimental pour le SDK d’application Windows

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

Versions expérimentales du canal :

Version 1.5 Expérimentale (1.5.0-experimental2)

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

Résolution des bogues

Cette version contient les correctifs de bugs suivants :

  • Correction d’un problème provoquant des plantages d’applications au démarrage lors de l’utilisation d’un NavigationViewItem personnalisé. Pour plus d’informations, veuillez consulter la section GitHub #8814.
  • Correction d’un problème NavigationView où le bouton des points de suspension générait une erreur. Pour plus d’informations, veuillez consulter la section GitHub #8380.
  • Correction d’un problème où un SystemBackdrop ne s’affichait pas correctement dans une application multi-fenêtres. Pour plus d’informations, veuillez consulter la section GitHub #8423.
  • Correction d’un problème de duplication lors de l’insertion au début d’un ObservableCollection. Pour plus d’informations, veuillez consulter la section GitHub #8370.

Nouvelles API

La version 1.5-experimental2 inclut les nouvelles API suivantes. Ces API ne sont pas expérimentales, mais ne sont pas encore incluses dans une version stable de WinAppSDK.

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

API expérimentales supplémentaires

Cette version inclut les API expérimentales nouvelles et modifiées suivantes :

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 expérimentale (1.5.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.5.231202003-experimental1.

Nouvelles API

1.5-experimental1 inclut les nouvelles API suivantes. Ces API ne sont pas expérimentales, mais ne sont pas encore incluses dans une version stable de WinAppSDK.

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

API expérimentales supplémentaires

Cette version inclut les API expérimentales nouvelles et modifiées suivantes :

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 expérimentale (1.4.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.4.230518007-experimental1.

Résolution des bogues

Cette version contient des correctifs divers, notamment les suivants :

  • Correction d’un problème où l’activation du compteur de vitesse de trame des paramètres de débogage dans une nouvelle application bureautique WinUI provoquait une violation d’accès. Pour plus d’informations, consultez le problème 2835 sur GitHub.
  • Correction d’un problème où le défilement horizontal sur un pavé tactile ne fonctionnait pas dans une page Web WebView2. Pour plus d’informations, consultez le problème 7772 sur GitHub.

API expérimentales supplémentaires

Cette version inclut les API expérimentales nouvelles et modifiées suivantes :

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 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 maintenant utiliser les 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

Version 1.2 expérimentale (1.2.0-experimental2)

Il s’agit de la dernière version du canal expérimental. Elle prend en charge toutes les caractéristiques du canal expérimental et les caractéristiques de la version 1.2.0-preview 1.

Pour télécharger, reciblez votre version NuGet WinAppSDK vers 1.2.220909.2-experimental2.

Problème résolu

Dans les versions Windows Insider Preview à venir, les applications utilisant le SDK d’application Windows ne parviennent pas à démarrer.

Version 1.2 expérimentale (1.2.0-experimental1)

Il s’agit de la dernière version du canal expérimental. Elle prend en charge toutes les caractéristiques du canal expérimental.

Pour télécharger, reciblez votre version NuGet WinAppSDK vers 1.2.220727.1-experimental1.

Composition et entrée

Tout d’abord introduit dans le SDK d'application Windows 0.8, il existe plusieurs classes expérimentales dans les espaces de noms Microsoft.UI.Input.Experimental et Microsoft.UI.Composition.Experimental.

Nouveautés de cette version :

Contenu

Nouveautés de cette version, les classes expérimentales de l’espace de noms Microsoft.UI.Content fournissent les blocs élémentaires du contenu interactif. Il s’agit de primitives de bas niveau qui peuvent être assemblées en contenu pour fournir l’expérience interactive d’un utilisateur final. Le contenu définit la structure pour la sortie rendue avec des animations, le traitement des entrées sur différentes cibles, la représentation d’accessibilité et la gestion des modifications d’état de l’hôte.

API importantes :

  • ContentIsland - rassemble la sortie, l’entrée et l’accessibilité et fournit l’abstraction du contenu interactif. Une arborescence visuelle personnalisée peut être construite et rendue interactive avec ces API.
  • DesktopChildSiteBridge - permet à ContentIsland de se connecter à une hiérarchie basée sur HWND.

Pour plus d’informations, consultez l’exemple sur GitHub.

Répartition

DispatcherQueue distribue désormais en tant que réentrant. Auparavant, aucun rappel DispatcherQueueHandler ne pouvait être actif sur un monothread à la fois. À présent, si un gestionnaire démarre une pompe de messages imbriquée, des rappels supplémentaires sont distribués en tant que réentrant. Cela correspond au comportement Win32 autour des messages de fenêtre et des pompes de messages imbriquées.

Notifications

L’inscription du nom complet et de l’icône de l’application pour la notification d’application est désormais prise en charge. Pour plus d’informations, consultez la spécification sur GitHub.

WinUI 3

  • Les contrôles et les styles sont à jour avec la version WinUI 2.8.
  • UWP n’est plus pris en charge dans les versions expérimentales.

Autres limitations et problèmes connus

  • Les applications doivent être reconstruites après la mise à jour vers Windows App SDK 1.2-experimental1 en raison d’un changement cassant introduit dans l’ABI.
  • Les applications qui référencent un package qui dépend de WebView2 (comme Microsoft.Identity.Client) ne parviennent pas à être générées. Cela est dû à des fichiers binaires en conflit au moment de la génération. Pour plus d’informations, consultez le problème 2492 sur GitHub.
  • L’utilisation de dotnet build avec un projet de bibliothèque de classes C# WinAppSDK peut causer une erreur de génération « La tâche Microsoft.Build.Packaging.Pri.Tasks.ExpandPriContent n’a pas pu être chargée ». Pour résoudre ce problème, définissez <EnableMsixTooling>true</EnableMsixTooling> dans votre fichier projet.
  • Les modèles WinAppSDK par défaut notent que maxVersionTested="10.0.19041.0" au lieu de "10.0.22000.0". Pour une prise en charge complète de certaines fonctionnalités, notamment les UnlockedDEH, mettez à jour MaxVersionTested vers « 10.0.22000.0 » dans votre fichier projet.

Version 1.0 expérimentale (1.0.0-experimental1)

Cette version prend en charge toutes les caractéristiques du canal expérimental.

Télécharger

Les sections suivantes décrivent les fonctionnalités nouvelles et mises à jour, les limitations et les problèmes connus pour cette version.

WinUI 3

Cette version de WinUI 3 est axée sur la création de nouvelles caractéristiques pour la version 1.0 stable et la résolution des bogues.

  • Nouvelles caractéristiques : prise en charge de l’affichage d’un ContentDialog par fenêtre plutôt que par conversation.
  • Bogues : pour obtenir la liste complète des bogues résolus dans cette version, consultez notre référentiel GitHub.
  • Échantillons : pour profiter des contrôles et caractéristiques WinUI 3, vous pouvez cloner et générer l’application de galerie WinUI 3 à partir de GitHub, ou la télécharger à partir de la Boutique Microsoft.

Pour plus d’informations ou pour commencer à développer avec WinUI, consultez :

Notifications Push (caractéristique expérimentale)

Cette version introduit une API de notifications Push qui peut être utilisée par des applications bureautiques empaquetées avec des identités basées sur l’inscription d’applications Azure. Pour utiliser cette caractéristique, vous devez vous inscrire à notre préversion privée.

Limitations importantes :

  • Les notifications Push ne sont prises en charge que dans les applications empaquetées MSIX qui s’exécutent sur la version 2004 de Windows 10 (build 19041) ou une version ultérieure.
  • Microsoft se réserve le droit de désactiver ou de révoquer les applications des notifications Push pendant la préversion privée.
  • Microsoft ne garantit ni la fiabilité ni la latence des notifications Push.
  • Pendant la préversion privée, le volume de notifications Push est limité à 1 million par mois.

Pour en savoir plus, consultez Notifications Push.

Fenêtrage

Cette version inclut les mises à jour des API de fenêtrage. Il s’agit d’un ensemble d’API de fenêtrage de haut niveau, centrées sur la classe AppWindow, qui permettent des scénarios de fenêtrage simples d’utilisation qui s’intègrent bien à l’expérience utilisateur Windows et à d’autres applications. Ceci est similaire, mais pas identique, à UWP AppWindow.

Limitations importantes :

  • Cette version de AppWindow est actuellement disponible uniquement pour les applications Win32 (empaquetées et non empaquetées).
  • Le SDK d’application Windows ne fournit actuellement pas de méthodes pour attacher du contenu de l’infrastructure d’interface utilisateur à un AppWindow ; vous êtes limité à l’utilisation des méthodes d’accès d’interopérabilité HWND.
  • L’API de fenêtrage ne fonctionnera actuellement pas sur Windows versions 1809 et 1903 pour AMD64.

Pour plus d’informations, consultez Gérer les fenêtres d’application.

Déploiement pour les applications non empaquetées

Cette version introduit les mises à jour de la caractéristique de dépendances dynamiques, notamment l’API de démarrage.

Limitations importantes :

  • La caractéristique de dépendances dynamiques est prise en charge uniquement pour les applications non empaquetées.
  • Les appelants avec élévation de privilèges ne sont pas pris en charge.

Pour plus d’informations, consultez les articles suivants :

Autres limitations et problèmes connus

  • Aucune prise en charge de toute configuration de build d’UC : le SDK d’application Windows est écrit en code natif et ne prend donc pas en charge les configurations d’UC. Les gabarits WinUI 3 dans Visual Studio autorisent uniquement les versions spécifiques à l’architecture. Lorsque vous ajoutez le SDK d’application Windows à une application ou un composant .NET existant qui prend en charge n’importe quel UC, vous devez spécifier l’architecture souhaitée : x86, x64 ou arm64.
  • Les applications .NET doivent cibler la build 18362 ou ultérieure : votre TFM doit être défini sur net6.0-windows10.0.18362 ou version ultérieure, et la <TargetPlatformVersion> de votre projet d’empaquetage doit être défini sur 18362 ou version ultérieure. Pour plus d’informations, consultez ce problème connu sur GitHub.
  • Les applications C# utilisant la version 1.0 expérimentale doivent utiliser l’un des kits de développement logiciel (SDK) .NET suivants :

Version 0.8 en préversion (0.8.0-preview)

Cette version prend en charge toutes les caractéristiques du canal expérimental.

Télécharger

Les sections suivantes décrivent les fonctionnalités nouvelles et mises à jour, les limitations et les problèmes connus pour cette version.

WinUI 3

Cette version introduit des corrections de bogues critiques (y compris ceux corrigés dans les versions de maintenance 0.5) et d’autres modifications pour WinUI. Pour obtenir une liste complète, consultez les notes de publication de WinUI 3 - SDK d’application Windows 0.8.

Cycle de vie de l’application (caractéristique expérimentale)

Cette version présente de nouvelles caractéristiques expérimentales liées à la gestion du cycle de vie de votre application.

  • Toutes les applications (empaquetées et non empaquetées) peuvent utiliser GetActivatedEventArgs (bien que les applications empaquetées puissent déjà utiliser l’implémentation de celle-ci dans la plateforme).
  • Seules les applications non empaquetées peuvent utiliser les fonctions RegisterForXXXActivation.
  • Les applications bureautiques empaquetées peuvent utiliser l’instance du cycle de vie des applications.

Pour plus d’informations, consultez l’instance d’application et l’activation enrichie.

Déploiement pour les applications non empaquetées (caractéristique expérimentale)

Cette version présente de nouvelles caractéristiques de déploiement expérimentales pour les applications non empaquetées. Les applications non empaquetées peuvent désormais prendre une dépendance dynamique sur les packages d’exécution du SDK d’application Windows afin de continuer à utiliser votre MSI existante ou programme d’installation pour le déploiement d’applications. Cette fonctionnalité est disponible pour les caractéristiques suivantes :

  • Programme d’installation autonome pour SDK d’application Windows.
  • Offre groupée de packages MSIX qui inclut des fonctionnalités de dépendances dynamiques.

Pour plus d’informations, consultez le Guide de déploiement du SDK Windows App pour les applications dépendantes du framework empaquetées avec un emplacement externe ou non empaquetées.

DWriteCore

Cette version ajout également les caractéristiques suivantes :

  • Décorations de texte (soulignement et barré dans l’API de disposition de texte)
  • Disposition verticale de texte
  • API de crénage des polices
  • Prise en charge expérimentale des applications non empaquetées

Pour en savoir plus, reportez-vous à Afficher le texte avec DWriteCore.

MRT Core

Cette version ajout également les caractéristiques suivantes :

  • L’action de génération des ressources est désormais automatiquement définie, ce qui réduit le besoin de configuration manuelle du projet.
  • Prise en charge expérimentale des applications non empaquetées.

Pour plus d’informations, consultez Gérer les ressources avec MRT Core.

Limitations et problèmes connus

  • Aucune prise en charge de toute configuration de build d’UC : le SDK d’application Windows est écrit en code natif et ne prend donc pas en charge les configurations d’UC. Les gabarits WinUI 3 dans Visual Studio autorisent uniquement les versions spécifiques à l’architecture. Lorsque vous ajoutez le SDK d’application Windows à une application ou un composant .NET existant qui prend en charge n’importe quel UC, vous devez spécifier l’architecture souhaitée : x86, x64 ou arm64.
  • Les applications .NET doivent cibler la build 18362 ou ultérieure : votre TFM doit être défini sur net6.0-windows10.0.18362 ou version ultérieure, et la <TargetPlatformVersion> de votre projet d’empaquetage doit être défini sur 18362 ou version ultérieure. Pour plus d’informations, consultez ce problème connu sur GitHub.

Exemples

Les exemples du SDK d’application Windows ne fonctionnent pas encore avec cette version. Des exemples nouveaux et mis à jour, notamment des exemples illustrant de nouvelles caractéristiques telles que le déploiement d’applications non empaquetées, seront bientôt disponibles.