AppCenterTest@1 - App Center 测试 v1 任务

使用 Visual Studio App Center 测试应用包。

语法

# App Center test v1
# Test app packages with Visual Studio App Center.
- task: AppCenterTest@1
  inputs:
    appFile: # string. Alias: app. Required. Binary application file path. 
    artifactsDirectory: '$(Build.ArtifactStagingDirectory)/AppCenterTest' # string. Alias: artifactsDir. Required. Artifacts directory. Default: $(Build.ArtifactStagingDirectory)/AppCenterTest.
  # Prepare Tests
    #prepareTests: true # boolean. Alias: enablePrepare. Prepare tests. Default: true.
    frameworkOption: 'appium' # 'appium' | 'espresso' | 'calabash' | 'uitest' | 'xcuitest'. Alias: framework. Required when enablePrepare = true. Test framework. Default: appium.
    #appiumBuildDirectory: # string. Alias: appiumBuildDir. Required when enablePrepare = true && framework = appium. Build directory. 
    #espressoBuildDirectory: # string. Alias: espressoBuildDir. Optional. Use when enablePrepare = true && framework = espresso. Build directory. 
    #espressoTestApkFile: # string. Alias: espressoTestApkPath. Optional. Use when enablePrepare = true && framework = espresso. Test APK path. 
    #calabashProjectDirectory: # string. Alias: calabashProjectDir. Required when enablePrepare = true && framework = calabash. Project directory. 
    #calabashConfigFile: # string. Optional. Use when enablePrepare = true && framework = calabash. Cucumber config file. 
    #calabashProfile: # string. Optional. Use when enablePrepare = true && framework = calabash. Profile to run. 
    #calabashSkipConfigCheck: false # boolean. Optional. Use when enablePrepare = true && framework = calabash. Skip Configuration Check. Default: false.
    #uiTestBuildDirectory: # string. Alias: uitestBuildDir. Required when enablePrepare = true && framework = uitest. Build directory. 
    #uitestStorePath: # string. Optional. Use when enablePrepare = true && framework = uitest. Store file. 
    #uiTestStorePassword: # string. Alias: uitestStorePass. Optional. Use when enablePrepare = true && framework = uitest. Store password. 
    #uitestKeyAlias: # string. Optional. Use when enablePrepare = true && framework = uitest. Key alias. 
    #uiTestKeyPassword: # string. Alias: uitestKeyPass. Optional. Use when enablePrepare = true && framework = uitest. Key password. 
    #uiTestToolsDirectory: # string. Alias: uitestToolsDir. Optional. Use when enablePrepare = true && framework = uitest. Test tools directory. 
    #signInfo: # string. Optional. Use when framework = calabash || framework = uitest. Signing information. 
    #xcUITestBuildDirectory: # string. Alias: xcuitestBuildDir. Optional. Use when enablePrepare = true && framework = xcuitest. Build directory. 
    #xcUITestIpaFile: # string. Alias: xcuitestTestIpaPath. Optional. Use when enablePrepare = true && framework = xcuitest. Test IPA path. 
    #prepareOptions: # string. Alias: prepareOpts. Optional. Use when enablePrepare = true. Additional options. 
  # Run Tests
    #runTests: true # boolean. Alias: enableRun. Run tests. Default: true.
    credentialsOption: 'serviceEndpoint' # 'serviceEndpoint' | 'inputs'. Alias: credsType. Required when enableRun = true. Authentication method. Default: serviceEndpoint.
    #serverEndpoint: # string. Required when enableRun = true && credsType = serviceEndpoint. App Center service connection. 
    #username: # string. Required when enableRun = true && credsType = inputs. App Center username. 
    #password: # string. Required when enableRun = true && credsType = inputs. App Center password. 
    appSlug: # string. Required when enableRun = true. App slug. 
    devices: # string. Required when enableRun = true. Devices. 
    #series: 'master' # string. Optional. Use when enableRun = true. Test series. Default: master.
    #dsymDirectory: # string. Alias: dsymDir. Optional. Use when enableRun = true. dSYM directory. 
    localeOption: 'en_US' # 'da_DK' | 'nl_NL' | 'en_GB' | 'en_US' | 'fr_FR' | 'de_DE' | 'ja_JP' | 'ru_RU' | 'es_MX' | 'es_ES' | 'user'. Alias: locale. Required when enableRun = true. System language. Default: en_US.
    #userDefinedLocale: # string. Optional. Use when enableRun = true && locale = user. Other locale. 
    #loginOptions: # string. Alias: loginOpts. Optional. Use when enableRun = true && credsType = inputs. Additional options for login. 
    #runOptions: # string. Alias: runOpts. Optional. Use when enableRun = true. Additional options for run. 
    #skipWaitingForResults: false # boolean. Alias: async. Optional. Use when enableRun = true. Do not wait for test result. Default: false.
  # Advanced
    #cliFile: # string. Alias: cliLocationOverride. App Center CLI location. 
    #showDebugOutput: false # boolean. Alias: debug. Enable debug output. Default: false.

输入

appFile - 二进制应用程序文件路径
输入别名： app。 string. 必需。

从存储库根目录到要测试的 APK 或 IPA 文件的相对路径。

artifactsDirectory - Artifacts 目录
输入别名： artifactsDir。 string. 必需。 默认值：$(Build.ArtifactStagingDirectory)/AppCenterTest。

指定放置由准备步骤生成并由运行步骤使用的项目的位置。 如果此目录尚不存在，则将创建该目录。

prepareTests - 准备测试
输入别名： enablePrepare。 boolean. 默认值：true。

当设置为 true时，此输入将准备测试。

frameworkOption - 测试框架
输入别名： framework。 string. 当 enablePrepare = true 时，需要此选项。 允许的值：appium、、espressocalabash、 uitest (Xamarin UI 测试) 。 xcuitest 默认值：appium。

appiumBuildDirectory - 生成目录
输入别名： appiumBuildDir。 string. 当 enablePrepare = true && framework = appium 时，需要此选项。

具有 Appium 测试的目录的路径。

espressoBuildDirectory - 生成目录
输入别名： espressoBuildDir。 string. 可选。 在 时 enablePrepare = true && framework = espresso使用 。

Espresso 输出目录的路径。

espressoTestApkFile - 测试 APK 路径
输入别名： espressoTestApkPath。 string. 可选。 在 时 enablePrepare = true && framework = espresso使用 。

包含 Espresso 测试的 APK 文件的路径。 如果未设置， build-dir 则用于发现它。 允许使用通配符。

calabashProjectDirectory - 项目目录
输入别名： calabashProjectDir。 string. 当 enablePrepare = true && framework = calabash 时，需要此选项。

Calabash 工作区目录的路径。

calabashConfigFile - Cucumber 配置文件
string. 可选。 在 时 enablePrepare = true && framework = calabash使用 。

Cucumber 配置文件的路径，通常cucumber.yml。

calabashProfile - 要运行的配置文件
string. 可选。 在 时 enablePrepare = true && framework = calabash使用 。

要运行的配置文件。 此值必须存在于 Cucumber 配置文件中。

calabashSkipConfigCheck - 跳过配置检查
boolean. 可选。 在 时 enablePrepare = true && framework = calabash使用 。 默认值：false。

当设置为 true时，此输入将跳过 Cucumber 配置文件指定的配置检查。

uiTestBuildDirectory - 生成目录
输入别名： uitestBuildDir。 string. 当 enablePrepare = true && framework = uitest 时，需要此选项。

包含生成的测试程序集的目录的路径。

uitestStorePath - 存储文件
string. 可选。 在 时 enablePrepare = true && framework = uitest使用 。

用于对应用进行签名的应用商店文件的路径。

uiTestStorePassword - 存储密码
输入别名： uitestStorePass。 string. 可选。 在 时 enablePrepare = true && framework = uitest使用 。

用于对应用进行签名的应用商店文件的密码。 若要加密此值，请使用在“变量”选项卡上启用锁的新变量。

uitestKeyAlias - 密钥别名
string. 可选。 在 时 enablePrepare = true && framework = uitest使用 。

指定标识存储文件中使用的公钥/私钥对的别名。

uiTestKeyPassword - 密钥密码
输入别名： uitestKeyPass。 string. 可选。 在 时 enablePrepare = true && framework = uitest使用 。

指定别名和存储文件的密钥密码。 若要加密此值，请使用在“变量”选项卡上启用锁的新变量。

uiTestToolsDirectory - 测试工具目录
输入别名： uitestToolsDir。 string. 可选。 在 时 enablePrepare = true && framework = uitest使用 。

包含test-cloud.exe的 Xamarin UI 测试工具 的 目录的路径。

signInfo - 签名信息
string. 可选。 在 时 framework = calabash || framework = uitest使用 。

对测试服务器进行签名。

xcUITestBuildDirectory - 生成目录
输入别名： xcuitestBuildDir。 string. 可选。 在 时 enablePrepare = true && framework = xcuitest使用 。

生成输出目录的路径通常 $(ProjectDir)/Build/Products/Debug-iphoneos () 。

xcUITestIpaFile - 测试 IPA 路径
输入别名： xcuitestTestIpaPath。 string. 可选。 在 时 enablePrepare = true && framework = xcuitest使用 。

带有 XCUITest 测试的 .ipa 文件的路径。

prepareOptions - 其他选项
输入别名： prepareOpts。 string. 可选。 在 时 enablePrepare = true使用 。

传递给 App Center 测试准备步骤的其他参数。

runTests - 运行测试
输入别名： enableRun。 boolean. 默认值：true。

运行测试。

credentialsOption - 身份验证方法
输入别名： credsType。 string. 当 enableRun = true 时，需要此选项。 允许的值： serviceEndpoint (App Center 服务连接) 、 inputs (凭据) 。 默认值：serviceEndpoint。

使用 App Center 服务连接或输入凭据以连接到 Visual Studio App Center。

serverEndpoint - App Center 服务连接
string. 当 enableRun = true && credsType = serviceEndpoint 时，需要此选项。

选择 Visual Studio App Center 的服务连接。 如果需要，请单击“管理”链接以创建新的服务连接。

username - App Center 用户名
string. 当 enableRun = true && credsType = inputs 时，需要此选项。

通过访问 App Center 登录页创建用户名，并在此处提供值。

password - App Center 密码
string. 当 enableRun = true && credsType = inputs 时，需要此选项。

访问 App Center 登录页设置密码，并在此处提供值。 接受在生成或发布管道 $(passwordVariable) 中定义的变量。 可以将变量类型 secret 标记为 来保护它。

appSlug - 应用数据
string. 当 enableRun = true 时，需要此选项。

应用数据组的格式 <username>/<app_identifier>为 。 若要查找 <username> 应用的 和 <app_identifier> ，请在 Visual Studio App Center 中单击其名称。 生成的 URL 的格式 https://appcenter.ms/users/<username>/apps/<app_identifier>为 。

devices - 设备
string. 当 enableRun = true 时，需要此选项。

标识将对其运行此测试的设备。 从 Visual Studio App Center 测试信标定义新的测试运行时，复制并粘贴此字符串。

series - 测试系列
string. 可选。 在 时 enableRun = true使用 。 默认值：master。

用于组织测试运行的系列名称 (例如：master、production、beta) 。

dsymDirectory - dSYM 目录
输入别名： dsymDir。 string. 可选。 在 时 enableRun = true使用 。

iOS 符号文件的路径。

localeOption - 系统语言
输入别名： locale。 string. 当 enableRun = true 时，需要此选项。 允许的值： da_DK (丹麦语 (丹麦) ) ， nl_NL (荷兰语 (荷兰) ) ， en_GB (英语 (英国) ) 、 en_US (英语 (美国) ) 、 fr_FR (法语 (法国) ) 、 de_DE (德语 (德国) ) 、 ja_JP (日语 (日本) ) 、 ru_RU (俄语 (俄罗斯) ) 、 es_MX (西班牙语 (墨西哥) ) ， es_ES (西班牙语 (西班牙) ) ， user (其他) 。 默认值：en_US。

如果未显示你的语言，则使用 。 选择 Other 并输入其区域设置，例如 en_US。

userDefinedLocale - 其他区域设置
string. 可选。 在 时 enableRun = true && locale = user使用 。

以 格式 <language>_<country>输入任何双字母 ISO-639 语言代码以及任何双字母 ISO 3166 国家/地区代码，例如 en_US。

loginOptions - 用于登录的其他选项
输入别名： loginOpts。 string. 可选。 在 时 enableRun = true && credsType = inputs使用 。

传递给 Visual Studio App Center 登录步骤的其他参数。

runOptions - 用于运行的其他选项
输入别名： runOpts。 string. 可选。 在 时 enableRun = true使用 。

传递给 Visual Studio App Center 测试运行的其他参数。

skipWaitingForResults - 不要等待测试结果
输入别名： async。 boolean. 可选。 在 时 enableRun = true使用 。 默认值：false。

异步执行命令，并在上传测试时退出，而无需等待测试结果。

cliFile - App Center CLI 位置
输入别名： cliLocationOverride。 string.

生成或发布代理上 Visual Studio App Center CLI 的路径。

showDebugOutput - 启用调试输出
输入别名： debug。 boolean. 默认值：false。

将 添加到 --debug Visual Studio App Center CLI。

任务控制选项

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

输出变量

无。

备注

此任务允许使用 App Center Test 针对应用程序二进制 (.apk 或 .ipa 文件) 运行测试套件。

• 首先在 App Center 中注册。
• 有关使用此任务的详细信息，请参阅 App Center 文章使用 Azure DevOps 进行 UI 测试。

示例

此示例使用 App Center 测试任务在 Android 应用上运行 Espresso 测试。

steps:
- task: AppCenterTest@1
  displayName: 'Espresso Test - Synchronous'
  inputs:
    appFile: 'Espresso/espresso-app.apk'
    artifactsDirectory: '$(Build.ArtifactStagingDirectory)/AppCenterTest'
    frameworkOption: espresso
    espressoBuildDirectory: Espresso
    serverEndpoint: 'myAppCenterServiceConnection'
    appSlug: 'xplatbg1/EspressoTests'
    devices: a84c93af

要求

要求	说明
管道类型	YAML，经典版本
运行平台	Agent、DeploymentGroup
需求	无
功能	此任务不满足作业中后续任务的任何要求。
命令限制	任意
可设置变量	任意
代理版本	2.206.1 或更高版本
任务类别	测试