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
- Платформа тестирования
string
. Требуется при .enablePrepare = true
Допустимые значения: appium
, espresso
, uitest
calabash
( тест пользовательского интерфейса 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
- Файл конфигурации 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
.
Указывает путь к каталогу с помощью средств тестирования пользовательского интерфейса 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
.
Указывает метод проверки подлинности. Используйте подключение к конечной точке службы Мобильного центра или укажите учетные данные для подключения к Visual Studio Mobile Center.
serverEndpoint
- Подключение к центру мобильной связи
string
. Требуется при .enableRun = true && credsType = serviceEndpoint
Указывает конечную точку службы для подключения к Visual Studio Mobile Center. Чтобы создать ее, щелкните ссылку Управление и создайте новую конечную точку службы.
username
- Имя пользователя в центре мобильных устройств
string
. Требуется при .enableRun = true && credsType = inputs
Чтобы задать имя пользователя, перейдите в Центр мобильных устройств Azure .
password
- Пароль центра мобильных устройств
string
. Требуется при .enableRun = true && credsType = inputs
Чтобы задать пароль, перейдите в Центр мобильной связи Azure . Эта строка может принимать переменную, определенную в определениях сборки или выпуска, как $(passwordVariable)
. Вы можете пометить тип переменной как secret
безопасный.
appSlug
- Приложение Slug
string
. Требуется при .enableRun = true
Приложение slug имеет формат {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_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
string
.
Указывает путь к интерфейсу командной mobile-center
строки (CLI).
debug
- Включение выходных данных отладки
boolean
. Значение по умолчанию: false
.
Добавляется --debug
в интерфейс командной mobile-center
строки (CLI).
Параметры управления задачами
Помимо входных данных, все задачи имеют параметры управления. Дополнительные сведения см. в разделе Параметры управления и общие свойства задачи.
Выходные переменные
Нет.
Требования
Требование | Описание |
---|---|
Типы конвейеров | YAML, классическая сборка |
Выполняется в | Агент, DeploymentGroup |
Требования | None |
Capabilities | Эта задача не удовлетворяет требованиям для последующих задач в задании. |
Ограничения команд | Любой |
Устанавливаемые переменные | Любой |
Версия агента | Все поддерживаемые версии агента. |
Категория задач | Тест |