Partage via

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

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

La dernière version disponible de la traçabilité 0.8.x du canal stable du SDK d’application Windows est la version 0.8.12.

Notes

Le kit SDK Windows App était connu sous le nom de code Project Reunion. Certaines ressources du SDK dans les versions 0.8 et antérieures utilisent toujours le nom de code. Certaines parties de la documentation utilisent toujours Project Reunion quand elles font référence à un composant existant ou à une version antérieure spécifique.

Version 0.8.12

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

Notes

Pour les développeurs C#, l’une des versions suivantes du SDK .NET est requise : 5.0.213, 5.0.407, 6.0.104, 6.0.202 (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 ».

Correctifs de bogues (0.8.12)

  • Résolution d’un problème où les applications avec SwapChainPanel ou WebView2 se bloquaient de façon imprévisible en raison d’une violation d’accès.

Version 0.8.11

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

Notes

Pour les développeurs C#, l’une des versions suivantes du SDK .NET est requise : 5.0.213, 5.0.407, 6.0.104, 6.0.202 (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 ».

Correctifs de bogues (0.8.11)

  • Correction de la régression provoquant le déclenchement de l’événement de focus perdu lors de la sélection de texte à l’aide de la souris.

Version 0.8.10

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

Notes

Pour les développeurs C#, l’une des versions suivantes du SDK .NET est requise : 5.0.213, 5.0.407, 6.0.104, 6.0.202 (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 ».

Correctifs de bogues (0.8.10)

  • Correction de problèmes entraînant parfois le blocage des applications lors d’une opération de glisser-déplacer.

Notes

Le SDK d’application Windows 0.8.9 n’a pas été publié. La version publiée directement après la version 0.8.8 est 0.8.10.

Version 0.8.8

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

Notes

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 ».

Correctifs de bogues (0.8.8)

  • Correction des problèmes d’entrée tactile dans TextBox concernant le clavier logiciel et l’interaction générale. Ces problèmes affectaient également les raccourcis clavier. Pour plus d’informations, consultez le problème 6291 sur GitHub.
  • Correction d’un problème où une fenêtre d’application s’affichait parfois comme inactive alors qu’elle était active.
  • Correction d’un problème de performances provoqué par l’exécution d’UIA (UI Automation) dans des processus externes.
  • Correction du problème de stabilité de l’application avec l’entrée du stylet.
  • Résolution d’un problème où le rendu des icônes png dans un menu était considérablement retardé en raison d’UIA.

Version 0.8.7

Il s’agit d’une version de maintenance du SDK d’application Windows qui inclut plusieurs mises à jour de performances pour les applications C#/.NET. Pour effectuer une mise à jour vers cette version, vous devez référencer la dernière version du package du SDK Windows. Pour ce faire, ajoutez la propriété <WindowsSdkPackageVersion>10.0.<sdk_version>.24</WindowsSdkPackageVersion> à votre fichier .csproj avec la version du SDK que votre application cible à partir de la propriété TargetFramework. Exemple :

<Project Sdk="Microsoft.NET.Sdk">
   <PropertyGroup>
       <OutputType>WinExe</OutputType>
       <TargetFramework>net6.0-windows10.0.19041.0</TargetFramework>
       <TargetPlatformMinVersion>10.0.17763.0</TargetPlatformMinVersion>
       <WindowsSdkPackageVersion>10.0.19041.24</WindowsSdkPackageVersion>
   <PropertyGroup>
   ...

Cette version de projection du SDK Windows sera disponible dans une prochaine version de maintenance de .NET 6. Une fois la mise à jour du SDK .NET disponible, vous devez supprimer la propriété <WindowsSdkPackageVersion> de votre fichier projet.

Si vous ne définissez pas cette propriété, vous verrez une erreur comme : "Error: This version of Project Reunion requires WinRT.Runtime.dll version 1.6 or greater."

Version 0.8.6

Il s’agit d’une version de maintenance du SDK d’application Windows qui inclut plusieurs améliorations des performances pour les applications C#/.NET pour la version 0.8.0.

Pour effectuer une mise à jour vers cette version du SDK d’application Windows, vous devez avoir installé la dernière mise à jour de décembre du SDK .NET (voir Télécharger .NET et .NET 5 atteindra la fin du support le 10 mai 2022). Si vous n’avez pas la version minimale requise du Kit de développement logiciel (SDK) .NET, une erreur semblable à celle-ci s’affiche. "Error: This version of Project Reunion requires WinRT.Runtime.dll version 1.4 or greater."

Correctifs de bogues (0.8.6)

Pour obtenir une liste détaillée des améliorations apportées aux performances, consultez les notes de publication de C#/WinRT 1.4.1.

Version 0.8.5

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

Correctifs de bogues (0.8.5)

  • Résolution du problème qui provoquait le blocage des applications WinUI utilisant l’entrée de pointeur.
  • Correction d’un problème qui empêchait les boutons de la barre de titre (min, max, close) d’avoir des coins arrondis sur Windows 11.
  • Résolution d’un problème empêchant l’affichage des options de disposition de redimensionnement lors du pointage sur le bouton Agrandir/Restaurer sur Windows 11.
  • Correction d’un problème provoquant une exception de blocage lors de la création d’un objet PointCollection. Pour plus d’informations, consultez le problème 971 sur GitHub.

Les limitations et les problèmes connus pour la version 0.8 s’appliquent également à la version 0.8.5, sauf indication contraire dans la section ci-dessous.

Version 0.8.4

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

Correctifs de bogues (0.8.4)

  • Corrige les barres de titre personnalisées afin que ContentDialog ne les couvre pas et que les boutons de la barre de titre soient arrondis.
  • Correction d’un blocage dans le traitement des images lorsque l’échelle d’affichage est modifiée.
  • Corrige les bogues de découpage où l’interface utilisateur disparaît ou se coupe incorrectement

Les limitations et les problèmes connus pour la version 0.8 s’appliquent également à la version 0.8.4, sauf indication contraire dans la section ci-dessous.

Version 0.8.3

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

Correctifs de bogues (0.8.3)

Le focus clavier était perdu lorsqu’une fenêtre était réduite, puis restaurée, nécessitant un clic de souris pour restaurer le focus.

Les limitations et les problèmes connus pour la version 0.8 s’appliquent également à la version 0.8.3, sauf indication contraire dans la section ci-dessous.

Version 0.8.2

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

Correctifs de bogues (0.8.2)

  • Le SDK d’application Windows et WinUI 3 sont désormais pris en charge dans Visual Studio 2022 Preview 2 et versions ultérieures.
  • Pour les applications .NET, vous pouvez recevoir l’erreur suivante lors du passage d’un tableau d’énumérations : Object contains non-primitive or non-blittable data.
  • L’écriture à l’aide du panneau d’écriture manuscrite à l’intérieur d’une zone de texte provoque un blocage
  • Les icônes/images se chargent toujours à leur valeur d’échelle de 100 % plutôt qu’en fonction de la valeur d’échelle du moniteur
  • Le nettoyage de mémoire d’EventSource<T> entraîne l’échec ultérieur de la désinscription des gestionnaires (consultez ce problème GitHub pour plus d’informations)
  • Correctif de sécurité : pour plus d’informations, consultez CVE-2021-34533.
  • SwapChainPanel.CompositionScaleChanged retourne parfois des valeurs CompositionScale incorrectes après modification de l’échelle d’affichage

Les limitations et les problèmes connus pour la version 0.8 s’appliquent également à la version 0.8.2, sauf indication contraire dans la section ci-dessous.

Version 0.8.1

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

Correctifs de bogues (0.8.1)

  • Le SDK d’application Windows ne peut pas s’exécuter sur la dernière version de Windows Insider
  • Blocage dans EditableComboBox lors de l’entrée d’une valeur qui n’apparaît pas dans la liste déroulante
  • WebView2 ne permet pas à l’utilisateur d’utiliser la tabulation une fois que le focus a été reçu
  • Qualifier entièrement l’espace de noms Windows.Foundation.Metadata.DefaultOverload dans le code généré WinUI pour éviter toute ambiguïté de l’espace de noms
    • Cela corrige le bogue #5108.
  • Correctif de sécurité : consultez CVE-2021-34489 pour plus d’informations.

Les limitations et les problèmes connus pour la version 0.8 s’appliquent également à la version 0.8.1, sauf indication contraire dans la section ci-dessous.

Version 0.8.0 stable

Nouvelles fonctionnalités et mises à jour

Cette version prend en charge toutes les fonctionnalités du canal stable.

WinUI 3 :

Cette version inclut de nombreux correctifs de bogues et une stabilisation améliorée dans WinUI 3. Voici toutes les nouvelles modifications apportées à WinUI 3 depuis la publication de WinUI 3 - Project Reunion 0.5 :

  • Le contrôle Pivot a été rajouté et peut désormais être utilisé dans n’importe quelle application WinUI 3.

  • Tous les correctifs de bogues de Project Reunion v0.5.5, v0.5.6 et v0.5.7 sont inclus dans cette version.

  • Nouveaux correctifs de bogues, notamment :

    • Cliquer avec le bouton droit dans TextBox fait planter l’application
    • NavigationView provoque un plantage dans Project Reunion 0.5 Preview dans la plateforme UWP
    • La barre de progression ne montre pas la différence entre l’option Mise en pause et Erreur
    • Blocage dans RichEditBox lors de la copie/du collage/de la modification du style de texte
    • Les boutons de légende d’une fenêtre sont mal placés quand SetTitleBar n’est pas défini ou a la valeur null

    Pour obtenir la liste complète des bogues résolus dans cette version, consultez notre référentiel GitHub.

  • L’API ColorHelper.ToDisplayName n’est plus disponible.

  • Les types suivants ont été supprimés :

    • Microsoft.Graphics.IGeometrySource2D
    • Microsoft.Graphics.IGeometrySource2DInterop

    Utilisez plutôt Windows.Graphics.IGeometrySource2D et Windows.Graphics.IGeometrySource2DInterop.

  • Tous les types de l’espace de noms Microsoft.System ont été déplacés vers l’espace de noms Microsoft.UI.Dispatching, y compris la classe DispatcherQueue.

  • La propriété AcrylicBrush.BackgroundSource a été supprimée, car HostBackdrop n’est pas pris en charge en tant que BackgroundSource dans WinUI 3.

Pour plus d’informations sur WinUI, consultez WinUI.

Pour profiter des contrôles et fonctionnalités 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 Microsoft Store.

Pour commencer à développer avec WinUI, consultez les articles suivants :

DWriteCore :

Cette version de DWriteCore inclut les fonctionnalités nouvelles et mises à jour suivantes. DWriteCore est présenté et décrit dans la Vue d’ensemble de DWriteCore.

Notes

DWriteCoreCreateFactory est fonctionnellement identique à la fonction DWriteCreateFactory exportée par la version système de DirectWrite. La fonction DWriteCore a un nom différent pour éviter toute ambiguïté dans le cas où vous liez à la fois DWriteCore.lib et DWrite.lib.

Pour obtenir des informations de référence sur les API DWriteCore et DirectWrite, consultez Informations de référence sur l’API DWriteCore et Informations de référence sur l’API DirectWrite.

MRTCore :

  • L’action Générer pour les ressources est automatiquement définie lorsque vous ajoutez la ressource à votre projet, ce qui réduit la nécessité d’une configuration manuelle du projet.

Limitations

  • Cette version n’est actuellement pas prise en charge sur le canal de développement du Programme Windows Insider. Ce problème est résolu dans la version 0.8.1.

  • Applications de bureau (C# ou C++ de bureau) : cette version est prise en charge uniquement pour une utilisation dans les applications de bureau (C++ ou C#) qui sont empaquetées à l’aide de MSIX. Pour utiliser le SDK d’application Windows dans les applications de bureau non empaquetées, vous devez utiliser le canal de version expérimentale.

Important

Si vous utilisez une application UWP, consultez Migrer d’UWP vers le SDK d’application Windows.

Problèmes connus

  • Les outils WinUI 3, comme l’arborescence d’éléments visuels en temps réel, l’explorateur de propriétés en temps réel et le rechargement à chaud dans les versions 0.8 et ultérieures nécessitent Visual Studio 2019 16.11 Preview 3 et versions ultérieures.

  • Les applications qui utilisent actuellement WinUI 3 et le SDK d’application Windows 0.8 ne peuvent pas utiliser les bibliothèques de classes qui utilisent Project Reunion 0.5. Mettez à jour les bibliothèques de classes pour utiliser le SDK d’application Windows 0.8.

  • 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 votre projet d’empaquetage doit être défini sur 18362 ou version ultérieure. Pour plus d’informations, consultez le problème GitHub 921.

  • Vous pouvez rencontrer un blocage lorsque vous basculez fréquemment entre le mode clair et le mode sombre.

  • Pour les applications .NET, vous pouvez recevoir l’erreur suivante lors de la transmission d’un tableau d’énumérations : Object contains non-primitive or non-blittable data. ceci est résolu dans la version 0.8.2.

  • Pour les applications .NET, il n’existe actuellement aucun moyen de refuser l’indexation d’une image en tant que ressource d’application à l’aide de l’interface utilisateur de Visual Studio. Pour contourner ce problème, ajoutez un objet Directory.Build.targets (voir Personnaliser votre build - Visual Studio pour obtenir des instructions) au projet et supprimez la ou les images comme suit :

    • Pour supprimer des images spécifiques (notez que le chemin relatif est nécessaire) :

      <Project>
<ItemGroup>
    <Content Remove="..\Bitmap1.bmp" />
</ItemGroup>
</Project>
      • Pour supprimer des images basées sur des métadonnées :
      <Project>
<ItemGroup>
    <Content Remove="@(None->WithMetadataValue('Pack','true'))" />
</ItemGroup>
</Project>

      Un correctif de ce problème est prévu pour une prochaine version . À ce stade, les solutions de contournement ci-dessus ne seront plus nécessaires.