FastbootDeviceFlasher

public class FastbootDeviceFlasher
extends Object implements IDeviceFlasher

java.lang.Object
↳	com.android.tradefed.targetprep.FastbootDeviceFlasher

الفئات الفرعية المباشرة المعروفة CdmaDeviceFlasher CdmaDeviceFlasher فئة تعرض صورة على جهاز Android أصلي مزوّد بجهاز إرسال لاسلكي CDMA

---

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

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)

معالجة وميض قسم 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