Google cam kết thúc đẩy công bằng chủng tộc cho các cộng đồng Đen. Xem thế nào.
Trang này được dịch bởi Cloud Translation API.
Switch to English

BugreportCollector

public class BugreportCollector
extends Object implements ITestInvocationListener

java.lang.Object
com.android.tradefed.result.BugreportCollector


Một ITestInvocationListener qua thu thập các lỗi khi các sự kiện có thể định cấu hình xảy ra và sau đó gọi ITestInvocationListener#testLog trên các con của nó sau khi mỗi lỗi được thu thập.

Hành vi: (FIXME: hoàn thành việc này)

  • Chụp sau mỗi lần thử nếu thất bại
  • Chụp sau mỗi testcase
  • Chụp sau mỗi lần thử thất bại
  • Chiếm lấy

Tóm lược

Các lớp lồng nhau

enum BugreportCollector.Filter

enum BugreportCollector.Freq

enum BugreportCollector.Noun

class BugreportCollector.Predicate

Một vị từ đầy đủ mô tả khi nào cần chụp bugreport.

enum BugreportCollector.Relation

interface BugreportCollector.SubPredicate

Lĩnh vực

public static final BugreportCollector.Predicate AFTER_FAILED_TESTCASES

Một biến vị ngữ được xác định trước sẽ kích hoạt sau mỗi testcase thất bại

public static final BugreportCollector.Predicate AT_START

Một vị từ được xác định trước sẽ kích hoạt khi lệnh đầu tiên bắt đầu

Nhà xây dựng công cộng

BugreportCollector ( ITestInvocationListener listener, ITestDevice testDevice)

Phương pháp công cộng

void addPredicate ( BugreportCollector.Predicate p)
void blockUntilIdle ()

Chặn cho đến khi người sưu tầm không thu thập bất kỳ lỗi nào.

TestSummary getSummary ()

Cho phép InvocationListener trả về một bản tóm tắt.

void invocationEnded (long elapsedTime)

Báo cáo rằng việc gọi đã kết thúc, cho dù thành công hay do một số điều kiện lỗi.

void invocationFailed (Throwable cause)

Báo cáo một lời gọi không đầy đủ do một số điều kiện lỗi.

void invocationStarted ( IInvocationContext context)

Báo cáo bắt đầu cuộc gọi thử nghiệm.

void setAsynchronous (boolean asynchronous)

Đặt xem bộ sưu tập bugreport có nên thu thập bugreport trong một luồng khác asynchronous = true ( asynchronous = true ) hoặc chặn người gọi cho đến khi bugreport được ghi lại ( asynchronous = false ).

void setDescriptiveName (String name)

Đặt tên mô tả để sử dụng khi ghi bugreports.

void setDeviceWaitTime (int waitTime)

Đặt thời gian (tính bằng giây) để chờ thiết bị trực tuyến trước khi chúng tôi cố gắng ghi lại lỗi.

void testAssumptionFailure ( TestDescription test, String trace)

Được gọi khi một cờ kiểm tra nguyên tử cho rằng nó giả sử một điều kiện là sai

void testEnded ( TestDescription test, testMetrics) testEnded ( TestDescription test, testMetrics)

Báo cáo kết thúc thực hiện của một trường hợp thử nghiệm cá nhân.

void testFailed ( TestDescription test, String trace)

Báo cáo sự thất bại của một trường hợp thử nghiệm cá nhân.

void testIgnored ( TestDescription test)

Được gọi khi kiểm tra sẽ không được chạy, thường là do phương thức kiểm tra được chú thích bằng org.junit.Ignore.

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

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

void testRunEnded (long elapsedTime, runMetrics) testRunEnded (long elapsedTime, runMetrics)

Báo cáo kết thúc chạy thử.

void testRunFailed (String errorMessage)

Chạy thử báo cáo không hoàn thành do một lỗi nghiêm trọng.

void testRunStarted (String runName, int testCount)

Báo cáo sự bắt đầu của một lần chạy thử.

void testRunStopped (long elapsedTime)

Chạy thử báo cáo đã dừng trước khi hoàn thành do yêu cầu của người dùng.

void testStarted ( TestDescription test)

Báo cáo sự bắt đầu của một trường hợp thử nghiệm cá nhân.

Lĩnh vực

SAU_FAILED_TESTCASES

public static final BugreportCollector.Predicate AFTER_FAILED_TESTCASES

Một biến vị ngữ được xác định trước sẽ kích hoạt sau mỗi testcase thất bại

AT_START

public static final BugreportCollector.Predicate AT_START

Một vị từ được xác định trước sẽ kích hoạt khi lệnh đầu tiên bắt đầu

Nhà xây dựng công cộng

BugreportCollector

public BugreportCollector ( ITestInvocationListener listener, 
                ITestDevice testDevice)

Thông số
listener ITestInvocationListener

testDevice ITestDevice

Phương pháp công cộng

addPredicate

public void addPredicate ( BugreportCollector.Predicate p)

Thông số
p BugreportCollector.Predicate

blockUntilIdle

public void blockUntilIdle ()

Chặn cho đến khi người sưu tầm không thu thập bất kỳ lỗi nào. Nếu trình thu thập không tích cực thu thập lỗi, hãy quay lại ngay lập tức

nhận được

public TestSummary getSummary ()

Cho phép InvocationListener trả về một bản tóm tắt.

Trả về
TestSummary Một TestSummary tóm tắt hoạt động, hoặc null

cầu khẩn

public void invocationEnded (long elapsedTime)

Báo cáo rằng việc 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 tự động gọi theo khung TradeFedencies.

Thông số
elapsedTime long : thời gian trôi qua của lời mời trong ms

lời mời

public void invocationFailed (Throwable cause)

Báo cáo một lời gọi không đầy đủ do một số điều kiện lỗi.

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

Thông số
cause Throwable : nguyên nhân có Throwable của sự thất bại

invocationStarted

public void invocationStarted ( IInvocationContext context)

Báo cáo bắt đầu cuộc gọi thử nghiệm.

Sẽ được tự động gọi theo khung TradeFedencies. Phóng viên cần ghi đè phương thức này để hỗ trợ báo cáo nhiều thiết bị.

Thông số
context IInvocationContext : thông tin về lời mời

setAnyncous

public void setAsynchronous (boolean asynchronous)

Đặt xem bộ sưu tập bugreport có nên thu thập bugreport trong một luồng khác asynchronous = true ( asynchronous = true ) hoặc chặn người gọi cho đến khi bugreport được ghi lại ( asynchronous = false ).

Thông số
asynchronous boolean

setDescriptiveName

public void setDescriptiveName (String name)

Đặt tên mô tả để sử dụng khi ghi bugreports. Nếu null , BugreportCollector sẽ quay trở lại hành vi mặc định của việc xê-ri hóa tên của sự kiện khiến bugreport được thu thập.

Thông số
name String

setDeviceWaitTime

public void setDeviceWaitTime (int waitTime)

Đặt thời gian (tính bằng giây) để chờ thiết bị trực tuyến trước khi chúng tôi cố gắng ghi lại lỗi. Nếu tiêu cực, không có kiểm tra sẽ được thực hiện. Bất kỳ DeviceNotAvailableException gặp phải trong kiểm tra này sẽ được ghi lại và bỏ qua.

Thông số
waitTime int

testAsschargeFailure

public void testAssumptionFailure ( TestDescription test, 
                String trace)

Được gọi khi một cờ kiểm tra nguyên tử cho rằng nó giả sử một điều kiện là sai

Thông số
test TestDescription : xác định thử nghiệm

trace String : dấu vết ngăn xếp của sự thất bại

kiểm tra

public void testEnded ( TestDescription test, 
                 testMetrics)

Báo cáo kết thúc thực hiện của một trường hợp thử nghiệm cá nhân.

Nếu testFailed(TestDescription, String) không được gọi, thử nghiệm này đã được thông qua. Đồng thời trả về bất kỳ số liệu khóa / giá trị nào có thể được phát ra trong quá trình thực hiện trường hợp thử nghiệm.

Thông số
test TestDescription : xác định thử nghiệm

testMetrics : ERROR(/Map) của các số liệu được phát ra

thử nghiệm thất bại

public void testFailed ( TestDescription test, 
                String trace)

Báo cáo sự thất bại của một trường hợp thử nghiệm cá nhân.

Sẽ được gọi giữa testStarted và testEnded.

Thông số
test TestDescription : xác định thử nghiệm

trace String : dấu vết ngăn xếp của sự thất bại

kiểm tra

public void testIgnored ( TestDescription test)

Được gọi khi kiểm tra sẽ không được chạy, thường là do phương thức kiểm tra được chú thích bằng org.junit.Ignore.

Thông số
test TestDescription : xác định thử nghiệm

kiểm tra

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

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

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

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

Thông 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ần gọi. tức là người triển khai phải có khả năng xử lý nhiều cuộc gọi với 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 createdInputStream để bắt đầu đọc dữ liệu và đảm bảo đóng InputStream khi kết thúc. Người gọi cần đảm bảo nguồn dữ liệu vẫn còn và có thể truy cập cho đến khi phương thức testLog hoàn thành.

testRunEnded

public void testRunEnded (long elapsedTime, 
                 runMetrics)

Báo cáo kết thúc chạy thử. CỐ ĐỊNH: Chúng tôi không thể có hai giao diện Map <> với loại khác nhau, vì vậy chúng tôi phải sử dụng HashMap tại đây.

Thông 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 khóa-giá trị được báo cáo khi kết thúc quá trình chạy thử với Metric .

testRunFails

public void testRunFailed (String errorMessage)

Chạy thử báo cáo không hoàn thành do một lỗi nghiêm trọng.

Thông số
errorMessage String : String mô tả lý do cho thất bại chạy.

testRunStarted

public void testRunStarted (String runName, 
                int testCount)

Báo cáo sự bắt đầu của một lần chạy thử.

Thông số
runName String : tên chạy thử

testCount int : tổng số bài kiểm tra đang chạy

testRunStopped

public void testRunStopped (long elapsedTime)

Chạy thử báo cáo đã dừng trước khi hoàn thành do yêu cầu của người dùng.

TODO: hiện không được sử dụng, xem xét loại bỏ

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

đã bắt đầu

public void testStarted ( TestDescription test)

Báo cáo sự bắt đầu của một trường hợp thử nghiệm cá nhân. Giao diện cũ hơn, nên sử dụng testStarted(com.android.tradefed.result.TestDescription) bất cứ khi nào có thể.

Thông số
test TestDescription : xác định thử nghiệm