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
时,需要此选项。 允许的值:appium
、espresso
、calabash
、 uitest
(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 连接的服务终结点。 若要创建一个,请单击“ 管理”链接 并创建新的服务终结点。
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
、、 production
beta
) 。
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
。
将 添加到--debug
mobile-center
命令行接口 (CLI) 。
任务控制选项
除了任务输入,所有任务都有控制选项。 有关详细信息,请参阅 控制选项和常见任务属性。
输出变量
无。