VSTest Bridge-tillägg

Det här tillägget ger ett kompatibilitetslager med VSTest som gör att testramverken kan fortsätta att köras i VSTest-läge (vstest.console.exevanligt dotnet test, VSTest task på AzDo, Test Explorers i Visual Studio och Visual Studio Code...). Det här tillägget levereras som en del av paketet Microsoft.Testing.Extensions.VSTestBridge .

Viktigt!

Paketet levereras med Microsoft .NET-biblioteket med stängd källkod utan kostnad för att använda licensieringsmodellen.

Kompatibilitet med VSTest

Huvudsyftet med det här tillägget är att erbjuda en enkel och smidig uppgraderingsupplevelse för VSTest-användare genom att tillåta ett dubbelt läge där den nya plattformen är aktiverad och parallellt erbjuds ett kompatibilitetsläge så att de vanliga arbetsflödena kan fortsätta att fungera.

Stöd för Runsettings

Med det här tillägget kan du ange en VSTest .runsettings-fil, men inte alla alternativ i den här filen hämtas av plattformen. Vi beskriver nedan de inställningar som stöds och inte stöds, konfigurationsalternativ och alternativ för de mest använda VSTest-konfigurationsalternativen.

När det är aktiverat av testramverket kan du använda --settings <SETTINGS_FILE> för att ange .runsettings filen.

RunConfiguration-element

Elementet RunConfiguration kan innehålla följande element. Ingen av dessa inställningar respekteras av Microsoft.Testing.Platform:

Nod	beskrivning	Orsak/lösning
MaxCpuCount	Den här inställningen styr parallellitetsnivån på processnivå. Använd 0 för att aktivera den maximala parallelliteten på processnivå.	När Microsoft.Testing.Platform används med MSBuild avlastas det här alternativet till MSBuild. När en enda körbar fil körs har det här alternativet ingen betydelse för Microsoft.Testing.Platform.
ResultsDirectory	Katalogen där testresultat placeras. Sökvägen är relativ till katalogen som innehåller .runsettings-filen .	Använd kommandoradsalternativet --results-directory för att fastställa katalogen där testresultaten ska placeras. Om den angivna katalogen inte finns skapas den. Standardvärdet finns TestResults i katalogen som innehåller testprogrammet.
TargetFrameworkVersion	Den här inställningen definierar den ramverksversion eller ramverksfamilj som ska användas för att köra tester.	Det här alternativet ignoreras. Egenskaperna <TargetFramework> eller <TargetFrameworks> MSBuild avgör programmets målramverk. Testerna finns i det slutliga programmet.
TargetPlatform	Den här inställningen definierar arkitekturen som ska användas för att köra tester.	<RuntimeIdentifier> avgör arkitekturen för det slutliga programmet som är värd för testerna.
TreatTestAdapterErrorsAsWarnings	Undertrycker testkortsfel för att bli varningar.	Microsoft.Testing.Platform tillåter endast att en typ av tester körs från en enda sammansättning, och om testramverket eller andra delar av infrastrukturen inte kan läsas in blir det ett fel som inte kan hoppas över, eftersom det innebär att vissa tester inte kunde identifieras eller köras.
TestAdaptersPaths	En eller flera sökvägar till katalogen där TestAdapters finns	Microsoft.Testing.Platform använder inte begreppet testkort och tillåter inte dynamisk inläsning av tillägg såvida de inte ingår i bygget och registreras i Program.cs, antingen automatiskt via byggmål eller manuellt.
TestCaseFilter	Ett filter för att begränsa tester som ska köras.	Om du vill filtrera tester använder du --filter kommandoradsalternativet.
TestSessionTimeout	Tillåter användare att avsluta en testsession när den överskrider en viss tidsgräns.	Det finns inget alternativ.
DotnetHostPath	Ange en anpassad sökväg till dotnet-värden som används för att köra testvärden.	Microsoft.Testing.Platform utför ingen ytterligare matchning av dotnet. Det beror helt på hur dotnet löser sig, vilket kan styras av miljövariabler som DOTNET_HOST_PATH.
TreatNoTestsAsError	Avsluta med slutkod som inte är noll när inga tester identifieras.	Microsoft.Testing.Platform fel som standard när inga tester identifieras eller körs i ett testprogram. Du kan ange hur många tester du förväntar dig att hitta i sammansättningen med hjälp --minimum-expected-tests av kommandoradsparametern, som standard är 1.

DataCollectors-element

Microsoft.Testing.Platform använder inte datainsamlare. I stället har den begreppet in-process- och out-of-process-tillägg. Varje tillägg konfigureras av respektive konfigurationsfil eller via kommandoraden.

Det viktigaste är hängnings - och kraschtillägget och kodtäckningstillägget .

LoggerRun Inställningar-element

Loggarna i Microsoft.Testing.Platform konfigureras via kommandoradsparametrar eller med inställningar i kod.

Stöd för VSTest-filter

Det här tillägget ger också möjlighet att använda VSTest-filtreringsmekanismen för att identifiera eller köra endast de tester som matchar filteruttrycket. Mer information finns i avsnittet Information om filteralternativ eller för ramverksspecifik information finns på sidan Köra selektiva enhetstester .

När det är aktiverat av testramverket kan du använda --filter <FILTER_EXPRESSION>.