自 2025 年 3 月 27 日起，我们建议您使用 android-latest-release 而非 aosp-main 构建 AOSP 并为其做出贡献。如需了解详情，请参阅 AOSP 的变更。

此页面由 Cloud Translation API 翻译。

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)` 设置 null 设备请求标志
`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` 值，如果不可用，则为 null。

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`	如果给定的 `IDevice` 与所提供的选项匹配，则为 `true`。否则返回 `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)

设置 null device requested 标志

参数
`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`