Sugerencia
Puede omitir un código de salida de específico mediante la opción de línea de comandos --ignore-exit-code.
También puede establecer opciones de línea de comandos que se aplican a un proyecto de prueba específico en el archivo de proyecto mediante la propiedad TestingPlatformCommandLineArguments MSBuild. Un caso de uso común es para los proyectos de prueba que tienen todas las pruebas ignoradas, que normalmente se cerrarán con el código de salida 8 (la sesión de prueba ejecutó cero pruebas). En este escenario, puede agregar lo siguiente debajo de un PropertyGroup en el archivo del proyecto.
<TestingPlatformCommandLineArguments>$(TestingPlatformCommandLineArguments) --ignore-exit-code 8</TestingPlatformCommandLineArguments>
Publicar el proyecto de prueba mediante dotnet publish y ejecutar la aplicación directamente es otra manera de ejecutar las pruebas. Por ejemplo, ejecutando el ./Contoso.MyTests.exe. En algunos escenarios también es viable usar dotnet build para generar el archivo ejecutable, pero puede haber casos perimetrales que se deben tener en cuenta, como AOT nativo.
Utilice dotnet run
El comando dotnet run se puede usar para compilar y ejecutar el proyecto de prueba. Esta es la manera más sencilla, aunque a veces más lenta, de ejecutar las pruebas. El uso de dotnet run es práctico al editar y ejecutar pruebas localmente, ya que garantiza que el proyecto de prueba se vuelva a compilar cuando sea necesario.
dotnet run también buscará automáticamente el proyecto en la carpeta actual.
dotnet run --project Contoso.MyTests
Para obtener más información sobre dotnet run, consulte dotnet run.
Utilice dotnet exec
El comando dotnet exec o dotnet se usa para ejecutar un proyecto de prueba ya compilado; es una alternativa a ejecutar la aplicación directamente.
dotnet exec requiere la ruta de acceso al archivo DLL del proyecto de prueba compilado.
dotnet exec Contoso.MyTests.dll
o
dotnet Contoso.MyTests.dll
Nota:
Si se proporciona la ruta de acceso al archivo ejecutable del proyecto de prueba (*.exe) se produce un error:
Error:
An assembly specified in the application dependencies manifest
(Contoso.MyTests.deps.json) has already been found but with a different
file extension:
package: 'Contoso.MyTests', version: '1.0.0'
path: 'Contoso.MyTests.dll'
previously found assembly: 'S:\t\Contoso.MyTests\bin\Debug\net10.0\Contoso.MyTests.exe'
Para obtener más información sobre dotnet exec, consulte dotnet exec.
Utilice dotnet test
Microsoft.Testing.Platform ofrece una capa de compatibilidad con vstest.console.exe y dotnet test garantiza que puede ejecutar las pruebas como antes al habilitar un nuevo escenario de ejecución.
dotnet test Contoso.MyTests.dll
Las pruebas Microsoft.Testing.Platform se pueden ejecutar (y depurar) en Visual Studio, se integran con el Explorador de pruebas y también se pueden ejecutar directamente como proyecto de inicio.
Ejecución de la aplicación con Visual Studio
El proyecto de prueba Microsoft.Testing.Platform se compila como un ejecutable y se puede ejecutar directamente. Esto ejecuta todas las pruebas del archivo ejecutable especificado, a menos que se proporcione un filtro.
- Vaya al proyecto de prueba que desea ejecutar en el Explorador de soluciones, selecciónelo con el botón derecho y seleccione Establecer como proyecto de inicio.
- Seleccione Depurar>Iniciar sin depurar (o use Ctrl+F5) para ejecutar el proyecto de prueba seleccionado.
Aparece la ventana de consola con la ejecución y el resumen de la prueba.
Depure la aplicación directamente en Visual Studio
El proyecto de prueba Microsoft.Testing.Platform se puede depurar directamente. Para depurar todas las pruebas en el ejecutable dado, a menos que se proporcione un filtro:
- Vaya al proyecto de prueba que desea ejecutar en el Explorador de soluciones, selecciónelo con el botón derecho y seleccione Establecer como proyecto de inicio.
- Establece un punto de interrupción en la prueba que deseas depurar.
- Vaya a Depurar>Iniciar depuración (o presione F5) para depurar el proyecto de prueba seleccionado.
Todas las pruebas se ejecutan hasta que se alcance la prueba con un punto de interrupción. Recorra la prueba para depurarla. Una vez que haya terminado de depurar la aplicación, se reanuda la ejecución de todas las pruebas restantes, a menos que la detenga.
Usar el Explorador de pruebas
Para ejecutar una prueba, vaya al Explorador de pruebas y seleccione la prueba (o las pruebas) que se van a ejecutar. Selecciónelo con el botón derecho y elija Ejecutar. De forma similar a depurar una prueba, seleccione la prueba (o pruebas) en el Explorador de pruebas, seleccione con el botón derecho y elija Depurar.
Nota:
La actualización automática de pruebas sin compilar el proyecto no está disponible.
La extensión C# junto con C# Dev Kit permite depurar/ejecutar pruebas en Visual Studio Code, además de agregar integración con el Explorador de pruebas de Visual Studio Code.
Ejecución de la aplicación con Visual Studio Code
El proyecto de prueba Microsoft.Testing.Platform se compila como un ejecutable y se puede ejecutar directamente. Esto ejecuta todas las pruebas del archivo ejecutable especificado, a menos que se proporcione un filtro.
- Vaya a un archivo de prueba para el que desea ejecutar pruebas.
- Use Ctrl+F5 para ejecutar el proyecto de prueba seleccionado. Si tiene varios proyectos, una ventana emergente le pedirá que seleccione el que va a ejecutarse.
Aparece la ventana de consola con la ejecución y el resumen de la prueba.
Depurar la aplicación directamente en Visual Studio Code
El proyecto de prueba Microsoft.Testing.Platform se compila como un ejecutable y se puede ejecutar directamente. Esto ejecuta todas las pruebas del archivo ejecutable especificado, a menos que se proporcione un filtro.
- Vaya a un archivo de prueba para el que desea ejecutar pruebas.
- Use F5 para depurar el proyecto de prueba seleccionado. Si tiene varios proyectos, una ventana emergente le pedirá que seleccione el que va a ejecutarse.
Sugerencia
Existen otras formas de ejecutar un proyecto .NET usando C# DevKit, como ejecutar desde el explorador de soluciones o crear las configuraciones de inicio correspondientes. Se especifican en la documentación de Visual Studio Code.
A medida que se ejecuta el proyecto, aparece la pestaña de salida con la ejecución y el resumen de su prueba.
Usar el Explorador de pruebas
Para ejecutar una prueba, vaya al Explorador de pruebas y seleccione la prueba (o las pruebas) que se van a ejecutar. Selecciónelo con el botón derecho y elija Ejecutar. De forma similar a depurar una prueba, seleccione la prueba (o pruebas) en el Explorador de pruebas, seleccione con el botón derecho y elija Depurar.
Nota:
La actualización automática de pruebas sin compilar el proyecto no está disponible.
Para ejecutar un solo proyecto de prueba en CI, agregue un paso para cada archivo ejecutable de prueba que desee ejecutar, como el siguiente en Azure DevOps:
- task: CmdLine@2
displayName: "Run Contoso.MyTests"
inputs:
script: '.\Contoso.MyTests\bin\Debug\net10.0\Contoso.MyTests.exe'
Ejecute el dotnet test comando manualmente, similar al flujo de trabajo local típico:
- task: CmdLine@2
displayName: "Run tests"
inputs:
script: 'dotnet test' # add command-line options as needed
Ejecutar usando la tarea de Azure con el comando de prueba DotNetCoreCLI. Esto requiere un global.json archivo en la raíz del repositorio que especifique Microsoft.Testing.Platform como ejecutor de pruebas:
{
"test": {
"runner": "Microsoft.Testing.Platform"
}
}
- task: DotNetCoreCLI@2
displayName: "Run tests"
inputs:
command: test
Nota:
La compatibilidad con Microsoft.Testing.Platform en DotNetCoreCLI se agregó en la versión 2.263.0 de la tarea.