IMetricCollector
public
interface
IMetricCollector
implements
IDisableable,
ILogSaverListener
| com.android.tradefed.device.metric.IMetricCollector |
Giao diện này sẽ được thêm dưới dạng một trình trang trí khi báo cáo kết quả kiểm thử để thu thập các chỉ số phù hợp.
Bạn không thể dùng giao diện này làm ITestInvocationListener. Quy trình kiểm tra cấu hình sẽ từ chối yêu cầu này. Bạn phải dùng tham số này làm "metrics_collector".
Các đối tượng thu thập không được giữ trạng thái nội bộ vì chúng có thể được dùng lại ở nhiều nơi. Nếu bạn thực sự phải dùng trạng thái nội bộ, thì bạn nên xoá trạng thái đó trên init(IInvocationContext,ITestInvocationListener).
Tóm tắt
Phương thức công khai | |
|---|---|
default
boolean
|
captureModuleLevel()
Liệu trình thu thập có áp dụng cho tính năng chụp ở cấp độ mô-đun hay không và có nên khởi động hay không. |
default
boolean
|
doesModuleContainFailure()
Trả về true nếu mô-đun hiện tại có chứa trường hợp kiểm thử hoặc lần chạy kiểm thử nào bị lỗi. |
default
void
|
enableDefaultMetricCollection()
Cho phép các trình thu thập bật chế độ thu thập chỉ số mặc định. |
default
IMetricCollector.MetricCollectionLevel
|
getAlwaysOnCollectionLevel()
|
abstract
List<IBuildInfo>
|
getBuildInfos()
Trả về danh sách thông tin bản dựng có trong lệnh gọi. |
abstract
List<ITestDevice>
|
getDevices()
Trả về danh sách các thiết bị có trong lệnh gọi. |
abstract
ITestInvocationListener
|
getInvocationListener()
Trả về |
default
IMetricCollector.MetricCollectionLevel
|
getOnFailureCollectionLevel()
|
abstract
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ả. |
default
boolean
|
isDefaultMetricCollectionEnabled()
Liệu trình thu thập có đang thu thập chỉ số trong quá trình thu thập chỉ số mặc định hay không. |
abstract
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. |
abstract
void
|
onTestEnd(DeviceMetricData testData, Map<String, MetricMeasurement.Metric> currentTestCaseMetrics, TestDescription test)
Lệnh gọi lại khi một trường hợp kiểm thử kết thúc. |
abstract
void
|
onTestEnd(DeviceMetricData testData, Map<String, MetricMeasurement.Metric> currentTestCaseMetrics)
Lệnh gọi lại khi một trường hợp kiểm thử kết thúc. |
abstract
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. |
default
void
|
onTestModuleEnded()
Cho phép ghi lại sự kiện kết thúc mô-đun. |
default
void
|
onTestModuleStarted()
Cho phép ghi lại sự kiện mô-đun đã bắt đầu. |
abstract
void
|
onTestRunEnd(DeviceMetricData runData, Map<String, MetricMeasurement.Metric> currentRunMetrics)
Lệnh gọi lại khi một lần chạy thử nghiệm kết thúc. |
abstract
void
|
onTestRunStart(DeviceMetricData runData)
Lệnh gọi lại khi một lần chạy kiểm thử bắt đầu. |
default
void
|
onTestRunStart(DeviceMetricData runData, int testCount)
Lệnh gọi lại khi một lần chạy kiểm thử bắt đầu. |
default
void
|
onTestRunStartBlocking()
Gọi lại rõ ràng để bắt đầu trình thu thập theo cách thủ công nếu trình thu thập đó hỗ trợ. |
abstract
void
|
onTestStart(DeviceMetricData testData)
Lệnh gọi lại khi một trường hợp kiểm thử bắt đầu. |
default
void
|
setAlwaysOnCollectionLevel(IMetricCollector.MetricCollectionLevel level)
Đặt cấp độ mà trình thu thập sẽ thu thập nhật ký bất kể lỗi. |
default
void
|
setModuleContainsFailure()
Đặt xem mô-đun có lỗi nào không (trường hợp kiểm thử, lần chạy kiểm thử). |
default
void
|
setOnFailureCollectionLevel(IMetricCollector.MetricCollectionLevel level)
Đặt cấp độ mà trình thu thập sẽ thu thập nhật ký trong trường hợp xảy ra lỗi. |
Phương thức công khai
captureModuleLevel
public boolean captureModuleLevel ()
Liệu trình thu thập có áp dụng cho tính năng chụp ở cấp độ mô-đun hay không và có nên khởi động hay không.
| Giá trị trả về | |
|---|---|
boolean |
|
doesModuleContainFailure
public boolean doesModuleContainFailure ()
Trả về true nếu mô-đun hiện tại có chứa trường hợp kiểm thử hoặc lần chạy kiểm thử nào bị lỗi.
| Giá trị trả về | |
|---|---|
boolean |
|
enableDefaultMetricCollection
public void enableDefaultMetricCollection ()
Cho phép các trình thu thập bật chế độ thu thập chỉ số mặc định. Khi chế độ thu thập chỉ số mặc định được bật, bộ thu thập chỉ nên thu thập ở cấp thu thập được chỉ định.
getAlwaysOnCollectionLevel
public IMetricCollector.MetricCollectionLevel getAlwaysOnCollectionLevel ()
| Giá trị trả về | |
|---|---|
IMetricCollector.MetricCollectionLevel |
|
getBuildInfos
public abstract List<IBuildInfo> getBuildInfos ()
Trả về danh sách thông tin bản dựng có trong lệnh gọi.
| Giá trị trả về | |
|---|---|
List<IBuildInfo> |
|
getDevices
public abstract List<ITestDevice> getDevices ()
Trả về danh sách các thiết bị có trong lệnh gọi.
| Giá trị trả về | |
|---|---|
List<ITestDevice> |
|
getInvocationListener
public abstract ITestInvocationListener getInvocationListener ()
Trả về ITestInvocationListener ban đầu nơi chúng tôi chuyển tiếp kết quả.
| Giá trị trả về | |
|---|---|
ITestInvocationListener |
|
getOnFailureCollectionLevel
public IMetricCollector.MetricCollectionLevel getOnFailureCollectionLevel ()
| Giá trị trả về | |
|---|---|
IMetricCollector.MetricCollectionLevel |
|
init
public abstract 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ử 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ời 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 |
|
isDefaultMetricCollectionEnabled
public boolean isDefaultMetricCollectionEnabled ()
Liệu trình thu thập có đang thu thập chỉ số trong quá trình thu thập chỉ số mặc định hay không.
| Giá trị trả về | |
|---|---|
boolean |
|
onTestAssumptionFailure
public abstract 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 abstract void onTestEnd (DeviceMetricData testData, Map<String, MetricMeasurement.Metric> 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(DeviceMetricData). |
currentTestCaseMetrics |
Map: bản đồ hiện tại của các chỉ số được truyền đến testEnded(TestDescription,Map). |
test |
TestDescription: TestDescription của trường hợp kiểm thử đang diễn ra. |
| Gửi | |
|---|---|
DeviceNotAvailableException |
|
onTestEnd
public abstract void onTestEnd (DeviceMetricData testData, Map<String, MetricMeasurement.Metric> 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(DeviceMetricData). |
currentTestCaseMetrics |
Map: bản đồ hiện tại của các chỉ số được truyền đến testEnded(TestDescription,Map). |
| Gửi | |
|---|---|
DeviceNotAvailableException |
|
onTestFail
public abstract 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 | |
|---|---|
|
com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
|
onTestModuleStarted
public void onTestModuleStarted ()
Cho phép ghi lại sự kiện mô-đun đã bắt đầu.
| Gửi | |
|---|---|
|
com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
|
onTestRunEnd
public abstract void onTestRunEnd (DeviceMetricData runData, Map<String, MetricMeasurement.Metric> currentRunMetrics)
Lệnh gọi lại khi một lần chạy thử nghiệm 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(DeviceMetricData). |
currentRunMetrics |
Map: bản đồ hiện tại của các chỉ số được truyền đến testRunEnded(long,Map). |
| Gửi | |
|---|---|
DeviceNotAvailableException |
|
onTestRunStart
public abstract void onTestRunStart (DeviceMetricData runData)
Lệnh gọi lại khi một lần chạy kiểm thử bắt đầu.
| Tham số | |
|---|---|
runData |
DeviceMetricData: DeviceMetricData chứa dữ liệu cho lần chạy. |
| Gửi | |
|---|---|
DeviceNotAvailableException |
|
onTestRunStart
public void onTestRunStart (DeviceMetricData runData, int testCount)
Lệnh gọi lại khi một lần chạy kiểm thử bắt đầu.
| Tham số | |
|---|---|
runData |
DeviceMetricData: DeviceMetricData chứa dữ liệu cho lần chạy. |
testCount |
int: số lượng trường hợp kiểm thử trong lần chạy kiểm thử này. |
| Gửi | |
|---|---|
DeviceNotAvailableException |
|
onTestRunStartBlocking
public void onTestRunStartBlocking ()
Gọi lại rõ ràng để bắt đầu trình thu thập theo cách thủ công nếu trình thu thập đó hỗ trợ. Điều này giúp đảm bảo chúng ta không nằm ngoài một số vòng đời kiểm thử không đồng bộ.
| Gửi | |
|---|---|
|
com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
|
onTestStart
public abstract 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 |
|
setAlwaysOnCollectionLevel
public void setAlwaysOnCollectionLevel (IMetricCollector.MetricCollectionLevel level)
Đặt cấp độ mà trình thu thập sẽ thu thập nhật ký bất kể lỗi.
Cấp độ NULL sẽ không tạo ra bộ sưu tập.
| Tham số | |
|---|---|
level |
IMetricCollector.MetricCollectionLevel: MetricCollectionLevel mà nhật ký sẽ được thu thập. |
setModuleContainsFailure
public void setModuleContainsFailure ()
Đặt xem mô-đun có lỗi nào không (trường hợp kiểm thử, lần chạy kiểm thử).
setOnFailureCollectionLevel
public void setOnFailureCollectionLevel (IMetricCollector.MetricCollectionLevel level)
Đặt cấp độ mà trình thu thập sẽ thu thập nhật ký trong trường hợp xảy ra lỗi.
Cấp độ NULL sẽ không tạo ra bộ sưu tập.
| Tham số | |
|---|---|
level |
IMetricCollector.MetricCollectionLevel: MetricCollectionLevel mà nhật ký sẽ được thu thập. |