一、環境要求python 3.6+android 4.4+

二、介紹uiautomator2 是一個可以使用Python對Android裝置進行UI自動化的庫。其底層基於Google uiautomator，Google提供的uiautomator庫可以獲取螢幕上任意一個APP的任意一個控制元件屬性，並對其進行任意操作。

三、庫地址GitHub地址：https://github.com/openatx/uiautomator2

https://github.com/openatx/uiautomator2/blob/master/README.md

四、安裝

1、安裝uiautomator2

pip install --pre uiautomator2 pip install pillow （如果需要截圖，可安裝這個庫）12

2、裝置安裝atx-agent

首先裝置連線到PC，並能夠adb devices發現該裝置。執行下面的命令會自動安裝本庫所需要的裝置端程式：uiautomator-server，atx-agent，openstf / minicap，openstf / minitouch

# init就是所有USB連線電腦的手機上都安裝uiautomator2python -m uiautomator2 init # 指定手機安裝uiautomator2， 用 --mirrorpython -m uiautomator2 init --mirror --serial $SERIAL# 嫌棄慢的話，可以用國內的映象python -m uiautomator2 init --mirror12345678

最後提示success，代表atx-agent初始化成功。

3、安裝weditor有了這個，方便我們快速的識別手機上的元素，方便寫程式碼

pip install -U weditor1

安裝好之後，就可以在命令列執行 weditor --help 確認是否安裝成功了。

Windows系統可以使用命令在桌面建立一個快捷方式:

weditor --shortcut1

在windows cmd中執行上述命令後，會在桌面上建立一個快捷方式，如下圖：

啟動方法：

方法1.命令列直接輸入 weditor 會自動開啟瀏覽器，輸入裝置的ip或者序列號，點選Connect即可;方法2.桌面上雙擊WEditor快捷方式即可;方法3.命令列中執行 python -m weditor

啟動後如下圖：

五、應用及操作

呼叫uiautomator2的過程

裝置連線方法，有兩種：

python-uiautomator2連線手機的方式有兩種，一種是透過WIFI，另外一種是透過USB。兩種方法各有優缺點。WIFI最便利的地方要數可以不用連線資料線，USB則可以用在PC和手機網路不在一個網段用不了的情況。

（1）透過WiFi，假設裝置IP 192.168.0.107和您的PC在同一網路中

import uiautomator2 as u2d = u2.connect('192.168.0.107') 12

（2）透過USB， 假設裝置序列是123456789F

import uiautomator2 as u2d = u2.connect('123456789F') # USB連結裝置。或者u2.connect_usb('123456f')#d = u2.connect_usb() 或者 d = u2.connect()  ，當前只有一個裝置時可以用這個123

在沒有引數的情況下呼叫u2.connect()， uiautomator2將從環境變數ANDROID_DEVICE_IP獲取裝置IP。如果這個環境變數是空的，uiautomator將返回connect_usb，您需要確保只有一個裝置連線到計算機。

檢查並維持裝置端守護程序處於執行狀態：

d.healthcheck()1

開啟除錯開關：

d.debug = Trued.info12

安裝應用，只能從URL安裝：

d.app_install('http://some-domain.com/some.apk')  #引號內為下載apk地址1

啟動應用：

d.app_start('com.eg.android.AlipayGphone')  #引號內為包名稱，這裡為支付寶1

停止應用：

#相當於'am force-stop'強制停止應用d.app_stop('com.eg.android.AlipayGphone') #相當於'pm clear' 清空App資料d.app_clear('com.eg.android.AlipayGphone')12345

停止所有正在執行的應用程式：

# 停止所有d.app_stop_all()# 停止所有應用程式，除了com.examples.demod.app_stop_all(excludes=['com.examples.demo'])12345

跳過彈窗，禁止彈窗：

d.disable_popups()   # 自動跳過彈出視窗 d.disable_popups(False)  # 禁用自動跳過彈出窗12

獲取裝置資訊：

# 獲取基本資訊d.info# 獲取視窗大小print(d.window_size())# 裝置垂直輸出示例: (1080, 1920)# 裝置水平輸出示例: (1920, 1080)# 獲取當前應用程式資訊。對於某些android裝置，輸出可以為空print(d.current_app())#獲取裝置序列號print(d.serial)#獲取WIFI IPprint(d.wlan_ip)#獲取詳細的裝置資訊print(d.device_info)12345678910111213141516171819

獲取應用資訊：

d.app_info("com.eg.android.AlipayGphone")# 會輸出'''{    "packageName": "com.eg.android.AlipayGphone",     "mainActivity": "com.eg.android.AlipayGphone.AlipayLogin",     "label": "支付寶",     "versionName": "10.2.13.9020",     "versionCode": 360,     "size": 108306104}'''# 儲存應用程式圖示img = d.app_icon("com.eg.android.AlipayGphone")img.save("icon.png")123456789101112131415

推拉檔案：（1）將檔案推送到裝置

# push資料夾d.push("foo.txt", "/sdcard/")# push和重新命名d.push("foo.txt", "/sdcard/bar.txt")# push fileobjwith open("foo.txt", 'rb') as f:    d.push(f, "/sdcard/")# 推動和更改檔案訪問模式d.push("foo.sh", "/data/local/tmp/", mode=0o755)123456789

（2）從裝置中拉出一個檔案

d.pull("/sdcard/tmp.txt", "tmp.txt")# 如果在裝置上找不到檔案，FileNotFoundError將引發d.pull("/sdcard/some-file-not-exists.txt", "tmp.txt")1234

關鍵事件：（1）開啟/關閉螢幕

d.screen_on()＃開啟螢幕 d.screen_off() ＃關閉螢幕12

（2）獲取當前螢幕狀態

d.info.get('screenOn')  # 需要 Android> = 4.41

（3）硬鍵盤和軟鍵盤操作

d.press("home") # 點選home鍵d.press("back") # 點選back鍵d.press("left") # 點選左鍵d.press("right") # 點選右鍵d.press("up") # 點選上鍵d.press("down") # 點選下鍵d.press("center") # 點選選中d.press("menu") # 點選menu按鍵d.press("search") # 點選搜尋按鍵d.press("enter") # 點選enter鍵d.press("delete") # 點選刪除按鍵d.press("recent") # 點選近期活動按鍵d.press("volume_up") # 音量+d.press("volume_down") # 音量-d.press("volume_mute") # 靜音d.press("camera") # 相機d.press("power") #電源鍵1234567891011121314151617

（4）解鎖螢幕

d.unlock()# 相當於# 1. 發射活動:com.github.uiautomator.ACTION_IDENTIFY# 2. 按home鍵1234

手勢與裝置的互動：

# 單擊螢幕d.click(x,y)  # x,y為點選座標# 雙擊螢幕d.double_click(x,y)d.double_click(x,y,0.1) # 預設兩個單擊之間間隔時間為0.1秒# 長按d.long_click(x,y)d.long_click(x,y,0.5)  # 長按0.5秒（預設）# 滑動d.swipe(sx, sy, ex, ey)d.swipe(sx, sy, ex, ey, 0.5) #滑動0.5s(default)#拖動d.drag(sx, sy, ex, ey)d.drag(sx, sy, ex, ey, 0.5)#拖動0.5s(default)# 滑動點 多用於九宮格解鎖，提前獲取到每個點的相對座標（這裡支援百分比）# 從點(x0, y0)滑到點(x1, y1)再滑到點(x2, y2)# 兩點之間的滑動速度是0.2秒d.swipe((x0, y0), (x1, y1), (x2, y2), 0.2)# 注意：單擊，滑動，拖動操作支援百分比位置值。例：d.long_click(0.5, 0.5) 表示長按螢幕中心12345678910111213141516171819202122232425

XPath：

# 檢索方向d.orientation# 檢索方向。輸出可以是 "natural" or "left" or "right" or "upsidedown"# 設定方向d.set_orientation("l") # or "left"d.set_orientation("r") # or "right"d.set_orientation("n") # or "natural"#凍結/ 開啟旋轉d.freeze_rotation() # 凍結旋轉d.freeze_rotation(False) # 開啟旋轉########## 截圖 ############# 截圖並儲存到電腦上的一個檔案中，需要Android>=4.2。d.screenshot("home.jpg") # 得到PIL.Image格式的影象. 但你必須先安裝pillowimage = d.screenshot() # default format="pillow"image.save("home.jpg") # 或'home.png'，目前只支援png 和 jpg格式的影象 # 得到OpenCV的格式影象。當然，你需要numpy和cv2安裝第一個import cv2image = d.screenshot(format='opencv')cv2.imwrite('home.jpg', image) # 獲取原始JPEG資料imagebin = d.screenshot(format='raw')open("some.jpg", "wb").write(imagebin)############################## 轉儲UI層次結構# get the UI hierarchy dump content (unicoded).（獲取UI層次結構轉儲內容）d.dump_hierarchy()# 開啟通知或快速設定d.open_notification()  #下拉開啟通知欄d.open_quick_settings()  #下拉開啟快速設定欄# 檢查特定的UI物件是否存在d(text="Settings").exists # 返回布林值，如果存在則為True，否則為Falsed.exists(text="Settings") # 另一種寫法# 高階用法d(text="Settings").exists(timeout=3) # 等待'Settings'在3秒鐘出現# 獲取特定UI物件的資訊d(text="Settings").info# 獲取/設定/清除可編輯欄位的文字(例如EditText小部件)d(text="Settings").get_text()  #得到文字小部件d(text="Settings").set_text("My text...")  #設定文字d(text="Settings").clear_text()  #清除文字# 獲取Widget中心點d(text="Settings").center()#d(text="Settings").center(offset=(0, 0)) # 基準位置左前12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152535455565758

UI物件有五種定位方式：

# text、resourceId、description、className、xpath、座標# 執行單擊UI物件#text定位單擊d(text="Settings").click()d(text="Settings", className="android.widget.TextView").click()#resourceId定位單擊d(resourceId="com.ruguoapp.jike:id/tv_title", className="android.widget.TextView").click() #description定位單擊d(description="設定").click()d(description="設定", className="android.widget.TextView").click()#className定位單擊d(className="android.widget.TextView").click()#xpath定位單擊d.xpath("//android.widget.FrameLayout[@index='0']/android.widget.LinearLayout[@index='0']").click()#座標單擊d.click(182, 1264)# 等待元素出現(最多10秒），出現後單擊 d(text="Settings").click(timeout=10)# 在10秒時點選，預設的超時0d(text='Skip').click_exists(timeout=10.0)# 單擊直到元素消失，返回布林d(text="Skip").click_gone(maxretry=10, interval=1.0) # maxretry預設值10,interval預設值1.0# 點選基準位置偏移d(text="Settings").click(offset=(0.5, 0.5)) # 點選中心位置，同d(text="Settings").click()d(text="Settings").click(offset=(0, 0)) # 點選左前位置d(text="Settings").click(offset=(1, 1)) # 點選右下# 執行雙擊UI物件d(text="設定").double_click() # 雙擊特定ui物件的中心d.double_click(x, y, 0.1)  # 兩次單擊之間的預設持續時間為0.1秒#執行長按UI物件# 長按特定UI物件的中心d(text="Settings").long_click()d.long_click(x, y, 0.5) # 長按座標位置0.5s預設# 將UI物件拖向另一個點或另一個UI物件# Android<4.3不能使用drag.# 在0.5秒內將UI物件拖到螢幕點(x, y)d(text="Settings").drag_to(x, y, duration=0.5)# 將UI物件拖到另一個UI物件的中心位置，時間為0.25秒d(text="Settings").drag_to(text="Clock", duration=0.25)123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051

常見用法：

# 等待10sd.xpath("//android.widget.TextView").wait(10.0)# 找到並單擊d.xpath("//*[@content-desc='分享']").click()# 檢查是否存在if d.xpath("//android.widget.TextView[contains(@text, 'Se')]").exists:    print("exists")    # 獲取所有文字檢視文字、屬性和中心點for elem in d.xpath("//android.widget.TextView").all():    print("Text:", elem.text)    #獲取檢視文字for elem in d.xpath("//android.widget.TextView").all():    print("Attrib:", elem.attrib)    #獲取屬性和中心點#返回: (100, 200)for elem in d.xpath("//android.widget.TextView").all():    print("Position:", elem.center())# xpath常見用法：# 所有元素//*# resource-id包含login字元//*[contains(@resource-id, 'login')]# 按鈕包含賬號或帳號//android.widget.Button[contains(@text, '賬號') or contains(@text, '帳號')]# 所有ImageView中的第二個(//android.widget.ImageView)[2]# 所有ImageView中的最後一個(//android.widget.ImageView)[last()]# className包含ImageView//*[contains(name(), "ImageView")]