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

Dane wejściowe

appFile - Ścieżka pliku aplikacji binarnej
Alias wejściowy: app. string. Wymagane.

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

artifactsDirectory - Katalog artefaktów
Alias wejściowy: artifactsDir. string. Wymagane. Wartość domyślna: $(Build.ArtifactStagingDirectory)/AppCenterTest.

Określa, gdzie należy umieścić artefakty utworzone przez krok przygotowywania i używane przez krok przebiegu. 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 true, te dane wejściowe przygotowują testy.

frameworkOption - Struktura testowa
Alias wejściowy: framework. string. Wymagane, gdy enablePrepare = true. Dozwolone wartości: appium, , espresso, uitestcalabash(Xamarin UI Test), xcuitest. Wartość domyślna: appium.

appiumBuildDirectory - Katalog kompilacji
Alias wejściowy: appiumBuildDir. string. Wymagane, gdy enablePrepare = true && framework = appium.

Ścieżka do katalogu z testami Appium.

espressoBuildDirectory - Katalog kompilacji
Alias wejściowy: espressoBuildDir. string. Opcjonalny. Użyj polecenia , gdy enablePrepare = true && framework = espresso.

Ścieżka do katalogu wyjściowego Espresso.

espressoTestApkFile - Testowanie ścieżki apk
Alias wejściowy: espressoTestApkPath. string. Opcjonalny. Użyj polecenia , gdy enablePrepare = true && framework = 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 enablePrepare = true && framework = calabash.

Ścieżka do katalogu obszaru roboczego Calabash.

calabashConfigFile - Plik konfiguracji ogórka
string. Opcjonalny. Użyj polecenia , gdy enablePrepare = true && framework = calabash.

Ścieżka do pliku konfiguracji ogórek, zwykle cucumber.yml.

calabashProfile - Profil do uruchomienia
string. Opcjonalny. Użyj polecenia , gdy enablePrepare = true && framework = calabash.

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

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

Po ustawieniu wartości true, te dane wejściowe pomijają sprawdzanie konfiguracji określone przez profil ogórka.

uiTestBuildDirectory - Katalog kompilacji
Alias wejściowy: uitestBuildDir. string. Wymagane, gdy enablePrepare = true && framework = uitest.

Ścieżka do katalogu z utworzonymi zestawami testowymi.

uitestStorePath - Zapisz plik
string. Opcjonalny. Użyj polecenia , gdy enablePrepare = true && framework = uitest.

Ścieżka do pliku sklepu używanego do podpisywania aplikacji.

uiTestStorePassword - Przechowywanie hasła
Alias wejściowy: uitestStorePass. string. Opcjonalny. Użyj polecenia , gdy enablePrepare = true && framework = 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.

uitestKeyAlias - Alias klucza
string. Opcjonalny. Użyj polecenia , gdy enablePrepare = true && framework = uitest.

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

uiTestKeyPassword - Hasło klucza
Alias wejściowy: uitestKeyPass. string. Opcjonalny. Użyj polecenia , gdy enablePrepare = true && framework = 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.

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

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

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

Podpisuje serwer testowy.

xcUITestBuildDirectory - Katalog kompilacji
Alias wejściowy: xcuitestBuildDir. string. Opcjonalny. Użyj polecenia , gdy enablePrepare = true && framework = xcuitest.

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

xcUITestIpaFile - Testowanie ścieżki IPA
Alias wejściowy: xcuitestTestIpaPath. string. Opcjonalny. Użyj polecenia , gdy enablePrepare = true && framework = xcuitest.

Ścieżka do pliku ipa z testami XCUITest.

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

Dodatkowe argumenty, które są przekazywane do kroku przygotowywania testu usługi App Center.

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

Uruchamia testy.

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

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

serverEndpoint - Połączenie usługi App Center
string. Wymagane, gdy enableRun = true && credsType = 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ą.

username - Nazwa użytkownika centrum aplikacji
string. Wymagane, gdy enableRun = true && credsType = inputs.

Utwórz swoją nazwę użytkownika, odwiedzając stronę logowania w Centrum aplikacji i podaj tutaj wartość.

password - Hasło usługi App Center
string. Wymagane, gdy enableRun = true && credsType = inputs.

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

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

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

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

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

series - Seria testowa
string. Opcjonalny. Użyj polecenia , gdy enableRun = true. Wartość domyślna: master.

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

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

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

localeOption - Język systemu
Alias wejściowy: locale. string. Wymagane, gdy enableRun = true. Dozwolone wartości: da_DK (Duński (Dania)), nl_NL (Holenderski (Holandia)), (angielski (Wielka Brytania)), en_GBen_US (angielski (Stany Zjednoczone)), fr_FR (francuski (Francja)), de_DE (niemiecki (Niemcy ja_JP )), (japoński (Japonia)), (rosyjski (Rosja)), ru_RUes_MX (hiszpański (Meksyk)), es_ES (hiszpański (Hiszpania)), user (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 enableRun = true && locale = 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 enableRun = true && credsType = inputs.

Dodatkowe argumenty przekazywane do kroku logowania programu Visual Studio App Center.

runOptions - Dodatkowe opcje uruchamiania
Alias wejściowy: runOpts. string. Opcjonalny. Użyj polecenia , gdy enableRun = 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 enableRun = true. Wartość domyślna: false.

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

cliFile - Lokalizacja interfejsu wiersza polecenia usługi App Center
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 zadania

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

Zmienne wyjściowe

Brak.

Uwagi

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

• Najpierw zarejestruj się w usłudze App Center .
• Aby uzyskać szczegółowe informacje na temat korzystania z tego zadania, zobacz artykuł App Center documentation Using Azure DevOps for UI Testing (Korzystanie z usługi Azure DevOps na potrzeby testowania interfejsu użytkownika).

Przykłady

W tym przykładzie testy Espresso są uruchamiane w aplikacji dla 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, kompilacja klasyczna
Działa na	Agent, DeploymentGroup
Wymagania	Brak
Możliwości	To zadanie nie spełnia żadnych wymagań dotyczących kolejnych zadań w zadaniu.
Ograniczenia poleceń	Dowolne
Zmienne w formie tabeli settable	Dowolne
Wersja agenta	2.206.1 lub nowsza
Kategoria zadania	Testowanie