此页面由 Cloud Translation API 翻译。

TestRunResult

public class TestRunResult
extends Object

java.lang.Object 中
↳	com.android.tradefed.result.TestRunResult

保存单个测试运行的结果。

保持准确的测试计数，并跟踪未完成的测试。

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

摘要

字段
`public static final String`	`ERROR_DIVIDER`

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

公共方法
	`getCompletedTests()` 获取已完成的测试集。
`long`	`getElapsedTime()` 返回当前运行所用时间。
`int`	`getExpectedTestCount()` 获取此 TestRunResult 预计包含的测试用例数。
	`getFailedTests()` 获取失败的测试集。
`String`	`getName()`
`int`	`getNumAllFailedTests()` 返回处于失败状态（失败、假设失败）的测试总数
`int`	`getNumCompleteTests()` 获取本次运行中完整测试的数量，即状态为 != 未完成。
`int`	`getNumTests()` 获取此运行作业中的测试数量。
`int`	`getNumTestsInState(TestStatus status)` 获取此运行的处于给定状态的测试数量。
`int`	`getNumTestsInState(TestResult.TestStatus ddmlibStatus)` 以便与之前的状态兼容。
	`getPassedTests()` 获取一组已通过的测试。
`FailureDescription`	`getRunFailureDescription()` 返回运行失败描述符；如果运行未失败，则返回 `null`。
`String`	`getRunFailureMessage()` 返回运行失败错误消息；如果运行未失败，则返回 `null`。
`MultiMap<String, LogFile>`	`getRunLoggedFiles()` 返回地图的副本，其中包含与该测试用例相关联的所有记录文件。
	`getRunMetrics()`
	`getRunProtoMetrics()`
`long`	`getStartTime()` 返回第一次 testRunStart 调用的开始时间。
	`getTestResults()` 返回测试结果的地图。
	`getTestsInState( statuses)` 获取处于指定状态的一组测试。
	`getTestsResultsInState(TestStatus status)` 返回特定状态的所有 `TestResult`。
`String`	`getTextSummary()` 返回描述结果的用户友好型字符串。
`boolean`	`hasFailedTests()`
`boolean`	`isRunComplete()`
`boolean`	`isRunFailure()`
`static TestRunResult`	`merge( testRunResults)`
`static TestRunResult`	`merge( testRunResults, MergeStrategy strategy)` 合并同一 testRunName 的多个 TestRunResults。
`void`	`resetRunFailure()` 重置运行失败状态。
`void`	`setAggregateMetrics(boolean metricAggregation)`
`void`	`setRunComplete(boolean runComplete)`
`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`	`testLogSaved(String dataName, LogFile logFile)` 系统会存储有关正在记录的文件的信息，并将其与测试用例或测试运行相关联进行中。
`void`	`testRunEnded(long elapsedTime, runMetrics)` 使用新的 proto 指标的新界面。
`void`	`testRunFailed(FailureDescription failureDescription)`
`void`	`testRunFailed(String errorMessage)`
`void`	`testRunStarted(String runName, int testCount, long startTime)` 通知测试运行已开始。
`void`	`testRunStarted(String runName, int testCount)` 通知测试运行已开始。
`void`	`testRunStopped(long elapsedTime)`
`void`	`testSkipped(TestDescription test, SkipReason reason)`
`void`	`testStarted(TestDescription test, long startTime)`
`void`	`testStarted(TestDescription test)`

字段

ERROR_DIVIDER 错误

public static final String ERROR_DIVIDER

公共构造函数

TestRunResult

public TestRunResult ()

创建一个空的 TestRunResult。

公共方法

getCompletedTests

public  getCompletedTests ()

获取已完成的测试集。

返回

已用时间

public long getElapsedTime ()

返回当前运行所用时间。

返回
`long`

getexpectedTestCount

public int getExpectedTestCount ()

获取此 TestRunResult 预计包含的测试用例数。实际数字可能是低于预期数量。通常，这种不一致就表示测试运行失败。

返回
`int`

getFailedTest

public  getFailedTests ()

获取失败的测试集。

返回

getName

public String getName ()

返回
`String`	测试运行名称

getNumAllFailedTests

public int getNumAllFailedTests ()

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

返回
`int`

getNumCompleteTests

public int getNumCompleteTests ()

获取本次运行中完整测试的数量，即状态为 != 未完成。

返回
`int`

getNumTests 类的构造函数

public int getNumTests ()

获取此运行作业中的测试数量。

返回
`int`

getNumTestsInState

public int getNumTestsInState (TestStatus status)

获取此运行的处于给定状态的测试数量。

参数
`status`	`TestStatus`

返回
`int`

getNumTestsInState

public int getNumTestsInState (TestResult.TestStatus ddmlibStatus)

以便与之前的状态兼容。改用 getNumTestsInState(com.android.tradefed.result.TestStatus)。

参数
`ddmlibStatus`	`TestResult.TestStatus`

返回
`int`

getPassedTest

public  getPassedTests ()

获取一组已通过的测试。

返回

getRunFailureDescription

public FailureDescription getRunFailureDescription ()

返回运行失败描述符；如果运行未失败，则返回 null。

返回
`FailureDescription`

getRunFailureMessage

public String getRunFailureMessage ()

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

返回
`String`

getRunLoggedFiles

public MultiMap<String, LogFile> getRunLoggedFiles ()

返回地图的副本，其中包含与该测试用例相关联的所有记录文件。

返回
`MultiMap<String, LogFile>`

getRunMetrics

public  getRunMetrics ()

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

getRunProtoMetrics

public  getRunProtoMetrics ()

返回
	采用新 proto 格式的测试运行指标的 `ERROR(/Map)`。

getStartTime

public long getStartTime ()

返回第一次 testRunStart 调用的开始时间。

返回
`long`

getTestResults

public  getTestResults ()

返回测试结果的地图。

返回

getTestsInState

public  getTestsInState ( statuses)

获取处于指定状态的一组测试。

参数
`statuses`

返回

getTestsResultsInState

public  getTestsResultsInState (TestStatus status)

返回特定状态的所有 TestResult。

参数
`status`	`TestStatus`

返回

getTextSummary

public String getTextSummary ()

返回描述结果的用户友好型字符串。

返回
`String`

hasFailedTests

public boolean hasFailedTests ()

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

isRunComplete

public boolean isRunComplete ()

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

isRunFailure

public boolean isRunFailure ()

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

合并

public static TestRunResult merge ( testRunResults)

参数
`testRunResults`

返回
`TestRunResult`

另见：

ERROR(/#merge(List, MergeStrategy))

合并

public static TestRunResult merge ( testRunResults, 
                MergeStrategy strategy)

合并同一 testRunName 的多个 TestRunResults。如果某个测试用例出现在多个 TestRunResults，但结果不同（例如，“boottest-device”运行三次结果失败-失败-通过），我们会将失败运行中的所有堆栈轨迹串联起来，并信任最终结果状态、指标、日志文件和开始/结束时间的运行结果。

参数
`testRunResults`	：要合并的 TestRunResult 列表。
`strategy`	`MergeStrategy`：用于合并结果的合并策略。

返回
`TestRunResult`	包含来自 testRunResults 的合并数据的最终 TestRunResult。

resetRunFailure

public void resetRunFailure ()

重置运行失败状态。

重试时有时需要重置运行失败状态。此操作应注意不要清除真正的故障

setAggregateMetrics

public void setAggregateMetrics (boolean metricAggregation)

参数
`metricAggregation`	`boolean`

setRunComplete

public void setRunComplete (boolean runComplete)

参数
`runComplete`	`boolean`

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`

测试失败

public void testFailed (TestDescription test, 
                FailureDescription failure)

参数
`test`	`TestDescription`
`failure`	`FailureDescription`

测试失败

public void testFailed (TestDescription test, 
                String trace)

参数
`test`	`TestDescription`
`trace`	`String`

testIgnored

public void testIgnored (TestDescription test)

参数
`test`	`TestDescription`

testLogSaved

public void testLogSaved (String dataName, 
                LogFile logFile)

系统会存储有关正在记录的文件的信息，并将其与测试用例或测试运行相关联进行中。

参数
`dataName`	`String`：引用数据的名称。
`logFile`	`LogFile`：表示对象的保存位置的 `LogFile` 对象，以及提供相关信息

testRunEnded

public void testRunEnded (long elapsedTime, 
                 runMetrics)

使用新的 proto 指标的新界面。

参数
`elapsedTime`	`long`
`runMetrics`

testRunFailed

public void testRunFailed (FailureDescription failureDescription)

参数
`failureDescription`	`FailureDescription`

testRunFailed

public void testRunFailed (String errorMessage)

参数
`errorMessage`	`String`

testRunStarted

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

通知测试运行已开始。

参数
`runName`	`String`：为进行跟踪而与测试运行关联的名称。
`testCount`	`int`：与测试运行相关的预期测试用例数。
`startTime`	`long`

testRunStarted

public void testRunStarted (String runName, 
                int testCount)

通知测试运行已开始。

参数
`runName`	`String`：为进行跟踪而与测试运行关联的名称。
`testCount`	`int`：与测试运行相关的预期测试用例数。

testRunStopped

public void testRunStopped (long elapsedTime)

参数
`elapsedTime`	`long`

testSkipped（已跳过测试）

public void testSkipped (TestDescription test, 
                SkipReason reason)

参数
`test`	`TestDescription`
`reason`	`SkipReason`

testStarted

public void testStarted (TestDescription test, 
                long startTime)

参数
`test`	`TestDescription`
`startTime`	`long`

testStarted

public void testStarted (TestDescription test)

参数
`test`	`TestDescription`