Kiểm thử đo lường

public class InstrumentationTest
extends Object implements IAbiReceiver, IConfigurationReceiver, IDeviceTest, IMetricCollectorReceiver, IRemoteTest, ITestCollector

java.lang.Object
↳	com.android.tradefed.testtype.InstrumentationTest

Các lớp con trực tiếp đã biết AndroidJUnitTest, CodeCoverageTest AndroidJUnitTest Một bài kiểm thử chạy gói kiểm thử đo lường trên một thiết bị nhất định bằng cách sử dụng android.support.test.runner.AndroidJUnitRunner.  CodeCoverageTest Kiểm thử chạy một gói kiểm thử đo lường trên một thiết bị nhất định và tạo báo cáo mức độ sử dụng mã.

---

Kiểm thử chạy một 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( extraListeners) Cho phép thêm nhiều trình nghe tuỳ chỉnh hơn 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 IConfiguration cho chương trình kiểm thử này.
String	getCoverageTarget() Lấy phạm vi bao phủ đã đặt trước đó qua setCoverageTarget(String).
boolean	getDebug() Lấy chế độ cài đặt gỡ lỗi đo lường.
ITestDevice	getDevice() Tải thiết bị đang được kiểm tra.
String	getForceAbi()
long	getMaxTimeout() Trả về thời gian chờ tối đa đã đặt cho khả năng đo lường.
String	getPackageName() Tải gói tệp kê khai Android để chạy.
String	getRunName() Lấy tên chạy thử nghiệm 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ẽ được sử dụng.
boolean	isOrchestrator() Trả về giá trị của ERROR(InstrumentationTest#mOrchestrator/com.android.tradefed.testtype.InstrumentationTest#mOrchestrator InstrumentationTest#mOrchestrator)
void	run(TestInformation testInfo, ITestInvocationListener listener) Chạy chương trình kiểm thử rồi báo cáo kết quả cho trình nghe.
void	setAbi(IAbi abi)
void	setClassName(String testClassName) Đặt tên lớp kiểm thử để chạy (không bắt buộc).
void	setCollectTestsOnly(boolean shouldCollectTest) Bật hoặc tắt chế độ thu thập thử nghiệm
void	setCollectsTestsShellTimeout(int timeout) Phương thức này không được dùng nữa. Phương thức này không hoạt động
void	setConfiguration(IConfiguration config) Chèn IConfiguration đang sử dụng.
void	setCoverageTarget(String coverageTarget) Đặt mục tiêu mức độ sử dụng 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 là True nếu chúng ta thực thi định dạng đầu ra AJUR của công cụ đo lường.
void	setForceAbi(String abi) Đặt tuỳ chọn force-abi.
void	setInstallFile(File installFile) Thiết lập tệp không bắt buộc cần cài đặt có chứa các bài kiểm thử.
void	setIsolatedStorage(boolean isolatedStorage) Đặt hoặc không sử dụng bộ nhớ riêng biệt.
void	setMethodName(String testMethodName) Đặt phương thức kiểm thử để chạy (không bắt buộc).
void	setMetricCollectors( collectors) Thiết lập danh sách IMetricCollector được xác định cho lần chạy kiểm thử.
void	setOrchestrator(boolean useOrchestrator) Đặt tuỳ chọn --orchestrator
void	setPackageName(String packageName) Thiết lập để gói tệp kê khai Android chạy.
void	setReRunUsingTestFile(boolean reRunUsingTestFile) Thiết lập tuỳ chọn --rerun-from-file.
void	setRerunMode(boolean rerun) Đặt chế độ chạy lại (không bắt buộc).
void	setRunName(String runName) Đặt tên chạy thử nghiệm tuỳ chỉnh sẽ được cung cấp cho trình nghe
void	setRunnerName(String runnerName) Đặt trình chạy đo lường Android để sử dụng (không bắt buộc).
void	setShellTimeout(long timeout) Nếu muốn, hãy đặt thời gian tối đa (tính bằng mili giây) mong đợi đầu ra shell từ thiết bị.
void	setTestFilePathOnDevice(String testFilePathOnDevice) (Không bắt buộc) Thiết lập đường dẫn đến một tệp nằm trên thiết bị có chứa danh sách dòng riêng các lớp và phương thức kiểm thử (định dạng: com.foo.Class#method) để chạy.
void	setTestPackageName(String testPackageName) Thiết lập bộ lọc cho gói thử nghiệm.
void	setTestSize(String size) Đặt kích thước kiểm thử để chạy (không bắt buộc).
void	setTestTimeout(long timeout) Nếu muốn, hãy đặt thời gian tối đa (tính bằng mili giây) cho từng lần chạy kiểm thử.
void	setTestsToRun( tests) Thiết lập tập hợp kiểm thử sẽ được thực thi bằng công cụ InstrumentationTest này.
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 nội dung cần chạy lại.
String	getClassName() Lấy tên lớp để chạy.
ListInstrumentationParser	getListInstrumentationParser() Lấy ListInstrumentationParser dùng để phân tích cú pháp "đo lường danh sách pm" truy vấn.
String	getMethodName() Lấy phương thức kiểm thử để chạy.
String	getTestPackageName() Lấy gói kiểm thử java để chạy.
String	queryRunnerName() Truy vấn thiết bị để trình chạy kiểm thử sử dụng.
void	setRunnerArgs(IRemoteAndroidTestRunner runner)

Trường

RUN_THỬ NGHIỆM_AS_USER_KEY

public static final String RUN_TESTS_AS_USER_KEY

CHẠY_KIỂM TRA_ĐẾN_SDK_SAND_HỘP

public static final String RUN_TESTS_ON_SDK_SANDBOX

gỡ lỗi

protected boolean mDebug

mInstrumentSdkTrong Hộp cát

protected boolean mInstrumentSdkInSandbox

Hộp cát mInstrumentSdk

protected boolean mInstrumentSdkSandbox

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

Kiểm thử đo lường

public InstrumentationTest ()

Phương thức công khai

addDeviceListeners

public void addDeviceListeners ( extraListeners)

Cho phép thêm nhiều trình nghe tuỳ chỉnh hơn 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ố

getAbi

public IAbi getAbi ()

Giá trị trả về
IAbi

nhận cấu hình

public IConfiguration getConfiguration ()

Lấy IConfiguration cho chương trình kiểm thử này.

Giá trị trả về
IConfiguration

Mục tiêu phạm vi bao phủ

public String getCoverageTarget ()

Lấy phạm vi bao phủ đã đặt trước đó 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 ()

Tải thiết bị đang được kiểm tra.

Giá trị trả về
ITestDevice	ITestDevice

getForceAbi

public String getForceAbi ()

Giá trị trả về
String

nhận thời gian chờ tối đa

public long getMaxTimeout ()

Trả về thời gian chờ tối đa đã đặt cho khả năng đo lường.

Giá trị trả về
long

getPackageName

public String getPackageName ()

Tải gói tệp kê khai Android để chạy.

Giá trị trả về
String

getRunName

public String getRunName ()

Lấy tên chạy thử nghiệm 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ẽ được sử dụng.

Giá trị trả về
String

phối lại

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 chương trình kiểm thử rồi 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 kiểm thử.
listener	ITestInvocationListener: ITestInvocationListener của kết quả thử nghiệm

Gửi
DeviceNotAvailableException

setAbi

public void setAbi (IAbi abi)

Tham số
abi	IAbi

setClassName

public void setClassName (String testClassName)

Đặt tên lớp kiểm thử để chạy (không bắt buộc).

Tham số
testClassName	String

Chỉ setcollectionTests

public void setCollectTestsOnly (boolean shouldCollectTest)

Bật hoặc tắt chế độ thu thập thử nghiệm

setThusTestsShellHết thời gian chờ

public void setCollectsTestsShellTimeout (int timeout)

Phương thức này không được dùng nữa.
Phương thức này 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 kiểm thử.

Tham số
timeout	int

Cấu hình đặt

public void setConfiguration (IConfiguration config)

Chèn IConfiguration đang sử dụng.

Tham số
config	IConfiguration

set bao phủ mục tiêu

public void setCoverageTarget (String coverageTarget)

Đặt mục tiêu mức độ sử dụng 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 để CoverageTarget có thể được truy xuất sau đó 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 thành.

thiết lập thiết bị

public void setDevice (ITestDevice device)

Chèn thiết bị đang được kiểm thử.

Tham số
device	ITestDevice: ITestDevice để sử dụng

Đặt Thực thi Định dạng

public void setEnforceFormat (boolean enforce)

Đặt là True nếu chúng ta thực thi định dạng đầu ra AJUR của công cụ đo lường.

Tham số
enforce	boolean

Thiết lập Lực lượng Hành động

public void setForceAbi (String abi)

Đặt tuỳ chọn force-abi.

setInstallFile

public void setInstallFile (File installFile)

Thiết lập tệp không bắt buộc cần cài đặt có chứa các bài kiểm thử.

Tham số
installFile	File: ERROR(/File) có thể cài đặt

setIsolatedStorage

public void setIsolatedStorage (boolean isolatedStorage)

Đặt hoặc không sử dụng bộ nhớ riêng biệt.

Tham số
isolatedStorage	boolean

setMethodName

public void setMethodName (String testMethodName)

Đặt phương thức kiểm thử để chạy (không bắt buộc).

Tham số
testMethodName	String

setMetricCollectionor

public void setMetricCollectors ( collectors)

Thiết lập danh sách IMetricCollector được xác định cho lần chạy kiểm thử.

Tham số
collectors

thiết lập

public void setOrchestrator (boolean useOrchestrator)

Đặt tuỳ chọn --orchestrator

Tham số
useOrchestrator	boolean

setPackageName

public void setPackageName (String packageName)

Thiết lập để gói tệp kê khai Android chạy.

Tham số
packageName	String

setReRunUsageTestFile

public void setReRunUsingTestFile (boolean reRunUsingTestFile)

Thiết lập tuỳ chọn --rerun-from-file.

Tham số
reRunUsingTestFile	boolean

setRerunMode

public void setRerunMode (boolean rerun)

Đặ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 thử nghiệm tuỳ chỉnh sẽ được cung cấp cho trình nghe

Tham số
runName	String

setRunnerName

public void setRunnerName (String runnerName)

Đặt trình chạy đo lường Android để sử dụng (không bắt buộc).

Tham số
runnerName	String

setShellHết thời gian chờ

public void setShellTimeout (long timeout)

Nếu muốn, hãy đặt thời gian tối đa (tính bằng mili giây) mong đợi đầu ra shell từ thiết bị.

Tham số
timeout	long

setTestFilePathOnDevice

public void setTestFilePathOnDevice (String testFilePathOnDevice)

(Không bắt buộc) Thiết lập đường dẫn đến một tệp nằm trên thiết bị có chứa danh sách dòng riêng các lớp và phương thức kiểm thử (định dạng: com.foo.Class#method) để chạy. Nếu được đặt, sẽ tự động cố gắng chạy lại các kiểm thử bằng cách sử dụ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 kiểm thử còn lại thông qua hoạt động chạy lại.

Tham số
testFilePathOnDevice	String

setTestPackageName

public void setTestPackageName (String testPackageName)

Thiết lập bộ lọc cho gói thử nghiệm.

Nếu giá trị không có giá trị rỗng, chỉ các lượt 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 một giá trị không rỗng cho setClassName(String)

Tham số
testPackageName	String

setTestSize

public void setTestSize (String size)

Đặt kích thước kiểm thử để chạy (không bắt buộc).

Tham số
size	String

Thời gian chờ setTest

public void setTestTimeout (long timeout)

Nếu muốn, hãy đặt thời gian tối đa (tính bằng mili giây) cho từng lần chạy kiểm thử.

Tham số
timeout	long

setTestsToRun

public void setTestsToRun ( tests)

Thiết lập tập hợp kiểm thử sẽ được thực thi bằng công cụ InstrumentationTest này.

Tham số
tests	: các bài kiểm thử cần chạy

setWindowAnimation

public void setWindowAnimation (boolean windowAnimation)

Tham số
windowAnimation	boolean

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

loại trừKhông thực thi

protected static  excludeNonExecuted (TestRunResult results)

Lọc ra "NOT_EXECUTED" và Bỏ qua để theo dõi nội dung 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 "đo lường danh sách pm" truy vấn.

Giá trị trả về
ListInstrumentationParser

phương thức getMethodName

protected String getMethodName ()

Lấy phương thức kiểm thử để chạy.

Giá trị trả về
String

getTestPackageName

protected String getTestPackageName ()

Lấy gói kiểm thử java để chạy.

Giá trị trả về
String

queryRunnerName

protected String queryRunnerName ()

Truy vấn thiết bị để trình chạy kiểm thử 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 tôi không tìm thấy giá trị nào.

Gửi
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

setRunnerArgs

protected void setRunnerArgs (IRemoteAndroidTestRunner runner)

Tham số
runner	IRemoteAndroidTestRunner