Appium Android：如何仅向下滚动查找元素，避免先滚至顶部

1. 调整UiScrollable实现单向滚动 #

默认的scrollIntoView会先滚动到容器顶部再向下查找，这是导致性能问题的核心。你可以通过两种方式修改：

方式1：使用scrollIntoView重载方法禁止反向滚动 #

UiScrollable提供了带第二个参数的scrollIntoView方法，设置scrollBackward为false，即可避免向上滚动回顶部，仅从当前位置向下查找元素：

driver.find_element(
    AppiumBy.ANDROID_UIAUTOMATOR,
    f'new UiScrollable(new UiSelector().scrollable(true))'
    '.scrollIntoView(new UiSelector().descriptionContains("{description_part}"), false)'
)

注：第二个参数scrollBackward控制是否允许向上滚动，设为false后，只会保持当前位置向下滚动查找。

方式2：循环调用scrollForward并检查元素 #

如果上述重载方法不生效，可以手动循环滚动+元素检查，完全控制滚动方向：

from selenium.common.exceptions import NoSuchElementException

def scroll_to_element_downward(driver, description_part):
    # 获取滚动容器
    scrollable_container = driver.find_element(
        AppiumBy.ANDROID_UIAUTOMATOR,
        'new UiScrollable(new UiSelector().scrollable(true))'
    )
    max_scroll_times = 10  # 限制最大滚动次数，防止无限循环
    current_scroll = 0

    while current_scroll < max_scroll_times:
        try:
            # 尝试查找目标元素
            return driver.find_element(
                AppiumBy.ANDROID_UIAUTOMATOR,
                f'new UiSelector().descriptionContains("{description_part}")'
            )
        except NoSuchElementException:
            # 未找到则向下滚动一次
            scrollable_container.execute_script('.scrollForward()')
            current_scroll += 1
    raise NoSuchElementException(f"未找到包含描述'{description_part}'的元素")

2. 替代方案：使用Appium原生滚动命令 #

Appium的mobile: scroll扩展命令更灵活，支持直接指定滚动方向，无需依赖UiAutomator的默认行为：

# 先获取滚动容器的ID
scrollable_id = driver.find_element(
    AppiumBy.ANDROID_UIAUTOMATOR,
    'new UiSelector().scrollable(true)'
).id

# 执行单向向下滚动查找
driver.execute_script('mobile: scroll', {
    'direction': 'down',
    'element': scrollable_id,
    'predicateString': f'description CONTAINS "{description_part}"'
})

3. 手动模拟滚动（精准控制） #

如果需要完全自定义滚动距离和速度，可以用TouchAction模拟手动滑动：

from appium.webdriver.common.touch_action import TouchAction

def swipe_down(driver):
    screen = driver.get_window_size()
    # 从屏幕下半部滑到上半部
    start_x = screen['width'] // 2
    start_y = int(screen['height'] * 0.7)
    end_y = int(screen['height'] * 0.3)
    TouchAction(driver).press(x=start_x, y=start_y).wait(200).move_to(x=start_x, y=end_y).release().perform()

def find_element_with_manual_swipe(driver, description_part):
    max_swipes = 10
    count = 0
    while count < max_swipes:
        try:
            return driver.find_element(
                AppiumBy.ANDROID_UIAUTOMATOR,
                f'new UiSelector().descriptionContains("{description_part}")'
            )
        except NoSuchElementException:
            swipe_down(driver)
            count += 1
    raise NoSuchElementException(f"未找到目标元素")

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