安装Appium 2.0后找不到appium-webdriveragent及启动失败问题

核心原因：Appium 2.0架构变化 #

Appium 2.0采用驱动独立安装的架构，appium-webdriveragent不再位于主App包的/usr/local/lib/node_modules/appium/node_modules/路径下，而是跟随xcuitest驱动存放在独立目录中。

步骤1：定位xcuitest驱动的安装路径 #

运行以下命令查看已安装驱动的位置：

appium driver list --installed

输出会包含类似这样的路径（具体路径根据系统和安装方式可能不同）：

xcuitest (5.12.0) - ~/.appium/node_modules/appium-xcuitest-driver

appium-webdriveragent就位于该路径的子目录中（通常是WebDriverAgent文件夹）。

步骤2：解决Xcodebuild退出码65问题 #

退出码65通常和签名、依赖或Xcode配置有关，按以下步骤排查：

• 配置WebDriverAgent签名

  1. 打开步骤1中找到的WebDriverAgent.xcodeproj文件（位于xcuitest驱动路径下的WebDriverAgent文件夹）
  2. 在Xcode中选择WebDriverAgentRunner和WebDriverAgentLib两个target，分别设置：
     • 勾选"Automatically manage signing"
     • 选择你的开发者Team
     • 修改Bundle ID为唯一值（比如在原ID后添加你的账号标识）
  3. 尝试手动编译运行WebDriverAgentRunner到目标设备/模拟器，确认能正常启动。

• 修复Carthage依赖
  进入WebDriverAgent目录，重新拉取依赖：

  carthage bootstrap --platform iOS
  

  Xcode 14对依赖兼容性要求更高，这一步能解决大部分依赖缺失问题。

• 添加Desired Capabilities配置
  在你的测试脚本中，添加签名相关的配置项：

  {
    "platformName": "iOS",
    "deviceName": "你的设备名称",
    "automationName": "XCUITest",
    "xcodeOrgId": "你的开发者团队ID",
    "xcodeSigningId": "iPhone Developer"
  }
  

  团队ID可以在Xcode的"Accounts"面板中查看。

• 验证Xcode命令行工具
  确保Xcode命令行工具指向正确版本：

  xcode-select -p
  

  如果指向的不是Xcode 14.1的路径，运行：

  sudo xcode-select -s /Applications/Xcode.app/Contents/Developer
  

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