Macaca之2.0版本（iOS）完全安装手册

一、环境配置

• 请安装 Xcode8.3 或者更高版本
• 需要安装 usb这里写链接内容muxd 以便于通过 USB 通道测试 iOS 真机，不需要测试真机则不用安装

$ brew install usbmuxd

• 应用中如含有 WebView，请安装 ios-webkit-debug-proxy

$ brew install ios-webkit-debug-proxy

• 请安装 carthage 来构建 Macaca XCTestWD.

$ brew install carthage

       备注：使用brew命令需要安装Homebrew（一款常用的 MacOS 的包管理器），请按照官网提示安装。

• 准备 App 包：如需要测试 iOS 应用，请使用 Scheme 设置为 debug 的 .app 包。

       iOS 真机环境，详情见macaca使用中各种坑 中的第10点。

插件：

       devtool
       安装：$ npm install devtool -g

       webdriver-client
       安装：$ npm i webdriver-client --save

       mocha

       WebDriverAgent
       定位到根目录，执行./Scripts/bootstrap.sh

       gradle
       安装：$ npm i gradle --save-dev

       iosutil

demo：

       sample-nodejs

       Macaca Sample

环境检查

       通过 macaca doctor 可以检查环境是否配置成功

$ macaca doctor

资源网址：

       macaca官网

       TesterHome

一些开源镜像

       由于网络原因导致的安装失败可以通过指定软件的镜像来解决
       Chromedriver 和 Electron 可以使用如下镜像：

$ export CHROMEDRIVER_CDNURL=http://npm.taobao.org/mirrors/chromedriver/$ export ELECTRON_MIRROR=https://npm.taobao.org/mirrors/electron/

       Homebrew 可以使用如下镜像：

HOMEBREW_BOTTLE_DOMAIN=https://mirrors.ustc.edu.cn/homebrew-bottles brew install ios-webkit-debug-proxy

二、安装macaca

# 安装工具包和驱动$ npm i macaca-cli macaca-ios -g$ git clone https://github.com/macaca-sample/sample-nodejs.git --depth=1$ cd sample-nodejs# 安装项目依赖$ npm i

       官方建议用npm，但是有时候安装不上，可以使用cnpm来安装

三、运行macaca

       1、macaca run --verbose -d ./macaca-test/macaca-ios-test.js

       注意，$ macaca run --verbose 直接运行是运行pc端的模拟器

       2、$ make test-ios 更多运行方式见 Makefile

四、命令行工

执行测试用例

# run test in current cwd$ macaca run --verbose# 指定测试文件目录及测试框架，此功能只支持 Node.js 版# 目前支持 mocha, jasmine, tman 和 ava。$ macaca run -d ./test -f mocha# 将结果导出为文件$ macaca run -o# 静默执行（只支持桌面浏览器）$ macaca run --no-window# 使用自定义的报告器$ CUSTOM_DIR=path/to/screenshot macaca run -d ./test --reporter macaca-simple-reportormacaca-simple-reportor 是自定义报告器的一个示例，可以作为参考。

只启动服务器

# 普通用法，添加了 --verbose 可以看到详细的信息$ macaca server --verbose# 设置端口号$ macaca server -p 3456

检查当前 Macaca 的安装环境

$ macaca doctor

更多的选项

$ macaca -h# 服务器相关选项$ macaca server -h# 如何执行用例的选项$ macaca run -h