Informes de prueba

Estas características requieren la instalación de paquetes NuGet adicionales, como se describe en cada sección.

Sugerencia

Al usar Microsoft.Testing.Platform.MSBuild (incluido transitivamente por MSTest, NUnit y ejecutores xUnit), estas extensiones se registran automáticamente al instalar sus paquetes NuGet, no se necesitan cambios de código. El registro manual especificado en este artículo solo es necesario si ha deshabilitado el punto de entrada generado automáticamente estableciendo <GenerateTestingPlatformEntryPoint>false</GenerateTestingPlatformEntryPoint>.

informes de prueba de Visual Studio (TRX)

El Visual Studio archivo de resultados de pruebas (o TRX) es el formato predeterminado para publicar resultados de pruebas. Esta extensión requiere el paquete NuGet Microsoft.Testing.Extensions.TrxReport .

Registro manual

var builder = await TestApplication.CreateBuilderAsync(args);
builder.AddTrxReportProvider();

Nota:

Al usar el registro manual, registre el proveedor de informes TRX por última vez. La aplicación actual depende del orden de registro, por lo que al registrarla después de todas las demás extensiones se garantiza que capturen todos los datos de prueba.

Options

Opción Description
--report-trx Genera el informe TRX.
--report-trx-filename Nombre del informe TRX generado. El nombre predeterminado coincide con el formato <UserName>_<MachineName>_<yyyy-MM-dd_HH_mm_ss.fffffff>.trxsiguiente.

El informe se guarda dentro de la carpeta TestResults predeterminada que se puede especificar a través del argumento de --results-directory la línea de comandos.

informes de Azure DevOps

Azure DevOps ofrece un plugin de reporte que mejora la ejecución de pruebas para desarrolladores que alojan su código en GitHub, pero realizan el compilado en agentes de compilación de Azure DevOps. Agrega información adicional a los errores para mostrar el error directamente en GitHub PR.

anotación Error de anotación en GitHub vista de archivos

Esta extensión requiere el paquete NuGet Microsoft.Testing.Extensions.AzureDevOpsReport .

Registro manual

var builder = await TestApplication.CreateBuilderAsync(args);
builder.TestHost.AddAzureDevOpsProvider();

Options

Opción Description
--report-azdo Habilita el generador de informes Azure DevOps. Los errores y advertencias se escriben en la salida en un formato que Azure DevOps entiende.
--report-azdo-severity Gravedad que se utilizará para los eventos notificados. Los valores válidos son error (valor predeterminado) y warning.
--report-azdo-flaky-history Consulta el historial de resultados de pruebas de Azure DevOps de los últimos N días (1-90) y anota los fallos notificados con información contextual sobre la inestabilidad. Se requiere --report-azdo.
--report-azdo-demote-known-flaky Rebaja de errores a advertencias los fallos suficientemente intermitentes en la ventana del historial de Azure DevOps (el umbral predeterminado es del 25 %). Requiere --report-azdo y --report-azdo-flaky-history.
--report-azdo-quarantine-file Ruta de acceso a un archivo de texto que muestra nombres completos o patrones globales de prueba en cuarentena. Los errores coincidentes se notifican como advertencias. Se requiere --report-azdo.
--report-azdo-upload-artifacts Carga archivos de resultados de prueba o agrega etiquetas de compilación a Azure DevOps. Los valores válidos son off (valor predeterminado), tags-only, filesy all.
--report-azdo-upload-artifact-include Incluye archivos en la carga de artefactos de Azure DevOps mediante patrones glob relativos al directorio de resultados de las pruebas. Tiene como valor predeterminado **/*. Requiere --report-azdo-upload-artifacts que sea un valor distinto de off.
--report-azdo-upload-artifact-exclude Excluye los archivos de la carga de artefactos de Azure DevOps mediante patrones globales en relación con el directorio de resultados de pruebas. Requiere --report-azdo-upload-artifacts que sea un valor distinto de off.
--report-azdo-upload-artifact-name Invalida el nombre del contenedor de artefactos de Azure DevOps. Tiene como valor predeterminado TestResults_{assemblyName}_{tfm}. Requiere --report-azdo-upload-artifacts que sea un valor distinto de off.
--publish-azdo-test-results Publica los resultados de las pruebas en directo en la pestaña Azure DevOps Tests.
--publish-azdo-run-name Establece un nombre de ejecución de prueba de Azure DevOps personalizado para la publicación de resultados de pruebas en directo. Se requiere --publish-azdo-test-results.

Nota:

La extensión Azure DevOps se convirtió en estable en MTP 1.9.0 (--report-azdo y --report-azdo-severity). Todas las demás opciones de la tabla ( --report-azdo-flaky-history, --report-azdo-demote-known-flaky--report-azdo-quarantine-file--report-azdo-upload-artifacts--report-azdo-upload-artifact-include--report-azdo-upload-artifact-exclude, --report-azdo-upload-artifact-name, --publish-azdo-test-resultsy --publish-azdo-run-name ) están disponibles en MTP a partir de la versión 2.3.0.

La extensión detecta automáticamente que se ejecuta en el entorno de integración continua (CI) comprobando la variable de TF_BUILD entorno.