[Android] Break GTest emulator launching into a separate function.

build/android/emulator.py

 #!/usr/bin/env python
 #
 # Copyright (c) 2012 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 an interface to start and stop Android emulator.
 
 Assumes system environment ANDROID_NDK_ROOT has been set.
 
   Emulator: The class provides the methods to launch/shutdown the emulator with
             the android virtual device named 'avd_armeabi' .
 """
 
 import logging
 import os
 import signal
 import subprocess
 import sys
 import time
 
 from pylib import android_commands
 from pylib import cmd_helper
+from pylib.utils import time_profile
 
 # adb_interface.py is under ../../third_party/android_testrunner/
 sys.path.append(os.path.join(os.path.abspath(os.path.dirname(__file__)), '..',
    '..', 'third_party', 'android_testrunner'))
 import adb_interface
 import errors
 import run_command
 
 class EmulatorLaunchException(Exception):
   """Emulator failed to launch."""
@@ skipping 58 matching lines @@
   """Returns an available TCP port for the console."""
   used_ports = []
   emulators = android_commands.GetEmulators()
   for emulator in emulators:
     used_ports.append(emulator.split('-')[1])
   for port in PortPool.port_range():
     if str(port) not in used_ports:
       return port
 
 
+def LaunchEmulators(emulator_count, fast_and_loose=False):
+  """Launch multiple emulators and wait for them to boot.
+
+  Args:
+    emulator_count: number of emulators to launch.
+
+  Returns:
+    List of emulators.
+  """
+  emulators = []
+  for n in xrange(emulator_count):
+    t = time_profile.TimeProfile('Emulator launch %d' % n)
+    avd_name = None
+    if n > 0:
+      # Creates a temporary AVD for the extra emulators.
+      avd_name = 'run_tests_avd_%d' % n
+    logging.info('Emulator launch %d with avd_name=%s', n, avd_name)
+    emulator = Emulator(avd_name, fast_and_loose)
+    emulator.Launch(kill_all_emulators=n == 0)
+    t.Stop()
+    emulators.append(emulator)
+  # Wait for all emulators to boot completed.
+  for emulator in emulators:
+    emulator.ConfirmLaunch(True)
+  return emulators
+
+
 class Emulator(object):
   """Provides the methods to lanuch/shutdown the emulator.
 
   The emulator has the android virtual device named 'avd_armeabi'.
 
   The emulator could use any even TCP port between 5554 and 5584 for the
   console communication, and this port will be part of the device name like
   'emulator-5554'. Assume it is always True, as the device name is the id of
   emulator managed in this class.
 
@@ skipping 195 matching lines @@
       signal.signal(sig, signal.SIG_DFL)
     self.Shutdown()
     raise KeyboardInterrupt  # print a stack
 
   def _InstallKillHandler(self):
     """Install a handler to kill the emulator when we exit unexpectedly."""
     for sig in self._SIGNALS:
       signal.signal(sig, self._ShutdownOnSignal)
 
 def main(argv):
   Emulator(None, True).Launch(True)

[frankf, 2013/01/08 22:14:27]

Can we move emulator.py into pylib/utils. Does it make sense  this script to be
executable? If so maybe just have a thin executable wrapper around
utils/emulator.py here.

 
 
 if __name__ == '__main__':
   main(sys.argv)