此擴充提供與 VSTest 相容層,允許已實作 VSTest 的測試框架:
- 輕鬆運行 Microsoft 測試平台(MTP),無需進行大幅度的代碼重寫。
- 支援 VSTest 與 MTP 並使用相同的測試框架實作。
此擴充套件隨 Microsoft.Testing.Extensions.VSTestBridge NuGet 套件一同推出。
與 VSTest 的相容性
此延伸模組的主要目的是允許啟用新平臺的雙重模式,並同時提供相容性模式,讓一般工作流程能夠繼續運作,為 VSTest 使用者提供簡單且順暢的升級體驗。
橋接器將基於 VSTest 的測試框架調整至 MTP。 它不會把 VsTestConsoleWrapper 變成原生 MTP 用戶端,也不保證每個 MTP 架構都能透過 VSTest 執行。 現有 Microsoft.TestPlatform.TranslationLayer 的整合仍需 vstest.console 和相容的 VSTest 轉接器。
對於能發現並執行 MTP 測試的新工具,請使用 MTP 伺服器模式用戶端。 如需其他整合選項,請參閱 以程式方式進行測試探索與執行。
執行設定支援
此擴充功能可讓您提供 VSTest .runsettings 檔案,但平台並不支援此檔案中的所有選項。 我們在下面描述最常使用 VSTest 組態選項的支援和不支援的設定、組態選項和替代方案。
由測試架構啟用時,您可以使用 --settings <SETTINGS_FILE> 來提供 .runsettings 檔案。
RunConfiguration 元素
以下 RunConfiguration 元素不被 MTP 支援:
| Node | 描述 | 原因/因應措施 |
|---|---|---|
| MaxCpuCount | 此設定用於控制進程層級的平行化程度。 使用 0 啟用最大進程層級平行處理原則。 | 當 MTP 與 MSBuild 一起使用時,此選項會被交由 MSBuild。 當執行單一執行檔時,這個選項對 MTP 沒有意義。 |
| ResultsDirectory | 放置測試結果的目錄。 路徑相對於包含 .runsettings 檔案的目錄。 | 使用 --results-directory 命令列選項來設定結果目錄。 關於 dotnet test 預設值與版面配置,請參見 結果與雜訊。 |
| 目標框架版本 (TargetFrameworkVersion) | 此設定會定義用來執行測試的架構版本或架構系列。 | 這個選項會被忽略。
<TargetFramework> 或 <TargetFrameworks> MSBuild 屬性會決定應用程式的目標架構。 測試承載於最終應用程式中。 |
| 目標平台 | 此設定會定義用來執行測試的架構。 |
<RuntimeIdentifier> 決定裝載測試的最終應用程式架構。 |
| 將測試適配器錯誤視為警告 | 抑制測試配接器錯誤,使其變為警告。 | MTP 只允許從單一組件執行一種測試,且未能載入測試框架或其他基礎設施部分將成為無法跳過的錯誤,因為這表示某些測試無法被發現或執行。 |
| TestAdaptersPaths | TestAdapters 所在目錄的一個或多個指向路徑 | MTP 不使用測試介面卡的概念,且不允許動態載入擴充功能,除非它們是建置的一部分,且已透過建置目標自動或手動註冊於 Program.cs。 |
| TestCaseFilter | 用於限制將執行測試的篩選器。 | 從 v1.6 開始,支援此 runsettings 項目。 在此版本之前,您應該改用命令行選項 --filter。 |
| TestSessionTimeout | 允許使用者在超過指定的逾時時終止測試工作階段。 | 沒有替代選項。 |
| DotnetHostPath | 指定自訂用來執行測試主機的 dotnet 主機路徑。 | MTP 並沒有進行任何額外的 .NET 解析。 這完全取決於 dotnet 解析本身的方式,這可由環境變數控制,例如 DOTNET_HOST_PATH。 |
| 將無測試視為錯誤 | 未發現任何測試時,返回非零的退出代碼。 | 當測試應用程式中未發現或執行任何測試時,MTP 預設會出錯。 您可以使用 --minimum-expected-tests 預設為 1 的命令行參數,來設定元件中預期要尋找的測試數目。 |
DataCollectors 元素
MTP 並沒有使用資料收集器。 而是具有程式內和跨程式的擴充功能概念。 每個擴充功能都是由其各自的組態檔或透過命令行來設定。
最重要的是,停止回應 和 當機 擴充功能,以及 程式碼涵蓋 擴充功能。
LoggerRunSettings 元素
MTP 中的記錄器可透過命令列參數或程式碼設定來設定。
VSTest 篩選支援
此延伸模組也可讓您使用 VSTest 篩選機制來探索或只執行符合篩選表達式的測試。 如需詳細資訊,請參閱 篩選選項詳細數據 一節,或如需架構特定詳細數據,請參閱 執行選擇性單元測試 頁面。
當測試框架啟用時,您可以使用 --filter <FILTER_EXPRESSION>。
TestRun 參數
您可以使用 --test-parameter格式的 key=value 命令行選項,將參數傳遞至測試回合。 這個選項可以多次使用,為每個要設定的參數指定一次。
然後,測試回合中的測試架構可以存取這些參數:
- 若為 MSTest,請使用 Properties
- 若為 NUnit,請使用 TestContext.TestParameters