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

XmlTestRunListener

public class XmlTestRunListener
extends Object implements ITestRunListener

java.lang.Object
↳	com.android.ddmlib.testrunner.XmlTestRunListener

JUnit 결과를 Ant의 XMLJUnitResultFormatter와 일치하는 형식의 XML 파일에 작성합니다.

테스트 실행별로 별도의 XML 파일을 만듭니다.

참고:

https://svn.jenkins-ci.org/trunk/hudson/dtkit/dtkit-format/dtkit-junit-model/src/main/resources/com/thalesgroup/dtkit/junit/model/xsd/junit-4.xsd

요약

공개 생성자
`XmlTestRunListener()`

공개 메서드
`void`	`addSystemError(String systemError)` 시스템 오류 메시지 추가
`TestRunResult`	`getRunResult()` `TestRunResult`을 반환합니다.
`String`	`getSystemError()` 'system-err' 요소의 XML 파일에 작성할 시스템 오류 메시지를 반환합니다.
`void`	`setHostName(String hostName)`
`void`	`setReportDir(File file)` 사용할 보고서 파일을 설정합니다.
`void`	`testAssumptionFailure(TestIdentifier test, String trace)` 원자 테스트에서 거짓인 조건을 가정한다고 표시할 때 호출됩니다.
`void`	`testEnded(TestIdentifier test, testMetrics)` 개별 테스트 사례의 실행 종료를 보고합니다.
`void`	`testFailed(TestIdentifier test, String trace)` 개별 테스트 사례의 실패를 보고합니다.
`void`	`testIgnored(TestIdentifier test)` 테스트가 실행되지 않을 때 호출됩니다. 일반적으로 테스트 메서드에 org.junit.Ignore가 주석으로 달려 있기 때문입니다.
`void`	`testRunEnded(long elapsedTime, runMetrics)` 테스트 실행의 종료를 보고합니다.
`void`	`testRunFailed(String errorMessage)` 심각한 오류로 인해 테스트 실행을 완료하지 못했다고 보고합니다.
`void`	`testRunStarted(String runName, int numTests)` 테스트 실행 시작을 보고합니다.
`void`	`testRunStopped(long elapsedTime)` 사용자 요청으로 인해 테스트 실행이 완료되기 전에 중지되었다고 보고합니다.
`void`	`testStarted(TestIdentifier test)` 개별 테스트 사례의 시작을 보고합니다.

보호된 메서드
	`getPropertiesAttributes()` 테스트 보고서에 포함할 속성 속성을 키-값 쌍으로 가져옵니다.
`File`	`getResultFile(File reportDir)` 보고서가 생성될 `ERROR(/File)`를 만듭니다.
`String`	`getTestName(TestIdentifier testId)`
`String`	`getTestSuiteName()`

공개 생성자

XmlTestRunListener

public XmlTestRunListener ()

공개 메서드

addSystemError

public void addSystemError (String systemError)

시스템 오류 메시지 추가

매개변수
`systemError`	`String`

getRunResult

public TestRunResult getRunResult ()

TestRunResult을 반환합니다.

반환 값
`TestRunResult`	테스트 실행 결과

getSystemError

public String getSystemError ()

'system-err' 요소의 XML 파일에 작성할 시스템 오류 메시지를 반환합니다. 이 함수가 빈 문자열을 반환하면 요소가 생성되지 않습니다.

반환 값
`String`

setHostName

public void setHostName (String hostName)

매개변수
`hostName`	`String`

setReportDir

public void setReportDir (File file)

사용할 보고서 파일을 설정합니다.

매개변수
`file`	`File`

testAssumptionFailure

public void testAssumptionFailure (TestIdentifier test, 
                String trace)

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

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

testEnded

public void testEnded (TestIdentifier test, 
                 testMetrics)

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

testFailed(TestIdentifier, String)가 호출되지 않은 경우 이 테스트는 통과됩니다. 테스트 사례 실행 중에 발생했을 수 있는 키/값 측정항목도 반환합니다.

매개변수

test

TestIdentifier: 테스트를 식별합니다.

testMetrics

: android.app.Instrumentation#sendStatus에 의해 테스트 사례가 실행되는 동안 방출된 측정항목의 ERROR(/Map)입니다. 동일한 키를 여러 번 내보내지 않는 한 삽입 순서가 유지됩니다. IInstrumentationResultParser.StatusKeys에 정의된 표준 키는 이 맵에서 필터링됩니다. Ddmlib는 IInstrumentationResultParser.StatusKeys에 정의된 추가 테스트 측정항목을 추가할 수 있습니다.

testFailed

public void testFailed (TestIdentifier test, 
                String trace)

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

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

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

testIgnored

public void testIgnored (TestIdentifier test)

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

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

testRunEnded

public void testRunEnded (long elapsedTime, 
                 runMetrics)

테스트 실행의 종료를 보고합니다.

매개변수

elapsedTime

long: 기기에서 보고한 경과 시간(밀리초)

runMetrics

: android.app.Instrumentation#addResults에 의해 테스트 사례가 실행되는 동안 방출된 측정항목의 ERROR(/Map)입니다. 동일한 키를 여러 번 내보내지 않는 한 삽입 순서가 유지됩니다. IInstrumentationResultParser.StatusKeys에 정의된 표준 키는 이 맵에서 필터링됩니다. Ddmlib는 IInstrumentationResultParser.StatusKeys에 정의된 추가 테스트 측정항목을 추가할 수 있습니다.

testRunFailed

public void testRunFailed (String errorMessage)

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

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

testRunStarted

public void testRunStarted (String runName, 
                int numTests)

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

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

testRunStopped

public void testRunStopped (long elapsedTime)

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

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

testStarted

public void testStarted (TestIdentifier test)

개별 테스트 사례의 시작을 보고합니다.

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

보호된 메서드

getPropertiesAttributes

protected  getPropertiesAttributes ()

테스트 보고서에 포함할 속성 속성을 키-값 쌍으로 가져옵니다.

반환 값

getResultFile

protected File getResultFile (File reportDir)

보고서가 생성될 ERROR(/File)를 만듭니다.

매개변수
`reportDir`	`File`: 보고서의 루트 디렉터리입니다.

반환 값
`File`	파일

생성 값
	IOException

getTestName

protected String getTestName (TestIdentifier testId)

매개변수
`testId`	`TestIdentifier`

반환 값
`String`

getTestSuiteName

protected String getTestSuiteName ()

반환 값
`String`