IDeviceFlasher

public interface IDeviceFlasher

com.android.tradefed.targetprep.IDeviceFlasher


وميضات صورة الجهاز على الجهاز

ملخّص

الطرق العامة

abstract void flash(ITestDevice device, IDeviceBuildInfo deviceBuild)

يتم إنشاء الفلاشات على الجهاز.

default getAdditionalFileFilters()

الحصول على فلاتر لعناصر البناء الإضافية

abstract CommandStatus getSystemFlashingStatus()

استرداد حالة تنفيذ الأمر لفلاش أقسام النظام الأساسية

abstract IDeviceFlasher.UserDataFlashOption getUserDataFlashOption()

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

abstract void overrideDeviceOptions(ITestDevice device)

إلغاء خيارات جهاز

default void postFlashOperations(ITestDevice device, IDeviceBuildInfo deviceBuild)

جميع عمليات التنظيف والفحوصات التي يجب أن تحدث بعد قسم الفلاش الفعلي

default void preFlashOperations(ITestDevice device, IDeviceBuildInfo deviceBuild)

جميع عمليات الإعداد والتحقّق التي يجب إجراؤها قبل قسم الفلاش المعنيّ

abstract void setDataWipeSkipList( dataWipeSkipList)

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

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

abstract void setFlashingResourcesRetriever(IFlashingResourcesRetriever retriever)

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

abstract void setForceSystemFlash(boolean forceSystemFlash)

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

default void setRamdiskPartition(String ramdiskPartition)

ضبط قسم ذاكرة الوصول العشوائي

default void setShouldFlashRamdisk(boolean shouldFlashRamdisk)

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

abstract void setUserDataFlashOption(IDeviceFlasher.UserDataFlashOption flashOption)

يتيح هذا الخيار تفعيل أو إيقاف إعادة تحميل صورة بيانات المستخدم أو محوها أو الاحتفاظ بها.

abstract void setWipeTimeout(long timeout)

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

default boolean shouldFlashRamdisk()

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

default boolean supportsFlashingInFastbootD()

ما إذا كان يمكن فلاش الجهاز الذي ينفِّذ أداة الفلاش في وضع fastbootd

default void tearDownFlasher()

الفرصة الأخيرة لتنفيذ أداة الفلاش لتنظيف نفسها

الطرق العامة

فلاش

public abstract void flash (ITestDevice device, 
                IDeviceBuildInfo deviceBuild)

يتم إنشاء الفلاشات على الجهاز.

يعود إلى الظهور فور اكتمال عملية الفلاش. على المتصلين الانتظار إلى أن يصبح الجهاز متصلاً بالإنترنت ومتاحًا قبل مواصلة الاختبار.

المعلمات
device ITestDevice: ITestDevice للوميض

deviceBuild IDeviceBuildInfo: IDeviceBuildInfo للوميض

عمليات الرمي
TargetSetupError في حال تعذّر فلاش الإصدار
DeviceNotAvailableException إذا توقّف الجهاز عن الاستجابة

getAdditionalFileFilters

public  getAdditionalFileFilters ()

الحصول على فلاتر لعناصر البناء الإضافية

تحتاج بعض أدوات الفلاش إلى عناصر إنشاء معيّنة ليست من بين العناصر التلقائية المستخدَمة. يجب أن تلغي هذه الأدوات هذه الطريقة، حتى لا يحتاج كل مستخدم لأدوات التفليش إلى معرفة هذه الملفات وتوفير خيارات سطر الأوامر.

يُرجى العِلم أنّه يتمّ استدعاء هذه الطريقة على مثيل مؤقت من IDeviceFlasher، لذا يجب عدم الاعتماد على أي حالة تتجاوز تلك المقدَّمة في المنشئ التلقائي.

يتم تفسير السلاسل في المجموعة على أنّها أنماط ملفات، وسيتم استرجاع جميع الملفات التي تتطابق مع النمط.

تُرجع هذه الطريقة مجموعة فارغة تلقائيًا.

المرتجعات

getSystemFlashingStatus

public abstract CommandStatus getSystemFlashingStatus ()

استرداد حالة تنفيذ الأمر لفلاش أقسام النظام الأساسية

يُرجى العلم أنّه في حال عدم إعادة تحميل أقسام النظام (إذا كان النظام يتضمّن الإصدار المطلوب إعادة تحميله) ، قد تكون حالة الأمر null.

المرتجعات
CommandStatus

getUserDataFlashOption

public abstract IDeviceFlasher.UserDataFlashOption getUserDataFlashOption ()

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

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

overrideDeviceOptions

public abstract void overrideDeviceOptions (ITestDevice device)

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

postFlashOperations

public void postFlashOperations (ITestDevice device, 
                IDeviceBuildInfo deviceBuild)

جميع عمليات التنظيف والفحوصات التي يجب أن تحدث بعد قسم الفلاش المعنيّ ولن يتم تضمين أيٍّ من هذه العمليات في القسم الحرج الذي يتم التحكّم فيه بالالتزام المتزامن.

المعلمات
device ITestDevice: ITestDevice للوميض

deviceBuild IDeviceBuildInfo: IDeviceBuildInfo للوميض

عمليات الرمي
TargetSetupError في حال تعذُّر إكمال أي عملية إعداد
DeviceNotAvailableException إذا توقّف الجهاز عن الاستجابة

preFlashOperations

public void preFlashOperations (ITestDevice device, 
                IDeviceBuildInfo deviceBuild)

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

المعلمات
device ITestDevice: ITestDevice للوميض

deviceBuild IDeviceBuildInfo: IDeviceBuildInfo للوميض

عمليات الرمي
TargetSetupError في حال تعذُّر إكمال أي عملية إعداد
DeviceNotAvailableException إذا توقّف الجهاز عن الاستجابة

setDataWipeSkipList

public abstract void setDataWipeSkipList ( dataWipeSkipList)

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

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

المعلمات
dataWipeSkipList

setFlashingResourcesRetriever

public abstract void setFlashingResourcesRetriever (IFlashingResourcesRetriever retriever)

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

المعلمات
retriever IFlashingResourcesRetriever: IFlashingResourcesRetriever المطلوب استخدامه

setForceSystemFlash

public abstract void setForceSystemFlash (boolean forceSystemFlash)

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

setRamdiskPartition

public void setRamdiskPartition (String ramdiskPartition)

ضبط قسم ذاكرة الوصول العشوائي

setShouldFlashRamdisk

public void setShouldFlashRamdisk (boolean shouldFlashRamdisk)

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

setUserDataFlashOption

public abstract void setUserDataFlashOption (IDeviceFlasher.UserDataFlashOption flashOption)

يتيح هذا الخيار تفعيل أو إيقاف إعادة تحميل صورة بيانات المستخدم أو محوها أو الاحتفاظ بها.

setWipeTimeout

public abstract void setWipeTimeout (long timeout)

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

المعلمات
timeout long

shouldFlashRamdisk

public boolean shouldFlashRamdisk ()

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

المرتجعات
boolean

supportsFlashingInFastbootD

public boolean supportsFlashingInFastbootD ()

ما إذا كان يمكن فلاش الجهاز الذي ينفِّذ أداة الفلاش في وضع fastbootd

المرتجعات
boolean

tearDownFlasher

public void tearDownFlasher ()

الفرصة الأخيرة لتنفيذ أداة الفلاش لتنظيف نفسها