اعتبارًا من 27 آذار (مارس) 2025، ننصحك باستخدام android-latest-release بدلاً من aosp-main لإنشاء AOSP والمساهمة فيه. لمزيد من المعلومات، يُرجى الاطّلاع على التغييرات في AOSP.

تمت ترجمة هذه الصفحة بواسطة Cloud Translation API‏.

IDeviceFlasher

public interface IDeviceFlasher

com.android.tradefed.targetprep.IDeviceFlasher

الفئات الفرعية غير المباشرة المعروفة

CdmaDeviceFlasher وFastbootDeviceFlasher وOtaUpdateDeviceFlasher وSystemUpdaterDeviceFlasher

CdmaDeviceFlasher	فئة تعرض صورة على جهاز Android أصلي مزوّد بجهاز إرسال لاسلكي CDMA
FastbootDeviceFlasher	فئة تعتمد على Fastboot لفلاش صورة على أجهزة Android المادية
OtaUpdateDeviceFlasher	أداة لفلاش الأجهزة تعمل على تشغيل النص البرمجي system/update_engine/scripts/update_device.py باستخدام حزمة كاملة أو متزايدة من خلال بروتوكول OTA لتعديل صورة الجهاز
SystemUpdaterDeviceFlasher	`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 ()

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