FastbootDeviceFlasher
public
class
FastbootDeviceFlasher
extends Object
implements
IDeviceFlasher
java.lang.Object | |
↳ | com.android.tradefed.targetprep.FastbootDeviceFlasher |
فئة تعتمد على Fastboot لفلاش صورة على أجهزة Android المادية
ملخّص
الحقول | |
---|---|
public
static
final
String |
BASEBAND_IMAGE_NAME
|
وظائف الإنشاء العامة | |
---|---|
FastbootDeviceFlasher()
|
الطرق العامة | |
---|---|
static
String
|
fetchImageVersion(IRunUtil runUtil, ITestDevice device, String imageName)
طريقة مساعدة للحصول على إصدار الصورة الحالي على الجهاز |
void
|
flash(ITestDevice device, IDeviceBuildInfo deviceBuild)
يتم إنشاء الفلاشات على الجهاز. |
CommandStatus
|
getSystemFlashingStatus()
استرداد حالة تنفيذ الأمر لفلاش أقسام النظام الأساسية |
IDeviceFlasher.UserDataFlashOption
|
getUserDataFlashOption()
الحصول على ما إذا كان يجب إعادة تحميل صورة بيانات المستخدم أو محوها أو الاحتفاظ بها |
void
|
overrideDeviceOptions(ITestDevice device)
إلغاء خيارات جهاز |
void
|
preFlashOperations(ITestDevice device, IDeviceBuildInfo deviceBuild)
جميع عمليات الإعداد والتحقّق التي يجب إجراؤها قبل قسم الفلاش المعنيّ |
void
|
setDataWipeSkipList(
ضبط قائمة المسارات ضمن
يُرجى العلم أنّ درجة دقة قائمة التخطّي هي العناصر الفرعية المباشرة للعنصر |
void
|
setFlashOptions(
تُستخدَم لضبط قائمة بالخيارات التي يتم تمريرها مع أوامر الفلاش/التحديث. |
void
|
setFlashingResourcesRetriever(IFlashingResourcesRetriever retriever)
تُستخدَم لضبط الآلية التي يمكن من خلالها لبرنامج الفلاش استرداد ملفات الموارد للفلاشة. |
void
|
setForceSystemFlash(boolean forceSystemFlash)
لضبط ما إذا كان يجب دائمًا فلاش النظام حتى إذا كان يعمل بالإصدار الحالي |
void
|
setIncrementalFlashing(IncrementalImageUtil incrementalUtil)
|
void
|
setRamdiskPartition(String ramdiskPartition)
ضبط قسم ذاكرة الوصول العشوائي |
void
|
setShouldFlashRamdisk(boolean shouldFlashRamdisk)
لتحديد ما إذا كان يجب فلاش ذاكرة وصول عشوائي إضافية بعد تحديث الجهاز من خلال ملف zip للصورة |
void
|
setUserDataFlashOption(IDeviceFlasher.UserDataFlashOption flashOption)
يتيح هذا الخيار تفعيل أو إيقاف إعادة تحميل صورة بيانات المستخدم أو محوها أو الاحتفاظ بها. |
void
|
setWipeTimeout(long timeout)
اضبط مهلة محو البيانات. |
boolean
|
shouldFlashRamdisk()
التحقّق مما إذا كان قد تم ضبط أداة الفلاش لتشغيل ملف ramdisk إضافي بعد تحديث الجهاز من خلال ملف zip للصورة |
الطرق المحمية | |
---|---|
void
|
checkAndFlashBaseband(ITestDevice device, IDeviceBuildInfo deviceBuild)
إذا لزم الأمر، ثبِّت صورة قاعدة بيانات البرامج الثابتة على الجهاز. |
boolean
|
checkAndFlashBootloader(ITestDevice device, IDeviceBuildInfo deviceBuild)
ثبِّت صورة برنامج الإقلاع على الجهاز إذا لزم الأمر. |
boolean
|
checkAndFlashSystem(ITestDevice device, String systemBuildId, String systemBuildFlavor, IDeviceBuildInfo deviceBuild)
إذا لزم الأمر، وضِّع صورة النظام على الجهاز. |
boolean
|
checkShouldFlashBaseband(ITestDevice device, IDeviceBuildInfo deviceBuild)
تحقَّق مما إذا كان يجب إعادة تحميل الإصدار الأساسي على الجهاز المقدَّم. |
IFlashingResourcesParser
|
createFlashingResourcesParser(IDeviceBuildInfo localBuild, DeviceDescriptor descriptor)
طريقة المصنع لإنشاء |
void
|
downloadExtraImageFiles(IFlashingResourcesParser resourceParser, IFlashingResourcesRetriever retriever, IDeviceBuildInfo localBuild)
عنصر ربط للسماح للطبقات الفرعية بتنزيل ملفات صور مخصّصة إضافية إذا لزم الأمر |
void
|
downloadFlashingResources(ITestDevice device, IDeviceBuildInfo localBuild)
تنزيل ملفات صور فلاش إضافية مطلوبة |
String
|
executeFastbootCmd(ITestDevice device, String... cmdArgs)
طريقة مساعدة لتنفيذ أمر fastboot |
String
|
executeLongFastbootCmd(ITestDevice device, String... cmdArgs)
طريقة مساعدة لتنفيذ أمر fastboot يستغرق وقتًا طويلاً |
String
|
executeLongFastbootCmd(ITestDevice device,
طريقة مساعدة لتنفيذ أمر fastboot يستغرق وقتًا طويلاً باستخدام متغيّرات البيئة |
void
|
flashBaseband(ITestDevice device, File basebandImageFile)
إعادة تحميل صورة قاعدة النطاق المحدَّدة وإعادة التشغيل إلى برنامج الإقلاع |
void
|
flashBootloader(ITestDevice device, File bootloaderImageFile)
برمجة صورة برنامج الإقلاع المحدَّدة وإعادة تشغيل الجهاز من جديد في برنامج الإقلاع |
void
|
flashExtraImages(ITestDevice device, IDeviceBuildInfo deviceBuild)
عليك فلاش أي أقسام خاصة بالجهاز قبل فلاش النظام وإعادة التشغيل. |
void
|
flashPartition(ITestDevice device, File imgFile, String partition)
فلاش قسم فردي من جهاز |
void
|
flashRamdiskIfNeeded(ITestDevice device, IDeviceBuildInfo deviceBuild)
|
void
|
flashSystem(ITestDevice device, IDeviceBuildInfo deviceBuild)
وضِع صورة النظام على الجهاز |
void
|
flashUserData(ITestDevice device, IDeviceBuildInfo deviceBuild)
فلاش قسم userdata على الجهاز |
void
|
flashUserDataFromDeviceImageFile(ITestDevice device, IDeviceBuildInfo deviceBuild)
استخراج ملف userdata.img من ملف صورة الجهاز وفلاشه على الجهاز |
String
|
getBootPartitionName()
الحصول على اسم قسم التمهيد لأداة فلاش هذا الجهاز |
String
|
getBootloaderFilePrefix(ITestDevice device)
الحصول على بادئة ملف مشغّل التحميل |
String
|
getCurrentSlot(ITestDevice device)
طريقة مساعدة لاسترداد الفتحة الحالية (للأجهزة المزوّدة بميزة A/B) |
IFlashingResourcesRetriever
|
getFlashingResourcesRetriever()
|
FuseUtil
|
getFuseUtil()
|
String
|
getImageVersion(ITestDevice device, String imageName)
|
IRunUtil
|
getRunUtil()
تمّ عرضها للاختبار. |
void
|
handleUserDataFlashing(ITestDevice device, IDeviceBuildInfo deviceBuild)
معالجة وميض قسم userdata/cache |
boolean
|
hasPartition(ITestDevice device, String partition)
التحقّق من برنامج الإقلاع لمعرفة ما إذا كان القسم المحدّد متوفّرًا أم لا |
void
|
preFlashSetup(ITestDevice device, IDeviceBuildInfo deviceBuild)
نفِّذ أي إعدادات إضافية مطلوبة قبل الفلاش. |
void
|
setSystemBuildInfo(String systemBuildId, String systemBuildFlavor)
|
void
|
verifyRequiredBoards(ITestDevice device, IFlashingResourcesParser resourceParser, String deviceProductType)
تأكَّد من أنّ نوع منتج الجهاز متوافق مع الإصدار المطلوب تثبيته. |
void
|
wipeCache(ITestDevice device)
محو قسم ذاكرة التخزين المؤقت على الجهاز |
void
|
wipePartition(ITestDevice device, String partition)
محو القسم المحدّد باستخدام fastboot erase <name> |
الحقول
BASEBAND_IMAGE_NAME
public static final String BASEBAND_IMAGE_NAME
وظائف الإنشاء العامة
FastbootDeviceFlasher
public FastbootDeviceFlasher ()
الطرق العامة
fetchImageVersion
public static String fetchImageVersion (IRunUtil runUtil, ITestDevice device, String imageName)
طريقة مساعدة للحصول على إصدار الصورة الحالي على الجهاز
المعلمات | |
---|---|
runUtil |
IRunUtil |
device |
ITestDevice : ITestDevice لتنفيذ الأمر |
imageName |
String : اسم الصورة المطلوب الحصول عليها. |
المرتجعات | |
---|---|
String |
تجميع إخراج stdout من الأمر |
عمليات الرمي | |
---|---|
DeviceNotAvailableException |
إذا لم يكن الجهاز متاحًا |
TargetSetupError |
في حال تعذّر تنفيذ الأمر fastboot أو تعذّر تحديد الإصدار |
فلاش
public void flash (ITestDevice device, IDeviceBuildInfo deviceBuild)
يتم إنشاء الفلاشات على الجهاز.
يعود إلى الظهور فور اكتمال عملية الفلاش. على المتصلين الانتظار إلى أن يصبح الجهاز متصلاً بالإنترنت ومتاحًا قبل مواصلة الاختبار.
المعلمات | |
---|---|
device |
ITestDevice : ITestDevice للوميض |
deviceBuild |
IDeviceBuildInfo : IDeviceBuildInfo للوميض |
عمليات الرمي | |
---|---|
DeviceNotAvailableException |
|
TargetSetupError |
getSystemFlashingStatus
public CommandStatus getSystemFlashingStatus ()
استرداد حالة تنفيذ الأمر لفلاش أقسام النظام الأساسية
يُرجى العِلم أنّه في حال عدم إعادة تحميل أقسام النظام (إذا كان النظام يتضمّن الإصدار المطلوب إعادة تحميله)
، قد تكون حالة الأمر null
.
المرتجعات | |
---|---|
CommandStatus |
getUserDataFlashOption
public IDeviceFlasher.UserDataFlashOption getUserDataFlashOption ()
الحصول على ما إذا كان يجب إعادة تحميل صورة بيانات المستخدم أو محوها أو الاحتفاظ بها
المرتجعات | |
---|---|
IDeviceFlasher.UserDataFlashOption |
ما إذا كان يجب إعادة تحميل صورة بيانات المستخدم أو محوها أو الاحتفاظ بها |
overrideDeviceOptions
public void overrideDeviceOptions (ITestDevice device)
إلغاء خيارات جهاز تُستخدَم لإلغاء قيم الخيارات التلقائية إذا كانت القيم التلقائية غير متوافقة مع جهاز معيّن.
preFlashOperations
public void preFlashOperations (ITestDevice device, IDeviceBuildInfo deviceBuild)
جميع عمليات الإعداد والتحقّق التي يجب إجراؤها قبل قسم الفلاش المعنيّ ولن يتم تضمين أيٍّ من هذه العمليات في القسم الحرج الذي يتم التحكّم فيه بالالتزام المتزامن.
المعلمات | |
---|---|
device |
ITestDevice : ITestDevice للوميض |
deviceBuild |
IDeviceBuildInfo : IDeviceBuildInfo للوميض |
عمليات الرمي | |
---|---|
DeviceNotAvailableException |
|
TargetSetupError |
setDataWipeSkipList
public void setDataWipeSkipList (dataWipeSkipList)
ضبط قائمة المسارات ضمن /data
لتجنُّب محو المحتوى عند استخدام
ITestsZipInstaller
يُرجى العلم أنّ درجة دقة قائمة التخطّي هي العناصر الفرعية المباشرة للعنصر /data
.
المعلمات | |
---|---|
dataWipeSkipList |
|
setFlashOptions
public void setFlashOptions (flashOptions)
تُستخدَم لضبط قائمة بالخيارات التي يتم تمريرها مع أوامر الفلاش/التحديث.
setFlashingResourcesRetriever
public void setFlashingResourcesRetriever (IFlashingResourcesRetriever retriever)
تُستخدَم لضبط الآلية التي يمكن من خلالها لبرنامج الفلاش استرداد ملفات الموارد للفلاشة.
المعلمات | |
---|---|
retriever |
IFlashingResourcesRetriever : IFlashingResourcesRetriever المطلوب استخدامه |
setForceSystemFlash
public void setForceSystemFlash (boolean forceSystemFlash)
لضبط ما إذا كان يجب دائمًا فلاش النظام حتى إذا كان يعمل بالإصدار الحالي
setIncrementalFlashing
public void setIncrementalFlashing (IncrementalImageUtil incrementalUtil)
المعلمات | |
---|---|
incrementalUtil |
IncrementalImageUtil |
setRamdiskPartition
public void setRamdiskPartition (String ramdiskPartition)
ضبط قسم ذاكرة الوصول العشوائي
setShouldFlashRamdisk
public void setShouldFlashRamdisk (boolean shouldFlashRamdisk)
لتحديد ما إذا كان يجب فلاش ذاكرة وصول عشوائي إضافية بعد تحديث الجهاز من خلال ملف zip للصورة
setUserDataFlashOption
public void setUserDataFlashOption (IDeviceFlasher.UserDataFlashOption flashOption)
يتيح هذا الخيار تفعيل أو إيقاف إعادة تحميل صورة بيانات المستخدم أو محوها أو الاحتفاظ بها.
setWipeTimeout
public void setWipeTimeout (long timeout)
اضبط مهلة محو البيانات.
المعلمات | |
---|---|
timeout |
long |
shouldFlashRamdisk
public boolean shouldFlashRamdisk ()
التحقّق مما إذا كان قد تم ضبط أداة الفلاش لتشغيل ملف ramdisk إضافي بعد تحديث الجهاز من خلال ملف zip للصورة
المرتجعات | |
---|---|
boolean |
الطرق المحمية
checkAndFlashBaseband
protected void checkAndFlashBaseband (ITestDevice device, IDeviceBuildInfo deviceBuild)
إذا لزم الأمر، ثبِّت صورة قاعدة بيانات البرامج الثابتة على الجهاز. لن يتم فلاش النطاق الأساسي إلا إذا كان الإصدار الحالي على الجهاز != الإصدار المطلوب
المعلمات | |
---|---|
device |
ITestDevice : ITestDevice للوميض |
deviceBuild |
IDeviceBuildInfo : IDeviceBuildInfo الذي يحتوي على صورة قاعدة الإرسال المطلوب فلاشها |
عمليات الرمي | |
---|---|
DeviceNotAvailableException |
إذا لم يكن الجهاز متاحًا |
TargetSetupError |
إذا تعذّر فلاش قاعدة البيانات |
checkAndFlashBootloader
protected boolean checkAndFlashBootloader (ITestDevice device, IDeviceBuildInfo deviceBuild)
ثبِّت صورة برنامج الإقلاع على الجهاز إذا لزم الأمر.
لن يتم فلاش برنامج الإقلاع إلا إذا كان الإصدار الحالي على الجهاز ≠ الإصدار المطلوب.
المعلمات | |
---|---|
device |
ITestDevice : ITestDevice للوميض |
deviceBuild |
IDeviceBuildInfo : IDeviceBuildInfo الذي يحتوي على صورة أداة تحميل البرامج الثابتة المطلوب برمجته |
المرتجعات | |
---|---|
boolean |
true في حال تم فلاش برنامج الإقلاع، false في حال تم تخطّيه |
عمليات الرمي | |
---|---|
DeviceNotAvailableException |
إذا لم يكن الجهاز متاحًا |
TargetSetupError |
في حال تعذّر فلاش برنامج الإقلاع |
checkAndFlashSystem
protected boolean checkAndFlashSystem (ITestDevice device, String systemBuildId, String systemBuildFlavor, IDeviceBuildInfo deviceBuild)
إذا لزم الأمر، وضِّع صورة النظام على الجهاز.
يُرجى الاطّلاع على ERROR(/#shouldFlashSystem(String,String,com.android.tradefed.build.IDeviceBuildInfo))
.
بغض النظر عن المسار الذي تم اختياره، من المفترض أن يتم تشغيل الجهاز في مساحة المستخدم بعد تنفيذ الطريقة.
المعلمات | |
---|---|
device |
ITestDevice : ITestDevice للوميض |
systemBuildId |
String : رقم تعريف الإصدار الحالي الذي يتم تشغيله على الجهاز |
systemBuildFlavor |
String : إصدار الإصدار الحالي الذي يعمل على الجهاز |
deviceBuild |
IDeviceBuildInfo : IDeviceBuildInfo الذي يحتوي على صورة النظام المطلوب تركيبها |
المرتجعات | |
---|---|
boolean |
true إذا تم فلاش النظام، false إذا تم تخطّيه |
عمليات الرمي | |
---|---|
DeviceNotAvailableException |
إذا لم يكن الجهاز متاحًا |
TargetSetupError |
في حال تعذّر فلاش برنامج الإقلاع |
checkShouldFlashBaseband
protected boolean checkShouldFlashBaseband (ITestDevice device, IDeviceBuildInfo deviceBuild)
تحقَّق مما إذا كان يجب إعادة تحميل الإصدار الأساسي على الجهاز المقدَّم.
المعلمات | |
---|---|
device |
ITestDevice : ITestDevice للتحقّق من |
deviceBuild |
IDeviceBuildInfo : IDeviceBuildInfo الذي يحتوي على صورة النطاق الأساسي المطلوب التحقّق منها |
المرتجعات | |
---|---|
boolean |
عمليات الرمي | |
---|---|
DeviceNotAvailableException |
إذا لم يكن الجهاز متاحًا |
TargetSetupError |
إذا تعذّر فلاش قاعدة البيانات |
createFlashingResourcesParser
protected IFlashingResourcesParser createFlashingResourcesParser (IDeviceBuildInfo localBuild, DeviceDescriptor descriptor)
طريقة المصنع لإنشاء IFlashingResourcesParser
تمّ عرضها لاختبار الوحدة.
المعلمات | |
---|---|
localBuild |
IDeviceBuildInfo : IDeviceBuildInfo المطلوب تحليله |
descriptor |
DeviceDescriptor : وصف الجهاز الذي يتم فلاشه |
المرتجعات | |
---|---|
IFlashingResourcesParser |
IFlashingResourcesParser تم إنشاؤه من خلال طريقة المصنع |
عمليات الرمي | |
---|---|
|
com.android.tradefed.targetprep.TargetSetupError |
TargetSetupError |
downloadExtraImageFiles
protected void downloadExtraImageFiles (IFlashingResourcesParser resourceParser, IFlashingResourcesRetriever retriever, IDeviceBuildInfo localBuild)
عنصر ربط للسماح للطبقات الفرعية بتنزيل ملفات صور مخصّصة إضافية إذا لزم الأمر
المعلمات | |
---|---|
resourceParser |
IFlashingResourcesParser : IFlashingResourcesParser |
retriever |
IFlashingResourcesRetriever : IFlashingResourcesRetriever |
localBuild |
IDeviceBuildInfo : IDeviceBuildInfo |
عمليات الرمي | |
---|---|
|
com.android.tradefed.targetprep.TargetSetupError |
TargetSetupError |
downloadFlashingResources
protected void downloadFlashingResources (ITestDevice device, IDeviceBuildInfo localBuild)
تنزيل ملفات صور فلاش إضافية مطلوبة
المعلمات | |
---|---|
device |
ITestDevice : ITestDevice لتنزيل المراجع |
localBuild |
IDeviceBuildInfo : IDeviceBuildInfo المطلوب تعبئته يفترض أنّه سبق ضبط ملف صورة الجهاز
|
عمليات الرمي | |
---|---|
DeviceNotAvailableException |
إذا لم يكن الجهاز متاحًا |
TargetSetupError |
في حال تعذّر استرداد الموارد |
executeFastbootCmd
protected String executeFastbootCmd (ITestDevice device, String... cmdArgs)
طريقة مساعدة لتنفيذ أمر fastboot
المعلمات | |
---|---|
device |
ITestDevice : ITestDevice لتنفيذ الأمر |
cmdArgs |
String : الوسيطات التي يجب تقديمها إلى fastboot |
المرتجعات | |
---|---|
String |
سلسلِ ناتج stderr من الأمر إذا لم يكن فارغًا. بخلاف ذلك، يتم عرض stdout. بعض أوامر fastboot غريبة من حيث أنّها تُفرِغ الإخراج إلى stderr في حال النجاح. |
عمليات الرمي | |
---|---|
DeviceNotAvailableException |
إذا لم يكن الجهاز متاحًا |
TargetSetupError |
في حال تعذُّر تنفيذ أمر fastboot |
executeLongFastbootCmd
protected String executeLongFastbootCmd (ITestDevice device, String... cmdArgs)
طريقة مساعدة لتنفيذ أمر fastboot يستغرق وقتًا طويلاً
ملاحظة: يتم تنفيذ معظم أوامر Fastboot عادةً خلال مهلة السماح التي تفرضها INativeDevice.executeFastbootCommand(String)
. ومع ذلك، عند فلاش عدة
أجهزة في آنٍ واحد، يمكن أن تستغرق أوامر Fastboot وقتًا أطول بكثير من المعتاد.
المعلمات | |
---|---|
device |
ITestDevice : ITestDevice لتنفيذ الأمر |
cmdArgs |
String : الوسيطات التي يجب تقديمها إلى fastboot |
المرتجعات | |
---|---|
String |
سلسلِ ناتج stderr من الأمر إذا لم يكن فارغًا. بخلاف ذلك، يتم عرض stdout. بعض أوامر fastboot غريبة من حيث أنّها تُفرِغ الإخراج إلى stderr في حال النجاح. |
عمليات الرمي | |
---|---|
DeviceNotAvailableException |
إذا لم يكن الجهاز متاحًا |
TargetSetupError |
في حال تعذُّر تنفيذ أمر fastboot |
executeLongFastbootCmd
protected String executeLongFastbootCmd (ITestDevice device,envVarMap, String... cmdArgs)
طريقة مساعدة لتنفيذ أمر fastboot يستغرق وقتًا طويلاً باستخدام متغيّرات البيئة
ملاحظة: يتم تنفيذ معظم أوامر Fastboot عادةً خلال مهلة السماح التي تفرضها INativeDevice.executeFastbootCommand(String)
. ومع ذلك، عند فلاش عدة
أجهزة في آنٍ واحد، يمكن أن تستغرق أوامر Fastboot وقتًا أطول بكثير من المعتاد.
المعلمات | |
---|---|
device |
ITestDevice : ITestDevice لتنفيذ الأمر |
envVarMap |
: الخريطة التي تحمل متغيرات البيئة التي يجب ضبطها قبل
تشغيل الأمر fastboot |
cmdArgs |
String : الوسيطات التي يجب تقديمها إلى fastboot |
المرتجعات | |
---|---|
String |
سلسلِ ناتج stderr من الأمر إذا لم يكن فارغًا. بخلاف ذلك، يتم عرض stdout. بعض أوامر fastboot غريبة من حيث أنّها تُفرِغ الإخراج إلى stderr في حال النجاح. |
عمليات الرمي | |
---|---|
DeviceNotAvailableException |
إذا لم يكن الجهاز متاحًا |
TargetSetupError |
في حال تعذُّر تنفيذ أمر fastboot |
flashBaseband
protected void flashBaseband (ITestDevice device, File basebandImageFile)
إعادة تحميل صورة قاعدة النطاق المحدَّدة وإعادة التشغيل إلى برنامج الإقلاع
المعلمات | |
---|---|
device |
ITestDevice : ITestDevice للوميض |
basebandImageFile |
File : صورة قاعدة النطاق ERROR(/File) |
عمليات الرمي | |
---|---|
DeviceNotAvailableException |
إذا لم يكن الجهاز متاحًا |
TargetSetupError |
إذا تعذّر فلاش قاعدة البيانات |
flashBootloader
protected void flashBootloader (ITestDevice device, File bootloaderImageFile)
برمجة صورة برنامج الإقلاع المحدَّدة وإعادة تشغيل الجهاز من جديد في برنامج الإقلاع
المعلمات | |
---|---|
device |
ITestDevice : ITestDevice للوميض |
bootloaderImageFile |
File : صورة أداة تحميل البرامج ERROR(/File) |
عمليات الرمي | |
---|---|
DeviceNotAvailableException |
إذا لم يكن الجهاز متاحًا |
TargetSetupError |
في حال تعذّر الفلاش |
flashExtraImages
protected void flashExtraImages (ITestDevice device, IDeviceBuildInfo deviceBuild)
عليك فلاش أي أقسام خاصة بالجهاز قبل فلاش النظام وإعادة التشغيل. لا يتم تنفيذ أي إجراء ما لم يتم تجاوزه.
المعلمات | |
---|---|
device |
ITestDevice : ITestDevice للوميض |
deviceBuild |
IDeviceBuildInfo : IDeviceBuildInfo الذي يحتوي على ملفات التصميم |
عمليات الرمي | |
---|---|
|
com.android.tradefed.device.DeviceNotAvailableException |
|
com.android.tradefed.targetprep.TargetSetupError |
DeviceNotAvailableException |
|
TargetSetupError |
flashPartition
protected void flashPartition (ITestDevice device, File imgFile, String partition)
فلاش قسم فردي من جهاز
المعلمات | |
---|---|
device |
ITestDevice : ITestDevice للوميض |
imgFile |
File : ERROR(/File) يشير إلى الصورة المطلوب عرضها |
partition |
String : اسم القسم الذي سيتم برمجته |
عمليات الرمي | |
---|---|
DeviceNotAvailableException |
|
TargetSetupError |
flashRamdiskIfNeeded
protected void flashRamdiskIfNeeded (ITestDevice device, IDeviceBuildInfo deviceBuild)
المعلمات | |
---|---|
device |
ITestDevice |
deviceBuild |
IDeviceBuildInfo |
عمليات الرمي | |
---|---|
DeviceNotAvailableException |
|
TargetSetupError |
flashSystem
protected void flashSystem (ITestDevice device, IDeviceBuildInfo deviceBuild)
وضِع صورة النظام على الجهاز
المعلمات | |
---|---|
device |
ITestDevice : ITestDevice للوميض |
deviceBuild |
IDeviceBuildInfo : IDeviceBuildInfo للوميض |
عمليات الرمي | |
---|---|
DeviceNotAvailableException |
إذا لم يكن الجهاز متاحًا |
TargetSetupError |
في حال تعذُّر تنفيذ أمر fastboot |
flashUserData
protected void flashUserData (ITestDevice device, IDeviceBuildInfo deviceBuild)
فلاش قسم userdata على الجهاز
المعلمات | |
---|---|
device |
ITestDevice : ITestDevice للوميض |
deviceBuild |
IDeviceBuildInfo : IDeviceBuildInfo الذي يحتوي على الملفات المطلوب فلاشها |
عمليات الرمي | |
---|---|
DeviceNotAvailableException |
إذا لم يكن الجهاز متاحًا |
TargetSetupError |
في حال تعذّر فلاش بيانات المستخدم |
flashUserDataFromDeviceImageFile
protected void flashUserDataFromDeviceImageFile (ITestDevice device, IDeviceBuildInfo deviceBuild)
استخراج ملف userdata.img من ملف صورة الجهاز وفلاشه على الجهاز
المعلمات | |
---|---|
device |
ITestDevice : ITestDevice للوميض |
deviceBuild |
IDeviceBuildInfo : IDeviceBuildInfo الذي يحتوي على الملفات المطلوب فلاشها |
عمليات الرمي | |
---|---|
DeviceNotAvailableException |
إذا لم يكن الجهاز متاحًا |
TargetSetupError |
في حال تعذّر استخراج بيانات المستخدم أو فلاشها |
getBootPartitionName
protected String getBootPartitionName ()
الحصول على اسم قسم التمهيد لأداة فلاش هذا الجهاز
القيمة التلقائية هي "bootloader". يجب إلغاء القيمة المحدَّدة في الفئات الفرعية إذا لزم الأمر.
المرتجعات | |
---|---|
String |
getBootloaderFilePrefix
protected String getBootloaderFilePrefix (ITestDevice device)
الحصول على بادئة ملف مشغّل التحميل
الإعداد التلقائي هو getBootPartitionName()
. يجب إلغاء القيمة المحدَّدة في الفئات الفرعية إذا لزم الأمر.
المعلمات | |
---|---|
device |
ITestDevice : ITestDevice للوميض |
المرتجعات | |
---|---|
String |
عمليات الرمي | |
---|---|
DeviceNotAvailableException |
إذا لم يكن الجهاز متاحًا |
TargetSetupError |
في حال تعذّر الحصول على البادئة |
getCurrentSlot
protected String getCurrentSlot (ITestDevice device)
طريقة مساعدة لاسترداد الفتحة الحالية (للأجهزة المزوّدة بميزة A/B)
المعلمات | |
---|---|
device |
ITestDevice : ITestDevice لتنفيذ الأمر |
المرتجعات | |
---|---|
String |
"a" أو "b" أو null (إذا لم يكن الجهاز متوافقًا مع وضع A/B) |
عمليات الرمي | |
---|---|
|
com.android.tradefed.device.DeviceNotAvailableException |
|
com.android.tradefed.targetprep.TargetSetupError |
DeviceNotAvailableException |
|
TargetSetupError |
getFlashingResourcesRetriever
protected IFlashingResourcesRetriever getFlashingResourcesRetriever ()
المرتجعات | |
---|---|
IFlashingResourcesRetriever |
getImageVersion
protected String getImageVersion (ITestDevice device, String imageName)
المعلمات | |
---|---|
device |
ITestDevice |
imageName |
String |
المرتجعات | |
---|---|
String |
عمليات الرمي | |
---|---|
DeviceNotAvailableException |
|
TargetSetupError |
handleUserDataFlashing
protected void handleUserDataFlashing (ITestDevice device, IDeviceBuildInfo deviceBuild)
معالجة وميض قسم userdata/cache
المعلمات | |
---|---|
device |
ITestDevice : ITestDevice للوميض |
deviceBuild |
IDeviceBuildInfo : IDeviceBuildInfo الذي يحتوي على الملفات المطلوب فلاشها |
عمليات الرمي | |
---|---|
|
com.android.tradefed.device.DeviceNotAvailableException |
|
com.android.tradefed.targetprep.TargetSetupError |
DeviceNotAvailableException |
|
TargetSetupError |
hasPartition
protected boolean hasPartition (ITestDevice device, String partition)
التحقّق من برنامج الإقلاع لمعرفة ما إذا كان القسم المحدّد متوفّرًا أم لا
المعلمات | |
---|---|
device |
ITestDevice : ITestDevice المطلوب إجراء عملية عليه |
partition |
String : اسم التقسيم المطلوب التحقّق منه |
المرتجعات | |
---|---|
boolean |
عمليات الرمي | |
---|---|
DeviceNotAvailableException |
preFlashSetup
protected void preFlashSetup (ITestDevice device, IDeviceBuildInfo deviceBuild)
نفِّذ أي إعدادات إضافية مطلوبة قبل الفلاش. لا يتم تنفيذ أي إجراء ما لم يتم إلغاء هذا الإعداد.
المعلمات | |
---|---|
device |
ITestDevice : ITestDevice لإعداد |
deviceBuild |
IDeviceBuildInfo : IDeviceBuildInfo الذي يحتوي على ملفات التصميم |
عمليات الرمي | |
---|---|
|
com.android.tradefed.device.DeviceNotAvailableException |
|
com.android.tradefed.targetprep.TargetSetupError |
DeviceNotAvailableException |
|
TargetSetupError |
setSystemBuildInfo
protected void setSystemBuildInfo (String systemBuildId, String systemBuildFlavor)
المعلمات | |
---|---|
systemBuildId |
String |
systemBuildFlavor |
String |
verifyRequiredBoards
protected void verifyRequiredBoards (ITestDevice device, IFlashingResourcesParser resourceParser, String deviceProductType)
تأكَّد من أنّ نوع منتج الجهاز متوافق مع الإصدار المطلوب تثبيته.
سيتحقّق التنفيذ الأساسي من تضمين سمة deviceProductType في مجموعة IFlashingResourcesParser.getRequiredBoards()
. يمكن أن تلغي الفئات الفرعية الإعدادات كما تريد.
المعلمات | |
---|---|
device |
ITestDevice : ITestDevice المطلوب فلاشها |
resourceParser |
IFlashingResourcesParser : IFlashingResourcesParser |
deviceProductType |
String : نوع المنتج device |
عمليات الرمي | |
---|---|
TargetSetupError |
إذا لم تتطابق معلومات اللوحة المطلوبة للإصدار مع الجهاز |
wipeCache
protected void wipeCache (ITestDevice device)
محو قسم ذاكرة التخزين المؤقت على الجهاز
المعلمات | |
---|---|
device |
ITestDevice : ITestDevice للوميض |
عمليات الرمي | |
---|---|
DeviceNotAvailableException |
إذا لم يكن الجهاز متاحًا |
TargetSetupError |
في حال تعذّر إعادة تحميل ذاكرة التخزين المؤقت |
wipePartition
protected void wipePartition (ITestDevice device, String partition)
محو القسم المحدّد باستخدام fastboot erase <name>
المعلمات | |
---|---|
device |
ITestDevice : ITestDevice المطلوب إجراء عملية عليه |
partition |
String : اسم التقسيم المطلوب محوه |
عمليات الرمي | |
---|---|
DeviceNotAvailableException |
|
TargetSetupError |