VSMobileCenterTest@0 — zadanie testowe usługi Mobile Center w wersji 0

To zadanie służy do testowania pakietów aplikacji mobilnych za pomocą programu Visual Studio Mobile Center.

Składnia

# Mobile Center Test v0
# Test mobile app packages with Visual Studio Mobile Center.
- task: VSMobileCenterTest@0
  inputs:
    app: # string. Required. Binary Application File Path. 
    artifactsDir: '$(Build.ArtifactStagingDirectory)/MobileCenterTest' # string. Required. Artifacts Directory. Default: $(Build.ArtifactStagingDirectory)/MobileCenterTest.
  # Prepare Tests
    #enablePrepare: true # boolean. Prepare Tests. Default: true.
    framework: 'appium' # 'appium' | 'espresso' | 'calabash' | 'uitest' | 'xcuitest'. Required when enablePrepare = true. Test Framework. Default: appium.
    #appiumBuildDir: # string. Required when enablePrepare = true && framework = appium. Build Directory. 
    #espressoBuildDir: # string. Optional. Use when enablePrepare = true && framework = espresso. Build Directory. 
    #espressoTestApkPath: # string. Optional. Use when enablePrepare = true && framework = espresso. Test APK Path. 
    #calabashProjectDir: # string. 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.
    #uitestBuildDir: # string. Required when enablePrepare = true && framework = uitest. Build Directory. 
    #uitestStoreFile: # string. Optional. Use when enablePrepare = true && framework = uitest. Store File. 
    #uitestStorePass: # string. Optional. Use when enablePrepare = true && framework = uitest. Store Password. 
    #uitestKeyAlias: # string. Optional. Use when enablePrepare = true && framework = uitest. Key Alias. 
    #uitestKeyPass: # string. Optional. Use when enablePrepare = true && framework = uitest. Key Password. 
    #uitestToolsDir: # string. Optional. Use when enablePrepare = true && framework = uitest. Test Tools Directory. 
    #signInfo: # string. Optional. Use when framework = calabash || framework = uitest. Signing Information. 
    #xcuitestBuildDir: # string. Optional. Use when enablePrepare = true && framework = xcuitest. Build Directory. 
    #xcuitestTestIpaPath: # string. Optional. Use when enablePrepare = true && framework = xcuitest. Test IPA Path. 
    #prepareOpts: # string. Optional. Use when enablePrepare = true. Additional Options. 
  # Run Tests
    #enableRun: true # boolean. Run Tests. Default: true.
    credsType: 'serviceEndpoint' # 'serviceEndpoint' | 'inputs'. Required when enableRun = true. Authentication Method. Default: serviceEndpoint.
    #serverEndpoint: # string. Required when enableRun = true && credsType = serviceEndpoint. Mobile Center Connection. 
    #username: # string. Required when enableRun = true && credsType = inputs. Mobile Center Username. 
    #password: # string. Required when enableRun = true && credsType = inputs. Mobile 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.
    #dsymDir: # string. Optional. Use when enableRun = true. dSYM Directory. 
    locale: 'en_US' # 'da_DK' | 'nl_NL' | 'en_GB' | 'en_US' | 'fr_FR' | 'de_DE' | 'ja_JP' | 'ru_RU' | 'es_MX' | 'es_ES' | 'user'. Required when enableRun = true. System Language. Default: en_US.
    #userDefinedLocale: # string. Optional. Use when enableRun = true && locale = user. Other Locale. 
    #loginOpts: # string. Optional. Use when enableRun = true && credsType = inputs. Addtional Options for Login. 
    #runOpts: # string. Optional. Use when enableRun = true. Additional Options for Run. 
    #async: false # boolean. Optional. Use when enableRun = true. Do not wait for test result. Default: false.
  # Advanced
    #cliLocationOverride: # string. mobile-center CLI Location. 
    #debug: false # boolean. Enable Debug Output. Default: false.

Dane wejściowe

app - Ścieżka pliku aplikacji binarnej
string. Wymagane.

Określa ścieżkę względną z katalogu głównego repozytorium do . PLIK APK lub . Plik IPA, który chcesz przetestować.

artifactsDir - Katalog artefaktów
string. Wymagane. Wartość domyślna: $(Build.ArtifactStagingDirectory)/MobileCenterTest.

Określa katalog, aby umieścić artefakty generowane przez krok przygotowywania i używane przez krok uruchamiania. Katalog zostanie utworzony, jeśli nie istnieje.

enablePrepare - Przygotowywanie testów
boolean. Wartość domyślna: true.

Jeśli jest ustawiona wartość true, przygotowuje testy.

framework - Struktura testowa
string. Wymagane, gdy enablePrepare = true. Dozwolone wartości: appium, , calabashespresso, uitest (test interfejsu użytkownika platformy Xamarin), xcuitest. Wartość domyślna: appium.

Określa strukturę testową, która będzie używana przez zadanie.

appiumBuildDir - Katalog kompilacji
string. Wymagane, gdy enablePrepare = true && framework = appium.

Określa ścieżkę do katalogu zawierającego testy Appium.

espressoBuildDir - Katalog kompilacji
string. Opcjonalny. Użyj polecenia , gdy enablePrepare = true && framework = espresso.

Określa ścieżkę katalogu wyjściowego Espresso.

espressoTestApkPath - Ścieżka testowa pliku APK
string. Opcjonalny. Użyj polecenia , gdy enablePrepare = true && framework = espresso.

Określa ścieżkę do pliku APK z testami Espresso. Jeśli wartość nie jest ustawiona, build-dir zostanie użyta do znalezienia pliku APK. Symbole wieloznaczne są dozwolone.

calabashProjectDir - Katalog projektu
string. Wymagane, gdy enablePrepare = true && framework = calabash.

Określa ścieżkę katalogu obszaru roboczego Calabash.

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

Określa ścieżkę pliku do pliku konfiguracji Ogórek, który jest zwykle cucumber.yml.

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

Określa profil do uruchomienia. Ta wartość musi istnieć w pliku konfiguracji Ogórek.

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

Wymusza uruchomienie zadania bez profilu Ogórek.

uitestBuildDir - Katalog kompilacji
string. Wymagane, gdy enablePrepare = true && framework = uitest.

Określa ścieżkę do katalogu z utworzonymi zestawami testowymi.

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

Określa ścieżkę do pliku magazynu.

uitestStorePass - Przechowywanie hasła
string. Opcjonalny. Użyj polecenia , gdy enablePrepare = true && framework = uitest.

Określa hasło do pliku magazynu. Użyj nowej zmiennej z włączoną blokadą na karcie Zmienne, aby zaszyfrować tę wartość.

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

Określa alias, który identyfikuje parę kluczy publicznych/prywatnych używanych w pliku magazynu.

uitestKeyPass - Hasło klucza
string. Opcjonalny. Użyj polecenia , gdy enablePrepare = true && framework = uitest.

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

uitestToolsDir - katalog Test Tools
string. Opcjonalny. Użyj polecenia , gdy enablePrepare = true && framework = uitest.

Określa ścieżkę do katalogu za pomocą narzędzi do testowania 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.

Używa informacji podpisywania do podpisywania serwera testowego.

xcuitestBuildDir - Katalog kompilacji
string. Opcjonalny. Użyj polecenia , gdy enablePrepare = true && framework = xcuitest.

Określa ścieżkę do katalogu wyjściowego kompilacji, który jest zwykle $(ProjectDir)/Build/Products/Debug-iphoneos.

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

Określa ścieżkę do *.ipa pliku za pomocą testów XCUITest.

prepareOpts - Dodatkowe opcje
string. Opcjonalny. Użyj polecenia , gdy enablePrepare = true.

Określa dodatkowe argumenty do przekazania do mobile-center test prepare step.

enableRun - Uruchamianie testów
boolean. Wartość domyślna: true.

credsType - Metoda uwierzytelniania
string. Wymagane, gdy enableRun = true. Dozwolone wartości: serviceEndpoint (połączenie z usługą Mobile Center), inputs (poświadczenia). Wartość domyślna: serviceEndpoint.

Określa metodę uwierzytelniania. Użyj połączenia punktu końcowego usługi Mobile Center lub określ poświadczenia, aby nawiązać połączenie z programem Visual Studio Mobile Center.

serverEndpoint - Połączenie z usługą Mobile Center
string. Wymagane, gdy enableRun = true && credsType = serviceEndpoint.

Określa punkt końcowy usługi dla połączenia programu Visual Studio Mobile Center. Aby je utworzyć, kliknij link Zarządzaj i utwórz nowy punkt końcowy usługi.

username - Nazwa użytkownika centrum urządzeń przenośnych
string. Wymagane, gdy enableRun = true && credsType = inputs.

Odwiedź witrynę Azure Mobile Center , aby ustawić nazwę użytkownika.

password - Hasło centrum mobilnego
string. Wymagane, gdy enableRun = true && credsType = inputs.

Odwiedź witrynę Azure Mobile Center , aby ustawić hasło. Ten ciąg może akceptować zmienną zdefiniowaną w definicjach kompilacji/wydania jako $(passwordVariable). Możesz oznaczyć typ zmiennej tak secret , aby go zabezpieczyć.

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

Slug aplikacji jest w formacie {username}/{app_identifier}. Aby zlokalizować {username} aplikację i {app_identifier} ją znaleźć, znajdź listę aplikacji w usłudze Azure Mobile Apps. Adres URL jest w formacie https://mobile.azure.com/users/{username}/apps/{app_identifier}.

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

Określa, na których urządzeniach będzie uruchamiany ten test. Skopiuj i wklej ten ciąg podczas definiowania nowego przebiegu testu z aplikacji Mobile Center Test Beacon.

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

Określa nazwę serii do organizowania przebiegów testów (np. master, production, beta).

dsymDir - katalog dSYM
string. Opcjonalny. Użyj polecenia , gdy enableRun = true.

Określa ścieżkę do katalogu dSYM, który zawiera pliki symboli systemu iOS.

locale - Język systemu
string. Wymagane, gdy enableRun = true. Dozwolone wartości: da_DK (Duński (Dania)), nl_NL (Holenderski (Holandia)), (angielski (Zjednoczone Królestwo)), en_USen_GB (angielski (Stany Zjednoczone) fr_FR ), (francuski (Francja de_DE )), (niemiecki (Niemcy ja_JP )), (japoński (Japonia)), ru_RU (rosyjski (Rosja es_MX )), (hiszpański (Meksyk)), (hiszpański (Hiszpania)), es_ESuser (inne). Wartość domyślna: en_US.

Jeśli język nie jest wyświetlany, określ wartość Inne i wprowadź jego ustawienia regionalne, takie jak en_US.

userDefinedLocale - Inne ustawienia regionalne
string. Opcjonalny. Użyj polecenia , gdy enableRun = true && locale = user.

Określa dowolny dwuliterowy kod języka ISO-639 wraz z dwuliterowym kodem kraju ISO 3166 w formacie [language]_[country], takim jak en_US.

loginOpts - Opcje dodawania do logowania
string. Opcjonalny. Użyj polecenia , gdy enableRun = true && credsType = inputs.

Określa dodatkowe argumenty, które są przekazywane do mobile-center login step.

runOpts - Dodatkowe opcje uruchamiania
string. Opcjonalny. Użyj polecenia , gdy enableRun = true.

Określa dodatkowe argumenty, które są przekazywane do mobile-center test run.

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

W przypadku ustawienia na wartość trueprogram wykonuje polecenia asynchronicznie i kończy działanie po przekazaniu testów bez oczekiwania na wyniki testu.

cliLocationOverride - lokalizacja interfejsu wiersza polecenia centrum mobilnego
string.

Określa ścieżkę do interfejsu mobile-center wiersza polecenia (CLI).

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

Dodaje --debug do interfejsu mobile-center wiersza polecenia (CLI).

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.

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	Wszystkie obsługiwane wersje agentów.
Kategoria zadania	Testowanie