آماده‌ساز فلش دستگاه

public abstract class DeviceFlashPreparer
extends BaseTargetPreparer implements IConfigurationReceiver , ITestLoggerReceiver

شیء جاوا
↳ com.android.tradefed.targetprep.BaseTargetPreparer
↳ com.android.tradefed.targetprep.DeviceFlashPreparer

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

خلاصه

سازندگان عمومی

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)

قبل از فلش کردن، بررسی‌های لازم را انجام دهید تا مطمئن شوید دستگاه مطابق با اطلاعات ساخت (build information) است.

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)

سازندگان عمومی

آماده‌ساز فلش دستگاه 

public DeviceFlashPreparer ()

روش‌های عمومی

addAllowedBranchForTransitionInIncremental 

public void addAllowedBranchForTransitionInIncremental (String branch)

پارامترها
branch String

addBranchTransitionIncremental 

public void addBranchTransitionInIncremental (String origin, 
                String destination)

پارامترها
origin String

destination String

addFlasherExtraMetadata 

public void addFlasherExtraMetadata ( metadata)

پارامترها
metadata

دریافت کنید 

public IBuildInfo getBuild (TestInformation testInfo)

getBuildInfo را طوری پوشش می‌دهیم که بتوانیم برای سناریوهای خاص، آن را بازنویسی کنیم.

پارامترها
testInfo TestInformation

بازگشت‌ها
IBuildInfo

دریافت‌کننده‌ی تست‌لاگر 

public ITestLogger getTestLogger ()

بازگشت‌ها
ITestLogger

فعال‌سازی چشمک‌زن افزایشی 

public boolean isIncrementalFlashingEnabled ()

بازگشت‌ها
boolean

نیروی چشمک زن افزایشی غیرفعال شد 

public boolean isIncrementalFlashingForceDisabled ()

بازگشت‌ها
boolean

setAllowCrossReleaseFlashing 

public void setAllowCrossReleaseFlashing (boolean allowCrossReleaseFlashing)

پارامترها
allowCrossReleaseFlashing boolean

setAllowUnzipBaseline 

public void setAllowUnzipBaseline (boolean allowUnzipBaseline)

پارامترها
allowUnzipBaseline boolean

تنظیم اعمال اسنپ‌شات 

public void setApplySnapshot (boolean applySnapshot)

پارامترها
applySnapshot boolean

پیکربندی set 

public void setConfiguration (IConfiguration configuration)

IConfiguration مورد استفاده را تزریق می‌کند.

پارامترها
configuration IConfiguration

گزینه‌های میزبان را نادیده بگیرید 

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

تنظیم به‌روزرسانی بوت‌لودر از فضای کاربری 

public void setUpdateBootloaderFromUserspace (boolean updateBootloaderFromUserspace)

پارامترها
updateBootloaderFromUserspace boolean

setUseIncrementalNewFlow 

public void setUseIncrementalNewFlow (boolean useIncrementalNewFlow)

پارامترها
useIncrementalNewFlow boolean

تنظیم گزینه فلش داده‌های کاربر 

public void setUserDataFlashOption (IDeviceFlasher.UserDataFlashOption flashOption)

گزینه userdata-flash را تنظیم کنید

تنظیم پاک کردنبعد از اعمال عکس فوری 

public void setWipeAfterApplySnapshot (boolean wipeAfterApplySnapshot)

پارامترها
wipeAfterApplySnapshot boolean

اشک‌ریزان 

public void tearDown (TestInformation testInfo, 
                Throwable e)

پارامترها
testInfo TestInformation

e Throwable

پرتاب‌ها
DeviceNotAvailableException

useMerkleTreeComparison 

public void useMerkleTreeComparison (boolean enableMerkleTreeComparison)

پارامترها
enableMerkleTreeComparison boolean

روش‌های محافظت‌شده

چک آنتی رول بک 

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

پارامترها
flasher IDeviceFlasher

device ITestDevice

deviceBuild IDeviceBuildInfo

بازگشت‌ها
boolean

پرتاب‌ها
DeviceNotAvailableException

بررسی نوع محصول دستگاه 

protected void checkDeviceProductType (ITestDevice device, 
                IDeviceBuildInfo deviceBuild)

قبل از فلش کردن، بررسی‌های لازم را انجام دهید تا مطمئن شوید دستگاه مطابق با اطلاعات ساخت (build information) است.

پارامترها
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 ایجاد کنید. زیرکلاس‌ها می‌توانند override شوند.

پارامترها
device ITestDevice

بازگشت‌ها
IDeviceFlasher

پرتاب‌ها
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

دریافت دستگاهبوتزمان انتظار 

protected long getDeviceBootWaitTime ()

زمان انتظار بوت دستگاه را دریافت می‌کند

بازگشت‌ها
long

گزینه‌های میزبان 

protected IHostOptions getHostOptions ()

نمونه‌ی IHostOptions را برای استفاده دریافت می‌کند.

برای تست واحد در معرض نمایش قرار گرفت

بازگشت‌ها
IHostOptions

گزارشFlashMetrics 

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 : وضعیت اجرای فرمان چشمک‌زن

بررسی شناسه ساخت در setSkipPostFlash 

protected void setSkipPostFlashBuildIdCheck (boolean skipPostFlashBuildIdCheck)

پارامترها
skipPostFlashBuildIdCheck boolean

setUseIncrementalFlashing 

protected void setUseIncrementalFlashing (boolean incrementalFlashing)

پارامترها
incrementalFlashing boolean