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 |
|
如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... |
| webkitResponseTimeout | (只限制真实设备)等待safari中页面的响应时间，默认为毫秒 | 如3000 |
| remoteDebugProxy | （仅限Sim， <= 11.2）如果设置，Appium通过本地端口（仅限Sim，<= 11.2）上的代理或此unix套接字上的代理（仅Sim> = 11.3）发送和接收远程调试消息，而不是直接与iOS远程调试器通信。 例如 12000 | 如12000 or "/tmp/my.proxy.socket" |
