Kiểm tra thiết bị đo đạc
public class InstrumentationTest
extends Object
implements IDeviceTest , IRemoteTest , ITestCollector , IAbiReceiver , IConfigurationReceiver , IMetricCollectorReceiver
java.lang.Object | |
↳ | com.android.tradefed.testtype.InstrumentationTest |
Thử nghiệm chạy gói thử nghiệm thiết bị đo đạc trên thiết bị nhất định.
Bản tóm tắt
Lĩnh vực | |
---|---|
public static final String | RUN_TESTS_AS_USER_KEY |
public static final String | RUN_TESTS_ON_SDK_SANDBOX |
protected boolean | mDebug
|
Nhà thầu xây dựng công cộng | |
---|---|
InstrumentationTest () |
Phương pháp công cộng | |
---|---|
void | addDeviceListeners ( extraListeners) addDeviceListeners ( extraListeners) Cho phép thêm nhiều trình nghe tùy chỉnh hơn vào trình chạy |
void | addInstrumentationArg (String key, String value) Thêm đối số để cung cấp khi chạy thử nghiệm thiết bị đo đạc. |
IAbi | getAbi () |
IConfiguration | getConfiguration () Nhận |
String | getCoverageTarget () Nhận vùng phủ sóngTarget đã đặt trước đó thông qua |
boolean | getDebug () Nhận cài đặt gỡ lỗi thiết bị. |
ITestDevice | getDevice () Lấy thiết bị đang được kiểm tra. |
String | getForceAbi () |
long | getMaxTimeout () Trả về bộ thời gian chờ tối đa cho thiết bị đo. |
String | getPackageName () Tải gói kê khai Android để chạy. |
String | getRunName () Nhận tên chạy thử nghiệm tùy chỉnh sẽ được cung cấp cho người nghe |
String | getRunnerName () Sử dụng trình chạy thiết bị Android. |
void | run ( TestInformation testInfo, ITestInvocationListener listener) Chạy thử nghiệm và báo cáo kết quả cho người nghe. |
void | setAbi ( IAbi abi) |
void | setClassName (String testClassName) Tùy chọn, đặt tên lớp kiểm tra để chạy. |
void | setCollectTestsOnly (boolean shouldCollectTest) Bật hoặc tắt chế độ thu thập bài kiểm tra |
void | setCollectsTestsShellTimeout (int timeout) Phương pháp này không được dùng nữa. Phương pháp này là không hoạt động |
void | setConfiguration ( IConfiguration config) Tiêm |
void | setCoverageTarget (String coverageTarget) Đặt mục tiêu bao phủ của thử nghiệm này. |
void | setDebug (boolean debug) Đặt cài đặt gỡ lỗi thiết bị. |
void | setDevice ( ITestDevice device) Tiêm thiết bị đang được thử nghiệm. |
void | setEnforceFormat (boolean enforce) Đặt Đúng nếu chúng tôi thực thi định dạng đầu ra AJUR của thiết bị đo đạc. |
void | setForceAbi (String abi) Đặt tùy chọn buộc-abi. |
void | setInstallFile (File installFile) Đặt tệp tùy chọn để cài đặt có chứa các bài kiểm tra. |
void | setIsolatedStorage (boolean isolatedStorage) Đặt thời tiết hoặc không sử dụng bộ lưu trữ biệt lập. |
void | setMethodName (String testMethodName) Tùy chọn, đặt phương pháp thử nghiệm để chạy. |
void | setMetricCollectors ( collectors) setMetricCollectors ( collectors) Đặt danh sách |
void | setPackageName (String packageName) Đặt gói kê khai Android để chạy. |
void | setReRunUsingTestFile (boolean reRunUsingTestFile) Đặt tùy chọn --rerun-from-file. |
void | setRerunMode (boolean rerun) Tùy chọn, đặt chế độ chạy lại. |
void | setRunName (String runName) Đặt tên chạy thử nghiệm tùy chỉnh sẽ được cung cấp cho người nghe |
void | setRunnerName (String runnerName) Tùy chọn đặt trình chạy thiết bị Android để sử dụng. |
void | setShellTimeout (long timeout) Tùy chọn đặt thời gian tối đa (tính bằng mili giây) mong đợi kết quả đầu ra từ thiết bị. |
void | setTestFilePathOnDevice (String testFilePathOnDevice) Tùy chọn, đặt đường dẫn đến một tệp nằm trên thiết bị phải chứa danh sách các lớp và phương thức kiểm tra được phân tách bằng dòng (định dạng: com.foo.Class#method) sẽ được chạy. |
void | setTestPackageName (String testPackageName) Đặt bộ lọc gói thử nghiệm. |
void | setTestSize (String size) Tùy chọn, đặt kích thước thử nghiệm để chạy. |
void | setTestTimeout (long timeout) Tùy chọn, đặt thời gian tối đa (tính bằng mili giây) cho mỗi lần chạy thử riêng lẻ. |
void | setTestsToRun ( tests) setTestsToRun ( tests) Đặt tập hợp các thử nghiệm sẽ được thực hiện bởi InstrumentationTest này. |
void | setWindowAnimation (boolean windowAnimation) |
Phương pháp được bảo vệ | |
---|---|
static | excludeNonExecuted ( TestRunResult results) Lọc ra "NOT_EXECUTED" nhằm mục đích theo dõi những gì cần chạy lại. |
String | getClassName () Lấy tên lớp để chạy. |
ListInstrumentationParser | getListInstrumentationParser () Lấy |
String | getMethodName () Lấy phương pháp thử nghiệm để chạy. |
String | getTestPackageName () Lấy gói java thử nghiệm để chạy. |
String | queryRunnerName () Truy vấn thiết bị để người chạy thử sử dụng. |
void | setRunnerArgs (IRemoteAndroidTestRunner runner) |
Lĩnh vực
RUN_TESTS_AS_USER_KEY
public static final String RUN_TESTS_AS_USER_KEY
RUN_TESTS_ON_SDK_SANDBOX
public static final String RUN_TESTS_ON_SDK_SANDBOX
mDebug
protected boolean mDebug
Nhà thầu xây dựng công cộng
Kiểm tra thiết bị đo đạc
public InstrumentationTest ()
Phương pháp công cộng
addDeviceListener
public void addDeviceListeners (extraListeners)
Cho phép thêm nhiều trình nghe tùy chỉnh hơn vào trình chạy
Thông số | |
---|---|
extraListeners |
thêmInstrumentationArg
public void addInstrumentationArg (String key, String value)
Thêm đối số để cung cấp khi chạy thử nghiệm thiết bị đo đạc.
Thông số | |
---|---|
key | String : tên đối số |
value | String : giá trị đối số |
lấy cấu hình
public IConfiguration getConfiguration ()
Nhận IConfiguration
cho thử nghiệm này.
Trả lại | |
---|---|
IConfiguration |
getCoverageTarget
public String getCoverageTarget ()
Nhận vùng phủ sóngTarget đã đặt trước đó thông qua setCoverageTarget(String)
.
Trả lại | |
---|---|
String |
gỡ lỗi
public boolean getDebug ()
Nhận cài đặt gỡ lỗi thiết bị.
Trả lại | |
---|---|
boolean | Cài đặt gỡ lỗi boolean. |
lấy thiết bị
public ITestDevice getDevice ()
Lấy thiết bị đang được kiểm tra.
Trả lại | |
---|---|
ITestDevice | ITestDevice |
getForceAbi
public String getForceAbi ()
Trả lại | |
---|---|
String |
getMaxTimeout
public long getMaxTimeout ()
Trả về bộ thời gian chờ tối đa cho thiết bị đo.
Trả lại | |
---|---|
long |
lấyTên gói
public String getPackageName ()
Tải gói kê khai Android để chạy.
Trả lại | |
---|---|
String |
lấy tên chạy
public String getRunName ()
Nhận tên chạy thử nghiệm tùy chỉnh sẽ được cung cấp cho người nghe
Trả lại | |
---|---|
String |
getRunnerName
public String getRunnerName ()
Sử dụng trình chạy thiết bị Android.
Trả lại | |
---|---|
String |
chạy
public void run (TestInformation testInfo, ITestInvocationListener listener)
Chạy thử nghiệm và báo cáo kết quả cho người nghe.
Thông số | |
---|---|
testInfo | TestInformation : Đối tượng TestInformation chứa thông tin hữu ích để chạy thử nghiệm. |
listener | ITestInvocationListener : ITestInvocationListener của kết quả kiểm tra |
Ném | |
---|---|
DeviceNotAvailableException |
setClassName
public void setClassName (String testClassName)
Tùy chọn, đặt tên lớp kiểm tra để chạy.
Thông số | |
---|---|
testClassName | String |
setCollectTestsOnly
public void setCollectTestsOnly (boolean shouldCollectTest)
Bật hoặc tắt chế độ thu thập bài kiểm tra
setCollectsTestsShellTimeout
public void setCollectsTestsShellTimeout (int timeout)
Phương pháp này không được dùng nữa.
Phương pháp này là không hoạt động
Đặt thời gian tối đa tính bằng mili giây để cho phép 'thời gian tối đa phản hồi đầu ra shell' khi thu thập các bài kiểm tra.
Thông số | |
---|---|
timeout | int |
setConfiguration
public void setConfiguration (IConfiguration config)
Tiêm IConfiguration
đang sử dụng.
Thông số | |
---|---|
config | IConfiguration |
setCoverageTarget
public void setCoverageTarget (String coverageTarget)
Đặt mục tiêu bao phủ của thử nghiệm này.
Hiện tại chưa sử dụng. Phương thức này chỉ hiện diện nên có thể truy xuất CoverageTarget sau đó thông qua getCoverageTarget()
Thông số | |
---|---|
coverageTarget | String |
setDebug
public void setDebug (boolean debug)
Đặt cài đặt gỡ lỗi thiết bị.
Thông số | |
---|---|
debug | boolean : giá trị boolean để đặt cài đặt gỡ lỗi thiết bị đo đạc thành. |
bộThiết bị
public void setDevice (ITestDevice device)
Tiêm thiết bị đang được thử nghiệm.
Thông số | |
---|---|
device | ITestDevice : ITestDevice sẽ sử dụng |
setEnforceFormat
public void setEnforceFormat (boolean enforce)
Đặt Đúng nếu chúng tôi thực thi định dạng đầu ra AJUR của thiết bị đo đạc.
Thông số | |
---|---|
enforce | boolean |
setForceAbi
public void setForceAbi (String abi)
Đặt tùy chọn buộc-abi.
setInstallFile
public void setInstallFile (File installFile)
Đặt tệp tùy chọn để cài đặt có chứa các bài kiểm tra.
Thông số | |
---|---|
installFile | File : ERROR(/File) có thể cài đặt |
setIsolatedStorage
public void setIsolatedStorage (boolean isolatedStorage)
Đặt thời tiết hoặc không sử dụng bộ lưu trữ biệt lập.
Thông số | |
---|---|
isolatedStorage | boolean |
setMethodName
public void setMethodName (String testMethodName)
Tùy chọn, đặt phương pháp thử nghiệm để chạy.
Thông số | |
---|---|
testMethodName | String |
setMetricCollectors
public void setMetricCollectors (collectors)
Đặt danh sách IMetricCollector
được xác định cho lần chạy thử nghiệm.
Thông số | |
---|---|
collectors |
setPackageName
public void setPackageName (String packageName)
Đặt gói kê khai Android để chạy.
Thông số | |
---|---|
packageName | String |
setReRunUsingTestFile
public void setReRunUsingTestFile (boolean reRunUsingTestFile)
Đặt tùy chọn --rerun-from-file.
Thông số | |
---|---|
reRunUsingTestFile | boolean |
setRerunMode
public void setRerunMode (boolean rerun)
Tùy chọn, đặt chế độ chạy lại.
Thông số | |
---|---|
rerun | boolean |
setRunName
public void setRunName (String runName)
Đặt tên chạy thử nghiệm tùy chỉnh sẽ được cung cấp cho người nghe
Thông số | |
---|---|
runName | String |
setRunnerName
public void setRunnerName (String runnerName)
Tùy chọn đặt trình chạy thiết bị Android để sử dụng.
Thông số | |
---|---|
runnerName | String |
setShellTimeout
public void setShellTimeout (long timeout)
Tùy chọn đặt thời gian tối đa (tính bằng mili giây) mong đợi kết quả đầu ra từ thiết bị.
Thông số | |
---|---|
timeout | long |
setTestFilePathOnDevice
public void setTestFilePathOnDevice (String testFilePathOnDevice)
Tùy chọn, đặt đường dẫn đến một tệp nằm trên thiết bị phải chứa danh sách các lớp và phương thức kiểm tra được phân tách bằng dòng (định dạng: com.foo.Class#method) sẽ được chạy. Nếu được đặt, sẽ tự động thử chạy lại các thử nghiệm bằng cách sử dụng tệp thử nghiệm này thông qua InstrumentationFileTest thay vì thực thi các lệnh adb riêng biệt cho từng thử nghiệm còn lại thông qua chạy lại.
Thông số | |
---|---|
testFilePathOnDevice | String |
setTestPackageName
public void setTestPackageName (String testPackageName)
Đặt bộ lọc gói thử nghiệm.
Nếu không rỗng, chỉ các thử nghiệm trong gói java nhất định mới được thực thi.
Sẽ bị bỏ qua nếu giá trị khác null được cung cấp cho setClassName(String)
Thông số | |
---|---|
testPackageName | String |
setTestSize
public void setTestSize (String size)
Tùy chọn, đặt kích thước thử nghiệm để chạy.
Thông số | |
---|---|
size | String |
setTestTimeout
public void setTestTimeout (long timeout)
Tùy chọn, đặt thời gian tối đa (tính bằng mili giây) cho mỗi lần chạy thử riêng lẻ.
Thông số | |
---|---|
timeout | long |
setTestsToRun
public void setTestsToRun (tests)
Đặt tập hợp các thử nghiệm sẽ được thực hiện bởi InstrumentationTest này.
Thông số | |
---|---|
tests |
setWindowHoạt hình
public void setWindowAnimation (boolean windowAnimation)
Thông số | |
---|---|
windowAnimation | boolean |
Phương pháp được bảo vệ
loại trừKhông thực thi
protected staticexcludeNonExecuted (TestRunResult results)
Lọc ra "NOT_EXECUTED" nhằm mục đích theo dõi những gì cần chạy lại.
Thông số | |
---|---|
results | TestRunResult |
Trả lại | |
---|---|
lấy tên lớp
protected String getClassName ()
Lấy tên lớp để chạy.
Trả lại | |
---|---|
String |
getListInstrumentationParser
protected ListInstrumentationParser getListInstrumentationParser ()
Lấy ListInstrumentationParser
dùng để phân tích các truy vấn 'danh sách chiều'.
Trả lại | |
---|---|
ListInstrumentationParser |
getMethodName
protected String getMethodName ()
Lấy phương pháp thử nghiệm để chạy.
Trả lại | |
---|---|
String |
getTestPackageName
protected String getTestPackageName ()
Lấy gói java thử nghiệm để chạy.
Trả lại | |
---|---|
String |
tên truy vấnRunner
protected String queryRunnerName ()
Truy vấn thiết bị để người chạy thử sử dụng.
Trả lại | |
---|---|
String | tên người chạy thử đầu tiên khớp với gói hoặc null nếu chúng tôi không tìm thấy. |
Ném | |
---|---|
| com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
setRunnerArgs
protected void setRunnerArgs (IRemoteAndroidTestRunner runner)
Thông số | |
---|---|
runner | IRemoteAndroidTestRunner |