VSTest.Console.exe – možnosti příkazového řádku
VSTest.Console.exe je nástroj příkazového řádku pro spouštění testů. Na příkazovém řádku můžete zadat několik možností v libovolném pořadí. Tyto možnosti jsou uvedené v obecných možnostech příkazového řádku.
Poznámka:
Adaptér MSTest v sadě Visual Studio funguje také v zastaralém režimu (ekvivalentní spouštění testů s mstest.exe) kvůli kompatibilitě. Ve starším režimu nemůže využít funkci TestCaseFilter. Adaptér může přepnout do staršího režimu, pokud je zadán soubor testsettings , forcelegacymode je nastaven na true v souboru runsettings nebo pomocí atributů, jako je HostType.
Pokud chcete spustit automatizované testy na počítači založeném na architektuře ARM, musíte použít VSTest.Console.exe.
Otevřete příkazový řádek pro vývojáře a použijte nástroj příkazového řádku nebo ho najdete v %Program Files(x86)%\Microsoft Visual Studio\<version>\<edition>\common7\ide\CommonExtensions\<Platform | Microsoft>.
Obecné možnosti příkazového řádku
V následující tabulce jsou uvedeny všechny možnosti VSTest.Console.exe a krátké popisy. Podobný souhrn můžete zobrazit zadáním VSTest.Console/? na příkazový řádek.
| Možnost | Popis |
|---|---|
| [názvy testovacích souborů] | Spusťte testy ze zadaných souborů. Oddělte několik názvů testovacích souborů mezerami. Příklady: mytestproject.dll, mytestproject.dll myothertestproject.exe |
| /Nastavení:[název souboru] | Spusťte testy s dalšími nastaveními, jako jsou kolektory dat. Další informace naleznete v tématu Konfigurace testů jednotek pomocí souboru .runsettings Příklad: /Settings:local.runsettings |
| /Tests:[název testu] | Spusťte testy s názvy, které obsahují zadané hodnoty. Tento příkaz odpovídá úplnému názvu testu, včetně oboru názvů. Pokud chcete zadat více hodnot, oddělte je čárkami. Příklad: /Tests:TestMethod1,testMethod2Možnost příkazového řádku /Tests nelze použít s možností příkazového řádku /TestCaseFilter . |
| /Paralelní | Určuje, že testy se provádějí paralelně. Ve výchozím nastavení je možné použít až všechna dostupná jádra na počítači. Můžete nakonfigurovat počet jader, která se mají použít v souboru nastavení. |
| /Enablecodecoverage | Povolí v testovacím běhu CodeCoverage adaptér diagnostiky dat. Výchozí nastavení se použijí, pokud není zadáno pomocí souboru nastavení. |
| /Inisolation | Spustí testy v izolovaném procesu. Díky této izolaci se proces vstest.console.exe méně pravděpodobně zastaví na chybě v testech, ale testy můžou běžet pomaleji. |
| /UseVsixExtensions | Tato možnost způsobí, že proces vstest.console.exe použije nebo přeskočí nainstalované rozšíření VSIX (pokud existuje) v testovacím spuštění. Tato možnost je zastaralá. Od příští hlavní verze sady Visual Studio může být tato možnost odebrána. Přechod na využívání rozšíření zpřístupněných jako balíček NuGet Příklad: /UseVsixExtensions:true |
| /TestAdapterPath:[path] | Vynutí proces vstest.console.exe použití vlastních testovacích adaptérů ze zadané cesty (pokud existuje) v testovacím spuštění. Příklad: /TestAdapterPath:[pathToCustomAdapters] |
| /Platform:[typ platformy] | Vynutí použití dané platformy místo platformy určené z aktuálního modulu runtime. Tato možnost může vynutit pouze platformy x86 a x64 ve Windows. Možnost ARM je přerušená a ve většině systémů bude mít za následek x64. Nezadávejte tuto možnost pro spuštění v modulech runtime, které nejsou v seznamu platných hodnot, jako je ARM64. Platné hodnoty jsou x86, x64 a ARM. |
| /Framework: [verze architektury] | Cílová verze .NET, která se má použít k provedení testu. Příklady hodnot jsou Framework35, , Framework45Framework40, FrameworkUap10, .NETCoreApp,Version=v1.1.TargetFrameworkAttribute se používá k automatickému rozpoznání této možnosti z sestavení a výchozí hodnota Framework40 je, když atribut není k dispozici. Tuto možnost musíte explicitně zadat, pokud odeberete TargetFrameworkAttribute ze sestavení .NET Core.Pokud je cílová architektura zadaná jako Framework35, testy se spustí v CLR 4.0 "režim kompatibility". Příklad: /Framework:framework40 |
| /TestCaseFilter:[expression] | Spusťte testy, které odpovídají danému výrazu. <Výraz> je vlastnost=value>>< formátu<[|<Výraz>]. Příklad: /TestCaseFilter:"Priority=1"Příklad: /TestCaseFilter:"TestCategory=Nightly|FullyQualifiedName=Namespace.ClassName.MethodName"Možnost příkazového řádku /TestCaseFilter nelze použít s možností příkazového řádku /Tests . Informace o vytvářeníach |
| /? | Zobrazí informace o využití. |
| /Logger:[uri/friendlyname] | Zadejte protokolovací nástroje pro výsledky testů. Pokud chcete povolit více protokolovacích souborů, zadejte parametr vícekrát. Příklad: Pokud chcete výsledky přihlásit do souboru výsledků testů sady Visual Studio (TRX), použijte /Logger:trx [; LogFileName=<Defaults to unique file name>] |
| /ListTests:[název souboru] | Zobrazí seznam zjištěných testů z daného testovacího kontejneru. Poznámka: Tato /TestCaseFilters možnost nemá žádný vliv při výpisu testů. Řídí pouze to, které testy se spustí. |
| /ListDiscoverers | Zobrazí seznam nainstalovaných zjišťovačů testů. |
| /ListExecutors | Zobrazí seznam nainstalovaných exekutorů testů. |
| /ListLoggers | Vypíše nainstalované protokolovací nástroje pro testování. |
| /List Nastavení Providers | Zobrazí seznam nainstalovaných zprostředkovatelů nastavení testů. |
| /Vinu | Spustí testy v režimu blame. Tato možnost je užitečná při izolování problematických testů, které způsobují chybové ukončení hostitele testu. Při zjištění chybového ukončení vytvoří sekvenční soubor, který TestResults/<Guid>/<Guid>_Sequence.xml zachycuje pořadí testů, které byly spuštěny před chybovým ukončením. Další informace najdete v tématu Kolektor dat Blame. |
| /Diag:[název souboru] | Zapíše do zadaného souboru protokoly trasování diagnostiky. |
| /ResultsDirectory:[path] | Pokud adresář výsledků testů neexistuje, vytvoří se v zadané cestě. Příklad: /ResultsDirectory:<pathToResultsDirectory> |
| /ParentProcessId:[parentProcessId] | ID procesu nadřazeného procesu zodpovědného za spuštění aktuálního procesu. |
| /Port:[port] | Port pro připojení soketu a příjem zpráv událostí. |
| /Collect:[dataCollector friendlyName] | Povolí kolektor dat pro testovací běh. Další informace. |
Tip
Možnosti a hodnoty nerozlišují malá a velká písmena.
Příklady
Syntaxe spuštění vstest.console.exe je:
vstest.console.exe [TestFileNames] [Options]
Ve výchozím nastavení příkaz vrátí hodnotu 0, když se normálně ukončí, i když nejsou zjištěny žádné testy. Pokud chcete vrátit nenulovou hodnotu, pokud nejsou zjištěny žádné testy, použijte <TreatNoTestsAsError>true</TreatNoTestsAsError> možnost runsettings.
Následující příkaz spustí vstest.console.exe pro myTestProject.dll testovací knihovny:
vstest.console.exe myTestProject.dll
Následující příkaz spustí vstest.console.exe s více testovacími soubory. Názvy testovacích souborů oddělte mezerami:
vstest.console.exe myTestFile.dll myOtherTestFile.dll
Následující příkaz spustí vstest.console.exe s několika možnostmi. Spustí testy v souboru myTestFile.dll v izolovaném procesu a používá nastavení zadaná v souboru Local.Run Nastavení. Kromě toho spustí testy označené jako Priorita=1 a výsledky zaprotokoluje do souboru .trx .
vstest.console.exe myTestFile.dll /Settings:Local.RunSettings /InIsolation /TestCaseFilter:"Priority=1" /Logger:trx
Následující příkaz spustí vstest.console.exe s možností myTestProject.dll testovací knihovny:/blame
vstest.console.exe myTestFile.dll /blame
Pokud dojde k chybovému ukončení testovacího hostitele, vygeneruje se soubor sequence.xml . Soubor obsahuje plně kvalifikované názvy testů v jejich sekvenci provádění až do konkrétního testu, který byl spuštěn v době chybového ukončení.
Pokud nedojde k chybě testovacího hostitele, soubor sequence.xml se negeneruje.
Příklad vygenerovaného souboru sequence.xml :
<?xml version="1.0"?>
<TestSequence>
<Test Name="TestProject.UnitTest1.TestMethodB" Source="D:\repos\TestProject\TestProject\bin\Debug\TestProject.dll" />
<Test Name="TestProject.UnitTest1.TestMethodA" Source="D:\repos\TestProject\TestProject\bin\Debug\TestProject.dll" />
</TestSequence>
Příklad UPW
Pro UPW musí být soubor appxrecipe odkazován místo knihovny DLL.
vstest.console.exe /Logger:trx /Platform:x64 /framework:frameworkuap10 UnitTestsUWP\bin\x64\Release\UnitTestsUWP.build.appxrecipe