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)

將序號新增至排除清單。

addProductType

public void addProductType (String productType)

在裝置選項中新增產品類型。

addProperty

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

deviceRequested

public boolean deviceRequested ()

傳回
boolean

emulatorRequested

public boolean emulatorRequested ()

傳回
boolean

fetchEnvironmentVariable

public String fetchEnvironmentVariable (String name)

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

參數
name String：要擷取的環境變數。
傳回
String 環境變數的 String 值，如果無法取得，則為空值。

gceDeviceRequested

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 ()

傳回要求的連續劇清單。

傳回

localVirtualDeviceRequested

public boolean localVirtualDeviceRequested ()

傳回
boolean

相符

public boolean matches (IDevice device)

參數
device IDevice

傳回
boolean true：如果指定的 IDevice 與提供的選項相符。其他情況則為 false

nullDeviceRequested

public boolean nullDeviceRequested ()

傳回
boolean

remoteDeviceRequested

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

setEmulatorRequested

public void setEmulatorRequested (boolean emulatorRequested)

設定模擬器要求的標記

參數
emulatorRequested boolean

setGceDeviceRequested

public void setGceDeviceRequested (boolean gceDeviceRequested)

參數
gceDeviceRequested boolean

setMaxBatteryLevel

public void setMaxBatteryLevel (Integer maxBattery)

設定電池電量上限

參數
maxBattery Integer

setMaxBatteryTemperature

public void setMaxBatteryTemperature (Integer maxBatteryTemperature)

設定電池電量上限

參數
maxBatteryTemperature Integer

setMinBatteryLevel

public void setMinBatteryLevel (Integer minBattery)

設定電池電量下限

參數
minBattery Integer

setNullDeviceRequested

public void setNullDeviceRequested (boolean nullDeviceRequested)

設定要求的空值裝置標記

參數
nullDeviceRequested boolean

setRequireBatteryCheck

public void setRequireBatteryCheck (boolean requireCheck)

設定是否需要為電池電量不明的裝置執行電池檢查

參數
requireCheck boolean

setRequireBatteryTemperatureCheck

public void setRequireBatteryTemperatureCheck (boolean requireCheckTemprature)

設定是否需要針對電池溫度不明的裝置進行電池溫度檢查

參數
requireCheckTemprature boolean

setSerial

public void setSerial (String... serialNumber)

設定序號包含清單，取代任何現有值。

參數
serialNumber String

setStubEmulatorRequested

public void setStubEmulatorRequested (boolean stubEmulatorRequested)

設定要求的輔助程式模擬器標記

參數
stubEmulatorRequested boolean

stubEmulatorRequested

public boolean stubEmulatorRequested ()

傳回
boolean