Condividi tramite

Confronto tra Microsoft.Testing.Platform e VSTest

  • Articolo

Microsoft.Testing.Platform è un'alternativa leggera e portabile a VSTest per l'esecuzione di test nella riga di comando, nelle pipeline di integrazione continua (CI), in Esplora test di Visual Studio e in Visual Studio Code. In questo articolo vengono illustrate le differenze principali tra Microsoft.Testing.Platform e VSTest.

Differenze nell'esecuzione dei test

I test vengono eseguiti in modalità diverse a seconda del runner.

Eseguire test VSTest

VSTest viene fornito con Visual Studio, .NET SDK e come strumento autonomo nel pacchetto NuGet Microsoft.TestPlatform. VSTest utilizza un eseguibile runner per eseguire i test, chiamato vstest.console.exe, che può essere utilizzato direttamente o tramite dotnet test.

Eseguire test Di Microsoft.Testing.Platform

Microsoft.Testing.Platform è incorporato direttamente nel progetto di test e non include file eseguibili aggiuntivi. Quando si esegue il file eseguibile del progetto, i test vengono eseguiti. Per altre informazioni sull'esecuzione di test Microsoft.Testing.Platform, vedere panoramica di Microsoft.Testing.Platform: Eseguire ed eseguire test di debug.

Spazi dei nomi e pacchetti NuGet

Per acquisire familiarità con Microsoft.Testing.Platform e VSTest, è utile comprendere i namespace e i pacchetti NuGet utilizzati da ciascuno.

Spazi dei nomi VSTest

VSTest è una raccolta di strumenti di test noti anche come piattaforma di test . Il codice sorgente VSTest è open source e disponibile nel repository GitHub microsoft/vstest. Il codice usa lo spazio dei nomi Microsoft.TestPlatform.*.

VSTest è estendibile e i tipi comuni vengono inseriti in pacchetto Microsoft.TestPlatform.ObjectModel NuGet.

Namespace Microsoft.Testing.Platform

Microsoft.Testing.Platform si basa sul pacchetto NuGet Microsoft.Testing.Platform e su altre librerie nel namespace Microsoft.Testing.*. Come VSTest, il Microsoft.Testing.Platform è open source e ha un microsoft/testfx repository GitHub.

Protocollo di comunicazione

Nota

Esplora test di Visual Studio supporta il protocollo Microsoft.Testing.Platform a partire dalla versione 17.12. Se si eseguono o si esegue il debug dei test usando versioni precedenti di Visual Studio, Esplora test userà vstest.console.exe e il protocollo precedente per eseguire questi test.

Microsoft.Testing.Platform usa un protocollo basato su JSON-RPC per comunicare tra Visual Studio e il processo di test runner. Il protocollo è documentato nel repository GitHub MSTest.

VSTest usa anche un protocollo di comunicazione basato su JSON, ma non è basato su JSON-RPC.

Disabilitazione del nuovo protocollo

Per disabilitare l'uso del nuovo protocollo in Esplora test, è possibile modificare il progetto per aggiungere la proprietà seguente: <DisableTestingPlatformServerCapability>true</DisableTestingPlatformServerCapability>.

È anche possibile passare a Opzioni funzionalità di anteprima in Visual Studio e deselezionare l'opzione "Usa modalità server della piattaforma di test".

Eseguibili

VSTest fornisce più eseguibili, in particolare vstest.console.exe, testhost.exee datacollector.exe. Tuttavia, MSTest viene incorporato direttamente nel progetto di test e non include altri file eseguibili. Il file eseguibile compilato dal progetto di test in viene usato per ospitare tutti gli strumenti di test ed eseguire tutte le attività necessarie per eseguire i test.

Migrazione da VSTest

Oltre ai passaggi specifici del framework di test, è necessario aggiornare l'infrastruttura di test per adattarla a Microsoft.Testing.Platform.

dotnet test

Le opzioni della riga di comando di dotnet test sono suddivise in 2 categorie: argomenti correlati alla compilazione e test correlati.

Gli argomenti correlati alla compilazione vengono passati al comando dotnet build e, di conseguenza, non è necessario aggiornarli per la nuova piattaforma. Gli argomenti relativi alla build sono elencati di seguito:

  • -a|--arch <ARCHITECTURE>
  • --artifacts-path <ARTIFACTS_DIR>
  • -c|--configuration <CONFIGURATION>
  • -f|--framework <FRAMEWORK>
  • -e|--environment <NAME="VALUE">
  • --interactive
  • --no-build
  • --nologo
  • --no-restore
  • -o|--output <OUTPUT_DIRECTORY>
  • --os <OS>
  • -r|--runtime <RUNTIME_IDENTIFIER>
  • -v|--verbosity <LEVEL>

Gli argomenti correlati al test sono specifici di VSTest e quindi devono essere trasformati in modo che corrispondano alla nuova piattaforma. La tabella seguente illustra il mapping tra gli argomenti VSTest e la nuova piattaforma:

Argomento VSTest Nuovo argomento della piattaforma
--test-adapter-path <ADAPTER_PATH> Non supportato
--blame Non supportato
--blame-crash --crashdump richiede l'estensione per i crash dump
--blame-crash-dump-type <DUMP_TYPE> --crashdump-type richiede l'estensione per i crash dump
--blame-crash-collect-always Non supportato
--blame-hang --hangdump richiede l'estensione hang dump
--blame-hang-dump-type <DUMP_TYPE> --hangdump-type richiede l'estensione hang dump
--blame-hang-timeout <TIMESPAN> --hangdump-timeout richiede l'estensione hang dump
--collect <DATA_COLLECTOR_NAME> Dipende dall'agente di raccolta dati
-d\|--diag <LOG_FILE> --diagnostic
--filter <EXPRESSION> Dipende dal framework di test selezionato
-l\|--logger <LOGGER> Dipende dal "logger"
--results-directory <RESULTS_DIR> --results-directory <RESULTS_DIR>
-s\|--settings <SETTINGS_FILE> Dipende dal framework di test selezionato
-t\|--list-tests --list-tests
-- <RunSettings arguments> Non supportato

Importante

Prima di specificare qualsiasi argomento Microsoft.Testing.Platform, è necessario aggiungere -- per separare gli argomenti dotnet test dai nuovi argomenti della piattaforma. Ad esempio, dotnet test --no-build -- --list-tests.

vstest.console.exe

Se si usa direttamente vstest.console.exe, è consigliabile sostituirlo con il comando dotnet test.

Esplora Test

Quando si usa Visual Studio o Esplora test di Visual Studio Code, potrebbe essere necessario abilitare il supporto per la nuova piattaforma di test.

Visual Studio

Esplora test di Visual Studio supporta la nuova piattaforma di test a partire dalla versione 17.14. Se si usa una versione precedente, potrebbe essere necessario aggiornare Visual Studio alla versione più recente.

Visual Studio Code

Test Explorer di Visual Studio Code supporta la nuova piattaforma di test dalla versione X in poi.

Azure DevOps

Quando si usano le attività di Azure DevOps, potrebbe essere necessario aggiornare la pipeline per usare la nuova piattaforma di test.

Attività VSTest

Se si usa l'attività VSTest in Azure DevOps, è possibile sostituirla con l'attività .NET Core.

Attività .NET Core

Se si usa l'attività .NET Core, non sono necessarie modifiche.