VSMobileCenterTest@0 - Mobile Center 测试 v0 任务

使用此任务通过 Visual Studio Mobile Center 测试移动应用包。

语法

# Mobile Center Test v0
# Test mobile app packages with Visual Studio Mobile Center.
- task: VSMobileCenterTest@0
  inputs:
    app: # string. Required. Binary Application File Path. 
    artifactsDir: '$(Build.ArtifactStagingDirectory)/MobileCenterTest' # string. Required. Artifacts Directory. Default: $(Build.ArtifactStagingDirectory)/MobileCenterTest.
  # Prepare Tests
    #enablePrepare: true # boolean. Prepare Tests. Default: true.
    framework: 'appium' # 'appium' | 'espresso' | 'calabash' | 'uitest' | 'xcuitest'. Required when enablePrepare = true. Test Framework. Default: appium.
    #appiumBuildDir: # string. Required when enablePrepare = true && framework = appium. Build Directory. 
    #espressoBuildDir: # string. Optional. Use when enablePrepare = true && framework = espresso. Build Directory. 
    #espressoTestApkPath: # string. Optional. Use when enablePrepare = true && framework = espresso. Test APK Path. 
    #calabashProjectDir: # string. 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.
    #uitestBuildDir: # string. Required when enablePrepare = true && framework = uitest. Build Directory. 
    #uitestStoreFile: # string. Optional. Use when enablePrepare = true && framework = uitest. Store File. 
    #uitestStorePass: # string. Optional. Use when enablePrepare = true && framework = uitest. Store Password. 
    #uitestKeyAlias: # string. Optional. Use when enablePrepare = true && framework = uitest. Key Alias. 
    #uitestKeyPass: # string. Optional. Use when enablePrepare = true && framework = uitest. Key Password. 
    #uitestToolsDir: # string. Optional. Use when enablePrepare = true && framework = uitest. Test Tools Directory. 
    #signInfo: # string. Optional. Use when framework = calabash || framework = uitest. Signing Information. 
    #xcuitestBuildDir: # string. Optional. Use when enablePrepare = true && framework = xcuitest. Build Directory. 
    #xcuitestTestIpaPath: # string. Optional. Use when enablePrepare = true && framework = xcuitest. Test IPA Path. 
    #prepareOpts: # string. Optional. Use when enablePrepare = true. Additional Options. 
  # Run Tests
    #enableRun: true # boolean. Run Tests. Default: true.
    credsType: 'serviceEndpoint' # 'serviceEndpoint' | 'inputs'. Required when enableRun = true. Authentication Method. Default: serviceEndpoint.
    #serverEndpoint: # string. Required when enableRun = true && credsType = serviceEndpoint. Mobile Center Connection. 
    #username: # string. Required when enableRun = true && credsType = inputs. Mobile Center Username. 
    #password: # string. Required when enableRun = true && credsType = inputs. Mobile 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.
    #dsymDir: # string. Optional. Use when enableRun = true. dSYM Directory. 
    locale: 'en_US' # 'da_DK' | 'nl_NL' | 'en_GB' | 'en_US' | 'fr_FR' | 'de_DE' | 'ja_JP' | 'ru_RU' | 'es_MX' | 'es_ES' | 'user'. Required when enableRun = true. System Language. Default: en_US.
    #userDefinedLocale: # string. Optional. Use when enableRun = true && locale = user. Other Locale. 
    #loginOpts: # string. Optional. Use when enableRun = true && credsType = inputs. Addtional Options for Login. 
    #runOpts: # string. Optional. Use when enableRun = true. Additional Options for Run. 
    #async: false # boolean. Optional. Use when enableRun = true. Do not wait for test result. Default: false.
  # Advanced
    #cliLocationOverride: # string. mobile-center CLI Location. 
    #debug: false # boolean. Enable Debug Output. Default: false.

输入

app - 二进制应用程序文件路径
string. 必需。

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


artifactsDir - 项目目录
string. 必需。 默认值:$(Build.ArtifactStagingDirectory)/MobileCenterTest

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


enablePrepare - 准备测试
boolean. 默认值:true

如果设置为 true,则准备测试。


framework - 测试框架
string. 当 enablePrepare = true 时,需要此选项。 允许的值:appiumespressocalabashuitest (Xamarin UI 测试) 。 xcuitest 默认值:appium

指定任务将使用的测试框架。


appiumBuildDir - 生成目录
string. 当 enablePrepare = true && framework = appium 时,需要此选项。

指定包含 Appium 测试的目录的路径。


espressoBuildDir - 生成目录
string. 可选。 在 时 enablePrepare = true && framework = espresso使用 。

指定 Espresso 输出目录的路径。


espressoTestApkPath - 测试 APK 路径
string. 可选。 在 时 enablePrepare = true && framework = espresso使用 。

指定包含 Espresso 测试的 APK 文件的路径。 如果未设置值, build-dir 则用于查找 APK 文件。 允许使用通配符。


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

强制任务在没有 Cucumber 配置文件的情况下运行。


uitestBuildDir - 生成目录
string. 当 enablePrepare = true && framework = uitest 时,需要此选项。

指定具有生成的测试程序集的目录的路径。


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

指定存储文件的路径。


uitestStorePass - 存储密码
string. 可选。 在 时 enablePrepare = true && framework = uitest使用 。

指定存储文件的密码。 请在“变量”选项卡上使用新的变量并为其启用锁定以加密此值。


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

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


uitestKeyPass - 密钥密码
string. 可选。 在 时 enablePrepare = true && framework = uitest使用 。

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


uitestToolsDir - 测试工具 目录
string. 可选。 在 时 enablePrepare = true && framework = uitest使用 。

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


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

使用签名信息对测试服务器进行签名。


xcuitestBuildDir - 生成目录
string. 可选。 在 时 enablePrepare = true && framework = xcuitest使用 。

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


xcuitestTestIpaPath - 测试 IPA 路径
string. 可选。 在 时 enablePrepare = true && framework = xcuitest使用 。

使用 XCUITest 测试指定文件的路径 *.ipa


prepareOpts - 其他选项
string. 可选。 在 时 enablePrepare = true使用 。

指定要传递给 mobile-center test prepare step的其他参数。


enableRun - 运行测试
boolean. 默认值:true


credsType - 身份验证方法
string. 当 enableRun = true 时,需要此选项。 允许的值: serviceEndpoint (Mobile Center Connection) , inputs (凭据) 。 默认值:serviceEndpoint

指定身份验证方法。 使用 Mobile Center 服务终结点连接,或指定凭据以连接到 Visual Studio Mobile Center。


serverEndpoint - Mobile Center 连接
string. 当 enableRun = true && credsType = serviceEndpoint 时,需要此选项。

指定 Visual Studio Mobile Center 连接的服务终结点。 若要创建一个,请单击“ 管理”链接 并创建新的服务终结点。


username - 移动中心用户名
string. 当 enableRun = true && credsType = inputs 时,需要此选项。

访问 Azure 移动中心 设置用户名。


password - 移动中心密码
string. 当 enableRun = true && credsType = inputs 时,需要此选项。

请访问 Azure 移动中心 设置密码。 此字符串可以接受在生成/发布定义中定义为 的 $(passwordVariable)变量。 可以将变量类型 secret 标记为 来保护它。


appSlug - 应用 Slug
string. 当 enableRun = true 时,需要此选项。

应用数据组的格式 {username}/{app_identifier}为 。 若要为应用查找 {username}{app_identifier} ,请在 Azure 移动应用上查找应用一览。 该 URL 的格式为 https://mobile.azure.com/users/{username}/apps/{app_identifier}


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

标识将针对哪些设备运行此测试。 从 Mobile Center 测试信标定义新的测试运行时,复制并粘贴此字符串。


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

指定用于组织测试运行的系列名称, (例如 master、、 productionbeta) 。


dsymDir - dSYM 目录
string. 可选。 在 时 enableRun = true使用 。

指定包含 iOS 符号文件的 dSYM 目录的路径。


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

如果未显示你的语言,请指定 “其他 ”并输入其区域设置,例如 en_US


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

指定格式为 的任何双字母 ISO-639 语言代码,以及任何双字母 ISO 3166 国家/地区代码, [language]_[country]例如 en_US


loginOpts - 登录的附加选项
string. 可选。 在 时 enableRun = true && credsType = inputs使用 。

指定传递给 mobile-center login step的其他参数。


runOpts - 用于运行的其他选项
string. 可选。 在 时 enableRun = true使用 。

指定传递给 mobile-center test run的其他参数。


async - 不要等待测试结果
boolean. 可选。 在 时 enableRun = true使用 。 默认值:false

设置为 true时,异步执行命令,并在上传测试时退出,而无需等待测试结果。


cliLocationOverride - mobile-center CLI 位置
string.

指定 mobile-center 命令行接口的路径 (CLI) 。


debug - 启用调试输出
boolean. 默认值:false

将 添加到--debugmobile-center命令行接口 (CLI) 。


任务控制选项

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

输出变量

无。

要求

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