2026년부터 트렁크 안정 개발 모델과 일치하고 생태계의 플랫폼 안정성을 보장하기 위해 2분기와 4분기에 AOSP에 소스 코드를 게시합니다. AOSP를 빌드하고 기여하려면 aosp-main 대신 android-latest-release를 사용하는 것이 좋습니다. android-latest-release 매니페스트 브랜치는 항상 AOSP에 푸시된 최신 버전을 참조합니다. 자세한 내용은 AOSP 변경사항을 참고하세요.

CollectingTestListener

public class CollectingTestListener
extends Object implements ITestInvocationListener, ILogSaverListener

java.lang.Object
↳	com.android.tradefed.result.CollectingTestListener

알려진 직접 서브클래스

JsonHttpTestResultReporter, MetricsXMLResultReporter, ModuleListener, ReportPassedTests, ResultAggregator, ShardListener, SuiteResultReporter, XmlResultReporter

JsonHttpTestResultReporter	테스트 측정항목 결과 및 브랜치, 기기 정보를 JSON으로 인코딩하고 HTTP 서비스 엔드포인트에 POST하는 결과 보고 도구입니다.
MetricsXMLResultReporter	MetricsXMLResultReporter는 테스트의 invocationEnded 단계에서 metrics-folder 매개변수로 지정된 폴더의 XML 파일에 테스트 측정항목과 실행 측정항목을 작성합니다.
ModuleListener	결과 목록을 수집하기 위해 각 모듈의 각 `IRemoteTest`에 연결된 리스너입니다.
ReportPassedTests	통과한 테스트를 제외할 수 있는 필터를 파일에 보고합니다.
ResultAggregator	취해진 재시도 전략에 따라 필요한 경우 결과를 집계하는 특수 전달자입니다.
ShardListener	호출 샤드 (즉, 여러 리소스에서 동시에 실행되도록 호출을 분할한 것)에서 결과를 수집하고 다른 리스너로 전달하는 `ITestInvocationListener`입니다.
SuiteResultReporter	전체 모음 호출의 테스트 결과를 수집하고 최종 결과를 출력합니다.
XmlResultReporter	Ant의 XMLJUnitResultFormatter와 일치하는 형식으로 JUnit 결과를 XML 파일에 작성합니다.

알려진 간접 하위 클래스

FormattedGeneratorReporter, XmlFormattedGeneratorReporter

FormattedGeneratorReporter	특정 형식으로 보고서를 생성할 수 있는 Reporter입니다.
XmlFormattedGeneratorReporter	모음 결과를 xml 형식으로 형식 지정하는 `FormattedGeneratorReporter` 구현

모든 테스트 결과를 수집하는 ITestInvocationListener입니다.

이 객체에 사용되는 데이터 구조는 스레드 안전하지만 ITestInvocationListener 콜백은 올바른 순서로 호출해야 합니다.

요약

공개 생성자
`CollectingTestListener()`

공개 메서드
`IBuildInfo`	`getBuildInfo()` 이 메서드는 지원 중단되었습니다. `getInvocationContext()`의 `IBuildInfo`를 사용합니다.
`TestRunResult`	`getCurrentRunResults()` 현재 테스트 실행의 결과를 가져옵니다.
`int`	`getExpectedTests()` 예상 테스트 수를 반환합니다.
`IInvocationContext`	`getInvocationContext()` `invocationStarted(com.android.tradefed.invoker.IInvocationContext)`를 통해 보고된 호출 컨텍스트를 반환합니다.
	`getMergedTestRunResults()` 여러 시도에서 실행된 모든 실험의 병합된 결과 모음을 반환합니다.
`IInvocationContext`	`getModuleContextForRunResult(String testRunName)` 결과와 연결된 모듈의 `IInvocationContext`를 반환합니다.
`MultiMap<String, LogFile>`	`getModuleLogFiles()` 모듈과 연결된 로깅된 모든 파일이 포함된 맵의 사본을 반환합니다.
`MultiMap<String, LogFile>`	`getNonAssociatedLogFiles()` 테스트 실행 또는 모듈과 연결되지 않은 로깅된 모든 파일이 포함된 맵의 사본을 반환합니다.
`int`	`getNumAllFailedTestRuns()` 실패 상태에서 총 테스트 실행 수를 반환합니다.
`int`	`getNumAllFailedTests()` 실패 상태의 총 테스트 수를 반환합니다 (실패한 테스트만 반환됨, 가정 실패는 여기에 포함되지 않음).
`int`	`getNumTestsInState(TestResult.TestStatus status)` 이 실행에서 지정된 상태의 테스트 수를 반환합니다.
`int`	`getNumTotalTests()` 모든 실행의 완료된 총 테스트 수를 반환합니다.
`IBuildInfo`	`getPrimaryBuildInfo()` `invocationStarted(com.android.tradefed.invoker.IInvocationContext)`를 통해 보고된 기본 빌드 정보를 반환합니다.
	`getRunResults()` 이 메서드는 지원 중단되었습니다. `getMergedTestRunResults()` 사용
`TestRunResult`	`getTestRunAtAttempt(String testRunName, int attempt)` 단일 시도에 대해 `TestRunResult`를 반환합니다.
`int`	`getTestRunAttemptCount(String testRunName)` 지정된 테스트 실행 이름의 시도 횟수를 반환합니다.
	`getTestRunAttempts(String testRunName)` 지정된 테스트 실행의 `TestRunResult`에 대한 모든 시도를 가져옵니다.
	`getTestRunForAttempts(int attempt)` 지정된 시도의 모든 결과를 가져옵니다.
	`getTestRunNames()` 모든 테스트 실행의 모든 이름을 반환합니다.
`boolean`	`hasFailedTests()` 호출에 실패한 테스트 또는 가정 실패 테스트가 있는지 여부를 반환합니다.
`boolean`	`hasTestRunResultsForName(String testRunName)` 지정된 테스트 실행 이름에 결과가 있는지 여부를 반환합니다.
`void`	`invocationEnded(long elapsedTime)`
`void`	`invocationFailed(Throwable cause)`
`void`	`invocationStarted(IInvocationContext context)`
`void`	`logAssociation(String dataName, LogFile logFile)`
`void`	`setBuildInfo(IBuildInfo buildInfo)` 이 메서드는 지원 중단되었습니다. 더 이상 테스트에 필요하지 않습니다.
`void`	`setMergeStrategy(MergeStrategy strategy)` 결과를 병합할 때 사용할 `MergeStrategy`를 설정합니다.
`void`	`testAssumptionFailure(TestDescription test, String trace)`
`void`	`testAssumptionFailure(TestDescription test, FailureDescription failure)`
`void`	`testEnded(TestDescription test, long endTime, testMetrics)`
`void`	`testEnded(TestDescription test, testMetrics)`
`void`	`testFailed(TestDescription test, FailureDescription failure)`
`void`	`testFailed(TestDescription test, String trace)`
`void`	`testIgnored(TestDescription test)`
`void`	`testModuleEnded()`
`void`	`testModuleStarted(IInvocationContext moduleContext)`
`void`	`testRunEnded(long elapsedTime, runMetrics)`
`void`	`testRunFailed(FailureDescription failure)`
`void`	`testRunFailed(String errorMessage)`
`void`	`testRunStarted(String name, int numTests, int attemptNumber)`
`void`	`testRunStarted(String name, int numTests)`
`void`	`testRunStarted(String name, int numTests, int attemptNumber, long startTime)`
`void`	`testRunStopped(long elapsedTime)`
`void`	`testStarted(TestDescription test, long startTime)`
`void`	`testStarted(TestDescription test)`

보호된 메서드
`final void`	`clearModuleLogFiles()` 모듈 파일을 정리하여 너무 오래 전송되지 않도록 합니다.
`final void`	`clearResultsForName(String testRunName)` 지정된 실행 이름의 결과를 지울 수 있습니다.
`void`	`setIsAggregrateMetrics(boolean aggregate)` '집계 측정항목' 옵션 전환

공개 생성자

CollectingTestListener

public CollectingTestListener ()

공개 메서드

getBuildInfo

public IBuildInfo getBuildInfo ()

이 메서드는 지원 중단되었습니다.
는 getInvocationContext()의 IBuildInfo를 사용합니다.

빌드 정보를 반환합니다.

반환 값
`IBuildInfo`

getCurrentRunResults

public TestRunResult getCurrentRunResults ()

현재 테스트 실행의 결과를 가져옵니다.

결과가 불완전할 수 있습니다. 결과를 처리하기 전에 TestRunResult.isRunComplete() 값 또는 (@link TestRunResult#isRunFailure()}을 적절하게 테스트하는 것이 좋습니다.

반환 값
`TestRunResult`	마지막 테스트 실행 중에 수집된 데이터를 나타내는 `TestRunResult`

getExpectedTests

public int getExpectedTests ()

예상 테스트 수를 반환합니다. 일부 테스트가 실행되지 않은 경우 getNumTotalTests()과 다를 수 있습니다.

반환 값
`int`

getInvocationContext

public IInvocationContext getInvocationContext ()

invocationStarted(com.android.tradefed.invoker.IInvocationContext)를 통해 보고된 호출 컨텍스트를 반환합니다.

반환 값
`IInvocationContext`

getMergedTestRunResults

public  getMergedTestRunResults ()

여러 시도에서 실행된 모든 실험의 병합된 결과 모음을 반환합니다.

결과가 여러 개인 경우 각 테스트 실행이 병합되며 최신 테스트 결과가 이전 실행의 테스트 결과를 덮어씁니다. 테스트 실행은 시도 횟수순으로 정렬됩니다.

동일한 시도의 측정항목은 aggregate-metrics에서 설정한 환경설정에 따라 병합됩니다. 최종 측정항목은 마지막 시도의 측정항목입니다.

반환 값

getModuleContextForRunResult

public IInvocationContext getModuleContextForRunResult (String testRunName)

결과와 연결된 모듈의 IInvocationContext를 반환합니다.

매개변수
`testRunName`	`String`: {`testRunStarted(String, int)`에서 지정한 이름입니다.

반환 값
`IInvocationContext`	해당 이름에 대한 결과가 없는 경우 지정된 테스트 실행 이름 `null`의 모듈 `IInvocationContext`입니다.

getModuleLogFiles

public MultiMap<String, LogFile> getModuleLogFiles ()

모듈과 연결된 로깅된 모든 파일이 포함된 맵의 사본을 반환합니다.

반환 값
`MultiMap<String, LogFile>`

getNonAssociatedLogFiles

public MultiMap<String, LogFile> getNonAssociatedLogFiles ()

테스트 실행 또는 모듈과 연결되지 않은 로깅된 모든 파일이 포함된 맵의 사본을 반환합니다.

반환 값
`MultiMap<String, LogFile>`

getNumAllFailedTestRuns

public int getNumAllFailedTestRuns ()

실패 상태의 총 테스트 실행 수를 반환합니다.

반환 값
`int`

getNumAllFailedTests

public int getNumAllFailedTests ()

실패 상태의 총 테스트 수를 반환합니다 (실패한 테스트만 반환됨, 가정 실패는 여기에 포함되지 않음).

반환 값
`int`

getNumTestsInState

public int getNumTestsInState (TestResult.TestStatus status)

이 실행에서 지정된 상태의 테스트 수를 반환합니다.

매개변수
`status`	`TestResult.TestStatus`

반환 값
`int`

getNumTotalTests

public int getNumTotalTests ()

모든 실행의 완료된 총 테스트 수를 반환합니다.

반환 값
`int`

getPrimaryBuildInfo

public IBuildInfo getPrimaryBuildInfo ()

invocationStarted(com.android.tradefed.invoker.IInvocationContext)를 통해 보고된 기본 빌드 정보를 반환합니다. 기본 빌드는 실행 중인 구성의 첫 번째 빌드 제공업체에서 반환한 빌드입니다. 컨텍스트가 없는 경우 (테스트 사례를 빌드할 수 없음) null을 반환합니다.

반환 값
`IBuildInfo`

getRunResults

public  getRunResults ()

이 메서드는 지원 중단되었습니다.
getMergedTestRunResults() 사용

모든 테스트 실행의 결과를 반환합니다.

반환 값

getTestRunAtAttempt

public TestRunResult getTestRunAtAttempt (String testRunName, 
                int attempt)

단일 시도에 대해 TestRunResult를 반환합니다.

매개변수
`testRunName`	`String`: {`testRunStarted(String, int)`에서 지정한 이름입니다.
`attempt`	`int`: 시도 ID입니다.

반환 값
`TestRunResult`	지정된 이름 및 시도 ID의 `TestRunResult` 또는 존재하지 않는 경우 `null`입니다.

getTestRunAttemptCount

public int getTestRunAttemptCount (String testRunName)

지정된 테스트 실행 이름의 시도 횟수를 반환합니다.

매개변수
`testRunName`	`String`: {`testRunStarted(String, int)`에서 지정한 이름입니다.

반환 값
`int`

getTestRunAttempts

public  getTestRunAttempts (String testRunName)

지정된 테스트 실행의 TestRunResult에 대한 모든 시도를 가져옵니다.

매개변수
`testRunName`	`String`: {`testRunStarted(String, int)`에서 지정한 이름입니다.

반환 값
	지정된 테스트 실행의 모든 `TestRunResult`로, 시도 횟수순으로 정렬됩니다.

getTestRunForAttempts

public  getTestRunForAttempts (int attempt)

지정된 시도의 모든 결과를 가져옵니다.

매개변수
`attempt`	`int`: 결과를 원하는 시도입니다.

반환 값
	특정 시도의 모든 `TestRunResult`

getTestRunNames

public  getTestRunNames ()

모든 테스트 실행의 모든 이름을 반환합니다.

이러한 테스트 실행은 여러 번 시도하여 여러 번 실행되었을 수 있습니다.

반환 값

hasFailedTests

public boolean hasFailedTests ()

호출에 실패한 테스트 또는 가정 실패 테스트가 있는지 여부를 반환합니다.

반환 값
`boolean`

hasTestRunResultsForName

public boolean hasTestRunResultsForName (String testRunName)

지정된 테스트 실행 이름에 결과가 있는지 여부를 반환합니다.

매개변수
`testRunName`	`String`: {`testRunStarted(String, int)`에서 지정한 이름입니다.

반환 값
`boolean`

invocationEnded

public void invocationEnded (long elapsedTime)

매개변수
`elapsedTime`	`long`

invocationFailed

public void invocationFailed (Throwable cause)

매개변수
`cause`	`Throwable`

invocationStarted

public void invocationStarted (IInvocationContext context)

매개변수
`context`	`IInvocationContext`

logAssociation

public void logAssociation (String dataName, 
                LogFile logFile)

매개변수
`dataName`	`String`
`logFile`	`LogFile`

setBuildInfo

public void setBuildInfo (IBuildInfo buildInfo)

이 메서드는 지원 중단되었습니다.
더 이상 테스트에 필요하지 않습니다.

빌드 정보를 설정합니다. 테스트용으로만 사용해야 합니다.

매개변수
`buildInfo`	`IBuildInfo`

setMergeStrategy

public void setMergeStrategy (MergeStrategy strategy)

결과를 병합할 때 사용할 MergeStrategy를 설정합니다.

매개변수
`strategy`	`MergeStrategy`

testAssumptionFailure

public void testAssumptionFailure (TestDescription test, 
                String trace)

매개변수
`test`	`TestDescription`
`trace`	`String`

testAssumptionFailure

public void testAssumptionFailure (TestDescription test, 
                FailureDescription failure)

매개변수
`test`	`TestDescription`
`failure`	`FailureDescription`

testEnded

public void testEnded (TestDescription test, 
                long endTime, 
                 testMetrics)

매개변수
`test`	`TestDescription`
`endTime`	`long`
`testMetrics`

testEnded

public void testEnded (TestDescription test, 
                 testMetrics)

매개변수
`test`	`TestDescription`
`testMetrics`

testFailed

public void testFailed (TestDescription test, 
                FailureDescription failure)

매개변수
`test`	`TestDescription`
`failure`	`FailureDescription`

testFailed

public void testFailed (TestDescription test, 
                String trace)

매개변수
`test`	`TestDescription`
`trace`	`String`

testIgnored

public void testIgnored (TestDescription test)

매개변수
`test`	`TestDescription`

testModuleEnded

public void testModuleEnded ()

testModuleStarted

public void testModuleStarted (IInvocationContext moduleContext)

매개변수
`moduleContext`	`IInvocationContext`

testRunEnded

public void testRunEnded (long elapsedTime, 
                 runMetrics)

매개변수
`elapsedTime`	`long`
`runMetrics`

testRunFailed

public void testRunFailed (FailureDescription failure)

매개변수
`failure`	`FailureDescription`

testRunFailed

public void testRunFailed (String errorMessage)

매개변수
`errorMessage`	`String`

testRunStarted

public void testRunStarted (String name, 
                int numTests, 
                int attemptNumber)

매개변수
`name`	`String`
`numTests`	`int`
`attemptNumber`	`int`

testRunStarted

public void testRunStarted (String name, 
                int numTests)

매개변수
`name`	`String`
`numTests`	`int`

testRunStarted

public void testRunStarted (String name, 
                int numTests, 
                int attemptNumber, 
                long startTime)

매개변수
`name`	`String`
`numTests`	`int`
`attemptNumber`	`int`
`startTime`	`long`

testRunStopped

public void testRunStopped (long elapsedTime)

매개변수
`elapsedTime`	`long`

testStarted

public void testStarted (TestDescription test, 
                long startTime)

매개변수
`test`	`TestDescription`
`startTime`	`long`

testStarted

public void testStarted (TestDescription test)

매개변수
`test`	`TestDescription`

보호된 메서드

clearModuleLogFiles

protected final void clearModuleLogFiles ()

모듈 파일을 정리하여 너무 오래 전송되지 않도록 합니다.

clearResultsForName

protected final void clearResultsForName (String testRunName)

지정된 실행 이름의 결과를 지울 수 있습니다. 결과 애그리게이터와 같은 경우에만 사용해야 합니다.

매개변수
`testRunName`	`String`

setIsAggregrateMetrics

protected void setIsAggregrateMetrics (boolean aggregate)

'집계 측정항목' 옵션 전환

매개변수
`aggregate`	`boolean`