Partage via

Notes de publication du canal stable pour le SDK d’application Windows 1.3

  • Article

Le canal stable fournit les versions des SDK d’application Windows prises en charge par les applications dans les environnements de production. Les applications qui utilisent la version stable du SDK d’application Windows peuvent également être publiées dans le Microsoft Store.

Liens importants :

Dernière version de la chaîne stable :

Téléchargements pour le SDK d’application Windows

Remarque

Les extensions SDK d'application Windows Visual Studio Extensions (VSIX) ne sont plus distribuées sous forme de téléchargement séparé. Elles sont disponibles dans le Marché Visual Studio à l'intérieur de Visual Studio.

Version 1.3.3 (1.3.230724000)

Il s’agit d’une version de maintenance du SDK d’application Windows qui inclut des correctifs de bogues critiques pour la version 1.3.

  • Correction d’un problème où la souris cessait parfois de fonctionner quand une boîte de dialogue était fermée.
  • Correction d’un problème de déploiement qui empêchait l’installation des applications en raison d’une incompatibilité des versions de package sur le système. Pour plus d’informations, consultez le problème GitHub 3740.
  • Correction d’un problème affectant le positionnement du menu contextuel dans le SDK d’application Windows 1.3.
  • Correction d’un problème entraînant le blocage de certaines applications WinUI3, dans certains cas, pendant la fermeture de l’application, car XAML s’arrêtait trop tôt.
  • Correction d’un problème où les icônes de police n’étaient pas correctement mises en miroir dans les langues de droite à gauche. Pour plus d’informations, consultez le problème GitHub 7661.
  • Correction d’un problème entraînant le blocage d’une application à l’arrêt quand les ressources étaient détruites dans le mauvais ordre. Pour plus d’informations, consultez le problème GitHub 7924.

Version 1.3.2 (1.3.230602002)

Il s’agit d’une version de maintenance du SDK d’application Windows qui inclut des correctifs de bogues critiques pour la version 1.3.

  • Correction d’un plantage au moment de la définition d’un curseur protégé.
  • Correction d’un problème de performances dans XamlMetadataProvider au démarrage d’une application. Pour plus d’informations, consultez le problème GitHub #8281.
  • Correction d’un problème lié aux liens hypertexte et à l’interaction tactile dans un RichTextBlock. Pour plus d’informations, consultez le problème GitHub #6513.
  • Correction d’un problème lié au défilement et aux pavés tactiles dans WebView2. Pour plus d’informations, consultez le problème GitHub #7772.
  • Correction d’un problème rendant parfois nécessaire le redémarrage de Visual Studio quand le SDK d’application Windows est mis à jour. Pour plus d’informations, consultez le problème GitHub #3554.
  • Correction d’une exception bruyante à l’arrêt en cas d’exécution dans un débogueur.

Version 1.3.1 (1.3.230502000)

Il s’agit d’une version de maintenance du SDK d’application Windows qui inclut des correctifs de bogues critiques pour la version 1.3.

  • Correction d’un problème provoquant le blocage des applications lors de la définition de SystemBackdrop si le contenu était null. Pour plus d’informations, consultez le problème GitHub #8416.
  • Résolution d’un problème provoquant le blocage des applications lors de la définition du titre de la fenêtre en XAML, une nouvelle fonctionnalité ajoutée dans la version 1.3.0. Pour plus d’informations, consultez le problème GitHub #3689.
  • Correction d’un problème où une fenêtre prenait le focus de manière incorrecte lorsque son contenu changeait.
  • Correction d’un problème lié à la création de projets C++ avec les modèles de projet WinAppSDK 1.3.
  • Modèles mis à jour sur la Place de marché Visual Studio

nouvelles fonctionnalités, mises à jour et problèmes connus pour la version 1.3

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

Dans une application du SDK d’application Windows 1.2 existante, vous pouvez mettre à jour votre package Nuget vers la version 1.3.230331000 (voir la section Mettre à jour un package dans Installer et gérer des packages dans Visual Studio à l’aide du Gestionnaire de package NuGet).

Pour obtenir le runtime et le MSIX mis à jour, consultez les derniers téléchargements du SDK d'application Windows.

API de toile de fond XAML

Avec les propriétés intégrées à la fenêtre XAML, les toiles de fond Mica & arrière-plan Acrylic sont désormais plus faciles à utiliser dans votre application WinUI 3. Pour plus d’informations sur les propriétés de toile de fond Xaml, consultez la documentation sur la Toile de fond système et l’API de Toile de fond Mica.

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.

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.
  • 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 la spécification de l’API Échecs de recherche de ressources XAML de suivi sur GitHub.

Autres mises à jour

  • Consultez notre jalon WinAppSDK 1.3 sur le GitHub WinAppSDK pour connaître les problèmes supplémentaires résolus dans cette version.
  • Consultez notre jalon WinUI 3 dans WinAppSDK 1.3 sur le GitHub microsoft-ui-xaml pour connaître les problèmes supplémentaires traités dans cette version.
  • 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.

Problème connu

En raison d’une modification récente du compilateur xaml, un projet existant qui effectue une mise à niveau vers la version 1.3 peut rencontrer une erreur de build comme celle-ci dans Visual Studio :

> C:\Users\user\\.nuget\packages\microsoft.windowsappsdk\\**1.3.230331000**\buildTransitive\Microsoft.UI.Xaml.Markup.Compiler.interop.targets(537,17): error MSB4064: The "PrecompiledHeaderFile" parameter is not supported by the "CompileXaml" task loaded from assembly: Microsoft.UI.Xaml.Markup.Compiler, Version=1.0.0.0, Culture=neutral, PublicKeyToken=de31ebe4ad15742b from the path: C:\Users\user\\.nuget\packages\microsoft.windowsappsdk\\**1.2.230118.102**\tools\net472\Microsoft.UI.Xaml.Markup.Compiler.dll. Verify that the parameter exists on the task, the <UsingTask> points to the correct assembly, and it is a settable public instance property.

Cela est causé par l’utilisation par Visual Studio d’une dll de tâche de compilateur xaml mise en cache de la version 1.2 avec une logique MSBuild incompatible de la version 1.3, comme indiqué dans le texte d’erreur ci-dessus. La solution de contournement consiste à arrêter Visual Studio, à le redémarrer et à recharger la solution.