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(
تحدِّد هذه السياسة قائمة المسارات ضمن
يُرجى العِلم أنّ مستوى تفصيل قائمة التخطّي هو العناصر الثانوية المباشرة للعلامة |
default
void
|
setExtraMetadata(
يسمح للمشغّل بتلقّي خيارات بيانات وصفية إضافية. |
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()
يتحقّق مما إذا كان برنامج التثبيت مضبوطًا على تثبيت 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 |
|
setExtraMetadata
public void setExtraMetadata (metadata)
يسمح للمشغّل بتلقّي خيارات بيانات وصفية إضافية.
| المعلمات | |
|---|---|
metadata |
|
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 ()
يتحقّق مما إذا كان برنامج التثبيت مضبوطًا على تثبيت ramdisk إضافي بعد تحديث الجهاز من خلال ملف مضغوط يحتوي على صورة
| المرتجعات | |
|---|---|
boolean |
|
supportsFlashingInFastbootD
public boolean supportsFlashingInFastbootD ()
تحديد ما إذا كان يمكن تحديث الجهاز الذي يستخدم أداة التحديث في وضع fastbootd.
| المرتجعات | |
|---|---|
boolean |
|
tearDownFlasher
public void tearDownFlasher ()
الفرصة الأخيرة لتنفيذ برنامج الفلاش لتنظيف نفسه