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
. To jest wymagane.
Określa ścieżkę względną z katalogu głównego repozytorium do . APK lub . Plik IPA, który chcesz przetestować.
katalogu artefaktów artifactsDir
-
string
. To jest wymagane. Wartość domyślna: $(Build.ArtifactStagingDirectory)/MobileCenterTest
.
Określa katalog, aby umieścić artefakty, które są 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 ustawiono wartość true
, przygotowuje testy.
framework
-
Test Framework
string
. Wymagane, gdy enablePrepare = true
. Dozwolone wartości: appium
, espresso
, calabash
, uitest
(Xamarin UI Test), xcuitest
. Wartość domyślna: appium
.
Określa platformę testową, która będzie używana przez zadanie.
appiumBuildDir
-
katalogu kompilacji
string
. Wymagane, gdy enablePrepare = true && framework = appium
.
Określa ścieżkę do katalogu zawierającego testy Appium.
espressoBuildDir
-
katalogu kompilacji
string
. Opcjonalny. Użyj polecenia , gdy enablePrepare = true && framework = espresso
.
Określa ścieżkę katalogu wyjściowego Espresso.
espressoTestApkPath
-
testowej ścieżki 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
służy do znajdowania pliku APK. Symbole wieloznaczne są dozwolone.
katalogu projektów calabashProjectDir
-
string
. Wymagane, gdy enablePrepare = true && framework = calabash
.
Określa ścieżkę katalogu obszaru roboczego Calabash.
calabashConfigFile
-
pliku konfiguracji ogórka
string
. Opcjonalny. Użyj polecenia , gdy enablePrepare = true && framework = calabash
.
Określa ścieżkę pliku do pliku konfiguracji Ogórka, który jest zwykle cucumber.yml
.
profil calabashProfile
- do uruchamiania
string
. Opcjonalny. Użyj polecenia , gdy enablePrepare = true && framework = calabash
.
Określa 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
.
Zmusza zadanie do uruchomienia bez profilu Ogórka.
uitestBuildDir
-
katalogu kompilacji
string
. Wymagane, gdy enablePrepare = true && framework = uitest
.
Określa ścieżkę do katalogu z utworzonymi zestawami testowymi.
uitestStoreFile
-
Store File
string
. Opcjonalny. Użyj polecenia , gdy enablePrepare = true && framework = uitest
.
Określa ścieżkę do pliku magazynu.
uitestStorePass
-
Store Password
string
. Opcjonalny. Użyj polecenia , gdy enablePrepare = true && framework = uitest
.
Określa hasło dla 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 identyfikujący parę kluczy publicznych/prywatnych używanych w pliku magazynu.
hasła klucza uitestKeyPass
-
string
. Opcjonalny. Użyj polecenia , gdy enablePrepare = true && framework = uitest
.
Określa hasło klucza dla aliasu i pliku magazynu. Użyj nowej zmiennej z włączoną blokadą na karcie Zmienne, aby zaszyfrować tę wartość.
uitestToolsDir
-
Narzędzia testowe
string
. Opcjonalny. Użyj polecenia , gdy enablePrepare = true && framework = uitest
.
Określa ścieżkę 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
.
Używa informacji podpisywania do podpisywania serwera testowego.
xcuitestBuildDir
-
katalogu 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
-
testowa ścieżka IPA
string
. Opcjonalny. Użyj polecenia , gdy enablePrepare = true && framework = xcuitest
.
Określa ścieżkę do pliku *.ipa
z testami 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
.
metody uwierzytelniania credsType
-
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.
połączenia serverEndpoint
- 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 go utworzyć, kliknij link Zarządzaj i utwórz nowy punkt końcowy usługi.
nazwy użytkownika username
- Mobile Center
string
. Wymagane, gdy enableRun = true && credsType = inputs
.
Odwiedź witrynę Azure Mobile Center, aby ustawić nazwę użytkownika.
haseł password
- Mobile Center
string
. Wymagane, gdy enableRun = true && credsType = inputs
.
Aby ustawić hasło, odwiedź Azure Mobile Center. Ten ciąg może akceptować zmienną zdefiniowaną w definicjach kompilacji/wydania jako $(passwordVariable)
. 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, znajdź listę aplikacji w witrynie Azure Mobile Apps. Adres URL jest w formacie https://mobile.azure.com/users/{username}/apps/{app_identifier}
.
devices
-
Devices
string
. Wymagane, gdy enableRun = true
.
Określa urządzenia, względem których będzie uruchamiany ten test. Skopiuj i wklej ten ciąg podczas definiowania nowego przebiegu testu z aplikacji Mobile Center Test Beacon.
serii testów series
-
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
).
katalogu dsymDir
- dSYM
string
. Opcjonalny. Użyj polecenia , gdy enableRun = true
.
Określa ścieżkę do katalogu dSYM, który zawiera pliki symboli systemu iOS.
języka systemu 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)), ru_RU
(Japoński (Japonia)), es_MX
(Rosyjski)), es_ES
(Hiszpański (Meksyk)), user
(Hiszpański (Hiszpania)), (inne). Wartość domyślna: en_US
.
Jeśli język nie jest wyświetlany, określ Inne i wprowadź jego ustawienia regionalne, takie jak en_US
.
userDefinedLocale
-
innych ustawień regionalnych
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
.
Opcje dodawania loginOpts
- logowania
string
. Opcjonalny. Użyj polecenia , gdy enableRun = true && credsType = inputs
.
Określa dodatkowe argumenty przekazywane do mobile-center login step
.
runOpts
-
dodatkowe opcje uruchamiania
string
. Opcjonalny. Użyj polecenia , gdy enableRun = true
.
Określa dodatkowe argumenty przekazywane do mobile-center test run
.
async
-
Nie czekaj na wynik testu
boolean
. Opcjonalny. Użyj polecenia , gdy enableRun = true
. Wartość domyślna: false
.
Po ustawieniu wartości na true
program wykonuje polecenia asynchronicznie i kończy działanie, gdy testy są przekazywane bez oczekiwania na wyniki testu.
cliLocationOverride
-
lokalizacji interfejsu wiersza polecenia centrum mobilnego
string
.
Określa ścieżkę do interfejsu wiersza polecenia (CLI) mobile-center
.
debug
-
włączanie danych wyjściowych debugowania
boolean
. Wartość domyślna: false
.
Dodaje --debug
do interfejsu wiersza polecenia (CLI) mobile-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.
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 | Wszystkie obsługiwane wersje agentów. |
Kategoria zadań | Testowanie |