MonkeyRunner is DEAD

UI Automator

developer.android.com/training/te…

Android 平台全部自动化测试框架的底层实现都依赖官方提供的 UI Automator 测试框架，适用于跨系统和已安装应用程序的跨应用程序功能UI测试。主要功能包括三部分：

• UI Automator Viewer 检查布局层次结构的查看器。
• UiDevice 设备状态信息并在目标设备上执行操做的API。
• UI Automator API 支持跨应用程序UI测试的API。

UI Automator Viewer

PC 端 GUI 工具，扫描和分析 Android 设备上当前显示的 UI 组件。展现 UI 布局层次结构，查看设备上当前对用户可见的 UI 组件的属性。从名称能够看出，它是 UI Automator 的只读功能部分，即只能查看 UI 组件的树形结构和属性，不能操做控制 UI 组件。

uiautomatorviewer 位于 <android-sdk>/tools/bin 目录。
启动入口是一个bash文件，实际调用 <android-sdk>/tools/lib 目录的 uiautomatorviewer-26.0.0-dev.jar 。
GUI 基于 Eclipse + SWT 实现，使用 Gradle 构建。
系列工具源码在 https://android.googlesource.com/platform/tools/swt/ 。 依赖 https://android.googlesource.com/platform/tools/base/ 。
活跃分支： mirror-goog-studio-master-dev 。
该仓库还包含如下工具。

• chimpchat
• ddms
• hierarchyviewer2
• monkeyrunner
• swtmenubar
• traceview

其内部实现基于 adb shell uiautomator dump 。从源码仓库提交记录看，主要功能开发的活跃时间是 2014-2015，2016以后已经不多更新维护。那个年代的 Android 开发主要使用 Eclipse ， 因此基于 SWT 实现多平台 PC GUI ，在当时合理。

该工具实际使用运行不稳定，极易报错。

Error while obtaining UI hierarchy XML file: com.android.ddmlib.SyncException: Remote object doesn't exist!

错误缘由一般是：

• adb 链接通道不稳定。
• 机型兼容性问题，权限问题。
• 当前手机应用程序界面处于动态，例如播放视频，动画。而且10秒超时时间仍未进入静态。

分析源码可知，错误都源于 Android Framework uiautomator 。

MonkeyRunner

developer.android.com/studio/test…

官方提供的另一个工具，封装 uiautomator API，供 Python 脚本调用，也可注入 java 扩展插件。
相比 uiautomatorviewer 和 uiautomator 命令行工具，可编程扩展性更佳。
MonkeyRunner 使用了比较冷门的 Jython 实现。

1. 启动运行入口

monkeyrunner -plugin <plugin_jar> <program_filename> <program_options>

monkeyrunner 是一个bash文件，位于 <android-sdk>/tools/bin ，启动调用 <android-sdk>/tools/lib/monkeyrunner-26.0.0-dev.jar 。

export ANDROID_HOME="~/Library/Android/sdk"
$ANDROID_HOME/tools/bin/monkeyrunner uiparser.py
复制代码

2. 主要方法

MonkeyDevice.getProperty()

等同于调用 adb shell getprop <keyword> 。获取设备系统环境变量。
不一样厂商的设备，key可能不一样。针对具体测试机型，可以使用 adb shell getprop ，显示全部系统环境变量的key。

MonkeyDevce.shell()

等同于调用adb shell命令。

3. 缺陷

MonkeyRunner 基于 Jython 2.5.3 。看上去结合了Java和Python的优点，实际对于Java和Python编程都不友好。

• Jython 2.5.3 过期，主流的Python 3.x和2.7的不少语法和库没法使用。
• 使用vscode等编辑器编码时，缺乏智能提示和自动补全。编辑器和pylint没法识别导入的库， 例如 from com.android.monkeyrunner import MonkeyRunner, MonkeyDevice, MonkeyImage 。
• Jython 彷佛不能像常规的python程序同样引用外部库。实测只能使用 MonkeyRunner 内置的 os, sys, subprocess 等库。
• Java extend plugin 能作的事情较少。

MonkeyRunner 实际仍然是使用 adb shell 和其中的 uiautomator 命令获取UI组件状态和属性。因此它跟 UI Automator Viewer 同样受限于 uiautomator 自己的缺陷，致使运行不稳定。

adb shell uiautomator

adb
developer.android.google.cn/studio/comm…

adb shell am
developer.android.google.cn/studio/comm…
使用 Activity Manager (am) 工具发出命令以执行各类系统操做，如启动 Activity、强行中止进程、广播 intent、修改设备屏幕属性及其余操做。

adb shell pm
developer.android.google.cn/studio/comm…
使用软件包管理器 Package Manager (pm) 工具发出命令，安装，卸载，查询安装包。

adb shell uiatomator
官网相关页面已被删除，仅能从搜索引擎历史快照中找到。猜想可能近期会有变动，或者官方建议再也不使用。
经过执行命令能够查看使用方法和参数。

Usage: uiautomator <subcommand> [options]

Available subcommands:

help: displays help message

runtest: executes UI automation tests
    runtest <class spec> [options]
    <class spec>: <JARS> < -c <CLASSES> | -e class <CLASSES> >
      <JARS>: a list of jar files containing test classes and dependencies. If
        the path is relative, it's assumed to be under /data/local/tmp. Use absolute path if the file is elsewhere. Multiple files can be specified, separated by space. <CLASSES>: a list of test class names to run, separated by comma. To a single method, use TestClass#testMethod format. The -e or -c option may be repeated. This option is not required and if not provided then all the tests in provided jars will be run automatically. options: --nohup: trap SIG_HUP, so test won't terminate even if parent process
               is terminated, e.g. USB is disconnected.
      -e debug [true|false]: wait for debugger to connect before starting.
      -e runner [CLASS]: use specified test runner class instead. If
        unspecified, framework default runner will be used.
      -e <NAME> <VALUE>: other name-value pairs to be passed to test classes.
        May be repeated.
      -e outputFormat simple | -s: enabled less verbose JUnit style output.

dump: creates an XML dump of current UI hierarchy
    dump [--verbose][file]
      [--compressed]: dumps compressed layout information.
      [file]: the location where the dumped XML should be stored, default is
      /sdcard/window_dump.xml

events: prints out accessibility events until terminated
复制代码

uiautomator 缺陷

运行耗时长，失败率高，频繁报错。
ERROR: could not get idle state. 一般表示当前UI处于动态渲染刷新期间，例如正在播放视频，动画。在10秒超时时间内仍未进入静态。由于此时 UI 树的节点对象快速变化中，不能稳定获取。

uiautomator 源码

PC端工具源码位于仓库 android.googlesource.com/platform/fr… master 分支。
最新更新于 2014.11.14。以后活跃分支变动为 android-support-test 分支。uiautomator 源码被移除，改为 android.support.test library, expresso 等工具的源码工程。
手机端框架源码位于仓库 android.googlesource.com/platform/fr… master 分支。
uiAutomation.waitForIdle(1000, 1000 * 10); 是报错的关键代码，即单次超时等待1秒，最长超时等待10秒。超时抛出异常。

DumpCommand.java

android.googlesource.com/platform/fr…

// It appears that the bridge needs time to be ready. Making calls to the
// bridge immediately after connecting seems to cause exceptions. So let's also
// do a wait for idle in case the app is busy.
try {
    UiAutomation uiAutomation = automationWrapper.getUiAutomation();
    uiAutomation.waitForIdle(1000, 1000 * 10);
    AccessibilityNodeInfo info = uiAutomation.getRootInActiveWindow();
    if (info == null) {
        System.err.println("ERROR: null root node returned by UiTestAutomationBridge.");
        return;
    }
    Display display =
            DisplayManagerGlobal.getInstance().getRealDisplay(Display.DEFAULT_DISPLAY);
    int rotation = display.getRotation();
    Point size = new Point();
    display.getSize(size);
    AccessibilityNodeInfoDumper.dumpWindowToFile(info, dumpFile, rotation, size.x, size.y);
} catch (TimeoutException re) {
    System.err.println("ERROR: could not get idle state.");
    return;
} finally {
    automationWrapper.disconnect();
}
System.out.println(
        String.format("UI hierchary dumped to: %s", dumpFile.getAbsolutePath()));
复制代码

UiAutomation.java

android.googlesource.com/platform/fr…

/** * Waits for the accessibility event stream to become idle, which is not to * have received an accessibility event within <code>idleTimeoutMillis</code>. * The total time spent to wait for an idle accessibility event stream is bounded * by the <code>globalTimeoutMillis</code>. * * @param idleTimeoutMillis The timeout in milliseconds between two events * to consider the device idle. * @param globalTimeoutMillis The maximal global timeout in milliseconds in * which to wait for an idle state. * * @throws TimeoutException If no idle state was detected within * <code>globalTimeoutMillis.</code> */
public void waitForIdle(long idleTimeoutMillis, long globalTimeoutMillis) throws TimeoutException {
    synchronized (mLock) {
        throwIfNotConnectedLocked();
        final long startTimeMillis = SystemClock.uptimeMillis();
        if (mLastEventTimeMillis <= 0) {
            mLastEventTimeMillis = startTimeMillis;
        }
        while (true) {
            final long currentTimeMillis = SystemClock.uptimeMillis();
            // Did we get idle state within the global timeout?
            final long elapsedGlobalTimeMillis = currentTimeMillis - startTimeMillis;
            final long remainingGlobalTimeMillis =
                    globalTimeoutMillis - elapsedGlobalTimeMillis;
            if (remainingGlobalTimeMillis <= 0) {
                throw new TimeoutException("No idle state with idle timeout: "
                        + idleTimeoutMillis + " within global timeout: "
                        + globalTimeoutMillis);
            }
            // Did we get an idle state within the idle timeout?
            final long elapsedIdleTimeMillis = currentTimeMillis - mLastEventTimeMillis;
            final long remainingIdleTimeMillis = idleTimeoutMillis - elapsedIdleTimeMillis;
            if (remainingIdleTimeMillis <= 0) {
                return;
            }
            try {
                  mLock.wait(remainingIdleTimeMillis);
            } catch (InterruptedException ie) {
                  /* ignore */
            }
        }
    }
}
复制代码

Android Device Monitor

developer.android.com/studio/prof…

Android SDK 工具集的 Android Device Monitor 已废弃。

Android Device Monitor was deprecated in Android Studio 3.1 and removed from Android Studio 3.2. The features that you could use through the Android Device Monitor have been replaced by new features. The table below helps you decide which features you should use instead of these deprecated and removed features.

官方给出的替代品 Layout Inspector 功能更强大，界面也更美观，但目前还不成熟，相比 iOS 神器 Reveal ， 仍需努力。
developer.android.com/studio/debu…

uiparser

参照 MonkeyRunner 官方文档实现的 Python Demo。

github.com/9468305/pyt…

TODO

基于上述问题，我准备写一个更智能更稳定更高效的 UI Inspecotr ，基于 AndroidX UIAutomation ，使用 Kotlin 实现。