AppCenterTest@1 – testovací úloha App Center v1

Článek
07/02/2024

Testování balíčků aplikací pomocí Centra aplikací sady Visual Studio

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.

Vstupy

appFile - Cesta k binárnímu souboru aplikace
Vstupní alias: app. string. Povinná hodnota.

Relativní cesta z kořene úložiště k souboru APK nebo IPA, který chcete otestovat.

artifactsDirectory - Adresář artefaktů
Vstupní alias: artifactsDir. string. Povinná hodnota. Výchozí hodnota: $(Build.ArtifactStagingDirectory)/AppCenterTest.

Určuje, kam se mají umístit artefakty vytvořené v kroku přípravy a použité v kroku spuštění. Tento adresář se vytvoří, pokud ještě neexistuje.

prepareTests - Příprava testů
Vstupní alias: enablePrepare. boolean. Výchozí hodnota: true.

Při nastavení na true, tento vstup připraví testy.

frameworkOption - Testovací architektura
Vstupní alias: framework. string. Vyžaduje se, když enablePrepare = true. Povolené hodnoty: appium, espresso, calabash, uitest (test uživatelského rozhraní Xamarinu), xcuitest. Výchozí hodnota: appium.

appiumBuildDirectory - Adresář sestavení
Vstupní alias: appiumBuildDir. string. Vyžaduje se, když enablePrepare = true && framework = appium.

Cesta k adresáři s testy Appium.

espressoBuildDirectory - Adresář sestavení
Vstupní alias: espressoBuildDir. string. Nepovinný parametr. Použijte, když enablePrepare = true && framework = espresso.

Cesta k výstupnímu adresáři Espresso.

espressoTestApkFile - Test cesty APK
Vstupní alias: espressoTestApkPath. string. Nepovinný parametr. Použijte, když enablePrepare = true && framework = espresso.

Cesta k souboru APK s testy Espresso. Pokud není nastavená, build-dir použije se k jeho zjištění. Zástupný znak je povolený.

calabashProjectDirectory - Adresář projektu
Vstupní alias: calabashProjectDir. string. Vyžaduje se, když enablePrepare = true && framework = calabash.

Cesta k adresáři pracovního prostoru Calabash.

calabashConfigFile - Konfigurační soubor okurky
string. Nepovinný parametr. Použijte, když enablePrepare = true && framework = calabash.

Cesta ke konfiguračnímu souboru Okurka, obvykle cucumber.yml.

calabashProfile - Profil, který se má spustit
string. Nepovinný parametr. Použijte, když enablePrepare = true && framework = calabash.

Profil, který se má spustit. Tato hodnota musí existovat v konfiguračním souboru Okurka.

calabashSkipConfigCheck - Přeskočit kontrolu konfigurace
boolean. Nepovinný parametr. Použijte, když enablePrepare = true && framework = calabash. Výchozí hodnota: false.

Při nastavení na truehodnotu tento vstup přeskočí kontrolu konfigurace určenou profilem Okurka.

uiTestBuildDirectory - Adresář sestavení
Vstupní alias: uitestBuildDir. string. Vyžaduje se, když enablePrepare = true && framework = uitest.

Cesta k adresáři s sestavenými testovacími sestaveními.

uitestStorePath - Uložit soubor
string. Nepovinný parametr. Použijte, když enablePrepare = true && framework = uitest.

Cesta k souboru úložiště, který se používá k podepsání aplikace.

uiTestStorePassword - Uložit heslo
Vstupní alias: uitestStorePass. string. Nepovinný parametr. Použijte, když enablePrepare = true && framework = uitest.

Heslo souboru úložiště, který se používá k podepsání aplikace. Pokud chcete tuto hodnotu zašifrovat, použijte novou proměnnou s povoleným zámkem na kartě Proměnné.

uitestKeyAlias - Alias klíče
string. Nepovinný parametr. Použijte, když enablePrepare = true && framework = uitest.

Určuje alias, který identifikuje pár veřejného a privátního klíče, který se používá v souboru úložiště.

uiTestKeyPassword - Heslo klíče
Vstupní alias: uitestKeyPass. string. Nepovinný parametr. Použijte, když enablePrepare = true && framework = uitest.

Určuje heslo klíče pro alias a soubor úložiště. Pokud chcete tuto hodnotu zašifrovat, použijte novou proměnnou s povoleným zámkem na kartě Proměnné.

uiTestToolsDirectory - Adresář testovacích nástrojů
Vstupní alias: uitestToolsDir. string. Nepovinný parametr. Použijte, když enablePrepare = true && framework = uitest.

Cesta k adresáři s testovacími nástroji uživatelského rozhraní Xamarinu, které obsahují test-cloud.exe.

signInfo - Podpisové informace
string. Nepovinný parametr. Použijte, když framework = calabash || framework = uitest.

Podepíše testovací server.

xcUITestBuildDirectory - Adresář sestavení
Vstupní alias: xcuitestBuildDir. string. Nepovinný parametr. Použijte, když enablePrepare = true && framework = xcuitest.

Cesta k výstupnímu adresáři sestavení (obvykle $(ProjectDir)/Build/Products/Debug-iphoneos).

xcUITestIpaFile - Test cesty IPA
Vstupní alias: xcuitestTestIpaPath. string. Nepovinný parametr. Použijte, když enablePrepare = true && framework = xcuitest.

Cesta k souboru .ipa s testy XCUITest.

prepareOptions - Další možnosti
Alias vstupu: prepareOpts. string. Nepovinný parametr. Použijte, když enablePrepare = true.

Další argumenty, které se předávají kroku přípravy testu app center.

runTests - Spouštění testů
Alias vstupu: enableRun. boolean. Výchozí hodnota: true.

Spustí testy.

credentialsOption - Metoda ověřování
Alias vstupu: credsType. string. Vyžaduje se, když enableRun = true. Povolené hodnoty: serviceEndpoint (připojení služby App Center), inputs (Přihlašovací údaje). Výchozí hodnota: serviceEndpoint.

Použije připojení služby App Center nebo zadá přihlašovací údaje pro připojení k sadě Visual Studio App Center.

serverEndpoint - Připojení služby App Center
string. Vyžaduje se, když enableRun = true && credsType = serviceEndpoint.

Vybere připojení služby pro Visual Studio App Center. V případě potřeby klikněte na odkaz Spravovat a vytvořte nové připojení služby.

username - Uživatelské jméno app center
string. Vyžaduje se, když enableRun = true && credsType = inputs.

Vytvořte své uživatelské jméno tak, že navštívíte přihlašovací stránku App Center a zadáte hodnotu sem.

password - Heslo app center
string. Vyžaduje se, když enableRun = true && credsType = inputs.

Nastavte heslo tak, že navštívíte přihlašovací stránku App Center a zadáte hodnotu sem. Proměnné definované v kanálech buildu nebo verze jako $(passwordVariable) jsou přijímány. Typ proměnné můžete označit jako secret zabezpečený.

appSlug - Slug aplikace
string. Vyžaduje se, když enableRun = true.

Slug aplikace je ve formátu <username>/<app_identifier>. Pokud chcete najít <username> a <app_identifier> aplikace, klikněte na její název v sadě Visual Studio App Center. Výsledná adresa URL je ve formátu https://appcenter.ms/users/<username>/apps/<app_identifier>.

devices - Zařízení
string. Vyžaduje se, když enableRun = true.

Identifikuje zařízení, na kterých se tento test spustí. Zkopírujte a vložte tento řetězec při definování nového testovacího běhu z testovacího signálu sady Visual Studio App Center.

series - Testovací řada
string. Nepovinný parametr. Použijte, když enableRun = true. Výchozí hodnota: master.

Název řady pro uspořádání testovacích běhů (například hlavní, produkční, beta).

dsymDirectory - Adresář dSYM
Alias vstupu: dsymDir. string. Nepovinný parametr. Použijte, když enableRun = true.

Cesta k souborům symbolů iOS.

localeOption - Jazyk systému
Alias vstupu: locale. string. Vyžaduje se, když enableRun = true. Povolené hodnoty: da_DK (dánština (Dánsko)), nl_NL (holandština (Nizozemsko)), en_GB (angličtina (Spojené království)), en_US (angličtina (USA)), fr_FR (francouzština (Francie)), de_DE (němčina (Německo)), ja_JP (japonština (Japonsko)), ru_RU (ruština (Rusko)), es_MX (španělština (Mexiko)), es_ES (španělština (Španělsko)), user (ostatní). Výchozí hodnota: en_US.

Pokud se váš jazyk nezobrazuje, využijte ho. Vyberte Other a zadejte národní prostředí, například en_US.

userDefinedLocale - Jiné národní prostředí
string. Nepovinný parametr. Použijte, když enableRun = true && locale = user.

Zadá jakýkoli dvoumísmenný kód jazyka ISO-639 spolu s libovolným dvoumísmenným kódem země ISO 3166 ve formátu <language>_<country>, například en_US.

loginOptions - Další možnosti přihlášení
Alias vstupu: loginOpts. string. Nepovinný parametr. Použijte, když enableRun = true && credsType = inputs.

Další argumenty, které jsou předány kroku přihlášení k Visual Studio App Center.

runOptions - Další možnosti spuštění
Alias vstupu: runOpts. string. Nepovinný parametr. Použijte, když enableRun = true.

Další argumenty, které se předávají testovacímu běhu visual studio App Center.

skipWaitingForResults - Nečekejte na výsledek testu
Alias vstupu: async. boolean. Nepovinný parametr. Použijte, když enableRun = true. Výchozí hodnota: false.

Spustí příkaz asynchronně a při nahrání testů se ukončí bez čekání na výsledky testu.

cliFile - Umístění rozhraní příkazového řádku app Center
Alias vstupu: cliLocationOverride. string.

Cesta k rozhraní příkazového řádku pro Visual Studio App Center v agentu sestavení nebo verze.

showDebugOutput - Povolení výstupu ladění
Alias vstupu: debug. boolean. Výchozí hodnota: false.

Přidá --debug do rozhraní příkazového řádku pro Visual Studio App Center.

uitestStoreFile - Uložit soubor
string. Nepovinný parametr. Použijte, když enablePrepare = true && framework = uitest.

Možnosti ovládání úloh

Všechny úlohy mají kromě vstupů také možnosti ovládání. Další informace najdete v tématu Možnosti ovládacích prvků a běžné vlastnosti úlohy.

Výstupní proměnné

Žádné

Poznámky

Tato úloha umožňuje spustit testovací sady na binární soubor aplikace (soubor .apk nebo .ipa ) pomocí app center test.

Nejprve se zaregistrujte v App Center .
Podrobnosti o použití této úlohy najdete v dokumentaci k App Center v článku Použití Azure DevOps k testování uživatelského rozhraní.

Příklady

Tento příklad spustí testy Espresso v aplikaci pro Android pomocí úlohy App Center Test.

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

Požadavky

Požadavek	Popis
Typy kanálů	YAML, klasický build
Běží na	Agent, DeploymentGroup
Požadavky	Žádné
Možnosti	Tento úkol nesplňuje žádné požadavky na následné úkoly v úloze.
Omezení příkazů	Všechny
Nastavitelné proměnné	Všechny
Verze agenta	2.206.1 nebo vyšší
Kategorie úloh	Test

Požadavek	Popis
Typy kanálů	YAML, klasický build
Běží na	Agent, DeploymentGroup
Požadavky	Žádné
Možnosti	Tento úkol nesplňuje žádné požadavky na následné úkoly v úloze.
Omezení příkazů	Všechny
Nastavitelné proměnné	Všechny
Verze agenta	2.144.0 nebo vyšší
Kategorie úloh	Test

Požadavek	Popis
Typy kanálů	YAML, klasický build
Běží na	Agent, DeploymentGroup
Požadavky	Žádné
Možnosti	Tento úkol nesplňuje žádné požadavky na následné úkoly v úloze.
Omezení příkazů	Všechny
Nastavitelné proměnné	Všechny
Verze agenta	Všechny podporované verze agenta.
Kategorie úloh	Test

Sdílet prostřednictvím