Mac上搭建Macaca

主要介绍如何在Mac上搭建Macaca，包括准备、安装和运行。

一、基础环境

1、安装brew：

ruby−e"ruby−e"(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)"

检查是否安装成功：$ brew -v

2、安装Node.js和npm：

$ brew install node

检查Node.js是否安装成功：$ node -v

检查npm是否安装成功：$ npm -v

二、安装Macaca

1、安装命令行工具：

$ npm i -g macaca-cli

2、安装驱动：

安装Electron驱动：$ npm i macaca-electron -g

安装Chrome驱动：$ npm i macaca-chrome -g

安装Android驱动：$ npm i macaca-android -g

安装iOS驱动：$ npm i macaca-ios -g

驱动根据对应的平台选择安装相应的程序，若测试Android和iOS应用，还需另外安装相应的环境，分别见附录A和附录B。

3、环境检查

$ macaca doctor

可以看到Android和iOS驱动红色字体显示，提示版本过旧，这时可以输入命令升级版本重新安装，安装后重新检查环境，全部绿色，即环境配置成功。

三、执行用例

1、下载案例：

$ git clone https://github.com/macaca-sample/mobile-app-sample-nodejs.git --depth=1

2、下载后，进入macaca-test-sample目录，安装项目依赖：

$ npm i

3、运行用例：

$ macaca run --verbose

至此环境搭建成功，且能运行一个完整的用例。

四、遇到的坑

1、Electron找不到path.txt的解决方法

$ cd node_modules/electron-prebuilt && node install.js

2、由于网络原因引起的资源下载和安装失败，可以切换切换成淘宝源

$ npm install -g cnpm --registry=https://registry.npm.taobao.org

附录A、Android环境

1、安装JDK并配置环境变量

下载mac版的JDK并安装：http://www.oracle.com/technetwork/java/javase/downloads/index.html

.bash_profile中设置JAVA_HOME

检查是否安装成功：$ java -version

2、安装Android-SDK并配置环境变量

安装Android-SDK：$ brew install android-sdk

.bash_profile中设置ANDROID_HOME

附录B、安装iOS环境

1、安装xcode8或者更高版本

下载xcode并安装：https://developer.apple.com/xcode/downloads/

2、安装 usbmuxd 以便于通过 USB 通道测试 iOS 真机，不需要测试真机则不用安装

$ brew install usbmuxd

3、应用中如含有 WebView，安装 ios-webkit-debug-proxy

$ brew install ios-webkit-debug-proxy