本頁面由 Cloud Translation API 翻譯而成。

UiAutomatorTest

public class UiAutomatorTest
extends Object implements IDeviceTest, IRemoteTest, ITestFilterReceiver

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

摘要

欄位
`protected`	`mListeners`

公用建構函式
`UiAutomatorTest()`

公用方法
`void`	`addAllExcludeFilters( filters)` 新增要排除測試的篩選器 `ERROR(/Set)`。
`void`	`addAllIncludeFilters( filters)` 新增要納入測試的篩選器 `ERROR(/Set)`。
`void`	`addClassName(String className)` 新增要執行的測試類別名稱。
`void`	`addClassNames( classNames)` 新增要執行的測試類別名稱集合。
`void`	`addExcludeFilter(String filter)` 新增篩選器，篩選出要排除的測試。
`void`	`addIncludeFilter(String filter)` 新增篩選器，選取要納入的測試。
`void`	`addRunArg(String key, String value)` 新增執行 UI Automator 測試時提供的引數
`void`	`clearExcludeFilters()` 刪除目前追蹤的所有「排除」篩選器。
`void`	`clearIncludeFilters()` 刪除目前追蹤的所有「包含」篩選器。
	`getClassNames()` 取得設定要執行的測試類別名稱清單
`ITestDevice`	`getDevice()` 取得要測試的裝置。
	`getExcludeFilters()` 傳回目前 `ERROR(/Set)` 的「排除」篩選器。
	`getIncludeFilters()` 傳回「包含」篩選器的目前 `ERROR(/Set)`。
`long`	`getSyncTime()`
	`getTestJarPaths()`
	`getTestRunArgMap()`
`IRemoteAndroidTestRunner`	`getTestRunner()`
`boolean`	`isInstrumentationTest()`
`void`	`run(TestInformation testInfo, ITestInvocationListener listener)` 執行測試，並將結果回報給事件監聽器。
`void`	`setCaptureLogs(boolean captureLogs)` 此方法已淘汰。請改用 `setLoggingOption(com.android.tradefed.testtype.UiAutomatorTest.LoggingOption)`。保留與 cts-tradefed 的相容性
`void`	`setDevice(ITestDevice device)` 插入要測試的裝置。
`void`	`setLoggingOption(UiAutomatorTest.LoggingOption loggingOption)`
`void`	`setRunName(String runName)`
`void`	`setRunnerName(String runnerName)`
`void`	`setSyncTime(long syncTime)`
`void`	`setTestJarPaths( jarPaths)`
`void`	`setTestRunArgMap( runArgMap)`

保護方法
`IRemoteAndroidTestRunner`	`createTestRunner()`
`IRunUtil`	`getRunUtil()`
`void`	`onScreenshotAndBugreport(ITestDevice device, ITestInvocationListener listener, String prefix, UiAutomatorTest.TestFailureAction overrideAction)`
`void`	`onScreenshotAndBugreport(ITestDevice device, ITestInvocationListener listener, String prefix)`
`void`	`preTestSetup()` 檢查裝置上是否出現 UI Automator 元件

欄位

mListener

protected  mListeners

公用建構函式

UiAutomatorTest

public UiAutomatorTest ()

公用方法

加入所有排除篩選器

public void addAllExcludeFilters ( filters)

新增要排除測試的篩選器 ERROR(/Set)。

參數
`filters`

加入所有篩選器

public void addAllIncludeFilters ( filters)

新增要納入測試的篩選器 ERROR(/Set)。

參數
`filters`

addClassName

public void addClassName (String className)

新增要執行的測試類別名稱。

參數
`className`	`String`

addClassNames

public void addClassNames ( classNames)

新增要執行的測試類別名稱集合。

參數
`classNames`

新增排除篩選器

public void addExcludeFilter (String filter)

新增篩選器，篩選出要排除的測試。

參數
`filter`	`String`

加入篩選器

public void addIncludeFilter (String filter)

新增篩選器，選取要納入的測試。

參數
`filter`	`String`

addRunArg

public void addRunArg (String key, 
                String value)

新增執行 UI Automator 測試時提供的引數

參數
`key`	`String`：引數名稱
`value`	`String`：引數值

清除排除篩選器

public void clearExcludeFilters ()

刪除目前追蹤的所有「排除」篩選器。

ClearIncludeFilters

public void clearIncludeFilters ()

刪除目前追蹤的所有「包含」篩選器。

getClassNames

public  getClassNames ()

取得設定要執行的測試類別名稱清單

傳回
	測試類別名稱清單

getDevice

public ITestDevice getDevice ()

取得要測試的裝置。

傳回
`ITestDevice`	`ITestDevice`

取得排除篩選器

public  getExcludeFilters ()

傳回目前 ERROR(/Set) 的「排除」篩選器。

傳回

getIncludeFilters

public  getIncludeFilters ()

傳回「包含」篩選器的目前 ERROR(/Set)。

傳回

getSyncTime

public long getSyncTime ()

傳回
`long`	則要決定系統同步處理測試的時間。

getTestJarPaths

public  getTestJarPaths ()

傳回
	測試 jar 路徑

getTestRunArgMap

public  getTestRunArgMap ()

傳回
	傳遞至 UiAutomatorRunner 的引數

getTestRunner

public IRemoteAndroidTestRunner getTestRunner ()

傳回
`IRemoteAndroidTestRunner`	測試執行工具

isInstrumentationTest

public boolean isInstrumentationTest ()

傳回
`boolean`

得分

public void run (TestInformation testInfo, 
                ITestInvocationListener listener)

執行測試，並將結果回報給事件監聽器。

參數
`testInfo`	`TestInformation`：`TestInformation` 物件，包含可執行的實用資訊測試。
`listener`	`ITestInvocationListener`：測試結果的 `ITestInvocationListener`

擲回
`DeviceNotAvailableException`

設定 CaptureCapture

public void setCaptureLogs (boolean captureLogs)

此方法已淘汰。
請改用 setLoggingOption(com.android.tradefed.testtype.UiAutomatorTest.LoggingOption)。

保留與 cts-tradefed 的相容性

參數
`captureLogs`	`boolean`

setDevice

public void setDevice (ITestDevice device)

插入要測試的裝置。

參數
`device`	`ITestDevice`：要使用的 `ITestDevice`

setLoggingOption

public void setLoggingOption (UiAutomatorTest.LoggingOption loggingOption)

參數
`loggingOption`	`UiAutomatorTest.LoggingOption`

setRunName

public void setRunName (String runName)

參數
`runName`	`String`

setRunnerName

public void setRunnerName (String runnerName)

參數
`runnerName`	`String`

setSyncTime

public void setSyncTime (long syncTime)

參數
`syncTime`	`long`：測試檔案同步處理的時間。

setTestJarPaths

public void setTestJarPaths ( jarPaths)

參數
`jarPaths`	：測試 Jar 的位置。

setTestRunArgMap

public void setTestRunArgMap ( runArgMap)

參數
`runArgMap`	：要傳遞給 UiAutomatorRunner 的引數。

保護方法

createTestRunner

protected IRemoteAndroidTestRunner createTestRunner ()

傳回
`IRemoteAndroidTestRunner`

擲回
`DeviceNotAvailableException`

getRunUtil

protected IRunUtil getRunUtil ()

傳回
`IRunUtil`

螢幕截圖 AndBugreport

protected void onScreenshotAndBugreport (ITestDevice device, 
                ITestInvocationListener listener, 
                String prefix, 
                UiAutomatorTest.TestFailureAction overrideAction)

參數
`device`	`ITestDevice`
`listener`	`ITestInvocationListener`
`prefix`	`String`
`overrideAction`	`UiAutomatorTest.TestFailureAction`

螢幕截圖 AndBugreport

protected void onScreenshotAndBugreport (ITestDevice device, 
                ITestInvocationListener listener, 
                String prefix)

參數
`device`	`ITestDevice`
`listener`	`ITestInvocationListener`
`prefix`	`String`

preTest 設定

protected void preTestSetup ()

檢查裝置上是否出現 UI Automator 元件

擲回
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`