Comprender las versiones de SDK de WebView2

Las nuevas versiones del SDK de WebView2 se distribuyen a la misma cadencia general que el explorador Microsoft Edge \ (cromo ), que es aproximadamente cada seis semanas.

Versión de lanzamiento y versión preliminar

El paquete de NuGet de WebView2 contiene una versión y un paquete de versión preliminar.

El paquete de versión es compatible con versiones posteriores y contiene los siguientes componentes.

Las API del SDK son totalmente compatibles.

El paquete de versión preliminar es un supraconjunto del paquete de versiones con las API experimentales.

Guía básica

El paquete de versión contiene todas las API de Win32 C/C++ y .NET, estables y estables. El paquete de versión preliminar contiene las API experimentales que están sujetas a cambios en función de los comentarios.

API experimentales

El equipo de WebView está buscando comentarios sobre las API experimentales que pueden estar incluidas en versiones futuras. Las API experimentales se marcan como experimental en el SDK. Para ayudarle a evaluar las API experimentales y compartir sus comentarios, navegue hasta el repositorio de comentarios de WebView.

Precaución

Las API experimentales se pueden introducir, modificar y quitar de SDK a SDK. Evite usar las API experimentales en aplicaciones de producción.

Nota

Es posible que las API experimentales no estén disponibles en la versión instalada del tiempo de ejecución de WebView2.

Coincidencia de WebView2 versiones en tiempo de ejecución

Las aplicaciones de WebView2 requieren que los usuarios instalen un motor en tiempo de ejecución de WebView2. El tiempo de ejecución de WebView2 se actualiza automáticamente a la versión más reciente disponible. En algunos escenarios, es posible que los usuarios deseen detener las actualizaciones automáticas del tiempo de ejecución de WebView2, lo que puede provocar problemas de compatibilidad de la aplicación.

Si se detienen las actualizaciones en tiempo de ejecución de WebView2, asegúrate de comprender la versión mínima del tiempo de ejecución de WebView2 requerida por tu aplicación. Considere los dos elementos siguientes:

  1. La versión mínima requerida del SDK, que se encuentra en las notas de la versión de WebView2 en versión mínima de tiempo de ejecución de WebView2. Por ejemplo, para el SDK de la versión 1.0.622.22, debe instalar el motor en tiempo de ejecución de WebView2 o un canal de Microsoft Edge no estable con un número de compilación de 86.0.616.0 o posterior. La versión mínima requerida por el SDK solo cambia cuando se produce un cambio importante en la plataforma Web.
  2. La versión mínima requerida del paquete NuGet necesaria para admitir las interfaces y las API que usas en tu aplicación. Las nuevas interfaces y API se agregan periódicamente a WebView2. Las API e interfaces empaquetadas en un SDK requieren diferentes versiones del tiempo de ejecución de WebView2, ya que las API y la interfaz se agregan al SDK en diferentes momentos. La versión de tiempo de ejecución de WebView2 requerida coincide con el número de compilación, el tercer número, de la versión de SDK que se introdujo en la API por primera vez. Por ejemplo, una nueva API o interfaz agregada en la versión 1.0.622.22 de SDK requiere la versión de tiempo de ejecución de WebView2: 86.0.622.0 una API o una interfaz agregada en una versión de SDK posterior requiere el tiempo de ejecución de WebView2 que tiene el mismo número de versión que el SDK. Para ayudarte a determinar si la versión de tiempo de ejecución de WebView2 es compatible con una interfaz o una API, navega para determinar WebView2 requisito en tiempo de ejecución.

Importante

Al desarrollar aplicaciones de WebView2 de perennes, prueba regularmente tu aplicación con las versiones más recientes del tiempo de ejecución de WebView2 y de los exploradores de Microsoft Edge no estables. Debido a que la plataforma web está evolucionando constantemente, la mejor manera de garantizar que tu aplicación sea la espera.

Determinar requisito de tiempo de ejecución de WebView2

Según el SDK que use, tenga en cuenta los siguientes elementos:

  • C/C++ Win32. Cuando use QueryInterface para obtener una nueva interfaz, compruebe un valor devuelto de E_NOINTERFACE . El valor puede indicar que el tiempo de ejecución de WebView2 es una versión anterior y no es compatible con esa interfaz. Para obtener un ejemplo de cómo funciona, vaya a la línea 622-AppWindow. cpp.
  • .Net y WinUI. Comprueba una No such interface supported excepción al usar métodos, propiedades y eventos que se agregaron a SDK más recientes. La excepción puede producirse cuando el tiempo de ejecución de WebView2 es una versión anterior y no es compatible con las API.

Si una API no está disponible, considera la posibilidad de quitar la característica asociada o informa a los usuarios de que se requiere una actualización para el tiempo de ejecución de WebView2.