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

1.0.2792.45

Date de publication : 23 septembre 2024

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

Pour une compatibilité complète de l’API, cette version release du Kit de développement logiciel (SDK) WebView2 nécessite WebView2 Runtime version 129.0.2792.45 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

KIT de développement logiciel (SDK) uniquement

1.0.2839-préversion

Date de publication : 23 septembre 2024

Package NuGet pour le Kit de développement logiciel (SDK) WebView2 1.0.2839-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 130.0.2839.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
  • Correction d’un problème où le fait de se concentrer sur un contrôle WebView2 dans WinAppSDK avec le paramètre Windows « Faire défiler les fenêtres inactives » désactivé entraînait l’échec du défilement.
  • Bloqué edge://wallet dans WebView2. (Problème n° 4710)
  • Effacez la variable d’environnement pour la couleur d’arrière-plan par défaut dans les contrôles WebView2 .NET une fois la création du contrôleur terminée.
  • Activation de la prise en charge de l’accessibilité pour Webview2 en mode d’hébergement visuel.
  • Correction d’un bogue avec la suppression d’un filtre « ressource web demandée » pour plusieurs sources lorsque l’une d’elles est Document.
  • Correction d’une régression où DataList n’était pas visible dans WinUI ou dans d’autres instances WebView2 hébergées visuellement.
KIT de développement logiciel (SDK) uniquement
  • Correction d’une dépendance sdk pour les projets .NET. (Problème n° 4743)
  • Correction d’un problème de compatibilité lors de l’appel GetAvailableBrowserVersionString() avec un ancien WebView2Loader.dll. (Problème #4395)
  • Correction de problèmes lors de la compilation du code généré par wv2winrt avec les cpp20 options et /permissive- .
  • Ajout de .NET 8 TargetFramework pour C# WinRT, activation de la compatibilité AOT (avant-temps) et désactivation du marshaling du runtime.

1.0.2739.15

Date de publication : 26 août 2024

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

Pour une compatibilité complète de l’API, cette version Release du Kit de développement logiciel (SDK) WebView2 nécessite webView2 Runtime version 128.0.2739.15 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.

Gestion des notifications web

Ajout de la prise en charge de la notification web pour les notifications non persistantes. L’événement NotificationReceived pour CoreWebView2 contrôle la gestion des notifications web, ce qui permet la personnalisation ou la suppression par l’application hôte. Les notifications non gérées sont par défaut l’interface utilisateur de WebView2.

Enregistrer sous

Ajout SaveAs d’API qui vous permettent d’effectuer par programmation l’opération Enregistrer sous . Vous pouvez utiliser ces API pour bloquer la boîte de dialogue Enregistrer sous par défaut, puis enregistrer en mode silencieux ou créer votre propre interface utilisateur pour Enregistrer sous. Ces API se rapportent uniquement à la boîte de dialogue Enregistrer sous , et non à la boîte de dialogue Télécharger , qui continue d’utiliser les API de téléchargement existantes.

Bogue

Il n’y a aucun correctif de bogue dans ce Kit de développement logiciel (SDK) release.

1.0.2783-préversion

Date de publication : 26 août 2024

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

Pour une compatibilité complète avec l’API, cette préversion du Kit de développement logiciel (SDK) WebView2 nécessite le runtime WebView2 fourni avec Microsoft Edge version 129.0.2783.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)
  • Réactive le comportement par défaut de SetUserAgent: par défaut, SetUserAgent est efficace pour les iframes cross-origin.
Runtime uniquement

  • Activation par défaut de la fonctionnalité de glissement interactif. Voir edge-webview-interactive-dragging dans indicateurs de navigateur WebView2.

  • Désactivé IsolateSandboxedIframes pour WebView2.

  • Correction d’un problème où la création de WebView échoue lorsque plusieurs instances sont lancées en même temps. (Problème n° 4731)

  • Correction d’un bogue dans la projection JavaScript WinRT où la mise en cache des propriétés existantes dans les objets dont le nom contient Proxy ou Function provoquait une erreur en raison d’une collision de noms.

  • Correction d’un bogue dans lequel le contrôle WebView2 devenait de taille incorrecte après la déconnexion et la reconnexion d’un moniteur.

  • Correction d’un problème où les liens « mailto : » laissèrent une fenêtre contextuelle sans titre ouverte, au lieu de fermer automatiquement la fenêtre contextuelle.

KIT de développement logiciel (SDK) uniquement

  • La projection WinRT C# fonctionne désormais sur UWP.

  • Correction d’un problème pour s’assurer que GeneratedFilesDir ne s’affiche plus dans Visual Studio pour la projection WinRT C#.

Voir également