Freigeben über


Versionshinweise für WebView2-SDK

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

1.0.3650.58

Veröffentlichungsdatum: 8. Dezember 2025

NuGet-Paket für WebView2 SDK 1.0.3650.58

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

Höherstufungen auf Phase 3 (stabil in Release)

Es wurden keine zusätzlichen APIs von Phase 2: Stable in Vorabversion auf Phase 3: Stable in Release in diesem Release SDK heraufgestuft.

Fehlerbehebungen

Nur Runtime
  • Der Zugriff auf das lokale Netzwerk wurde behoben, der ein Popupfenster für eine Berechtigungswarnung ausgelöst hat.

1.0.3712-Vorabversion

Veröffentlichungsdatum: 8. Dezember 2025

NuGet-Paket für WebView2 SDK 1.0.3712-prerelease

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

Höherstufungen auf Phase 1 (Experimentell in Vorabversion)

Die folgenden APIs befinden sich in Phase 1: Experimentell in Vorabversion und wurden in diesem Vorabversions-SDK hinzugefügt.

Anpassen des Portbereichsverhaltens

Die zulässigen Portbereichs-APIs ermöglichen das Einschränken oder Anpassen der Netzwerkportbereiche, die WebView2 für verschiedene Transportprotokolle und -bereiche verwenden kann. Dies bietet eine erweiterte Sicherheitskontrolle.

  • Verwenden Sie SetAllowedPortRange für die CoreWebView2EnvironmentOptions (oder ICoreWebView2ExperimentalEnvironmentOptions) instance, um Porteinschränkungen während der Umgebungserstellung zu konfigurieren.

    • Verwenden Sie den scope Parameter, um anzugeben, ob die Konfiguration für alle Komponenten (Default) oder nur für WebRTC-Peer-zu-Peer-Verbindungen (WebRtc) gilt. Derzeit wird nur WebRtc unterstützt.

    • Verwenden Sie den protocol -Parameter, um das Transportprotokoll anzugeben (unterstützt derzeit Udp).

    • Geben Sie minPort die Werte und maxPort zwischen 1025 und 65535 (einschließlich) an, oder verwenden Sie (0,0), um Einschränkungen zurückzusetzen/zu entfernen.

  • Verwenden Sie GetEffectiveAllowedPortRange für die CoreWebView2EnvironmentOptions (oder ICoreWebView2ExperimentalEnvironmentOptions) instance, um die Konfiguration des aktiven Portbereichs für einen bestimmten Bereich und ein bestimmtes Protokoll abzurufen.

    • Gibt den explizit festgelegten Bereich für den angegebenen Bereich zurück oder erbt vom Default Bereich, falls nicht festgelegt.

    • Gibt (0,0) zurück, wenn für den angegebenen Bereich keine Einschränkungen konfiguriert sind.

Höherstufungen auf Phase 2 (stabil in Vorabversion)

Die folgenden APIs wurden von Phase 1: Experimental in Prerelease zu Phase 2: Stable in Prerelease heraufgestuft und sind in diesem Vorabversions-SDK enthalten.

Anpassen des Drag-and-Drop-Verhaltens (DragStarting-API)

Die DragStarting API überschreibt das standardmäßige Drag-and-Drop-Verhalten, wenn sie im visuellen Hostingmodus ausgeführt wird. Das DragStarting Ereignis benachrichtigt Ihre App, wenn der Benutzer einen Ziehvorgang in WebView2 startet, und stellt den Zustand bereit, der erforderlich ist, um den Standardmäßigen WebView2-Ziehvorgang mit Ihrer eigenen Logik außer Kraft zu setzen.

  • Verwenden Sie DragStarting für die ICoreWebView2CompositionController5 , um einen Ereignishandler hinzuzufügen, der aufgerufen wird, wenn der Ziehvorgang gestartet wird.
  • Verwenden Sie ICoreWebView2DragStartingEventArgs , um einen eigenen Ziehvorgang zu starten.
    • Verwenden Sie die GetDeferral -Methode, um eine beliebige asynchrone Ziehlogik auszuführen und zu einem späteren Zeitpunkt wieder in webView aufzurufen.
    • Verwenden Sie die Handled -Eigenschaft, um WebView2 wissen zu lassen, ob eine eigene Ziehlogik verwendet werden soll.

Fehlerbehebungen

Dieses Vorabversions-SDK enthält die folgenden Fehlerbehebungen.

Nur Runtime
  • Der Zugriff auf das lokale Netzwerk wurde behoben, der ein Popupfenster für eine Berechtigungswarnung ausgelöst hat.
  • Eine Regression der setColorScheme API wurde behoben.
  • Die verzögerte Initialisierung für ICoreWebView2NewWindowRequestedEventArgs für den Befehlszeilenschalter enable-new-window-requested-deferred-initializationwurde behoben.

1.0.3595.46

Veröffentlichungsdatum: 3. November 2025

NuGet-Paket für WebView2 SDK 1.0.3595.46

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

Höherstufungen auf Phase 3 (stabil in Release)

Es wurden keine zusätzlichen APIs von Phase 2: Stable in Vorabversion auf Phase 3: Stable in Release in diesem Release SDK heraufgestuft.

Fehlerbehebungen

Dieses Release SDK enthält die folgenden Fehlerbehebungen.

Nur Runtime
  • Die Erstellung eines "Spekulativen Renderer"-Prozesses wurde deaktiviert.

1.0.3650-Vorabversion

Veröffentlichungsdatum: 7. November 2025

NuGet-Paket für WebView2 SDK 1.0.3650-prerelease

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

Höherstufungen auf Phase 1 (Experimentell in Vorabversion)

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

Höherstufungen auf Phase 2 (stabil in Vorabversion)

In diesem Vorabversions-SDK wurden keine APIs von Phase 1: Experimentell in Vorabversion auf Phase 2: Stabil in Vorabversion heraufgestuft.

Fehlerbehebungen

Dieses Vorabversions-SDK enthält die folgenden Fehlerbehebungen.

Nur Runtime
  • Die Erstellung eines "Spekulativen Renderer"-Prozesses wurde deaktiviert.
  • Es wurde ein Problem mit der Synchronisierung des Suchdialogs beim programmgesteuerten Ausführen einer Suche behoben.

1.0.3537.50

Veröffentlichungsdatum: 6. Oktober 2025

NuGet-Paket für WebView2 SDK 1.0.3537.50

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

Höherstufungen auf Phase 3 (stabil in Release)

Es wurden keine zusätzlichen APIs von Phase 2: Stable in Vorabversion auf Phase 3: Stable in Release in diesem Release SDK heraufgestuft.

Fehlerbehebungen

Dieses Release SDK enthält die folgenden Fehlerbehebungen.

Nur Runtime
  • Der Zugriff auf das lokale Netzwerk wurde behoben, der ein Popupfenster für eine Berechtigungswarnung ausgelöst hat.
Nur SDK
  • Ein BinSkim-Fehler für wurde behoben WebView2Loader.dll.

1.0.3590-vorabversion

Veröffentlichungsdatum: 7. Oktober 2025

NuGet-Paket für WebView2 SDK 1.0.3590-prerelease

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

Höherstufungen auf Phase 1 (Experimentell in Vorabversion)

Die folgenden APIs befinden sich in Phase 1: Experimentell in Vorabversion und wurden in diesem Vorabversions-SDK hinzugefügt.

Unterstützung von Vertraulichkeitsbezeichnungen

Eine neue Vertraulichkeitsinformations-API in WebView2 ermöglicht Anwendungen den Zugriff auf Vertraulichkeitsbezeichnungsinformationen, die von Webseiten über den Seiteninteraktionseinschränkungs-Manager übermittelt werden. Mit diesem Feature können Hostanwendungen vertrauliche Inhalte erkennen und darauf reagieren.

Wichtige Funktionen:

  • Konfigurieren der Verfügbarkeit des Seiteninteraktions-Einschränkungs-Managers : Konfigurieren Sie eine Liste von URL-Filtern für den Seiteninteraktionseinschränkungs-Manager. Nachdem die Liste konfiguriert wurde, wird der Seiteninteraktionseinschränkungs-Manager auf Seiten in der Zulassungsliste verfügbar. Diese Seiten können Vertraulichkeitsbezeichnungen über die API an die Plattform senden.

  • Offenlegung von - CoreWebView2 Vertraulichkeitsinformationen macht nun eine SensitivityInfo -Eigenschaft und ein SensitivityInfoChanged -Ereignis verfügbar, sodass Anwendungen auf Aktualisierungen von Vertraulichkeitsbezeichnungsinformationen lauschen können.

Die Unterstützung von Vertraulichkeitsbezeichnungen ist anfänglich nur in Win32 verfügbar. Die Unterstützung für .NET und WinRT ist für eine zukünftige Version geplant.

Höherstufungen auf Phase 2 (stabil in Vorabversion)

In diesem Vorabversions-SDK wurden keine APIs von Phase 1: Experimentell in Vorabversion auf Phase 2: Stabil in Vorabversion heraufgestuft.

Fehlerbehebungen

Dieses Vorabversions-SDK enthält die folgenden Fehlerbehebungen.

Nur Runtime
  • Ein hängenender Zeiger im Zugriffsberechtigungskontext des Dateisystems wurde behoben.
  • Das Hängen der Benutzeroberfläche beim Ziehen und Ablegen in WinUI3 wurde behoben.
  • Der Zugriff auf das lokale Netzwerk wurde behoben, der ein Popupfenster für eine Berechtigungswarnung ausgelöst hat.
  • Es wurde ein Problem behoben, bei dem ein zusätzlicher Bereich in der Zugriffsstruktur angezeigt wurde.
  • Es wurde ein Problem behoben, bei dem Downloads im Standardbrowserframe nicht funktionierten.
Nur SDK
  • Ein BinSkim-Fehler für wurde behoben WebView2Loader.dll.

1.0.3485.44

Veröffentlichungsdatum: 8. September 2025

NuGet-Paket für WebView2 SDK 1.0.3485.44

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

Allgemeine Änderungen

Dieses Release SDK konzentriert sich darauf, webView2 durch Verbesserungen hinter den Kulissen besser funktionieren zu lassen.

  • Die Testinfrastruktur wurde gestärkt.
  • Die Überprüfung von APIs wurde verbessert, um sicherzustellen, dass die APIs in verschiedenen Szenarien zuverlässig funktionieren.

Diese grundlegenden Verbesserungen bieten stabile, gründlich getestete Funktionen zum Erstellen von WebView2-Apps.

Höherstufungen auf Phase 3 (stabil in Release)

Es wurden keine zusätzlichen APIs von Phase 2: Stable in Vorabversion auf Phase 3: Stable in Release in diesem Release SDK heraufgestuft.

Fehlerbehebungen

Dieses Release SDK enthält keine Fehlerbehebungen.

1.0.3530-Prerelease

Veröffentlichungsdatum: 8. September 2025

NuGet-Paket für WebView2 SDK 1.0.3530-prerelease

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

Allgemeine Änderungen

Dieses Vorabversions-SDK konzentriert sich darauf, webView2 durch Verbesserungen hinter den Kulissen besser funktionieren zu lassen.

  • Die Testinfrastruktur wurde gestärkt.
  • Die Überprüfung von APIs wurde verbessert, um sicherzustellen, dass die APIs in verschiedenen Szenarien zuverlässig funktionieren.

Diese grundlegenden Verbesserungen bieten stabile, gründlich getestete Funktionen zum Erstellen von WebView2-Apps.

Höherstufungen auf Phase 1 (Experimentell in Vorabversion)

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

Höherstufungen auf Phase 2 (stabil in Vorabversion)

In diesem Vorabversions-SDK wurden keine APIs von Phase 1: Experimentell in Vorabversion auf Phase 2: Stabil in Vorabversion heraufgestuft.

Fehlerbehebungen

Dieses Vorabversions-SDK enthält die folgenden Fehlerbehebungen.

Nur SDK
  • Ein Speicherverlust im WPF Composition Controller wurde behoben.

1.0.3405.78

Veröffentlichungsdatum: 11. August 2025

NuGet-Paket für WebView2 SDK 1.0.3405.78

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

Höherstufungen auf Phase 3 (stabil in Release)

Die folgenden APIs wurden von Phase 2: Stable in Prerelease auf Phase 3: Stable in Release heraufgestuft und sind jetzt in diesem Release SDK enthalten.

Anpassen des Suchverhaltens (Such-API)

Mit der Such-API können Sie Suchvorgänge programmgesteuert steuern und Ihrer App die folgenden Funktionen hinzufügen:

  • Passen Sie suchoptionen an, einschließlich Ausdruck suchen, Groß-/Kleinschreibung, Word Abgleich, Übereinstimmungsmarkierung und Standardunterdrückung der Benutzeroberfläche.
  • Suchen Sie Textzeichenfolgen, und navigieren Sie zwischen ihnen in einem WebView2-Steuerelement.
  • Programmgesteuertes Initiieren von Suchvorgängen und Navigieren nach Ergebnissen suchen .
  • Unterdrücken Sie die Standard-Find-Benutzeroberfläche .
  • Verfolgen Sie die status von Suchvorgängen nach.

Es gibt bekannte Probleme mit der Such-API für PDF-Dokumente. Wenn Sie ein PDF-Dokument in einem WebView2-Steuerelement anzeigen, stellt das Feature Suchen derzeit nur den ersten Index und die Anzahl der gefundenen Übereinstimmungen bereit. Wenn die Zeichenfolge beispielsweise dreimal in einer PDF-Datei vorkommt, würde die Benutzeroberfläche 1/3 sagen und würde das programmgesteuerte Aufrufen von Next oder Previous nicht unterstützen.

Wir untersuchen diese Probleme aktiv und empfehlen Ihnen, alle auftretenden Probleme mithilfe des WebView2Feedback-Repositorys zu melden.

Fehlerbehebungen

Nur Runtime
  • Ein Absturz in Devtools auf Windows Server und Windows 10 wurde behoben.

1.0.3477-Vorabversion

Veröffentlichungsdatum: 11. August 2025

NuGet-Paket für WebView2 SDK 1.0.3477-prerelease

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

Höherstufungen auf Phase 1 (Experimentell in Vorabversion)

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


Höherstufungen auf Phase 2 (stabil in Vorabversion)

In diesem Vorabversions-SDK wurden keine APIs von Phase 1: Experimentell in Vorabversion auf Phase 2: Stabil in Vorabversion heraufgestuft.

Fehlerbehebungen

Nur Runtime
  • Korrigiert, put_UserAgent dass für Servicemitarbeiter nicht funktioniert.
  • Ein Absturz in Devtools auf Windows Server und Windows 10 wurde behoben.
  • Browserprozessnachverfolgung nach dem Aufrufen remove_BrowserProcessExitedvon entfernt.
  • Es wurde ein Speicherverlustproblem bei hostObject asynchronen Funktionsaufrufen behoben.
  • Behoben, dass die Toucheingabe beim Hosten von Visuals nach einem langen Tippen nicht funktionierte.

1.0.3351.48

Veröffentlichungsdatum: 1. Juli 2025

NuGet-Paket für WebView2 SDK 1.0.3351.48

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

Höherstufungen auf Phase 3 (stabil in Release)

Die folgenden APIs wurden von Phase 2: Stable in Prerelease auf Phase 3: Stable in Release heraufgestuft und sind jetzt in diesem Release SDK enthalten.

Zulassen, dass Eingabeereignisnachrichten das Browserfenster durchlaufen

Die CoreWebView2ControllerOptions -Klasse verfügt jetzt über eine AllowHostInputProcessing -Eigenschaft, mit der Benutzereingabeereignisnachrichten (Tastatur, Maus, Toucheingabe oder Stift) durch das Browserfenster geleitet werden können, die von einem App-Prozessfenster empfangen werden können.

Fehlerbehebungen

Nur Runtime
  • Es wurde ein Blackbox-Problem bei Dialogfeldern beim Hosten von Visuals behoben.

1.0.3415-Vorabversion

Veröffentlichungsdatum: 14. Juli 2025

NuGet-Paket für WebView2 SDK 1.0.3415-prerelease

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

Höherstufungen auf Phase 1 (Experimentell in Vorabversion)

Die folgenden APIs befinden sich in Phase 1: Experimentell in Vorabversion und wurden in diesem Vorabversions-SDK hinzugefügt.

Aktivieren der Hintergrundverarbeitung und Offlineunterstützung (WebView2-Worker-APIs)

Die WebView2-Worker-APIs ermöglichen Hostanwendungen die Interaktion mit Web-Workern, um Aufgaben aus dem Hauptthread auszulagern, die Reaktionsfähigkeit zu verbessern und Hintergrundvorgänge zu unterstützen. Zu diesen Web-Workern gehören dedizierte Worker, freigegebene Worker und Service Worker.

Diese APIs bieten Folgendes:

  • Lebenszyklusereignisse: Überwachen Sie die Erstellung und Zerstörung von Arbeitskräften.
  • Messagingschnittstellen: Kommunizieren Sie mit Workern mithilfe von PostMessage und WebMessageReceived.
  • Workerverwaltung: Abfragen und Abrufen von Workerregistrierungen und -instanzen.
Rendern von benutzerdefinierten Titelleisten (Überlagerungs-API für Fenstersteuerelemente)

Mit der Überlagerungs-API für Fenstersteuerelemente können Entwickler benutzerdefinierte Titelleisten erstellen, indem Untertitel Schaltflächen (Minimieren, Maximieren, Wiederherstellen, Schließen) direkt im WebView2-Fenster gerendert werden. Die Fenstersteuerelementüberlagerung wird in der oberen Ecke der WebView angezeigt und lässt sich nahtlos in die Benutzeroberfläche Ihrer App integrieren.

Verwenden Sie diese API in folgenden Fällen:

  • Sie möchten die Standardtitelleiste des Betriebssystems durch eine vollständig angepasste In-App-Titelleiste ersetzen.
  • Sie arbeiten mit Nicht-Client-Regionsfeatures wie app-region: drag und IsNonClientRegionSupportEnabled.

Diese API eignet sich ideal für Apps, die eine moderne, immersive Benutzeroberfläche erfordern.

Höherstufungen auf Phase 2 (stabil in Vorabversion)

Die folgenden APIs wurden von Phase 1: Experimental in Prerelease zu Phase 2: Stable in Prerelease heraufgestuft und sind in diesem Vorabversions-SDK enthalten.

Anpassen des Suchverhaltens (Such-API)

Mit der Such-API können Sie Suchvorgänge programmgesteuert steuern und Ihrer App die folgenden Funktionen hinzufügen:

  • Passen Sie suchoptionen an, einschließlich Ausdruck suchen, Groß-/Kleinschreibung, Word Abgleich, Übereinstimmungsmarkierung und Standardunterdrückung der Benutzeroberfläche.
  • Suchen Sie Textzeichenfolgen, und navigieren Sie zwischen ihnen in einem WebView2-Steuerelement.
  • Programmgesteuertes Initiieren von Suchvorgängen und Navigieren nach Ergebnissen suchen .
  • Unterdrücken Sie die Standard-Find-Benutzeroberfläche .
  • Verfolgen Sie die status von Suchvorgängen nach.

Es gibt bekannte Probleme mit der Such-API für PDF-Dokumente. Wenn Sie ein PDF-Dokument in einem WebView2-Steuerelement anzeigen, stellt das Feature Suchen derzeit nur den ersten Index und die Anzahl der gefundenen Übereinstimmungen bereit. Wenn die Zeichenfolge beispielsweise dreimal in einer PDF-Datei vorkommt, würde die Benutzeroberfläche 1/3 sagen und würde das programmgesteuerte Aufrufen von Next oder Previous nicht unterstützen.

Wir untersuchen diese Probleme aktiv und empfehlen Ihnen, alle auftretenden Probleme mithilfe des WebView2Feedback-Repositorys zu melden.

Fehlerbehebungen

Nur Runtime
  • Es wurde ein Blackbox-Problem bei Dialogfeldern beim Hosten von Visuals behoben.
  • Korrigiert, put_UserAgent dass für Servicemitarbeiter nicht funktioniert.
  • Absturz in DevTools auf Windows Server und Windows 10 behoben.

Weitere Informationen

API-Referenz: