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(
ضبط قائمة المسارات ضمن
يُرجى العلم أنّ درجة دقة قائمة التخطّي هي العناصر الفرعية المباشرة للعنصر |
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
publicgetAdditionalFileFilters ()
الحصول على فلاتر لعناصر البناء الإضافية
تحتاج بعض أدوات الفلاش إلى عناصر إنشاء معيّنة ليست من بين العناصر التلقائية المستخدَمة. يجب أن تلغي هذه الأدوات هذه الطريقة، حتى لا يحتاج كل مستخدم لأدوات التفليش إلى معرفة هذه الملفات وتوفير خيارات سطر الأوامر.
يُرجى العِلم أنّه يتمّ استدعاء هذه الطريقة على مثيل مؤقت من 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 ()
الفرصة الأخيرة لتنفيذ أداة الفلاش لتنظيف نفسها