主要介绍如何在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