Touch actions - Appium

移动手势的自动化

尽管 Selenium WebDriver 的规范已经支持了一些移动交互,但它的参数并不总是那么容易地映射到底层设备的自动化框架所提供的方法上（比如 iOS 上的 UIAutomation）。为此，Appium 在最新的规范(https://dvcs.w3.org/hg/webdriver/raw-file/tip/webdriver-spec.html#multiactions-1) 中实现了新的触摸操作和多重操作 API。

注意，这与早期版本中原始的 JSON Wire 协议里的触摸操作 API 不同。

这些 API 允许你使用多个执行器去建立任意的手势。请查看对应语言的 Appium 客户端文档来查看使用这些 API 的示例。

触摸操作(TouchAction)/多重操作(MultiAction) API 概述

触摸操作(TouchAction)

TouchAction 对象包含一连串的事件。

在所有的 appium 客户端库里，触摸对象被创建并被赋予一连串的事件。

规范里可用的事件有： * 短按(press) * 释放(release) * 移动到(moveTo) * 点击(tap) * 等待(wait) * 长按(longPress) * 取消(cancel) * 执行(perform)

这是一个使用伪代码创建一个动作的示例：

TouchAction().press(el0).moveTo(el1).release()

上述模拟了一个用户按下一个元素，滑动他的手指到另一个位置，然后将他的手指从屏幕上移开。

Appium按顺序执行这些事件。你可以添加wait事件来控制事件的时长。

moveTo 的坐标与当前的位置相关。举例来说，从 100,100 拖拽到 200,200 可以这样实现:

.press(100,100) // 从 100,100 开始
.moveTo(100,100) // 分别给X和Y坐标增加100，在 200,200 结束

Appium 客户端库有不同的实现方式，举例来说:你可以传递坐标或元素给 moveTo 事件。当坐标和元素一起传递时，该坐标是相对于元素位置的相对坐标，而不是相对于当前位置。

调用 perform 事件发送全部的事件序列给 appium，触摸手势就会在你的设备上执行。

Appium客户端也允许通过 driver 对象直接执行触摸操作，而不是在触摸操作对象上调用 perform 事件。

在伪代码里，以下两者是相等的：

TouchAction().tap(el).perform()

driver.perform(TouchAction().tap(el))

多点触控(MultiTouch)

MultiTouch对象是触摸操作的集合。

多点触控手势只有两个方法，add和perform。

add 用于将不同的触摸操作添加到当前的多点触控中。

当 perform 执行时，被添加到多点触控里的所有触摸操作会被发送给 appium 并被执行，就像它们同时发生一样。Appium 会按序一个个执行触摸事件，首先第一个事件，然后第二个，以此类推。

用两只手指点击的伪代码示例：

action0 = TouchAction().tap(el)
action1 = TouchAction().tap(el)
MultiAction().add(action0).add(action1).perform()

缺陷与解决方法

不幸的是，在iOS 7.0 - 8.x 的模拟器上存在着一个缺陷，ScrollViews、CollectionViews和TableViews不能识别 UIAutomation（Appium在iOS底层所使用的框架）所创建的手势。为了避免这些，我们已经提供了一个可用的新函数 scroll，它在大多数情况下能让你完成你想在这些 view 中的任意一个上去做的事，也就是，滚动它！

滚动

为了允许使用这个特殊的手势，我们重写了 driver 的 execute 和 executeScript 方法，并且给命令加上 mobile: 前缀。看下面的示例：

为了进行滚动，将你想滚动的方向作为参数传入。

JavascriptExecutor js = (JavascriptExecutor) driver;
HashMap<String, String> scrollObject = new HashMap<String, String>();
scrollObject.put("direction", "down");
js.executeScript("mobile: scroll", scrollObject);

driver.execute_script("mobile: scroll", {"direction": "down"})

driver.execute('mobile: scroll', {direction: 'down'})

execute_script 'mobile: scroll', direction: 'down'

Dictionary<string, string> scrollObject = new Dictionary<string, string>();
scrollObject.Add("direction", "down");
((IJavaScriptExecutor)driver).ExecuteScript("mobile: scroll", scrollObject));

$params = array(array('direction' => 'down'));
$driver->executeScript("mobile: scroll", $params);

使用方向和元素进行滚动的示例。

JavascriptExecutor js = (JavascriptExecutor) driver;
HashMap<String, String> scrollObject = new HashMap<String, String>();
scrollObject.put("direction", "down");
scrollObject.put("element", ((RemoteWebElement) element).getId());
js.executeScript("mobile: scroll", scrollObject);

driver.execute_script("mobile: scroll", {"direction": "down", element: element.getAttribute("id")})

driver.execute('mobile: scroll', {direction: 'down', element: element.value.ELEMENT});

execute_script 'mobile: scroll', direction: 'down', element: element.ref

Dictionary<string, string> scrollObject = new Dictionary<string, string>();
scrollObject.Add("direction", "down");
scrollObject.Add("element", <element_id>);
((IJavaScriptExecutor)driver).ExecuteScript("mobile: scroll", scrollObject));

$params = array(array('direction' => 'down', 'element' => element.GetAttribute("id")));
$driver->executeScript("mobile: scroll", $params);

Swiping

在 XCUITest 驱动上有一个特别的方法，和 scrolling 类似。(见 https://developer.apple.com/reference/xctest/xcuielement)。

这个方法的名字和 Scrolling的 API 一样，只要用 "mobile: swipe" 替换 "mobile: scroll"。

滑块的自动化

iOS

Java

// java
// 滑动值可以是代表0到1之间数字的字符串
// 例如，"0.1"代表10%，"1.0"代表100%
WebElement slider =  driver.findElement(By.xpath("//window[1]/slider[1]"));
slider.sendKeys("0.1");

Android

在Android上与滑块交互的最佳方式是使用触摸操作。

本文由 NativeZhang 翻译，由 lihuazhang 校验。