Appium Server搭配Xcode运行时WebDriverAgent启动失败问题求解

报错根因 #

该错误由工具版本迭代导致：新版Xcode不再支持Carthage默认生成的.framework依赖包格式，要求使用xcframework格式，课程发布时的旧版WebDriverAgent构建命令未适配该规则，因此构建失败。

解决方案操作步骤 #

• 第一步：定位WebDriverAgent本地安装目录
  不同安装方式的Appium对应路径不同，常见路径如下：
  1. 桌面版Appium：/Applications/Appium.app/Contents/Resources/app/node_modules/appium-xcuitest-driver/WebDriverAgent
  2. npm全局安装的Appium：/usr/local/lib/node_modules/appium/node_modules/appium-xcuitest-driver/WebDriverAgent
  3. Appium 2.x版本：~/.appium/node_modules/appium-xcuitest-driver/node_modules/appium-webdriveragent
• 第二步：执行适配后的构建命令
  终端进入上述定位到的WebDriverAgent目录，先升级Carthage到最新版本避免兼容问题：
  brew upgrade carthage
  再执行带xcframework参数的构建命令：
  carthage bootstrap --platform iOS,tvOS --use-xcframeworks
• 第三步：验证构建结果
  命令执行无报错后，检查WebDriverAgent目录下的Carthage/Build路径，确认生成了iOS、tvOS平台对应的.xcframework后缀依赖包。
• 第四步：重启Appium Server，重新运行测试用例即可。

异常排查（若构建仍失败） #

• 若提示xcodebuild路径错误，执行命令指定Xcode开发者路径：
  sudo xcode-select -s /Applications/Xcode.app/Contents/Developer
• 若使用M1/M2芯片的Mac设备执行报错，可加架构适配参数执行：
  arch -x86_64 carthage bootstrap --platform iOS,tvOS --use-xcframeworks
• 若使用Appium 2.x版本，先确认已安装xcuitest驱动，执行appium driver list查看，未安装的话先执行appium driver install xcuitest后再重新构建WebDriverAgent。

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