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)
غيِّر الإعدادات على الجهاز. |
Set<ExternalDependency>
|
getDependencies()
|
ITestDevice
|
getDevice(TestInformation testInfo)
|
boolean
|
isForceSkipSystemProps()
|
void
|
processDeprecatedOptions(ITestDevice device)
تتم معالجة الخيارات المتوقّفة نهائيًا وتحويلها إلى الخيارات المستخدَمة حاليًا. |
void
|
processOptions(ITestDevice device)
معالجة جميع |
static
void
|
setCommandForBinaryState(BinaryState state, List<String> 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)
طريقة مساعدة لإضافة إعداد ON/OFF إلى خريطة الإعدادات. |
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(Map<String, String> wifiSssidToPsk)
|
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
protected List<String> mRunCommandAfterSettings
mRunCommandBeforeSettings
protected List<String> mRunCommandBeforeSettings
mScreenBrightness
protected Integer mScreenBrightness
mScreenTimeoutSecs
protected Long mScreenTimeoutSecs
mSetProps
protected Map<String, String> mSetProps
mSetTestHarness
protected boolean mSetTestHarness
mTimezone
protected String mTimezone
mTriggerMediaMounted
protected boolean mTriggerMediaMounted
mWifiPsk
protected String mWifiPsk
mWifiSsid
protected String mWifiSsid
mWifiSsidToPsk
protected Map<String, String> mWifiSsidToPsk
طُرق وضع التصميم العامة
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)
طريقة مساعدة لإضافة أمر تشغيل ON/OFF سيتم تنفيذه على الجهاز.
| المعلَمات | |
|---|---|
state |
BinaryState: BinaryState |
commands |
List: قائمة الأوامر التي ستتم إضافة الأمر on أو off إليها. |
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)
طريقة مساعدة لإضافة إعداد ON/OFF إلى خريطة الإعدادات.
| المعلَمات | |
|---|---|
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 |
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 (Map<String, String> wifiSssidToPsk)
| المعلَمات | |
|---|---|
wifiSssidToPsk |
Map |
setWifiWatchdog
protected void setWifiWatchdog (BinaryState wifiWatchdog)
متاحة لاختبار الوحدات
| المعلَمات | |
|---|---|
wifiWatchdog |
BinaryState |