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.

BaseDeviceMetricCollectionor

public class BaseDeviceMetricCollector
extends Object implements IDeviceActionReceiver, IMetricCollector

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

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

AtraceThu thập	`IMetricCollector` chạy dấu vết trong quá trình kiểm thử, đồng thời thu thập kết quả và ghi nhật ký chúng vào lệnh gọi.
BugreportzOnFailureCollector	Thu thập báo cáo lỗi khi 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	Một `BaseDeviceMetricCollector` sẽ kéo Clang các phép đo mức độ sử dụng thiết bị rồi ghi lại các phép đo đó 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	Trình thu thập sẽ thu thập và ghi nhật ký phía máy chủ khi xảy ra lỗi trường hợp kiểm thử.
DeviceTraceCollectionor	Trình thu thập sẽ bắt đầu theo dõi perfetto khi bắt đầu chạy kiểm thử và ghi tệp theo dõi ở cuối.
FilePullerDeviceMetricCollectionor	`BaseDeviceMetricCollector` theo dõi khoá chỉ số từ thiết bị và lấy chúng dưới dạng tệp từ thiết bị.
GcovCodeCoverageCollector	`BaseDeviceMetricCollector` sẽ kéo gcov các phép đo mức độ sử dụng thiết bị rồi ghi lại các phép đo đó dưới dạng cấu phần phần mềm kiểm thử.
GcovKernelCodeCoverageCollector	`BaseDeviceMetricCollector` sẽ lấy nhân hệ điều hành gcov các phép đo mức độ sử dụng ra khỏi debugfs và tắt thiết bị, sau đó ghi lại chúng dưới dạng kiểm thử cấu phần phần mềm.
HostStatsdMetricCollectionor	`IMetricCollector` thu thập các chỉ số đã thống kê từ phía máy chủ bằng phần mềm tiện ích có thống kê .
JavaCodeCoverageCollectionor	`BaseDeviceMetricCollector` sẽ kéo Java các phép đo mức độ sử dụng thiết bị rồi ghi lại các phép đo đó dưới dạng cấu phần phần mềm kiểm thử.
LogcatOnSuccessCollectionor	Trình thu thập sẽ thu thập và ghi nhật ký logcat khi trường hợp kiểm thử không thành công.
LogcatTimingMetricCollectionor	Một trình thu thập chỉ số thu thập thông tin thời gian (ví dụ: thời gian chuyển đổi người dùng) từ logcat trong quá trình một hoặc nhiều lần kiểm tra lặp lại bằng cách sử dụng các mẫu biểu thức chính quy nhất định để phân tích cú pháp tín hiệu bắt đầu và kết thúc của sự kiện từ các dòng logcat.
Khởi động lại lý do tập hợp	Trình thu thập thu thập dữ liệu về lần khởi động lại thiết bị trong quá trình chạy kiểm thử và báo cáo theo lý do và số lượng.
RuntimeRestartCollectionor	Trình thu thập thu thập dấu thời gian khởi động lại thời gian chạy (sự cố máy chủ hệ thống) trong quá trình kiểm thử chạy, nếu có.
Chụp ảnh màn hìnhOnFailure Collector	Trình thu thập sẽ chụp và ghi nhật ký ả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

AtraceRunMetricCollectionor, BluetoothConnectionLatencyCollector, BluetoothConnectionStateCollector, BluetoothHciSnoopLogReceiveor, FilePullerLogCollector, ModuleLogcatLogcat Collector, PerfettoPullerMetricCollector, ShowmapPullerMetricThuor,

AtraceRunMetricCollectionor	Thu thập dấu vết từ tất cả các thư mục kiểm thử trong thư mục cho sẵn từ thiết bị kiểm thử, ghi nhật ký thư mục kiểm thử và xử lý đăng các tệp theo dõi trong thư mục kiểm thử và tổng hợp các chỉ số.
BluetoothConnectionLatencyCollector	Trình thu thập sẽ đẩy cấu hình chỉ số thời lượng của số liệu thống kê được xác định trước đến các thiết bị và thu thập Thời lượng kết nối Bluetooth cho từng hồ sơ.
BluetoothConnectionStateCollector	Trình thu thập này sẽ thu thập các chỉ số BluetoothConnectionStateChanged và ghi lại trạng thái kết nối của mỗi hồ sơ.
BluetoothHciSnoopLogCollector	Bộ thu thập để bật tính năng ghi nhật ký snoop Bluetooth HCI trên DUT và để thu thập nhật ký cho mỗi lần kiểm tra.
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.
PerfettoPullerMetricCollectionor	Cách 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	Phương thức triển khai cơ sở của `FilePullerDeviceMetricCollector` cho phép kéo sơ đồ chương trình khỏi thiết bị rồi 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ời 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ó trong lệnh gọi.
`final`	`getDevices()` Trả về danh sách thiết bị có 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 của mô-đun và bộ nhớ đệm nó vào bản đồ cho các lệnh gọi tiếp theo.
`final ITestInvocationListener`	`getInvocationListener()` Trả về `ITestInvocationListener` ban đầu khi chúng ta chuyển tiếp kết quả.
`String`	`getModuleName()`
`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()`.
`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 độ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ả.
`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ố lỗi .
`final void`	`invocationFailed(FailureDescription failure)` Báo cáo lệnh gọi không hoàn tất do một số điều kiện lỗi.
`final 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.
`void`	`invocationSkipped(SkipReason reason)` Báo cáo lệnh gọi là bị bỏ qua
`final void`	`invocationStarted(IInvocationContext context)` Trình nghe lời 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à chia nhỏ).
`boolean`	`isDisabledReceiver()` Liệu `IDeviceActionReceiver` có tắt hay không.
`final void`	`logAssociation(String dataName, LogFile logFile)` Không sử dụng nội dung triển khai trình thu thập chỉ số.
`void`	`onTestAssumptionFailure(DeviceMetricData testData, TestDescription test)` Gọi lại khi một trường hợp kiểm thử không thành công do lỗi giả định.
`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 đã kết thúc mô-đun.
`void`	`onTestModuleStarted()` Cho phép chụp 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 kết thúc trên thiết bị.
`void`	`rebootStarted(ITestDevice device)` Nhận thông báo khi khởi động lại thiết bị.
`final void`	`setDisable(boolean isDisabled)` Đặt xem có tắt đối tượng hay không.
`void`	`setDisableReceiver(boolean isDisabled)` Đặt xem có 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 phép kiểm thử nguyên tử gắn cờ cho một điều kiện là false
`final void`	`testAssumptionFailure(TestDescription test, FailureDescription failure)` Được gọi khi một phép kiểm thử nguyên tử gắn cờ cho một điều kiện là false
`final void`	`testEnded(TestDescription test, long endTime, testMetrics)` Thay thế cho `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 bài kiểm thử không được chạy, thường là vì 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 khi kết thúc chạy mô-đun.
`final void`	`testModuleStarted(IInvocationContext moduleContext)` Báo cáo việc bắt đầu một mô-đun đang chạy.
`final void`	`testRunEnded(long elapsedTime, runMetrics)` Báo cáo kết thúc lần chạy thử nghiệm.
`final 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`.
`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.
`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ử chạy lệnh gọi lại
`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)` Đã 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.
`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.
`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 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 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

BaseDeviceMetricCollectionor

public BaseDeviceMetricCollector ()

Phương thức công khai

phần mở rộng

public void extraInit (IInvocationContext context, 
                ITestInvocationListener listener)

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

getBuildInfo

public final  getBuildInfos ()

Trả về danh sách thông tin bản dựng có 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ó trong lệnh gọi.

Giá trị trả về

getFileFromTestArtifacts

public 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 của mô-đun và bộ nhớ đệm nó vào 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.

khởi tạo

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ả. Ý chí chỉ được gọi một lần cho mỗi thực thể và trình thu thập dự kiến sẽ cập nhật ngữ cảnh và trình nghe. Init sẽ không bao giờ được gọi trong lần chạy kiểm thử luôn trước đó.

Khô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, dù thành công hay do một số 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

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

public final void invocationFailed (FailureDescription failure)

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ố
`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 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`: `Throwable` nguyên nhân gây ra lỗi

Đã bỏ qua lệnh gọi

public void invocationSkipped (SkipReason reason)

Báo cáo lệnh gọi là bị bỏ qua

Tham số
`reason`	`SkipReason`

đã kích hoạt

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ì là False.

Giá trị trả về
`boolean`

isDisabledReceiver

public boolean isDisabledReceiver ()

Liệu IDeviceActionReceiver có 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 nội dung triển khai trình thu thập chỉ số. Đây chỉ là chuyển tiếp.

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

onTestAssumptionFailed (Không thành công kiểm thử)

public void onTestAssumptionFailure (DeviceMetricData testData, 
                TestDescription test)

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

Tham số
`testData`	`DeviceMetricData`: `DeviceMetricData` chứa 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` chứa dữ liệu cho trường hợp kiểm thử. Sẽ là cùng một đối tượng như trong `onTestStart(com.android.tradefed.device.metric.DeviceMetricData)`.
`currentTestCaseMetrics`	: sơ đồ chỉ số hiện tại được chuyể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` chứa dữ liệu cho trường hợp kiểm thử. Sẽ là cùng một đối tượng như trong `onTestStart(com.android.tradefed.device.metric.DeviceMetricData)`.
`currentTestCaseMetrics`	: sơ đồ chỉ số hiện tại được chuyể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` chứa 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`

onTestModule Đã kết thúc

public void onTestModuleEnded ()

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

Gửi
`DeviceNotAvailableException`

onTestModuleĐã bắt đầu

public void onTestModuleStarted ()

Cho phép chụp sự kiện đã bắt đầu mô-đun.

Gửi
`DeviceNotAvailableException`

Kết thúc chạy kiểm thử

public void onTestRunEnd (DeviceMetricData runData, 
                 currentRunMetrics)

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

Tham số
`runData`	`DeviceMetricData`: `DeviceMetricData` chứa dữ liệu để chạy. Vẫn sẽ giữ nguyên như trong `onTestRunStart(com.android.tradefed.device.metric.DeviceMetricData)`.
`currentRunMetrics`	: sơ đồ chỉ số hiện tại được chuyể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` chứa dữ liệu để chạy.

Gửi
`DeviceNotAvailableException`

Bắt đầu kiểm tra

public void onTestStart (DeviceMetricData testData)

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

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

Gửi
`DeviceNotAvailableException`

đã kết thúc khởi động lại

public void rebootEnded (ITestDevice device)

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

LƯU Ý: Trình 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ỏ qua.

Tham số
`device`	`ITestDevice`: `ITestDevice` khi 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 khởi động lại thiết bị.

LƯU Ý: Trình 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ỏ qua.

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

Gửi
`DeviceNotAvailableException`

đặtTắt

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ỏ phải được bỏ qua. Có thể dùng để vô hiệu hoá một đối tượng theo mặc định theo mặc định hàm khởi tạo.

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. Vô hiệu hoá có nghĩa là chưa được đăng ký với thiết bị để nhận sự kiện hành động trên thiết bị.

Tham số
`isDisabled`	`boolean`

setLogSaver

public final void setLogSaver (ILogSaver logSaver)

Không sử dụng nội dung triển khai trình thu thập chỉ số. Đây chỉ là chuyển tiếp.

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

thử nghiệmAssumptionKhông thành công

public final void testAssumptionFailure (TestDescription test, 
                String trace)

Được gọi khi một phép kiểm thử nguyên tử gắn cờ cho một điều kiện là false

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

thử nghiệmAssumptionKhông thành công

public final void testAssumptionFailure (TestDescription test, 
                FailureDescription failure)

Được gọi khi một phép kiểm thử nguyên tử gắn cờ cho một điều kiện là false

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 final void testEnded (TestDescription test, 
                long endTime, 
                 testMetrics)

Thay thế cho 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)` trong số các chỉ số được đưa ra

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

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

Nếu bạn không gọi testFailed(TestDescription, FailureDescription), thì kiểm thử này đã thành công. Cũng trả về bất kỳ khoá/giá trị nào các chỉ số 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

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

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 trong khoảng thời gian giữa testStarted và testCancelled.

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 trong khoảng thời gian giữa testStarted và testCancelled.

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

Đã bỏ qua kiểm thử

public final void testIgnored (TestDescription test)

Được gọi khi một bài kiểm thử không được chạy, thường là vì 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ử

nhật ký kiểm thử

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 và cung cấp nhật ký máy chủ lưu trữ và nếu có thì là logcat thiết bị.

Tham số
`dataName`	`String`: tên mô tả `String` của dữ liệu. ví dụ: "device_logcat". Ghi chú dataName không được là duy nhất cho mỗi lệnh gọi. tức là người 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 kết quả InputStream khi hoàn tất. Phương thức gọi phải đảm bảo giữ lại nguồn dữ liệu có sẵn và có thể truy cập được cho đến khi phương thức testLog hoàn tất.

testLog đã lưu

public 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ố. Đây chỉ là chuyển tiếp.

Tham số
`dataName`	`String`: tên mô tả `String` của dữ liệu. ví dụ: "device_logcat". Ghi chú dataName không được là duy nhất cho mỗi lệnh gọi. tức là người 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 kết quả InputStream khi hoàn tất.
`logFile`	`LogFile`: `LogFile` chứa siêu dữ liệu của tệp đã lưu.

thử nghiệmMô-đun đã kết thúc

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 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ự. Chỉ được dùng trong lần chạy có sử dụng mô-đun: trình chạy dựa trên bộ sản phẩm.

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

testRun kết thúc

public final void testRunEnded (long elapsedTime, 
                 runMetrics)

Báo cáo kết thúc lần chạy thử nghiệm. FIXME: Chúng tôi không thể có hai Bản đồ<> giao diện khác loại, vì vậy, chúng tôi phải sử dụng HashMap ở đây.

Tham số
`elapsedTime`	`long`: thời gian đã trôi qua theo báo cáo của thiết bị, tính bằng mili giây
`runMetrics`	: các cặp khoá-giá trị được báo cáo khi kết thúc lượt chạy kiểm thử bằng `Metric`.

testRunFailed không thành công

public final 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 không thành công

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 chạy kiểm thử
`testCount`	`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. Số tryNumber được lập chỉ mục 0 và sẽ tăng mỗi lần một lần chạy mới sẽ xảy ra. ví dụ: Một quy trình kiểm thử chi tiết được thử lại 3 lần, kết quả sẽ có tổng cộng 4 lần chạy trong cùng một runName và cố gắng dùng số là từ 0 đến 3.

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

public final void testRunStarted (String runName, 
                int testCount)

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

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

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

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 chạy kiểm thử
`testCount`	`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. Số tryNumber được lập chỉ mục 0 và sẽ tăng mỗi khi một lần chạy mới sẽ diễn ra. ví dụ: Một bài kiểm thử được thử lại ở cấp độ chi tiết 3 lần, và tổng cộng sẽ có 4 lần chạy trong cùng một runName và cố gắngNumber là từ 0 đến 3.
`startTime`	`long`: thời gian bắt đầu chạy, được đo bằng `System.currentTimeMillis()`

TestRunSđã dừng

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.

VIỆC CẦN LÀM: hiện không sử dụng, hãy cân nhắc xoá

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

Đã bỏ qua kiểm thử

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`

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

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

đã 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ử