Appium使用TouchAction滑动距离不稳定 如何实现精准滑动

问题原因 #

你当前使用的TouchAction是Appium旧版非标准API，本身在不同系统版本、驱动版本下坐标计算存在兼容偏差，且滑动时系统自带的滚动惯性也会导致实际滑动距离和预期不一致。

可行解决方法 #

• 替换为W3C标准Actions API
  新版Appium推荐使用W3C标准的动作API，坐标计算逻辑更统一，精度更高，上滑实现代码示例如下：

  // 先获取真实可滑动区域的上下边界，避免状态栏/标题栏干扰
  int startY = 滑动区域底部坐标;
  int endY = 滑动区域顶部坐标;
  int centerX = driver.manage().window().getSize().width / 2;
  
  PointerInput finger = new PointerInput(PointerInput.Kind.TOUCH, "finger");
  Sequence swipe = new Sequence(finger, 1);
  // 按下起始点
  swipe.addAction(finger.createPointerMove(Duration.ofMillis(0), PointerInput.Origin.viewport(), centerX, startY));
  swipe.addAction(finger.createPointerDown(PointerInput.MouseButton.LEFT.asArg()));
  // 匀速滑动到目标点，时长固定200ms避开惯性
  swipe.addAction(finger.createPointerMove(Duration.ofMillis(200), PointerInput.Origin.viewport(), centerX, endY));
  swipe.addAction(finger.createPointerUp(PointerInput.MouseButton.LEFT.asArg()));
  
  driver.perform(Collections.singletonList(swipe));
  

• 固定滑动时长在200~300ms区间
  滑动时长低于100ms容易被系统识别为点击操作，高于300ms会触发系统自带的滚动惯性，导致实际滑动距离超出预期。
• 基于可滑动容器计算坐标
  不要直接用整个屏幕的宽高计算滑动坐标，先通过driver.findElement()获取到可滑动容器的元素，再调用getLocation()和getSize()方法计算容器的真实上下边界，排除状态栏、标题栏、导航栏的高度干扰，避免不同设备的系统栏高度不同导致的滑动偏移。
• 精度要求极高的场景可关闭滚动惯性
  Android端可执行命令adb shell settings put system scroll_friction 0调整系统滚动摩擦系数，消除惯性；iOS端可在初始化驱动的Capability中配置disableWindowAnimation: true关闭滚动动画，提升滑动精度。
• 增加滑动结果校验消除误差
  滑动完成后校验目标元素是否已出现在可视区域，若未出现则补滑固定距离，避免单次滑动的误差累积。

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