VSTest@1 - Visual Studio Test v1 工作

使用此工作搭配 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 或更新版本
工作類別	測試