VSTest@1 - Visual Studio Test v1 工作

發行項
07/02/2024

使用此工作搭配 Visual Studio 測試執行器來執行測試。

Syntax

# Visual Studio Test v1
# Run tests with Visual Studio test runner.
- task: VSTest@1
  inputs:
  # Execution Options
    testAssembly: '**\*test*.dll;-:**\obj\**' # string. Required. Test Assembly. Default: **\*test*.dll;-:**\obj\**.
    #testFiltercriteria: # string. Test Filter criteria. 
    #runSettingsFile: # string. Run Settings File. 
    #overrideTestrunParameters: # string. Override TestRun Parameters. 
    #codeCoverageEnabled: False # boolean. Code Coverage Enabled. Default: False.
    #runInParallel: false # boolean. Run In Parallel. Default: false.
  # Advanced Execution Options
    #vstestLocationMethod: 'version' # 'version' | 'location'. VSTest. Default: version.
    #vsTestVersion: '14.0' # 'latest' | '14.0' | '12.0'. Optional. Use when vstestLocationMethod = version. VSTest version. Default: 14.0.
    #vstestLocation: # string. Optional. Use when vstestLocationMethod = location. Path to vstest.console.exe. 
    #pathtoCustomTestAdapters: # string. Path to Custom Test Adapters. 
    #otherConsoleOptions: # string. Other console options. 
  # Reporting Options
    #testRunTitle: # string. Test Run Title. 
    #platform: # string. Platform. 
    #configuration: # string. Configuration. 
    #publishRunAttachments: true # boolean. Upload Test Attachments. Default: true.

輸入

testAssembly - 測試元件
string. 必要。預設值：**\*test*.dll;-:**\obj\**。

指定要在其中執行測試的測試二進位檔。可以使用萬用字元。例如，針對名稱中具有「test」的所有 DLL 使用 **\*test*.dll;-:**\obj\** ，並排除任何名為「obj」子目錄中的檔案。

testFiltercriteria - 測試篩選準則
string.

指定從測試元件篩選測試的其他準則。例如：Priority=1|Name=MyTestMethod。

runSettingsFile - 執行設定檔案
string.

指定要與測試搭配使用的 runsettings 檔案路徑。使用 $(Build.SourcesDirectory) 來存取 Project 資料夾。

overrideTestrunParameters - 覆寫 TestRun 參數
string.

覆寫Runsettings檔案之TestRunParameters區段中定義的參數。例如：AppURL=$(DeployURL);Port=8080。

codeCoverageEnabled - 啟用程式碼涵蓋範圍
boolean. 預設值：False。

從測試回合收集程式碼涵蓋範圍資訊。

runInParallel - 平行執行
boolean. 預設值：false。

啟用測試的平行執行。

vstestLocationMethod - VSTest
string. 允許的值： version 、 location (指定位置) 。預設值：version。

vsTestVersion - VSTest 版本
string. 選擇性。使用時機 vstestLocationMethod = version 。允許的值： latest 、 14.0 (Visual Studio 2015) ， 12.0 (Visual Studio 2013) 。預設值：14.0。

指定要使用的 Visual Studio Test 版本。

vstestLocation - vstest.console.exe的路徑
string. 選擇性。使用時機 vstestLocationMethod = location 。

指定 VSTest 的路徑。

pathtoCustomTestAdapters - 自訂測試配接器的路徑
string.

指定自訂測試配接器的目錄路徑。會自動搜尋 NuGet 還原的配接器。

otherConsoleOptions - 其他主控台選項
string.

指定可傳遞至 vstest.console.exe 的其他主控台選項。

testRunTitle - 測試回合標題
string.

指定測試回合的名稱。

platform - 平臺
string.

指定應該報告測試的平臺。如果您已在建置工作中定義平臺的變數，請在提供此輸入時使用該變數。

configuration - 配置
string.

指定應該報告測試的組態。如果您已在建置工作中定義組態的變數，請在提供此輸入時使用該變數。

publishRunAttachments - 上傳測試附件
boolean. 預設值：true。

加入宣告或退出發佈測試回合層級附件。

工作控制選項

除了工作輸入之外，所有工作都有控制選項。如需詳細資訊，請參閱控制項選項和一般工作屬性。

輸出變數

無。

規格需求

需求	說明
管線類型	YAML、傳統組建、傳統版本
執行于	Agent、DeploymentGroup
要求	自我裝載代理程式必須具備符合下列需求的功能，才能執行使用此工作的作業：vstest
Capabilities	此工作不符合作業中後續工作的任何需求。
命令限制	任意
Settable 變數	任意
代理程式版本	1.89.0 或更新版本
工作類別	測試

共用方式為