com.facebook.buck.apple.simulator

Class AppleSimulatorController

java.lang.Object

com.facebook.buck.apple.simulator.AppleSimulatorController

public class AppleSimulatorController
extends Object

Utility class to manage starting the iOS simulator as well as installing and running applications inside it.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	AppleSimulatorController.LaunchBehavior

Constructor Summary

Constructors

Constructor and Description
AppleSimulatorController(ProcessExecutor processExecutor, Path simctlPath, Path iosSimulatorPath)

Method Summary

Modifier and Type	Method and Description
boolean	canStartSimulator(String simulatorUdid)
boolean	installBundleInSimulator(String simulatorUdid, Path bundlePath) Installs a bundle in a previously-started simulator.
Optional<Long>	launchInstalledBundleInSimulator(String simulatorUdid, String bundleID, AppleSimulatorController.LaunchBehavior launchBehavior, List<String> args) Launches a previously-installed bundle in a started simulator.
Optional<Long>	startSimulator(String simulatorUdid, long timeoutMillis) Starts up the iOS simulator, blocking the calling thread until the simulator boots or timeoutMillis passes, whichever happens first.
Optional<Long>	waitForSimulatorsToShutdown(long timeoutMillis) Waits up to timeoutMillis for all simulators to shut down.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

AppleSimulatorController

public AppleSimulatorController(ProcessExecutor processExecutor,
                                Path simctlPath,
                                Path iosSimulatorPath)

Method Detail

startSimulator

public Optional<Long> startSimulator(String simulatorUdid,
                                     long timeoutMillis)
                              throws IOException,
                                     InterruptedException

Starts up the iOS simulator, blocking the calling thread until the simulator boots or timeoutMillis passes, whichever happens first.

Call canStartSimulator(String) before invoking this method to ensure the simulator can be started.

Returns:

The number of milliseconds waited if the simulator booted successfully, Optional.empty() otherwise.

Throws:

IOException

InterruptedException

canStartSimulator

public boolean canStartSimulator(String simulatorUdid)
                          throws IOException,
                                 InterruptedException

Throws:

IOException

InterruptedException

waitForSimulatorsToShutdown

public Optional<Long> waitForSimulatorsToShutdown(long timeoutMillis)
                                           throws IOException,
                                                  InterruptedException

Waits up to timeoutMillis for all simulators to shut down.

Returns:

The number of milliseconds waited if all simulators have shut down, Optional.empty() otherwise.

Throws:

IOException

InterruptedException

installBundleInSimulator

public boolean installBundleInSimulator(String simulatorUdid,
                                        Path bundlePath)
                                 throws IOException,
                                        InterruptedException

Installs a bundle in a previously-started simulator.

Returns:

true if the bundle was installed, false otherwise.

Throws:

IOException

InterruptedException

launchInstalledBundleInSimulator

public Optional<Long> launchInstalledBundleInSimulator(String simulatorUdid,
                                                       String bundleID,
                                                       AppleSimulatorController.LaunchBehavior launchBehavior,
                                                       List<String> args)
                                                throws IOException,
                                                       InterruptedException

Launches a previously-installed bundle in a started simulator.

Returns:

the process ID of the newly-launched process if successful, an absent value otherwise.

Throws:

IOException

InterruptedException