AppCenterTest@1 – App Center-test v1-uppgift

Artikel
03/24/2025

Testa apppaket med 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.

Ingångar

appFile - filsökväg för binärt program
Indataalias: app. string. Obligatoriskt.

Den relativa sökvägen från lagringsplatsens rot till den APK- eller IPA-fil som du vill testa.

artifactsDirectory - Artifacts-katalog
Indataalias: artifactsDir. string. Obligatoriskt. Standardvärde: $(Build.ArtifactStagingDirectory)/AppCenterTest.

Anger var artefakterna som skapas av förberedelsesteget ska placeras och används av körningssteget. Den här katalogen skapas om den inte redan finns.

prepareTests - Förbereda tester
Indataalias: enablePrepare. boolean. Standardvärde: true.

När inställningen är inställd på trueförbereder den här indata testerna.

frameworkOption - Test framework
Indataalias: framework. string. Krävs när enablePrepare = true. Tillåtna värden: appium, espresso, calabash, uitest (Xamarin UI Test) xcuitest. Standardvärde: appium.

appiumBuildDirectory - Build-katalog
Indataalias: appiumBuildDir. string. Krävs när enablePrepare = true && framework = appium.

Sökvägen till katalogen med Appium-testerna.

espressoBuildDirectory - Build-katalog
Indataalias: espressoBuildDir. string. Valfritt. Använd när enablePrepare = true && framework = espresso.

Sökvägen till Espresso-utdatakatalogen.

espressoTestApkFile - Test APK-sökväg
Indataalias: espressoTestApkPath. string. Valfritt. Använd när enablePrepare = true && framework = espresso.

Sökvägen till APK-filen med Espresso-testerna. Om den inte har angetts används build-dir för att identifiera den. Ett jokertecken tillåts.

calabashProjectDirectory - Project-katalog
Indataalias: calabashProjectDir. string. Krävs när enablePrepare = true && framework = calabash.

Sökvägen till katalogen för Calabash-arbetsytan.

calabashConfigFile - gurka konfigurationsfil
string. Valfritt. Använd när enablePrepare = true && framework = calabash.

Sökvägen till Gurka-konfigurationsfilen, vanligtvis cucumber.yml.

calabashProfile - profil för att köra
string. Valfritt. Använd när enablePrepare = true && framework = calabash.

Profilen som ska köras. Det här värdet måste finnas i gurkakonfigurationsfilen.

calabashSkipConfigCheck - Hoppa över konfigurationskontrollen
boolean. Valfritt. Använd när enablePrepare = true && framework = calabash. Standardvärde: false.

När värdet är inställt på truehoppar den här indatan över konfigurationskontrollen som anges av gurkprofilen.

uiTestBuildDirectory - Build-katalog
Indataalias: uitestBuildDir. string. Krävs när enablePrepare = true && framework = uitest.

Sökvägen till katalogen med de byggda testsammansättningarna.

uitestStorePath - Store-fil
string. Valfritt. Använd när enablePrepare = true && framework = uitest.

Sökvägen till store-filen som används för att signera appen.

uiTestStorePassword - Lagra lösenord
Indataalias: uitestStorePass. string. Valfritt. Använd när enablePrepare = true && framework = uitest.

Lösenordet för store-filen som används för att signera appen. Om du vill kryptera det här värdet använder du en ny variabel med låset aktiverat på fliken Variabler.

uitestKeyAlias - Nyckelalias
string. Valfritt. Använd när enablePrepare = true && framework = uitest.

Anger det alias som identifierar det offentliga/privata nyckelpar som används i lagringsfilen.

uiTestKeyPassword - Nyckellösenord
Indataalias: uitestKeyPass. string. Valfritt. Använd när enablePrepare = true && framework = uitest.

Anger nyckellösenordet för aliaset och lagringsfilen. Om du vill kryptera det här värdet använder du en ny variabel med låset aktiverat på fliken Variabler.

uiTestToolsDirectory - Test tools directory
Indataalias: uitestToolsDir. string. Valfritt. Använd när enablePrepare = true && framework = uitest.

Sökvägen till katalogen med Xamarin UI-testverktygen som innehåller test-cloud.exe.

signInfo - signeringsinformation
string. Valfritt. Använd när framework = calabash || framework = uitest.

Signerar testservern.

xcUITestBuildDirectory - Build-katalog
Indataalias: xcuitestBuildDir. string. Valfritt. Använd när enablePrepare = true && framework = xcuitest.

Sökvägen till utdatakatalogen för bygget (vanligtvis $(ProjectDir)/Build/Products/Debug-iphoneos).

xcUITestIpaFile - Testa IPA-sökväg
Indataalias: xcuitestTestIpaPath. string. Valfritt. Använd när enablePrepare = true && framework = xcuitest.

Sökvägen till .ipa-filen med XCUITest-testerna.

prepareOptions - Ytterligare alternativ
Indataalias: prepareOpts. string. Valfritt. Använd när enablePrepare = true.

De ytterligare argument som skickas till teststeget i App Center förbereder.

runTests - Kör tester
Indataalias: enableRun. boolean. Standardvärde: true.

Kör testerna.

credentialsOption - -autentiseringsmetod
Indataalias: credsType. string. Krävs när enableRun = true. Tillåtna värden: serviceEndpoint (App Center-tjänstanslutning), inputs (autentiseringsuppgifter). Standardvärde: serviceEndpoint.

Använder App Center-tjänstanslutningen eller anger autentiseringsuppgifterna för att ansluta till Visual Studio App Center.

serverEndpoint - App Center-tjänstanslutning
string. Krävs när enableRun = true && credsType = serviceEndpoint.

Väljer tjänstanslutningen för Visual Studio App Center. Om det behövs klickar du på länken Hantera för att skapa en ny tjänstanslutning.

username - Användarnamn för App Center
string. Krävs när enableRun = true && credsType = inputs.

Skapa ditt användarnamn genom att gå till inloggningssidan för App Centeroch ange värdet här.

password - App Center-lösenord
string. Krävs när enableRun = true && credsType = inputs.

Ange ditt lösenord genom att gå till inloggningssidan för App Centeroch ange värdet här. Variabler som definieras i bygg- eller versionspipelines som $(passwordVariable) godkänns. Du kan markera variabeltypen som secret för att skydda den.

appSlug -
string. Krävs när enableRun = true.

Appsnigeln är i formatet <username>/<app_identifier>. Om du vill hitta <username> och <app_identifier> för en app klickar du på dess namn från Visual Studio App Center. Den resulterande URL:en är i formatet https://appcenter.ms/users/<username>/apps/<app_identifier>.

devices - Enheter
string. Krävs när enableRun = true.

Identifierar de enheter som testet ska köras mot. Kopiera och klistra in den här strängen när du definierar en ny testkörning från Visual Studio App Center Test beacon.

series - testserien
string. Valfritt. Använd när enableRun = true. Standardvärde: master.

Serienamnet för att organisera testkörningarna (till exempel master, produktion, beta).

dsymDirectory - dSYM-katalog
Indataalias: dsymDir. string. Valfritt. Använd när enableRun = true.

Sökvägen till iOS-symbolfilerna.

localeOption - Systemspråk
Indataalias: locale. string. Krävs när enableRun = true. Tillåtna värden: da_DK (danska (Danmark)), nl_NL (nederländska (Nederländerna)), en_GB (engelska (Storbritannien)), en_US (engelska (USA)), fr_FR (franska (Frankrike)), en_US (engelska (USA)), fr_FR (franska (Frankrike)), en_USde_DE (tyska (Tyskland)), ja_JP (japanska (Japan)), ru_RU (ryska (Ryssland)), es_MX (spanska (Mexiko)), es_ES (spanska (Spanien)), user (övrigt). Standardvärde: en_US.

Använd om ditt språk inte visas. Välj Other och ange dess nationella inställningar, till exempel en_US.

userDefinedLocale - Andra språkvarianter
string. Valfritt. Använd när enableRun = true && locale = user.

Anger valfri iso-639-språkkod med två bokstäver tillsammans med valfri ISO 3166-landskod med två bokstäver i formatet <language>_<country>, till exempel en_US.

loginOptions - Ytterligare alternativ för inloggning
Indataalias: loginOpts. string. Valfritt. Använd när enableRun = true && credsType = inputs.

De ytterligare argument som skickas till inloggningssteget för Visual Studio App Center.

runOptions - Ytterligare alternativ för körning
Indataalias: runOpts. string. Valfritt. Använd när enableRun = true.

De ytterligare argument som skickas till Visual Studio App Center-testkörningen.

skipWaitingForResults - Vänta inte på testresultatet
Indataalias: async. boolean. Valfritt. Använd när enableRun = true. Standardvärde: false.

Kör ett kommando asynkront och avslutas när testerna laddas upp utan att vänta på testresultaten.

cliFile - App Center CLI-plats
Indataalias: cliLocationOverride. string.

Sökvägen till Visual Studio App Center CLI i bygg- eller versionsagenten.

showDebugOutput - Aktivera felsökningsutdata
Indataalias: debug. boolean. Standardvärde: false.

Lägger till --debug i Visual Studio App Center CLI.

Kontrollalternativ för aktivitet

Alla aktiviteter har kontrollalternativ utöver sina aktivitetsindata. Mer information finns i Kontrollalternativ och vanliga uppgiftsegenskaper.

Utdatavariabler

Ingen.

Anmärkningar

Med den här uppgiften kan du köra testpaket mot ett binärt program (.apk eller .ipa- fil) med hjälp av App Center Test.

Registrera dig med App Center först.
Mer information om hur du använder den här uppgiften finns i App Center-dokumentationsartikeln Using Azure DevOps for UI Testing.

Exempel

Det här exemplet kör Espresso-tester på en Android-app med hjälp av App Center-testuppgiften.

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

Krav

Krav	Beskrivning
Pipelinetyper	YAML, klassisk version
Körs på	Agent, DeploymentGroup
kräver	Ingen
funktioner	Den här aktiviteten uppfyller inte några krav på efterföljande uppgifter i jobbet.
Kommandobegränsningar	Vilken som helst
variabler som kan	Vilken som helst
Agentversion	2.206.1 eller senare
Aktivitetskategori	Test

Krav	Beskrivning
Pipelinetyper	YAML, klassisk version
Körs på	Agent, DeploymentGroup
kräver	Ingen
funktioner	Den här aktiviteten uppfyller inte några krav på efterföljande uppgifter i jobbet.
Kommandobegränsningar	Vilken som helst
variabler som kan	Vilken som helst
Agentversion	2.144.0 eller senare
Aktivitetskategori	Test

Krav	Beskrivning
Pipelinetyper	YAML, klassisk version
Körs på	Agent, DeploymentGroup
kräver	Ingen
funktioner	Den här aktiviteten uppfyller inte några krav på efterföljande uppgifter i jobbet.
Kommandobegränsningar	Vilken som helst
variabler som kan	Vilken som helst
Agentversion	Alla agentversioner som stöds.
Aktivitetskategori	Test

Dela via