Начиная с 2026 года, в соответствии с нашей моделью стабильной разработки основной ветки и для обеспечения стабильности платформы для экосистемы, мы будем публиковать исходный код в AOSP во 2-м и 4-м кварталах. Для сборки и внесения вклада в AOSP используйте ветку android-latest-release . Ветка android-latest-release manifest всегда будет ссылаться на самый последний релиз, выпущенный в AOSP. Для получения дополнительной информации см. раздел «Изменения в AOSP» .

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

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 ()

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