SDK de versión preliminar 1.0.4255-prerelease, para el entorno de ejecución 154 (11 de septiembre de 2026)

Notas de la versión del SDK de versión preliminar de WebView2 de Microsoft Edge, fecha de lanzamiento: 11 de septiembre de 2026.

Paquete NuGet para SDK de WebView2 1.0.4255-prerelease

Para ser compatibilidad total con API, esta versión preliminar del SDK de WebView2 requiere el tiempo de ejecución de WebView2 que se incluye con Microsoft Edge versión 154.0.4255.0 o posterior. consulte Runtime 154.0.4258.31 (28 de septiembre de 2026).

Contenido detallado:

API experimentales (Fase 1: Experimental en versión preliminar)

Las siguientes API se encuentran en la fase 1: Experimental en versión preliminar y se han agregado en este SDK de versión preliminar.

API LaunchingExternalUriScheme a nivel de marco

El LaunchingExternalUriScheme evento ahora también se plantea el CoreWebView2Frame, además de CoreWebView2. Esto permite a un host atribuir un lanzamiento de esquema URI externo (como mailto:, tel:, o un protocolo personalizado) al específico iframe que lo inició. Esto resulta útil cuando hay varias subaplicaciones hospedadas en iframes, incluido cuando los iframes comparten el mismo origen.

El evento se genera cuando el LaunchingExternalUriScheme contenido de un frame, o en un iframe anidado dentro de él, intenta iniciar un esquema URI externo. Cuando el lanzamiento se origina en un anidado iframe, el evento burbujea hacia afuera a través de los ancestros rastreados CoreWebView2Frame , comenzando con el marco rastreado más cercano (más interno) y continuando hacia el marco de nivel superior, y finalmente a CoreWebView2. El remitente del evento para cada invocación es el CoreWebView2Frame receptor del evento.

CoreWebView2LaunchingExternalUriSchemeEventArgs tiene una nueva Handled propiedad. Los controladores de nivel de fotograma se invocan antes que los CoreWebView2controladores de nivel de fotograma; si un controlador de nivel de fotograma establece Handled en TRUE, el evento no se genera en los fotogramas anteriores restantes o en CoreWebView2. Cancel continúa controlando si se inicia el URI, mientras controla Handled si se invocan los controladores restantes. Los argumentos (incluidos Cancel y Handled) se comparten entre niveles; para suprimir los controladores de nivel WebView al tomar un Deferralconjunto de , Handled antes de tomar el aplazamiento.

API de entorno de clúster compartido

La API del entorno de clúster compartido permite que las aplicaciones host que cooperan compartan explícitamente un entorno WebView2, incluido un proceso del explorador y una carpeta de datos de usuario, acordando un ClusterName. Las aplicaciones no proporcionan una ruta de acceso a la carpeta de datos de usuario; el tiempo de ejecución de WebView2 deriva del nombre del clúster.

Una aplicación host llama CoreWebView2Environment.CreateOrJoinClusterEnvironmentAsync con una CoreWebView2ClusterEnvironmentOptions instancia. El primer host que establezca el clúster determina sus opciones para todo el proceso. Los anfitriones posteriores se unen cuando sus opciones coinciden. Estas opciones siguen siendo autoritativas mientras se ejecute el proceso del explorador compartido; Después de que salga, el siguiente host puede establecer el clúster con diferentes opciones.

La operación anterior devuelve un CoreWebView2ClusterEnvironmentCreateResult que contiene a Status y, si se realiza correctamente, el CoreWebView2Environmentarchivo . Posibles valores de Status:

  • Succeeded indica que se ha realizado correctamente. Se crea y devuelve un compartido CoreWebView2Environment .

  • OptionsMismatch Indica que un clúster en ejecución tiene diferentes opciones. No se crea y devuelve un compartido CoreWebView2Environment .

  • NotSupported Indica que el host no puede usar entornos de clúster, como un proceso de espacio aislado AppContainer . No se crea y devuelve un compartido CoreWebView2Environment .

Los errores al iniciar o completar la operación se notifican por separado como excepciones en .NET y WinRT, o como valores de retorno erróneos HRESULT en Win32.

Llamada CoreWebView2Environment.GetClusterEnvironmentOptions para leer las opciones de un clúster en ejecución sin iniciar un explorador. Se devuelve null cuando no se está ejecutando ningún clúster o cuando el host no puede usar entornos de clúster. El flujo recomendado es leer las opciones actuales, volver a usarlas si están disponibles y, a continuación, crear o unirse. Como otro host puede establecer un clúster entre estas llamadas, las aplicaciones deben seguir OptionsMismatch controlándolas leyendo las opciones de nuevo y reintentándolo, o mediante un entorno privado.

PerHostProfileIsolation está habilitado de forma predeterminada y los espacios de nombres de perfil por aplicación host para evitar el uso compartido accidental de perfiles. Este no es un límite de seguridad; Los miembros del grupo deben confiar unos en otros. El uso compartido se admite dentro de la misma sesión de inicio de sesión y de usuario, con hosts que utilizan el mismo nivel de integridad, estado de elevación y runtime de WebView2 resuelto. Las aplicaciones deben comprobar la compatibilidad en tiempo de ejecución y volver a un entorno privado cuando la API no esté disponible.

Consulte la especificación de API de entorno de clúster WebView2 compartido .

Vea también