1. 前言

本来这次文章的title是写成和前几篇类似的《EasyMonkeyDevice API实践全记录》，内容也打算把每一个API的实践和建议给记录下来，但后来想了下认为这样子并非最好的方法，鉴于EasyMonkeyDevice事实上就是在前几章描写叙述的MonkeyDevice和HierarchyViewer的基础上加了一层Wrapper，把原来的通过接受坐标点或者ViewNode来操作控件的思想统一成通过控件ID来操作。事实上终于它们都会转换成坐标点或ViewNode进行操作。以touch和visible这两个API为样例，大家看下下面的源代码就非常清楚了。

MonkeyDevice里面的touch是用坐标点作为參数的。而以下的EasyMonkeyDevice用得是id(By这个类里面就一个ID而已。有兴趣查其源代码），终于还是转成坐标点：

public void touch(By selector, TouchPressType type)
    {
        Point p = getElementCenter(selector);
        mDevice.getImpl().touch(p.x, p.y, type);
    }

HierarchyViewer里面的Visible用的是ViewNode。EasyMonkeyDevice用得是id,终于还是转成ViewNode：

public boolean visible(By selector)
    {
        ViewNode node = selector.findView(mHierarchyViewer);
        return mHierarchyViewer.visible(node);
    }

所以本文应该除了给出API的实践之外还应该把每一个API和其与MonkeyDevice和HierarchyViewer的API所相应的API给列出来做一个相应的Map，方便我们參考。

实践中我们还是用SDK自带的NotePad APK，如果已经有一个Note存在的情况下，通过下面步骤来走一遍EasyMonkeyDevice的全部API：

• 使用MonkeyDevice对象实例化EasyMonkeyDevice
• 通过ID Touch一个Note
• 获得进入NoteEditor activity后的WindowId并验证是否正确
• 通过ID检查Note的内容这个EditText是否存在和可见
• 通过Note的ID获得Text
• 通过Note的ID Type进新Text
• 通过Note的ID获得Location

下面是我们操作过程中会看到的两个Activity的截图。先贴上来给大家对以上步骤有一个感性认识，最后我会贴出实践验证性代码。

NotesList Activity截图：

watermark/2/text/aHR0cDovL2Jsb2cuY3Nkbi5uZXQvemh1YmFpdGlhbg==/font/5a6L5L2T/fontsize/400/fill/I0JBQkFCMA==/dissolve/70/gravity/Center" >

NoteEditor Activity截图：

2. EaysyMonkeyDevice API List and Sample

EasyMonkeyDevice是在MonkeyDevice和HierarchyViewer的基础上出来的一个类。依照本人的理解，主要添加的功能就是：

• 在MonkeyDevice和HierarchyViewer的基础上针对部分API添加了对控件ID的支持以操作控件

下面是个人整理的列表：尝试对全部的API进行一个描写叙述和演示样例Demo

3. EasyMonkeyDevice vs MonkeyDevice API Mapping Matrix

这里会列出MonkeyDevice的全部API已经EasyMonkeyDevice与其相应的API。没有去掉冗余是由于方便今后Reference的时候知道EasyMonkeyDevice并非全然把全部MonkeyDevice的API都进行Wrap的，仅仅有以下两个。

以下一章理同。

• touch:MonkeyDevice通过坐标点touch；EasyMonkeyDevice通过控件ID去touch
• type:MonkeyDevice往当前focused地方输入。EasyMonkeyDevice往由ID指定控件输入

4. EasyMonkeyDevice vs HierarchyViewer Mapping Matrix

EasyMonkeyDevice Wrap了HiearchyViewer 的对应API而得到下面这些API

• getFocusedWindowId：Wrap了hierarchyviewer的getFocusedWindowName。不再使用ViewNode而使用ID来的获得Window id/Name，事实上依据我的实践id/name是同一回事
• locate：事实上就是把HierarchyViewer的getAbsolutePositionOfView和getAbsoluteCenterOfView整合在一起获得起始坐标和Width/Hight,前者获得事实上坐标，后者获得中心位置。相减后乘以2就是EasyMonkeyDevice想要的Width/Hight了
• visible： 相同是把參数由ViewNode改成id
• getText：同上

5. EasyMonkeyDevice Standalone API

剩下一个API是没有跟以上的MonkeyDevice和HierarchyViewer有不论什么相应关系的：

• visible：通过id检查该控件是否存在，猜想应该是google在代码重构的时候添加的一个方法方便大家推断而已

6. 验证性代码

from com.android.monkeyrunner import MonkeyRunner,MonkeyDevice,MonkeyImage
from com.android.monkeyrunner.easy import EasyMonkeyDevice,By
from com.android.chimpchat.hierarchyviewer import HierarchyViewer
from com.android.hierarchyviewerlib.models import ViewNode, Window
from java.awt import Point

#from com.android.hierarchyviewerlib.device import 

#Connect to the target device

device = MonkeyRunner.waitForConnection()

eDevice=EasyMonkeyDevice(device)
device.startActivity(component="com.example.android.notepad/com.example.android.notepad.NotesList")

'''
MonkeyRunner.sleep(2)
print 'Show Menu Options'
device.press('KEYCODE_MENU',
             MonkeyDevice.DOWN_AND_UP);

MonkeyRunner.sleep(3)
print 'Press on the menu entry of  \"Add note\"'
eDevice.touch(By.id('id/title'),
               MonkeyDevice.DOWN)

MonkeyRunner.sleep(2)
device.press('KEYCODE_MENU',
             MonkeyDevice.DOWN_AND_UP);
'''

#Step 1: try touching on the first note
eDevice.touch(By.id('id/text1'),
              MonkeyDevice.DOWN_AND_UP)

#Step 2: Get the window ID
winId = 'com.example.android.notepad/    com.example.android.notepad.NoteEditor'
#Need to sleep a while till ready
MonkeyRunner.sleep(3)
winId = eDevice.getFocusedWindowId()
if(winId == winId):
    print "Edit Note WinId is:",        winId.encode('utf-8')
else:
    print "Failed"
    exit(1)

#Step3: is note EditText exist?

noteId = 'id/note'
if True == eDevice.exists(By.id(noteId)):
    print 'Note exist'
else:
    print 'Note not found!'
    exit(2)

#Step4: is note EditText visible?
if True == eDevice.visible(By.id(noteId)):
    print 'Note is visible'
else:
    print 'Note is invisible'
    exit(3)

#Step 4: getText
text = eDevice.getText(By.id(noteId))
print 'Note text:',text.encode('utf-8')

#Step 5: setText
eDevice.type(By.id(noteId), 'New')

#Step 6: locate
locate = eDevice.locate(By.id(noteId))
print 'Location(x,y,w,h) is:',locate

7. EasyMonkeyDevice Source Code for Your Reference

/*jadclipse*/// Decompiled by Jad v1.5.8e. Copyright 2001 Pavel Kouznetsov.

package com.android.monkeyrunner.easy;

import com.android.chimpchat.hierarchyviewer.HierarchyViewer;
import com.android.hierarchyviewerlib.models.ViewNode;
import com.android.monkeyrunner.JythonUtils;
import com.google.common.base.Preconditions;
import org.python.core.*;

public class By extends PyObject
    implements ClassDictInit
{

    public static void classDictInit(PyObject dict)
    {
        JythonUtils.convertDocAnnotationsForClass(com/android/monkeyrunner/easy/By, dict);
    }

    By(String id)
    {
        this.id = id;
    }

    public static By id(PyObject args[], String kws[])
    {
        ArgParser ap = JythonUtils.createArgParser(args, kws);
        Preconditions.checkNotNull(ap);
        String id = ap.getString(0);
        return new By(id);
    }

    public static By id(String id)
    {
        return new By(id);
    }

    public ViewNode findView(HierarchyViewer viewer)
    {
        return viewer.findViewById(id);
    }

    private String id;
}

/*
	DECOMPILATION REPORT

	Decompiled from: D:\Projects\Workspace\JarPackages\monkeyrunner.jar
	Total time: 69 ms
	Jad reported messages/errors:
The class file version is 50.0 (only 45.3, 46.0 and 47.0 are supported)
	Exit status: 0
	Caught exceptions:
*/

8. By Class Source Code for Your Better Reference

/*jadclipse*/// Decompiled by Jad v1.5.8e. Copyright 2001 Pavel Kouznetsov.

package com.android.monkeyrunner.easy;

import com.android.chimpchat.core.IChimpDevice;
import com.android.chimpchat.core.TouchPressType;
import com.android.chimpchat.hierarchyviewer.HierarchyViewer;
import com.android.hierarchyviewerlib.models.ViewNode;
import com.android.monkeyrunner.JythonUtils;
import com.android.monkeyrunner.MonkeyDevice;
import com.google.common.base.Preconditions;
import java.util.Set;
import org.eclipse.swt.graphics.Point;
import org.python.core.*;

// Referenced classes of package com.android.monkeyrunner.easy:
//            By

public class EasyMonkeyDevice extends PyObject
    implements ClassDictInit
{

    public static void classDictInit(PyObject dict)
    {
        JythonUtils.convertDocAnnotationsForClass(com/android/monkeyrunner/easy/EasyMonkeyDevice, dict);
    }

    public EasyMonkeyDevice(MonkeyDevice device)
    {
        mDevice = device;
        mHierarchyViewer = device.getImpl().getHierarchyViewer();
    }

    public void touch(PyObject args[], String kws[])
    {
        ArgParser ap = JythonUtils.createArgParser(args, kws);
        Preconditions.checkNotNull(ap);
        By selector = getSelector(ap, 0);
        String tmpType = ap.getString(1);
        TouchPressType type = TouchPressType.fromIdentifier(tmpType);
        Preconditions.checkNotNull(type, (new StringBuilder()).append("Invalid touch type: ").append(tmpType).toString());
        touch(selector, type);
    }

    public void touch(By selector, TouchPressType type)
    {
        Point p = getElementCenter(selector);
        mDevice.getImpl().touch(p.x, p.y, type);
    }

    public void type(PyObject args[], String kws[])
    {
        ArgParser ap = JythonUtils.createArgParser(args, kws);
        Preconditions.checkNotNull(ap);
        By selector = getSelector(ap, 0);
        String text = ap.getString(1);
        type(selector, text);
    }

    public void type(By selector, String text)
    {
        Point p = getElementCenter(selector);
        mDevice.getImpl().touch(p.x, p.y, TouchPressType.DOWN_AND_UP);
        mDevice.getImpl().type(text);
    }

    public PyTuple locate(PyObject args[], String kws[])
    {
        ArgParser ap = JythonUtils.createArgParser(args, kws);
        Preconditions.checkNotNull(ap);
        By selector = getSelector(ap, 0);
        ViewNode node = selector.findView(mHierarchyViewer);
        Point p = HierarchyViewer.getAbsolutePositionOfView(node);
        PyTuple tuple = new PyTuple(new PyObject[] {
            new PyInteger(p.x), new PyInteger(p.y), new PyInteger(node.width), new PyInteger(node.height)
        });
        return tuple;
    }

    public boolean exists(PyObject args[], String kws[])
    {
        ArgParser ap = JythonUtils.createArgParser(args, kws);
        Preconditions.checkNotNull(ap);
        By selector = getSelector(ap, 0);
        return exists(selector);
    }

    public boolean exists(By selector)
    {
        ViewNode node = selector.findView(mHierarchyViewer);
        return node != null;
    }

    public boolean visible(PyObject args[], String kws[])
    {
        ArgParser ap = JythonUtils.createArgParser(args, kws);
        Preconditions.checkNotNull(ap);
        By selector = getSelector(ap, 0);
        return visible(selector);
    }

    public boolean visible(By selector)
    {
        ViewNode node = selector.findView(mHierarchyViewer);
        return mHierarchyViewer.visible(node);
    }

    public String getText(PyObject args[], String kws[])
    {
        ArgParser ap = JythonUtils.createArgParser(args, kws);
        Preconditions.checkNotNull(ap);
        By selector = getSelector(ap, 0);
        return getText(selector);
    }

    public String getText(By selector)
    {
        ViewNode node = selector.findView(mHierarchyViewer);
        return mHierarchyViewer.getText(node);
    }

    public String getFocusedWindowId(PyObject args[], String kws[])
    {
        return getFocusedWindowId();
    }

    public String getFocusedWindowId()
    {
        return mHierarchyViewer.getFocusedWindowName();
    }

    public PyObject __findattr_ex__(String name)
    {
        if(!EXPORTED_METHODS.contains(name))
            return mDevice.__findattr_ex__(name);
        else
            return super.__findattr_ex__(name);
    }

    private By getSelector(ArgParser ap, int i)
    {
        return (By)ap.getPyObject(i).__tojava__(com/android/monkeyrunner/easy/By);
    }

    private Point getElementCenter(By selector)
    {
        ViewNode node = selector.findView(mHierarchyViewer);
        if(node == null)
        {
            throw new PyException(Py.ValueError, String.format("View not found: %s", new Object[] {
                selector
            }));
        } else
        {
            Point p = HierarchyViewer.getAbsoluteCenterOfView(node);
            return p;
        }
    }

    private MonkeyDevice mDevice;
    private HierarchyViewer mHierarchyViewer;
    private static final Set EXPORTED_METHODS = JythonUtils.getMethodNames(com/android/monkeyrunner/easy/EasyMonkeyDevice);

}

/*
	DECOMPILATION REPORT

	Decompiled from: D:\Projects\Workspace\JarPackages\monkeyrunner.jar
	Total time: 920 ms
	Jad reported messages/errors:
The class file version is 50.0 (only 45.3, 46.0 and 47.0 are supported)
	Exit status: 0
	Caught exceptions:
*/