Testrapporter

Dessa funktioner kräver installation av ytterligare NuGet-paket, enligt beskrivningen i varje avsnitt.

Tips/Råd

När du använder Microsoft.Testing.Platform.MSBuild (ingår transitivt av MSTest, NUnit och xUnit-löpare) registreras dessa tillägg automatiskt när du installerar deras NuGet-paket – inga kodändringar behövs. Den manuella registrering som anges i den här artikeln krävs bara om du inaktiverade den automatiskt genererade startpunkten genom att ange <GenerateTestingPlatformEntryPoint>false</GenerateTestingPlatformEntryPoint>.

Visual Studio testrapporter (TRX)

Den Visual Studio testresultatfilen (eller TRX) är standardformatet för publicering av testresultat. Det här tillägget kräver NuGet-paketet Microsoft.Testing.Extensions.TrxReport .

Manuell registrering

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

Anmärkning

När du använder manuell registrering registrerar du TRX-rapportprovidern senast. Den aktuella implementeringen beror på registreringsordningen, så om du registrerar den efter alla andra tillägg ser du till att den samlar in alla testdata.

Alternativ

Alternativ Description
--report-trx Genererar TRX-rapporten.
--report-trx-filename Namnet på den genererade TRX-rapporten. Standardnamnet matchar följande format <UserName>_<MachineName>_<yyyy-MM-dd_HH_mm_ss.fffffff>.trx.

Rapporten sparas i standardmappen TestResults som kan anges via kommandoradsargumentet --results-directory.

Azure DevOps rapporter

Azure DevOps rapportplugin förbättrar testkörningen för utvecklare som är värdar för sin kod på GitHub, men använder Azure DevOps byggagenter. Den tillhandahåller mer information om fel för att visa dessa direkt i GitHub PR.

Felanmärkningar i GitHub PR-filernas vy

Det här tillägget kräver NuGet-paketet Microsoft.Testing.Extensions.AzureDevOpsReport .

Manuell registrering

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

Alternativ

Alternativ Description
--report-azdo Aktiverar Azure DevOps rapportgenerator. Fel och varningar skrivs till utdata i ett format som Azure DevOps förstår.
--report-azdo-severity Allvarlighetsgrad att använda för rapporterade händelser. Giltiga värden är error (standard) och warning.
--report-azdo-flaky-history Hämtar Azure DevOps-testresultathistorik för de senaste N dagarna (1–90) och annoterar rapporterade misslyckanden med kontext om instabilitet. Kräver --report-azdo.
--report-azdo-demote-known-flaky Nedgraderar misslyckanden som är tillräckligt instabila i historikfönstret i Azure DevOps (standardtröskelvärdet är 25 %) från fel till varningar. Kräver --report-azdo och --report-azdo-flaky-history.
--report-azdo-quarantine-file Sökväg till en textfil som listar fullständigt kvalificerade namn för test i karantän eller globmönster. Misslyckanden vid matchning rapporteras som varningar. Kräver --report-azdo.
--report-azdo-upload-artifacts Laddar upp testresultatfiler och/eller lägger till byggtaggar i Azure DevOps. Giltiga värden är off (standard), tags-only, filesoch all.
--report-azdo-upload-artifact-include Innehåller filer i Azure DevOps artefaktuppladdning med hjälp av globmönster i förhållande till katalogen för testresultat. Standardinställningen är **/*. Kräver --report-azdo-upload-artifacts att vara ett annat värde än off.
--report-azdo-upload-artifact-exclude Exkluderar filer från Azure DevOps artefaktuppladdning med hjälp av globmönster i förhållande till katalogen med testresultat. Kräver --report-azdo-upload-artifacts att vara ett annat värde än off.
--report-azdo-upload-artifact-name Åsidosätter namnet på artefaktcontainern i Azure DevOps. Standardinställningen är TestResults_{assemblyName}_{tfm}. Kräver --report-azdo-upload-artifacts att vara ett annat värde än off.
--publish-azdo-test-results Publicerar testresultat live på fliken Azure DevOps Tests.
--publish-azdo-run-name Anger ett anpassat Azure DevOps testkörningsnamn för live-testresultatpublicering. Kräver --publish-azdo-test-results.

Anmärkning

Tillägget Azure DevOps blev stabilt i MTP 1.9.0 (--report-azdo och --report-azdo-severity). Alla andra alternativ i tabellen – --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-resultsoch --publish-azdo-run-name – är tillgängliga i MTP från och med version 2.3.0.

Tillägget identifierar automatiskt att det körs i en CI-miljö (continuous integration) genom att kontrollera TF_BUILD miljövariabeln.