VSTest 橋接器延伸模組

此延伸模組提供 VSTest 的相容性層，可讓測試架構相依以繼續支援使用 VSTest 模式執行 (vstest.console.exe、一般 dotnet test、AzDo 上的 VSTest task、Visual Studio 和 Visual Studio Code 的測試總管...)。此延伸模組隨附於 Microsoft.Testing.Extensions.VSTestBridge 套件。

重要

此套件隨附 Microsoft .NET 程式庫封閉原始碼免費使用授權模型。

與 VSTest 的相容性

此延伸模組的主要目的是為 VSTest 使用者提供簡單且順暢的升級體驗，方式是藉由雙重模式啟用新平臺並同時提供相容性模式，讓一般工作流程能夠繼續運作。

Runsettings 支援

此延伸模組可讓您提供 VSTest .runsettings 檔案，但平台不會使用此檔案中的所有選項。 我們在下方描述支援和不支援的設定、組態選項和最常使用的 VSTest 組態選項替代方案。

由測試架構啟用時，您可以使用 --settings <SETTINGS_FILE> 來提供 .runsettings 檔案。

RunConfiguration 元素

RunConfiguration 元素可以包括下列元素。 Microsoft.Testing.Platform 不會遵守這些設定：

節點	描述	原因/因應措施
MaxCpuCount	此設定可控制處理序層級上的平行處理原則層級。 使用 0 以啟用最大處理序層級平行處理原則。	當 Microsoft.Testing.Platform 與 MSBuild 搭配使用時，此選項會卸載至 MSBuild。 執行單一可執行檔時，此選項對 Microsoft.Testing.Platform 沒有任何意義。
ResultsDirectory	放置測試結果的目錄。 路徑相對於包含 .runsettings 檔案的目錄。	使用命令行選項 --results-directory 來判斷要放置測試結果的目錄。 如果指定的目錄不存在，則會建立該目錄。 預設值為 TestResults，位於包含測試應用程式的目錄裡。
TargetFrameworkVersion	此設定會定義用來執行測試的架構版本或架構系列。	已忽略此選項。 <TargetFramework> 或 <TargetFrameworks> MSBuild 屬性會決定應用程式的目標架構。 測試裝載於最終應用程式中。
TargetPlatform	此設定會定義用來執行測試的結構。	<RuntimeIdentifier> 會決定裝載測試之最終應用程式的架構。
TreatTestAdapterErrorsAsWarnings	隱藏要變成警告的測試配接器錯誤。	Microsoft.Testing.Platform 只允許從單一組件執行一種測試，而且無法載入測試架構或其他基礎結構元件將會變成無法略過的錯誤，因為其表示無法探索或執行某些測試。
TestAdaptersPaths	TestAdapters 所在目錄的一或多個路徑	Microsoft.Testing.Platform 不會使用測試配接器的概念，而且不允許動態載入延伸模組，除非其為組建的一部分，而且會透過建置目標自動註冊或手動註冊 Program.cs。
TestCaseFilter	限制將執行之測試的篩選。	若要篩選測試，請使用 --filter 命令列選項。
TestSessionTimeout	當測試工作階段超過指定的逾時之時，允許使用者終止測試工作階段。	沒有替代選項。
DotnetHostPath	指定用來執行測試主機之 dotnet 主機的自訂路徑。	Microsoft.Testing.Platform 不會執行任何額外的 dotnet 解析。 這完全取決於 dotnet 解析本身的方式，這可由環境變數控制，例如 DOTNET_HOST_PATH。
TreatNoTestsAsError	未探索到任何測試時，以非零結束代碼結束。	在測試應用程式中未探索或執行任何測試時，Microsoft.Testing.Platform 預設會發生錯誤。 您可以使用命令列參數，將 --minimum-expected-tests 預期在元件中找到的測試數目設定為 1。

DataCollectors 元素

Microsoft.Testing.Platform 未使用資料收集器。 而是具有內含式和跨流程延伸模組的概念。 每個延伸模組都是由其各自的設定檔或透過命令列來設定。

最重要的是停止回應和損毀延伸模組，以及程式代碼涵蓋範圍延伸模組。

LoggerRunSettings 元素

Microsoft.Testing.Platform 中的記錄器是透過命令列參數或程式碼中的設定來設定。

VSTest 篩選條件支援

此延伸模組也可讓您使用 VSTest 篩選條件來探索或只執行符合篩選條件運算式的測試。 如需詳細資訊，請參閱篩選條件選項詳細資訊一節，或如需架構特定詳細資訊，請參閱執行選擇性單元測試頁面。

由測試架構啟用時，您可以使用 --filter <FILTER_EXPRESSION>。