1、下載或者更新Homebrew：

       homebrew官網 macOS 不可或缺的套件管理器

$ /usr/bin/ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)"  #下載
$ brew update #更新
$ brew -v
Homebrew 1.1.5
Homebrew/homebrew-core (git revision e151b; last commit 2016-12-26)

2、使用homebrew來安裝node.js

       node採用C++編寫，是一個JavaScript的執行環境，因為JS是指令碼語言需要一個解析器才能執行，對於寫在HTML頁面的JS，瀏覽器本身就是解析器，對於需要單獨執行的JS，Node.js就是解析器。

$ brew install node
$ node -v
v7.3.0

3、安裝npm：

       NPM 使用介紹 是一個NodeJS包管理和分發工具，已經成為了非官方的釋出Node模組（包）的標準。

$ brew install npm

4、使用npm來安裝appium

       2017.01.03目前最新的版本是 1.6.3 ，當然也可以在 macOS下bitbucket下載appium客戶端，但是坑人的是最新版本是 1.5.3 支援的還只是 iOS10 以下的 UIAutomation 框架基礎上測試，而 iOS10 以後蘋果使用的卻是基於 XCUITest

，所以只能採用npm安裝咯。但是因為國內牆太高而使用npm卻是從國外伺服器下載，有時候使用npm需要非常長的時間，更多時候是失敗，推薦使用cnpm來安裝：

       淘寶 NPM 映象 10分鐘同步npmjs.org映象，使用方式和npm完全一致

$ npm install cnpm -g --registry=https://registry.npm.taobao.org
$ npm view appium versions #檢視appium所有的版本號

5、使用cnpm安裝appium和appium-doctor

$ cnpm install -g appium --
 
no-cache
$ cnpm install -g appium
$ cnpm install -g appium-doctor

6、檢查appium環境檢測：

$ appium-doctor
info AppiumDoctor Appium Doctor v.1.4.2
info AppiumDoctor ### Diagnostic starting ###
info AppiumDoctor  ✔ Xcode is installed at: /Applications/Xcode.app/Contents/Developer
WARN AppiumDoctor  ✖ Xcode Command Line Tools are NOT installed!
info AppiumDoctor  ✔ DevToolsSecurity is enabled.
info AppiumDoctor  ✔ The Authorization DB is set up properly.
info AppiumDoctor  ✔ The Node.js binary was found at: /usr/local/bin/node
info AppiumDoctor  ✔ Carthage was found at: /usr/local/bin/carthage
info AppiumDoctor  ✔ HOME is set to: /Users/denglibing
WARN AppiumDoctor  ✖ ANDROID_HOME is NOT set!
info AppiumDoctor  ✔ JAVA_HOME is set to: /Library/Java/JavaVirtualMachines/jdk1.8.0_131.jdk/Contents/Home
WARN AppiumDoctor  ✖ adb could not be found because ANDROID_HOME is NOT set!
WARN AppiumDoctor  ✖ android could not be found because ANDROID_HOME is NOT set!
WARN AppiumDoctor  ✖ emulator could not be found because ANDROID_HOME is NOT set!
WARN AppiumDoctor  ✖ Bin directory for $JAVA_HOME is not set
info AppiumDoctor ### Diagnostic completed, 6 fixes needed. ###
info AppiumDoctor 
info AppiumDoctor ### Manual Fixes Needed ###
info AppiumDoctor The configuration cannot be automatically fixed, please do the following first:
WARN AppiumDoctor - Manually configure ANDROID_HOME.
WARN AppiumDoctor - Manually configure ANDROID_HOME and run appium-doctor again.
WARN AppiumDoctor - Add '$JAVA_HOME/bin' to your PATH environment
info AppiumDoctor ###
info AppiumDoctor 
info AppiumDoctor Bye, run appium-doctor again when all manual fixes have been applied!
info AppiumDoctor 

常見問題解決：

(1)、Xcode Command Line Tools are NOT installed!

$ xcode-select --install  

       按照提示安裝即可

(2)、Carthage was NOT found!

$ brew install carthage      

carthage：類似cocoapods管理第三方程式碼，自動將工程編譯為動態庫，所以僅支援iOS8以上

(3)、WARN AppiumDoctor ✖ ANDROID_HOME is NOT set!

       建議安裝Android編譯器，可以解決其他Android環境的其他問題

       設定 ANDROID_HOME 路徑：

       設定 JAVA_HOME 路徑：

(4)、JAVA_HOME問題：

       .bash_profile檔案：

export JAVA_HOME=/Library/Java/JavaVirtualMachines/jdk1.8.0_131.jdk/Contents/Home
export ANDROID_HOME=/Users/yourname/Library/Android/sdk
export PATH=$PATH:$ANDROID_HOME/tools:$ANDROID_HOME/platform-tools:${JAVA_HOME}/bin

7、安裝appium客戶端

       上面的操作只是安裝了server端，接下來需要安裝測試程式碼執行所依賴的客戶端，我們以python為例：

git clone https://github.com/appium/python-client
cd python-client-master 
sudo python setup.py install

8、安裝 appium-xcuitest-driver

       對於 iOS10 以上的測試，需要下載安裝 appium-xcuitest-driver 驅動：Appium iOS driver, backed by Apple XCUITest

       或者重新安裝 appium-xcuitest-driver (先解除安裝在重新安裝新版本2.5.3)

       原因：appium 預設安裝的appium-xcuitest-driver版本有點老，貌似是 2.4.0的版本，老的版本問題，執行測試的時候會提示

[debug] [WebDriverAgent] Device: Mar 29 15:29:21 Cheersde-iPhone XCTRunner[2848] <Notice>: Running tests...
[debug][WebDriverAgent] Device: Mar 29 15:29:22 Cheersde-iPhone XCTRunner[2848] <Notice>: Continuing to run tests in the background with task ID 1
[debug] [XCUITest] Waiting for WebDriverAgent server to finish loading...

       導致被測試的app launch不起來，一直卡在 [debug][XCUITest] Waiting for WebDriverAgent server to finish loading... 這塊

       而新的版本appium-xcuitest-driver 2.5.3 就解決了這個問題。

安裝方法：

cd /usr/local/lib/node_modules/appium   
npm uninstall appium-xcuitest-driver         先解除安裝
npm install appium-xcuitest-driver@2.5.3  重新安裝 2.5.3

       當然也可以在 /usr/local/lib/node_modules/appium/node_modules/[email protected]/WebDriverAgent/ 找到該專案，執行 carthage update , 選擇 WebDriverAgentRunner 編譯即可。

       但是這種方法很不方便，下面提供一種更簡單的的：

安裝appium-xcuitest-driver依賴

       進入WebDriverAgent安裝目錄。執行bootstrap
cd /usr/local/lib/node_modules/appium/node_modules/[email protected]@appium-xcuitest-driver/WebDriverAgent （如果WebDriverAgent 所在路徑和此不同，請自行查詢）

mkdir -p Resources/WebDriverAgent.bundle
sh ./Scripts/bootstrap.sh -d

       在執行sh ./Scripts/bootstrap.sh -d很可能會有因為某種原因而網路連線失敗。方法就是去下載了一個VPN代理軟體，我下的是雲梯VPN,使用這個連結，我們都能優惠10元。

       再次執行sh ./Scripts/bootstrap.sh -d 無報錯就OK了

其他相關的安裝

$ brew install libimobiledevice --HEAD  # install from HEAD to get important updates
$ brew install ideviceinstaller         # 只是對iOS9有用

$ npm install -g ios-deploy                # iOS10 以後的版本安裝ios-deploy
$ sudo gem install xcpretty            # 真機需要安裝 xcpretty

9、下載測試程式碼並且測試

       官網上的測試程式碼坑很多，這個問題我困擾我好久。一開始還以為是自己那個環境出問題還是流程不對，結果真的只是官網測試程式碼本身問題，當然可以自己編寫程式碼測試咯，也可以下載我找的一個簡單的 appium_ios_sample_code

       先執行模擬器的測試

$ cd sample-code/apps/HHH

#在sample-code/apps/HHH/build/Release-iphonesimulator/得到HHH.app包
$ xcodebuild -sdk iphonesimulator
Build settings from command line:
    SDKROOT = iphonesimulator10.2

=== BUILD TARGET HHH OF PROJECT HHH WITH THE DEFAULT CONFIGURATION (Release) ===
...
...
...
Signing Identity:     "-"

    /usr/bin/codesign --force --sign - --timestamp=none /Users/denglibing/Desktop/sample-code/apps/HHH/build/Release-iphonesimulator/HHH.app

** BUILD SUCCEEDED **


$ cd sample-code/examples/python
$ python ios_simple_simulator.py
test_scroll (__main__.SimpleIOSTests) ... ok

----------------------------------------------------------------------
Ran 1 test in 30.421s

OK

       對於真機，可能要麻煩些，安裝 appium-xcuitest-driver 驅動後，生成在真機上執行的包：

       參考資料可以看官網的說明 部署ios-app到手機上

# 在 apps/HHH/build/Release-iphoneos/HHH.app 得到 release 包
$ xcodebuild -sdk iphoneos -target HHH -configuration Release CODE_SIGN_IDENTITY="iPhone Distribution: Shenzhen XXXX Technology Co., Ltd. (B9FH944VTE)" 
PROVISIONING_PROFILE="08f04032-ca2e-4bb5-b1ba-c32778115f2e"

       關於怎麼設定 CODE_SIGN_IDENTITY 和 PROVISIONING_PROFILE 如何檢視 ，可以選擇下圖所示的 Development Team 一行, control+c 然後 複製出去即可

       接下來連上真機 執行測試用例程式碼：

$ cd sample-code/examples/python
$ python ios_simple_device.py
test_scroll (__main__.SimpleIOSTests) ... ok
----------------------------------------------------------------------
Ran 1 test in 30.421s

OK

10：一些很有幫助的資料

11、心得：

       整體的流程其實不多，但是在macOS10.12搭建appium的環境及測試整個過程著實煩躁，有時候一個小問題就卡1-2天也不好說，而且官網上的文件和測試程式碼已經部分誤導我走了非常多的歪路。