AppCenterTest@1 – testovací úloha App Center v1

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.

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.

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