com.facebook.buck.android.exopackage

Interface AndroidDevicesHelper

All Superinterfaces:

AutoCloseable, Closeable

All Known Implementing Classes:

AdbHelper

public interface AndroidDevicesHelper
extends Closeable

AndroidDevicesHelper provides a way to interact with multiple devices as AndroidDevices (rather than IDevices).

All of ExopackageInstaller's interaction with devices and adb goes through this class and AndroidDevice making it easy to provide different implementations in tests.

Nested Class Summary

Nested Classes

Modifier and Type	Interface and Description
static interface	AndroidDevicesHelper.AdbDeviceCallable This is basically the same as AdbHelper.AdbCallable except that it takes an AndroidDevice instead of an IDevice.

Method Summary

Modifier and Type	Method and Description
void	adbCall(String description, AndroidDevicesHelper.AdbDeviceCallable func, boolean quiet)
default void	adbCallOrThrow(String description, AndroidDevicesHelper.AdbDeviceCallable func, boolean quiet) A simple wrapper around adbCall that will throw if adbCall returns false.
com.google.common.collect.ImmutableList<AndroidDevice>	getDevices(boolean quiet)
void	installApk(SourcePathResolverAdapter pathResolver, HasInstallableApk hasInstallableApk, boolean installViaSd, boolean quiet, String packageName) Install apk on all matching devices.
void	startActivity(SourcePathResolverAdapter pathResolver, HasInstallableApk hasInstallableApk, String activity, boolean waitForDebugger)
void	uninstallApp(String packageName, boolean shouldKeepUserData) Uninstall apk from all matching devices.

Methods inherited from interface java.io.Closeable

close

Method Detail

adbCallOrThrow

default void adbCallOrThrow(String description,
                            AndroidDevicesHelper.AdbDeviceCallable func,
                            boolean quiet)
                     throws InterruptedException

A simple wrapper around adbCall that will throw if adbCall returns false.

Throws:

InterruptedException

adbCall

void adbCall(String description,
             AndroidDevicesHelper.AdbDeviceCallable func,
             boolean quiet)
      throws InterruptedException

Throws:

InterruptedException

getDevices

com.google.common.collect.ImmutableList<AndroidDevice> getDevices(boolean quiet)

installApk

void installApk(SourcePathResolverAdapter pathResolver,
                HasInstallableApk hasInstallableApk,
                boolean installViaSd,
                boolean quiet,
                @Nullable
                String packageName)
         throws InterruptedException

Install apk on all matching devices. This functions performs device filtering based on three possible arguments:

-e (emulator-only) - only emulators are passing the filter -d (device-only) - only real devices are passing the filter -s (serial) - only device/emulator with specific serial number are passing the filter

If more than one device matches the filter this function will fail unless multi-install mode is enabled (-x). This flag is used as a marker that user understands that multiple devices will be used to install the apk if needed.

Throws:

InterruptedException

uninstallApp

void uninstallApp(String packageName,
                  boolean shouldKeepUserData)
           throws InterruptedException

Uninstall apk from all matching devices.

Throws:

InterruptedException

See Also:

installApk(SourcePathResolverAdapter, HasInstallableApk, boolean, boolean, String)

startActivity

void startActivity(SourcePathResolverAdapter pathResolver,
                   HasInstallableApk hasInstallableApk,
                   @Nullable
                   String activity,
                   boolean waitForDebugger)
            throws IOException

Throws:

IOException