Freigeben über

Versionshinweise für WebView2-SDK

  • Artikel

Diese Versionshinweise enthalten Informationen zu neuen Features und Fehlerbehebungen, die im WebView2 Release SDK und im WebView2 Prerelease SDK enthalten sind.

1.0.2849.39

Veröffentlichungsdatum: 21. Oktober 2024

NuGet-Paket für WebView2 SDK 1.0.2849.39

Für vollständige API-Kompatibilität erfordert diese Releaseversion des WebView2 SDK WebView2 Runtime Version 130.0.2849.39 oder höher.

Promotions

Die folgenden APIs wurden zu Stable heraufgestuft und sind jetzt in diesem Release SDK enthalten.

Konfigurieren der Sicherheitswarnung beim Speichern einer Datei (SaveFileSecurityCheckStarting Ereignis)

Ein neues SaveFileSecurityCheckStarting Ereignis wurde hinzugefügt. Ihre App kann einen Handler für dieses Ereignis registrieren, um den Dateipfad, die Dateinamenerweiterung und die URI-Informationen zum Dokumentursprung abzurufen. Sie können dann Ihre eigenen Regeln anwenden, um Aktionen wie die folgenden auszuführen:

  • Lassen Sie das Speichern der Datei zu, ohne eine Standardmäßige Sicherheitswarnungsbenutzeroberfläche zur Dateityprichtlinie anzuzeigen.
  • Abbrechen des Speicherns.
  • Erstellen Sie eine eigene Benutzeroberfläche, um Laufzeitrichtlinien für Dateitypen zu verwalten.

Fehlerbehebungen

Nur Runtime
  • Es wurde ein Problem mit dem Fokus des Dialogfelds "Herunterladen " behoben, wenn tab oderUMSCHALT+TAB gedrückt wurde, um in das Webview2-Steuerelement zu wechseln.
Nur SDK
  • Die Verwendung ohne CoreWebView2.AddWebResourceRequestedFilter Parameter CoreWebView2WebResourceRequestSourceKinds ist jetzt veraltet. Weitere Informationen finden Sie unter .NET CoreWebView2.AddWebResourceRequestedFilter-Methode.
  • .NET 8 TargetFramework für C# WinRT hinzugefügt, AOT-Kompatibilität (Ahead-of-Time) aktiviert und Runtime-Marshalling deaktiviert.

1.0.2895-Vorabversion

Veröffentlichungsdatum: 21. Oktober 2024

NuGet-Paket für WebView2 SDK 1.0.2895-prerelease

Für vollständige API-Kompatibilität erfordert diese Vorabversion des WebView2 SDK die WebView2-Runtime, die im Lieferumfang von Microsoft Edge Version 131.0.2895.0 oder höher enthalten ist.

Experimentelle APIs

Die folgenden experimentellen APIs wurden in diesem Vorabversions-SDK hinzugefügt.

RestartRequested Ereignis, wenn WebView2 neu gestartet werden muss

Ein neues RestartRequested Ereignis wurde hinzugefügt. Das RestartRequested Ereignis wird immer dann ausgelöst, wenn WebView2 neu gestartet werden muss, um Updates oder Konfigurationsänderungen anzuwenden. Sie können diese API verwenden, um zu erkennen, wann WebView2 neu gestartet werden muss, und entsprechende Aktionen auszuführen. Die Priority -Eigenschaft der RestartRequested Ereignisargumente gibt die Priorität der Neustartanforderung an:

  • High gibt an, dass die App die Benutzer so schnell wie möglich zum Neustart auffordern soll.
  • Normal gibt an, dass die App die Benutzer auf der Grundlage der bestmöglichen Leistung an einen Neustart erinnern soll.

Promotions

Die folgenden APIs wurden in diesem Vorabversions-SDK von Experimentell auf Stabil heraufgestuft.

Steuern, ob die Bildschirmaufnahme-Benutzeroberfläche angezeigt wird (ScreenCaptureStarting Ereignis)

Ein neues ScreenCaptureStarting Ereignis wurde hinzugefügt. Dieses Ereignis wird immer dann ausgelöst, wenn webView2 und/oder iframe, das dem CoreWebView2Frame (oder einem seiner Nachfolger-iframes) entspricht, die Berechtigung zur Verwendung der Bildschirmaufnahme-API anfordert, bevor die Benutzeroberfläche angezeigt wird. Die App kann dann die Anzeige der Benutzeroberfläche blockieren oder die Anzeige der Benutzeroberfläche zulassen.

Konfigurieren der Sicherheitswarnung beim Speichern einer Datei (SaveFileSecurityCheckStarting Ereignis)

Ein neues SaveFileSecurityCheckStarting Ereignis wurde hinzugefügt. Ihre App kann einen Handler für dieses Ereignis registrieren, um den Dateipfad, die Dateinamenerweiterung und die URI-Informationen zum Dokumentursprung abzurufen. Sie können dann Ihre eigenen Regeln anwenden, um Aktionen wie die folgenden auszuführen:

  • Lassen Sie das Speichern der Datei zu, ohne eine Standardmäßige Sicherheitswarnungsbenutzeroberfläche zur Dateityprichtlinie anzuzeigen.
  • Abbrechen des Speicherns.
  • Erstellen Sie eine eigene Benutzeroberfläche, um Laufzeitrichtlinien für Dateitypen zu verwalten.

Fehlerbehebungen

Nur SDK
  • Die Arm64-Inkompatibilität mit WindowsAppSDK 1.6 wurde behoben.
  • Zusätzliches WebView2Loader.dll im WinAppSDK-Fall entfernt.
  • Die Verwendung ohne CoreWebView2.AddWebResourceRequestedFilter Parameter CoreWebView2WebResourceRequestSourceKinds ist jetzt veraltet. Weitere Informationen finden Sie unter .NET CoreWebView2.AddWebResourceRequestedFilter-Methode.

1.0.2792.45

Veröffentlichungsdatum: 23. September 2024

NuGet-Paket für WebView2 SDK 1.0.2792.45

Für vollständige API-Kompatibilität erfordert diese Releaseversion des WebView2 SDK WebView2 Runtime Version 129.0.2792.45 oder höher.

Promotions

Es wurden keine zusätzlichen APIs zu Stable heraufgestuft und in diesem Release SDK hinzugefügt.

Fehlerbehebungen

Nur SDK
  • Eine SDK-Abhängigkeit für .NET-Projekte wurde behoben. (Problem 4743)

1.0.2839-Vorabversion

Veröffentlichungsdatum: 23. September 2024

NuGet-Paket für WebView2 SDK 1.0.2839-prerelease

Für vollständige API-Kompatibilität erfordert diese Vorabversion des WebView2 SDK die WebView2-Runtime, die im Lieferumfang von Microsoft Edge Version 130.0.2839.0 oder höher enthalten ist.

Experimentelle APIs

In diesem Vorabversions-SDK wurden keine experimentellen APIs hinzugefügt.

Promotions

In diesem Vorabversions-SDK wurden keine APIs von "Experimentell" auf "Stabil" heraufgestuft.

Fehlerbehebungen

Nur Runtime
  • Es wurde ein Problem behoben, bei dem der Fokus auf ein WebView2-Steuerelement in WinAppSDK mit deaktivierter Windows-Einstellung "Inaktive Fenster scrollen" dazu führte, dass der Bildlauf fehlschlägt.
  • In WebView2 blockiert edge://wallet . (Problem 4710)
  • Die Umgebungsvariable wurde für die Standardhintergrundfarbe in .NET WebView2-Steuerelementen gelöscht, nachdem die Erstellung des Controllers abgeschlossen wurde.
  • Barrierefreiheitsunterstützung für Webview2 im visuellen Hostingmodus aktiviert.
  • Es wurde ein Fehler behoben, bei dem der Filter "Webressource angefordert" für mehrere Quellen entfernt wurde, wenn eine davon Dokument ist.
  • Es wurde eine Regression behoben, bei der DataList in WinUI oder anderen visuell gehosteten WebView2-Instanzen nicht sichtbar war.
Nur SDK
  • Eine SDK-Abhängigkeit für .NET-Projekte wurde behoben. (Problem 4743)
  • Ein Kompatibilitätsproblem beim Aufrufen GetAvailableBrowserVersionString() mit einem älteren WebView2Loader.dllwurde behoben. (Problem 4395)
  • Probleme beim Kompilieren von wv2winrt-generiertem Code mit den cpp20 Optionen und /permissive- wurden behoben.
  • .NET 8 TargetFramework für C# WinRT hinzugefügt, AOT-Kompatibilität (Ahead-of-Time) aktiviert und Runtime-Marshalling deaktiviert.

1.0.2739.15

Veröffentlichungsdatum: 26. August 2024

NuGet-Paket für WebView2 SDK 1.0.2739.15

Für vollständige API-Kompatibilität erfordert diese Releaseversion des WebView2 SDK WebView2 Runtime Version 128.0.2739.15 oder höher.

Promotions

Die folgenden APIs wurden zu Stable heraufgestuft und sind jetzt in diesem Release SDK enthalten.

Webbenachrichtigungsverarbeitung

Unterstützung für Webbenachrichtigungen für nicht persistente Benachrichtigungen hinzugefügt. Das NotificationReceived -Ereignis für CoreWebView2 steuert die Webbenachrichtigungsverarbeitung und ermöglicht die Anpassung oder Unterdrückung durch die Host-App. Unbehandelte Benachrichtigungen werden standardmäßig auf der Benutzeroberfläche von WebView2 verwendet.

„Speichern unter“

ApIs hinzugefügt SaveAs , mit denen Sie den Vorgang Speichern unter programmgesteuert ausführen können. Sie können diese APIs verwenden, um das Standarddialogfeld Speichern unter zu blockieren und dann entweder im Hintergrund zu speichern oder eine eigene Benutzeroberfläche für Speichern unter zu erstellen. Diese APIs beziehen sich nur auf das Dialogfeld Speichern unter , nicht auf das Dialogfeld Herunterladen , in dem weiterhin die vorhandenen Download-APIs verwendet werden.

Fehlerbehebungen

Dieses Release SDK enthält keine Fehlerbehebungen.

1.0.2783-Vorabversion

Veröffentlichungsdatum: 26. August 2024

NuGet-Paket für WebView2 SDK 1.0.2783-prerelease

Für vollständige API-Kompatibilität erfordert diese Vorabversion des WebView2 SDK die WebView2-Runtime, die im Lieferumfang von Microsoft Edge Version 129.0.2783.0 oder höher enthalten ist.

Experimentelle APIs

In diesem Vorabversions-SDK wurden keine experimentellen APIs hinzugefügt.

Promotions

In diesem Vorabversions-SDK wurden keine APIs von "Experimentell" auf "Stabil" heraufgestuft.

Fehlerbehebungen

Runtime und SDK
  • Das Standardverhalten von SetUserAgentwurde erneut aktiviert: ist standardmäßig SetUserAgent für ursprungsübergreifende iframes wirksam.
Nur Runtime

  • Das interaktive Ziehfeature wurde standardmäßig aktiviert. Weitere Informationen finden Sie edge-webview-interactive-dragging unter WebView2-Browserflags.

  • Deaktiviert IsolateSandboxedIframes für WebView2.

  • Es wurde ein Problem behoben, bei dem die WebView-Erstellung fehlschlägt, wenn mehrere Instanzen gleichzeitig gestartet werden. (Problem 4731)

  • Ein Fehler in der WinRT-JavaScript-Projektion wurde behoben, bei dem das Zwischenspeichern vorhandener Eigenschaften in Objekten, deren Name einen Fehler aufgrund eines Namenskonflikts enthält Proxy oder Function verursacht hat.

  • Es wurde ein Fehler behoben, bei dem das WebView2-Steuerelement nach dem Trennen und erneuten Verbinden eines Monitors die falsche Größe anwies.

  • Es wurde ein Problem behoben, bei dem "mailto:"-Links ein unbenanntes Popupfenster geöffnet lassen, anstatt das Popupfenster automatisch zu schließen.

Nur SDK

  • Die C#-WinRT-Projektion funktioniert jetzt auf UWP.

  • Es wurde ein Problem behoben, um sicherzustellen, dass GeneratedFilesDir in Visual Studio für C# WinRT-Projektion nicht mehr angezeigt wird.

1.0.2651.64

Veröffentlichungsdatum: 13. August 2024

NuGet-Paket für WebView2 SDK 1.0.2651.64

Für vollständige API-Kompatibilität erfordert diese Releaseversion des WebView2 SDK WebView2 Runtime Version 127.0.2651.64 oder höher.

Promotions

Die folgenden APIs wurden zu Stable heraufgestuft und sind jetzt in diesem Release SDK enthalten.

  • Die WebMessageObjects-API wurde aktualisiert, um das Einfügen von DOM-Objekten in WebView2-Inhalte zu ermöglichen, die über die App und über die CoreWebView2.PostWebMessage API in die andere Richtung erstellt werden. Ein neuer Webobjekttyp (CoreWebView2FileSystemHandle) wurde hinzugefügt, um ein Dateisystemhandle darzustellen, das an den Webinhalt gepostet werden kann, um diesem Zugriff auf das Dateisystem zu gewähren.

Fehlerbehebungen

Nur Runtime
  • Es wurde eine Regression behoben, bei der WebResourceRequested Ereignisse an bestimmten Standorten abstürzten. (Problem 4602)
Nur SDK
  • x86 für WinRT C#-Projektion korrigiert.

1.0.2730-prerelease

Veröffentlichungsdatum: 7. August 2024

NuGet-Paket für WebView2 SDK 1.0.2730-prerelease

Für vollständige API-Kompatibilität erfordert diese Vorabversion des WebView2 SDK die WebView2-Runtime, die im Lieferumfang von Microsoft Edge Version 128.0.2730.0 oder höher enthalten ist.

Experimentelle APIs

Die folgenden experimentellen APIs wurden in diesem Vorabversions-SDK hinzugefügt.

  • Neue Drosselungssteuerelement-APIs hinzugefügt, die eine effiziente Ressourcenverwaltung ermöglichen, indem Sie JavaScript-Timer drosseln können. Dies ist hilfreich in Szenarien, in denen ein WebView2-Steuerelement sichtbar bleiben muss, aber weniger Ressourcen verbrauchen muss (z. B. wenn der Benutzer nicht mit dem Inhalt interagiert). Diese Drosselungssteuerelement-APIs ermöglichen Folgendes:
    • Anpassen der Drosselung von Skripttimern (setTimeout und setInterval) unter verschiedenen Seitenzuständen (Vordergrund, Hintergrund und Hintergrund mit intensiver Drosselung).
    • Drosseln von Skripttimern in ausgewählten gehosteten iframes.

Promotions

Die folgenden APIs wurden in diesem Vorabversions-SDK von Experimentell auf Stabil heraufgestuft.

  • ApIs hinzugefügt SaveAs , mit denen Sie den Vorgang Speichern unter programmgesteuert ausführen können. Sie können diese APIs verwenden, um das Standarddialogfeld Speichern unter zu blockieren und dann entweder im Hintergrund zu speichern oder eine eigene Benutzeroberfläche für Speichern unter zu erstellen. Diese APIs beziehen sich nur auf das Dialogfeld Speichern unter , nicht auf das Dialogfeld Herunterladen , in dem weiterhin die vorhandenen Download-APIs verwendet werden.
  • Unterstützung für Webbenachrichtigungen für nicht persistente Benachrichtigungen hinzugefügt. Das NotificationReceived -Ereignis für CoreWebView2 steuert die Webbenachrichtigungsverarbeitung und ermöglicht die Anpassung oder Unterdrückung durch die Host-App. Unbehandelte Benachrichtigungen werden standardmäßig auf der Benutzeroberfläche von WebView2 verwendet.

Fehlerbehebungen

Nur Runtime

  • Es wurde ein Problem behoben, bei dem das App-Fenster nicht über Systembefehle (z. B. ALT+F4 oder ALT+LEERTASTE) gesteuert werden konnte, wenn sich der Fokus in WebView2 für den visuellen Hostingmodus befand. (Problem 2961)

  • Es wurde ein Fehler in der WebView2-UWP behoben, bei dem die Suchleiste nicht von der Host-App aus angeklippt werden konnte.

Nur SDK

  • Hinzufügen der fehlenden WinRT-API CoreWebView2Notification.VibrationPattern . Diese WinRT-API kann mit den Versionshinweisen der Stabilen Benachrichtigungs-API für die Heraufstufungs-API kombiniert werden. siehe "Webbenachrichtigung" und NotificationReceived für WinRT direkt oben.

  • Es wurde ein Problem behoben, bei dem KeyDown Ereignisse aus dem WinForms WebView2-Steuerelement nicht die richtigen ModifierKeys Informationen enthalten. (Problem 1216)

  • x86 für WinRT C#-Projektion korrigiert.

  • GetAvailableCoreWebView2BrowserVersionString Wurde CreateCoreWebView2Environment während des Runtimeupdates robuster gegenüber potenziellen Racebedingungen.

1.0.2592.51

Veröffentlichungsdatum: 19. Juni 2024

NuGet-Paket für WebView2 SDK 1.0.2592.51

Für vollständige API-Kompatibilität erfordert diese Releaseversion des WebView2 SDK WebView2 Runtime Version 126.0.2592.51 oder höher.

Promotions

Es wurden keine zusätzlichen APIs zu Stable heraufgestuft und in diesem Release SDK hinzugefügt.

Fehlerbehebungen

Nur Runtime

  • Deaktiviert BreakoutBoxPreferCaptureTimestampInVideoFrame für WebView2 TextureStream.

  • Eine Regression wurde behoben, bei der das Ereignis nur für den WindowCloseRequested ersten window.close() Aufruf ausgelöst wurde.

  • Eine Regression wurde behoben, bei der typisierte Arrays in der WinRT-JavaScript-Projektion nicht wie IDispatch auf dem Host behandelt werden konnten.

  • Es wurde ein Fehler behoben, bei dem das Popup zum automatischen Ausfüllen sofort geschlossen wurde und zu einer Änderung des Fokus führt.

  • Es wurde ein Fehler behoben, bei dem WebView2 aufgrund von AppPolicyGetWindowingModelnicht geladen werden kann. (Problem 4591)

1.0.2646-vorabversion

Veröffentlichungsdatum: 19. Juni 2024

NuGet-Paket für WebView2 SDK 1.0.2646-prerelease

Für vollständige API-Kompatibilität erfordert diese Vorabversion des WebView2 SDK die WebView2-Runtime, die im Lieferumfang von Microsoft Edge Version 128.0.2646.0 oder höher enthalten ist.

Allgemeine Features

  • Unterstützung für C#/WinRT .NET 6 und höher hinzugefügt.

Experimentelle Funktionen

  • Es wurde das Featureflag msWebView2EnableDownloadContentInWebResourceResponseReceivedeingeführt, ein experimentelles Feature (und nicht als stabiles Feature). Wenn dieses Flag aktiviert ist, können Antworten von Navigationen, die zu Downloads werden, in WebResourceResponseReceivedverfügbar sein.

Experimentelle APIs

Die folgenden experimentellen APIs wurden in diesem Vorabversions-SDK hinzugefügt.

  • Ein neues SaveFileSecurityCheckStarting Ereignis wurde hinzugefügt. Als Entwickler können Sie einen Handler für dieses Ereignis registrieren, um den Dateipfad, die Dateinamenerweiterung und die URI-Informationen zum Dokumentursprung abzurufen. Anschließend können Sie Ihre eigenen Regeln anwenden, um Aktionen wie die folgenden auszuführen:
    • Lassen Sie das Speichern der Datei zu, ohne eine Standardmäßige Sicherheitswarnungsbenutzeroberfläche zur Dateityprichtlinie anzuzeigen.
    • Abbrechen des Speicherns.
    • Erstellen Sie eine eigene Benutzeroberfläche, um Laufzeitrichtlinien für Dateitypen zu verwalten.
  • Ein neues ScreenCaptureStarting Ereignis wurde hinzugefügt. Dieses Ereignis wird immer dann ausgelöst, wenn webView2 und/oder iframe, das dem CoreWebView2Frame (oder einem seiner Nachfolger-iframes) entspricht, die Berechtigung zur Verwendung der Bildschirmaufnahme-API anfordert, bevor die Benutzeroberfläche angezeigt wird. Als Entwickler können Sie dann die Anzeige der Benutzeroberfläche blockieren oder die Anzeige der Benutzeroberfläche zulassen.
  • Der .NET-Klasse wurde eine neue GetComICoreWebView2 Methode hinzugefügt, mit der CoreWebView2 Sie eine CoreWebView2 zwischen .NET und COM konvertieren können. Eine neue WinRT-Schnittstelle wurde hinzugefügt, mit der Sie eine CoreWebView2 zwischen WinRT und COM konvertieren können. Dadurch können Sie zwischen Bibliotheken zusammenarbeiten, die in verschiedenen Sprachen geschrieben sind.

Promotions

Die folgenden APIs wurden in diesem Vorabversions-SDK von Experimentell auf Stabil heraufgestuft.

  • Die WebMessageObjects-API wurde aktualisiert, um das Einfügen von DOM-Objekten in WebView2-Inhalte zu ermöglichen, die über die App und über die CoreWebView2.PostWebMessage API in die andere Richtung erstellt werden. Ein neuer Webobjekttyp wurde hinzugefügt, um ein Dateisystemhandle darzustellen, das an den Webinhalt gepostet werden kann, um diesem Zugriff auf das Dateisystem zu gewähren.

Fehlerbehebungen

Nur Runtime
  • Ein Fehler in der Aktivierungslogik des eigenen Fensters für das visuelle Hosting wurde behoben.

1.0.2535.41

Veröffentlichungsdatum: 28. Mai 2024

NuGet-Paket für WebView2 SDK 1.0.2535.41

Für vollständige API-Kompatibilität erfordert diese Releaseversion des WebView2 SDK WebView2 Runtime Version 125.0.2535.41 oder höher.

Promotions

Die folgenden APIs wurden zu Stable heraufgestuft und sind jetzt in diesem Release SDK enthalten.

  • Unterstützung für die Fluent-Formatvorlagen-Überlagerungs-Scrollleiste.

Fehlerbehebungen

Nur Runtime

  • Es wurde ein Fehler behoben, bei dem das LaunchingExternalURIScheme Dialogfeld fälschlicherweise erneut angezeigt wird, wenn der Ereignishandler angefügt ist und das Kontrollkästchen immer speichern aktiviert ist und der Benutzer dieses Kontrollkästchen aktiviert.

  • Es wurde ein Problem behoben, bei dem Textbearbeitungssteuerelemente im visuellen Hosting IME-Eingaben duplizierten, wenn sie verloren und dann den Fokus wiedererlangten.

  • Es wurde ein Problem behoben, bei dem voll vertrauenswürdige UWP-Apps keine eigenen Fenster anzeigen konnten.

Nur SDK
  • Es wurde ein Problem im SDK behoben, das zu fehlerhaften <Plattformwerten> in der Liste der .NET-Projektplattformen führte. (Problem 1755)

1.0.2584-Vorabversion

Veröffentlichungsdatum: 28. Mai 2024

NuGet-Paket für WebView2 SDK 1.0.2584-prerelease

Für vollständige API-Kompatibilität erfordert diese Vorabversion des WebView2 SDK die WebView2-Runtime, die im Lieferumfang von Microsoft Edge Version 126.0.2584.0 oder höher enthalten ist.

Experimentelle Funktionen

  • Es wurde eine Option zum Abbrechen der anfänglichen Navigation in WebView2 eingeführt, um die Startleistung zu verbessern. Diese Änderung ist standardmäßig deaktiviert und kann mithilfe des msWebView2CancelInitialNavigation Featureflags aktiviert werden.

Experimentelle APIs

In diesem Vorabversions-SDK wurden keine experimentellen APIs hinzugefügt.

Promotions

In diesem Vorabversions-SDK wurden keine APIs von "Experimentell" auf "Stabil" heraufgestuft.

Fehlerbehebungen

Runtime und SDK
  • Es wurde ein Absturz behoben, bei dem asynchrone Methoden des .NET-Hostobjekts ein NULL-Ergebnis zurückgeben. (Problem 4509)
Nur Runtime

  • Ein WebView2-Speicherverlust wurde behoben, wenn das Fenster geschlossen wurde. (Problem 4286)

  • Es wurde ein Problem behoben, bei dem ignoreMemberNotFoundError für .NET-Objekte nicht funktionierte. (Problem 4497)

  • Gibt nun einen ordnungsgemäßen Fehlercode zurück, wenn CreateSharedBuffer mit der Puffergröße 0 aufgerufen wird. (Problem 4554)

  • Es wurde ein Aktivierungsproblem für das Dialogfeld zum Durchsuchen von Caretzeichen behoben.

  • Es wurde ein Problem behoben, bei dem das WebView2 Visual Hosting-Ereignis CursorChanged nicht für benutzerdefinierte Cursor ausgelöst wurde.

Weitere Informationen