python UIAutomator2使用超詳細(xì)教程

pip install --pre uiautomator2 
pip install pillow （如果需要截圖，可安裝這個(gè)庫(kù)）

# init就是所有USB連接電腦的手機(jī)上都安裝uiautomator2
python -m uiautomator2 init
 
# 指定手機(jī)安裝uiautomator2， 用 --mirror
python -m uiautomator2 init --mirror --serial $SERIAL

# 嫌棄慢的話，可以用國(guó)內(nèi)的鏡像
python -m uiautomator2 init --mirror

pip install -U weditor

weditor --shortcut

import uiautomator2 as u2
d = u2.connect('192.168.0.107') 

import uiautomator2 as u2
d = u2.connect('123456789F') # USB鏈接設(shè)備?；蛘遳2.connect_usb('123456f')
#d = u2.connect_usb() 或者 d = u2.connect() ，當(dāng)前只有一個(gè)設(shè)備時(shí)可以用這個(gè)

d.healthcheck()

d.debug = True
d.info

d.app_install('http://some-domain.com/some.apk') #引號(hào)內(nèi)為下載apk地址

d.app_start('com.eg.android.AlipayGphone') #引號(hào)內(nèi)為包名稱(chēng)，這里為支付寶

#相當(dāng)于'am force-stop'強(qiáng)制停止應(yīng)用
d.app_stop('com.eg.android.AlipayGphone') 

#相當(dāng)于'pm clear' 清空App數(shù)據(jù)
d.app_clear('com.eg.android.AlipayGphone')

# 停止所有
d.app_stop_all()

# 停止所有應(yīng)用程序，除了com.examples.demo
d.app_stop_all(excludes=['com.examples.demo'])

d.disable_popups() # 自動(dòng)跳過(guò)彈出窗口 
d.disable_popups(False) # 禁用自動(dòng)跳過(guò)彈出窗

# 獲取基本信息
d.info

# 獲取窗口大小
print(d.window_size())
# 設(shè)備垂直輸出示例: (1080, 1920)
# 設(shè)備水平輸出示例: (1920, 1080)

# 獲取當(dāng)前應(yīng)用程序信息。對(duì)于某些android設(shè)備，輸出可以為空
print(d.current_app())

#獲取設(shè)備序列號(hào)
print(d.serial)

#獲取WIFI IP
print(d.wlan_ip)

#獲取詳細(xì)的設(shè)備信息
print(d.device_info)

d.app_info("com.eg.android.AlipayGphone")
# 會(huì)輸出
'''
{
 "packageName": "com.eg.android.AlipayGphone", 
 "mainActivity": "com.eg.android.AlipayGphone.AlipayLogin", 
 "label": "支付寶", 
 "versionName": "10.2.13.9020", 
 "versionCode": 360, 
 "size": 108306104
}
'''
# 保存應(yīng)用程序圖標(biāo)
img = d.app_icon("com.eg.android.AlipayGphone")
img.save("icon.png")

# push文件夾
d.push("foo.txt", "/sdcard/")
# push和重命名
d.push("foo.txt", "/sdcard/bar.txt")
# push fileobj
with open("foo.txt", 'rb') as f:
 d.push(f, "/sdcard/")
# 推動(dòng)和更改文件訪問(wèn)模式
d.push("foo.sh", "/data/local/tmp/", mode=0o755)

d.pull("/sdcard/tmp.txt", "tmp.txt")

# 如果在設(shè)備上找不到文件，F(xiàn)ileNotFoundError將引發(fā)
d.pull("/sdcard/some-file-not-exists.txt", "tmp.txt")

d.screen_on()＃打開(kāi)屏幕 
d.screen_off() ＃關(guān)閉屏幕

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

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

d.unlock()
# 相當(dāng)于
# 1. 發(fā)射活動(dòng):com.github.uiautomator.ACTION_IDENTIFY
# 2. 按home鍵

# 單擊屏幕
d.click(x,y) # x,y為點(diǎn)擊坐標(biāo)

# 雙擊屏幕
d.double_click(x,y)
d.double_click(x,y,0.1) # 默認(rèn)兩個(gè)單擊之間間隔時(shí)間為0.1秒

# 長(zhǎng)按
d.long_click(x,y)
d.long_click(x,y,0.5) # 長(zhǎng)按0.5秒（默認(rèn)）

# 滑動(dòng)
d.swipe(sx, sy, ex, ey)
d.swipe(sx, sy, ex, ey, 0.5) #滑動(dòng)0.5s(default)

#拖動(dòng)
d.drag(sx, sy, ex, ey)
d.drag(sx, sy, ex, ey, 0.5)#拖動(dòng)0.5s(default)
# 滑動(dòng)點(diǎn) 多用于九宮格解鎖，提前獲取到每個(gè)點(diǎn)的相對(duì)坐標(biāo)（這里支持百分比）

# 從點(diǎn)(x0, y0)滑到點(diǎn)(x1, y1)再滑到點(diǎn)(x2, y2)
# 兩點(diǎn)之間的滑動(dòng)速度是0.2秒
d.swipe((x0, y0), (x1, y1), (x2, y2), 0.2)
# 注意：?jiǎn)螕?，滑?dòng)，拖動(dòng)操作支持百分比位置值。例：
d.long_click(0.5, 0.5) 表示長(zhǎng)按屏幕中心

# 檢索方向
d.orientation
# 檢索方向。輸出可以是 "natural" or "left" or "right" or "upsidedown"

# 設(shè)置方向
d.set_orientation("l") # or "left"
d.set_orientation("r") # or "right"
d.set_orientation("n") # or "natural"

#凍結(jié)/ 開(kāi)啟旋轉(zhuǎn)
d.freeze_rotation() # 凍結(jié)旋轉(zhuǎn)
d.freeze_rotation(False) # 開(kāi)啟旋轉(zhuǎn)

########## 截圖 ############
# 截圖并保存到電腦上的一個(gè)文件中，需要Android>=4.2。
d.screenshot("home.jpg")
 
# 得到PIL.Image格式的圖像. 但你必須先安裝pillow
image = d.screenshot() # default format="pillow"
image.save("home.jpg") # 或'home.png'，目前只支持png 和 jpg格式的圖像
 
# 得到OpenCV的格式圖像。當(dāng)然，你需要numpy和cv2安裝第一個(gè)
import cv2
image = d.screenshot(format='opencv')
cv2.imwrite('home.jpg', image)
 
# 獲取原始JPEG數(shù)據(jù)
imagebin = d.screenshot(format='raw')
open("some.jpg", "wb").write(imagebin)

#############################

# 轉(zhuǎn)儲(chǔ)UI層次結(jié)構(gòu)
# get the UI hierarchy dump content (unicoded).（獲取UI層次結(jié)構(gòu)轉(zhuǎn)儲(chǔ)內(nèi)容）
d.dump_hierarchy()


# 打開(kāi)通知或快速設(shè)置
d.open_notification() #下拉打開(kāi)通知欄
d.open_quick_settings() #下拉打開(kāi)快速設(shè)置欄

# 檢查特定的UI對(duì)象是否存在
d(text="Settings").exists # 返回布爾值，如果存在則為T(mén)rue，否則為False
d.exists(text="Settings") # 另一種寫(xiě)法
# 高級(jí)用法
d(text="Settings").exists(timeout=3) # 等待'Settings'在3秒鐘出現(xiàn)

# 獲取特定UI對(duì)象的信息
d(text="Settings").info

# 獲取/設(shè)置/清除可編輯字段的文本(例如EditText小部件)
d(text="Settings").get_text() #得到文本小部件
d(text="Settings").set_text("My text...") #設(shè)置文本
d(text="Settings").clear_text() #清除文本

# 獲取Widget中心點(diǎn)
d(text="Settings").center()
#d(text="Settings").center(offset=(0, 0)) # 基準(zhǔn)位置左前

# text、resourceId、description、className、xpath、坐標(biāo)

# 執(zhí)行單擊UI對(duì)象
#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="設(shè)置").click()
d(description="設(shè)置", className="android.widget.TextView").click()

#className定位單擊
d(className="android.widget.TextView").click()

#xpath定位單擊
d.xpath("http://android.widget.FrameLayout[@index='0']/android.widget.LinearLayout[@index='0']").click()

#坐標(biāo)單擊
d.click(182, 1264)

# 等待元素出現(xiàn)(最多10秒），出現(xiàn)后單擊 
d(text="Settings").click(timeout=10)
# 在10秒時(shí)點(diǎn)擊，默認(rèn)的超時(shí)0
d(text='Skip').click_exists(timeout=10.0)
# 單擊直到元素消失，返回布爾
d(text="Skip").click_gone(maxretry=10, interval=1.0) # maxretry默認(rèn)值10,interval默認(rèn)值1.0
# 點(diǎn)擊基準(zhǔn)位置偏移
d(text="Settings").click(offset=(0.5, 0.5)) # 點(diǎn)擊中心位置，同d(text="Settings").click()
d(text="Settings").click(offset=(0, 0)) # 點(diǎn)擊左前位置
d(text="Settings").click(offset=(1, 1)) # 點(diǎn)擊右下

# 執(zhí)行雙擊UI對(duì)象
d(text="設(shè)置").double_click() # 雙擊特定ui對(duì)象的中心
d.double_click(x, y, 0.1) # 兩次單擊之間的默認(rèn)持續(xù)時(shí)間為0.1秒

#執(zhí)行長(zhǎng)按UI對(duì)象
# 長(zhǎng)按特定UI對(duì)象的中心
d(text="Settings").long_click()
d.long_click(x, y, 0.5) # 長(zhǎng)按坐標(biāo)位置0.5s默認(rèn)

# 將UI對(duì)象拖向另一個(gè)點(diǎn)或另一個(gè)UI對(duì)象
# Android4.3不能使用drag.
# 在0.5秒內(nèi)將UI對(duì)象拖到屏幕點(diǎn)(x, y)
d(text="Settings").drag_to(x, y, duration=0.5)

# 將UI對(duì)象拖到另一個(gè)UI對(duì)象的中心位置，時(shí)間為0.25秒
d(text="Settings").drag_to(text="Clock", duration=0.25)

# 等待10s
d.xpath("http://android.widget.TextView").wait(10.0)

# 找到并單擊
d.xpath("http://*[@content-desc='分享']").click()

# 檢查是否存在
if d.xpath("http://android.widget.TextView[contains(@text, 'Se')]").exists:
 print("exists")
 
# 獲取所有文本視圖文本、屬性和中心點(diǎn)
for elem in d.xpath("http://android.widget.TextView").all():
 print("Text:", elem.text)
 
#獲取視圖文本
for elem in d.xpath("http://android.widget.TextView").all():
 print("Attrib:", elem.attrib)
 
#獲取屬性和中心點(diǎn)
#返回: (100, 200)
for elem in d.xpath("http://android.widget.TextView").all():
 print("Position:", elem.center())

# xpath常見(jiàn)用法：
# 所有元素
//*

# resource-id包含login字符
//*[contains(@resource-id, 'login')]

# 按鈕包含賬號(hào)或帳號(hào)
//android.widget.Button[contains(@text, '賬號(hào)') or contains(@text, '帳號(hào)')]

# 所有ImageView中的第二個(gè)
(//android.widget.ImageView)[2]

# 所有ImageView中的最后一個(gè)
(//android.widget.ImageView)[last()]

# className包含ImageView
//*[contains(name(), "ImageView")]