Примечание.
Для доступа к этой странице требуется авторизация. Вы можете попробовать войти или изменить каталоги.
Для доступа к этой странице требуется авторизация. Вы можете попробовать изменить каталоги.
Тестирование пакетов приложений с помощью Центра приложений Visual Studio.
Синтаксис
# App Center test v1
# Test app packages with Visual Studio App Center.
- task: AppCenterTest@1
inputs:
appFile: # string. Alias: app. Required. Binary application file path.
artifactsDirectory: '$(Build.ArtifactStagingDirectory)/AppCenterTest' # string. Alias: artifactsDir. Required. Artifacts directory. Default: $(Build.ArtifactStagingDirectory)/AppCenterTest.
# Prepare Tests
#prepareTests: true # boolean. Alias: enablePrepare. Prepare tests. Default: true.
frameworkOption: 'appium' # 'appium' | 'espresso' | 'calabash' | 'uitest' | 'xcuitest'. Alias: framework. Required when enablePrepare = true. Test framework. Default: appium.
#appiumBuildDirectory: # string. Alias: appiumBuildDir. Required when enablePrepare = true && framework = appium. Build directory.
#espressoBuildDirectory: # string. Alias: espressoBuildDir. Optional. Use when enablePrepare = true && framework = espresso. Build directory.
#espressoTestApkFile: # string. Alias: espressoTestApkPath. Optional. Use when enablePrepare = true && framework = espresso. Test APK path.
#calabashProjectDirectory: # string. Alias: calabashProjectDir. 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.
#uiTestBuildDirectory: # string. Alias: uitestBuildDir. Required when enablePrepare = true && framework = uitest. Build directory.
#uitestStorePath: # string. Optional. Use when enablePrepare = true && framework = uitest. Store file.
#uiTestStorePassword: # string. Alias: uitestStorePass. Optional. Use when enablePrepare = true && framework = uitest. Store password.
#uitestKeyAlias: # string. Optional. Use when enablePrepare = true && framework = uitest. Key alias.
#uiTestKeyPassword: # string. Alias: uitestKeyPass. Optional. Use when enablePrepare = true && framework = uitest. Key password.
#uiTestToolsDirectory: # string. Alias: uitestToolsDir. Optional. Use when enablePrepare = true && framework = uitest. Test tools directory.
#signInfo: # string. Optional. Use when framework = calabash || framework = uitest. Signing information.
#xcUITestBuildDirectory: # string. Alias: xcuitestBuildDir. Optional. Use when enablePrepare = true && framework = xcuitest. Build directory.
#xcUITestIpaFile: # string. Alias: xcuitestTestIpaPath. Optional. Use when enablePrepare = true && framework = xcuitest. Test IPA path.
#prepareOptions: # string. Alias: prepareOpts. Optional. Use when enablePrepare = true. Additional options.
# Run Tests
#runTests: true # boolean. Alias: enableRun. Run tests. Default: true.
credentialsOption: 'serviceEndpoint' # 'serviceEndpoint' | 'inputs'. Alias: credsType. Required when enableRun = true. Authentication method. Default: serviceEndpoint.
#serverEndpoint: # string. Required when enableRun = true && credsType = serviceEndpoint. App Center service connection.
#username: # string. Required when enableRun = true && credsType = inputs. App Center username.
#password: # string. Required when enableRun = true && credsType = inputs. App 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.
#dsymDirectory: # string. Alias: dsymDir. Optional. Use when enableRun = true. dSYM directory.
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 when enableRun = true. System language. Default: en_US.
#userDefinedLocale: # string. Optional. Use when enableRun = true && locale = user. Other locale.
#loginOptions: # string. Alias: loginOpts. Optional. Use when enableRun = true && credsType = inputs. Additional options for login.
#runOptions: # string. Alias: runOpts. Optional. Use when enableRun = true. Additional options for run.
#skipWaitingForResults: false # boolean. Alias: async. Optional. Use when enableRun = true. Do not wait for test result. Default: false.
# Advanced
#cliFile: # string. Alias: cliLocationOverride. App Center CLI location.
#showDebugOutput: false # boolean. Alias: debug. Enable debug output. Default: false.
Входные данные
appFile
-
Путь к файлу двоичного приложения
Псевдоним ввода: app.
string. Обязательное.
Относительный путь от корня репозитория к файлу APK или IPA, который требуется протестировать.
artifactsDirectory
-
Каталог артефактов
Псевдоним ввода: artifactsDir.
string. Обязательное. Значение по умолчанию: $(Build.ArtifactStagingDirectory)/AppCenterTest.
Указывает, где следует разместить артефакты, созданные на этапе подготовки и используемые на этапе выполнения. Этот каталог будет создан, если он еще не существует.
prepareTests
-
Подготовка тестов
Псевдоним ввода: enablePrepare.
boolean. Значение по умолчанию: true.
Если задано значение true, этот вход подготавливает тесты.
frameworkOption
-
Тестовая среда
Псевдоним ввода: framework.
string. Требуется, если enablePrepare = true. Допустимые значения: appium, espresso, calabash, uitest (тест пользовательского интерфейса Xamarin), xcuitest. Значение по умолчанию: appium.
appiumBuildDirectory
-
Каталог сборки
Псевдоним ввода: appiumBuildDir.
string. Требуется, если enablePrepare = true && framework = appium.
Путь к директории с тестами Appium.
espressoBuildDirectory
-
Каталог сборки
Псевдоним ввода: espressoBuildDir.
string. Необязательно. Используется при enablePrepare = true && framework = espresso.
Путь к выходному каталогу эспрессо.
espressoTestApkFile
-
Тестовый путь APK
Псевдоним ввода: espressoTestApkPath.
string. Необязательно. Используется при enablePrepare = true && framework = espresso.
Путь к APK-файлу с тестами Эспрессо. Если он не установлен, build-dir то используется для его обнаружения. Допускается использование подстановочных знаков.
calabashProjectDirectory
-
Директория проекта
Псевдоним ввода: calabashProjectDir.
string. Требуется, если enablePrepare = true && framework = calabash.
Путь к директории рабочей области Calabash.
calabashConfigFile
-
Файл конфигурации огурца
string. Необязательно. Используется при enablePrepare = true && framework = calabash.
Путь к конфигурационному файлу Cucumber, как правило, cucumber.yml.
Профиль calabashProfile - для запуска
string. Необязательно. Используется при enablePrepare = true && framework = calabash.
Профиль для запуска. Это значение должно существовать в файле конфигурации огурца.
calabashSkipConfigCheck
-
пропустить проверку конфигурации
boolean. Необязательно. Используется при enablePrepare = true && framework = calabash. Значение по умолчанию: false.
Если задано значение , trueэтот ввод пропускает проверку конфигурации, указанную профилем Cucumber.
uiTestBuildDirectory
-
Каталог сборки
Псевдоним ввода: uitestBuildDir.
string. Требуется, если enablePrepare = true && framework = uitest.
Путь к директории со собранными тестовыми сборками.
uitestStorePath
-
Сохранить файл
string. Необязательно. Используется при enablePrepare = true && framework = uitest.
Путь к файлу магазина, который используется для подписи приложения.
uiTestStorePassword
-
Пароль от магазина
Псевдоним ввода: uitestStorePass.
string. Необязательно. Используется при enablePrepare = true && framework = uitest.
Пароль файла хранилища, который используется для подписи приложения. Чтобы зашифровать это значение, используйте новую переменную с включенной блокировкой на вкладке Переменные.
uitestKeyAlias
-
Ключевой псевдоним
string. Необязательно. Используется при enablePrepare = true && framework = uitest.
Указывает псевдоним, определяющий пару открытого и закрытого ключей, используемую в файле хранилища.
паролем ключа uiTestKeyPassword -
Псевдоним ввода: uitestKeyPass.
string. Необязательно. Используется при enablePrepare = true && framework = uitest.
Задает пароль ключа для псевдонима и файла хранилища. Чтобы зашифровать это значение, используйте новую переменную с включенной блокировкой на вкладке Переменные.
uiTestToolsDirectory
-
Каталог средств тестирования
Псевдоним ввода: uitestToolsDir.
string. Необязательно. Используется при enablePrepare = true && framework = uitest.
Путь к каталогу с тестовыми средствами пользовательского интерфейса Xamarin, содержащими test-cloud.exe.
signInfo
-
Информация для подписи
string. Необязательно. Используется при framework = calabash || framework = uitest.
Подписывает тестовый сервер.
xcUITestBuildDirectory
-
Каталог сборки
Псевдоним ввода: xcuitestBuildDir.
string. Необязательно. Используется при enablePrepare = true && framework = xcuitest.
Путь к директории вывода сборки (обычно $(ProjectDir)/Build/Products/Debug-iphoneos).
xcUITestIpaFile
-
Тестовый путь IPA
Псевдоним ввода: xcuitestTestIpaPath.
string. Необязательно. Используется при enablePrepare = true && framework = xcuitest.
Путь к файлу .ipa с тестами XCUITest.
prepareOptions
-
Дополнительные опции
Псевдоним ввода: prepareOpts.
string. Необязательно. Используется при enablePrepare = true.
Дополнительные аргументы, передаваемые на этап подготовки к тесту в Центре приложений.
runTests
-
Выполнение тестов
Псевдоним ввода: enableRun.
boolean. Значение по умолчанию: true.
Запускает тесты.
credentialsOption
-
Метод аутентификации
Псевдоним ввода: credsType.
string. Требуется, если enableRun = true. Допустимые значения: serviceEndpoint (Подключение к службе Центра приложений), inputs (Учетные данные). Значение по умолчанию: serviceEndpoint.
Использует подключение к службе Центра приложений или вводит учетные данные для подключения к Центру приложений Visual Studio.
serverEndpoint
-
подключение службы Центра приложений
string. Требуется, если enableRun = true && credsType = serviceEndpoint.
Выбирает подключение службы для Центра приложений Visual Studio. При необходимости нажмите на ссылку Управление, чтобы создать новое подключение к службе.
username
-
Имя пользователя Центра приложений
string. Требуется, если enableRun = true && credsType = inputs.
Создайте имя пользователя, посетив страницу входа в Центр приложений, и укажите его значение.
password
-
Пароль Центра приложений
string. Требуется, если enableRun = true && credsType = inputs.
Установите пароль, посетив страницу входа в Центр приложений, и укажите его значение. Переменные, определенные в конвейерах сборки или выпуска в том виде, в котором $(passwordVariable) они принимаются. Вы можете пометить тип переменной как secret для защиты.
appSlug
-
приложения
string. Требуется, если enableRun = true.
Слизь приложения находится в формате <username>/<app_identifier>. Чтобы найти <username> и <app_identifier> для приложения, щелкните его имя в Центре приложений Visual Studio. Полученный URL имеет формат https://appcenter.ms/users/<username>/apps/<app_identifier>.
devices
-
устройства
string. Требуется, если enableRun = true.
Определяет устройства, на которых будет выполняться этот тест. Скопируйте и вставьте эту строку при определении нового тестового запуска из тестового маяка Центра приложений Visual Studio.
series
-
Серия испытаний
string. Необязательно. Используется при enableRun = true. Значение по умолчанию: master.
Название серии для организации тестовых прогонов (например: мастер, продакшн, бета).
dsymDirectory
-
Каталог dSYM
Псевдоним ввода: dsymDir.
string. Необязательно. Используется при enableRun = true.
Путь к файлам символов iOS.
localeOption
-
системный язык
Псевдоним ввода: 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.
Используйте, если ваш язык не отображается. Выберите Other и введите его языковой стандарт, например en_US.
userDefinedLocale
-
Другие языковые
string. Необязательно. Используется при enableRun = true && locale = user.
Вводит любой двухбуквенный код языка ISO-639 вместе с любым двухбуквенным кодом страны ISO 3166 в формате <language>_<country>, например en_US.
loginOptions
-
Дополнительные возможности для входа в систему
Псевдоним ввода: loginOpts.
string. Необязательно. Используется при enableRun = true && credsType = inputs.
Дополнительные аргументы, передаваемые на шаг входа в Центр приложений Visual Studio.
runOptions
-
Дополнительные опции для бега
Псевдоним ввода: runOpts.
string. Необязательно. Используется при enableRun = true.
Дополнительные аргументы, передаваемые в тестовый запуск Центра приложений Visual Studio.
skipWaitingForResults
-
Не ожидайте результатов теста
Псевдоним ввода: async.
boolean. Необязательно. Используется при enableRun = true. Значение по умолчанию: false.
Выполняет команду асинхронно и завершает работу при загрузке тестов, не дожидаясь результатов теста.
cliFile
-
Расположение интерфейса командной строки Центра приложений
Псевдоним ввода: cliLocationOverride.
string.
Путь к интерфейсу командной строки Центра приложений Visual Studio в агенте сборки или выпуска.
showDebugOutput
-
Включение вывода отладки
Псевдоним ввода: debug.
boolean. Значение по умолчанию: false.
Добавляется --debug в интерфейс командной строки Центра приложений Visual Studio.
Параметры управления задачами
Помимо входных данных, все задачи имеют параметры управления. Дополнительные сведения см. в разделе Параметры управления и общие свойства задач.
Выходные переменные
Нет.
Замечания
Эта задача позволяет запускать наборы тестов для двоичного файла приложения (.apk или IPA-файла ) с помощью теста Центра приложений.
- сначала зарегистрируйтесь в Центре приложений.
- Дополнительные сведения об использовании этой задачи см. в статье документации Центра приложений Использование Azure DevOps для тестирования пользовательского интерфейса.
Примеры
В этом примере тесты Espresso выполняются в приложении Android с помощью задачи «Тест Центра приложений».
steps:
- task: AppCenterTest@1
displayName: 'Espresso Test - Synchronous'
inputs:
appFile: 'Espresso/espresso-app.apk'
artifactsDirectory: '$(Build.ArtifactStagingDirectory)/AppCenterTest'
frameworkOption: espresso
espressoBuildDirectory: Espresso
serverEndpoint: 'myAppCenterServiceConnection'
appSlug: 'xplatbg1/EspressoTests'
devices: a84c93af
Требования
| Требование | Описание |
|---|---|
| Типы конвейеров | YAML, классическая сборка |
| Выполняется в | Агент, DeploymentGroup |
| Требования | Отсутствует |
| Возможности | Эта задача не удовлетворяет требованиям к последующим задачам в задании. |
| ограничения команд | Любое |
| переменные settable | Любое |
| Версия агента | 2.206.1 или более поздней версии |
| Категория задач | Тест |
| Требование | Описание |
|---|---|
| Типы конвейеров | YAML, классическая сборка |
| Выполняется в | Агент, DeploymentGroup |
| Требования | Отсутствует |
| Возможности | Эта задача не удовлетворяет требованиям к последующим задачам в задании. |
| ограничения команд | Любое |
| переменные settable | Любое |
| Версия агента | 2.144.0 или более поздней версии |
| Категория задач | Тест |
| Требование | Описание |
|---|---|
| Типы конвейеров | YAML, классическая сборка |
| Выполняется в | Агент, DeploymentGroup |
| Требования | Отсутствует |
| Возможности | Эта задача не удовлетворяет требованиям к последующим задачам в задании. |
| ограничения команд | Любое |
| переменные settable | Любое |
| Версия агента | Все поддерживаемые версии агента. |
| Категория задач | Тест |