### 封装 Appium 手势操作为通用 API 的设计思路 在 APP 自动化测试中，手势操作是常见的交互方式，如滑动、长按、拖拽等。为了提高代码的复用性和可维护性，可以将这些操作封装为通用 API，供多个测试用例调用。 #### 1. 滑动操作封装 滑动操作是 Appium 中最常用的手势之一，常用于翻页、滚动列表等场景。可以通过定义一个 `SwipeAPI` 类来封装不同方向的滑动逻辑： ```python class SwipeAPI: def __init__(self, driver): self.driver = driver self.width = self.driver.get_window_size()['width'] self.height = self.driver.get_window_size()['height'] def swipe_up(self, duration=800): """向上滑动""" self.driver.swipe(self.width * 0.5, self.height * 0.75, self.width * 0.5, self.height * 0.25, duration) def swipe_down(self, duration=800): """向下滑动""" self.driver.swipe(self.width * 0.5, self.height * 0.25, self.width * 0.5, self.height * 0.75, duration) def swipe_left(self, duration=800): """向左滑动""" self.driver.swipe(self.width * 0.75, self.height * 0.5, self.width * 0.25, self.height * 0.5, duration) def swipe_right(self, duration=800): """向右滑动""" self.driver.swipe(self.width * 0.25, self.height * 0.5, self.width * 0.75, self.height * 0.5, duration) ``` 此类通过获取设备屏幕尺寸并设定固定比例坐标实现滑动方向控制，适用于多种分辨率设备[^3]。 #### 2. 长按操作封装 长按操作在 App 测试中常用于触发菜单或弹出框，Appium 提供了 `TouchAction` 来实现该操作。可以将其封装为通用方法： ```python from appium.webdriver.common.touch_action import TouchAction class LongPressAPI: def __init__(self, driver): self.driver = driver def long_press_element(self, element, duration=1000): action = TouchAction(self.driver) action.long_press(element, duration=duration).release().perform() ``` 此方法接受一个元素对象和长按时间（毫秒），通过 `TouchAction` 实现模拟长按效果[^3]。 #### 3. 多点触控与拖拽操作封装 对于更复杂的手势操作，如拖拽、缩放等，也可以使用 `TouchAction` 和 `MultiAction` 进行封装： ```python class DragAndDropAPI: def __init__(self, driver): self.driver = driver def drag_and_drop(self, origin_el, target_el): action = TouchAction(self.driver) action.press(origin_el).wait(100).move_to(target_el).release().perform() ``` 该方法实现了从一个元素拖拽到另一个元素的操作，适用于排序、移动控件等测试场景[^3]。 #### 4. 组合手势操作封装 有时需要组合多个手势完成特定功能，例如先滑动再点击。可以基于上述封装类进一步组合： ```python class CompositeGestureAPI: def __init__(self, driver): self.driver = driver self.swipe_api = SwipeAPI(driver) self.click_api = ClickAPI(driver) def scroll_and_click(self, by, value): for _ in range(5): # 最多尝试滑动5次 try: self.click_api.click_element(by, value) return True except: self.swipe_api.swipe_up() return False ``` 该类结合滑动与点击操作，在找不到目标元素时自动向上滑动并重试，增强测试脚本的健壮性[^1]。 ---