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

DeviceTestRunOptions

public class DeviceTestRunOptions
extends Object

java.lang.Object
↳	com.android.tradefed.testtype.junit4.DeviceTestRunOptions

建構工具類別，提供透過 BaseHostJUnit4Test 執行裝置測試的相關選項。

摘要

公用建構函式
`DeviceTestRunOptions(String packageName)`

公用方法
`DeviceTestRunOptions`	`addExtraListener(ITestLifeCycleReceiver listener)` 在正在執行的檢測作業中新增額外的事件監聽器。
`DeviceTestRunOptions`	`addInstrumentationArg(String key, String value)` 新增要傳遞至檢測的引數。
`void`	`clearExtraListeners()`
`void`	`clearInstrumentationArgs()` 清除先前使用 `addInstrumentationArg(String, String)` 設定的所有檢測引數。
`String`	`getApkFileName()` 傳回 APK 安裝作業的 APK 檔案名稱。
`ITestDevice`	`getDevice()`
	`getExtraListeners()`
`String[]`	`getInstallArgs()` 傳回安裝指令的額外選項。
	`getInstrumentationArgs()`
`Long`	`getMaxInstrumentationTimeoutMs()`
`Long`	`getMaxTimeToOutputMs()`
`String`	`getPackageName()`
`String`	`getRunner()`
`String`	`getTestClassName()`
`String`	`getTestMethodName()`
`Long`	`getTestTimeoutMs()`
`Integer`	`getUserId()`
`boolean`	`isForceQueryable()` 是否可查詢要安裝的 APK。
`boolean`	`isGrantPermission()` 是否授予 APK 安裝權限。
`boolean`	`isHiddenApiCheckDisabled()`
`boolean`	`isIsolatedStorageDisabled()`
`boolean`	`isRestartDisabled()`
`boolean`	`isTestApiCheckDisabled()`
`boolean`	`isWindowAnimationDisabled()`
`DeviceTestRunOptions`	`setApkFileName(String apkFileName)` 設定 APK 安裝作業的 APK 檔案名稱。
`DeviceTestRunOptions`	`setCheckResults(boolean checkResults)` 設定是否應檢查檢測執行作業的結果，確保不會失敗。
`DeviceTestRunOptions`	`setDevice(ITestDevice device)`
`DeviceTestRunOptions`	`setDisableHiddenApiCheck(boolean disableHiddenApiCheck)` 設定是否將 --no-hidden-api-checks 新增至「am instrument」從主機端。
`DeviceTestRunOptions`	`setDisableIsolatedStorage(boolean disableIsolatedStorage)` 設定是否要將 --no-獨立儲存空間新增至「am instrument」從主機端。
`DeviceTestRunOptions`	`setDisableRestart(boolean disableRestart)` 設定是否要新增 --no-restart 至「am instrument」從主機端使用
`DeviceTestRunOptions`	`setDisableTestApiCheck(boolean disableTestApiCheck)` 設定是否將 --no-test-api-access 新增至「am instrument」所使用的伺服器
`DeviceTestRunOptions`	`setDisableWindowAnimation(boolean disableWindowAnimation)` 設定是否將 --no-window-animation 新增至「am instrument」從主機端。
`DeviceTestRunOptions`	`setForceQueryable(boolean forceQueryable)` 如果無法查詢要安裝的 APK，請設定 `false`。
`DeviceTestRunOptions`	`setGrantPermission(boolean grantPermission)` 授予 APK 安裝權限。
`DeviceTestRunOptions`	`setInstallArgs(String... installArgs)` 設定安裝指令的額外選項。
`DeviceTestRunOptions`	`setMaxInstrumentationTimeoutMs(Long maxInstrumentationTimeoutMs)` 設定完整檢測作業必須執行的時間上限 (以毫秒為單位)，完成。
`DeviceTestRunOptions`	`setMaxTimeToOutputMs(Long maxTimeToOutputMs)` 設定檢測作業在產生前可停止輸出的時間上限 (以毫秒為單位) 已停止。
`DeviceTestRunOptions`	`setRunner(String runner)` 設定用來執行檢測的檢測執行器。
`DeviceTestRunOptions`	`setTestClassName(String testClassName)` 設定檢測作業應執行的類別名稱。
`DeviceTestRunOptions`	`setTestMethodName(String testMethodName)` 設定檢測作業應執行的方法名稱。
`DeviceTestRunOptions`	`setTestTimeoutMs(Long testTimeoutMs)` 設定測試在中斷前可執行的時間上限 (以毫秒為單位)。
`DeviceTestRunOptions`	`setUserId(Integer userId)` 設定應執行檢測作業的使用者 ID。
`boolean`	`shouldCheckResults()`

公用建構函式

DeviceTestRunOptions

public DeviceTestRunOptions (String packageName)

參數
`packageName`	`String`

公用方法

addExtraListener

public DeviceTestRunOptions addExtraListener (ITestLifeCycleReceiver listener)

在正在執行的檢測作業中新增額外的事件監聽器。

參數
`listener`	`ITestLifeCycleReceiver`

傳回
`DeviceTestRunOptions`

addInstrumentationArg

public DeviceTestRunOptions addInstrumentationArg (String key, 
                String value)

新增要傳遞至檢測的引數。

參數
`key`	`String`
`value`	`String`

傳回
`DeviceTestRunOptions`

ClearExtraListener

public void clearExtraListeners ()

ClearInstrumentationArgs

public void clearInstrumentationArgs ()

清除先前使用 addInstrumentationArg(String, String) 設定的所有檢測引數。

getApkFileName

public String getApkFileName ()

傳回 APK 安裝作業的 APK 檔案名稱。

傳回
`String`

getDevice

public ITestDevice getDevice ()

傳回
`ITestDevice`

getExtraListener

public  getExtraListeners ()

傳回

getInstallArgs

public String[] getInstallArgs ()

傳回安裝指令的額外選項。

傳回
`String[]`

getInstrumentationArgs

public  getInstrumentationArgs ()

傳回

getMaxInstrumentationTimeoutMs

public Long getMaxInstrumentationTimeoutMs ()

傳回
`Long`

getMaxTimeToOutputMs

public Long getMaxTimeToOutputMs ()

傳回
`Long`

getPackageName

public String getPackageName ()

傳回
`String`

getRunner

public String getRunner ()

傳回
`String`

getTestClassName

public String getTestClassName ()

傳回
`String`

getTestMethodName

public String getTestMethodName ()

傳回
`String`

getTestTimeoutMs

public Long getTestTimeoutMs ()

傳回
`Long`

getUserId

public Integer getUserId ()

傳回
`Integer`

isForceQueryable

public boolean isForceQueryable ()

是否可查詢要安裝的 APK。預設值為 true。

傳回
`boolean`

isGrantPermission

public boolean isGrantPermission ()

是否授予 APK 安裝權限。

傳回
`boolean`

isHiddenApiCheck 已停用

public boolean isHiddenApiCheckDisabled ()

傳回
`boolean`

isIsolatedStorageDisabled

public boolean isIsolatedStorageDisabled ()

傳回
`boolean`

is 重新啟動已停用

public boolean isRestartDisabled ()

傳回
`boolean`

isTestApiCheckDisabled

public boolean isTestApiCheckDisabled ()

傳回
`boolean`

isWindowAnimation 已停用

public boolean isWindowAnimationDisabled ()

傳回
`boolean`

setApkFileName

public DeviceTestRunOptions setApkFileName (String apkFileName)

設定 APK 安裝作業的 APK 檔案名稱。

參數
`apkFileName`	`String`

傳回
`DeviceTestRunOptions`

setCheckResults

public DeviceTestRunOptions setCheckResults (boolean checkResults)

設定是否應檢查檢測執行作業的結果，確保不會失敗。

參數
`checkResults`	`boolean`

傳回
`DeviceTestRunOptions`

setDevice

public DeviceTestRunOptions setDevice (ITestDevice device)

參數
`device`	`ITestDevice`

傳回
`DeviceTestRunOptions`

setDisableHiddenApiCheck

public DeviceTestRunOptions setDisableHiddenApiCheck (boolean disableHiddenApiCheck)

設定是否將 --no-hidden-api-checks 新增至「am instrument」從主機端。

參數
`disableHiddenApiCheck`	`boolean`

傳回
`DeviceTestRunOptions`

setDisableIsolatedStorage

public DeviceTestRunOptions setDisableIsolatedStorage (boolean disableIsolatedStorage)

設定是否要將 --no-獨立儲存空間新增至「am instrument」從主機端。

參數
`disableIsolatedStorage`	`boolean`

傳回
`DeviceTestRunOptions`

setDisableRestart

public DeviceTestRunOptions setDisableRestart (boolean disableRestart)

設定是否要新增 --no-restart 至「am instrument」從主機端使用

參數
`disableRestart`	`boolean`

傳回
`DeviceTestRunOptions`

setDisableTestApiCheck

public DeviceTestRunOptions setDisableTestApiCheck (boolean disableTestApiCheck)

設定是否將 --no-test-api-access 新增至「am instrument」所使用的伺服器

參數
`disableTestApiCheck`	`boolean`

傳回
`DeviceTestRunOptions`

設定停用視窗動畫

public DeviceTestRunOptions setDisableWindowAnimation (boolean disableWindowAnimation)

設定是否將 --no-window-animation 新增至「am instrument」從主機端。

參數
`disableWindowAnimation`	`boolean`

傳回
`DeviceTestRunOptions`

setForceQueryable

public DeviceTestRunOptions setForceQueryable (boolean forceQueryable)

如果無法查詢要安裝的 APK，請設定 false。

參數
`forceQueryable`	`boolean`

傳回
`DeviceTestRunOptions`

設定授權權限

public DeviceTestRunOptions setGrantPermission (boolean grantPermission)

授予 APK 安裝權限。

參數
`grantPermission`	`boolean`

傳回
`DeviceTestRunOptions`

setInstallArgs

public DeviceTestRunOptions setInstallArgs (String... installArgs)

設定安裝指令的額外選項。

參數
`installArgs`	`String`

傳回
`DeviceTestRunOptions`

setMaxInstrumentationTimeoutMs

public DeviceTestRunOptions setMaxInstrumentationTimeoutMs (Long maxInstrumentationTimeoutMs)

設定完整檢測作業必須執行的時間上限 (以毫秒為單位)，完成。如果不想設定逾時，請將值設為 0。選用項目。

參數
`maxInstrumentationTimeoutMs`	`Long`

傳回
`DeviceTestRunOptions`

setMaxTimeToOutputM

public DeviceTestRunOptions setMaxTimeToOutputMs (Long maxTimeToOutputMs)

設定檢測作業在產生前可停止輸出的時間上限 (以毫秒為單位) 已停止。如果不想設定逾時，請將值設為 0。選用項目。

參數
`maxTimeToOutputMs`	`Long`

傳回
`DeviceTestRunOptions`

setRunner

public DeviceTestRunOptions setRunner (String runner)

設定用來執行檢測的檢測執行器。預設 Runner 是「android.support.test.runner.AndroidJUnitRunner」。選用項目。

參數
`runner`	`String`

傳回
`DeviceTestRunOptions`

setTestClassName

public DeviceTestRunOptions setTestClassName (String testClassName)

設定檢測作業應執行的類別名稱。系統會篩選檢測只能執行類別可搭配 setTestMethodName(String) 使用。選用項目。

參數
`testClassName`	`String`

傳回
`DeviceTestRunOptions`

setTestMethodName

public DeviceTestRunOptions setTestMethodName (String testMethodName)

設定檢測作業應執行的方法名稱。必須設定 setTestClassName(String) 才能正常運作。選用項目。

參數
`testMethodName`	`String`

傳回
`DeviceTestRunOptions`

setTestTimeoutMs

public DeviceTestRunOptions setTestTimeoutMs (Long testTimeoutMs)

設定測試在中斷前可執行的時間上限 (以毫秒為單位)。設為 0 的日期沒有逾時。選用項目。

參數
`testTimeoutMs`	`Long`

傳回
`DeviceTestRunOptions`

設定使用者 ID

public DeviceTestRunOptions setUserId (Integer userId)

設定應執行檢測作業的使用者 ID。選用項目。

參數
`userId`	`Integer`

傳回
`DeviceTestRunOptions`

應檢查結果

public boolean shouldCheckResults ()

傳回
`boolean`