Google is committed to advancing racial equity for Black communities. See how.
本頁面由 Cloud Translation API 翻譯而成。
Switch to English

儀器測試

public class InstrumentationTest
extends Object implements IDeviceTest , IResumableTest , ITestCollector , IAbiReceiver , IInvocationContextReceiver , IMetricCollectorReceiver

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


在給定設備上運行儀器測試包的測試。

摘要

領域

protected boolean mDebug

公共建設者

InstrumentationTest ()

公開方法

void addDeviceListeners ( extraListeners) addDeviceListeners ( extraListeners)

允許向跑步者添加更多自定義偵聽器

void addInstrumentationArg (String key, String value)

添加參數以在運行測試時提供。

IAbi getAbi ()
String getCoverageTarget ()

獲取先前通過setCoverageTarget(String)設置的coverageTarget。

boolean getDebug ()

獲取檢測調試設置。

ITestDevice getDevice ()

獲取被測設備。

String getForceAbi ()
long getMaxTimeout ()

返回儀器的最大超時設置。

String getPackageName ()

獲取要運行的Android清單包。

String getRunName ()

獲取將提供給偵聽器的自定義測試運行名稱

String getRunnerName ()

獲取要使用的Android工具運行器。

boolean isResumable ()

void run ( ITestInvocationListener listener)

運行測試,並將結果報告給偵聽器。

void setAbi ( IAbi abi)
void setBugreportFrequency ( BugreportCollector.Freq freq)

設置測試失敗後自動收集錯誤報告的頻率。

void setClassName (String testClassName)

(可選)將測試類名稱設置為運行。

void setCollectTestsOnly (boolean shouldCollectTest)

啟用或禁用測試收集模式

void setCollectsTestsShellTimeout (int timeout)

不建議使用此方法。此方法不可操作

void setCoverageTarget (String coverageTarget)

設置此測試的覆蓋率目標。

void setDebug (boolean debug)

設置檢測調試設置。

void setDevice ( ITestDevice device)

注入被測設備。

void setEnforceFormat (boolean enforce)

如果我們強制執行工具的AJUR輸出格式,則設置True。

void setFallbackToSerialRerun (boolean reRunSerially)

設置--fallback-to-serial-rerun選項。

void setForceAbi (String abi)

設置force-abi選項。

void setInstallFile (File installFile)

設置要安裝的包含測試的可選文件。

void setInvocationContext ( IInvocationContext invocationContext)
void setIsolatedStorage (boolean isolatedStorage)

設置是否使用隔離存儲。

void setMethodName (String testMethodName)

(可選)將測試方法設置為運行。

void setMetricCollectors ( collectors) setMetricCollectors ( collectors)

設置為測試運行定義的IMetricCollector的列表。

void setPackageName (String packageName)

將Android清單包設置為運行。

void setReRunUsingTestFile (boolean reRunUsingTestFile)

設置--rerun-from-file選項。

void setRebootBeforeReRun (boolean rebootBeforeReRun)

設置--reboot-before-rerun選項。

void setRerunMode (boolean rerun)

(可選)設置重新運行模式。

void setResumeMode (boolean resume)

(可選)設置恢復模式。

void setRunName (String runName)

設置將提供給偵聽器的自定義測試運行名稱

void setRunnerName (String runnerName)

(可選)設置要使用的Android工具運行器。

void setShellTimeout (long timeout)

(可選)設置期望從設備輸出外殼程序的最長時間(以毫秒為單位)。

void setTestFilePathOnDevice (String testFilePathOnDevice)

(可選)將路徑設置為位於設備上的文件,該文件應包含要運行的以行分隔的測試類和方法(格式:com.foo.Class#method)的列表。

void setTestPackageName (String testPackageName)

設置測試包過濾器。

void setTestSize (String size)

(可選)將測試大小設置為運行。

void setTestTimeout (long timeout)

(可選)設置每個單獨的測試運行的最長時間(以毫秒為單位)。

void setTestsToRun ( tests) setTestsToRun ( tests)

設置應由此InstrumentationTest執行的測試的集合。

受保護的方法

String getClassName ()

獲取要運行的類名。

ListInstrumentationParser getListInstrumentationParser ()

獲取用於解析“ pm list instrumentation”查詢的ListInstrumentationParser

String getMethodName ()

獲取要運行的測試方法。

String getTestPackageName ()

獲取要運行的測試Java包。

String queryRunnerName ()

向設備查詢要使用的測試運行程序。

void setRunnerArgs (IRemoteAndroidTestRunner runner)

領域

mDebug

protected boolean mDebug

公共建設者

儀器測試

public InstrumentationTest ()

公開方法

addDeviceListeners

public void addDeviceListeners ( extraListeners)

允許向跑步者添加更多自定義偵聽器

參量
extraListeners

addInstrumentationArg

public void addInstrumentationArg (String key, 
                String value)

添加參數以在運行測試時提供。

參量
key String :參數名稱

value String :參數值

getAbi

public IAbi getAbi ()

退貨
IAbi

getCoverageTarget

public String getCoverageTarget ()

獲取先前通過setCoverageTarget(String)設置的coverageTarget。

退貨
String

getDebug

public boolean getDebug ()

獲取檢測調試設置。

退貨
boolean 布爾調試設置。

getDevice

public ITestDevice getDevice ()

獲取被測設備。

退貨
ITestDevice ITestDevice

getForceAbi

public String getForceAbi ()

退貨
String

getMaxTimeout

public long getMaxTimeout ()

返回儀器的最大超時設置。

退貨
long

getPackageName

public String getPackageName ()

獲取要運行的Android清單包。

退貨
String

getRunName

public String getRunName ()

獲取將提供給偵聽器的自定義測試運行名稱

退貨
String

getRunnerName

public String getRunnerName ()

獲取要使用的Android工具運行器。

退貨
String

isResumable

public boolean isResumable ()

退貨
boolean

public void run ( ITestInvocationListener listener)

運行測試,並將結果報告給偵聽器。

參量
listener ITestInvocationListener :測試結果的ITestInvocationListener

投擲
DeviceNotAvailableException

setAbi

public void setAbi ( IAbi abi)

參量
abi IAbi

setBugreportFrequency

public void setBugreportFrequency ( BugreportCollector.Freq freq)

設置測試失敗後自動收集錯誤報告的頻率。

請注意,測試運行程序和錯誤報告收集器之間沒有反饋機制,因此應謹慎使用EACH設置:如果大量連續快速發生故障,則可能會收集給定故障之一的錯誤報告發生相應故障後數十分鐘或幾小時。

參量
freq BugreportCollector.Freq

setClassName

public void setClassName (String testClassName)

(可選)將測試類名稱設置為運行。

參量
testClassName String

setCollectTestsOnly

public void setCollectTestsOnly (boolean shouldCollectTest)

啟用或禁用測試收集模式

setCollectsTestsShellTimeout

public void setCollectsTestsShellTimeout (int timeout)

不建議使用此方法。
此方法不可操作

設置最大時間(以毫秒為單位),以在收集測試時考慮“對外殼輸出響應的最大時間”。

參量
timeout int

setCoverageTarget

public void setCoverageTarget (String coverageTarget)

設置此測試的覆蓋率目標。

目前未使用。只是存在此方法,因此以後可以通過getCoverageTarget()檢索getCoverageTarget()

參量
coverageTarget String

setDebug

public void setDebug (boolean debug)

設置檢測調試設置。

參量
debug boolean :將檢測調試設置設置為的布爾值。

setDevice

public void setDevice ( ITestDevice device)

注入被測設備。

參量
device ITestDevice :要使用的ITestDevice

setEnforceFormat

public void setEnforceFormat (boolean enforce)

如果我們強制執行工具的AJUR輸出格式,則設置True。

參量
enforce boolean

setFallbackToSerialRerun

public void setFallbackToSerialRerun (boolean reRunSerially)

設置--fallback-to-serial-rerun選項。

參量
reRunSerially boolean

setForceAbi

public void setForceAbi (String abi)

設置force-abi選項。

setInstallFile

public void setInstallFile (File installFile)

設置要安裝的包含測試的可選文件。

參量
installFile File :可安裝的ERROR(/File)

setInvocationContext

public void setInvocationContext ( IInvocationContext invocationContext)

參量
invocationContext IInvocationContext

setIsolatedStorage

public void setIsolatedStorage (boolean isolatedStorage)

設置是否使用隔離存儲。

參量
isolatedStorage boolean

setMethodName

public void setMethodName (String testMethodName)

(可選)將測試方法設置為運行。

參量
testMethodName String

setMetricCollectors

public void setMetricCollectors ( collectors)

設置為測試運行定義的IMetricCollector的列表。

參量
collectors

setPackageName

public void setPackageName (String packageName)

將Android清單包設置為運行。

參量
packageName String

setReRunUsingTestFile

public void setReRunUsingTestFile (boolean reRunUsingTestFile)

設置--rerun-from-file選項。

參量
reRunUsingTestFile boolean

setRebootBeforeReRun

public void setRebootBeforeReRun (boolean rebootBeforeReRun)

設置--reboot-before-rerun選項。

參量
rebootBeforeReRun boolean

setRerunMode

public void setRerunMode (boolean rerun)

(可選)設置重新運行模式。

參量
rerun boolean

setResumeMode

public void setResumeMode (boolean resume)

(可選)設置恢復模式。

參量
resume boolean

setRunName

public void setRunName (String runName)

設置將提供給偵聽器的自定義測試運行名稱

參量
runName String

setRunnerName

public void setRunnerName (String runnerName)

(可選)設置要使用的Android工具運行器。

參量
runnerName String

setShellTimeout

public void setShellTimeout (long timeout)

(可選)設置期望從設備輸出外殼程序的最長時間(以毫秒為單位)。

參量
timeout long

setTestFilePathOnDevice

public void setTestFilePathOnDevice (String testFilePathOnDevice)

(可選)將路徑設置為位於設備上的文件,該文件應包含要運行的以行分隔的測試類和方法(格式:com.foo.Class#method)的列表。如果置位,將自動嘗試重新運行測試通過使用該測試文件InstrumentationFileTest而不是執行單獨的ADB命令用於經由每個剩餘測試InstrumentationSerialTest

參量
testFilePathOnDevice String

setTestPackageName

public void setTestPackageName (String testPackageName)

設置測試包過濾器。

如果為非null,則僅執行給定java包內的測試。

如果已將非空值提供給setClassName(String)將被忽略

參量
testPackageName String

setTestSize

public void setTestSize (String size)

(可選)將測試大小設置為運行。

參量
size String

setTestTimeout

public void setTestTimeout (long timeout)

(可選)設置每個單獨的測試運行的最長時間(以毫秒為單位)。

參量
timeout long

setTestsToRun

public void setTestsToRun ( tests)

設置應由此InstrumentationTest執行的測試的集合。

參量
tests :要運行的測試

受保護的方法

getClassName

protected String getClassName ()

獲取要運行的類名。

退貨
String

getListInstrumentationParser

protected ListInstrumentationParser getListInstrumentationParser ()

獲取用於解析“ pm list instrumentation”查詢的ListInstrumentationParser

退貨
ListInstrumentationParser

getMethodName

protected String getMethodName ()

獲取要運行的測試方法。

退貨
String

getTestPackageName

protected String getTestPackageName ()

獲取要運行的測試Java包。

退貨
String

queryRunnerName

protected String queryRunnerName ()

向設備查詢要使用的測試運行程序。

退貨
String 與軟件包匹配的第一個測試跑步者名稱;如果找不到,則為null。

投擲
DeviceNotAvailableException

setRunnerArgs

protected void setRunnerArgs (IRemoteAndroidTestRunner runner)

參量
runner IRemoteAndroidTestRunner