Appium-TouchAction类与MultiAction类（控件元素的滑动、拖动，九宫格解锁，手势操作等）

文章转自：https://www.cnblogs.com/lfr0123/p/13679568.html

swipe一般用于对页面进行上下左右滑动操作，但自动化过程中还会遇到其他情况，如对控件元素进行滑动、拖拽操作，九宫格解锁，手势操作，地图的放大与缩小等。这些需要针对控件元素的滑动操作，或者点至点、元素至元素之间的滑动操作，使用swipe方法显然不是很方便，这时候就可以用到appium里提供TouchAction类和MultiAction类。

一，TouchAction类

1，TouchAction类由webdriver库提供，提供以下方法：

• tap(self, element=None, x=None, y=None, count=1)，点击，点击元素el或坐标点(x, y) 1次

• press(self, el=None, x=None, y=None, pressure=None)，短按，按压元素el或坐标点(x, y)

• long_press(self, el=None, x=None, y=None, duration=1000)，长按，长按元素el或坐标点(x, y)，duration为按压时间，默认1000ms

• wait(self, ms=0)，暂停，时间默认为0

• move_to(self, el=None, x=None, y=None)，移动到，滑动至目标元素el位置或目标坐标点(x, y)

• release(self)，释放，将指针提离屏幕结束操作

• perform(self)，执行，将命令发送到要操作的服务器来执行该操作

注意，坐标x、y为int型，示例如下：

from appium import webdriver
# 需要导入模块TouchAction
from appium.webdriver.common.touch_action import TouchAction

desired_caps = {
    "platformName": "Android",
    "platformVersion": "10",
    "deviceName": "PCT_AL10",
    "appPackage": "com.ss.android.article.news",
    "appActivity": ".activity.MainActivity",
    "automationName": "uiautomator2",
    "unicodeKeyboard": True,
    "resetKeyboard": True,
    "noReset": False,
}
# 启动app
driver = webdriver.Remote('http://127.0.0.1:4723/wd/hub', desired_caps)

# 构造TouchAction实例对象
action = TouchAction(driver)
按住点(x1, y1)，等待1000ms，滑动至点(x2, y2)，释放
action.press(x=x1, y=y1).wait(1000).move_to(x=x2, y=y2).release()
# 执行操作
action.perform()

2，tap点击

# 点击元素的中心点
tap(element=ele1)
# 点击坐标(x1, y1)
tap(x=x1, y=y1)
# 以元素ele1左上角的x坐标向右移动x2单位，y坐标向下移动y2单位，在点(x+x2, y+y2)上点击
tap(element=ele1, x=x2, y=y2)

3，press短按

# 按压元素
press(el=ele1)
# 按压坐标
press(x=x1, y=y1)
# 以元素ele1左上角的x坐标向右移动x2单位，y坐标向下移动y2单位，在点(x+x2, y+y2)上按压
press(el=ele1, x=x2, y=y2)

4，long_press长按

# 按压元素，默认1000ms
long_press(el=ele1)
# 按压坐标500ms
long_press(x=x1, y=y1, duration=500)
# 以元素ele1左上角的x坐标向右移动x2单位，y坐标向下移动y2单位，在点(x+x2, y+y2)上按压
long_press(el=ele1, x=x2, y=y2)

5，move_to移动至目标点

# 该方法需要与press()、long_press()结合使用

# 从另一个点移动至目标元素ele1
move_to(el=ele1)
# 从另一个点移动至点(x1, y1)
move_to(x=x1, y=y1)
# 从另一个点移动至点(x+x2, y+y2), (x, y)为元素ele1左上角的坐标
move_to(el=ele1, x=x2, y=y2)

6，wait等待

# 等待，如等待500ms
wait(500)

7，release释放

# 释放操作，与按压、长按结合使用
release()

8，perform执行

# 将动作命令发送至服务器来执行该动作，如：
action = TouchAction(driver).press(x=x1, y=y1).move_to(x=x2, y=y2).release()
执行滑动操作
action.perform()

二，多点触控MultiAction类

1，MultiAction类中提供以下方法：

• add(self, *touch_actions)，参数*touch_actions为触摸操作集合，将一个或多个触摸操作添加至当前的多点触控实例中

• perform(self)，执行多点触控操作

使用场景，如页面的放大、缩小等

2，示例

from appium import webdriver
from appium.webdriver.common.touch_action import TouchAction
# 需要导入模块MultiAction
from appium.webdriver.common.multi_action import MultiAction

desired_caps = {
    "platformName": "Android",
    "platformVersion": "10",
    "deviceName": "PCT_AL10",
    "appPackage": "com.ss.android.article.news",
    "appActivity": ".activity.MainActivity",
    "automationName": "uiautomator2",
    "unicodeKeyboard": True,
    "resetKeyboard": True,
    "noReset": False,
}
# 启动app
driver = webdriver.Remote('http://127.0.0.1:4723/wd/hub', desired_caps

# 创建两个触摸事件
action = TouchAction(driver)
action1 = action.press(ele1).move_to(ele2).release()
action2 = action.press(x=50, y=50).move_to(x=100, y=200).release()

# 创建MultiAction实例对象
multi_action = MultiAction(driver)
# 将触摸事件加入TouchAction对象
multi_action.add(action1, action2)

# 执行事件
multi_action.perform()

三，使用场景

1，TouchAction使用场景--控件元素滑动

• 今日头条顶部菜单栏向左滑动

  

  思路：长按"视频"元素滑动至"关注"元素位置，然后释放

# 关注按钮元素
concern_ele = driver.find_element_by_xpath("//*[@content-desc='关注']")
# 视频按钮元素
video_ele = driver.find_element_by_xpath("//*[@content-desc='视频']")

action = TouchAction(driver)
长按"视频"元素滑动至"关注"元素位置，然后释放
action.long_press(video_ele).move_to(concern_ele).release().perform()

• 还有下面这种形式，通过对滑动控件元素来选择时间：

  

  思路：通过向上滑动选择年月日。以日期选择控件为例，按压日期元素滑动至【确定】按钮即可滚动日期（由于元素属性的原因这里不能选择精确的日期）

# 日期元素
day_ele = driver.find_element_by_id("resource-id")
# 视频按钮元素
sure_ele = driver.find_element_by_xpath("//*[@text='确定']")

action = TouchAction(driver)
# 长按日期元素滑动至确定按钮元素位置，然后释放
action.long_press(day_ele).move_to(sure_ele).release().perform()

2，TouchAction使用场景--九宫格解锁

from appium.webdriver.common.touch_action import TouchAction

class NineSquUnlock(object):
    '''
    九宫格解锁，九宫格中每个点的坐标可以通过uiautomatorviewer获取，以下仅为示例
    '''
    def __init__(self, driver):
        self.driver = driver
        self.pwd = '1235789'   # 解锁密码
        self.unit_location = [
        (300, 300), (300, 600), (300, 900),
        (600, 200), (600, 600), (600, 900),
        (900, 200), (900, 600), (900, 900)
        ]

    def unlock(self):
        # 将密码转换为对应坐标点的索引，获取密码对应的坐标点
        pwd_loc = []
        for i in self.pwd:
            unit_index = self.unit_location[int(i)]
            pwd_loc.append(unit_index)

        action = TouchAction(self.driver)
        # 按压起点
        action.press(*pwd_loc[0]).wait(200)
        # 根据坐标点滑动
        for i in range(1, len(pwd_loc)):
            action.move_to(*pwd_loc[i]).wait(200)
        # 释放动作并执行
        action.release().perform()

if __name__ == '__main__':
    # 调试，构造的driver仅为示例
    from appium import webdriver
    driver = webdriver.Remote()
    NineSquUnlock(driver).unlock()