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

VSMobileCenterTest@0 — задача "Тест мобильного центра" версии 0

  • Статья

Используйте эту задачу для тестирования пакетов мобильных приложений с помощью 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 - Test Framework
string. Требуется, если enablePrepare = true. Допустимые значения: appium, espresso, calabash, uitest (тест пользовательского интерфейса Xamarin), xcuitest. Значение по умолчанию: appium.

Указывает платформу тестирования, которую будет использовать задача.


appiumBuildDir - каталог сборки
string. Требуется, если enablePrepare = true && framework = appium.

Указывает путь к каталогу, содержаму тесты Appium.


espressoBuildDir - каталог сборки
string. Необязательно. Используется при enablePrepare = true && framework = espresso.

Указывает путь к выходному каталогу Espresso.


espressoTestApkPath - тестовый путь APK
string. Необязательно. Используется при enablePrepare = true && framework = espresso.

Указывает путь к APK-файлу с помощью тестов Espresso. Если значение не задано, build-dir используется для поиска APK-файла. Подстановочные знаки допустимы.


calabashProjectDir - Каталог проекта
string. Требуется, если enablePrepare = true && framework = calabash.

Указывает путь к каталогу рабочей области Calabash.


calabashConfigFile - файл конфигурации огурца
string. Необязательно. Используется при enablePrepare = true && framework = calabash.

Указывает путь к файлу конфигурации огурца, который обычно cucumber.yml.


Профиль calabashProfile - для запуска
string. Необязательно. Используется при enablePrepare = true && framework = calabash.

Указывает профиль для запуска. Это значение должно существовать в файле конфигурации огурца.


calabashSkipConfigCheck - пропустить проверку конфигурации
boolean. Необязательно. Используется при enablePrepare = true && framework = calabash. Значение по умолчанию: false.

Принудительно выполняет задачу без профиля Огурца.


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.

Указывает путь к каталогу с помощью средств тестирования пользовательского интерфейса Xamarin, содержащих test-cloud.exe.


signInfo - сведения о подписи
string. Необязательно. Используется при framework = calabash || framework = uitest.

Использует сведения о подписи для подписывания тестового сервера.


xcuitestBuildDir - каталог сборки
string. Необязательно. Используется при enablePrepare = true && framework = xcuitest.

Указывает путь к выходному каталогу сборки, который обычно $(ProjectDir)/Build/Products/Debug-iphoneos.


xcuitestTestIpaPath - тестовый путь IPA
string. Необязательно. Используется при enablePrepare = true && framework = xcuitest.

Указывает путь к файлу *.ipa с помощью тестов XCUITest.


prepareOpts - дополнительные параметры
string. Необязательно. Используется при enablePrepare = true.

Указывает дополнительные аргументы для передачи в mobile-center test prepare step.


enableRun - выполнение тестов
boolean. Значение по умолчанию: true.


Метод проверки подлинности credsType -
string. Требуется, если enableRun = true. Допустимые значения: serviceEndpoint (подключение к мобильному центру), inputs (учетные данные). Значение по умолчанию: serviceEndpoint.

Указывает метод проверки подлинности. Используйте подключение конечной точки службы Mobile Center или укажите учетные данные для подключения к Visual Studio Mobile Center.


serverEndpoint - подключение к мобильному центру
string. Требуется, если enableRun = true && credsType = serviceEndpoint.

Указывает конечную точку службы для подключения Visual Studio Mobile Center. Чтобы создать ее, щелкните ссылку Управление и создайте новую конечную точку службы.


username - имени пользователя в Центре мобильных устройств
string. Требуется, если enableRun = true && credsType = inputs.

Чтобы задать имя пользователя, посетите в Центре мобильных устройств Azure.


паролей password - Mobile Center
string. Требуется, если enableRun = true && credsType = inputs.

Чтобы задать пароль, посетите Центре мобильных устройств Azure. Эта строка может принимать переменную, определенную в определениях сборки и выпуска, как $(passwordVariable). Вы можете пометить тип переменной как secret для защиты.


appSlug - App 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.

Указывает путь к каталогу dSYM, который содержит файлы символов iOS.


locale - системный язык
string. Требуется, если enableRun = true. Допустимые значения: da_DK (Датская (Дания)), nl_NL (голландский (Нидерланды)), en_GB (английский (Соединенное Королевство)), en_US (английский (США)), fr_FR (французский (Франция)), de_DEfr_FR (Франция)) en_US (немецкий (Германия)), 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 - расположение интерфейса командной строки мобильного центра
string.

Указывает путь к интерфейсу командной строки mobile-center (CLI).


debug - включить выходных данных отладки
boolean. Значение по умолчанию: false.

Добавляет --debug в интерфейс командной строки mobile-center (CLI).


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

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

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

Нет.

Требования

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