InstrumentationTest

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

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

Một Kiểm thử chạy gói kiểm thử đo lường trên thiết bị đã cho.

Tóm tắt

Hằng số

String RUN_TESTS_AS_USER_KEY

String RUN_TESTS_ON_SDK_SANDBOX

Trường

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 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 kiểm thử đo lường.

IAbi getAbi()
IConfiguration getConfiguration()

Lấy IConfiguration cho bài kiểm thử này.

String getCoverageTarget()

Nhận 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()

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

String getRunName()

Lấy tên của quy trình 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ẽ được 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)

Bạn có thể đặ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 dữ liệu 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 là một thao tác không có hiệu lực

void setConfiguration(IConfiguration config)

Chèn IConfiguration đang 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)

Đặt 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 tôi thực thi định dạng đầu ra AJUR của hoạt động đo lường.

void setForceAbi(String abi)

Đặt lựa chọn force-abi.

void setInstallFile(File installFile)

Đặt tệp không bắt buộc để cài đặt có chứa các kiểm thử.

void setIsolatedStorage(boolean isolatedStorage)

Đặt xem có sử dụng bộ nhớ biệt lập hay không.

void setMethodName(String testMethodName)

Bạn có thể đặt phương thức kiểm thử để chạy.

void setMetricCollectors( collectors)

Đặt danh sách IMetricCollector được xác định cho lần chạy thử nghiệm.

void setOrchestrator(boolean useOrchestrator)

Đặt lựa chọn --orchestrator

void setPackageName(String packageName)

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

void setReRunUsingTestFile(boolean reRunUsingTestFile)

Đặt lựa chọn --rerun-from-file.

void setRerunMode(boolean rerun)

Bạn có thể đặt chế độ phát lại (không bắt buộc).

void setRunName(String runName)

Đặt tên cho lần chạy thử nghiệm tuỳ chỉnh sẽ được cung cấp cho trình nghe

void setRunnerName(String runnerName)

Bạn có thể đặ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) dự kiến đầu ra của 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 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 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 thử nghiệm riêng lẻ.

void setTestsToRun( tests)

Đặt tập hợp các kiểm thử mà InstrumentationTest này sẽ 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à Skipped (Đã 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".

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ị để tìm trình chạy kiểm thử cần dùng.

void setRunnerArgs(IRemoteAndroidTestRunner runner)

Hằng số

RUN_TESTS_AS_USER_KEY

public static final String RUN_TESTS_AS_USER_KEY

Giá trị không đổi: "RUN_TESTS_AS_USER"

RUN_TESTS_ON_SDK_SANDBOX

public static final String RUN_TESTS_ON_SDK_SANDBOX

Giá trị không đổi: "RUN_TESTS_ON_SDK_SANDBOX"

Trường

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 nhiều trình nghe tuỳ chỉnh 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 các 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 bài kiểm thử này.

Giá trị trả về
IConfiguration

getCoverageTarget

public String getCoverageTarget ()

Nhận 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 ()

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

Giá trị trả về
String

getRunName

public String getRunName ()

Lấy tên của quy trình 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ẽ được 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 bài kiểm thử.
listener ITestInvocationListener: ITestInvocationListener kết quả kiểm tra
Gửi
DeviceNotAvailableException

setAbi

public void setAbi (IAbi abi)

Tham số
abi IAbi

setClassName

public void setClassName (String testClassName)

Bạn có thể đặt tên lớp kiểm thử để chạy (không bắt buộc).

Tham số
testClassName String

setCollectTestsOnly

public void setCollectTestsOnly (boolean shouldCollectTest)

Bật hoặc tắt chế độ thu thập dữ liệu thử nghiệm

setCollectsTestsShellTimeout

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 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 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 để coverageTarget có thể được truy xuất sau đó thông qua getCoverageTarget()

Tham số
coverageTarget String

setDebug

public void setDebug (boolean debug)

Đặt 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 tôi 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 lựa chọn force-abi.

setInstallFile

public void setInstallFile (File installFile)

Đặt tệp không bắt buộc để cài đặt có chứa các kiểm thử.

Tham số
installFile File: ERROR(/File) có thể cài đặt

setIsolatedStorage

public void setIsolatedStorage (boolean isolatedStorage)

Đặt xem có sử dụng bộ nhớ biệt lập hay không.

Tham số
isolatedStorage boolean

setMethodName

public void setMethodName (String testMethodName)

Bạn có thể đặt phương thức kiểm thử để chạy.

Tham số
testMethodName String

setMetricCollectors

public void setMetricCollectors ( collectors)

Đặt danh sách IMetricCollector được xác định cho lần chạy thử nghiệm.

Tham số
collectors

setOrchestrator

public void setOrchestrator (boolean useOrchestrator)

Đặt lựa 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 lựa chọn --rerun-from-file.

Tham số
reRunUsingTestFile boolean

setRerunMode

public void setRerunMode (boolean rerun)

Bạn có thể đặt chế độ phát lại (không bắt buộc).

Tham số
rerun boolean

setRunName

public void setRunName (String runName)

Đặt tên cho lầ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)

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) dự kiến đầu ra của 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 bằng dòng (định dạng: com.foo.Class#method) sẽ được chạy. Nếu được đặt, sẽ tự động cố gắng chạy lại các 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 kiểm thử còn lại thông qua lệnh 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ác rỗng, chỉ những 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)

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 thử nghiệm riêng lẻ.

Tham số
timeout long

setTestsToRun

public void setTestsToRun ( tests)

Đặt tập hợp các kiểm thử mà InstrumentationTest này sẽ thực thi.

Tham số
tests : các 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à Skipped (Đã 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".

Giá trị trả về
ListInstrumentationParser

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ị để tìm trình chạy kiểm thử cần 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 giá trị 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