Examen de la compatibilidad de Visual Studio Code con pruebas unitarias

  • 7 minutos

Para poder generar pruebas unitarias con GitHub Copilot, el proyecto necesita un marco de pruebas de trabajo y una manera de ejecutar pruebas dentro de Visual Studio Code. Visual Studio Code, el SDK de .NET y la extensión C# Dev Kit proporcionan el entorno que hospeda las pruebas unitarias, mientras que GitHub Copilot se centra en generar y refinar el código de prueba. Comprender el entorno subyacente hace que el flujo de trabajo de GitHub Copilot sea mucho más fácil de seguir.

En esta unidad se examinan las características de Visual Studio Code y las herramientas de C# que admiten pruebas unitarias. Las unidades posteriores se centran en cómo GitHub Copilot genera y mantiene el código de prueba que se ejecuta en este entorno.

Visual Studio Code soporte para pruebas unitarias

Para crear y ejecutar pruebas unitarias de C# en Visual Studio Code, necesita los siguientes recursos:

  • El SDK de .NET 8.0 o posterior.
  • Extensión del Kit de desarrollo de C# para Visual Studio Code.
  • Un paquete de marco de prueba agregado al proyecto.

Compatibilidad del kit de desarrollo de C# para pruebas unitarias

La extensión kit de desarrollo de C# proporciona las características de prueba que se usan en este módulo:

  • Explorador de pruebas: vista de árbol que muestra todos los casos de prueba del área de trabajo. Para abrir el Explorador de pruebas, seleccione el icono de beaker en la barra actividad.
  • Ejecutar o depurar casos de prueba: los botones de reproducción verde aparecen en el editor junto a cada clase y método de prueba. Haga clic con el botón derecho en un botón de reproducción para ver más opciones.
  • Ver los resultados de las pruebas: después de ejecutar una prueba, el resultado se refleja en las decoraciones del editor y en el Explorador de pruebas. Al seleccionar un vínculo en una traza de pila, se va a la ubicación del código fuente.
  • Comandos de prueba: los comandos como Test: Run All Tests están disponibles en la paleta de comandos. Busque Test: para ver la lista completa.
  • Configuración de pruebas: la configuración que controla la detección de pruebas y el comportamiento en tiempo de ejecución están disponibles en el editor de configuración. Busque Testing para ver las opciones disponibles.

El Kit de desarrollo de C# es compatible con los siguientes marcos de pruebas:

  • xUnit
  • NUnit
  • MSTest (herramienta de pruebas de Microsoft)

Creación de un proyecto de prueba mediante la paleta de comandos

La paleta de comandos de Visual Studio Code proporciona la manera más fácil de crear un proyecto de prueba que use un marco compatible. Puede abrir la paleta de comandos de las siguientes formas:

  • Presione las teclas Ctrl + Shift + P (Windows/Linux) o Cmd + Shift + P (macOS).
  • Abra el menú Vista y después seleccione Paleta de comandos.
  • Abra la vista Explorador de soluciones, haga clic con el botón derecho en la carpeta de la solución y seleccione Nuevo proyecto. Esta opción abre la paleta de comandos con el .NET: Nuevo Project... comando ya seleccionado.

En las secciones siguientes se muestra cómo crear un proyecto de prueba para cada marco compatible.

xUnit

Abra la paleta de comandos y seleccione .NET: Nuevo Project... , seleccione xUnit Test Project y proporcione un nombre y una ubicación para el nuevo project. Este comando crea un proyecto que usa xUnit como biblioteca de pruebas y configura el ejecutor de pruebas agregando los siguientes <PackageReference /> elementos al archivo del proyecto:

  • Microsoft.NET.Test.Sdk
  • xUnit
  • xunit.runner.visualstudio
  • coverlet.collector

Desde el terminal integrado, puede agregar una referencia desde el proyecto de prueba al proyecto en prueba:

dotnet add [location of your test csproj file] reference [location of the csproj file for project to be tested]

NUnit

Abra la paleta de comandos y seleccione .NET: Nuevo Project... , seleccione NUnit3 Test Project y proporcione un nombre y una ubicación para el nuevo project. Este comando crea un proyecto que usa NUnit como biblioteca de pruebas y agrega los siguientes <PackageReference /> elementos al archivo del proyecto:

  • Microsoft.NET.Test.Sdk
  • NUnit
  • NUnit3TestAdapter

Agregue una referencia al proyecto en prueba desde terminal:

dotnet add [location of your test csproj file] reference [location of the csproj file for project to be tested]

MSTest (herramienta de pruebas de Microsoft)

Abra la paleta de comandos y seleccione .NET: Nuevo Project... , seleccione MSTest Test Project y proporcione un nombre y una ubicación para el nuevo project. Este comando agrega los siguientes <PackageReference /> elementos al archivo de proyecto:

  • Microsoft.NET.Test.Sdk
  • MSTest.TestAdapter
  • MSTest.TestFramework
  • coverlet.collector

Agregue una referencia al proyecto en prueba desde terminal:

dotnet add [location of your test csproj file] reference [location of the csproj file for project to be tested]

Ejecución y administración de pruebas unitarias en Visual Studio Code

Una vez que existe un proyecto de prueba, Visual Studio Code y el Kit de desarrollo de C# ofrecen varias maneras de ejecutar y administrar pruebas:

  • Ejecutar o depurar desde el editor: seleccione el botón de reproducción verde situado junto a una clase o método para ejecutar ese destino. Haga clic con el botón derecho en el botón de reproducción para ver opciones como Ejecutar prueba y depurar prueba.
  • Explorador de pruebas: ejecute o depure pruebas individuales, grupos o el conjunto completo desde la vista de árbol. Los resultados de las pruebas, incluidos los iconos de paso y error y las duraciones, aparecen junto a cada elemento.
  • Ver los resultados de las pruebas: las decoraciones del editor y el Explorador de pruebas reflejan el estado actual de cada prueba después de una ejecución. Seleccione enlaces en las trazas de pila para saltar a la línea que provoca el error.
  • Comandos de prueba: use comandos como Test: Run All Tests, Test: Debug Failed Testsy Test: Show Output desde la paleta de comandos.
  • Configuración de prueba: Busque Testing en el editor de configuración para configurar opciones como la ejecución automática al guardar o el formato de los resultados de las pruebas.

Flujo de trabajo de pruebas unitarias con GitHub Copilot

Al combinar Visual Studio Code con GitHub Copilot, el proceso de prueba unitaria se divide en tres fases:

  1. Set up the environment: Use Visual Studio Code, el SDK de .NET y el Kit de desarrollo de C# para crear un proyecto de prueba y hacer referencia al proyecto en prueba. Ha completado esta fase en esta unidad.
  2. Generar código de prueba: use GitHub Copilot en la vista Chat para generar pruebas unitarias para el código de la aplicación. Las siguientes unidades cubren esta fase.
  3. Ejecutar y mantener pruebas: Use el Explorador de pruebas y el Kit de desarrollo de C# para ejecutar pruebas y, a continuación, use GitHub Copilot para ampliar la cobertura y corregir las pruebas con errores.

Las unidades restantes se centran en las herramientas de GitHub Copilot que admiten las fases 2 y 3.