Эта страница переведена с помощью Cloud Translation API.

ISandbox

public interface ISandbox

com.android.tradefed.sandbox.ISandbox

Известные косвенные подклассы

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

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

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

Публичные методы
`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 ()

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