Microsoft.Testing.Platform (MTP) konfigurace nastavení

MTP podporuje použití konfiguračních souborů a proměnných prostředí ke konfiguraci chování testovací platformy. Tento článek popisuje nastavení konfigurace, které můžete použít ke konfiguraci testovací platformy.

testconfig.json

Testovací platforma používá konfigurační soubor s názvem [appname].testconfig.json ke konfiguraci chování testovací platformy. Soubor testconfig.json je soubor JSON, který obsahuje nastavení konfigurace testovací platformy.

Soubor testconfig.json má následující strukturu:

{
    "platformOptions": {
        "resultDirectory": "./TestResults"
    }
}

Platforma automaticky rozpozná a načte [appname].testconfig.json soubor umístěný ve výstupním adresáři testovacího projektu (blízko spustitelného souboru).

Při použití Microsoft.Testing.Platform.MSBuildmůžete jednoduše vytvořit testconfig.json soubor, který se automaticky přejmenuje na [appname].testconfig.json a přesunut do výstupního adresáře testovacího projektu.

Počínaje MTP 1.5 můžete pomocí argumentu --config-file příkazového řádku určit cestu k testconfig.json. Tento soubor má přednost před souborem [appname].testconfig.json.

Poznámka

Soubor.testconfig.json [appname] se přepíše v následných buildech.

Použijte centralizovaný testconfig.json

Pokud chcete sdílet jeden soubor testconfig.json mezi více testovacími projekty, můžete ho umístit na centrální místo a předat jej pomocí --config-file. Pokud je nástroj MSBuild k dispozici (například dotnet test nebo dotnet run), můžete argument automaticky předat pomocí vlastnosti MSBuild TestingPlatformCommandLineArguments. Přidáním do adresáře.Build.props v kořenovém adresáři úložiště zajistíte, aby všechny testovací projekty používaly stejnou konfiguraci:

<PropertyGroup>
  <TestingPlatformCommandLineArguments>
    $(TestingPlatformCommandLineArguments) --config-file $(MSBuildThisFileDirectory)testconfig.json
  </TestingPlatformCommandLineArguments>
</PropertyGroup>

Priorita konfigurace

Pokud lze stejné nastavení zadat několika způsoby, MTP jej vyhodnotí v následujícím pořadí (platí první nalezená shoda):

  1. Argumenty příkazového řádku (například --results-directory)
  2. Proměnné prostředí
  3. nastavení testconfig.json
  4. Předdefinované výchozí hodnoty

Možnosti platformy

Část platformOptions souboru testconfig.json konfiguruje základní chování testovací platformy. V následující tabulce jsou uvedeny všechny podporované možnosti platformy:

Položka Výchozí Description
resultDirectory TestResults Adresář, do kterého se umístí výsledky testu. Může to být relativní cesta (přeložená z aktuálního pracovního adresáře) nebo absolutní cesta. Možnost příkazového řádku --results-directory má přednost.
exitProcessOnUnhandledException false Pokud je nastavena hodnota true, proces hostitele testu se při neošetřených výjimkách okamžitě ukončí namísto umožnění řádného ukončení. Proměnná prostředí TESTINGPLATFORM_EXIT_PROCESS_ON_UNHANDLED_EXCEPTION (hodnoty 1 nebo 0) má přednost.

Poznámka

K dispozici jsou další interní možnosti platformy pro pokročilé scénáře (například časové limity pojmenovaných kanálů pro řadiče hostitele testů). Tyto možnosti jsou určeny pro použití infrastruktury a nejsou zde popsány.

Příklad:

{
  "platformOptions": {
    "resultDirectory": "../../TestResults",
    "exitProcessOnUnhandledException": false
  }
}

Proměnné prostředí v testconfig.json

Poznámka

K dispozici v MTP od verze 2.3.0.

Oddíl environmentVariables nastaví proměnné prostředí pro testovací proces před jeho spuštěním. Pro každou proměnnou použijte řetězcové hodnoty.

{
  "environmentVariables": {
    "DOTNET_ENVIRONMENT": "Development",
    "FEATURE_FLAG": "true"
  }
}

Možnosti CLI v souboru testconfig.json

Ve verzích před MTP 2.3.0 nejsou funkce rozšíření, jako jsou výpis paměti při selhání, výpis paměti při zablokování, opakovaný pokus, sestavy TRX a pokrytí kódu, konfigurovatelné prostřednictvím souboru testconfig.json. Tyto funkce se konfigurují výhradně prostřednictvím argumentů příkazového řádku.

Od verze MTP 2.3.0 může MTP číst volby příkazového řádku z testconfig.json prostřednictvím IConfiguration. Tato podpora zahrnuje možnosti rozšíření, takže můžete použít položky JSON pro možnosti, které nechcete předávat na příkazovém řádku při každém spuštění. Argumenty příkazového řádku mají stále přednost.

Úplný odkaz na možnosti příkazového řádku najdete v referenčních informacích k možnostem rozhraní příkazového řádku MTP.

Testování nastavení specifických pro architekturu

Testovací architektury mohou definovat vlastní konfigurační oddíly v souboru testconfig.json . Projděte si dokumentaci pro testovací architekturu:

Příklad testconfig.json

Následující příklad ukazuje soubortestconfig.json , který konfiguruje možnosti platformy a nastavení MSTest:

{
  "platformOptions": {
    "resultDirectory": "./TestResults"
  },
  "mstest": {
    "parallelism": {
      "enabled": true,
      "workers": 4,
      "scope": "method"
    },
    "timeout": {
      "test": 30000
    },
    "execution": {
      "considerFixturesAsSpecialTests": true
    }
  }
}

Migrace z .runsettings na testconfig.json

Pokud migrujete ze souboru .runsettings , následující tabulka mapuje běžná nastavení na jejich testconfig.json ekvivalenty nebo alternativy:

Nastavení .runsettings ekvivalent souboru testconfig.json Poznámky
RunConfiguration/ResultsDirectory platformOptions.resultDirectory
RunConfiguration/MaxCpuCount Žádný ekvivalent Paralelismus na úrovni procesu se řídí pomocí dotnet test --max-parallel-test-modules nebo volby MSBuild /m.
MSTest/* mstest.* Viz Konfigurace MSTest — testconfig.json.
xUnit/* xUnit.* Viz xUnit.net testconfig.json.
LoggerRunSettings/Loggers Možnosti CLI Použijte --report-trx nebo podobné možnosti rozhraní příkazového řádku. Počínaje MTP 2.3.0 může MTP číst možnosti rozhraní příkazového řádku z testconfig.json.
DataCollectionRunSettings (obviňovat) Možnosti CLI Použijte volby příkazového řádku --crashdump a --hangdump. Počínaje MTP 2.3.0 může MTP číst možnosti rozhraní příkazového řádku z testconfig.json. Viz Výpisy pádů a zamrznutí.
DataCollectionRunSettings (pokrytí) Možnosti rozhraní příkazového řádku Použijte volbu --coverage CLI. Počínaje MTP 2.3.0 může MTP číst možnosti rozhraní příkazového řádku z testconfig.json. Viz Pokrytí kódu.
TestRunParameters --test-parameter CLI Použijte --test-parameter key=value na příkazovém řádku.

Proměnné prostředí

Proměnné prostředí lze použít k poskytnutí některých informací o konfiguraci běhového prostředí.

Poznámka

Proměnné prostředí mají přednost před nastavením konfigurace v souboru testconfig.json.

TESTINGPLATFORM_EXIT_PROCESS_ON_UNHANDLED_EXCEPTION proměnná prostředí

Je-li nastavena hodnota 1, proces testovacího hostitele se při neošetřené výjimce okamžitě ukončí. Při nastavení 0umožňuje platforma řádné vypnutí. Toto nastavení má přednost před platformOptions:exitProcessOnUnhandledException konfigurací.

TESTINGPLATFORM_DEFAULT_HANG_TIMEOUT proměnná prostředí

Přepíše výchozí časový limit (300 sekund) používaný pro připojení pojmenovaného kanálu mezi kontrolerem testovacího hostitele a testovacím hostitelem. Hodnota musí být řetězec kompatibilní s TimeSpan.

TESTINGPLATFORM_UI_LANGUAGE proměnná prostředí

Od MTP 1.5 tato proměnná prostředí nastavuje jazyk platformy pro zobrazování zpráv a logů pomocí hodnoty jazykového nastavení, jako je en-us. Tento jazyk má přednost před jazyky sady Visual Studio a .NET SDK. Podporované hodnoty jsou stejné jako pro Visual Studio. Další informace najdete v části o změně jazyka instalačního programu v dokumentaci k instalaci sady Visual Studio.

TESTINGPLATFORM_DIAGNOSTIC proměnná prostředí

Pokud je nastavená hodnota 1, povolí protokolování diagnostiky.

TESTINGPLATFORM_DIAGNOSTIC_VERBOSITY proměnná prostředí

Definuje úroveň podrobností, když je povolená diagnostika. Dostupné hodnoty jsou Trace, Debug, Information, Warning, Errornebo Critical.

TESTINGPLATFORM_DIAGNOSTIC_OUTPUT_DIRECTORY proměnná prostředí

Výstupní adresář diagnostického protokolování. Pokud není zadaný, soubor se vygeneruje ve výchozím adresáři TestResults .

TESTINGPLATFORM_DIAGNOSTIC_FILE_PREFIX proměnná prostředí

Předpona názvu souboru protokolu. Výchozí hodnota je "log_". Odpovídá možnosti příkazového řádku --diagnostic-file-prefix.

Poznámka

Tento název proměnné prostředí je v MTP k dispozici od verze 2.3.0. Starší proměnná prostředí TESTINGPLATFORM_DIAGNOSTIC_OUTPUT_FILEPREFIX je kvůli zpětné kompatibilitě stále podporována, ale je označena za zastaralou a v některé z budoucích hlavních verzí může být odebrána. Pokud jsou nastaveny obě proměnné, TESTINGPLATFORM_DIAGNOSTIC_FILE_PREFIX má přednost.

TESTINGPLATFORM_DIAGNOSTIC_SYNCHRONOUS_WRITE proměnná prostředí

Vynutí integrovaný nástroj pro záznam souborů, aby synchronně zapisoval protokoly. Užitečné ve scénářích, kdy nechcete ztratit žádné položky protokolu (pokud se proces chybově ukončí). Tím se zpomalí spuštění testu. Odpovídá možnosti příkazového řádku --diagnostic-synchronous-write.

Poznámka

Tento název proměnné prostředí je v MTP k dispozici od verze 2.3.0. Starší proměnná prostředí TESTINGPLATFORM_DIAGNOSTIC_FILELOGGER_SYNCHRONOUSWRITE je kvůli zpětné kompatibilitě stále podporována, ale je označena za zastaralou a v některé z budoucích hlavních verzí může být odebrána. Pokud jsou nastaveny obě proměnné, TESTINGPLATFORM_DIAGNOSTIC_SYNCHRONOUS_WRITE má přednost.

TESTINGPLATFORM_EXITCODE_IGNORE proměnná prostředí

Středníkem oddělený seznam ukončovacích kódů, které se mají ignorovat. Pokud je ukončovací kód ignorován, proces místo toho vrátí 0. Například TESTINGPLATFORM_EXITCODE_IGNORE=2;8 ignoruje selhání testů a scénáře, kdy nebyl spuštěn žádný test.

TESTINGPLATFORM_NOBANNER proměnná prostředí

Při nastavení na 1 nebo true potlačí úvodní banner, zprávu o autorských právech a telemetrický banner. Odpovídá přepínači příkazového řádku --no-banner. Proměnná DOTNET_NOLOGO prostředí má stejný účinek.

NO_COLOR proměnná prostředí

Při nastavení na libovolnou neprázdnou hodnotu potlačí veškerý výstup barvy ANSI. MTP dodržuje konvenci NO_COLOR .

Poznámka

K dispozici v MTP od verze 2.3.0.

DOTNET_NOLOGO proměnná prostředí

Při nastavení na 1 nebo true potlačí úvodní banner, zprávu o autorských právech a telemetrický banner. Toto je standardní proměnná prostředí .NET CLI a MTP ji zohledňuje. Viz také TESTINGPLATFORM_NOBANNER.

TESTINGPLATFORM_WAIT_ATTACH_DEBUGGER proměnná prostředí

Při nastavení na 1 se testovací proces při spuštění pozastaví a před pokračováním počká na připojení ladicího programu. Odpovídá přepínači příkazového řádku --debug. Nepodporuje se na platformách prohlížeče.

Poznámka

Tato proměnná prostředí je v MTP k dispozici od verze 1.6.0.

TESTINGPLATFORM_LAUNCH_ATTACH_DEBUGGER proměnná prostředí

Když je nastavena hodnota 1, testovací proces při spuštění zavolá Debugger.Launch(), čímž vyzve systém ke spuštění ladicího programu just-in-time a jeho připojení k procesu. Pomocí této proměnné můžete ladit problémy při spuštění (například handshake v režimu serveru), ke kterým dochází před ručním připojením. Na platformách jiných než Windows závisí chování na nakonfigurovaném ladicím programu JIT.

Poznámka

Tato proměnná prostředí je v MTP k dispozici od verze 1.6.0.

Poznámka

Proměnné prostředí související s diagnostikou mají přednost před odpovídajícími --diagnostic-* argumenty příkazového řádku.

Viz také

  • Last updated on