Aplicación de ejemplo de WPF con extensión CDP

En este ejemplo de WebView2 se muestra cómo usar la extensión CDP de WebView2 para usar el protocolo Chrome DevTools (CDP) en una aplicación WPF.

• Nombre de ejemplo: WV2CDPExtensionWPFSample
• Directorio del repositorio: WV2CDPExtensionWPFSample
• Archivo de solución: WV2CDPExtensionWPFSample.sln

Este ejemplo, WV2CDPExtensionWPFSample, se compila con la extensión CDP WebView2 (el paquete NuGet Microsoft.Web.WebView2.DevToolsProtocolExtension ). En este ejemplo se llama a los métodos del protocolo Chrome DevTools en un DevToolsProtocolHelper objeto de WebView2.

Este ejemplo se compila como un proyecto de Visual Studio 2019 de WPF. Usa C# en el entorno WebView2.

El menú Comandos de DevTools :

El menú Eventos de DevTools :

Si es la primera vez que usa WebView2, se recomienda primero seguir el tutorial Introducción a WebView2 en aplicaciones WPF . El tutorial le guiará a través de la creación de un WebView2 y la adición de algunas funciones básicas de WebView2.

Paso 1: Instalación de un canal de versión preliminar de Microsoft Edge

Se recomienda la versión más reciente del canal Canary.

1. Si aún no está instalado un canal de versión preliminar de Microsoft Edge (Beta, Desarrollo o Canary), en una ventana o pestaña independiente, consulte Instalación de un canal de vista previa de Microsoft Edge en Configuración del entorno de desarrollo para WebView2. Siga los pasos de esa sección y vuelva a esta página y continúe con los pasos siguientes.

Paso 2: Instalación de Visual Studio con compatibilidad con .NET

Se requiere Microsoft Visual Studio (con compatibilidad con .NET). Microsoft Visual Studio Code no se admite para este ejemplo.

1. Si Visual Studio (versión mínima necesaria) con compatibilidad con .NET aún no está instalado, en una ventana o pestaña independiente, vea Instalar Visual Studio en Configurar el entorno de desarrollo para WebView2. Siga los pasos de esa sección y vuelva a esta página y continúe con los pasos siguientes.

Paso 3: Clonación o descarga del repositorio WebView2Samples

1. Si aún no lo ha hecho, clone o descargue el repositorio en la WebView2Sample unidad local. En una ventana o pestaña independiente, consulte Descarga del repositorio WebView2Samples en Configuración del entorno de desarrollo para WebView2. Siga los pasos de esa sección y vuelva a esta página y continúe a continuación.

Paso 4: Abrir la solución en Visual Studio

1. En la unidad local, abra el .sln archivo en Visual Studio, en el directorio :

   • <your-repos-directory>/WebView2Samples/SampleApps/WV2CDPExtensionWPFSample/WV2CDPExtensionWPFSample.sln

   o bien:

   • <your-repos-directory>/WebView2Samples-main/SampleApps/WV2CDPExtensionWPFSample/WV2CDPExtensionWPFSample.sln

Si desea usar Visual Studio 2017, en Visual Studio, cambie el conjunto de herramientas de la plataforma del proyecto en propiedades > de configuración de proyecto Conjunto de herramientas > de la plataforma general>. Para usar Visual Studio 2017, es posible que también tenga que instalar un SDK de Windows reciente.

Paso 5: Instalación de cargas de trabajo si se le solicita

1. Si se le solicita, instale las cargas de trabajo de Visual Studio que se soliciten. En una ventana o pestaña independiente, vea Instalar cargas de trabajo de Visual Studio en Configuración del entorno de desarrollo para WebView2. Siga los pasos de esa sección y vuelva a esta página y continúe a continuación.

   El proyecto WV2CDPExtensionWPFSample se abre en Visual Studio:

   

Paso 6: Compilación y ejecución del proyecto con la versión instalada de los SDK

Una versión del SDK de WebView2 y WebView2 DevToolsProtocolExtension se incluyen como paquetes NuGet en este proyecto. En un paso posterior, los actualizará mediante el Administrador de paquetes NuGet de Visual Studio.

En la parte superior de Visual Studio, establezca el destino de compilación, como se indica a continuación:

1. En la lista desplegable Configuraciones de solución , seleccione Depurar o Liberar.

2. En la lista desplegable Plataformas de soluciones , seleccione Cualquier CPU.

3. En Explorador de soluciones, haga clic con el botón derecho en el proyecto WV2CDPExtensionWPFSample y, a continuación, seleccione Compilar.

1. En Visual Studio, seleccione Depurar>iniciar depuración (F5).

   Se abre la ventana de la aplicación de ejemplo:

   

2. En Visual Studio, seleccione Depurar>detener depuración. Visual Studio cierra la aplicación.

Paso 7: Actualización del SDK de WebView2

1. En Explorador de soluciones, haga clic con el botón derecho en el proyecto (no en el nodo de solución) y, a continuación, seleccione Administrar paquetes NuGet. Se abre el Administrador de paquetes NuGet .

2. Haga clic en la pestaña Instalado o Novedades.

3. Active o desactive la casilla Incluir versión preliminar .

   

   En la captura de pantalla anterior se muestra Visual Studio 2019, que muestra este ejemplo en el contexto de la solución WebView2APIsSample global, en lugar de la solución independiente actual. En esta captura de pantalla, el repositorio tiene una versión de lanzamiento del SDK de WebView2 y hay disponibles versiones preliminares y versiones más recientes del SDK.

4. Si aparece una versión más reciente del SDK Microsoft.Web.WebView2 , haga clic en el botón Actualizar . Una versión preliminar tiene un sufijo "-prerelease", como 1.0.1248-prerelease. Los SDK de versión preliminar le permiten probar las características y LAS API de WebView2 más recientes.

Si desea ver detalles sobre este paso, en una ventana o pestaña independiente, consulte Instalación o actualización del SDK de WebView2 en Configuración del entorno de desarrollo para WebView2. Siga los pasos de esa sección y vuelva a esta página y continúe a continuación.

Paso 8: Actualización de la extensión CDP de WebView2

Un requisito previo para este ejemplo es la versión más reciente de la extensión CDP de WebView2 (Microsoft.Web.WebView2.DevToolsProtocolExtension), que se incluye en este proyecto. Ese paquete agrega compatibilidad con la API del protocolo Chrome DevTools (CDP).

1. En Explorador de soluciones, haga clic con el botón derecho en el proyecto y, a continuación, seleccione Administrar paquetes NuGet. Se abre el Administrador de paquetes NuGet .

2. Haga clic en la pestaña Instalado o Novedades.

3. Desactive la casilla Incluir versión preliminar .

   

4. Si aparece una versión más reciente del SDK Microsoft.Web.WebView2.DevToolsProtocolExtension , haga clic en el botón Actualizar .

Vea también:

• Uso del protocolo Chrome DevTools (CDP) en aplicaciones WebView2

Paso 9: Compilación y ejecución del proyecto con paquetes actualizados

1. En Visual Studio, seleccione Depurar>iniciar depuración (F5).

   Se abre la ventana de la aplicación de ejemplo:

   

2. En Visual Studio, seleccione Depurar>detener depuración. Visual Studio cierra la aplicación.

Paso 10: Inspeccionar el código

1. En el editor de código de Visual Studio, inspeccione el código:

   

   El menú Comandos de DevTools :

   

   El menú Eventos de DevTools :

   

Vea también

• Referencia de api de WebView2
• Introducción a WebView2 en aplicaciones winUI 2 (UWP)
• Microsoft.Web.WebView2.DevToolsProtocolExtension en NuGet.