Настройка устройства

public class DeviceSetup
extends BaseTargetPreparer implements IExternalDependency

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

Известные прямые подклассы GoogleDeviceSetup GoogleDeviceSetup Расширение DeviceSetup , позволяющее настраивать дополнительные свойства, специфичные для Google.

---

Компонент ITargetPreparer , который настраивает устройство для тестирования на основе предоставленных Option .

Для этого требуется устройство, на котором возможен доступ по протоколу 'adb root', как правило, это устройство типа сборки userdebug.

Эту процедуру следует выполнить после прошивки новой сборки.

Примечание: данное средство подготовки предназначено для лабораторий непрерывного тестирования и предполагает, что тестируемое устройство будет перепрошито и очищено перед следующим запуском. Поэтому оно выполняет минимальную очистку во время разборки и не должно использоваться в тестовом модуле.

Краткое содержание

Поля
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 List<String>	mRunCommandAfterSettings
protected List<String>	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 Map<String, String>	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 Map<String, String>	mWifiSsidToPsk
protected BinaryState	mWifiWatchdog

Государственные строители
DeviceSetup ()

Общедоступные методы
void	changeSettings ( ITestDevice device) Измените настройки устройства.
Set<ExternalDependency>	getDependencies ()
ITestDevice	getDevice ( TestInformation testInfo)
boolean	isForceSkipSystemProps ()
void	processDeprecatedOptions ( ITestDevice device) Обрабатывает устаревшие параметры, преобразуя их в используемые в данный момент параметры.
void	processOptions ( ITestDevice device) Обработайте все Option и преобразуйте их в системные свойства, настройки или команды выполнения.
static void	setCommandForBinaryState ( BinaryState state, List<String> commands, String onCommand, String offCommand) Вспомогательный метод для добавления команды включения/выключения, которая будет выполняться на устройстве.
void	setGlobalSetting (String key, String value) Доступно для модульного тестирования
void	setSecureSetting (String key, String value) Доступно для модульного тестирования
static void	setSettingForBinaryState ( BinaryState state, MultiMap <String, String> settingsMap, String setting, String onValue, String offValue) Вспомогательный метод для добавления параметра ВКЛ/ВЫКЛ в карту настроек.
void	setSystemSetting (String key, String value) Доступно для модульного тестирования
void	setUp ( TestInformation testInfo)
void	tearDown ( TestInformation testInfo, Throwable e)

Защищенные методы
void	setAirplaneMode ( BinaryState airplaneMode) Доступно для модульного тестирования
void	setAutoRotate ( BinaryState autoRotate) Доступно для модульного тестирования
void	setAutoUpdateTime ( BinaryState autoUpdateTime) Доступно для модульного тестирования
void	setAutoUpdateTimezone ( BinaryState autoUpdateTimezone) Доступно для модульного тестирования
void	setBatterySaver ( BinaryState batterySaver) Доступно для модульного тестирования
void	setBatterySaverTrigger (Integer batterySaverTrigger) Доступно для модульного тестирования
void	setBluetooth ( BinaryState bluetooth) Доступно для модульного тестирования
void	setCell ( BinaryState cell)
void	setCellAutoSetting ( BinaryState cellAutoSetting)
void	setData ( BinaryState data)
void	setDefaultSimData (Integer defaultSimData) Доступно для модульного тестирования
void	setDefaultSimSms (Integer defaultSimSms) Доступно для модульного тестирования
void	setDefaultSimVoice (Integer defaultSimVoice) Доступно для модульного тестирования
void	setDeprecatedAudioSilent (boolean silent) Этот метод устарел. Используйте setDisableAudio(boolean) вместо него.
void	setDeprecatedMinExternalStoreSpace (long storeSpace) Этот метод устарел. Используйте setMinExternalStorageKb(long) вместо него.
void	setDeprecatedSetProp (String prop) Этот метод устарел. Используйте setProperty(String,String) вместо него.
void	setDisableAudio (boolean disable) Доступно для модульного тестирования
void	setDisableCwWifiMediator ( BinaryState disableCwWifiMediator)
void	setDisableDalvikVerifier (boolean disableDalvikVerifier) Доступно для модульного тестирования
void	setDisableDialing (boolean disableDialing) Доступно для модульного тестирования
void	setDisableDoze (boolean disableDoze) Доступно для модульного тестирования
void	setEnableFullBatteryStatsHistory (boolean enableFullBatteryStatsHistory) Доступно для модульного тестирования
void	setEthernet ( BinaryState ethernet) Доступно для модульного тестирования
void	setForceRootSetup (boolean force)
void	setForceSkipSystemProps (boolean force) Доступно для модульного тестирования
void	setInstallNonMarketApps ( BinaryState installNonMarketApps) Доступно для модульного тестирования
void	setLocalDataPath (File path) Доступно для модульного тестирования
void	setLocationGps ( BinaryState locationGps) Доступно для модульного тестирования
void	setLocationNetwork ( BinaryState locationNetwork) Доступно для модульного тестирования
void	setMinExternalStorageKb (long storageKb) Доступно для модульного тестирования
void	setNfc ( BinaryState nfc) Доступно для модульного тестирования
void	setNotificationLed ( BinaryState notificationLed) Доступно для модульного тестирования
void	setProperty (String key, String value) Доступно для модульного тестирования
void	setRestoreProperties (boolean restoreProperties) Доступно для модульного тестирования
void	setRestoreSettings (boolean restoreSettings) Доступно для модульного тестирования
void	setScreenAdaptiveBrightness ( BinaryState screenAdaptiveBrightness) Доступно для модульного тестирования
void	setScreenAlwaysOn ( BinaryState screenAlwaysOn) Доступно для модульного тестирования
void	setScreenAmbientMode ( BinaryState screenAmbientMode) Доступно для модульного тестирования
void	setScreenBrightness (Integer screenBrightness) Доступно для модульного тестирования
void	setScreenSaver ( BinaryState screenSaver) Доступно для модульного тестирования
void	setScreenTimeoutSecs (Long screenTimeoutSecs) Доступно для модульного тестирования
void	setTestHarness (boolean setTestHarness) Доступно для модульного тестирования
void	setTimezone (String timezone) Доступно для модульного тестирования
void	setTriggerMediaMounted (boolean triggerMediaMounted) Доступно для модульного тестирования
void	setWakeGesture ( BinaryState wakeGesture) Доступно для модульного тестирования
void	setWifi ( BinaryState wifi) Доступно для модульного тестирования
void	setWifiNetwork (String wifiNetwork) Доступно для модульного тестирования
void	setWifiPsk (String wifiPsk)
void	setWifiScanAlwaysEnabled ( BinaryState wifiScanAlwaysEnabled) Доступно для модульного тестирования
void	setWifiSsidToPsk (Map<String, String> wifiSssidToPsk)
void	setWifiWatchdog ( BinaryState wifiWatchdog) Доступно для модульного тестирования

Поля

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

мДанные

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

mПредыдущиеСвойства

protected File mPreviousProperties

mRemoteDataPath

protected String mRemoteDataPath

mRestoreProperties

protected boolean mRestoreProperties

mRestoreSettings

protected boolean mRestoreSettings

mRunCommandAfterSettings

protected List<String> mRunCommandAfterSettings

mRunCommandBeforeSettings

protected List<String> 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 Map<String, String> 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 Map<String, String> mWifiSsidToPsk

mWifiWatchdog

protected BinaryState mWifiWatchdog

Государственные строители

Настройка устройства

public DeviceSetup ()

Общедоступные методы

изменить настройки

public void changeSettings (ITestDevice device)

Измените настройки устройства.

Доступно для детей из разных классов, что позволяет им отменять изменения.

Параметры
device	ITestDevice : ITestDevice

Броски
DeviceNotAvailableException	если устройство недоступно
TargetSetupError	если произошла ошибка при настройке параметров

получить зависимости

public Set<ExternalDependency> getDependencies ()

Возвраты
Set<ExternalDependency>

getDevice

public ITestDevice getDevice (TestInformation testInfo)

Параметры
testInfo	TestInformation

Возвраты
ITestDevice

isForceSkipSystemProps

public boolean isForceSkipSystemProps ()

Возвраты
boolean

processDeprecatedOptions

public void processDeprecatedOptions (ITestDevice device)

Обрабатывает устаревшие параметры, преобразуя их в используемые в данный момент параметры.

Этот метод следует запускать перед любыми другими методами обработки. В случае, если устаревший параметр переопределяет указанный неустаревший параметр, будет выброшено исключение TargetSetupError .

Параметры
device	ITestDevice

Броски
TargetSetupError	если возникнет конфликт

processOptions

public void processOptions (ITestDevice device)

Обработайте все Option и преобразуйте их в системные свойства, настройки или команды выполнения. В данный момент не выполняет никаких команд на устройстве.

Это сделано таким образом, чтобы дочерние классы могли это переопределять.

Параметры
device	ITestDevice : ITestDevice

Броски
DeviceNotAvailableException	если устройство недоступно
TargetSetupError	если Option конфликтуют

setCommandForBinaryState

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

Вспомогательный метод для добавления команды включения/выключения, которая будет выполняться на устройстве.

Параметры
state	BinaryState : BinaryState
commands	List : перечень команд, к которым следует добавить команду включения или выключения.
onCommand	String : Команда, которая будет выполнена, если включена. Игнорируется, если команда равна null
offCommand	String : Команда, которая будет выполнена, если значение равно OFF. Игнорируется, если команда равна null .

setGlobalSetting

public void setGlobalSetting (String key, 
                String value)

Доступно для модульного тестирования

Параметры
key	String
value	String

setSecureSetting

public void setSecureSetting (String key, 
                String value)

Доступно для модульного тестирования

Параметры
key	String
value	String

setSettingForBinaryState

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

Вспомогательный метод для добавления параметра ВКЛ/ВЫКЛ в карту настроек.

Параметры
state	BinaryState : BinaryState
settingsMap	MultiMap : MultiMap используется для хранения настроек.
setting	String : Ключ настройки
onValue	String : значение, если включено.
offValue	String : значение, если OFF

setSystemSetting

public void setSystemSetting (String key, 
                String value)

Доступно для модульного тестирования

Параметры
key	String
value	String

настраивать

public void setUp (TestInformation testInfo)

Параметры
testInfo	TestInformation

Броски
BuildError
DeviceNotAvailableException
TargetSetupError

срывать

public void tearDown (TestInformation testInfo, 
                Throwable e)

Параметры
testInfo	TestInformation
e	Throwable

Броски
DeviceNotAvailableException

Защищенные методы

setAirplaneMode

protected void setAirplaneMode (BinaryState airplaneMode)

Доступно для модульного тестирования

Параметры
airplaneMode	BinaryState

setAutoRotate

protected void setAutoRotate (BinaryState autoRotate)

Доступно для модульного тестирования

Параметры
autoRotate	BinaryState

setAutoUpdateTime

protected void setAutoUpdateTime (BinaryState autoUpdateTime)

Доступно для модульного тестирования

Параметры
autoUpdateTime	BinaryState

setAutoUpdateTimezone

protected void setAutoUpdateTimezone (BinaryState autoUpdateTimezone)

Доступно для модульного тестирования

Параметры
autoUpdateTimezone	BinaryState

setBatterySaver

protected void setBatterySaver (BinaryState batterySaver)

Доступно для модульного тестирования

Параметры
batterySaver	BinaryState

setBatterySaverTrigger

protected void setBatterySaverTrigger (Integer batterySaverTrigger)

Доступно для модульного тестирования

Параметры
batterySaverTrigger	Integer

установить Bluetooth

protected void setBluetooth (BinaryState bluetooth)

Доступно для модульного тестирования

Параметры
bluetooth	BinaryState

setCell

protected void setCell (BinaryState cell)

Параметры
cell	BinaryState

setCellAutoSetting

protected void setCellAutoSetting (BinaryState cellAutoSetting)

Параметры
cellAutoSetting	BinaryState

setData

protected void setData (BinaryState data)

Параметры
data	BinaryState

setDefaultSimData

protected void setDefaultSimData (Integer defaultSimData)

Доступно для модульного тестирования

Параметры
defaultSimData	Integer

setDefaultSimSms

protected void setDefaultSimSms (Integer defaultSimSms)

Доступно для модульного тестирования

Параметры
defaultSimSms	Integer

setDefaultSimVoice

protected void setDefaultSimVoice (Integer defaultSimVoice)

Доступно для модульного тестирования

Параметры
defaultSimVoice	Integer

setDeprecatedAudioSilent

protected void setDeprecatedAudioSilent (boolean silent)

Этот метод устарел.
Вместо этого используйте setDisableAudio(boolean) .

Доступно для модульного тестирования

Параметры
silent	boolean

setDeprecatedMinExternalStoreSpace

protected void setDeprecatedMinExternalStoreSpace (long storeSpace)

Этот метод устарел.
Вместо этого используйте setMinExternalStorageKb(long) .

Доступно для модульного тестирования

Параметры
storeSpace	long

setDeprecatedSetProp

protected void setDeprecatedSetProp (String prop)

Этот метод устарел.
Используйте setProperty(String,String) вместо этого.

Доступно для модульного тестирования

Параметры
prop	String

setDisableAudio

protected void setDisableAudio (boolean disable)

Доступно для модульного тестирования

Параметры
disable	boolean

setDisableCwWifiMediator

protected void setDisableCwWifiMediator (BinaryState disableCwWifiMediator)

Параметры
disableCwWifiMediator	BinaryState

setDisableDalvikVerifier

protected void setDisableDalvikVerifier (boolean disableDalvikVerifier)

Доступно для модульного тестирования

Параметры
disableDalvikVerifier	boolean

setDisableDialing

protected void setDisableDialing (boolean disableDialing)

Доступно для модульного тестирования

Параметры
disableDialing	boolean

setDisableDoze

protected void setDisableDoze (boolean disableDoze)

Доступно для модульного тестирования

Параметры
disableDoze	boolean

setEnableFullBatteryStatsHistory

protected void setEnableFullBatteryStatsHistory (boolean enableFullBatteryStatsHistory)

Доступно для модульного тестирования

Параметры
enableFullBatteryStatsHistory	boolean

setEthernet

protected void setEthernet (BinaryState ethernet)

Доступно для модульного тестирования

Параметры
ethernet	BinaryState

setForceRootSetup

protected void setForceRootSetup (boolean force)

Параметры
force	boolean

setForceSkipSystemProps

protected void setForceSkipSystemProps (boolean force)

Доступно для модульного тестирования

Параметры
force	boolean

setInstallNonMarketApps

protected void setInstallNonMarketApps (BinaryState installNonMarketApps)

Доступно для модульного тестирования

Параметры
installNonMarketApps	BinaryState

setLocalDataPath

protected void setLocalDataPath (File path)

Доступно для модульного тестирования

Параметры
path	File

setLocationGps

protected void setLocationGps (BinaryState locationGps)

Доступно для модульного тестирования

Параметры
locationGps	BinaryState

setLocationNetwork

protected void setLocationNetwork (BinaryState locationNetwork)

Доступно для модульного тестирования

Параметры
locationNetwork	BinaryState

setMinExternalStorageKb

protected void setMinExternalStorageKb (long storageKb)

Доступно для модульного тестирования

Параметры
storageKb	long

setNfc

protected void setNfc (BinaryState nfc)

Доступно для модульного тестирования

Параметры
nfc	BinaryState

setNotificationLed

protected void setNotificationLed (BinaryState notificationLed)

Доступно для модульного тестирования

Параметры
notificationLed	BinaryState

setProperty

protected void setProperty (String key, 
                String value)

Доступно для модульного тестирования

Параметры
key	String
value	String

setRestoreProperties

protected void setRestoreProperties (boolean restoreProperties)

Доступно для модульного тестирования

Параметры
restoreProperties	boolean

setRestoreSettings

protected void setRestoreSettings (boolean restoreSettings)

Доступно для модульного тестирования

Параметры
restoreSettings	boolean

setScreenAdaptiveBrightness

protected void setScreenAdaptiveBrightness (BinaryState screenAdaptiveBrightness)

Доступно для модульного тестирования

Параметры
screenAdaptiveBrightness	BinaryState

setScreenAlwaysOn

protected void setScreenAlwaysOn (BinaryState screenAlwaysOn)

Доступно для модульного тестирования

Параметры
screenAlwaysOn	BinaryState

setScreenAmbientMode

protected void setScreenAmbientMode (BinaryState screenAmbientMode)

Доступно для модульного тестирования

Параметры
screenAmbientMode	BinaryState

setScreenBrightness

protected void setScreenBrightness (Integer screenBrightness)

Доступно для модульного тестирования

Параметры
screenBrightness	Integer

setScreenSaver

protected void setScreenSaver (BinaryState screenSaver)

Доступно для модульного тестирования

Параметры
screenSaver	BinaryState

setScreenTimeoutSecs

protected void setScreenTimeoutSecs (Long screenTimeoutSecs)

Доступно для модульного тестирования

Параметры
screenTimeoutSecs	Long

setTestHarness

protected void setTestHarness (boolean setTestHarness)

Доступно для модульного тестирования

Параметры
setTestHarness	boolean

setTimezone

protected void setTimezone (String timezone)

Доступно для модульного тестирования

Параметры
timezone	String

setTriggerMediaMounted

protected void setTriggerMediaMounted (boolean triggerMediaMounted)

Доступно для модульного тестирования

Параметры
triggerMediaMounted	boolean

setWakeGesture

protected void setWakeGesture (BinaryState wakeGesture)

Доступно для модульного тестирования

Параметры
wakeGesture	BinaryState

setWifi

protected void setWifi (BinaryState wifi)

Доступно для модульного тестирования

Параметры
wifi	BinaryState

setWifiNetwork

protected void setWifiNetwork (String wifiNetwork)

Доступно для модульного тестирования

Параметры
wifiNetwork	String

setWifiPsk

protected void setWifiPsk (String wifiPsk)

Параметры
wifiPsk	String

setWifiScanAlwaysEnabled

protected void setWifiScanAlwaysEnabled (BinaryState wifiScanAlwaysEnabled)

Доступно для модульного тестирования

Параметры
wifiScanAlwaysEnabled	BinaryState

setWifiSsidToPsk

protected void setWifiSsidToPsk (Map<String, String> wifiSssidToPsk)

Параметры
wifiSssidToPsk	Map

setWifiWatchdog

protected void setWifiWatchdog (BinaryState wifiWatchdog)

Доступно для модульного тестирования

Параметры
wifiWatchdog	BinaryState