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.

Bộ sưu tập số liệu thiết bị cơ bản

public class BaseDeviceMetricCollector
extends Object implements IDeviceActionReceiver, IMetricCollector

java.lang.Object
↳	com.android.tradefed.device.metric.BaseDeviceMetricCollector

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

AtraceCollector, BugreportzOnFailureCollector, BugreportzOnTestCaseFailureCollector, ClangCodeCoverageCollector, CountTestCasesCollector, DebugHostLogOnFailureCollector, DeviceTraceCollector, FilePullerDeviceMetricCollector, GcovCodeCoverageCollector, GcovKernelCodeCoverageCollector, HostStatsdMetricCollector, JavaCodeCoverageCollector, LogcatOnFailureCollector, LogcatTimingMetricCollector, RebootReasonCollector, RuntimeRestartCollector, ScreenshotOnFailureCollector

Atracethuor	`IMetricCollector` chạy atrace trong quá trình kiểm thử, thu thập kết quả và ghi lại các kết quả đó vào lệnh gọi.
BugreportzOnFailureCollector	Thu thập bugreportz khi một trường hợp kiểm thử không thành công.
BugreportzOnTestCaseFailureCollector	Thu thập báo cáo lỗi khi một trường hợp kiểm thử trong một lần chạy không thành công.
ClangCodeCoverageCollector	`BaseDeviceMetricCollector` sẽ lấy các phép đo mức độ sử dụng Clang trên thiết bị và ghi lại dưới dạng cấu phần phần mềm kiểm thử.
CountTestCasesCollector	Đếm và báo cáo số lượng trường hợp kiểm thử cho một `IRemoteTest` nhất định.
DebugHostLogOnFailureCollector	Bộ thu thập sẽ thu thập và ghi nhật ký phía máy chủ khi xảy ra lỗi kiểm thử.
DeviceTraceCollector	Bộ thu thập sẽ bắt đầu theo dõi perfetto khi một lần chạy kiểm thử bắt đầu và ghi nhật ký tệp theo dõi ở cuối.
FilePullerDeviceMetricCollector	`BaseDeviceMetricCollector` theo dõi khoá chỉ số đến từ thiết bị và lấy khoá đó dưới dạng tệp từ thiết bị.
GcovCodeCoverageCollectionor	`BaseDeviceMetricCollector` sẽ lấy các phép đo mức độ sử dụng gcov từ thiết bị và ghi lại dưới dạng cấu phần phần mềm kiểm thử.
GcovKernelCodeCoverageCollector	`BaseDeviceMetricCollector` sẽ lấy các phép đo phạm vi sử dụng hạt nhân gcov từ debugfs và ngoài thiết bị, sau đó ghi lại các phép đo này dưới dạng cấu phần phần mềm kiểm thử.
HostStatsdMetricCollectionor	`IMetricCollector` thu thập các chỉ số statsd từ phía máy chủ bằng cách sử dụng các lệnh tiện ích statsd.
JavaCodeCoverageCollector	`BaseDeviceMetricCollector` sẽ lấy các phép đo phạm vi sử dụng Java từ thiết bị và ghi lại dưới dạng cấu phần phần mềm kiểm thử.
LogcatOnFailureCollector	Bộ thu thập sẽ ghi lại và ghi nhật ký logcat khi một trường hợp kiểm thử không thành công.
LogcatTimingMetricCollector	Bộ thu thập chỉ số thu thập thông tin về thời gian (ví dụ: thời gian chuyển đổi người dùng) từ logcat trong một hoặc nhiều lần kiểm thử lặp lại bằng cách sử dụng các mẫu regex nhất định để phân tích cú pháp tín hiệu bắt đầu và kết thúc của một sự kiện từ các dòng logcat.
RebootReasonCollector	Bộ thu thập dữ liệu thu thập quá trình khởi động lại thiết bị trong quá trình chạy kiểm thử và báo cáo các lần khởi động lại theo lý do và số lượng.
RuntimeRestartCollector	Bộ thu thập dữ liệu thu thập dấu thời gian của các lần khởi động lại thời gian chạy (sự cố máy chủ hệ thống) trong quá trình chạy kiểm thử, nếu có.
ScreenshotOnFailureCollector	Bộ thu thập sẽ chụp và ghi lại ảnh chụp màn hình khi một trường hợp kiểm thử không thành công.

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

AtraceRunMetricCollector, BluetoothConnectionLatencyCollector, BluetoothConnectionStateCollector, BluetoothHciSnoopLogCollector, FilePullerLogCollector, ModuleLogcatCollector, PerfettoPullerMetricCollector, ShowmapPullerMetricCollector, TraceCmdCollector

AtraceRunMetricCollector	Thu thập dấu vết từ tất cả thư mục kiểm thử trong thư mục đã cho từ thiết bị kiểm thử, ghi lại thư mục kiểm thử và xử lý sau các tệp theo dõi trong thư mục kiểm thử, đồng thời tổng hợp các chỉ số.
BluetoothConnectionLatencyCollector	Trình thu thập sẽ đẩy một cấu hình chỉ số thời lượng thống kê được xác định trước tới các thiết bị và thu thập thời lượng kết nối Bluetooth cho từng hồ sơ.
BluetoothConnectionStateCollector	Bộ thu thập này sẽ thu thập các chỉ số BluetoothConnectionStateChanged và ghi lại số trạng thái kết nối cho mỗi hồ sơ.
BluetoothHciSnoopLogCollector	Bộ thu thập để bật tính năng ghi nhật ký theo dõi HCI Bluetooth trên DUT và thu thập nhật ký cho mỗi lần kiểm thử.
FilePullerLogCollector	Trình ghi nhật ký của tệp do phía thiết bị báo cáo.
ModuleLogcatThu thập	Phiên bản của trình thu thập logcat nhưng dành cho mô-đun.
PerfettoPullerMetricCollector	Phương thức triển khai cơ sở của `FilePullerDeviceMetricCollector` cho phép lấy các tệp perfetto từ thiết bị và thu thập các chỉ số từ thiết bị đó.
ShowmapPullerMetricCollectionor	Cách triển khai cơ sở của `FilePullerDeviceMetricCollector` cho phép lấy các tệp sơ đồ chương trình từ thiết bị và thu thập các chỉ số từ thiết bị đó.
TraceCmdCollector	`IMetricCollector` thu thập dấu vết trong quá trình kiểm thử bằng trace-cmd và ghi lại các dấu vết đó vào lệnh gọi.

Cách triển khai cơ sở của IMetricCollector cho phép bắt đầu và dừng thu thập trên onTestRunStart(com.android.tradefed.device.metric.DeviceMetricData) và ERROR(/#onTestRunEnd(com.android.tradefed.device.metric.DeviceMetricData,Map)).

Tóm tắt

Trường
`public static final String`	`TEST_CASE_EXCLUDE_GROUP_OPTION`
`public static final String`	`TEST_CASE_INCLUDE_GROUP_OPTION`

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

Phương thức công khai
`void`	`extraInit(IInvocationContext context, ITestInvocationListener listener)`
`final`	`getBuildInfos()` Trả về danh sách thông tin bản dựng có sẵn trong lệnh gọi.
`final`	`getDevices()` Trả về danh sách thiết bị có sẵn trong lệnh gọi.
`File`	`getFileFromTestArtifacts(String fileName)` Truy xuất tệp qua cấu phần phần mềm kiểm thử hoặc cấu phần phần mềm mô-đun và lưu tệp đó vào bộ nhớ đệm trên bản đồ cho các lệnh gọi tiếp theo.
`final ITestInvocationListener`	`getInvocationListener()` Trả về `ITestInvocationListener` ban đầu mà chúng ta đang chuyển tiếp kết quả.
`String`	`getModuleName()`
`final`	`getRealDevices()` Trả về tất cả thiết bị không phải là thiết bị mô phỏng trong danh sách `getDevices()`.
`String`	`getRunName()` Trả về tên của lần chạy kiểm thử `mRunName` kích hoạt trình thu thập.
`final ITestInvocationListener`	`init(IInvocationContext context, ITestInvocationListener listener)` Khởi chạy trình thu thập dữ liệu bằng ngữ cảnh hiện tại và nơi chuyển tiếp kết quả.
`final void`	`invocationEnded(long elapsedTime)` Báo cáo rằng lệnh gọi đã kết thúc, dù thành công hay do một số điều kiện lỗi.
`final void`	`invocationFailed(FailureDescription failure)` 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.
`final 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
`final void`	`invocationStarted(IInvocationContext context)` Trình nghe lệnh gọi để chuyển tiếp
`final 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ỏ).
`boolean`	`isDisabledReceiver()` Liệu `IDeviceActionReceiver` có bị tắt hay không.
`final void`	`logAssociation(String dataName, LogFile logFile)` Không sử dụng trong quá trình triển khai trình thu thập chỉ số.
`void`	`onTestAssumptionFailure(DeviceMetricData testData, TestDescription test)` Lệnh gọi lại khi một trường hợp kiểm thử không thành công do giả định không thành công.
`void`	`onTestEnd(DeviceMetricData testData, currentTestCaseMetrics, TestDescription test)` Lệnh gọi lại khi một trường hợp kiểm thử kết thúc.
`void`	`onTestEnd(DeviceMetricData testData, currentTestCaseMetrics)` Lệnh gọi lại khi một trường hợp kiểm thử kết thúc.
`void`	`onTestFail(DeviceMetricData testData, TestDescription test)` Lệnh gọi lại khi một trường hợp kiểm thử không thành công.
`void`	`onTestModuleEnded()` Cho phép ghi lại sự kiện mô-đun đã kết thúc.
`void`	`onTestModuleStarted()` Cho phép ghi lại sự kiện đã bắt đầu mô-đun.
`void`	`onTestRunEnd(DeviceMetricData runData, currentRunMetrics)` Lệnh gọi lại khi chạy kiểm thử kết thúc.
`void`	`onTestRunFailed(DeviceMetricData testData, FailureDescription failure)` Lệnh gọi lại cho các sự kiện testRunFailed
`void`	`onTestRunStart(DeviceMetricData runData)` Lệnh gọi lại khi bắt đầu chạy kiểm thử.
`void`	`onTestStart(DeviceMetricData testData)` Lệnh gọi lại khi một trường hợp kiểm thử được bắt đầu.
`void`	`rebootEnded(ITestDevice device)` Nhận thông báo khi quá trình khởi động lại thiết bị kết thúc.
`void`	`rebootStarted(ITestDevice device)` Nhận thông báo khi quá trình khởi động lại bắt đầu trong thiết bị.
`final void`	`setDisable(boolean isDisabled)` Thiết lập xem có nên tắt đối tượng hay không.
`void`	`setDisableReceiver(boolean isDisabled)` Đặt xem có nên tắt `IDeviceActionReceiver` hay không.
`final void`	`setLogSaver(ILogSaver logSaver)` Không sử dụng nội dung triển khai trình thu thập chỉ số.
`final 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
`final 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
`final 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.
`final 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ẻ.
`final 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ẻ.
`final 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ẻ.
`final 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.
`final void`	`testLog(String dataName, LogDataType dataType, InputStreamSource dataStream)` Cung cấp nhật ký hoặc dữ liệu gỡ lỗi liên quan từ lệnh gọi kiểm thử.
`final void`	`testLogSaved(String dataName, LogDataType dataType, InputStreamSource dataStream, LogFile logFile)` Không sử dụng nội dung triển khai trình thu thập chỉ số.
`final void`	`testModuleEnded()` Báo cáo kết thúc quá trình chạy mô-đun.
`final void`	`testModuleStarted(IInvocationContext moduleContext)` Báo cáo thời điểm bắt đầu chạy một mô-đun.
`final void`	`testRunEnded(long elapsedTime, runMetrics)` Báo cáo kết thúc quá trình chạy kiểm thử.
`final 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ả.
`final 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.
`final void`	`testRunStarted(String runName, int testCount, int attemptNumber)` Báo cáo thời điểm bắt đầu chạy kiểm thử.
`final void`	`testRunStarted(String runName, int testCount)` Kiểm thử lệnh gọi lại khi chạy
`final void`	`testRunStarted(String runName, int testCount, int attemptNumber, long startTime)` Báo cáo thời điểm bắt đầu chạy kiểm thử.
`final 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.
`final 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.
`final 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.
`final void`	`testStarted(TestDescription test)` Lệnh gọi lại của trường hợp kiểm thử

Trường

TEST_CASE_EXCLUDE_GROUP_OPTION

public static final String TEST_CASE_EXCLUDE_GROUP_OPTION

TEST_CASE_INCLUDE_GROUP_OPTION

public static final String TEST_CASE_INCLUDE_GROUP_OPTION

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

BaseDeviceMetricCollector

public BaseDeviceMetricCollector ()

Phương thức công khai

extraInit

public void extraInit (IInvocationContext context, 
                ITestInvocationListener listener)

Gửi
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

getBuildInfos

public final  getBuildInfos ()

Trả về danh sách thông tin bản dựng có sẵn trong lệnh gọi.

Giá trị trả về

các thiết bị

public final  getDevices ()

Trả về danh sách thiết bị có sẵn trong lệnh gọi.

Giá trị trả về

getFileFromTestArtifacts

public File getFileFromTestArtifacts (String fileName)

Truy xuất tệp từ cấu phần phần mềm kiểm thử hoặc cấu phần phần mềm mô-đun và lưu vào bộ nhớ đệm trong một bản đồ cho các lệnh gọi tiếp theo.

Tham số
`fileName`	`String`: tên của tệp cần tra cứu trong cấu phần phần mềm.

Giá trị trả về
`File`	Tệp từ cấu phần phần mềm kiểm thử hoặc cấu phần phần mềm mô-đun. Trả về giá trị rỗng nếu không tìm thấy tệp.

getInvocationListener

public final ITestInvocationListener getInvocationListener ()

Trả về ITestInvocationListener ban đầu khi chúng ta chuyển tiếp kết quả.

Giá trị trả về
`ITestInvocationListener`

getModuleName

public String getModuleName ()

Giá trị trả về
`String`

getRealDevices

public final  getRealDevices ()

Trả về tất cả các thiết bị không phải mã giả lập từ danh sách getDevices().

Giá trị trả về

getRunName

public String getRunName ()

Trả về tên của lần chạy kiểm thử mRunName kích hoạt trình thu thập.

Giá trị trả về
`String`	mRunName, tên lần chạy kiểm thử hiện tại.

init

public final ITestInvocationListener init (IInvocationContext context, 
                ITestInvocationListener listener)

Khởi động trình thu thập với ngữ cảnh hiện tại và nơi chuyển tiếp kết quả. Sẽ chỉ được gọi một lần cho mỗi thực thể và trình thu thập dữ liệu dự kiến sẽ cập nhật ngữ cảnh và trình nghe nội bộ. Init sẽ không bao giờ được gọi trong lần chạy kiểm thử luôn trước đó.

Đừng ghi đè trừ phi bạn biết mình đang làm gì.

Tham số
`context`	`IInvocationContext`: `IInvocationContext` cho lệnh gọi đang diễn ra.
`listener`	`ITestInvocationListener`: `ITestInvocationListener` nơi đặt kết quả.

Giá trị trả về
`ITestInvocationListener`	trình nghe mới gói trình nghe ban đầu.

Gửi
`DeviceNotAvailableException`

gọi đã kết thúc

public final 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 final void invocationFailed (FailureDescription failure)

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.

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

Tham số
`failure`	`FailureDescription`: `FailureDescription` mô tả nguyên nhân lỗi

kích hoạt không thành công

public final 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.

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

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

Đã bỏ qua lệnh gọi

public void invocationSkipped (SkipReason reason)

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

Tham số
`reason`	`SkipReason`

invocationStarted

public final void invocationStarted (IInvocationContext context)

Trình nghe lời gọi để chuyển tiếp

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

Đã tắt

public final 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à chia nhỏ). Nếu không thì giá trị sẽ là false.

Giá trị trả về
`boolean`

isDisabledReceiver

public boolean isDisabledReceiver ()

Liệu IDeviceActionReceiver có bị tắt hay không.

Giá trị trả về
`boolean`	trả về true nếu bị tắt, nếu không sẽ trả về false.

logAssociation

public final void logAssociation (String dataName, 
                LogFile logFile)

Không sử dụng trong quá trình triển khai trình thu thập chỉ số. Đây là tính năng chuyển tiếp thuần tuý.

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

onTestAssumptionFailure

public void onTestAssumptionFailure (DeviceMetricData testData, 
                TestDescription test)

Lệnh gọi lại khi một trường hợp kiểm thử không thành công do giả định không thành công.

Tham số
`testData`	`DeviceMetricData`: `DeviceMetricData` lưu giữ dữ liệu cho trường hợp kiểm thử.
`test`	`TestDescription`: `TestDescription` của trường hợp kiểm thử đang diễn ra.

Gửi
`DeviceNotAvailableException`

Kết thúc kiểm tra

public void onTestEnd (DeviceMetricData testData, 
                 currentTestCaseMetrics, 
                TestDescription test)

Lệnh gọi lại khi một trường hợp kiểm thử kết thúc. Đây là lúc bạn cần dọn dẹp.

Tham số
`testData`	`DeviceMetricData`: `DeviceMetricData` lưu giữ dữ liệu cho trường hợp kiểm thử. Sẽ là đối tượng giống như trong `onTestStart(com.android.tradefed.device.metric.DeviceMetricData)`.
`currentTestCaseMetrics`	: bản đồ hiện tại của các chỉ số được truyền đến `ERROR(/#testEnded(com.android.tradefed.result.TestDescription,Map))`.
`test`	`TestDescription`: `TestDescription` của trường hợp kiểm thử đang diễn ra.

Gửi
`DeviceNotAvailableException`

Kết thúc kiểm tra

public void onTestEnd (DeviceMetricData testData, 
                 currentTestCaseMetrics)

Lệnh gọi lại khi một trường hợp kiểm thử kết thúc. Đây là lúc bạn cần dọn dẹp.

Tham số
`testData`	`DeviceMetricData`: `DeviceMetricData` lưu giữ dữ liệu cho trường hợp kiểm thử. Sẽ là đối tượng giống như trong `onTestStart(com.android.tradefed.device.metric.DeviceMetricData)`.
`currentTestCaseMetrics`	: bản đồ hiện tại của các chỉ số được truyền đến `ERROR(/#testEnded(com.android.tradefed.result.TestDescription,Map))`.

Gửi
`DeviceNotAvailableException`

onTestFail

public void onTestFail (DeviceMetricData testData, 
                TestDescription test)

Lệnh gọi lại khi một trường hợp kiểm thử không thành công.

Tham số
`testData`	`DeviceMetricData`: `DeviceMetricData` lưu giữ dữ liệu cho trường hợp kiểm thử.
`test`	`TestDescription`: `TestDescription` của trường hợp kiểm thử đang diễn ra.

Gửi
`DeviceNotAvailableException`

onTestModuleEnded

public void onTestModuleEnded ()

Cho phép ghi lại sự kiện kết thúc mô-đun.

Gửi
`DeviceNotAvailableException`

onTestModuleStarted

public void onTestModuleStarted ()

Cho phép ghi lại sự kiện đã bắt đầu mô-đun.

Gửi
`DeviceNotAvailableException`

onTestRunEnd

public void onTestRunEnd (DeviceMetricData runData, 
                 currentRunMetrics)

Lệnh gọi lại khi một lần chạy kiểm thử kết thúc. Đây là lúc dọn dẹp.

Tham số
`runData`	`DeviceMetricData`: `DeviceMetricData` chứa dữ liệu để chạy. Sẽ là đối tượng giống như trong `onTestRunStart(com.android.tradefed.device.metric.DeviceMetricData)`.
`currentRunMetrics`	: bản đồ hiện tại của các chỉ số được truyền đến `ERROR(/#testRunEnded(long,Map))`.

Gửi
`DeviceNotAvailableException`

onTestRunFailed – Không thành công

public void onTestRunFailed (DeviceMetricData testData, 
                FailureDescription failure)

Lệnh gọi lại cho các sự kiện testRunFailed

Gửi
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

onTestRunStart

public void onTestRunStart (DeviceMetricData runData)

Lệnh gọi lại khi bắt đầu chạy kiểm thử.

Tham số
`runData`	`DeviceMetricData`: `DeviceMetricData` lưu giữ dữ liệu cho lần chạy.

Gửi
`DeviceNotAvailableException`

onTestStart

public void onTestStart (DeviceMetricData testData)

Lệnh gọi lại khi một trường hợp kiểm thử bắt đầu.

Tham số
`testData`	`DeviceMetricData`: `DeviceMetricData` lưu giữ dữ liệu cho trường hợp kiểm thử.

Gửi
`DeviceNotAvailableException`

rebootEnded

public void rebootEnded (ITestDevice device)

Nhận thông báo khi quá trình khởi động lại thiết bị kết thúc.

LƯU Ý: Bộ thu nên tránh khởi động lại trong lệnh gọi lại này. Mọi nỗ lực khởi động lại đều sẽ bị bỏ qua.

Tham số
`device`	`ITestDevice`: `ITestDevice` nơi quá trình khởi động lại kết thúc.

Gửi
`DeviceNotAvailableException`

đã khởi động lại

public void rebootStarted (ITestDevice device)

Nhận thông báo khi quá trình khởi động lại bắt đầu trong thiết bị.

LƯU Ý: Bộ thu nên tránh khởi động lại trong lệnh gọi lại này. Mọi lần khởi động lại sẽ bị bỏ qua.

Tham số
`device`	`ITestDevice`: `ITestDevice` nơi quá trình khởi động lại bắt đầu.

Gửi
`DeviceNotAvailableException`

setDisable

public final void setDisable (boolean isDisabled)

Đặt xem có tắt đối tượng hay không. Tắt có nghĩa là cả bước thiết lập và bước chia nhỏ sẽ được bỏ qua. 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.

setDisableReceiver

public void setDisableReceiver (boolean isDisabled)

Đặt xem có tắt IDeviceActionReceiver hay không. Việc tắt nghĩa là thiết bị sẽ không được đăng ký để nhận các sự kiện hành động của thiết bị.

Tham số
`isDisabled`	`boolean`

setLogSaver

public final void setLogSaver (ILogSaver logSaver)

Không sử dụng trong quá trình triển khai trình thu thập chỉ số. Đây là tính năng chuyển tiếp thuần tuý.

Tham số
`logSaver`	`ILogSaver`: `ILogSaver`

testAssumptionFailure

public final 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 final 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 final 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 final 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 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)` của các chỉ số được phát ra

testFailed

public final 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 final 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 final 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 final void testLog (String dataName, 
                LogDataType dataType, 
                InputStreamSource dataStream)

Cung cấp nhật ký hoặc dữ liệu gỡ lỗi liên quan từ lệnh gọi kiểm thử.

Phải được gọi trước ERROR(/ITestInvocationListener#invocationFailed(Throwable)) hoặc ERROR(/ITestInvocationListener#invocationEnded(long))

Khung TradeFederation sẽ tự động gọi phương thức này, cung cấp nhật ký máy chủ và nếu có, logcat của thiết bị.

Tham số
`dataName`	`String`: tên mô tả `String` của dữ liệu. Ví dụ: "device_logcat". Lưu ý: dataName có thể không phải là duy nhất cho mỗi lệnh gọi. Tức là trình triển khai phải có khả năng xử lý nhiều lệnh gọi có cùng dataName
`dataType`	`LogDataType`: `LogDataType` của dữ liệu
`dataStream`	`InputStreamSource`: `InputStreamSource` của dữ liệu. Người triển khai nên gọi createInputStream để bắt đầu đọc dữ liệu và đảm bảo đóng InputStream thu được khi hoàn tất. Phương thức gọi phải đảm bảo nguồn dữ liệu vẫn hiện diện và có thể truy cập được cho đến khi phương thức testLog hoàn tất.

testLogSaved

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

Không sử dụng trong quá trình triển khai trình thu thập chỉ số. Đây là tính năng chuyển tiếp thuần tuý.

Tham số
`dataName`	`String`: tên mô tả `String` của dữ liệu. Ví dụ: "device_logcat". Lưu ý: dataName có thể không phải là duy nhất cho mỗi lệnh gọi. Tức là trình triển khai phải có khả năng xử lý nhiều lệnh gọi có cùng dataName
`dataType`	`LogDataType`: `LogDataType` của dữ liệu
`dataStream`	`InputStreamSource`: `InputStreamSource` của dữ liệu. Trình triển khai nên gọi createInputStream để bắt đầu đọc dữ liệu và đảm bảo đóng InputStream thu được khi hoàn tất.
`logFile`	`LogFile`: `LogFile` chứa siêu dữ liệu của tệp đã lưu.

testModuleEnded

public final void testModuleEnded ()

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

testModuleStarted

public final void testModuleStarted (IInvocationContext moduleContext)

Báo cáo thời điểm bắt đầu chạy một mô-đun. 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 final void testRunEnded (long elapsedTime, 
                 runMetrics)

Báo cáo kết thúc quá trình chạy kiểm thử.

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

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

public final void testRunStarted (String runName, 
                int testCount, 
                int attemptNumber)

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

Tham số
`runName`	`String`: tên lần chạy kiểm thử
`testCount`	`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.

testRunStarted

public final void testRunStarted (String runName, 
                int testCount)

Kiểm thử lệnh gọi lại khi chạy

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

testRunStarted

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

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

Tham số
`runName`	`String`: tên lần chạy kiểm thử
`testCount`	`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 lường thông qua `System.currentTimeMillis()`

testRunStopped

public final void testRunStopped (long elapsedTime)

Đã dừng chạy thử nghiệm báo cáo trước khi hoàn tất do có 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 final 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. Hệ thống sẽ thử lại các lượt kiểm thử này để có được lượt thực thi phù hợp.

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

testStarted

public final 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()`

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

public final void testStarted (TestDescription test)

Lệnh gọi lại trường hợp kiểm thử

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