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上下文，默认FalseTrue，False
noReset ：在会话前，不重启app，重启的话只删除数据True，False
fullReset ：完全重启app，删除app，数据后重启True，False
eventTimings ：启用或禁用各种Appium内部事件的时间报告，默认FalseTrue，False
enablePerformanceLogging ：（仅限Web和webview）使在Chrome（在Android上）或Safari（在iOS上）可以有log（默认为false）True，False
printPageSourceOnFindFailure ： 当某个操作失败时，打印当前页面代码，默认FalseTrue，False
Android Only
标签概述值
appActivitypackage ：中想要运行的Activity name，名字前通常需要加.,默认从package manifest读取 如.MainActivity，MainActivity
appPackageAndroid ： 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，默认为FalseTrue，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
androidInstallPathapk ：安装前会先被push到的地址，默认是/data/local/tmp如/sdcard/Downloads/
adbPortadb ：server的port，默认是5037如5037
systemPortSystemPort ：用来连接appium-uiautomator2-server 或 appium-espresso-driver。对于前者，端口通常是8200-8299，后者为8300-8399，当两者都要用时，要注意产生冲突如8201
remoteAdbHost ：远程的ADB host如192.168.0.101
androidDeviceSocketDevtools ：套接字名称。 仅在测试的应用程序是Chromium浏览器时才需要。 套接字由浏览器打开，Chromedriver作为devtools客户端连接浏览器。如chrome_devtools_remote
avd 要启动的avd名如api19
avdLaunchTimeoutavd ：启动并连接到adb的超时时间，默认为60000毫秒如30000
avdReadyTimeout ：avd完成启动的动画需要的超时时间，默认为120000毫秒 如30000
avdArgs ：模拟器启动时额外的参数如-netfast
useKeystore ：使用自定义密钥库对apk签名，默认为falseTrue，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，则忽略。 默认为falseTrue，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
dontStopAppOnReset ：用于是否关闭activity所属的app后再启动activity，等同于adb shell am start 是否使用-S参数True，False
unicodeKeyboard ：使可以输入Unicode，默认为FalseTrue，False
resetKeyboard ：在用Unicode测试完成后，将键盘reset，不可单独使用，默认为FalseTrue，False
noSign ：使用调试键跳过检查和签名应用程序，仅适用于UiAutomator，而不适用于selendroid，默认为falseTrue，False
ignoreUnimportantViews ：是否调用uiautomator的函数setCompressedLayoutHierarchy()，此功能能加快测试速度，Accessibility命令将更快地运行而忽略某些元素True，False
disableAndroidWatchers ：是否禁用app的监听功能，这会减少cpu使用率。此功能仅适用于UiAutomator，而不适用于selendroid，默认为falseTrue，False
chromeOptions ：提供chromeDriver的capability参数chromeOptions: {args: ['--disable-popup-blocking']}
recreateChromeDriverSessions ：移动至非web程序时，是否杀掉chromeDriverTrue，False
nativeWebScreenshot ：在web程序中，用原生adb截图，而不是chromeDriverTrue，False
androidScreenshotPath ：文件截图默认存放地址如/sdcard/screenshots/
autoGrantPermissions ：让appium自动授权app权限，如果noReset为True，则该条不生效True,False
networkSpeed ：指定网络最快上传与下载速度如['full','gsm', 'edge', 'hscsd', 'gprs', 'umts', 'hsdpa', 'lte', 'evdo']
gpsEnabled是否启动gpsTrue，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"]
adbExecTimeoutadb ：指令超时时间，默认是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.lprojTrue，False
processArguments通过 instruments 传递到 AUT 的参数如-myflag
interKeyDelay输入值时发送到元素的延迟时间如100
showIOSLog是否在appium日志中显示从设备捕获的任何日志。 默认为falseTrue，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"