从无到有搭建 Macaca 环境 (forMac)

草帽路飞UU · 发表于 2017-6-29 10:20:55

官方环境配置教程：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<code></code>

复制代码

安装后可以用node -v查看版本号,如果正常则说明安装成功,Macaca2.0要求当前node版本要高于6.0，如果以前安装过低版本的Node,可以通过如下命令更新Node版本：

$brew upgrade node<code></code>

复制代码

安装cnpmhttps://cnpmjs.org/
npm是node.js的包管理工具，可以用他来安装和更新各种node的pacakage,可以理解为Java中Maven类似的作用，但是由于众所周知的那堵墙，直接用npm安装速度会非常慢，这种情况下可以安装阿里巴巴提供的cnpm，cnpm提供了国内的镜像，可以加快包的下载速度，安装方法如下：
命令行工具输入如下命令：

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

复制代码

如果在安装过程中提示 Permission 权限相关错误，可以尝试 $ sudo chown -R $USER /usr/local，永久破除 sudo 要求。
安装成功后同样可以通过cnpm -v来验证安装是否成功，安装成功后，在原来使用npm的地方，直接替换成cnpm即可，
比如，原始命令为
$npm i -g macaca-cli替换后为:
$cnpm i -g macaca-cliMacaca相关安装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等命令
$ cnpm 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. cnpm i macaca-ios -g
2. 如果提示
3. xcode-select: error: tool 'xcodebuild' requires Xcode, but active
4. developer directory '/Library/Developer/CommandLineTools' is a command
5. line tools instance
6. 命令行执行如下即可：
7. sudo xcode-select -s /Applications/Xcode.app/Contents/Developer
复制代码