Appium(五)：Desired Capabilities

1. Desired Capabilities

Desired Capabilities简单来说就是一组设置，这些设置可以让测试脚本控制Appium的运行行为。下面就逐个对Desired Capabilities中的设置进行阐述。首先看与Appium服务器相关的Capability，Android和iOS两个平台都是有效的设置。

基本参数：

automationName

自动化测试引擎

Appium或 Selendroid

platformName

手机操作系统

iOS, Android, 或 FirefoxOS

platformVersion

手机操作系统版本

如： android 10, 5.1.1；ios的 13.1

deviceName

手机或模拟器设备名称

android的如android，ios如iPhone Simulator

app

.ipa .apk文件路径

比如/abs/path/to/my.apk或http://myapp.com/app.ipa

browserName

启动手机浏览器

iOS如:Safari，Android如:Chrome,Chromium,Browser

newCommandTimeout

设置命令超时时间，单位：秒。

比如 60

autoLaunch

Appium是否需要自动安装和启动应用。默认值true

true, false

language

(Sim/Emu-only) 设定模拟器 ( simulator / emulator ) 的语言。

如： fr

locale

(Sim/Emu-only) 设定模拟器 ( simulator / emulator ) 的区域设置。

如： fr_CA

udid

ios真机的唯一设备标识

如： 1ae203187fc012g

orientation

设置横屏或竖屏

LANDSCAPE (横向) 或 PORTRAIT (纵向)

autoWebview

直接转换到 WebView 上下文。 默认值 false、

true, false

noReset

不要在会话前重置应用状态。默认值false。

true, false

fullReset

(iOS) 删除整个模拟器目录。(Android)通过卸载默认值 false

true, false

仅对Android测试有效的设置：

关键字

描述

实例

appActivity

启动app包,一般点开头

如：.MainActivity, .Settings

appPackage

Android应用的包名

比如com.example.android.myApp

appWaitActivity

等待启动的Activity名称

SplashActivity

deviceReadyTimeout

设置超时时间

5

androidCoverage

用于执行测试的 instrumentation类

com.my.Pkg/com.my.Pkg.instrumentation.MyInstrumentation

enablePerformanceLogging

(仅适用于 Chrome 和 webview) 开启 Chromedriver 的性能日志。(默认 false)

true, false

androidDeviceReadyTimeout

等待设备在启动应用后超时时间，单位秒

如 30

androidDeviceSocket

开发工具的 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 or false

keystorePath

自定义keystore路径。默认~/.android/debug.keystore

如 /path/to.keystore

keystorePassword

自定义 keystore 的密码。

如 foo

keyAlias

key 的别名

如 androiddebugkey

keyPassword

key 的密码

如 foo

chromedriverExecutable

webdriver可执行文件的绝对路径 应该用它代替Appium 自带的 webdriver)

/abs/path/to/webdriver

autoWebviewTimeout

毫秒为单位，Webview上下文激活的时间。默认2000

如 4

intentAction

用于启动activity的intent action。(默认值 android.intent.action.MAIN)

如 android.intent.action.MAIN, android.intent.action.VIEW

intentCategory

用于启动 activity 的 intent category。 (默认值 android.intent.category.LAUNCHER)

如 android.intent.category.LAUNCHER, android.intent.category.APP_CONTACTS

intentFlags

用于启动activity的标识(flags) (默认值 0x10200000)

如 0x10200000

optionalIntentArguments

用于启动 activity 的额外 intent 参数。请查看 Intent 参数

如 --esn <EXTRA_KEY>, --ez <EXTRA_KEY> <EXTRA_BOOLEAN_VALUE>

dontStopAppOnReset

在使用 adb 启动应用时不要停止被测应用的进程。默认值： false

true 或 false

unicodeKeyboard

使用 Unicode 输入法。默认值 false

true 或 false

resetKeyboard

重置输入法到原有状态，默认值 false

true 或 false

noSign

跳过检查和对应用进行 debug 签名的步骤。默认值 false

true 或 false

ignoreUnimportantViews

调用 uiautomator 的函数这个关键字能加快测试执行的速度。默认值 false

true 或 false

disableAndroidWatchers

关闭 android 监测应用无响ANR和崩溃crash的监视器默认值： false。

true 或者 false

chromeOptions

允许传入 chrome driver 使用的 chromeOptions 参数。请查阅 chromeOptions 了解更多信息。

chromeOptions: {args: [‘--disable-popup-blocking‘]}

仅对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;

我们开发主要使用的Capability包括platformName、platformVersion、appPackage、appActivity、unicodeKeyboard、 resetKeyboard和newCommandTimeout。这些Capability基本上已经满足了目前的测试需求。

 

原文作者：@小灰灰
本文为作者原创，转载请注明出处：https://www.cnblogs.com/liuhui0308/p/12018608.html

 

posted @ 2020-09-17 15:37  嗨不错喽  阅读(203)  评论(0)  编辑  收藏  举报