RemoteAndroidTestRunner

public class RemoteAndroidTestRunner
extends Object implements IRemoteAndroidTestRunner

java.lang.Object
↳	com.android.ddmlib.testrunner.RemoteAndroidTestRunner

---

Chạy lệnh kiểm thử Android từ xa và báo cáo kết quả.

Tóm tắt

Hàm khởi tạo công khai
RemoteAndroidTestRunner(String packageName, IShellEnabledDevice remoteDevice) Hàm khởi tạo thay thế.
RemoteAndroidTestRunner(String packageName, String runnerName, IShellEnabledDevice remoteDevice) Hàm khởi tạo thay thế.
RemoteAndroidTestRunner(String packageName, String runnerName, IShellEnabledDevice remoteDevice, RemoteAndroidTestRunner.StatusReporterMode statusReporterMode) Tạo một trình chạy kiểm thử Android từ xa.

Phương thức công khai
void	addBooleanArg(String name, boolean value) Thêm một đối số boolean để đưa vào lệnh đo lường.
void	addInstrumentationArg(String name, String value) Thêm một đối số để đưa vào lệnh đo lường.
void	cancel() Yêu cầu huỷ lần chạy thử này.
IInstrumentationResultParser	createParser(String runName, listeners) Tạo InstrumentationResultParser sẽ được dùng để phân tích cú pháp đầu ra của hoạt động đo lường.
String	getAmInstrumentCommand()
IRemoteAndroidTestRunner.CoverageOutput	getCoverageOutputType() Trả về loại mức độ kiểm thử được tạo bởi trình chạy.
String	getPackageName() Trả về tên gói ứng dụng.
String	getRunOptions() Trả về các lựa chọn cho lệnh am instrument.
String	getRunnerName() Trả về runnerName.
void	removeInstrumentationArg(String name) Xoá một đối số đã thêm trước đó.
void	run(ITestRunListener... listeners) Thực thi lượt kiểm thử này.
void	run( listeners) Thực thi lượt kiểm thử này.
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.
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".
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".
void	setCoverage(boolean coverage) Đặt chế độ mức độ sử dụng mã cho lần chạy kiểm thử này.
void	setCoverageReportLocation(String reportPath) Đặt vị trí của các báo cáo mức độ phù hợp được tạo.
void	setDebug(boolean debug) Đặt chế độ gỡ lỗi này cho lần chạy thử nghiệm này.
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ử.
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ị.
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.
void	setMaxtimeToOutputResponse(int maxTimeToOutputResponse)
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.
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
void	setRunOptions(String options) Đặt các tuỳ chọn cho lệnh am instrument.
void	setTestCollection(boolean collect) Đặt lần chạy thử nghiệm này ở chế độ kiểm thử bộ sưu tập.
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".
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 bảo vệ
String	getArgsCommand() Trả về cú pháp dòng lệnh đo lường đầy đủ cho các đối số đo lường được cung cấp.
String	getRunnerPath() Trả về đường dẫn đầy đủ của thành phần đo lường.

Hàm khởi tạo công khai

RemoteAndroidTestRunner

public RemoteAndroidTestRunner (String packageName, 
                IShellEnabledDevice remoteDevice)

Hàm khởi tạo thay thế. Sử dụng trình chạy đo lường mặc định.

Tham số
packageName	String: gói ứng dụng Android chứa các kiểm thử cần chạy
remoteDevice	IShellEnabledDevice: thiết bị Android để thực thi các kiểm thử

RemoteAndroidTestRunner

public RemoteAndroidTestRunner (String packageName, 
                String runnerName, 
                IShellEnabledDevice remoteDevice)

Hàm khởi tạo thay thế. Sử dụng statusReporterMode mặc định.

Tham số
packageName	String: gói ứng dụng Android chứa các kiểm thử cần chạy
runnerName	String: trình chạy kiểm thử đo lường để thực thi. Nếu giá trị rỗng, sẽ dùng trình chạy mặc định
remoteDevice	IShellEnabledDevice: thiết bị Android để thực thi các kiểm thử

RemoteAndroidTestRunner

public RemoteAndroidTestRunner (String packageName, 
                String runnerName, 
                IShellEnabledDevice remoteDevice, 
                RemoteAndroidTestRunner.StatusReporterMode statusReporterMode)

Tạo một trình chạy kiểm thử Android từ xa.

Tham số
packageName	String: gói ứng dụng Android chứa các kiểm thử cần chạy
runnerName	String: trình chạy kiểm thử đo lường để thực thi. Nếu giá trị rỗng, sẽ dùng trình chạy mặc định
remoteDevice	IShellEnabledDevice: thiết bị Android để thực thi các kiểm thử
statusReporterMode	RemoteAndroidTestRunner.StatusReporterMode: chế độ trình báo cáo trạng thái sẽ được dùng cho lệnh am instrument

Phương thức công khai

addBooleanArg

public 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 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 khi "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 void cancel ()

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

createParser

public IInstrumentationResultParser createParser (String runName, 
                 listeners)

Tạo InstrumentationResultParser sẽ được dùng để phân tích cú pháp đầu ra của hoạt động đo lường.

Tham số
runName	String: Tên của lượt chạy cần sử dụng.
listeners	: Trình nghe nơi báo cáo kết quả.

Giá trị trả về
IInstrumentationResultParser	Một bản sao của InstrumentationResultParser.

getAmInstrumentCommand

public String getAmInstrumentCommand ()

Giá trị trả về
String

getCoverageOutputType

public 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 String getPackageName ()

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

Giá trị trả về
String

getRunOptions

public String getRunOptions ()

Trả về các lựa chọn cho lệnh am instrument.

Giá trị trả về
String

getRunnerName

public String getRunnerName ()

Trả về runnerName.

Giá trị trả về
String

removeInstrumentationArg

public 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 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
AdbCommandRejectedException
ShellCommandUnresponsiveException
TimeoutException

chạy

public 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
AdbCommandRejectedException
ShellCommandUnresponsiveException
TimeoutException

setAdditionalTestOutputLocation

public 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 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 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 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 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 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 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 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 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 void setMaxtimeToOutputResponse (int maxTimeToOutputResponse)

Tham số
maxTimeToOutputResponse	int

setMethodName

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

setRunOptions

public void setRunOptions (String options)

Đặt các tuỳ chọn cho lệnh am instrument. Hãy xem com/android/commands/am/Am.java để biết danh sách đầy đủ các lựa chọn.

Tham số
options	String

setTestCollection

public void setTestCollection (boolean collect)

Đặ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ố
collect	boolean

setTestPackageName

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

Phương thức được bảo vệ

getArgsCommand

protected String getArgsCommand ()

Trả về cú pháp dòng lệnh đo lường đầy đủ cho các đối số đo lường được cung cấp. Trả về một chuỗi trống nếu không có đối số nào được chỉ định.

Giá trị trả về
String

getRunnerPath

protected String getRunnerPath ()

Trả về đường dẫn đầy đủ của thành phần đo lường.

Giá trị trả về
String