Starting March 27, 2025, we recommend using android-latest-release
instead of aosp-main
to build and contribute to AOSP. For more information, see Changes to AOSP.
Stay organized with collections
Save and categorize content based on your preferences.
TradefedSandbox
public
class
TradefedSandbox
extends Object
implements
ISandbox
java.lang.Object
|
↳ |
com.android.tradefed.sandbox.TradefedSandbox
|
Sandbox container that can run a Trade Federation invocation. TODO: Allow Options to be passed to
the sandbox.
Summary
Public methods |
String
|
createClasspath(File workingDir)
Create a classpath based on the environment and the working directory returned by getTradefedSandboxEnvironment(com.android.tradefed.invoker.IInvocationContext, com.android.tradefed.config.IConfiguration, String[]) .
|
IConfiguration
|
createThinLauncherConfig(String[] args, IKeyStoreClient keyStoreClient, IRunUtil runUtil, File globalConfig)
Special mode disconnected from main run: When a configuration does not appear to exists in
the parent, we fallback to thin launcher where we attempt to setup the sandbox with currently
known informations and fill up the working directory to create the config fully in the
versioned dir.
|
File
|
getTradefedSandboxEnvironment(IInvocationContext context, IConfiguration nonVersionedConfig, String[] args)
Returns the sandbox environment TF to be used based on the command line arguments.
|
Exception
|
prepareEnvironment(IInvocationContext context, IConfiguration config, ITestInvocationListener listener)
Prepare the environment for the sandbox to run properly.
|
CommandResult
|
run(IConfiguration config, ITestLogger logger)
Run the sandbox with the environment that was set.
|
void
|
tearDown()
Clean up any states, files or environment that may have been changed.
|
Public constructors
TradefedSandbox
public TradefedSandbox ()
Public methods
createThinLauncherConfig
public IConfiguration createThinLauncherConfig (String[] args,
IKeyStoreClient keyStoreClient,
IRunUtil runUtil,
File globalConfig)
Special mode disconnected from main run: When a configuration does not appear to exists in
the parent, we fallback to thin launcher where we attempt to setup the sandbox with currently
known informations and fill up the working directory to create the config fully in the
versioned dir.
Parameters |
args |
String : The original command line args. |
keyStoreClient |
IKeyStoreClient : the current keystore client to use to create configurations. |
runUtil |
IRunUtil : the current IRunUtil to run host commands. |
globalConfig |
File : The global configuration to use to run subprocesses of TF. |
Returns |
IConfiguration |
a File pointing to the configuration XML of TF for NON_VERSIONED objects. Returns
null if no thin launcher config could be created.
|
getTradefedSandboxEnvironment
public File getTradefedSandboxEnvironment (IInvocationContext context,
IConfiguration nonVersionedConfig,
String[] args)
Returns the sandbox environment TF to be used based on the command line arguments.
Parameters |
context |
IInvocationContext : the IInvocationContext of the parent. |
nonVersionedConfig |
IConfiguration : the IConfiguration representing the non versioned objects. |
args |
String : the command line arguments. |
Returns |
File |
a ERROR(/File) directory containing the TF sandbox environment jars.
|
prepareEnvironment
public Exception prepareEnvironment (IInvocationContext context,
IConfiguration config,
ITestInvocationListener listener)
Prepare the environment for the sandbox to run properly.
Returns |
Exception |
an Exception containing the failure. or Null if successful.
|
run
public CommandResult run (IConfiguration config,
ITestLogger logger)
Run the sandbox with the environment that was set.
Parameters |
config |
IConfiguration : the IConfiguration for the command to run. |
logger |
ITestLogger : an ITestLogger where we can log files. |
Returns |
CommandResult |
a CommandResult with the status of the sandbox run and logs.
|
tearDown
public void tearDown ()
Clean up any states, files or environment that may have been changed.
Protected methods
dumpGlobalConfig
protected File dumpGlobalConfig (IConfiguration config,
exclusionPatterns)
Dump the global configuration filtered from some objects.
Parameters |
config |
IConfiguration |
exclusionPatterns |
|
Throws |
ConfigurationException |
|
prepareConfiguration
protected Exception prepareConfiguration (IInvocationContext context,
IConfiguration config,
ITestInvocationListener listener)
Prepare the IConfiguration
that will be passed to the subprocess and will drive the
container execution.
Returns |
Exception |
an Exception if anything went wrong, null otherwise.
|
Content and code samples on this page are subject to the licenses described in the Content License. Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.
Last updated 2022-08-03 UTC.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Missing the information I need","missingTheInformationINeed","thumb-down"],["Too complicated / too many steps","tooComplicatedTooManySteps","thumb-down"],["Out of date","outOfDate","thumb-down"],["Samples / code issue","samplesCodeIssue","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2022-08-03 UTC."],[],[]]