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.

ModuleListener

public class ModuleListener
extends CollectingTestListener

java.lang.Object
↳	com.android.tradefed.result.CollectingTestListener
	↳	com.android.tradefed.testtype.suite.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ả.

Tóm tắt

Hàm khởi tạo công khai
`ModuleListener(ITestInvocationListener listener, IInvocationContext moduleContext)` Hàm khởi tạo.

Phương thức công khai
`boolean`	`hasLastAttemptFailed()` Trả về kết quả phiên thử lại gần đây nhất của trình nghe có thành công hay không.
`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 bạn không thể thực hiện điều này trong 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`	`setAttemptIsolation(CurrentInvocation.IsolationGrade isolation)` Đặt xem có nên báo cáo lượt truy cập đó là riêng biệt hay không.
`void`	`setCollectTestsOnly(boolean collectTestsOnly)` Đặt xem chúng ta có chỉ thu thập các bài kiểm thử hay không.
`void`	`setMarkTestsSkipped(boolean skip)` Có đánh dấu tất cả các trường hợp kiểm thử đã bỏ qua hay không.
`void`	`setTestMappingSources( testMappingSources)` Đặt các nguồn ánh xạ kiểm thử sẽ được chèn vào chỉ số.
`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ế `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.
`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`	`testLog(String dataName, LogDataType dataType, InputStreamSource dataStream)`
`void`	`testLogSaved(String dataName, LogDataType dataType, InputStreamSource dataStream, LogFile logFile)`
`void`	`testRunEnded(long elapsedTime, runMetrics)` Báo cáo kết thúc lần chạy thử nghiệm.
`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, int attemptNumber, long startTime)` Báo cáo thời điểm bắt đầu chạy kiểm thử.
`void`	`testSkipped(TestDescription test, SkipReason reason)` Được gọi khi một chương trình kiểm thử bị bỏ qua và không thực thi vì một lý do thường không như mong đợi.
`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.

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

ModuleListener

public ModuleListener (ITestInvocationListener listener, 
                IInvocationContext moduleContext)

Hàm khởi tạo.

Tham số
`listener`	`ITestInvocationListener`
`moduleContext`	`IInvocationContext`

Phương thức công khai

hasLastAttemptFailed

public boolean hasLastAttemptFailed ()

Trả về kết quả phiên thử lại gần đây nhất của trình nghe có thành công hay không.

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ử.

thiết lập chính sách cách ly

public void setAttemptIsolation (CurrentInvocation.IsolationGrade isolation)

Đặt xem liệu lượt thử có được báo cáo là riêng biệt hay không.

Tham số
`isolation`	`CurrentInvocation.IsolationGrade`

setCollectTestsOnly

public void setCollectTestsOnly (boolean collectTestsOnly)

Đặt xem chúng ta có chỉ thu thập các bài kiểm thử hay không.

Tham số
`collectTestsOnly`	`boolean`

setMarkTestsSkipped

public void setMarkTestsSkipped (boolean skip)

Liệu có đánh dấu tất cả các trường hợp kiểm thử là đã bỏ qua hay không.

Tham số
`skip`	`boolean`

setTestMappingSources

public void setTestMappingSources ( testMappingSources)

Đặt các nguồn liên kết kiểm thử sẽ được chèn vào các chỉ số.

Tham số
`testMappingSources`

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.

testEnded

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 kết thúc quá trình thực thi của một trường hợp kiểm thử riêng lẻ.

Nếu bạn không gọi testFailed(TestDescription, FailureDescription), thì kiểm thử này đã thành công. 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)` của các chỉ số được phát 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 đó.

testFailed

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ử

testLog

public void testLog (String dataName, 
                LogDataType dataType, 
                InputStreamSource dataStream)

Tham số
`dataName`	`String`
`dataType`	`LogDataType`
`dataStream`	`InputStreamSource`

testLogSaved

public void testLogSaved (String dataName, 
                LogDataType dataType, 
                InputStreamSource dataStream, 
                LogFile logFile)

Tham số
`dataName`	`String`
`dataType`	`LogDataType`
`dataStream`	`InputStreamSource`
`logFile`	`LogFile`

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 vào cuối lần chạy kiểm thử

testRunFailed

public void testRunFailed (FailureDescription failure)

Không hoàn tất được quá trình chạy thử nghiệm báo cáo do lỗi theo mô tả trong FailureDescription.

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 hoàn tất được quá trình chạy thử nghiệm báo cáo do xảy ra 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ố bài 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. Số tryNumber được lập chỉ mục là 0 và sẽ tăng lên mỗi khi một lần chạy mới xảy ra. Ví dụ: một kiểm thử được thử lại ở cấp độ chi tiết 3 lần, phải có tổng 4 lần chạy trong cùng một runName và tryNumber là từ 0 đến 3.

testRunStarted

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ố bài 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 bằng `System.currentTimeMillis()`

testSkipped

public void testSkipped (TestDescription test, 
                SkipReason reason)

Được gọi khi một chương trình kiểm thử bị bỏ qua và không thực thi vì một lý do thường không như mong đợi. 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`

đã bắt đầu thử nghiệm

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 bằng `System.currentTimeMillis()`