| title | description | ms.date | monikerRange |
|---|---|---|---|
XamarinTestCloud@1 - Xamarin Test Cloud v1 task |
XamarinTestCloud@1 is deprecated. Test mobile apps with Xamarin Test Cloud using Xamarin.UITest. Instead, use the 'App Center test' task. |
04/16/2024 |
<=azure-pipelines |
:::moniker range=">=azure-pipelines-2019.1"
XamarinTestCloud@1 is deprecated. Originally, this task was used in a build or release pipeline to test mobile apps with Xamarin Test Cloud using Xamarin.UITest.
Note
[!INCLUDE task-deprecation] You can now sign up with App Center and use the AppCenterDistribute@3 task instead.
:::moniker-end
:::moniker range="=azure-pipelines-2019"
XamarinTestCloud@1 is deprecated. Originally, this task was used in a build or release pipeline to test mobile apps with Xamarin Test Cloud using Xamarin.UITest.
Note
You can now sign up with App Center and use the AppCenterDistrivbute#3 task instead.
:::moniker-end
:::moniker range=">=azure-pipelines-2019.1"
# 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.:::moniker-end
:::moniker range="=azure-pipelines-2019"
# 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.:::moniker-end
:::moniker range="<=azure-pipelines"
appFile - App file
Input alias: app. string. Required.
Specifies the relative path from repo root of the app(s) to test. Wildcards can be used. For example, **/*.apk for all APK files in all subfolders. Learn more about file matching patterns.
:::moniker-end
:::moniker range="<=azure-pipelines"
dsymFile - dSYM file (iOS only)
Input alias: dsym. string.
Provides a path relative to the .ipa file. To make crash logs easier to read, you can upload a dSYM file that is associated with your app. This field only applies to iOS apps. Wildcards can be used. For example: *.dSYM. Learn more about file matching patterns.
:::moniker-end
:::moniker range="<=azure-pipelines"
teamApiKey - Team API key
string. Required.
Specifies your Xamarin Test Cloud Team API key, which can be found under Teams & Apps. Use a secret variable to avoid exposing this value.
:::moniker-end
:::moniker range="<=azure-pipelines"
email - User email
Input alias: user. string. Required.
Specifies the email address of your Xamarin Test Cloud account.
:::moniker-end
:::moniker range="<=azure-pipelines"
devices - Devices
string. Required.
Specifies the devices string generated by Xamarin Test Cloud. The string can be found as the value of the --devices command line argument of a Test Cloud test run.
:::moniker-end
:::moniker range="<=azure-pipelines"
series - Series
string. Required. Default value: master.
Specifies the series name for organizing test runs (e.g. master, production, beta).
:::moniker-end
:::moniker range="<=azure-pipelines"
testAssemblyDirectory - Test assembly directory
Input alias: testDir. string. Required.
Specifies the relative path to the folder containing the test assemblies, such as: SolutionName/TestsProjectName/bin/Release.
:::moniker-end
:::moniker range="<=azure-pipelines"
parallelizationOption - Parallelization
Input alias: parallelization. string. Required. Allowed values: none, --fixture-chunk (By test fixture), --test-chunk (By test method). Default value: none.
Specifies tests to run simultaneously.
:::moniker-end
:::moniker range="<=azure-pipelines"
localeOption - System language
Input alias: locale. string. Required. Allowed values: da_DK (Danish (Denmark)), nl_NL (Dutch (Netherlands)), en_GB (English (United Kingdom)), en_US (English (United States)), fr_FR (French (France)), de_DE (German (Germany)), ja_JP (Japanese (Japan)), ru_RU (Russian (Russia)), es_MX (Spanish (Mexico)), es_ES (Spanish (Spain)), user (Other). Default value: en_US.
Specifies your language. If your language isn't displayed, select Other and enter its locale below, such as en_US.
:::moniker-end
:::moniker range="<=azure-pipelines"
userDefinedLocale - Other locale
string. Optional. Use when locale = user.
Enters any two-letter ISO-639 language code along with any two-letter ISO 3166 country code in the format [language]_[country], such as en_US.
:::moniker-end
:::moniker range="<=azure-pipelines"
testCloudFile - test-cloud.exe location
Input alias: testCloudLocation. string. Required. Default value: **/packages/**/tools/test-cloud.exe.
Specifies the path to test-cloud.exe. Wildcards can be used, and when they are, the first occurrence of test-cloud.exe is used. Learn more about file matching patterns.
:::moniker-end
:::moniker range="<=azure-pipelines"
optionalArgs - Optional arguments
string.
Specifies the additional arguments passed to test-cloud.exe.
:::moniker-end
:::moniker range=">=azure-pipelines-2019.1"
publishNUnitResults - Publish results to Azure Pipelines
boolean. Default value: true.
Specifies the --nunit-xml option to be passed to test-cloud.exeso that results from the NUnit xml file are be published to Azure Pipelines.
:::moniker-end
:::moniker range="=azure-pipelines-2019"
publishNUnitResults - Publish results to Azure Pipelines/TFS
boolean. Default value: true.
Specifies the --nunit-xml option to be passed to test-cloud.exeso that results from the NUnit xml file are be published to TFS or Azure Pipelines.
:::moniker-end
All tasks have control options in addition to their task inputs. For more information, see Control options and common task properties.
:::moniker range="<=azure-pipelines"
None.
:::moniker-end
:::moniker range="<=azure-pipelines"
| Requirement | Description |
|---|---|
| Pipeline types | YAML, Classic build, Classic release |
| Runs on | Agent, DeploymentGroup |
| Demands | None |
| Capabilities | This task does not satisfy any demands for subsequent tasks in the job. |
| Command restrictions | Any |
| Settable variables | Any |
| Agent version | 1.83.0 or greater |
| Task category | Test |
:::moniker-end