A partir de 2026, para alinhar com nosso modelo de desenvolvimento estável de tronco e garantir a estabilidade da plataforma para o ecossistema, vamos publicar o código-fonte no AOSP no segundo e quarto trimestres. Para criar e contribuir com o AOSP, recomendamos usar android-latest-release em vez de aosp-main. O branch de manifesto android-latest-release sempre vai fazer referência à versão mais recente enviada ao AOSP. Para mais informações, consulte Mudanças no AOSP.

DeviceSelectionOptions

public class DeviceSelectionOptions
extends Object implements IDeviceSelection

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

Contêiner para critérios de seleção de dispositivos.

Resumo

Construtores públicos
`DeviceSelectionOptions()`

Métodos públicos
`void`	`addExcludeSerial(String serialNumber)` Adicione um número de série à lista de exclusão.
`void`	`addProductType(String productType)` Adicione um tipo de produto às opções de seleção de dispositivo.
`void`	`addProperty(String propertyKey, String propValue)` Adicionar um critério de propriedade às opções de seleção de dispositivos
`void`	`addSerial(String serialNumber)` Adicione um número de série às opções de seleção de dispositivo.
`static IDeviceSelection`	`createForSerial(String serial)` Método auxiliar de fábrica para criar um `IDeviceSelection` que só vai corresponder ao dispositivo com o número de série especificado.
`boolean`	`deviceRequested()`
`boolean`	`emulatorRequested()`
`String`	`fetchEnvironmentVariable(String name)` Função auxiliar usada para buscar variáveis de ambiente.
`boolean`	`gceDeviceRequested()`
`IDeviceSelection.BaseDeviceType`	`getBaseDeviceTypeRequested()` Retorna o tipo de dispositivo que devemos usar.
`Integer`	`getBatteryLevel(IDevice device)` Recupera o nível da bateria do dispositivo especificado.
`String`	`getDeviceProductType(IDevice device)` Recebe o tipo de produto dos dispositivos especificados.
`String`	`getDeviceProductVariant(IDevice device)` Recebe a variante de produto dos dispositivos especificados.
`DeviceSelectionOptions.DeviceRequestedType`	`getDeviceTypeRequested()`
	`getExcludeSerials()` Recebe uma cópia da lista de exclusão de números de série.
`Integer`	`getMaxBatteryLevel()` Recebe o nível máximo de bateria solicitado.
`Integer`	`getMaxBatteryTemperature()` Recebe o nível máximo de bateria solicitado
`Integer`	`getMinBatteryLevel()` Recebe o nível mínimo de bateria solicitado.
	`getNoMatchReason()` Retorna o motivo pelo qual o dispositivo não foi correspondido.
	`getProductTypes()` Recebe uma cópia da lista de tipos de produtos.
	`getProperties()` Retorna um mapa da lista de propriedades
`boolean`	`getRequireBatteryCheck()` Recebe se a verificação da bateria é necessária para dispositivos com nível de bateria desconhecido.
`boolean`	`getRequireBatteryTemperatureCheck()` Recebe se a verificação da temperatura da bateria é necessária para dispositivos com temperatura desconhecida.
	`getSerials(IDevice device)` Recebe uma cópia dos números de série
	`getSerials()` Retorna a lista de números de série solicitados.
`boolean`	`localVirtualDeviceRequested()`
`boolean`	`matches(IDevice device)`
`boolean`	`nullDeviceRequested()`
`boolean`	`remoteDeviceRequested()`
`void`	`setBaseDeviceTypeRequested(IDeviceSelection.BaseDeviceType type)` Define o tipo de dispositivo que devemos usar.
`void`	`setDeviceRequested(boolean deviceRequested)` Define a flag de emulador solicitada.
`void`	`setDeviceTypeRequested(DeviceSelectionOptions.DeviceRequestedType requestedType)`
`void`	`setEmulatorRequested(boolean emulatorRequested)` Define a flag de emulador solicitado.
`void`	`setGceDeviceRequested(boolean gceDeviceRequested)`
`void`	`setMaxBatteryLevel(Integer maxBattery)` Define o nível máximo da bateria
`void`	`setMaxBatteryTemperature(Integer maxBatteryTemperature)` Define o nível máximo da bateria
`void`	`setMinBatteryLevel(Integer minBattery)` Define o nível mínimo de bateria
`void`	`setNullDeviceRequested(boolean nullDeviceRequested)` Define a flag de dispositivo nulo solicitada
`void`	`setRequireBatteryCheck(boolean requireCheck)` Define se a verificação da bateria é necessária para dispositivos com nível de bateria desconhecido.
`void`	`setRequireBatteryTemperatureCheck(boolean requireCheckTemprature)` Define se a verificação da temperatura da bateria é necessária para dispositivos com temperatura desconhecida.
`void`	`setSerial(String... serialNumber)` Defina a lista de inclusão de números de série, substituindo os valores atuais.
`void`	`setStubEmulatorRequested(boolean stubEmulatorRequested)` Define a flag solicitada do emulador de stub.
`boolean`	`shouldCreateTemporarilyPlaceholder()` Crie um marcador de posição temporário com os metadados.
`boolean`	`stubEmulatorRequested()`

Construtores públicos

DeviceSelectionOptions

public DeviceSelectionOptions ()

Métodos públicos

addExcludeSerial

public void addExcludeSerial (String serialNumber)

Adicione um número de série à lista de exclusão.

addProductType

public void addProductType (String productType)

Adicione um tipo de produto às opções de seleção de dispositivo.

addProperty

public void addProperty (String propertyKey, 
                String propValue)

Adicionar um critério de propriedade às opções de seleção de dispositivos

Parâmetros
`propertyKey`	`String`
`propValue`	`String`

addSerial

public void addSerial (String serialNumber)

Adicione um número de série às opções de seleção de dispositivo.

createForSerial

public static IDeviceSelection createForSerial (String serial)

Método auxiliar de fábrica para criar um IDeviceSelection que só vai corresponder ao dispositivo com o número de série especificado.

Parâmetros
`serial`	`String`

Retorna
`IDeviceSelection`

deviceRequested

public boolean deviceRequested ()

Retorna
`boolean`

emulatorRequested

public boolean emulatorRequested ()

Retorna
`boolean`

fetchEnvironmentVariable

public String fetchEnvironmentVariable (String name)

Função auxiliar usada para buscar variáveis de ambiente. Ele é essencialmente um wrapper em torno de System.getenv(String). Isso é feito para fins de teste de unidade.

Parâmetros
`name`	`String`: a variável de ambiente a ser buscada.

Retorna
`String`	um valor `String` da variável de ambiente ou nulo se não estiver disponível.

gceDeviceRequested

public boolean gceDeviceRequested ()

Retorna
`boolean`

getBaseDeviceTypeRequested

public IDeviceSelection.BaseDeviceType getBaseDeviceTypeRequested ()

Retorna o tipo de dispositivo que devemos usar.

Retorna
`IDeviceSelection.BaseDeviceType`

getBatteryLevel

public Integer getBatteryLevel (IDevice device)

Recupera o nível da bateria do dispositivo especificado.

Parâmetros
`device`	`IDevice`: o `IDevice`

Retorna
`Integer`	o nível da bateria do dispositivo ou `null` se for desconhecido

getDeviceProductType

public String getDeviceProductType (IDevice device)

Recebe o tipo de produto dos dispositivos especificados.

Parâmetros
`device`	`IDevice`: o `IDevice`

Retorna
`String`	o tipo de produto do dispositivo ou `null` se for desconhecido

getDeviceProductVariant

public String getDeviceProductVariant (IDevice device)

Recebe a variante de produto dos dispositivos especificados.

Parâmetros
`device`	`IDevice`: o `IDevice`

Retorna
`String`	a variante do produto do dispositivo ou `null` se for desconhecida

getDeviceTypeRequested

public DeviceSelectionOptions.DeviceRequestedType getDeviceTypeRequested ()

Retorna
`DeviceSelectionOptions.DeviceRequestedType`

getExcludeSerials

public  getExcludeSerials ()

Recebe uma cópia da lista de exclusão de números de série.

Retorna
	um `ERROR(/Collection)` de números de série

getMaxBatteryLevel

public Integer getMaxBatteryLevel ()

Recebe o nível máximo de bateria solicitado

Retorna
`Integer`

getMaxBatteryTemperature

public Integer getMaxBatteryTemperature ()

Recebe o nível máximo de bateria solicitado

Retorna
`Integer`

getMinBatteryLevel

public Integer getMinBatteryLevel ()

Recebe o nível mínimo de bateria solicitado.

Retorna
`Integer`

getNoMatchReason

public  getNoMatchReason ()

Retorna o motivo pelo qual o dispositivo não foi correspondido.

Retorna
	um mapa do número de série para o motivo pelo qual ele não foi alocado

getProductTypes

public  getProductTypes ()

Recebe uma cópia da lista de tipos de produtos.

Retorna
	uma `ERROR(/Collection)` de tipos de produtos

getProperties

public  getProperties ()

Retorna um mapa da lista de propriedades

Retorna
	um `ERROR(/Map)` de nomes de propriedades do dispositivo para valores

getRequireBatteryCheck

public boolean getRequireBatteryCheck ()

Recebe se a verificação da bateria é necessária para dispositivos com nível de bateria desconhecido.

Retorna
`boolean`

getRequireBatteryTemperatureCheck

public boolean getRequireBatteryTemperatureCheck ()

Recebe se a verificação da temperatura da bateria é necessária para dispositivos com temperatura desconhecida.

Retorna
`boolean`

getSerials

public  getSerials (IDevice device)

Recebe uma cópia dos números de série

Parâmetros
`device`	`IDevice`: o `IDevice` que representa o dispositivo considerado para seleção.

Retorna
	um `ERROR(/Collection)` de números de série

getSerials

public  getSerials ()

Retorna a lista de números de série solicitados.

Retorna

localVirtualDeviceRequested

public boolean localVirtualDeviceRequested ()

Retorna
`boolean`

é igual a

public boolean matches (IDevice device)

Parâmetros
`device`	`IDevice`

Retorna
`boolean`	`true` se o `IDevice` fornecido corresponder às opções apresentadas. `false` caso contrário

nullDeviceRequested

public boolean nullDeviceRequested ()

Retorna
`boolean`

remoteDeviceRequested

public boolean remoteDeviceRequested ()

Retorna
`boolean`

setBaseDeviceTypeRequested

public void setBaseDeviceTypeRequested (IDeviceSelection.BaseDeviceType type)

Define o tipo de dispositivo que devemos usar.

Parâmetros
`type`	`IDeviceSelection.BaseDeviceType`

setDeviceRequested

public void setDeviceRequested (boolean deviceRequested)

Define a flag de emulador solicitada.

Parâmetros
`deviceRequested`	`boolean`

setDeviceTypeRequested

public void setDeviceTypeRequested (DeviceSelectionOptions.DeviceRequestedType requestedType)

Parâmetros
`requestedType`	`DeviceSelectionOptions.DeviceRequestedType`

setEmulatorRequested

public void setEmulatorRequested (boolean emulatorRequested)

Define a flag de emulador solicitada.

Parâmetros
`emulatorRequested`	`boolean`

setGceDeviceRequested

public void setGceDeviceRequested (boolean gceDeviceRequested)

Parâmetros
`gceDeviceRequested`	`boolean`

setMaxBatteryLevel

public void setMaxBatteryLevel (Integer maxBattery)

Define o nível máximo da bateria

Parâmetros
`maxBattery`	`Integer`

setMaxBatteryTemperature

public void setMaxBatteryTemperature (Integer maxBatteryTemperature)

Define o nível máximo da bateria

Parâmetros
`maxBatteryTemperature`	`Integer`

setMinBatteryLevel

public void setMinBatteryLevel (Integer minBattery)

Define o nível mínimo de bateria

Parâmetros
`minBattery`	`Integer`

setNullDeviceRequested

public void setNullDeviceRequested (boolean nullDeviceRequested)

Define a flag de dispositivo nulo solicitada

Parâmetros
`nullDeviceRequested`	`boolean`

setRequireBatteryCheck

public void setRequireBatteryCheck (boolean requireCheck)

Define se a verificação da bateria é necessária para dispositivos com nível de bateria desconhecido.

Parâmetros
`requireCheck`	`boolean`

setRequireBatteryTemperatureCheck

public void setRequireBatteryTemperatureCheck (boolean requireCheckTemprature)

Define se a verificação da temperatura da bateria é necessária para dispositivos com temperatura desconhecida.

Parâmetros
`requireCheckTemprature`	`boolean`

setSerial

public void setSerial (String... serialNumber)

Defina a lista de inclusão de números de série, substituindo os valores atuais.

Parâmetros
`serialNumber`	`String`

setStubEmulatorRequested

public void setStubEmulatorRequested (boolean stubEmulatorRequested)

Define a flag solicitada do emulador de stub.

Parâmetros
`stubEmulatorRequested`	`boolean`

shouldCreateTemporarilyPlaceholder

public boolean shouldCreateTemporarilyPlaceholder ()

Crie um marcador de posição temporário com os metadados.

Retorna
`boolean`

stubEmulatorRequested

public boolean stubEmulatorRequested ()

Retorna
`boolean`