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