ISandbox

public interface ISandbox

com.android.tradefed.sandbox.ISandbox


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

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

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

abstract String createClasspath (File workingDir)

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

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

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

default discoverTests ( IInvocationContext context, IConfiguration configuration)

Подэтап prepareEnvironment(com.android.tradefed.invoker.IInvocationContext, com.android.tradefed.config.IConfiguration, com.android.tradefed.result.ITestInvocationListener) , который обнаруживает тесты, если включен SandboxOptions.shouldUseTestDiscovery() .

default discoverTests ( IInvocationContext context, IConfiguration configuration, ITestLogger logger)
default IFolderBuildInfo fetchSandboxExtraArtifacts ( IInvocationContext context, IConfiguration configuration, String[] args)

Подшаг prepareEnvironment(com.android.tradefed.invoker.IInvocationContext, com.android.tradefed.config.IConfiguration, com.android.tradefed.result.ITestInvocationListener) , который извлекает дополнительные файлы, необходимые для песочницы.

default File getTradefedSandboxEnvironment ( IInvocationContext context, IConfiguration nonVersionedConfig, String[] args)

Возвращает TF среды песочницы, которая будет использоваться на основе аргументов командной строки.

default File getTradefedSandboxEnvironment ( IInvocationContext context, IConfiguration nonVersionedConfig, ITestLogger logger, String[] args)
abstract Exception prepareEnvironment ( IInvocationContext context, IConfiguration configuration, ITestInvocationListener listener)

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

abstract CommandResult run ( TestInformation info, IConfiguration configuration, ITestLogger logger)

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

abstract void tearDown ()

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

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

создать путь к классу

public abstract String createClasspath (File workingDir)

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

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

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

Броски
ConfigurationException

createThinLauncherConfig

public abstract 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, если не удалось создать тонкую конфигурацию запуска.

Откройте для себяТесты

public  discoverTests (IInvocationContext context, 
                IConfiguration configuration)

Подэтап prepareEnvironment(com.android.tradefed.invoker.IInvocationContext, com.android.tradefed.config.IConfiguration, com.android.tradefed.result.ITestInvocationListener) , который обнаруживает тесты, если включен SandboxOptions.shouldUseTestDiscovery() .

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

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

Возврат
Карта обнаруженных тестов или значение null, если они не поддерживаются или не удались.

Откройте для себяТесты

public  discoverTests (IInvocationContext context, 
                IConfiguration configuration, 
                ITestLogger logger)

Параметры
context IInvocationContext

configuration IConfiguration

logger ITestLogger

Возврат

fetchSandboxExtraArtifacts

public IFolderBuildInfo fetchSandboxExtraArtifacts (IInvocationContext context, 
                IConfiguration configuration, 
                String[] args)

Подшаг prepareEnvironment(com.android.tradefed.invoker.IInvocationContext, com.android.tradefed.config.IConfiguration, com.android.tradefed.result.ITestInvocationListener) , который извлекает дополнительные файлы, необходимые для песочницы.

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

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

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

Возврат
IFolderBuildInfo полученная сборка для дополнительных файлов в песочнице.

Броски
com.android.tradefed.build.BuildRetrivalError
com.android.tradefed.config.ConfigurationException
Исключение IO
BuildRetrievalError
ConfigurationException

getTradefedSandboxEnvironment

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

Возвращает TF среды песочницы, которая будет использоваться на основе аргументов командной строки.

Параметры
context IInvocationContext : IInvocationContext родительского объекта.

nonVersionedConfig IConfiguration : IConfiguration , представляющий объекты без версии.

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

Возврат
File каталог ERROR(/File) , содержащий файлы jar среды песочницы TF.

getTradefedSandboxEnvironment

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

Параметры
context IInvocationContext

nonVersionedConfig IConfiguration

logger ITestLogger

args String

Возврат
File

подготовить среду

public abstract Exception prepareEnvironment (IInvocationContext context, 
                IConfiguration configuration, 
                ITestInvocationListener listener)

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

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

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

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

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

бегать

public abstract CommandResult run (TestInformation info, 
                IConfiguration configuration, 
                ITestLogger logger)

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

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

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

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

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

срывать

public abstract void tearDown ()

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