当前位置:   article > 正文

Appium Desired Capabilities_desired capabilities-appium官网

desired capabilities-appium官网

简介

Appium Desired Capabilities官方文档:http://appium.io/docs/en/writing-running-appium/caps/
或者在gitHub上查看:https://github.com/appium/appium/blob/master/docs/cn/writing-running-appium/caps.md
Desired Capabilities是一组设置的键值对的集合,是对Appium会话进行配置,传达给服务器所需自动化的平台和应用程序,通知Appium Server建立所需要的Session信息

例:

{
    "platformName": "iOS",
    "platformVersion": "11.0",
    "deviceName": "iPhone 7",
    "automationName": "XCUITest",
    "app": "/path/to/my.app"}

  这组设置就是表明运行平台IOS系统,平台版本11.0,设备名称iPhone7,使用ios的XCITest驱动运行程序/path/to/my.app

appium-desktop 中设置

  点击【start server v xxx】启动appium-desktop后点击右上角放大镜图标。

    

  进入设置Desired Capabilities。配置Appium session,设置Capabilities,如下图,启动会话对app进行操作

  

脚本中进行设置

  如下脚本:  

from appium import webdriver

caps = {}
caps["platformName"] = "Android"
caps["deviceName"] = "32"
caps["appPackage"] = "com.tencent.qqlite"
caps["appActivity"] = "com.tencent.mobileqq.activity.RegisterGuideActivity"

driver = webdriver.Remote("http://localhost:4723/wd/hub", caps)

el1 = driver.find_element_by_id("com.tencent.qqlite:id/btn_login")
el1.click()
el2 = driver.find_element_by_accessibility_id("请输入QQ号码或手机或邮箱")
el2.send_keys("xxxxxxxxxx")
el3 = driver.find_element_by_accessibility_id("请输入密码")
el3.send_keys("xxxxxxxxxxx")
el4 = driver.find_element_by_accessibility_id("登录QQ")
el4.click()

driver.quit()

 

Capability 参数

  以下设置来源于gitHub:https://github.com/appium/appium/blob/master/docs/cn/writing-running-appium/caps.md

            Appium 服务器初始化参数(Capability)

  公有

  <expand_table>

描述
automationName自动化测试的引擎Appium (默认)或者 Selendroid
platformName使用的手机操作系统iOSAndroid, 或者 FirefoxOS
platformVersion手机操作系统的版本例如 7.14.4
deviceName使用的手机或模拟器类型iPhone SimulatoriPad SimulatoriPhone Retina 4-inchAndroid EmulatorGalaxy S4, 等等.... 在 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)。默认值为 falsetruefalse
noReset在当前 session 下不会重置应用的状态。默认值为 falsetruefalse
fullReset(iOS)删除所有的模拟器文件夹。(Android) 要清除 app 里的数据,请将应用卸载才能达到重置应用的效果。在 Android, 在 session 完成之后也会将应用卸载掉。默认值为 falsetruefalse

  

  Android 独有

  <expand_table>

描述
appActivityActivity 的名字是指从你的包中所要启动的 Android acticity。他通常需要再前面添加. (例如 使用 .MainActivity 代替 MainActivityMainActivity.Settings
appPackage运行的 Android 应用的包名com.example.android.myAppcom.android.settings
appWaitActivity用于等待启动的 Android Activity 名称SplashActivity
appWaitPackage用于等待启动的 Android 应用的包com.example.android.myAppcom.android.settings
appWaitDuration用于等待 appWaitActivity 启动的超时时间(以毫秒为单位)(默认值为 20000)30000
deviceReadyTimeout用于等待模拟器或真机准备就绪的超时时间5
androidCoverage用于执行测试的 instrumentation 类。 传送 -w 参数到如下命令 adb shell am instrument -e coverage true -wcom.my.Pkg/com.my.Pkg.instrumentation.MyInstrumentation
enablePerformanceLogging(仅适用于 Chrome 与 webview)开启 Chromedriver 的性能日志。(默认值为 falsetruefalse
androidDeviceReadyTimeout用于等待设备在启动应用后准备就绪的超时时间。以秒为单位。例如 30
androidInstallTimeout用于等待在设备中安装 apk 所花费的时间(以毫秒为单位)。默认值为 90000例如 90000
adbPort用来连接 ADB 服务器的端口(默认值为 50375037
androidDeviceSocket开发工具的 socket 名称。只有在被测应用是一个使用 Chromium 内核的浏览器时才需要。socket 会被浏览器打开,然后 Chromedriver 把它作为开发者工具来进行连接。例如 chrome_devtools_remote
avd被启动 avd 的名字例如 api19
avdLaunchTimeout用于等待 avd 启动并连接 ADB 的超时时间(以毫秒为单位),默认值为 120000300000
avdReadyTimeout用于等待 avd 完成启动动画的超时时间(以毫秒为单位),默认值为 120000300000
avdArgs启动 avd 时使用的额外参数例如 -netfast
useKeystore使用自定义的 keystore 给 apk 签名,默认值为 falsetruefalse
keystorePath自定义 keystore 的路径, 默认路径为 ~/.android/debug.keystore例如 /path/to.keystore
keystorePassword自定义 keystore 的密码例如 foo
keyAliaskey 的别名例如 androiddebugkey
keyPasswordkey 的密码例如 foo
chromedriverExecutablewebdriver 可执行文件的绝对路径(如果 Chromium 内嵌一个自己提供的 webdriver,则应使用他去替换掉 Appium 自带的 chromedriver)/abs/path/to/webdriver
autoWebviewTimeout用于等待 Webview 上下文(context)激活的时间(以毫秒为单位)。默认值为 2000例如 4
intentAction用于启动 activity 的 intent action(默认值为 android.intent.action.MAIN)例如 android.intent.action.MAINandroid.intent.action.VIEW
intentCategory用于启动 activity 的 intent category。(默认值为 android.intent.category.LAUNCHER)例如 android.intent.category.LAUNCHERandroid.intent.category.APP_CONTACTS
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)。默认值为 falsetruefalse
unicodeKeyboard使用 Unicode 输入法。 默认值为 falsetruefalse
resetKeyboard在设定了 unicodeKeyboard 关键字的 Unicode 测试结束后,重置输入法到原有状态。如果单独使用,将会被忽略。默认值为 falsetruefalse
noSign跳过检查和对应用进行 debug 签名的步骤。仅适用于 UiAutomator,不适用于 selendroid。 默认值为 falsetruefalse
ignoreUnimportantViews调用 uiautomator 的函数 setCompressedLayoutHierarchy()。由于 Accessibility 命令在忽略部分元素的情况下执行速度会加快,这个关键字能加快测试执行的速度。被忽略的元素将不能够被找到,因此这个关键字同时也被实现成可以随时改变的 设置 ( settings )。 默认值为 falsetrue 或 false
disableAndroidWatchers禁用 android 监视器(watchers)。监视器用于见识应用程序的无响应状态(anr)和崩溃(crash),禁用会降低 Android 设备或模拟器的 CPU 使用率。该 capability 仅在使用 UiAutomator 时有效,不适用于 selendroid,默认设置为 falsetrue 或 false
chromeOptions允许对 ChromeDriver 传 chromeOptions 的参数。了解更多信息请查阅 chromeOptionschromeOptions: {args: ['--disable-popup-blocking']}
recreateChromeDriverSessions当移除非 ChromeDriver webview时,终止掉 ChromeDriver 的 session。默认设置为 falsetruefalse
nativeWebScreenshot在 web 的上下文(context),使用原生(native)的方法去截图,而不是用过代理的 ChromeDriver。默认值为 falsetruefalse
androidScreenshotPath在设备中截图被保存的目录名。默认值为 /data/local/tmp例如 /sdcard/screenshots/
autoGrantPermissions让Appium自动确定您的应用需要哪些权限,并在安装时将其授予应用。默认设置为 falsetruefalse

 

  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(仅支持模拟器)强制打开或关闭定位服务。默认值是保持当前模拟器的设定.truefalse
locationServicesAuthorized(仅支持模拟器)通过修改 plist 文件设定是否允许应用使用定位服务,从而避免定位服务的警告出现。默认值是保持当前模拟器的设定。请注意在使用这个关键字时,你同时需要使用 bundleId 关键字来发送你的应用的 bundle ID。truefalse
autoAcceptAlerts当警告弹出的时候,都会自动去点接受。包括隐私访问权限的警告(例如 定位,联系人,照片)。默认值为 false。不支持基于 XCUITest 的测试。truefalse
autoDismissAlerts当警告弹出的时候,都会自动去点取消。包括隐私访问权限的警告(例如 定位,联系人,照片)。默认值为 false。不支持基于 XCUITest 的测试。truefalse
nativeInstrumentsLib使用原生 intruments 库(即关闭 instruments-without-delay)。truefalse
nativeWebTap(仅支持模拟器)在Safari中允许“真实的",非基于 javascript 的 web 点击 (tap) 。 默认值:false。注意:取决于 viewport 大小/比例, 点击操作不一定能精确地点中对应的元素。truefalse
safariInitialUrl(仅支持模拟器) (>= 8.1) 初始化 safari 的时使用的地址。默认是一个本地的欢迎页面例如 https://www.github.com
safariAllowPopups(仅支持模拟器)允许 javascript 在 Safari 中创建新窗口。默认保持模拟器当前设置。truefalse
safariIgnoreFraudWarning(仅支持模拟器)阻止 Safari 显示此网站可能存在风险的警告。默认保持浏览器当前设置。truefalse
safariOpenLinksInBackground(仅支持模拟器)Safari 是否允许链接在新窗口打开。默认保持浏览器当前设置。truefalse
keepKeyChains(仅支持模拟器)当 Appium 会话开始/结束时是否保留存放密码存放记录 (keychains) 库(Library)/钥匙串(Keychains))truefalse
localizableStringsDir从哪里查找本地化字符串。默认值为 en.lprojen.lproj
processArguments通过 instruments 传递到 AUT 的参数例如 -myflag
interKeyDelay以毫秒为单位,按下每一个按键之间的延迟时间例如 100
showIOSLog是否在 Appium 的日志中显示设备的日志。默认值为 falsetruefalse
sendKeyStrategy输入文字到文字框的策略。模拟器默认值:oneByOne(一个接着一个)。真实设备默认值:grouped (分组输入)oneByOnegroupedsetValue
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-----

 

  使用 XCUITest(iOS 独有)

  <expand_table>

描述
processArguments将会传送到 WebDriverAgent 的进程参数与环境{ args: ["a", "b", "c"] , env: { "a": "b", "c": "d" } } 或 '{"args": ["a", "b", "c"], "env": { "a": "b", "c": "d" }}'
wdaLocalPort如果这个值被指定了,Mac 主机就会使用这个端口,通过 USB 发送数据到 iOS 设备中。默认的端口与 iOS 设备中 WDA 的端口号是一致的。例如 8100
showXcodeLog是否显示运行测试时 Xcode 的输出日志,如果值设置为 true ,则会在启动的时候产生大量的额外日志。默认设置为 false例如 true
iosInstallPause安装应用程序与启动 WebDriverAgent 之间停止的间隔时间(以毫秒为单位),特别适用于体积较大的包。默认是设置为 0例如 8000
xcodeConfigFile一个可选的 Xcode 可配置文件的完整路径,用于指定在真机上运行 WebDriverAgent 的个人身份或者团队身份的代码签名。例如 /path/to/myconfig.xcconfig
keychainPath从系统的 keychain 中导出私有开发秘钥的完整路径。在真机测试时与 keychainPassword 配合使用。例如 /path/to/MyPrivateKey.p12
keychainPassword在 keychainPath 中指定 keychain 的解锁密码。例如 super awesome password
scaleFactor模拟器缩放因子。这对于默认分辨率是大于实际分辨的模拟器来说非常有用。因此,你不用上下滑动模拟器的屏幕就能看到所有模拟器显示的内容了。可接受的值为: '1.0', '0.75', '0.5', '0.33' 和 '0.25'。 这些值都应该是一个字符串
preventWDAAttachments设置 WebDriverAgent 项目中的 DerivedData 文件夹的权限为仅可读。为了防止 XCTest 框架产生大量无用的截屏与日志,该设置是非常必要的,因为这是不可能通过 Apple 提供的接口去关闭的。设置 capabilitity 为 true 将会设置 Posix 的文件夹的权限为 555,设置为 false 则会将权限重置回 755
webDriverAgentUrl若提供了 URL,Appium 将在这 URL 上连接现有的 WebDriverAgent 实例,而不是重新启动一个。例如 http://localhost:8100
useNewWDA若设置为 true,则直接卸载设备上现存的所有 WebDriverAgent 客户端。在某些情况,该做法可以提高稳定性。默认设置为 false例如 true
wdaLaunchTimeout等待 WebDriverAgent 可 ping 同的时间(以毫秒为单位)。默认设置为 60000ms。例如 30000
calendarAccessAuthorized若设置为 true,则允许在 iOS 模拟器上访问日历。若设置为 false,则不被允许。否则,日历的 authorizationStatus 会保持不变。-

 

  You.i 引擎独有

  <expand_table>

描述
youiEngineAppAddress正在运行的应用的设备的 IP 地址。使用 localhost 作为模拟地址。使用 localhost 作为模拟器地址。使用设备的 IP 地址作为真机的 IP。例如 localhost 或 192.168.1.203

 

  WinAppDriver 独有

  <expand_table>

描述
platformName运行测试时所在的平台例如 Windows
deviceName运行测试时所使用设备的名字例如 WindowsPC
app被测 windows 应用的 appID 或被测的 .exe 文件的路径。 查阅该文档可了解更多查找 appID 的详细方法。例如 c24c8163-548e-4b84-a466-530178fc0580_scyf5npe3hv32!App

 

声明:本文内容由网友自发贡献,不代表【wpsshop博客】立场,版权归原作者所有,本站不承担相应法律责任。如您发现有侵权的内容,请联系我们。转载请注明出处:https://www.wpsshop.cn/w/很楠不爱3/article/detail/187038
推荐阅读
相关标签
  

闽ICP备14008679号