macaca环境配置

LiteralliJeff

操作步骤

安装JDK

jdk需要是1.8版本

• 配置环境变量
  
  win+r输入rundll32.exe sysdm.cpl,EditEnvironmentVariables环境变量新增：JAVA_HOME = “jdk安装地址”，同时在path下新增%JAVA_HOME%\jre\bin，%JAVA_HOME%\jre\bin
  校验是否安装成功，命令行中输入 java -version，显示如下即配置成功
  
  
  
  image.png
  
  
  
  
  

2.安装Nodejs

nodejsv8.0 或者更高版本
nodejs集成了npm，命令行中输入npm -v ，显示版本即可



image.png



• 配置默认全局模块的存放路径，方便查找
  
  npm config set prefix "node安装路径\node_global"npm config set cache "node安装路径\node_cache"配置环境变量：将"node安装路径\node_global"添加到系统变量path中
  
  
  
• 安装cnpm
  
  npm config set registry http://registry.npm.taobao.org命令行输入 cnpm -v ,这一步如果报错，请参考上面---配置node_globa环境变量
  
  
  

安装SDK

sdk下载对应版本即可



image.png



解压后打开SDK manager.exe 文件，安装如下



image.png



配置环境变量

新增系统变量：ANDROID_HOME  = sdk安装地址
;%ANDROID_HOME%\platform-tools;%ANDROID_HOME%\tools;加入到系统变量path中



image.png


命令行输入 adb  version  显示对应版本即成功

4.安装Gradle

Gradle下载解压即可

• 配置环境变量
  
  新增系统变量：GRADLE_HOME = gradle解压地址%GRADLE_HOME%\bin 加入到系统变量path中
  命令行输入gradle -v
  
  
  
  image.png
  
  
  
  
  

5.安装Macaca

命令行：cnpm i macaca-cli -g，出现一只猴子脸说明安装成功



image.png


由于前面设置了全局模块安装路径，在对应路径下会生成 macaca-cli文件夹
命令行：macaca doctor，查看macaca配置



image.png



• 根据需要安装驱动即可
  
  cnpm i macaca-android -g   安装Android驱动cnpm i macaca-ios -g            安装ios驱动cnpm i macaca-electron -g   安装electron环境驱动cnpm i macaca-chrome -g    安装chrome驱动cnpm install webdriver-client  安装webdriver-clientcnpm i app-inspector -g    安装app-inspector
  
  
  
• 开源镜像
  
  chrome-driver：http://npm.taobao.org/mirrors/chromedriver/electron：https://npm.taobao.org/mirrors/electron/
  
  
  
• 官网
  
  Sample示例地址: https://github.com/macaca-sample/macaca-test-sample-pythonPython API文档：https://macacajs.github.io/wd.py/
  
  
  

常用命令

• 启动Macaca服务
  
  macaca server --verbose 加--verbose，打印详细日志python tests/macaca-desktop-sample.test.py  运行测试macaca server 正常模式macaca server -p 3456 设置端口macaca server -p 3456 & 设置端口后台运行macaca server --verbose输出详细日志
  
  
  
• 测试
  
  macaca run  运行当前目录用例集macaca run -d ./test 运行指定目录下用例集macaca doctor 环境检查
  
  
  
• 帮助
  
  macaca -hmacaca server -hmacaca run -hmacaca doctor -h
  
  
  

问题记录

SDK manager.exe文件打不开，闪退

• 解决方案：
  
  文件下载地址：https://pan.baidu.com/s/19EYPseh43Ks0gnsv30xlUA密码：hi5u下载解压后将 find_java.bat替换掉SDK文件下\tools\lib下面的find_java.bat；原因好像是r17以上的版本重写了find_java.bat，需要替换回r16的版本
  
  
  

2.SDK manager下载不了东西或者很慢

解决方案:可以配置对应host；将dl.google.com通过https://site.ip138.com/dl.google.com/ 查询对应可用ip，将能够ping 通的ip加入到host里即可


image.png

3.执行cnpm i macaca-android -g  报错，提示License for package Android SDK Build-Tools 28.0.2 not accepted

image.png

• 解决方案
  
  
  （1）进入sdk安装目录下，文件地址行输入cmd回车，打开命令行工具
  
  
  
  image.png
  
  
  （2）输入sdkmanager.bat --licenses，执行之后，它会提示你去允许认证，然后命令会提醒你确定y/n（accept lincense），一路y下去便可以了。（3）若提示“Error: Unknown argument --licenses，说明版本太低，执行sdkmanager.bat --update，一路y下去便可以了。（4）成功后，再次执行cnpm i macaca-android -g  即可
  
  
  

4.执行脚本时，提示 app-debug.apk不存在，如图

image.png

• 解决方案
  
  
  （1）检查macaca-andriod 安装路径下的是否有如下两个包
  
  
  
  image.png
  
  
  （2）如果没有，则说明 macaca-android 未安装成功，再次执行cnpm i macaca-android -g（3）若还是无法成功，则说明SDK未配置，请仿照上面再次安装SDK所需内容
  
  
  

执行cnpm i macaca-chrome -g报错，如图



image.png