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(Collection<String> dataWipeSkipList)

تحدِّد هذه السياسة قائمة المسارات ضمن /data التي يجب تجنُّب محوها عند استخدام ITestsZipInstaller.

يُرجى العِلم أنّ مستوى تفصيل قائمة التخطّي هو العناصر الفرعية المباشرة للعنصر /data.

void setFlashOptions(Collection<String> flashOptions)

تحدِّد هذه السمة قائمة بالخيارات التي سيتم تمريرها مع أوامر التحديث أو التثبيت السريع.

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 shouldCheckBasebandVersionAfterFlash()
boolean shouldFlashRamdisk()

يتحقّق مما إذا كان برنامج التحديث مضبوطًا على عرض قرص RAM إضافي بعد تحديث الجهاز من خلال ملف مضغوط يحتوي على صورة

boolean shouldSkipBasebandVersionCheck()
boolean shouldSkipBootloaderVersionCheck()
static boolean stderrContainsFailed(String stderr, boolean skipBootloaderVersionCheck, boolean skipBasebandVersionCheck, boolean skipFastbootFailedMessage)
static boolean stderrContainsFailed(String stderr, boolean skipBootloaderVersionCheck, boolean skipBasebandVersionCheck)

طُرق محمية

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)

طريقة المصنع لإنشاء IFlashingResourcesParser.

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, Map<String, String> envVarMap, String... cmdArgs)

طريقة مساعدة لتنفيذ أمر fastboot طويل الأمد باستخدام متغيّرات البيئة

void flashBaseband(ITestDevice device, File basebandImageFile)

يومض صورة النطاق الأساسي المحدّدة ويعيد التشغيل إلى برنامج الإقلاع

void flashBootloader(ITestDevice device, File bootloaderImageFile, boolean requireReboot)

يومض صورة برنامج الإقلاع المحدّدة.

void flashBootloader(ITestDevice device, File bootloaderImageFile)

يومض صورة برنامج الإقلاع المحدّدة ويعيد التشغيل إلى برنامج الإقلاع

void flashExtraImages(ITestDevice device, IDeviceBuildInfo deviceBuild)

يجب تثبيت ذاكرة ROM لأي أقسام خاصة بالجهاز قبل تثبيت ذاكرة ROM للنظام وإعادة التشغيل.

void flashPartition(ITestDevice device, File imgFile, String partition)

تثبيت ذاكرة ROM لقسم فردي من جهاز

void flashRamdiskIfNeeded(ITestDevice device, IDeviceBuildInfo deviceBuild)
void flashSystem(ITestDevice device, IDeviceBuildInfo deviceBuild)

تثبيت صورة النظام على الجهاز

void flashTrusty(ITestDevice device, File trustyImageFile)

يومض صورة trusty المحدّدة ويعيد التشغيل إلى برنامج الإقلاع

void flashUserData(ITestDevice device, IDeviceBuildInfo deviceBuild)

تثبيت ذاكرة ROM لقسم بيانات المستخدم على الجهاز.

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 setCheckBasebandVersionAfterFlash(boolean checkBasebandVersionAfterFlash)
void setSkipBasebandVersionCheck(boolean skipBasebandVersionCheck)
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 (Collection<String> dataWipeSkipList)

تحدِّد هذه السياسة قائمة المسارات ضمن /data التي يجب تجنُّب محوها عند استخدام ITestsZipInstaller.

يُرجى العِلم أنّ مستوى تفصيل قائمة التخطّي هو العناصر الفرعية المباشرة للعنصر /data.

المعلَمات
dataWipeSkipList Collection

setFlashOptions

public void setFlashOptions (Collection<String> 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

shouldCheckBasebandVersionAfterFlash

public boolean shouldCheckBasebandVersionAfterFlash ()

المرتجعات
boolean

shouldFlashRamdisk

public boolean shouldFlashRamdisk ()

يتحقّق مما إذا كان برنامج التحديث مضبوطًا على عرض قرص RAM إضافي بعد تحديث الجهاز من خلال ملف مضغوط يحتوي على صورة

المرتجعات
boolean

shouldSkipBasebandVersionCheck

public boolean shouldSkipBasebandVersionCheck ()

المرتجعات
boolean

shouldSkipBootloaderVersionCheck

public boolean shouldSkipBootloaderVersionCheck ()

المرتجعات
boolean

stderrContainsFailed

public static boolean stderrContainsFailed (String stderr, 
                boolean skipBootloaderVersionCheck, 
                boolean skipBasebandVersionCheck, 
                boolean skipFastbootFailedMessage)

المعلَمات
stderr String

skipBootloaderVersionCheck boolean

skipBasebandVersionCheck boolean

skipFastbootFailedMessage boolean

المرتجعات
boolean

stderrContainsFailed

public static boolean stderrContainsFailed (String stderr, 
                boolean skipBootloaderVersionCheck, 
                boolean skipBasebandVersionCheck)

المعلَمات
stderr String

skipBootloaderVersionCheck boolean

skipBasebandVersionCheck boolean

المرتجعات
boolean

طُرق محمية

checkAndFlashBaseband

protected void checkAndFlashBaseband (ITestDevice device, 
                IDeviceBuildInfo deviceBuild)

إذا لزم الأمر، ثبِّت صورة النطاق الأساسي على الجهاز. لن يتم تحديث النطاق الأساسي إلا إذا كان الإصدار الحالي على الجهاز مختلفًا عن الإصدار المطلوب

المعلَمات
device ITestDevice: ITestDevice المطلوب عرضه بشكل متقطع
deviceBuild IDeviceBuildInfo: IDeviceBuildInfo الذي يحتوي على صورة النطاق الأساسي المراد تثبيتها
عمليات الطرح
DeviceNotAvailableException في حال عدم توفّر الجهاز
TargetSetupError إذا تعذّر تثبيت ذاكرة ROM للنطاق الأساسي

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,IDeviceBuildInfo)/#shouldFlashSystem(java.lang.String,java.lang.String,com.android.tradefed.build.IDeviceBuildInfo) shouldFlashSystem(String,String,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 إذا تعذّر تثبيت ذاكرة ROM للنطاق الأساسي

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 في غضون المهلة الزمنية المسموح بها من خلال ITestDevice.executeFastbootCommand(String...). ومع ذلك، عند وميض أجهزة متعددة في الوقت نفسه، قد تستغرق أوامر fastboot وقتًا أطول بكثير من المعتاد.

المعلَمات
device ITestDevice: ITestDevice لتنفيذ الأمر عليه
cmdArgs String: الوسيطات التي يجب تقديمها إلى fastboot
المرتجعات
String سلسلة مخرجات stderr من الأمر إذا كانت غير فارغة. بخلاف ذلك، تعرض stdout Some بعض أوامر fastboot غريبة لأنّها تعرض الناتج إلى stderr في حالة النجاح
عمليات الطرح
DeviceNotAvailableException في حال عدم توفّر الجهاز
TargetSetupError في حال تعذُّر تنفيذ أمر fastboot

executeLongFastbootCmd

protected String executeLongFastbootCmd (ITestDevice device, 
                Map<String, String> envVarMap, 
                String... cmdArgs)

طريقة مساعدة لتنفيذ أمر fastboot طويل الأمد باستخدام متغيّرات البيئة

ملاحظة: يتم عادةً تنفيذ معظم أوامر fastboot في غضون المهلة المسموح بها من خلال ITestDevice.executeFastbootCommand(String...). ومع ذلك، عند وميض أجهزة متعددة في الوقت نفسه، قد تستغرق أوامر fastboot وقتًا أطول بكثير من المعتاد.

المعلَمات
device ITestDevice: ITestDevice لتنفيذ الأمر عليه
envVarMap Map: الخريطة التي تتضمّن متغيرات البيئة التي يجب ضبطها قبل تشغيل أمر 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: صورة النطاق الأساسي File
عمليات الطرح
DeviceNotAvailableException في حال عدم توفّر الجهاز
TargetSetupError إذا تعذّر تثبيت ذاكرة ROM للنطاق الأساسي

flashBootloader

protected void flashBootloader (ITestDevice device, 
                File bootloaderImageFile, 
                boolean requireReboot)

يومض صورة برنامج الإقلاع المحدّدة.

المعلَمات
device ITestDevice: ITestDevice المطلوب عرضه بشكل متقطع
bootloaderImageFile ‫File: صورة برنامج الإقلاع File
requireReboot boolean: ما إذا كان سيتم إعادة التشغيل بعد التثبيت
عمليات الطرح
DeviceNotAvailableException في حال عدم توفّر الجهاز
TargetSetupError في حال تعذّر الوميض

flashBootloader

protected void flashBootloader (ITestDevice device, 
                File bootloaderImageFile)

يومض صورة برنامج الإقلاع المحدّدة ويعيد التشغيل إلى برنامج الإقلاع

المعلَمات
device ITestDevice: ITestDevice المطلوب عرضه بشكل متقطع
bootloaderImageFile ‫File: صورة برنامج الإقلاع File
عمليات الطرح
DeviceNotAvailableException في حال عدم توفّر الجهاز
TargetSetupError في حال تعذّر الوميض

flashExtraImages

protected void flashExtraImages (ITestDevice device, 
                IDeviceBuildInfo deviceBuild)

يجب تثبيت ذاكرة ROM لأي أقسام خاصة بالجهاز قبل تثبيت ذاكرة ROM للنظام وإعادة التشغيل. لا يتم تنفيذ أي عملية ما لم يتم تجاوزها.

المعلَمات
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)

تثبيت ذاكرة ROM لقسم فردي من جهاز

المعلَمات
device ITestDevice: ITestDevice المطلوب عرضه بشكل متقطع
imgFile File: 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

flashTrusty

protected void flashTrusty (ITestDevice device, 
                File trustyImageFile)

يومض صورة trusty المحدّدة ويعيد التشغيل إلى برنامج الإقلاع

المعلَمات
device ITestDevice: ITestDevice المطلوب عرضه بشكل متقطع
trustyImageFile File: الصورة الموثوقة File
عمليات الطرح
DeviceNotAvailableException في حال عدم توفّر الجهاز
TargetSetupError في حال تعذّر الوميض

flashUserData

protected void flashUserData (ITestDevice device, 
                IDeviceBuildInfo deviceBuild)

تثبيت ذاكرة ROM لقسم بيانات المستخدم على الجهاز.

المعلَمات
device ITestDevice: ITestDevice المطلوب عرضه بشكل متقطع
deviceBuild IDeviceBuildInfo: IDeviceBuildInfo الذي يحتوي على الملفات المطلوب تثبيتها
عمليات الطرح
DeviceNotAvailableException في حال عدم توفّر الجهاز
TargetSetupError في حال تعذُّر تثبيت ذاكرة ROM لبيانات المستخدمين

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

getFuseUtil

protected FuseUtil getFuseUtil ()

المرتجعات
FuseUtil

getImageVersion

protected String getImageVersion (ITestDevice device, 
                String imageName)

المعلَمات
device ITestDevice

imageName String

القيم المُعادة
String

عمليات الطرح
DeviceNotAvailableException
TargetSetupError

getRunUtil

protected IRunUtil getRunUtil ()

يتم عرضها للاختبار.

المرتجعات
IRunUtil

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

setCheckBasebandVersionAfterFlash

protected void setCheckBasebandVersionAfterFlash (boolean checkBasebandVersionAfterFlash)

المعلَمات
checkBasebandVersionAfterFlash boolean

setSkipBasebandVersionCheck

protected void setSkipBasebandVersionCheck (boolean skipBasebandVersionCheck)

المعلَمات
skipBasebandVersionCheck boolean

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