AppCenterTest@1 — zadanie testowe usługi App Center w wersji 1

Testowanie pakietów aplikacji za pomocą programu Visual Studio App Center.

Składnia

# 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 prepareTests = true. Test framework. Default: appium.
    #appiumBuildDirectory: # string. Alias: appiumBuildDir. Required when prepareTests = true && frameworkOption = appium. Build directory. 
    #espressoBuildDirectory: # string. Alias: espressoBuildDir. Optional. Use when prepareTests = true && frameworkOption = espresso. Build directory. 
    #espressoTestApkFile: # string. Alias: espressoTestApkPath. Optional. Use when prepareTests = true && frameworkOption = espresso. Test APK path. 
    #calabashProjectDirectory: # string. Alias: calabashProjectDir. Required when prepareTests = true && frameworkOption = calabash. Project directory. 
    #calabashConfigFile: # string. Optional. Use when prepareTests = true && frameworkOption = calabash. Cucumber config file. 
    #calabashProfile: # string. Optional. Use when prepareTests = true && frameworkOption = calabash. Profile to run. 
    #calabashSkipConfigCheck: false # boolean. Optional. Use when prepareTests = true && frameworkOption = calabash. Skip Configuration Check. Default: false.
    #uiTestBuildDirectory: # string. Alias: uitestBuildDir. Required when prepareTests = true && frameworkOption = uitest. Build directory. 
    #uitestStorePath: # string. Optional. Use when prepareTests = true && frameworkOption = uitest. Store file. 
    #uiTestStorePassword: # string. Alias: uitestStorePass. Optional. Use when prepareTests = true && frameworkOption = uitest. Store password. 
    #uitestKeyAlias: # string. Optional. Use when prepareTests = true && frameworkOption = uitest. Key alias. 
    #uiTestKeyPassword: # string. Alias: uitestKeyPass. Optional. Use when prepareTests = true && frameworkOption = uitest. Key password. 
    #uiTestToolsDirectory: # string. Alias: uitestToolsDir. Optional. Use when prepareTests = true && frameworkOption = uitest. Test tools directory. 
    #signInfo: # string. Optional. Use when frameworkOption = calabash || frameworkOption = uitest. Signing information. 
    #xcUITestBuildDirectory: # string. Alias: xcuitestBuildDir. Optional. Use when prepareTests = true && frameworkOption = xcuitest. Build directory. 
    #xcUITestIpaFile: # string. Alias: xcuitestTestIpaPath. Optional. Use when prepareTests = true && frameworkOption = xcuitest. Test IPA path. 
    #prepareOptions: # string. Alias: prepareOpts. Optional. Use when prepareTests = true. Additional options. 
  # Run Tests
    #runTests: true # boolean. Alias: enableRun. Run tests. Default: true.
    credentialsOption: 'serviceEndpoint' # 'serviceEndpoint' | 'inputs'. Alias: credsType. Required when runTests = true. Authentication method. Default: serviceEndpoint.
    #serverEndpoint: # string. Required when runTests = true && credentialsOption = serviceEndpoint. App Center service connection. 
    #username: # string. Required when runTests = true && credentialsOption = inputs. App Center username. 
    #password: # string. Required when runTests = true && credentialsOption = inputs. App Center password. 
    appSlug: # string. Required when runTests = true. App slug. 
    devices: # string. Required when runTests = true. Devices. 
    #series: 'master' # string. Optional. Use when runTests = true. Test series. Default: master.
    #dsymDirectory: # string. Alias: dsymDir. Optional. Use when runTests = 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 runTests = true. System language. Default: en_US.
    #userDefinedLocale: # string. Optional. Use when runTests = true && localeOption = user. Other locale. 
    #loginOptions: # string. Alias: loginOpts. Optional. Use when runTests = true && credentialsOption = inputs. Additional options for login. 
    #runOptions: # string. Alias: runOpts. Optional. Use when runTests = true. Additional options for run. 
    #skipWaitingForResults: false # boolean. Alias: async. Optional. Use when runTests = 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.

Dane wejściowe

ścieżka pliku aplikacji binarnej appFile -
Alias wejściowy: app. string. To jest wymagane.

Ścieżka względna z katalogu głównego repozytorium do pliku APK lub IPA, który chcesz przetestować.


artifactsDirectory - katalogu Artifacts
Alias wejściowy: artifactsDir. string. To jest wymagane. Wartość domyślna: $(Build.ArtifactStagingDirectory)/AppCenterTest.

Określa, gdzie należy umieścić artefakty utworzone przez krok przygotowywania i używane przez krok uruchamiania. Ten katalog zostanie utworzony, jeśli jeszcze nie istnieje.


prepareTests - przygotowywanie testów
Alias wejściowy: enablePrepare. boolean. Wartość domyślna: true.

Po ustawieniu wartości truedane wejściowe przygotowują testy.


frameworkOption - platformy testowej
Alias wejściowy: framework. string. Wymagane, gdy prepareTests = true. Dozwolone wartości: appium, espresso, calabash, uitest (Xamarin UI Test), xcuitest. Wartość domyślna: appium.


katalogu appiumBuildDirectory - Build
Alias wejściowy: appiumBuildDir. string. Wymagane, gdy prepareTests = true && frameworkOption = appium.

Ścieżka do katalogu z testami Appium.


katalogu espressoBuildDirectory - Build
Alias wejściowy: espressoBuildDir. string. Opcjonalny. Użyj polecenia , gdy prepareTests = true && frameworkOption = espresso.

Ścieżka do katalogu wyjściowego Espresso.


espressoTestApkFile - testowa ścieżka APK
Alias wejściowy: espressoTestApkPath. string. Opcjonalny. Użyj polecenia , gdy prepareTests = true && frameworkOption = espresso.

Ścieżka do pliku APK z testami Espresso. Jeśli nie zostanie ustawiona, build-dir zostanie użyta do jego odnalezienia. Symbol wieloznaczny jest dozwolony.


calabashProjectDirectory - katalog projektu
Alias wejściowy: calabashProjectDir. string. Wymagane, gdy prepareTests = true && frameworkOption = calabash.

Ścieżka do katalogu obszaru roboczego Calabash.


calabashConfigFile - pliku konfiguracji ogórka
string. Opcjonalny. Użyj polecenia , gdy prepareTests = true && frameworkOption = calabash.

Ścieżka do pliku konfiguracji Ogórka, zwykle cucumber.yml.


profil calabashProfile - do uruchamiania
string. Opcjonalny. Użyj polecenia , gdy prepareTests = true && frameworkOption = calabash.

Profil do uruchomienia. Ta wartość musi istnieć w pliku konfiguracji Ogórka.


calabashSkipConfigCheck - pomiń sprawdzanie konfiguracji
boolean. Opcjonalny. Użyj polecenia , gdy prepareTests = true && frameworkOption = calabash. Wartość domyślna: false.

Po ustawieniu wartości na truedane wejściowe pomijają sprawdzanie konfiguracji określone przez profil ogórka.


katalogu uiTestBuildDirectory - Build
Alias wejściowy: uitestBuildDir. string. Wymagane, gdy prepareTests = true && frameworkOption = uitest.

Ścieżka do katalogu z utworzonymi zestawami testowymi.


uitestStorePath - Store
string. Opcjonalny. Użyj polecenia , gdy prepareTests = true && frameworkOption = uitest.

Ścieżka do pliku ze sklepu, który jest używany do podpisywania aplikacji.


uiTestStorePassword - Przechowuj hasło
Alias wejściowy: uitestStorePass. string. Opcjonalny. Użyj polecenia , gdy prepareTests = true && frameworkOption = uitest.

Hasło pliku sklepu używanego do podpisywania aplikacji. Aby zaszyfrować tę wartość, użyj nowej zmiennej z włączoną blokadą na karcie Zmienne.


alias klucza uitestKeyAlias -
string. Opcjonalny. Użyj polecenia , gdy prepareTests = true && frameworkOption = uitest.

Określa alias identyfikujący parę kluczy publicznych/prywatnych używanych w pliku magazynu.


hasła klucza uiTestKeyPassword -
Alias wejściowy: uitestKeyPass. string. Opcjonalny. Użyj polecenia , gdy prepareTests = true && frameworkOption = uitest.

Określa hasło klucza dla aliasu i pliku magazynu. Aby zaszyfrować tę wartość, użyj nowej zmiennej z włączoną blokadą na karcie Zmienne.


katalog narzędzi uiTestToolsDirectory - testowych
Alias wejściowy: uitestToolsDir. string. Opcjonalny. Użyj polecenia , gdy prepareTests = true && frameworkOption = uitest.

Ścieżka do katalogu za pomocą narzędzi testowych interfejsu użytkownika platformy Xamarin, które zawierają test-cloud.exe.


informacje o podpisywaniu signInfo -
string. Opcjonalny. Użyj polecenia , gdy frameworkOption = calabash || frameworkOption = uitest.

Podpisuje serwer testowy.


katalogu xcUITestBuildDirectory - Build
Alias wejściowy: xcuitestBuildDir. string. Opcjonalny. Użyj polecenia , gdy prepareTests = true && frameworkOption = xcuitest.

Ścieżka do katalogu wyjściowego kompilacji (zazwyczaj $(ProjectDir)/Build/Products/Debug-iphoneos).


xcUITestIpaFile - testowa ścieżka IPA
Alias wejściowy: xcuitestTestIpaPath. string. Opcjonalny. Użyj polecenia , gdy prepareTests = true && frameworkOption = xcuitest.

Ścieżka do pliku ipa z testami XCUITest.


prepareOptions - dodatkowe opcje
Alias wejściowy: prepareOpts. string. Opcjonalny. Użyj polecenia , gdy prepareTests = true.

Dodatkowe argumenty, które są przekazywane do kroku przygotowywania testu w Centrum aplikacji.


runTests - Uruchamianie testów
Alias wejściowy: enableRun. boolean. Wartość domyślna: true.

Uruchamia testy.


metody uwierzytelniania credentialsOption -
Alias wejściowy: credsType. string. Wymagane, gdy runTests = true. Dozwolone wartości: serviceEndpoint (połączenie usługi App Center), inputs (poświadczenia). Wartość domyślna: serviceEndpoint.

Używa połączenia usługi App Center lub wprowadza poświadczenia w celu nawiązania połączenia z centrum aplikacji programu Visual Studio.


połączenia usługi serverEndpoint - App Center
string. Wymagane, gdy runTests = true && credentialsOption = serviceEndpoint.

Wybiera połączenie usługi dla programu Visual Studio App Center. W razie potrzeby kliknij link Zarządzaj, aby utworzyć nowe połączenie z usługą.


nazwa użytkownika centrum aplikacji username -
string. Wymagane, gdy runTests = true && credentialsOption = inputs.

Utwórz nazwę użytkownika, odwiedzając stronę logowania App Centeri podaj tutaj wartość.


hasła usługi password - App Center
string. Wymagane, gdy runTests = true && credentialsOption = inputs.

Ustaw hasło, odwiedzając stronę logowania App Centeri podaj tutaj wartość. Zmienne zdefiniowane w potokach kompilacji lub wydania jako $(passwordVariable) są akceptowane. Możesz oznaczyć typ zmiennej jako secret, aby go zabezpieczyć.


appSlug - Slug aplikacji
string. Wymagane, gdy runTests = true.

Slug aplikacji jest w formacie <username>/<app_identifier>. Aby zlokalizować <username> i <app_identifier> dla aplikacji, kliknij jej nazwę z programu Visual Studio App Center. Wynikowy adres URL ma format https://appcenter.ms/users/<username>/apps/<app_identifier>.


devices - Urządzeń
string. Wymagane, gdy runTests = true.

Identyfikuje urządzenia, względem których zostanie uruchomiony ten test. Skopiuj i wklej ten ciąg podczas definiowania nowego przebiegu testu z sygnału nawigacyjnego testowego programu Visual Studio App Center.


serii testów series -
string. Opcjonalny. Użyj polecenia , gdy runTests = true. Wartość domyślna: master.

Nazwa serii do organizowania przebiegów testów (na przykład master, production, beta).


katalogu dsymDirectory - dSYM
Alias wejściowy: dsymDir. string. Opcjonalny. Użyj polecenia , gdy runTests = true.

Ścieżka do plików symboli systemu iOS.


localeOption - język systemu
Alias wejściowy: locale. string. Wymagane, gdy runTests = true. Dozwolone wartości: da_DK (Duński )), nl_NL (Holenderski (Holandia)), en_GB (angielski (Wielka Brytania)), en_US (angielski (Stany Zjednoczone)), fr_FR (Francuski (Francja)de_DE), fr_FR (Niemiecki (Niemcy)), ru_RU (Japoński (Japonia)), es_MX (Rosyjski)), es_ES (Hiszpański (Meksyk)), user (Hiszpański (Hiszpania)), (inne). Wartość domyślna: en_US.

Użyj, jeśli twój język nie jest wyświetlany. Wybierz Other i wprowadź jego ustawienia regionalne, takie jak en_US.


userDefinedLocale - inne ustawienia regionalne
string. Opcjonalny. Użyj polecenia , gdy runTests = true && localeOption = user.

Wprowadza dowolny dwuliterowy kod języka ISO-639 wraz z dwuliterowym kodem kraju ISO 3166 w formacie <language>_<country>, takim jak en_US.


loginOptions - dodatkowe opcje logowania
Alias wejściowy: loginOpts. string. Opcjonalny. Użyj polecenia , gdy runTests = true && credentialsOption = inputs.

Dodatkowe argumenty przekazywane do kroku logowania w centrum aplikacji programu Visual Studio.


runOptions - dodatkowe opcje uruchamiania
Alias wejściowy: runOpts. string. Opcjonalny. Użyj polecenia , gdy runTests = true.

Dodatkowe argumenty, które są przekazywane do przebiegu testowego programu Visual Studio App Center.


skipWaitingForResults - Nie czekaj na wynik testu
Alias wejściowy: async. boolean. Opcjonalny. Użyj polecenia , gdy runTests = true. Wartość domyślna: false.

Wykonuje polecenie asynchronicznie i kończy działanie po przekazaniu testów bez oczekiwania na wyniki testu.


lokalizacji interfejsu wiersza polecenia centrum aplikacji cliFile -
Alias wejściowy: cliLocationOverride. string.

Ścieżka do interfejsu wiersza polecenia programu Visual Studio App Center w agencie kompilacji lub wydania.


showDebugOutput - Włączanie danych wyjściowych debugowania
Alias wejściowy: debug. boolean. Wartość domyślna: false.

Dodaje --debug do interfejsu wiersza polecenia programu Visual Studio App Center.


Opcje sterowania zadaniami

Wszystkie zadania mają opcje sterowania oprócz danych wejściowych zadań podrzędnych. Aby uzyskać więcej informacji, zobacz opcje kontroli i typowe właściwości zadań.

Zmienne wyjściowe

Żaden.

Uwagi

To zadanie umożliwia uruchamianie zestawów testów względem pliku binarnego aplikacji (.apk lub pliku ipa) przy użyciu narzędzia App Center Test.

Przykłady

W tym przykładzie testy Espresso są uruchamiane w aplikacji systemu Android przy użyciu zadania Test centrum aplikacji.

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

Wymagania

Wymaganie Opis
Typy potoków YAML, klasyczna kompilacja
Działa na Agent, grupa wdrożeniowa
Wymagania Żaden
możliwości To zadanie nie spełnia żadnych wymagań dotyczących kolejnych zadań w zadaniu.
ograniczenia poleceń Jakikolwiek
zmienne ustawiane Jakikolwiek
Wersja agenta 2.206.1 lub nowsza
Kategoria zadań Testowanie
Wymaganie Opis
Typy potoków YAML, klasyczna kompilacja
Działa na Agent, grupa wdrożeniowa
Wymagania Żaden
możliwości To zadanie nie spełnia żadnych wymagań dotyczących kolejnych zadań w zadaniu.
ograniczenia poleceń Jakikolwiek
zmienne ustawiane Jakikolwiek
Wersja agenta 2.144.0 lub nowsza
Kategoria zadań Testowanie
Wymaganie Opis
Typy potoków YAML, klasyczna kompilacja
Działa na Agent, grupa wdrożeniowa
Wymagania Żaden
możliwości To zadanie nie spełnia żadnych wymagań dotyczących kolejnych zadań w zadaniu.
ograniczenia poleceń Jakikolwiek
zmienne ustawiane Jakikolwiek
Wersja agenta Wszystkie obsługiwane wersje agentów.
Kategoria zadań Testowanie