Partage via

Notes de publication du canal d'aperçu pour le SDK d'application Windows 1.1

  • Article

Important

Le canal d'aperçu n'est pas pris en charge pour une utilisation dans des environnements de production, et les apps qui utilisent les versions d'aperçu ne peuvent pas être publiées sur le Microsoft Store.

La chaîne de prévisualisation comprend des versions du SDK d'application Windows avec des fonctionnalités de la chaîne de prévisualisation à des stades avancés de développement. Les versions d'évaluation n'incluent pas de fonctionnalités et d'API expérimentales, mais peuvent encore faire l'objet de modifications avant la prochaine version stable.

Liens importants :

Dernière version de la chaîne de prévisualisation :

Dernière version de la chaîne stable :

Version 1.1 Aperçu 3 (1.1.0-preview3)

Il s’agit de la dernière version de l’aperçu du canal pour la version 1.1. Il prend en charge tous les aperçus fonctionnalités du canal (consultez Fonctionnalités disponibles par canal de publication).

Dans une application existante utilisant SDK d'application Windows 1.0, vous pouvez mettre à jour votre package Nuget vers 1.1.0-preview3 (consultez la section Mettre à jour un package dans Installer et gérer des packages dans Visual Studio à l'aide du gestionnaire de packages NuGet). De plus, reportez-vous à la rubrique Derniers téléchargements du SDK d'application Windows pour obtenir le runtime et le MSIX mis à jour.

Remarque

Pour les développeurs C#, l’une des versions suivantes du SDK .NET est requise : 6.0.202, 6.0.104, 5.0.407, 5.0.213 (ou version ultérieure). Pour mettre à jour votre version du SDK .NET, consultez Téléchargements .NET ou mettez à jour vers la dernière version de Visual Studio. Sans la version requise du SDK .NET, lors de la mise à jour de votre package NuGet, vous verrez une erreur du type : « Cette version de WindowsAppSDK nécessite WinRT.Runtime.dll version 1.6 ou ultérieure ».

En plus de toutes les fonctionnalités de l'aperçu 2, les sections suivantes décrivent les fonctionnalités nouvelles et mises à jour, les limitations et les problèmes connus pour cette version.

WinUI 3 (1.1.0-preview3)

Mica et Acrylic sont désormais disponibles pour les applications WinUI 3.

Pour plus d’informations sur ces matériaux, consultez Matériaux dans Windows 11. Consultez notre exemple de code pour l'application de Mica dans des applications C++ à l'adresse Appliquez des matériaux Mica ou Acrylique dans des applications de bureau pour Windows 11 et dans des applications C# sur GitHub dans le cadre de la galerie de contrôles WinUI.

Notifications (1.1.0-preview3)

Problèmes résolus :

  • Dans la version 1.1.0-preview1 et 1.1.0-preview2, certaines applications non empaquetées ont vu leurs icônes d’application correctement copiées dans AppData\LocalMicrosoftWindowsAppSDK. Pour cette version, ils seront copiés vers AppData\Local\Microsoft\WindowsAppSDK à la place. Pour éviter les fuites d’icônes, vous devez supprimer manuellement l’icône de l’application sur le chemin incorrect après la mise à jour vers la version 1.1.0-preview3.
  • L’icône d’application et la récupération du nom d’affichage de l’application pour les notifications d’application via les raccourcis sont désormais pris en charge. Cette icône d’application sera hiérarchisée par rapport à n’importe quelle icône spécifiée dans les fichiers de ressources.
  • La prise en charge des notifications Push pour les applications non empaquetées a été restaurée (voir Limitations pour l’exception notée). Nous avons introduit l’API PushNotificationManager ::IsSupported pour case activée si votre application prend en charge les notifications Push.

Limitations :

  • Les notifications pour une application élevée non empaquetée ne sont pas prises en charge. PushNotificationManager.IsSupported vérifie l’utilisation du mode avec élévation de privilèges. Toutefois, nous travaillons à la prise en charge de cette version ultérieure.

Création de packages MSIX

Nous avons amélioré MSIX en ajoutant de nouvelles fonctionnalités existantes et en étendant les fonctionnalités existantes via les catégories d’extensions :

  • windows.appExecutionAlias
  • windows.customDesktopEventLog
  • windows.dataShortcuts
  • windows.fileTypeAssociation
  • windows.fileTypeAssociation.iconHandler
  • windows.folder
  • windows.shortcut

Celles-ci nécessitent l’installation du package de framework du SDK d’application Windows. Consultez les derniers téléchargements du SDK d'application Windows pour installer le runtime.

Gestionnaire d’environnement (1.1.0-preview3)

Ensemble d’API qui permet aux développeurs d’ajouter, de supprimer et de modifier des variables d’environnement sans avoir à utiliser directement l’API de Registre.

Clarification de la version 1.1 Preview 1 : suppression automatique de toutes les modifications de variable d’environnement lorsqu’une application qui a utilisé le gestionnaire d’environnement est désinstallée est disponible uniquement pour les applications empaquetées. En outre, la restauration des modifications des variables d’environnement nécessite l’installation du package d’infrastructure du Kit de développement logiciel (SDK) d’application Windows, consultez Derniers téléchargements pour le Kit de développement logiciel (SDK) d’application Windows pour le runtime.

Autres limitations connues

Régressions de la version 1.1 Aperçu 2 :

  • Pour les applications .NET utilisant des API MRT Core et des applications WinUI qui ne sont pas déployées avec MSIX à projet unique :
    • Les fichiers RESW et image ajoutés au projet en tant qu’éléments existants et précédemment inclus automatiquement dans les groupes d’éléments PRIResource et Content ItemGroups, respectivement, ne seront pas inclus dans ces ItemGroups. Par conséquent, ces ressources ne seront pas indexées pendant la génération IRP. Elles ne seront donc pas disponibles pendant l’exécution.
      • Solution de contournement : incluez manuellement les ressources dans le fichier projet et supprimez-les du ItemGroup None.
      • Solution de contournement alternative : quand elle est disponible, mettez à niveau le Kit de développement logiciel (SDK) .NET de vos applications vers la version 6.0.300. Pour plus d’informations, consultez la configuration requise pour le Kit de développement logiciel (SDK) .NET.
  • Pour les applications .NET qui ne sont pas déployées avec MSIX à projet unique :
    • Si un fichier est ajouté au Content ItemGroup deux fois ou plus, une erreur de build s’affiche.
      • Solution de contournement : supprimez l’inclusion/s dupliquée ou définissez EnableDefaultContentItems sur false dans le fichier projet.

Les deux régressions seront restaurées dans la prochaine version stable.

Version 1.1 Aperçu 2 (1.1.0-preview2)

Il s’agit de la deuxième version du canal de préversion pour la version 1.1. Il prend en charge tous les aperçus fonctionnalités du canal (consultez Fonctionnalités disponibles par canal de publication).

Dans une application existante utilisant SDK d'application Windows 1.0, vous pouvez mettre à jour votre package Nuget vers 1.1.0-preview2 (consultez la section Mettre à jour un package dans Installer et gérer des packages dans Visual Studio à l'aide du gestionnaire de packages NuGet). De plus, reportez-vous à la rubrique Derniers téléchargements du SDK d'application Windows pour obtenir le runtime et le MSIX mis à jour.

Remarque

Pour les développeurs C#, l’une des versions suivantes du SDK .NET est requise : 6.0.202, 6.0.104, 5.0.407, 5.0.213 (ou version ultérieure). Pour mettre à jour votre version du SDK .NET, consultez Téléchargements .NET ou mettez à jour vers la dernière version de Visual Studio. Sans la version requise du SDK .NET, lors de la mise à jour de votre package NuGet, vous verrez une erreur du type : « Cette version de WindowsAppSDK nécessite WinRT.Runtime.dll version 1.6 ou ultérieure ».

En plus de toutes les fonctionnalités de l'aperçu 1, les sections suivantes décrivent les fonctionnalités nouvelles et mises à jour, les limitations et les problèmes connus pour cette version.

Notifications (1.1.0-preview2)

Problèmes résolus :

  • Une application sans identité de package qui envoie des notifications voit désormais son icône d’application dans la notification si l’icône fait partie de la ressource de l’application. Si la ressource d’application n’a pas d’icône, l’icône d’application par défaut Windows est utilisée.
  • Une application WinUI 3 qui n’est pas en cours d’exécution peut désormais être activée en arrière-plan via une notification.

Régression de la version 1.1 Preview 1 : prise en charge des notifications Push pour les applications non empaquetées. On s’attend à ce qu’elle soit restaurée dans la prochaine version.

Limitations connues :

  • Nous avons introduit l’API PushNotificationManager ::IsSupported pour case activée si les applications autonomes prennent en charge les notifications Push. Toutefois, cette API ne fonctionne pas encore comme prévu. Gardez donc un œil dans la prochaine préversion pour obtenir une prise en charge complète de l’API IsSupported.
  • Certaines applications non empaquetées verront leurs icônes d’application copiées incorrectement dans AppData\LocalMicrosoftWindowsAppSDK. Pour la prochaine version, ils seront copiés vers AppData\Local\Microsoft\WindowsAppSDK à la place. Pour éviter les fuites d’icônes, le développeur doit supprimer manuellement son icône d’application au chemin incorrect après la mise à niveau vers la prochaine version.
  • L’icône d’application et la récupération du nom d’affichage de l’application pour les notifications via les raccourcis n’est pas prise en charge. Mais nous travaillons à la prise en charge de cela dans une prochaine version.

Déploiement

Nouvelles fonctionnalités :

Limitations connues :

  • Le déploiement autonome est pris en charge uniquement sur Windows 10, 1903 et versions ultérieures.

Fenêtrage

Pour faciliter la programmation de l’accès aux fonctionnalités implémentées dans USER32.dll (consultez Fenêtres et messages), cette version fait apparaître une plus grande partie de ces fonctionnalités dans AppWindow lui-même.

Nouvelles fonctionnalités :

  • Les applications avec des fenêtres existantes ont plus de contrôle sur la façon dont une fenêtre est affichée, en appelant AppWindow.ShowOnceWithRequestedStartupState, l’équivalent de ShowWindow(SW_SHOWDEFAULT).
  • Les applications peuvent afficher, réduire ou restaurer une fenêtre tout en spécifiant si la fenêtre doit être activée ou non au moment où l’appel est effectué.
  • Les applications peuvent désormais définir la taille de la zone cliente d’une fenêtre dans les coordonnées Win32.
  • Nous avons ajouté des API pour prendre en charge la gestion z-order des fenêtres.
  • Les applications dessinant des barres de titre personnalisées avec AppWindowTitleBar.ExtendsContentIntoTitleBar peuvent définir une option PreferredTitleBarHeight. Vous avez le choix entre une barre de titre de hauteur standard et une barre de titre haute qui laisse plus de place au contenu interactif. Consultez Barre de titre dans les instructions de conception Fluent pour obtenir des conseils sur l’utilisation d’une barre de titre haute.

Limitations connues :

  • La prise en charge de la barre de titre de grande taille est disponible uniquement sur Windows 11. Nous travaillons à réduire ce niveau avec d’autres API de barre de titres personnalisées.

WinUI 3 (1.1.0-preview2)

Problèmes résolus :

  • Résolution d’un problème entraînant le blocage des applications C# avec WebView2 au lancement lorsque le runtime C/C++ (CRT) n’était pas installé en mettant à niveau le SDK WebView2 de la version 1020.46 vers la version 1185.39.
  • Correction d’un problème entraînant l’affichage d’un dégradé dans certains coins arrondis alors qu’ils devaient être de couleur unie. Pour plus d’informations, consultez les problèmes 6076 et problèmes 6194 sur GitHub.
  • Correction d’un problème où les styles mis à jour étaient manquants dans generic.xaml.
  • Correction d’un problème de cycle de disposition provoquant le blocage d’une application lors du défilement jusqu’à la fin d’un contrôle ListView. Pour plus d’informations, consultez le problème 6218 sur GitHub.

Performances

Les applications C# ont plusieurs améliorations de performances. Pour plus d’informations, consultez les notes de publication C#/WinRT 1.6.1.

Version 1.1 Aperçu 1 (1.1.0-preview1)

Il s’agit de la première version du canal de préversion pour la version 1.1. Il prend en charge tous les aperçus fonctionnalités du canal (consultez Fonctionnalités disponibles par canal de publication).

Dans une application existante utilisant SDK d'application Windows 1.0, vous pouvez mettre à jour votre package Nuget vers 1.1.0-preview1 (consultez la section Mettre à jour un package dans Installer et gérer des packages dans Visual Studio à l'aide du gestionnaire de packages NuGet). De plus, reportez-vous à la rubrique Derniers téléchargements du SDK d'application Windows pour obtenir le runtime et le MSIX mis à jour.

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

WinUI 3 (1.1.0-preview1)

Problème connu : les utilisateurs ne parviennent pas à déposer un élément lorsque la fonction « glisser-déposer » est activée.

Prise en charge élevée (administrateur)

À l’aide du Kit de développement logiciel (SDK) d’application Windows 1.1 Preview 1, les applications (y compris WinUI 3) peuvent s’exécuter avec des privilèges élevés.

Limitations importantes :

  • Disponible uniquement sur Windows 11 Mais nous évaluons la mise en place de cette prise en charge dans une version ultérieure.

Problèmes connus :

  • Les applications WinUI 3 avec élévation de privilèges se bloquent lors du glissement d’un élément lors d’une interaction glisser-déplacer.

Déploiement autonome

Le Kit de développement logiciel (SDK) d’application Windows 1.1 introduit la prise en charge du déploiement autonome. Consultez la Vue d’ensemble du déploiement du SDK d’application Windows pour connaître les différences entre le déploiement autonome et dépendant du framework, et découvrir comment commencer.

Problèmes connus :

  • Une application C++ empaquetée doit ajouter les éléments ci-dessous au bas de son fichier projet pour contourner un bogue dans le fichier autonome .targets qui supprime les références d’infrastructure à VCLibs :

    <PropertyGroup>
    <IncludeGetResolvedSDKReferences>true</IncludeGetResolvedSDKReferences>
</PropertyGroup>

<Target Name="_RemoveFrameworkReferences"
    BeforeTargets="_ConvertItems;_CalculateInputsForGenerateCurrentProjectAppxManifest">
    <ItemGroup>
        <FrameworkSdkReference Remove="@(FrameworkSdkReference)" Condition="'%(FrameworkSdkReference.SDKName)' == 'Microsoft.WindowsAppRuntime.1.1-preview1'" />
    </ItemGroup>
</Target>

  • Pris en charge uniquement sur Windows 10, 1903 et les versions ultérieures.

Notifications (1.1.0-preview1)

Les développeurs d’applications empaquetées (y compris empaquetées avec un emplacement externe) et non empaquetées peuvent désormais envoyer des notifications Windows.

Nouvelles fonctionnalités :

  • Prise en charge des notifications d’application pour les applications empaquetées et non empaquetées. Détails complets sur GitHub
    • Les développeurs peuvent envoyer des notifications d’application, également appelées notifications toast, localement ou à partir de leur propre service cloud.
  • Prise en charge des notifications push pour les applications empaquetées et non empaquetées. Détails complets sur GitHub
    • Les développeurs peuvent envoyer des notifications brutes et des notifications d’application à partir de leur propre service cloud.

Limitations :

  • Les applications publiées en tant qu’autonomes peuvent ne pas prendre en charge les notifications Push. Gardez un œil dans la prochaine préversion d’une API IsSupported pour case activée pour la prise en charge des notifications Push.
  • Les applications qui ne sont pas empaquetées envoyant des notifications d’application ne voient pas leur icône d’application dans la notification de l’application, sauf si elles sont des applications console. Les applications console qui ne sont pas empaquetées doivent suivre les modèles indiqués dans l’exemple ToastNotificationsDemoApp.
  • Le runtime du Kit de développement logiciel (SDK) d’application Windows doit être installé pour prendre en charge les notifications Push, consultez Derniers téléchargements du SDK d'applications Windows d’application Windows pour le programme d’installation.
  • Une application WinUI 3 qui n’est pas en cours d’exécution ne peut pas être activée en arrière-plan via une notification. Mais nous travaillons à la prise en charge de cela dans une prochaine version.

Gestionnaire d’environnement (1.1.0-preview1)

Ensemble d’API qui permet aux développeurs d’ajouter, de supprimer et de modifier des variables d’environnement sans avoir à utiliser directement l’API de Registre.

Nouvelles fonctionnalités :

  • Fournit la suppression automatique de toutes les variables d’environnement modifiées lorsqu’une application qui a utilisé le gestionnaire d’environnement est désinstallée.

Limitations :

  • Actuellement indisponible dans les applications C#. Mais nous évaluons l’ajout de cette fonctionnalité aux applications C# dans une version ultérieure.

Autres limitations et problèmes connus

  • Si vous utilisez C# avec la version 1.1.0 Preview 1, vous devez utiliser l’une des versions suivantes du SDK .NET au minimum : .NET SDK 6.0.201, 6.0.103, 5.0.212 ou 5.0.406. Pour mettre à jour votre version du SDK .NET, consultez Téléchargements .NET ou mettez à jour vers la dernière version de Visual Studio.