一、前言
在做App自動化測驗時，經常需要進行手勢操作，比如滑屏、放大、縮小等，這里就涉及到TouchAction & TouchActions兩個模塊，TouchAction和TouchActions主要用于App、webview的手勢操作，用法與PC端的ActionChains類似，
1、TouchAction、TouchActions區別
TouchAction是appium的輔助類，主要是一些手勢操作，TouchActions是Selenium的輔助類，在TouchAction的基礎上做了些功能補充，TouchAction和TouchActions只能用于單個手指的操作，MultiAction可以模擬多指操作，
二、TouchAction介紹
1、官方檔案
http://appium.io/docs/cn/writing-running-appium/touch-actions/
2、匯入TouchAction模塊
from appium.webdriver.common.touch_action import TouchAction
3、操作方法
1）tap()：點擊操作
對一個元素或控制元件執行點擊操作
方法：tap(element=None, x=None, y=None, count=1)
示例：
# 操作的元素物件
ele_str = driver.find_element(By.XPATH, "//span[text()='立即體驗']")
# 通過定位到的元素點擊
TouchAction(driver).tap(ele_str).release().perform()
# 通過元素坐標點擊
TouchAction(driver).tap(x=360, y=1320).release().perform()
# 以定位的元素左上角為原點，分別向下、向右偏移10個像素點
TouchAction(driver).tap(ele_str, 10, 10).release().perform()
2) press():按壓操作
按壓一個元素或坐標點（x,y），通過手指按壓手機螢屏的某個位置，
方法：press(el=None, x=None, y=None)
示例：
# 操作的元素物件
ele_str = driver.find_element(By.XPATH, "//span[text()='立即體驗']")
# 按壓定位到的元素
TouchAction(driver).press(ele_str).release().perform()
# 按壓元素坐標點
TouchAction(driver).press(x=360, y=1320).release().perform()
# 以元素的左上角為原點，分別向下、向右偏移10個像素點，然后按壓釋放
TouchAction(driver).press(ele_str, 10, 10).release().perform()
3) long_press():長按操作
長按一個元素或坐標點（x,y）， 相比press()方法，long_press()多了一個入參duration，duration指按壓持續時間，以毫秒為單位，1000表示按一秒鐘，必須是int型別，其用法與press()方法相同，
方法：long_press(el=None, x=None, y=None, duration=1000)
示例：
# 操作的元素物件
ele_str = driver.find_element(By.XPATH, "//span[text()='立即體驗']")
# 長按元素，持續5秒時間
TouchAction(driver).long_press(ele_str, duration=5000).release().perform()
# 長按坐標點，持續5秒時間
TouchAction(driver).long_press(x=360, y=1320, duration=5000).release().perform()
# 以元素的左上角為原點，分別向下、向右偏移10個像素點，長按5秒然后釋放
TouchAction(driver).long_press(ele_str, 10, 10, duration=5000).release().perform()
4）move_to():移動
將指標或游標從上一個點移動到指定的元素或坐標點，
方法：move_to(el=None, x=None, y=None)
示例：
# 操作的元素物件
ele_str = driver.find_element(By.XPATH, "//span[text()='立即體驗']")
# 在坐標(360,1320)處按下，滑動到坐標(700,1320)處，然后釋放手指
TouchAction(driver).press(x=360, y=1320).move_to(x=700, y=1320).release().perform()
# 在元素ele_str所在位置處按下，滑動至元素ele_end處，然后釋放手指
TouchAction(driver).press(ele_str).move_to(ele_end).release().perform()
5）wait():等待
執行手勢動作時，等待一段時間，wait(int ms)，單位是毫秒，1s = 1000ms
示例：
# 在坐標(360,1320)處按下后等待2秒，然后滑動至坐標(700,1320)處
TouchAction(self.driver).press(x=360, y=1320).wait(2000).move_to(x=700, y=1320).release().perform()
6）release():釋放
釋放螢屏上的指標操作，與按下和長按聯合使用，
7) perform():執行
發送需要執行的動作指令集至服務器，
8)連續滑屏
App自動化測驗時有時需要滑動多個點，可以使用多個move_to()組合，
示例：
TouchAction(driver).press(x=10, y=10).wait(2000) \
.move_to(x=20, y=20).wait(1000) \
.move_to(x=30, y=30).wait(1000) \
.release().perform()
三、TouchActions介紹
1、說明檔案
TouchActions官方檔案：
https://www.selenium.dev/selenium/docs/api/py/webdriver/selenium.webdriver.common.touch_actions.html
TouchActions中文版檔案：
https://liushilive.github.io/github_selenium_docs_api_py/md/selenium/webdriver/common/touch_actions.html
2、匯入TouchActions模塊
from selenium.webdriver.common.touch_actions import TouchActions
3、操作方法
1) tap(on_element):單擊
點擊給定的元素，
引數on_element: 要點按的元素
2) double_tap(on_element):雙擊
雙擊特定元素，
引數on_element: 要點按的元素，
3) tap_and_hold(xcoord, ycoord)
在給定坐標處按下并保持，
引數：
xcoord: X 軸坐標
ycoord: Y 軸坐標
4) move(xcoord, ycoord)
按壓住某點移動至指定位置，
引數：
xcoord: X 軸坐標
ycoord: Y 軸坐標
5) scroll(xoffset, yoffset)
觸摸并滾動，向 xoffset 和 yoffset 移動，
引數：
xoffset: X 軸偏移量
yoffset: Y 軸偏移量
6) scroll_from_element(on_element, xoffset, yoffset)
觸摸并滾動從 on_element 開始，向 xoffset 和 yoffset 移動，
引數：
on_element: 滾動開始的元素
xoffset: X 軸偏移量
yoffset: Y 軸偏移量
7) long_press(on_element)
長按一個元素，
引數：
on_element: 長按的元素
8) flick(xspeed, yspeed)
從螢屏上的任意位置開始輕彈，
引數：
xspeed: X 軸速度，以每秒像素為單位，
yspeed: Y 軸速度，以每秒像素為單位，
9) flick_element(on_element, xoffset, yoffset, speed)
從 on_element 開始輕彈，然后以指定的速度移動 xoffset 和 yoffset，
引數：
on_element: Flick 將從元素的中心開始，
xoffset: X 軸偏移量
yoffset: Y 軸偏移量
speed: 每秒偏移的像素
10)release(xcoord, ycoord)
在指定位置釋放先前發出的 tap 和 hold 命令，
引數：
xcoord: X 軸坐標
ycoord: Y 軸坐標
11)perform()
發送需要執行的動作指令集至服務器，
4、Tips
TouchActions我還沒找到使用場景，后面遇到了再補上使用示例，
TouchAction和TouchActions方法中用到的坐標可以通過下面的方法獲取：
1）獲取螢屏大小
print("獲取螢屏大小：", driver.get_window_size())
執行結果：獲取螢屏大小： {'width': 720, 'height': 1491}
2）獲取元素大小
# 操作的元素物件
ele_str = driver.find_element(By.XPATH, "//span[text()='立即體驗']")
print("location獲取元素坐標：", ele_str.location)
print("location獲取元素坐標X值：", ele_str.location["x"])
print("size獲取元素大小：", ele_str.size)
print("size獲取元素的長度：", ele_str.size['width'])
print("rect獲取元素坐標和大小：", ele_str.rect)
執行結果：
location獲取元素坐標： {'x': 260, 'y': 1290}
location獲取元素坐標X值： 260
size獲取元素大小： {'height': 60, 'width': 200}
size獲取元素的長度： 200
rect獲取元素坐標和大小： {'height': 60, 'width': 200, 'x': 260, 'y': 1290}
3）手機App坐標與Webview頁面坐標
在做UI自動化測驗用到TouchAction和TouchActions時，有的需要獲取元素的坐標，然后對坐標進行press、tap等操作，在進行手機App測驗時，webview頁面獲取的坐標會有區別，
如上圖，title部分是APP原生的，下面部分是webview環境，在獲取webview部分的“看看關注”按鈕的坐標時，是以webview環境的左上角為原點計算的，這樣獲取的坐標與螢屏的像素坐標點不一致，在使用TouchAction對“看看關注”坐標進行操作時，會得不到預期結果，
只有Android、ios原生的App環境獲取的坐標可以使用TouchAction操作，
4）偏移量
TouchActions有的操作方法中是使用xoffset、yoffset偏移量來操作的，這個偏移量是以操作的元素中心為原點的，
轉載請註明出處，本文鏈接：https://www.uj5u.com/qita/301179.html
標籤：其他