滑动交互方法

大家好，今天我们来学习一下在 APP 测试中如何进行滑动操作。滑动是移动端应用中非常常见的交互方式，比如我们在浏览新闻、查看图片或者切换页面时，经常会用到滑动操作。在自动化测试中，模拟滑动操作是非常重要的，因为它可以帮助我们验证 APP 的滑动功能是否正常。接下来，我们会介绍几种常见的滑动方法，并通过代码示例来演示如何实现这些操作。

---

简介

在移动端应用中，基于简便的原因，用户通常会倾向于使用滑动操作来达到与应用程序中的控件进行交互的，这使得滑动成为自动化测试中频繁使用的关键动作。在 Appium 中提供了多种方式来实现模拟用户的滑动屏幕动作。

在移动端应用中，滑动操作是非常常见的交互方式。用户通过滑动屏幕来浏览内容、切换页面或者操作控件。因此，在自动化测试中，模拟滑动操作是一个非常重要的技能。Appium 提供了多种方式来实现滑动操作，比如通过坐标滑动、从一个元素滑动到另一个元素等。这些方法可以帮助我们模拟用户的滑动行为，从而验证 APP 的功能是否正常。

---

滑动操作的场景

移动端应用中的滑动场景，大致有如下几种类型：

1. 触摸事件模拟：滑动操作的基本原理是模拟用户触摸屏幕的行为。通过发送一系列的触摸事件，模拟用户按住、滑动和释放的动作，可以实现在屏幕上滑动的效果。

2. 坐标计算：滑动操作通常涉及到起始点和终点的坐标计算，起始点表示滑动的起始位置，终点表示滑动的结束位置。这些坐标可以是相对于屏幕或特定元素的坐标。

3. 惯性滑动：有些滑动操作在用户释放手指后还会继续滑动一段距离，模拟惯性滑动的效果，这通常需要在滑动过程中模拟逐渐减速的过程。

在移动端应用中，滑动操作的应用场景非常广泛。比如，我们在浏览新闻时，可以通过上下滑动来查看更多内容；在查看图片时，可以通过左右滑动来切换图片；在设置页面中，可以通过滑动来调整音量或亮度。滑动的实现原理主要是通过模拟用户的触摸事件，比如按住屏幕、滑动和释放。此外，滑动操作还涉及到坐标的计算，比如起始点和终点的坐标。有些滑动操作还带有惯性效果，比如在用户释放手指后，页面会继续滑动一段距离。这些场景都需要我们在自动化测试中进行模拟。

---

滑动的方式

接下来，我们来看几种常见的滑动方式。Appium 提供了多种滑动方法，比如 swipe 和 scroll。swipe 方法是通过指定起始点和终点的坐标来实现滑动，而 scroll 方法则是通过指定起始元素和结束元素来实现滑动。这两种方法都非常实用，可以根据具体的测试需求选择合适的方式。

---

swipe 方法

从一个点滑动到另一个点，可选择持续时间，具有滑动的惯性。需要的参数如下：

使用 appium 官方 Demo apk 进行练习，apk 网盘地址。

• start_x：开始坐标 x。
• start_y：开始坐标 y。
• end_x：结束坐标 x。
• end_y：结束坐标 y。
• duration（可选）：滑动持续的时间，默认为 0。

swipe 方法是通过指定起始点和终点的坐标来实现滑动的。我们可以通过设置起始点的 x 和 y 坐标，以及终点的 x 和 y 坐标来控制滑动的方向和距离。此外，我们还可以设置滑动的持续时间，来控制滑动的速度。比如，如果我们想模拟一个快速的滑动操作，可以将持续时间设置得较短；如果想模拟一个缓慢的滑动操作，可以将持续时间设置得较长。这个方法非常适合用于模拟用户在屏幕上滑动的操作。

---

Python 代码示例

from appium import webdriver
from appium.options.android import UiAutomator2Options
from appium.webdriver.common.appiumby import AppiumBy

class TestSwipe:

    def setup_class(self):
        '''
        完成 capability 设置
        初始化 driver
        :return:
        '''
        # 设置 cpability
        caps = {
            # 设置 app 安装的平台（Android，iOS）
            "platformName": "Android",
            # 设置 appium 驱动
            "appium:automationName": "uiautomator2",
            # 设置设备名称
            "appium:deviceName": "emulator-5554",
            # 设置被测 app 的包名
            "appium:appPackage": "io.appium.android.apis",
            # 设置被测 app 启动页面的 Activity
            "appium:appActivity": ".ApiDemos"
        }

        # 初始化 driver
        self.driver = webdriver.Remote(
            "http://127.0.0.1:4723",
            options=UiAutomator2Options().load_capabilities(caps)
        )
        # 设置全局隐式等待
        self.driver.implicitly_wait(5)

    def teardown_class(self):
        '''
        关闭 driver
        :return:
        '''
        self.driver.quit()

    def test_swipe_views(self):
        # 从一个点滑动到另一个点，可选择持续时间
        '''
        start_x: 开始坐标 x
        start_y: 开始坐标 y
        end_x: 结束坐标 x
        end_y: 结束坐标 y
        duration: 持续时间
        '''
        # 点击进入 Views 界面
        self.driver.find_element(AppiumBy.ACCESSIBILITY_ID, 'Views').click()
        # 获取窗口的宽和高
        size = self.driver.get_window_size()
        height = size.get('height')
        weight = size.get('width')
        # 执行滑动操作
        self.driver.swipe(
            start_x=weight * 0.5,
            start_y=height * 0.8,
            end_x=weight * 0.5,
            end_y=height * 0.2,
            duration=2000
        )
        # 查找 Picker 元素
        ele = self.driver.find_element(AppiumBy.ACCESSIBILITY_ID, 'Picker')
        # 断言滑动成功 找到元素
        assert ele.text == 'Picker'

我们来看一个 Python 的代码示例。这段代码展示了如何使用 swipe 方法来实现滑动操作。首先，我们初始化了 Appium 的 driver，然后通过 find_element 方法定位到 Views 界面。接着，我们获取了屏幕的宽度和高度，并通过 swipe 方法从屏幕的底部滑动到顶部。最后，我们通过断言来验证滑动操作是否成功。这段代码非常直观，展示了如何通过代码实现滑动操作。

---

Java 代码示例

// Java 中没有提供对应的便捷方法，需要使用自定义的方法来实现对应操作
package org.example;

import io.appium.java_client.android.AndroidDriver;
import io.appium.java_client.AppiumBy;
import io.appium.java_client.remote.MobileCapabilityType;
import org.junit.jupiter.api.AfterAll;
import org.junit.jupiter.api.BeforeAll;
import org.junit.jupiter.api.Test;
import org.openqa.selenium.Dimension;
import org.openqa.selenium.WebElement;
import org.openqa.selenium.interactions.PointerInput;
import org.openqa.selenium.interactions.Sequence;
import org.openqa.selenium.remote.DesiredCapabilities;

import java.net.MalformedURLException;
import java.net.URL;
import java.time.Duration;
import java.util.Collections;

import static org.junit.jupiter.api.Assertions.assertEquals;

public class TestSwipe {

    private static AndroidDriver driver;

    @BeforeAll
    public static void setUpClass() throws MalformedURLException {
        // 初始化capability
        DesiredCapabilities caps = new DesiredCapabilities();
        // 设置 app 安装的平台（Android、iOS）
        caps.setCapability(MobileCapabilityType.PLATFORM_NAME, "Android");
        // 设置 appium 驱动
        caps.setCapability(MobileCapabilityType.AUTOMATION_NAME, "UiAutomator2");
        // 设置设备名称
        caps.setCapability(MobileCapabilityType.DEVICE_NAME, "emulator-5554");
        // 设置 app 的包名
        caps.setCapability("appPackage", "io.appium.android.apis");
        // 设置 app 的启动页
        caps.setCapability("appActivity", ".ApiDemos");
        // 设置 app 不清空缓存
        caps.setCapability("appium:noReset", true);
        // 设置 app 不重启
        caps.setCapability("appium:shouldTerminateApp", true);

        // 设置启动url
        URL remoteUrl = new URL("http://127.0.0.1:4723");
        // 初始化driver
        driver = new AndroidDriver(remoteUrl, caps);
    }

    @AfterAll
    public static void teardownClass() {
        if (driver != null) {
            driver.quit();
        }
    }

    @Test
    public void testSwipeViews() {
        // 点击进入 Views 界面
        driver.findElement(AppiumBy.accessibilityId("Views")).click();

        // 获取窗口的宽和高
        Dimension size = driver.manage().window().getSize();
        int height = size.getHeight();
        int width = size.getWidth();

        // 执行滑动操作
        int startX = (int) (width * 0.5);
        int startY = (int) (height * 0.8);
        int endX = (int) (width * 0.5);
        int endY = (int) (height * 0.2);

        swipe(startX, startY, endX, endY, Duration.ofSeconds(2));

        // 查找 Picker 元素
        WebElement ele = driver.findElement(AppiumBy.accessibilityId("Picker"));

        // 断言滑动成功 找到元素
        assertEquals("Picker", ele.getText());
    }

    public void swipe(int startX, int startY, int endX, int endY, Duration duration) {
        PointerInput finger = new PointerInput(PointerInput.Kind.TOUCH, "finger");
        Sequence swipe = new Sequence(finger, 1)
                .addAction(finger.createPointerMove(Duration.ofMillis(0), PointerInput.Origin.viewport(), startX, startY))
                .addAction(finger.createPointerDown(PointerInput.MouseButton.LEFT.asArg()))
                .addAction(finger.createPointerMove(duration, PointerInput.Origin.viewport(), endX, endY))
                .addAction(finger.createPointerUp(PointerInput.MouseButton.LEFT.asArg()));
        driver.perform(Collections.singletonList(swipe));
    }
}

接下来是 Java 的代码示例。由于 Java 中没有直接提供 swipe 方法，我们需要通过自定义方法来实现滑动操作。这段代码首先初始化了 AndroidDriver，然后通过 findElement 方法定位到 Views 界面。接着，我们获取了屏幕的宽度和高度，并通过自定义的 swipe 方法从屏幕的底部滑动到顶部。最后，我们通过断言来验证滑动操作是否成功。这段代码展示了如何在 Java 中实现滑动操作。

---

scroll 方法

从一个元素滑动到另一个元素，具有滑动的惯性。需要的参数如下：

使用 appium 官方 Demo apk 进行练习，apk 网盘地址。

• origin_el：滑动的起始元素。
• destination_el：滑动的结束元素。

scroll 方法是通过指定起始元素和结束元素来实现滑动的。我们可以通过定位到两个元素，然后从起始元素滑动到结束元素。这个方法非常适合用于模拟用户在列表中滑动的操作。比如，我们可以从一个列表项滑动到另一个列表项，从而查看更多内容。

---

Python 代码示例

from appium import webdriver
from appium.options.android import UiAutomator2Options
from appium.webdriver.common.appiumby import AppiumBy

class TestSwipe:

    def setup_class(self):
        '''
        完成 capability 设置
        初始化 driver
        :return:
        '''
        # 设置 cpability
        caps = {
            # 设置 app 安装的平台（Android，iOS）
            "platformName": "Android",
            # 设置 appium 驱动
            "appium:automationName": "uiautomator2",
            # 设置设备名称
            "appium:deviceName": "emulator-5554",
            # 设置被测 app 的包名
            "appium:appPackage": "io.appium.android.apis",
            # 设置被测 app 启动页面的 Activity
            "appium:appActivity": ".ApiDemos"
        }

        # 初始化 driver
        self.driver = webdriver.Remote(
            "http://127.0.0.1:4723",
            options=UiAutomator2Options().load_capabilities(caps)
        )
        # 设置全局隐式等待
        self.driver.implicitly_wait(5)

    def teardown_class(self):
        '''
        关闭 driver
        :return:
        '''
        self.driver.quit()

    def test_scroll_ele(self):
        '''
        从一个元素滑动到另一个元素
        '''
        # 点击进入 Views 界面
        self.driver.find_element(
            AppiumBy.ACCESSIBILITY_ID, 'Views'
        ).click()
        # 滑动起始元素
        image_btn = self.driver.find_element(
            AppiumBy.ACCESSIBILITY_ID, 'ImageButton'
        )
        # 滑动结束元素
        button = self.driver.find_element(
            AppiumBy.ACCESSIBILITY_ID, 'Buttons'
        )
        # 执行滑动操作
        self.driver.scroll(image_btn, button, duration=2000)
        # 查找 Picker 元素
        ele = self.driver.find_element(
            AppiumBy.ACCESSIBILITY_ID, 'Picker'
        )
        assert ele.text == 'Picker'

我们来看一个 Python 的代码示例。这段代码展示了如何使用 scroll 方法来实现滑动操作。首先，我们初始化了 Appium 的 driver，然后通过 find_element 方法定位到 Views 界面。接着，我们定位到起始元素和结束元素，并通过 scroll 方法从起始元素滑动到结束元素。最后，我们通过断言来验证滑动操作是否成功。这段代码非常直观，展示了如何通过代码实现滑动操作。

---

Java 代码示例

// Java 中没有提供对应的便捷方法，需要使用自定义的方法来实现对应操作
package org.example;

import io.appium.java_client.AppiumBy;
import io.appium.java_client.android.AndroidDriver;
import io.appium.java_client.remote.MobileCapabilityType;
import org.junit.jupiter.api.AfterAll;
import org.junit.jupiter.api.BeforeAll;
import org.junit.jupiter.api.Test;
import org.openqa.selenium.WebElement;
import org.openqa.selenium.interactions.PointerInput;
import org.openqa.selenium.interactions.Sequence;
import org.openqa.selenium.remote.DesiredCapabilities;

import java.net.MalformedURLException;
import java.net.URL;
import java.time.Duration;
import java.util.Collections;

import static org.junit.jupiter.api.Assertions.assertEquals;

public class TestSwipe {

    private static AndroidDriver driver;

    @BeforeAll
    public static void setUpClass() throws MalformedURLException {
        // 初始化capability
        DesiredCapabilities caps = new DesiredCapabilities();
        // 设置 app 安装的平台（Android、iOS）
        caps.setCapability(MobileCapabilityType.PLATFORM_NAME, "Android");
        // 设置 appium 驱动
        caps.setCapability(MobileCapabilityType.AUTOMATION_NAME, "UiAutomator2");
        // 设置设备名称
        caps.setCapability(MobileCapabilityType.DEVICE_NAME, "emulator-5554");
        // 设置 app 的包名
        caps.setCapability("appPackage", "io.appium.android.apis");
        // 设置 app 的启动页
        caps.setCapability("appActivity", ".ApiDemos");

        // 设置启动url
        URL remoteUrl = new URL("http://127.0.0.1:4723");
        // 初始化driver
        driver = new AndroidDriver(remoteUrl, caps);
        // 设置全局隐式等待时间
        driver.manage().timeouts().implicitlyWait(Duration.ofSeconds(5));
    }

    @AfterAll
    public static void teardownClass() {
        if (driver != null) {
            // 关闭 driver
            driver.quit();
        }
    }

    @Test
    public void testScrollEle() {
        // 点击进入 Views 界面
        driver.findElement(AppiumBy.accessibilityId("Views")).click();
        // 滑动起始元素
        WebElement imageBtn = driver.findElement(AppiumBy.accessibilityId("ImageButton"));
        // 滑动结束元素
        WebElement button = driver.findElement(AppiumBy.accessibilityId("Buttons"));
        // 执行滑动操作
        scroll(imageBtn, button, Duration.ofSeconds(2));
        // 查找 Picker 元素
        WebElement ele = driver.findElement(AppiumBy.accessibilityId("Picker"));
        // 断言滑动成功 找到元素
        assertEquals("Picker", ele.getText());
    }

    public void scroll(WebElement startElement, WebElement endElement, Duration duration) {
        int startX = startElement.getLocation().getX() + startElement.getSize().getWidth() / 2;
        int startY = startElement.getLocation().getY() + startElement.getSize().getHeight() / 2;
        int endX = endElement.getLocation().getX() + endElement.getSize().getWidth() / 2;
        int endY = endElement.getLocation().getY() + endElement.getSize().getHeight() / 2;

        PointerInput finger = new PointerInput(PointerInput.Kind.TOUCH, "finger");
        Sequence swipe = new Sequence(finger, 1)
                .addAction(finger.createPointerMove(Duration.ZERO, PointerInput.Origin.viewport(), startX, startY))
                .addAction(finger.createPointerDown(PointerInput.MouseButton.LEFT.asArg()))
                .addAction(finger.createPointerMove(duration, PointerInput.Origin.viewport(), endX, endY))
                .addAction(finger.createPointerUp(PointerInput.MouseButton.LEFT.asArg()));

        driver.perform(Collections.singletonList(swipe));
    }
}

接下来是 Java 的代码示例。由于 Java 中没有直接提供 scroll 方法，我们需要通过自定义方法来实现滑动操作。这段代码首先初始化了 AndroidDriver，然后通过 findElement 方法定位到 Views 界面。接着，我们定位到起始元素和结束元素，并通过自定义的 scroll 方法从起始元素滑动到结束元素。最后，我们通过断言来验证滑动操作是否成功。这段代码展示了如何在 Java 中实现滑动操作。

---

总结

• 滑动操作的场景
• 使用 swipe 方法滑动
• 使用 scroll 方法滑动

今天我们学习了滑动操作的几种常见方法，包括 swipe 和 scroll。swipe 方法通过指定起始点和终点的坐标来实现滑动，而 scroll 方法通过指定起始元素和结束元素来实现滑动。这些方法都非常实用，可以帮助我们模拟用户的滑动行为，从而验证 APP 的功能是否正常。希望大家通过今天的课程，能够熟练使用这些方法，并在实际项目中应用它们。