一、使用CMD命令開啟模擬器

執行monkeyrunner之前必須先執行相應的模擬器或連上裝置，不然monkeyrunner無法連線裝置。

1.1  用Elipse開啟Android模擬器或在CMD中用Android命令開啟模擬器。

1.2  這裡重點講一下在CMD中用Android命令開啟模擬器

命令：emulator -avd test （注意：test為虛擬裝置的名稱——AVD的全稱為：Android Virtual Device，就是Android執行的虛擬裝置，如下圖所示：）

上面命令中的test是模擬器名稱。使用時需要改成實際名字。

如果正常，模擬器應該可以啟動起來了。

如果執行的結果出現以下錯誤內容：

1. PANIC: Could not open: C:\Documents and Settings\sAdministrator\.android/avd/test.ini  

如下圖所示：

原因在於你的環境變數缺少配置。請在“系統變數”中新增“ANDROID_SDK_HOME”，設定其值為“C:\Documents and Settings\Administrator”（注意：這裡的值不能為C:\Documents and Settings\Administrator\.android），如下圖所示：

確定後，關閉CMD視窗，重新開啟CMD。執行以上命令。將會啟用模擬器。

二 、進入MonkeyRunner

2.1  模擬器啟動成功後，我們仍在CMD環境中操作。現在進入monkeyrunner的shell命令互動模式。

命令：monkeyrunner

2.2  進入shell命令互動模式後，首要一件事就是匯入monkeyrunner所要使用的模組。直接在shell命令下輸入：

from com.android.monkeyrunner import MonkeyRunner,MonkeyDevice 回車

OK，這步完成我們就可以利用monkeyrunner進行測試工作了。

有兩種方案：

一：直接在shell命令下輸入以下命令；

命令說明

device=MonkeyRunner.waitForConnection() #連線手機裝置

device.installPackage("../samples/android-10/ApiDemos/bin/Apidemos.apk") #安裝apk包到手機裝置。

啟動其中的任意activity了，只要傳入package和activity名稱即可。命令如下：
device.startActivity(component="com.example.android.apis/com.example.android.apis.ApiDemos")
此時模擬器會自動開啟ApiDemos這個應用程式的主頁。

device.reboot() #手機裝置重啟

device.touch(300,300,'DOWN_AND_UP')

MonkeyRunner.alert("hello")#在emulator上會彈出訊息提示

device.press('KEYCODE_HOME',MonkeyDevice.DOWN_AND_UP)

device.type('hello')#向編輯區域輸入文字'hello'

二：將以下命令寫到python檔案裡，例如test.py，然後我們再從命令列直接通過monkeyrunner執行它即可。比如，我們還是用上面的例子，語法如下：monkeyrunner test.py 接下來monkeyrunner會自動呼叫test.py，並執行其中的語句，相當方便。

例項：test.py

1. from com.android.monkeyrunner import MonkeyRunner,MonkeyDevice  
2. device=MonkeyRunner.waitForConnection()  
3. device.startActivity(component="your.www.com/your.www.com.TestActivity")  

在CMD中執行

monkeyrunner test.py

可能出現錯誤“Can't open specified script file”，如下圖所示：

原因在於python指令碼檔案路徑不正確。你可以有以下解決辦法：

1、將test.py檔案存放到monkeyrunner檔案同一目錄中。可以執行：monkeyrunner test.py 呼叫

2、指定python檔案位置。如果test.py檔案在D盤根目錄下，可以這樣執行：monkeyrunner d:\test.py

三 、MonkeyRunner語法

3.1 monkeyrunner

monkeyrunner工具提供了一個API，運用該API編寫的程式可以不用通過android程式碼來直接控制android裝置和模擬器，我們可以寫一個python程式對android應用程式或測試包進行安裝、執行、傳送模擬擊鍵，對使用者介面進行截圖並將截圖儲存在workstation上等操作。monkeyrunner工具的主要設計目的是用於測試application/framework層上的應用程式和裝置、或用於執行單元測試套件，也可以用於其它目的。

3.2 monkeyrunner為android測試提供了以下獨特的功能：
1、多裝置控制:monkeyrunner API可以跨多個裝置或模擬器實施測試套件。可以在同一時間接上所有裝置或一次啟動全部模擬器，依據程式依次連線到每一個，然後執行一個或多個測試。也可以用程式啟動一個配置好的模擬器，執行一個或多個測試，然後關閉模擬器。
2、功能測試:monkeyrunner可以為一個應用自動貫徹一次功能測試。您提供按鍵或觸控事件的輸入數值，然後觀察輸出結果的截圖。
4、迴歸測試:monkeyrunner可以執行某個應用，並將其結果截圖與既定已知正確的結果截圖相比較，以此測試應用的穩定性。
4、可擴充套件的自動化：由於monkeyrunner是一個API工具包，我們可以開發基於python模組和程式的一整套系統，以此來控制android裝置。除了使用monkeyrunner API，我們還可以使用標準的python os和ubprocess模組來呼叫android debug bridge這樣的android工具。如ADB這樣的android工具，也可以將自己寫的類新增到monkeyrunner API中。

3.3  執行monkeyrunner

可以直接使用一個程式碼檔案執行monkeyrunner，抑或在互動式對話中輸入monkeyrunner語句。不論使用哪種方式，你都需要呼叫SDK目錄的tools子目錄下的monkeyrunner命令。如果提供一個檔名作為執行引數，則monkeyrunner將視檔案內容為python程式，並加以執行；否則，它將提供一個互動對話環境。

3.4  monkeyrunner命令語法

monkeyrunner -plugin <plugin_jar> <programe_filename> <programe_option>

3.5 monkeyrunner API

主要包括三個模組
1、MonkeyRunner:這個類提供了用於連線monkeyrunner和裝置或模擬器的方法，它還提供了用於建立使用者介面顯示提供了方法。
2、MonkeyDevice:代表一個裝置或模擬器。這個類為安裝和解除安裝包、開啟Activity、傳送按鍵和觸控事件、執行測試包等提供了方法。
3、MonkeyImage:這個類提供了捕捉螢幕的方法。這個類為截圖、將點陣圖轉換成各種格式、對比兩個MonkeyImage物件、將image儲存到檔案等提供了方法。
3.6 匯入需要的模組

方式一：

import sys
from com.android.monkeyrunner import MonkeyRunner as mr
from com.android.monkeyrunner import MonkeyDevice as md
from com.android.monkeyrunner import MonkeyImage as mi
如果給匯入的模組起了別名，就應該使用別名，而不能使用原名，否則會出現錯誤。
比如連線裝置或模擬器，起了以上別名後，命令應該如下：
device=mr.waitForConnection() 

方式二：
from com.android.monkeyrunner import MonkeyRunner,MonkeyDevice,MonkeyImage

方式三：
import com.android.monkeyrunner
但是在使用時，就顯得特別麻煩
device=com.android.monkeyrunner.MonkeyRunner.waitForConnection() 

方式四：
我們也可以給它一個別名
import com.android.monkeyrunner as cam
但是在使用時，就顯得特別麻煩
device=cam.MonkeyRunner.waitForConnection()

#等待連線到裝置，與模擬器連線，返回monkeydevice物件,代表連線的裝置。沒有報錯的話說明連線成功。
引數1：超時時間，單位秒，浮點數。預設是無限期地等待。
引數2：串deviceid，指定的裝置名稱。預設為當前裝置（手機優先，比如手機通過USB線連線到PC、其次為模擬器）。
預設連線：device=MonkeyRunner.waitForConnection()
引數連線：device = mr.waitForConnection(1.0,'emulator-5554')

3.7 向裝置或模擬器安裝要測試的APK

device.installPackage('myproject/bin/MyApplication.apk') #引數是相對或絕對APK路徑
路徑級別用“/”，不能用“\”，比如d:\www\a.apk，而應該寫成d:/www/a.apk
安裝成功返回true,此時檢視模擬器我們可以在IDLE介面上看到安裝的APK的圖示了。


3.8 從裝置中刪除指定的軟體包，包括其相關的資料和調整快取

device.removePackage('myproject/bin/MyApplication.apk')
刪除成功返回true。


3.9 啟動任意的Activity

device.startActivity(component="your.www.com/your.www.com.TestActivity")
或者
device.startActivity(component="your.www.com/.TestActivity")

此時可以向模擬器傳送如按鍵、滾動、截圖、儲存等操作了。


執行一個adb shell命令，並返回結果，如果有的話
device.shell("...")

3.10 暫停目前正在執行的程式指定的秒數
MonkeyRunner.sleep(秒數，浮點數)

3.11 捕捉螢幕寫入檔案

獲取裝置的遮蔽緩衝區，產生了整個顯示器的遮蔽捕獲。（截圖）
result=device.takeSnapshot()
返回一個MonkeyImage物件（點陣圖包裝），我們可以用以下命令將圖儲存到檔案
result.writeToFile('takeSnapshot\\result1.png','png')

MonkeyImage.writeToFile(引數1:輸出檔名，也可以包括路徑,引數2:目標格式)
寫成功返回true，否則返回false

3.12 type
鍵盤上的型別指定的字串，這相當於要求每個字串中的字元按（鍵碼，DOWN_AND_UP）.
字串傳送到鍵盤
device.type('字串')

3.13 喚醒裝置螢幕（在裝置螢幕上喚醒）

device.wake()

3.14 重新引導到指定的載入程式指定的裝置

device.reboot()

 3.15 touch、press

在指定位置傳送觸控事件（x,y的單位為畫素）

device.touch(x,y,TouchPressType-觸控事件型別)

傳送到指定鍵的一個關鍵事件

device.press(引數1:鍵碼,引數2:觸控事件型別)
引數1：見android.view.KeyEvent
引數2，如有TouchPressType()返回的型別－觸控事件型別，有三種。
1、DOWN傳送一個DOWN事件。指定DOWN事件型別傳送到裝置，對應的按一個鍵或觸控式螢幕幕上。
2、UP傳送一個UP事件。指定UP事件型別傳送到裝置，對應釋放一個鍵或從螢幕上擡起。
3、DOWN_AND_UP傳送一個DOWN事件，然後一個UP事件。對應於輸入鍵或點選螢幕。
以上三種事件做為press()或touch()引數。原英文如下：
use this with the type argument of press() or touch() to send a down event.


為了模擬輸入鍵，傳送DOWN_AND_UP。


引數1的部分具體內容邏輯：

按下HOME鍵 device.press('KEYCODE_HOME',MonkeyDevice.DOWN_AND_UP) 
按下BACK鍵 device.press('KEYCODE_BACK',MonkeyDevice.DOWN_AND_UP) 
按下下導航鍵 device.press('KEYCODE_DPAD_DOWN',MonkeyDevice.DOWN_AND_UP) 
按下上導航鍵 device.press('KEYCODE_DPAD_UP',MonkeyDevice.DOWN_AND_UP) 
按下OK鍵 device.press('KEYCODE_DPAD_CENTER',MonkeyDevice.DOWN_AND_UP)


device.press('KEYCODE_ENTER',MonkeyDevice.DOWN_AND_UP)#輸入回車
device.press('KEYCODE_BACK',MonkeyDevice.DOWN_AND_UP)#點選返回

home鍵KEYCODE_HOME 
back鍵KEYCODE_BACK 
send鍵KEYCODE_CALL 
end鍵KEYCODE_ENDCALL 
上導航鍵KEYCODE_DPAD_UP 
下導航鍵KEYCODE_DPAD_DOWN 
左導航KEYCODE_DPAD_LEFT 
右導航鍵KEYCODE_DPAD_RIGHT  
ok鍵KEYCODE_DPAD_CENTER 
上音量鍵KEYCODE_VOLUME_UP  
下音量鍵KEYCODE_VOLUME_DOWN 
power鍵KEYCODE_POWER 
camera鍵KEYCODE_CAMERA 
menu鍵KEYCODE_MENU 

更多：http://developer.android.com/reference/android/view/KeyEvent.html