ModuleOemTargetPreparer

public class ModuleOemTargetPreparer
extends InstallApexModuleTargetPreparer

java.lang.Object
↳	com.android.tradefed.targetprep.BaseTargetPreparer
	↳	com.android.tradefed.targetprep.TestAppInstallSetup
		↳	com.android.tradefed.targetprep.suite.SuiteApkInstaller
			↳	com.android.tradefed.targetprep.InstallApexModuleTargetPreparer
				↳	com.android.tradefed.targetprep.ModuleOemTargetPreparer

---

Summary

Nested classes
class	ModuleOemTargetPreparer.ModuleInfo A simple struct class to store information about a module

Public constructors
ModuleOemTargetPreparer()

Public methods
void	checkModuleAfterPush(ITestDevice device, pushedModules) Check module name and version code after pushed
void	setUp(TestInformation testInfo) Perform the target setup for testing, push modules to replace the preload ones

Protected methods
void	checkPreloadModules(TestInformation testInfo, DeviceDescriptor deviceDescriptor) Check preload modules info
String[]	getApkDirectory(ITestDevice device, String packageName) Get apk file path under system directory
String	getPackageVersioncode(ITestDevice device, String packageName, boolean isAPK) Check package version after pushed module given package name.
ModuleOemTargetPreparer.ModuleInfo	pushFile(File moduleFile, TestInformation testInfo) Push files to /system/apex/ for apex or /system/** for apk
String	renameFile(ITestDevice device, File moduleFile, String packageName) Rename to-be-updated file name to same one under /system.
void	setupDevice(TestInformation testInfo) adb root and remount device before push files under /system

Public constructors

ModuleOemTargetPreparer

public ModuleOemTargetPreparer ()

Public methods

checkModuleAfterPush

public void checkModuleAfterPush (ITestDevice device, 
                 pushedModules)

Check module name and version code after pushed

Parameters
device	ITestDevice
pushedModules	: List of modules pushed

Throws
TargetSetupError	throw exception if no module pushed
DeviceNotAvailableException	throw exception if no device available

setUp

public void setUp (TestInformation testInfo)

Perform the target setup for testing, push modules to replace the preload ones

Parameters
testInfo	TestInformation: The TestInformation of the invocation.

Throws
TargetSetupError	if fatal error occurred setting up environment
BuildError	If an error occurs due to the build being prepared
DeviceNotAvailableException	if device became unresponsive

Protected methods

checkPreloadModules

protected void checkPreloadModules (TestInformation testInfo, 
                DeviceDescriptor deviceDescriptor)

Check preload modules info

Parameters
testInfo	TestInformation: test info
deviceDescriptor	DeviceDescriptor

Throws
DeviceNotAvailableException	throws exception if devices no available
TargetSetupError	throws exception if no modules preloaded

getApkDirectory

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

Get apk file path under system directory

Parameters
device	ITestDevice
packageName	String: module package name

Returns
String[]	string array with apk name and path

Throws
DeviceNotAvailableException	if device is not available
TargetSetupError	if cannot find the path of the package

getPackageVersioncode

protected String getPackageVersioncode (ITestDevice device, 
                String packageName, 
                boolean isAPK)

Check package version after pushed module given package name.

Parameters
packageName	String: pushed package name
isAPK	boolean

Returns
String

Throws
DeviceNotAvailableException	throws exception if device not found.

pushFile

protected ModuleOemTargetPreparer.ModuleInfo pushFile (File moduleFile, 
                TestInformation testInfo)

Push files to /system/apex/ for apex or /system/** for apk

Parameters
moduleFile	File: module file
testInfo	TestInformation: the TestInformation for the invocation.

Returns
ModuleOemTargetPreparer.ModuleInfo

Throws
TargetSetupError	if cannot push file via adb
DeviceNotAvailableException	if device not available

renameFile

protected String renameFile (ITestDevice device, 
                File moduleFile, 
                String packageName)

Rename to-be-updated file name to same one under /system.

Parameters
device	ITestDevice: test device
moduleFile	File: module file to be installed
packageName	String: name under /system/*

Returns
String	new file name after rename

Throws
TargetSetupError	if file cannot be renamed
DeviceNotAvailableException

setupDevice

protected void setupDevice (TestInformation testInfo)

adb root and remount device before push files under /system

Parameters
testInfo	TestInformation: the TestInformation for the invocation.

Throws
TargetSetupError	if device cannot be remount.
DeviceNotAvailableException