Google cam kết thúc đẩy công bằng chủng tộc cho Cộng đồng người da đen. Xem cách thực hiện.

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

InstrumentationTest

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 quy trình 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	Một quy trình kiểm thử chạy 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ã.

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( extraListeners)` 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 `IConfiguration` cho kiểm thử này.
`String`	`getCoverageTarget()` Lấy coverageTarget đã đặt trước đó thông qua `setCoverageTarget(String)`.
`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 `ERROR(InstrumentationTest.mOrchestrator/com.android.tradefed.testtype.InstrumentationTest#mOrchestrator InstrumentationTest.mOrchestrator)`
`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 `IConfiguration` đang được sử dụng.
`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( collectors)` Đặt 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)` Đặ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( tests)` Đặ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 `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).
`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ố

getAbi

public IAbi getAbi ()

Giá trị trả về
`IAbi`

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`

setAbi

public void setAbi (IAbi abi)

Tham số
`abi`	`IAbi`

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`	: các chương trình 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ệ

excludeNonExecuted

protected static  excludeNonExecuted (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`