Trang này được dịch bởi Cloud Translation API.

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`