XamarinTestCloud@1 - Xamarin Test Cloud v1 任务

XamarinTestCloud@1已弃用。 最初,此任务在生成或发布管道中使用 Xamarin.UITest 通过 Xamarin Test Cloud 测试移动应用。

注意

此任务已弃用,将于 2024 年 1 月 31 日停用。

现在可以 注册 App Center 并改用 AppCenterDistribute@3 任务。

XamarinTestCloud@1已弃用。 最初,此任务在生成或发布管道中使用 Xamarin.UITest 通过 Xamarin Test Cloud 测试移动应用。

注意

现在可以 注册 App Center 并改用 AppCenterDistrivbute#3 任务。

语法

# Xamarin Test Cloud v1
# [Deprecated] Test mobile apps with Xamarin Test Cloud using Xamarin.UITest. Instead, use the 'App Center test' task.
- task: XamarinTestCloud@1
  inputs:
    appFile: # string. Alias: app. Required. App file. 
    #dsymFile: # string. Alias: dsym. dSYM file (iOS only). 
    teamApiKey: # string. Required. Team API key. 
    email: # string. Alias: user. Required. User email. 
    devices: # string. Required. Devices. 
    series: 'master' # string. Required. Series. Default: master.
    testAssemblyDirectory: # string. Alias: testDir. Required. Test assembly directory. 
  # Advanced
    parallelizationOption: 'none' # 'none' | '--fixture-chunk' | '--test-chunk'. Alias: parallelization. Required. Parallelization. Default: none.
    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. System language. Default: en_US.
    #userDefinedLocale: # string. Optional. Use when locale = user. Other locale. 
    testCloudFile: '**/packages/**/tools/test-cloud.exe' # string. Alias: testCloudLocation. Required. test-cloud.exe location. Default: **/packages/**/tools/test-cloud.exe.
    #optionalArgs: # string. Optional arguments. 
    #publishNUnitResults: true # boolean. Publish results to Azure Pipelines. Default: true.
# Xamarin Test Cloud v1
# [Depreciated] Testing mobile apps with Xamarin Test Cloud using Xamarin.UITest - recommended task is now AppCenterTest.
- task: XamarinTestCloud@1
  inputs:
    appFile: # string. Alias: app. Required. App file. 
    #dsymFile: # string. Alias: dsym. dSYM file (iOS only). 
    teamApiKey: # string. Required. Team API key. 
    email: # string. Alias: user. Required. User email. 
    devices: # string. Required. Devices. 
    series: 'master' # string. Required. Series. Default: master.
    testAssemblyDirectory: # string. Alias: testDir. Required. Test assembly directory. 
  # Advanced
    parallelizationOption: 'none' # 'none' | '--fixture-chunk' | '--test-chunk'. Alias: parallelization. Required. Parallelization. Default: none.
    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. System language. Default: en_US.
    #userDefinedLocale: # string. Optional. Use when locale = user. Other locale. 
    testCloudFile: '**/packages/**/tools/test-cloud.exe' # string. Alias: testCloudLocation. Required. test-cloud.exe location. Default: **/packages/**/tools/test-cloud.exe.
    #optionalArgs: # string. Optional arguments. 
    #publishNUnitResults: true # boolean. Publish results to Azure Pipelines/TFS. Default: true.

输入

appFile - 应用文件
输入别名: appstring. 必需。

指定要测试的应用的存储库根目录 () 的相对路径。 可以使用通配符。 例如, **/*.apk 对于所有子文件夹中的所有 APK 文件。 详细了解 文件匹配模式


dsymFile - 仅限 iOS (dSYM 文件)
输入别名: dsymstring.

提供相对于 .ipa 文件的路径。 若要使故障日志更易于阅读,可以上传与应用关联的 dSYM 文件。 此字段仅适用于 iOS 应用。 可以使用通配符。 例如:*.dSYM。 详细了解 文件匹配模式


teamApiKey - 团队 API 密钥
string. 必需。

指定可在 Teams & 应用下找到的 Xamarin 测试云团队 API 密钥。 请使用机密变量以避免公开此值。


email - 用户电子邮件
输入别名: userstring. 必需。

指定 Xamarin Test Cloud 帐户的电子邮件地址。


devices - 设备
string. 必需。

指定 Xamarin Test Cloud 生成的设备字符串。 字符串可作为 Test Cloud 测试运行的命令行参数的值 --devices 找到。


series - 系列
string. 必需。 默认值:master

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


testAssemblyDirectory - 测试程序集目录
输入别名: testDirstring. 必需。

指定包含测试程序集的文件夹的相对路径,例如: SolutionName/TestsProjectName/bin/Release


parallelizationOption - 并行
输入别名: parallelizationstring. 必需。 允许的值: none--fixture-chunk (By test fixture) 、 --test-chunk (By test method) 。 默认值:none

指定要同时运行的测试。


localeOption - 系统语言
输入别名: localestring. 必需。 允许的值: 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. 可选。 在 时 locale = user使用 。

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


testCloudFile - test-cloud.exe 位置
输入别名: testCloudLocationstring. 必需。 默认值:**/packages/**/tools/test-cloud.exe

指定 的路径 test-cloud.exe。 可以使用通配符,当它们出现时,将使用 的第一个匹配项 test-cloud.exe 。 详细了解 文件匹配模式


optionalArgs - 可选参数
string.

指定传递给 test-cloud.exe的其他参数。


publishNUnitResults - 将结果发布到 Azure Pipelines
boolean. 默认值:true

指定要 --nunit-xml 传递给 test-cloud.exe的选项,以便将 NUnit xml 文件的结果发布到 Azure Pipelines。


publishNUnitResults - 将结果发布到 Azure Pipelines/TFS
boolean. 默认值:true

指定要 --nunit-xml 传递给 test-cloud.exe的选项,以便将 NUnit xml 文件的结果发布到 TFS 或 Azure Pipelines。


任务控制选项

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

输出变量

无。

要求

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