VSMobileCenterTest@0 - 移动中心测试 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 - Artifacts 目录
string。 必填。 默认值:$(Build.ArtifactStagingDirectory)/MobileCenterTest

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


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

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


framework - 测试框架
stringenablePrepare = true时是必需的。 允许的值:appiumespressocalabashuitest(Xamarin UI 测试),xcuitest。 默认值:appium

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


appiumBuildDir - 生成目录
stringenablePrepare = true && framework = appium时是必需的。

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


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

指定 Espresso 输出目录的路径。


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

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


calabashProjectDir - 项目目录
stringenablePrepare = 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 - 生成目录
stringenablePrepare = 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 - 身份验证方法
stringenableRun = true时是必需的。 允许的值:serviceEndpoint(移动中心连接)、inputs(凭据)。 默认值:serviceEndpoint

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


serverEndpoint - 移动中心连接
stringenableRun = true && credsType = serviceEndpoint时是必需的。

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


username - 移动中心用户名
stringenableRun = true && credsType = inputs时是必需的。

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


password - 移动中心密码
stringenableRun = true && credsType = inputs时是必需的。

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


appSlug - App Slug
stringenableRun = true时是必需的。

应用 slug 采用 {username}/{app_identifier}格式。 若要查找应用的 {username}{app_identifier},请在 Azure 移动应用中找到应用列表。 该 URL 的格式为 https://mobile.azure.com/users/{username}/apps/{app_identifier}


devices - 设备
stringenableRun = true时是必需的。

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


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

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


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

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


locale - 系统语言
stringenableRun = true时是必需的。 允许的值为:da_DK(丹麦))、nl_NL(荷兰)、en_GB(英国)、en_US(英语(美国))、fr_FR(法国))fr_FRen_GBru_RU (德国)、es_MX(日本)、es_ES(俄罗斯)、user(西班牙)、(西班牙)、(其他)。 默认值:en_US

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


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

[language]_[country]格式指定任何双字母 ISO-639 语言代码以及任何双字母 ISO 3166 国家/地区代码,如 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 - 移动中心 CLI 位置
string

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


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

--debug 添加到 mobile-center 命令行接口(CLI)。


任务控制选项

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

输出变量

没有。

要求

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