Appium超详细环境搭建for-Mac

兜兜转转试用了一圈自动化框架后，回归到appium，与一年以前相比，appium有了很大的改变：
一、iOS 9 以前一直以 instruments 下的 UIAutomation为驱动底层技术（弊端因为 instruments 的限制，单台 mac 只能对应单台设备）；
二、iOS 9.3 时代推出 XCUITest 工具，用以替代 UIAutomation；
三、iOS 10 时代苹果直接废弃了 UIAutomation、Facebook 推出 WebDriverAgent（实现的 server 可以支持单台 mac 对应多个设备）；四、Appium 在iOS 9.3 后全面采用 WebDriverAgent 的方案。

首先，咱们要知道环境搭建所需工具：

其次，重中之重：版本很重要，个人是：xcode9.3 + node10.11.0 + appium1.7.0，若是根据如下配置仍然不能成功运行，那么99%是版本的问题

下面开始逐个安装
一、安装node
brew install node
经过这种方法安装的node是最新版本，由于我本地须要有node 8.1.1版本，因此使用nvm进行安装
备注：nvm的安装和使用

二、下载Xcode 和 Command Line Tools：须要有个AppleID，并根据本身电脑OS版本下载所需版本
下载地址

下载后直接安装便可，注意Xcode保持在application文件夹下只有一个惟一版本

三、下载安装JDK
oracle官网下载地址

下载完成后直接安装便可

四、安装Android SDK
不少资料都推荐使用brew安装，可是实践后发现SDK文件为空，因此使用Android studio来安装
下载Android studio

具体安装步骤见此文档

若是打开Android studio报错，直接cancel到下一步便可；若使用default方式安装，也能够在configuration里从新下载相关tools

五、安装appium最新版本
github release版本下载

这里不使用npm下载方式是由于下载过程较长，且容易报错

六、安装appium-doctor
npm install -g appium-doctor

七、配置Android环境变量
在 ~/.bash_profile文件中添加path

export ANDROID_HOME=~/Library/Android/sdk/
export JAVA_HOME=/Library/Java/JavaVirtualMachines/jdk1.8.0_171.jdk/Contents/Home #jdk安装路径   
export PATH=~/bin:$PATH:/usr/local/bin:$ANDROID_HOME/platform-tools/:$JAVA_HOME/bin
export CLASSPATH=.:$JAVA_HOME/lib/dt.jar:$JAVA_HOME/lib/tools.jar

在appium的configurations里设置：

八、安装其余依赖
brew install libimobiledevice --HEAD
npm install -g ios-deploy
brew install carthage

libimobiledevice / ideviceinstaller 库：至关于 android 的 adb，是 Appium 底层用到的工具之一，用于获取 iOS 设备信息
ios-deploy：查看设备应用
carthage：相似于 java 的 maven，项目依赖管理，主要是 WebDriverAgent 使用

九、配置WebDriverAgent
（1）首先进入WebDriverAgent所在文件目录下：
/Applications/Appium.app/Contents/Resources/app/node_modules/appium/node_modules/appium-xcuitest-driver/WebDriverAgent
（2）根目录下执行：
./Scripts/bootstrap.sh
（3）打开WebDriverAgent.xcodeproj工程文件
（4）添加本身的account：Xcode -> Preferences -> account -> 左下角 +

（5）更改bundle id：这里的bundle id就至关于一个App的惟一识别号，更改的规则随意，只要确认不会与有重复便可；全部的targets都须要修改

十、验证是否环境已经安装成功了
（1）终端输入：appium-doctor
若是环境都已配置好，应该是文章最开始图片中的结果
（2）运行WebDriverAgentRunner

按照图中
1：选择scheme为WebDriverAgentRunner -> 2：选择运行设备，模拟器和真机均可以 -> 3：选择要构建的方式 ->4：选择Test方式
的步骤验证是否能成功运行WebDriverAgentRunner

若是真机运行后弹出须要在设置中信任证书，

Verify the Developer App certificate for your account is trusted on your device. Open Settings on iPhone and navigate to General -> Device Management, then select your Developer App certificate to trust it.

按照步骤操做后，从新运行就能够了

成功运行结果图：

十一、遇到的问题总结
一、appium版本不支持xcode版本（须要调用XCUITest)，从新下载可匹配的Xcode版本
Xcode9.3 + Appium1.6.4时，运行WebDriverAgentRunner报错

Early unexpected exit, operation never finished bootstrapping - no restart will be attempted

解决方法：更新Appium版本到1.7.0

二、appium没法调起webdriverrunner（webdriveragent更新），查看是否由于webdriveragent证书签名、依赖framework、serverURL抛出错误信息
安装依赖framework时报错：

Falling back to building from the source
A shell task (/usr/bin/xcrun xcodebuild -project /Applications/Appium.app/Contents/Resources/app/node_modules/appium/node_modules/appium-xcuitest-driver/WebDriverAgent/Carthage/Checkouts/CocoaAsyncSocket/CocoaAsyncSocket.xcodeproj CODE_SIGNING_REQUIRED=NO CODE_SIGN_IDENTITY= CARTHAGE=YES -list) failed with exit code 72:
xcrun: error: unable to find utility "xcodebuild", not a developer tool or in PATH

解决方法：选择Command Line Tools

Xcode -> Preferences -> Locations -> Command Line Tools

三、长时间测试，server中断，这个没法解决，appium自身问题四、webdriveragent启动失败，status、inspector没法正常查看，查看版本五、appium脚本启动失败，查看脚本中的配置