Udostępnij za pośrednictwem


Rozszerzenie programu VSTest Bridge

To rozszerzenie zapewnia warstwę zgodności z narzędziem VSTest, co pozwala platformom testowym w zależności od tego, czy nadal jest obsługiwana w trybie VSTest (vstest.console.exezwykle dotnet testVSTest task w narzędziu AzDo, Eksploratorach testów programu Visual Studio i programie Visual Studio Code...). To rozszerzenie jest dostarczane w ramach pakietu Microsoft.Testing.Extensions.VSTestBridge.

Zgodność z programem VSTest

Głównym celem tego rozszerzenia jest oferowanie łatwego i płynnego środowiska uaktualniania dla użytkowników VSTest, umożliwiając tryb podwójny, w którym nowa platforma jest włączona i równolegle oferowany jest tryb zgodności, aby umożliwić kontynuowanie pracy zwykłych przepływów pracy.

Obsługa ustawień uruchamiania

To rozszerzenie umożliwia udostępnienie pliku .runsettings VSTest, ale nie wszystkie opcje w tym pliku są pobierane przez platformę. Poniżej opisano obsługiwane i nieobsługiwane ustawienia, opcje konfiguracji i alternatywy dla najczęściej używanych opcji konfiguracji VSTest.

Po włączeniu przez platformę testową można --settings <SETTINGS_FILE> podać .runsettings plik.

RunConfiguration, element

Element RunConfiguration może zawierać następujące elementy. Żadne z tych ustawień nie są przestrzegane przez usługę Microsoft.Testing.Platform:

Węzeł opis Przyczyna/obejście problemu
MaxCpuCount To ustawienie kontroluje poziom równoległości na poziomie procesu. Użyj wartości 0, aby włączyć maksymalny równoległość na poziomie procesu. Gdy program Microsoft.Testing.Platform jest używany z programem MSBuild, ta opcja jest odciążona do programu MSBuild. Po uruchomieniu pojedynczego pliku wykonywalnego ta opcja nie ma znaczenia dla microsoft.Testing.Platform.
ResultsDirectory Katalog, w którym są umieszczane wyniki testów. Ścieżka jest względna względem katalogu zawierającego plik .runsettings . Użyj opcji --results-directory wiersza polecenia, aby określić katalog, w którym zostaną umieszczone wyniki testu. Jeśli określony katalog nie istnieje, zostanie utworzony. Wartość domyślna znajduje TestResults się w katalogu zawierającym aplikację testową.
TargetFrameworkVersion To ustawienie definiuje wersję platformy lub rodzinę platform do użycia do uruchamiania testów. Ta opcja jest ignorowana. Właściwości <TargetFramework> lub <TargetFrameworks> MSBuild określają platformę docelową aplikacji. Testy są hostowane w końcowej aplikacji.
TargetPlatform To ustawienie definiuje architekturę używaną do uruchamiania testów. <RuntimeIdentifier> określa architekturę ostatecznej aplikacji, która hostuje testy.
TreatTestAdapterErrorsAsWarnings Pomija błędy adaptera testowego, aby stać się ostrzeżeniami. Microsoft.Testing.Platform umożliwia uruchamianie tylko jednego typu testów z pojedynczego zestawu, a ładowanie struktury testowej lub innych części infrastruktury stanie się niemożliwym do pominięcia błędem, ponieważ oznacza to, że nie można odnaleźć lub uruchomić niektórych testów.
TestAdaptersPaths Co najmniej jedna ścieżka do katalogu, w którym znajdują się elementy TestAdapters Microsoft.Testing.Platform nie korzysta z koncepcji kart testowych i nie zezwala na dynamiczne ładowanie rozszerzeń, chyba że są częścią kompilacji i są rejestrowane w Program.csprogramie automatycznie za pośrednictwem obiektów docelowych kompilacji lub ręcznie.
TestCaseFilter Filtr ograniczający testy, które będą uruchamiane. Aby filtrować testy, użyj --filter opcji wiersza polecenia.
TestSessionTimeout Umożliwia użytkownikom zakończenie sesji testowej po przekroczeniu limitu czasu. Nie ma alternatywnej opcji.
DotnetHostPath Określ niestandardową ścieżkę do hosta dotnet, który jest używany do uruchamiania hosta testowego. Microsoft.Testing.Platform nie wykonuje żadnych dodatkowych rozwiązań dotnet. Zależy to w pełni od sposobu rozpoznawania samej aplikacji dotnet, która może być kontrolowana przez zmienne środowiskowe, takie jak DOTNET_HOST_PATH.
TreatNoTestsAsError Zakończ działanie z kodem zakończenia bez zera, gdy nie zostaną odnalezione żadne testy. Microsoft.Testing.Platform domyślnie wystąpi błąd, gdy nie zostaną odnalezione ani uruchomione testy w aplikacji testowej. Liczbę testów, które można znaleźć w zestawie, można ustawić przy użyciu --minimum-expected-tests parametru wiersza polecenia, który domyślnie to 1.

DataCollectors, element

Microsoft.Testing.Platform nie korzysta z modułów zbierających dane. Zamiast tego ma pojęcie rozszerzeń procesowych i poza procesem. Każde rozszerzenie jest konfigurowane przez odpowiedni plik konfiguracji lub za pośrednictwem wiersza polecenia.

Co najważniejsze, zawiesza się i zawiesza się rozszerzenie awaryjne oraz rozszerzenie pokrycia kodu.

LoggerRunSettings, element

Rejestratory w programie Microsoft.Testing.Platform są konfigurowane za pomocą parametrów wiersza polecenia lub ustawień w kodzie.

Obsługa filtru VSTest

To rozszerzenie oferuje również możliwość używania mechanizmu filtrowania VSTest do odnajdywania lub uruchamiania tylko testów, które są zgodne z wyrażeniem filtru. Aby uzyskać więcej informacji, zobacz sekcję Szczegóły opcji filtrowania lub szczegółowe informacje dotyczące platformy, zobacz stronę Uruchamianie selektywnych testów jednostkowych .

Po włączeniu przez platformę testową można użyć polecenia --filter <FILTER_EXPRESSION>.