DeviceSetup
public
class
DeviceSetup
extends BaseTargetPreparer
implements
IExternalDependency
java.lang.Object | ||
↳ | com.android.tradefed.targetprep.BaseTargetPreparer | |
↳ | com.android.tradefed.targetprep.DeviceSetup |
ITargetPreparer
لضبط إعدادات جهاز للاختبار استنادًا إلى Option
المقدَّمة
تتطلّب هذه الطريقة جهازًا يمكن فيه استخدام أداة adb root، وعادةً ما يكون نوع الإصدار هو userdebug.
يجب تنفيذ هذا الإجراء بعد إعادة تحميل إصدار جديد.
ملاحظة: تم تصميم أداة الإعداد هذه لمختبرات الاختبار المستمر، وتفترض أنّه سيتم إعادة تحميل برمجية الجهاز الذي يخضع للاختبار ومحو بياناته قبل التشغيل التالي. وبالتالي، لا يؤدي هذا الإجراء إلا إلى الحد الأدنى من التنظيف أثناء عملية الإزالة، ويجب عدم استخدامه في وحدة اختبار.
ملخّص
وظائف الإنشاء العامة | |
---|---|
DeviceSetup()
|
الطرق العامة | |
---|---|
void
|
changeSettings(ITestDevice device)
تغيير الإعدادات على الجهاز |
|
getDependencies()
|
ITestDevice
|
getDevice(TestInformation testInfo)
|
boolean
|
isForceSkipSystemProps()
|
void
|
processDeprecatedOptions(ITestDevice device)
تعالج الخيارات المتوقّفة نهائيًا وتحوّلها إلى الخيارات المستخدَمة حاليًا. |
void
|
processOptions(ITestDevice device)
عالج جميع |
static
void
|
setCommandForBinaryState(BinaryState state,
طريقة مساعدة لإضافة أمر تشغيل/إيقاف ليتم تنفيذه على الجهاز |
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)
تم إيقاف هذه الطريقة نهائيًا.
استخدِم |
void
|
setDeprecatedMinExternalStoreSpace(long storeSpace)
تم إيقاف هذه الطريقة نهائيًا.
استخدِم |
void
|
setDeprecatedSetProp(String prop)
تم إيقاف هذه الطريقة نهائيًا.
استخدِم |
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(
|
void
|
setWifiWatchdog(BinaryState wifiWatchdog)
متاح لاختبار الوحدات |
الحقول
mBatterySaverTrigger
protected Integer mBatterySaverTrigger
mDefaultSimData
protected Integer mDefaultSimData
mDefaultSimSms
protected Integer mDefaultSimSms
mDefaultSimVoice
protected Integer mDefaultSimVoice
mDisableAudio
protected boolean mDisableAudio
mDisableDalvikVerifier
protected boolean mDisableDalvikVerifier
mDisableDialing
protected boolean mDisableDialing
mDisableDoze
protected boolean mDisableDoze
mEnableFullBatteryStatsHistory
protected boolean mEnableFullBatteryStatsHistory
mForceSkipRunCommands
protected boolean mForceSkipRunCommands
mForceSkipSettings
protected boolean mForceSkipSettings
mForceSkipSystemProps
protected boolean mForceSkipSystemProps
mLocalDataFile
protected File mLocalDataFile
mMinExternalStorageKb
protected long mMinExternalStorageKb
mOptimizedPropertySetting
protected boolean mOptimizedPropertySetting
mPreviousProperties
protected File mPreviousProperties
mRemoteDataPath
protected String mRemoteDataPath
mRestoreProperties
protected boolean mRestoreProperties
mRestoreSettings
protected boolean mRestoreSettings
mRunCommandAfterSettings
protectedmRunCommandAfterSettings
mRunCommandBeforeSettings
protectedmRunCommandBeforeSettings
mScreenBrightness
protected Integer mScreenBrightness
mScreenTimeoutSecs
protected Long mScreenTimeoutSecs
mSetProps
protectedmSetProps
mSetTestHarness
protected boolean mSetTestHarness
mTimezone
protected String mTimezone
mTriggerMediaMounted
protected boolean mTriggerMediaMounted
mWifiPsk
protected String mWifiPsk
mWifiSsid
protected String mWifiSsid
mWifiSsidToPsk
protectedmWifiSsidToPsk
وظائف الإنشاء العامة
DeviceSetup
public DeviceSetup ()
الطرق العامة
changeSettings
public void changeSettings (ITestDevice device)
تغيير الإعدادات على الجهاز
يتمّ عرضها لكي يتمكّن الأبناء من إلغاء القيمة.
المعلمات | |
---|---|
device |
ITestDevice : ITestDevice |
عمليات الرمي | |
---|---|
DeviceNotAvailableException |
إذا لم يكن الجهاز متاحًا |
TargetSetupError |
في حال تعذّر ضبط الإعدادات |
getDependencies
publicgetDependencies ()
المرتجعات | |
---|---|
|
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 |
setCellAutoSetting
protected void setCellAutoSetting (BinaryState cellAutoSetting)
المعلمات | |
---|---|
cellAutoSetting |
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 |
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 |
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 |