Поделиться через


XamarinTestCloud@1 — задача Xamarin Test Cloud версии 1

XamarinTestCloud@1 не рекомендуется. Первоначально эта задача использовалась в конвейере сборки или выпуска для тестирования мобильных приложений с помощью Xamarin Test Cloud с помощью Xamarin.UITest.

Примечание

Эта задача устарела и будет прекращена 31 января 2024 г.

Теперь вы можете зарегистрироваться в Центре приложений и использовать задачу AppCenterDistribute@3 .

XamarinTestCloud@1 не рекомендуется. Первоначально эта задача использовалась в конвейере сборки или выпуска для тестирования мобильных приложений с помощью Xamarin Test Cloud с помощью Xamarin.UITest.

Примечание

Теперь вы можете зарегистрироваться в Центре приложений и использовать задачу 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 - Файл приложения
Входной псевдоним: app. string. Обязательный.

Указывает относительный путь от корня репозитория тестируемых приложений. Можно использовать подстановочные знаки. Например, **/*.apk для всех файлов APK во всех вложенных папках. Дополнительные сведения о шаблонах сопоставления файлов.


dsymFile - Файл dSYM (только для iOS)
Входной псевдоним: dsym. string.

Предоставляет путь относительно .ipa файла. Чтобы упростить чтение журналов сбоев, можно отправить файл dSYM, связанный с приложением. Это поле применяется только к приложениям iOS. Можно использовать подстановочные знаки. Например: *.dSYM. Дополнительные сведения о шаблонах сопоставления файлов.


teamApiKey - Ключ API группы
string. Обязательный.

Указывает ключ API Xamarin Test Cloud Team, который можно найти в разделе Teams & Apps. Используйте переменную секрета , чтобы избежать предоставления этого значения.


email - Электронная почта пользователя
Входной псевдоним: user. string. Обязательный.

Указывает адрес электронной почты учетной записи Xamarin Test Cloud.


devices - Устройств
string. Обязательный.

Указывает строку устройств, созданную Xamarin Test Cloud. Строку можно найти как значение аргумента командной --devices строки тестового запуска Test Cloud.


series - Серии
string. Обязательный. Значение по умолчанию: master.

Указывает имя ряда для организации тестовых запусков (например master, , production, beta).


testAssemblyDirectory - Каталог тестовой сборки
Входной псевдоним: testDir. string. Обязательный.

Указывает относительный путь к папке, содержащей тестовые сборки, например : SolutionName/TestsProjectName/bin/Release.


parallelizationOption - Распараллеливание
Входной псевдоним: parallelization. string. Обязательный. Допустимые значения: none, --fixture-chunk (по тестовой методике), --test-chunk (по методу теста). Значение по умолчанию: none.

Указывает тесты для одновременного выполнения.


localeOption - Системный язык
Входной псевдоним: locale. string. Обязательный. Допустимые значения: 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.

Вводит любой двухбуквенный код языка ISO-639 вместе с любым двухбуквенный код страны ISO 3166 в формате [язык]_[страна], например en_US.


testCloudFile - расположениеtest-cloud.exe
Входной псевдоним: testCloudLocation. string. Обязательный. Значение по умолчанию: **/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, чтобы результаты из XML-файла NUnit публиковались в Azure Pipelines.


publishNUnitResults - Публикация результатов в Azure Pipelines/TFS
boolean. Значение по умолчанию: true.

Указывает параметр, --nunit-xml в который необходимо передать test-cloud.exe, чтобы результаты из xml-файла NUnit публиковались в TFS или Azure Pipelines.


Параметры управления задачами

Помимо входных данных, все задачи имеют параметры управления. Дополнительные сведения см. в разделе Параметры управления и общие свойства задачи.

Выходные переменные

Нет.

Требования

Требование Описание
Типы конвейеров YAML, классическая сборка, классический выпуск
Выполняется в Агент, DeploymentGroup
Требования None
Capabilities Эта задача не удовлетворяет требованиям для последующих задач в задании.
Ограничения команд Любой
Устанавливаемые переменные Любой
Версия агента 1.83.0 или более поздней версии
Категория задач Тест