操作步骤

1. 安装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环境变量

3. 安装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-client
  • cnpm 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-python
  • Python API文档：https://macacajs.github.io/wd.py/

6. 常用命令

• 启动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 -h
  • macaca server -h
  • macaca run -h
  • macaca doctor -h

问题记录

1. 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所需内容

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

   
   image.png