Appium中如何将未显示在视口的元素滚动至可见区域？

先修正核心错误 #

你提到SetUp.setDriver()将AppiumDriver赋值给WebElement，这是类型不兼容的错误——WebElement代表页面单个元素，AppiumDriver是驱动实例，二者不能直接赋值。正确的SetUp类应该维护AppiumDriver实例：

public class SetUp {
    private static AppiumDriver driver;

    public static void setDriver(AppiumDriver appiumDriver) {
        driver = appiumDriver;
    }

    public static AppiumDriver getDriver() {
        return driver;
    }
}

有效滚动方法（基于UIAutomator2） #

针对Android 12 + UIAutomator2环境，以下几种滚动方式稳定有效：

1. 滚动到指定文本的元素

直接通过文本定位并滚动到目标元素：

MobileElement targetElement = (MobileElement) SetUp.getDriver().findElementByAndroidUIAutomator(
        "new UiScrollable(new UiSelector().scrollable(true).instance(0)).scrollIntoView("
        + "new UiSelector().textContains(\"要找的文本\").instance(0));"
);
// 定位到后可执行操作，比如点击
targetElement.click();

2. 滚动到指定资源ID的元素

如果元素有唯一资源ID，用ID定位更精准：

MobileElement targetElement = (MobileElement) SetUp.getDriver().findElementByAndroidUIAutomator(
        "new UiScrollable(new UiSelector().scrollable(true).instance(0)).scrollIntoView("
        + "new UiSelector().resourceId(\"com.android.settings:id/目标元素ID\").instance(0));"
);

3. 无目标时的通用滚动

仅需要滚动页面（无明确目标元素）时使用：

// 向下滚动一次
SetUp.getDriver().findElementByAndroidUIAutomator(
        "new UiScrollable(new UiSelector().scrollable(true).instance(0)).scrollForward();"
);

// 向上滚动一次
SetUp.getDriver().findElementByAndroidUIAutomator(
        "new UiScrollable(new UiSelector().scrollable(true).instance(0)).scrollBackward();"
);

注意事项 #

• 确保目标元素所在的容器控件是可滚动的（scrollable(true)能匹配到对应控件），否则滚动逻辑不会生效。
• 使用文本定位时，优先用textContains而非精确text，避免因文本截断、大小写差异导致定位失败。
• 滚动操作前，确保驱动实例已正确初始化并通过SetUp类传递，避免空指针或类型错误。

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