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.

BaseDeviceMetricCollector

public class BaseDeviceMetricCollector
extends Object implements IDeviceActionReceiver, IMetricCollector

java.lang.Object
↳	com.android.tradefed.device.metric.BaseDeviceMetricCollector

알려진 직접 서브클래스

AtraceCollector	테스트 중에 atrace를 실행하고 결과를 수집하여 호출에 로깅하는 `IMetricCollector`입니다.
BugreportzOnFailureCollector	테스트 사례가 실패하면 bugreportz를 수집합니다.
BugreportzOnTestCaseFailureCollector	실행 중인 테스트 사례가 실패하면 bugreportz를 수집합니다.
ClangCodeCoverageCollector	기기에서 Clang 커버리지 측정을 가져와 테스트 아티팩트로 로깅하는 `BaseDeviceMetricCollector`
CodeCoverageCollector	기기에서 Java 및 네이티브 적용 범위 측정을 가져와 테스트 아티팩트로 로깅하는 `BaseDeviceMetricCollector`
CountTestCasesCollector	지정된 `IRemoteTest`의 테스트 사례 수를 집계하고 보고합니다.
DebugHostLogOnFailureCollector	테스트 사례 실패가 발생할 때 호스트 측 로그를 수집하고 기록하는 수집기입니다.
DeviceTraceCollector	테스트 실행이 시작될 때 perfetto 트레이스를 시작하고 끝날 때 트레이스 파일을 로깅하는 수집기
FilePullerDeviceMetricCollector	기기에서 전송되는 측정항목 키를 수신하고 기기에서 파일로 가져오는 `BaseDeviceMetricCollector`
GcovCodeCoverageCollector	기기에서 gcov 커버리지 측정을 가져와 테스트 아티팩트로 로깅하는 `BaseDeviceMetricCollector`입니다.
GcovKernelCodeCoverageCollector	debugfs에서 gcov 커널 적용 범위 측정을 가져와 기기에서 오프한 후 최종적으로 테스트 아티팩트로 로깅하는 `BaseDeviceMetricCollector`
HostStatsdMetricCollector	statsd 유틸리티 명령어를 사용하여 호스트 측에서 statsd 측정항목을 수집하는 `IMetricCollector`입니다.
JavaCodeCoverageCollector	기기에서 Java 적용 범위 측정을 가져와 테스트 아티팩트로 로깅하는 `BaseDeviceMetricCollector`입니다.
LogcatOnFailureCollector	테스트 사례 또는 테스트 실행이 실패할 때 logcat을 캡처하고 기록하는 수집기입니다.
LogcatTimingMetricCollector	제공된 정규식 패턴을 사용하여 로그캣 줄에서 이벤트의 시작 및 종료 신호를 파싱하여 하나 이상의 반복 테스트 중에 로그캣에서 타이밍 정보 (예: 사용자 전환 시간)를 수집하는 측정항목 수집기입니다.
ModulePerfettoCollector	테스트 모듈이 시작 및 종료되고 기기가 재부팅될 때 Perfetto 트레이스를 시작하는 수집기입니다.
RebootReasonCollector	테스트 실행 중에 기기 재부팅을 수집하고 이유와 개수로 보고하는 수집기입니다.
RuntimeRestartCollector	테스트 실행 중에 런타임 다시 시작(시스템 서버 비정상 종료)의 타임스탬프를 수집하는 수집기입니다(있는 경우).
ScreenRecordOnFailureCollector	테스트 사례가 실패할 때 화면 녹화 동영상을 캡처하고 기록하는 수집기
ScreenshotOnFailureCollector	테스트 사례가 실패할 때 스크린샷을 캡처하고 기록하는 수집기

알려진 간접 하위 클래스

AtraceRunMetricCollector, BluetoothConnectionLatencyCollector, BluetoothConnectionStateCollector, BluetoothHciSnoopLogCollector, FilePullerLogCollector, ModuleLogcatCollector, PerfettoFilePullerCollector, PerfettoPullerMetricCollector, ShowmapPullerMetricCollector, TraceCmdCollector

AtraceRunMetricCollector	지정된 디렉터리 아래의 모든 테스트 디렉터리에서 테스트 기기의 트레이스를 수집하고, 테스트 디렉터리를 로깅하고, 테스트 디렉터리 아래의 트레이스 파일을 후처리하고, 측정항목을 집계합니다.
BluetoothConnectionLatencyCollector	수집기는 사전 정의된 statsd 기간 측정항목 구성을 기기에 푸시하고 각 프로필의 블루투스 연결 기간을 수집합니다.
BluetoothConnectionStateCollector	이 수집기는 BluetoothConnectionStateChanged 측정항목을 수집하고 각 프로필의 연결 상태 번호를 기록합니다.
BluetoothHciSnoopLogCollector	DUT에서 블루투스 HCI 스누프 로깅을 사용 설정하고 각 테스트의 로그를 수집하는 수집기
FilePullerLogCollector	기기 측에서 보고한 파일의 로거입니다.
ModuleLogcatCollector	logcat 수집기의 버전(모듈용)입니다.
PerfettoFilePullerCollector	기기에서 Perfetto 트레이스 파일을 가져오고, 선택적으로 압축하고, 테스트 로그에 추가하는 수집기입니다.
PerfettoPullerMetricCollector	이 클래스는 지원 중단되었습니다. 대신 `PerfettoFilePullerCollector` 및 `ERROR(/PerfettoTracePostProcessor)`를 사용하세요.
ShowmapPullerMetricCollector	기기에서 showmap 파일을 가져오고 여기에서 측정항목을 수집할 수 있는 `FilePullerDeviceMetricCollector`의 기본 구현
TraceCmdCollector	trace-cmd를 사용하여 테스트 중에 트레이스를 수집하고 호출에 로깅하는 `IMetricCollector`입니다.

onTestRunStart(DeviceMetricData) 및 onTestRunEnd(DeviceMetricData,Map)에서 수집을 시작하고 중지할 수 있는 IMetricCollector의 기본 구현

요약

상수
`String`	`TEST_CASE_EXCLUDE_GROUP_OPTION`
`String`	`TEST_CASE_INCLUDE_GROUP_OPTION`

공개 생성자
`BaseDeviceMetricCollector()`

공개 메서드
`boolean`	`doesModuleContainFailure()` 현재 모듈에 테스트 사례 또는 테스트 실행 실패가 포함된 경우 true를 반환합니다.
`void`	`enableDefaultMetricCollection()` 수집기가 기본 측정항목 수집을 사용 설정할 수 있도록 허용합니다.
`void`	`extraInit(IInvocationContext context, ITestInvocationListener listener)`
`IMetricCollector.MetricCollectionLevel`	`getAlwaysOnCollectionLevel()`
`final List<IBuildInfo>`	`getBuildInfos()` 호출에서 사용할 수 있는 빌드 정보 목록을 반환합니다.
`final List<ITestDevice>`	`getDevices()` 호출에서 사용 가능한 기기 목록을 반환합니다.
`File`	`getFileFromTestArtifacts(String fileName)` 테스트 아티팩트 또는 모듈 아티팩트에서 파일을 가져와 후속 호출을 위해 맵에 캐시합니다.
`final ITestInvocationListener`	`getInvocationListener()` 결과를 전달하는 원래 `ITestInvocationListener`를 반환합니다.
`String`	`getModuleName()`
`IMetricCollector.MetricCollectionLevel`	`getOnFailureCollectionLevel()`
`final List<ITestDevice>`	`getRealDevices()` `getDevices()` 목록에서 스텁이 아닌 모든 기기를 반환합니다.
`String`	`getRunName()` 수집기를 트리거하는 테스트 실행 `mRunName`의 이름을 반환합니다.
`String`	`getTestName()` 수집기를 트리거하는 테스트 `mTestName`의 이름을 반환합니다.
`final ITestInvocationListener`	`init(IInvocationContext context, ITestInvocationListener listener)` 현재 컨텍스트와 결과를 전달할 위치를 사용하여 수집기를 초기화합니다.
`final void`	`invocationEnded(long elapsedTime)` 호출이 성공적으로 종료되었는지 아니면 오류 조건으로 인해 종료되었는지 보고합니다.
`final void`	`invocationFailed(FailureDescription failure)` 오류 조건으로 인해 불완전한 호출을 보고합니다.
`final void`	`invocationFailed(Throwable cause)` 오류 조건으로 인해 불완전한 호출을 보고합니다.
`void`	`invocationSkipped(SkipReason reason)` 호출을 건너뛴 것으로 보고합니다.
`final void`	`invocationStarted(IInvocationContext context)` 전달을 위한 호출 리스너
`boolean`	`isDefaultMetricCollectionEnabled()` 수집기가 기본 측정항목 수집의 일부로 측정항목을 수집하는지 여부입니다.
`final boolean`	`isDisabled()` 전체 객체가 사용 중지된 경우 (설정과 해체를 모두 건너뜀) True를 반환합니다.
`boolean`	`isDisabledReceiver()` `IDeviceActionReceiver`가 사용 중지되었는지 여부
`final void`	`logAssociation(String dataName, LogFile logFile)` 측정항목 수집기 구현 내에서 사용하지 마세요.
`void`	`onTestAssumptionFailure(DeviceMetricData testData, TestDescription test)` 가정 실패로 테스트 사례가 실패할 때 호출되는 콜백입니다.
`void`	`onTestEnd(DeviceMetricData testData, Map<String, MetricMeasurement.Metric> currentTestCaseMetrics)` 테스트 사례가 종료될 때 호출되는 콜백입니다.
`void`	`onTestEnd(DeviceMetricData testData, Map<String, MetricMeasurement.Metric> currentTestCaseMetrics, TestDescription test)` 테스트 사례가 종료될 때 호출되는 콜백입니다.
`void`	`onTestFail(DeviceMetricData testData, TestDescription test)` 테스트 사례가 실패할 때 호출되는 콜백입니다.
`void`	`onTestModuleEnded()` 모듈 종료 이벤트를 캡처할 수 있습니다.
`void`	`onTestModuleStarted()` 모듈 시작 이벤트를 캡처할 수 있습니다.
`void`	`onTestRunEnd(DeviceMetricData runData, Map<String, MetricMeasurement.Metric> currentRunMetrics)` 테스트 실행이 종료될 때 호출되는 콜백입니다.
`void`	`onTestRunFailed(DeviceMetricData testData, FailureDescription failure)` testRunFailed 이벤트 콜백
`void`	`onTestRunStart(DeviceMetricData runData)` 테스트 실행이 시작될 때 호출되는 콜백입니다.
`void`	`onTestStart(DeviceMetricData testData)` 테스트 사례가 시작될 때 호출되는 콜백입니다.
`void`	`rebootEnded(ITestDevice device)` 기기에서 재부팅이 종료될 때 알림을 가져옵니다.
`void`	`rebootStarted(ITestDevice device)` 기기에서 재부팅이 시작되면 알림을 받습니다.
`void`	`setAlwaysOnCollectionLevel(IMetricCollector.MetricCollectionLevel level)` 실패와 관계없이 수집기가 로그를 수집해야 하는 수준을 설정합니다.
`final void`	`setDisable(boolean isDisabled)` 객체를 사용 중지해야 하는지 여부를 설정합니다.
`void`	`setDisableReceiver(boolean isDisabled)` `IDeviceActionReceiver`을 사용 중지할지 여부를 설정합니다.
`final void`	`setLogSaver(ILogSaver logSaver)` 측정항목 수집기 구현 내에서 사용하지 마세요.
`void`	`setModuleContainsFailure()` 모듈에 실패 (테스트 사례, 테스트 실행)가 있었는지 설정합니다.
`void`	`setOnFailureCollectionLevel(IMetricCollector.MetricCollectionLevel level)` 실패 시 수집기가 로그를 수집해야 하는 수준을 설정합니다.
`final void`	`testAssumptionFailure(TestDescription test, String trace)` 원자 테스트에서 거짓인 조건을 가정한다고 표시할 때 호출됩니다.
`final void`	`testAssumptionFailure(TestDescription test, FailureDescription failure)` 원자 테스트에서 거짓인 조건을 가정한다고 표시할 때 호출됩니다.
`final void`	`testEnded(TestDescription test, long endTime, HashMap<String, MetricMeasurement.Metric> testMetrics)` 종료 시간을 직접 지정할 수 있는 `testEnded(TestDescription,Map)`의 대안입니다.
`final void`	`testEnded(TestDescription test, HashMap<String, MetricMeasurement.Metric> testMetrics)` 개별 테스트 사례의 실행 종료를 보고합니다.
`final void`	`testFailed(TestDescription test, FailureDescription failure)` 개별 테스트 사례의 실패를 보고합니다.
`final void`	`testFailed(TestDescription test, String trace)` 개별 테스트 사례의 실패를 보고합니다.
`final void`	`testIgnored(TestDescription test)` 테스트가 실행되지 않을 때 호출됩니다. 일반적으로 테스트 메서드에 org.junit.Ignore가 주석으로 달려 있기 때문입니다.
`final void`	`testLog(String dataName, LogDataType dataType, InputStreamSource dataStream)` 테스트 호출에서 연결된 로그 또는 디버그 데이터를 제공합니다.
`final void`	`testLogSaved(String dataName, LogDataType dataType, InputStreamSource dataStream, LogFile logFile)` 측정항목 수집기 구현 내에서 사용하지 마세요.
`final void`	`testModuleEnded()` 모듈 실행의 끝을 보고합니다.
`final void`	`testModuleStarted(IInvocationContext moduleContext)` 실행 중인 모듈의 시작을 보고합니다.
`final void`	`testRunEnded(long elapsedTime, HashMap<String, MetricMeasurement.Metric> runMetrics)` 테스트 실행의 종료를 보고합니다.
`final void`	`testRunFailed(FailureDescription failure)` `FailureDescription`에 설명된 실패로 인해 테스트 실행이 완료되지 않았다고 보고합니다.
`final void`	`testRunFailed(String errorMessage)` 심각한 오류로 인해 보고서 테스트 실행을 완료하지 못했습니다.
`final void`	`testRunStarted(String runName, int testCount, int attemptNumber)` 테스트 실행 시작을 보고합니다.
`final void`	`testRunStarted(String runName, int testCount)` 테스트 실행 콜백
`final void`	`testRunStarted(String runName, int testCount, int attemptNumber, long startTime)` 테스트 실행 시작을 보고합니다.
`final void`	`testRunStopped(long elapsedTime)` 사용자 요청으로 인해 테스트 실행이 완료되기 전에 중지되었다고 보고합니다.
`final void`	`testSkipped(TestDescription test, SkipReason reason)` 테스트가 건너뛰고 일반적으로 예상되지 않는 이유로 실행되지 않은 경우 호출됩니다.
`final void`	`testStarted(TestDescription test, long startTime)` 테스트가 시작된 시점도 지정하는 `testStarted(TestDescription)`의 대안으로, 정확한 측정을 위해 `testEnded(TestDescription,long,Map)`와 결합됩니다.
`final void`	`testStarted(TestDescription test)` 테스트 사례 콜백

상수

TEST_CASE_EXCLUDE_GROUP_OPTION

public static final String TEST_CASE_EXCLUDE_GROUP_OPTION

상수 값: 'test-case-exclude-group'

TEST_CASE_INCLUDE_GROUP_OPTION

public static final String TEST_CASE_INCLUDE_GROUP_OPTION

상수 값: 'test-case-include-group'

공개 생성자

BaseDeviceMetricCollector

public BaseDeviceMetricCollector ()

공개 메서드

doesModuleContainFailure

public boolean doesModuleContainFailure ()

현재 모듈에 테스트 사례 또는 테스트 실행 실패가 포함된 경우 true를 반환합니다.

반환
`boolean`

enableDefaultMetricCollection

public void enableDefaultMetricCollection ()

수집기가 기본 측정항목 수집을 사용 설정할 수 있도록 허용합니다. 기본 측정항목 수집이 사용 설정된 경우 수집기는 지정된 수집 수준에서만 수집해야 합니다.

extraInit

public void extraInit (IInvocationContext context, 
                ITestInvocationListener listener)

생성 값
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

getAlwaysOnCollectionLevel

public IMetricCollector.MetricCollectionLevel getAlwaysOnCollectionLevel ()

반환
`IMetricCollector.MetricCollectionLevel`

getBuildInfos

public final List<IBuildInfo> getBuildInfos ()

호출에서 사용할 수 있는 빌드 정보 목록을 반환합니다.

반환
`List<IBuildInfo>`

getDevices

public final List<ITestDevice> getDevices ()

호출에서 사용 가능한 기기 목록을 반환합니다.

반환
`List<ITestDevice>`

getFileFromTestArtifacts

public File getFileFromTestArtifacts (String fileName)

테스트 아티팩트 또는 모듈 아티팩트에서 파일을 가져와 후속 호출을 위해 맵에 캐시합니다.

매개변수
`fileName`	`String`: 아티팩트에서 조회할 파일의 이름입니다.

반환
`File`	테스트 아티팩트 또는 모듈 아티팩트의 파일입니다. 파일을 찾을 수 없는 경우 null을 반환합니다.

getInvocationListener

public final ITestInvocationListener getInvocationListener ()

결과를 전달하는 원래 ITestInvocationListener를 반환합니다.

반환
`ITestInvocationListener`

getModuleName

public String getModuleName ()

반환
`String`

getOnFailureCollectionLevel

public IMetricCollector.MetricCollectionLevel getOnFailureCollectionLevel ()

반환
`IMetricCollector.MetricCollectionLevel`

getRealDevices

public final List<ITestDevice> getRealDevices ()

getDevices() 목록에서 스텁이 아닌 모든 기기를 반환합니다.

반환
`List<ITestDevice>`

getRunName

public String getRunName ()

수집기를 트리거하는 테스트 실행 mRunName의 이름을 반환합니다.

반환
`String`	mRunName, 현재 테스트 실행 이름입니다.

getTestName

public String getTestName ()

수집기를 트리거하는 테스트 mTestName의 이름을 반환합니다.

반환
`String`	mTestName, 현재 테스트 이름

init

public final ITestInvocationListener init (IInvocationContext context, 
                ITestInvocationListener listener)

현재 컨텍스트와 결과를 전달할 위치를 사용하여 수집기를 초기화합니다. 인스턴스당 한 번만 호출되며 수집기는 내부 컨텍스트와 리스너를 업데이트해야 합니다. 테스트 실행 중에는 항상 이전에 init이 호출되지 않습니다.

어떤 기능인지 잘 아는 경우에만 재정의하세요.

매개변수
`context`	`IInvocationContext`: 진행 중인 호출의 `IInvocationContext`입니다.
`listener`	`ITestInvocationListener`: 결과를 배치할 `ITestInvocationListener`입니다.

반환
`ITestInvocationListener`	원래 리스너를 래핑하는 새 리스너

생성 값
`DeviceNotAvailableException`

invocationEnded

public final void invocationEnded (long elapsedTime)

호출이 성공적으로 종료되었는지 아니면 오류 조건으로 인해 종료되었는지 보고합니다.

TradeFederation 프레임워크에 의해 자동으로 호출됩니다.

매개변수
`elapsedTime`	`long`: 호출의 경과 시간(밀리초)

invocationFailed

public final void invocationFailed (FailureDescription failure)

오류 조건으로 인해 불완전한 호출을 보고합니다.

TradeFederation 프레임워크에 의해 자동으로 호출됩니다.

매개변수
`failure`	`FailureDescription`: 실패 원인을 설명하는 `FailureDescription`

invocationFailed

public final void invocationFailed (Throwable cause)

오류 조건으로 인해 불완전한 호출을 보고합니다.

TradeFederation 프레임워크에 의해 자동으로 호출됩니다.

매개변수
`cause`	`Throwable`: 실패의 `Throwable` 원인

invocationSkipped

public void invocationSkipped (SkipReason reason)

호출을 건너뛴 것으로 보고합니다.

매개변수
`reason`	`SkipReason`

invocationStarted

public final void invocationStarted (IInvocationContext context)

전달을 위한 호출 리스너

매개변수
`context`	`IInvocationContext`: 호출에 관한 정보

isDefaultMetricCollectionEnabled

public boolean isDefaultMetricCollectionEnabled ()

수집기가 기본 측정항목 수집의 일부로 측정항목을 수집하는지 여부입니다.

반환
`boolean`

isDisabled

public final boolean isDisabled ()

전체 객체가 사용 중지된 경우 (설정과 해체를 모두 건너뜀) True를 반환합니다. 그렇지 않으면 false입니다.

반환
`boolean`

isDisabledReceiver

public boolean isDisabledReceiver ()

IDeviceActionReceiver가 사용 중지되었는지 여부

반환
`boolean`	사용 중지된 경우 true를 반환하고, 그렇지 않으면 false를 반환합니다.

logAssociation

public final void logAssociation (String dataName, 
                LogFile logFile)

측정항목 수집기 구현 내에서 사용하지 마세요. 이는 순수한 전달입니다.

매개변수
`dataName`	`String`: 데이터의 이름
`logFile`	`LogFile`: 이전에 로깅되었으며 테스트 사례와 연결되어야 하는 `LogFile`입니다.

onTestAssumptionFailure

public void onTestAssumptionFailure (DeviceMetricData testData, 
                TestDescription test)

가정 실패로 테스트 사례가 실패할 때 호출되는 콜백입니다.

매개변수
`testData`	`DeviceMetricData`: 테스트 사례의 데이터를 보유하는 `DeviceMetricData`입니다.
`test`	`TestDescription`: 진행 중인 테스트 사례의 `TestDescription`입니다.

생성 값
`DeviceNotAvailableException`

onTestEnd

public void onTestEnd (DeviceMetricData testData, 
                Map<String, MetricMeasurement.Metric> currentTestCaseMetrics)

테스트 사례가 종료될 때 호출되는 콜백입니다. 이때 정리해야 합니다.

매개변수
`testData`	`DeviceMetricData`: 테스트 사례의 데이터를 보유하는 `DeviceMetricData`입니다. `onTestStart(DeviceMetricData)` 중에 사용된 객체와 동일한 객체입니다.
`currentTestCaseMetrics`	`Map`: `testEnded(TestDescription,Map)`에 전달된 현재 측정항목 맵입니다.

생성 값
`DeviceNotAvailableException`

onTestEnd

public void onTestEnd (DeviceMetricData testData, 
                Map<String, MetricMeasurement.Metric> currentTestCaseMetrics, 
                TestDescription test)

테스트 사례가 종료될 때 호출되는 콜백입니다. 이때 정리해야 합니다.

매개변수
`testData`	`DeviceMetricData`: 테스트 사례의 데이터를 보유하는 `DeviceMetricData`입니다. `onTestStart(DeviceMetricData)` 중에 사용된 객체와 동일한 객체입니다.
`currentTestCaseMetrics`	`Map`: `testEnded(TestDescription,Map)`에 전달된 현재 측정항목 맵입니다.
`test`	`TestDescription`: 진행 중인 테스트 사례의 `TestDescription`입니다.

생성 값
`DeviceNotAvailableException`

onTestFail

public void onTestFail (DeviceMetricData testData, 
                TestDescription test)

테스트 사례가 실패할 때 호출되는 콜백입니다.

매개변수
`testData`	`DeviceMetricData`: 테스트 사례의 데이터를 보유하는 `DeviceMetricData`입니다.
`test`	`TestDescription`: 진행 중인 테스트 사례의 `TestDescription`입니다.

생성 값
`DeviceNotAvailableException`

onTestModuleEnded

public void onTestModuleEnded ()

모듈 종료 이벤트를 캡처할 수 있습니다.

생성 값
`DeviceNotAvailableException`

onTestModuleStarted

public void onTestModuleStarted ()

모듈 시작 이벤트를 캡처할 수 있습니다.

생성 값
`DeviceNotAvailableException`

onTestRunEnd

public void onTestRunEnd (DeviceMetricData runData, 
                Map<String, MetricMeasurement.Metric> currentRunMetrics)

테스트 실행이 종료될 때 호출되는 콜백입니다. 이때 정리해야 합니다.

매개변수
`runData`	`DeviceMetricData`: 실행 데이터를 보유하는 `DeviceMetricData`입니다. `onTestRunStart(DeviceMetricData)`과 동일한 객체입니다.
`currentRunMetrics`	`Map`: `testRunEnded(long,Map)`에 전달된 현재 측정항목 맵입니다.

생성 값
`DeviceNotAvailableException`

onTestRunFailed

public void onTestRunFailed (DeviceMetricData testData, 
                FailureDescription failure)

testRunFailed 이벤트 콜백

생성 값
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

onTestRunStart

public void onTestRunStart (DeviceMetricData runData)

테스트 실행이 시작될 때 호출되는 콜백입니다.

매개변수
`runData`	`DeviceMetricData`: 실행 데이터를 보유하는 `DeviceMetricData`입니다.

생성 값
`DeviceNotAvailableException`

onTestStart

public void onTestStart (DeviceMetricData testData)

테스트 사례가 시작될 때 호출되는 콜백입니다.

매개변수
`testData`	`DeviceMetricData`: 테스트 사례의 데이터를 보유하는 `DeviceMetricData`입니다.

생성 값
`DeviceNotAvailableException`

rebootEnded

public void rebootEnded (ITestDevice device)

기기에서 재부팅이 종료될 때 알림을 가져옵니다.

참고: 수신기는 이 콜백 중에 재부팅을 피해야 합니다. 재부팅 시도는 무시됩니다.

매개변수
`device`	`ITestDevice`: 재부팅이 종료된 `ITestDevice`입니다.

생성 값
`DeviceNotAvailableException`

rebootStarted

public void rebootStarted (ITestDevice device)

기기에서 재부팅이 시작되면 알림을 받습니다.

참고: 수신기는 이 콜백 중에 재부팅을 피해야 합니다. 재부팅 시도는 무시됩니다.

매개변수
`device`	`ITestDevice`: 재부팅이 시작된 `ITestDevice`입니다.

생성 값
`DeviceNotAvailableException`

setAlwaysOnCollectionLevel

public void setAlwaysOnCollectionLevel (IMetricCollector.MetricCollectionLevel level)

실패와 관계없이 수집기가 로그를 수집해야 하는 수준을 설정합니다.

NULL 수준은 컬렉션이 생성되지 않습니다.

매개변수
`level`	`IMetricCollector.MetricCollectionLevel`: 로그가 수집될 `MetricCollectionLevel`입니다.

setDisable

public final void setDisable (boolean isDisabled)

객체를 사용 중지해야 하는지 여부를 설정합니다. 사용 중지됨은 설정 및 해체 단계를 모두 건너뛰어야 함을 의미합니다. 기본 생성자에서 객체를 기본적으로 사용 중지하는 데 사용할 수 있습니다.

매개변수
`isDisabled`	`boolean`: 객체가 배치되어야 하는 상태입니다.

setDisableReceiver

public void setDisableReceiver (boolean isDisabled)

IDeviceActionReceiver을 사용 중지할지 여부를 설정합니다. 사용 중지하면 기기 작업 이벤트를 수신하기 위해 기기에 등록되지 않습니다.

매개변수
`isDisabled`	`boolean`

setLogSaver

public final void setLogSaver (ILogSaver logSaver)

측정항목 수집기 구현 내에서 사용하지 마세요. 이는 순수한 전달입니다.

매개변수
`logSaver`	`ILogSaver`: `ILogSaver`

setModuleContainsFailure

public void setModuleContainsFailure ()

모듈에 실패 (테스트 사례, 테스트 실행)가 있었는지 설정합니다.

setOnFailureCollectionLevel

public void setOnFailureCollectionLevel (IMetricCollector.MetricCollectionLevel level)

실패 시 수집기가 로그를 수집해야 하는 수준을 설정합니다.

NULL 수준은 컬렉션이 생성되지 않습니다.

매개변수
`level`	`IMetricCollector.MetricCollectionLevel`: 로그가 수집될 `MetricCollectionLevel`입니다.

testAssumptionFailure

public final void testAssumptionFailure (TestDescription test, 
                String trace)

원자 테스트에서 거짓인 조건을 가정한다고 표시할 때 호출됩니다.

매개변수
`test`	`TestDescription`: 테스트를 식별합니다.
`trace`	`String`: 실패의 스택 트레이스

testAssumptionFailure

public final void testAssumptionFailure (TestDescription test, 
                FailureDescription failure)

원자 테스트에서 거짓인 조건을 가정한다고 표시할 때 호출됩니다.

매개변수
`test`	`TestDescription`: 테스트를 식별합니다.
`failure`	`FailureDescription`: 실패 및 컨텍스트를 설명하는 `FailureDescription`입니다.

testEnded

public final void testEnded (TestDescription test, 
                long endTime, 
                HashMap<String, MetricMeasurement.Metric> testMetrics)

종료 시간을 직접 지정할 수 있는 testEnded(TestDescription,Map)의 대안입니다. 정확한 측정을 위해 testStarted(TestDescription,long)와 결합하세요.

매개변수
`test`	`TestDescription`: 테스트를 식별합니다.
`endTime`	`long`: 테스트가 종료된 시간입니다(`System.currentTimeMillis()`을 통해 측정됨).
`testMetrics`	`HashMap`: 내보낸 측정항목의 `Map`

testEnded

public final void testEnded (TestDescription test, 
                HashMap<String, MetricMeasurement.Metric> testMetrics)

개별 테스트 사례의 실행 종료를 보고합니다.

testFailed(TestDescription, FailureDescription)가 호출되지 않았다면 이 테스트는 통과입니다. 테스트 사례 실행 중에 발생했을 수 있는 키/값 측정항목도 반환합니다.

매개변수
`test`	`TestDescription`: 테스트를 식별합니다.
`testMetrics`	`HashMap`: 내보낸 측정항목의 `Map`

testFailed

public final void testFailed (TestDescription test, 
                FailureDescription failure)

개별 테스트 사례의 실패를 보고합니다.

testStarted와 testEnded 사이에 호출됩니다.

매개변수
`test`	`TestDescription`: 테스트를 식별합니다.
`failure`	`FailureDescription`: 실패 및 컨텍스트를 설명하는 `FailureDescription`입니다.

testFailed

public final void testFailed (TestDescription test, 
                String trace)

개별 테스트 사례의 실패를 보고합니다.

testStarted와 testEnded 사이에 호출됩니다.

매개변수
`test`	`TestDescription`: 테스트를 식별합니다.
`trace`	`String`: 실패의 스택 트레이스

testIgnored

public final void testIgnored (TestDescription test)

테스트가 실행되지 않을 때 호출됩니다. 일반적으로 테스트 메서드에 org.junit.Ignore가 주석으로 달려 있기 때문입니다.

매개변수
`test`	`TestDescription`: 테스트를 식별합니다.

testLog

public final void testLog (String dataName, 
                LogDataType dataType, 
                InputStreamSource dataStream)

테스트 호출에서 연결된 로그 또는 디버그 데이터를 제공합니다.

ERROR(ITestInvocationListener.invocationFailed(Throwable)/ITestInvocationListener#invocationFailed(java.lang.Throwable) ITestInvocationListener.invocationFailed(Throwable)) 또는 ERROR(/ITestInvocationListener#invocationEnded(long)) 전에 호출해야 합니다.

TradeFederation 프레임워크는 이 메서드를 자동으로 호출하여 호스트 로그와 해당하는 경우 기기 logcat을 제공합니다.

매개변수
`dataName`	`String`: 데이터의 `String` 설명 이름입니다(예: 'device_logcat'). dataName은 호출마다 고유하지 않을 수 있습니다. 즉, 구현자는 동일한 dataName으로 여러 호출을 처리할 수 있어야 합니다.
`dataType`	`LogDataType`: 데이터의 `LogDataType`
`dataStream`	`InputStreamSource`: 데이터의 `InputStreamSource`입니다. 구현자는 createInputStream을 호출하여 데이터 읽기를 시작해야 하며 완료되면 결과 InputStream을 닫아야 합니다. 호출자는 testLog 메서드가 완료될 때까지 데이터 소스가 표시되고 액세스 가능하도록 해야 합니다.

testLogSaved

public final void testLogSaved (String dataName, 
                LogDataType dataType, 
                InputStreamSource dataStream, 
                LogFile logFile)

측정항목 수집기 구현 내에서 사용하지 마세요. 이는 순수한 전달입니다.

매개변수
`dataName`	`String`: 데이터의 `String` 설명 이름입니다(예: 'device_logcat'). dataName은 호출마다 고유하지 않을 수 있습니다. 즉, 구현자는 동일한 dataName으로 여러 호출을 처리할 수 있어야 합니다.
`dataType`	`LogDataType`: 데이터의 `LogDataType`
`dataStream`	`InputStreamSource`: 데이터의 `InputStreamSource`입니다. 구현자는 createInputStream을 호출하여 데이터 읽기를 시작해야 하며 완료되면 결과 InputStream을 닫아야 합니다.
`logFile`	`LogFile`: 저장된 파일의 메타데이터가 포함된 `LogFile`입니다.

testModuleEnded

public final void testModuleEnded ()

모듈 실행의 끝을 보고합니다.

testModuleStarted

public final void testModuleStarted (IInvocationContext moduleContext)

실행 중인 모듈의 시작을 보고합니다. 이 콜백은 testModuleEnded()와 연결되어 있으며 시퀀스에서 선택사항입니다. 모듈을 사용하는 실행(스위트 기반 러너) 중에만 사용됩니다.

매개변수
`moduleContext`	`IInvocationContext`: 모듈의 `IInvocationContext`입니다.

testRunEnded

public final void testRunEnded (long elapsedTime, 
                HashMap<String, MetricMeasurement.Metric> runMetrics)

테스트 실행의 종료를 보고합니다. FIXME: 유형이 다른 Map<> 인터페이스 두 개를 사용할 수 없으므로 여기서는 HashMap을 사용해야 합니다.

매개변수
`elapsedTime`	`long`: 기기에서 보고한 경과 시간(밀리초)
`runMetrics`	`HashMap`: `Metric`로 테스트 실행이 끝날 때 보고되는 키-값 쌍입니다.

testRunFailed

public final void testRunFailed (FailureDescription failure)

FailureDescription에 설명된 실패로 인해 테스트 실행이 완료되지 않았다고 보고합니다.

매개변수
`failure`	`FailureDescription`: 실패 및 컨텍스트를 설명하는 `FailureDescription`입니다.

testRunFailed

public final void testRunFailed (String errorMessage)

심각한 오류로 인해 보고서 테스트 실행을 완료하지 못했습니다.

매개변수
`errorMessage`	`String`: 실행 실패 이유를 설명하는 `String`입니다.

testRunStarted

public final void testRunStarted (String runName, 
                int testCount, 
                int attemptNumber)

테스트 실행 시작을 보고합니다.

매개변수
`runName`	`String`: 테스트 실행 이름
`testCount`	`int`: 테스트 실행의 총 테스트 수
`attemptNumber`	`int`: 동일한 runName의 여러 시도를 식별하는 주문 번호입니다. attemptNumber는 0부터 시작하며 새 실행이 발생할 때마다 증가해야 합니다. 예를 들어 테스트가 상세하게 3번 재시도되면 동일한 runName 아래에 총 4번의 실행이 있어야 하며 attemptNumber는 0~3입니다.

testRunStarted

public final void testRunStarted (String runName, 
                int testCount)

테스트 실행 콜백

매개변수
`runName`	`String`: 테스트 실행 이름
`testCount`	`int`: 테스트 실행의 총 테스트 수

testRunStarted

public final void testRunStarted (String runName, 
                int testCount, 
                int attemptNumber, 
                long startTime)

테스트 실행 시작을 보고합니다.

매개변수
`runName`	`String`: 테스트 실행 이름
`testCount`	`int`: 테스트 실행의 총 테스트 수
`attemptNumber`	`int`: 동일한 runName의 여러 시도를 식별하는 주문 번호입니다. attemptNumber는 0부터 시작하며 새 실행이 발생할 때마다 증가해야 합니다. 예를 들어 테스트가 상세하게 3번 재시도되면 동일한 runName 아래에 총 4번의 실행이 있어야 하며 attemptNumber는 0~3입니다.
`startTime`	`long`: `System.currentTimeMillis()`을 통해 측정된 실행 시작 시간

testRunStopped

public final void testRunStopped (long elapsedTime)

사용자 요청으로 인해 테스트 실행이 완료되기 전에 중지되었다고 보고합니다.

TODO: 현재 사용되지 않음, 삭제 고려

매개변수
`elapsedTime`	`long`: 기기에서 보고한 경과 시간(밀리초)

testSkipped

public final void testSkipped (TestDescription test, 
                SkipReason reason)

테스트가 건너뛰고 일반적으로 예상되지 않는 이유로 실행되지 않은 경우 호출됩니다. 이러한 테스트는 적절한 실행을 위해 다시 시도됩니다.

매개변수
`test`	`TestDescription`: 테스트를 식별합니다.
`reason`	`SkipReason`: `SkipReason`

testStarted

public final void testStarted (TestDescription test, 
                long startTime)

테스트가 시작된 시점도 지정하는 testStarted(TestDescription)의 대안으로, 정확한 측정을 위해 testEnded(TestDescription,long,Map)와 결합됩니다.

매개변수
`test`	`TestDescription`: 테스트를 식별합니다.
`startTime`	`long`: 테스트가 시작된 시간입니다(`System.currentTimeMillis()`을 통해 측정됨).

testStarted

public final void testStarted (TestDescription test)

테스트 사례 콜백

매개변수
`test`	`TestDescription`: 테스트를 식별합니다.