[Android] Switch to DeviceUtils versions of GoHome, ForceStop, etc.

build/android/pylib/device/device_utils.py

 # Copyright 2014 The Chromium Authors. All rights reserved.
 # Use of this source code is governed by a BSD-style license that can be
 # found in the LICENSE file.
 
 """Provides a variety of device interactions based on adb.
 
 Eventually, this will be based on adb_wrapper.
 """
 # pylint: disable=W0613
 
@@ skipping 372 matching lines @@
       retries: Same as for |IsOnline|.
     """
     package, old_intent = intent.action.rsplit('.', 1)
     if intent.extras is None:
       args = []
     else:
       args = ['-e %s%s' % (k, ' "%s"' % v if v else '')
               for k, v in intent.extras.items() if len(k) > 0]
     self.old_interface.BroadcastIntent(package, old_intent, *args)
 
+  @decorators.WithTimeoutAndRetriesFromInstance()
+  def GoHome(self, timeout=None, retries=None):
+    """ Return to the home screen.

[frankf, 2014/06/25 19:19:30]

remove space here and below

[jbudorick, 2014/06/25 21:04:28]

Done.

+
+    Args:
+      timeout: Same as for |IsOnline|.
+      retries: Same as for |IsOnline|.
+    """
+    self.old_interface.GoHome()
+
+  @decorators.WithTimeoutAndRetriesFromInstance()
+  def ForceStop(self, package, timeout=None, retries=None):
+    """ Close the application.
+
+    Args:
+      package: A string containing the name of the package to stop.
+      timeout: Same as for |IsOnline|.

[Victor Starodub, 2014/06/25 19:35:45]

Maybe expand these? IsOnline is 300 lines away and might be removed or moved out
to another file in future.

+      retries: Same as for |IsOnline|.
+    """
+    self.old_interface.CloseApplication(package)
+
+  @decorators.WithTimeoutAndRetriesFromInstance()
+  def ClearApplicationState(self, package, timeout=None, retries=None):
+    """ Clear all state for the given package.
+
+    Args:
+      package: A string containing the name of the package to stop.
+      timeout: Same as for |IsOnline|.
+      retries: Same as for |IsOnline|.
+    """
+    self.old_interface.ClearApplicationState(package)
+
+  @decorators.WithTimeoutAndRetriesFromInstance()
+  def SendKeyEvent(self, keycode, timeout=None, retries=None):
+    """ Sends a keycode to the device.
+
+    Args:
+      keycode: A integer keycode to send to the device.

[frankf, 2014/06/25 19:19:30]

should this be an enum of some sort?

[jbudorick, 2014/06/25 21:04:28]

It could be, although I'm reluctant to include it in this CL as nothing uses
this function at the moment.

I added a note that the values come from
http://developer.android.com/reference/android/view/KeyEvent.html

+      timeout: Same as for |IsOnline|.
+      retries: Same as for |IsOnline|.
+    """
+    self.old_interface.SendKeyEvent(keycode)
+
   def __str__(self):
     """Returns the device serial."""
     return self.old_interface.GetDevice()
 
   @staticmethod
   def parallel(devices=None, async=False):
     """Creates a Parallelizer to operate over the provided list of devices.
 
     If |devices| is either |None| or an empty list, the Parallelizer will
     operate over all attached devices.
 
     Args:
       devices: A list of either DeviceUtils instances or objects from
                from which DeviceUtils instances can be constructed. If None,
                all attached devices will be used.
       async: If true, returns a Parallelizer that runs operations
              asynchronously.
     Returns:
       A Parallelizer operating over |devices|.
     """
     if not devices or len(devices) == 0:
       devices = pylib.android_commands.GetAttachedDevices()
     parallelizer_type = (parallelizer.Parallelizer if async
                          else parallelizer.SyncParallelizer)
     return parallelizer_type([
         d if isinstance(d, DeviceUtils) else DeviceUtils(d)
         for d in devices])