Macaca环境搭建全教程

首先想要会Macaca，还得先会用github，不然你得死……因为各种例子都在git上，官网也一样，蛋疼的很……

#基础环境

1.JDK：jdk1.8-配置变量

2.Android SDK：sdk 25.0.2-配置变量

3.Cnpm：切换淘宝源，因为国外资源访问很慢，而且有些资源还无法下载(如果npm可以满足你的安装需求，可跳过此步)：

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

$ npm i -g macaca-cli 
// 等价替换
$ cnpm i -g macaca-cli

4.Node.js：要求v4.0及以上(据说v7.0的也不行，所以建议7.0以下)

5.XCode ：要求v7.3及以上（用Mac的同学直接从AppStore安装就可以

#Macaca安装

1.macaca-cli：

cnpm i macaca-cli -g

6.webdriver-client：

cnpm install webdriver-client

7.各种驱动：

$ npm i macaca-ios -g
$ npm i macaca-android -g
$ npm i macaca-chrome -g
$ npm i macaca-electron -g　　（desktop应用）

8.安装app-inspector,用于控件查找

$ npm i app-inspector -g

9.完成以上安装后，macaca doctor 校验安装环境

坑位总结

1.如果提示以下信息，请检查JDK版本。Version 52.0对应的是JDK1.8版本，于是更新本地JDK版本为1.8 问题成功解决。

[dx] Exception in thread "main" java.lang.UnsupportedClassVersionError: com/android/dx/command/Main : Unsupported major.minor version 52.0

2..Android SDK问题，Macaca支持Android最低版本为API18, 请注意，另外build-tool请不要安装预览版。

3.关于pom.xml中引用macaca的jar包问题，这里需要去设置一下你在maven中引用的镜像地址，我在maven配置的文章中有介绍。如果不设置的话，在引用的时候会发现无法加载

测试用例编写

1.下载官方提供的Java版Demo用例

https://github.com/macaca-sample/sample-java

2.脚本分析

通过导入Maven项目，发现只有一个SampleTest.java类，后期官方更新版本只需要修改pom.xml中的版本号即可，便于维护。

SetUP()实例，针对于PC端：

@Before
public void setUp() throws Exception {
   // 在setUp()中配置被测应用的基础信息，如平台版本，安装包地址等
    Logger logger = Logger.getLogger(getClass());
    JSONObject porps = new JSONObject();
    porps.put("autoAcceptAlerts", true);
    porps.put("browserName", "electron");
    porps.put("platformName", "desktop");
    porps.put("version", "");
    porps.put("javascriptEnabled", true);
    porps.put("platform", "ANY");
    JSONObject desiredCapabilities = new JSONObject();
    desiredCapabilities.put("desiredCapabilities", porps);
    driver.initDriver(desiredCapabilities).setWindowSize(1280, 800).get("https://www.baidu.com");
}

针对移动端：

@Before
public void setUp() throws Exception {

    JSONObject porps = new JSONObject();
    porps.put("autoAcceptAlerts", true);
    porps.put("platformVersion", "9.3");
    porps.put("deviceName", "iPhone 5s");
    porps.put("platformName", "iOS");
    // 指定待测应用的安装包
    porps.put("app", "**/**/targetApp.zip"); 
    JSONObject desiredCapabilities = new JSONObject();
    desiredCapabilities.put("desiredCapabilities", porps);
    driver.initDriver(desiredCapabilities);
    driver.platform = "ios"; 
    }

需要注意的是，对于iOS平台，app的安装包需要基于.app包压缩后的zip包，而不能用.ipa包进行压缩，对于模拟器，可以直接安装使用，但是对于真机，则需要涉及证书签名等问题，后期介绍。

另外，对于配置参数，iOS与安卓有各自特有的参数请结合官方文档使用。

用例编写

@Test
public void test_case_1() throws Exception {
    driver
        .elementById("kw")
        .sendKeys("macaca")
        .sleep(1000)
        .elementById("su")
        .click()
        .sleep(3000);
      
    String html = driver.source();

    Assert.assertThat(html, containsString("<html>"));

    driver
        .elementByCss("#head > div.head_wrapper")
        .elementByXPath("//*[@id="kw"]")
        .sendKeys(" elementByXPath")
        .elementById("su")
        .click()
        .takeScreenshot();
}

以上是JavaScript写法，更简洁。

执行用例

Javascript版本的用例可以直接通过一条命令启动macaca server并运行case,而Java版的用例则需要单独启动Macaca server，然后执行测试用例

1.进工程目录：

$cd path/to/macaca-test-sample-java

2.启动Macaca Server：

$macaca server
追加--verbose，可查看启动详情
$macaca server --verbose

3.当前工程的目录下cmd

$mvn -s settings.xml clean install  （下载依赖包）
$mvn test    （执行用例）

UI控件-Inspector

早期，查找控件依赖于Android自带的UIAutomator viewer，iOS则依赖于XCode中的Accessibility Inspector，但是这两种工具查找起来相对麻烦，效率相对低下，针对这个问题，Macaca团队提供了统一的Inspector工具，可以以Web的方式，方便的查看不论是安卓还是iOS的控件。

常用链接

Macaca官方教程

TestHome社区-Macaca一些技术贴

Macaca源码