159
從無到有搭建Macaca環境(for Mac)
官方環境配置教程：https://macacajs.com/environment-setup
Macaca官方提供了環境配置指南(地址如上)，但官方文檔中多處是針對有相應開發經驗的同學介紹，對於新手來講入門成本較高，且我們在實踐中也常會遇到一些問題，導致環境配置受阻，本文基於筆者配置中的經驗，總結了配置過程中的詳細步驟，旨在提供一個詳盡的Macaca環境配置指南，幫助新手們從無到有的搭建一套Macaca開發環境，作為官方指南的補充和細化，歡迎拍磚。
基礎環境準備
安裝Homebrew
簡易安裝步驟(最新可參考官網)
$ /usr/bin/ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)"
安裝Node和npm
$ brew install node
安裝後可以用node -v查看版本號,如果正常則說明安裝成功,Macaca2.0要求當前node版本要高於6.0，如果以前安裝過低版本的Node,可以通過如下命令更新Node版本：
$brew upgrade node
安裝cnpm
npm是node.js的包管理工具，可以用他來安裝和更新各種node的pacakage,可以理解為Java中Maven類似的作用，但是由於眾所周知的那堵牆，直接用npm安裝速度會非常慢，這種情況下可以安裝阿裏巴巴提供的cnpm，cnpm提供了國內的鏡像，可以加快包的下載速度，安裝方法如下：
命令行工具輸入如下命令：
$npm install -g cnpm --registry=https://registry.npm.taobao.org
如果在安裝過程中提示 Permission 權限相關錯誤，可以嚐試 $ sudo chown -R $USER /usr/local，永久破除 sudo 要求。
安裝成功後同樣可以通過cnpm -v來驗證安裝是否成功，安裝成功後，在原來使用npm的地方，直接替換成cnpm即可，
比如，原始命令為
$npm i -g macaca-cli
替換後為:
$cnpm i -g macaca-cli
Macaca相關安裝
iOS
如果不針對iOS作自動化，可以忽略此處
- 安裝XCode(依賴Mac電腦，AppStore下載即可)
- 安裝相關工具
$ brew install usbmuxd $ brew install ios-webkit-debug-proxy $ brew install carthage
Android
- 安裝JDK Macaca支持JDK7及以上，可到官網選擇對應版本安裝 官網下載 注意安裝後需要配置JAVA_HOME環境變量,如果本地命令行工具用的是mac係統的默認命令行工具，將其配置到 ~/.bashprofile中，如果用的是zsh，將其配置到 ~/.zshrc中，如下：
export JAVA_HOME="/Library/Java/JavaVirtualMachines/jdk1.8.0_101.jdk/Contents/Home"
環境變量修改後需要source一下進行更新，比如如果修改的是~/.zshrc，需要執行$source ~/.zshrc
更新後執行echo $JAVA_HOME 如果能正常打印出環境變量，則證明環境變量已經配置成功
- 安裝Android Studio 官方安裝
3.安裝gradle（用於打包UIAutomatorWD）
$ brew install gradle
配置gradle環境變量，如果本地命令行工具用的是mac係統的默認命令行工具，將其配置到~/.bashprofile中，如果用的是zsh，將其配置到~/.zshrc中，如下：
export GRADLE_HOME="/usr/local/bin/gradle"
環境變量修改後需要source一下進行更新，比如如果修改的是~/.zshrc，需要執行$source ~/.zshrc
更新後執行$echo $GRADLE_HOME 如果能正常打印出環境變量，則證明環境變量已經配置成功
4.安裝&配置安卓sdk
通過AndroidStudio內的sdkmanager安裝安卓依賴的sdk版本，操作路徑：
AndroidStudio -> Tools -> Android -> SDK Manager
需要安裝的依賴：
SDK Platforms : Android 6.0及以上版本
SDK Tools: Android SDK Platform-Tools && Android SDK Tools && NDK
具體勾選效果如下：
上麵第一張圖中紅框標記的ANDROID_HOME地址是安卓SDK的路徑，需要配置到環境變量中，配置方法同gradle一樣
如上都配置好後，需要將兩個環境變量拚接到係統的PATH變量中，全部配置完成後的內容如下：
Macaca命令行工具安裝
macaca-cli為macaca的命令行工具，集成了macaca doctor等命令
$ tnpm i -g macaca-cli
// 備注 -g 表示全局安裝，如果不加-g參數會在當前目錄下安裝macaca-cli
驅動安裝
執行如下命令安裝對應不同平台的驅動，可以選擇性安裝
$ cnpm i macaca-ios -g
$ cnpm i macaca-android -g
$ cnpm i macaca-chrome -g
$ cnpm i macaca-electron -g
備注：
1. 當需要更新相應驅動時，直接執行如上的安裝命令即可
2. cnpm i macaca-ios -g
如果提示
xcode-select: error: tool 'xcodebuild' requires Xcode, but active developer directory '/Library/Developer/CommandLineTools' is a command line tools instance
命令行執行如下即可：
sudo xcode-select -s /Applications/Xcode.app/Contents/Developer
至此，便完成了完整的Macaca相關環境的安裝，此時我們可以通過macaca doctor命令檢查當前環境配置：
如圖為常規的Macaca環境配置結果，現在Macaca在環境上做了相對嚴格的校驗，如果有部分依賴安裝不成功，會給出相應的提示，針對性解決即可。
最後更新：2017-08-25 15:03:30