appium之Capability参数说明

Capability

通用Capability

字段	描述	参考
platformName	手机操作系统	IOS, Android
platformVersion	手机版本号	7.1, 10
deviceName	手机型号	iPhone Simulator, Galaxy S4
app	指向的一个app安装包, .ipa 、.apk、.zip文件, appium将其安装到该设备上, 如果指定了appPackage 和appActivity参数, Android则不需要此参数	/abs/path/my.apk 或 http://myapp.com/app.ipa
nweCommandTimeout	用于客户端在退出或结束session之前, Appium等待客户端发送一条新命令所花费的时间, 单位秒	10
orientation	模拟器的方向	LANDSCAPE (横向) 或 PORTRAIT (纵向)
autoWebview	直接转换到 WebView 上下文。 默认值 false	true, false
noReset	不要在会话前重置应用状态。默认值false。	true, false
fullReset	(iOS) 删除整个模拟器目录。(Android)通过卸载默认值 false	true, false

Android特有

字段	描述	参考
appActivity	apk的launcherActivity	如：.MainActivity, .Settings
appPackage	安卓应用的包名	com.kuaidaan.app
appWaitActivity	等待启动的Activity名称	SplashActivity
deviceReadyTimeout	设置超时时间	5
androidDeviceReadyTimeout	等待设备在启动应用后超时时间，单位秒	如 30
unicodeKeyboard	使用 Unicode 输入法。默认值 false	true 或 false
resetKeyboard	重置输入法到原有状态，默认值 false	true 或 false

iOS特有

字段	描述	参考
calendarFormat	(Sim-only) 为iOS的模拟器设置日历格式	如 gregorian (公历)
bundleId	被测应用的bundle ID，真机上执行测试时，你可以不提供 app 关键字，但你必须提供udid	如 io.appium.TestApp
udid	连接真机的唯一设备编号 ( Unique device identifier )	如 1ae203187fc012g
launchTimeout	以毫秒为单位，在Appium运行失败之前设置一个等待 instruments的时间	比如： 20000
locationServicesEnabled	(Sim-only) 强制打开或关闭定位服务。默认值是保持当前模拟器的设定	true 或 false
locationServicesAuthorized	使用这个关键字时，你同时需要使用 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中允许"真实的"，默认值： 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;