Microsoft. Funzionalità di Testing.Platform (MTP)

MTP viene fornito con funzionalità predefinite e può essere esteso tramite pacchetti NuGet.

Quando si utilizza Microsoft.Testing.Platform.MSBuild (incluso transitivamente dai driver di MSTest, NUnit e xUnit), è sufficiente installare un pacchetto NuGet di estensione: le estensioni vengono rilevate e registrate automaticamente e il punto di ingresso viene generato per te.

Se si rifiuta esplicitamente il punto di ingresso generato automaticamente impostando <GenerateTestingPlatformEntryPoint>false</GenerateTestingPlatformEntryPoint>, è necessario registrare manualmente le estensioni nel Main metodo. Ogni pagina di estensione documenta la chiamata di registrazione manuale.

Le estensioni che richiedono un pacchetto NuGet vengono fornite con il proprio modello di licenza (alcuni meno permissivi), assicurarsi di fare riferimento alla licenza associata alle estensioni da usare.

Inizia qui

Usare il percorso seguente in base all'obiettivo:

• Trovare le opzioni della riga di comando in un'unica posizione: informazioni di riferimento sulle opzioni dell'interfaccia della riga di comando MTP.
• Aggiungi funzionalità alle esecuzioni di test: usa le pagine delle funzioni in questo articolo.
• Creare un'estensione personalizzata: architettura MTP, punti di estensione e servizi.

Scegliere per scenario

• È necessario personalizzare l'output del terminale: output del terminale (predefinito)
• Sono necessari i report TRX o Azure DevOps: i report di Test (estensione)
• Servono dati di copertura: copertura del codice (estensione)
• È necessaria la diagnostica di arresto anomalo o blocco: arresti anomali e dump di blocco (estensione)
• Necessità di ripetere i test non riusciti: Riprovare (estensione)
• Necessita supporto per hot reload: Ricaricamento rapido (estensione)
• È necessario il supporto di Microsoft Fakes: Microsoft Fakes (estensione)
• Sono necessarie tracce e metriche OpenTelemetry: OpenTelemetry (estensione )
• Raccolta dei dati di Telemetria e opzione di esclusione (estensione)

Funzionalità predefinite

Queste funzionalità fanno parte della piattaforma principale e non richiedono pacchetti NuGet aggiuntivi.

Output del terminale

Stato e segnalazione dello stato al terminale: modalità di output, supporto ANSI e indicatori di stato.

Funzionalità di estensione

Queste funzionalità richiedono l'installazione di pacchetti NuGet.

Report di test

Generare file di report di test (TRX, Azure DevOps).

Copertura del codice

Raccogli i dati di code coverage durante l'esecuzione dei test.

Arresti anomali e blocchi

Raccogliere i file di dump del processo quando l'host di test va in crash o si blocca.

OpenTelemetry

Generare tracce e metriche tramite OpenTelemetry durante le esecuzioni dei test.

Riprova

Ripetere i test non riusciti con criteri configurabili.

Ricaricamento rapido

Eseguire test con supporto di ricaricamento rapido per un'iterazione rapida.

Microsoft Fakes

Eseguire test che usano Microsoft Fakes per gli stub e gli shim.

Telemetria

Raccolta di dati di telemetria. Informazioni su come rifiutare esplicitamente e quali dati vengono raccolti.

Integrazione della registrazione

Nota

Microsoft. Extensions.Logging Bridge è stato introdotto in MTP 2.3.0.

Il pacchetto Microsoft.Testing.Extensions.Logging collega la diagnostica di Microsoft.Testing.Platform a ILogger, così i log della piattaforma e delle estensioni passano attraverso la stessa pipeline Microsoft.Extensions.Logging già usata dall'applicazione.

Registrazione manuale:

var builder = await TestApplication.CreateBuilderAsync(args);
builder.AddMicrosoftExtensionsLogging(logging => logging.AddConsole());

Estensioni sperimentali

Le estensioni seguenti sono sperimentali. Le API vengono annotate con la TPEXP diagnostica e potrebbero cambiare in una versione futura. L'uso di tali API richiede il riconoscimento della diagnostica sperimentale. Per altre informazioni, vedere diagnostica di Microsoft.Testing.Platform.

Videoregistratore (sperimentale, introdotto in MTP 2.3.0)

Registra la schermata durante un'esecuzione di test. ffmpeg Deve essere disponibile nel computer ed è abilitato con l'opzione --capture-video . Registrala manualmente con builder.AddVideoRecorderProvider().

Distribuzione di app in pacchetto (sperimentale, introdotta in MTP 2.3.0)

Estensione di riferimento che usa il punto di estensione sperimentale ITestHostLauncher per distribuire e avviare un host di test dell'app in pacchetto. Registrala manualmente con builder.AddPackagedAppDeployment().