برنامج 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( dataWipeSkipList)

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

تجدر الإشارة إلى أنّ دقّة قائمة التخطّي هي عناصر ثانوية مباشرة لـ /data.

void setFlashOptions( flashOptions)

تضبط هذه السياسة قائمة بالخيارات التي سيتم تمريرها باستخدام أوامر الفلاش/التحديث.

void setFlashingResourcesRetriever(IFlashingResourcesRetriever retriever)

لضبط الآلية التي يمكن لبرنامج الفلاش من خلالها استرداد ملفات الموارد لإجراء الوميض.

void setForceSystemFlash(boolean forceSystemFlash)

لضبط ما إذا كان يجب تحديث النظام دائمًا حتى في حال تشغيل الإصدار الحالي

void setIncrementalFlashing(IncrementalImageUtil incrementalUtil)
void setRamdiskPartition(String ramdiskPartition)

لضبط قسم RAMD

void setShouldFlashRamdisk(boolean shouldFlashRamdisk)

لضبط ما إذا كان يجب وميض قرص ذاكرة إضافي بعد تحديث الجهاز عبر ملف zip للصور

void setUserDataFlashOption(IDeviceFlasher.UserDataFlashOption flashOption)

تبديل ما إذا كان يجب وميض صورة بيانات المستخدم أو مسحها أو الاحتفاظ بها

void setWipeTimeout(long timeout)

ضبط مهلة حجب البيانات.

boolean shouldFlashRamdisk()

للتحقق مما إذا تم ضبط وميض على ذاكرة وصول عشوائي إضافية بعد تحديث الجهاز عبر برنامج 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)

طريقة الإعدادات الأصلية لإنشاء IFlashingResourcesParser.

void downloadExtraImageFiles(IFlashingResourcesParser resourceParser, IFlashingResourcesRetriever retriever, IDeviceBuildInfo localBuild)

استخدِم عنصر الجذب للسماح للفئات الفرعية بتنزيل ملفات صور مخصّصة إضافية عند الحاجة.

void downloadFlashingResources(ITestDevice device, IDeviceBuildInfo localBuild)

لتنزيل ملفات الصور الوامضة الإضافية المطلوبة

String executeFastbootCmd(ITestDevice device, String... cmdArgs)

طريقة مساعد لتنفيذ أمر Fastboot (Fastboot).

String executeLongFastbootCmd(ITestDevice device, String... cmdArgs)

طريقة مساعِدة لتنفيذ أمر Fastboot طويل الأمد

String executeLongFastbootCmd(ITestDevice device, envVarMap, String... cmdArgs)

طريقة مساعدة لتنفيذ أمر 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)

قسم بيانات المستخدمين Flash على الجهاز.

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 setSystemBuildInfo(String systemBuildId, String systemBuildFlavor)
void verifyRequiredBoards(ITestDevice device, IFlashingResourcesParser resourceParser, String deviceProductType)

تحقق من أن نوع منتج الجهاز يتوافق مع النسخة التي سيتم تحديثها.

void wipeCache(ITestDevice device)

مسح قسم ذاكرة التخزين المؤقت على الجهاز

void wipePartition(ITestDevice device, String partition)

حجب بيانات القسم المحدد باستخدام "محو Fastboot <name>"

الحقول

BASEBAND_IMAGE_NAME

public static final String BASEBAND_IMAGE_NAME

شركة إنشاءات عامة

برنامج FastbootDeviceFlasher

public FastbootDeviceFlasher ()

الطرق العامة

جلبImageVersion

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 ما إذا كان ينبغي وميض صورة بيانات المستخدم أو مسحها أو الاحتفاظ بها

استبدالDeviceOptions

public void overrideDeviceOptions (ITestDevice device)

خيارات الإلغاء للجهاز. يتم استخدامه لإلغاء قيم الخيارات التلقائية إذا كانت الإعدادات التلقائية غير متوافقة مع جهاز معيّن.

عمليات ما قبل Flash

public void preFlashOperations (ITestDevice device, 
                IDeviceBuildInfo deviceBuild)

جميع عمليات الإعداد وعمليات التحقّق التي يجب أن تحدث قبل الجزء المهمّ الوامض الفعلي ولن يتم تضمين أي من هذه العمليات في القسم المهم الذي يتم التحكّم فيه بالتزامن.

المعلّمات
device ITestDevice: السمة ITestDevice المطلوب وميضها

deviceBuild IDeviceBuildInfo: السمة IDeviceBuildInfo المطلوب وميضها

الرميات
DeviceNotAvailableException
TargetSetupError

setDataDatawaveEscapeList

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)

لضبط ما إذا كان يجب تحديث النظام دائمًا حتى في حال تشغيل الإصدار الحالي

تعيين IncrementalFlashing

public void setIncrementalFlashing (IncrementalImageUtil incrementalUtil)

المعلّمات
incrementalUtil IncrementalImageUtil

تعيين Ramdisk Partition

public void setRamdiskPartition (String ramdiskPartition)

لضبط قسم RAMD

setShouldFlashRamdisk

public void setShouldFlashRamdisk (boolean shouldFlashRamdisk)

لضبط ما إذا كان يجب وميض قرص ذاكرة إضافي بعد تحديث الجهاز عبر ملف zip للصور

setUserDataFlashOption

public void setUserDataFlashOption (IDeviceFlasher.UserDataFlashOption flashOption)

تبديل ما إذا كان يجب وميض صورة بيانات المستخدم أو مسحها أو الاحتفاظ بها

ضبط المهلة المحددة

public void setWipeTimeout (long timeout)

ضبط مهلة حجب البيانات.

المعلّمات
timeout long

يجب FlashRamdisk

public boolean shouldFlashRamdisk ()

للتحقق مما إذا تم ضبط وميض على ذاكرة وصول عشوائي إضافية بعد تحديث الجهاز عبر برنامج zip للصور

الركلات المردودة
boolean

الطرق المحمية

CheckAndFlashBase Band

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 في حال تعذّر تحميل برنامج الإقلاع

CheckShouldFlashBase Band

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

تنزيل FlashingResources

protected void downloadFlashingResources (ITestDevice device, 
                IDeviceBuildInfo localBuild)

لتنزيل ملفات الصور الوامضة الإضافية المطلوبة

المعلّمات
device ITestDevice: ITestDevice لتنزيل الموارد الخاصة به

localBuild IDeviceBuildInfo: السمة IDeviceBuildInfo المطلوب تعبئتها على افتراض أنّ ملف صورة الجهاز قد سبق ضبطه

الرميات
DeviceNotAvailableException إذا لم يكن الجهاز متاحًا
TargetSetupError في حال تعذّر استرداد الموارد

تنفيذ FastbootCmd

protected String executeFastbootCmd (ITestDevice device, 
                String... cmdArgs)

طريقة مساعد لتنفيذ أمر Fastboot (Fastboot).

المعلّمات
device ITestDevice: السمة ITestDevice المطلوب تنفيذ الأمر عليها

cmdArgs String: الوسيطات التي يجب تقديمها إلى Fastboot

الركلات المردودة
String سلسلة إخراج Stderr من الأمر إذا لم تكن فارغة. بخلاف ذلك يتم إرجاع stdout. بعض أوامر Fastboot غريبة لأنّها تنقل المخرجات إلى المفتاح stderr في حالة النجاح.

الرميات
DeviceNotAvailableException إذا لم يكن الجهاز متاحًا
TargetSetupError في حال فشل أمر Fastboot

تنفيذ LongFastbootCmd

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

تنفيذ LongFastbootCmd

protected String executeLongFastbootCmd (ITestDevice device, 
                 envVarMap, 
                String... cmdArgs)

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

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

المعلّمات
device ITestDevice: السمة ITestDevice المطلوب تنفيذ الأمر عليها

envVarMap : الخريطة التي تتضمن متغيرات البيئة التي يجب ضبطها قبل تشغيل أمر Fastboot (Fastboot)

cmdArgs String: الوسيطات التي يجب تقديمها إلى Fastboot

الركلات المردودة
String سلسلة إخراج Stderr من الأمر إذا لم تكن فارغة. بخلاف ذلك يتم إرجاع stdout. بعض أوامر Fastboot غريبة لأنّها تنقل المخرجات إلى المفتاح stderr في حالة النجاح.

الرميات
DeviceNotAvailableException إذا لم يكن الجهاز متاحًا
TargetSetupError في حال فشل أمر Fastboot

شريط أساسي فلاش

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

قسم الفلاش

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

مسح جزء فردي من الجهاز

المعلّمات
device ITestDevice: السمة ITestDevice المطلوب وميضها

imgFile File: عنصر ERROR(/File) يشير إلى الصورة التي سيتم وميضها

partition String: اسم القسم المراد تحديثه

الرميات
DeviceNotAvailableException
TargetSetupError

فلاشRamdiskIfبحed

protected void flashRamdiskIfNeeded (ITestDevice device, 
                IDeviceBuildInfo deviceBuild)

المعلّمات
device ITestDevice

deviceBuild IDeviceBuildInfo

الرميات
DeviceNotAvailableException
TargetSetupError

نظام الفلاش

protected void flashSystem (ITestDevice device, 
                IDeviceBuildInfo deviceBuild)

فلاش صورة النظام على الجهاز.

المعلّمات
device ITestDevice: السمة ITestDevice المطلوب وميضها

deviceBuild IDeviceBuildInfo: السمة IDeviceBuildInfo المطلوب وميضها

الرميات
DeviceNotAvailableException إذا لم يكن الجهاز متاحًا
TargetSetupError في حال فشل أمر Fastboot

بيانات المستخدم فلاش

protected void flashUserData (ITestDevice device, 
                IDeviceBuildInfo deviceBuild)

قسم بيانات المستخدمين Flash على الجهاز.

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

احصل على اسم قسم التشغيل لبرنامج الفلاش على هذا الجهاز.

تكون القيمة التلقائية هي "برنامج الإقلاع". ويجب أن تلغي الفئات الفرعية إذا لزم الأمر.

الركلات المردودة
String

getBootloaderFilePrefix

protected String getBootloaderFilePrefix (ITestDevice device)

احصل على بادئة ملف برنامج الإقلاع.

وتكون القيمة التلقائية هي getBootPartitionName(). ويجب أن تلغي الفئات الفرعية إذا لزم الأمر.

المعلّمات
device ITestDevice: السمة ITestDevice المطلوب وميضها

الركلات المردودة
String

الرميات
DeviceNotAvailableException إذا لم يكن الجهاز متاحًا
TargetSetupError إذا تعذّر الحصول على بادئة

الحصول على Currents

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

الحصول على FlashingResourcesRetriever

protected IFlashingResourcesRetriever getFlashingResourcesRetriever ()

الركلات المردودة
IFlashingResourcesRetriever

الحصول على FuseUtil

protected FuseUtil getFuseUtil ()

الركلات المردودة
FuseUtil

getImageVersion

protected String getImageVersion (ITestDevice device, 
                String imageName)

المعلّمات
device ITestDevice

imageName String

الركلات المردودة
String

الرميات
DeviceNotAvailableException
TargetSetupError

الحصول على RunUtil

protected IRunUtil getRunUtil ()

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

الركلات المردودة
IRunUtil

HandUserDataFlashing

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

لهاتقسيم

protected boolean hasPartition (ITestDevice device, 
                String partition)

للتأكّد من توفّر القسم المحدّد باستخدام برنامج الإقلاع

المعلّمات
device ITestDevice: ITestDevice الذي سيتم تشغيله عليه

partition String: اسم القسم المراد التحقّق منه

الركلات المردودة
boolean

الرميات
DeviceNotAvailableException

الإعداد المسبق للفلاش

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

التحقق من اللوحات المطلوبة

protected void verifyRequiredBoards (ITestDevice device, 
                IFlashingResourcesParser resourceParser, 
                String deviceProductType)

تحقق من أن نوع منتج الجهاز يتوافق مع النسخة التي سيتم تحديثها.

سيتحقّق التنفيذ الأساسي من تضمين deviceProductType في مجموعة IFlashingResourcesParser.getRequiredBoards(). وقد تلغي الفئات الفرعية على النحو المطلوب.

المعلّمات
device ITestDevice: السمة ITestDevice التي سيتم وميضها

resourceParser IFlashingResourcesParser: IFlashingResourcesParser

deviceProductType String: نوع المنتج "device"

الرميات
TargetSetupError إذا كانت معلومات اللوحة المطلوبة في الإصدار لا تتطابق مع الجهاز

مسح ذاكرة التخزين المؤقت

protected void wipeCache (ITestDevice device)

مسح قسم ذاكرة التخزين المؤقت على الجهاز

المعلّمات
device ITestDevice: السمة ITestDevice المطلوب وميضها

الرميات
DeviceNotAvailableException إذا لم يكن الجهاز متاحًا
TargetSetupError إذا فشل عمل ذاكرة التخزين المؤقت

حجب البيانات

protected void wipePartition (ITestDevice device, 
                String partition)

حجب بيانات القسم المحدد باستخدام "محو Fastboot <name>"

المعلّمات
device ITestDevice: ITestDevice الذي سيتم تشغيله عليه

partition String: اسم القسم المراد مسحه

الرميات
DeviceNotAvailableException
TargetSetupError