ModulePusher

public class ModulePusher
extends Object

java.lang.Object
   ↳ com.android.tradefed.targetprep.ModulePusher

Summary

Nested classes

class ModulePusher.ModulePushError

Fatal error during Mainline module push. 

Fields

public static final String LINE_BREAK

Public constructors

ModulePusher(ITestDevice device, long waitTimeMs, long delayWaitingTimeMs)

Public methods

void installModules(ImmutableMultimap<String, File> moduleFiles, boolean factoryReset, boolean disablePackageCache)

Installs moduleFiles to the device by adb push.

Protected methods

void checkApexActivated(ITestDevice device, modules)

Check if all apexes are activated.

Path getApexPathUnderSystem(ITestDevice device, String packageName)
getModulesFailToActivate( toInstall, activatedApexes)

Get modules that failed to be activated.

String[] getPathsOnDevice(ITestDevice device, String packageName)

Get the paths of the installation files of the package on the device.

Path[] getPreloadPaths(ITestDevice device, File[] moduleFiles, String packageName, int apiLevel)

Get the paths of the preload package on the device.

ImmutableMap<String, String> parsePackageVersionCodes(String output)

Parses lines of "package:{key} versionCode:{value}" into a map.

void setupDevice(ITestDevice device)

adb root and remount device before push files under /system

void waitForDeviceToBeResponsive(long waitTime)

Fields

LINE_BREAK

public static final String LINE_BREAK

Public constructors

ModulePusher

public ModulePusher (ITestDevice device, 
                long waitTimeMs, 
                long delayWaitingTimeMs)

Parameters
device ITestDevice

waitTimeMs long

delayWaitingTimeMs long

Public methods

installModules

public void installModules (ImmutableMultimap<String, File> moduleFiles, 
                boolean factoryReset, 
                boolean disablePackageCache)

Installs moduleFiles to the device by adb push.

Parameters
moduleFiles ImmutableMultimap: a multimap from package names to the package files. In split case, the base package should be the first in iteration order.
factoryReset boolean: if reload via factory reset.
disablePackageCache boolean

Throws
DeviceNotAvailableException
ModulePusher.ModulePushError
TargetSetupError

Protected methods

checkApexActivated

protected void checkApexActivated (ITestDevice device, 
                 modules)

Check if all apexes are activated.

Parameters
device ITestDevice: under test.
modules

Throws
ModulePusher.ModulePushError if activation failed.
DeviceNotAvailableException

getApexPathUnderSystem

protected Path getApexPathUnderSystem (ITestDevice device, 
                String packageName)

Parameters
device ITestDevice

packageName String

Returns
Path

Throws
DeviceNotAvailableException
ModulePusher.ModulePushError

getModulesFailToActivate

protected  getModulesFailToActivate ( toInstall, 
                 activatedApexes)

Get modules that failed to be activated.

Parameters
toInstall

activatedApexes : The set of the active apexes on device
Returns
a list containing the apexinfo of the input apex modules that failed to be activated.

getPathsOnDevice

protected String[] getPathsOnDevice (ITestDevice device, 
                String packageName)

Get the paths of the installation files of the package on the device.

Parameters
device ITestDevice: under test
packageName String: of the module
Returns
String[] paths of all files of the package
Throws
DeviceNotAvailableException if device is not available
ModulePusher.ModulePushError

getPreloadPaths

protected Path[] getPreloadPaths (ITestDevice device, 
                File[] moduleFiles, 
                String packageName, 
                int apiLevel)

Get the paths of the preload package on the device.

For split packages, return the path of the package dir followed by the paths of files. As a result, the size of return is always > 1 in this case. For non-split packages, simply return the path of the preload installation file.

Parameters
device ITestDevice: under test
moduleFiles File: local modules files to install
packageName String: of the module
apiLevel int: of the device
Returns
Path[] the paths of the preload files.
Throws
DeviceNotAvailableException
ModulePusher.ModulePushError

parsePackageVersionCodes

protected ImmutableMap<String, String> parsePackageVersionCodes (String output)

Parses lines of "package:{key} versionCode:{value}" into a map.

Parameters
output String

Returns
ImmutableMap<String, String>

setupDevice

protected void setupDevice (ITestDevice device)

adb root and remount device before push files under /system

Parameters
device ITestDevice

Throws
ModulePusher.ModulePushError if device cannot be remounted.
DeviceNotAvailableException if device unavailable.

waitForDeviceToBeResponsive

protected void waitForDeviceToBeResponsive (long waitTime)

Parameters
waitTime long