技术分享 | app 自动化测试（Android）-- 触屏操作自动化

作者：霍格沃兹测试开发学社

2022 年 9 月 27 日
北京
本文字数：2367 字
阅读完需：约 8 分钟

导入 TouchActionPython 版本 from appium.webdriver.common.touch_action import TouchAction

Java 版本 import io.appium.java_client.TouchAction;

常用的手势操作 press 按下 TouchAction 提供的常用的手势操作有如下操作：

press 按下

release 释放

move_to/moveTo 移动

tap 点击

long_press/longPress 长按

wait 等待

cancel 取消

perform 执行

TouchAction 提供的 press( ) 方法可以实现对元素或者坐标的按下操作。通常会结合 release( ) 方法实现对某个元素的点击（包括按下和抬起两个动作）。

在某个控件上执行 press 操作，用法如下：

Python 版本按下某个元素，用法如下：

press(WebElement el)

在坐标为（x,y）的点执行 press 操作，用法如下：

press(int x, int y)

Java 版本在坐标为（x,y）的点执行 press 操作，用法如下：

press(int x, int y)

release 释放释放操作，可以结合其它的事件使用。代表该系列动作的一个结束标志。在某个控件上执行释放操作，用法如下：

Python 版本 release(WebElement el)

也可以在上一个操作结束之后执行 release，不添加任何参数，用法如下：

release()

Java 版本 release()

移动以控件为目标，从一个点移动到该目标上，用法如下：

Python 版本 move_to(WebElement el)

以（x,y）点为目标，从一个点移动到该目标，用法如下：

move_to(WebElement el, int x, int y)

Java 版本以（x,y）点为目标，从一个点移动到该目标，用法如下：

moveTo(WebElement el, int x, int y)

tap 点击在某个控件的中心点上点击一下，用法如下：

Python 版本 tap(WebElement el)

以控件 el 的左上角为基准，沿着 x 轴向右移动 x 单位，沿着 y 轴向下移动 y 单位。在该点上点击，用法如下：

tap(WebElement el, int x, int y)

以（x,y）坐标点为目标点击，用法如下：

tap(int x, int y)

Java 版本只提供坐标点击，用法如下：

tap(int x, int y)

长按长按某一控件，用法如下：

Python 版本 long_press(WebElement el)

以（x,y）点为目标实现长按，用法如下：

long_press(int x, int y)

在控件的左上角的 x 坐标偏移 x 单位，y 左边偏移 y 单位的坐标上长按。用法如下：

long_press(WebElement el, int x, int y)

Java 版本只提供坐标点击，用法如下：

longPress(int x, int y)

等待等待，单位为毫秒。可以在操作事件的过程中，短暂的停留几秒再继续操作。用法如下：

Python 版本 wait(long timeout)

Java 版本 wait(long timeout)

cancel 取消可以取消执行事件链中的事件，用法如下：

Python 版本 cancel()

Java 版本 cancel()

执行 perform 执行事件链中的事件，一般最后会调用这个方法，顺序执行事件链中的动作。用法如下：

Python 版本 perform()

Java 版本 perform()

案例打开测试应用，从元素 “Views” 文本滑动到 “Accessibility” 元素，创建一个测试文件代码如下：

测试 app 官方下载地址：https://github.com/appium/appium/tree/master/sample-code/apps

#!/usr/bin/env python

-- coding: utf-8 --

测试文件 test_touchaction.py

from appium import webdriverfrom appium.webdriver.common.touch_action import TouchAction

class TestTouchAction():def setup(self):caps = {}caps['platformName'] = 'Android'caps['platformVersion'] = '6.0'caps['deviceName'] = 'emulator-5554'caps['appPackage'] = 'io.appium.android.apis'caps['appActivity'] = 'io.appium.android.apis.ApiDemos'self.driver = webdriver.Remote(

"http://127.0.0.1:4723/wd/hub", caps)self.driver.implicitly_wait(5)

def teardown(self):    self.driver.quit()
def test_touchaction_unlock(self):    # 点击 Views    el1 = self.driver.find_element_by_accessibility_id(        "Views")    # 点击 Accessibility    el2 = self.driver.find_element_by_accessibility_id(        "Accessibility")    # TouchAction 滑动操作    action = TouchAction(self.driver)    action.press(el1).wait(100).move_to\    (el2).wait(100).release().perform()

复制代码

public class TouchActionTest {static AppiumDriver driver;

@BeforeAllpublic static void beforeAll() throws MalformedURLException {    DesiredCapabilities caps = new DesiredCapabilities();    caps.setCapability("deviceName", "emulator-5554");    caps.setCapability("platformName", "Android");    caps.setCapability("appPackage", "io.appium.android.apis");    caps.setCapability("appActivity", "io.appium.android.apis.\    ApiDemos");    URL appiumServer = new URL("http://127.0.0.1:4723/wd/hub");    driver = new AndroidDriver(appiumServer, caps);    driver.manage().timeouts().implicitlyWait(10, \    TimeUnit.SECONDS);}
@Testvoid test() {    // 创建 TouchAction 对象    TouchAction action = new TouchAction<>(driver);    // TouchAction 滑动操作    action.press(PointOption.point((int) (width * 0.5), \    (int) (height * 0.8))).waitAction(WaitOptions.\    waitOptions(Duration.ofSeconds(2))).moveTo(\    PointOption.point((int) (width * 0.5), \    (int) (height * 0.2))).release().perform();}

复制代码

}

以上两段代码实现了相同的操作，创建了一个 TouchAction 对象，调用里面的 press() 方法实现起点元素的点击，使用 wait() 方法在事件之间添加等待，使用 move_to()/moveTo() 方法完成手势的移动操作，然后调用 release() 方法来完成手势的抬起，最后调用 perform() 方法对添加到 TouchAction 中的事件链顺序执行。