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截图：

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

作者	自主博客	微信服务号及扫描码	CSDN
天地会珠海分舵	http://techgogogo.com	服务号:TechGoGoGo扫描码:	http://blog.csdn.net/zhubaitian