capability参数配置
前言
本文为在霍格沃兹测试开发学社的学习经历分享
简介
- 功能：配置 Appium 会话，告诉 Appium 服务器需要自动化的平台的应用程序
- 形式：键值对的集合，键对应设置的名称，值对应设置的值
主要分为三部分
- 公共部分
- ios 部分
- android 部分
- session
- Appium 的客户端和服务端之间进行通信的前提
- 通过 Desired Capabilities 建立会话
公共部分参数配置
| 键 | 描述 | 值 |
|---|---|---|
| platformName | 使用的手机操作系统 | ios,Android |
| platformVersion | 手机操作系统的版本 | 例如6.0 |
| deviceName | 使用的手机或模拟器类型 | Android Emulator,Galaxy S4等等，可以通过adb devices查看设备列表 |
| automationName | 使用哪个自动化引擎 | android默认使用uiautomator2，ios默认使用XCUTest |
| noRest | 在当前session下不会重置应用的状态，默认为false | true,false |
| udid | 连接的真实设备唯一设备编号 |
Android特有的部分
| 键 | 描述 |
|---|---|
| appActivity | Activity的名字，从包中想要启动的android activity |
| appPackage | 运行的android应用包名 |
| appWaitActivity | 用于等待启动的Android Activity名称 |
| unicodeKeyboard | 启用Unicode输入，默认为false |
| dontStopAppOnReset | 首次启动的时候，不停止app |
| skipDeviceInitialization | 跳过安装，权限设置等操作 |
IOS独有
| 键 | 描述 |
|---|---|
| bundleId | 被测应用的bundle ID,用于在真实设备中启动测试，也用于使用其他需要bundle ID 的关键字启动测试。在使用此参数在真实的设备上执行测试时，可以不提供app关键字，当时必须提供udid |
| autoAcceptAlerts | 但ios的个人信息访问警告出现时，自动接收。默认false |
| showIOSLog | 是否在appium日志中显示从设备捕获的任何日志。默认false |
示例：
- API Demo 启动页配置
{
"platformName": "android",
"deviceName": "emulator-5554",
"appPackage": "io.appium.android.apis",
"appActivity": ".ApiDemos"
}
添加参数，提高用例的稳定性
{
"noReset": "true", // 不清空缓存信息
"dontStopAppOnReset": "true", // 首次启动的时候，不停止app
"skipDeviceInitialization": "true", // 跳过安装，权限设置等操作
"unicodeKeyBoard": "true" // 输入中文
}
Settings API
官网文档：http://appium.io/docs/cn/advanced-concepts/settings/#settings_1
使用方法：# caps['settings[waitForIdleTimeout]']= 0
capability进阶用法
- newCommandTimeout
设置appium请求等待最长时间，默认为60s，是appium发送请求的最大间隔时间
- udid
设备的唯一标识，是adb devices获取到的设备标识
- autoGrantPermissions
为软件授予弹窗权限，打开软件后，有时候会弹出一些权限授予的弹窗，可以通过设置这个参数去授予权限，不会影响到自动化测试的执行。默认为False
注意：如果设置了noReset 等于True的话，这个capability（功能）是不工作的。
- noRest
在安卓系统中，设置该参数为True的话，不停止软件，不会去清除软件的数据，不会去卸载软件。
- fullReset
让app完全保持干净状态，停止app，清空app缓存，在会话开始之前和测试之后会卸载app
- dontStopAppOnReset
不去重启app，由于启动app的操作，底层是通过adb命令来实现的，所以当该参数设置为True的时候，启动命令不会去加-S参数，如果为False，则会加上-S参数
原理：
- adb shell am start 包名/页面名 启动app，如果app已经启动，则不会再启动
- adb shell am start -S 包名/页面名 启动app，如果app已经启动，会先关掉app再启动
官方文档：https://appium.io/docs/en/writing-running-appium/caps/
- relaxed-security设置为true的话，可以在代码中使用adb命令
