1.    背景

2.    Void broadcastIntent

2.1 分析

targetDevice.broadcastIntent(action=‘android.intent.action.INSERT‘,
                           mimetype=‘vnd.android.cursor.dir/contact‘,
                           extras = {‘name‘:‘user1501488‘, ‘phone‘:‘123-15489‘}

targetDevice.startActivity(action=‘android.intent.action.INSERT‘,
                           mimetype=‘vnd.android.cursor.dir/contact‘,
                           extras = {‘name‘:‘user1501488‘, ‘phone‘:‘123-15489‘})

targetDevice.shell("am start -a android.intent.action.INSERT -t vnd.android.cursor.dir/contact -e name ‘Donald Duck‘ -e phone 555-1234").

3. void startActivity

3.1 示例

targetDevice.startActivity(action=‘android.intent.action.VIEW‘,
                          mimetype=‘vnd.android.cursor.dir/vnd.google.note‘)

targetDevice.startActivity(component="com.example.android.notepad/com.example.android.notepad.NotesList")

targetDevice.startActivity(action=‘android.intent.action.INSERT‘,
                           mimetype=‘vnd.android.cursor.dir/contact‘,
                           extras = {‘name‘:‘user1501488‘, ‘phone‘:‘123-15489‘})

4.  void drag (tuple start, tuple end, floatduration, integer steps)

4.1 实例

viewer = targetDevice.getHierarchyViewer()
note = viewer.findViewById(‘id/text1‘)
point = viewer.getAbsoluteCenterOfView(note)
startX = point.x
startY = point.y

targetDevice.drag((startX,startY),(startX,startY),1)

targetDevice.press(‘KEYCODE_BACK‘, MonkeyDevice.DOWN_AND_UP)

4.2 分析和建议

5 Object getProperty (string key)

5.1示例

displayWidth =targetDevice.getProperty (‘display.width‘)
printdisplayWidth.encode(‘utf-8‘)
 
displayHight =targetDevice.getProperty(‘display.width‘)
printdisplayHight.encode(‘utf-8‘)

5.2  分析和建议

6． Object getSystemProperty (string key)

6.1 示例

displayWidth = targetDevice.getSystemProperty (‘service.adb.tcp.port‘)
print displayWidth.encode(‘utf-8‘)

6.2 分析和建议

displayWidth = targetDevice.getSystemProperty (‘display.width‘)
print displayWidth.encode(‘utf-8‘)

7 Boolean installPackage (string path)

7.1示例

if True == targetDevice.installPackage(‘D:\\Projects\\Workspace\\PythonMonkeyRunnerDemo\\apps\\MPortal.apk‘):
   print "Installationfinished successfully"
else:
    print "Failedto install the apk"

7.2 分析和建议

• 官方网站描述的这个API是没有返回值的（见背景中的表），而最新版本的API里面是Boolean值。
• 参数输入的应该是PC端这边的Local路径而非目标系统的Local路径。

8 boolean removePackage(string package)

8.1 示例

if True == targetDevice.removePackage(‘com.majcit.portal‘):
   print "Succeed toremove the package"
else:
    print "Failedto remove teh package"

8.2 注意事项

9. dictionary instrument (string className, dictionary args)

9.1 示例

dict = targetDevice.instrument(‘com.example.android.notepad.tryout/android.test.InstrumentationTestRunner‘)
print dict

dict = dict = targetDevice.instrument(‘com.example.android.notepad.tryout/android.test.InstrumentationTestRunner‘,
                                      {‘class‘:‘com.example.android.notepad.tryout.TCCreateNote‘})
print dict

9.2 分析

package com.example.android.notepad.tryout;

import com.robotium.solo.Solo;

import android.test.ActivityInstrumentationTestCase2;
import android.app.Activity;

@SuppressWarnings("rawtypes")
public class TCCreateNote extends ActivityInstrumentationTestCase2{

	private static Solo solo = null;
	public Activity activity;
	
	private static final int NUMBER_TOTAL_CASES = 2;
	private static int run = 0;
	
	private static Class<?> launchActivityClass;

	//对应re-sign.jar生成出来的信息框里的两个值
	private static String mainActiviy = "com.example.android.notepad.NotesList";
	private static String packageName = "com.example.android.notepad";

	static {

		try {

			launchActivityClass = Class.forName(mainActiviy);

		} catch (ClassNotFoundException e) {

			throw new RuntimeException(e);

		}

	}
	
	
	@SuppressWarnings("unchecked")
	public TCCreateNote() {
		super(packageName, launchActivityClass);
	}

	
	@Override
	public void setUp() throws Exception {
		//setUp() is run before a test case is started. 
		//This is where the solo object is created.
		super.setUp(); 
		//The variable solo has to be static, since every time after a case‘s finished, this class TCCreateNote would be re-instantiated
		// which would lead to soto to re-instantiated to be null if it‘s not set as static
		if(solo == null) {
			TCCreateNote.solo = new Solo(getInstrumentation(), getActivity());
		}
	}
	
	@Override
	public void tearDown() throws Exception {
		//Check whether it‘s the last case executed.
		run += countTestCases();
		if(run >= NUMBER_TOTAL_CASES) {
			solo.finishOpenedActivities();
		}
	}

	public void testAddNoteCNTitle() throws Exception {
		
		solo.clickOnMenuItem("Add note");
		solo.enterText(0, "中文标签笔记");
		solo.clickOnMenuItem("Save");
		solo.clickInList(0);
		solo.clearEditText(0);
		solo.enterText(0, "Text 1");
		solo.clickOnMenuItem("Save");
		solo.assertCurrentActivity("Expected NotesList Activity", "NotesList");
		
		solo.clickLongOnText("中文标签笔记");
		solo.clickOnText("Delete");
	}
	
	
	public void testAddNoteEngTitle() throws Exception {
		solo.clickOnMenuItem("Add note");
		solo.enterText(0, "English Title Note");
		solo.clickOnMenuItem("Save");
		solo.clickInList(0);
		solo.clearEditText(0);
		solo.enterText(0, "Text 1");
		solo.clickOnMenuItem("Save");
		solo.assertCurrentActivity("Expected NotesList Activity", "NotesList");
		
		solo.clickLongOnText("English Title Note");
		solo.clickOnText("Delete");
	}
}

• 调用此方法之前先要找到第一个参数怎么写：执行命令“pm list instrumentation”
•  调用次方法如果不指定第一个参数会执行指定Component下面的所有测试脚本和目标应用包中所有用到Instrumentation的测试用例
• 调用此方法最终事实上是在目标机器上根据指定的参数执行“am instrument xxxx”

10 void press (string name, integer type)

10.1 示例

targetDevice.press(‘KEYCODE_BACK‘,MonkeyDevice.DOWN_AND_UP)

10.2 分析

11. void touch (integer x,integer y, integer type)

11.1 示例

viewer = targetDevice.getHierarchyViewer()
note = viewer.findViewById(‘id/text1‘)
point = viewer.getAbsoluteCenterOfView(note)
startX = point.x
startY = point.y

targetDevice.touch(startX,startY，MonkeyDevice.DOWN_AND_UP)

11.2 分析

12. void type (string message)

12.1 示例

viewer = targetDevice.getHierarchyViewer()
note = viewer.findViewById(‘id/text1‘)
point = viewer.getAbsoluteCenterOfView(note)
startX = point.x
startY = point.y
targetDevice.touch(startX,startY,MonkeyDevice.DOWN_AND_UP)
MonkeyRunner.sleep(3)
targetDevice.type(‘NewContent‘)

12.2 分析

13. Wake()

13.1示例

targetDevice.wake()

13.2 分析

14. MonkeyImange takeSnapshot()

14.1 示例

#Connect to the target targetDevice
targetDevice = MonkeyRunner.waitForConnection()

easy_device = EasyMonkeyDevice(targetDevice)  #touch a button by id would need this
targetDevice.startActivity(component="com.example.android.notepad/com.example.android.notepad.NotesList")

#invoke the menu options
MonkeyRunner.sleep(6)
#targetDevice.press(‘KEYCODE_MENU‘, MonkeyDevice.DOWN_AND_UP);

‘‘‘
     public ViewNode findViewById(String id) 
     * @param id id for the view.
     * @return view with the specified ID, or {@code null} if no view found.
‘‘‘
#MonkeyRunner.alert("Continue?", "help", "Ok?")

pic = targetDevice.takeSnapshot()
pic = pic.getSubImage((0,38,480,762))

newPic = targetDevice.takeSnapshot()
newPic = newPic.getSubImage((0,38,480,762))

print (newPic.sameAs(pic,1.0))
newPic.writeToFile(‘./shot1.png‘,‘png‘)

14 object shell（string cmd）

14.1 示例

res = targetDevice.shell(‘ls /data/local/tmp|grep note‘)
print res

14.2 分析

15 void reboot(string into)

targetDevice.reboot()