AppCenterTest@1 — задача тестирования версии 1 в Центре приложений

Тестирование пакетов приложений с помощью Центра приложений 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 - Каталог Artifacts
Входной псевдоним: artifactsDir. string. Обязательный. Значение по умолчанию: $(Build.ArtifactStagingDirectory)/AppCenterTest.

Указывает место размещения артефактов, созданных на этапе подготовки и используемых этапом выполнения. Этот каталог будет создан, если он еще не существует.

prepareTests - Подготовка тестов
Входной псевдоним: enablePrepare. boolean. Значение по умолчанию: true.

Если задано значение true, эти входные данные подготавливают тесты.

frameworkOption - Платформа тестирования
Входной псевдоним: framework. string. Требуется при .enablePrepare = true Допустимые значения: appium, espresso, uitestcalabash( тест пользовательского интерфейса Xamarin), xcuitest. Значение по умолчанию: appium.

appiumBuildDirectory - Каталог сборки
Входной псевдоним: appiumBuildDir. string. Требуется при .enablePrepare = true && framework = appium

Путь к каталогу с тестами Appium.

espressoBuildDirectory - Каталог сборки
Входной псевдоним: espressoBuildDir. string. Необязательный элемент. Используйте при enablePrepare = true && framework = espresso.

Путь к выходному каталогу Espresso.

espressoTestApkFile - Проверка пути APK
Входной псевдоним: espressoTestApkPath. string. Необязательный элемент. Используйте при enablePrepare = true && framework = espresso.

Путь к APK-файлу с тестами Espresso. Если значение не задано, build-dir используется для его обнаружения. Подстановочный знак разрешен.

calabashProjectDirectory - Каталог проекта
Входной псевдоним: 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.

Если задано значение 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 - Приложение slug
string. Требуется, если enableRun = true.

Приложение slug имеет формат <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.

Имя ряда для организации тестовых запусков (например, master, рабочая, бета-версия).

dsymDirectory - Каталог dSYM
Входной псевдоним: dsymDir. string. Необязательный элемент. Используйте при enableRun = true.

Путь к файлам символов iOS.

localeOption - Язык системы
Входной псевдоним: 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.

Используйте , если язык не отображается. Выберите 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 - Расположение cli центра приложений
Входной псевдоним: cliLocationOverride. string.

Путь к интерфейсу командной строки Центра приложений Visual Studio в агенте сборки или выпуска.

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

Добавляет --debug в интерфейс командной строки Центра приложений Visual Studio.

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

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

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

Нет.

Remarks

Эта задача позволяет выполнять наборы тестов для двоичного файла приложения (.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
Требования	None
Capabilities	Эта задача не удовлетворяет требованиям для последующих задач в задании.
Ограничения команд	Любой
Устанавливаемые переменные	Любой
Версия агента	2.206.1 или более поздней версии
Категория задач	Тест