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

Artykuł
03/24/2025

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

ś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 enablePrepare = 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 enablePrepare = true && framework = appium.

Ścieżka do katalogu z testami Appium.

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

Ścieżka do katalogu wyjściowego Espresso.

espressoTestApkFile - testowa ścieżka 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 - pliku konfiguracji ogórka
string. Opcjonalny. Użyj polecenia , gdy enablePrepare = true && framework = calabash.

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

profil calabashProfile - do uruchamiania
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 na truedane wejściowe pomijają sprawdzanie konfiguracji określone przez profil ogórka.

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

Ścieżka do katalogu z utworzonymi zestawami testowymi.

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

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

uiTestStorePassword - Store password
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.

alias klucza uitestKeyAlias -
string. Opcjonalny. Użyj polecenia , gdy enablePrepare = true && framework = 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 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.

katalog narzędzi uiTestToolsDirectory - 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.

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

Podpisuje serwer testowy.

katalogu xcUITestBuildDirectory - Build
Alias wejściowy: xcuitestBuildDir. string. Opcjonalny. Użyj polecenia , gdy enablePrepare = true && framework = 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 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 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 enableRun = 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 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ą.

nazwa użytkownika centrum aplikacji username -
string. Wymagane, gdy enableRun = true && credsType = 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 enableRun = true && credsType = 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 - App slug
string. Wymagane, gdy enableRun = 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 - Devices
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 testu z sygnału nawigacyjnego testowego programu Visual Studio App Center.

serii testów series -
string. Opcjonalny. Użyj polecenia , gdy enableRun = 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 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 )), nl_NL (Holenderski (Holandia)), en_GB (angielski (Wielka Brytania)), en_US (angielski (Stany Zjednoczone)), fr_FR (Francuski (Francja)de_DE), fr_FR (Niemiecki (Niemcy)), ja_JP (Japoński (Japonia)), ru_RU (Rosyjski)), es_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 w centrum aplikacji programu Visual Studio.

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.

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.

najpierw utwórz konto w centrum aplikacji.
Aby uzyskać szczegółowe informacje na temat korzystania z tego zadania, zobacz artykuł z dokumentacją usługi App Center Using Azure DevOps for UI Testing.

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, DeploymentGroup
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, DeploymentGroup
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, DeploymentGroup
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

Udostępnij za pośrednictwem