AppCenterTest@1 – App Center-Testtask v1

Hiermit werden App-Pakete mit Visual Studio App Center getestet.

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.

Eingaben

appFile - Binäranwendungsdateipfad
Eingabealias: app. string. Erforderlich.

Der relative Pfad vom Repositorystamm zu der 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.

Wenn diese Eingabe auf truefestgelegt ist, werden die Tests vorbereitet.

frameworkOption - Testframework
Eingabealias: framework. string. Erforderlich, wenn enablePrepare = true. Zulässige Werte: appium, espresso, uitestcalabash(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. Optional. Verwenden Sie , wenn enablePrepare = true && framework = espresso.

Der Pfad zum Espresso-Ausgabeverzeichnis.

espressoTestApkFile - Testen des APK-Pfads
Eingabealias: espressoTestApkPath. string. Optional. Verwenden Sie , wenn enablePrepare = true && framework = espresso.

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

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

Der Pfad zum Calabash-Arbeitsbereichsverzeichnis.

calabashConfigFile - Gurkenkonfigurationsdatei
string. Optional. Verwenden Sie , wenn enablePrepare = true && framework = calabash.

Der Pfad zur Cucumber-Konfigurationsdatei, normalerweise cucumber.yml.

calabashProfile - Auszuführende Profile
string. Optional. Verwenden Sie , wenn enablePrepare = true && framework = calabash.

Das auszuführende Profil. Dieser Wert muss in der Cucumber-Konfigurationsdatei vorhanden sein.

calabashSkipConfigCheck - Konfigurationsprüfung überspringen
boolean. Optional. Verwenden Sie , wenn enablePrepare = true && framework = calabash. Standardwert. false.

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

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

Der Pfad zum Verzeichnis mit den erstellten Testassemblys.

uitestStorePath - Datei speichern
string. Optional. Verwenden Sie , wenn enablePrepare = true && framework = uitest.

Der Pfad zu der Speicherdatei, die zum Signieren der App verwendet wird.

uiTestStorePassword - Kennwort speichern
Eingabealias: uitestStorePass. string. Optional. Verwenden Sie , wenn enablePrepare = true && framework = uitest.

Das Kennwort der Speicherdatei, 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. Optional. Verwenden Sie , 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. Optional. Verwenden Sie , 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. Optional. Verwenden Sie , wenn enablePrepare = true && framework = uitest.

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

signInfo - Signaturinformationen
string. Optional. Verwenden Sie , wenn framework = calabash || framework = uitest.

Signiert den Testserver.

xcUITestBuildDirectory - Buildverzeichnis
Eingabealias: xcuitestBuildDir. string. Optional. Verwenden Sie , wenn enablePrepare = true && framework = xcuitest.

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

xcUITestIpaFile - Testen des IPA-Pfads
Eingabealias: xcuitestTestIpaPath. string. Optional. Verwenden Sie , wenn enablePrepare = true && framework = xcuitest.

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

prepareOptions - Zusätzliche Optionen
Eingabealias: prepareOpts. string. Optional. Verwenden Sie , wenn enablePrepare = true.

Die zusätzlichen Argumente, die an den App Center-Testvorbereitungsschritt ü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 Service-Verbindung), 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 Service-Verbindung
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-Anmeldeseite besuchen, und geben Sie den Wert hier an.

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

Legen Sie Ihr Kennwort fest, indem Sie die App Center-Anmeldeseite besuchen, und geben Sie den Wert hier an. In Build- oder Releasepipelines $(passwordVariable) definierte Variablen werden akzeptiert. Sie können den Variablentyp als secret zum Sichern markieren.

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

Der App-Slug hat das Format von <username>/<app_identifier>. Um nach und <username><app_identifier> für eine App zu suchen, klicken Sie im Visual Studio App Center auf dessen Namen. Die resultierende URL hat das Format https://appcenter.ms/users/<username>/apps/<app_identifier>.

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

Gibt die Geräte an, auf denen 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 Test Beacon definieren.

series - Testreihen
string. Optional. Verwenden Sie , wenn enableRun = true. Standardwert. master.

Der Serienname für die Organisation der Testläufe (z. B. master, Produktion, Beta).

dsymDirectory - Verzeichnis "dSYM"
Eingabealias: dsymDir. string. Optional. Verwenden Sie , 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 (USA)), fr_FR (Französisch (Frankreich)), de_DE (Deutsch (Deutschland)), ja_JP (Japanisch (Japan)), ru_RU (Russisch (Russland)), es_MX (Spanisch (Mexiko)), es_ES (Spanisch (Spanien)), user (Sonstige). Standardwert. en_US.

Verwenden Sie, wenn Ihre Sprache nicht angezeigt wird. Wählen Sie das Gebietsschema aus Other , und geben Sie es ein, z. B en_US. .

userDefinedLocale - Andere Gebietsschemas
string. Optional. Verwenden Sie , wenn enableRun = true && locale = user.

Gibt einen beliebigen ZWEI-Buchstaben-ISO-639-Sprachcode zusammen mit einem beliebigen ZWEI-Buchstaben-ISO 3166-Ländercode im Format <language>_<country>ein, z en_US. B. .

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

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

runOptions - Zusätzliche Optionen für die Ausführung
Eingabealias: runOpts. string. Optional. Verwenden Sie , wenn enableRun = true.

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

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

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

cliFile - Standort der App Center-CLI
Eingabealias: cliLocationOverride. string.

Der Pfad zur Visual Studio App Center CLI auf dem Build- oder Release-Agent.

showDebugOutput - Aktivieren der Debugausgabe
Eingabealias: debug. boolean. Standardwert. false.

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

Optionen für die Vorgangskontrolle

Alle Vorgänge verfügen zusätzlich zu ihren Eingaben über Steuerungsoptionen. Weitere Informationen finden Sie unter Steuerungsoptionen und allgemeine Aufgabeneigenschaften.

Ausgabevariablen

Keine.

Hinweise

Mit dieser Aufgabe können Sie Testsammlungen für eine Anwendungsbinärdatei (.apk - oder IPA-Datei ) mithilfe von App Center Test ausführen.

• Zuerst registrieren Sie sich bei 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 für eine Android-App mithilfe des App Center-Testtasks 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
Wird ausgeführt auf	Agent, DeploymentGroup
Forderungen	Keine
Capabilities	Diese Aufgabe erfüllt keine Anforderungen an nachfolgende Aufgaben im Auftrag.
Befehlseinschränkungen	Any
Einstellbare Variablen	Any
Agent-Version	2.206.1 oder höher
Aufgabenkategorie	Test