AppCenterTest@1 – App Center v1 tesztfeladat

Alkalmazáscsomagok tesztelése a Visual Studio App Centerrel.

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.

Bevitelek

appFile - Bináris alkalmazásfájl elérési útja
Bemeneti alias: app. string. Kötelező.

Az adattár gyökerétől a tesztelni kívánt APK- vagy IPA-fájlhoz vezető relatív elérési út.

artifactsDirectory - Artifacts könyvtár
Bemeneti alias: artifactsDir. string. Kötelező. Alapértelmezett érték: $(Build.ArtifactStagingDirectory)/AppCenterTest.

Meghatározza, hogy hová helyezze az előkészítési lépés által létrehozott és a futtatási lépés által használt összetevőket. Ez a könyvtár akkor jön létre, ha még nem létezik.

prepareTests - Tesztek előkészítése
Bemeneti alias: enablePrepare. boolean. Alapértelmezett érték: true.

Ha a értékre truevan állítva, ez a bemenet előkészíti a teszteket.

frameworkOption - Tesztelési keretrendszer
Bemeneti alias: framework. string. Akkor szükséges, ha enablePrepare = true. Engedélyezett értékek: appium, espresso, calabashuitest (Xamarin UI-teszt), xcuitest. Alapértelmezett érték: appium.

appiumBuildDirectory - Könyvtár létrehozása
Bemeneti alias: appiumBuildDir. string. Akkor szükséges, ha enablePrepare = true && framework = appium.

A könyvtár elérési útja az Appium-tesztekkel.

espressoBuildDirectory - Könyvtár létrehozása
Bemeneti alias: espressoBuildDir. string. Választható. Használja a következőt: enablePrepare = true && framework = espresso.

Az Espresso kimeneti könyvtárának elérési útja.

espressoTestApkFile - Az APK elérési útjának tesztelése
Bemeneti alias: espressoTestApkPath. string. Választható. Használja a következőt: enablePrepare = true && framework = espresso.

Az APK-fájl elérési útja az Eszpresszó tesztekkel. Ha nincs beállítva, build-dir a rendszer felderíti. Helyettesítő karakter használata engedélyezett.

calabashProjectDirectory - Projektkönyvtár
Bemeneti alias: calabashProjectDir. string. Akkor szükséges, ha enablePrepare = true && framework = calabash.

A Calabash-munkaterület könyvtárának elérési útja.

calabashConfigFile - Uborka konfigurációs fájl
string. Választható. Használja a következőt: enablePrepare = true && framework = calabash.

Az Uborka konfigurációs fájl elérési útja, általában cucumber.yml.

calabashProfile - Futtatandó profil
string. Választható. Használja a következőt: enablePrepare = true && framework = calabash.

A futtatni kívánt profil. Ennek az értéknek léteznie kell az Uborka konfigurációs fájlban.

calabashSkipConfigCheck - Konfigurációellenőrzés kihagyása
boolean. Választható. Használja a következőt: enablePrepare = true && framework = calabash. Alapértelmezett érték: false.

Ha a értékre truevan állítva, ez a bemenet kihagyja az Uborka profil által megadott konfigurációs ellenőrzést.

uiTestBuildDirectory - Könyvtár létrehozása
Bemeneti alias: uitestBuildDir. string. Akkor szükséges, ha enablePrepare = true && framework = uitest.

A könyvtár elérési útja a beépített tesztszerelvényekkel.

uitestStorePath - Fájl tárolása
string. Választható. Használja a következőt: enablePrepare = true && framework = uitest.

Az alkalmazás aláírásához használt tárolófájl elérési útja.

uiTestStorePassword - Jelszó tárolása
Bemeneti alias: uitestStorePass. string. Választható. Használja a következőt: enablePrepare = true && framework = uitest.

Az alkalmazás aláírásához használt tárolófájl jelszava. Az érték titkosításához használjon egy új változót, amelynek zárolása engedélyezve van a Változók lapon.

uitestKeyAlias - Kulcsalias
string. Választható. Használja a következőt: enablePrepare = true && framework = uitest.

Megadja azt az aliast, amely azonosítja a tárolófájlban használt nyilvános/titkos kulcspárt.

uiTestKeyPassword - Kulcsjelszó
Bemeneti alias: uitestKeyPass. string. Választható. Használja a következőt: enablePrepare = true && framework = uitest.

Megadja az alias és a tárolófájl kulcsjelszóját. Az érték titkosításához használjon egy új változót, amelynek zárolása engedélyezve van a Változók lapon.

uiTestToolsDirectory - Teszteszközök könyvtára
Bemeneti alias: uitestToolsDir. string. Választható. Használja a következőt: enablePrepare = true && framework = uitest.

A könyvtár elérési útja az test-cloud.exetartalmazó Xamarin felhasználói felületi teszteszközökkel.

signInfo - Aláírási információk
string. Választható. Használja a következőt: framework = calabash || framework = uitest.

Aláírja a tesztkiszolgálót.

xcUITestBuildDirectory - Könyvtár létrehozása
Bemeneti alias: xcuitestBuildDir. string. Választható. Használja a következőt: enablePrepare = true && framework = xcuitest.

A build kimeneti könyvtárának elérési útja (általában $(ProjectDir)/Build/Products/Debug-iphoneos).

xcUITestIpaFile - IPA-elérési út tesztelése
Bemeneti alias: xcuitestTestIpaPath. string. Választható. Használja a következőt: enablePrepare = true && framework = xcuitest.

Az .ipa fájl elérési útja az XCUITest-tesztekkel.

prepareOptions - További beállítások
Bemeneti alias: prepareOpts. string. Választható. Használja a következőt: enablePrepare = true.

Az App Center teszt-előkészítési lépésének átadott további argumentumok.

runTests - Tesztek futtatása
Bemeneti alias: enableRun. boolean. Alapértelmezett érték: true.

Futtatja a teszteket.

credentialsOption - Hitelesítési módszer
Bemeneti alias: credsType. string. Akkor szükséges, ha enableRun = true. Engedélyezett értékek: serviceEndpoint (App Center szolgáltatáskapcsolat) inputs (hitelesítő adatok). Alapértelmezett érték: serviceEndpoint.

Az App Center szolgáltatáskapcsolatot használja, vagy megadja a hitelesítő adatokat a Visual Studio App Centerhez való csatlakozáshoz.

serverEndpoint - App Center-szolgáltatáskapcsolat
string. Akkor szükséges, ha enableRun = true && credsType = serviceEndpoint.

Kiválasztja a Visual Studio App Center szolgáltatáskapcsolatát. Ha szükséges, kattintson a Kezelés hivatkozásra egy új szolgáltatáskapcsolat létrehozásához.

username - App Center-felhasználónév
string. Akkor szükséges, ha enableRun = true && credsType = inputs.

Hozza létre a felhasználónevét az App Center bejelentkezési oldalán, és adja meg itt az értéket.

password - App Center-jelszó
string. Akkor szükséges, ha enableRun = true && credsType = inputs.

Állítsa be a jelszavát az App Center bejelentkezési oldalán, és adja meg itt az értéket. A buildelési vagy kiadási folyamatokban definiált változók $(passwordVariable) elfogadottak. A változótípust biztonságossá secret teheti.

appSlug - Alkalmazáscsúcs
string. Akkor szükséges, ha enableRun = true.

Az alkalmazáscsúcs formátuma <username>/<app_identifier>. Az és <app_identifier> egy alkalmazás megkereséséhez <username> kattintson a nevére a Visual Studio App Centerben. Az eredményként kapott URL-cím formátuma https://appcenter.ms/users/<username>/apps/<app_identifier>.

devices - Eszközök
string. Akkor szükséges, ha enableRun = true.

Azonosítja azokat az eszközöket, amelyen a teszt futni fog. Másolja és illessze be ezt a sztringet, amikor új tesztfuttatást határoz meg a Visual Studio App Center tesztjelzőjéből.

series - Tesztsorozat
string. Választható. Használja a következőt: enableRun = true. Alapértelmezett érték: master.

A tesztfuttatások rendszerezésének sorozatneve (például: master, production, béta).

dsymDirectory - dSYM-könyvtár
Bemeneti alias: dsymDir. string. Választható. Használja a következőt: enableRun = true.

Az iOS-szimbólumfájlok elérési útja.

localeOption - Rendszernyelv
Bemeneti alias: locale. string. Akkor szükséges, ha enableRun = true. Megengedett értékek: da_DK (dán (Dánia)), nl_NL (holland (Hollandia)), en_GB (angol (Egyesült Királyság)), en_US (angol (Egyesült Államok)), fr_FR (francia (Franciaország)), de_DE (német (Németország)), ja_JP (japán (Japán)), ru_RU (orosz (Oroszország)), es_MX (spanyol (Mexikó)), es_ES (spanyol (Spanyolország)), user (Egyéb). Alapértelmezett érték: en_US.

Használja, ha a nyelv nem jelenik meg. Válassza ki Other és adja meg a területi beállításokat, például en_US: .

userDefinedLocale - Egyéb területi beállítás
string. Választható. Használja a következőt: enableRun = true && locale = user.

A kétbetűs ISO-639 nyelvi kódot, valamint bármely kétbetűs ISO 3166 országkódot <language>_<country>adja meg formátumban, például en_US: .

loginOptions - További bejelentkezési lehetőségek
Bemeneti alias: loginOpts. string. Választható. Használja a következőt: enableRun = true && credsType = inputs.

A Visual Studio App Center bejelentkezési lépésének átadott további argumentumok.

runOptions - További futtatási lehetőségek
Bemeneti alias: runOpts. string. Választható. Használja a következőt: enableRun = true.

A Visual Studio App Center tesztfuttatásának átadott további argumentumok.

skipWaitingForResults - Ne várjon a teszteredményre
Bemeneti alias: async. boolean. Választható. Használja a következőt: enableRun = true. Alapértelmezett érték: false.

Aszinkron módon hajt végre egy parancsot, és a teszteredmények várakozása nélkül kilép a tesztek feltöltésekor.

cliFile - Az App Center parancssori felületének helye
Bemeneti alias: cliLocationOverride. string.

A Visual Studio App Center parancssori felületének elérési útja a buildelési vagy kiadási ügynökön.

showDebugOutput - Hibakeresési kimenet engedélyezése
Bemeneti alias: debug. boolean. Alapértelmezett érték: false.

Hozzáadja --debug a Visual Studio App Center parancssori felületéhez.

Feladatvezérlési lehetőségek

Minden feladathoz tartoznak vezérlési lehetőségek is a feladat bemenetei mellett. További információ: Vezérlési beállítások és gyakori feladattulajdonságok.

Kimeneti változók

Nincsenek.

Megjegyzések

Ez a feladat lehetővé teszi tesztcsomagok futtatását egy alkalmazás bináris fájlja (.apk vagy .ipa fájl) alapján az App Center Test használatával.

• Először regisztráljon az App Centerrel .
• A feladat használatával kapcsolatos részletekért tekintse meg az App Center felhasználói felületi teszteléshez készült Azure DevOps használatával foglalkozó dokumentációját.

Példák

Ez a példa Espresso-teszteket futtat egy Android-alkalmazáson az App Center Test feladattal.

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

Követelmények

Követelmény	Leírás
Folyamattípusok	YAML, klasszikus build
Futtatás:	Ügynök, DeploymentGroup
Igények	None
Képességek	Ez a tevékenység nem felel meg a feladat későbbi tevékenységeire vonatkozó követelményeknek.
Parancskorlátozások	Bármelyik
Változók beállítása	Bármelyik
Ügynök verziója	2.206.1 vagy újabb
Feladatkategória	Teszt