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); }- 使用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 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. |
|
|
| MonkeyImagetakeSnapshot() 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：同上
| EasyMonkeyDevice API vs HierarchViewer API |
|
|
| HierarchyViewer |
EasyMonkeyDevice |
Comment
|
| public ViewNode findViewById(String id) /** * Find a view by id. * @param id id for the view. * @return view with the specified ID, or {@code null} if no view found. */
|
|
|
| public ViewNode findViewById(String id, ViewNode rootNode) /** * Find a view by ID, starting from the given root node * @param id ID of the view you're looking for * @param rootNode the ViewNode at which to begin the traversal * @return view with the specified ID, or {@code null} if no view found. */ |
|
|
| public String getFocusedWindowName() /** * Gets the window that currently receives the focus. * @return name of the window that currently receives the focus. */
|
String getFocusedWindowId() Gets the id of the focused window. returns = "The symbolic id of the focused window or None." |
|
|
public static Point getAbsolutePositionOfView(ViewNode node)/** * Gets the absolute x/y position of the view node. * * @param node view node to find position of. * @return point specifying the x/y position of the node. */
|
PyTuple locate(By selector) Locates the coordinates of the selected object returns = "Tuple containing (x,y,w,h) location and size.") |
|
| public static Point getAbsoluteCenterOfView(ViewNode node) /** * Gets the absolute x/y center of the specified view node. * * @param node view node to find position of. * @return absolute x/y center of the specified view node. */ |
||
| public boolean visible(ViewNode node) /** * Gets the visibility of a given element. * @param selector selector for the view. * @return True if the element is visible. */
|
boolean visible(By selector) Checks if the specified object is visible. |
|
| public String getText(ViewNode node) /** * Gets the text of a given element. * * @param selector selector for the view. * @return the text of the given element. */
|
String getText(By selector) Obtain the text in the selected input box. |
|
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:',locate7. 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 扫描码: |
©著作权归作者所有：来自51CTO博客作者zhukev的原创作品，如需转载，请注明出处，否则将追究法律责任
api MonkeyRunner EasyMonkeyDevice
0 收藏
上一篇：参加香港亚洲秋季电子展经验点滴拾... 下一篇：致网友Wonderfei的一封信...
猜你喜欢
我的友情链接 最新HTML BroadcastChannel API引荐 Matrix源码分析之第一篇 使用LiveDataBus进行组件通信，让你永无后顾之忧 React Native集成到Android项目当中 面试经历：记一次Android面试 Android：实现模块 api 化 在Android中集成flutter 带你深入理解Android中的自定义属性！！！ 程序员笔记|JSBridge框架解决通信问题实现移动端跨平台开发 Java注解实战之APT构建模块化的第一步 怎么让软键盘弹出时，部分控件上移 MVVM 架构与数据绑定库 Android自定义Dialog及与Activity的交互 开发十年，就只剩下这套架构体系了！ Flutter交互实战－即刻App探索页下拉＆拖拽效果 Fragments片段
扫一扫,领取大礼包
0
分享
zhukev
|
Ctrl+Enter 发布
发布
取消