iOS_UI自动化02篇：Desired Capabilities

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自动化、接口、框架搭建学习资料！

点赞关注不迷路！！！【三连ღ】，有问题也可私聊哟~(*╹▽╹*)