Appium 常用初始化启动参数 Capability详解

最新推荐文章于 2026-03-27 11:23:46 发布

原创最新推荐文章于 2026-03-27 11:23:46 发布 · 1.5k 阅读

2 ·

本内容遵循CC 4.0 BY-SA版权协议

本文版权归原作者所有，仅供学习参考之用，转载请注明出处未经作者允许请务必保留此段声明！

收录于

Python自动化

Appium

简介

官方解析

Desired Capabilities are keys and values encoded in a JSON object, sent by Appium clients to the server when a new automation session is requested. They tell the Appium drivers all kinds of important things about how you want your test to work. Each Appium client builds capabilities in a way specific to the client’s language, but at the end of the day, they are sent over to Appium as JSON objects.

说明

Desired Capabilities是一组设置的JSON对象键值对的集合，其中键对应设置的名称，而值对应设置的值。Desired Capabilities主要用于Appium服务器建立需要的Session，Appium的客户端和服务端之间进行通信都必须在一个Session的上下文中进行。客户端在发起通信的时候首先会发送一个叫作“Desired Capabilities”的JSON对象给服务器。服务器收到该数据后，会创建一个session并将session的ID返回到客户端。之后客户端可以用该session的ID发送后续的命令。

常用Capability

只列举一些常用的键值对

公共部分

Capabilities	描述	值
platformName	使用哪个移动操作系统平台	iOS, Android, 或FirefoxOS
platformVersion	移动操作系统版本	例如7.1，4.4
deviceName	要使用的移动设备或模拟器类型	iPhone Simulator, Galaxy S4, 等等在 iOS 上，instruments -s devices或者 xctrace xcrun xctrace list devices（从 Xcode 12 开始）。在 Android 上，此功能目前被忽略，尽管它仍然是必需的。
app	安装包的绝对路径	/abs/path/to/my.apk 或者 http://myapp.com/app.ipa
newCommandTimeout	在假设客户端退出并结束会话之前，Appium 将等待来自客户端的新命令多长时间（以秒为单位）	例如 60
udid	连接的物理设备的唯一设备标识符	例如 1ae203187fc012g
noReset	请勿在此会话之前重置应用状态	true, false 默认为false，重置

Android 专用

Capabilities	描述	值
appActivity	要从包中启动的 Android 活动的Activity	MainActivity, .Settings
appPackage	您要运行的 Android 应用程序的包名	com.example.android.myApp, com.android.settings
appWaitActivity	用于您要等待的 Android Activity	SplashActivity, SplashActivity,OtherActivity, ,.SplashActivity
unicodeKeyboard	启用 Unicode 输入，默认 false	true 或者 false
resetKeyboard	unicodeKeyboard在运行具有功能的 Unicode 测试后，将键盘重置为其原始状态。单独使用时忽略。默认false	true 或者 false
chromeOptions	允许为 ChromeDriver 传递 chromeOptions 功能	chromeOptions: {args: [’–disable-popup-blocking’]}
chromedriverExecutable	webdriver 可执行驱动文件的绝对本地路径	/abs/path/to/webdriver
autoGrantPermissions	让 Appium 自动确定您的应用程序需要哪些权限，并在安装时将它们授予应用程序。默认为false. 如果noReset是true，则此功能不起作用	true 或者 false

仅限 iOS

Capabilities	描述	值
bundleId	被测应用的捆绑包 ID	例如 io.appium.TestApp
launchTimeout	以毫秒为单位，在Appium运行失败之前设置一个等待instruments的时间	例如：20000
autoAcceptAlerts	如果弹出，则自动接受所有 iOS 警报。这包括隐私访问权限警报（例如，位置、联系人、照片）。默认为false	true 或者 false
autoDismissAlerts	如果弹出所有 iOS 警报，它们会自动关闭。这包括隐私访问权限警报（例如，位置、联系人、照片）。默认为false	true 或者 false