IRemoteAndroidTestRunner

public interface IRemoteAndroidTestRunner

com.android.ddmlib.testrunner.IRemoteAndroidTestRunner

Giao diện để chạy lệnh kiểm thử Android từ xa và báo cáo kết quả cho một trình nghe.

Tóm tắt

Phương thức công khai

abstract void addBooleanArg(String name, boolean value)

Thêm một đối số boolean để đưa vào lệnh đo lường.

abstract void addInstrumentationArg(String name, String value)

Thêm một đối số để đưa vào lệnh đo lường.

abstract void cancel()

Yêu cầu huỷ lần chạy thử này.

abstract IRemoteAndroidTestRunner.CoverageOutput getCoverageOutputType()

Trả về loại mức độ kiểm thử được tạo bởi trình chạy.

abstract String getPackageName()

Trả về tên gói ứng dụng.

abstract String getRunnerName()

Trả về runnerName.

abstract void removeInstrumentationArg(String name)

Xoá một đối số đã thêm trước đó.

abstract void run(ITestRunListener... listeners)

Thực thi lượt kiểm thử này.

abstract void run( listeners)

Thực thi lượt kiểm thử này.

abstract void setAdditionalTestOutputLocation(String additionalTestDataPath)

Đặt vị trí của đầu ra kiểm thử bổ sung cần sao chép vào máy chủ trước khi ứng dụng kiểm thử bị gỡ cài đặt.

abstract void setClassName(String className)

Đặt để chỉ chạy các kiểm thử trong lớp này. Phải được gọi trước "run".

abstract void setClassNames(String[] classNames)

Đặt để chỉ chạy các kiểm thử trong các lớp được cung cấp Phải được gọi trước "run".

abstract void setCoverage(boolean coverage)

Đặt chế độ mức độ sử dụng mã cho lần chạy kiểm thử này.

abstract void setCoverageReportLocation(String reportPath)

Đặt vị trí của các báo cáo mức độ phù hợp được tạo.

abstract void setDebug(boolean debug)

Đặt chế độ gỡ lỗi này cho lần chạy thử nghiệm này.

abstract void setLogOnly(boolean logOnly)

Đặt lần chạy kiểm thử này ở chế độ chỉ ghi nhật ký – bỏ qua quá trình thực thi kiểm thử.

abstract void setMaxTimeToOutputResponse(long maxTimeToOutputResponse, TimeUnit maxTimeUnits)

Đặt thời gian tối đa cho phép giữa đầu ra của lệnh shell chạy các kiểm thử trên thiết bị.

abstract void setMaxTimeout(long maxTimeout, TimeUnit maxTimeUnits)

Đặt thời gian tối đa cho phép để quá trình đo lường hoàn tất.

abstract void setMaxtimeToOutputResponse(int maxTimeToOutputResponse)

Phương thức này không được dùng nữa. Sử dụng ERROR(/#setMaxTimeToOutputResponse(long,java.util.concurrent.TimeUnit)).

abstract void setMethodName(String className, String testName)

Đặt để chỉ chạy phương thức kiểm thử đã chỉ định Phải được gọi trước khi chạy.

abstract void setRunName(String runName)

Đặt tên chạy tuỳ chỉnh để báo cáo cho ITestRunListener trên run()

Nếu không chỉ định, hệ thống sẽ sử dụng tên gói

abstract void setTestCollection(boolean collection)

Đặt lần chạy thử nghiệm này ở chế độ kiểm thử bộ sưu tập.

abstract void setTestPackageName(String packageName)

Đặt để chạy tất cả các kiểm thử trong gói đã chỉ định Phải được gọi trước "run".

abstract void setTestSize(IRemoteAndroidTestRunner.TestSize size)

Đặt để chỉ chạy các kiểm thử có kích thước nhất định.

Phương thức công khai

addBooleanArg

public abstract void addBooleanArg (String name, 
                boolean value)

Thêm một đối số boolean để đưa vào lệnh đo lường.

Tham số
name String: tên của đối số gói đo lường
value boolean: giá trị của đối số

addInstrumentationArg

public abstract void addInstrumentationArg (String name, 
                String value)

Thêm một đối số để đưa vào lệnh đo lường.

Phải được gọi trước "run". Nếu một đối số có tên đã cho đã được cung cấp, thì giá trị của đối số đó sẽ bị ghi đè.

Tham số
name String: tên của đối số gói đo lường
value String: giá trị của đối số

hủy

public abstract void cancel ()

Yêu cầu huỷ lần chạy thử này.

getCoverageOutputType

public abstract IRemoteAndroidTestRunner.CoverageOutput getCoverageOutputType ()

Trả về loại mức độ kiểm thử được tạo bởi trình chạy. Hãy xem CoverageOutput.

Giá trị trả về
IRemoteAndroidTestRunner.CoverageOutput

getPackageName

public abstract String getPackageName ()

Trả về tên gói ứng dụng.

Giá trị trả về
String

getRunnerName

public abstract String getRunnerName ()

Trả về runnerName.

Giá trị trả về
String

removeInstrumentationArg

public abstract void removeInstrumentationArg (String name)

Xoá một đối số đã thêm trước đó.

Tham số
name String: tên của đối số gói đo lường cần xoá

chạy

public abstract void run (ITestRunListener... listeners)

Thực thi lượt kiểm thử này.

Phương thức thuận tiện cho ERROR(/#run(Collection)).

Tham số
listeners ITestRunListener: theo dõi kết quả kiểm thử
Gửi
TimeoutException trong trường hợp hết thời gian chờ kết nối.
AdbCommandRejectedException nếu adb từ chối lệnh
ShellCommandUnresponsiveException nếu thiết bị không đưa ra kết quả kiểm thử nào trong khoảng thời gian dài hơn thời gian tối đa để đưa ra kết quả.
nếu mất kết nối với thiết bị.

chạy

public abstract void run ( listeners)

Thực thi lượt kiểm thử này.

Tham số
listeners : tập hợp các trình nghe cho kết quả kiểm thử
Gửi
TimeoutException trong trường hợp hết thời gian chờ kết nối.
AdbCommandRejectedException nếu adb từ chối lệnh
ShellCommandUnresponsiveException nếu thiết bị không đưa ra kết quả kiểm thử nào trong khoảng thời gian dài hơn thời gian tối đa để đưa ra kết quả.
nếu mất kết nối với thiết bị.

setAdditionalTestOutputLocation

public abstract void setAdditionalTestOutputLocation (String additionalTestDataPath)

Đặt vị trí của đầu ra kiểm thử bổ sung cần sao chép vào máy chủ trước khi ứng dụng kiểm thử bị gỡ cài đặt. Ví dụ: báo cáo điểm chuẩn được tạo.

Tham số
additionalTestDataPath String

setClassName

public abstract void setClassName (String className)

Đặt để chỉ chạy các kiểm thử trong lớp này. Phải được gọi trước "run".

Tham số
className String: tên lớp đủ điều kiện (ví dụ: x.y.z)

setClassNames

public abstract void setClassNames (String[] classNames)

Đặt để chỉ chạy các kiểm thử trong các lớp được cung cấp Phải được gọi trước "run".

Nếu cung cấp nhiều lớp, bạn cần có InstrumentationTestRunner hỗ trợ cú pháp đối số nhiều lớp.

Tham số
classNames String: mảng tên lớp đủ điều kiện (ví dụ: x.y.z)

setCoverage

public abstract void setCoverage (boolean coverage)

Đặt chế độ mức độ sử dụng mã cho lần chạy kiểm thử này.

Tham số
coverage boolean

setCoverageReportLocation

public abstract void setCoverageReportLocation (String reportPath)

Đặt vị trí của các báo cáo mức độ phù hợp được tạo.

Tham số
reportPath String

setDebug

public abstract void setDebug (boolean debug)

Đặt chế độ gỡ lỗi này cho lần chạy thử nghiệm này. Nếu đúng, trình chạy kiểm thử Android sẽ đợi trình gỡ lỗi đính kèm trước khi tiếp tục thực thi kiểm thử.

Tham số
debug boolean

setLogOnly

public abstract void setLogOnly (boolean logOnly)

Đặt lần chạy kiểm thử này ở chế độ chỉ ghi nhật ký – bỏ qua quá trình thực thi kiểm thử.

Tham số
logOnly boolean

setMaxTimeToOutputResponse

public abstract void setMaxTimeToOutputResponse (long maxTimeToOutputResponse, 
                TimeUnit maxTimeUnits)

Đặt thời gian tối đa cho phép giữa đầu ra của lệnh shell chạy các kiểm thử trên thiết bị.

Điều này cho phép bạn đặt thời gian chờ trong trường hợp các kiểm thử bị kẹt và không bao giờ kết thúc. Điều này khác với thời gian chờ thông thường khi kết nối.

Theo mặc định, không có thời gian chờ nào được chỉ định.

Tham số
maxTimeToOutputResponse long: khoảng thời gian tối đa mà lệnh được phép không xuất bất kỳ phản hồi nào. Giá trị 0 có nghĩa là phương thức sẽ đợi vô thời hạn (cho đến khi receiver huỷ thực thi) để có đầu ra lệnh và không bao giờ gửi.
maxTimeUnits TimeUnit: Đơn vị cho các giá trị maxTimeToOutputResponse và maxTimeout khác 0.

setMaxTimeout

public abstract void setMaxTimeout (long maxTimeout, 
                TimeUnit maxTimeUnits)

Đặt thời gian tối đa cho phép để quá trình đo lường hoàn tất.

Điều này cho phép bạn đặt thời gian chờ trong trường hợp các kiểm thử bị kẹt và không bao giờ kết thúc. Điều này khác với thời gian chờ thông thường khi kết nối.

Theo mặc định, không có thời gian chờ nào được chỉ định.

Tham số
maxTimeout long: khoảng thời gian tối đa mà lệnh được phép không đưa ra bất kỳ phản hồi nào. Giá trị 0 có nghĩa là phương thức sẽ đợi vô thời hạn (cho đến khi receiver huỷ thực thi) để có đầu ra lệnh và không bao giờ gửi.
maxTimeUnits TimeUnit: Đơn vị cho các giá trị maxTimeToOutputResponse và maxTimeout khác 0.

setMaxtimeToOutputResponse

public abstract void setMaxtimeToOutputResponse (int maxTimeToOutputResponse)

Phương thức này không được dùng nữa.
Sử dụng ERROR(/#setMaxTimeToOutputResponse(long,java.util.concurrent.TimeUnit)).

Tham số
maxTimeToOutputResponse int

setMethodName

public abstract void setMethodName (String className, 
                String testName)

Đặt để chỉ chạy phương thức kiểm thử đã chỉ định Phải được gọi trước khi chạy.

Tham số
className String: tên lớp đủ điều kiện (ví dụ: x.y.z)
testName String: tên phương thức

setRunName

public abstract void setRunName (String runName)

Đặt tên chạy tuỳ chỉnh để báo cáo cho ITestRunListener trên run()

Nếu không chỉ định, hệ thống sẽ sử dụng tên gói

setTestCollection

public abstract void setTestCollection (boolean collection)

Đặt lần chạy thử nghiệm này ở chế độ kiểm thử bộ sưu tập. Nếu đúng, sẽ bỏ qua quá trình thực thi kiểm thử và sẽ đặt tất cả các đối số trình chạy thích hợp cần thiết để thu thập kiểm thử thành công.

Tham số
collection boolean

setTestPackageName

public abstract void setTestPackageName (String packageName)

Đặt để chạy tất cả các kiểm thử trong gói đã chỉ định Phải được gọi trước "run".

Tham số
packageName String: tên gói đủ điều kiện (ví dụ: x.y.z)

setTestSize

public abstract void setTestSize (IRemoteAndroidTestRunner.TestSize size)

Đặt để chỉ chạy các kiểm thử có kích thước nhất định. Phải được gọi trước khi "run".

Tham số
size IRemoteAndroidTestRunner.TestSize: TestSize cần chạy.