VisualStudioTestPlatformInstaller@1 - Visual Studio 测试平台安装程序 v1 任务

  • 项目

使用此任务从 nuget.org 或指定源获取 Microsoft 测试平台，并将其添加到工具缓存。 安装程序任务满足 vstest 需求，生成或发布管道中的后续 Visual Studio 测试任务可以运行，而无需在代理计算机上安装完整的 Visual Studio。

语法

# Visual Studio test platform installer v1
# Acquire the test platform from nuget.org or the tool cache. Satisfies the ‘vstest’ demand and can be used for running tests and collecting diagnostic data using the Visual Studio Test task.
- task: VisualStudioTestPlatformInstaller@1
  inputs:
  # Package settings
    packageFeedSelector: 'nugetOrg' # 'nugetOrg' | 'customFeed' | 'netShare'. Required. Package Feed. Default: nugetOrg.
    #versionSelector: 'latestPreRelease' # 'latestPreRelease' | 'latestStable' | 'specificVersion'. Required when packageFeedSelector = nugetOrg || packageFeedSelector = customFeed. Version. Default: latestPreRelease.
    #testPlatformVersion: # string. Required when versionSelector = specificVersion. Test Platform Version. 
    #customFeed: # string. Required when packageFeedSelector = customFeed. Package Source. 
    #username: # string. Optional. Use when packageFeedSelector = customFeed. User Name. 
    #password: # string. Optional. Use when packageFeedSelector = customFeed. Password. 
    #netShare: # string. Required when packageFeedSelector = netShare. UNC Path.

# Visual Studio Test Platform Installer v1
# Acquires the test platform from nuget.org or the tools cache. Satisfies the ‘vstest’ demand and can be used for running tests and collecting diagnostic data using the Visual Studio Test task.
- task: VisualStudioTestPlatformInstaller@1
  inputs:
  # Package settings
    packageFeedSelector: 'nugetOrg' # 'nugetOrg' | 'customFeed' | 'netShare'. Required. Package Feed. Default: nugetOrg.
    #versionSelector: 'latestPreRelease' # 'latestPreRelease' | 'latestStable' | 'specificVersion'. Required when packageFeedSelector = nugetOrg || packageFeedSelector = customFeed. Version. Default: latestPreRelease.
    #testPlatformVersion: # string. Required when versionSelector = specificVersion. Test Platform Version. 
    #customFeed: # string. Required when packageFeedSelector = customFeed. Package Source. 
    #username: # string. Optional. Use when packageFeedSelector = customFeed. User Name. 
    #password: # string. Optional. Use when packageFeedSelector = customFeed. Password. 
    #netShare: # string. Required when packageFeedSelector = netShare. UNC Path.

输入

packageFeedSelector - 包源
string. 必需。 允许的值： nugetOrg (官方 Nuget) 、 customFeed (自定义源) (netShare 网络路径) 。 默认值：nugetOrg。

指定任务提取 Visual Studio Test Platform NuGet 包的源。

nugetOrg - 官方 NuGet： 从 NuGet 获取测试平台包。 此选项需要在代理计算机上建立 Internet 连接。

customFeed - 自定义源：从 Azure DevOps 或 TFS 中的自定义源或包管理源获取测试平台包。

netShare - 网络路径：从网络共享安装测试平台。 必须从 NuGet 下载指定的 Microsoft.TestPlatform.nupkg 版本，并将其放置在生成/发布代理可以访问的网络共享上。


versionSelector - 版本
string. 当 packageFeedSelector = nugetOrg || packageFeedSelector = customFeed 时，需要此选项。 允许的值： latestPreRelease (最新 (包括预发行) ) 、 latestStable (最新稳定) (specificVersion 特定版本) 。 默认值：latestPreRelease。

安装最新版本或特定版本的 Visual Studio 测试平台。 如果使用测试平台安装程序运行编码的 UI 测试，则所选的 Visual Studio 测试平台必须与生成测试二进制文件的 Visual Studio 安装的主版本匹配。 例如，如果编码的 UI 测试项目是使用 Visual Studio 2017 (版本 15.x) 生成的，则必须使用 Test Platform 版本 15.x。


testPlatformVersion - 测试平台版本
string. 当 versionSelector = specificVersion 时，需要此选项。

指定要在代理上安装的 Visual Studio 测试平台的版本。 可以在 NuGet 上查看可用版本。


customFeed - 包源
string. 当 packageFeedSelector = customFeed 时，需要此选项。

指定 Azure DevOps 或 TFS 中包含测试平台包的自定义源或包管理源的 URL。 可以指定公共和专用源。


username - 用户名
string. 可选。 在 时 packageFeedSelector = customFeed使用 。

指定用于对 Package Source 参数中指定的源进行身份验证的用户名。 如果 password 输入使用个人访问令牌 (PAT) ，则不需要此输入。


password - 密码
string. 可选。 在 时 packageFeedSelector = customFeed使用 。

指定密码或个人访问令牌 (PAT) ，用于对输入中指定的 customFeed 源进行身份验证。


netShare - UNC 路径
string. 当 packageFeedSelector = netShare 时，需要此选项。

指定文件的完整 UNC 路径 Microsoft.TestPlatform.nupkg 。 必须从 NuGet 下载指定的Microsoft.TestPlatform.nupkg版本，并将其放置在生成/发布代理可以访问的网络共享上。


任务控制选项

除了任务输入，所有任务都有控制选项。 有关详细信息，请参阅 控制选项和常见任务属性。

输出变量

无。

备注

注意

如果使用托管代理，检查所使用的代理的软件表，以查看是否安装了 Visual Studio。 如果已安装 Visual Studio，则无需运行 Visual Studio 测试平台安装程序任务。

使用此任务从 nuget.org 或指定源获取 Microsoft 测试平台，并将其添加到工具缓存。 安装程序任务满足 vstest 需求，生成或发布管道中的后续 Visual Studio 测试任务 可以运行，而无需在代理计算机上安装完整的 Visual Studio。

注意

  • 在生成或发布管道中，“Visual Studio 测试平台安装程序”任务必须显示在“Visual Studio 测试”任务之前。
  • “Visual Studio 测试”任务中的“测试平台版本”选项必须设置为“由工具安装程序安装”。

请参阅 从测试计划运行自动测试。

要求

要求 说明
管道类型 YAML、经典版本、经典版本
运行平台 Agent、DeploymentGroup
需求 无
功能 运行此任务满足同一作业中任何后续任务的以下 要求 ：VsTest
命令限制 任意
可设置变量 任意
代理版本 2.144.0 或更高版本
任务类别 工具
要求 说明
管道类型 YAML、经典版本、经典版本
运行平台 Agent、DeploymentGroup
需求 无
功能 运行此任务满足同一作业中任何后续任务的以下 要求 ：VsTest
命令限制 任意
可设置变量 任意
代理版本 2.103.0 或更高版本
任务类别 工具