VSMobileCenterTest@0 – úloha Test v0 mobile Center

2025-06-24

Pomocí této úlohy otestujte balíčky mobilních aplikací pomocí centra Visual Studio Mobile Center.

Syntaxe

# Mobile Center Test v0
# Test mobile app packages with Visual Studio Mobile Center.
- task: VSMobileCenterTest@0
  inputs:
    app: # string. Required. Binary Application File Path. 
    artifactsDir: '$(Build.ArtifactStagingDirectory)/MobileCenterTest' # string. Required. Artifacts Directory. Default: $(Build.ArtifactStagingDirectory)/MobileCenterTest.
  # Prepare Tests
    #enablePrepare: true # boolean. Prepare Tests. Default: true.
    framework: 'appium' # 'appium' | 'espresso' | 'calabash' | 'uitest' | 'xcuitest'. Required when enablePrepare = true. Test Framework. Default: appium.
    #appiumBuildDir: # string. Required when enablePrepare = true && framework = appium. Build Directory. 
    #espressoBuildDir: # string. Optional. Use when enablePrepare = true && framework = espresso. Build Directory. 
    #espressoTestApkPath: # string. Optional. Use when enablePrepare = true && framework = espresso. Test APK Path. 
    #calabashProjectDir: # string. 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.
    #uitestBuildDir: # string. Required when enablePrepare = true && framework = uitest. Build Directory. 
    #uitestStoreFile: # string. Optional. Use when enablePrepare = true && framework = uitest. Store File. 
    #uitestStorePass: # string. Optional. Use when enablePrepare = true && framework = uitest. Store Password. 
    #uitestKeyAlias: # string. Optional. Use when enablePrepare = true && framework = uitest. Key Alias. 
    #uitestKeyPass: # string. Optional. Use when enablePrepare = true && framework = uitest. Key Password. 
    #uitestToolsDir: # string. Optional. Use when enablePrepare = true && framework = uitest. Test Tools Directory. 
    #signInfo: # string. Optional. Use when framework = calabash || framework = uitest. Signing Information. 
    #xcuitestBuildDir: # string. Optional. Use when enablePrepare = true && framework = xcuitest. Build Directory. 
    #xcuitestTestIpaPath: # string. Optional. Use when enablePrepare = true && framework = xcuitest. Test IPA Path. 
    #prepareOpts: # string. Optional. Use when enablePrepare = true. Additional Options. 
  # Run Tests
    #enableRun: true # boolean. Run Tests. Default: true.
    credsType: 'serviceEndpoint' # 'serviceEndpoint' | 'inputs'. Required when enableRun = true. Authentication Method. Default: serviceEndpoint.
    #serverEndpoint: # string. Required when enableRun = true && credsType = serviceEndpoint. Mobile Center Connection. 
    #username: # string. Required when enableRun = true && credsType = inputs. Mobile Center Username. 
    #password: # string. Required when enableRun = true && credsType = inputs. Mobile 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.
    #dsymDir: # string. Optional. Use when enableRun = true. dSYM Directory. 
    locale: 'en_US' # 'da_DK' | 'nl_NL' | 'en_GB' | 'en_US' | 'fr_FR' | 'de_DE' | 'ja_JP' | 'ru_RU' | 'es_MX' | 'es_ES' | 'user'. Required when enableRun = true. System Language. Default: en_US.
    #userDefinedLocale: # string. Optional. Use when enableRun = true && locale = user. Other Locale. 
    #loginOpts: # string. Optional. Use when enableRun = true && credsType = inputs. Addtional Options for Login. 
    #runOpts: # string. Optional. Use when enableRun = true. Additional Options for Run. 
    #async: false # boolean. Optional. Use when enableRun = true. Do not wait for test result. Default: false.
  # Advanced
    #cliLocationOverride: # string. mobile-center CLI Location. 
    #debug: false # boolean. Enable Debug Output. Default: false.

Vstupy

app - cesta k souboru binární aplikace
string. Povinné.

Určuje relativní cestu z kořenového adresáře úložiště do objektu . APK nebo . Soubor IPA, který chcete otestovat.

adresáře artefaktů artifactsDir -
string. Povinné. Výchozí hodnota: $(Build.ArtifactStagingDirectory)/MobileCenterTest.

Určuje adresář, do kterého se umístí artefakty vytvořené krokem přípravy a používaným krokem spuštění. Adresář se vytvoří, pokud neexistuje.

enablePrepare - příprava testů
boolean. Výchozí hodnota: true.

Pokud je nastavená na true, připraví testy.

testovací architektury framework -
string. Požadováno při enablePrepare = true. Povolené hodnoty: appium, espresso, calabash, uitest (Xamarin UI Test), xcuitest. Výchozí hodnota: appium.

Určuje testovací architekturu, kterou bude úloha používat.

appiumBuildDir - adresář sestavení
string. Požadováno při enablePrepare = true && framework = appium.

Určuje cestu k adresáři, který obsahuje testy Appium.

espressoBuildDir - adresář sestavení
string. Volitelný. Používá se při enablePrepare = true && framework = espresso.

Určuje cestu pro výstupní adresář Espresso.

espressoTestApkPath - testovací cesta APK
string. Volitelný. Používá se při enablePrepare = true && framework = espresso.

Určuje cestu k souboru APK pomocí testů Espresso. Pokud hodnota není nastavená, build-dir slouží k vyhledání souboru APK. Jsou povoleny zástupné cardy.

calabashProjectDir - adresář projektu
string. Požadováno při enablePrepare = true && framework = calabash.

Určuje cestu pro adresář pracovního prostoru Calabash.

calabashConfigFile - konfigurační soubor
string. Volitelný. Používá se při enablePrepare = true && framework = calabash.

Určuje cestu k souboru konfiguračního souboru okurách, který je obvykle cucumber.yml.

calabashProfile - profil pro spuštění
string. Volitelný. Používá se při enablePrepare = true && framework = calabash.

Určuje profil, který se má spustit. Tato hodnota musí existovat v konfiguračním souboru okurách.

calabashSkipConfigCheck - přeskočit kontrolu konfigurace
boolean. Volitelný. Používá se při enablePrepare = true && framework = calabash. Výchozí hodnota: false.

Vynutí spuštění úkolu bez profilu ochucené.

uitestBuildDir - adresář sestavení
string. Požadováno při enablePrepare = true && framework = uitest.

Určuje cestu k adresáři s sestavenými testovacími sestaveními.

uitestStoreFile - uložit souborů
string. Volitelný. Používá se při enablePrepare = true && framework = uitest.

Určuje cestu k souboru úložiště.

uitestStorePass - uložit heslo
string. Volitelný. Používá se při enablePrepare = true && framework = uitest.

Určuje heslo pro soubor úložiště. K zašifrování této hodnoty použijte novou proměnnou s povoleným zámkem na kartě Proměnné.

alias klíče uitestKeyAlias -
string. Volitelný. Používá se při enablePrepare = true && framework = uitest.

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

uitestKeyPass - heslo klíče
string. Volitelný. Používá se při enablePrepare = true && framework = uitest.

Určuje heslo klíče pro alias a uložení souboru. K zašifrování této hodnoty použijte novou proměnnou s povoleným zámkem na kartě Proměnné.

adresář uitestToolsDir - testovacích nástrojů
string. Volitelný. Používá se při enablePrepare = true && framework = uitest.

Určuje cestu k adresáři pomocí nástrojů pro testování uživatelského rozhraní Xamarinu, které obsahují test-cloud.exe.

signInfo - podpisových informací
string. Volitelný. Používá se při framework = calabash || framework = uitest.

Používá podpisové informace k podepsání testovacího serveru.

xcuitestBuildDir - adresář sestavení
string. Volitelný. Používá se při enablePrepare = true && framework = xcuitest.

Určuje cestu k výstupnímu adresáři sestavení, který je obvykle $(ProjectDir)/Build/Products/Debug-iphoneos.

xcuitestTestIpaPath - testovací cesta IPA
string. Volitelný. Používá se při enablePrepare = true && framework = xcuitest.

Určuje cestu k souboru *.ipa pomocí testů XCUITest.

prepareOpts - další možnosti
string. Volitelný. Používá se při enablePrepare = true.

Určuje další argumenty, které se mají předat mobile-center test prepare step.

enableRun - spustit testy
boolean. Výchozí hodnota: true.

metoda ověřování credsType -
string. Požadováno při enableRun = true. Povolené hodnoty: serviceEndpoint (připojení k mobilnímu centru), inputs (přihlašovací údaje). Výchozí hodnota: serviceEndpoint.

Určuje metodu ověřování. Použijte připojení koncového bodu služby Mobile Center nebo zadejte přihlašovací údaje pro připojení k sadě Visual Studio Mobile Center.

připojení k mobilnímu centru serverEndpoint -
string. Požadováno při enableRun = true && credsType = serviceEndpoint.

Určuje koncový bod služby pro připojení k sadě Visual Studio Mobile Center. Pokud ho chcete vytvořit, klikněte na odkaz Spravovat a vytvořte nový koncový bod služby.

Uživatelské jménousername - Mobile Center
string. Požadováno při enableRun = true && credsType = inputs.

Navštivte Azure Mobile Center a nastavte své uživatelské jméno.

hesla k mobilnímu centru password -
string. Požadováno při enableRun = true && credsType = inputs.

Pokud chcete nastavit heslo, navštivte Azure Mobile Center. Tento řetězec může přijmout proměnnou definovanou v definicích sestavení/vydané verze jako $(passwordVariable). Typ proměnné můžete označit jako secret, abyste ho zabezpečili.

appSlug - Aplikace Slug
string. Požadováno při enableRun = true.

Slug aplikace je ve formátu {username}/{app_identifier}. Pokud chcete vyhledat {username} a {app_identifier} aplikace, vyhledejte výpis aplikace na Azure Mobile Apps. Adresa URL je ve formátu https://mobile.azure.com/users/{username}/apps/{app_identifier}.

devices - zařízení
string. Požadováno při enableRun = true.

Určuje, jaká zařízení se tento test spustí. Zkopírujte a vložte tento řetězec při definování nového testovacího spuštění z signálu Mobile Center Test.

testovací řady series -
string. Volitelný. Používá se při enableRun = true. Výchozí hodnota: master.

Určuje název řady pro uspořádání testovacích běhů (např. master, production, beta).

adresáře dsymDir - dSYM
string. Volitelný. Používá se při enableRun = true.

Určuje cestu k adresáři dSYM, který obsahuje soubory symbolů iOS.

jazyka systému locale -
string. Požadováno při enableRun = true. Povolené hodnoty: da_DK (Dánština (Dánsko)), nl_NL (Nizozemsko),en_GB (Angličtina (Spojené království)), en_US (Angličtina (Spojené státy)), fr_FR (Francie)), fr_FR (Francie)), ja_JPen_US (německo)), es_MX (japonština (Japonsko)), es_ES (Rusko)), user (Mexiko)), (španělsko)), (jiné). Výchozí hodnota: en_US.

Pokud se váš jazyk nezobrazí, zadejte Jiné a zadejte jeho národní prostředí, například en_US.

userDefinedLocale - jiné národní prostředí
string. Volitelný. Používá se při enableRun = true && locale = user.

Určuje jakýkoli dvoumísmenný kód jazyka ISO-639 spolu s kódem země ISO 3166 se dvěma písmeny ve formátu [language]_[country], například en_US.

loginOpts - Možnosti přidání pro přihlašovací
string. Volitelný. Používá se při enableRun = true && credsType = inputs.

Určuje další argumenty, které se předávají mobile-center login step.

runOpts - další možnosti pro spuštění
string. Volitelný. Používá se při enableRun = true.

Určuje další argumenty, které se předávají mobile-center test run.

async - Nečekat na výsledek testu
boolean. Volitelný. Používá se při enableRun = true. Výchozí hodnota: false.

Při nastavení na truespustí příkazy asynchronně a ukončí, když se testy nahrají, aniž by čekaly na výsledky testu.

cliLocationOverride - umístění rozhraní příkazového řádku mobilního centra
string.

Určuje cestu k rozhraní příkazového řádku (CLI) mobile-center.

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

Přidá --debug do rozhraní příkazového řádku (CLI) mobile-center.

Možnosti ovládání úloh

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

Výstupní proměnné

Žádné.

Požadavky

Požadavek	Popis
Typy kanálů	YAML, klasické sestavení
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ů	Jakýkoliv
nastavitelné proměnné	Jakýkoliv
Verze agenta	Všechny podporované verze agenta.
Kategorie úkolu	Zkouška