TradefedSandbox

public class TradefedSandbox
extends Object implements ISandbox

java.lang.Object
↳ com.android.tradefed.sandbox.TradefedSandbox

Контейнер-песочница, который может запускать вызов Торговой федерации. TODO: разрешить передачу параметров в песочницу.

Краткое содержание

Константы

String EXTRA_TARGET_LAB

String GENERAL_TESTS_ZIP

String SANDBOX_ENABLED

Публичные конструкторы

TradefedSandbox ()

Публичные методы

String createClasspath (File workingDir)

Создайте путь к классам на основе среды и рабочего каталога, возвращаемого ISandbox.getTradefedSandboxEnvironment(com.android.tradefed.invoker.IInvocationContext, com.android.tradefed.config.IConfiguration, String[]) .

IConfiguration createThinLauncherConfig (String[] args, IKeyStoreClient keyStoreClient, IRunUtil runUtil, File globalConfig)

Специальный режим, отключенный от основного запуска: если конфигурация не существует в родительском объекте, мы возвращаемся к тонкому лаунчеру, где пытаемся настроить песочницу с использованием известной на данный момент информации и заполнить рабочий каталог, чтобы полностью создать конфигурацию в версионном каталоге.

File getTradefedSandboxEnvironment ( IInvocationContext context, IConfiguration nonVersionedConfig, ITestLogger logger, String[] args)
static matchSandboxExtraBuildTargetByConfigName (String configName)

Учитывая имя конфигурации теста, сопоставьте дополнительные цели сборки с дополнительными целями сборки Sandbox.

Exception prepareEnvironment ( IInvocationContext context, IConfiguration config, ITestInvocationListener listener)

Подготовьте среду для корректной работы песочницы.

CommandResult run ( TestInformation info, IConfiguration config, ITestLogger logger)

Запустите песочницу с настроенной средой.

void tearDown ()

Очистите все состояния, файлы и окружение, которые могли быть изменены.

Защищенные методы

File dumpGlobalConfig ( IConfiguration config, exclusionPatterns)

Вывести глобальную конфигурацию, отфильтрованную из некоторых объектов.

String getJava ()
Exception prepareConfiguration ( IInvocationContext context, IConfiguration config, ITestInvocationListener listener)

Подготовьте IConfiguration , который будет передан в подпроцесс и будет управлять выполнением контейнера.

File prepareContext ( IInvocationContext context, IConfiguration config)

Подготовьте и сериализуйте IInvocationContext .

Константы

EXTRA_TARGET_LAB 

public static final String EXTRA_TARGET_LAB

Постоянное значение: «lab»

ОБЩИЕ_ТЕСТЫ_ZIP 

public static final String GENERAL_TESTS_ZIP

Постоянное значение: "general-tests.zip"

SANDBOX_ENABLED 

public static final String SANDBOX_ENABLED

Постоянное значение: «SANDBOX_ENABLED»

Публичные конструкторы

TradefedSandbox 

public TradefedSandbox ()

Публичные методы

createClasspath 

public String createClasspath (File workingDir)

Создайте путь к классам на основе среды и рабочего каталога, возвращаемого ISandbox.getTradefedSandboxEnvironment(com.android.tradefed.invoker.IInvocationContext, com.android.tradefed.config.IConfiguration, String[]) .

Параметры
workingDir File : текущий рабочий каталог песочницы.

Возврат
String Путь к классам, который будет использоваться.

Броски
ConfigurationException

createThinLauncherConfig 

public IConfiguration createThinLauncherConfig (String[] args, 
                IKeyStoreClient keyStoreClient, 
                IRunUtil runUtil, 
                File globalConfig)

Специальный режим, отключенный от основного запуска: если конфигурация не существует в родительском объекте, мы возвращаемся к тонкому лаунчеру, где пытаемся настроить песочницу с использованием известной на данный момент информации и заполнить рабочий каталог, чтобы полностью создать конфигурацию в версионном каталоге.

Параметры
args String : Исходные аргументы командной строки.

keyStoreClient IKeyStoreClient : текущий клиент хранилища ключей, используемый для создания конфигураций.

runUtil IRunUtil : текущий IRunUtil для запуска команд хоста.

globalConfig File : глобальная конфигурация, используемая для запуска подпроцессов TF.

Возврат
IConfiguration Файл, указывающий на XML-конфигурацию TF для объектов NON_VERSIONED. Возвращает значение null, если не удалось создать конфигурацию тонкого средства запуска.

getTradefedSandboxEnvironment 

public File getTradefedSandboxEnvironment (IInvocationContext context, 
                IConfiguration nonVersionedConfig, 
                ITestLogger logger, 
                String[] args)

Параметры
context IInvocationContext

nonVersionedConfig IConfiguration

logger ITestLogger

args String

Возврат
File

matchSandboxExtraBuildTargetByConfigName 

public static  matchSandboxExtraBuildTargetByConfigName (String configName)

Учитывая имя конфигурации теста, сопоставьте дополнительные цели сборки с дополнительными целями сборки Sandbox.

Параметры
configName String

Возврат

подготовьте окружающую среду 

public Exception prepareEnvironment (IInvocationContext context, 
                IConfiguration config, 
                ITestInvocationListener listener)

Подготовьте среду для корректной работы песочницы.

Параметры
context IInvocationContext : текущий вызов IInvocationContext .

config IConfiguration : IConfiguration для запуска команды.

listener ITestInvocationListener : текущий вызов ITestInvocationListener куда должны быть переданы окончательные результаты.

Возврат
Exception Exception содержащее ошибку. или Null в случае успеха.

бегать 

public CommandResult run (TestInformation info, 
                IConfiguration config, 
                ITestLogger logger)

Запустите песочницу с настроенной средой.

Параметры
info TestInformation : TestInformation , описывающая вызов

config IConfiguration : IConfiguration для запуска команды.

logger ITestLogger : ITestLogger , где мы можем регистрировать файлы.

Возврат
CommandResult CommandResult со статусом запуска песочницы и журналами.

срывать 

public void tearDown ()

Очистите все состояния, файлы и окружение, которые могли быть изменены.

Защищенные методы

dumpGlobalConfig 

protected File dumpGlobalConfig (IConfiguration config, 
                 exclusionPatterns)

Вывести глобальную конфигурацию, отфильтрованную из некоторых объектов.

Параметры
config IConfiguration

exclusionPatterns

Возврат
File

Броски
ConfigurationException

получитьJava 

protected String getJava ()

Возврат
String

подготовитьКонфигурацию 

protected Exception prepareConfiguration (IInvocationContext context, 
                IConfiguration config, 
                ITestInvocationListener listener)

Подготовьте IConfiguration , который будет передан в подпроцесс и будет управлять выполнением контейнера.

Параметры
context IInvocationContext : Текущий IInvocationContext .

config IConfiguration : IConfiguration , который необходимо подготовить.

listener ITestInvocationListener : Текущий вызов ITestInvocationListener .

Возврат
Exception Исключение, если что-то пошло не так, в противном случае — null.

подготовитьКонтекст 

protected File prepareContext (IInvocationContext context, 
                IConfiguration config)

Подготовьте и сериализуйте IInvocationContext .

Параметры
context IInvocationContext : IInvocationContext , который необходимо подготовить.

config IConfiguration : IConfiguration песочницы.

Возврат
File сериализованный IInvocationContext .

Броски
IOException