DesiredCapabilities参数设置

Appium的DesiredCapabilities参数设置

DesiredCapabilities 负责启动服务端时的参数设置。实际使用时根据自己的需要，可自行修改一些参数。

比如，应用程序在查找某个页面的元素时，定位可能会时间超长。默认的命令间隔时间是60s,如果在60s内没有找到，就会自动退出。可以使用newCommandTimeout设置为更大的数值。

capabilities.setCapability("newCommandTimeout",240);

比如，最开始使用appium时，设置了上面的安装apk的路径，结果安装后调试程序发现接口无返回数据。后来定位问题是因为安装时进行了重签名。程序的保护机制让数据无返回了。可以使用noSign设置来避免重签名。

capabilities.setCapability("noSign","true");

当然，后来发现不在程序里写文件路径，而是提前安装好测试包，这样就避免了每次都要重新安装。

完整的server参数

http://appium.io/slate/en/master/?ruby#appium-server-capabilities

**Server capabilities**
Capability           想使用的自动化引擎Appium 、Selendroid
platformName         平台的名称：iOS, Android, or FirefoxOS
platformVersion      移动设备的系统版本号，7.1, 4.4
deviceName           IOS：instruments -s devices，Android:随便写
app                  安装文件路径：/abs/path/to/my.apk or http://myapp.com/app.ipa
browserName          测试的web浏览器，如果是测app则忽略
newCommandTimeout    等待新命令的最长时间，超时后退出。默认是60s
autoLaunch           是否自动安装和启动,默认true
language             模拟器的语言设置
locale               模拟器的地区设置
udid                 设备号
orientation          模拟器的横竖屏设置
autoWebview          Move directly into Webview context
noReset              在当前session前不重置app状态
fullReset            ios删除文件夹，Android删除app数据。

**android only**
|`appActivity`|
 你要从你的应用包中启动的 Android Activity 名称。
它通常需要在前面添加 `.`  (如：使用`.MainActivity` 而不是 `MainActivity`) |`MainActivity`, `.Settings`|

|`appPackage`| 
你想运行的Android应用的包名|
比如`com.example.android.myApp`, `com.android.settings`|

|`appWaitActivity`| 
你想要等待启动的 Android Activity 名称|`SplashActivity`|

|`deviceReadyTimeout`| 
设置等待一个模拟器或真机准备就绪的超时时间|`5`|

|`androidCoverage`| 
用于执行测试的 instrumentation 类。
作为命令 `adb shell am instrument -e coverage true -w` 的 `-w` 参数。| `com.my.Pkg/com.my.Pkg.instrumentation.MyInstrumentation`|

|`enablePerformanceLogging`| 
(仅适用于 Chrome 和 webview) 开启 Chromedriver 的性能日志。 (默认 `false`) | `true`, `false`|

|`androidDeviceReadyTimeout`|
等待设备在启动应用后准备就绪的超时时间。以秒为单位。|如 `30`|

|`androidDeviceSocket`|
开发工具的 socket 名称。只有在被测应用是一个使用 Chromium 内核的浏览器时需要。 socket 会被浏览器打开，然后 Chromedriver 把它作为开发者                                         工具来进行连接。|如 `chrome_devtools_remote`|

|`avd`| 
需要启动的 AVD  (安卓虚拟设备) 名称。|如 `api19`|

|`avdLaunchTimeout`| 
以毫秒为单位，等待 AVD 启动并连接到 ADB 的超时时间。(默认值 `120000`)| `300000`|

|`avdReadyTimeout`| 
以毫秒为单位，等待 AVD 完成启动动画的超时时间。(默认值 `120000`)| `300000`|

|`avdArgs`| 
启动 AVD 时需要加入的额外的参数。|如 `-netfast`|

|`useKeystore`| 
使用一个自定义的 keystore 来对 apk 进行重签名。默认值 `false`|`true` or `false`|

|`keystorePath`| 
自定义 keystore 的路径。默认： ~/.android/debug.keystore|如 `/path/to.keystore`|

|`keystorePassword`| 
自定义 keystore 的密码。|如 `foo`|

|`keyAlias`| 
key 的别名 |如 `androiddebugkey`|
|`keyPassword`| 
key 的密码 |如 `foo`|

|`chromedriverExecutable`|
 webdriver 可执行文件的绝对路径 (如果 Chromium 核心提供了对应的 webdriver， 应该用它代替 Appium 自带的 webdriver) |`/abs/path/to/webdriver`|

|`autoWebviewTimeout`| 
以毫秒为单位，等待 Webview 上下文激活的时间。默认值 `2000`| 如 `4`|

|`intentAction`| 
用于启动 activity 的 intent action。 (默认值 `android.intent.action.MAIN`)| 如 `android.intent.action.MAIN`, `android.intent.action.VIEW`|

|`intentCategory`|
 用于启动 activity 的 intent category。 (默认值 `android.intent.category.LAUNCHER`)  | 如 `android.intent.category.LAUNCHER`,                                                                            `android.intent.category.APP_CONTACTS`

|`intentFlags`|
 用于启动 activity 的标识 ( flags )  (默认值 `0x10200000`)  | 如 `0x10200000`

|`optionalIntentArguments`| 
用于启动 activity 的额外 intent 参数。请查看 [Intent 参数](http://developer.android.com/tools/help/adb.html#IntentSpec) | 如 `--esn                                                                               <EXTRA_KEY>`, `--ez <EXTRA_KEY> <EXTRA_BOOLEAN_VALUE>`

|`dontStopAppOnReset`| 
在使用 adb 启动应用时不要停止被测应用的进程。如果被测应用是由另一个锚应用（anchor app）创建的，请把这个参数设置为 `false` 以允许锚应用                                             在使用 adb 启动被测应用时保持运行。换句话说，当 `dontStopAppOnReset` 设为 `true` 时，我们在 `adb shell am start` 命令中不会包含 `-S` 标志。                                                如果这个参数没有被设置或设为 `false`，我们会加入 `-S` 标志。默认值： `false`| `true` 或 `false`|

|`unicodeKeyboard`|
 使用 Unicode 输入法。默认值 `false`| `true` 或 `false`|

|`resetKeyboard`| 
在设定了 `unicodeKeyboard` 关键字的 Unicode 测试结束后，重置输入法到原有状态。如果单独使用，将会被忽略。默认值 `false`| `true` 或 `false`|

|`noSign`| 
跳过检查和对应用进行 debug 签名的步骤。只能在使用 UiAutomator 时使用，使用 selendroid 是不行。默认值 `false` | `true` 或 `false`|

|`ignoreUnimportantViews`| 
调用 uiautomator 的函数 `setCompressedLayoutHierarchy()`。由于 Accessibility 命令在忽略部分元素的情况下执行速度会加快，这个关键字能加                                                 快测试执行的速度。被忽略的元素将不能够被找到，因此这个关键字同时也被实现成可以随时改变的 *设置 ( settings ) * 。默认值 `false` | `true` 或                                                      `false`|

|`disableAndroidWatchers`| 
关闭 android 监测应用无响应（ANR）和崩溃（crash）的监视器，这能够在 android 设备/模拟器上减少 cpu 使用量。这个参数只能在使用                                                             UiAutomator 时工作，在使用 selendroid 时无效。默认值： `false`。| `true` 或者 `false`|

|`chromeOptions`| 
允许传入 chrome driver 使用的 chromeOptions 参数。请查阅 [chromeOptions](https://sites.google.com/a/chromium.org/chromedriver/capabilities) 了解更                                   多信息。| `chromeOptions: {args: [‘--disable-popup-blocking‘]}` |


**ios  only**
|`calendarFormat`| 
(Sim-only) 为iOS的模拟器设置日历格式|如 `gregorian` (公历) |

|`bundleId`| 
被测应用的 bundle ID 。用于在真实设备中启动测试，也用于使用其他需要 bundle ID 的关键字启动测试。在使用 bundle ID 在真实设备上执行测试时，你可以不提供 `app` 关键字，但你必须提供 `udid` 。|如 `io.appium.TestApp`|

|`udid`| 
连接的真实设备的唯一设备编号 ( Unique device identifier ) |如 `1ae203187fc012g`|

|`launchTimeout`|
 以毫秒为单位，在 Appium 运行失败之前设置一个等待 instruments 的时间 |比如： `20000`|

|`locationServicesEnabled`| 
(Sim-only) 强制打开或关闭定位服务。默认值是保持当前模拟器的设定|`true` 或 `false`|

|`locationServicesAuthorized`| 
(Sim-only) 通过修改 plist 文件设定是否允许应用使用定位服务，从而避免定位服务的警告出现。默认值是保持当前模拟器的设定。请注意在使用这个关键字时，你同时需要使用 `bundleId` 关键字来发送你的应用的 bundle ID。|`true` 或者 `false`|

|`autoAcceptAlerts`| 
当 iOS 的个人信息访问警告 (如 位置、联系人、图片) 出现时，自动选择接受( Accept )。默认值 `false`。|`true` 或者 `false`|

|`autoDismissAlerts`| 
当 iOS 的个人信息访问警告 (如 位置、联系人、图片) 出现时，自动选择不接受( Dismiss )。默认值 `false`。|`true` 或者 `false`|

|`nativeInstrumentsLib`| 
使用原生 intruments 库 (即关闭 instruments-without-delay ) |`true` 或者 `false`|

|`nativeWebTap`|
 (Sim-only) 在Safari中允许"真实的"，非基于 javascript 的 web 点击 (tap) 。 默认值： `false`。注意：取决于 viewport 大小/比例， 点击操作不一定能精确地点中对应的元素。|`true` 或者 `false`|

|`safariInitialUrl`| 
(Sim-only) (>= 8.1) Safari 的初始地址。默认值是一个本地的欢迎页面 | 例如： `https://www.github.com` |

|`safariAllowPopups`| 
(Sim-only) 允许 javascript 在 Safari 中创建新窗口。默认保持模拟器当前设置。|`true` 或者 `false`|

|`safariIgnoreFraudWarning`| 
(Sim-only) 阻止 Safari 显示此网站可能存在风险的警告。默认保持浏览器当前设置。|`true` 或者 `false`|

|`safariOpenLinksInBackground`|
 (Sim-only) Safari 是否允许链接在新窗口打开。默认保持浏览器当前设置。|`true` 或者 `false`|

|`keepKeyChains`|
 (Sim-only) 当 Appium 会话开始/结束时是否保留存放密码存放记录 (keychains)  (库(Library)/钥匙串(Keychains)) |`true` 或者 `false`|

|`localizableStringsDir`|
 从哪里查找本地化字符串。默认值 `en.lproj`|`en.lproj`|

|`processArguments`| 
通过 instruments 传递到 AUT 的参数 |如 `-myflag`|

|`interKeyDelay`| 
以毫秒为单位，按下每一个按键之间的延迟时间。|如 `100`|

|`showIOSLog`| 
是否在 Appium 的日志中显示设备的日志。默认值 `false`|`true` 或者 `false`|

|`sendKeyStrategy`| 
输入文字到文字框的策略。
模拟器默认值：`oneByOne` (一个接着一个) 。真实设备默认值：`grouped` (分组输入)  |`oneByOne`, `grouped` 或 `setValue`|

|`screenshotWaitTimeout`| 
以秒为单位，生成屏幕截图的最长等待时间。默认值： 10。 |如 `5`|

|`waitForAppScript`|
 用于判断 "应用是否被启动” 的 iOS 自动化脚本代码。默认情况下系统等待直到页面内容非空。结果必须是布尔类型。 |例如 `true;`, `target.elements().length > 0;`, `$.delay(5000); true;` |