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.
# 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.
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 true
van á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
, calabash
uitest
(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 true
van á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.
uitestStoreFile
- Fájl tárolása
string
. Választható. Használja a következőt: enablePrepare = true && framework = uitest
.
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 |
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.144.0 vagy újabb |
Feladatkategória | Teszt |
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 | Minden támogatott ügynökverzió. |
Feladatkategória | Tesztelés |
Visszajelzés
https://aka.ms/ContentUserFeedback.
Hamarosan elérhető: 2024-ben fokozatosan kivezetjük a GitHub-problémákat a tartalom visszajelzési mechanizmusaként, és lecseréljük egy új visszajelzési rendszerre. További információ:Visszajelzés küldése és megtekintése a következőhöz: