重启Mac后Appium WebdriverIO的driver.touchAction()报错“未实现方法”求助

核心排查与修复方案 #

1. 检查Appium版本兼容性 #

重启后大概率触发了依赖自动更新，Appium 2.x版本已移除touchAction()方法，官方推荐使用performActions()或actions()替代。

• 先确认Appium版本：执行appium -v，若为2.x，直接替换API，示例代码：

  // 原touchAction代码
  await driver.touchAction([
    { action: 'press', x: 100, y: 200 },
    { action: 'wait', ms: 1000 },
    { action: 'release' }
  ]);
  
  // 替换为performActions
  await driver.performActions([{
    type: 'pointer',
    id: 'finger1',
    parameters: { pointerType: 'touch' },
    actions: [
      { type: 'pointerMove', duration: 0, x: 100, y: 200 },
      { type: 'pointerDown', button: 0 },
      { type: 'pause', duration: 1000 },
      { type: 'pointerUp', button: 0 }
    ]
  }]);
  

2. 校验uiautomator2驱动状态 #

• 检查已安装驱动：执行appium driver list --installed，确认uiautomator2在列表中
• 若缺失，重新安装：appium driver install uiautomator2，安装完成后重启Appium Server

3. 核对WebdriverIO配置 #

确保wdio.conf.ts的capabilities中配置正确：

capabilities: [{
  platformName: 'Android',
  automationName: 'UiAutomator2', // 必须指定为UiAutomator2
  appium:deviceName: '你的设备名',
  appium:app: '/path/to/your/app.apk'
}]

同时用adb devices确认设备连接正常。

4. 确认环境变量生效 #

重启后环境变量可能未加载，重新执行以下命令验证：

echo $ANDROID_HOME # 应指向Android SDK目录，如/Users/xxx/Library/Android/sdk
echo $JAVA_HOME    # 应指向JDK 8或11目录，Appium对高版本JDK兼容性差

若路径错误，重新配置后执行source ~/.zshrc或source ~/.bash_profile生效。

5. 回退依赖版本（临时方案） #

若不想替换API，可回退到支持touchAction()的Appium 1.x版本：

npm uninstall -g appium
npm install -g appium@1.22.3 # 选择稳定的1.x版本

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