2026년부터 트렁크 안정 개발 모델과 일치하고 생태계의 플랫폼 안정성을 보장하기 위해 2분기와 4분기에 AOSP에 소스 코드를 게시합니다. AOSP를 빌드하고 기여하려면 android-latest-release를 사용하세요. android-latest-release 매니페스트 브랜치는 항상 AOSP에 푸시된 최신 버전을 참조합니다. 자세한 내용은 AOSP 변경사항을 참고하세요.

Google uses AI technology to translate content into your preferred language. AI translations can contain errors.

ISandbox

public interface ISandbox

com.android.tradefed.sandbox.ISandbox

알려진 간접 하위 클래스

GoogleTradefedSandbox, TradefedSandbox

GoogleTradefedSandbox	실습 인프라에서 사용할 `TradefedSandbox`의 내부 전문화
TradefedSandbox	Trade Federation 호출을 실행할 수 있는 샌드박스 컨테이너

호출을 실행하는 데 사용할 수 있는 샌드박스를 정의하는 인터페이스

요약

공개 메서드
`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)` `SandboxOptions.shouldUseTestDiscovery()`이 사용 설정된 경우 테스트를 검색하는 `prepareEnvironment(IInvocationContext,IConfiguration,ITestInvocationListener)`의 하위 단계입니다.
`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()` 변경되었을 수 있는 상태, 파일 또는 환경을 정리합니다.

공개 메서드

createClasspath

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`: TF의 하위 프로세스를 실행하는 데 사용할 전역 구성입니다.

반환
`IConfiguration`	버전이 지정되지 않은 객체의 TF 구성 XML을 가리키는 파일 씬 런처 구성을 만들 수 없는 경우 null을 반환합니다.

discoverTests

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

SandboxOptions.shouldUseTestDiscovery()이 사용 설정된 경우 테스트를 검색하는 prepareEnvironment(IInvocationContext,IConfiguration,ITestInvocationListener)의 하위 단계입니다.

매개변수
`context`	`IInvocationContext`: 현재 호출 `IInvocationContext`입니다.
`configuration`	`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`입니다.
`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`	TF 샌드박스 환경 jar가 포함된 `File` 디렉터리

생성 값
`Exception`

getTradefedSandboxEnvironment

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

매개변수
`context`	`IInvocationContext`
`nonVersionedConfig`	`IConfiguration`
`logger`	`ITestLogger`
`args`	`String`

반환
`File`

생성 값
`Exception`

prepareEnvironment

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

샌드박스가 올바르게 실행되도록 환경을 준비합니다.

매개변수
`context`	`IInvocationContext`: 현재 호출 `IInvocationContext`입니다.
`configuration`	`IConfiguration`: 실행할 명령어의 `IConfiguration`입니다.
`listener`	`ITestInvocationListener`: 최종 결과를 파이프해야 하는 현재 호출 `ITestInvocationListener`입니다.

반환
`Exception`	실패를 포함하는 `Exception` 또는 성공한 경우 Null

run

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

설정된 환경으로 샌드박스를 실행합니다.

매개변수
`info`	`TestInformation`: 호출을 설명하는 `TestInformation`
`configuration`	`IConfiguration`: 실행할 명령어의 `IConfiguration`입니다.
`logger`	`ITestLogger`: 로그 파일을 기록할 수 있는 `ITestLogger`입니다.

반환
`CommandResult`	샌드박스 실행 상태 및 로그가 포함된 `CommandResult`

생성 값
`Throwable`

tearDown

public abstract void tearDown ()

변경되었을 수 있는 상태, 파일 또는 환경을 정리합니다.