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

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

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)`
`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)`

الطرق المحمية
`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`

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`

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

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`: الوقت المستغرَق في فلاش صورة الجهاز المضغوطة
`flashingStatus`	`CommandStatus`: حالة تنفيذ أمر الفلاش

setSkipPostFlashBuildIdCheck

protected void setSkipPostFlashBuildIdCheck (boolean skipPostFlashBuildIdCheck)

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

setUseIncrementalFlashing

protected void setUseIncrementalFlashing (boolean incrementalFlashing)

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