Mac 上搭建 iOS WebDriverAgent 环境

Mac环境搭建

• macOS 系统电脑：12.6.2

• Xcode：14.0.1（xcodebuild -version）

• appium Desktop：1.21.0 (下载链接)
  Appium Desktop 1.22.0 ，从该版本开始，Appium 将 Server 和 Inspect 工具分开了，需要分别下载。

• Python：3.9

• PyCharm

• mac上安装nodejs

  检查：npm -v，node -v

• cnpm：npm install -g cnpm --registry=https://registry.npm.taobao.org

• ios-deploy 依赖库：cnpm install -g ios-deploy

• brew：/bin/zsh -c "$(curl -fsSL https://gitee.com/cunkai/HomebrewCN/raw/master/Homebrew.sh)"

• 安装 libimobiledevice、carthage：

  brew install libimobiledevice

  brew install carthage

---

配置 Xcode 生成 WDA

1. 关于 WebDriverAgent 的选择

   1. 安装 Appium（或者 Appium Server GUI）后，安装路径下存在的一个 appium-webdriveragent 目录
   2. 或者从 github 上下载，比如我试了下 appium/WebDriverAgent 选择了此时最新的 WebDriverAgent-4.10.23，直接点击下载：Source code(tar.gz)。然后替换路径下的 appium-webdriveragent

   路径：

    # 如果安装的是新的 Appium Server GUI
    /Applications/Appium Server GUI.app/Contents/Resources/app/node_modules/appium/node_modules/appium-webdriveragent
   

    # 如果安装的是 Appium 
    /Applications/Appium.app/Contents/Resources/app/node_modules/appium/node_modules/appium-webdriveragent
   

2. 进入 appium-webdriveragent 目录双击 WebDriverAgent.xcodeproj 打开工程配置

3. 添加开发者账号

   Xcode->Preferences->Accounts，个人使用的话，账号需要购买，一般公司会提供账号。

4. 选择模拟器

   Xcode 顶部栏，点击 WebDriverAgentRunner 来选择，如下一步骤中的图，我选择的是 iPhone12，iOS 版本是14.3。

5. 配置 WebDriverAgentLib

   

6. 配置 WebDriverAgentRunner

   需要更改 Bundle Identifier，原来默认是 com.facebook.WebDriverAgentRunner，在末尾加一些随机字符让其变得唯一
   

7. 选择将要运行的 WebDriverAgentRunner 的模拟器（或真机设备)

   WebDriverAgent: WebDriverAgentRunner > iPhone12

8. 快捷键 command + u 运行并测试

   • Xcode 提示 Succeeded 表示成功
   • 模拟器打开后，界面上会生成一个白色的 WebDriverAgent 应用
     -

---

常见问题

brew 安装失败

因为网络问题而安装失败，解决：命令：/bin/zsh -c "$(curl -fsSL https://gitee.com/cunkai/HomebrewCN/raw/master/Homebrew.sh)"

(解决无法安装的参考链接)

如果非网络问题，brew install libimobiledevice 安装失败，提示 Error: command failed with exit 128: git

尝试用最原始的方式重新安装 brew：

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

还看到一种方法：brew install --HEAD libimobiledevice