اعتبارًا من عام 2026، ولضمان توافقنا مع نموذج التطوير الثابت الرئيسي وضمان استقرار المنصة في المنظومة المتكاملة، سننشر الرمز المصدري في "مشروع Android مفتوح المصدر" (AOSP) في الربع الثاني والربع الرابع. لإنشاء AOSP والمساهمة فيه، ننصحك باستخدام android-latest-release بدلاً من aosp-main. سيشير فرع البيان android-latest-release دائمًا إلى أحدث إصدار تم إرساله إلى AOSP. لمزيد من المعلومات، يُرجى الاطّلاع على التغييرات في مشروع Android المفتوح المصدر (AOSP).

DeviceFlashPreparer

public abstract class DeviceFlashPreparer
extends BaseTargetPreparer implements IConfigurationReceiver, ITestLoggerReceiver

java.lang.Object
↳	com.android.tradefed.targetprep.BaseTargetPreparer
	↳	com.android.tradefed.targetprep.DeviceFlashPreparer

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

FastbootUpdateBootstrapPreparer

FastbootUpdateBootstrapPreparer ITargetPreparer التي تنقل الملفات المحدّدة (برنامج الإقلاع والراديو وملف ZIP لصورة الجهاز) إلى IDeviceBuildInfo لتثبيت FastbootDeviceFlasher على الأجهزة، ثم تُدرج سمات الجهاز بعد الإقلاع في معلومات الإصدار لأغراض إعداد التقارير عن النتائج.

ITargetPreparer تعرض صورة على أجهزة Android.

ملخّص

الإنشاءات العامة
`DeviceFlashPreparer()`

الطُرق العامة
`void`	`addAllowedBranchForTransitionInIncremental(String branch)`
`void`	`addBranchTransitionInIncremental(String origin, String destination)`
`void`	`addFlasherExtraMetadata( metadata)`
`IBuildInfo`	`getBuild(TestInformation testInfo)` تضمين getBuildInfo حتى نتمكّن من إلغاء الإعداد التلقائي في سيناريوهات معيّنة
`ITestLogger`	`getTestLogger()`
`boolean`	`isIncrementalFlashingEnabled()`
`boolean`	`isIncrementalFlashingForceDisabled()`
`void`	`setAllowCrossReleaseFlashing(boolean allowCrossReleaseFlashing)`
`void`	`setAllowUnzipBaseline(boolean allowUnzipBaseline)`
`void`	`setApplySnapshot(boolean applySnapshot)`
`void`	`setConfiguration(IConfiguration configuration)` يُدرِج `IConfiguration` المستخدَم.
`void`	`setIgnoreHostOptions(boolean ignoreHostOptions)`
`void`	`setTestLogger(ITestLogger testLogger)` إدخال مثيل `ITestLogger`
`void`	`setUp(TestInformation testInfo)`
`void`	`setUpdateBootloaderFromUserspace(boolean updateBootloaderFromUserspace)`
`void`	`setUseIncrementalNewFlow(boolean useIncrementalNewFlow)`
`void`	`setUserDataFlashOption(IDeviceFlasher.UserDataFlashOption flashOption)` ضبط الخيار userdata-flash
`void`	`setWipeAfterApplySnapshot(boolean wipeAfterApplySnapshot)`
`void`	`tearDown(TestInformation testInfo, Throwable e)`
`void`	`useMerkleTreeComparison(boolean enableMerkleTreeComparison)`

الطُرق المحمية
`boolean`	`checkAntiRollback(IDeviceFlasher flasher, ITestDevice device, IDeviceBuildInfo deviceBuild)`
`void`	`checkDeviceProductType(ITestDevice device, IDeviceBuildInfo deviceBuild)` يمكن إجراء فحص قبل التثبيت للتأكّد من أنّ الجهاز مطابق للمعلومات الواردة في الإصدار.
`abstract IDeviceFlasher`	`createFlasher(ITestDevice device)` انقر على "إنشاء" `IDeviceFlasher` لاستخدامها.
`long`	`getDeviceBootWaitTime()` تعرض هذه السمة وقت الانتظار قبل إقلاع الجهاز
`IHostOptions`	`getHostOptions()` يحصل على مثيل `IHostOptions` المطلوب استخدامه.
`void`	`reportFlashMetrics(String branch, String buildFlavor, String buildId, String serial, long queueTime, long flashingTime, CommandStatus flashingStatus)` إرسال بيانات توقيت وميض الجهاز إلى الخلفية الخاصة بالمقاييس
`void`	`setSkipPostFlashBuildIdCheck(boolean skipPostFlashBuildIdCheck)`
`void`	`setUseIncrementalFlashing(boolean incrementalFlashing)`

الإنشاءات العامة

DeviceFlashPreparer

public DeviceFlashPreparer ()

الطُرق العامة

addAllowedBranchForTransitionInIncremental

public void addAllowedBranchForTransitionInIncremental (String branch)

المعلمات
`branch`	`String`

addBranchTransitionInIncremental

public void addBranchTransitionInIncremental (String origin, 
                String destination)

المعلمات
`origin`	`String`
`destination`	`String`

addFlasherExtraMetadata

public void addFlasherExtraMetadata ( metadata)

المعلمات
`metadata`

getBuild

public IBuildInfo getBuild (TestInformation testInfo)

تضمين getBuildInfo حتى نتمكّن من إلغاء الإعداد التلقائي في سيناريوهات معيّنة

المعلمات
`testInfo`	`TestInformation`

المرتجعات
`IBuildInfo`

getTestLogger

public ITestLogger getTestLogger ()

المرتجعات
`ITestLogger`

isIncrementalFlashingEnabled

public boolean isIncrementalFlashingEnabled ()

المرتجعات
`boolean`

isIncrementalFlashingForceDisabled

public boolean isIncrementalFlashingForceDisabled ()

المرتجعات
`boolean`

setAllowCrossReleaseFlashing

public void setAllowCrossReleaseFlashing (boolean allowCrossReleaseFlashing)

المعلمات
`allowCrossReleaseFlashing`	`boolean`

setAllowUnzipBaseline

public void setAllowUnzipBaseline (boolean allowUnzipBaseline)

المعلمات
`allowUnzipBaseline`	`boolean`

setApplySnapshot

public void setApplySnapshot (boolean applySnapshot)

المعلمات
`applySnapshot`	`boolean`

setConfiguration

public void setConfiguration (IConfiguration configuration)

يُدرِج IConfiguration المستخدَم.

المعلمات
`configuration`	`IConfiguration`

setIgnoreHostOptions

public void setIgnoreHostOptions (boolean ignoreHostOptions)

المعلمات
`ignoreHostOptions`	`boolean`

setTestLogger

public void setTestLogger (ITestLogger testLogger)

إدخال مثيل ITestLogger

المعلمات
`testLogger`	`ITestLogger`

setUp

public void setUp (TestInformation testInfo)

المعلمات
`testInfo`	`TestInformation`

الرميات
`BuildError`
`DeviceNotAvailableException`
`TargetSetupError`

setUpdateBootloaderFromUserspace

public void setUpdateBootloaderFromUserspace (boolean updateBootloaderFromUserspace)

المعلمات
`updateBootloaderFromUserspace`	`boolean`

setUseIncrementalNewFlow

public void setUseIncrementalNewFlow (boolean useIncrementalNewFlow)

المعلمات
`useIncrementalNewFlow`	`boolean`

setUserDataFlashOption

public void setUserDataFlashOption (IDeviceFlasher.UserDataFlashOption flashOption)

ضبط الخيار userdata-flash

setWipeAfterApplySnapshot

public void setWipeAfterApplySnapshot (boolean wipeAfterApplySnapshot)

المعلمات
`wipeAfterApplySnapshot`	`boolean`

tearDown

public void tearDown (TestInformation testInfo, 
                Throwable e)

المعلمات
`testInfo`	`TestInformation`
`e`	`Throwable`

الرميات
`DeviceNotAvailableException`

useMerkleTreeComparison

public void useMerkleTreeComparison (boolean enableMerkleTreeComparison)

المعلمات
`enableMerkleTreeComparison`	`boolean`

الطُرق المحمية

checkAntiRollback

protected boolean checkAntiRollback (IDeviceFlasher flasher, 
                ITestDevice device, 
                IDeviceBuildInfo deviceBuild)

المعلمات
`flasher`	`IDeviceFlasher`
`device`	`ITestDevice`
`deviceBuild`	`IDeviceBuildInfo`

المرتجعات
`boolean`

الرميات
`DeviceNotAvailableException`

checkDeviceProductType

protected void checkDeviceProductType (ITestDevice device, 
                IDeviceBuildInfo deviceBuild)

يمكن إجراء فحص قبل التثبيت للتأكّد من أنّ الجهاز مطابق للمعلومات الواردة في الإصدار.

المعلمات
`device`	`ITestDevice`: `ITestDevice` المراد إظهارها بشكل متقطع
`deviceBuild`	`IDeviceBuildInfo`: `IDeviceBuildInfo` المستخدَم في الفلاش

الرميات
	com.android.tradefed.targetprep.BuildError
	com.android.tradefed.device.DeviceNotAvailableException
`BuildError`
`DeviceNotAvailableException`

createFlasher

protected abstract IDeviceFlasher createFlasher (ITestDevice device)

انقر على "إنشاء" IDeviceFlasher لاستخدامها. يمكن للفئات الفرعية تجاهل

المعلمات
`device`	`ITestDevice`

المرتجعات
`IDeviceFlasher`

الرميات
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

getDeviceBootWaitTime

protected long getDeviceBootWaitTime ()

تعرض هذه السمة وقت الانتظار قبل إقلاع الجهاز

المرتجعات
`long`

getHostOptions

protected IHostOptions getHostOptions ()

يحصل على مثيل IHostOptions المطلوب استخدامه.

معروضة لاختبار الوحدات

المرتجعات
`IHostOptions`

reportFlashMetrics

protected void reportFlashMetrics (String branch, 
                String buildFlavor, 
                String buildId, 
                String serial, 
                long queueTime, 
                long flashingTime, 
                CommandStatus flashingStatus)

إرسال بيانات توقيت وميض الجهاز إلى الخلفية الخاصة بالمقاييس

المعلمات
`branch`	‫`String`: الفرع الذي تم إنشاء إصدار الجهاز منه
`buildFlavor`	‫`String`: صيغة إصدار الجهاز
`buildId`	`String`: رقم إصدار الجهاز
`serial`	‫`String`: الرقم التسلسلي للجهاز
`queueTime`	‫`long`: الوقت المستغرَق في انتظار توفّر حدّ أقصى للوميض
`flashingTime`	‫`long`: الوقت المستغرَق في تثبيت ملف zip لصورة الجهاز
`flashingStatus`	استبدِل `CommandStatus` بحالة تنفيذ أمر التحديث.

setSkipPostFlashBuildIdCheck

protected void setSkipPostFlashBuildIdCheck (boolean skipPostFlashBuildIdCheck)

المعلمات
`skipPostFlashBuildIdCheck`	`boolean`

setUseIncrementalFlashing

protected void setUseIncrementalFlashing (boolean incrementalFlashing)

المعلمات
`incrementalFlashing`	`boolean`