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

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

TestInvocation

public class TestInvocation
extends Object implements ITestInvocation

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

ITestInvocation의 기본 구현입니다.

IConfiguration를 기반으로 주요 객체를 로드합니다. - 빌드를 검색합니다. - 타겟을 준비합니다. - 테스트를 실행합니다. - 결과를 보고합니다.

요약

상수
`long`	`AVAILABILITY_CHECK_TIMEOUT`

필드
`public static final String`	`COMMAND_ARGS_KEY` 명령줄 인수 속성의 키입니다.
`public static final String`	`INVOCATION_EXTERNAL_DEPENDENCIES`
`public static final String`	`TRADEFED_CONFIG_NAME`
`public static final String`	`TRADEFED_END_HOST_LOG`
`public static final String`	`TRADEFED_INVOC_COMPLETE_HOST_LOG`
`public static final String`	`TRADEFED_LOG_NAME`

공개 생성자
`TestInvocation()`

공개 메서드
`static IBuildInfo`	`backFillBuildInfoForReporting(String commandLine)` 다운로드 실패 시 보고를 위해 명령줄을 사용하여 `IBuildInfo`를 백필하는 도우미입니다.
`static FailureDescription`	`createFailureFromException(Throwable exception, TestRecordProto.FailureStatus defaultStatus)` 호출 예외에서 `FailureDescription`를 만듭니다.
`IInvocationExecution`	`createInvocationExec(TestInvocation.RunMode mode)` 따라야 할 호출 경로를 만듭니다.
`static String`	`getDeviceLogName(TestInvocation.Stage stage)`
`static String`	`getEmulatorLogName(TestInvocation.Stage stage)`
`ITestInvocation.ExitInformation`	`getExitInfo()` 지정된 호출의 종료 정보입니다.
`void`	`invoke(IInvocationContext context, IConfiguration config, IRescheduler rescheduler, ITestInvocationListener... extraListeners)` 테스트 호출을 실행합니다.
`static boolean`	`isSubprocess(IConfiguration config)` 호출이 현재 하위 프로세스 범위 내에 있으면 true를 반환합니다.
`void`	`notifyInvocationForceStopped(String message, ErrorIdentifier errorId)` TradeFed 중지를 요청했음을 `TestInvocation`에 알립니다.
`void`	`notifyInvocationStopped(String message)` `TestInvocation`에 TradeFed가 종료될 예정임을 알립니다.
`static void`	`printStageDelimiter(TestInvocation.Stage phase, boolean end)` 호출의 지정된 스테이지에 대한 구분 기호를 출력합니다.
`void`	`registerExecutionFiles(ExecutionFiles executionFiles)`
`void`	`setClearcutClient(ClearcutClient client)` 측정항목을 보고하도록 clearcut 클라이언트를 전달합니다.
`static boolean`	`shouldSkipBugreportError(Throwable t)` 버그 신고를 건너뛰어야 하는 경우 오류를 식별하는 도우미 메서드
`String`	`toString()`

보호된 메서드
`void`	`addInvocationMetric(InvocationMetricLogger.InvocationMetricKey key, String value)`
`void`	`addInvocationMetric(InvocationMetricLogger.InvocationMetricKey key, long value)`
`void`	`applyAutomatedReporters(IConfiguration config)`
`void`	`setExitCode(CommandRunner.ExitCode code, Throwable stack)` 종료 코드를 설정하는 도우미입니다.

상수

AVAILABILITY_CHECK_TIMEOUT

public static final long AVAILABILITY_CHECK_TIMEOUT

상수 값: 180000 (0x000000000002bf20)

필드

COMMAND_ARGS_KEY

public static final String COMMAND_ARGS_KEY

명령줄 인수 속성의 키입니다.

INVOCATION_EXTERNAL_DEPENDENCIES

public static final String INVOCATION_EXTERNAL_DEPENDENCIES

TRADEFED_CONFIG_NAME

public static final String TRADEFED_CONFIG_NAME

TRADEFED_END_HOST_LOG

public static final String TRADEFED_END_HOST_LOG

TRADEFED_INVOC_COMPLETE_HOST_LOG

public static final String TRADEFED_INVOC_COMPLETE_HOST_LOG

TRADEFED_LOG_NAME

public static final String TRADEFED_LOG_NAME

공개 생성자

TestInvocation

public TestInvocation ()

공개 메서드

backFillBuildInfoForReporting

public static IBuildInfo backFillBuildInfoForReporting (String commandLine)

다운로드 실패 시 보고를 위해 명령줄을 사용하여 IBuildInfo를 백필하는 도우미입니다.

매개변수
`commandLine`	`String`

반환 값
`IBuildInfo`

createFailureFromException

public static FailureDescription createFailureFromException (Throwable exception, 
                TestRecordProto.FailureStatus defaultStatus)

호출 예외에서 FailureDescription를 만듭니다.

매개변수
`exception`	`Throwable`: 변환할 예외
`defaultStatus`	`TestRecordProto.FailureStatus`: 예외가 `IHarnessException`가 아닌 경우 기본적으로 사용할 상태입니다.

반환 값
`FailureDescription`

createInvocationExec

public IInvocationExecution createInvocationExec (TestInvocation.RunMode mode)

따라야 할 호출 경로를 만듭니다.

매개변수
`mode`	`TestInvocation.RunMode`: 현재 실행 중인 모드입니다.

반환 값
`IInvocationExecution`	호출을 설명하는 `IInvocationExecution`입니다.

getDeviceLogName

public static String getDeviceLogName (TestInvocation.Stage stage)

매개변수
`stage`	`TestInvocation.Stage`

반환 값
`String`

getEmulatorLogName

public static String getEmulatorLogName (TestInvocation.Stage stage)

매개변수
`stage`	`TestInvocation.Stage`

반환 값
`String`

getExitInfo

public ITestInvocation.ExitInformation getExitInfo ()

지정된 호출의 종료 정보입니다.

반환 값
`ITestInvocation.ExitInformation`

호출

public void invoke (IInvocationContext context, 
                IConfiguration config, 
                IRescheduler rescheduler, 
                ITestInvocationListener... extraListeners)

테스트 호출을 실행합니다.

매개변수
`context`	`IInvocationContext`: 테스트를 실행할 `IInvocationContext`입니다.
`config`	`IConfiguration`: 이 테스트 실행의 `IConfiguration`입니다.
`rescheduler`	`IRescheduler`: 다른 리소스에서 실행하기 위해 호출의 일부를 다시 예약하기 위한 `IRescheduler`
`extraListeners`	`ITestInvocationListener`: `config`에 있는 `ITestInvocationListener` 외에도 알림을 보낼 `ITestInvocationListener`

생성 값
`DeviceNotAvailableException`

isSubprocess

public static boolean isSubprocess (IConfiguration config)

호출이 현재 하위 프로세스 범위 내에 있으면 true를 반환합니다.

매개변수
`config`	`IConfiguration`

반환 값
`boolean`

notifyInvocationForceStopped

public void notifyInvocationForceStopped (String message, 
                ErrorIdentifier errorId)

TradeFed 중지를 요청했음을 TestInvocation에 알립니다.

매개변수
`message`	`String`: 호출 중지와 관련된 메시지
`errorId`	`ErrorIdentifier`: 강제 종료와 연결된 식별자

notifyInvocationStopped

public void notifyInvocationStopped (String message)

TestInvocation에 TradeFed가 최종적으로 종료될 예정임을 알립니다.

매개변수
`message`	`String`: 호출 중지와 관련된 메시지

printStageDelimiter

public static void printStageDelimiter (TestInvocation.Stage phase, 
                boolean end)

호출의 지정된 스테이지에 대한 구분 기호를 출력합니다.

매개변수
`phase`	`TestInvocation.Stage`
`end`	`boolean`

registerExecutionFiles

public void registerExecutionFiles (ExecutionFiles executionFiles)

매개변수
`executionFiles`	`ExecutionFiles`

setClearcutClient

public void setClearcutClient (ClearcutClient client)

측정항목을 보고하도록 clearcut 클라이언트를 전달합니다.

매개변수
`client`	`ClearcutClient`

shouldSkipBugreportError

public static boolean shouldSkipBugreportError (Throwable t)

버그 신고를 건너뛰어야 하는 경우 오류를 식별하는 도우미 메서드

매개변수
`t`	`Throwable`

반환 값
`boolean`

toString

public String toString ()

반환 값
`String`

보호된 메서드

addInvocationMetric

protected void addInvocationMetric (InvocationMetricLogger.InvocationMetricKey key, 
                String value)

매개변수
`key`	`InvocationMetricLogger.InvocationMetricKey`
`value`	`String`

addInvocationMetric

protected void addInvocationMetric (InvocationMetricLogger.InvocationMetricKey key, 
                long value)

매개변수
`key`	`InvocationMetricLogger.InvocationMetricKey`
`value`	`long`

applyAutomatedReporters

protected void applyAutomatedReporters (IConfiguration config)

매개변수
`config`	`IConfiguration`

setExitCode

protected void setExitCode (CommandRunner.ExitCode code, 
                Throwable stack)

종료 코드를 설정하는 도우미입니다. 테스트를 위해 노출됩니다.

매개변수
`code`	`CommandRunner.ExitCode`
`stack`	`Throwable`