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

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

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

void setFlashOptions( 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 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)

طريقة المصنع لإنشاء 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)

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

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

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

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