Relatórios de teste

Esses recursos exigem a instalação de pacotes NuGet adicionais, conforme descrito em cada seção.

Dica

Ao usar o Microsoft.Testing.Platform.MSBuild (incluído transitivamente por MSTest, NUnit e xUnit runners), essas extensões são registradas automaticamente quando você instala seus pacotes NuGet , sem necessidade de alterações de código. O registro manual especificado neste artigo só será necessário se você desabilitar o ponto de entrada gerado automaticamente definindo <GenerateTestingPlatformEntryPoint>false</GenerateTestingPlatformEntryPoint>.

Visual Studio relatórios de teste (TRX)

O Visual Studio arquivo de resultado de teste (ou TRX) é o formato padrão para publicar resultados de teste. Essa extensão requer o pacote NuGet Microsoft.Testing.Extensions.TrxReport .

Registro manual

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

Observação

Ao usar o registro manual, registre o provedor de relatório TRX por último. A implementação atual depende da ordem de registro, portanto, registrá-la após todas as outras extensões garante que ela capture todos os dados de teste.

Opções

Opção	DESCRIÇÃO
--report-trx	Gera o relatório TRX.
--report-trx-filename	O nome do relatório TRX gerado. O nome padrão corresponde ao seguinte formato <UserName>_<MachineName>_<yyyy-MM-dd_HH_mm_ss.fffffff>.trx.

O relatório é salvo dentro da pasta TestResults padrão que pode ser especificada por meio do argumento de --results-directory linha de comando.

relatórios Azure DevOps

O plug-in de relatório do Azure DevOps aprimora a execução de testes para desenvolvedores que hospedam seu código no GitHub, mas realizam builds em agentes de build do Azure DevOps. Isso adiciona informações extras às falhas para exibi-las diretamente na PR do GitHub.

Anotação de erro na visualização de arquivos de PR do GitHub

Essa extensão requer o pacote NuGet Microsoft.Testing.Extensions.AzureDevOpsReport .

Registro manual

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

Opções

Opção	DESCRIÇÃO
--report-azdo	Habilita o gerador de relatório Azure DevOps. Erros e avisos são gravados na saída em um formato que Azure DevOps entende.
--report-azdo-severity	Severidade a ser usada para eventos reportados. Os valores válidos são error (padrão) e warning.
--report-azdo-flaky-history	Consulta o histórico de resultados de teste do Azure DevOps dos últimos N dias (1 a 90) e anota as falhas relatadas com contexto de instabilidade. Requer --report-azdo.
--report-azdo-demote-known-flaky	Rebaixa falhas que são bastante irregulares na janela de histórico de Azure DevOps (o limite padrão é 25%) de erros a avisos. Requer --report-azdo e --report-azdo-flaky-history.
--report-azdo-quarantine-file	Caminho para um arquivo de texto que lista nomes totalmente qualificados de teste em quarentena ou padrões glob. Falhas correspondentes são relatadas como avisos. Requer --report-azdo.
--report-azdo-upload-artifacts	Envia arquivos de resultados de teste e/ou adiciona tags de build ao Azure DevOps. Os valores válidos são off (padrão), tags-onlye filesall.
--report-azdo-upload-artifact-include	Inclui arquivos no upload de artefatos do Azure DevOps usando padrões glob relativos ao diretório de resultados de teste. Usa **/* como padrão. Requer --report-azdo-upload-artifacts ser um valor diferente de off.
--report-azdo-upload-artifact-exclude	Exclui arquivos do upload de artefatos do Azure DevOps usando padrões glob relativos ao diretório de resultados de teste. Requer --report-azdo-upload-artifacts ser um valor diferente de off.
--report-azdo-upload-artifact-name	Substitui o nome do contêiner de artefatos do Azure DevOps. Usa TestResults_{assemblyName}_{tfm} como padrão. Requer --report-azdo-upload-artifacts ser um valor diferente de off.
--publish-azdo-test-results	Publica os resultados do teste ao vivo na guia Azure DevOps Tests.
--publish-azdo-run-name	Define um nome de execução de teste de Azure DevOps personalizado para publicação de resultado de teste ao vivo. Requer --publish-azdo-test-results.

Observação

A extensão Azure DevOps ficou estável no MTP 1.9.0 (--report-azdo e --report-azdo-severity). Todas as outras opções na tabela — --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-resultse --publish-azdo-run-name — estão disponíveis no MTP a partir da versão 2.3.0.

A extensão detecta automaticamente que está em execução no ambiente de CI (integração contínua) verificando a variável de TF_BUILD ambiente.