Microsoft.Testing.Platform (MTP): referencia de las opciones de la CLI

En este artículo se proporciona un punto de entrada central para las opciones de línea de comandos de MTP.

Important

Las opciones de plataforma están disponibles en MTP. Las opciones de extensión solo están disponibles cuando cada aplicación de prueba de destino registra el paquete de extensión que los proporciona. Agregue el paquete directamente o use una configuración o perfil del SDK de prueba que lo incluya. Si una aplicación de prueba no registra la extensión, se produce un error en la ejecución con el código de salida 5 porque no se reconoce la opción.

Opciones de plataforma

• @

  Especifica el nombre del archivo de respuesta. El nombre del archivo de respuesta debe seguir inmediatamente el @ carácter sin espacio en blanco entre el @ carácter y el nombre del archivo de respuesta.

  Las opciones de un archivo de respuesta se interpretan como si estuvieran presentes en ese lugar en la línea de comandos. No puedes usar el carácter de barra inversa \ para concatenar líneas. El uso de un archivo de respuesta ayuda para comandos muy largos que podrían superar los límites de terminal. Puede combinar un archivo de respuesta con argumentos de línea de comandos en línea. Por ejemplo:

  ./TestExecutable.exe @"filter.rsp" --timeout 10s
  

  donde filter.rsp puede tener el siguiente contenido:

  --filter "A very long filter"
  

  O bien, se puede usar un único archivo rsp para especificar el tiempo de espera y el filtro como se indica a continuación:

  ./TestExecutable.exe @"arguments.rsp"
  

  --filter "A very long filter" --timeout 10s
  

  Nota:

  Cuando se usa dotnet test, el analizador de línea de comandos del SDK usa un enfoque de token por línea en el que cada línea del archivo de respuesta se trata como un único token. En ese caso, cada argumento debe estar en una línea independiente:

  --filter
  A very long filter
  --timeout
  10s
  

• --config-file

  Especifica un archivo testconfig.json.

• --debug

  Detiene la ejecución de la prueba al iniciarse para que pueda adjuntar un depurador al proceso de prueba. Equivalente a establecer la TESTINGPLATFORM_WAIT_ATTACH_DEBUGGERvariable de entorno en 1. No se admite en plataformas de explorador.

  Nota:

  Esta opción está disponible en MTP a partir de la versión 1.9.0. Reemplaza la opción anterior (introducida en MTP 1.6.0); el nombre anterior --debug-wait-attach se quitó y ya no se debe usar.

• --diagnostic

  Habilita el registro de diagnóstico. El nivel de registro predeterminado es Trace. Para cada origen de prueba, MTP escribe <asm>_<tfm>_<arch>_<timestamp>.diag. Si se produce una colisión de marcas de tiempo, MTP añade un sufijo de proceso y contador en lugar de sobrescribir el archivo existente.

• --diagnostic-synchronous-write

  Obliga al registrador de archivos integrado a escribir registros de forma sincrónica. Resulta útil para escenarios en los que no desea perder ninguna entrada de registro (si el proceso se bloquea). Esto ralentiza la ejecución de la prueba.

  Nota:

  Disponible en MTP a partir de la versión 2.0.0. Reemplaza la opción anterior --diagnostic-filelogger-synchronouswrite , que se quitó en MTP 2.0.0.

• --diagnostic-output-directory

  Directorio de salida del registro de diagnóstico, si no se especifica que el archivo se genere en el directorio predeterminado TestResults.

• --diagnostic-file-prefix

  Prefijo del nombre del archivo de registro. El valor predeterminado es <asm>_<tfm>_<arch>.

  Nota:

  Disponible en MTP a partir de la versión 2.0.0. Reemplaza la opción anterior --diagnostic-output-fileprefix , que se quitó en MTP 2.0.0.

• --diagnostic-verbosity

  Define el nivel de detalle cuando se usa el modificador --diagnostic. Los valores disponibles son Trace, Debug, Information, Warning, Erroro Critical.

• --enable-dynamic-extensions

  Permite cargar extensiones declaradas en archivos de manifiesto *.testingplatformextensions.json junto con la aplicación de prueba. Las extensiones dinámicas están deshabilitadas de forma predeterminada. Para conocer los requisitos de seguridad y el esquema del manifiesto, consulte Carga de extensiones dinámicamente.

  Nota:

  Esta opción está disponible en MTP a partir de la versión 2.4.0.

• --exit-on-process-exit

  Salga del proceso de prueba si el proceso dependiente se cierra. Se debe proporcionar PID.

• --filter-uid

  Filtra las pruebas que se ejecutarán según los UID de sus nodos de prueba. Acepta uno o varios UID.

  Nota:

  Esta opción está disponible en MTP a partir de la versión 1.8.0. A partir de MTP 2.3.0, no se pueden combinar --filter-uid y --treenode-filter; si se especifican ambos, no se supera la validación de la línea de comandos y se devuelve el código de salida InvalidCommandLine.

• --help

  Imprime una descripción de cómo usar el comando .

• --ignore-exit-code

  Permite omitir algunos códigos de salida distintos de cero y, en su lugar, devolverlos como 0. Para obtener más información, consulte Omisión de códigos de salida específicos.

• --info

  Muestra información avanzada sobre la aplicación de prueba de .NET, como:

  • La plataforma.
  • El entorno.
  • Cada proveedor de línea de comandos registrado, como name, version, description y options.
  • Cada herramienta registrada, como command, name, version, description, y todos los proveedores de línea de comandos.

  Esta característica se usa para comprender las extensiones que registrarían la misma opción de línea de comandos o los cambios en las opciones disponibles entre varias versiones de una extensión (o la plataforma).

• --list-tests

  Enumera las pruebas disponibles sin ejecutarlas. Opcionalmente, toma un argumento que controla el formato de salida: text (valor predeterminado, legible por el usuario) o json.

  Nota:

  El json formato de salida está disponible en MTP a partir de la versión 2.3.0.

• --maximum-failed-tests

  Especifica el número máximo de errores de pruebas que, cuando se alcanza, detendrá la ejecución de pruebas. La compatibilidad con este modificador requiere que los autores del marco implementen la funcionalidad IGracefulStopTestExecutionCapability. El código de salida al alcanzar esa cantidad de errores de prueba es 13. Para obtener más información, consulte Códigos de salida de MTP.

  Nota:

  Esta característica está disponible en MTP a partir de la versión 1.5.

• --minimum-expected-tests

  Especifica un número mínimo positivo de pruebas que se deben ejecutar. Cuando la ejecución ejecuta menos pruebas, incluido cero, sale con el código 9. Un mínimo explícito prevalece sobre --zero-tests-policy.

  Con dotnet test, esta opción se aplica a toda la ejecución cuando se especifica antes de --, y a cada módulo de prueba cuando se especifica después de --. Para obtener más información, consulte Los mínimos de ejecución completa y por módulo.

  Nota:

  --minimum-expected-tests 0 no es válido. Para suprimir el código de salida de pruebas cero, use --ignore-exit-code 8.

• --no-banner

  Deshabilita el banner de inicio, el mensaje de copyright y el banner de telemetría. El mismo efecto se puede lograr a través de las TESTINGPLATFORM_NOBANNERDOTNET_NOLOGO o .

• --results-directory

  El directorio donde se guardarán los resultados de pruebas. Si el directorio especificado no existe, se crea. El valor predeterminado es TestResults en el directorio que contiene la aplicación de prueba.

• --server

  Inicia la aplicación de prueba en modo servidor JSON-RPC para la integración con editores, IDE o herramientas. Omita el valor o use jsonrpc. Para obtener un cliente de solo origen compatible, consulte Modo de servidor MTP.

  Important

  El dotnettestcli valor y sus argumentos de transporte son internos para la integración del SDK de .NET. No los pase manualmente.

• --show-slowest-tests

  Muestra el número solicitado de pruebas más lentas en el resumen del terminal. Cuando una ejecución contiene varios módulos de prueba, MTP notifica las pruebas más lentas para cada módulo.

  Nota:

  Esta opción está disponible en MTP a partir de la versión 2.4.0.

• --timeout

  Tiempo de espera global de ejecución de pruebas. Toma un argumento como cadena en el formato <value>[h|m|s] donde <value> es float.

• --treenode-filter

  Filtra las pruebas que se van a ejecutar mediante una expresión de filtro de árbol. Los filtros de árbol ofrecen una coincidencia más completa que --filter para escenarios avanzados.

  Nota:

  A partir de MTP 2.3.0, no se pueden combinar --treenode-filter y --filter-uid; si se especifican ambos, no se supera la validación de la línea de comandos y se devuelve el código de salida InvalidCommandLine.

• --zero-tests-policy

  Controla si una ejecución en la que no se ejecuta ninguna prueba porque se omitieron todas las pruebas se trata como un fallo. Los valores válidos son allow-skipped (valor predeterminado) y strict. Con allow-skipped, una ejecución con todo omitido se completa correctamente. Con strict, se produce un error con el código 8de salida . Un valor explícito --minimum-expected-tests reemplaza esta directiva y usa código 9 de salida cuando no se cumple el mínimo.

  Nota:

  Esta opción está disponible en MTP a partir de la versión 4.3.0. Con dotnet test, pase la opción después de -- para reenviarla a cada módulo de prueba. Cuando no establece un mínimo global, el SDK de .NET 11 determina el veredicto de pruebas cero de ejecución completa por separado. Para obtener más información, consulte Los mínimos de ejecución completa y por módulo.

Opciones de extensión por escenario

Use la tabla siguiente para buscar el paquete y las opciones de cada extensión. Un perfil de SDK de prueba puede proporcionar un paquete en lugar de una referencia de paquete directo.

Escenario	Componente requerido	Documentación de características
Recopilar cobertura de código	Microsoft.Testing.Extensions.CodeCoverage o coverlet.MTP	Cobertura de código
Recopilación de volcados por caída o bloqueo	Microsoft.Testing.Extensions.CrashDump o Microsoft.Testing.Extensions.HangDump	Volcados de bloqueo y de falta de respuesta
Generación de informes de prueba	Paquete de extensión para el formato seleccionado, como Microsoft.Testing.Extensions.TrxReport	Informes de prueba
Personalización de la salida del terminal	Núcleo MTP (sin paquete adicional)	Salida del terminal
Volver a intentar pruebas fallidas	Microsoft.Testing.Extensions.Retry	Reintentar

Detección de opciones en la aplicación de prueba

Ejecute el ejecutable de prueba con --helpo ejecute dotnet test --help en modo MTP para enumerar las opciones disponibles para el conjunto de extensiones actual.

Para obtener diagnósticos avanzados de proveedores y opciones registrados, ejecute con --info.

Consulte también

• Introducción a MTP
• Características de MTP
• Pruebas con dotnet test