AppCenterTest@1 – App Center-test v1-uppgift

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.

Indata

appFile - Sökväg till binär programfil
Indataalias: app. string. Krävs.

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

artifactsDirectory - Artefaktkatalog
Indataalias: artifactsDir. string. Krävs. 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 det här värdet är inställt truepå förbereder dessa indata testerna.

frameworkOption - Testramverk
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 - Skapa katalog
Indataalias: appiumBuildDir. string. Krävs när enablePrepare = true && framework = appium.

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

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

Sökvägen till espressoutdatakatalogen.

espressoTestApkFile - Testa 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 build-dir används för att identifiera den. Jokertecken tillåts.

calabashProjectDirectory - Projektkatalog
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 gurkakonfigurationsfilen, vanligtvis cucumber.yml.

calabashProfile - Profil som ska köras
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 konfigurationskontroll
boolean. Valfritt. Använd när enablePrepare = true && framework = calabash. Standardvärde: false.

När den här inställningen är inställd truepå hoppar den här indatan över konfigurationskontrollen som anges av Gurkaprofilen.

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

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

uitestStorePath - Lagra 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 aliaset som identifierar det offentliga/privata nyckelparet som används i store-filen.

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 - Katalog för testverktyg
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 - Skapa 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 App Center-testförberedarsteget.

runTests - Köra 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änstanslutning 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 - App Center-användarnamn
string. Krävs när enableRun = true && credsType = inputs.

Skapa ditt användarnamn genom att gå till inloggningssidan för App Center och 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 Center och ange värdet här. Variabler som definieras i bygg- eller versionspipelines som $(passwordVariable) accepteras. Du kan markera variabeltypen som secret för att skydda den.

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

App-snigel ä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 har 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-testfyren.

series - Testserie
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)), de_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 nationella inställningar
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å testresultat
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 --debug till 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

Inga.

Kommentarer

Med den här uppgiften kan du köra testsviter mot en programbinär fil (.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 (Använda Azure DevOps för gränssnittstestning).

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
Krav	Ingen
Funktioner	Den här aktiviteten uppfyller inte några krav för efterföljande uppgifter i jobbet.
Kommandobegränsningar	Valfri
Inställningsbara variabler	Valfri
Agentversion	2.206.1 eller senare
Uppgiftskategori	Test