裝置設定

public class DeviceSetup
extends BaseTargetPreparer implements IExternalDependency

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

ITargetPreparer 可依據提供的 Option 設定要測試的裝置。

需要有「adb root」的裝置通常是使用者偵錯建構類型

應在新版本刷新「之後」執行。

注意：本準備工具適用於持續測試研究室，並假設 測試中的裝置會在下次執行前刷新並抹除資料。因此，本質上會進行 ，而且不應用於測試模組。

摘要

欄位

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)

輔助方法可新增要在裝置上執行的 ON/OFF 執行指令。

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

自動旋轉

protected BinaryState mAutoRotate

mAutoUpdateTime

protected BinaryState mAutoUpdateTime

mAutoUpdate 時區

protected BinaryState mAutoUpdateTimezone

mBatterySaver

protected BinaryState mBatterySaver

mBatterySaverTrigger

protected Integer mBatterySaverTrigger

藍牙

protected BinaryState mBluetooth

行動網路

protected BinaryState mCell

行動行動網路自動設定

protected BinaryState mCellAutoSetting

mData

protected BinaryState mData

mDefaultSimData

protected Integer mDefaultSimData

mDefaultSimSms

protected Integer mDefaultSimSms

mDefaultSimVoice

protected Integer mDefaultSimVoice

停用音訊

protected boolean mDisableAudio

mDisableCwWifiMediator

protected BinaryState mDisableCwWifiMediator

mDisableDalvikVerifier

protected boolean mDisableDalvikVerifier

停用撥號

protected boolean mDisableDialing

mDisableDoze

protected boolean mDisableDoze

mEnableFullBatteryStatsHistory

protected boolean mEnableFullBatteryStatsHistory

乙太網路

protected BinaryState mEthernet

mForceSkipRunCommands

protected boolean mForceSkipRunCommands

mForce 略過設定

protected boolean mForceSkipSettings

mForceSkipSystemProps

protected boolean mForceSkipSystemProps

mGlobal 設定

protected MultiMap<String, String> mGlobalSettings

mHideErrorDialogs

protected BinaryState mHideErrorDialogs

mInstallNonMarket 應用程式

protected BinaryState mInstallNonMarketApps

mLocalDataFile

protected File mLocalDataFile

mLocationGps

protected BinaryState mLocationGps

mLocationNetwork

protected BinaryState mLocationNetwork

mMinExternalStorageKb

protected long mMinExternalStorageKb

mNFC

protected BinaryState mNfc

已收到通知

protected BinaryState mNotificationLed

最佳化資源設定

protected boolean mOptimizedPropertySetting

mPreviousProperties

protected File mPreviousProperties

mRemoteDataPath

protected String mRemoteDataPath

mRestoreProperties

protected boolean mRestoreProperties

mRestore 設定

protected boolean mRestoreSettings

mRunCommandAfterSettings

protected  mRunCommandAfterSettings

mRunCommandBeforeSettings

protected  mRunCommandBeforeSettings

mScreenAdaptiveBrightness

protected BinaryState mScreenAdaptiveBrightness

一律開啟螢幕長亮模式

protected BinaryState mScreenAlwaysOn

mScreenAmbientMode

protected BinaryState mScreenAmbientMode

螢幕亮度

protected Integer mScreenBrightness

螢幕保護程式

protected BinaryState mScreenSaver

mScreenTimeoutSec

protected Long mScreenTimeoutSecs

mSecure 設定

protected MultiMap<String, String> mSecureSettings

mSetProps

protected  mSetProps

mSetTestHarness

protected boolean mSetTestHarness

mSyncTimezoneWithHost

protected BinaryState mSyncTimezoneWithHost

mSystem 設定

protected MultiMap<String, String> mSystemSettings

m 時區

protected String mTimezone

mTriggerMedia 已掛接

protected boolean mTriggerMediaMounted

mWake 手勢

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

公用建構函式

裝置設定

public DeviceSetup ()

公用方法

變更設定

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

process 已淘汰 Options

public void processDeprecatedOptions (ITestDevice device)

處理將已淘汰的選項轉換為目前使用的選項。

此方法應先執行，再執行其他處理方法。這會擲回 如果已淘汰的選項覆寫指定的未淘汰項目，就會傳回 TargetSetupError 如果有需要 SQL 指令的分析工作負載 則 BigQuery 可能是最佳選擇

參數
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)

輔助方法可新增要在裝置上執行的 ON/OFF 執行指令。

參數
state BinaryState：BinaryState
commands ：要新增 on 或 off 指令的指令清單。
onCommand String：ON 時要執行的指令。如果指令為 null，請忽略這個參數
offCommand String：關閉時要執行的指令。如果指令為 null，請忽略這個參數

設定全域設定

public void setGlobalSetting (String key, 
                String value)

開放單元測試

參數
key String

value String

設定安全設定

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：如果為 ON，則值
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

TearDown

public void tearDown (TestInformation testInfo, 
                Throwable e)

參數
testInfo TestInformation

e Throwable

擲回
DeviceNotAvailableException

保護方法

setAirplaneMode

protected void setAirplaneMode (BinaryState airplaneMode)

開放單元測試

參數
airplaneMode BinaryState

設定自動旋轉

protected void setAutoRotate (BinaryState autoRotate)

開放單元測試

參數
autoRotate BinaryState

設定自動更新時間

protected void setAutoUpdateTime (BinaryState autoUpdateTime)

開放單元測試

參數
autoUpdateTime BinaryState

setAutoUpdateTimezone (設定自動更新時區)

protected void setAutoUpdateTimezone (BinaryState autoUpdateTimezone)

開放單元測試

參數
autoUpdateTimezone BinaryState

設定省電模式

protected void setBatterySaver (BinaryState batterySaver)

開放單元測試

參數
batterySaver BinaryState

setBatterySaverTrigger

protected void setBatterySaverTrigger (Integer batterySaverTrigger)

開放單元測試

參數
batterySaverTrigger Integer

設定藍牙。

protected void setBluetooth (BinaryState bluetooth)

開放單元測試

參數
bluetooth BinaryState

setCell

protected void setCell (BinaryState cell)

參數
cell BinaryState

setCellAutoSettings

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

setdeprecationAudioSilent

protected void setDeprecatedAudioSilent (boolean silent)

此方法已淘汰。
請改用 setDisableAudio(boolean)。

開放單元測試

參數
silent boolean

set 已淘汰 MinExternalStoreSpace

protected void setDeprecatedMinExternalStoreSpace (long storeSpace)

此方法已淘汰。
請改用 setMinExternalStorageKb(long)。

開放單元測試

參數
storeSpace long

setdeprecationSetProp

protected void setDeprecatedSetProp (String prop)

此方法已淘汰。
請改用 setProperty(String, String)。

開放單元測試

參數
prop String

設定停用音訊

protected void setDisableAudio (boolean disable)

開放單元測試

參數
disable boolean

setDisableCwWifiMediator

protected void setDisableCwWifiMediator (BinaryState disableCwWifiMediator)

參數
disableCwWifiMediator BinaryState

setDisableDalvikVerifier

protected void setDisableDalvikVerifier (boolean disableDalvikVerifier)

開放單元測試

參數
disableDalvikVerifier boolean

setDisable 撥號

protected void setDisableDialing (boolean disableDialing)

開放單元測試

參數
disableDialing boolean

setDisableDoze

protected void setDisableDoze (boolean disableDoze)

開放單元測試

參數
disableDoze boolean

設定 EnableFullBatteryStatsHistory

protected void setEnableFullBatteryStatsHistory (boolean enableFullBatteryStatsHistory)

開放單元測試

參數
enableFullBatteryStatsHistory boolean

set 乙太網路

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

廣播出價

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

設定還原設定

protected void setRestoreSettings (boolean restoreSettings)

開放單元測試

參數
restoreSettings boolean

setScreenAdaptiveBrightness

protected void setScreenAdaptiveBrightness (BinaryState screenAdaptiveBrightness)

開放單元測試

參數
screenAdaptiveBrightness BinaryState

設定螢幕永遠開啟

protected void setScreenAlwaysOn (BinaryState screenAlwaysOn)

開放單元測試

參數
screenAlwaysOn BinaryState

setScreenAmbientMode

protected void setScreenAmbientMode (BinaryState screenAmbientMode)

開放單元測試

參數
screenAmbientMode BinaryState

設定螢幕亮度

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

設定時區

protected void setTimezone (String timezone)

開放單元測試

參數
timezone String

setTriggerMedia 掛接

protected void setTriggerMediaMounted (boolean triggerMediaMounted)

開放單元測試

參數
triggerMediaMounted boolean

設定喚醒手勢

protected void setWakeGesture (BinaryState wakeGesture)

開放單元測試

參數
wakeGesture BinaryState

setWifi

protected void setWifi (BinaryState wifi)

開放單元測試

參數
wifi BinaryState

設定 Wi-Fi 網路

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