Android自動化學習筆記之MonkeyRunner：官方介紹和簡單實例

----------------------------------------------------------------------------------------------------------------------------

小記: 一直都是用公司自己研發的自動化工具，對市面開源的自動化工具知之甚少，所以開始自學開源的自動化工具。

初步學習中，難免會有疏漏和想不到的地方，隨着不斷深入的了解，可能會覺得現在的筆記很可笑，不過有新的體會，我會及時修改，不斷進步。

2014-10-13:初版

2014-10-14:更新模擬器實例和常用命令

2014-10-16:更新2個真機實例

2014-10-17:添加Q&A

2014-10-23: 更新兩種編寫monkeyrunner腳本的第三方插件，另開一篇文章：Android自動化學習筆記：編寫MonkeyRunner腳本的幾種方式

------------------------------------------------------------------------------------------------------------------------------

下面來學習一下官方文檔: (簡介翻譯來自網絡)

一、什么是monkeyrunner

monkeyrunner工具提供了一個API，使用此API寫出的程序可以在Android代碼之外控制Android設備和模擬器。通過monkeyrunner，您可以寫出一個Python程序去安裝一個Android應用程序或測試包，運行它，向它發送模擬擊鍵，截取它的用戶界面圖 片，並將截圖存儲於工作站上。monkeyrunner工具的主要設計目的是用於測試功能/框架水平上的應用程序和設備，或用於運行單元測試套件，但您當然也可以將其用於其它目的。

二、Monkey和MonkeyRunner

Monkey工具直接運行在設備或模擬器的adb shell中，生成用戶或系統的偽隨機事件流。

相比較之下，MonkeyRunner工具則是在工作站上通過API定義的特定命令和事件來控制設備或模擬器

三、MonkeyRunner的特色

　　1. 多設備控制：monkeyrunner API可以跨多個設備或模擬器實施測試套件。您可以在同一時間接上所有的設備或一次啟動全部模擬器（或統統一起），依據程序依次連接到每一個，然后運行一個或多個測試。您也可以用程序啟動一個配置好的模擬器，運行一個或多個測試，然后關閉模擬器。

　　2. 功能測試： monkeyrunner可以為一個應用自動貫徹一次功能測試。您提供按鍵或觸摸事件的輸入數值，然后觀察輸出結果的截屏。

　　3. 回歸測試：monkeyrunner可以運行某個應用，並將其結果截屏與既定已知正確的結果截屏相比較，以此測試應用的穩定性。

　　4. 可擴展的自動化：由於monkeyrunner是一個API工具包，您可以基於Python模塊和程序開發一整套系統，以此來控制Android設備。除 了使用monkeyrunner API之外，您還可以使用標准的Python os和subprocess模塊來調用Android Debug Bridge這樣的Android工具。

四、Monkeyrunner運行環境

無論怎么運行，都需要調用 SDK目錄的tools子目錄下的monkeyrunner命令。如果您提供一個文件名作為運行參數，則monkeyrunner將視文件內容為 Python程序，並加以運行；否則，它將提供一個交互對話環境。

monkeyrunner的命令語法為：

monkeyrunner -plugin <plugin_jar> <program_filename> <program_options>

五、官網實例（網上的資料都沒有提及，運行腳本之前，必須先把連接到電腦上或者啟動模擬器）
官網的例子，不解釋。

# Imports the monkeyrunner modules used by this program
from com.android.monkeyrunner import MonkeyRunner, MonkeyDevice

# Connects to the current device, returning a MonkeyDevice object
device = MonkeyRunner.waitForConnection()

# Installs the Android package. Notice that this method returns a boolean, so you can test
# to see if the installation worked.
device.installPackage('myproject/bin/MyApplication.apk')

# sets a variable with the package's internal name
package = 'com.example.android.myapplication'

# sets a variable with the name of an Activity in the package
activity = 'com.example.android.myapplication.MainActivity'

# sets the name of the component to start
runComponent = package + '/' + activity

# Runs the component
device.startActivity(component=runComponent)

# Presses the Menu button
device.press('KEYCODE_MENU', MonkeyDevice.DOWN_AND_UP)

# Takes a screenshot
result = device.takeSnapshot()

# Writes the screenshot to a file
result.writeToFile('myproject/shot1.png','png')

六、實例二(模擬器4.4.2測試通過)：

步驟：截屏-->滑屏-->截屏
目的：學習截屏方法的使用

'''
Created on Oct 14, 2014

@author: deldong
'''
print 'Before execution'

# Imports the monkeyrunner modules used by this program
from com.android.monkeyrunner import MonkeyRunner

# Connects to the current device, returning a MonkeyDevice object
device = MonkeyRunner.waitForConnection()
 
# Takes a screenshot
result = device.takeSnapshot()

# Writes the screenshot to a file
result.writeToFile('./beforeDrag.png','png')
#多嘴一句，這里的截圖，其實是存放在..sdk/tools下面，找了1天有木有······
#當然這里也可以寫絕對路徑，比如c:\screenshot\beforeDrag.png #Drag screen from right to left
for i in range(0,3):
    device.drag((600,200),(100,200),0.1,10)
    MonkeyRunner.sleep(1)
 
#Takes a screenshot
result = device.takeSnapshot()
#Writes the screenshot to a file
result.writeToFile('./afterDrag.png','png')

print 'After execution'

七、實例三（諾基亞X2手機測試通過）：

步驟：安裝APK-->打開APK-->關閉APK-->重復打開關閉操作N次-->卸載APK
目的：寫個壓力測試的腳本玩玩

'''
Created on Oct 16, 2014

@author: deldong
'''
# -*- coding: UTF-8 -*-
import sys#因為系統是英文系統，打漢字的話，必須用添加# -*- coding: UTF-8 -*-
reload(sys)
sys.setdefaultencoding("utf-8")

# 導入所需的方法
from com.android.monkeyrunner import MonkeyRunner, MonkeyDevice

#連接我的Nokia手機
print ("Connecting device.....")
NokiaDevice = MonkeyRunner.waitForConnection()
if not NokiaDevice:
    print ("Please connect a device to start!")
else:
    print ("Device Connected successfully!")

#安裝apk
try:
    NokiaDevice.installPackage('C:/apps/MyFirstApp.apk')
    print ("Package installed successfully! ")
except:
    print ("Package installation failed!")

#設置包名
package = 'com.example.myfirstapp'

#設置activity名
activity = 'com.example.myfirstapp.MainActivity'

#循環執行四次
for i in range(1,5):
    #打開已安裝的應用
    print ("Open installed package for the %d time"%i)
    NokiaDevice.startActivity(component=package + '/' + activity)
    #等待5秒
    print ("wait 5 sec")
    MonkeyRunner.sleep(5)
    #關閉應用
    print("Quit the application")
    NokiaDevice.press("KEYCODE_BACK",NokiaDevice.DOWN_AND_UP)
    print ("wait 5 sec")
    MonkeyRunner.sleep(5)

#卸載APK
try:
    print("Uninstall package!")
    NokiaDevice.removePackage("com.example.myfirstapp")
    print("Uninstall package successfully")
except:
    print ("Package unintall failed!")

 

cmd提示：

八、實例四（諾基亞X2手機測試通過）：

步驟：重啟手機-->喚醒手機-->輸入密碼解鎖
目的：使用重啟和喚醒的方法

# -*- coding: UTF-8 -*-
'''
Created on Oct 16, 2014

@author: deldong
'''
import sys
reload(sys)
sys.setdefaultencoding("utf-8")

# 導入所需的方法
from com.android.monkeyrunner import MonkeyRunner, MonkeyDevice

#連接我的Nokia手機
print ("Connecting device.....")
NokiaDevice = MonkeyRunner.waitForConnection()
if not NokiaDevice:
    print ("Please connect a device to start!")
else:
    print ("Device Connected successfully!")

#重啟設備
print("Reboot device!")
NokiaDevice.reboot()
MonkeyRunner.sleep(60)

#喚醒設備
print("Wake device")
NokiaDevice.wake()
print("wait 2s")
MonkeyRunner.sleep(2)

#解鎖 輸入密碼
print("unlock device....")
NokiaDevice.drag((400,700),(400,300),0.1,10)
MonkeyRunner.sleep(5)
NokiaDevice.type('201449')
print("unlock successfully")

 

Q&A:

Q：在cmd中執行monkeyrunner c:\test.py腳本時報錯

提示：141017 14:35:59.101:S [main] [com.android.monkeyrunner.MonkeyRunnerOptions]SyntaxError: Non-ASCII character in file 'C:\calculator.py', but no encoding declared; see http://www.python.org/peps/pep-0263.html for details

解決辦法：在腳本的第一行添加中文的注釋語句代碼： # -*- coding: UTF-8 -*-
如果還不行的話，多添加下面三行代碼即可。

import sys
reload(sys)
sys.setdefaultencoding("utf-8")

九、常用命令：

1.安裝Android包，此方法返回的返回值為boolean，由此可以判斷安裝過程是否正常
device.installPackage('文件名')
#參數是相對或絕對APK路徑
路徑級別用“/”，不能用“\”，比如d:\www\a.apk，而應該寫成d:/www/a.apk
安裝成功返回true,此時查看模擬器我們可以看到安裝的APK的圖標了。

2.從設備中刪除指定的軟件包，此方法返回的返回值為boolean，刪除其相關的數據和調整緩存
device.removePackage ('包名')

3.啟動一個Activity，兩種方式
device.startActivity (component='包名/包名.Activity名')
device.startActivity (component='包名/.Activity名')

4.暫停(秒);
MonkeyRunner.sleep(5)

5.截圖：
result=device.takeSnapshot()
#此方法返回一個MonkeyImage對象（點陣圖包裝），我們可以用以下命令將圖保存到文件
#result.writeToFile('takeSnapshot\\result1.png','png')
#MonkeyImage.writeToFile(參數1:輸出文件名，也可以包括路徑,參數2:目標格式)
#寫成功返回true，否則返回false。
6.觸擊屏幕

在指定位置發送觸摸事件（x,y的單位為像素）

device.touch(x,y,TouchPressType-觸摸事件類型)
device.touch(100,100,"DOWN_AND_UP")

發送到指定鍵的一個關鍵事件
device.press(參數1:鍵碼,參數2:觸摸事件類型)
參數1：見android.view.KeyEvent URL:http://developer.android.com/reference/android/view/KeyEvent.html
參數2，如有TouchPressType()返回的類型－觸摸事件類型，有三種。
a、DOWN 發送一個DOWN事件。指定DOWN事件類型發送到設備，對應的按一個鍵或觸摸屏幕上。 b、UP 發送一個UP事件。指定UP事件類型發送到設備，對應釋放一個鍵或從屏幕上抬起。 c、DOWN_AND_UP 發送一個DOWN事件，然后一個UP事件。對應於輸入鍵或點擊屏幕。

7.發送按鍵指令
按下HOME鍵 device.press('KEYCODE_HOME','DOWN_AND_UP')
按下BACK鍵 device.press('KEYCODE_BACK','DOWN_AND_UP')
按下下導航鍵 device.press('KEYCODE_DPAD_DOWN','DOWN_AND_UP')
按下上導航鍵 device.press('KEYCODE_DPAD_UP','DOWN_AND_UP')
按下OK鍵 device.press('KEYCODE_DPAD_CENTER','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

八、參考資料：

Google官方文檔：
http://developer.android.com/tools/help/monkeyrunner_concepts.html

網絡資料：
http://www.cnblogs.com/yyangblog/archive/2011/03/10/1980086.html
http://blog.csdn.net/shy871265996/article/details/9716723