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 prepareTests = true. Test framework. Default: appium.
    #appiumBuildDirectory: # string. Alias: appiumBuildDir. Required when prepareTests = true && frameworkOption = appium. Build directory. 
    #espressoBuildDirectory: # string. Alias: espressoBuildDir. Optional. Use when prepareTests = true && frameworkOption = espresso. Build directory. 
    #espressoTestApkFile: # string. Alias: espressoTestApkPath. Optional. Use when prepareTests = true && frameworkOption = espresso. Test APK path. 
    #calabashProjectDirectory: # string. Alias: calabashProjectDir. Required when prepareTests = true && frameworkOption = calabash. Project directory. 
    #calabashConfigFile: # string. Optional. Use when prepareTests = true && frameworkOption = calabash. Cucumber config file. 
    #calabashProfile: # string. Optional. Use when prepareTests = true && frameworkOption = calabash. Profile to run. 
    #calabashSkipConfigCheck: false # boolean. Optional. Use when prepareTests = true && frameworkOption = calabash. Skip Configuration Check. Default: false.
    #uiTestBuildDirectory: # string. Alias: uitestBuildDir. Required when prepareTests = true && frameworkOption = uitest. Build directory. 
    #uitestStorePath: # string. Optional. Use when prepareTests = true && frameworkOption = uitest. Store file. 
    #uiTestStorePassword: # string. Alias: uitestStorePass. Optional. Use when prepareTests = true && frameworkOption = uitest. Store password. 
    #uitestKeyAlias: # string. Optional. Use when prepareTests = true && frameworkOption = uitest. Key alias. 
    #uiTestKeyPassword: # string. Alias: uitestKeyPass. Optional. Use when prepareTests = true && frameworkOption = uitest. Key password. 
    #uiTestToolsDirectory: # string. Alias: uitestToolsDir. Optional. Use when prepareTests = true && frameworkOption = uitest. Test tools directory. 
    #signInfo: # string. Optional. Use when frameworkOption = calabash || frameworkOption = uitest. Signing information. 
    #xcUITestBuildDirectory: # string. Alias: xcuitestBuildDir. Optional. Use when prepareTests = true && frameworkOption = xcuitest. Build directory. 
    #xcUITestIpaFile: # string. Alias: xcuitestTestIpaPath. Optional. Use when prepareTests = true && frameworkOption = xcuitest. Test IPA path. 
    #prepareOptions: # string. Alias: prepareOpts. Optional. Use when prepareTests = true. Additional options. 
  # Run Tests
    #runTests: true # boolean. Alias: enableRun. Run tests. Default: true.
    credentialsOption: 'serviceEndpoint' # 'serviceEndpoint' | 'inputs'. Alias: credsType. Required when runTests = true. Authentication method. Default: serviceEndpoint.
    #serverEndpoint: # string. Required when runTests = true && credentialsOption = serviceEndpoint. App Center service connection. 
    #username: # string. Required when runTests = true && credentialsOption = inputs. App Center username. 
    #password: # string. Required when runTests = true && credentialsOption = inputs. App Center password. 
    appSlug: # string. Required when runTests = true. App slug. 
    devices: # string. Required when runTests = true. Devices. 
    #series: 'master' # string. Optional. Use when runTests = true. Test series. Default: master.
    #dsymDirectory: # string. Alias: dsymDir. Optional. Use when runTests = 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 runTests = true. System language. Default: en_US.
    #userDefinedLocale: # string. Optional. Use when runTests = true && localeOption = user. Other locale. 
    #loginOptions: # string. Alias: loginOpts. Optional. Use when runTests = true && credentialsOption = inputs. Additional options for login. 
    #runOptions: # string. Alias: runOpts. Optional. Use when runTests = true. Additional options for run. 
    #skipWaitingForResults: false # boolean. Alias: async. Optional. Use when runTests = 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 - Ramverk för provning
Indataalias: framework. string. Krävs när prepareTests = 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 prepareTests = true && frameworkOption = appium.

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

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

Sökvägen till Espresso-utdatakatalogen.

espressoTestApkFile - Test APK-sökväg
Indataalias: espressoTestApkPath. string. Valfritt. Använd när prepareTests = true && frameworkOption = 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 prepareTests = true && frameworkOption = calabash.

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

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

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

calabashProfile - profil för att köra
string. Valfritt. Använd när prepareTests = true && frameworkOption = 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 prepareTests = true && frameworkOption = 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 prepareTests = true && frameworkOption = uitest.

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

uitestStorePath - Store-fil
string. Valfritt. Använd när prepareTests = true && frameworkOption = 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 prepareTests = true && frameworkOption = 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 prepareTests = true && frameworkOption = 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 prepareTests = true && frameworkOption = 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 över testverktyg
Indataalias: uitestToolsDir. string. Valfritt. Använd när prepareTests = true && frameworkOption = uitest.

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

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

Signerar testservern.

xcUITestBuildDirectory - Build-katalog
Indataalias: xcuitestBuildDir. string. Valfritt. Använd när prepareTests = true && frameworkOption = 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 prepareTests = true && frameworkOption = xcuitest.

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

prepareOptions - Ytterligare alternativ
Indataalias: prepareOpts. string. Valfritt. Använd när prepareTests = 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 runTests = 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 runTests = true && credentialsOption = 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 runTests = true && credentialsOption = 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 runTests = true && credentialsOption = 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 runTests = 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 runTests = 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 runTests = 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 runTests = true.

Sökvägen till iOS-symbolfilerna.

localeOption - Systemspråk
Indataalias: locale. string. Krävs när runTests = 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_USes_MX (tyska (Tyskland)), es_ES (japanska (Japan)), user (ryska (Ryssland)), (spanska (Mexiko)), (spanska (Spanien)), (ö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 runTests = true && localeOption = 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 runTests = true && credentialsOption = 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 runTests = 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 runTests = 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

Feedback

Var den här sidan till hjälp?

Last updated on 2026-09-23