از 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 که فایل‌های مشخص شده (بوت‌لودر، رادیو، زیپ تصویر دستگاه) را در IDeviceBuildInfo قرار می‌دهد تا دستگاه‌ها را با FastbootDeviceFlasher فلش کند، سپس ویژگی‌های دستگاه پس از راه‌اندازی را برای اهداف گزارش نتیجه به اطلاعات ساخت تزریق می‌کند.

یک ITargetPreparer که یک تصویر را روی سخت افزار فیزیکی اندروید فلش می کند.

خلاصه

سازندگان عمومی
`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 ()

روش های عمومی

addAllowedBranchForTransitionIncremental

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`

isIncrementalFlashing Enabled است

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`

پیکربندی set

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`

راه اندازی

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`

پاره کردن

public void tearDown (TestInformation testInfo, 
                Throwable e)

پارامترها
`testInfo`	`TestInformation`
`e`	`Throwable`

پرتاب می کند
`DeviceNotAvailableException`

استفاده ازMerkleTreeComparison

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`

ایجاد فلاشر

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`

گزارش فلش متریک

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`