BaseDeviceMetricCollector

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, CodeCoverageCollector, CountTestCasesCollector, DebugHostLogOnFailureCollector, DeviceTraceCollector, FilePullerDeviceMetricCollector, GcovCodeCoverageCollector, GcovKernelCodeCoverageCollector, HostStatsdMetricCollector, JavaCodeCoverageCollector, LogcatOnFailureCollector, LogcatTimingMetricCollector, RebootReasonCollector, RuntimeRestartCollector, ScreenshotOnFailureCollector AtraceCollector Một IMetricCollector chạy atrace trong quá trình kiểm thử, thu thập kết quả và ghi nhật ký 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 bugreportz 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 các phép đo mức độ phù hợp của Clang ra khỏi thiết bị và ghi lại các phép đo đó dưới dạng các cấu phần phần mềm kiểm thử.  CodeCoverageCollector Một BaseDeviceMetricCollector sẽ kéo các phép đo mức độ phù hợp của Java và gốc ra khỏi thiết bị, đồng thời ghi lại các phép đo đó dưới dạng các 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ủ lưu trữ khi xảy ra lỗi trường hợp kiểm thử.  DeviceTraceCollector Bộ thu thập sẽ bắt đầu dấu vết perfetto khi bắt đầu chạy kiểm thử và ghi tệp dấu vết vào cuối.  FilePullerDeviceMetricCollector Một BaseDeviceMetricCollector lắng nghe khoá chỉ số đến từ thiết bị và kéo chúng dưới dạng tệp từ thiết bị.  GcovCodeCoverageCollector Một BaseDeviceMetricCollector sẽ kéo các phép đo mức độ phù hợp gcov ra khỏi thiết bị và ghi lại các phép đo đó dưới dạng các cấu phần phần mềm kiểm thử.  GcovKernelCodeCoverageCollector BaseDeviceMetricCollector sẽ kéo các phép đo mức độ phù hợp của hạt nhân gcov ra khỏi debugfs và khỏi thiết bị, sau đó ghi nhật ký các phép đo đó dưới dạng các cấu phần phần mềm kiểm thử.  HostStatsdMetricCollector Một IMetricCollector thu thập các chỉ số statsd từ phía máy chủ lưu trữ bằng cách sử dụng các lệnh tiện ích statsd.  JavaCodeCoverageCollector BaseDeviceMetricCollector sẽ kéo các phép đo mức độ phù hợp của Java ra khỏi thiết bị và ghi lại các phép đo đó dưới dạng các cấu phần phần mềm kiểm thử.  LogcatOnFailureCollector Trình thu thập sẽ ghi lại và đăng nhập một logcat khi một trường hợp kiểm thử không thành công.  LogcatTimingMetricCollector Một trình 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 biểu thức chính quy đã cho để 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 Trình thu thập dữ liệu thu thập thông tin về quá trình khởi động lại thiết bị trong quá trình chạy thử và báo cáo thông tin đó theo lý do và số lượng.  RuntimeRestartCollector Trình thu thập thu thập dấu thời gian của các lần khởi động lại thời gian chạy (hệ thống gặp sự cố máy chủ) trong quá trình chạy thử nghiệm (nếu có).  ScreenshotOnFailureCollector Trình 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, PerfettoFilePullerCollector, PerfettoPullerMetricCollector, ShowmapPullerMetricCollector, TraceCmdCollector AtraceRunMetricCollector Thu thập các 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 nhật ký thư mục kiểm thử và xử lý hậu kỳ các tệp dấu vết 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 cấu hình chỉ số thời lượng statsd đượ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 số trạng thái kết nối cho từng hồ sơ.  BluetoothHciSnoopLogCollector Trình 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 từng kiểm thử.  FilePullerLogCollector Trình ghi nhật ký của tệp do phía thiết bị báo cáo.  ModuleLogcatCollector Phiên bản của trình thu thập logcat nhưng dành cho mô-đun.  PerfettoFilePullerCollector Một trình thu thập kéo các tệp dấu vết perfetto từ thiết bị, nén các tệp đó (nếu có) và thêm các tệp đó vào nhật ký kiểm thử.  PerfettoPullerMetricCollector Lớp này không được dùng nữa. Thay vào đó, hãy sử dụng PerfettoFilePullerCollector và ERROR(/PerfettoTracePostProcessor).  ShowmapPullerMetricCollector Triển khai cơ sở của FilePullerDeviceMetricCollector cho phép kéo các tệp showmap từ thiết bị và thu thập các chỉ số từ đó.  TraceCmdCollector Một IMetricCollector thu thập các dấu vết trong quá trình kiểm thử bằng trace-cmd và ghi nhật ký các dấu vết đó vào lệnh gọi.

---

Cách triển khai cơ bản 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

Hằng số
String	TEST_CASE_EXCLUDE_GROUP_OPTION
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 các thiết bị có trong lệnh gọi.
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.
final ITestInvocationListener	getInvocationListener() Trả về ITestInvocationListener gốc nơi chúng tôi 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 là thiết bị thay thế trong danh sách getDevices().
String	getRunName() Trả về tên của lần chạy thử mRunName kích hoạt trình thu thập dữ liệu.
String	getTestName() Trả về tên của kiểm thử mTestName 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 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, cho 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ị vô hiệu hoá (bỏ qua cả quá trình thiết lập và huỷ).
boolean	isDisabledReceiver() IDeviceActionReceiver có bị vô hiệu hoá hay không.
final void	logAssociation(String dataName, LogFile logFile) Không sử dụng trong quá trình triển khai bộ 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 kết thúc mô-đun.
void	onTestModuleStarted() Cho phép ghi lại sự kiện mô-đun đã bắt đầu.
void	onTestRunEnd(DeviceMetricData runData, currentRunMetrics) Lệnh gọi lại khi một lần chạy 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 một lần chạy thử nghiệm bắt đầu.
void	onTestStart(DeviceMetricData testData) Lệnh gọi lại khi một trường hợp kiểm thử 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 quá trình khởi động lại bắt đầu trên thiết bị.
final void	setDisable(boolean isDisabled) Đặt 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 trong quá trình triển khai bộ thu thập chỉ số.
final void	testAssumptionFailure(TestDescription test, String trace) Được gọi khi một kiểm thử đơn vị gắn cờ rằng kiểm thử đó giả định một điều kiện sai
final void	testAssumptionFailure(TestDescription test, FailureDescription failure) Được gọi khi một kiểm thử đơn vị gắn cờ rằng kiểm thử đó giả định một điều kiện sai
final void	testEnded(TestDescription test, long endTime, testMetrics) Phương án thay thế cho ERROR(/#testEnded(com.android.tradefed.result.TestDescription,Map)), trong đó chúng ta có thể chỉ định trực tiếp thời gian kết thúc.
final void	testEnded(TestDescription test, testMetrics) Báo cáo thời điểm kết thúc quá trình 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 quy 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 được liên kết từ lệnh gọi kiểm thử.
final void	testLogSaved(String dataName, LogDataType dataType, InputStreamSource dataStream, LogFile logFile) Không sử dụng trong quá trình triển khai bộ thu thập chỉ số.
final void	testModuleEnded() Báo cáo về việc kết thúc một lần 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 thử nghiệm.
final void	testRunFailed(FailureDescription failure) Không thể hoàn tất quá trình chạy thử báo cáo do lỗi được mô tả bằng FailureDescription.
final void	testRunFailed(String errorMessage) Không thể hoàn tất quá trình chạy thử báo cáo do gặp 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 một lần chạy thử nghiệm.
final void	testRunStarted(String runName, int testCount) Lệnh gọi lại chạy thử
final void	testRunStarted(String runName, int testCount, int attemptNumber, long startTime) Báo cáo thời điểm bắt đầu một lần chạy thử nghiệm.
final void	testRunStopped(long elapsedTime) Chạy thử báo cáo bị dừng trước khi hoàn tất do người dùng yêu cầu.
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 thường không 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 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 trường hợp kiểm thử

Hằng số

TEST_CASE_EXCLUDE_GROUP_OPTION

public static final String TEST_CASE_EXCLUDE_GROUP_OPTION

Giá trị không đổi: "test-case-exclude-group"

TEST_CASE_INCLUDE_GROUP_OPTION

public static final String TEST_CASE_INCLUDE_GROUP_OPTION

Giá trị không đổi: "test-case-include-group"

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ó trong lệnh gọi.

Giá trị trả về

getDevices

public final  getDevices ()

Trả về danh sách các thiết bị có 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ác 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 gốc nơi chúng tôi 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 là thiết bị thay thế trong danh sách getDevices().

Giá trị trả về

getRunName

public String getRunName ()

Trả về tên của lần chạy thử mRunName kích hoạt bộ sưu tập.

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

getTestName

public String getTestName ()

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

Giá trị trả về
String	mTestName, tên kiểm thử hiện tại.

init

public final ITestInvocationListener init (IInvocationContext context, 
                ITestInvocationListener listener)

Khởi chạy trình thu thập bằng ngữ cảnh hiện tại và nơi chuyển tiếp kết quả. Chỉ được gọi một lần cho mỗi phiên bản và trình thu thập dự kiến sẽ cập nhật ngữ cảnh và trình nghe nội bộ của phiên bản đó. Init sẽ không bao giờ được gọi trong quá trình chạy thử nghiệm mà luôn được gọi 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 bao bọc trình nghe ban đầu.

Gửi
DeviceNotAvailableException

invocationEnded

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 gây ra lỗi

invocationFailed

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

invocationSkipped

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ệnh gọi để chuyển tiếp

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

isDisabled

public final boolean isDisabled ()

Trả về True nếu toàn bộ đối tượng bị vô hiệu hoá (bỏ qua cả quá trình thiết lập và huỷ). Nếu không thì trả về giá trị false.

Giá trị trả về
boolean

isDisabledReceiver

public boolean isDisabledReceiver ()

IDeviceActionReceiver có bị vô hiệu hoá hay không.

Giá trị trả về
boolean	trả về true nếu bị vô hiệu hoá, trả về false nếu không.

logAssociation

public final void logAssociation (String dataName, 
                LogFile logFile)

Không sử dụng trong quá trình triển khai bộ 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 nhật ký 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 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

onTestEnd

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à thời điểm 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	: 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

onTestEnd

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à thời điểm 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	: 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 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

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 mô-đun đã bắt đầu.

Gửi
DeviceNotAvailableException

onTestRunEnd

public void onTestRunEnd (DeviceMetricData runData, 
                 currentRunMetrics)

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

Tham số
runData	DeviceMetricData: DeviceMetricData chứa dữ liệu cho lần chạy. Sẽ là cùng một đối tượ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

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 một lần chạy thử nghiệm bắt đầu.

Tham số
runData	DeviceMetricData: DeviceMetricData chứa 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 chứa 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 kết thúc trên thiết bị.

LƯU Ý: Các thiết bị nhận không nên 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

rebootStarted

public void rebootStarted (ITestDevice device)

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

LƯU Ý: Các thiết bị nhận không nên 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 bắt đầu.

Gửi
DeviceNotAvailableException

setDisable

public final void setDisable (boolean isDisabled)

Đặt xem có nên tắt đối tượng hay không. Tắt có nghĩa là bạn nên bỏ qua cả bước thiết lập và bước tháo dỡ. 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ó nên tắt IDeviceActionReceiver hay không. Nếu bạn tắt, thì ứng dụng sẽ không được đăng ký với thiết bị để nhận các sự kiện thao tác trên 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 bộ 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ử đơn vị gắn cờ rằng kiểm thử đó giả định một điều kiện sai

Tham số
test	TestDescription: xác định bài kiểm tra
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ử đơn vị gắn cờ rằng kiểm thử đó giả định một điều kiện sai

Tham số
test	TestDescription: xác định bài kiểm tra
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)

Phương án thay thế cho ERROR(/#testEnded(com.android.tradefed.result.TestDescription,Map)), trong đó chúng ta có thể chỉ định trực tiếp thời gian kết thúc. 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 bài kiểm tra
endTime	long: thời gian kết thúc kiểm thử, được đo bằng System.currentTimeMillis()
testMetrics	: một ERROR(/Map) các chỉ số được phát ra

testEnded

public final void testEnded (TestDescription test, 
                 testMetrics)

Báo cáo thời điểm 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ì quy trình kiểm thử này đã thành công. Cũng trả về mọi chỉ số khoá/giá trị có thể đã được phát trong quá trình thực thi trường hợp kiểm thử.

Tham số
test	TestDescription: xác định bài kiểm tra
testMetrics	: một ERROR(/Map) 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 bài kiểm tra
failure	FailureDescription: FailureDescription mô tả lỗi và ngữ cảnh của lỗi đó.

testFailed

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 bài kiểm tra
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 quy 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 bài kiểm tra

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 được liên kết 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ủ lưu trữ và nhật ký cat của thiết bị (nếu có).

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à 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. Người triển khai nên gọi createInputStream để bắt đầu đọc dữ liệu và đảm bảo đóng InputStream kết quả khi hoàn tất. Người gọi phải đảm bảo nguồn dữ liệu vẫn hiện diện và có thể truy cập 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 bộ 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à 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. Người triển khai nên gọi createInputStream để bắt đầu đọc dữ liệu và đảm bảo đóng InputStream kết quả 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 về việc kết thúc một lần 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 chuỗi. Nó 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 thử nghiệm.

Tham số
elapsedTime	long: thiết bị báo cáo thời gian đã trôi qua, 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 final void testRunFailed (FailureDescription failure)

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

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 thể hoàn tất quá trình chạy thử báo cáo do gặp lỗi nghiêm trọng.

Tham số
errorMessage	String: String mô tả lý do khiến lần chạy không thành công.

testRunStarted

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

Báo cáo thời điểm bắt đầu một lần chạy thử nghiệm.

Tham số
runName	String: tên của lần chạy 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à sẽ tăng lên mỗi khi có một lần chạy mới. Ví dụ: Một thử nghiệm được thử lại chi tiết 3 lần, thì thử nghiệm đó sẽ có tổng cộng 4 lần chạy trong cùng một runName và attemptNumber từ 0 đến 3.

testRunStarted

public final void testRunStarted (String runName, 
                int testCount)

Lệnh gọi lại chạy thử

Tham số
runName	String: tên của lần chạy 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 một lần chạy thử nghiệm.

Tham số
runName	String: tên của lần chạy 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à sẽ tăng lên mỗi khi có một lần chạy mới. Ví dụ: Một bài kiểm thử được thử lại chi tiết 3 lần, thì bài kiểm thử đó sẽ có tổng cộng 4 lần chạy 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()

testRunStopped

public final void testRunStopped (long elapsedTime)

Chạy thử báo cáo bị dừng trước khi hoàn tất do người dùng yêu cầu.

TODO: currently unused, consider removing

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

testSkipped

public 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 thường không 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 bài kiểm tra
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 bài kiểm tra
startTime	long: thời gian bắt đầu kiểm thử, được đo bằng System.currentTimeMillis()

testStarted

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 bài kiểm tra