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

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

官方环境配置教程: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 carthageAndroid
[*]安装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
具体勾选效果如下:

https://private-alipayobjects.alipay.com/alipay-rmsdeploy-image/skylark/png/234/f36455d448d5f68c.png

https://private-alipayobjects.alipay.com/alipay-rmsdeploy-image/skylark/png/234/d2a73e09648bbd0e.png
上面第一张图中红框标记的ANDROID_HOME地址是安卓SDK的路径,需要配置到环境变量中,配置方法同gradle一样
如上都配置好后,需要将两个环境变量拼接到系统的PATH变量中,全部配置完成后的内容如下:

https://private-alipayobjects.alipay.com/alipay-rmsdeploy-image/skylark/png/234/68dcf52f9b0800f4.png
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 备注:

[*]当需要更新相应驱动时,直接执行如上的安装命令即可
[*]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命令检查当前环境配置:

https://private-alipayobjects.alipay.com/alipay-rmsdeploy-image/skylark/png/234/e7208deade6deee2.png
如图为常规的Macaca环境配置结果,现在Macaca在环境上做了相对严格的校验,如果有部分依赖安装不成功,会给出相应的提示,针对性解决即可。

乐哈哈yoyo 发表于 2017-6-29 10:29:18

写的很好,步骤很详细,值得学习!

草帽路飞UU 发表于 2017-6-29 10:30:19

乐哈哈yoyo 发表于 2017-6-29 10:29
写的很好,步骤很详细,值得学习!

谢谢支持!

洒脱 发表于 2017-6-29 10:55:12

写的很好哦

洒脱 发表于 2017-6-29 10:56:59

写的很棒哦
页: [1]
查看完整版本: 从无到有搭建 Macaca 环境 (forMac)