Delen via

VSTest Bridge-extensie

Deze extensie biedt een compatibiliteitslaag met VSTest, waardoor testframeworks die ervan afhankelijk zijn, blijven functioneren in de VSTest-modus (vstest.console.exe, gebruikelijke dotnet test, VSTest task op AzDo, en de Test Explorers van Visual Studio en Visual Studio Code...). Deze extensie wordt meegeleverd als onderdeel van het Microsoft.Testing.Extensions.VSTestBridge pakket.

Compatibiliteit met VSTest

Het belangrijkste doel van deze extensie is om een eenvoudige en soepele upgrade-ervaring te bieden voor VSTest-gebruikers door een dubbele modus toe te staan waarin het nieuwe platform is ingeschakeld en parallel een compatibiliteitsmodus wordt aangeboden om de gebruikelijke werkstromen te laten werken.

Ondersteuning voor Runsettings

Met deze extensie kunt u een VSTest .runsettings bestandaanleveren, maar niet alle opties in dit bestand worden door het platform verwerkt. Hieronder worden de ondersteunde en niet-ondersteunde instellingen, configuratieopties en alternatieven beschreven voor de meest gebruikte VSTest-configuratieopties.

Wanneer dit is ingeschakeld door het testframework, kunt u --settings <SETTINGS_FILE> gebruiken om het .runsettings-bestand op te geven.

RunConfiguratie-element

De volgende RunConfiguration--elementen worden niet ondersteund door Microsoft.Testing.Platform:

Knoop Beschrijving Reden / Tijdelijke oplossing
MaxCpuCount Deze instelling bepaalt het niveau van parallelle uitvoering op procesniveau. Gebruik 0 om parallelle uitvoering op procesniveau in te schakelen. Wanneer Microsoft.Testing.Platform wordt gebruikt met MSBuild, wordt deze optie offloaded naar MSBuild. Wanneer één uitvoerbaar bestand wordt uitgevoerd, heeft deze optie geen betekenis voor Microsoft.Testing.Platform.
ResultatenDirectory De map waarin testresultaten worden geplaatst. Het pad is relatief ten opzichte van de map die het bestand .runsettings bevat. Gebruik de opdrachtregeloptie --results-directory om te bepalen waar de testresultaten worden geplaatst. Als de opgegeven map niet bestaat, wordt deze gemaakt. De standaardwaarde is TestResults in de map die de testtoepassing bevat.
TargetFrameworkVersion Met deze instelling definieert u de frameworkversie of frameworkfamilie die moet worden gebruikt om tests uit te voeren. Deze optie wordt genegeerd. De eigenschappen van de <TargetFramework> of <TargetFrameworks> MSBuild bepalen het doelframework van de toepassing. De tests worden gehost in de uiteindelijke toepassing.
TargetPlatform- Deze instelling definieert de architectuur die moet worden gebruikt voor het uitvoeren van tests. <RuntimeIdentifier> bepaalt de architectuur van de uiteindelijke toepassing die als host fungeert voor de tests.
BehandelTestAdapterFoutenAlsWaarschuwingen Onderdrukt testadapterfouten zodat ze als waarschuwingen worden weergegeven. Met Microsoft.Testing.Platform kan slechts één type test vanuit één assembly worden uitgevoerd, en het niet kunnen laden van het testframework of andere delen van de infrastructuur wordt een onoverkomelijke fout, omdat dit aangeeft dat sommige tests niet kunnen worden ontdekt of uitgevoerd.
TestadaptersPaden Een of meer paden naar de map waar de TestAdapters zich bevinden Microsoft.Testing.Platform maakt geen gebruik van het concept van testadapters en staat dynamisch laden van extensies niet toe, tenzij ze deel uitmaken van de build en zijn geregistreerd in Program.cs, hetzij automatisch via builddoelen of handmatig.
TestCaseFilter Een filter om tests te beperken die worden uitgevoerd. Vanaf v1.6 wordt deze runettings-vermelding nu ondersteund. Voor deze versie moet u in plaats daarvan --filter opdrachtregeloptie gebruiken.
TestSessionTimeout Hiermee kunnen gebruikers een testsessie beëindigen wanneer deze een bepaalde time-out overschrijdt. Er is geen alternatieve optie.
DotnetHostPath Geef een aangepast pad op naar dotnet-host die wordt gebruikt om de testhost uit te voeren. Microsoft.Testing.Platform voert geen extra oplossingen voor dotnet uit. Het hangt volledig af van de manier waarop dotnet zichzelf oplost, die kan worden beheerd door omgevingsvariabelen zoals DOTNET_HOST_PATH.
BehandelGeenTestsAlsFout Afsluiten met een niet-nul exitcode wanneer er geen tests worden gevonden. Microsoft.Testing.Platform zal standaard een fout geven wanneer er geen tests worden ontdekt of uitgevoerd in een testtoepassing. U kunt instellen hoeveel tests u verwacht te vinden in de assembly met behulp van --minimum-expected-tests opdrachtregelparameter, die standaard 1 is.

Gegevensverzamelaars-element

Microsoft.Testing.Platform geen gegevensverzamelaars gebruikt. In plaats daarvan introduceert het het concept van in-process- en out-of-process-extensies. Elke extensie wordt geconfigureerd door het respectieve configuratiebestand of via de opdrachtregel.

Het allerbelangrijkste zijn de hang en crash extensies, en de codedekking extensie.

Het element LoggerRunSettings

Loggers in Microsoft.Testing.Platform worden geconfigureerd via opdrachtregelparameters of door instellingen in code.

Ondersteuning voor VSTest-filters

Deze extensie biedt ook de mogelijkheid om het VSTest-filtermechanisme te gebruiken om alleen de tests te detecteren of uit te voeren die overeenkomen met de filterexpressie. Voor meer informatie, kijk in de sectie Filteroptie details of voor frameworkspecifieke details de pagina Selectief unittests uitvoeren.

Wanneer dit is ingeschakeld door het testframework, kunt u --filter <FILTER_EXPRESSION>gebruiken.

Parameters voor TestRun

U kunt parameters doorgeven aan de testuitvoering met de opdrachtregeloptie --test-parameter in het formaat key=value. Deze optie kan meerdere keren worden opgegeven, één voor elke parameter die moet worden ingesteld.

Deze parameters kunnen vervolgens door het testframework worden toegegagen tijdens het uitvoeren van de test.