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

Google은 AI 기술을 사용하여 콘텐츠를 사용자의 기본 언어로 번역합니다. AI 번역에는 오류가 있을 수 있습니다.

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

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