自 2025 年 3 月 27 日起，我们建议您使用 android-latest-release 而非 aosp-main 构建 AOSP 并为其做出贡献。如需了解详情，请参阅 AOSP 的变更。

此页面由 Cloud Translation API 翻译。

DeviceSetup

public class DeviceSetup
extends BaseTargetPreparer implements IExternalDependency

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

用于根据提供的 Option 配置设备以进行测试的 ITargetPreparer。

需要支持“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`	`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`

公共构造函数
`DeviceSetup()`

公共方法
`void`	`changeSettings(ITestDevice device)` 更改设备上的设置。
	`getDependencies()`
`ITestDevice`	`getDevice(TestInformation testInfo)`
`boolean`	`isForceSkipSystemProps()`
`void`	`processDeprecatedOptions(ITestDevice device)` 处理已废弃的选项，将其转换为当前使用的选项。
`void`	`processOptions(ITestDevice device)` 处理所有 `Option`，并将其转换为系统属性、设置或运行命令。
`static void`	`setCommandForBinaryState(BinaryState state, 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( 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  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

公共构造函数

DeviceSetup

public DeviceSetup ()

公共方法

changeSettings

public void changeSettings (ITestDevice device)

更改设备上的设置。

公开，以便子类可以替换。

参数
`device`	`ITestDevice`：`ITestDevice`

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

getDependencies

public  getDependencies ()

返回

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, 
                 commands, 
                String onCommand, 
                String offCommand)

用于添加要在设备上执行的开启/关闭运行命令的辅助方法。

参数
`state`	`BinaryState`：`BinaryState`
`commands`	：要将开启或关闭命令添加到的命令列表。
`onCommand`	`String`：开启时要运行的命令。如果命令为 `null`，则忽略
`offCommand`	`String`：处于“关闭”状态时要运行的命令。如果命令为 `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`：关闭时的值

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 ( wifiSssidToPsk)

参数
`wifiSssidToPsk`

setWifiWatchdog

protected void setWifiWatchdog (BinaryState wifiWatchdog)

公开以进行单元测试

参数
`wifiWatchdog`	`BinaryState`