Desired Capabilities
Desired Capabilities在启动session的时候是必须提供的。Desired Capabilities本质上是以键值对方式存放的一个JSON对象,客户端将这些键值对发给服务端,告诉服务端我们希望怎么进行测试。
如下是一些很重要的配置:
{
"platformName": "iOS",
"platformVersion": "11.0",
"deviceName": "iPhone 7",
"automationName": "XCUITest",
"app": "/path/to/my.app"
}
复制代码
这一组配置告诉appium在一个系统为iOS11.0的iphone7模拟器上使用XCUITest驱动,运行"/path/to/my.app"这个APP进行自动化测试。
注:在真机上测试,需要多指定udid、xcodeOrgld、xcodeSigningId三个属性。
General Capabilities
Capability | Description | Values |
---|---|---|
automationName | 使用哪种自动化引擎 | Andriod使用Appium(默认)或UiAutomator2或Espresso;iOS使用XCUITest;使用You.i 编写的应用程序使用YouiEngine |
platformName | 使用哪种移动平台 | Andriod、iOS或FirefoxOS |
platformVersion | 移动平台系统版本 | eg:7.1,11.0 |
deviceName | 使用哪种设备,真机还是模拟器 | iPhone Simulator, iPad Simulator, iPhone Retina 4-inch, Android Emulator, Galaxy S4, etc.... |
app | apk、.ipa或包含apk或ipa的.zip文件的本地绝对路径或远程http URL。Appium将尝试在适当的设备上安装这个应用程序的二进制文件。注意:如果Android指定了appPackage和appActivity参数,则该参数不是必须的。和browserName不兼容。 | eg: /abs/path/to/my.apk 或 myapp.com/app.ipa |
otherApps | 在测试之前需要安装的一些app,注:这个配置对automationName为Espresso和iOS真机上没有用 | e.g., "/path/to/app.apk", www.example.com/url/to/app.…, ["appium.github.io/appium/asse…", "/path/to/app-b.app"] |
browserName | 需要测试的手机浏览器,如果是APP则为空 | 'Safari' (iOS)和 'Chrome', 'Chromium', 或 'Browser' (Android) |
newCommandTimeout | 在下一个命令执行之前的等待最大时长。单位为秒。 | eg:60 |
language | 语言 | e.g. fr |
locale | 定位 | e.g. fr_CA, CA |
udid | 连接设备的唯一标识符 | e.g. 1ae203187fc012g |
orientation | (Sim / Emu-only)从某个特定方向开始 | LANDSCAPE、PORTRAIT |
autoWebview | 直接进入Webview上下文。默认false | true、false |
noReset | 在开始会话之前不要重置应用程序状态 | true、false |
fullReset | 执行完整的重置操作 | true、false |
eventTimings | Appium提供了一个能力,可以获取关于启动信息和命令执行时间的计时信息。这是由eventTimings这个初始化参数控制的高级功能(把这个参数设置为true来记录事件的计时信息)。打开这个参数,GET/session/:id这个接口的响应结果(也就是,driver.getSessionDetails()的响应结果,或者类似的,取决于客户端实现)中会包含events属性 | eg:true |
enablePerformanceLogging | (仅限Web和webview)启用Chromedriver(Android)或Safari(iOS)性能记录(默认false) | true、false |
printPageSourceOnFindFailure | 当一个操作失败时,打印当前页面的源代码信息。默认False | true、false |
clearSystemFiles | session结束时删除所有系统文件,默认false | true、false |
只限iOS
Capability | Description | Values |
---|---|---|
calendarFormat | (仅限SIM)为iOS模拟器设置的日历格式 | eg:gregorian |
bundleId | 测试中的应用程序的BundleID。用于在设备上启动应用程序。在真实设备上执行测试使用BundleID时,可以省略app参数,但是必须提供udid参数 | eg:io.appium.TestApp |
launchTimeout | instruments 挂起或失败后启动的等待时间。单位毫秒 | eg:20000 |
locationServiceEnabled | (仅限SIM)强制定位服务处于打开或关闭状态。默认是保持当前的模拟设置 | true、false |
lacationServiceAuthorized | (Sim-only) 通过修改 plist 文件设定是否允许应用使用定位服务,从而避免定位服务的警告出现。默认值是保持当前模拟器的设定。请注意在使用这个关键字时,你同时需要使用 bundleId 关键字来发送你的应用的 bundle ID | true、false |
autoAcceptAlerts | 自动确认所有iOS弹出提示。这包括隐私访问权限提醒(例如:位置,联系人,照片)。默认是false | true、false |
autoDismissAlerts | 自动取消所有iOS弹出提示。这包括隐私访问权限提醒(例如:位置,联系人,照片)。默认是false。 | true、false |
nativeInstrumentsLib | 使用原生 intruments 库 (即关闭 instruments-without-delay ) | true、false |
nativeWebTap | (仅限SIM)在Safari上使用非JavaScript实现的web tap 操作。默认:false。警告:取决于viewport的大小/比例,这可能无法准确地点击一个元素 | true、false |
safariInitialUrl | (仅限SIM)(> = 8.1)初始Safari浏览器网址,默认为本地欢迎页面 | eg:www.github.com |
safariAllowPopups | (仅限Sim)允许JavaScript在Safari中打开新窗口。默认保持当前的模拟设置 | true、false |
safariIgnoreFraudWarning | (仅限SIM)防止Safari显示欺诈网站警告。默认保持当前的模拟设置 | true、false |
safariOpenLinksInBackground | (仅限SIM)Safari是否应允许在新窗口中打开链接。默认保持当前的模拟设置 | true、false |
keepKeyChains | (Sim-only) 当 Appium 会话开始/结束时是否保留存放密码存放记录 (keychains) (库(Library)/钥匙串(Keychains)) | true、false localizableStringsDir |
interKeyDelay | 以毫秒为单位,按下每一个按键之间的延迟时间 | eg:100 |
showIOSLog | 是否在 Appium 的日志中显示设备的日志。默认值false | true、false |
sendKeysStrategy | 输入文字到文字框的策略。模拟器默认值:oneByOne(一个接着一个) 。真实设备默认值:grouped (分组输入) | oneByOne,grouped或者setValue |
screenshotWaitTimeout | 以秒为单位,生成屏幕截图的最长等待时间。默认值10 | eg:5 |
waitForAppScript | 用于判断 "应用是否被启动” 的 iOS 自动化脚本代码。默认情况下系统等待直到页面内容非空。结果必须是布尔类型 | eg:’true;’、’target.elements().length > 0;’、’$.delay(5000); true;’ |
webviewConnectRetries | 向远程调试器发送连接消息以获取webview的次数。默认:8 | eg:12 |
appName | 被测应用程序的显示名称。用于在iOS 9+在后台自动化应用程序 | eg:UICatalog |
customsSSLCert | (仅限Sim)向模拟器添加SSL证书 | e.g. -----BEGIN CERTIFICATE-----MIIFWjCCBEKg...-----END CERTIFICATE----- |
webkitResponseTimeout | (仅限真实设备)设置时间(以毫秒为单位)以等待Safari会话中WebKit的响应。默认为5000 | eg:10000 |
remoteDebugProxy | 远程调试代理(sim-only,<=11.2) | e.g. 12000 or "/tmp/my.proxy.socket" |
enableAsyncExecuteFromHttps | 允许模拟器在使用https的页面里执行异步JavaScript,默认false | true、false |
skipLogCapture | 跳过抓取log,默认false | true、false |
webkitDebugProxyPort | (只限真实设备) ios-webkit-debug-proxy连接的端口,默认是27753 | 12021 |
最后
俺叫小枫,一个成天想着一夜暴富的测试员
(1140267353)一起成长一起加油的伙伴群!软件测试,与你同行!
群内可领取最新软件测试大厂面试资料和Python自动化、接口、框架搭建学习资料!
点赞关注不迷路!!!【三连ღ】,有问题也可私聊哟~(*╹▽╹*)