自 2025 年 3 月 27 日起，我们建议您使用 android-latest-release 而非 aosp-main 构建 AOSP 并为其做出贡献。如需了解详情，请参阅 AOSP 的变更。

此页面由 Cloud Translation API 翻译。

TestRunResult

public class TestRunResult
extends Object implements ITestRunListener

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

用于保存单次测试运行的结果。

准确统计测试次数，并跟踪未完成的测试。

不具有线程安全性！必须按顺序调用 test* 回调

摘要

公共构造函数
`TestRunResult()` 创建一个空的`TestRunResult`。

公共方法
	`getCompletedTests()` 获取已完成的测试集。
`long`	`getElapsedTime()` 返回当前运行已过去的时间。
`String`	`getName()`
`int`	`getNumAllFailedTests()` 返回处于失败状态（失败、假设失败）的测试总数
`int`	`getNumCompleteTests()` 获取相应运行中已完成的测试数量，即状态不为“不完整”的测试数量。
`int`	`getNumTests()` 获取相应运行中的测试数量。
`int`	`getNumTestsInState(TestResult.TestStatus status)` 获取相应运行中处于指定状态的测试数量。
`String`	`getRunFailureMessage()` 如果运行未失败，则返回运行失败错误消息 `null`。
	`getRunMetrics()`
	`getTestResults()` 返回测试结果的映射。
`String`	`getTextSummary()` 返回一个描述结果的易懂字符串。
`boolean`	`hasFailedTests()`
`boolean`	`isRunComplete()`
`boolean`	`isRunFailure()`
`void`	`setAggregateMetrics(boolean metricAggregation)`
`void`	`setRunComplete(boolean runComplete)`
`void`	`testAssumptionFailure(TestIdentifier test, String trace)` 当原子测试标记其假设的条件为 false 时调用
`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 testCount)` 报告测试运行的开始。
`void`	`testRunStopped(long elapsedTime)` 报告测试运行因用户请求而在完成前停止。
`void`	`testStarted(TestIdentifier test)` 报告单个测试用例的开始。

公共构造函数

TestRunResult

public TestRunResult ()

创建空的 TestRunResult。

公共方法

getCompletedTests

public  getCompletedTests ()

获取已完成的测试集。

返回

getElapsedTime

public long getElapsedTime ()

返回当前运行的已用时间。

返回
`long`

getName

public String getName ()

返回
`String`	测试运行名称

getNumAllFailedTests

public int getNumAllFailedTests ()

返回处于失败状态（失败、假设失败）的测试总数

返回
`int`

getNumCompleteTests

public int getNumCompleteTests ()

获取相应运行中已完成的测试数量，即状态不为“不完整”的测试数量。

返回
`int`

getNumTests

public int getNumTests ()

获取相应运行中的测试数量。

返回
`int`

getNumTestsInState

public int getNumTestsInState (TestResult.TestStatus status)

获取相应运行中处于指定状态的测试数量。

参数
`status`	`TestResult.TestStatus`

返回
`int`

getRunFailureMessage

public String getRunFailureMessage ()

如果运行未失败，则返回运行失败错误消息 null。

返回
`String`

getRunMetrics

public  getRunMetrics ()

返回
	测试运行指标的 `ERROR(/Map)`。

getTestResults

public  getTestResults ()

返回测试结果的映射。

返回

getTextSummary

public String getTextSummary ()

返回一个描述结果的易懂字符串。

返回
`String`

hasFailedTests

public boolean hasFailedTests ()

返回
`boolean`	如果测试运行有任何失败或出错的测试，则为 `true`。

isRunComplete

public boolean isRunComplete ()

返回
`boolean`	如果测试运行已完成，则为 `true`。

isRunFailure

public boolean isRunFailure ()

返回
`boolean`	如果测试运行失败，则为 `true`。

setAggregateMetrics

public void setAggregateMetrics (boolean metricAggregation)

参数
`metricAggregation`	`boolean`

setRunComplete

public void setRunComplete (boolean runComplete)

参数
`runComplete`	`boolean`

testAssumptionFailure

public void testAssumptionFailure (TestIdentifier test, 
                String trace)

当原子测试标记其假设的条件为 false 时调用

参数
`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 testCount)

报告测试运行的开始。

参数
`runName`	`String`：测试运行名称
`testCount`	`int`：测试运行中的测试总数

testRunStopped

public void testRunStopped (long elapsedTime)

报告测试运行因用户请求而在完成前停止。

参数
`elapsedTime`	`long`：设备报告的已用时间，以毫秒为单位

testStarted

public void testStarted (TestIdentifier test)

报告单个测试用例的开始。

参数
`test`	`TestIdentifier`：用于标识测试