appium Capabilities的各个标签

今天详解一下Capabilities的各个标签，以后如果用得着可以随时翻阅。

General Capabilities

标签	概述	值
automationName	使用引擎	默认为Appium，其中Appium、UiAutomator2、Selendroid、Espresso用于Android，XCUITest用于iOS
platformName	操作系统	如iOS、Android、FirefoxOS
platformVersion	操作系统版本	如7.1，4.4
deviceName	设备名	如iPhone Simulator, iPad Simulator, iPhone Retina 4-inch, Android Emulator, Galaxy S4，iOS需要，Android可以忽略
app	apk、.ipa等的加载路径	如D:\\text.apk、/home/zhuyt/test.ipa
browserName	浏览器名，若为app则省略	如'Safari'、'Chromium'
newCommandTimeout	appium server与client的超时时间	如60s
language	语言，默认只有用Siumulator才有效	如fr
locale	国家地区，默认只有用Siumulator才有效	如fr_CA, CA
udid	连接的物理设备的唯一设备标识符	如1ae203187fc012g
orientation	（仅限Sim / Emu）以某个方向开始	LANDSCAPE or PORTRAIT
autoWebview	直接进入Webview上下文，默认False	True，False
noReset	在会话前，不重启app，重启的话只删除数据	True，False
fullReset	完全重启app，删除app，数据后重启	True，False
eventTimings	启用或禁用各种Appium内部事件的时间报告，默认False	True，False
enablePerformanceLogging	（仅限Web和webview）使在Chrome（在Android上）或Safari（在iOS上）可以有log（默认为false）	True，False
printPageSourceOnFindFailure	当某个操作失败时，打印当前页面代码，默认False	True，False

Android Only

标签	概述	值
appActivity	package中想要运行的Activity name，名字前通常需要加.,默认从package manifest读取	如.MainActivity，MainActivity
appPackage	Android app中想要运行的Java的package包，默认从package manifest读取	如com.example.android.myApp
appWaitActivity	设置要等待的activity，默认与appActivity一样，若有appActivity、appPackage，则必须设置为第一个启动的activity名称	如MainActivity，MainActivity
appWaitPackage	要等待的App内的Java Package,默认与appPackage相等.	如com.example.android.myApp, com.android.settings
appWaitDuration	用于等待appWaitActivity启动的超时（以毫秒为单位）（默认为20000）	如30000
deviceReadyTimeout	等待设备准备就绪时的超时时间(默认为s)	如5
allowTestPackages	如果在manifest中有android:testOnly="true"，则允许安装test Package，默认为False	True，False
androidCoverage	用于执行测试的 instrumentation 类, adb shell am instrument -e coverage true -w	后接instumentation类，如com.my.Pkg.instrumentation.MyInstrumentation
androidCoverageEndIntent	设置实施的广播操作，覆盖范围为文件系统。即调用adb shell am broadcast -a	后接参数如com.example.pkg.END_EMMA
androidDeviceReadyTimeout	设备引导结束后，准备就绪的超时时间	如30
androidInstallTimeout	安装apk用的超时时间，默认90000毫秒	如90000
androidInstallPath	apk安装前会先被push到的地址，默认是/data/local/tmp	如/sdcard/Downloads/
adbPort	adb server的port，默认是5037	如5037
systemPort	SystemPort用来连接appium-uiautomator2-server 或 appium-espresso-driver。对于前者，端口通常是8200-8299，后者为8300-8399，当两者都要用时，要注意产生冲突	如8201
remoteAdbHost	远程的ADB host	如192.168.0.101
androidDeviceSocket	Devtools套接字名称。 仅在测试的应用程序是Chromium浏览器时才需要。 套接字由浏览器打开，Chromedriver作为devtools客户端连接浏览器。	如chrome_devtools_remote
avd	要启动的avd名	如api19
avdLaunchTimeout	avd启动并连接到adb的超时时间，默认为60000毫秒	如30000
avdReadyTimeout	avd完成启动的动画需要的超时时间，默认为120000毫秒	如30000
avdArgs	模拟器启动时额外的参数	如-netfast
useKeystore	使用自定义密钥库对apk签名，默认为false	True，Fasle
keystorePath	自定义密钥库的地址，默认为~/.android/debug.keystore	如/path/to.keystore
keystorePassword	密钥库的密码	如foo
keyAlias	密钥的别名	如androiddebugkey
keyPassword	密钥的密码	如foo
chromedriverExecutable	webdriver的绝对路径，如果chrome提供给了自己的wedriver，则应使用这，不用与appium绑定的chromedriver	如/abs/path/to/webdriver
chromedriverExecutableDir	chromedriver的路径，会自动在该路径寻找chromedriver，如果chromedriverUseSystemExecutable 是true，则忽略	如/abs/path/to/chromedriver/directory
chromedriverChromeMappingFile	文件的绝对路径，将Chromedriver版本映射到它支持的最小Chrome。 如果chromedriverUseSystemExecutable为true，则忽略	如/abs/path/to/mapping.json
chromedriverUseSystemExecutable	如果为true，则绕过自动Chromedriver配置并使用随Appium下载的版本。 如果设置了chromedriverExecutable，则忽略。 默认为false	True，False
autoWebviewTimeout	等待webView激活的超时时间，默认是2000毫秒	如2000
intentAction	用于启动 activity 的 intent action，默认值为android.intent.action.MAIN	如android.intent.action.MAIN
intentCategory	指定当前动作（Action）被执行的环境	如android.intent.category.LAUNCHER, android.intent.category.APP_CONTACTS
intentFlags	用于启动的activity的标志，默认0x10200000	如0x10200000
optionalIntentArguments	用于启动activity的intent action的参数	如--esn <EXTRA_KEY>, --ez <EXTRA_KEY> <EXTRA_BOOLEAN_VALUE>
dontStopAppOnReset	用于是否关闭activity所属的app后再启动activity，等同于adb shell am start 是否使用-S参数	True，False
unicodeKeyboard	使可以输入Unicode，默认为False	True，False
resetKeyboard	在用Unicode测试完成后，将键盘reset，不可单独使用，默认为False	True，False
noSign	使用调试键跳过检查和签名应用程序，仅适用于UiAutomator，而不适用于selendroid，默认为false	True，False
ignoreUnimportantViews	是否调用uiautomator的函数setCompressedLayoutHierarchy()，此功能能加快测试速度，Accessibility命令将更快地运行而忽略某些元素	True，False
disableAndroidWatchers	是否禁用app的监听功能，这会减少cpu使用率。此功能仅适用于UiAutomator，而不适用于selendroid，默认为false	True，False
chromeOptions	提供chromeDriver的capability参数	chromeOptions: {args: ['--disable-popup-blocking']}
recreateChromeDriverSessions	移动至非web程序时，是否杀掉chromeDriver	True，False
nativeWebScreenshot	在web程序中，用原生adb截图，而不是chromeDriver	True，False
androidScreenshotPath	文件截图默认存放地址	如/sdcard/screenshots/
autoGrantPermissions	让appium自动授权app权限，如果noReset为True，则该条不生效	True,False
networkSpeed	指定网络最快上传与下载速度	如['full','gsm', 'edge', 'hscsd', 'gprs', 'umts', 'hsdpa', 'lte', 'evdo']
gpsEnabled	是否启动gps	True，False
isHeadless	将此功能设置为true可在无需显示设备时运行仿真器。 false是默认值isHeadless也支持iOS，检查特定于XCUITest的功能	True，False
otherApps	运行测试前需要安装的app列表	如"/path/to/app.apk", https://www.example.com/url/to/app.apk, ["/path/to/app-a.apk", "/path/to/app-b.apk"]
adbExecTimeout	adb指令超时时间，默认是20000毫秒	如50000
localeScript	建立一个script	例如"Cyrl" (Cyrillic)

UIAutomator2 Only

标签	概述	值
uiautomator2ServerLaunchTimeout	等待uiAutomator2的server启动超时时间，单位毫秒	如3000
uiautomator2ServerInstallTimeout	等待uiAutomator2的server被安装超时时间，单位毫秒	如3000

Espresso Only

标签	概述	值
espressoServerLaunchTimeout	等待espresso的server的启动超时时间，单位毫秒	如3000

iOS Only

标签	概述	值
calendarFormat	（仅限Sim）要为iOS模拟器设置的日历格式	如gregorian
bundleId	被测试应用程序的bundle Id。用于在真实设备中启动测试，。在使用 bundle ID 在真实设备上执行测试时，你可以省略'app'关键字，但你必须提供 `udid` ，	如io.appium.TestApp
udid	设备唯一物理地址号	如1ae203187fc012g
launchTimeout	启动超时时间，单位毫秒	如3000
locationServicesEnabled	（仅限Sim）强制关闭定位与否。	True，False
locationServicesAuthorized	（仅限Sim）通过修改 plist 文件设定是否允许应用使用定位服务，从而避免定位服务的警告出现。请注意在使用这个关键字时，必须需要使用 `bundleId` 关键字来发送应用的 bundle ID。	True，False
autoAcceptAlerts	接收任何警告处理，包括隐私访问许可警报。默认为False。不适用于基于XCUITest的测试。	True，False
autoDismissAlerts	不接受任何警告处理，包括隐私访问许可警报。默认为False。不适用于基于XCUITest的测试。	True，False
nativeInstrumentsLib	使用原生 intruments 库 (即关闭 instruments-without-delay )	True，False
nativeWebTap	（仅限Sim）在Safari中启用“真实的”非基于JavaScript的网络点击。 默认值：false。 警告：根据视口大小/比例，这可能无法准确地点击元素	True，False
safariInitialUrl	（仅限Sim）(>= 8.1) 初始的safari的URL，默认是当前的欢迎页	如https://www.github.com
safariAllowPopups	（仅限Sim）允许用JS在Safari中打开新窗口。	True，False
safariIgnoreFraudWarning	（仅限Sim）防止Safari显示欺诈性网站警告。	True，False
safariOpenLinksInBackground	（仅限Sim）Safari是否应允许在新窗口中打开链接。	True，False
keepKeyChains	（仅限Sim）是否在启动/完成appium会话时保留KeyChains，即保存密码等。	True，False
localizableStringsDir	（仅限Sim）是否寻找本地化的字符串。默认en.lproj	True，False
processArguments	通过 instruments 传递到 AUT 的参数	如-myflag
interKeyDelay	输入值时发送到元素的延迟时间	如100
showIOSLog	是否在appium日志中显示从设备捕获的任何日志。 默认为false	True，False
sendKeyStrategy	输入文本到文本框的策略。模拟器默认：一个一个输。真实设备：分组输	oneByOne, grouped or setValue
screenshotWaitTimeout	等待生成屏幕截图的最大超时秒数。 默认值：10，单位为秒	如10
waitForAppScript	用于判断 "应用是否被启动” 的 iOS 自动化脚本代码。默认情况下系统等待直到页面内容非空。结果必须是布尔类型。	如true;, target.elements().length > 0;, $.delay(5000);
webviewConnectRetries	将连接消息发送到远程调试器以获取webview的次数。 默认值：8	如8
appName	被测试的app的显示名字。IOS系统版本需要为9.0+	如UICatalog
customSSLCert	（仅限Sim）将SSL证书添加到iOS的模拟器中	如 -----BEGIN CERTIFICATE-----MIIFWjCCBEKg... -----END CERTIFICATE-----
webkitResponseTimeout	(只限制真实设备)等待safari中页面的响应时间，默认为毫秒	如3000
remoteDebugProxy	（仅限Sim， <= 11.2）如果设置，Appium通过本地端口（仅限Sim，<= 11.2）上的代理或此unix套接字上的代理（仅Sim> = 11.3）发送和接收远程调试消息，而不是直接与iOS远程调试器通信。 例如 12000	如12000 or "/tmp/my.proxy.socket"