news 2026/4/16 20:54:56

Python+Appium自动化测试(10)-TouchAction类与MultiAction类(控件元素的滑动、拖动,九宫格解锁,手势操作等)

作者头像

张小明

前端开发工程师

1.2k 24
文章封面图
Python+Appium自动化测试(10)-TouchAction类与MultiAction类(控件元素的滑动、拖动,九宫格解锁,手势操作等)

滑动屏幕方法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型,示例如下:

ss="language-python"># @author: 给你一页白纸 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,示例

ss="language-python"># @author: 给你一页白纸 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使用场景–九宫格解锁

# @author: 给你一页白纸 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()

3,MultiAction使用场景
app中地图的放大、缩小;app中图片的放大、缩小。

如下图中A、B、C、D四个坐标点,1所示滑动操作则放大图片,2所示滑动操作则缩小照片。

代码参考第二步中示例。

最后作为一位过来人也是希望大家少走一些弯路,在这里我给大家分享一些软件测试的学习资料和我花了3个月整理的软件测试自学全栈,这些资料希望能给你前进的路上带来帮助。

视频文档获取方式:
这份文档和视频资料,对于想从事【软件测试】的朋友来说应该是最全面最完整的备战仓库,这个仓库也陪伴我走过了最艰难的路程,希望也能帮助到你!以上均可以分享,点下方小卡片即可自行领取。

版权声明: 本文来自互联网用户投稿,该文观点仅代表作者本人,不代表本站立场。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。如若内容造成侵权/违法违规/事实不符,请联系邮箱:809451989@qq.com进行投诉反馈,一经查实,立即删除!
网站建设 2026/4/16 9:23:29

AI自动剪辑:打造完美预告片

一、 核心概念与技术基础视频素材预处理文件解析与解码: 使用库(如FFmpeg, OpenCV)读取原始视频文件。镜头边界检测: 算法识别场景切换点(如基于帧间差异、色彩直方图变化)。关键帧提取&#xf…

作者头像 李华
网站建设 2026/4/16 14:51:14

【dz-1005】基于单片机的压力锅设计

摘要 在现代家庭生活中,压力锅作为高效便捷的烹饪工具,其安全性与智能化水平备受关注。传统压力锅多依赖手动操作,存在温度和压力控制精度不足、模式单一、缺乏实时监测与远程控制等问题,难以满足用户对精准烹饪和便捷操作的需求…

作者头像 李华
网站建设 2026/4/16 9:21:43

PPIO上线Prompt Cache:让模型调用更快、更省、更稳

在大模型推理场景中,响应速度直接影响用户体验和系统性能。传统推理服务需要每次都重新计算相同的文本片段,导致不必要的计算开销和延迟,PPIO 推出的 Prompt Cache(提示词缓存)有效解决了这一问题。 PPIO的 Prompt Cac…

作者头像 李华
网站建设 2026/4/16 14:32:09

AI智能体系统三大核心协议全解析:MCP、A2A、AG-UI架构设计指南!

简介 本文详解AI智能体系统三大核心协议:MCP解决智能体与外部工具交互标准化;A2A实现智能体间通信协作;AG-UI规范前端与智能体交互。这些协议构成AI智能体应用基础设施,使智能体能操作环境、协作交互,推动从单一向多智…

作者头像 李华