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

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