前言

用 Macaca 可以快速、便捷地进行安卓 native 的自动化测试，用简洁的 js 语法，写下用例，然后执行 Macaca CLI 命令，就可以看到安卓的手机在按照你的指令自动进行用例操作。相关文章可参考：
使用 Macaca 测试 Android 应用

Macaca 对于 native 的自动化测试主要利用了 UIAutomator 。Macaca 是如何将这一 Java 写成的工具集成到自身的呢，本文将对此进行分析，让大家更加快乐、明白地使用 Macaca 。

自动化利器－UIAutomator

首先介绍下 UIAutomator。UIAutomator 是随 Android SDK 一起发布的一个测试框架，该测试框架提供了一系列 API，利用这些 API 我们可以编程和安卓 App 进行交互，例如：打开设置菜单，点击，滑动等。并且可以对设备进行物理指令操作，如：旋转设备，获取设备分辨率等。该测试框架的 jar 包可以在 SDK 的安装目录中找到:

$ANDROID_HOME/platforms/android-$version/uiautomator.jar

其中 $version 为安装的 SDK 版本号

下面是 UIAutomator 框架的类图：

类图出处连接

图中，用来写测试用例的常用几个类简介：

UiObject 代表一个设备上可见的 ui 元素
UiScrollable 用来在可滚动 ui 容器中查找元素。因为有的元素要滚动后才可以看到
UiSelector 条件对象，和 UiObject 对象一起使用来根据条件查找元素
UiCollection ui 元素对象的集合
UiDevices 通过 getUiDevices 方法获得一个单例的对象，通过该对象可以进行一些设备相关的操作

测试原理

Macaca 主要有两个模块来负责操作设备的自动化测试，一个是 macaca-adb，一个是 uiautomator-client。macaca-adb 用 Nodejs 对安卓 adb 命令进行了包装，以供其他 node 模块调用，可以用其来进行模拟器的启动，端口号映射，获取设备等操作。uiautomator-client 模块是我们分析的主角。

Java 端测试用例编写方法

我们先来看 Java 端一般是如何跑 UIAutomator 测试用例的。创建一个 Java 工程，编写用例类，UIAutomator 的测试入口是一个 UIAutomatorTestCase 的子类，范例如下：

import com.android.uiautomator.testrunner.UiAutomatorTestCase;

public class test extends UiAutomatorTestCase {   
    public void testMain() throws UiObjectNotFoundException {   
         // 用例代码 
    }
}

然后在该工程根目录下执行命令

android create uitest-project

会在工程下生成一个 ant 的 build.xml 文件，接着用 ant 对该工程进行编译打包，在工程的 bin 目录下生成 jar 包。

将生成的 jar 包用adb push到安卓设备上，然后执行

adb shell uiautomator runtest jar包名 -c 测试类名

最后我们的 UIAutomator Java 用例代码便运行起来了。

Macaca 的做法

uiautomator-client 模块会在本地机器和安卓设备之间建立 socket 连接，然后自动化指令就通过 socket 进行传输。既然是建立 socket ，那么必然有客户端和服务端的 socket 服务建立过程。本机上的 socket 服务建立用 Nodejs 建立并监听即可。对于手机端的 socket 服务建立，我们把 Java 建立 socket 的过程放在 UIAutomator 用例的入口处，如下：

import com.android.uiautomator.testrunner.UiAutomatorTestCase;

public class test extends UiAutomatorTestCase {   
    public void testMain() throws UiObjectNotFoundException {   
          // 建立socket服务
         initSocketServer();
    }
}

然后我们将“ Java 端测试用例编写方法”这一小节描述的过程用 Nodejs 的代码进行封装，所涉及的 adb 命令由 macaca-adb 模块搞定，包括 ant 编译命令也通过 Nodejs 来封装执行，生成一个驱动 jar 包，最后将这个 UIAutomator 驱动模块 push 到安卓设备并启动，这样安卓设备就建立 socket 服务完毕。下面从代码上详细分析一下该过程。

安装了 uiautomator-client，并成功跑过一次安卓测试用例的同学，可以在 uiautomator-client 的安装目录下查找 uiautomator-client 文件夹，可以发现该文件夹下包含了一个标准的 UIAutomator 的测试用例工程：

这个工程就是被上图中 scripts 文件夹下的 build.js 创建的。Macaca UIAutomator 驱动的编译过程就是在 build.js 中进行的。

我们来看 build.js 中的逻辑，先通过 checkEv 函数来检测系统环境变量 ANDROID_HOME 有没有配置，因为需要用到 SDK 目录下的 Android Tools 工具：

var checkEnv = function() {
  return JAVA_HOME.getPath().then(javaHome => {
    console.log('JAVA_HOME is set to ' + javaHome);

    var env = global.process.env;

    if (!env.ANDROID_HOME) {
      console.log('ANDROID_HOME is not set');
      throw new Error('ANDROID_HOME is not set');
    }

    var android = isWindows ? 'android.bat' : 'android';
    var androidTool = path.resolve(env.ANDROID_HOME, 'tools', android);

    if (!_.isExistedFile(androidTool)) {
      console.log('`android` command was not found');
      throw new Error('`android` command was not found');
    }

    var sdkVersion = selectAndroidSdkSync();

    if (!sdkVersion) {
      console.log('no avaliable sdk');
      throw new Error('no avaliable sdk');
    }

    sdkVersion = sdkVersion[sdkVersion.length - 1];

    var args = ['create', 'uitest-project', '-n', fileName, '-t', sdkVersion, '-p', '.'];

    return [androidTool, args];
  });
};

然后用 createUITest 函数来创建一个标准的 UIAutomator 测试工程，并生成了 ant build 文件：

var createUITest = function(res) {
  var androidTool = res[0];
  var args = res[1];
  return new Promise((resolve, reject) => {
    var createProcess = spawn(androidTool, args, {
      cwd: cwd
    });

    createProcess.on('error', err => {
      console.log(err);
      reject(err);
    });

    createProcess.stdout.setEncoding('utf8');
    createProcess.stderr.setEncoding('utf8');

    createProcess.stdout.on('data', data => {
      console.log(data);
    });

    createProcess.stderr.on('data', data => {
      console.log(data);
    });

    createProcess.on('exit', code => {
      if (code !== 0) {
        reject(new Error('setup failed'));
      } else {
        resolve();
      }
    });
  });
};

然后通过 buildBootstrap 函数来进行 Java 编译，其中用到一个 ant 的 npm 包:

var buildBootstrap = function() {
  return new Promise((resolve, reject) => {
    var buildProcess = spawn(ant, ['build'], {
      cwd: cwd
    });

    buildProcess.on('error', err => {
      return reject(err);
    });

    buildProcess.stdout.setEncoding('utf8');
    buildProcess.stderr.setEncoding('utf8');

    buildProcess.stdout.on('data', data => {
      console.log(data);
    });
    buildProcess.stderr.on('data', data => {
      console.log(data);
    });

    buildProcess.on('exit', code => {
      if (code !== 0) {
        reject(new Error('build failed'));
      } else {
        console.log(fileName + ' build success!');
        resolve();
      }
    });
  });
};

需要特别注意的是，设备端 socket 服务监听的是设备端口，本地电脑端服务监听的本机的端口，要想连通这两端的 socket，需要用 adb 工具进行端口映射，命令如下：

adb forward tcp:A tcp:B

通过该 adb 命令可以将发往本机 A 端口的数据重定向到安卓设备的 B 端口。

有了 socket 连接，就可以将测试指令发往 UIAutomator 驱动，驱动根据不同的指令参数去执行用 UIAutomator API 写成的 Java 用例。

小结

将上一小节的分析用一个图来进行总结，给大家一个全局认识

用 UIAutomator API 编写自动化代码

可以看到，最终我们的自动化指令是要通过 UIAutomator 这个框架来驱动的，如何用该框架的 API 进行自动化代码编写读者可以参照网上的各种教程，这里笔者通过 Swipe 操作的实现来简单地介绍 Macaca 是如何使用该框架 API 的。

首先将操作指令都用一个类表示：Swipe.java，它实现 execute 方法，通过 socket 收到 json 字符串指令后，解析字符串，根据字符串去调用对应的指令类实例的 execute 方法。范例如下：

import com.android.uiautomator.core.UiDevice;

public class Scroll {
    public String execute(JSONObject args) throws JSONException {
        try {
            boolean result = UiDevice.getInstance().swipe(50, 300, 50, 10, 1000);
            return success(result);
        } catch (final Exception e) {
            return failed("UnknownError");
        }
    }
}

其中 UiDevice 是 UIAutomator 框架下的类，且是单例的，通过getInstance获取实例后调用swipe来模拟设备上的手势滑动。

在 Macaca 测试用例中用driver.swipe(startX, startY, endX, endY, duration)的方式编写滑动用例，下面给出两种滑动的自动化效果范例：

上下滑动图片

左右滑动

总结

本文简要分析了 Macaca 利用 UIAutomator 的原理，抛砖引玉。但是实际的代码实现需要考虑更多的东西，也更为复杂，且这部分也仅仅是 Macaca 的一个模块。但是 Macaca 代码都是开源的，觉得本文写的不够详细或有兴趣深入的同学可以亲自去看看其源码。Macaca 也还有很多不足，欢迎大家参与其中，多提意见多支持。^_^

本文所涉及相关模块的 github 地址：

macaca-adb

uiautomator-client

ant-lite

两个范例的代码地址（打包好的 apk 均命名为 app-release.apk 放在工程根目录下，可直接在用例中引用）：

左右滑动：https://github.com/brunoyang/android-bootstrap

上下滑动：https://github.com/kobe990/vertical-swipe