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