DesiredCapabilities.android()/iphone()报错，是否需替换为MutableCapabilities？

开发者阿泽

2026-7-30

解决DesiredCapabilities.android()/iphone()方法未定义的问题

问题原因

Appium Java客户端8.x及以上版本，已移除DesiredCapabilities类中的android()、iphone()这类静态工厂方法，直接调用会触发「方法未定义」的错误。

你的疑问解答

是的，完全可以用MutableCapabilities替代DesiredCapabilities实现需求，这也是Appium新版本推荐的写法。以下是具体替代代码：

Android场景替代代码

MutableCapabilities caps = new MutableCapabilities();
caps.setCapability("proxy", proxy);
caps.setCapability("deviceName", android_deviceName);
caps.setCapability("platformName", mob_platformName);
caps.setCapability("platformVersion", android_platformVersion);
// 可选：指定Android自动化引擎，一般用UiAutomator2
caps.setCapability("automationName", "UiAutomator2");

iOS场景替代代码（原`iphone()`方法对应iOS设备）

MutableCapabilities caps = new MutableCapabilities();
caps.setCapability("deviceName", ios_deviceName);
caps.setCapability("platformName", "iOS");
caps.setCapability("platformVersion", ios_platformVersion);
// 可选：指定iOS自动化引擎，一般用XCUITest
caps.setCapability("automationName", "XCUITest");

兼容写法（不推荐）

如果坚持使用DesiredCapabilities，可通过构造器实例化后手动设置平台参数：

// Android场景
DesiredCapabilities capabilities = new DesiredCapabilities();
capabilities.setCapability("platformName", "Android");
capabilities.setCapability("proxy", proxy);
capabilities.setCapability("deviceName", android_deviceName);
capabilities.setCapability("platformVersion", android_platformVersion);

// iOS场景
DesiredCapabilities capabilities = new DesiredCapabilities();
capabilities.setCapability("platformName", "iOS");
capabilities.setCapability("deviceName", ios_deviceName);
capabilities.setCapability("platformVersion", ios_platformVersion);