Appium服务器初始化参数（Capability）

键

描述

​​automationName​​                                       

自动化测试的引擎

​​platformName​​

使用的手机操作系统

​​platformVersion​​

手机操作系统的版本

​​deviceName​​

使用的手机或模拟器类型

​​app​​

本地绝对路径_或_远程 URL 所指向的一个安装包（.ipa,.apk,或 .zip 文件）。Appium 将其安装到合适的设备上。请注意，如果您指定了 appPackage 和 appActivity 参数（见下文），Android 则不需要此参数了。该参数也与 browserName 不兼容。

​​browserName​​

做自动化时使用的浏览器名字。

​​newCommandTimeout​​

用于客户端在退出或者结束 session 之前，Appium 等待客户端发送一条新命令所花费的时间（秒为单位）

​​language​​

(Sim/Emu-only) 为模拟器设置语言

​​locale​​

(Sim/Emu-only) 为模拟器设置所在区域

​​udid​​

连接真机的唯一设备号

​​orientation​​

(Sim/Emu-only) 模拟器当前的方向

​​autoWebview​​

直接转换到 Webview 上下文（context）。

​​noReset​​

在当前 session 下不会重置应用的状态。​​True​​表示每次运行不重新启动

键

描述

值

​​appActivity​​                                                      

Activity 的名字是指从你的包中所要启动的 Android acticity。他通常需要再前面添加. （例如 使用 .​​MainActivity​​ 代替 MainActivity）

MainActivity, .Settings

​​appPackage​​

运行的 Android 应用的包名

com.example.android.myApp, com.android.settings

​​appWaitActivity​​

用于等待启动的 Android Activity 名称

SplashActivity

​​appWaitPackage​​

用于等待启动的 Android 应用的包

com.example.android.myApp, com.android.settings

​​appWaitDuration​​

用于等待 appWaitActivity 启动的超时时间（以毫秒为单位）（默认值为 20000)

30000

​​deviceReadyTimeout​​

用于等待模拟器或真机准备就绪的超时时间

5

​​androidCoverage​​

用于执行测试的 instrumentation 类。 传送 -w 参数到如下命令 ​​adb shell am instrument -e coverage true -w​​

​​com.my.Pkg/com.my.Pkg.instrumentation.MyInstrumentation​​

​​enablePerformanceLogging​​

（仅适用于 Chrome 与 webview）开启 Chromedriver 的性能日志。（默认值为 false）

true, false

​​androidDeviceReadyTimeout​​

用于等待设备在启动应用后准备就绪的超时时间。以秒为单位。

例如 30

​​androidInstallTimeout​​

用于等待在设备中安装 apk 所花费的时间（以毫秒为单位）。默认值为 90000

例如 90000

​​adbPort​​

用来连接 ADB 服务器的端口（默认值为 5037）

5037

​​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或false

​​keystorePath​​

自定义 keystore 的路径, 默认路径为 ~/.android/debug.keystore

例如 /path/to.keystore

​​keystorePassword​​

自定义 keystore 的密码

例如 foo

​​keyAlias​​

key 的别名

例如 androiddebugkey

​​keyPassword​​

key 的密码

例如 foo

​​chromedriverExecutable​​

webdriver 可执行文件的绝对路径（如果 Chromium 内嵌一个自己提供的 webdriver，则应使用他去替换掉 Appium 自带的 chromedriver）

/abs/path/to/webdriver

​​autoWebviewTimeout​​

用于等待 Webview 上下文（context）激活的时间（以毫秒为单位）。默认值为 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 参数

例如 ​​--esn <EXTRA_KEY>, --ez <EXTRA_KEY> <EXTRA_BOOLEAN_VALUE>​​, 等等。

​​dontStopAppOnReset​​

在使用 adb 启动应用之前，不要终止被测应用的进程。如果被测应用是被其他钩子(anchor)应用所创建的，设置该参数为 false 后，就允许钩子(anchor)应用的进程在使用 adb 启动被测应用期间仍然存在。换而言之，设置 dontStopAppOnReset 为 true 后，我们在 adb shell am start 的调用中不需要包含 -S标识（flag）。忽略该 capability 或 设置为 false 的话，就需要包含 -S 标识（flag）。默认值为 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 监视器（watchers）。监视器用于见识应用程序的无响应状态（anr）和崩溃（crash），禁用会降低 Android 设备或模拟器的 CPU 使用率。该 capability 仅在使用 UiAutomator 时有效，不适用于 selendroid，默认设置为 false。

true 或 false

​​chromeOptions​​

允许对 ChromeDriver 传 chromeOptions 的参数。了解更多信息请查阅 chromeOptions

​​chromeOptions: {args: ['--disable-popup-blocking']}​​

​​recreateChromeDriverSessions​​

当移除非 ChromeDriver webview时，终止掉 ChromeDriver 的 session。默认设置为 false

true或false

​​nativeWebScreenshot​​

在 web 的上下文（context），使用原生（native）的方法去截图，而不是用过代理的 ChromeDriver。默认值为 false

true或false

​​androidScreenshotPath​​

在设备中截图被保存的目录名。默认值为 /data/local/tmp

例如 ​​/sdcard/screenshots/​​

​​autoGrantPermissions​​

让Appium自动确定您的应用需要哪些权限，并在安装时将其授予应用。默认设置为 false

true或false