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.

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 버전을 반환합니다.
`List<ITargetPreparer>`	`getLabPreparersToRun(IConfiguration config, String deviceName)` 이 기기에서 실행할 실험실 준비자 목록을 가져옵니다.
`List<ITargetPreparer>`	`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, List<ITargetPreparer> preparersToRun, Map<String, Set<ITargetPreparer>> 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`: 테스트 실행에서 발생한 원래 예외입니다.

생성 값
`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`

생성 값
`Throwable`

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 List<ITargetPreparer> getLabPreparersToRun (IConfiguration config, 
                String deviceName)

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

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

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

반환
`List<ITargetPreparer>`

getTargetPreparersToRun

protected List<ITargetPreparer> getTargetPreparersToRun (IConfiguration config, 
                String deviceName)

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

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

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

반환
`List<ITargetPreparer>`

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, 
                List<ITargetPreparer> preparersToRun, 
                Map<String, Set<ITargetPreparer>> trackPreparersMap)

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

반환
`Throwable`

setTestTag

protected void setTestTag (IBuildInfo info, 
                IConfiguration config)

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

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