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

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

Các lớp con trực tiếp đã biết

AndroidJUnitTest , CodeCoverageTest

AndroidJUnitTest	Thử nghiệm chạy gói thử nghiệm thiết bị trên thiết bị nhất định bằng android.support.test.runner.AndroidJUnitRunner.
Mã Phạm vi kiểm tra	Thử nghiệm chạy gói thử nghiệm thiết bị 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ị 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 `IConfiguration` cho bài kiểm tra này.
`String`	`getCoverageTarget ()` Nhận mục tiêu bảo hiểm đã đặt trước đó qua `setCoverageTarget(String)` .
`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 `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ị đượ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 `IMetricCollector` s được xác định cho lần chạy thử nghiệm.
`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 `ListInstrumentationParser` được sử dụng để phân tích các truy vấn 'công cụ đo lường danh sách pm'.
`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ố

getAbi

public IAbi getAbi ()

trả lại
`IAbi`

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`

setAbi

public void setAbi (IAbi abi)

Thông số
`abi`	`IAbi`

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`	: các bài kiểm tra để chạy

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 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`

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`