VSMobileCenterTest@0 – Aufgabe "Mobile Center Test v0"

Artikel
03/24/2025

Verwenden Sie diese Aufgabe, um mobile App-Pakete mit Visual Studio Mobile Center zu testen.

Syntax

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

Eingänge

app - Dateipfad für binäre Anwendungen
string. Erforderlich.

Gibt den relativen Pfad vom Repositorystamm zum . APK oder . IPA-Datei, die Sie testen möchten.

artifactsDir - Artifacts Directory-
string. Erforderlich. Standardwert: $(Build.ArtifactStagingDirectory)/MobileCenterTest.

Gibt das Verzeichnis an, das die Artefakte platziert, die vom Vorbereitungsschritt erstellt und vom Ausführungsschritt verwendet werden. Das Verzeichnis wird erstellt, wenn es nicht vorhanden ist.

enablePrepare - Vorbereiten von Tests
boolean. Standardwert: true.

Wenn diese Einstellung auf truefestgelegt ist, werden Tests vorbereitet.

framework - Testframework-
string. Erforderlich, wenn enablePrepare = true. Zulässige Werte: appium, espresso, calabash, uitest (Xamarin UI Test), xcuitest. Standardwert: appium.

Gibt das Testframework an, das von der Aufgabe verwendet wird.

appiumBuildDir - Erstellen von Verzeichnis-
string. Erforderlich, wenn enablePrepare = true && framework = appium.

Gibt den Pfad zum Verzeichnis an, das Appium-Tests enthält.

espressoBuildDir - Erstellen von Verzeichnis-
string. Wahlfrei. Wird verwendet, wenn enablePrepare = true && framework = espresso.

Gibt den Pfad für das Espresso-Ausgabeverzeichnis an.

espressoTestApkPath - APK-Pfad testen
string. Wahlfrei. Wird verwendet, wenn enablePrepare = true && framework = espresso.

Gibt den Pfad zur APK-Datei mit Espresso-Tests an. Wenn kein Wert festgelegt ist, wird build-dir verwendet, um die APK-Datei zu finden. Wildcards sind zulässig.

calabashProjectDir - Project Directory-
string. Erforderlich, wenn enablePrepare = true && framework = calabash.

Gibt den Pfad für das Calabash-Arbeitsbereichsverzeichnis an.

calabashConfigFile - Cucumber Config File
string. Wahlfrei. Wird verwendet, wenn enablePrepare = true && framework = calabash.

Gibt den Dateipfad zur Cucumber-Konfigurationsdatei an, die normalerweise cucumber.ymlist.

calabashProfile - Profil zum Ausführen von
string. Wahlfrei. Wird verwendet, wenn enablePrepare = true && framework = calabash.

Gibt das auszuführende Profil an. Dieser Wert muss in der Cucumber-Konfigurationsdatei vorhanden sein.

calabashSkipConfigCheck - Konfigurationsüberprüfung überspringen
boolean. Wahlfrei. Wird verwendet, wenn enablePrepare = true && framework = calabash. Standardwert: false.

Erzwingt die Ausführung der Aufgabe ohne Cucumber-Profil.

uitestBuildDir - Erstellen von Verzeichnis-
string. Erforderlich, wenn enablePrepare = true && framework = uitest.

Gibt den Pfad zum Verzeichnis mit integrierten Testassemblys an.

uitestStoreFile - Speichern
string. Wahlfrei. Wird verwendet, wenn enablePrepare = true && framework = uitest.

Gibt den Pfad zur Speicherdatei an.

uitestStorePass - Speichern des Kennworts
string. Wahlfrei. Wird verwendet, wenn enablePrepare = true && framework = uitest.

Gibt das Kennwort für die Speicherdatei an. Verwenden Sie eine neue Variable mit aktivierter Sperre auf der Registerkarte "Variablen", um diesen Wert zu verschlüsseln.

uitestKeyAlias - Schlüsselalias
string. Wahlfrei. Wird verwendet, wenn enablePrepare = true && framework = uitest.

Gibt den Alias an, der das öffentliche/private Schlüsselpaar identifiziert, das in der Speicherdatei verwendet wird.

uitestKeyPass - Schlüsselkennwort-
string. Wahlfrei. Wird verwendet, wenn enablePrepare = true && framework = uitest.

Gibt das Schlüsselkennwort für den Alias und die Speicherdatei an. Verwenden Sie eine neue Variable mit aktivierter Sperre auf der Registerkarte "Variablen", um diesen Wert zu verschlüsseln.

uitestToolsDir - Verzeichnis "Testtools"
string. Wahlfrei. Wird verwendet, wenn enablePrepare = true && framework = uitest.

Gibt den Pfad zum Verzeichnis mit Xamarin UI-Testtools an, die test-cloud.exeenthalten.

signInfo - Signierungsinformationen
string. Wahlfrei. Wird verwendet, wenn framework = calabash || framework = uitest.

Verwendet Signaturinformationen zum Signieren des Testservers.

xcuitestBuildDir - Erstellen von Verzeichnis-
string. Wahlfrei. Wird verwendet, wenn enablePrepare = true && framework = xcuitest.

Gibt den Pfad zum Buildausgabeverzeichnis an, der normalerweise $(ProjectDir)/Build/Products/Debug-iphoneosist.

xcuitestTestIpaPath - IPA-Testpfad
string. Wahlfrei. Wird verwendet, wenn enablePrepare = true && framework = xcuitest.

Gibt den Pfad zur *.ipa Datei mit den XCUITest-Tests an.

prepareOpts - zusätzliche Optionen
string. Wahlfrei. Wird verwendet, wenn enablePrepare = true.

Gibt zusätzliche Argumente an, die an mobile-center test prepare stepübergeben werden sollen.

enableRun - Ausführen von Tests
boolean. Standardwert: true.

credsType - Authentifizierungsmethode
string. Erforderlich, wenn enableRun = true. Zulässige Werte: serviceEndpoint (Mobile Center-Verbindung), inputs (Anmeldeinformationen). Standardwert: serviceEndpoint.

Gibt die Authentifizierungsmethode an. Verwenden Sie eine Endpunktverbindung für mobiles Center, oder geben Sie Anmeldeinformationen an, um eine Verbindung mit Visual Studio Mobile Center herzustellen.

serverEndpoint - Mobile Center Connection
string. Erforderlich, wenn enableRun = true && credsType = serviceEndpoint.

Gibt den Dienstendpunkt für Ihre Visual Studio Mobile Center-Verbindung an. Um einen zu erstellen, klicken Sie auf die Link verwalten, und erstellen Sie einen neuen Dienstendpunkt.

username - Mobile Center-Benutzername
string. Erforderlich, wenn enableRun = true && credsType = inputs.

Besuchen Sie Azure Mobile Center, um Ihren Benutzernamen festzulegen.

password - Kennwort für mobiles Center
string. Erforderlich, wenn enableRun = true && credsType = inputs.

Besuchen Sie Azure Mobile Center, um Ihr Kennwort festzulegen. Diese Zeichenfolge kann eine Variable akzeptieren, die in Build-/Releasedefinitionen als $(passwordVariable)definiert ist. Sie können den Variablentyp als secret markieren, um ihn zu sichern.

appSlug - App Slug
string. Erforderlich, wenn enableRun = true.

Die App-Slug befindet sich im Format {username}/{app_identifier}. Um {username} und {app_identifier} für eine App zu finden, suchen Sie den Eintrag der App auf Azure Mobile Apps. Das Format der URL ist https://mobile.azure.com/users/{username}/apps/{app_identifier}.

devices - Geräte
string. Erforderlich, wenn enableRun = true.

Gibt an, für welche Geräte dieser Test ausgeführt wird. Kopieren Sie diese Zeichenfolge, und fügen Sie sie ein, wenn Sie eine neue Testausführung über das Mobile Center-Testbeacons definieren.

series - Testserien-
string. Wahlfrei. Wird verwendet, wenn enableRun = true. Standardwert: master.

Gibt den Reihennamen für die Organisation von Testläufen an (z. B. master, production, beta).

dsymDir - dSYM Directory-
string. Wahlfrei. Wird verwendet, wenn enableRun = true.

Gibt den Pfad zum dSYM-Verzeichnis an, das iOS-Symboldateien enthält.

locale - Systemsprache
string. Erforderlich, wenn enableRun = true. Zulässige Werte: da_DK (Dänisch (Dänemark)), nl_NL (Niederländisch (Niederlande)), en_GB (Englisch (Vereinigtes Königreich)), en_US (Englisch (Vereinigte Staaten)), fr_FR (Französisch (Frankreich)), de_DEfr_FR (Deutsch (Deutschland)), ru_RU (Japanisch (Japan)), es_MX (Russisch (Russland)), es_ES (Spanisch (Mexiko)), user (Spanien)), (Sonstige). Standardwert: en_US.

Wenn Ihre Sprache nicht angezeigt wird, geben Sie Andere an, und geben Sie das Gebietsschema ein, z. B. en_US.

userDefinedLocale - andere Gebietsschema-
string. Wahlfrei. Wird verwendet, wenn enableRun = true && locale = user.

Gibt einen beliebigen Zwei-Buchstaben-ISO-639-Sprachcode zusammen mit zwei Buchstaben ISO 3166-Ländercode im Format [language]_[country]an, z. B. en_US.

loginOpts - Addtional Options for Login
string. Wahlfrei. Wird verwendet, wenn enableRun = true && credsType = inputs.

Gibt zusätzliche Argumente an, die an mobile-center login stepübergeben werden.

runOpts - zusätzliche Optionen für die Ausführung
string. Wahlfrei. Wird verwendet, wenn enableRun = true.

Gibt zusätzliche Argumente an, die an mobile-center test runübergeben werden.

async - Warten Sie nicht auf das Testergebnis
boolean. Wahlfrei. Wird verwendet, wenn enableRun = true. Standardwert: false.

Bei Festlegung auf truewerden Befehle asynchron ausgeführt und beendet, wenn Tests hochgeladen werden, ohne auf die Testergebnisse zu warten.

cliLocationOverride - CLI-Standort für mobiles Center
string.

Gibt den Pfad zur mobile-center Befehlszeilenschnittstelle (CLI) an.

debug - Debugausgabe aktivieren
boolean. Standardwert: false.

Fügt der mobile-center Befehlszeilenschnittstelle (CLI) --debug--debug hinzu.

Aufgabensteuerungsoptionen

Alle Aufgaben verfügen zusätzlich zu ihren Aufgabeneingaben über Steuerungsoptionen. Weitere Informationen finden Sie unter Steuerelementoptionen und allgemeinen Aufgabeneigenschaften.

Ausgabevariablen

Keiner.

Anforderungen

Anforderung	BESCHREIBUNG
Pipelinetypen	YAML, klassischer Build
Läuft auf	Agent, DeploymentGroup
Anforderungen	Nichts
Funktionen	Dieser Vorgang erfüllt keine Anforderungen für nachfolgende Vorgänge im Auftrag.
Befehlseinschränkungen	Jegliche
Settable-Variablen	Jegliche
Agentversion	Alle unterstützten Agentversionen.
Vorgangskategorie	Testen

Freigeben über