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

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