Compartir a través de

Notas de la versión del SDK de WebView2

  • Artículo

Estas notas de la versión proporcionan información sobre las nuevas características y correcciones de errores que se incluyen en el SDK de versión webView2 y el SDK de versión preliminar de WebView2.

1.0.3065.39

Fecha de lanzamiento: 10 de febrero de 2025

Paquete NuGet para el SDK de WebView2 1.0.3065.39

Para obtener compatibilidad completa con la API, esta versión de versión del SDK de WebView2 requiere la versión 133.0.3065.39 o posterior de WebView2 Runtime.

Promociones

No se ha promocionado ninguna API adicional a Estable y se ha agregado en este SDK de versión.

Correcciones

Solo en tiempo de ejecución
  • Se agregó el botón Cerrar que falta en el control flotante Descargar .
  • Se ha corregido una condición de carrera que se producía cuando nunca se producía el evento respuesta de solicitud web.

Versión preliminar 1.0.3116

Fecha de lanzamiento: 10 de febrero de 2025

Paquete NuGet para el SDK de WebView2 1.0.3116-prerelease

Para obtener compatibilidad completa con la API, esta versión preliminar del SDK de WebView2 requiere el runtime de WebView2 que se incluye con la versión 134.0.3116.0 o posterior de Microsoft Edge.

API experimentales

No se han agregado API experimentales en este SDK de versión preliminar.

Promociones

No se ha promocionado ninguna API de Experimental a Estable en este SDK de versión preliminar.

Correcciones

Solo en tiempo de ejecución
  • Se agregó el botón Cerrar que falta en el control flotante Descargar .
  • Se ha corregido una condición de carrera que se producía cuando nunca se producía el evento respuesta de solicitud web.
Solo SDK
  • Se ha corregido la documentación de .NET y Win32 del CoreWebView2Find.FindNext método que mencionó FindPreviousincorrectamente . El resumen del método ahora menciona FindNext en su lugar. (Problema 5059)

1.0.2957.106

Fecha de lanzamiento: 20 de enero de 2025

Paquete NuGet para el SDK de WebView2 1.0.2957.106

Para obtener compatibilidad completa con la API, esta versión de versión del SDK de WebView2 requiere la versión 132.0.2957.106 o posterior de WebView2 Runtime.

Promociones

Las siguientes API se han promocionado a Estable y ahora se incluyen en este SDK de versión.

Mostrar elementos wpf sobre la capa WebView2 (WebView2CompositionControl)

WebView2CompositionControl impide que el control WebView2 sea la capa superior de una aplicación WPF y oscurezca los elementos de WPF. Microsoft.Web.WebView2.Wpf.WebView2CompositionControl es un reemplazo de colocación para el control WebView2 de WPF estándar. Tanto el control WebView2CompositionControl WebView2 como la Microsoft.Web.WebView2.Wpf.IWebView2 interfaz se implementan. Ambos derivan de FrameworkElement, como se indica a continuación:

  • FrameworkElement ->HwndHost ->WebView2.
  • FrameworkElement ->Control ->WebView2CompositionControl.

Fondo: Si va a compilar una aplicación de Windows Presentation Foundation (WPF) y usa el control WebView2, es posible que encuentre que la aplicación se encuentra con problemas de "espacio aéreo", donde el control WebView2 siempre se muestra en la parte superior, ocultando cualquier elemento WPF en la misma ubicación, incluso si intenta especificar que los elementos WPF estén por encima del control WebView2 (mediante el orden del árbol visual o la propiedad z-index, por ejemplo).

Este problema se produce porque el control WPF usa WPF HwndHost para hospedar el control Win32 WebView2 y HwndHost tiene un problema con el espacio aéreo.

Consulta también:

Correcciones

Solo en tiempo de ejecución
  • Se ha corregido una regresión en la que los cambios de visualización pueden hacer que WebView2 se represente más pequeño que la ventana de la aplicación.
Solo SDK
  • Se ha corregido un problema en WPF WebView2CompositionControl en el que no se muestra si se inicializa con el tamaño (0,0), como cuando se inicializa en de TabItem .TabControl (Problema n.º 4941)

Versión preliminar 1.0.3079

Fecha de lanzamiento: 24 de enero de 2025

Paquete NuGet para el SDK de WebView2 1.0.3079-prerelease

Para obtener compatibilidad completa con la API, esta versión preliminar del SDK de WebView2 requiere el entorno de ejecución de WebView2 que se incluye con la versión 134.0.3079.0 o posterior de Microsoft Edge.

API experimentales

Se han agregado las siguientes API experimentales en este SDK de versión preliminar.

Personalización del comportamiento de búsqueda (Buscar API)

Find API permite controlar mediante programación las operaciones Find y permite agregar la siguiente funcionalidad a la aplicación:

  • Personalice las opciones buscar, como Buscar término, Distinción de mayúsculas y minúsculas, coincidencia de Word, resaltado de coincidencias y supresión predeterminada de la interfaz de usuario.
  • Busque cadenas de texto y navegue entre ellas dentro de un control WebView2.
  • Inicie operaciones find mediante programación y navegue por Buscar resultados.
  • Suprima la interfaz de usuario de búsqueda predeterminada.
  • Realice un seguimiento del estado de las operaciones de búsqueda .

Hay problemas conocidos con los documentos de Find API for PDF. Al ver un documento PDF dentro de un control WebView2, la característica Buscar actualmente solo proporciona el primer índice y el número de coincidencias encontradas. Por ejemplo, si la cadena se produce tres veces en un PDF, la interfaz de usuario diría 1/3 y no admitiría la llamada mediante programación a Next o Previous. Estamos investigando activamente estos problemas y le recomendamos que informe de los problemas que encuentre mediante el repositorio WebView2Feedback .

Personalizar el comportamiento de arrastrar y colocar (DragStarting API)

La DragStarting API invalida el comportamiento predeterminado de arrastrar y colocar cuando se ejecuta en modo de hospedaje visual. El DragStarting evento notifica a la aplicación cuando el usuario inicia una operación de arrastre en WebView2 y proporciona el estado necesario para invalidar la operación de arrastrar WebView2 predeterminada con su propia lógica.

  • Use DragStarting en ICoreWebView2ExperimentalCompositionController6 para agregar un controlador de eventos que se invoca cuando se inicia la operación de arrastre.
  • Use ICoreWebView2ExperimentalDragStartingEventArgs para iniciar su propia operación de arrastre.
    • Use el GetDeferral método para ejecutar cualquier lógica de arrastre asincrónica y volver a llamar a WebView más adelante.
    • Use la Handled propiedad para que WebView2 sepa si desea usar su propia lógica de arrastre.
Seguimiento del historial de navegación de iframes anidados (API FrameCreatedEvent)

La API FrameCreatedEvent admite iframes anidados, como registrar el historial de navegación de un iframe de segundo nivel. Sin esta API, WebView2 solo realiza un seguimiento de los iframes de primer nivel, que son los iframes secundarios directos del marco principal. Con esta API, la aplicación puede suscribirse al evento de creación de iframe anidado, lo que proporciona a la aplicación acceso a todas las propiedades, métodos y eventos de CoreWebView2Frame para el iframe anidado.

Use esta API para administrar el seguimiento de iframe en una página que contiene varios niveles de iframes. Puede optar por realizar un seguimiento de cualquiera de los siguientes elementos:

  • Solo la página principal y los iframes de primer nivel (el comportamiento predeterminado).
  • Árbol de marcos WebView2 parcial con iframes específicos de interés.
  • Árbol de marcos WebView2 completo.
Establecer el color de fondo predeterminado en la inicialización de WebView2 (DefaultBackgroundColor API)

La API DefaultBackgroundColor permite a los usuarios establecer la propiedad en la DefaultBackgroundColor inicialización. Esto evita una interrupción del flash blanco durante el proceso de carga de WebView2.

Promociones

Las siguientes API se han promocionado de Experimental a Estable en este SDK de versión preliminar.

Mostrar elementos wpf sobre la capa WebView2 (WebView2CompositionControl)

WebView2CompositionControl impide que el control WebView2 sea la capa superior de una aplicación WPF y oscurezca los elementos de WPF. Microsoft.Web.WebView2.Wpf.WebView2CompositionControl es un reemplazo de colocación para el control WebView2 de WPF estándar. Tanto el control WebView2CompositionControl WebView2 como la Microsoft.Web.WebView2.Wpf.IWebView2 interfaz se implementan. Ambos derivan de FrameworkElement, como se indica a continuación:

  • FrameworkElement ->HwndHost ->WebView2.
  • FrameworkElement ->Control ->WebView2CompositionControl.

Fondo: Si va a compilar una aplicación de Windows Presentation Foundation (WPF) y usa el control WebView2, es posible que encuentre que la aplicación se encuentra con problemas de "espacio aéreo", donde el control WebView2 siempre se muestra en la parte superior, ocultando cualquier elemento WPF en la misma ubicación, incluso si intenta especificar que los elementos WPF estén por encima del control WebView2 (mediante el orden del árbol visual o la propiedad z-index, por ejemplo).

Este problema se produce porque el control WPF usa WPF HwndHost para hospedar el control Win32 WebView2 y HwndHost tiene un problema con el espacio aéreo.

Consulta también:

Correcciones

Solo en tiempo de ejecución
  • Se ha corregido una regresión en la que los cambios de visualización pueden hacer que WebView2 se represente más pequeño que la ventana de la aplicación.
  • Se ha habilitado la IsolateSandboxedIframes característica ascendente para WebView2.
  • Se ha evitado eliminar un trabajo de servicio cuando cambia la versión.
  • La CleanUpSome API de Hostobject ahora solo realiza la recolección de elementos no utilizados para el montón completo. CleanUpSome se ha quitado del motor V8.
  • Se ha corregido una regresión de AreBrowserAcceleratorKeysEnabled. (Problema n.º 5033)
  • Se ha corregido un error por IsDefaultDownloadDialogOpenChanged el que no se desencadenaba cuando se cierra un cuadro de diálogo mediante el teclado. (Problema 4807)
Solo SDK
  • Se ha corregido un problema en WPF WebView2CompositionControl en el que no se muestra si se inicializa con el tamaño (0,0), como cuando se inicializa en de TabItem .TabControl (Problema n.º 4941)

1.0.2903.40

Fecha de lanzamiento: 18 de noviembre de 2024

Paquete NuGet para el SDK de WebView2 1.0.2903.40

Para obtener compatibilidad completa con la API, esta versión de versión del SDK de WebView2 requiere la versión 131.0.2903.40 o posterior de WebView2 Runtime.

Promociones

Las siguientes API se han promocionado a Estable y ahora se incluyen en este SDK de versión.

Controlar si se muestra la interfaz de usuario de captura de pantalla (evento ScreenCaptureStarting)

Se ha agregado un nuevo ScreenCaptureStarting evento. Este evento se genera cada vez que WebView2 o iframe que corresponde a CoreWebView2Frame (o a cualquiera de sus iframes descendientes) solicita permiso para usar la API de captura de pantalla antes de que se muestre la interfaz de usuario. A continuación, la aplicación puede bloquear la visualización de la interfaz de usuario o permitir que se muestre la interfaz de usuario.

Correcciones

Solo en tiempo de ejecución
  • Se ha permitido que el cuadro de diálogo Descargar reciba el foco inicial al iniciarse.

Cambios generales

  • Microsoft Edge WebView2 Runtime ya no aparece enAplicaciones> de configuración> de WindowsAplicaciones instaladas, porque es un componente del sistema persistente.

1.0.2950-prerelease

Fecha de lanzamiento: 18 de noviembre de 2024

Paquete NuGet para el SDK de WebView2 1.0.2950-prerelease

Para obtener compatibilidad completa con la API, esta versión preliminar del SDK de WebView2 requiere el entorno de ejecución de WebView2 que se incluye con la versión 132.0.2950.0 o posterior de Microsoft Edge.

API experimentales

No se han agregado API experimentales en este SDK de versión preliminar.

Promociones

No se ha promocionado ninguna API de Experimental a Estable en este SDK de versión preliminar.

Correcciones

Solo en tiempo de ejecución
  • Se ha permitido que el cuadro de diálogo Descargar reciba el foco inicial al iniciarse.
  • Se ha corregido un bloqueo al cancelar la navegación a determinados sitios de FrameNavigationStarting. (Problema 4843)
  • Se pospuso la personalización del menú contextual cuando se muestra el menú de selección táctil. (Problema n.º 4737)
Solo SDK
  • Se ha agregado compatibilidad con Arm64ec.
  • Se ha corregido un problema por el que WebView2 que se ejecutaba en el modo "Ventana a objeto visual" no podía recibir la entrada del acelerador.

1.0.2849.39

Fecha de lanzamiento: 21 de octubre de 2024

Paquete NuGet para el SDK de WebView2 1.0.2849.39

Para obtener compatibilidad completa con la API, esta versión de versión del SDK de WebView2 requiere la versión 130.0.2849.39 o posterior de WebView2 Runtime.

Promociones

Las siguientes API se han promocionado a Estable y ahora se incluyen en este SDK de versión.

Configurar la advertencia de seguridad al guardar un archivo (SaveFileSecurityCheckStarting evento)

Se ha agregado un nuevo SaveFileSecurityCheckStarting evento. La aplicación puede registrar un controlador en este evento para obtener la ruta de acceso del archivo, la extensión de nombre de archivo y la información del URI de origen del documento. A continuación, puede aplicar sus propias reglas para realizar acciones como las siguientes:

  • Permite guardar el archivo sin presentar una interfaz de usuario de advertencia de seguridad predeterminada sobre la directiva de tipo de archivo.
  • Cancele el guardado.
  • Cree su propia interfaz de usuario para administrar las directivas de tipo de archivo en tiempo de ejecución.

Correcciones

Solo en tiempo de ejecución
  • Se ha corregido un problema de foco del cuadro de diálogo Descargar al presionar Tab o Mayús+Tab para cambiar al control Webview2.
Solo SDK
  • El uso CoreWebView2.AddWebResourceRequestedFilter sin un CoreWebView2WebResourceRequestSourceKinds parámetro ahora está en desuso. Vea el método .NET CoreWebView2.AddWebResourceRequestedFilter.
  • Se ha agregado .NET 8 TargetFramework para WinRT de C#, compatibilidad con AOT habilitada (con antelación) y serialización en tiempo de ejecución deshabilitada.

Versión preliminar 1.0.2895

Fecha de lanzamiento: 21 de octubre de 2024

Paquete NuGet para el SDK de WebView2 1.0.2895-prerelease

Para obtener compatibilidad completa con la API, esta versión preliminar del SDK de WebView2 requiere el entorno de ejecución de WebView2 que se incluye con la versión 131.0.2895.0 o posterior de Microsoft Edge.

API experimentales

Se han agregado las siguientes API experimentales en este SDK de versión preliminar.

RestartRequested evento cuando WebView2 necesita reiniciarse

Se ha agregado un nuevo RestartRequested evento. El RestartRequested evento se genera cada vez que WebView2 necesita reiniciarse para aplicar actualizaciones o cambios de configuración. Puede usar esta API para detectar cuándo WebView2 debe reiniciarse y realizar las acciones adecuadas. La Priority propiedad de los RestartRequested argumentos de evento indica la prioridad de la solicitud de reinicio:

  • High indica que la aplicación debe pedir a los usuarios que se reinicien lo antes posible.
  • Normal indica que la aplicación debe recordar a los usuarios que se reinicien de la mejor manera posible.

Promociones

Las siguientes API se han promocionado de Experimental a Estable en este SDK de versión preliminar.

Controlar si se muestra la interfaz de usuario de captura de pantalla (ScreenCaptureStarting evento)

Se ha agregado un nuevo ScreenCaptureStarting evento. Este evento se genera cada vez que WebView2 o iframe que corresponde a CoreWebView2Frame (o a cualquiera de sus iframes descendientes) solicita permiso para usar la API de captura de pantalla antes de que se muestre la interfaz de usuario. A continuación, la aplicación puede bloquear la visualización de la interfaz de usuario o permitir que se muestre la interfaz de usuario.

Configurar la advertencia de seguridad al guardar un archivo (SaveFileSecurityCheckStarting evento)

Se ha agregado un nuevo SaveFileSecurityCheckStarting evento. La aplicación puede registrar un controlador en este evento para obtener la ruta de acceso del archivo, la extensión de nombre de archivo y la información del URI de origen del documento. A continuación, puede aplicar sus propias reglas para realizar acciones como las siguientes:

  • Permite guardar el archivo sin presentar una interfaz de usuario de advertencia de seguridad predeterminada sobre la directiva de tipo de archivo.
  • Cancele el guardado.
  • Cree su propia interfaz de usuario para administrar las directivas de tipo de archivo en tiempo de ejecución.

Correcciones

Solo SDK
  • Se ha corregido la incompatibilidad de Arm64 con WindowsAppSDK 1.6.
  • Se quitó un extra WebView2Loader.dll en el caso de WinAppSDK.
  • El uso CoreWebView2.AddWebResourceRequestedFilter sin un CoreWebView2WebResourceRequestSourceKinds parámetro ahora está en desuso. Vea el método .NET CoreWebView2.AddWebResourceRequestedFilter.

1.0.2792.45

Fecha de lanzamiento: 23 de septiembre de 2024

Paquete NuGet para el SDK de WebView2 1.0.2792.45

Para obtener compatibilidad completa con la API, esta versión de versión del SDK de WebView2 requiere la versión 129.0.2792.45 o posterior de WebView2 Runtime.

Promociones

No se ha promocionado ninguna API adicional a Estable y se ha agregado en este SDK de versión.

Correcciones

Solo SDK

Versión preliminar 1.0.2839

Fecha de lanzamiento: 23 de septiembre de 2024

Paquete NuGet para el SDK de WebView2 1.0.2839-prerelease

Para obtener compatibilidad completa con la API, esta versión preliminar del SDK de WebView2 requiere el entorno de ejecución de WebView2 que se incluye con la versión 130.0.2839.0 o posterior de Microsoft Edge.

API experimentales

No se han agregado API experimentales en este SDK de versión preliminar.

Promociones

No se ha promocionado ninguna API de Experimental a Estable en este SDK de versión preliminar.

Correcciones

Solo en tiempo de ejecución
  • Se ha corregido un problema por el que al centrarse en un control WebView2 en WinAppSDK con la configuración "Desplazar ventanas inactivas" de Windows deshabilitada, se producía un error en el desplazamiento.
  • Bloqueado edge://wallet en WebView2. (Problema 4710)
  • Se ha borrado la variable de entorno para el color de fondo predeterminado en los controles WebView2 de .NET una vez que el controlador ha terminado de crearse.
  • Compatibilidad de accesibilidad habilitada para Webview2 en modo de hospedaje visual.
  • Se ha corregido un error al quitar un filtro "recurso web solicitado" para varios orígenes cuando uno de ellos es Document.
  • Se ha corregido una regresión que DataList no era visible en WinUI ni en otras instancias webView2 hospedadas visualmente.
Solo SDK
  • Se ha corregido una dependencia del SDK para proyectos de .NET. (Problema n.º 4743)
  • Se ha corregido un problema de compatibilidad al llamar a GetAvailableBrowserVersionString() con un elemento anterior WebView2Loader.dll. (Problema n.º 4395)
  • Se han corregido problemas al compilar código generado por wv2winrt con las cpp20 opciones y /permissive- .
  • Se ha agregado .NET 8 TargetFramework para WinRT de C#, compatibilidad con AOT habilitada (con antelación) y serialización en tiempo de ejecución deshabilitada.

Consulte también