appium capabilities

Posted 2021-03-04 丛影HHZ

前言：因为一直想过一遍capabilities，但是一直静不下来，干脆就把capabilities抄一遍，基本渣翻。。纯粹为了自己看下去找个理由

appium capabilities

通用的capabilities

Capability	描述	取值
automationName	选择使用的自动化引擎	Appium(默认) UiAutomator2 Espresso(android) XCUITest(ios) 或者是你自己应用的引擎
platformName	手机操作系统平台	iOS Android FirefoxOS
platformVersion	操作系统版本号
deviceName	设备名	通过adb devices 获得
app	给定app的绝对本地地址或是url地址 appium会尝试安装给定app到合适的设备 * 注意：如果设备是android此项可以忽略， 如果你已经指定appPackage和appActivity ， UiAutomator2 和 XCUITest这两种自动化引擎， 可以在没有app或是appPackage的情况下 创建一个session，与browserName不兼容
otherApps	给定APP或是APP列表，会在运行测试前安装 到设备中 * 注意：Espresso平台和ios真机，此项不起作用	"/path/to/app.apk", https://www.example.com/url/to/app.apk, ["http://appium.github.io/appium/assets/TestApp9.4.app.zip", "/path/to/app-b.app"]
browserName	要自动化的移动web浏览器的名称 如果要自动化一个app应用，此项应为空	‘Safari‘ for iOS and ‘Chrome‘, ‘Chromium‘, or ‘Browser‘ for Android
newCommandTimeout	在假定客户端退出并结束session之前， appium会等待客户端发出的命令多长时间(单位s)	e.g. 60
language	设置iOS (XCUITest driver only) 和 Android的语言	e.g. fr
locale	地区设置，适用于iOS (XCUITest driver only) 和 Android. 对于ios的设置格式为fr_CA， 对于Android的设置格式为CA(CA为国家名称的缩写)	e.g. fr_CA, CA
udid	唯一的设备标识符（所连接的真机）	e.g. 1ae203187fc012g
orientation	(Sim/Emu-only) 开始的时候使设备横屏或竖屏	LANDSCAPE(横屏)or PORTRAIT
autoWebview	直接切入Webview 默认是false	true, false
noReset	在开始session之前，不重置app的状态 android:不停止app，不清空app数据，不卸载app ios:结束测试后，不销毁和关闭sim， 在正在运行的sim或插入设备的任何位置开始运行测试	true, false
fullReset	完全重置app状态 android:停止运行app、清空app数据、 在session之前以及测试结束之后卸载app ios:在真机测试开始前和结束后，卸载app， 在模拟测试开始前和结束后，销毁模拟器 （如果之前resetOnSessionStartOnly: true给定了，这些设置会生效）	true, false
eventTimings	开启或禁止报告appium内部事件的耗时 （例如，每条命令的开始和结束时间） 默认false 使用true使其起作用， 然后根据查询当前会话的时间，将时间报告为事件属性。
enablePerformanceLogging	(只在Web 和webview 中有效) 开启Chromedriver(android)或者Safari(ios)的性能日志	true, false
printPageSourceOnFindFailure	当发现一个运行报错的时候，打印当前的page source.默认是false	true, false
clearSystemFiles	在session结束的时候，删除运行生成的文件。默认是false	true, false

Android 特有的

Capability	描述	取值
appActivity	要从包中启动的Android活动的活动名称 这通常需要在前面加上一个"." 默认情况下，此项可以从package的manifest中取得
appPackage	你打算运行的包名， 默认情况下，此项可以从package的manifest中取得
appWaitActivity	等待出现的Activity，多个Activity用逗号隔开 默认情况下，此项与appActivity一致 您必须将其设置为第一个关注的应用程序活动名称 免得此项设置的Activity与你设置的appActivity 和appPackage不一致 你也可以使用通配符(*)	SplashActivity, SplashActivity,OtherActivity, *, *.SplashActivity
appWaitPackage
appWaitDuration	设置等待appWaitActivity运行的超时时间，单位为毫秒， 默认为20000ms	30000
deviceReadyTimeout	等待设备准备好的超时时间，单位为秒
allowTestPackages	允许安装一个测试包到设备上， 这个测试包的manifest里标明android:testOnly="true"， 默认是false	true or false
androidCoverage
androidCoverageEndIntent
androidDeviceReadyTimeout
androidInstallTimeout
androidInstallPath
adbPort
systemPort
remoteAdbHost
androidDeviceSocket
avd
avdLaunchTimeout
avdReadyTimeout
avdArgs
useKeystore
keystorePath
keystorePassword
keyAlias
keyPassword
chromedriverExecutable
chromedriverArgs
chromedriverExecutableDir
chromedriverChromeMappingFile
chromedriverUseSystemExecutable
autoWebviewTimeout
chromedriverPort
chromedriverPorts
ensureWebviewsHavePages
webviewDevtoolsPort
dontStopAppOnReset
unicodeKeyboard
resetKeyboard
noSign
ignoreUnimportantViews
disableAndroidWatchers
chromeOptions
recreateChromeDriverSessions
nativeWebScreenshot
androidScreenshotPath
autoGrantPermissions
networkSpeed
gpsEnabled
isHeadless
adbExecTimeout
localeScript
skipDeviceInitialization
chromedriverDisableBuildCheck
skipUnlock
unlockType
unlockKey
autoLaunch
skipLogcatCapture
uninstallOtherPackages
disableWindowAnimation
remoteAppsCacheLimit
buildToolsVersion
androidNaturalOrientation
enforceAppInstall