AppCenterTest@1 – App Center-Test v1-Aufgabe

Artikel
03/24/2025

Testen Sie App-Pakete mit Visual Studio App Center.

Syntax

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

Eingänge

appFile - Dateipfad der binären Anwendung
Eingabealias: app. string. Erforderlich.

Der relative Pfad vom Repositorystamm zur APK- oder IPA-Datei, die Sie testen möchten.

artifactsDirectory - Artifacts-Verzeichnis
Eingabealias: artifactsDir. string. Erforderlich. Standardwert: $(Build.ArtifactStagingDirectory)/AppCenterTest.

Gibt an, wo die artefakte platziert werden sollen, die vom Vorbereitungsschritt erstellt und vom Ausführungsschritt verwendet werden. Dieses Verzeichnis wird erstellt, wenn es noch nicht vorhanden ist.

prepareTests - Vorbereiten von Tests
Eingabealias: enablePrepare. boolean. Standardwert: true.

Bei Festlegung auf truebereitet diese Eingabe die Tests vor.

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

appiumBuildDirectory - Buildverzeichnis-
Eingabealias: appiumBuildDir. string. Erforderlich, wenn enablePrepare = true && framework = appium.

Der Pfad zum Verzeichnis mit den Appium-Tests.

espressoBuildDirectory - Buildverzeichnis-
Eingabealias: espressoBuildDir. string. Wahlfrei. Wird verwendet, wenn enablePrepare = true && framework = espresso.

Der Pfad zum Ausgabeverzeichnis Espresso.

espressoTestApkFile - Test APK-Pfad
Eingabealias: espressoTestApkPath. string. Wahlfrei. Wird verwendet, wenn enablePrepare = true && framework = espresso.

Der Pfad zur APK-Datei mit den Espresso-Tests. Wenn sie nicht festgelegt ist, wird build-dir verwendet, um sie zu ermitteln. Ein Wildcard ist zulässig.

calabashProjectDirectory - Project-Verzeichnis
Eingabealias: calabashProjectDir. string. Erforderlich, wenn enablePrepare = true && framework = calabash.

Der Pfad zum Verzeichnis des Calabash-Arbeitsbereichs.

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

Der Pfad zur Cucumber-Konfigurationsdatei, in der Regel cucumber.yml.

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

Das auszuführende Profil. 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.

Wenn diese Eingabe auf truefestgelegt ist, überspringt diese Eingabe die vom Cucumber-Profil angegebene Konfigurationsüberprüfung.

uiTestBuildDirectory - Buildverzeichnis-
Eingabealias: uitestBuildDir. string. Erforderlich, wenn enablePrepare = true && framework = uitest.

Der Pfad zum Verzeichnis mit den erstellten Testassemblys.

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

Der Pfad zur Store-Datei, die zum Signieren der App verwendet wird.

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

Das Kennwort der Store-Datei, die zum Signieren der App verwendet wird. Verwenden Sie zum Verschlüsseln dieses Werts eine neue Variable mit aktivierter Sperre auf der Registerkarte "Variablen".

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.

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

Gibt das Schlüsselkennwort für den Alias und die Speicherdatei an. Verwenden Sie zum Verschlüsseln dieses Werts eine neue Variable mit aktivierter Sperre auf der Registerkarte "Variablen".

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

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

signInfo - Signieren von Informationen
string. Wahlfrei. Wird verwendet, wenn framework = calabash || framework = uitest.

Signiert den Testserver.

xcUITestBuildDirectory - Buildverzeichnis-
Eingabealias: xcuitestBuildDir. string. Wahlfrei. Wird verwendet, wenn enablePrepare = true && framework = xcuitest.

Der Pfad zum Buildausgabeverzeichnis (in der Regel $(ProjectDir)/Build/Products/Debug-iphoneos).

xcUITestIpaFile - IpA-Testpfad
Eingabealias: xcuitestTestIpaPath. string. Wahlfrei. Wird verwendet, wenn enablePrepare = true && framework = xcuitest.

Der Pfad zur IPA-Datei mit den XCUITest-Tests.

prepareOptions - Zusätzliche Optionen
Eingabealias: prepareOpts. string. Wahlfrei. Wird verwendet, wenn enablePrepare = true.

Die zusätzlichen Argumente, die an den Testschritt "App Center" übergeben werden.

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

Führt die Tests aus.

credentialsOption - Authentifizierungsmethode
Eingabealias: credsType. string. Erforderlich, wenn enableRun = true. Zulässige Werte: serviceEndpoint (App Center-Dienstverbindung), inputs (Anmeldeinformationen). Standardwert: serviceEndpoint.

Verwendet die App Center-Dienstverbindung oder gibt die Anmeldeinformationen ein, um eine Verbindung mit Visual Studio App Center herzustellen.

serverEndpoint - App Center-Dienstverbindung
string. Erforderlich, wenn enableRun = true && credsType = serviceEndpoint.

Wählt die Dienstverbindung für Visual Studio App Center aus. Klicken Sie bei Bedarf auf den Link "Verwalten", um eine neue Dienstverbindung zu erstellen.

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

Erstellen Sie Ihren Benutzernamen, indem Sie die App Center-Anmeldeseitebesuchen und hier den Wert angeben.

password - App Center-Kennwort
string. Erforderlich, wenn enableRun = true && credsType = inputs.

Legen Sie Ihr Kennwort fest, indem Sie die App Center-Anmeldeseitebesuchen und hier den Wert angeben. Variablen, die in Build- oder Releasepipelinen als $(passwordVariable) definiert sind, werden akzeptiert. Sie können den Variablentyp als secret markieren, um ihn zu sichern.

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

Die App-Slug befindet sich im Format <username>/<app_identifier>. Wenn Sie die <username> und <app_identifier> für eine App suchen möchten, klicken Sie in Visual Studio App Centerauf den Namen. Die resultierende URL befindet sich im Format https://appcenter.ms/users/<username>/apps/<app_identifier>.

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

Identifiziert die Geräte, für die dieser Test ausgeführt wird. Kopieren Sie diese Zeichenfolge, und fügen Sie sie ein, wenn Sie eine neue Testausführung über das Visual Studio App Center-Testbeacons definieren.

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

Der Serienname zum Organisieren der Testläufe (z. B. Master, Produktion, Beta).

dsymDirectory - dSYM-Verzeichnis-
Eingabealias: dsymDir. string. Wahlfrei. Wird verwendet, wenn enableRun = true.

Der Pfad zu den iOS-Symboldateien.

localeOption - Systemsprache
Eingabealias: locale. 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)), ja_JP (Japanisch (Japan)), ru_RU (Russisch (Russland)), es_MX (Spanisch (Mexiko)), es_ES (Spanien)), user (Sonstige). Standardwert: en_US.

Verwenden Sie, wenn Ihre Sprache nicht angezeigt wird. Wählen Sie Other aus, 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 buchstabenigen ISO-639-Sprachcode zusammen mit einem beliebigen zwei buchstabenigen ISO 3166-Ländercode im Format <language>_<country>ein, z. B. en_US.

loginOptions - Zusätzliche Optionen für die Anmeldung
Eingabealias: loginOpts. string. Wahlfrei. Wird verwendet, wenn enableRun = true && credsType = inputs.

Die zusätzlichen Argumente, die an den Anmeldeschritt von Visual Studio App Center übergeben werden.

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

Die zusätzlichen Argumente, die an die Testausführung von Visual Studio App Center übergeben werden.

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

Führt einen Befehl asynchron aus und beendet, wenn die Tests hochgeladen werden, ohne auf die Testergebnisse zu warten.

standort cliFile - App Center CLI
Eingabealias: cliLocationOverride. string.

Der Pfad zur Visual Studio App Center CLI für den Build- oder Release-Agent.

showDebugOutput - Debugausgabe aktivieren
Eingabealias: debug. boolean. Standardwert: false.

Fügt --debug zur Visual Studio App Center CLI hinzu.

Aufgabensteuerungsoptionen

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

Ausgabevariablen

Keiner.

Bemerkungen

Mit dieser Aufgabe können Sie Testsammlungen mit einer Anwendungs-Binärdatei (.apk oder .ipa--Datei) mit App Center Test ausführen.

Registrieren Sie sich zuerst beim App Center.
Ausführliche Informationen zur Verwendung dieser Aufgabe finden Sie im App Center-Dokumentationsartikel Verwenden von Azure DevOps für UI-Tests.

Beispiele

In diesem Beispiel werden Espresso-Tests auf einer Android-App mit der App Center-Testaufgabe ausgeführt.

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

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	2.206.1 oder höher
Vorgangskategorie	Testen

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	2.144.0 oder höher
Vorgangskategorie	Testen

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