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

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

$brew upgrade node 

安装 cnpm

https://cnpmjs.org/

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

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

如果在安装过程中提示 Permission 权限相关错误,可以尝试 $ sudo chown -R $USER /usr/local,永久破除 sudo 要求。

安装成功后同样可以通过 cnpm -v 来验证安装是否成功,安装成功后,在原来使用 npm 的地方,直接替换成 cnpm 即可,
比如,原始命令为

$npm i -g macaca-cli

替换后为:

$cnpm i -g macaca-cli

Macaca 相关安装

iOS

如果不针对 iOS 作自动化,可以忽略此处

  1. 安装 XCode(依赖 Mac 电脑,AppStore 下载即可)
  2. 安装相关工具
$ brew install usbmuxd

$ brew install ios-webkit-debug-proxy

$ brew install carthage

Android

  1. 安装 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 如果能正常打印出环境变量,则证明环境变量已经配置成功

  1. 安装 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       // iOS驱动(用于iOS平台自动化)
$ cnpm i macaca-android -g  // Android驱动(用于安卓平台自动化)
$ cnpm i macaca-chrome -g  // chrome 驱动
$ cnpm i macaca-electron -g  // electron 驱动

备注:

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

如图为常规的 Macaca 环境配置结果,现在 Macaca 在环境上做了相对严格的校验,如果有部分依赖安装不成功,会给出相应的提示,针对性解决即可。

附录

“Macaca 开源社区” 群的钉钉群号: 11775486(欢迎入群讨论,钉钉顶部搜索框搜索群号加入即可)

更多相关文章

UI 自动化框架调研总结
从无到有搭建 Macaca 环境 (forMac)
Macaca-Java 版入门指南
UI 自动化 Macaca-Java 版实践心得
UI 自动化利器 - 为你的应用自动添加控件 ID 探索
Macaca 基础原理浅析


↙↙↙阅读原文可查看相关链接,并与作者交流