Rozšíření mostu VSTest
Toto rozšíření poskytuje vrstvu kompatibility s VSTestem, která umožňuje testovacím frameworkům, které na něm závisí, pokračovat v podpoře režimu VSTest (vstest.console.exe, obvyklé dotnet test, VSTest task v AzDo, Průzkumnících testů sady Visual Studio a Visual Studio Code...). Toto rozšíření se dodává jako součást balíčku Microsoft.Testing.Extensions.VSTestBridge.
Kompatibilita s VSTestem
Hlavním účelem tohoto rozšíření je nabídnout uživatelům VSTest snadné a bezproblémové prostředí upgradu tím, že umožňuje duální režim, ve kterém je nová platforma aktivována a paralelní kompatibilní režim je nabízen, aby mohly obvyklé pracovní postupy pokračovat.
Podpora nastavení spuštění
Toto rozšíření umožňuje poskytnout VSTest .runsettings soubor, ale ne všechny možnosti v tomto souboru jsou vyzvednuty platformou. Níže popisujeme podporovaná a nepodporovaná nastavení, možnosti konfigurace a alternativy pro nejpoužívanější možnosti konfigurace VSTest.
Pokud je tato testovací architektura povolená, můžete k poskytnutí souboru .runsettings použít --settings <SETTINGS_FILE>.
RunConfiguration – element
Microsoft.Testing.Platformnepodporují následující prvky RunConfiguration:
| Uzel | Popis | Důvod / alternativní řešení |
|---|---|---|
| MaxCpuCount | Toto nastavení řídí úroveň paralelismu na úrovni procesu. Pomocí 0 povolíte maximální paralelismus na úrovni procesu. | Pokud se microsoft.Testing.Platform používá s nástrojem MSBuild, je tato možnost přesměrována do nástroje MSBuild. Při spuštění jednoho spustitelného souboru tato možnost nemá žádný význam pro Microsoft.Testing.Platform. |
| VýsledkovýAdresář | Adresář, do kterého se umístí výsledky testu. Cesta je relativní vzhledem k adresáři, který obsahuje soubor .runsettings. | Pomocí možnosti příkazového řádku --results-directory určete adresář, do kterého se mají výsledky testu umístit. Pokud zadaný adresář neexistuje, vytvoří se. Výchozí hodnota je TestResults v adresáři, který obsahuje testovací aplikaci. |
| TargetFrameworkVersion | Toto nastavení definuje verzi architektury nebo řadu rozhraní, která se má použít ke spouštění testů. | Tato možnost se ignoruje. Vlastnosti <TargetFramework> nebo <TargetFrameworks> MSBuild určují cílovou architekturu aplikace. Testy se hostují v konečné aplikaci. |
| TargetPlatform | Toto nastavení definuje architekturu, která se má použít ke spouštění testů. |
<RuntimeIdentifier> určuje architekturu konečné aplikace, která je hostitelem testů. |
| ZvažujChybyTestovacíhoAdapteruJakoVarování | Potlačí chyby testovacího adaptéru a změní je na upozornění. | Microsoft.Testing.Platform umožňuje spustit pouze jeden typ testů z jednoho sestavení a selhání načtení testovacího rámce nebo jiných částí infrastruktury se stane nepřeskočitelnou chybou, protože značí, že některé testy nebylo možné zjistit nebo spustit. |
| CestyTestAdaptérů | Jedna nebo více cest k adresáři, kde se nachází TestAdapter | Microsoft.Testing.Platform nepoužívá koncept testovacích adaptérů a neumožňuje dynamické načítání rozšíření, pokud nejsou součástí sestavení, a nejsou zaregistrované v Program.cs, buď automaticky prostřednictvím cílů sestavení, nebo ručně. |
| TestCaseFilter | Filtr pro omezení testů, které se spustí. | Od verze 1.6 se teď tato položka runsettings podporuje. Před touto verzí byste měli místo toho použít možnost příkazového řádku --filter. |
| Časový limit testovací relace | Umožňuje uživatelům ukončit testovací relaci, když překročí daný časový limit. | Neexistuje žádná alternativní možnost. |
| DotnetHostPath | Zadejte vlastní cestu k hostiteli dotnet, který se používá ke spuštění testovacího hostitele. | Microsoft.Testing.Platform neprovádí žádné další rozpoznávání dotnetu. Záleží plně na tom, jak si dotnet sám poradí, což lze řídit pomocí proměnných prostředí, jako je DOTNET_HOST_PATH. |
| TreatNoTestsAsError | Ukončete s ukončovacím kódem jiným než nula, jestliže nejsou zjištěny žádné testy. | Microsoft.Testing.Platform bude ve výchozím nastavení vyvolávat chybu, když se v testovací aplikaci nezjistí nebo nespustí žádné testy. Počet testů, které očekáváte v sestavení, můžete nastavit pomocí --minimum-expected-tests parametru příkazového řádku, který má výchozí hodnotu 1. |
Element sběračů dat
Microsoft.Testing.Platform nepoužívá kolektory dat. Místo toho má koncept rozšíření v rámci procesu (in-process) a mimo proces (out-of-process). Každé rozšíření je nakonfigurováno příslušným konfiguračním souborem nebo příkazovým řádkem.
Nejdůležitější jsou rozšíření pro zablokování a rozšíření pro selhání a rozšíření pro pokrytí kódu.
Element „LoggerRunSettings“
Nástroje pro protokolování v Microsoft.Testing.Platform se konfigurují pomocí parametrů příkazového řádku nebo nastavením přímo v kódu.
Podpora filtru VSTest
Toto rozšíření také nabízí možnost použít mechanismus filtrování VSTest ke zjišťování nebo spouštění pouze testů, které odpovídají výrazu filtru. Další informace najdete v části Podrobnosti o možnostech filtru nebo podrobnosti specifické pro architekturu najdete na stránce Spouštění selektivních testů jednotek.
Pokud je povolený testovací rámec, můžete použít --filter <FILTER_EXPRESSION>.
Parametry testovacího spuštění
Parametry můžete předat do spuštění testu pomocí volby příkazového řádku --test-parameters ve formátu key=value. Tuto možnost lze zadat vícekrát, jednu pro každý parametr, který se má nastavit.
K těmto parametrům pak může přistupovat testovací architektura v testovacím běhu:
- pro MSTest použijte Properties
- pro NUnit použijte TestContext.TestParameters
