IDeviceFlasher

public interface IDeviceFlasher

com.android.tradefed.targetprep.IDeviceFlasher

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

ملخّص

الإجراءات العامة

default boolean checkAntiRollback(ITestDevice device, IDeviceBuildInfo deviceBuild)

تحقَّق مما إذا تم تفعيل ميزة "الحماية من الرجوع إلى إصدار أقدم".

abstract void flash(ITestDevice device, IDeviceBuildInfo deviceBuild)

يتم إنشاء حزم البرامج على الجهاز.

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

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

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

default void setExtraMetadata(Map<String, String> metadata)

يسمح للمشغّل بتلقّي خيارات بيانات وصفية إضافية.

abstract void setFlashingResourcesRetriever(IFlashingResourcesRetriever retriever)

تضبط هذه السمة الآلية التي يمكن من خلالها لبرنامج التحديث استرداد ملفات الموارد اللازمة لتحديث البرنامج.

abstract void setForceSystemFlash(boolean forceSystemFlash)

تحديد ما إذا كان يجب دائمًا إعادة تثبيت النظام حتى إذا كان الإصدار الحالي قيد التشغيل

default void setRamdiskPartition(String ramdiskPartition)

تضبط قسم ramdisk

default void setShouldFlashRamdisk(boolean shouldFlashRamdisk)

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

abstract void setUserDataFlashOption(IDeviceFlasher.UserDataFlashOption flashOption)

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

abstract void setWipeTimeout(long timeout)

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

default boolean shouldFlashRamdisk()

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

default boolean supportsFlashingInFastbootD()

تحديد ما إذا كان يمكن تنزيل البرامج على الجهاز الذي يستخدم أداة التنزيل في وضع fastbootd.

default void tearDownFlasher()

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

الإجراءات العامة

checkAntiRollback

public boolean checkAntiRollback (ITestDevice device, 
                IDeviceBuildInfo deviceBuild)

تحقَّق مما إذا تم تفعيل ميزة "الحماية من الرجوع إلى إصدار أقدم".

المعلَمات
device ITestDevice

deviceBuild IDeviceBuildInfo

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

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

الفلاش

public abstract void flash (ITestDevice device, 
                IDeviceBuildInfo deviceBuild)

يتم إنشاء حزم البرامج على الجهاز.

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

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

getAdditionalFileFilters

public Set<String> getAdditionalFileFilters ()

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

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

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

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

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

المرتجعات
Set<String>

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 المطلوب عرضه بشكل متقطع
عمليات الطرح
DeviceNotAvailableException في حال عدم استجابة الجهاز
TargetSetupError في حال تعذّر إكمال أي عملية إعداد

preFlashOperations

public void preFlashOperations (ITestDevice device, 
                IDeviceBuildInfo deviceBuild)

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

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

setDataWipeSkipList

public abstract void setDataWipeSkipList (Collection<String> dataWipeSkipList)

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

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

المعلَمات
dataWipeSkipList Collection

setExtraMetadata

public void setExtraMetadata (Map<String, String> metadata)

يسمح للمشغّل بتلقّي خيارات بيانات وصفية إضافية.

المعلَمات
metadata Map

setFlashingResourcesRetriever

public abstract void setFlashingResourcesRetriever (IFlashingResourcesRetriever retriever)

تحدّد هذه السمة الآلية التي يمكن من خلالها لبرنامج التحديث استرداد ملفات الموارد اللازمة لتحديث البرنامج.

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

setForceSystemFlash

public abstract void setForceSystemFlash (boolean forceSystemFlash)

تحديد ما إذا كان يجب دائمًا إعادة تثبيت النظام حتى إذا كان الإصدار الحالي قيد التشغيل

setRamdiskPartition

public void setRamdiskPartition (String ramdiskPartition)

تضبط قسم ramdisk

setShouldFlashRamdisk

public void setShouldFlashRamdisk (boolean shouldFlashRamdisk)

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

setUserDataFlashOption

public abstract void setUserDataFlashOption (IDeviceFlasher.UserDataFlashOption flashOption)

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

setWipeTimeout

public abstract void setWipeTimeout (long timeout)

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

المعلَمات
timeout long

shouldFlashRamdisk

public boolean shouldFlashRamdisk ()

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

المرتجعات
boolean

supportsFlashingInFastbootD

public boolean supportsFlashingInFastbootD ()

تحديد ما إذا كان يمكن تنزيل البرامج على الجهاز الذي يستخدم أداة التنزيل في وضع fastbootd.

المرتجعات
boolean

tearDownFlasher

public void tearDownFlasher ()

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