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