03-MacOS上搭建Appium的iOS测试环境

本篇文章基于：MacOs-11.2.3 、Xcode -12.3 、appium-v1.20.2、appium-desktop-v1.20.2 ，是目前最新版本的appium

准备环境和文件

• MacOs-11.2.3
• iOS 14.2
• Apple ID，没有的可以注册：https://appleid.apple.com/account
• Xcode 12：直接从 App Store 下载安装
• Node.js：可用命令安装，也可下载安装包：https://nodejs.org/en/download/
• appium desktop，Appium 的桌面版：https://github.com/appium/appium-desktop/releases

相关库安装

• brew install libimobiledevice：用于连接 iOS 设备的开源工具，类似于 Android 的 ADB
• brew install ideviceinstaller：获取设备udid、安装app、获取bundleid
• brew install carthage：WebDriverAgent 使用的依赖管理工具
• brew install ios-deploy：不依赖Xcode，进行安装和调试iOS程序
• brew install node：安装node.js
• brew install npm : 安装npm  
• npm install -g cnpm --registry=https://registry.npm.taobao.org：安装cnpm，npm很慢且经常失败，推荐使用cnpm
• cnpm install -g appium：安装appium

验证安装

• cnpm install -g appium-doctor：安装 appium doctor
• appium-doctor --ios：检查appium的iOS环境

在 iOS 设备上安装 WebDriverAgent

 1. 更新 WebDriverAgent依赖

• 切换到appium-webdriveragent目录，执行sh ./Scripts/bootstrap.sh命令，如下所示

1. # Appium 桌面版本
2. cd /Applications/Appium.app/Contents/Resources/app/node_modules/appium/node_modules/appium-webdriveragent
3. sh ./Scripts/bootstrap.sh
4. 
5. # Appium 命令行版本
6. cd /usr/local/lib/node_modules/appium/node_modules/appium-webdriveragent
7. sh ./Scripts/bootstrap.sh

 2. 使用 Xcode 打开 WebDriverAgent 项目

• 点击 Finder→前往→前往文件夹…，输入以下路径，点击前往，双击文件夹下的 WebDriverAgent.xcodeproj 打开项目

1. # Appium 桌面版本
2. cd /Applications/Appium.app/Contents/Resources/app/node_modules/appium/node_modules/appium-webdriveragent
3. 
4. # Appium 命令行版本
5. cd /usr/local/lib/node_modules/appium/node_modules/appium-webdriveragent

 3. 在 Xcode 中添加开发者账号

• 点击上方菜单栏的 Xcode→Preferences→Accounts，点击左下角的 ＋ 按钮，选择 add Apple ID，添加自己的 Apple ID 作为开发者账号

 4. 编译 WebDriverAgentLib

• 勾选 Automatically manage signing，设置 Signning 的 Team 为上一步添加的个人开发者账号，点击右上角的编译按钮，编译成功上方会提示 Build  WebDriverAgentLib: Succeeded

 5. 编译 WebDriverAgentRunner

• 修改 Bundle Identifier 为 com.XXXXXX.WebDriverAgentRunner，必须是没有人用过的

• 勾选Automatically manage signing，设置 Signning 的Team为上一步添加的个人开发者账号，点击右上角的编译按钮，编译成功上方会提示 Build WebDriverAgentRunner: Succeeded

 6. 编译 IntegrationApp：

• 同上面操作

 7. 将 WebDriverAgentRunner 安装到 iOS 设备

• 在 Xcode 中，将 Target 切换为 WebDriverAgentRunner，目标设备选择已连接的 iOS 设备，点击菜单栏的 Product→Test

• 说明：上一步操作后会提示 Test Failed，可以看到 iOS 设备上多了一个叫 WebDriverAgentRunner 的 app，在 iOS 设备上点击 WebDriverAgentRunner 图标启动时会有弹窗提示 不受信任的开发者
• 解决：在 iOS 设备上，进入 设置→通用→设备管理 ，选择自己的 Apple ID 账号，点击信任 Apple ID
• 重复 步骤7的操作，可以看到 WebDriverAgentRunner 自动启动

 8. 验证 WebDriverAgent 安装

• iproxy 8100 8100
• 打开浏览器访问http://localhost:8100/status，可以查看 WebDriverAgentRunner 的状态