AppCenterTest@1 - App Center 测试 v1 任务

项目
03/24/2025

使用 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、espresso、calabash、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 - Project 目录
输入别名：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 - App slug
string。 enableRun = true时是必需的。

应用 slug 采用 <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（法国））fr_FRen_GBde_DE （德国）、ja_JP（日本）、ru_RU（俄罗斯）、es_MX（西班牙）、es_ES（西班牙）、user（其他）。默认值：en_US。

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

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

输入任何双字母 ISO-639 语言代码以及采用 <language>_<country>格式的任何双字母 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，经典生成
运行时间	代理，DeploymentGroup
需求	没有
功能	此任务不满足作业中后续任务的任何要求。
命令限制	任何
Settable 变量	任何
代理版本	2.206.1 或更高版本
任务类别	测试

要求	说明
管道类型	YAML，经典生成
运行时间	代理，DeploymentGroup
需求	没有
功能	此任务不满足作业中后续任务的任何要求。
命令限制	任何
Settable 变量	任何
代理版本	2.144.0 或更高版本
任务类别	测试

要求	说明
管道类型	YAML，经典生成
运行时间	代理，DeploymentGroup
需求	没有
功能	此任务不满足作业中后续任务的任何要求。
命令限制	任何
Settable 变量	任何
代理版本	所有支持的代理版本。
任务类别	测试

通过

AppCenterTest@1 - App Center 测试 v1 任务

语法

输入

任务控制选项

输出变量

注解

例子

要求

反馈

其他资源