UiAutomatorRunner
public
class
UiAutomatorRunner
extends Object
implements
IRemoteAndroidTestRunner
| java.lang.Object | |
| ↳ | com.android.tradefed.testtype.UiAutomatorRunner |
Chạy kiểm thử UI Automator trên thiết bị và báo cáo kết quả. Kiểm thử UI Automator là một trình chạy kiểm thử chuyên dụng để chạy các kiểm thử tự động hoá giao diện người dùng sử dụng khung UI Automator. Trình chạy kiểm thử trên thiết bị mô phỏng định dạng đầu ra của kiểm thử đo lường để có thể dùng lại mã phân tích cú pháp hiện có trong ddmlib và TF. Về cơ bản, đây là một trình bao bọc xung quanh lệnh này: adb shell uiautomator runtest (jar files) -e class (test classes) ...
Tóm tắt
Hàm khởi tạo công khai | |
|---|---|
UiAutomatorRunner(IDevice remoteDevice, String[] jarPaths, String runnerPath)
Tạo UiAutomatorRunner để chạy các bài kiểm thử tự động hoá giao diện người dùng |
|
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. |
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 của lớp Java được thêm gần đây nhất |
String
|
getRunnerName()
Trả về tên lớp UiAutomatorTestRunner mặc định |
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(
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 arg0)
Đặ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
|
setIgnoreSighup(boolean value)
Đặt lựa chọn trong uiautomator để bỏ qua SIGHUP. |
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 timeout, TimeUnit unit)
Đặ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 unit)
Đặt thời gian tối đa cho phép để quá trình đo lường hoàn tất. |
void
|
setMaxtimeToOutputResponse(int maxTimeToOutputResponse)
Phương thức này không được dùng nữa.
hãy sử dụng |
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 Nếu không chỉ định, hệ thống sẽ sử dụng tên gói |
void
|
setTestCollection(boolean b)
Đặ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
|
getRunCommand()
|
String
|
getRunnerPath()
|
Hàm khởi tạo công khai
UiAutomatorRunner
public UiAutomatorRunner (IDevice remoteDevice, String[] jarPaths, String runnerPath)
Tạo UiAutomatorRunner để chạy các bài kiểm thử tự động hoá giao diện người dùng
| Tham số | |
|---|---|
remoteDevice |
IDevice: thiết bị từ xa để tương tác: chạy thử nghiệm, thu thập kết quả, v.v. |
jarPaths |
String: đường dẫn đến các tệp jar nơi có các trường hợp kiểm thử UI Automator; đường dẫn phải tuyệt đối hoặc tương ứng với /data/local/tmp/ trên thiết bị |
runnerPath |
String: trình chạy uiautomator thay thế để sử dụng, có thể là null và trình chạy mặc định sẽ được dùng trong trường hợp này |
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.
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 của lớp Java được thêm gần đây nhất
| Giá trị trả về | |
|---|---|
String |
|
getRunnerName
public String getRunnerName ()
Trả về tên lớp UiAutomatorTestRunner mặc định
| 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 |
|
| 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 arg0)
Đặt vị trí của các báo cáo mức độ phù hợp được tạo.
| Tham số | |
|---|---|
arg0 |
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 |
setIgnoreSighup
public void setIgnoreSighup (boolean value)
Đặt lựa chọn trong uiautomator để bỏ qua SIGHUP.
| Tham số | |
|---|---|
value |
boolean: bỏ qua tín hiệu nếu được đặt thành true |
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 timeout,
TimeUnit unit)Đặ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ố | |
|---|---|
timeout |
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. |
unit |
TimeUnit: Đơn vị cho các giá trị maxTimeToOutputResponse và maxTimeout khác 0. |
setMaxTimeout
public void setMaxTimeout (long maxTimeout,
TimeUnit unit)Đặ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. |
unit |
TimeUnit: Đơn vị cho các giá trị maxTimeToOutputResponse và maxTimeout khác 0. |
setMaxtimeToOutputResponse
public void setMaxtimeToOutputResponse (int maxTimeToOutputResponse)
Phương thức này không được dùng nữa.
hãy sử dụng setMaxTimeToOutputResponse(long, TimeUnit).
| 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
setTestCollection
public void setTestCollection (boolean b)
Đặ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ố | |
|---|---|
b |
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ệ
getRunCommand
protected String getRunCommand ()
| Giá trị trả về | |
|---|---|
String |
|
getRunnerPath
protected String getRunnerPath ()
| Giá trị trả về | |
|---|---|
String |
|