ISandbox

public interface ISandbox

com.android.tradefed.sandbox.ISandbox


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

요약

공개 메서드

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)

SandboxOptions.shouldUseTestDiscovery()가 사용 설정되어 있는지 테스트를 감지하는 prepareEnvironment(com.android.tradefed.invoker.IInvocationContext, com.android.tradefed.config.IConfiguration, com.android.tradefed.result.ITestInvocationListener)의 하위 단계입니다.

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

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

공개 메서드

createClasspath

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 NON_VERSIONED 객체의 TF 구성 XML을 가리키는 파일입니다. 씬 런처 구성을 만들 수 없는 경우 null을 반환합니다.

discoverTests

public  discoverTests (IInvocationContext context, 
                IConfiguration configuration)

SandboxOptions.shouldUseTestDiscovery()가 사용 설정되어 있는지 테스트를 감지하는 prepareEnvironment(com.android.tradefed.invoker.IInvocationContext, com.android.tradefed.config.IConfiguration, com.android.tradefed.result.ITestInvocationListener)의 하위 단계입니다.

매개변수
context IInvocationContext: 현재 호출 IInvocationContext입니다.

configuration IConfiguration: 실행할 명령어의 IConfiguration입니다.

반환 값
발견된 테스트의 맵 또는 지원되지 않거나 실패한 경우 null입니다.

discoverTests

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.BuildRetrievalError
com.android.tradefed.config.ConfigurationException
IOException
BuildRetrievalError
ConfigurationException

getTradefedSandboxEnvironment

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

명령줄 인수를 기반으로 사용할 샌드박스 환경 TF를 반환합니다.

매개변수
context IInvocationContext: 상위 요소의 IInvocationContext입니다.

nonVersionedConfig IConfiguration: 버전 관리되지 않는 객체를 나타내는 IConfiguration입니다.

args String: 명령줄 인수입니다.

반환 값
File TF 샌드박스 환경 jar가 포함된 ERROR(/File) 디렉터리

getTradefedSandboxEnvironment

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

매개변수
context IInvocationContext

nonVersionedConfig IConfiguration

logger ITestLogger

args String

반환 값
File

prepareEnvironment

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

tearDown

public abstract void tearDown ()

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