DeviceSetup

public class DeviceSetup
extends BaseTargetPreparer implements IExternalDependency

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


Un ITargetPreparer que configura un dispositivo para realizar pruebas en función de los Option proporcionados.

Requiere un dispositivo en el que sea posible usar "adb root", por lo general, un tipo de compilación userdebug.

Se debe realizar después de que se actualice una compilación nueva.

Nota: Este preparador está diseñado para laboratorios de pruebas continuas y supone que el dispositivo en prueba se borrará y se le escribirá un firmware nuevo antes de la siguiente ejecución. Por lo tanto, realiza una limpieza mínima durante la baja y no debe usarse en un módulo de prueba.

Resumen

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

Constructores públicos

DeviceSetup()

Métodos públicos

void changeSettings(ITestDevice device)

Cambia la configuración del dispositivo.

getDependencies()
ITestDevice getDevice(TestInformation testInfo)
boolean isForceSkipSystemProps()
void processDeprecatedOptions(ITestDevice device)

Procesa las opciones obsoletas y las convierte en las opciones que se usan actualmente.

void processOptions(ITestDevice device)

Procesa todos los Option y conviértelos en elementos del sistema, parámetros de configuración o comandos de ejecución.

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

Método auxiliar para agregar un comando de ejecución de encendido/apagado que se ejecutará en el dispositivo.

void setGlobalSetting(String key, String value)

Se expone para pruebas de unidades

void setSecureSetting(String key, String value)

Se expone para pruebas de unidades

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

Es un método auxiliar para agregar un parámetro de configuración de encendido/apagado a un mapa de configuración.

void setSystemSetting(String key, String value)

Se expone para pruebas de unidades

void setUp(TestInformation testInfo)

void tearDown(TestInformation testInfo, Throwable e)

Métodos protegidos

void setAirplaneMode(BinaryState airplaneMode)

Se expone para pruebas de unidades

void setAutoRotate(BinaryState autoRotate)

Se expone para pruebas de unidades

void setAutoUpdateTime(BinaryState autoUpdateTime)

Se expone para pruebas de unidades

void setAutoUpdateTimezone(BinaryState autoUpdateTimezone)

Se expone para pruebas de unidades

void setBatterySaver(BinaryState batterySaver)

Se expone para pruebas de unidades

void setBatterySaverTrigger(Integer batterySaverTrigger)

Se expone para pruebas de unidades

void setBluetooth(BinaryState bluetooth)

Se expone para pruebas de unidades

void setCell(BinaryState cell)
void setCellAutoSetting(BinaryState cellAutoSetting)
void setData(BinaryState data)
void setDefaultSimData(Integer defaultSimData)

Se expone para pruebas de unidades

void setDefaultSimSms(Integer defaultSimSms)

Se expone para pruebas de unidades

void setDefaultSimVoice(Integer defaultSimVoice)

Se expone para pruebas de unidades

void setDeprecatedAudioSilent(boolean silent)

Este método dejó de estar disponible. Usa setDisableAudio(boolean) en su lugar.

void setDeprecatedMinExternalStoreSpace(long storeSpace)

Este método dejó de estar disponible. Usa setMinExternalStorageKb(long) en su lugar.

void setDeprecatedSetProp(String prop)

Este método dejó de estar disponible. Usa setProperty(String, String) en su lugar.

void setDisableAudio(boolean disable)

Se expone para pruebas de unidades

void setDisableCwWifiMediator(BinaryState disableCwWifiMediator)
void setDisableDalvikVerifier(boolean disableDalvikVerifier)

Se expone para pruebas de unidades

void setDisableDialing(boolean disableDialing)

Se expone para pruebas de unidades

void setDisableDoze(boolean disableDoze)

Se expone para pruebas de unidades

void setEnableFullBatteryStatsHistory(boolean enableFullBatteryStatsHistory)

Se expone para pruebas de unidades

void setEthernet(BinaryState ethernet)

Se expone para pruebas de unidades

void setForceRootSetup(boolean force)
void setForceSkipSystemProps(boolean force)

Se expone para pruebas de unidades

void setInstallNonMarketApps(BinaryState installNonMarketApps)

Se expone para pruebas de unidades

void setLocalDataPath(File path)

Se expone para pruebas de unidades

void setLocationGps(BinaryState locationGps)

Se expone para pruebas de unidades

void setLocationNetwork(BinaryState locationNetwork)

Se expone para pruebas de unidades

void setMinExternalStorageKb(long storageKb)

Se expone para pruebas de unidades

void setNfc(BinaryState nfc)

Se expone para pruebas de unidades

void setNotificationLed(BinaryState notificationLed)

Se expone para pruebas de unidades

void setProperty(String key, String value)

Se expone para pruebas de unidades

void setRestoreProperties(boolean restoreProperties)

Se expone para pruebas de unidades

void setRestoreSettings(boolean restoreSettings)

Se expone para pruebas de unidades

void setScreenAdaptiveBrightness(BinaryState screenAdaptiveBrightness)

Se expone para pruebas de unidades

void setScreenAlwaysOn(BinaryState screenAlwaysOn)

Se expone para pruebas de unidades

void setScreenAmbientMode(BinaryState screenAmbientMode)

Se expone para pruebas de unidades

void setScreenBrightness(Integer screenBrightness)

Se expone para pruebas de unidades

void setScreenSaver(BinaryState screenSaver)

Se expone para pruebas de unidades

void setScreenTimeoutSecs(Long screenTimeoutSecs)

Se expone para pruebas de unidades

void setTestHarness(boolean setTestHarness)

Se expone para pruebas de unidades

void setTimezone(String timezone)

Se expone para pruebas de unidades

void setTriggerMediaMounted(boolean triggerMediaMounted)

Se expone para pruebas de unidades

void setWakeGesture(BinaryState wakeGesture)

Se expone para pruebas de unidades

void setWifi(BinaryState wifi)

Se expone para pruebas de unidades

void setWifiNetwork(String wifiNetwork)

Se expone para pruebas de unidades

void setWifiPsk(String wifiPsk)
void setWifiScanAlwaysEnabled(BinaryState wifiScanAlwaysEnabled)

Se expone para pruebas de unidades

void setWifiSsidToPsk( wifiSssidToPsk)
void setWifiWatchdog(BinaryState wifiWatchdog)

Se expone para pruebas de unidades

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

Constructores públicos

DeviceSetup

public DeviceSetup ()

Métodos públicos

changeSettings

public void changeSettings (ITestDevice device)

Cambia la configuración del dispositivo.

Se expone para que las clases secundarias puedan anularlo.

Parámetros
device ITestDevice: El ITestDevice

Arroja
DeviceNotAvailableException si el dispositivo no está disponible
TargetSetupError si se produjo un error al configurar la configuración

getDependencies

public  getDependencies ()

Muestra

getDevice

public ITestDevice getDevice (TestInformation testInfo)

Parámetros
testInfo TestInformation

Muestra
ITestDevice

isForceSkipSystemProps

public boolean isForceSkipSystemProps ()

Muestra
boolean

processDeprecatedOptions

public void processDeprecatedOptions (ITestDevice device)

Procesa las opciones obsoletas y las convierte en las opciones que se usan actualmente.

Este método se debe ejecutar antes que cualquier otro método de procesamiento. Lanzará un TargetSetupError si la opción obsoleta anula una opción especificada que no está obsoleta.

Parámetros
device ITestDevice

Arroja
TargetSetupError si hay un conflicto

processOptions

public void processOptions (ITestDevice device)

Procesa todos los Option y conviértelos en elementos del sistema, parámetros de configuración o comandos de ejecución. No ejecuta ningún comando en el dispositivo en este momento.

Se expone para que las clases secundarias puedan anularlo.

Parámetros
device ITestDevice: El ITestDevice

Arroja
DeviceNotAvailableException si el dispositivo no está disponible
TargetSetupError si los Options entran en conflicto

setCommandForBinaryState

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

Método auxiliar para agregar un comando de ejecución de encendido/apagado que se ejecutará en el dispositivo.

Parámetros
state BinaryState: El BinaryState

commands : Es la lista de comandos a los que se agregará el comando de activación o desactivación.

onCommand String: Es el comando que se ejecutará si está ACTIVADO. Se ignora si el comando es null.

offCommand String: Es el comando que se ejecutará si está desactivado. Se ignora si el comando es null.

setGlobalSetting

public void setGlobalSetting (String key, 
                String value)

Se expone para pruebas de unidades

Parámetros
key String

value String

setSecureSetting

public void setSecureSetting (String key, 
                String value)

Se expone para pruebas de unidades

Parámetros
key String

value String

setSettingForBinaryState

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

Es un método auxiliar para agregar un parámetro de configuración de encendido/apagado a un mapa de configuración.

Parámetros
state BinaryState: El BinaryState

settingsMap MultiMap: Es el MultiMap que se usa para almacenar la configuración.

setting String: La clave de configuración

onValue String: Es el valor si está ACTIVADO.

offValue String: Es el valor si está desactivado.

setSystemSetting

public void setSystemSetting (String key, 
                String value)

Se expone para pruebas de unidades

Parámetros
key String

value String

setUp

public void setUp (TestInformation testInfo)

Parámetros
testInfo TestInformation

Arroja
BuildError
DeviceNotAvailableException
TargetSetupError

tearDown

public void tearDown (TestInformation testInfo, 
                Throwable e)

Parámetros
testInfo TestInformation

e Throwable

Arroja
DeviceNotAvailableException

Métodos protegidos

setAirplaneMode

protected void setAirplaneMode (BinaryState airplaneMode)

Se expone para pruebas de unidades

Parámetros
airplaneMode BinaryState

setAutoRotate

protected void setAutoRotate (BinaryState autoRotate)

Se expone para pruebas de unidades

Parámetros
autoRotate BinaryState

setAutoUpdateTime

protected void setAutoUpdateTime (BinaryState autoUpdateTime)

Se expone para pruebas de unidades

Parámetros
autoUpdateTime BinaryState

setAutoUpdateTimezone

protected void setAutoUpdateTimezone (BinaryState autoUpdateTimezone)

Se expone para pruebas de unidades

Parámetros
autoUpdateTimezone BinaryState

setBatterySaver

protected void setBatterySaver (BinaryState batterySaver)

Se expone para pruebas de unidades

Parámetros
batterySaver BinaryState

setBatterySaverTrigger

protected void setBatterySaverTrigger (Integer batterySaverTrigger)

Se expone para pruebas de unidades

Parámetros
batterySaverTrigger Integer

setBluetooth

protected void setBluetooth (BinaryState bluetooth)

Se expone para pruebas de unidades

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)

Se expone para pruebas de unidades

Parámetros
defaultSimData Integer

setDefaultSimSms

protected void setDefaultSimSms (Integer defaultSimSms)

Se expone para pruebas de unidades

Parámetros
defaultSimSms Integer

setDefaultSimVoice

protected void setDefaultSimVoice (Integer defaultSimVoice)

Se expone para pruebas de unidades

Parámetros
defaultSimVoice Integer

setDeprecatedAudioSilent

protected void setDeprecatedAudioSilent (boolean silent)

Este método dejó de estar disponible.
Usa setDisableAudio(boolean) en su lugar.

Se expone para pruebas de unidades

Parámetros
silent boolean

setDeprecatedMinExternalStoreSpace

protected void setDeprecatedMinExternalStoreSpace (long storeSpace)

Este método dejó de estar disponible.
Usa setMinExternalStorageKb(long) en su lugar.

Se expone para pruebas de unidades

Parámetros
storeSpace long

setDeprecatedSetProp

protected void setDeprecatedSetProp (String prop)

Este método dejó de estar disponible.
Usa setProperty(String, String) en su lugar.

Se expone para pruebas de unidades

Parámetros
prop String

setDisableAudio

protected void setDisableAudio (boolean disable)

Se expone para pruebas de unidades

Parámetros
disable boolean

setDisableCwWifiMediator

protected void setDisableCwWifiMediator (BinaryState disableCwWifiMediator)

Parámetros
disableCwWifiMediator BinaryState

setDisableDalvikVerifier

protected void setDisableDalvikVerifier (boolean disableDalvikVerifier)

Se expone para pruebas de unidades

Parámetros
disableDalvikVerifier boolean

setDisableDialing

protected void setDisableDialing (boolean disableDialing)

Se expone para pruebas de unidades

Parámetros
disableDialing boolean

setDisableDoze

protected void setDisableDoze (boolean disableDoze)

Se expone para pruebas de unidades

Parámetros
disableDoze boolean

setEnableFullBatteryStatsHistory

protected void setEnableFullBatteryStatsHistory (boolean enableFullBatteryStatsHistory)

Se expone para pruebas de unidades

Parámetros
enableFullBatteryStatsHistory boolean

setEthernet

protected void setEthernet (BinaryState ethernet)

Se expone para pruebas de unidades

Parámetros
ethernet BinaryState

setForceRootSetup

protected void setForceRootSetup (boolean force)

Parámetros
force boolean

setForceSkipSystemProps

protected void setForceSkipSystemProps (boolean force)

Se expone para pruebas de unidades

Parámetros
force boolean

setInstallNonMarketApps

protected void setInstallNonMarketApps (BinaryState installNonMarketApps)

Se expone para pruebas de unidades

Parámetros
installNonMarketApps BinaryState

setLocalDataPath

protected void setLocalDataPath (File path)

Se expone para pruebas de unidades

Parámetros
path File

setLocationGps

protected void setLocationGps (BinaryState locationGps)

Se expone para pruebas de unidades

Parámetros
locationGps BinaryState

setLocationNetwork

protected void setLocationNetwork (BinaryState locationNetwork)

Se expone para pruebas de unidades

Parámetros
locationNetwork BinaryState

setMinExternalStorageKb

protected void setMinExternalStorageKb (long storageKb)

Se expone para pruebas de unidades

Parámetros
storageKb long

setNfc

protected void setNfc (BinaryState nfc)

Se expone para pruebas de unidades

Parámetros
nfc BinaryState

setNotificationLed

protected void setNotificationLed (BinaryState notificationLed)

Se expone para pruebas de unidades

Parámetros
notificationLed BinaryState

setProperty

protected void setProperty (String key, 
                String value)

Se expone para pruebas de unidades

Parámetros
key String

value String

setRestoreProperties

protected void setRestoreProperties (boolean restoreProperties)

Se expone para pruebas de unidades

Parámetros
restoreProperties boolean

setRestoreSettings

protected void setRestoreSettings (boolean restoreSettings)

Se expone para pruebas de unidades

Parámetros
restoreSettings boolean

setScreenAdaptiveBrightness

protected void setScreenAdaptiveBrightness (BinaryState screenAdaptiveBrightness)

Se expone para pruebas de unidades

Parámetros
screenAdaptiveBrightness BinaryState

setScreenAlwaysOn

protected void setScreenAlwaysOn (BinaryState screenAlwaysOn)

Se expone para pruebas de unidades

Parámetros
screenAlwaysOn BinaryState

setScreenAmbientMode

protected void setScreenAmbientMode (BinaryState screenAmbientMode)

Se expone para pruebas de unidades

Parámetros
screenAmbientMode BinaryState

setScreenBrightness

protected void setScreenBrightness (Integer screenBrightness)

Se expone para pruebas de unidades

Parámetros
screenBrightness Integer

setScreenSaver

protected void setScreenSaver (BinaryState screenSaver)

Se expone para pruebas de unidades

Parámetros
screenSaver BinaryState

setScreenTimeoutSecs

protected void setScreenTimeoutSecs (Long screenTimeoutSecs)

Se expone para pruebas de unidades

Parámetros
screenTimeoutSecs Long

setTestHarness

protected void setTestHarness (boolean setTestHarness)

Se expone para pruebas de unidades

Parámetros
setTestHarness boolean

setTimezone

protected void setTimezone (String timezone)

Se expone para pruebas de unidades

Parámetros
timezone String

setTriggerMediaMounted

protected void setTriggerMediaMounted (boolean triggerMediaMounted)

Se expone para pruebas de unidades

Parámetros
triggerMediaMounted boolean

setWakeGesture

protected void setWakeGesture (BinaryState wakeGesture)

Se expone para pruebas de unidades

Parámetros
wakeGesture BinaryState

setWifi

protected void setWifi (BinaryState wifi)

Se expone para pruebas de unidades

Parámetros
wifi BinaryState

setWifiNetwork

protected void setWifiNetwork (String wifiNetwork)

Se expone para pruebas de unidades

Parámetros
wifiNetwork String

setWifiPsk

protected void setWifiPsk (String wifiPsk)

Parámetros
wifiPsk String

setWifiScanAlwaysEnabled

protected void setWifiScanAlwaysEnabled (BinaryState wifiScanAlwaysEnabled)

Se expone para pruebas de unidades

Parámetros
wifiScanAlwaysEnabled BinaryState

setWifiSsidToPsk

protected void setWifiSsidToPsk ( wifiSssidToPsk)

Parámetros
wifiSssidToPsk

setWifiWatchdog

protected void setWifiWatchdog (BinaryState wifiWatchdog)

Se expone para pruebas de unidades

Parámetros
wifiWatchdog BinaryState