ISandbox

public interface ISandbox

com.android.tradefed.sandbox.ISandbox

Известные косвенные подклассы GoogleTradefedSandbox , TradefedSandbox GoogleTradefedSandbox Внутренняя специализация TradefedSandbox для использования в лабораторной инфраструктуре. TradefedSandbox Песочница, позволяющая запускать вызовы Торговой федерации.

---

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

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

Общедоступные методы
abstract String	createClasspath (File workingDir) Создайте путь к классам на основе среды и рабочего каталога, возвращаемых функцией getTradefedSandboxEnvironment(IInvocationContext,IConfiguration,String[]) .
abstract IConfiguration	createThinLauncherConfig (String[] args, IKeyStoreClient keyStoreClient, IRunUtil runUtil, File globalConfig) Специальный режим, отключенный от основного запуска: если конфигурация, по-видимому, отсутствует в родительском процессе, мы переключаемся на тонкий лаунчер, где пытаемся настроить песочницу с использованием имеющейся информации и заполнить рабочий каталог, чтобы полностью создать конфигурацию в каталоге с версиями.
default Map<String, List<String>>	discoverTests ( IInvocationContext context, IConfiguration configuration) Подэтап функции prepareEnvironment(IInvocationContext,IConfiguration,ITestInvocationListener) , который обнаруживает тесты, если включена SandboxOptions.shouldUseTestDiscovery() .
default Map<String, List<String>>	discoverTests ( IInvocationContext context, IConfiguration configuration, ITestLogger logger)
default IFolderBuildInfo	fetchSandboxExtraArtifacts ( IInvocationContext context, IConfiguration configuration, String[] args) Подэтап функции prepareEnvironment(IInvocationContext,IConfiguration,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 () Удалите все измененные состояния, файлы или окружения.

Общедоступные методы

создатьClasspath

public abstract String createClasspath (File workingDir)

Создайте путь к классам на основе среды и рабочего каталога, возвращаемых функцией getTradefedSandboxEnvironment(IInvocationContext,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 : Глобальная конфигурация для запуска дочерних процессов TensorFlow.

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

discoverTests

public Map<String, List<String>> discoverTests (IInvocationContext context, 
                IConfiguration configuration)

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

Параметры
context	IInvocationContext : текущий вызов IInvocationContext .
configuration	IConfiguration : IConfiguration — это IConfiguration , в соответствии с которой будет выполняться команда.

Возвраты
Map<String, List<String>>	Карта обнаруженных тестов или значение null, если тест не поддерживается или не пройден.

discoverTests

public Map<String, List<String>> discoverTests (IInvocationContext context, 
                IConfiguration configuration, 
                ITestLogger logger)

Параметры
context	IInvocationContext
configuration	IConfiguration
logger	ITestLogger

Возвраты
Map<String, List<String>>

fetchSandboxExtraArtifacts

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

Подэтап функции prepareEnvironment(IInvocationContext,IConfiguration,ITestInvocationListener) , который загружает дополнительные файлы, необходимые для песочницы.

Параметры
context	IInvocationContext : текущий вызов IInvocationContext .
configuration	IConfiguration : IConfiguration — это IConfiguration , в соответствии с которой будет выполняться команда.
args	String : аргументы командной строки.

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

Броски
	com.android.tradefed.build.BuildRetrievalError
	com.android.tradefed.config.ConfigurationException
	java.io.IOException
BuildRetrievalError
ConfigurationException
IOException

getTradefedSandboxEnvironment

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

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

Параметры
context	IInvocationContext : IInvocationContext родительского объекта.
nonVersionedConfig	IConfiguration : объект IConfiguration представляющий неверсионированные объекты.
args	String : аргументы командной строки.

Возвраты
File	Каталог File , содержащий JAR-файлы среды песочницы TF.

Броски
Exception

getTradefedSandboxEnvironment

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

Параметры
context	IInvocationContext
nonVersionedConfig	IConfiguration
logger	ITestLogger
args	String

Возвраты
File

Броски
Exception

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

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

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

Параметры
context	IInvocationContext : текущий вызов IInvocationContext .
configuration	IConfiguration : IConfiguration — это IConfiguration , в соответствии с которой будет выполняться команда.
listener	ITestInvocationListener : текущий вызов ITestInvocationListener куда следует передавать окончательные результаты.

Возвраты
Exception	Exception содержащее информацию о сбое. Или значение Null в случае успеха.

бегать

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

Запустите песочницу с заданными параметрами среды.

Параметры
info	TestInformation : TestInformation описывающая вызов.
configuration	IConfiguration : IConfiguration — это IConfiguration , в соответствии с которой будет выполняться команда.
logger	ITestLogger : это ITestLogger , в котором можно записывать данные в файлы.

Возвраты
CommandResult	CommandResult , содержащий статус выполнения тестовой среды и журналы.

Броски
Throwable

срывать

public abstract void tearDown ()

Удалите все измененные состояния, файлы или окружения.