InstrumentationTest

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

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

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

---

Thử nghiệm chạy gói thử nghiệm thiết bị đo 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

Các nhà xây dựng công cộng
InstrumentationTest ()

Phương pháp công khai
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 một đối số để cung cấp khi chạy các bài kiểm tra thiết bị đo đạc.
IAbi	getAbi ()
IConfiguration	getConfiguration () Nhận cấu hình IConfiguration cho bài kiểm tra này.
String	getCoverageTarget () Nhận mục tiêu được đặt trước đó thông qua setCoverageTarget(String) .
boolean	getDebug () Nhận cài đặt gỡ lỗi thiết bị.
ITestDevice	getDevice () Lấy thiết bị đang kiểm tra.
String	getForceAbi ()
long	getMaxTimeout () Trả về thời gian chờ tối đa đã đặt cho thiết bị đo.
String	getPackageName () Lấy gói tệp kê khai Android để chạy.
String	getRunName () Lấy 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 các bài kiểm tra và báo cáo kết quả cho người nghe.
void	setAbi ( IAbi abi)
void	setClassName (String testClassName) Theo 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 thập thử nghiệm
void	setCollectsTestsShellTimeout (int timeout) Phương pháp này không được dùng nữa. Phương pháp này không phải là lựa chọn
void	setConfiguration ( IConfiguration config) IConfiguration đang sử dụng.
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 thử nghiệm.
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ị đo đạc.
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 máy làm ướt hoặc không sử dụng kho cách ly.
void	setMethodName (String testMethodName) Theo tùy chọn, đặt phương pháp thử nghiệm để chạy.
void	setMetricCollectors ( collectors) setMetricCollectors ( collectors) Đặt danh sách IMetricCollector được xác định để chạy thử nghiệm.
void	setPackageName (String packageName) Đặt gói tệp kê khai Android để chạy.
void	setReRunUsingTestFile (boolean reRunUsingTestFile) Đặt tùy chọn --rerun-from-file.
void	setRerunMode (boolean rerun) Theo 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) Theo tùy chọn, đặt trình chạy thiết bị Android để sử dụng.
void	setShellTimeout (long timeout) Theo 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, đặt đường dẫn đến 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 theo dòng (định dạng: phương thức com.foo.Class #) sẽ được chạy.
void	setTestPackageName (String testPackageName) Đặt bộ lọc gói thử nghiệm.
void	setTestSize (String size) Theo tùy chọn, đặt kích thước thử nghiệm để chạy.
void	setTestTimeout (long timeout) Theo 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 bài kiểm tra sẽ được thực hiện bởi InstrumentationTest này.
void	setWindowAnimation (boolean windowAnimation)

Các 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 ListInstrumentationParser được sử dụng để phân tích cú pháp các truy vấn 'pm list thiết bị đo đạc'.
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

Các nhà xây dựng công cộng

InstrumentationTest

public InstrumentationTest ()

Phương pháp công khai

addDeviceListaries

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

addIricalmentationArg

public void addInstrumentationArg (String key, 
                String value)

Thêm một đối số để cung cấp khi chạy các bài kiểm tra thiết bị đo đạc.

Thông số
key	String : tên đối số
value	String : giá trị đối số

getAbi

public IAbi getAbi ()

Lợi nhuận
IAbi

getConfiguration

public IConfiguration getConfiguration ()

Nhận cấu hình IConfiguration cho bài kiểm tra này.

Lợi nhuận
IConfiguration

getCoverageTarget

public String getCoverageTarget ()

Nhận mục tiêu được đặt trước đó thông qua setCoverageTarget(String) .

Lợi nhuận
String

getDebug

public boolean getDebug ()

Nhận cài đặt gỡ lỗi thiết bị.

Lợi nhuận
boolean	Cài đặt gỡ lỗi boolean.

getDevice

public ITestDevice getDevice ()

Lấy thiết bị đang kiểm tra.

Lợi nhuận
ITestDevice	ITestDevice

getForceAbi

public String getForceAbi ()

Lợi nhuận
String

getMaxTimeout

public long getMaxTimeout ()

Trả về thời gian chờ tối đa đã đặt cho thiết bị đo.

Lợi nhuận
long

getPackageName

public String getPackageName ()

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

Lợi nhuận
String

getRunName

public String getRunName ()

Lấy tên chạy thử nghiệm tùy chỉnh sẽ được cung cấp cho người nghe

Lợi nhuận
String

getRunnerName

public String getRunnerName ()

Sử dụng trình chạy thiết bị Android.

Lợi nhuận
String

chạy

public void run (TestInformation testInfo, 
                ITestInvocationListener listener)

Chạy các bài kiểm tra 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 các bài kiểm tra.
listener	ITestInvocationListener : ITestInvocationListener kết quả kiểm tra

Ném
DeviceNotAvailableException

setAbi

public void setAbi (IAbi abi)

Thông số
abi	IAbi

setClassName

public void setClassName (String testClassName)

Theo 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 thập thử nghiệm

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 không phải là lựa chọn

Đặ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 trình bao' khi thu thập các bài kiểm tra.

Thông số
timeout	int

setConfiguration

public void setConfiguration (IConfiguration config)

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ỉ mới hiện diện nên có thể truy xuất sau đó coverTarget 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 thành.

setDevice

public void setDevice (ITestDevice device)

Tiêm thiết bị đang thử nghiệm.

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ị đo đạc.

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)

setIsolatedStorage

public void setIsolatedStorage (boolean isolatedStorage)

Đặt máy làm ướt hoặc không sử dụng kho cách ly.

Thông số
isolatedStorage	boolean

setMethodName

public void setMethodName (String testMethodName)

Theo 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 để chạy thử nghiệm.

Thông số
collectors

setPackageName

public void setPackageName (String packageName)

Đặt gói tệp 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)

Theo 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)

Theo 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)

Theo 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, đặt đường dẫn đến 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 theo dòng (định dạng: phương thức com.foo.Class #) sẽ được chạy. Nếu được đặt, sẽ tự động cố gắng chạy lại các thử nghiệm bằng tệp thử nghiệm này qua InstrumentationFileTest thay vì thực hiện 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 null, chỉ các bài kiểm tra trong gói java đã cho sẽ được thực thi.

Sẽ bị bỏ qua nếu một giá trị không phải null đã được cung cấp cho setClassName(String)

Thông số
testPackageName	String

setTestSize

public void setTestSize (String size)

Theo 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)

Theo 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 bài kiểm tra sẽ được thực hiện bởi InstrumentationTest này.

Thông số
tests	: các bài kiểm tra để chạy

setWindowAnimation

public void setWindowAnimation (boolean windowAnimation)

Thông số
windowAnimation	boolean

Các phương pháp được bảo vệ

loại trừ

protected 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.

Thông số
results	TestRunResult

Lợi nhuận

getClassName

protected String getClassName ()

Lấy tên lớp để chạy.

Lợi nhuận
String

getListIricalmentationParser

protected ListInstrumentationParser getListInstrumentationParser ()

Lấy ListInstrumentationParser được sử dụng để phân tích cú pháp các truy vấn 'pm list thiết bị đo đạc'.

Lợi nhuận
ListInstrumentationParser

getMethodName

protected String getMethodName ()

Lấy phương pháp thử nghiệm để chạy.

Lợi nhuận
String

getTestPackageName

protected String getTestPackageName ()

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

Lợi nhuận
String

queryRunnerName

protected String queryRunnerName ()

Truy vấn thiết bị để người chạy thử sử dụng.

Lợi nhuận
String	tên người chạy thử nghiệm đầu tiên phù hợp với gói hoặc null nếu chúng tôi không tìm thấy bất kỳ tên nào.

Ném
DeviceNotAvailableException

setRunnerArgs

protected void setRunnerArgs (IRemoteAndroidTestRunner runner)

Thông số
runner	IRemoteAndroidTestRunner