implemented touch long press for Android.

android/bootstrap/src/io/appium/android/bootstrap/AndroidCommandExecutor.java

@@ -13,6 +13,7 @@ import io.appium.android.bootstrap.handler.GetText;
 import io.appium.android.bootstrap.handler.Orientation;
 import io.appium.android.bootstrap.handler.SetText;
 import io.appium.android.bootstrap.handler.Swipe;
+import io.appium.android.bootstrap.handler.TouchLongClick;
 import io.appium.android.bootstrap.handler.WaitForIdle;
 import io.appium.android.bootstrap.handler.Wake;
 
@@ -36,6 +37,7 @@ class AndroidCommandExecutor {
     map.put("swipe", new Swipe());
     map.put("flick", new Flick());
     map.put("click", new Click());
+    map.put("touchLongClick", new TouchLongClick());
     map.put("getText", new GetText());
     map.put("setText", new SetText());
     map.put("getName", new GetName());
@@ -49,7 +51,7 @@ class AndroidCommandExecutor {
   /**
    * Gets the handler out of the map, and executes the command.
    * 
-   * @param command
+   * @param command The {@link AndroidCommand}
    * @return {@link AndroidCommandResult}
    * @throws AndroidCommandException
    */

android/bootstrap/src/io/appium/android/bootstrap/AndroidElement.java

@@ -35,6 +35,10 @@ public class AndroidElement {
     return el.click();
   }
 
+  public boolean longClick() throws UiObjectNotFoundException {
+    return el.longClick();
+  }
+
   public Point getAbsolutePosition(final Double X, final Double Y)
       throws UiObjectNotFoundException, InvalidCoordinatesException {
     final Point point = new Point(X, Y);
@@ -166,5 +170,4 @@ public class AndroidElement {
   public boolean setText(final String text) throws UiObjectNotFoundException {
     return el.setText(text);
   }
-
 }

android/bootstrap/src/io/appium/android/bootstrap/handler/TouchLongClick.java

@@ -0,0 +1,40 @@
+package io.appium.android.bootstrap.handler;
+
+import com.android.uiautomator.core.UiObjectNotFoundException;
+import io.appium.android.bootstrap.*;
+import io.appium.android.bootstrap.exceptions.ElementNotInHashException;
+import org.json.JSONException;
+
+/**
+ * This handler is used to long click elements in the Android UI.
+ *
+ */
+public class TouchLongClick extends CommandHandler {
+
+  /**
+   *
+   * @param command The {@link AndroidCommand}
+   * @return {@link AndroidCommandResult}
+   * @throws JSONException
+   * @see io.appium.android.bootstrap.CommandHandler#execute(io.appium.android.bootstrap.AndroidCommand)
+   */
+  @Override
+  public AndroidCommandResult execute(AndroidCommand command) throws JSONException {
+    if (!command.isElementCommand()) {
+      return getErrorResult("Unable to long click without an element.");
+    }
+
+    try {
+      final AndroidElement el = command.getElement();
+      final boolean res = el.longClick();
+      return getSuccessResult(res);
+
+    } catch (final UiObjectNotFoundException e) {
+      return new AndroidCommandResult(WDStatus.NO_SUCH_ELEMENT, e.getMessage());
+    } catch (final ElementNotInHashException e) {
+      return new AndroidCommandResult(WDStatus.NO_SUCH_ELEMENT, e.getMessage());
+    } catch (final Exception e) {
+      return getErrorResult(e.getMessage());
+    }
+  }
+}

app/android.js

@@ -363,6 +363,10 @@ Android.prototype.click = function(elementId, cb) {
   this.proxy(["element:click", {elementId: elementId}], cb);
 };
 
+Android.prototype.touchLongClick = function(elementId, cb) {
+  this.proxy(["element:touchLongClick", {elementId: elementId}], cb);
+};
+
 Android.prototype.fireEvent = function(evt, elementId, value, cb) {
   cb(new NotYetImplementedError(), null);
 };

app/controller.js

@@ -278,6 +278,13 @@ exports.doClick = function(req, res) {
   req.device.click(elementId, getResponseHandler(req, res));
 };
 
+exports.touchLongClick = function(req, res) {
+  var element = req.body.element;
+  if (checkMissingParams(res, {element: element}, true)) {
+    req.device.touchLongClick(element, getResponseHandler(req, res));
+  }
+};
+
 exports.fireEvent = function(req, res) {
   var elementId = req.body.element
     , evt = req.body.event;

app/firefoxos.js

@@ -237,6 +237,7 @@ Firefox.prototype.notImplementedCmds = function() {
     , 'fireEvent'
     , 'complexTap'
     , 'flick'
+    , 'touchLongClick'
     , 'getPageSourceXML'
     , 'swipe'
     , 'hideKeyboard'

app/ios.js

@@ -852,6 +852,10 @@ IOS.prototype.click = function(elementId, cb) {
   }
 };
 
+IOS.prototype.touchLongClick = function(elementId, cb) {
+  cb(new NotYetImplementedError(), null);
+};
+
 IOS.prototype.fireEvent = function(evt, elementId, cb) {
   if (this.curWindowHandle) {
     this.useAtomsElement(elementId, cb, _.bind(function(atomsElement) {

app/routing.js

@@ -114,6 +114,8 @@ module.exports = function(appium) {
   rest.get('/wd/hub/session/:sessionId/screenshot', controller.getScreenshot);
   rest.post('/wd/hub/session/:sessionId?/element/:elementId?/element', controller.findElementFromElement);
   rest.post('/wd/hub/session/:sessionId?/element/:elementId?/elements', controller.findElementsFromElement);
+  rest.post('/wd/hub/session/:sessionId?/touch/click', controller.doClick);
+  rest.post('/wd/hub/session/:sessionId?/touch/longclick', controller.touchLongClick);
   rest.post('/wd/hub/session/:sessionId/touch/flick', controller.pickAFlickMethod);
   rest.post('/wd/hub/session/:sessionId?/url', controller.postUrl);
   rest.get('/wd/hub/session/:sessionId?/url', controller.getUrl);
@@ -181,13 +183,11 @@ var routeNotYetImplemented = function(rest) {
   rest.post('/wd/hub/session/:sessionId?/buttondown', controller.notYetImplemented);
   rest.post('/wd/hub/session/:sessionId?/buttonup', controller.notYetImplemented);
   rest.post('/wd/hub/session/:sessionId?/doubleclick', controller.notYetImplemented);
-  rest.post('/wd/hub/session/:sessionId?/touch/click', controller.doClick);
   rest.post('/wd/hub/session/:sessionId?/touch/down', controller.notYetImplemented);
   rest.post('/wd/hub/session/:sessionId?/touch/up', controller.notYetImplemented);
   rest.post('/wd/hub/session/:sessionId?/touch/move', controller.notYetImplemented);
   rest.post('/wd/hub/session/:sessionId?/touch/scroll', controller.notYetImplemented);
   rest.post('/wd/hub/session/:sessionId?/touch/doubleclick', controller.notYetImplemented);
-  rest.post('/wd/hub/session/:sessionId?/touch/longclick', controller.notYetImplemented);
   rest.get('/wd/hub/session/:sessionId?/location', controller.notYetImplemented);
   rest.get('/wd/hub/session/:sessionId?/session_storage', controller.notYetImplemented);
   rest.post('/wd/hub/session/:sessionId?/session_storage', controller.notYetImplemented);

docs/touch-actions.md

@@ -0,0 +1,19 @@
+# Touch Actions
+
+WebDriver provides an API to send some kinds of touch gestures to the devices,
+for example, to long press an element you can do:
+
+```java
+final WebElement imageView = searchResults.findElement(By.tagName("ImageView"));
+new TouchActions(driver).longPress(imageView).perform();
+```
+
+Currently Appium support some of the gestures in the Touch Actions API:
+
+* flick
+* long press
+* single tap
+
+Some other gestures are supported through the "Alternative access method"
+explained in [Automating mobile gestures](gestures.md)
+