android自动化之desired capabilities（启动一个app会话）
desired capabilities是一些发送给appium服务器的键值对集合，高速服务器我们想要启动什么类型的自动化会话。还有各种可以再自动化运行时修改服务器行为的capabilities。例如，我们可以吧platformName capability设置为ios，告诉appium我们想要IOS会话，而不是Android或者windows会话。
Appium服务器初始化参数：
官网链接：https://appium.io/docs/cn/writing-running-appium/caps/
| 键 | 描述 | 值 |
|---|---|---|
automationName |
自动化测试的引擎 | Appium （默认）或者 Selendroid |
platformName |
使用的手机操作系统 | iOS, Android, 或者 FirefoxOS |
platformVersion |
手机操作系统的版本 | 例如 7.1, 4.4 |
deviceName |
使用的手机或模拟器类型 | iPhone Simulator, iPad Simulator, 等等.... 在 iOS 上，使用 Instruments 的 instruments -s devices 命令可返回一个有效的设备的列表。在 Andorid 上虽然这个参数目前已被忽略，但仍然需要添加上该参数 |
app |
本地绝对路径_或_远程 http URL 所指向的一个安装包（.ipa,.apk,或 .zip 文件）。Appium 将其安装到合适的设备上。请注意，如果您指定了 appPackage 和 appActivity 参数（见下文），Android 则不需要此参数了。该参数也与 browserName 不兼容。 |
/abs/path/to/my.apk 或 http://myapp.com/app.ipa |
browserName |
做自动化时使用的浏览器名字。如果是一个应用则只需填写个空的字符串 | 'Safari' 对应 iOS，'Chrome', 'Chromium', 或 'Browser' 则对应 Android |
newCommandTimeout |
用于客户端在退出或者结束 session 之前，Appium 等待客户端发送一条新命令所花费的时间（秒为单位） | 例如 60 |
language |
(Sim/Emu-only) 为模拟器设置语言 | 例如 fr |
locale |
(Sim/Emu-only) 为模拟器设置所在区域 | 例如 fr_CA |
udid |
连接真机的唯一设备号 | 例如 1ae203187fc012g |
orientation |
(Sim/Emu-only) 模拟器当前的方向 | 竖屏 或 横屏 |
autoWebview |
直接转换到 Webview 上下文（context）。默认值为 false |
true, false |
noReset |
在当前 session 下不会重置应用的状态。默认值为 false |
true, false |
fullReset |
(iOS)删除所有的模拟器文件夹。(Android) 要清除 app 里的数据，请将应用卸载才能达到重置应用的效果。在 Android, 在 session 完成之后也会将应用卸载掉。默认值为 false |
true, false |
Android 独有的常用参数如下：
| 键 | 描述 | 值 |
|---|---|---|
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 |
|
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) |
例如 |
intentCategory |
用于启动 activity 的 intent category。（默认值为android.intent.category.LAUNCHER) |
例如 |
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 |
iOS 独有
<expand_table>
| 键 | 描述 | 值 |
|---|---|---|
calendarFormat |
（仅支持模拟器） 为iOS的模拟器设置日历格式 | 例如 gregorian |
bundleId |
被测应用的 bundle ID 。用于在真实设备中启动测试，也用于使用其他需要 bundle ID 的关键字启动测试。在使用 bundle ID 在真实设备上执行测试时，你可以不提供 app 关键字，但你必须提供 udid 。 |
例如 io.appium.TestApp |
udid |
连接的真实设备的唯一设备编号 (Unique device identifier) | 例如 1ae203187fc012g |
launchTimeout |
以毫秒为单位，在 Appium 运行失败之前设置一个等待 instruments 的时间 | 例如 20000 |
locationServicesEnabled |
（仅支持模拟器）强制打开或关闭定位服务。默认值是保持当前模拟器的设定. | true或false |
locationServicesAuthorized |
（仅支持模拟器）通过修改 plist 文件设定是否允许应用使用定位服务，从而避免定位服务的警告出现。默认值是保持当前模拟器的设定。请注意在使用这个关键字时，你同时需要使用 bundleId 关键字来发送你的应用的 bundle ID。 |
true或false |
autoAcceptAlerts |
当警告弹出的时候，都会自动去点接受。包括隐私访问权限的警告（例如 定位，联系人，照片）。默认值为 false。不支持基于 XCUITest的测试。 |
true或false |
autoDismissAlerts |
当警告弹出的时候，都会自动去点取消。包括隐私访问权限的警告（例如 定位，联系人，照片）。默认值为 false。不支持基于 XCUITest的测试。 |
true或false |
nativeInstrumentsLib |
使用原生 intruments 库（即关闭 instruments-without-delay）。 | true或false |
nativeWebTap |
（仅支持模拟器）在Safari中允许“真实的"，非基于 javascript 的 web 点击 (tap) 。 默认值：false。注意：取决于 viewport 大小/比例， 点击操作不一定能精确地点中对应的元素。 |
true或false |
safariInitialUrl |
（仅支持模拟器） (>= 8.1) 初始化 safari 的时使用的地址。默认是一个本地的欢迎页面 | 例如 https://www.github.com |
safariAllowPopups |
（仅支持模拟器）允许 javascript 在 Safari 中创建新窗口。默认保持模拟器当前设置。 | true或false |
safariIgnoreFraudWarning |
（仅支持模拟器）阻止 Safari 显示此网站可能存在风险的警告。默认保持浏览器当前设置。 | true或false |
safariOpenLinksInBackground |
（仅支持模拟器）Safari 是否允许链接在新窗口打开。默认保持浏览器当前设置。 | true或false |
keepKeyChains |
（仅支持模拟器）当 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; |
webviewConnectRetries |
用于获取 webview 失败时，发送连接信息到远程调试器的次数。默认次数为: 8 |
例如 12 |
appName |
被测应用的名字。 用于支持 iOS 9 以上系统的应用的自动化。 | 例如 UICatalog |
customSSLCert |
(Sim/Emu-only) 给模拟器添加一个 SSL 证书。 | 例如 -----BEGIN CERTIFICATE-----MIIFWjCCBEKg...-----END CERTIFICATE----- |
capabilities示例：
在python中，讲这些配置信息存储在字典当中。
如下
def get_desired_capabilities():
desired_caps = {
'platformName': 'Android',
'platformVersion': '7.0',
'deviceName': 'V889F',
'appPackage': 'com.alibaba.mts.mtsdemoapp',
'appWaitPackage': 'com.alibaba.mts.mtsdemoapp',
'app': 'D:/home/mdp/result/GroovyTest/case1/task.apk',
'newCommandTimeout': 30,
'automationName': 'Appium'
}
return desired_caps
def get_uri():
return "http://127.0.0.1:4723/wd/hub"
引起和结束一个app会话的代码示例：
from appium import webdriver
# 引入刚刚创建的同目录下的desired_capabilities.py
import desired_capabilities
# 我们使用python的unittest作为单元测试工具
import unittest
import time
class MqcTest(TestCase):
global automationName
def setUp(self):
# 获取我们设定的capabilities，通知Appium Server创建相应的会话。
desired_caps = desired_capabilities.get_desired_capabilities()
# 获取server的地址。
uri = desired_capabilities.get_uri()
# 获取使用的测试框架
self.automationName = desired_caps.get('automationName')
# 创建会话，得到driver对象，driver对象封装了所有的设备操作。下面会具体讲。
self.driver = webdriver.Remote(uri, desired_caps)
def tearDown(self):
# 测试结束，退出会话。
self.driver.quit()
测试狗一枚
