VSTest Bridge-tillägg
Det här tillägget ger ett kompatibilitetslager med VSTest som gör att testramverken kan fortsätta att stödja körning i VSTest-läge (vstest.console.exe, vanliga 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 Microsoft.Testing.Extensions.VSTestBridge-paketet.
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
Följande RunConfiguration--element stöds inte 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 det här alternativet avlastas till MSBuild. När en enda körbar fil körs har det här alternativet ingen betydelse för Microsoft.Testing.Platform. |
| Resultatkatalog | 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 är 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. |
| BehandlaTestAdapterFelSomVarningar | Undertrycker testadapterfel så att de blir varningar. | Microsoft.Testing.Platform tillåter endast att en typ av tester körs från ett enda assembly, och om testramverket eller andra delar av infrastrukturen inte kan laddas blir det ett fel som inte kan ignoreras, eftersom det innebär att vissa tester inte kan upptäckas eller köras. |
| Testadaptrarvägar | En eller flera sökvägar till katalogen där TestAdapters finns | Microsoft.Testing.Platform använder inte begreppet testadapter och tillåter inte dynamisk inläsning av tillägg om de inte ingår i builden 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. | Från och med v1.6 stöds nu den här runsettings-posten. Innan den här versionen bör du använda kommandoradsalternativet --filter i stället. |
| 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 lösning av dotnet. Det beror helt på hur dotnet hanterar sig, detta 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 av --minimum-expected-tests kommandoradsparameter, som standard är 1. |
Datainsamlarelementet
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.
Viktigast är hänga och krascha-tillägg samt kodtäcknings-tillägg.
LoggerRunSettings-elementet
Loggare i Microsoft.Testing.Platform konfigureras via kommandoradsparametrar eller av 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 Filteralternativets detaljer eller för specifik information om ramverket, se sidan Köra selektiva enhetstester.
När det är aktiverat av testramverket kan du använda --filter <FILTER_EXPRESSION>.
TestRun-parametrar
Du kan skicka parametrar till testkörningen med hjälp av kommandoradsalternativet --test-parameters i formatet key=value. Det här alternativet kan anges flera gånger, en för varje parameter som ska anges.
Dessa parametrar kan sedan nås av testramverket i testkörningen:
- för MSTest använder du Properties
- för NUnit använder du TestContext.TestParameters
