DeviceSetup

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 build 类型。

应在刷入新 build 后执行。

注意：此准备器适用于持续测试实验室，并假定受测设备会在下次运行之前刷写并擦除。因此，它在拆解期间执行的清理操作最少，不应在测试模块中使用。

摘要

字段
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

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 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

公共构造函数

DeviceSetup

public DeviceSetup ()

公共方法

changeSettings

public void changeSettings (ITestDevice device)

更改设备上的设置。

公开，以便子类可以覆盖。

参数
device	ITestDevice：ITestDevice

抛出
DeviceNotAvailableException	如果设备不可用
TargetSetupError	如果设置失败

getDependencies

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：如果为 ON，则运行相应命令。如果命令为 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

setUp

public void setUp (TestInformation testInfo)

参数
testInfo	TestInformation

抛出
BuildError
DeviceNotAvailableException
TargetSetupError

tearDown

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

setBluetooth

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