Rapporti di test

Queste funzionalità richiedono l'installazione di pacchetti NuGet aggiuntivi, come descritto in ogni sezione.

Suggerimento

Quando si usa Microsoft.Testing.Platform.MSBuild (incluso transitivamente da MSTest, NUnit e runner xUnit), queste estensioni vengono registrate automaticamente quando si installano i pacchetti NuGet, senza necessità di modifiche al codice. La registrazione manuale specificata in questo articolo è necessaria solo se il punto di ingresso generato automaticamente è stato disabilitato impostando <GenerateTestingPlatformEntryPoint>false</GenerateTestingPlatformEntryPoint>.

Report di test di Visual Studio (TRX)

Il file dei risultati del test Visual Studio (o TRX) è il formato predefinito per la pubblicazione dei risultati dei test. Questa estensione richiede il pacchetto NuGet Microsoft.Testing.Extensions.TrxReport .

Registrazione manuale

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

Annotazioni

Quando si usa la registrazione manuale, registrare il provider di report TRX per ultimo. L'implementazione corrente dipende dall'ordine di registrazione, quindi la registrazione dopo tutte le altre estensioni garantisce che acquisisca tutti i dati di test.

Options

Opzione Descrzione
--report-trx Genera il report TRX.
--report-trx-filename Nome del rapporto TRX generato. Il nome predefinito corrisponde al formato seguente <UserName>_<MachineName>_<yyyy-MM-dd_HH_mm_ss.fffffff>.trx.

Il report viene salvato all'interno della cartella predefinita TestResults che può essere specificata tramite l'argomento della riga di comando --results-directory.

I report di Azure DevOps

Azure DevOps plugin di report migliora l'esecuzione dei test per gli sviluppatori che ospitano il codice su GitHub, ma compilano su agenti di compilazione di Azure DevOps. Aggiunge informazioni aggiuntive ai guasti per mostrare il problema direttamente nella pull request di GitHub.

annotazione Errore nella visualizzazione dei file della richiesta pull GitHub

Questa estensione richiede il pacchetto NuGet Microsoft.Testing.Extensions.AzureDevOpsReport .

Registrazione manuale

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

Options

Opzione Descrzione
--report-azdo Abilita il generatore di report Azure DevOps. Gli errori e gli avvisi vengono scritti nell'output in un formato comprensibile Azure DevOps.
--report-azdo-severity Gravità da usare per gli eventi segnalati. I valori validi sono error (impostazione predefinita) e warning.
--report-azdo-flaky-history Interroga la cronologia dei risultati dei test di Azure DevOps degli ultimi N giorni (1-90) e annota gli esiti negativi segnalati con informazioni sul carattere intermittente. Richiede --report-azdo.
--report-azdo-demote-known-flaky Declassa da errori ad avvisi gli errori intermittenti nella finestra della cronologia di Azure DevOps quando sono sufficientemente frequenti (la soglia predefinita è del 25%). Richiede --report-azdo e --report-azdo-flaky-history.
--report-azdo-quarantine-file Percorso di un file di testo in cui sono elencati i nomi completi dei test in quarantena o i modelli GLOB. Gli errori corrispondenti vengono segnalati come avvisi. Richiede --report-azdo.
--report-azdo-upload-artifacts Carica i file dei risultati del test e/o aggiunge tag di compilazione a Azure DevOps. I valori validi sono off (impostazione predefinita), tags-only, filese all.
--report-azdo-upload-artifact-include Include i file nel caricamento dell'artefatto Azure DevOps usando modelli GLOB relativi alla directory dei risultati del test. Di default è **/*. Richiede --report-azdo-upload-artifacts che sia un valore diverso da off.
--report-azdo-upload-artifact-exclude Esclude i file dal caricamento dell'artefatto Azure DevOps usando modelli GLOB relativi alla directory dei risultati del test. Richiede --report-azdo-upload-artifacts che sia un valore diverso da off.
--report-azdo-upload-artifact-name Sostituisce il nome del contenitore artefatto di Azure DevOps. Di default è TestResults_{assemblyName}_{tfm}. Richiede --report-azdo-upload-artifacts che sia un valore diverso da off.
--publish-azdo-test-results Pubblica i risultati dei test nella scheda Azure DevOps Tests.
--publish-azdo-run-name Imposta un nome di esecuzione di test personalizzato Azure DevOps per la pubblicazione dei risultati del test live. Richiede --publish-azdo-test-results.

Annotazioni

L'estensione Azure DevOps è diventata stabile in MTP 1.9.0 (--report-azdo e --report-azdo-severity). Tutte le altre opzioni nella tabella , --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 , sono disponibili in MTP a partire dalla versione 2.3.0.

L'estensione rileva automaticamente che è in esecuzione nell'ambiente di integrazione continua (CI) controllando la TF_BUILD variabile di ambiente.

  • Last updated on