DeviceSetup

public class DeviceSetup
extends BaseTargetPreparer implements IExternalDependency

java.lang.Object
↳	com.android.tradefed.targetprep.BaseTargetPreparer
	↳	com.android.tradefed.targetprep.DeviceSetup

---

Um ITargetPreparer que configura um dispositivo para testes com base nos Options fornecidos.

Requer um dispositivo em que o "adb root" seja possível, normalmente um tipo de build userdebug.

Deve ser realizada após o flash de um novo build.

Observação:este preparador é destinado a laboratórios de testes contínuos e pressupõe que o dispositivo em teste será atualizado e apagado antes da próxima execução. Por isso, ele faz uma limpeza mínima durante a desmontagem e não deve ser usado em um módulo de teste.

Resumo

Campos
protected BinaryState	mAirplaneMode
protected BinaryState	mAutoRotate
protected BinaryState	mAutoUpdateTime
protected BinaryState	mAutoUpdateTimezone
protected BinaryState	mBatterySaver
protected Integer	mBatterySaverTrigger
protected BinaryState	mBluetooth
protected BinaryState	mCell
protected BinaryState	mCellAutoSetting
protected BinaryState	mData
protected Integer	mDefaultSimData
protected Integer	mDefaultSimSms
protected Integer	mDefaultSimVoice
protected boolean	mDisableAudio
protected BinaryState	mDisableCwWifiMediator
protected boolean	mDisableDalvikVerifier
protected boolean	mDisableDialing
protected boolean	mDisableDoze
protected boolean	mEnableFullBatteryStatsHistory
protected BinaryState	mEthernet
protected boolean	mForceSkipRunCommands
protected boolean	mForceSkipSettings
protected boolean	mForceSkipSystemProps
protected MultiMap<String, String>	mGlobalSettings
protected BinaryState	mHideErrorDialogs
protected BinaryState	mInstallNonMarketApps
protected File	mLocalDataFile
protected BinaryState	mLocationGps
protected BinaryState	mLocationNetwork
protected long	mMinExternalStorageKb
protected BinaryState	mNfc
protected BinaryState	mNotificationLed
protected boolean	mOptimizedPropertySetting
protected File	mPreviousProperties
protected String	mRemoteDataPath
protected boolean	mRestoreProperties
protected boolean	mRestoreSettings
protected	mRunCommandAfterSettings
protected	mRunCommandBeforeSettings
protected BinaryState	mScreenAdaptiveBrightness
protected BinaryState	mScreenAlwaysOn
protected BinaryState	mScreenAmbientMode
protected Integer	mScreenBrightness
protected BinaryState	mScreenSaver
protected Long	mScreenTimeoutSecs
protected MultiMap<String, String>	mSecureSettings
protected	mSetProps
protected boolean	mSetTestHarness
protected BinaryState	mSyncTimezoneWithHost
protected MultiMap<String, String>	mSystemSettings
protected String	mTimezone
protected boolean	mTriggerMediaMounted
protected BinaryState	mWakeGesture
protected BinaryState	mWifi
protected String	mWifiPsk
protected BinaryState	mWifiScanAlwaysEnabled
protected String	mWifiSsid
protected	mWifiSsidToPsk
protected BinaryState	mWifiWatchdog

Construtores públicos
DeviceSetup()

Métodos públicos
void	changeSettings(ITestDevice device) Mude as configurações no dispositivo.
	getDependencies()
ITestDevice	getDevice(TestInformation testInfo)
boolean	isForceSkipSystemProps()
void	processDeprecatedOptions(ITestDevice device) Processa as opções descontinuadas, convertendo-as nas opções usadas atualmente.
void	processOptions(ITestDevice device) Processe todos os Options e os transforme em propriedades do sistema, configurações ou comandos de execução.
static void	setCommandForBinaryState(BinaryState state, commands, String onCommand, String offCommand) Método auxiliar para adicionar um comando de execução LIGAR/DESLIGAR a ser executado no dispositivo.
void	setGlobalSetting(String key, String value) Exposto para testes de unidade
void	setSecureSetting(String key, String value) Exposto para testes de unidade
static void	setSettingForBinaryState(BinaryState state, MultiMap<String, String> settingsMap, String setting, String onValue, String offValue) Método auxiliar para adicionar uma configuração ATIVO/DESATIVO a um mapa de configuração.
void	setSystemSetting(String key, String value) Exposto para testes de unidade
void	setUp(TestInformation testInfo)
void	tearDown(TestInformation testInfo, Throwable e)

Métodos protegidos
void	setAirplaneMode(BinaryState airplaneMode) Exposto para testes de unidade
void	setAutoRotate(BinaryState autoRotate) Exposto para testes de unidade
void	setAutoUpdateTime(BinaryState autoUpdateTime) Exposto para testes de unidade
void	setAutoUpdateTimezone(BinaryState autoUpdateTimezone) Exposto para testes de unidade
void	setBatterySaver(BinaryState batterySaver) Exposto para testes de unidade
void	setBatterySaverTrigger(Integer batterySaverTrigger) Exposto para testes de unidade
void	setBluetooth(BinaryState bluetooth) Exposto para testes de unidade
void	setCell(BinaryState cell)
void	setCellAutoSetting(BinaryState cellAutoSetting)
void	setData(BinaryState data)
void	setDefaultSimData(Integer defaultSimData) Exposto para testes de unidade
void	setDefaultSimSms(Integer defaultSimSms) Exposto para testes de unidade
void	setDefaultSimVoice(Integer defaultSimVoice) Exposto para testes de unidade
void	setDeprecatedAudioSilent(boolean silent) Este método foi descontinuado. Use setDisableAudio(boolean).
void	setDeprecatedMinExternalStoreSpace(long storeSpace) Este método foi descontinuado. Use setMinExternalStorageKb(long).
void	setDeprecatedSetProp(String prop) Este método foi descontinuado. Use setProperty(String, String).
void	setDisableAudio(boolean disable) Exposto para testes de unidade
void	setDisableCwWifiMediator(BinaryState disableCwWifiMediator)
void	setDisableDalvikVerifier(boolean disableDalvikVerifier) Exposto para testes de unidade
void	setDisableDialing(boolean disableDialing) Exposto para testes de unidade
void	setDisableDoze(boolean disableDoze) Exposto para testes de unidade
void	setEnableFullBatteryStatsHistory(boolean enableFullBatteryStatsHistory) Exposto para testes de unidade
void	setEthernet(BinaryState ethernet) Exposto para testes de unidade
void	setForceRootSetup(boolean force)
void	setForceSkipSystemProps(boolean force) Exposto para testes de unidade
void	setInstallNonMarketApps(BinaryState installNonMarketApps) Exposto para testes de unidade
void	setLocalDataPath(File path) Exposto para testes de unidade
void	setLocationGps(BinaryState locationGps) Exposto para testes de unidade
void	setLocationNetwork(BinaryState locationNetwork) Exposto para testes de unidade
void	setMinExternalStorageKb(long storageKb) Exposto para testes de unidade
void	setNfc(BinaryState nfc) Exposto para testes de unidade
void	setNotificationLed(BinaryState notificationLed) Exposto para testes de unidade
void	setProperty(String key, String value) Exposto para testes de unidade
void	setRestoreProperties(boolean restoreProperties) Exposto para testes de unidade
void	setRestoreSettings(boolean restoreSettings) Exposto para testes de unidade
void	setScreenAdaptiveBrightness(BinaryState screenAdaptiveBrightness) Exposto para testes de unidade
void	setScreenAlwaysOn(BinaryState screenAlwaysOn) Exposto para testes de unidade
void	setScreenAmbientMode(BinaryState screenAmbientMode) Exposto para testes de unidade
void	setScreenBrightness(Integer screenBrightness) Exposto para testes de unidade
void	setScreenSaver(BinaryState screenSaver) Exposto para testes de unidade
void	setScreenTimeoutSecs(Long screenTimeoutSecs) Exposto para testes de unidade
void	setTestHarness(boolean setTestHarness) Exposto para testes de unidade
void	setTimezone(String timezone) Exposto para testes de unidade
void	setTriggerMediaMounted(boolean triggerMediaMounted) Exposto para testes de unidade
void	setWakeGesture(BinaryState wakeGesture) Exposto para testes de unidade
void	setWifi(BinaryState wifi) Exposto para testes de unidade
void	setWifiNetwork(String wifiNetwork) Exposto para testes de unidade
void	setWifiPsk(String wifiPsk)
void	setWifiScanAlwaysEnabled(BinaryState wifiScanAlwaysEnabled) Exposto para testes de unidade
void	setWifiSsidToPsk( wifiSssidToPsk)
void	setWifiWatchdog(BinaryState wifiWatchdog) Exposto para testes de unidade

Campos

mAirplaneMode

protected BinaryState mAirplaneMode

mAutoRotate

protected BinaryState mAutoRotate

mAutoUpdateTime

protected BinaryState mAutoUpdateTime

mAutoUpdateTimezone

protected BinaryState mAutoUpdateTimezone

mBatterySaver

protected BinaryState mBatterySaver

mBatterySaverTrigger

protected Integer mBatterySaverTrigger

mBluetooth

protected BinaryState mBluetooth

mCell

protected BinaryState mCell

mCellAutoSetting

protected BinaryState mCellAutoSetting

mData

protected BinaryState mData

mDefaultSimData

protected Integer mDefaultSimData

mDefaultSimSms

protected Integer mDefaultSimSms

mDefaultSimVoice

protected Integer mDefaultSimVoice

mDisableAudio

protected boolean mDisableAudio

mDisableCwWifiMediator

protected BinaryState mDisableCwWifiMediator

mDisableDalvikVerifier

protected boolean mDisableDalvikVerifier

mDisableDialing

protected boolean mDisableDialing

mDisableDoze

protected boolean mDisableDoze

mEnableFullBatteryStatsHistory

protected boolean mEnableFullBatteryStatsHistory

mEthernet

protected BinaryState mEthernet

mForceSkipRunCommands

protected boolean mForceSkipRunCommands

mForceSkipSettings

protected boolean mForceSkipSettings

mForceSkipSystemProps

protected boolean mForceSkipSystemProps

mGlobalSettings

protected MultiMap<String, String> mGlobalSettings

mHideErrorDialogs

protected BinaryState mHideErrorDialogs

mInstallNonMarketApps

protected BinaryState mInstallNonMarketApps

mLocalDataFile

protected File mLocalDataFile

mLocationGps

protected BinaryState mLocationGps

mLocationNetwork

protected BinaryState mLocationNetwork

mMinExternalStorageKb

protected long mMinExternalStorageKb

mNfc

protected BinaryState mNfc

mNotificationLed

protected BinaryState mNotificationLed

mOptimizedPropertySetting

protected boolean mOptimizedPropertySetting

mPreviousProperties

protected File mPreviousProperties

mRemoteDataPath

protected String mRemoteDataPath

mRestoreProperties

protected boolean mRestoreProperties

mRestoreSettings

protected boolean mRestoreSettings

mRunCommandAfterSettings

protected  mRunCommandAfterSettings

mRunCommandBeforeSettings

protected  mRunCommandBeforeSettings

mScreenAdaptiveBrightness

protected BinaryState mScreenAdaptiveBrightness

mScreenAlwaysOn

protected BinaryState mScreenAlwaysOn

mScreenAmbientMode

protected BinaryState mScreenAmbientMode

mScreenBrightness

protected Integer mScreenBrightness

mScreenSaver

protected BinaryState mScreenSaver

mScreenTimeoutSecs

protected Long mScreenTimeoutSecs

mSecureSettings

protected MultiMap<String, String> mSecureSettings

mSetProps

protected  mSetProps

mSetTestHarness

protected boolean mSetTestHarness

mSyncTimezoneWithHost

protected BinaryState mSyncTimezoneWithHost

mSystemSettings

protected MultiMap<String, String> mSystemSettings

mTimezone

protected String mTimezone

mTriggerMediaMounted

protected boolean mTriggerMediaMounted

mWakeGesture

protected BinaryState mWakeGesture

mWifi

protected BinaryState mWifi

mWifiPsk

protected String mWifiPsk

mWifiScanAlwaysEnabled

protected BinaryState mWifiScanAlwaysEnabled

mWifiSsid

protected String mWifiSsid

mWifiSsidToPsk

protected  mWifiSsidToPsk

mWifiWatchdog

protected BinaryState mWifiWatchdog

Construtores públicos

DeviceSetup

public DeviceSetup ()

Métodos públicos

changeSettings

public void changeSettings (ITestDevice device)

Mude as configurações no dispositivo.

Exposição para que as classes filhas possam substituir.

Parâmetros
device	ITestDevice: o ITestDevice

Gera
DeviceNotAvailableException	se o dispositivo não estiver disponível
TargetSetupError	se houver uma falha ao definir as configurações

getDependencies

public  getDependencies ()

Retorna

getDevice

public ITestDevice getDevice (TestInformation testInfo)

Parâmetros
testInfo	TestInformation

Retorna
ITestDevice

isForceSkipSystemProps

public boolean isForceSkipSystemProps ()

Retorna
boolean

processDeprecatedOptions

public void processDeprecatedOptions (ITestDevice device)

Processa as opções descontinuadas, convertendo-as nas opções usadas atualmente.

Esse método precisa ser executado antes de qualquer outro método de processamento. Será gerada uma TargetSetupError se a opção descontinuada substituir uma opção especificada que não foi descontinuada.

Parâmetros
device	ITestDevice

Gera
TargetSetupError	se houver um conflito

processOptions

public void processOptions (ITestDevice device)

Processe todos os Options e os transforme em propriedades do sistema, configurações ou comandos de execução. Não executa comandos no dispositivo no momento.

Exposição para que as classes filhas possam substituir isso.

Parâmetros
device	ITestDevice: o ITestDevice

Gera
DeviceNotAvailableException	se o dispositivo não estiver disponível
TargetSetupError	se os Options conflitarem

setCommandForBinaryState

public static void setCommandForBinaryState (BinaryState state, 
                 commands, 
                String onCommand, 
                String offCommand)

Método auxiliar para adicionar um comando de execução LIGAR/DESLIGAR a ser executado no dispositivo.

Parâmetros
state	BinaryState: o BinaryState
commands	: a lista de comandos para adicionar o comando de ativação ou desativação.
onCommand	String: o comando a ser executado se estiver ATIVADO. Será ignorado se o comando for null.
offCommand	String: o comando a ser executado se estiver DESLIGADO. Será ignorado se o comando for null.

setGlobalSetting

public void setGlobalSetting (String key, 
                String value)

Exposto para testes de unidade

Parâmetros
key	String
value	String

setSecureSetting

public void setSecureSetting (String key, 
                String value)

Exposto para testes de unidade

Parâmetros
key	String
value	String

setSettingForBinaryState

public static void setSettingForBinaryState (BinaryState state, 
                MultiMap<String, String> settingsMap, 
                String setting, 
                String onValue, 
                String offValue)

Método auxiliar para adicionar uma configuração ATIVO/DESATIVO a um mapa de configuração.

Parâmetros
state	BinaryState: o BinaryState
settingsMap	MultiMap: o MultiMap usado para armazenar as configurações.
setting	String: a chave de configuração
onValue	String: o valor se estiver ATIVADO
offValue	String: o valor se DESATIVADO

setSystemSetting

public void setSystemSetting (String key, 
                String value)

Exposto para testes de unidade

Parâmetros
key	String
value	String

setUp

public void setUp (TestInformation testInfo)

Parâmetros
testInfo	TestInformation

Gera
BuildError
DeviceNotAvailableException
TargetSetupError

tearDown

public void tearDown (TestInformation testInfo, 
                Throwable e)

Parâmetros
testInfo	TestInformation
e	Throwable

Gera
DeviceNotAvailableException

Métodos protegidos

setAirplaneMode

protected void setAirplaneMode (BinaryState airplaneMode)

Exposto para testes de unidade

Parâmetros
airplaneMode	BinaryState

setAutoRotate

protected void setAutoRotate (BinaryState autoRotate)

Exposto para testes de unidade

Parâmetros
autoRotate	BinaryState

setAutoUpdateTime

protected void setAutoUpdateTime (BinaryState autoUpdateTime)

Exposto para testes de unidade

Parâmetros
autoUpdateTime	BinaryState

setAutoUpdateTimezone

protected void setAutoUpdateTimezone (BinaryState autoUpdateTimezone)

Exposto para testes de unidade

Parâmetros
autoUpdateTimezone	BinaryState

setBatterySaver

protected void setBatterySaver (BinaryState batterySaver)

Exposto para testes de unidade

Parâmetros
batterySaver	BinaryState

setBatterySaverTrigger

protected void setBatterySaverTrigger (Integer batterySaverTrigger)

Exposto para testes de unidade

Parâmetros
batterySaverTrigger	Integer

setBluetooth

protected void setBluetooth (BinaryState bluetooth)

Exposto para testes de unidade

Parâmetros
bluetooth	BinaryState

setCell

protected void setCell (BinaryState cell)

Parâmetros
cell	BinaryState

setCellAutoSetting

protected void setCellAutoSetting (BinaryState cellAutoSetting)

Parâmetros
cellAutoSetting	BinaryState

setData

protected void setData (BinaryState data)

Parâmetros
data	BinaryState

setDefaultSimData

protected void setDefaultSimData (Integer defaultSimData)

Exposto para testes de unidade

Parâmetros
defaultSimData	Integer

setDefaultSimSms

protected void setDefaultSimSms (Integer defaultSimSms)

Exposto para testes de unidade

Parâmetros
defaultSimSms	Integer

setDefaultSimVoice

protected void setDefaultSimVoice (Integer defaultSimVoice)

Exposto para testes de unidade

Parâmetros
defaultSimVoice	Integer

setDeprecatedAudioSilent

protected void setDeprecatedAudioSilent (boolean silent)

Este método foi descontinuado.
use setDisableAudio(boolean).

Exposto para testes de unidade

Parâmetros
silent	boolean

setDeprecatedMinExternalStoreSpace

protected void setDeprecatedMinExternalStoreSpace (long storeSpace)

Este método foi descontinuado.
use setMinExternalStorageKb(long).

Exposto para testes de unidade

Parâmetros
storeSpace	long

setDeprecatedSetProp

protected void setDeprecatedSetProp (String prop)

Este método foi descontinuado.
use setProperty(String, String).

Exposto para testes de unidade

Parâmetros
prop	String

setDisableAudio

protected void setDisableAudio (boolean disable)

Exposto para testes de unidade

Parâmetros
disable	boolean

setDisableCwWifiMediator

protected void setDisableCwWifiMediator (BinaryState disableCwWifiMediator)

Parâmetros
disableCwWifiMediator	BinaryState

setDisableDalvikVerifier

protected void setDisableDalvikVerifier (boolean disableDalvikVerifier)

Exposto para testes de unidade

Parâmetros
disableDalvikVerifier	boolean

setDisableDialing

protected void setDisableDialing (boolean disableDialing)

Exposto para testes de unidade

Parâmetros
disableDialing	boolean

setDisableDoze

protected void setDisableDoze (boolean disableDoze)

Exposto para testes de unidade

Parâmetros
disableDoze	boolean

setEnableFullBatteryStatsHistory

protected void setEnableFullBatteryStatsHistory (boolean enableFullBatteryStatsHistory)

Exposto para testes de unidade

Parâmetros
enableFullBatteryStatsHistory	boolean

setEthernet

protected void setEthernet (BinaryState ethernet)

Exposto para testes de unidade

Parâmetros
ethernet	BinaryState

setForceRootSetup

protected void setForceRootSetup (boolean force)

Parâmetros
force	boolean

setForceSkipSystemProps

protected void setForceSkipSystemProps (boolean force)

Exposto para testes de unidade

Parâmetros
force	boolean

setInstallNonMarketApps

protected void setInstallNonMarketApps (BinaryState installNonMarketApps)

Exposto para testes de unidade

Parâmetros
installNonMarketApps	BinaryState

setLocalDataPath

protected void setLocalDataPath (File path)

Exposto para testes de unidade

Parâmetros
path	File

setLocationGps

protected void setLocationGps (BinaryState locationGps)

Exposto para testes de unidade

Parâmetros
locationGps	BinaryState

setLocationNetwork

protected void setLocationNetwork (BinaryState locationNetwork)

Exposto para testes de unidade

Parâmetros
locationNetwork	BinaryState

setMinExternalStorageKb

protected void setMinExternalStorageKb (long storageKb)

Exposto para testes de unidade

Parâmetros
storageKb	long

setNfc

protected void setNfc (BinaryState nfc)

Exposto para testes de unidade

Parâmetros
nfc	BinaryState

setNotificationLed

protected void setNotificationLed (BinaryState notificationLed)

Exposto para testes de unidade

Parâmetros
notificationLed	BinaryState

setProperty

protected void setProperty (String key, 
                String value)

Exposto para testes de unidade

Parâmetros
key	String
value	String

setRestoreProperties

protected void setRestoreProperties (boolean restoreProperties)

Exposto para testes de unidade

Parâmetros
restoreProperties	boolean

setRestoreSettings

protected void setRestoreSettings (boolean restoreSettings)

Exposto para testes de unidade

Parâmetros
restoreSettings	boolean

setScreenAdaptiveBrightness

protected void setScreenAdaptiveBrightness (BinaryState screenAdaptiveBrightness)

Exposto para testes de unidade

Parâmetros
screenAdaptiveBrightness	BinaryState

setScreenAlwaysOn

protected void setScreenAlwaysOn (BinaryState screenAlwaysOn)

Exposto para testes de unidade

Parâmetros
screenAlwaysOn	BinaryState

setScreenAmbientMode

protected void setScreenAmbientMode (BinaryState screenAmbientMode)

Exposto para testes de unidade

Parâmetros
screenAmbientMode	BinaryState

setScreenBrightness

protected void setScreenBrightness (Integer screenBrightness)

Exposto para testes de unidade

Parâmetros
screenBrightness	Integer

setScreenSaver

protected void setScreenSaver (BinaryState screenSaver)

Exposto para testes de unidade

Parâmetros
screenSaver	BinaryState

setScreenTimeoutSecs

protected void setScreenTimeoutSecs (Long screenTimeoutSecs)

Exposto para testes de unidade

Parâmetros
screenTimeoutSecs	Long

setTestHarness

protected void setTestHarness (boolean setTestHarness)

Exposto para testes de unidade

Parâmetros
setTestHarness	boolean

setTimeZone

protected void setTimezone (String timezone)

Exposto para testes de unidade

Parâmetros
timezone	String

setTriggerMediaMounted

protected void setTriggerMediaMounted (boolean triggerMediaMounted)

Exposto para testes de unidade

Parâmetros
triggerMediaMounted	boolean

setWakeGesture

protected void setWakeGesture (BinaryState wakeGesture)

Exposto para testes de unidade

Parâmetros
wakeGesture	BinaryState

setWifi

protected void setWifi (BinaryState wifi)

Exposto para testes de unidade

Parâmetros
wifi	BinaryState

setWifiNetwork

protected void setWifiNetwork (String wifiNetwork)

Exposto para testes de unidade

Parâmetros
wifiNetwork	String

setWifiPsk

protected void setWifiPsk (String wifiPsk)

Parâmetros
wifiPsk	String

setWifiScanAlwaysEnabled

protected void setWifiScanAlwaysEnabled (BinaryState wifiScanAlwaysEnabled)

Exposto para testes de unidade

Parâmetros
wifiScanAlwaysEnabled	BinaryState

setWifiSsidToPsk

protected void setWifiSsidToPsk ( wifiSssidToPsk)

Parâmetros
wifiSssidToPsk

setWifiWatchdog

protected void setWifiWatchdog (BinaryState wifiWatchdog)

Exposto para testes de unidade

Parâmetros
wifiWatchdog	BinaryState