Python Appium报错：desired_capabilities参数无效，如何改用Options？

错误原因 #

新版本Appium Python客户端（v2.x+）已经移除了desired_capabilities参数，必须使用对应平台的Options类来配置设备与应用信息。

解决步骤 #

• 导入对应平台的Options类（iOS用IOSOptions，Android用UiAutomator2Options）
• 用Options实例加载你的配置参数，两种方式任选其一：
  • 逐个调用set_capability()方法设置参数
  • 直接用load_capabilities()方法加载原有的CAPS字典
• 初始化WebDriver时，传入options参数替代desired_capabilities

修改后的完整代码 #

from appium import webdriver
from appium.options.ios import IOSOptions  # 导入iOS对应的Options类
from os import path

CUR_DIR = path.dirname(path.abspath(__file__))
APP = path.join(CUR_DIR, 'TheApp.app.zip')
APPIUM = 'http://localhost:4723'

CAPS = {
    'platformName': 'iOS',
    'platformVersion': '17.4',
    'deviceName': 'iPhone 12 mini',
    'automationName': 'XCUITest',
    'app': APP,
}

# 创建IOSOptions实例并加载配置
ios_options = IOSOptions()
ios_options.load_capabilities(CAPS)

# 初始化driver，传入options参数
driver = webdriver.Remote(
    command_executor=APPIUM,
    options=ios_options
)

额外说明 #

• 如果测试Android应用，只需替换导入的Options类：from appium.options.android import UiAutomator2Options，后续逻辑一致
• 确保你的Appium Python客户端版本是2.x及以上，可通过pip show appium-python-client查看版本，低于2.x建议执行pip install --upgrade appium-python-client升级

内容的提问来源于stack exchange，提问作者Robi