FastbootDeviceFlasher
public
class
FastbootDeviceFlasher
extends Object
implements
IDeviceFlasher
| java.lang.Object | |
| ↳ | com.android.tradefed.targetprep.FastbootDeviceFlasher |
فئة تعتمد على fastboot لتثبيت صورة على أجهزة Android فعلية.
ملخّص
الثوابت | |
|---|---|
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)
تضبط قسم ramdisk |
void
|
setShouldFlashRamdisk(boolean shouldFlashRamdisk)
تحديد ما إذا كان سيتم نقل ملف ramdisk إضافي بعد تحديث الجهاز من خلال ملف zip للصور |
void
|
setUserDataFlashOption(IDeviceFlasher.UserDataFlashOption flashOption)
تحديد ما إذا كان يجب عرض صورة بيانات المستخدم أو محوها أو الاحتفاظ بها |
void
|
setWipeTimeout(long timeout)
اضبط المهلة الزمنية لمحو البيانات. |
boolean
|
shouldFlashRamdisk()
يتحقّق مما إذا كان برنامج التثبيت مضبوطًا على تثبيت ramdisk إضافي بعد تحديث الجهاز من خلال ملف مضغوط يحتوي على صورة |
boolean
|
shouldSkipBootloaderVersionCheck()
|
static
boolean
|
stderrContainsFailed(String stderr, boolean skipBootloaderVersionCheck)
|
static
boolean
|
stderrContainsFailed(String stderr, boolean skipBootloaderVersionCheck, boolean skipFastbootFailedMessage)
|
الطُرق المحمية | |
|---|---|
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)
تثبيت قسم بيانات المستخدم على الجهاز |
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)
التعامل مع وميض قسم بيانات المستخدم/ذاكرة التخزين المؤقت |
boolean
|
hasPartition(ITestDevice device, String partition)
التحقّق من برنامج الإقلاع لمعرفة ما إذا كان القسم المحدّد متوفّرًا أم لا |
void
|
preFlashSetup(ITestDevice device, IDeviceBuildInfo deviceBuild)
نفِّذ أي عملية إعداد إضافية مطلوبة قبل التثبيت. |
void
|
setSkipBootloaderVersionCheck(boolean skipBootloaderVersionCheck)
|
void
|
setSkipFastbootFailedMessage(boolean skipFastbootFailedMessage)
|
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
القيمة الثابتة: "radio"
الإنشاءات العامة
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)
تضبط قسم ramdisk
setShouldFlashRamdisk
public void setShouldFlashRamdisk (boolean shouldFlashRamdisk)
تحديد ما إذا كان سيتم نقل ملف ramdisk إضافي بعد تحديث الجهاز من خلال ملف zip للصور
setUserDataFlashOption
public void setUserDataFlashOption (IDeviceFlasher.UserDataFlashOption flashOption)
تحديد ما إذا كان يجب عرض صورة بيانات المستخدم أو محوها أو الاحتفاظ بها
setWipeTimeout
public void setWipeTimeout (long timeout)
اضبط المهلة الزمنية لمحو البيانات.
| المعلمات | |
|---|---|
timeout |
long |
shouldFlashRamdisk
public boolean shouldFlashRamdisk ()
يتحقّق مما إذا كان برنامج التثبيت مضبوطًا على تثبيت ramdisk إضافي بعد تحديث الجهاز من خلال ملف مضغوط يحتوي على صورة
| المرتجعات | |
|---|---|
boolean |
|
shouldSkipBootloaderVersionCheck
public boolean shouldSkipBootloaderVersionCheck ()
| المرتجعات | |
|---|---|
boolean |
|
stderrContainsFailed
public static boolean stderrContainsFailed (String stderr,
boolean skipBootloaderVersionCheck)| المعلمات | |
|---|---|
stderr |
String |
skipBootloaderVersionCheck |
boolean |
| المرتجعات | |
|---|---|
boolean |
|
stderrContainsFailed
public static boolean stderrContainsFailed (String stderr,
boolean skipBootloaderVersionCheck,
boolean skipFastbootFailedMessage)| المعلمات | |
|---|---|
stderr |
String |
skipBootloaderVersionCheck |
boolean |
skipFastbootFailedMessage |
boolean |
| المرتجعات | |
|---|---|
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 Some بعض أوامر 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 Some بعض أوامر 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 Some بعض أوامر 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)
تثبيت قسم بيانات المستخدم على الجهاز
| المعلمات | |
|---|---|
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" أو قيمة فارغة (إذا كان الجهاز لا يتوافق مع نظام التشغيل 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)
التعامل مع وميض قسم بيانات المستخدم/ذاكرة التخزين المؤقت
| المعلمات | |
|---|---|
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 |
|
setSkipBootloaderVersionCheck
protected void setSkipBootloaderVersionCheck (boolean skipBootloaderVersionCheck)
| المعلمات | |
|---|---|
skipBootloaderVersionCheck |
boolean |
setSkipFastbootFailedMessage
protected void setSkipFastbootFailedMessage (boolean skipFastbootFailedMessage)
| المعلمات | |
|---|---|
skipFastbootFailedMessage |
boolean |
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 |
|