2025년 3월 27일부터 AOSP를 빌드하고 기여하려면 aosp-main 대신 android-latest-release를 사용하는 것이 좋습니다. 자세한 내용은 AOSP 변경사항을 참고하세요.

이 페이지는 Cloud Translation API를 통해 번역되었습니다.

InvocationExecution

public class InvocationExecution
extends Object implements IInvocationExecution

java.lang.Object
↳	com.android.tradefed.invoker.InvocationExecution

알려진 직접 서브클래스

DelegatedInvocationExecution, ParentSandboxInvocationExecution, RemoteInvocationExecution, SandboxedInvocationExecution

DelegatedInvocationExecution	`InvocationExecution`는 실행을 다른 Tradefed 바이너리에 위임합니다.
ParentSandboxInvocationExecution	샌드박스를 실행할 때 상위 호출 특수 작업의 `InvocationExecution` 버전입니다.
RemoteInvocationExecution	원격 실행을 실행하는 `InvocationExecution` 구현
SandboxedInvocationExecution	호출의 특수 샌드박스 실행: 이는 샌드박스 내에서 명령어를 실행할 때의 InvocationExection입니다.

모든 호출 단계(빌드 다운로드, target_prep, 테스트 실행, 정리)를 설명하는 클래스입니다. 일부 단계의 기본 동작을 재정의하도록 확장할 수 있습니다. 단계 순서는 TestInvocation에 따라 결정됩니다.

요약

상수
`String`	`ADB_VERSION_KEY`
`String`	`JAVA_CLASSPATH_KEY`
`String`	`JAVA_VERSION_KEY`

공개 생성자
`InvocationExecution()`

공개 메서드
`void`	`cleanUpBuilds(IInvocationContext context, IConfiguration config)` build_provider 정리 단계를 실행합니다.
`void`	`doCleanUp(IInvocationContext context, IConfiguration config, Throwable exception)` target_preparer 및 multi_target_preparer cleanUp 단계를 실행합니다.
`void`	`doSetup(TestInformation testInfo, IConfiguration config, ITestLogger listener)` target_preparer 및 multi_target_preparer setUp 단계를 실행합니다.
`void`	`doTeardown(TestInformation testInfo, IConfiguration config, ITestLogger logger, Throwable exception)` target_preparer 및 multi_target_preparer teardown 단계를 실행합니다.
`boolean`	`fetchBuild(TestInformation testInfo, IConfiguration config, IRescheduler rescheduler, ITestInvocationListener listener)` 호출의 build_provider 단계를 실행합니다.
`void`	`reportLogs(ITestDevice device, ITestLogger listener, TestInvocation.Stage stage)` 호출의 여러 단계에서 일부 기기 로그를 보고합니다.
`void`	`runDevicePostInvocationTearDown(IInvocationContext context, IConfiguration config, Throwable exception)` 호출의 각 기기 부분에 대해 `ITestDevice.postInvocationTearDown(Throwable)`를 호출합니다.
`void`	`runDevicePreInvocationSetup(IInvocationContext context, IConfiguration config, ITestLogger logger)` 호출의 각 기기 부분에 대해 `ERROR(ITestDevice.preInvocationSetup(IBuildInfo)/com.android.tradefed.device.ITestDevice#preInvocationSetup(com.android.tradefed.build.IBuildInfo) ITestDevice.preInvocationSetup(IBuildInfo))`를 호출합니다.
`void`	`runTests(TestInformation info, IConfiguration config, ITestInvocationListener listener)` 테스트를 실행합니다.
`boolean`	`shardConfig(IConfiguration config, TestInformation testInfo, IRescheduler rescheduler, ITestLogger logger)` 구성을 하위 구성으로 샤딩하여 여러 리소스에서 병렬로 실행되도록 다시 예약하려고 시도합니다.

보호된 메서드
`void`	`collectAutoInfo(IConfiguration config, TestInformation info)` 테스트 중인 기본 기기에 관한 일부 정보를 자동으로 수집합니다.
`IShardHelper`	`createShardHelper()` 사용할 `IShardHelper`을 만들어 반환합니다.
`void`	`customizeDevicePreInvocation(IConfiguration config, IInvocationContext context)` preInvocationSetup 전에 기기를 맞춤설정할 기회를 제공합니다.
`String`	`getAdbVersion()` 호출에 사용되는 adb 버전을 반환합니다.
	`getLabPreparersToRun(IConfiguration config, String deviceName)` 이 기기에서 실행할 실험실 준비자 목록을 가져옵니다.
	`getTargetPreparersToRun(IConfiguration config, String deviceName)` 이 기기에서 실행할 타겟 준비자 목록을 가져옵니다.
`void`	`linkExternalDirs(IBuildInfo info, TestInformation testInfo)`
`void`	`logHostAdb(IConfiguration config, ITestLogger logger)` $TMPDIR/adb.$UID.log에서 로그를 수집합니다.
`Throwable`	`runPreparersTearDown(TestInformation testInfo, ITestDevice device, String deviceName, int deviceIndex, ITestLogger logger, Throwable exception, preparersToRun, trackPreparersMap)`
`void`	`setTestTag(IBuildInfo info, IConfiguration config)` 빌드 정보에 테스트 태그를 설정하는 처리

상수

ADB_VERSION_KEY

public static final String ADB_VERSION_KEY

상수 값: "adb_version"

JAVA_CLASSPATH_KEY

public static final String JAVA_CLASSPATH_KEY

상수 값: 'java_classpath'

JAVA_VERSION_KEY

public static final String JAVA_VERSION_KEY

상수 값: 'java_version'

공개 생성자

InvocationExecution

public InvocationExecution ()

공개 메서드

cleanUpBuilds

public void cleanUpBuilds (IInvocationContext context, 
                IConfiguration config)

build_provider 정리 단계를 실행합니다. 빌드 가져오기와 연결됩니다.

매개변수
`context`	`IInvocationContext`: 호출의 `IInvocationContext`입니다.
`config`	`IConfiguration`: 이 테스트 실행의 `IConfiguration`입니다.

doCleanUp

public void doCleanUp (IInvocationContext context, 
                IConfiguration config, 
                Throwable exception)

target_preparer 및 multi_target_preparer cleanUp 단계를 실행합니다. 기기를 정리합니다.

매개변수
`context`	`IInvocationContext`: 호출의 `IInvocationContext`입니다.
`config`	`IConfiguration`: 이 테스트 실행의 `IConfiguration`입니다.
`exception`	`Throwable`: 테스트 실행에서 발생한 원래 예외입니다.

doSetup

public void doSetup (TestInformation testInfo, 
                IConfiguration config, 
                ITestLogger listener)

target_preparer 및 multi_target_preparer setUp 단계를 실행합니다. 테스트 실행에 필요한 모든 기기 설정을 실행합니다.

매개변수
`testInfo`	`TestInformation`: 호출의 `TestInformation`입니다.
`config`	`IConfiguration`: 이 테스트 실행의 `IConfiguration`입니다.
`listener`	`ITestLogger`: 설정 실패 로그를 보고할 `ITestLogger`입니다.

생성 값
`BuildError`
`DeviceNotAvailableException`
`TargetSetupError`

doTeardown

public void doTeardown (TestInformation testInfo, 
                IConfiguration config, 
                ITestLogger logger, 
                Throwable exception)

target_preparer 및 multi_target_preparer teardown 단계를 실행합니다. 설정과 연결된 기기를 해체합니다.

매개변수
`testInfo`	`TestInformation`: 호출의 `TestInformation`입니다.
`config`	`IConfiguration`: 이 테스트 실행의 `IConfiguration`입니다.
`logger`	`ITestLogger`: 로그를 보고할 `ITestLogger`입니다.
`exception`	`Throwable`: 테스트 실행에서 발생한 원래 예외입니다.

fetchBuild

public boolean fetchBuild (TestInformation testInfo, 
                IConfiguration config, 
                IRescheduler rescheduler, 
                ITestInvocationListener listener)

호출의 build_provider 단계를 실행합니다.

매개변수
`testInfo`	`TestInformation`: 호출의 `TestInformation`입니다.
`config`	`IConfiguration`: 이 테스트 실행의 `IConfiguration`입니다.
`rescheduler`	`IRescheduler`: 다른 리소스에서 실행되도록 호출의 일부를 다시 예약하는 데 사용되는 `IRescheduler`
`listener`	`ITestInvocationListener`: 빌드 다운로드 실패를 보고하는 `ITestInvocation`입니다.

반환 값
`boolean`	빌드를 성공적으로 다운로드한 경우 true, 그렇지 않은 경우 false입니다.

생성 값
`BuildRetrievalError`
`DeviceNotAvailableException`

reportLogs

public void reportLogs (ITestDevice device, 
                ITestLogger listener, 
                TestInvocation.Stage stage)

호출의 여러 단계에서 일부 기기 로그를 보고합니다. 예: logcat

매개변수
`device`	`ITestDevice`: 로그를 보고할 기기입니다.
`listener`	`ITestLogger`: 로그의 로거입니다.
`stage`	`TestInvocation.Stage`: 현재 호출 단계입니다.

runDevicePostInvocationTearDown

public void runDevicePostInvocationTearDown (IInvocationContext context, 
                IConfiguration config, 
                Throwable exception)

호출의 각 기기 부분에 대해 ITestDevice.postInvocationTearDown(Throwable)를 호출합니다.

매개변수
`context`	`IInvocationContext`: 호출의 `IInvocationContext`입니다.
`config`	`IConfiguration`: 이 테스트 실행의 `IConfiguration`입니다.
`exception`	`Throwable`: 실행 중인 테스트에서 발생한 원래 예외(있는 경우)

runDevicePreInvocationSetup

public void runDevicePreInvocationSetup (IInvocationContext context, 
                IConfiguration config, 
                ITestLogger logger)

호출의 각 기기 부분에 대해 ERROR(ITestDevice.preInvocationSetup(IBuildInfo)/com.android.tradefed.device.ITestDevice#preInvocationSetup(com.android.tradefed.build.IBuildInfo) ITestDevice.preInvocationSetup(IBuildInfo))를 호출합니다.

매개변수
`context`	`IInvocationContext`: 호출의 `IInvocationContext`입니다.
`config`	`IConfiguration`: 이 테스트 실행의 `IConfiguration`입니다.
`logger`	`ITestLogger`: 로그를 보고할 `ITestLogger`입니다.

생성 값
`DeviceNotAvailableException`
`TargetSetupError`

runTests

public void runTests (TestInformation info, 
                IConfiguration config, 
                ITestInvocationListener listener)

테스트를 실행합니다.

매개변수
`info`	`TestInformation`: 테스트를 실행할 `TestInformation`입니다.
`config`	`IConfiguration`: 실행할 `IConfiguration`
`listener`	`ITestInvocationListener`: 테스트 결과의 `ITestInvocationListener`

shardConfig

public boolean shardConfig (IConfiguration config, 
                TestInformation testInfo, 
                IRescheduler rescheduler, 
                ITestLogger logger)

구성을 하위 구성으로 샤딩하여 여러 리소스에서 병렬로 실행되도록 다시 예약하려고 시도합니다.

샤드 수가 1보다 큰 경우 샤드 색인을 설정하고 다시 예약하여 각 샤드의 구성을 만듭니다. 샤드 수가 설정되지 않은 경우 IShardHelper.shardConfig로 대체됩니다.

매개변수
`config`	`IConfiguration`: 현재 `IConfiguration`입니다.
`testInfo`	`TestInformation`: 테스트 정보를 보유하는 `TestInformation`입니다.
`rescheduler`	`IRescheduler`: `IRescheduler`
`logger`	`ITestLogger`: 샤딩 중에 파일을 로깅하는 데 사용되는 `ITestLogger`입니다.

반환 값
`boolean`	테스트가 샤딩된 경우 true입니다. 그렇지 않으면 `false`를 반환합니다.

보호된 메서드

collectAutoInfo

protected void collectAutoInfo (IConfiguration config, 
                TestInformation info)

테스트 중인 기본 기기에 관한 일부 정보를 자동으로 수집합니다.

매개변수
`config`	`IConfiguration`
`info`	`TestInformation`

생성 값
`DeviceNotAvailableException`

createShardHelper

protected IShardHelper createShardHelper ()

사용할 IShardHelper을 만들어 반환합니다.

반환 값
`IShardHelper`

customizeDevicePreInvocation

protected void customizeDevicePreInvocation (IConfiguration config, 
                IInvocationContext context)

preInvocationSetup 전에 기기를 맞춤설정할 기회를 제공합니다.

매개변수
`config`	`IConfiguration`: 호출의 구성입니다.
`context`	`IInvocationContext`: 현재 호출 컨텍스트입니다.

getAdbVersion

protected String getAdbVersion ()

호출에 사용되는 adb 버전을 반환합니다.

반환 값
`String`

getLabPreparersToRun

protected  getLabPreparersToRun (IConfiguration config, 
                String deviceName)

이 기기에서 실행할 실험실 준비자 목록을 가져옵니다.

샌드박스 클래스에서 재정의되어 실습 준비자가 샌드박스 자식 내에서 실행되지 않도록 제한합니다.

매개변수
`config`	`IConfiguration`
`deviceName`	`String`

반환 값

getTargetPreparersToRun

protected  getTargetPreparersToRun (IConfiguration config, 
                String deviceName)

이 기기에서 실행할 타겟 준비자 목록을 가져옵니다.

샌드박스 클래스에서 재정의되어 실습 준비자가 샌드박스 하위 항목 내에서 실행되지 않도록 제한합니다.

매개변수
`config`	`IConfiguration`
`deviceName`	`String`

반환 값

linkExternalDirs

protected void linkExternalDirs (IBuildInfo info, 
                TestInformation testInfo)

매개변수
`info`	`IBuildInfo`
`testInfo`	`TestInformation`

logHostAdb

protected void logHostAdb (IConfiguration config, 
                ITestLogger logger)

$TMPDIR/adb.$UID.log에서 로그를 수집합니다.

매개변수
`config`	`IConfiguration`
`logger`	`ITestLogger`

runPreparersTearDown

protected Throwable runPreparersTearDown (TestInformation testInfo, 
                ITestDevice device, 
                String deviceName, 
                int deviceIndex, 
                ITestLogger logger, 
                Throwable exception, 
                 preparersToRun, 
                 trackPreparersMap)

매개변수
`testInfo`	`TestInformation`
`device`	`ITestDevice`
`deviceName`	`String`
`deviceIndex`	`int`
`logger`	`ITestLogger`
`exception`	`Throwable`
`preparersToRun`
`trackPreparersMap`

반환 값
`Throwable`

setTestTag

protected void setTestTag (IBuildInfo info, 
                IConfiguration config)

빌드 정보에 테스트 태그를 설정하는 처리

매개변수
`info`	`IBuildInfo`
`config`	`IConfiguration`