1. 前言

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

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

2. EaysyMonkeyDevice API List and Sample

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

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

3. EasyMonkeyDevice vs MonkeyDevice API Mapping Matrix

4. EasyMonkeyDevice vs HierarchyViewer Mapping Matrix

5. EasyMonkeyDevice Standalone API

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

/*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:
*/