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에 의해 결정됩니다.

요약

필드
`public static final String`	`ADB_VERSION_KEY`
`public static final String`	`JAVA_CLASSPATH_KEY`
`public static final 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 버전을 반환합니다.
	`getPreparersToRun(IConfiguration config, String deviceName)` 이 기기에서 실행할 준비 도구 목록을 가져옵니다.
`void`	`logHostAdb(IConfiguration config, ITestLogger logger)` $TMPDIR/adb.$UID.log에서 로그를 수집합니다.
`void`	`runPreparersSetup(TestInformation testInfo, IConfiguration config, ITestLogger listener)`
`Throwable`	`runPreparersTearDown(TestInformation testInfo, ITestDevice device, String deviceName, int deviceIndex, ITestLogger logger, Throwable exception, preparersToRun)`
`void`	`setTestTag(IBuildInfo info, IConfiguration config)` 빌드 정보에서 테스트 태그 설정을 처리합니다.

필드

ADB_VERSION_KEY

public static final String ADB_VERSION_KEY

JAVA_CLASSPATH_KEY

public static final String JAVA_CLASSPATH_KEY

JAVA_VERSION_KEY

public static final String JAVA_VERSION_KEY

공개 생성자

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`

getPreparersToRun

protected  getPreparersToRun (IConfiguration config, 
                String deviceName)

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

실습 준비 도구가 샌드박스 하위 요소 내에서 실행되지 않도록 제한하기 위해 샌드박스 클래스에서 재정의됨

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

반환 값

logHostAdb

protected void logHostAdb (IConfiguration config, 
                ITestLogger logger)

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

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

runPreparersSetup

protected void runPreparersSetup (TestInformation testInfo, 
                IConfiguration config, 
                ITestLogger listener)

매개변수
`testInfo`	`TestInformation`
`config`	`IConfiguration`
`listener`	`ITestLogger`

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

runPreparersTearDown

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

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

반환 값
`Throwable`

setTestTag

protected void setTestTag (IBuildInfo info, 
                IConfiguration config)

빌드 정보에서 테스트 태그 설정을 처리합니다.

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