TestDeviceOptions

public class TestDeviceOptions
extends Object

java.lang.Object
↳	com.android.tradefed.device.TestDeviceOptions

---

ITestDevice Option 秒的容器

摘要

常數
int	DEFAULT_ADB_PORT

欄位
public static final String	INSTANCE_TYPE_OPTION
public static final String	REMOTE_TF_VERSION_OPTION

公用建構函式
TestDeviceOptions()

公用方法
void	addGceDriverParams(String param) 為 gce 驅動程式參數新增參數。
boolean	allowGceCmdTimeoutOverride() 傳回是否應依賴雲端的開機逾時引數 (如有)。
long	getAdbCommandTimeout()
int	getAdbRecoveryTimeout()
long	getAdbRootUnavailableTimeout()
long	getAvailableTimeout()
File	getAvdConfigFile() 傳回 Gce Avd 設定檔以啟動執行個體。
File	getAvdDriverBinary() 傳回二進位檔路徑，啟動 Gce Avd 執行個體。
String	getBaseImage() 傳回目前執行個體要使用的基本映像檔名稱
long	getBugreportzTimeout() 傳回要套用至 bugreportz 擷取的逾時值。
String	getConnCheckUrl()
static String	getCreateCommandByInstanceType(TestDeviceOptions.InstanceType type)
String	getCrosPassword() 傳回用來登入 Chrome OS 的密碼。
String	getCrosUser() 傳回要登入的 Chrome OS 使用者。
Integer	getCutoffBattery()
String	getDefaultNetworkType()
MultiMap<File, String>	getExtraFiles() 傳回在雲端建立期間必須上傳至 GCE 的額外檔案。
	getExtraOxygenArgs() 傳回額外引數以租用 Oxygen 裝置。
static	getExtraParamsByInstanceType(TestDeviceOptions.InstanceType type, String baseImage)
File	getFastbootBinary() 傳回要使用的指定 Fastboot 二進位檔。
long	getFastbootOutputTimeout()
int	getFastbootTimeout()
String	getGceAccount() 傳回 gce 電子郵件帳戶並與驅動程式搭配使用
long	getGceCmdTimeout() 傳回執行個體的 Gce Avd 逾時時間，讓執行個體上線。
String	getGceDriverBuildIdParam() 傳回應與建構資訊中版本 ID 配對的 GCE 驅動程式參數
MultiMap<String, File>	getGceDriverFileParams() 傳回其他檔案路徑，做為透過選項提供的 GCE 驅動程式參數。
Log.LogLevel	getGceDriverLogLevel() 傳回 Gce Avd 驅動程式的記錄層級。
	getGceDriverParams() 傳回透過選項提供的其他 GCE 驅動程式參數
int	getGceMaxAttempt() 傳回嘗試啟動 gce 裝置的次數上限
TestDeviceOptions.InstanceType	getInstanceType() 傳回應建立的虛擬裝置類型
String	getInstanceUser() 傳回應建立的 GCE 虛擬裝置的執行個體使用者
	getInvocationAttributeToMetadata()
String	getLogcatOptions()
long	getMaxLogcatDataSize() 取得要保留的 tmp logcat 資料約略大小上限 (以位元組為單位)。
long	getMaxWifiConnectTime()
long	getOnlineTimeout()
String	getOxygenAccountingUser() 傳回 Oxygen 裝置的會計使用者。
TestDeviceOptions.DeviceSize	getOxygenDeviceSize() 傳回執行 Oxygen 虛擬裝置的主機大小。
long	getOxygenLeaseLength() 傳回 Oxygen 裝置的出借時間長度 (以毫秒為單位)。
String	getOxygenServiceAddress() 傳回 Oxygen 裝置的服務地址。
String	getOxygenTargetRegion() 傳回 Oxygen 裝置的目標區域。
	getPostBootCommands()
int	getRebootTimeout()
int	getRemoteAdbPort() 傳回 ADB 伺服器監聽的執行個體遠端通訊埠
	getRemoteFetchFilePattern() 傳回嘗試透過 scp 擷取的模式清單。
File	getRemoteTf() 這個檔案指向要推送至遠端的 Tradefed 版本目錄。
File	getServiceAccountJsonKeyFile()
long	getSnapuserdTimeout()
File	getSshPrivateKeyPath() 傳回 SSH 金鑰路徑，用於使用 Gce Avd 執行個體的作業。
int	getUnencryptRebootTimeout()
boolean	getUseFastbootErase()
int	getWifiAttempts()
int	getWifiRetryWaitTime()
String	getWifiUtilAPKPath()
boolean	isCmdWifiVirtual()
boolean	isDisableKeyguard() 檢查是否應在啟動完畢後嘗試停用鍵盤鎖
boolean	isEnableAdbRoot() 檢查這部裝置啟動時是否應啟用 ADB 根層級
boolean	isLogcatCaptureEnabled()
boolean	isWifiExpoRetryEnabled()
void	setAdbCommandTimeout(long adbCommandTimeout) 設定逾時以傳送指令 (毫秒)。
void	setAdbRecoveryTimeout(int adbRecoveryTimeout)
void	setAdbRootUnavailableTimeout(long adbRootUnavailableTimeout)
void	setAvdConfigFile(File avdConfigFile) 設定 Gce Avd 設定檔以啟動執行個體。
void	setAvdDriverBinary(File avdDriverBinary) 設定二進位檔的路徑，啟動 Gce Avd 執行個體。
void	setConnCheckUrl(String url)
void	setCutoffBattery(int cutoffBattery) 設定所需的最低電池電量以繼續叫用。
void	setDisableKeyguard(boolean disableKeyguard) 設定是否在開機完成後嘗試停用鍵盤保護框
void	setExtraFiles(MultiMap<File, String> extraFiles) 設定建立雲端時需要上傳至 GCE 的額外檔案。
void	setFastbootTimeout(int fastbootTimeout)
void	setGceCmdTimeout(long gceCmdTimeout) 設定執行個體的 Gce Avd 逾時時間，讓執行個體上線。
void	setGceDriverBuildIdParam(String gceDriverBuildIdParam) 設定 GCE 驅動程式參數，這些參數應該與建構資訊中的版本 ID 配對
void	setGceDriverLogLevel(Log.LogLevel mGceDriverLogLevel) 設定 Gce Avd 驅動程式的記錄層級。
void	setGceMaxAttempt(int gceMaxAttempt) 設定 gce 裝置的嘗試啟動次數上限
void	setInstanceType(TestDeviceOptions.InstanceType type) 設定要建立的虛擬裝置的執行個體類型
void	setInstanceUser(String instanceUser) 設定應建立的 GCE 虛擬裝置的執行個體使用者。
void	setLogcatOptions(String logcatOptions) 設定要向下傳遞至 logcat 的選項
void	setMaxLogcatDataSize(long maxLogcatDataSize) 設定要保留的 tmp logcat 約略大小上限 (以位元組為單位)
void	setOnlineTimeout(long onlineTimeout)
void	setRebootTimeout(int rebootTimeout)
void	setRemoteAdbPort(int remoteAdbPort) 在 ADB 伺服器監聽的執行個體中設定遠端通訊埠
void	setServiceAccountJsonKeyFile(File jsonKeyFile) 設定服務帳戶的 json 金鑰檔案。
void	setSkipTearDown(boolean shouldSkipTearDown) 如果應略過 GCE 拆除作業，會傳回 true。
void	setSshPrivateKeyPath(File sshPrivateKeyPath) 設定 SSH 金鑰路徑，供使用 Gce Avd 執行個體進行作業。
void	setUnencryptRebootTimeout(int unencryptRebootTimeout)
void	setUseCmdWifi(boolean useCmdWifi)
void	setUseConnection(boolean useConnection)
void	setUseFastbootErase(boolean useFastbootErase)
void	setWifiAttempts(int wifiAttempts)
boolean	shouldDisableReboot()
boolean	shouldSkipTearDown() 如果應略過 GCE 拆除作業，會傳回 true。
boolean	shouldUseConnection() 傳回是否使用新的連線功能。
boolean	shouldUseContentProvider() 傳回交易內容供應器是否可用於推送/提取檔案。
boolean	useCmdWifiCommands() 傳回是否使用 cmd Wi-Fi 指令而非 apk。
boolean	useExitStatusWorkaround() 傳回是否使用變通方法，在無殼層 v2 的舊裝置上取得殼層退出狀態。
boolean	useOxygen() 如果使用 Oxygen 建立虛擬裝置，則傳回 true。
boolean	useOxygenProxy() 如果希望 TradeFed 直接呼叫 Oxygen 來租借裝置，則傳回 true。
boolean	useOxygenationDevice() 如果是在 OmniLab 的基礎架構中租用氧氣裝置，則傳回 true。
boolean	useUpdatedBootloaderStatus() 傳回是否要使用新版系統啟動載入程式狀態狀態。
boolean	waitForGceTearDown() 如果我們在繼續之前，應該在 GCE 拆除作業前封鎖，傳回 true。

常數

DEFAULT_ADB_PORT 函式

public static final int DEFAULT_ADB_PORT

常數值：5555 (0x000015b3)

欄位

INSTANCE_TYPE_OPTION

public static final String INSTANCE_TYPE_OPTION

REMOTE_TF_VERSION_OPTION

public static final String REMOTE_TF_VERSION_OPTION

公用建構函式

TestDeviceOptions

public TestDeviceOptions ()

公用方法

addGceDriverParams

public void addGceDriverParams (String param)

在 gce 驅動程式參數中新增參數。

參數
param	String

allowGceCmdTimeoutOverride

public boolean allowGceCmdTimeoutOverride ()

傳回是否應依賴雲端的開機逾時引數 (如有)。

傳回
boolean

getAdbCommandTimeout

public long getAdbCommandTimeout ()

傳回
long	傳送指令的逾時時間 (單位為毫秒)。

getAdbRecoveryTimeout

public int getAdbRecoveryTimeout ()

傳回
int	開機進入復原模式的逾時時間 (以毫秒為單位)。

getAdbRootUnavailableTimeout

public long getAdbRootUnavailableTimeout ()

傳回
long	在 ADB 根層級之後，等待裝置無法使用的時間 (以毫秒為單位)。

getAvailableTimeout

public long getAvailableTimeout ()

傳回
long	等待裝置可供使用的預設時間 (以毫秒為單位)。

getAvdConfigFile

public File getAvdConfigFile ()

傳回 Gce Avd 設定檔以啟動執行個體。

傳回
File

getAvdDriverBinary

public File getAvdDriverBinary ()

傳回二進位檔的路徑，啟動 Gce Avd 執行個體。

傳回
File

getBaseImage

public String getBaseImage ()

傳回要用於目前執行個體的基本映像檔名稱

傳回
String

getBugreportzTimeout

public long getBugreportzTimeout ()

傳回要套用至 bugreportz 擷取的逾時值。

傳回
long

getConnCheckUrl

public String getConnCheckUrl ()

傳回
String	連線測試要使用的預設網址。

getCreateCommandByInstanceType

public static String getCreateCommandByInstanceType (TestDeviceOptions.InstanceType type)

參數
type	TestDeviceOptions.InstanceType

傳回
String

getCrosPassword

public String getCrosPassword ()

傳回用來登入 Chrome OS 的密碼。

傳回
String

getCrosUser

public String getCrosUser ()

傳回要登入的 Chrome OS 使用者。

傳回
String

getCutoffBattery

public Integer getCutoffBattery ()

傳回
Integer	繼續叫用的最低電池電量。

getDefaultNetworkType

public String getDefaultNetworkType ()

傳回
String

getExtraFiles

public MultiMap<File, String> getExtraFiles ()

傳回在雲端建立期間必須上傳至 GCE 的額外檔案。

傳回
MultiMap<File, String>

getExtraOxygenArgs

public  getExtraOxygenArgs ()

傳回額外的引數以租用 Oxygen 裝置。

傳回

getExtraParamsByInstanceType

public static  getExtraParamsByInstanceType (TestDeviceOptions.InstanceType type, 
                String baseImage)

參數
type	TestDeviceOptions.InstanceType
baseImage	String

傳回

getFastbootBinary

public File getFastbootBinary ()

傳回要使用的指定 Fastboot 二進位檔。如果為空值，請使用 DeviceManager 的其中一個二進位檔。

傳回
File

getFastbootOutputTimeout

public long getFastbootOutputTimeout ()

傳回
long

getFastbootTimeout

public int getFastbootTimeout ()

傳回
int	開機進入 Fastboot 模式的逾時時間。

getGceAccount

public String getGceAccount ()

回傳 gce 電子郵件帳戶即可與驅動程式搭配使用

傳回
String

getGceCmdTimeout

public long getGceCmdTimeout ()

傳回執行個體的 Gce Avd 逾時時間，讓執行個體上線。

傳回
long

getGceDriverBuildIdParam

public String getGceDriverBuildIdParam ()

傳回應與建構資訊中版本 ID 配對的 GCE 驅動程式參數

傳回
String

getGceDriverFileParams

public MultiMap<String, File> getGceDriverFileParams ()

傳回其他檔案路徑，做為透過選項提供的 GCE 驅動程式參數。

傳回
MultiMap<String, File>

getGceDriverLogLevel

public Log.LogLevel getGceDriverLogLevel ()

傳回 Gce Avd 驅動程式的記錄層級。

傳回
Log.LogLevel

getGceDriverParams

public  getGceDriverParams ()

傳回透過選項提供的其他 GCE 驅動程式參數

傳回

getGceMaxtry

public int getGceMaxAttempt ()

傳回嘗試啟動 gce 裝置的次數上限

傳回
int

getInstanceType

public TestDeviceOptions.InstanceType getInstanceType ()

傳回應建立的虛擬裝置的執行個體類型

傳回
TestDeviceOptions.InstanceType

getInstanceUser

public String getInstanceUser ()

傳回應建立的 GCE 虛擬裝置的執行個體使用者

傳回
String

getInvocationAttributeToMetadata

public  getInvocationAttributeToMetadata ()

傳回

getLogcat 選項

public String getLogcatOptions ()

傳回
String	已設定的 logcat 選項

getMaxLogcatDataSize

public long getMaxLogcatDataSize ()

取得要保留的 tmp logcat 資料約略大小上限 (以位元組為單位)。

傳回
long

getMaxWifiConnectTime

public long getMaxWifiConnectTime ()

傳回
long	嘗試連線 Wi-Fi 的時間上限。

getOnlineTimeout

public long getOnlineTimeout ()

傳回
long	裝置上線的預設等待時間 (以毫秒為單位)。

getOxygenAccountingUser

public String getOxygenAccountingUser ()

傳回 Oxygen 裝置的會計使用者。

傳回
String

getOxygenDeviceSize

public TestDeviceOptions.DeviceSize getOxygenDeviceSize ()

傳回執行 Oxygen 虛擬裝置的主機大小。

傳回
TestDeviceOptions.DeviceSize

getOxygenLeaseLength

public long getOxygenLeaseLength ()

傳回 Oxygen 裝置的出借時間長度 (以毫秒為單位)。

傳回
long

getOxygenServiceAddress

public String getOxygenServiceAddress ()

傳回 Oxygen 裝置的服務地址。

傳回
String

getOxygenTargetRegion

public String getOxygenTargetRegion ()

傳回 Oxygen 裝置的目標區域。

傳回
String

getPostBootCommands

public  getPostBootCommands ()

傳回
	重新啟動後要執行的殼層指令清單。

getRebootTimeout

public int getRebootTimeout ()

傳回
int	完整系統開機的逾時時間 (單位為毫秒)。

getRemoteAdbPort

public int getRemoteAdbPort ()

傳回 ADB 伺服器監聽的執行個體遠端通訊埠

傳回
int

getRemoteFetchFilePattern

public  getRemoteFetchFilePattern ()

傳回嘗試透過 scp 擷取的模式清單。

傳回

getRemoteTf

public File getRemoteTf ()

這個檔案指向要推送至遠端的 Tradefed 版本目錄。

傳回
File

getServiceAccountJsonKeyFile

public File getServiceAccountJsonKeyFile ()

傳回
File	服務帳戶的 JSON 金鑰檔案

getSnapuserdTimeout

public long getSnapuserdTimeout ()

傳回
long

getSshPrivateKeyPath

public File getSshPrivateKeyPath ()

傳回 SSH 金鑰路徑，用於使用 Gce Avd 執行個體的作業。

傳回
File

getUnEncryptRebootTimeout

public int getUnencryptRebootTimeout ()

傳回
int	檔案系統格式的逾時時間 (單位為毫秒)，以及裝置在未加密的情況下重新啟動。

取得快速系統啟動模式 (FastbootErase)

public boolean getUseFastbootErase ()

傳回
boolean	是否使用 Fastboot 清除 (而非 Fastboot 格式) 來抹除分區。

getWifi 嘗試

public int getWifiAttempts ()

傳回
int	預設的連線嘗試次數。

getWifi 重試等待時間

public int getWifiRetryWaitTime ()

傳回
int	每次重試 Wi-Fi 連線之間的基本等待時間。

getWifiUtilAPKPath

public String getWifiUtilAPKPath ()

傳回
String	wifiutil apk 路徑

isCmdWifiVirtual

public boolean isCmdWifiVirtual ()

傳回
boolean

isDisableKeyguard

public boolean isDisableKeyguard ()

檢查是否應在開機完成後嘗試停用鍵盤保護框

傳回
boolean

isEnableAdbRoot

public boolean isEnableAdbRoot ()

檢查這部裝置啟動時是否應啟用 ADB 根層級

傳回
boolean

isLogcatCaptureEnabled

public boolean isLogcatCaptureEnabled ()

傳回
boolean	如果已啟用背景 Logcat 擷取功能，則為 true

isWifiExpo 重試已啟用

public boolean isWifiExpoRetryEnabled ()

傳回
boolean	是否應使用指數重試策略。

setAdbCommandTimeout

public void setAdbCommandTimeout (long adbCommandTimeout)

設定逾時以傳送指令 (毫秒)。

參數
adbCommandTimeout	long

setAdbRecoveryTimeout

public void setAdbRecoveryTimeout (int adbRecoveryTimeout)

參數
adbRecoveryTimeout	int：啟動進入復原模式的逾時時間 (以毫秒為單位)。

setAdbRootUnavailableTimeout

public void setAdbRootUnavailableTimeout (long adbRootUnavailableTimeout)

參數
adbRootUnavailableTimeout	long：在 ADB 根層級後，等待裝置停止使用的時間 (毫秒)。

setAvdConfigFile

public void setAvdConfigFile (File avdConfigFile)

設定 Gce Avd 設定檔以啟動執行個體。

參數
avdConfigFile	File

setAvdDriverBinary

public void setAvdDriverBinary (File avdDriverBinary)

設定二進位檔的路徑，啟動 Gce Avd 執行個體。

參數
avdDriverBinary	File

setConnCheckUrl

public void setConnCheckUrl (String url)

參數
url	String

設定時間

public void setCutoffBattery (int cutoffBattery)

設定所需的最低電池電量以繼續叫用。

參數
cutoffBattery	int

setDisableKeyguard

public void setDisableKeyguard (boolean disableKeyguard)

設定是否在開機完成後嘗試停用鍵盤保護框

參數
disableKeyguard	boolean

setExtraFiles

public void setExtraFiles (MultiMap<File, String> extraFiles)

設定建立雲端時需要上傳至 GCE 的額外檔案。

參數
extraFiles	MultiMap

設定快速系統逾時

public void setFastbootTimeout (int fastbootTimeout)

參數
fastbootTimeout	int：以 msec (毫秒) 為單位，啟動進入 Fastboot 模式的間隔。

setGceCmdTimeout

public void setGceCmdTimeout (long gceCmdTimeout)

設定執行個體的 Gce Avd 逾時時間，讓執行個體上線。

參數
gceCmdTimeout	long

setGceDriverBuildIdParam

public void setGceDriverBuildIdParam (String gceDriverBuildIdParam)

設定 GCE 驅動程式參數，找出哪些是應與建構資訊中的版本 ID 配對的

參數
gceDriverBuildIdParam	String

setGceDriverLogLevel

public void setGceDriverLogLevel (Log.LogLevel mGceDriverLogLevel)

設定 Gce Avd 驅動程式的記錄層級。

參數
mGceDriverLogLevel	Log.LogLevel

setGceMaxtry

public void setGceMaxAttempt (int gceMaxAttempt)

設定 gce 裝置的嘗試啟動次數上限

參數
gceMaxAttempt	int

setInstanceType

public void setInstanceType (TestDeviceOptions.InstanceType type)

設定要建立的虛擬裝置的執行個體類型

參數
type	TestDeviceOptions.InstanceType

setInstanceUser

public void setInstanceUser (String instanceUser)

設定應建立的 GCE 虛擬裝置的執行個體使用者。

參數
instanceUser	String

setLogcatOptions

public void setLogcatOptions (String logcatOptions)

設定要向下傳遞至 logcat 的選項

參數
logcatOptions	String

setMaxLogcatDataSize

public void setMaxLogcatDataSize (long maxLogcatDataSize)

設定要保留的 tmp logcat 約略大小上限 (以位元組為單位)

參數
maxLogcatDataSize	long

setOnlineTimeout

public void setOnlineTimeout (long onlineTimeout)

參數
onlineTimeout	long

setRebootTimeout

public void setRebootTimeout (int rebootTimeout)

參數
rebootTimeout	int：系統完全啟動的逾時時間 (以毫秒為單位)。

setRemoteAdbPort

public void setRemoteAdbPort (int remoteAdbPort)

在 ADB 伺服器監聽的執行個體中，設定遠端通訊埠

參數
remoteAdbPort	int

setServiceAccountJsonKeyFile

public void setServiceAccountJsonKeyFile (File jsonKeyFile)

設定服務帳戶 JSON 金鑰檔案。

參數
jsonKeyFile	File：金鑰檔案。

設定略過

public void setSkipTearDown (boolean shouldSkipTearDown)

如果應略過 GCE 拆除作業，會傳回 true。否則傳回「否」。

參數
shouldSkipTearDown	boolean

setSshPrivateKeyPath

public void setSshPrivateKeyPath (File sshPrivateKeyPath)

設定 SSH 金鑰路徑，供使用 Gce Avd 執行個體進行作業。

參數
sshPrivateKeyPath	File

setUnEncryptRebootTimeout

public void setUnencryptRebootTimeout (int unencryptRebootTimeout)

參數
unencryptRebootTimeout	int：檔案系統要格式化的逾時時間 (單位為毫秒)，且裝置在未加密後重新啟動。

設定 UseCmdWifi

public void setUseCmdWifi (boolean useCmdWifi)

參數
useCmdWifi	boolean

setUseConnection

public void setUseConnection (boolean useConnection)

參數
useConnection	boolean

設定使用 FastbootErase

public void setUseFastbootErase (boolean useFastbootErase)

參數
useFastbootErase	boolean：是否要使用 Fastboot 清除 (而非 Fastboot 格式) 來抹除分區。

setWifi 嘗試

public void setWifiAttempts (int wifiAttempts)

參數
wifiAttempts	int

應停用重新啟動

public boolean shouldDisableReboot ()

傳回
boolean	是否應停用裝置重新啟動功能

應略過

public boolean shouldSkipTearDown ()

如果應略過 GCE 拆除作業，會傳回 true。否則傳回「否」。

傳回
boolean

shouldUseConnection

public boolean shouldUseConnection ()

傳回是否使用新的連線功能。

傳回
boolean

應使用 ContentProvider

public boolean shouldUseContentProvider ()

傳回是否能使用交易內容供應器推送/提取檔案。

傳回
boolean

useCmdWifiCommand

public boolean useCmdWifiCommands ()

傳回是否使用 cmd Wi-Fi 指令而非 apk。

傳回
boolean

使用 ExitStatusWorkaround

public boolean useExitStatusWorkaround ()

傳回是否要使用解決方法，在沒有殼層 v2 的舊裝置上取得殼層退出狀態。

傳回
boolean

使用氧

public boolean useOxygen ()

如果使用 Oxygen 建立虛擬裝置，則傳回 true。否則傳回「否」。

傳回
boolean

useOxygenProxy

public boolean useOxygenProxy ()

如果希望 TradeFed 直接呼叫 Oxygen 來租借裝置，則傳回 true。

傳回
boolean

使用 OxygenationDevice

public boolean useOxygenationDevice ()

如果是在 OmniLab 的基礎架構中租用氧氣裝置，則傳回 true。否則傳回「否」。

傳回
boolean

使用 UpdatedBootloaderStatus

public boolean useUpdatedBootloaderStatus ()

傳回是否要使用新版系統啟動載入程式狀態狀態。

傳回
boolean

waitForGceTearDown

public boolean waitForGceTearDown ()

如果我們在進行 GCE 拆除前封鎖作業，會傳回 true。

傳回
boolean