Appium+python自動化（二十三）- 真假美猴王Monkeyrunner與Monkey傻傻的分不清楚（超詳解）

時間 2020-04-30

標籤 appium+python appium python 自動化二十三真假猴王 monkeyrunner monkey 傻的不清楚詳解欄目 Python 简体版

原文原文鏈接

簡介

　　看《西遊記》第五十七回，說是「六耳獼猴」化做孫悟空的摸樣，傷了唐僧，後又和孫悟空大打出手…… 這位假孫悟空，實力不用多說了吧，和真孫悟空通常無二，大戰孫悟空，鬧到上天入地下海。在唐僧那：念緊箍咒，兩個都喊疼，天然看不出哪一個真假；到天宮：拖塔天王拿照妖鏡照，也看不出；又到觀音那：觀音也看不出。最後到幽冥處閻羅那，經「諦聽」聽過以後，「諦聽」卻說：「我看出來了，卻不敢說」最後仍是如來老佛爺道出六耳真身並用金鉢盂罩住，才被孫悟空一棍子打死。想必各位小夥伴都看過這以精彩片斷。不過據知情人士說真假美猴王存在陰謀，這裏有黑幕：說是真的孫悟空被打死了，活下來的是假的。好了廢話少說，仍是回到今天的主題：真假美猴王Monkeyrunner與Monkey傻傻的分不清楚。html

　　今天宏哥就帶着各位小夥伴和童鞋們再當一回和尚：如來佛祖辨一辨真假美猴王，前邊咱們已經對monkey作過一些詳細的介紹和講解，今天咱們就再來介紹和講解一下monkeyrunner。看看他們之間的究竟是同樣仍是有區別的。python

monkeyrunner簡介

1.monkeyrunner工具使用Jython，這是一種使用Java編程語言的Python實現。Jython容許monkeyrunner API與Android框架輕鬆交互。使用Jython，您可使用Python語法來訪問API的常量，類和方法。MonkeyRunner工具是使用Jython(使用Java編程語言實現的android

Python)寫出來的，它提供了多個API，經過monkeyrunner API 能夠寫一個Python的程序來模擬操做控制Android設備app,測試其穩定性並經過截屏能夠方便地記錄出現的問題。shell

2.咱們來看一下monkeyrunner官網是如何介紹monkeyrunner的：編程

官網介紹（已翻譯成中文）宏哥在這裏給小夥伴截取一段翻譯，以下：windows

　　monkeyrunner工具提供了一個API，用於編寫從Android代碼外部控制Android設備或模擬器的程序。使用monkeyrunner，您能夠編寫一個Python程序，安裝Android應用程序或測試包，運行它，向其發送擊鍵，截取其用戶界面，並在工做站上存儲屏幕截圖、服務器

monkeyrunner工具主要用於測試功能/框架級別的應用程序和設備以及運行單元測試套件，但您能夠將其用於其餘目的。微信

monkeyrunner工具與UI / Application Exerciser Monkey無關，也稱爲monkey工具。該monkey工具adb直接在設備或仿真器上的shell中運行，並生成用戶和系統事件的僞隨機流。相比之下，monkeyrunner工具經過從API發送特定命令和事件來控制工做站中的設備和app

仿真器。框架

3.monkeyrunner即android SDK中自帶的工具之一，此工具提供API可按制android設備或模擬器。

4.有興趣的小夥伴們或者童鞋能夠查看一下monkeyrunner官網：https://www.android-doc.com/tools/help/monkeyrunner_concepts.html

5.monkeyrunner 路徑：Andriod_SDK\tools

MonkeyRunner工具獨特功能

1.多設備控制：monkeyrunner API能夠跨多個設備或仿真器應用一個或多個測試套件。您能夠物理鏈接全部設備或當即啓動全部模擬器（或二者），以編程方式依次鏈接到每一個設備，而後運行一個或多個測試。您還能夠以編程方式啓動模擬器配置，運行一個或多個測試，而後關閉模擬器。

2.功能測試：monkeyrunner能夠對Android應用程序進行自動化的從頭至尾的測試。您能夠經過擊鍵或觸摸事件提供輸入值，並將結果視爲屏幕截圖。

3.迴歸測試 - monkeyrunner能夠經過運行應用程序並將其輸出屏幕截圖與一組已知正確的屏幕截圖進行比較來測試應用程序的穩定性。

4.可擴展的自動化 - 因爲monkeyrunner是一個API工具包，您能夠開發一個基於Python的模塊和程序的整個系統來控制Android設備。除了使用monkeyrunner API自己，您還可使用標準的Python os和 subprocess 模塊來調用Android工具，例如 Android Debug Bridge。

您還能夠將本身的類添加到monkeyrunner API中。這在「使用插件擴展monkeyrunner 」一節中有更詳細的描述。

Monkeyrunner與Monkey區別

monkeyrunner和money沒有什麼直接的關係，monkey是在設備直接運行adb shell命令生成隨機事件來進行測試的。相比較而言，monkeyrunner則是經過API發送特定的命令和事件來控制設備。

爲了支持黑盒自動化測試的場景，Android SDK提供了monkey和monkeyrunner兩個測試工具，這兩個測試工具除了名字相似外，還均可以向待測應用發送按鍵等消息，每每容易產生混淆，如下是他倆的不一樣之處。

Monkey：

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

1.monkey運行在設備或者模擬器上邊，能夠脫離PC運行，其運行時以下圖所示。

Monkeyrunner：

Monkeyrunner工具是在工做站上經過API定義的特定命令和事件控制設備或模擬器。

而monkeyrunner運行在PC上，須要經過服務器/客戶端的的模式向設備或者模擬器上的android應用發送指令來執行測試，其運行時以下圖所示。

2.廣泛的作法是將monkey做爲一個向待測應用發送隨機按鍵消息的測試工具，驗證待測應用在這些隨機性的輸入面前是否會有閃退或者崩潰。而monkeyrunner則接受一個明確的測試腳本（使用python語言編寫的）。

3.雖然monkey也能夠根據一個指定的命令腳本發送按鍵消息，但其不支持條件判斷，也不支持讀取界面的信息來執行驗證操做。而monkeyrunner的測試腳本中有明確的條件判斷等語句，可用來作功能測試。

總結：

　　實際操做中，monkey因爲缺乏必要的條件判斷等命令，難以在功能測試上有所做爲，只能做爲生成一些隨機事件的工具，測試應用程序的健壯程度，待測應用崩潰後能夠根據monkey打印的日誌，再用monkey建立一個重現步驟，供開發調試。monkey服務器模式更適合用於黑盒測試，不建議用於自動化測試。

　　而Monkeyrunner雖然有Python和Java類庫的強大支持，但其自身提供的API有限，還得須要插件擴展其功能。

monkeyrunner API

monkeyrunner API包含在包中的三個模塊中 com.android.monkeyrunner：

1.MonkeyRunner：monkeyrunner程序的一類實用方法。此類提供了將monkeyrunner鏈接到設備或模擬器的方法。它還提供了爲monkeyrunner程序建立UI以及顯示內置幫助的方法。

2.MonkeyDevice：表示設備或模擬器。此類提供了安裝和卸載軟件包，啓動Activity以及嚮應用程序發送鍵盤或觸摸事件的方法。您還可使用此類來運行測試包。

3.MonkeyImage：表示屏幕捕獲圖像。此類提供捕獲屏幕，將位圖圖像轉換爲各類格式，比較兩個MonkeyImage對象以及將圖像寫入文件的方法。

在Python程序中，您能夠將每一個類做爲Python模塊進行訪問。monkeyrunner工具不會自動導入這些模塊。要導入模塊，請使用Python from語句：

1 from com.android.monkeyrunner import <module>

<module>您要導入的類名在哪裏。from經過用逗號分隔模塊名稱，能夠在同一語句中導入多個模塊。

運行monkeyrunner

您能夠從文件中運行monkeyrunner程序，也能夠在交互式會話中輸入monkeyrunner語句。您能夠經過調用SDK目錄子目錄中的monkeyrunner命令來執行這兩項操做tools/。若是提供文件名做爲參數，則該monkeyrunner命令將文件的內容做爲Python程序運行; 不然，它會啓動一個交互式會話。

該monkeyrunner命令的語法是

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

表1解釋了標誌和參數。

表1. monkeyrunner標誌和參數。

參數	描述
`-plugin <plugin_jar>`	（可選）指定`.jar`包含monkeyrunner插件的文件。要了解有關monkeyrunner插件的更多信息，請參閱使用插件擴展monkeyrunner。要指定多個文件，請屢次包含該參數。
`<program_filename>`	若是提供此參數，則該`monkeyrunner`命令將該文件的內容做爲Python程序運行。若是未提供參數，則該命令將啓動交互式會話。
`<program_options>`	（可選）<program_file>中程序的標誌和參數。

運行monkeyrunner

命令語法爲：

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

方式一：在CMD命令窗口直接運行monkeyrunner

方式二：使用Python編寫測試代碼文件，在CMD中執行monkeyrunner hongge.py運行

不論使用哪一種方式，您都須要調用SDK目錄的tools子目錄下的monkeyrunner命令。

注意：在運行monkeyrunner以前必須先運行相應的模擬器或鏈接真機，不然monkeyrunner沒法鏈接到設備

運行模擬器有兩種方法：一、經過eclipse中執行模擬器二、在CMD中經過命令調用模擬器

這裏介紹經過命令，在CMD中執行模擬器的方法

emulator -avd test

上面命令中test是指模擬器的名稱。

附：這部分前邊已經講解過，在這裏就再也不贅述）

問題：CMD運行提示monkeyrunner不是內部或外部命令，也不是可運行的程序或批處理文件。

解決：電腦環境變量未配置，將monkeyrunner所在目錄配在環境變量裏。

變量名：Path

變量值：D:\android\android-sdk-windows\tools;D:\android\android-sdk-windows\platform-tools

實例

實例一：卸載舊的APP，安裝新的APP

*準備

a. 鏈接安卓夜神模擬器設備

b. 運行CMD，檢測是否鏈接成功

CMD>adb devices

附：（這部分前邊已經講解過，在這裏就再也不贅述）

問題：CMD運行提示adb不是內部或外部命令，也不是可運行的程序或批處理文件。

解決：電腦環境變量未配置，將adb所在目錄配在環境變量裏。

*方式一：

1.打開CMD，運行monkeyrunner

2.進入monkeyrunner的shell命令交互模式後，逐條輸入如下命令

1 from com.android.monkeyrunner import MonkeyRunner, MonkeyDevice, MonkeyImage
2 device = MonkeyRunner.waitForConnection()
3 device.removePackage('com.taobao.taobao')
4 device.installPackage('C:\\Users\\DELL\\Desktop\\702757.apk')

（1）輸入命令前的夜神模擬器：

（2）輸入第三行命令後的夜神模擬器

（3）輸入第四行的夜神模擬器

注：每條命令的做用，請見方法二中的註解

實操如圖：

c.檢查手機app是否已更新

*方式二：

a. 編寫Python測試代碼

 1 # File: Test1.py  2 # Vision: V1.0
 3 # Author: hongge QQ羣：707699217  4 # 引入本程序所用到的模塊  5 from com.android.monkeyrunner import MonkeyRunner, MonkeyDevice, MonkeyImage  6 
 7 # 鏈接手機設備  8 device = MonkeyRunner.waitForConnection()  9 
10 # 截圖 11 result = device.takeSnapshot() 12 # 將截圖保存到文件 13 result.writeToFile('E:\\JAVA\\monkeyrunner\\Test1\\Test1_001.png','png') 14 
15 # 卸載APP 16 device.removePackage('cn.richinfo.thinkdrive') 17 print ('Uninstall Success!') 18 
19 # 暫停5秒 20 MonkeyRunner.sleep(5) 21 
22 # 截圖 23 result = device.takeSnapshot() 24 result.writeToFile('E:\\JAVA\\monkeyrunner\\Test1\\Test1_002.png','png') 25 
26 # 安裝新的APP 27 device.installPackage('E:\\JAVA\\monkeyrunner\\Test1\\ThinkDrive_new.apk') 28 print ('Install Success!') 29 
30 # 截圖 31 result = device.takeSnapshot() 32 result.writeToFile('E:\\JAVA\\monkeyrunner\\Test1\\Test1_003.png','png')

注：拷貝運行時請去掉中文註釋；或者在開頭加入 #coding=utf-8

b.執行Test1.py腳本

Monkeyrunner C:\Users\DELL\Desktop\test.py

實操如圖：

c.檢查手機app是否已更新

d.查看截圖文件夾，截圖和上邊逐條輸入命令，宏哥截得模擬器如出一轍的。

e.注意若是截圖不同本身加個等待時間，就會同樣，參考代碼：

 1 #coding=utf-8 
 2 # File: Test1.py  3 
 4 # Vision: V1.0
 5 
 6 # Author: hongge  QQ羣：707699217
 7 
 8 # 引入本程序所用到的模塊  9 
10 from com.android.monkeyrunner import MonkeyRunner, MonkeyDevice, MonkeyImage 11 
12 
13 
14 # 鏈接手機設備 15 
16 device = MonkeyRunner.waitForConnection() 17 
18 
19 
20 # 截圖 21 
22 result = device.takeSnapshot() 23 
24 # 將截圖保存到文件 25 
26 result.writeToFile('C:\\Users\\DELL\\Desktop\\test\\Test1_001.png','png') 27 
28 
29 
30 # 卸載APP 31 
32 device.removePackage('com.taobao.taobao') 33 
34 print ('Uninstall Success!') 35 
36 
37 
38 # 暫停5秒 39 
40 MonkeyRunner.sleep(5) 41 
42 
43 
44 # 截圖 45 
46 result = device.takeSnapshot() 47 
48 result.writeToFile('C:\\Users\\DELL\\Desktop\\test\\Test1_002.png','png') 49 
50 
51 # 暫停5秒 52 
53 MonkeyRunner.sleep(5) 54 
55 
56 # 安裝新的APP 57 
58 device.installPackage('C:\\Users\\DELL\\Desktop\\702757.apk') 59 
60 print ('Install Success!') 61 
62 # 暫停5秒 63 
64 MonkeyRunner.sleep(5) 65 
66 # 截圖 67 
68 result = device.takeSnapshot() 69 
70 result.writeToFile('C:\\Users\\DELL\\Desktop\\test\\Test1_003.png','png')

monkeyrunner內置幫助

您能夠經過運行如下命令爲monkeyrunner生成API參考：

1 monkeyrunner help.py <format> <outfile>

論點是：

<format>或者是text純文本的輸出或html用於HTML輸出。
<outfile> 是輸出文件的路徑限定名稱。

使用插件擴展monkeyrunner

您可使用Java編程語言編寫的類擴展monkeyrunner API，並將其構建爲一個或多個.jar文件。您可使用此功能使用您本身的類擴展monkeyrunner API或擴展示有類。您還可使用此功能初始化monkeyrunner環境。

要爲monkeyrunner提供插件，請monkeyrunner使用表1中-plugin <plugin_jar>描述的參數調用該命令。

在你的插件代碼，你能夠導入和擴展的主要monkeyrunner類 MonkeyDevice，MonkeyImage和MonkeyRunner在com.android.monkeyrunner（見的monkeyrunner API）。

請注意，插件不容許您訪問Android SDK。您沒法導入包等com.android.app。這是由於monkeyrunner與框架API級別下的設備或模擬器交互。

插件啓動類

.jar插件的文件能夠指定在腳本處理開始以前實例化的類。要指定此類，請將密鑰添加 MonkeyRunnerStartupRunner到.jar文件的清單中。該值應該是啓動時要運行的類的名稱。如下代碼段顯示瞭如何在ant構建腳本中執行此操做：

1 <jar jarfile="myplugin" basedir="${build.dir}">
2 <manifest>
3 <attribute name="MonkeyRunnerStartupRunner" value="com.myapp.myplugin"/>
4 </manifest>
5 </jar>

要訪問monkeyrunner的運行時環境，啓動類能夠實現 com.google.common.base.Predicate<PythonInterpreter>。例如，此類在默認命名空間中設置一些變量：

 1 package com.android.example;  2 
 3 import com.google.common.base.Predicate;  4 import org.python.util.PythonInterpreter;  5 
 6 public class Main implements Predicate<PythonInterpreter> {  7  @Override  8     public boolean apply(PythonInterpreter anInterpreter) {  9 
10         /*
11  * Examples of creating and initializing variables in the monkeyrunner environment's 12  * namespace. During execution, the monkeyrunner program can refer to the variables "newtest" 13  * and "use_emulator" 14  * 15         */
16         anInterpreter.set("newtest", "enabled"); 17         anInterpreter.set("use_emulator", 1); 18 
19         return true; 20     }

monkeyrunner環境搭建

1.安裝並配置好jdk環境

2.安裝android sdk

3.安裝python

4.monkeyrunner環境變量配置： {Path}\Andriod_SDK\tools

安裝結果檢測

在docs命令控制檯輸入命令：monkeyrunner出現以下顯示內容則說明安裝成功

Tips：退出monkeyrunner命令行模式能夠使用快捷鍵 ctrl+D退出。

小結

1.在方式二運行monkeyrunner報錯（190724 14:33:20.837:S [main] [com.android.monkeyrunner.MonkeyRunnerOptions] Script terminated due to an exception）

解決方法，報出該錯誤是使用的notepad++編碼格式問題，notepad++默認編碼格式是ansi，咱們使用的monkeyrunner腳本格式是utf-8，所以有衝突

修改方法以下

首先，看咱們的腳本編碼格式是什麼，我這裏的是utf-8，所以不用再作修改

3.若是編碼格式不是utf-8的，就要對它進行修改了，點擊格式，選擇utf-8，再保存，也可選擇無BOM格式的

4.再來運行一下，此次成功了

2.monkeyrunner經常使用的知識點

#引入程序所用的模塊

1 from com.android.monkeyrunner import MonkeyRunner, MonkeyDevice, MonkeyImage

#引入程序所用的模塊，使用別名

1 from com.android.monkeyrunner import MonkeyRunner as mr 2 from com.android.monkeyrunner import MonkeyDevice as md 3 from com.android.monkeyrunner import MonkeyImage as mi 4 #若是給導入的模塊起了別名，就必須使用別名，不然會出現錯誤。 5 #好比鏈接設備或模擬器，起了以上別名後，命令應該以下： 6 device=mr.waitForConnection()

#鏈接到設備或模擬器

1 #參數1：超時時間，單位秒，浮點數。默認是無限期地等待。 2 #參數2：串deviceid，指定的設備名稱。默認爲當前設備（手機優先，好比手機經過USB線鏈接到PC、其次爲模擬器）。 3 #默認鏈接： 4 device = MonkeyRunner.waitForConnection() 5 #參數鏈接： 6 device = MonkeyRunner.waitForConnection(1.0,'4df74b8XXXXXXX')

#向設備或模擬器安裝APK

1 #如下兩種方式都是對的 2 device.installPackage('E:/JAVA/monkeyrunner/Test1/ThinkDrive_new.apk') 3 device.installPackage('E:\\JAVA\\monkeyrunner\\Test1\\ThinkDrive_new.apk') 4 #參數能夠爲絕對路徑，也可爲相對路徑

#卸載設備或模擬器中的APK

1 #參數爲APK包名 2 device.removePackage('cn.richinfo.thinkdrive')

#啓動任意的Activity

1 #device.startActivity(component="包名/啓動Activity") 2 #如下兩種都OK 3 device.startActivity(component="cn.richinfo.thinkdrive/cn.richinfo.thinkdrive.ui.activities.NavigateActivity") 4 device.startActivity(component="cn.richinfo.thinkdrive/.ui.activities.NavigateActivity")

#手機截圖

1 #獲取設備的屏蔽緩衝區，產生了整個顯示器的屏蔽捕獲。（截圖） 2 result=device.takeSnapshot() 3 #返回一個MonkeyImage對象（點陣圖包裝），咱們能夠用如下命令將圖保存到文件 4 result.writeToFile('E:\\JAVA\\monkeyrunner\\Test1\\Test1_001.png','png')

#暫停

1 #暫停目前正在運行的程序指定的秒數 2 #MonkeyRunner.sleep(秒數，浮點數) 3 MonkeyRunner.sleep(5)

#字符串發送到鍵盤

1 #device.type('字符串') 2 device.type('hongge')

#喚醒設備屏幕

1 #鎖屏後,屏幕關閉，能夠用下命令喚醒 2 device.wake()

#重起手機

1 device.reboot()

#模擬滑動

1 #device.drag(X,Y,D,S) 2 #X 開始座標 3 #Y 結束座標 4 #D 拖動持續時間(以秒爲單位)，默認1.0秒 5 #S 插值點時要採起的步驟。默認值是10 6 device.drag((100,1053),(520,1053),0.1,10)

#在指定位置發送觸摸事件

1 #device.touch(x,y,觸摸事件類型) 2 #x,y的單位爲像素 3 #觸摸事件類型，請見下文中Findyou對device.press描述 4 
5 device.touch(520,520,'DOWN_AND_UP')

#發送指定類型指定鍵碼的事件

 1 #device.press(參數1:鍵碼,參數2:觸摸事件類型)  2 #參數1：見android.view.KeyEvent  3 #參數2，若有TouchPressType()返回的類型－觸摸事件類型，有三種。  4 #1、DOWN 發送一個DOWN事件。指定DOWN事件類型發送到設備，對應的按一個鍵或觸摸屏幕上。  5 #2、UP 發送一個UP事件。指定UP事件類型發送到設備，對應釋放一個鍵或從屏幕上擡起。  6 #3、DOWN_AND_UP 發送一個DOWN事件，而後一個UP事件。對應於輸入鍵或點擊屏幕。  7 以上三種事件作爲press()參數或touch()參數  8 
 9 #按下HOME鍵 10 device.press('KEYCODE_HOME',MonkeyDevice.DOWN_AND_UP) 11 #按下BACK鍵 12 device.press('KEYCODE_BACK',MonkeyDevice.DOWN_AND_UP) 13 #按下下導航鍵 14 device.press('KEYCODE_DPAD_DOWN',MonkeyDevice.DOWN_AND_UP) 15 #按下上導航鍵 16 device.press('KEYCODE_DPAD_UP',MonkeyDevice.DOWN_AND_UP) 17 #按下OK鍵 18 device.press('KEYCODE_DPAD_CENTER',MonkeyDevice.DOWN_AND_UP)