Thiết Bị Kiểm Tra
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ị 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 công cộng | |
---|---|
InstrumentationTest () |
Phương thức công khai | |
---|---|
void | addDeviceListeners ( extraListeners) addDeviceListeners ( extraListeners) Cho phép thêm nhiều người nghe tùy chỉnh vào người chạy |
void | addInstrumentationArg (String key, String value) Thêm đối số để cung cấp khi chạy thử nghiệm thiết bị. |
IAbi | getAbi () |
IConfiguration | getConfiguration () Nhận |
String | getCoverageTarget () Nhận mục tiêu bảo hiểm đã đặt trước đó qua |
boolean | getDebug () Nhận cài đặt gỡ lỗi thiết bị. |
ITestDevice | getDevice () Nhận thiết bị được kiểm tra. |
String | getForceAbi () |
long | getMaxTimeout () Trả về thời gian chờ tối đa đã đặt cho thiết bị. |
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 thử nghiệm để chạy. |
void | setCollectTestsOnly (boolean shouldCollectTest) Bật hoặc tắt chế độ thu bài kiểm tra |
void | setCollectsTestsShellTimeout (int timeout) Phương pháp này không được chấp nhận. Phương pháp này là một no-op |
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ị được kiểm tra. |
void | setEnforceFormat (boolean enforce) Đặt True nếu chúng tôi thực thi định dạng đầu ra AJUR của thiết bị. |
void | setForceAbi (String abi) Đặt tùy chọn force-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ữ bị cô lập. |
void | setMethodName (String testMethodName) Tùy chọn, thiết lập phương pháp kiểm tra để 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 đầu ra trình bao từ thiết bị. |
void | setTestFilePathOnDevice (String testFilePathOnDevice) Theo tùy chọn, hãy đặt đường dẫn đến một tệp nằm trên thiết bị 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ử nghiệm riêng lẻ. |
void | setTestsToRun ( tests) setTestsToRun ( tests) Đặt bộ sưu tậ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 () Nhận |
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 công cộng
Thiết Bị Kiểm Tra
public InstrumentationTest ()
Phương thức công khai
addDeviceListeners
public void addDeviceListeners (extraListeners)
Cho phép thêm nhiều người nghe tùy chỉnh vào người chạy
Thông số | |
---|---|
extraListeners |
addInstrumentationArg
public void addInstrumentationArg (String key, String value)
Thêm đối số để cung cấp khi chạy thử nghiệm thiết bị.
Thông số | |
---|---|
key | String : tên đối số |
value | String : giá trị đối số |
nhận cấu hình
public IConfiguration getConfiguration ()
Nhận IConfiguration
cho bài kiểm tra này.
trả lại | |
---|---|
IConfiguration |
getCoverageTarget
public String getCoverageTarget ()
Nhận mục tiêu bảo hiểm đã đặt trước đó qua setCoverageTarget(String)
.
trả lại | |
---|---|
String |
getDebug
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. |
getDevice
public ITestDevice getDevice ()
Nhận thiết bị được kiểm tra.
trả lại | |
---|---|
ITestDevice | ITestDevice |
getForceAbi
public String getForceAbi ()
trả lại | |
---|---|
String |
getMaxTimeout
public long getMaxTimeout ()
Trả về thời gian chờ tối đa đã đặt cho thiết bị.
trả lại | |
---|---|
long |
getPackageName
public String getPackageName ()
Tải gói kê khai Android để chạy.
trả lại | |
---|---|
String |
getRunName
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 thử nghiệm để chạy.
Thông số | |
---|---|
testClassName | String |
setCollectTestsOnly
public void setCollectTestsOnly (boolean shouldCollectTest)
Bật hoặc tắt chế độ thu bài kiểm tra
setCollectsTestsShellTimeout
public void setCollectsTestsShellTimeout (int timeout)
Phương pháp này không được chấp nhận.
Phương pháp này là một no-op
Đặ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 của shell' khi thu thập các bài kiểm tra.
Thông số | |
---|---|
timeout | int |
thiết lập cấu hình
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 chưa sử dụng. Phương thức này chỉ xuất hiện nên sau này có thể truy xuất CoverageTarget 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ị thành. |
thiết bị
public void setDevice (ITestDevice device)
Tiêm thiết bị được kiểm tra.
Thông số | |
---|---|
device | ITestDevice : ITestDevice để sử dụng |
setEnforceFormat
public void setEnforceFormat (boolean enforce)
Đặt True nếu chúng tôi thực thi định dạng đầu ra AJUR của thiết bị.
Thông số | |
---|---|
enforce | boolean |
setForceAbi
public void setForceAbi (String abi)
Đặt tùy chọn force-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) |
setBiệt lậpStorage
public void setIsolatedStorage (boolean isolatedStorage)
Đặt thời tiết hoặc không sử dụng bộ lưu trữ bị cô lập.
Thông số | |
---|---|
isolatedStorage | boolean |
setMethodName
public void setMethodName (String testMethodName)
Tùy chọn, thiết lập phương pháp kiểm tra để chạy.
Thông số | |
---|---|
testMethodName | String |
setMetricCollector
public void setMetricCollectors (collectors)
Đặt danh sách IMetricCollector
s đượ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 đầu ra trình bao từ thiết bị.
Thông số | |
---|---|
timeout | long |
setTestFilePathOnDevice
public void setTestFilePathOnDevice (String testFilePathOnDevice)
Theo tùy chọn, hãy đặt đường dẫn đến một tệp nằm trên thiết bị 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 phải là null, chỉ các kiểm tra trong gói java đã cho mới được thực thi.
Sẽ bị bỏ qua nếu một 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ử nghiệm riêng lẻ.
Thông số | |
---|---|
timeout | long |
setTestsToRun
public void setTestsToRun (tests)
Đặt bộ sưu tập các thử nghiệm sẽ được thực hiện bởi InstrumentationTest này.
Thông số | |
---|---|
tests |
setWindowAnimation
public void setWindowAnimation (boolean windowAnimation)
Thông số | |
---|---|
windowAnimation | boolean |
phương pháp được bảo vệ
loại trừKhông được thực hiện
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 | |
---|---|
getClassName
protected String getClassName ()
Lấy tên lớp để chạy.
trả lại | |
---|---|
String |
getListInstrumentationParser
protected ListInstrumentationParser getListInstrumentationParser ()
Nhận ListInstrumentationParser
được sử dụng để phân tích các truy vấn 'công cụ đo lường danh sách pm'.
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 |
queryRunnerName
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ử nghiệm đầu tiên khớp với gói hoặc null nếu chúng tôi không tìm thấy tên nào. |
ném | |
---|---|
| com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
setRunnerArgs
protected void setRunnerArgs (IRemoteAndroidTestRunner runner)
Thông số | |
---|---|
runner | IRemoteAndroidTestRunner |