Partager via

Notes de publication pour le SDK WebView2

  • Article

Ces notes de publication fournissent des informations sur les nouvelles fonctionnalités et les correctifs de bogues inclus dans le Kit de développement logiciel (SDK) WebView2 Release et le Kit de développement logiciel (SDK) de préversion WebView2.

1.0.3124.44

Date de publication : 10 mars 2025

Package NuGet pour le Kit de développement logiciel (SDK) WebView2 1.0.3124.44

Pour une compatibilité complète de l’API, cette version Release du Kit de développement logiciel (SDK) WebView2 nécessite WebView2 Runtime version 134.0.3124.44 ou ultérieure.

Promotions

Aucune API supplémentaire n’a été promue stable et ajoutée dans ce Kit de développement logiciel (SDK) release.

Bogue

Runtime uniquement
  • Les extensions ne seront pas désactivées dans WebView2 à l’aide AddBrowserExtensionAsyncde , que le mode développeur soit activé ou non. (Problème n° 5113)
  • Désactivation de la mise à jour en arrière-plan de l’heure réseau. (Problème n° 5047)
  • Correction de l’affichage de la fenêtre contextuelle de téléchargement lorsque target="_blank". (Problème n° 5063)

1.0.3171-préversion

Date de publication : 10 mars 2025

Package NuGet pour webView2 SDK 1.0.3171-prerelease

Pour une compatibilité complète de l’API, cette version préliminaire du Kit de développement logiciel (SDK) WebView2 nécessite le runtime WebView2 fourni avec Microsoft Edge version 135.0.3171.0 ou ultérieure.

API expérimentales

Aucune API expérimentale n’a été ajoutée dans ce Kit de développement logiciel (SDK) préversion.

Promotions

Aucune API n’a été promue d’Expérimentale à Stable dans ce KIT de développement logiciel (SDK) préversion.

Bogue

Runtime et KIT de développement logiciel (SDK)
  • Correction de la gestion des exceptions de méthode asynchrone de l’objet hôte. (Problème #3402)
  • Correction de la documentation pour CoreWebVIew2.Navigate. (Problème n° 5091)
Runtime uniquement
  • Correction d’une régression d’installation du magasin « Ajouter à Chrome ».
  • Correction des chargements de dossiers dans UWP et WinUI. (Problème n° 3275)
  • Les extensions ne seront pas désactivées dans WebView2 à l’aide AddBrowserExtensionAsyncde , que le mode développeur soit activé ou non. (Problème n° 5113)
  • Désactivation de la mise à jour en arrière-plan de l’heure réseau. (Problème n° 5047)
  • Correction de l’affichage de la fenêtre contextuelle de téléchargement lorsque target="_blank". (Problème n° 5063)
KIT de développement logiciel (SDK) uniquement
  • Corrige un incident qui peut se produire lorsque le garbage collector appelle Finalize sur un thread autre que le thread main.

1.0.3065.39

Date de publication : 10 février 2025

Package NuGet pour le Kit de développement logiciel (SDK) WebView2 1.0.3065.39

Pour une compatibilité complète de l’API, cette version Release du Kit de développement logiciel (SDK) WebView2 nécessite WebView2 Runtime version 133.0.3065.39 ou ultérieure.

Promotions

Aucune API supplémentaire n’a été promue stable et ajoutée dans ce Kit de développement logiciel (SDK) release.

Bogue

Runtime uniquement
  • Ajout du bouton Fermer manquant dans le menu volant Télécharger .
  • Correction d’une condition de concurrence qui se produisait lorsque l’événement de réponse à la demande web ne se produisait jamais.

1.0.3116-préversion

Date de publication : 10 février 2025

Package NuGet pour webView2 SDK 1.0.3116-preversion

Pour une compatibilité complète des API, cette version préliminaire du Kit de développement logiciel (SDK) WebView2 nécessite le runtime WebView2 fourni avec Microsoft Edge version 134.0.3116.0 ou ultérieure.

API expérimentales

Aucune API expérimentale n’a été ajoutée dans ce Kit de développement logiciel (SDK) préversion.

Promotions

Aucune API n’a été promue d’Expérimentale à Stable dans ce KIT de développement logiciel (SDK) préversion.

Bogue

Runtime uniquement
  • Ajout du bouton Fermer manquant dans le menu volant Télécharger .
  • Correction d’une condition de concurrence qui se produisait lorsque l’événement de réponse à la demande web ne se produisait jamais.
KIT de développement logiciel (SDK) uniquement
  • Correction de la documentation .NET et Win32 de la CoreWebView2Find.FindNext méthode qui a mentionné FindPreviousincorrectement . Le résumé de la méthode mentionne FindNext maintenant à la place. (Problème n° 5059)

1.0.2957.106

Date de publication : 20 janvier 2025

Package NuGet pour le Kit de développement logiciel (SDK) WebView2 1.0.2957.106

Pour une compatibilité complète de l’API, cette version release du Kit de développement logiciel (SDK) WebView2 nécessite WebView2 Runtime version 132.0.2957.106 ou ultérieure.

Promotions

Les API suivantes ont été promues en Stable et sont désormais incluses dans ce Kit de développement logiciel (SDK) release.

Afficher les éléments WPF au-dessus de la couche WebView2 (WebView2CompositionControl)

Le WebView2CompositionControl empêche le contrôle WebView2 d’être la couche supérieure d’une application WPF et de masquer tous les éléments WPF. Microsoft.Web.WebView2.Wpf.WebView2CompositionControl remplace le contrôle WebView2 WPF standard. WebView2 contrôle et WebView2CompositionControl implémente l’interface Microsoft.Web.WebView2.Wpf.IWebView2 . Les deux dérivent de FrameworkElement, comme suit :

  • FrameworkElement ->HwndHost ->WebView2.
  • FrameworkElement ->Control ->WebView2CompositionControl.

Arrière-plan : si vous créez une application Windows Presentation Foundation (WPF) et que vous utilisez le contrôle WebView2, vous pouvez constater que votre application rencontre des problèmes d'« espace aérien », où le contrôle WebView2 est toujours affiché en haut, masquant tous les éléments WPF au même emplacement, même si vous essayez de spécifier les éléments WPF au-dessus du contrôle WebView2 (à l’aide de l’arborescence visuelle ou de la propriété z-index, par exemple).

Ce problème se produit car le contrôle WPF utilise le WPF HwndHost pour héberger le contrôle Win32 WebView2 et HwndHost présente un problème avec l’espace aérien.

Voir aussi :

Bogue

Runtime uniquement
  • Correction d’une régression dans laquelle les modifications d’affichage peuvent entraîner le rendu de WebView2 plus petit que la fenêtre d’application.
KIT de développement logiciel (SDK) uniquement
  • Correction d’un problème dans WPF WebView2CompositionControl où il n’était pas affiché s’il était initialisé avec une taille (0,0), par exemple quand il était initialisé dans un TabItem d’un TabControl. (Problème n° 4941)

1.0.3079-préversion

Date de publication : 24 janvier 2025

Package NuGet pour le Kit de développement logiciel (SDK) WebView2 1.0.3079-prerelease

Pour une compatibilité complète de l’API, cette préversion du Kit de développement logiciel (SDK) WebView2 nécessite le runtime WebView2 fourni avec Microsoft Edge version 134.0.3079.0 ou ultérieure.

API expérimentales

Les API expérimentales suivantes ont été ajoutées dans ce Kit de développement logiciel (SDK) préversion.

Personnaliser le comportement de recherche (API De recherche)

L’API Find vous permet de contrôler par programmation les opérations Find et d’ajouter les fonctionnalités suivantes à votre application :

  • Personnalisez les options Rechercher, notamment Rechercher un terme, Respect de la casse, Correspondance Word, Mise en surbrillance des correspondances et Suppression de l’interface utilisateur par défaut.
  • Recherchez des chaînes de texte et naviguez entre elles dans un contrôle WebView2.
  • Lancez par programmation des opérations De recherche et accédez à Rechercher les résultats.
  • Supprimez l’interface utilisateur De recherche par défaut.
  • Suivez la status des opérations De recherche.

Il existe des problèmes connus avec l’API Rechercher pour les documents PDF. Lorsque vous affichez un document PDF dans un contrôle WebView2, la fonctionnalité Rechercher fournit uniquement le premier index et le nombre de correspondances trouvées. Par exemple, si la chaîne se produit trois fois dans un fichier PDF, l’interface utilisateur indique 1/3 et ne prend pas en charge l’appel programmatique suivant ou précédent. Nous étudions activement ces problèmes et vous encourageons à signaler les problèmes que vous rencontrez à l’aide du dépôt WebView2Feedback .

Personnaliser le comportement de glisser-déplacer (API DragStarting)

L’API DragStarting remplace le comportement glisser-déplacer par défaut lors de l’exécution en mode d’hébergement visuel. L’événement DragStarting avertit votre application lorsque l’utilisateur démarre une opération de glissement dans le WebView2 et fournit l’état nécessaire pour remplacer l’opération de glissement WebView2 par défaut par votre propre logique.

  • Utilisez DragStarting sur pour ICoreWebView2ExperimentalCompositionController6 ajouter un gestionnaire d’événements appelé lorsque l’opération de glissement démarre.
  • Utilisez ICoreWebView2ExperimentalDragStartingEventArgs pour démarrer votre propre opération de glissement.
    • Utilisez la GetDeferral méthode pour exécuter une logique de glissement asynchrone et rappeler dans WebView ultérieurement.
    • Utilisez la Handled propriété pour indiquer au WebView2 s’il faut utiliser sa propre logique de glissement.
Suivre l’historique de navigation pour les iframes imbriqués (API FrameCreatedEvent)

L’API FrameCreatedEvent prend en charge les iframes imbriqués, comme l’enregistrement de l’historique de navigation d’un iframe de deuxième niveau. Sans cette API, WebView2 effectue uniquement le suivi des iframes de premier niveau, qui sont les iframes enfants directs du frame main. À l’aide de cette API, votre application peut s’abonner à l’événement de création d’iframe imbriqué, ce qui lui donne accès à toutes les propriétés, méthodes et événements de CoreWebView2Frame pour l’iframe imbriqué.

Utilisez cette API pour gérer le suivi des iframes sur une page qui contient plusieurs niveaux d’iframes. Vous pouvez choisir de suivre l’un des éléments suivants :

  • Seul le main page et les iframes de premier niveau (comportement par défaut).
  • Arborescence de trames WebView2 partielle avec des iframes spécifiques intéressants.
  • Arborescence complète des images WebView2.
Définir la couleur d’arrière-plan par défaut sur l’initialisation WebView2 (API DefaultBackgroundColor)

L’API DefaultBackgroundColor permet aux utilisateurs de définir la propriété lors de l’initialisation DefaultBackgroundColor . Cela empêche un flash blanc perturbateur pendant le processus de chargement de WebView2.

Promotions

Les API suivantes ont été promues de Experimental à Stable dans ce Kit de développement logiciel (SDK) préversion.

Afficher les éléments WPF au-dessus de la couche WebView2 (WebView2CompositionControl)

Le WebView2CompositionControl empêche le contrôle WebView2 d’être la couche supérieure d’une application WPF et de masquer tous les éléments WPF. Microsoft.Web.WebView2.Wpf.WebView2CompositionControl remplace le contrôle WebView2 WPF standard. WebView2 contrôle et WebView2CompositionControl implémente l’interface Microsoft.Web.WebView2.Wpf.IWebView2 . Les deux dérivent de FrameworkElement, comme suit :

  • FrameworkElement ->HwndHost ->WebView2.
  • FrameworkElement ->Control ->WebView2CompositionControl.

Arrière-plan : si vous créez une application Windows Presentation Foundation (WPF) et que vous utilisez le contrôle WebView2, vous pouvez constater que votre application rencontre des problèmes d'« espace aérien », où le contrôle WebView2 est toujours affiché en haut, masquant tous les éléments WPF au même emplacement, même si vous essayez de spécifier les éléments WPF au-dessus du contrôle WebView2 (à l’aide de l’arborescence visuelle ou de la propriété z-index, par exemple).

Ce problème se produit car le contrôle WPF utilise le WPF HwndHost pour héberger le contrôle Win32 WebView2 et HwndHost présente un problème avec l’espace aérien.

Voir aussi :

Bogue

Runtime uniquement
  • Correction d’une régression dans laquelle les modifications d’affichage peuvent entraîner le rendu de WebView2 plus petit que la fenêtre d’application.
  • Activation de la IsolateSandboxedIframes fonctionnalité amont pour WebView2.
  • La suppression d’un worker de service a été empêchée lorsque la version change.
  • L’API CleanUpSome dans Hostobject effectue désormais uniquement le garbage collection pour le tas complet. CleanUpSome a été supprimé du moteur V8.
  • Correction d’une régression de AreBrowserAcceleratorKeysEnabled. (Problème n° 5033)
  • Correction d’un bogue qui IsDefaultDownloadDialogOpenChanged n’était pas déclenché lorsqu’une boîte de dialogue était fermée à l’aide du clavier. (Problème n° 4807)
KIT de développement logiciel (SDK) uniquement
  • Correction d’un problème dans WPF WebView2CompositionControl où il n’était pas affiché s’il était initialisé avec une taille (0,0), par exemple quand il était initialisé dans un TabItem d’un TabControl. (Problème n° 4941)

1.0.2903.40

Date de publication : 18 novembre 2024

Package NuGet pour le Kit de développement logiciel (SDK) WebView2 1.0.2903.40

Pour une compatibilité complète avec l’API, cette version release du Kit de développement logiciel (SDK) WebView2 nécessite WebView2 Runtime version 131.0.2903.40 ou ultérieure.

Promotions

Les API suivantes ont été promues en Stable et sont désormais incluses dans ce Kit de développement logiciel (SDK) release.

Contrôler si l’interface utilisateur de capture d’écran est affichée (événement ScreenCaptureStarting)

Ajout d’un nouvel ScreenCaptureStarting événement. Cet événement est déclenché chaque fois que l’iframe WebView2 et/ou qui correspond au (ou à l’un CoreWebView2Frame de ses iframes descendants) demande l’autorisation d’utiliser l’API Capture d’écran avant l’affichage de l’interface utilisateur. L’application peut ensuite bloquer l’affichage de l’interface utilisateur ou autoriser l’affichage de l’interface utilisateur.

Bogue

Runtime uniquement
  • Autorisé la boîte de dialogue Télécharger à recevoir le focus initial au lancement.

Modifications générales

  • Le runtime Microsoft Edge WebView2 n’est plus répertorié dans Paramètres> WindowsApplications>Installées, car il s’agit d’un composant système persistant.

1.0.2950-préversion

Date de publication : 18 novembre 2024

Package NuGet pour le Kit de développement logiciel (SDK) WebView2 1.0.2950-prerelease

Pour une compatibilité complète de l’API, cette version préliminaire du Kit de développement logiciel (SDK) WebView2 nécessite le runtime WebView2 fourni avec Microsoft Edge version 132.0.2950.0 ou ultérieure.

API expérimentales

Aucune API expérimentale n’a été ajoutée dans ce Kit de développement logiciel (SDK) préversion.

Promotions

Aucune API n’a été promue d’Expérimentale à Stable dans ce KIT de développement logiciel (SDK) préversion.

Bogue

Runtime uniquement
  • Autorisé la boîte de dialogue Télécharger à recevoir le focus initial au lancement.
  • Correction d’un incident lors de l’annulation de la navigation vers certains sites dans FrameNavigationStarting. (Problème n° 4843)
  • Report de la personnalisation du menu contextuel lorsque le menu de sélection tactile est affiché. (Problème n° 4737)
KIT de développement logiciel (SDK) uniquement
  • Ajout de la prise en charge d’Arm64ec.
  • Correction d’un problème où WebView2 exécuté en mode « Fenêtre vers visuel » ne pouvait pas recevoir d’entrée d’accélérateur.

1.0.2849.39

Date de publication : 21 octobre 2024

Package NuGet pour le Kit de développement logiciel (SDK) WebView2 1.0.2849.39

Pour une compatibilité complète de l’API, cette version Release du Kit de développement logiciel (SDK) WebView2 nécessite WebView2 Runtime version 130.0.2849.39 ou ultérieure.

Promotions

Les API suivantes ont été promues en Stable et sont désormais incluses dans ce Kit de développement logiciel (SDK) release.

Configurer l’avertissement de sécurité lors de l’enregistrement d’un fichier (SaveFileSecurityCheckStarting événement)

Ajout d’un nouvel SaveFileSecurityCheckStarting événement. Votre application peut inscrire un gestionnaire sur cet événement pour obtenir le chemin d’accès au fichier, l’extension de nom de fichier et les informations de l’URI d’origine du document. Vous pouvez ensuite appliquer vos propres règles pour effectuer des actions telles que les suivantes :

  • Autorisez l’enregistrement du fichier sans présenter d’interface utilisateur d’avertissement de sécurité par défaut concernant la stratégie de type de fichier.
  • Annulez l’enregistrement.
  • Créez votre propre interface utilisateur pour gérer les stratégies de type de fichier runtime.

Bogue

Runtime uniquement
  • Correction d’un problème de focus de boîte de dialogue Télécharger lorsque vous appuyez sur Tab ou Maj+Tab pour basculer dans le contrôle Webview2.
KIT de développement logiciel (SDK) uniquement
  • L’utilisation CoreWebView2.AddWebResourceRequestedFilter sans CoreWebView2WebResourceRequestSourceKinds paramètre est désormais déconseillée. Consultez la méthode .NET CoreWebView2.AddWebResourceRequestedFilter.
  • Ajout de .NET 8 TargetFramework pour C# WinRT, activation de la compatibilité AOT (avant-temps) et désactivation du marshaling du runtime.

1.0.2895-préversion

Date de publication : 21 octobre 2024

Package NuGet pour le Kit de développement logiciel (SDK) WebView2 1.0.2895-prerelease

Pour une compatibilité complète de l’API, cette version préliminaire du Kit de développement logiciel (SDK) WebView2 nécessite le runtime WebView2 fourni avec Microsoft Edge version 131.0.2895.0 ou ultérieure.

API expérimentales

Les API expérimentales suivantes ont été ajoutées dans ce Kit de développement logiciel (SDK) préversion.

RestartRequested événement lorsque WebView2 doit redémarrer

Ajout d’un nouvel RestartRequested événement. L’événement RestartRequested est déclenché chaque fois que WebView2 doit redémarrer pour appliquer des mises à jour ou des modifications de configuration. Vous pouvez utiliser cette API pour détecter quand WebView2 doit redémarrer et prendre les mesures appropriées. La Priority propriété des arguments d’événement RestartRequested indique la priorité de la demande de redémarrage :

  • High indique que l’application doit inviter les utilisateurs à redémarrer dès que possible.
  • Normal indique que l’application doit rappeler aux utilisateurs de redémarrer, au mieux.

Promotions

Les API suivantes ont été promues de Experimental à Stable dans ce Kit de développement logiciel (SDK) préversion.

Contrôler si l’interface utilisateur de capture d’écran est affichée (ScreenCaptureStarting événement)

Ajout d’un nouvel ScreenCaptureStarting événement. Cet événement est déclenché chaque fois que l’iframe WebView2 et/ou qui correspond au (ou à l’un CoreWebView2Frame de ses iframes descendants) demande l’autorisation d’utiliser l’API Capture d’écran avant l’affichage de l’interface utilisateur. L’application peut ensuite bloquer l’affichage de l’interface utilisateur ou autoriser l’affichage de l’interface utilisateur.

Configurer l’avertissement de sécurité lors de l’enregistrement d’un fichier (SaveFileSecurityCheckStarting événement)

Ajout d’un nouvel SaveFileSecurityCheckStarting événement. Votre application peut inscrire un gestionnaire sur cet événement pour obtenir le chemin d’accès au fichier, l’extension de nom de fichier et les informations de l’URI d’origine du document. Vous pouvez ensuite appliquer vos propres règles pour effectuer des actions telles que les suivantes :

  • Autorisez l’enregistrement du fichier sans présenter d’interface utilisateur d’avertissement de sécurité par défaut concernant la stratégie de type de fichier.
  • Annulez l’enregistrement.
  • Créez votre propre interface utilisateur pour gérer les stratégies de type de fichier runtime.

Bogue

KIT de développement logiciel (SDK) uniquement
  • Correction de l’incompatibilité Arm64 avec WindowsAppSDK 1.6.
  • Suppression d’un supplément WebView2Loader.dll dans le cas WinAppSDK.
  • L’utilisation CoreWebView2.AddWebResourceRequestedFilter sans CoreWebView2WebResourceRequestSourceKinds paramètre est désormais déconseillée. Consultez la méthode .NET CoreWebView2.AddWebResourceRequestedFilter.

Voir également