AppCenterTest@1 – App Center-test v1-uppgift

Artikel
07/02/2024

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.

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

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

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

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.144.0 eller senare
Uppgiftskategori	Test

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	Alla agentversioner som stöds.
Uppgiftskategori	Testa

Dela via