EasyMonkeyDevice vs MonkeyDevice&HierarchyViewer API Mapping Matrix
1. 前言
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,方便我们參考。
- 使用MonkeyDevice对象实例化EasyMonkeyDevice
- 通过ID Touch一个Note
- 获得进入NoteEditor activity后的WindowId并验证是否正确
- 通过ID检查Note的内容这个EditText是否存在和可见
- 通过Note的ID获得Text
- 通过Note的ID Type进新Text
- 通过Note的ID获得Location
2. EaysyMonkeyDevice API List and Sample
EasyMonkeyDevice是在MonkeyDevice和HierarchyViewer的基础上出来的一个类。依照本人的理解,主要添加的功能就是:
- 在MonkeyDevice和HierarchyViewer的基础上针对部分API添加了对控件ID的支持以操作控件
Return |
EasyMonkeyDevice |
Demo |
Comment
|
|
EasyMonkeyDevice( MonkeyDevice device) Use Monkey device to construct an EasyMonkeyDevice object, note that it would instantiate a HierarchyViewer member by device within this constructor |
device = MonkeyRunner.waitForConnection()
eDevice=EasyMonkeyDevice(device) |
Constructor |
Void |
touch(By selector, TouchPressType type) Sends a touch event specified by ‘type’ to the screen location specified by ‘by’ |
触摸点击主窗体: #Step 1: try touching on the first note eDevice.touch(By.id('id/text1'), MonkeyDevice.DOWN_AND_UP) 触摸弹出框或Menu Options会失败: 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)
|
參数By实际上 仅仅有By.ID,从 其源代码能够看 出来; type參数跟 MonkeyDevice 一样就那几个 DOWN/UP之类的
依据个人实践 和网上评论, 对系统菜单和 弹出框的支持 有问题 |
Void |
type(By selector, String text) Types a string into the specified object |
#Step 5: setText eDevice.type(By.id(noteId), 'New') |
|
Boolean |
exists(By selector) Checks if the specified object exists. |
#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) |
|
Boolean |
visible(By selector) Checks if the specified object is visible. |
#Step4: is note EditText visible? if True == eDevice.visible(By.id(noteId)): print 'Note is visible' else: print 'Note is invisible' exit(3) |
|
String |
getText(By selector) Obtain the text in the selected input box. |
#Step 4: getText text = eDevice.getText(By.id(noteId)) print 'Note text:',text.encode('utf-8') |
|
String |
getFocusedWindowId() Gets the id of the focused window. returns = "The symbolic id of the focused window or None." |
#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)
|
结果跟 HierarchyViewer 的 getFocusedWin dowName 返回值一模 一样,所以 猜想WindowID 和WindowName 是同一回事 |
PyTuple |
locate(By selector) Locates the coordinates of the selected object returns = "Tuple containing (x,y,w,h) location and size.") |
#Step 6: locate locate = eDevice.locate(By.id(noteId)) print 'Location(x,y,w,h) is:',locate |
|
3. EasyMonkeyDevice vs MonkeyDevice API Mapping Matrix
以下一章理同。
- touch:MonkeyDevice通过坐标点touch;EasyMonkeyDevice通过控件ID去touch
- type:MonkeyDevice往当前focused地方输入。EasyMonkeyDevice往由ID指定控件输入
EasyMonkeyDevice API vs MonkeyDevice API |
|
|
MonkeyDevice |
EasyMonkeyDevice |
Comment
|
Void broadcastIntent (string uri, string action, string data, string mimetype, iterable categories dictionary extras, component component, iterable flags) Broadcasts an Intent to this device, as if the Intent were coming from an application. |
|
|
Void drag (tuple start, tuple end, float duration, integer steps) Simulates a drag gesture (touch, hold, and move) on this device's screen. |
|
|
ObjectgetProperty (string key) Given the name of a system environment variable, returns its value for this device. The available variable names are listed in the detailed description of this method. |
|
|
ObjectgetSystemProperty (string key) . The API equivalent of adb shell getprop <key>. This is provided for use by platform developers. |
|
|
Void installPackage (string path) Installs the Android application or test package contained in packageFile onto this device. If the application or test package is already installed, it is replaced. |
|
|
Dictionaryinstrument (string className, dictionary args) Runs the specified component under Android instrumentation, and returns the results in a dictionary whose exact format is dictated by the component being run. The component must already be present on this device. |
|
|
Void press (string name, dictionary type) Sends the key event specified by type to the key specified by keycode. |
|
|
Void reboot (string into) Reboots this device into the bootloader specified by bootloadType. |
|
|
Void removePackage (string package) Deletes the specified package from this device, including its data and cache. |
|
|
Objectshell (string cmd) Executes an adb shell command and returns the result, if any. |
|
|
Void startActivity (string uri, string action, string data, string mimetype, iterable categories dictionary extras, component component, flags) Starts an Activity on this device by sending an Intent constructed from the supplied arguments. |
|
|
Captures the entire screen buffer of this device, yielding a MonkeyImage object containing a screen capture of the current display. |
|
|
Void touch (integer x, integer y, integer type) Sends a touch event specified by type to the screen location specified by x and y. |
Void touch(By selector, TouchPressType type) Sends a touch event specified by ‘type’ to the screen location specified by ‘by’ |
MonkeyDevice通过坐标点touch; EasyMonkeyDevice通过控件ID去touch |
Void type (string message) Sends the characters contained in message to this device, as if they had been typed on the device's keyboard. This is equivalent to calling press() for each keycode in message using the key event type DOWN_AND_UP. |
Void type(By selector, String text) Types a string into the specified object |
MonkeyDevice往当前focused地方输入; EasyMonkeyDevice往由ID指定控件输入 |
Void wake () Wakes the screen of this device. |
|
|
HierarchyViewer getHierarchyViewer() Get the HierarchyViewer object for the device. |
|
|
PyListgetPropertyList() Retrieve the properties that can be queried |
|
|
PyListgetViewIdList() Retrieve the view ids for the current application |
|
|
MonkeyViewgetViewById(String id) doc = "Obtains the view with the specified id.", args = {"id"}, argDocs = {"The id of the view to retrieve."}, returns = "The view object with the specified id." |
|
|
MonkeyViewgetViewByAccessibilityIds(String WinId, String accessId) args = {"windowId", "accessibility id"} argDocs = {"The window id of the view to retrieve.", "The accessibility id of the view to retrieve."}, returns = "The view object with the specified id.") |
|
|
MonkeyViewgetRootView() Obtains current root view |
|
|
PyListgetViewsByText(String text) Obtains a list of views that contain the specified text.", args = {"text"}, returns = "A list of view objects that contain the specified text.") |
|
|
4. EasyMonkeyDevice vs HierarchyViewer Mapping Matrix
- 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
- visible:通过id检查该控件是否存在,猜想应该是google在代码重构的时候添加的一个方法方便大家推断而已
EasyMonkeyDevice Standalone API |
|
EasyMonkeDevice |
Comment
|
boolean exists(By selector) Checks if the specified object exists. |
|
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 |
天地会珠海分舵 |
|
服务号:TechGoGoGo 扫描码:
|
http://blog.csdn.net/zhubaitian |