Vorabversion des SDK 1.0.4255 – Vorabversion, für Runtime 154 (11. September 2026)

Versionshinweise für Microsoft Edge WebView2 Prerelease SDK, Veröffentlichungsdatum: 11. September 2026.

NuGet-Paket für WebView2 SDK 1.0.4255-prerelease

Für vollständige API-Kompatibilität erfordert diese Vorabversion des WebView2-SDK die WebView2-Runtime, die mit Microsoft Edge Version 154.0.4255.0 oder höher ausgeliefert wird. siehe Runtime 154.0.4258.31 (28. September 2026).

Detaillierter Inhalt:

Experimentelle APIs (Phase 1: experimentell in der Vorabversion)

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

LaunchingExternalUriScheme-API auf Frameebene

Das LaunchingExternalUriScheme Ereignis wird nun auch auf CoreWebView2Frameangehoben, zusätzlich zu CoreWebView2. Auf diese Weise kann ein Host einen Start eines externen URI-Schemas (z. B mailto:. , tel:oder ein benutzerdefiniertes Protokoll) dem Spezifischen iframe zuordnen, der ihn initiiert hat. Dies ist nützlich, wenn mehrere Unter-Apps in iframes gehostet werden, auch wenn iframes denselben Ursprung haben.

Das LaunchingExternalUriScheme Ereignis wird ausgelöst, wenn Inhalt in einem frameoder in einer iframe darin verschachtelten Form versucht, ein externes URI-Schema zu starten. Wenn der Start von einem verschachtelten iframeausgeht, sprudelt das Ereignis nach außen durch die verfolgten CoreWebView2Frame Vorfahren – beginnend mit dem nächstgelegenen (innersten) verfolgten Frame und weiter zum obersten Level-Frame – und schließlich zu CoreWebView2. Der Ereignisabsender für jeden Aufruf ist der CoreWebView2Frame Empfänger, der das Ereignis empfängt.

CoreWebView2LaunchingExternalUriSchemeEventArgs verfügt über eine neue Handled Eigenschaft. Handler auf Frameebene werden vor den CoreWebView2Handlern auf -Ebene aufgerufen. Wenn ein Handler auf TRUEFrameebene festgelegt Handled ist, wird das Ereignis nicht für die verbleibenden Vorgängerframes oder auf CoreWebView2ausgelöst. Cancel steuert weiterhin, ob der URI gestartet wird, während Handled gleichzeitig gesteuert wird, ob die verbleibenden Handler aufgerufen werden. Args (einschließlich Cancel und Handled) werden über Ebenen hinweg gemeinsam genutzt; um die Handler auf WebView-Ebene zu unterdrücken, wenn ein Deferral, vor Handled der Verzögerung festgelegt wird.

API für die freigegebene Clusterumgebung

Mit der Shared Cluster Environment-API können kooperierende Hostanwendungen explizit eine WebView2-Umgebung freigeben, einschließlich eines Browserprozesses und eines Benutzerdatenordners, indem sie einer ClusterName. Anwendungen geben keinen Ordnerpfad für Benutzerdaten an. die WebView2-Runtime leitet sie vom Clusternamen ab.

Eine Host-App ruft mit einer CoreWebView2ClusterEnvironmentOptions instance aufCoreWebView2Environment.CreateOrJoinClusterEnvironmentAsync. Der erste Host, der den Cluster einrichtet, bestimmt seine prozessweiten Optionen. Später treten Hosts bei, wenn ihre Optionen übereinstimmen. Diese Optionen bleiben autorisierend, solange der freigegebene Browserprozess ausgeführt wird. Nach dem Beenden kann der nächste Host den Cluster mit verschiedenen Optionen einrichten.

Der obige Vorgang gibt einen CoreWebView2ClusterEnvironmentCreateResult zurück, der ein Status und bei Erfolg die freigegebenen CoreWebView2Environment. Mögliche Werte für Status:

  • Succeeded Zeigt Erfolg an. Eine Freigabe CoreWebView2Environment wird erstellt und zurückgegeben.

  • OptionsMismatch Gibt an, dass ein laufender Cluster verschiedene Optionen hat. Eine Freigabe CoreWebView2Environment wird nicht erstellt und zurückgegeben.

  • NotSupported Gibt an, dass der Host keine Clusterumgebungen verwenden kann, z. B. einen Sandkastenprozess AppContainer . Eine Freigabe CoreWebView2Environment wird nicht erstellt und zurückgegeben.

Fehler beim Starten oder Abschließen des Vorgangs werden separat als Ausnahmen in .NET und WinRT oder als fehlerhafte HRESULT Rückgabewerte in Win32 gemeldet.

Aufruf CoreWebView2Environment.GetClusterEnvironmentOptions , um die Optionen eines laufenden Clusters zu lesen, ohne einen Browser zu starten. Sie wird zurückgegeben null , wenn kein Cluster ausgeführt wird oder der Host keine Clusterumgebungen verwenden kann. Es wird empfohlen, die aktuellen Optionen zu lesen, sie wiederzuverwenden, falls verfügbar, und sie dann zu erstellen oder beizutreten. Da ein anderer Host zwischen diesen Aufrufen einen Cluster einrichten kann, müssen Anwendungen diese weiterhin verarbeiten OptionsMismatch , indem sie die Optionen erneut lesen und es erneut versuchen oder indem sie eine private Umgebung verwenden.

PerHostProfileIsolation ist standardmäßig aktiviert und vergibt Namespaces für Profilnamen pro Hostanwendung, um eine versehentliche Profilfreigabe zu verhindern. Dies ist keine Sicherheitsgrenze; Clustermitglieder müssen sich gegenseitig vertrauen. Die Freigabe wird innerhalb desselben Benutzers und derselben Anmeldesitzung unterstützt, wobei Hosts dieselbe Integritätsebene, denselben erhöhten Status und dieselbe aufgelöste WebView2-Runtime verwenden. Anwendungen sollten die Laufzeitunterstützung überprüfen und auf eine private Umgebung zurückgreifen, wenn die API nicht verfügbar ist.

Weitere Informationen finden Sie in der API-Spezifikation für die freigegebene WebView2-Clusterumgebung.

Siehe auch

  • Zuletzt aktualisiert um