Google cam kết thúc đẩy công bằng chủng tộc cho Cộng đồng người da đen. Xem cách thực hiện.

Trang này được dịch bởi Cloud Translation API.

Thu thậpTestListener

public class CollectingTestListener
extends Object implements IDisableable, ILogSaverListener, ITestInvocationListener

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

Các lớp con trực tiếp đã biết

JsonHttpTestResultReporter, LUCIResultReporter, MetricsXMLResultReporter, ModuleListener, ReportThroughTestTests, ResultAggregator, ShardListener, SuiteResultReporter, XmlResultReporter

JsonHttpTestResultReporter	Một trình báo cáo kết quả mã hoá kết quả các chỉ số kiểm thử và nhánh, thông tin thiết bị thành JSON và POST vào điểm cuối của dịch vụ HTTP
LUCIResultReporter	Trình báo cáo kết quả lưu kết quả kiểm thử mà ResultDB và LUCI cần vào định dạng JSON (go/result-sink) và ghi lại vị trí tệp trong bảng điều khiển.
MetricsXMLResultReporter	MetricsXMLResultReporter ghi các chỉ số kiểm thử và chạy các chỉ số vào một tệp XML trong thư mục do tham số metrics-folder chỉ định ở giai đoạn invocationEnded của kiểm thử.
ModuleListener	Trình nghe được đính kèm vào mỗi `IRemoteTest` của mỗi mô-đun để thu thập danh sách kết quả.
ReportPassedTests	Báo cáo trong tệp các bộ lọc có thể dùng để loại trừ kiểm thử đã đạt.
ResultAggregator	Trình chuyển tiếp đặc biệt tổng hợp các kết quả khi cần, dựa trên chiến lược thử lại đã được thực hiện.
ShardListener	`ITestInvocationListener` thu thập kết quả từ một mảnh lệnh gọi (còn gọi là một lệnh gọi phân tách để chạy song song trên nhiều tài nguyên) và chuyển tiếp các kết quả đó đến một trình nghe khác.
SuiteResultReporter	Thu thập kết quả kiểm thử cho toàn bộ lệnh gọi bộ kiểm thử và xuất kết quả cuối cùng.
XmlResultReporter	Ghi kết quả JUnit vào một tệp XML ở định dạng phù hợp với XMLJUnitResultFormatter của Ant.

Các lớp con gián tiếp đã biết

FormattedGeneratorReporter, XmlFormattedGeneratorReporter

FormattedGeneratorReporter	Trình báo cáo cho phép tạo báo cáo ở một định dạng cụ thể.
XmlFormattedGeneratorReporter	Triển khai `FormattedGeneratorReporter` để định dạng kết quả của bộ công cụ ở định dạng xml.

ITestInvocationListener sẽ thu thập tất cả kết quả kiểm thử.

Mặc dù các cấu trúc dữ liệu được sử dụng trong đối tượng này an toàn với luồng, nhưng bạn phải gọi lệnh gọi lại ITestInvocationListener theo đúng thứ tự.

Tóm tắt

Hàm khởi tạo công khai
`CollectingTestListener()`

Phương thức công khai
`IBuildInfo`	`getBuildInfo()` Phương thức này không còn được dùng nữa. dựa vào `IBuildInfo` từ `getInvocationContext()`.
`TestRunResult`	`getCurrentRunResults()` Lấy kết quả cho lần chạy kiểm thử hiện tại.
`int`	`getExpectedTests()` Trả về số lượng kiểm thử dự kiến.
`IInvocationContext`	`getInvocationContext()` Trả về ngữ cảnh lệnh gọi được báo cáo qua `invocationStarted(com.android.tradefed.invoker.IInvocationContext)`
	`getMergedTestRunResults()` Trả về tập hợp kết quả hợp nhất cho tất cả các lần chạy trên nhiều lần thử.
`IInvocationContext`	`getModuleContextForRunResult(String testRunName)` Trả về `IInvocationContext` của mô-đun liên kết với kết quả.
`MultiMap<String, LogFile>`	`getModuleLogFiles()` Trả về bản sao của bản đồ chứa tất cả tệp được ghi nhật ký liên kết với mô-đun
`MultiMap<String, LogFile>`	`getNonAssociatedLogFiles()` Trả về bản sao của bản đồ chứa tất cả tệp được ghi nhật ký không liên kết với một lần chạy kiểm thử hoặc một mô-đun.
`int`	`getNumAllFailedTestRuns()` Trả về tổng số lần chạy kiểm thử ở trạng thái không thành công
`int`	`getNumAllFailedTests()` Trả về tổng số lượt kiểm thử ở trạng thái lỗi (chỉ không thành công, các lỗi giả định sẽ không được tính vào trạng thái này).
`int`	`getNumTestsInState(TestStatus status)` Trả về số lượng kiểm thử ở trạng thái đã cho cho lần chạy này.
`int`	`getNumTestsInState(TestResult.TestStatus ddmlibStatus)` Để tương thích với loại trạng thái cũ
`int`	`getNumTotalTests()` Trả về tổng số bài kiểm thử hoàn chỉnh cho tất cả các lần chạy.
`IBuildInfo`	`getPrimaryBuildInfo()` Trả về thông tin bản dựng chính đã được báo cáo thông qua `invocationStarted(com.android.tradefed.invoker.IInvocationContext)`.
	`getRunResults()` Phương thức này không còn được dùng nữa. Sử dụng `getMergedTestRunResults()`
`TestRunResult`	`getTestRunAtAttempt(String testRunName, int attempt)` Trả về `TestRunResult` cho một lần thử.
`int`	`getTestRunAttemptCount(String testRunName)` Trả về số lần thử cho một tên chạy kiểm thử nhất định.
	`getTestRunAttempts(String testRunName)` Lấy tất cả các lần thử cho `TestRunResult` của một lần chạy kiểm thử nhất định.
	`getTestRunForAttempts(int attempt)` Lấy tất cả kết quả cho một lần thử nhất định.
	`getTestRunNames()` Trả về tất cả tên cho tất cả các lần chạy kiểm thử.
`boolean`	`hasFailedTests()` Trả về kết quả nếu lệnh gọi có bất kỳ kiểm thử nào không thành công hoặc giả định không thành công.
`boolean`	`hasTestRunResultsForName(String testRunName)` Trả về xem một tên chạy kiểm thử nhất định có kết quả hay không.
`void`	`invocationEnded(long elapsedTime)` Báo cáo rằng lệnh gọi đã kết thúc, cho dù thành công hay do một số điều kiện lỗi.
`void`	`invocationFailed(Throwable cause)` Báo cáo một lệnh gọi chưa hoàn tất do một số điều kiện lỗi.
`void`	`invocationSkipped(SkipReason reason)` Báo cáo một lệnh gọi là đã bỏ qua
`void`	`invocationStarted(IInvocationContext context)` Báo cáo thời điểm bắt đầu lệnh gọi kiểm thử.
`boolean`	`isDisabled()` Trả về True nếu toàn bộ đối tượng bị tắt (bỏ qua cả quá trình thiết lập và gỡ bỏ).
`void`	`logAssociation(String dataName, LogFile logFile)` Trong một số trường hợp, nhật ký phải được liên kết chặt chẽ với một trường hợp kiểm thử, nhưng không thể thực hiện việc này trên lệnh gọi lại `testLogSaved(String, com.android.tradefed.result.LogDataType, com.android.tradefed.result.InputStreamSource, com.android.tradefed.result.LogFile)` trực tiếp.
`void`	`setBuildInfo(IBuildInfo buildInfo)` Phương thức này không còn được dùng nữa. Không cần thiết cho việc kiểm thử nữa.
`void`	`setDisable(boolean isDisabled)` Thiết lập xem có nên tắt đối tượng hay không.
`void`	`setMergeStrategy(MergeStrategy strategy)` Đặt `MergeStrategy` để sử dụng khi hợp nhất kết quả.
`void`	`testAssumptionFailure(TestDescription test, String trace)` Được gọi khi một kiểm thử nguyên tử gắn cờ giả định một điều kiện là sai
`void`	`testAssumptionFailure(TestDescription test, FailureDescription failure)` Được gọi khi một kiểm thử nguyên tử gắn cờ giả định một điều kiện là sai
`void`	`testEnded(TestDescription test, long endTime, testMetrics)` Thay thế cho `ERROR(/#testEnded(com.android.tradefed.result.TestDescription,Map))`, trong đó chúng ta có thể trực tiếp chỉ định thời gian kết thúc.
`void`	`testEnded(TestDescription test, testMetrics)` Báo cáo việc kết thúc thực thi của một trường hợp kiểm thử riêng lẻ.
`void`	`testFailed(TestDescription test, FailureDescription failure)` Báo cáo lỗi của một trường hợp kiểm thử riêng lẻ.
`void`	`testFailed(TestDescription test, String trace)` Báo cáo lỗi của một trường hợp kiểm thử riêng lẻ.
`void`	`testIgnored(TestDescription test)` Được gọi khi một chương trình kiểm thử sẽ không chạy, thường là do một phương thức kiểm thử được chú thích bằng org.junit.Ignore.
`void`	`testModuleEnded()` Báo cáo kết thúc quá trình chạy mô-đun.
`void`	`testModuleStarted(IInvocationContext moduleContext)` Báo cáo thời điểm bắt đầu chạy một mô-đun.
`void`	`testRunEnded(long elapsedTime, runMetrics)` Báo cáo kết thúc quá trình chạy kiểm thử.
`void`	`testRunFailed(FailureDescription failure)` Không thể hoàn tất quá trình chạy kiểm thử báo cáo do lỗi do `FailureDescription` mô tả.
`void`	`testRunFailed(String errorMessage)` Không thể hoàn tất quá trình chạy kiểm thử báo cáo do lỗi nghiêm trọng.
`void`	`testRunStarted(String name, int numTests, int attemptNumber)` Báo cáo thời điểm bắt đầu chạy kiểm thử.
`void`	`testRunStarted(String name, int numTests)` Báo cáo thời điểm bắt đầu chạy kiểm thử.
`void`	`testRunStarted(String name, int numTests, int attemptNumber, long startTime)` Báo cáo thời điểm bắt đầu chạy kiểm thử.
`void`	`testRunStopped(long elapsedTime)` Quá trình chạy kiểm thử báo cáo đã dừng trước khi hoàn tất do yêu cầu của người dùng.
`void`	`testSkipped(TestDescription test, SkipReason reason)` Được gọi khi một kiểm thử bị bỏ qua và không thực thi vì một lý do không thường xảy ra.
`void`	`testStarted(TestDescription test, long startTime)` Thay thế cho `testStarted(com.android.tradefed.result.TestDescription)`, trong đó chúng ta cũng chỉ định thời điểm bắt đầu kiểm thử, kết hợp với `ERROR(/#testEnded(com.android.tradefed.result.TestDescription,long,Map))` để đo lường chính xác.
`void`	`testStarted(TestDescription test)` Báo cáo thời điểm bắt đầu một trường hợp kiểm thử riêng lẻ.

Phương thức được bảo vệ
`final void`	`clearModuleLogFiles()` Cho phép dọn dẹp tệp mô-đun để chúng ta tránh phải mang theo quá lâu.
`final void`	`clearResultsForName(String testRunName)` Cho phép xoá kết quả cho một tên chạy nhất định.
`void`	`setIsAggregrateMetrics(boolean aggregate)` Bật/tắt tuỳ chọn "chỉ số tổng hợp"

Hàm khởi tạo công khai

CollectingTestListener

public CollectingTestListener ()

Phương thức công khai

getBuildInfo

public IBuildInfo getBuildInfo ()

Phương thức này không còn được dùng nữa.
dựa vào IBuildInfo từ getInvocationContext().

Trả về thông tin bản dựng.

Giá trị trả về
`IBuildInfo`

nhận kết quả hiện tại

public TestRunResult getCurrentRunResults ()

Lấy kết quả của lần chạy kiểm thử hiện tại.

Xin lưu ý rằng kết quả có thể chưa đầy đủ. Bạn nên kiểm tra giá trị của TestRunResult.isRunComplete() và/hoặc (@link TestRunResult#isRunFailure()} nếu phù hợp trước khi xử lý kết quả.

Giá trị trả về
`TestRunResult`	`TestRunResult` đại diện cho dữ liệu được thu thập trong lần chạy kiểm thử gần đây nhất

getExpectedTests

public int getExpectedTests ()

Trả về số lượng kiểm thử dự kiến. Có thể khác với getNumTotalTests() nếu một số chương trình kiểm thử không chạy.

Giá trị trả về
`int`

getInvocationContext

public IInvocationContext getInvocationContext ()

Trả về ngữ cảnh lệnh gọi được báo cáo qua invocationStarted(com.android.tradefed.invoker.IInvocationContext)

Giá trị trả về
`IInvocationContext`

getMergedTestRunResults

public  getMergedTestRunResults ()

Trả về tập hợp kết quả hợp nhất cho tất cả các lần chạy trên nhiều lần thử.

Nếu có nhiều kết quả, mỗi lần chạy kiểm thử sẽ được hợp nhất, trong đó kết quả kiểm thử mới nhất sẽ ghi đè kết quả kiểm thử của các lần chạy trước. Các lần chạy kiểm thử được sắp xếp theo số lần thử.

Các chỉ số cho cùng một lượt thử sẽ được hợp nhất dựa trên lựa chọn ưu tiên do aggregate-metrics đặt. Các chỉ số cuối cùng sẽ là chỉ số của lần thử cuối cùng.

Giá trị trả về

getModuleContextForRunResult

public IInvocationContext getModuleContextForRunResult (String testRunName)

Trả về IInvocationContext của mô-đun liên kết với kết quả.

Tham số
`testRunName`	`String`: Tên do {`testRunStarted(String, int)` cung cấp.

Giá trị trả về
`IInvocationContext`	`IInvocationContext` của mô-đun cho tên chạy kiểm thử đã cho `null` nếu không có kết quả nào cho tên đó.

getModuleLogFiles

public MultiMap<String, LogFile> getModuleLogFiles ()

Trả về bản sao của bản đồ chứa tất cả tệp đã ghi nhật ký liên kết với mô-đun

Giá trị trả về
`MultiMap<String, LogFile>`

getNonAssociatedLogFiles

public MultiMap<String, LogFile> getNonAssociatedLogFiles ()

Trả về bản sao của bản đồ chứa tất cả tệp được ghi nhật ký không liên kết với một lần chạy kiểm thử hoặc một mô-đun.

Giá trị trả về
`MultiMap<String, LogFile>`

getNumAllFailedTestRuns

public int getNumAllFailedTestRuns ()

Trả về tổng số lần chạy kiểm thử ở trạng thái không thành công

Giá trị trả về
`int`

getNumAllFailedTests

public int getNumAllFailedTests ()

Trả về tổng số kiểm thử ở trạng thái không thành công (chỉ những kiểm thử không thành công, các lỗi giả định không được tính vào).

Giá trị trả về
`int`

getNumTestsInState

public int getNumTestsInState (TestStatus status)

Trả về số lượng chương trình kiểm thử ở trạng thái đã cho cho lần chạy này.

Tham số
`status`	`TestStatus`

Giá trị trả về
`int`

getNumTestsInState

public int getNumTestsInState (TestResult.TestStatus ddmlibStatus)

Để tương thích với loại trạng thái cũ

Tham số
`ddmlibStatus`	`TestResult.TestStatus`

Giá trị trả về
`int`

getNumTotalTests

public int getNumTotalTests ()

Trả về tổng số bài kiểm thử hoàn chỉnh cho tất cả các lần chạy.

Giá trị trả về
`int`

getPrimaryBuildInfo

public IBuildInfo getPrimaryBuildInfo ()

Trả về thông tin bản dựng chính đã được báo cáo qua invocationStarted(com.android.tradefed.invoker.IInvocationContext). Bản dựng chính là bản dựng do trình cung cấp bản dựng đầu tiên của cấu hình đang chạy trả về. Trả về giá trị rỗng nếu không có ngữ cảnh (không có bản dựng để kiểm thử trường hợp).

Giá trị trả về
`IBuildInfo`

nhận kết quả Run

public  getRunResults ()

Phương thức này không còn được dùng nữa.
Hãy sử dụng getMergedTestRunResults()

Trả về kết quả cho tất cả lần chạy kiểm thử.

Giá trị trả về

getTestRunAtTry (Chạy)

public TestRunResult getTestRunAtAttempt (String testRunName, 
                int attempt)

Trả về TestRunResult cho một lần thử.

Tham số
`testRunName`	`String`: Tên do {`testRunStarted(String, int)` đặt.
`attempt`	`int`: Mã lần thử.

Giá trị trả về
`TestRunResult`	`TestRunResult` cho tên và mã hoạt động đã đặt hoặc `null` nếu không tồn tại.

getTestRunRunCount

public int getTestRunAttemptCount (String testRunName)

Trả về số lần thử cho một tên chạy kiểm thử nhất định.

Tham số
`testRunName`	`String`: Tên do {`testRunStarted(String, int)` đặt.

Giá trị trả về
`int`

getTestRunAttempts

public  getTestRunAttempts (String testRunName)

Lấy tất cả các lần thử cho TestRunResult của một lần chạy kiểm thử nhất định.

Tham số
`testRunName`	`String`: Tên do {`testRunStarted(String, int)` cung cấp.

Giá trị trả về
	Tất cả `TestRunResult` cho một lần chạy kiểm thử nhất định, được sắp xếp theo số lần thử.

getTestRunForAttempts

public  getTestRunForAttempts (int attempt)

Lấy tất cả kết quả cho một lần thử nhất định.

Tham số
`attempt`	`int`: Lượt thử nghiệm mà chúng ta muốn có kết quả.

Giá trị trả về
	Tất cả `TestRunResult` cho một lần thử nhất định.

getTestRunNames

public  getTestRunNames ()

Trả về tất cả tên cho tất cả lần chạy kiểm thử.

Các lần chạy kiểm thử này có thể đã chạy nhiều lần với nhiều lần thử.

Giá trị trả về

hasFailedTests

public boolean hasFailedTests ()

Trả về kết quả nếu lệnh gọi có bất kỳ kiểm thử nào không thành công hoặc giả định không thành công.

Giá trị trả về
`boolean`

hasTestRunKết quảForName

public boolean hasTestRunResultsForName (String testRunName)

Trả về kết quả cho biết một tên chạy kiểm thử nhất định có kết quả hay không.

Tham số
`testRunName`	`String`: Tên do {`testRunStarted(String, int)` đặt.

Giá trị trả về
`boolean`

invocationEnded

public void invocationEnded (long elapsedTime)

Báo cáo rằng lệnh gọi đã kết thúc, cho dù thành công hay do một số điều kiện lỗi.

Sẽ được khung TradeFederation tự động gọi.

Tham số
`elapsedTime`	`long`: thời gian đã trôi qua của lệnh gọi tính bằng mili giây

invocationFailed

public void invocationFailed (Throwable cause)

Báo cáo lệnh gọi không hoàn tất do một số điều kiện lỗi.

Sẽ được khung TradeFederation tự động gọi.

Tham số
`cause`	`Throwable`: nguyên nhân `Throwable` gây ra lỗi

invocationSkipped

public void invocationSkipped (SkipReason reason)

Báo cáo một lệnh gọi là đã bỏ qua

Tham số
`reason`	`SkipReason`

đã gọi

public void invocationStarted (IInvocationContext context)

Báo cáo thời điểm bắt đầu lệnh gọi kiểm thử.

Sẽ được khung TradeFederation tự động gọi. Trình báo cáo cần ghi đè phương thức này để hỗ trợ báo cáo nhiều thiết bị.

Tham số
`context`	`IInvocationContext`: thông tin về lệnh gọi

Đã tắt

public boolean isDisabled ()

Trả về True nếu toàn bộ đối tượng bị tắt (bỏ qua cả quá trình thiết lập và gỡ bỏ). Nếu không thì là False.

Giá trị trả về
`boolean`

logAssociation

public void logAssociation (String dataName, 
                LogFile logFile)

Trong một số trường hợp, nhật ký phải được liên kết chặt chẽ với một trường hợp kiểm thử, nhưng không thể thực hiện việc này trên lệnh gọi lại testLogSaved(String, com.android.tradefed.result.LogDataType, com.android.tradefed.result.InputStreamSource, com.android.tradefed.result.LogFile) trực tiếp. Do đó, lệnh gọi lại này cho phép cung cấp một mối liên kết mạnh mẽ một cách rõ ràng.

Tham số
`dataName`	`String`: Tên của dữ liệu
`logFile`	`LogFile`: `LogFile` đã được ghi lại trước đó và phải được liên kết với trường hợp kiểm thử.

setBuildInfo

public void setBuildInfo (IBuildInfo buildInfo)

Phương thức này không còn được dùng nữa.
Không cần thiết cho việc kiểm thử nữa.

Thiết lập thông tin bản dựng. Chỉ nên dùng cho mục đích kiểm thử.

Tham số
`buildInfo`	`IBuildInfo`

setDisable

public void setDisable (boolean isDisabled)

Thiết lập xem có nên tắt đối tượng hay không. Tắt có nghĩa là bạn sẽ bỏ qua cả bước thiết lập và gỡ bỏ. Có thể dùng để tắt một đối tượng theo mặc định trong hàm khởi tạo mặc định.

Tham số
`isDisabled`	`boolean`: trạng thái mà đối tượng sẽ được đặt vào.

setMergeStrategy

public void setMergeStrategy (MergeStrategy strategy)

Đặt MergeStrategy để sử dụng khi hợp nhất các kết quả.

Tham số
`strategy`	`MergeStrategy`

testAssumptionFailure

public void testAssumptionFailure (TestDescription test, 
                String trace)

Được gọi khi một kiểm thử nguyên tử gắn cờ giả định một điều kiện là sai

Tham số
`test`	`TestDescription`: xác định kiểm thử
`trace`	`String`: dấu vết ngăn xếp của lỗi

testAssumptionFailure

public void testAssumptionFailure (TestDescription test, 
                FailureDescription failure)

Được gọi khi một kiểm thử nguyên tử gắn cờ giả định một điều kiện là sai

Tham số
`test`	`TestDescription`: xác định kiểm thử
`failure`	`FailureDescription`: `FailureDescription` mô tả lỗi và ngữ cảnh của lỗi đó.

thử nghiệm đã kết thúc

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

Thay thế ERROR(/#testEnded(com.android.tradefed.result.TestDescription,Map)), trong đó chúng ta có thể chỉ định thời gian kết thúc trực tiếp. Kết hợp với testStarted(com.android.tradefed.result.TestDescription, long) để đo lường chính xác.

Tham số
`test`	`TestDescription`: xác định kiểm thử
`endTime`	`long`: thời gian thử nghiệm kết thúc, được đo bằng `System.currentTimeMillis()`
`testMetrics`	: `ERROR(/Map)` của các chỉ số được phát ra

testEnded

public void testEnded (TestDescription test, 
                 testMetrics)

Báo cáo việc kết thúc thực thi của một trường hợp kiểm thử riêng lẻ.

Nếu testFailed(TestDescription, FailureDescription) không được gọi, thì kiểm thử này đã vượt qua. Ngoài ra, hàm này còn trả về mọi chỉ số khoá/giá trị có thể đã được phát ra trong quá trình thực thi trường hợp kiểm thử.

Tham số
`test`	`TestDescription`: xác định kiểm thử
`testMetrics`	: `ERROR(/Map)` trong số các chỉ số được đưa ra

testFailed

public void testFailed (TestDescription test, 
                FailureDescription failure)

Báo cáo lỗi của một trường hợp kiểm thử riêng lẻ.

Sẽ được gọi giữa testStarted và testEnded.

Tham số
`test`	`TestDescription`: xác định kiểm thử
`failure`	`FailureDescription`: `FailureDescription` mô tả lỗi và ngữ cảnh của lỗi đó.

thử nghiệm không thành công

public void testFailed (TestDescription test, 
                String trace)

Báo cáo lỗi của một trường hợp kiểm thử riêng lẻ.

Sẽ được gọi giữa testStarted và testEnded.

Tham số
`test`	`TestDescription`: xác định kiểm thử
`trace`	`String`: dấu vết ngăn xếp của lỗi

testIgnored

public void testIgnored (TestDescription test)

Được gọi khi một chương trình kiểm thử sẽ không chạy, thường là do một phương thức kiểm thử được chú thích bằng org.junit.Ignore.

Tham số
`test`	`TestDescription`: xác định kiểm thử

testModuleEnded

public void testModuleEnded ()

Báo cáo khi kết thúc chạy mô-đun.

testModuleStarted

public void testModuleStarted (IInvocationContext moduleContext)

Báo cáo việc bắt đầu một mô-đun đang chạy. Lệnh gọi lại này được liên kết với testModuleEnded() và không bắt buộc trong trình tự. Tệp này chỉ được dùng trong quá trình chạy sử dụng các mô-đun: trình chạy dựa trên bộ.

Tham số
`moduleContext`	`IInvocationContext`: `IInvocationContext` của mô-đun.

testRunEnded

public void testRunEnded (long elapsedTime, 
                 runMetrics)

Báo cáo kết thúc lần chạy thử nghiệm.

Tham số
`elapsedTime`	`long`: thời gian đã trôi qua do thiết bị báo cáo, tính bằng mili giây
`runMetrics`	: các cặp khoá-giá trị được báo cáo ở cuối một lần chạy kiểm thử

testRunFailed

public void testRunFailed (FailureDescription failure)

Không thể hoàn tất quá trình chạy kiểm thử báo cáo do lỗi do FailureDescription mô tả.

Tham số
`failure`	`FailureDescription`: `FailureDescription` mô tả lỗi và ngữ cảnh của lỗi đó.

testRunFailed

public void testRunFailed (String errorMessage)

Không thể hoàn tất quá trình chạy kiểm thử báo cáo do lỗi nghiêm trọng.

Tham số
`errorMessage`	`String`: `String` mô tả lý do không chạy được.

testRunStarted

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

Báo cáo thời điểm bắt đầu chạy kiểm thử.

Tham số
`name`	`String`: tên lần chạy kiểm thử
`numTests`	`int`: tổng số kiểm thử trong lần chạy kiểm thử
`attemptNumber`	`int`: số thứ tự, xác định các lần thử khác nhau của cùng một runName chạy nhiều lần. attemptNumber được lập chỉ mục từ 0 và phải tăng lên mỗi khi một lần chạy mới diễn ra. Ví dụ: Một kiểm thử được thử lại chi tiết 3 lần, thì tổng số lần chạy sẽ là 4 lần trong cùng một runName và attemptNumber sẽ từ 0 đến 3.

testRunStarted

public void testRunStarted (String name, 
                int numTests)

Báo cáo thời điểm bắt đầu chạy kiểm thử.

Tham số
`name`	`String`: tên lần chạy kiểm thử
`numTests`	`int`: tổng số bài kiểm thử trong lần chạy kiểm thử

Đã bắt đầu kiểm thử

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

Báo cáo thời điểm bắt đầu chạy kiểm thử.

Tham số
`name`	`String`: tên lần chạy kiểm thử
`numTests`	`int`: tổng số kiểm thử trong lần chạy kiểm thử
`attemptNumber`	`int`: số thứ tự, xác định các lần thử khác nhau của cùng một runName chạy nhiều lần. attemptNumber được lập chỉ mục từ 0 và phải tăng lên mỗi khi một lần chạy mới diễn ra. Ví dụ: Một kiểm thử được thử lại chi tiết 3 lần, thì tổng số lần chạy sẽ là 4 lần trong cùng một runName và attemptNumber sẽ từ 0 đến 3.
`startTime`	`long`: thời gian bắt đầu chạy, được đo lường thông qua `System.currentTimeMillis()`

testRunStopped

public void testRunStopped (long elapsedTime)

Quá trình chạy kiểm thử báo cáo đã dừng trước khi hoàn tất do yêu cầu của người dùng.

TODO: currently unused, consider removing

Tham số
`elapsedTime`	`long`: thời gian đã trôi qua do thiết bị báo cáo, tính bằng mili giây

testSkipped

public void testSkipped (TestDescription test, 
                SkipReason reason)

Được gọi khi một kiểm thử bị bỏ qua và không thực thi vì một lý do không thường xảy ra. Các kiểm thử này sẽ được thử lại để cố gắng thực thi đúng cách.

Tham số
`test`	`TestDescription`: xác định kiểm thử
`reason`	`SkipReason`: `SkipReason`

testStarted

public void testStarted (TestDescription test, 
                long startTime)

Thay thế cho testStarted(com.android.tradefed.result.TestDescription), trong đó chúng ta cũng chỉ định thời điểm bắt đầu kiểm thử, kết hợp với ERROR(/#testEnded(com.android.tradefed.result.TestDescription,long,Map)) để đo lường chính xác.

Tham số
`test`	`TestDescription`: xác định kiểm thử
`startTime`	`long`: thời gian bắt đầu kiểm thử, được đo lường thông qua `System.currentTimeMillis()`

testStarted

public void testStarted (TestDescription test)

Báo cáo việc bắt đầu một trường hợp kiểm thử riêng lẻ. Giao diện cũ, nên sử dụng testStarted(com.android.tradefed.result.TestDescription) bất cứ khi nào có thể.

Tham số
`test`	`TestDescription`: xác định kiểm thử

Phương thức được bảo vệ

clearModuleLogFiles

protected final void clearModuleLogFiles ()

Cho phép dọn dẹp tệp mô-đun để tránh mang theo quá lâu.

clearResultsForName

protected final void clearResultsForName (String testRunName)

Cho phép xoá kết quả cho một tên chạy nhất định. Chỉ nên sử dụng trong một số trường hợp như tổng hợp kết quả.

Tham số
`testRunName`	`String`

setIsAggregrateMetrics

protected void setIsAggregrateMetrics (boolean aggregate)

Bật/tắt tuỳ chọn "chỉ số tổng hợp"

Tham số
`aggregate`	`boolean`