一、安装环境介绍
macOS 10.12.4

Xcode 8.3.2

适用机型：iOS9 及以上机型

二、Appium源码安装
Xcode升级8.2之后不再支持UIAutomation，转而使用XCUITest；故当Xcode版本为8.2及以上版本时，只能安装Appium 1.5.3之后版本。Appium 1.5.3是基于UIAutomation底层驱动，即使安装成功也无法正常使用。

在实际安装过程中出现过Appium 1.6.3版本安装一直失败的情况，故以下以1.6.5版本为例，建议优先选择正式版本安装。

此处使用源码安装。

1、安装brew
/usr/bin/ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)"

2、安装libimobiledevice
brew install libimobiledevice --HEAD

3、安装carthage
brew install carthage

4、安装node.js
进入 https://nodejs.org/en/download/ 下载.pkg并安装

5、安装cnpm
npm install -g cnpm --registry=https://registry.npm.taobao.org

6、安装ios-deploy
cnpm install -g ios-deploy

7、安装xcpretty
gem install xcpretty

8、卸载原有Appium
$ npm uninstall appium -g
$ npm cache clean

9、安装Appium
$ npm i -g appium@1.6.5

10、查看安装情况
$ appium -v（出现版本号即安装成功）

11、安装appium-doctor
$ npm i -g appium-doctor

12、检查Appium环境
$ appium-doctor

当全为√时，Appium安装后后环境一切正常，若出现问题请参考下面的问题汇总

13、安装RoutingHttpServer库
背景：安装Appium后会有一个WebDriverAgent的iOS App工程，但未安装RoutingHttpServer库时无法编绎通过

$ cd /usr/local/lib/node_modules/appium/node_modules/appium-xcuitest-driver/WebDriverAgent
$ mkdir -p Resources/WebDriverAgent.bundle
$ sh ./Scripts/bootstrap.sh -d

14、WebDriverAgent工程配置
（a）Xcode打开 WebDriverAgent.xcodeproj 工程
目录：/usr/local/lib/node_modules/appium/node_modules/appium-xcuitest-driver/WebDriverAgent）

（b）修改iOS Deployment Target 为iOS 9.0
若不修改仅支持9.3以上版本

需修改project、所有targets中相应参数

（c）修改BundlID（必须修改，不能使用默认值）

修改5个targets中的 Product Bundle Identifier 参数

个人账户(不付费账户)：可以按自己的需求修改

企业账户（付费账户）：若使用公司的账户，需修改为特定的值（请联系我）

（d）编绎工程

编绎WebDriverAgentLib、WebDriverAgentRunner、WebDriverAgentRunner-nodebug、IntegrationApp；全部编绎通过，即工程配置完成；

（e）启动Appium 服务
$ appium -a 127.0.0.1 -p 4723

（f）校验Appium服务是否可用
$ xcodebuild -project /usr/local/lib/node_modules/appium/node_modules/appium-xcuitest-driver/WebDriverAgent/WebDriverAgent.xcodeproj -scheme WebDriverAgentRunner -destination id=设备UDID test

出现如下内容，表示服务可以正常使用：

Test Case '-[UITestingUITests testRunner]' started.
t = 0.00s Start Test at 2017-05-09 21:49:32.939
t = 0.01s Set Up
2017-05-09 21:49:32.968 XCTRunner[663:156885] Built at May 9 2017 21:49:21
2017-05-09 21:49:33.006 XCTRunner[663:156885] ServerURLHere->http://10.1.17.177:8100<-ServerURLHere
　　

三、问题汇总
1、appium-doctor：Xcode Command Line Tools 未安装
xcode-select --install

2、appium-doctor：adb、android未找到
（a）建议安装android ADT（http://tools.android-studio.org/index.php/adt-bundle-plugin）下载后直接解压就可以使用
（b）配置环境变量
　　1. 打开 .bash_profile文件

　　　　$ cd ~
　　　　$ open -e .bash_profile

　　2. 添加如下内容：

　　　　其中/Users/XXX/Documents/1--XXX/Automation/adt-bundle-mac-x86_64-20131030为ADT解压后的目录

　　　　export PATH=${PATH}:/Users/XXX/Documents/1--XXX/Automation/adt-bundle-mac-x86_64-20131030/sdk/platform-tools
　　　　export PATH=${PATH}:/Users/XXX/Documents/1--XXX/Automation/adt-bundle-mac-x86_64-20131030/sdk/tools
　　　　export ANDROID_HOME="/Users/XXX/Documents/1--XXX/Automation/adt-bundle-mac-x86_64-20131030/sdk"
　　　　export PATH=${PATH}:/Users/XXX/Documents/1--XXX/Automation/adt-bundle-mac-x86_64-20131030/sdk/tools:/Users/XXX/Documents/1--XXX/Automation/adt-bundle-mac-x86_64-20131030/sdk/platform-tools:/$JAVA_HOME/bin

　　3. 保存并关闭 .bash_profile文件

　　4. 更新配置的环境变量

　　　　source .bash_profile

（c）appium-doctor：JavaHome 环境
　　1. mac 一般内置安装了JAVA，可以先尝试配置环境变量

　　2. 在.bash_profile文件中添加如下内容

　　　　export JAVA_HOME=/usr

　　3. 若仍有问题，尝试重新安装

（d）code: 65, signal: null；code: null, signal: SIGKILL
　　一般在【二、步骤16】 检验时报错误：

　　>> xctest-client.js:202:14 [master] pid:17430 xctest client exit with code: 65, signal: null
　　>> xctest-client.js:230:14 [master] pid:17430 iproxy exit with code: null, signal: SIGKILL
　　>> xctest-client.js:157:16 [master] pid:17430 deviceconsole exit with code: null, signal: SIGKIL

　　出现此问题的原因基本都是WebDriverAgent工程配置时配置不正确，基本为证书问题，按照【二、步骤14】重新配置工程，保证可以全部编绎通过。

四、缺陷
此版本的Appium，无法使用inspecter获取控件信息（后续会提供app-inspecter进行控件获取的方法）

因WebDriverAgent工程编绎的ipa程序只能安装在iOS9以上，故无法在iOS7､iOS8上做自动化

五、升级
　　Xcode 9.0 之后需升级到最新版本，若安装1.6.5仍有问题可以到此链接（https://github.com/facebook/WebDriverAgent）下载webdriveragent工程文件替换/usr/local/lib/node_modules/appium/node_modules/appium-xcuitest-driver/WebDriverAgent中的文件，重新配置证书即可