Notas de la versión del SDK de WebView2
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.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.
CoreWebView2
Clase:CoreWebView2Frame
Clase:CoreWebView2NonClientRegionKind
Enumeración:
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.
CoreWebView2
Clase:CoreWebView2SaveFileSecurityCheckStartingEventArgs (clase)
- CoreWebView2SaveFileSecurityCheckStartingEventArgs.CancelSave (propiedad)
- CoreWebView2SaveFileSecurityCheckStartingEventArgs.DocumentOriginUri (propiedad)
- CoreWebView2SaveFileSecurityCheckStartingEventArgs.FileExtension (propiedad)
- CoreWebView2SaveFileSecurityCheckStartingEventArgs.FilePath (propiedad)
- Propiedad CoreWebView2SaveFileSecurityCheckStartingEventArgs.SuppressDefaultPolicy
- CoreWebView2SaveFileSecurityCheckStartingEventArgs.GetDeferral (Método)
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 unCoreWebView2WebResourceRequestSourceKinds
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.
CoreWebView2Environment
Clase:CoreWebView2RestartRequestedEventArgs
Clase:CoreWebView2RestartRequestedPriority Enum
CoreWebView2RestartRequestedPriority.Normal
CoreWebView2RestartRequestedPriority.High
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.
CoreWebView2
Clase:CoreWebView2Frame
Clase:CoreWebView2ScreenCaptureStartingEventArgs
Clase:
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.
CoreWebView2
Clase:CoreWebView2SaveFileSecurityCheckStartingEventArgs (clase)
- CoreWebView2SaveFileSecurityCheckStartingEventArgs.CancelSave (propiedad)
- CoreWebView2SaveFileSecurityCheckStartingEventArgs.DocumentOriginUri (propiedad)
- CoreWebView2SaveFileSecurityCheckStartingEventArgs.FileExtension (propiedad)
- CoreWebView2SaveFileSecurityCheckStartingEventArgs.FilePath (propiedad)
- Propiedad CoreWebView2SaveFileSecurityCheckStartingEventArgs.SuppressDefaultPolicy
- CoreWebView2SaveFileSecurityCheckStartingEventArgs.GetDeferral (Método)
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 unCoreWebView2WebResourceRequestSourceKinds
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
- Se ha corregido una dependencia del SDK para proyectos de .NET. (Problema n.º 4743)
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 anteriorWebView2Loader.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.
1.0.2739.15
Fecha de lanzamiento: 26 de agosto de 2024
Paquete NuGet para el SDK de WebView2 1.0.2739.15
Para obtener compatibilidad completa con la API, esta versión de versión del SDK de WebView2 requiere la versión 128.0.2739.15 o posterior de WebView2 Runtime.
Promociones
Las siguientes API se han promocionado a Estable y ahora se incluyen en este SDK de versión.
Control de notificaciones web
Se ha agregado compatibilidad con la notificación web para las notificaciones no persistentes. El NotificationReceived
evento para CoreWebView2
controla el control de notificaciones web, lo que permite la personalización o supresión por parte de la aplicación host. Las notificaciones no controladas se establecen de forma predeterminada en la interfaz de usuario de WebView2.
CoreWebView2
Clase:CoreWebView2Notification (clase)
- Propiedad CoreWebView2Notification.BadgeUri
- Propiedad CoreWebView2Notification.Body
- Propiedad CoreWebView2Notification.BodyImageUri
- Propiedad CoreWebView2Notification.Direction
- Propiedad CoreWebView2Notification.IconUri
- Propiedad CoreWebView2Notification.IsSilent
- Propiedad CoreWebView2Notification.Language
- Propiedad CoreWebView2Notification.RequiresInteraction
- Propiedad CoreWebView2Notification.ShouldRenotify
- Propiedad CoreWebView2Notification.Tag
- Propiedad CoreWebView2Notification.Timestamp
- Propiedad CoreWebView2Notification.Title
- Propiedad CoreWebView2Notification.VibrationPattern
- Método CoreWebView2Notification.ReportClicked
- Método CoreWebView2Notification.ReportClosed
- Método CoreWebView2Notification.ReportShown
- Evento CoreWebView2Notification.CloseRequested
CoreWebView2TextDirectionKind Enum
Default
LeftToRight
RightToLeft
Guardar como
Se han agregado SaveAs
API que permiten realizar mediante programación la operación Guardar como . Puede usar estas API para bloquear el cuadro de diálogo Guardar como predeterminado y, a continuación, guardar en silencio o compilar su propia interfaz de usuario para Guardar como. Estas API pertenecen solo al cuadro de diálogo Guardar como , no al cuadro de diálogo Descargar , que sigue usando las API de descarga existentes.
CoreWebView2
Clase:Enumeración CoreWebView2SaveAsKind
Complete
Default
HtmlOnly
SingleFile
CoreWebView2SaveAsUIResult Enum
Cancelled
FileAlreadyExists
InvalidPath
KindNotSupported
Success
CoreWebView2SaveAsUIShowingEventArgs (clase)
- CoreWebView2SaveAsUIShowingEventArgs.AllowReplace (propiedad)
- CoreWebView2SaveAsUIShowingEventArgs.Cancel (propiedad)
- CoreWebView2SaveAsUIShowingEventArgs.ContentMimeType (propiedad)
- CoreWebView2SaveAsUIShowingEventArgs.Kind (propiedad)
- CoreWebView2SaveAsUIShowingEventArgs.SaveAsFilePath (propiedad)
- CoreWebView2SaveAsUIShowingEventArgs.SuppressDefaultDialog (propiedad)
- CoreWebView2SaveAsUIShowingEventArgs.GetDeferral (Método)
Correcciones
No hay correcciones de errores en este SDK de versión.
1.0.2783-versión preliminar
Fecha de lanzamiento: 26 de agosto de 2024
Paquete NuGet para el SDK de WebView2 1.0.2783-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 129.0.2783.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
Runtime y SDK
- Volver a habilitar el comportamiento predeterminado de : de
SetUserAgent
forma predeterminada,SetUserAgent
es eficaz para los iframes entre orígenes.
Solo en tiempo de ejecución
Se ha habilitado la característica de arrastre interactivo de forma predeterminada. Consulte
edge-webview-interactive-dragging
en Marcas del explorador WebView2.Deshabilitado
IsolateSandboxedIframes
para WebView2.Se ha corregido un problema por el que se produce un error en la creación de WebView cuando se inician varias instancias al mismo tiempo. (Problema n.º 4731)
Se ha corregido un error en la proyección de JavaScript de WinRT que provocaba el almacenamiento en caché de propiedades existentes en objetos cuyo nombre contiene
Proxy
oFunction
causaba un error debido a la colisión de nombres.Se ha corregido un error por el que el control WebView2 se convertía en el tamaño incorrecto después de desconectar y volver a conectar un monitor.
Se ha corregido un problema por el que los vínculos "mailto:" dejaban abierta una ventana emergente sin título, en lugar de cerrar automáticamente la ventana emergente.
Solo SDK
La proyección de WinRT de C# ahora funciona en UWP.
Se ha corregido un problema para asegurarse de que
GeneratedFilesDir
ya no aparece en la proyección de WinRT de Visual Studio para C#.
1.0.2651.64
Fecha de lanzamiento: 13 de agosto de 2024
Paquete NuGet para el SDK de WebView2 1.0.2651.64
Para obtener compatibilidad completa con la API, esta versión de versión del SDK de WebView2 requiere la versión 127.0.2651.64 o posterior de WebView2 Runtime.
Promociones
Las siguientes API se han promocionado a Estable y ahora se incluyen en este SDK de versión.
- Se ha actualizado la API WebMessageObjects para permitir la inserción de objetos DOM en el contenido WebView2 construido a través de la aplicación y a través de la
CoreWebView2.PostWebMessage
API en la otra dirección. Se ha agregado un nuevo tipo de objeto web (CoreWebView2FileSystemHandle
) para representar un identificador del sistema de archivos que se puede publicar en el contenido web para proporcionarle acceso al sistema de archivos.
CoreWebView2
Clase:CoreWebView2Environment
Clase:CoreWebView2FileSystemHandle
Clase:Enumeración CoreWebView2FileSystemHandleKind
File
Directory
CoreWebView2FileSystemHandlePermission Enum
ReadOnly
ReadWrite
Correcciones
Solo en tiempo de ejecución
- Se ha corregido una regresión en la que
WebResourceRequested
los eventos se bloquean en determinados sitios. (Problema n.º 4602)
Solo SDK
- Se ha corregido x86 para la proyección de C# de WinRT.
1.0.2730-prelease
Fecha de lanzamiento: 7 de agosto de 2024
Paquete NuGet para el SDK de WebView2 1.0.2730-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 128.0.2730.0 o posterior de Microsoft Edge.
API experimentales
Se han agregado las siguientes API experimentales en este SDK de versión preliminar.
- Se han agregado nuevas API de controles de limitación que permiten una administración eficaz de recursos, ya que permiten limitar los temporizadores de JavaScript. Esto resulta útil en escenarios en los que un control WebView2 debe permanecer visible, pero debe consumir menos recursos (por ejemplo, cuando el usuario no interactúa con el contenido). Estas API de controles de limitación le permiten:
- Personalice la limitación de temporizadores de script (
setTimeout
ysetInterval
) en diferentes estados de página (primer plano, fondo y fondo con limitación intensiva). - Limite los temporizadores de script en iframes hospedados seleccionados.
- Personalice la limitación de temporizadores de script (
CoreWebView2Frame
Clase:CoreWebView2Settings
Clase:
Promociones
Las siguientes API se han promocionado de Experimental a Estable en este SDK de versión preliminar.
- Se han agregado
SaveAs
API que permiten realizar mediante programación la operación Guardar como . Puede usar estas API para bloquear el cuadro de diálogo Guardar como predeterminado y, a continuación, guardar en silencio o compilar su propia interfaz de usuario para Guardar como. Estas API pertenecen solo al cuadro de diálogo Guardar como , no al cuadro de diálogo Descargar , que sigue usando las API de descarga existentes.
CoreWebView2
Clase:Enumeración CoreWebView2SaveAsKind
Default
HtmlOnly
SingleFile
Complete
CoreWebView2SaveAsUIResult Enum
Success
InvalidPath
FileAlreadyExists
KindNotSupported
Cancelled
CoreWebView2SaveAsUIShowingEventArgs (clase)
- CoreWebView2SaveAsUIShowingEventArgs.AllowReplace (propiedad)
- CoreWebView2SaveAsUIShowingEventArgs.Cancel (propiedad)
- CoreWebView2SaveAsUIShowingEventArgs.ContentMimeType (propiedad)
- CoreWebView2SaveAsUIShowingEventArgs.Kind (propiedad)
- CoreWebView2SaveAsUIShowingEventArgs.SaveAsFilePath (propiedad)
- CoreWebView2SaveAsUIShowingEventArgs.SuppressDefaultDialog (propiedad)
- CoreWebView2SaveAsUIShowingEventArgs.GetDeferral (Método)
- Se ha agregado compatibilidad con la notificación web para las notificaciones no persistentes. El
NotificationReceived
evento paraCoreWebView2
controla el control de notificaciones web, lo que permite la personalización o supresión por parte de la aplicación host. Las notificaciones no controladas se establecen de forma predeterminada en la interfaz de usuario de WebView2.
Correcciones
Solo en tiempo de ejecución
Se ha corregido un problema por el que la ventana de la aplicación no se podía controlar mediante comandos del sistema (como Alt+F4 o Alt+Barra espaciadora) cuando el foco estaba en WebView2 para el modo de hospedaje visual. (Problema 2961)
Se ha corregido un error en WebView2 para UWP en el que no se podía hacer clic en la barra Buscar desde la aplicación host.
Solo SDK
Agregar la API de WinRT
CoreWebView2Notification.VibrationPattern
que falta. Esta API de WinRT se puede combinar con las notas de la versión de promoción de la API de notificación estable; vea "Notificación web" yNotificationReceived
para WinRT, inmediatamente anterior.Se ha corregido un problema que provocaba que
KeyDown
los eventos del control WebView2 de WinForms no incluyesen la información correctaModifierKeys
. (Problema n.º 1216)Se ha corregido x86 para la proyección de C# de WinRT.
Hecho
CreateCoreWebView2Environment
yGetAvailableCoreWebView2BrowserVersionString
más sólido frente a posibles condiciones de carrera durante la actualización en tiempo de ejecución.
Consulte también
- Acerca de las notas de la versión del SDK de WebView2
- Notas de la versión archivadas del SDK de WebView2
- Información general de las API de WebView2 : describe muchas de las API, por área de características, que se encuentran en los paquetes del SDK de versión.
- Ponerse en contacto con el equipo de Microsoft Edge WebView2