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

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

IMetricCollector

public interface IMetricCollector
implements IDisableable, ILogSaverListener

com.android.tradefed.device.metric.IMetricCollector

알려진 간접 하위 클래스

AtraceCollector, AtraceRunMetricCollector, BaseDeviceMetricCollector, BluetoothConnectionLatencyCollector, BluetoothConnectionStateCollector, BluetoothHciSnoopLogCollector, BugreportzOnFailureCollector, BugreportzOnTestCaseFailureCollector, ClangCodeCoverageCollector, CodeCoverageCollector, CountTestCasesCollector, DebugHostLogOnFailureCollector, DeviceTraceCollector, FilePullerDeviceMetricCollector, FilePullerLogCollector, 13개 기타

AtraceCollector	테스트 중에 atrace를 실행하고 결과를 수집하여 호출에 로깅하는 `IMetricCollector`입니다.
AtraceRunMetricCollector	테스트 기기에서 지정된 디렉터리 아래의 모든 테스트 디렉터리에서 트레이스를 수집하고, 테스트 디렉터리를 로깅하고, 테스트 디렉터리 아래의 트레이스 파일을 후처리하고, 측정항목을 집계합니다.
BaseDeviceMetricCollector	`onTestRunStart(com.android.tradefed.device.metric.DeviceMetricData)` 및 `ERROR(/#onTestRunEnd(com.android.tradefed.device.metric.DeviceMetricData,Map))`에서 수집을 시작하고 중지할 수 있는 `IMetricCollector`의 기본 구현입니다.
BluetoothConnectionLatencyCollector	수집기는 사전 정의된 statsd 시간 측정항목 구성을 기기에 푸시하고 각 프로필의 블루투스 연결 시간을 수집합니다.
BluetoothConnectionStateCollector	이 수집기는 BluetoothConnectionStateChanged 측정항목을 수집하고 각 프로필의 연결 상태 번호를 기록합니다.
BluetoothHciSnoopLogCollector	DUT에서 블루투스 HCI 스누프 로깅을 사용 설정하고 각 테스트의 로그를 수집하는 수집기입니다.
BugreportzOnFailureCollector	테스트 사례가 실패하면 bugreportz를 수집합니다.
BugreportzOnTestCaseFailureCollector	실행 중인 테스트 사례가 실패하면 bugreportz를 수집합니다.
ClangCodeCoverageCollector	기기에서 Clang 적용 범위 측정값을 가져와 테스트 아티팩트로 로깅하는 `BaseDeviceMetricCollector`입니다.
CodeCoverageCollector	기기에서 Java 및 네이티브 적용 범위 측정값을 가져와 테스트 아티팩트로 로깅하는 `BaseDeviceMetricCollector`입니다.
CountTestCasesCollector	지정된 `IRemoteTest`의 테스트 사례 수를 계산하고 보고합니다.
DebugHostLogOnFailureCollector	테스트 사례 실패가 발생할 때 호스트 측 로그를 수집하고 기록하는 수집기입니다.
DeviceTraceCollector	테스트 실행이 시작될 때 perfetto 트레이스를 시작하고 종료 시 트레이스 파일을 로깅하는 수집기입니다.
FilePullerDeviceMetricCollector	기기에서 전송되는 측정항목 키를 리슨하고 기기에서 파일로 가져오는 `BaseDeviceMetricCollector`입니다.
FilePullerLogCollector	기기 측에서 보고한 파일의 로거입니다.
GcovCodeCoverageCollector	기기에서 gcov 적용 범위 측정값을 가져와 테스트 아티팩트로 로깅하는 `BaseDeviceMetricCollector`입니다.
GcovKernelCodeCoverageCollector	debugfs 및 기기에서 gcov 커널 적용 범위 측정값을 가져와 테스트 아티팩트로 로깅하는 `BaseDeviceMetricCollector`입니다.
HostStatsdMetricCollector	statsd 유틸리티 명령어를 사용하여 호스트 측에서 statsd 측정항목을 수집하는 `IMetricCollector`입니다.
JavaCodeCoverageCollector	기기에서 Java 적용 범위 측정값을 가져와 테스트 아티팩트로 로깅하는 `BaseDeviceMetricCollector`입니다.
LogcatOnFailureCollector	테스트 사례가 실패할 때 logcat을 캡처하고 기록하는 수집기입니다.
LogcatTimingMetricCollector	하나 이상의 반복 테스트 중에 지정된 정규식 패턴을 사용하여 logcat 행에서 이벤트의 시작 및 종료 신호를 파싱하여 logcat에서 타이밍 정보 (예: 사용자 전환 시간)를 수집하는 측정항목 수집기입니다.
ModuleLogcatCollector	모듈용 Logcat 수집기 버전입니다.
PerfettoPullerMetricCollector	기기에서 perfetto 파일을 가져오고 측정항목을 수집할 수 있는 `FilePullerDeviceMetricCollector`의 기본 구현입니다.
RebootReasonCollector	테스트 실행 중에 기기 재부팅을 수집하고 이유 및 개수별로 보고하는 수집기입니다.
RuntimeRestartCollector	테스트 실행 중에 런타임 다시 시작(시스템 서버 비정상 종료)의 타임스탬프를 수집하는 수집기(있는 경우)
ScreenshotOnFailureCollector	테스트 사례가 실패할 때 스크린샷을 캡처하고 기록하는 수집기입니다.
ShowmapPullerMetricCollector	기기에서 showmap 파일을 가져오고 측정항목을 수집할 수 있는 `FilePullerDeviceMetricCollector`의 기본 구현입니다.
TraceCmdCollector	trace-cmd를 사용하여 테스트 중에 트레이스를 수집하고 호출에 로깅하는 `IMetricCollector`입니다.

이 인터페이스는 일치하는 측정항목을 수집하기 위해 테스트 결과를 보고할 때 데코레이터로 추가됩니다.

이 인터페이스는 ITestInvocationListener를 확장하더라도 로 사용할 수 없습니다. 구성 검사에서 이를 거부합니다. 'metrics_collector'로 사용해야 합니다.

수집기는 여러 위치에서 재사용될 수 있으므로 내부 상태를 유지하지 않습니다. 내부 상태를 반드시 사용해야 하는 경우 init(com.android.tradefed.invoker.IInvocationContext, com.android.tradefed.result.ITestInvocationListener)에서 정리해야 합니다.

요약

공개 메서드
`default boolean`	`captureModuleLevel()` 수집기가 모듈 수준 캡처에 적용되고 초기화되어야 하는지 여부입니다.
`abstract`	`getBuildInfos()` 호출에서 사용할 수 있는 빌드 정보 목록을 반환합니다.
`abstract`	`getDevices()` 호출에서 사용할 수 있는 기기 목록을 반환합니다.
`abstract ITestInvocationListener`	`getInvocationListener()` 결과를 전달하는 원래 `ITestInvocationListener`를 반환합니다.
`abstract ITestInvocationListener`	`init(IInvocationContext context, ITestInvocationListener listener)` 현재 컨텍스트와 결과를 전달할 위치를 사용하여 수집기를 초기화합니다.
`abstract void`	`onTestAssumptionFailure(DeviceMetricData testData, TestDescription test)` 가정 실패로 테스트 사례가 실패할 때의 콜백입니다.
`abstract void`	`onTestEnd(DeviceMetricData testData, currentTestCaseMetrics, TestDescription test)` 테스트 사례가 종료될 때 콜백
`abstract void`	`onTestEnd(DeviceMetricData testData, currentTestCaseMetrics)` 테스트 사례가 종료될 때 콜백
`abstract void`	`onTestFail(DeviceMetricData testData, TestDescription test)` 테스트 사례가 실패할 때의 콜백입니다.
`default void`	`onTestModuleEnded()` 모듈 종료 이벤트를 캡처할 수 있습니다.
`default void`	`onTestModuleStarted()` 모듈 시작 이벤트를 캡처할 수 있습니다.
`abstract void`	`onTestRunEnd(DeviceMetricData runData, currentRunMetrics)` 테스트 실행이 종료될 때의 콜백입니다.
`abstract void`	`onTestRunStart(DeviceMetricData runData)` 테스트 실행이 시작될 때의 콜백입니다.
`default void`	`onTestRunStart(DeviceMetricData runData, int testCount)` 테스트 실행이 시작될 때의 콜백입니다.
`abstract void`	`onTestStart(DeviceMetricData testData)` 테스트 사례가 시작될 때의 콜백입니다.

공개 메서드

captureModuleLevel

public boolean captureModuleLevel ()

수집기가 모듈 수준 캡처에 적용되고 초기화되어야 하는지 여부입니다.

반환 값
`boolean`

getBuildInfos

public abstract  getBuildInfos ()

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

반환 값

getDevices

public abstract  getDevices ()

호출에서 사용할 수 있는 기기 목록을 반환합니다.

반환 값

getInvocationListener

public abstract ITestInvocationListener getInvocationListener ()

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

반환 값
`ITestInvocationListener`

init

public abstract ITestInvocationListener init (IInvocationContext context, 
                ITestInvocationListener listener)

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

어떤 작업을 하는지 잘 알고 있지 않으면 재정의하지 마세요.

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

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

생성 값
`DeviceNotAvailableException`

onTestAssumptionFailure

public abstract void onTestAssumptionFailure (DeviceMetricData testData, 
                TestDescription test)

가정 실패로 테스트 사례가 실패할 때의 콜백입니다.

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

생성 값
`DeviceNotAvailableException`

onTestEnd

public abstract void onTestEnd (DeviceMetricData testData, 
                 currentTestCaseMetrics, 
                TestDescription test)

테스트 사례가 종료될 때 콜백 이제 정리할 시간입니다.

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

생성 값
`DeviceNotAvailableException`

onTestEnd

public abstract void onTestEnd (DeviceMetricData testData, 
                 currentTestCaseMetrics)

테스트 사례가 종료될 때 콜백 이제 정리할 시간입니다.

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

생성 값
`DeviceNotAvailableException`

onTestFail

public abstract void onTestFail (DeviceMetricData testData, 
                TestDescription test)

테스트 사례가 실패할 때의 콜백입니다.

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

생성 값
`DeviceNotAvailableException`

onTestModuleEnded

public void onTestModuleEnded ()

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

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

onTestModuleStarted

public void onTestModuleStarted ()

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

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

onTestRunEnd

public abstract void onTestRunEnd (DeviceMetricData runData, 
                 currentRunMetrics)

테스트 실행이 종료될 때의 콜백입니다. 이제 정리할 시간입니다.

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

생성 값
`DeviceNotAvailableException`

onTestRunStart

public abstract void onTestRunStart (DeviceMetricData runData)

테스트 실행이 시작될 때의 콜백입니다.

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

생성 값
`DeviceNotAvailableException`

onTestRunStart

public void onTestRunStart (DeviceMetricData runData, 
                int testCount)

테스트 실행이 시작될 때의 콜백입니다.

매개변수
`runData`	`DeviceMetricData`: 실행에 관한 데이터를 보유하는 `DeviceMetricData`입니다.
`testCount`	`int`: 이 테스트 실행의 테스트 사례 수입니다.

생성 값
`DeviceNotAvailableException`

onTestStart

public abstract void onTestStart (DeviceMetricData testData)

테스트 사례가 시작될 때의 콜백입니다.

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

생성 값
`DeviceNotAvailableException`