WebdriverIO+Appium实现滚动并通过Accessibility ID定位元素求助

问题背景 #

我是自动化测试新手，正在使用WebdriverIO和Appium进行安卓原生APP自动化测试，需要实现以下操作：

• 垂直滚动至目标元素
• 通过Accessibility ID定位该元素
• 点击该元素

目标元素仅具备Accessibility ID，我不清楚如何通过该属性定位元素，现求助编写对应测试代码。

尝试过的代码 #

我使用UiScrollable类编写了如下代码，但该代码只会滚动至页面底部，无法定位到目标元素：

it('Scroll down to and click on wellness category', async () => {
    await $('android=new UiScrollable(new UiSelector().scrollable(true)).flingToEnd(1)');
    const wellness = await $('~wellness');
    await wellness.click();
    await driver.pause(1000);
});

配置参数 #

capabilities: [
{
"appium:platformName": "Android",
"appium:platformVersion": "11.0",
"appium:deviceName": "Pixel 4a API 30",
"appium:automationName": "UIAutomator2",
"appium:app": path.join(process.cwd(), "path to the apk"),
"appium:autoGrantPermissions": true
}
]

解决方案 #

方法1：使用UiScrollable直接滚动到目标元素 #

核心是利用UiScrollable的scrollIntoView方法，让滚动容器直接滚动到包含目标Accessibility ID的元素位置，而非盲目滚到底部：

it('Scroll to and click wellness category', async () => {
    // 通过UiAutomator2语法，滚动到Accessibility ID为"wellness"的元素
    const wellnessElement = await $('android=new UiScrollable(new UiSelector().scrollable(true)).scrollIntoView(new UiSelector().description("wellness"))');
    await wellnessElement.click();
    await driver.pause(1000);
});

方法2：循环滚动直到元素可见（通用方案） #

如果UiScrollable的写法不适用，也可以通过循环滚动+元素检查的方式实现，适配更多场景：

it('Scroll until wellness element is visible and click', async () => {
    let elementFound = false;
    // 设置最大滚动次数，避免无限循环
    const maxScrollAttempts = 5;

    for (let i = 0; i < maxScrollAttempts; i++) {
        try {
            // 用Accessibility ID定位元素，等待其显示
            const wellness = await $('~wellness');
            await wellness.waitForDisplayed({ timeout: 2000 });
            await wellness.click();
            elementFound = true;
            break;
        } catch (err) {
            // 执行向下滚动操作，坐标需根据你的设备屏幕调整
            // 参数：起始x, 起始y, 结束x, 结束y, 滚动时长(ms)
            await driver.swipe(500, 1500, 500, 500, 800);
        }
    }

    if (!elementFound) {
        throw new Error('目标元素"wellness"在多次滚动后仍未找到');
    }
});

关键说明 #

• ~wellness是WebdriverIO中Accessibility ID的正确定位语法，原代码中这部分没有问题，故障根源是滚动逻辑未让元素进入可视区域。
• 方法1依赖UiAutomator2原生能力，定位和滚动一步完成，效率更高。
• 方法2的swipe坐标需要根据设备屏幕尺寸调整，可通过Appium Inspector获取屏幕宽高值优化。

内容的提问来源于stack exchange，提问作者Petya