DeviceSelectionOptions (裝置選取選項)

public class DeviceSelectionOptions
extends Object implements IDeviceSelection

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

---

裝置選取條件的容器。

摘要

公用建構函式
DeviceSelectionOptions()

公用方法
void	addExcludeSerial(String serialNumber) 將序號加入排除清單。
void	addProductType(String productType) 將產品類型新增至裝置選項。
void	addProperty(String propertyKey, String propValue) 在裝置選取選項中新增屬性條件
void	addSerial(String serialNumber) 在裝置選項選項中新增序號。
static IDeviceSelection	createForSerial(String serial) 協助工廠方法建立只會比對裝置與特定序列裝置的 IDeviceSelection
boolean	deviceRequested()
boolean	emulatorRequested()
String	fetchEnvironmentVariable(String name) 用於擷取環境變數的輔助函式。
boolean	gceDeviceRequested()
IDeviceSelection.BaseDeviceType	getBaseDeviceTypeRequested() 傳回我們使用的裝置類型。
Integer	getBatteryLevel(IDevice device) 擷取指定裝置的電池電量
String	getDeviceProductType(IDevice device) 取得指定裝置的產品類型
String	getDeviceProductVariant(IDevice device) 取得指定裝置的產品子類
DeviceSelectionOptions.DeviceRequestedType	getDeviceTypeRequested()
	getExcludeSerials() 取得序號排除清單副本
Integer	getMaxBatteryLevel() 取得所要求的最大電池電量
Integer	getMaxBatteryTemperature() 取得所要求的最大電池電量
Integer	getMinBatteryLevel() 取得要求的最低電池電量
	getNoMatchReason() 傳回不相符的原因。
	getProductTypes() 取得產品類型清單副本
	getProperties() 傳回屬性清單的對應
boolean	getRequireBatteryCheck() 針對電池電量未知的裝置，決定是否需要進行電池檢查
boolean	getRequireBatteryTemperatureCheck() 確認電池溫度不明時，是否要執行電池溫度檢查
	getSerials(IDevice device) 取得序號副本
	getSerials() 傳回所要求序列的清單。
boolean	localVirtualDeviceRequested()
boolean	matches(IDevice device)
boolean	nullDeviceRequested()
boolean	remoteDeviceRequested()
void	setBaseDeviceTypeRequested(IDeviceSelection.BaseDeviceType type) 設定我們應使用的裝置類型。
void	setDeviceRequested(boolean deviceRequested) 設定模擬器要求的旗標
void	setDeviceTypeRequested(DeviceSelectionOptions.DeviceRequestedType requestedType)
void	setEmulatorRequested(boolean emulatorRequested) 設定模擬器要求的旗標
void	setGceDeviceRequested(boolean gceDeviceRequested)
void	setMaxBatteryLevel(Integer maxBattery) 設定最大電池電量
void	setMaxBatteryTemperature(Integer maxBatteryTemperature) 設定最大電池電量
void	setMinBatteryLevel(Integer minBattery) 設定最低電池電量
void	setNullDeviceRequested(boolean nullDeviceRequested) 設定空值的裝置要求標記
void	setRequireBatteryCheck(boolean requireCheck) 設定當電池電量未知的裝置時，是否需要進行電池檢查
void	setRequireBatteryTemperatureCheck(boolean requireCheckTemprature) 設定當裝置電池溫度不明時，是否必須檢查電池溫度檢查功能
void	setSerial(String... serialNumber) 設定序號納入清單，取代任何現有值。
void	setStubEmulatorRequested(boolean stubEmulatorRequested) 設定虛設常式模擬器要求的旗標
boolean	stubEmulatorRequested()

公用建構函式

DeviceSelectionOptions (裝置選取選項)

public DeviceSelectionOptions ()

公用方法

addExcludeSerial

public void addExcludeSerial (String serialNumber)

將序號新增至排除清單。

加入產品類型

public void addProductType (String productType)

將產品類型加入裝置選項。

加入屬性

public void addProperty (String propertyKey, 
                String propValue)

在裝置選項選項中新增屬性條件

參數
propertyKey	String
propValue	String

addSerial

public void addSerial (String serialNumber)

在裝置選項選項中新增序號。

createForSerial

public static IDeviceSelection createForSerial (String serial)

協助工廠方法建立僅比對裝置與指定序列的 IDeviceSelection

參數
serial	String

傳回
IDeviceSelection

已要求裝置

public boolean deviceRequested ()

傳回
boolean

已要求模擬器

public boolean emulatorRequested ()

傳回
boolean

擷取環境變數

public String fetchEnvironmentVariable (String name)

用於擷取環境變數的輔助函式。基本上，這只是 System.getenv(String) 的包裝函式，是為了單元測試而執行。

參數
name	String：要擷取的環境變數。

傳回
String	環境變數的 String 值或空值 (如果無法使用)。

已要求 gceDevice

public boolean gceDeviceRequested ()

傳回
boolean

getBaseDeviceTypeRequested

public IDeviceSelection.BaseDeviceType getBaseDeviceTypeRequested ()

傳回我們使用的裝置類型。

傳回
IDeviceSelection.BaseDeviceType

getBatteryLevel

public Integer getBatteryLevel (IDevice device)

擷取指定裝置的電池電量

參數
device	IDevice：IDevice

傳回
Integer	裝置電池電量；如果不明，則為null

getDeviceProductType

public String getDeviceProductType (IDevice device)

取得指定裝置的產品類型

參數
device	IDevice：IDevice

傳回
String	裝置產品類型；如果不明，則為null

getDeviceProductVariant

public String getDeviceProductVariant (IDevice device)

取得指定裝置的產品子類

參數
device	IDevice：IDevice

傳回
String	裝置產品子類；如果不明，則為null

getDeviceTypeRequested

public DeviceSelectionOptions.DeviceRequestedType getDeviceTypeRequested ()

傳回
DeviceSelectionOptions.DeviceRequestedType

getExcludeSerials

public  getExcludeSerials ()

取得序號排除清單副本

傳回
	序號 ERROR(/Collection)

getMaxBatteryLevel

public Integer getMaxBatteryLevel ()

取得所要求的最大電池電量

傳回
Integer

getMaxBatteryTemperature

public Integer getMaxBatteryTemperature ()

取得所要求的最大電池電量

傳回
Integer

getMinBatteryLevel

public Integer getMinBatteryLevel ()

取得所要求的最低電池電量

傳回
Integer

getNoMatchReason

public  getNoMatchReason ()

傳回無法比對裝置的原因。

傳回
	序號對應說明無法分配的原因

getProductTypes

public  getProductTypes ()

取得產品類型清單副本

傳回
	ERROR(/Collection) 的產品類型

getProperties

public  getProperties ()

傳回屬性清單的對應

傳回
	將 ERROR(/Map) 裝置屬性名稱指派給值

getRequireBatteryCheck

public boolean getRequireBatteryCheck ()

針對電池電量未知的裝置，決定是否需要進行電池檢查

傳回
boolean

getRequireBatteryTemperatureCheck

public boolean getRequireBatteryTemperatureCheck ()

確認電池溫度不明裝置是否需要電池溫度檢查功能

傳回
boolean

getSerials

public  getSerials (IDevice device)

取得序號副本

參數
device	IDevice：IDevice 代表要選擇的裝置。

傳回
	序號 ERROR(/Collection)

getSerials

public  getSerials ()

傳回所要求序列的清單。

傳回

已要求 localVirtualDevice

public boolean localVirtualDeviceRequested ()

傳回
boolean

相符

public boolean matches (IDevice device)

參數
device	IDevice

傳回
boolean	如果指定的 IDevice 與提供的選項相符，則為 true。另有 false

已要求 nullDevice

public boolean nullDeviceRequested ()

傳回
boolean

已要求遠端裝置

public boolean remoteDeviceRequested ()

傳回
boolean

setBaseDeviceTypeRequested

public void setBaseDeviceTypeRequested (IDeviceSelection.BaseDeviceType type)

設定我們應使用的裝置類型。

參數
type	IDeviceSelection.BaseDeviceType

setDeviceRequested

public void setDeviceRequested (boolean deviceRequested)

設定模擬器要求的旗標

參數
deviceRequested	boolean

setDeviceTypeRequested

public void setDeviceTypeRequested (DeviceSelectionOptions.DeviceRequestedType requestedType)

參數
requestedType	DeviceSelectionOptions.DeviceRequestedType

已要求 setEmulator

public void setEmulatorRequested (boolean emulatorRequested)

設定模擬器要求的旗標

參數
emulatorRequested	boolean

setGceDeviceRequested

public void setGceDeviceRequested (boolean gceDeviceRequested)

參數
gceDeviceRequested	boolean

設定最大電池等級

public void setMaxBatteryLevel (Integer maxBattery)

設定最大電池電量

參數
maxBattery	Integer

設定最大電池溫度

public void setMaxBatteryTemperature (Integer maxBatteryTemperature)

設定最大電池電量

參數
maxBatteryTemperature	Integer

setMinBatteryLevel

public void setMinBatteryLevel (Integer minBattery)

設定最低電池電量

參數
minBattery	Integer

已要求 setNullDevice

public void setNullDeviceRequested (boolean nullDeviceRequested)

設定空值的裝置要求的標記

參數
nullDeviceRequested	boolean

設定須電池檢查

public void setRequireBatteryCheck (boolean requireCheck)

設定當電池電量未知的裝置時，是否要執行電池檢查

參數
requireCheck	boolean

設定 RequireBatteryTemperatureCheck

public void setRequireBatteryTemperatureCheck (boolean requireCheckTemprature)

設定當裝置電池溫度不明時，是否必須檢查電池溫度

參數
requireCheckTemprature	boolean

setSerial

public void setSerial (String... serialNumber)

設定序號納入清單，取代任何現有值。

參數
serialNumber	String

已要求 setStubEmulator

public void setStubEmulatorRequested (boolean stubEmulatorRequested)

設定虛設常式模擬器要求的旗標

參數
stubEmulatorRequested	boolean

已要求虛設常式

public boolean stubEmulatorRequested ()

傳回
boolean