فلشر دستگاه فست‌بوت

public class FastbootDeviceFlasher
extends Object implements IDeviceFlasher

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

کلاسی که برای فلش کردن یک ایمیج روی سخت‌افزار فیزیکی اندروید به فست‌بوت متکی است.

خلاصه

ثابت‌ها

String BASEBAND_IMAGE_NAME

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

FastbootDeviceFlasher ()

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

static String fetchImageVersion ( IRunUtil runUtil, ITestDevice device, String imageName)

متد کمکی برای دریافت نسخه فعلی تصویر روی دستگاه.

void flash ( ITestDevice device, IDeviceBuildInfo deviceBuild)

فلش‌ها روی دستگاه ساخته می‌شوند.

CommandStatus getSystemFlashingStatus ()

وضعیت اجرای دستور را برای فلش کردن پارتیشن‌های اصلی سیستم بازیابی کنید.

IDeviceFlasher.UserDataFlashOption getUserDataFlashOption ()

مشخص می‌کند که آیا تصویر داده کاربر باید فلش شود، پاک شود یا حفظ شود.

void overrideDeviceOptions ( ITestDevice device)

گزینه‌های مربوط به یک دستگاه را لغو کنید.

void preFlashOperations ( ITestDevice device, IDeviceBuildInfo deviceBuild)

تمام عملیات راه‌اندازی و بررسی‌هایی که باید قبل از فلش کردن بخش بحرانی انجام شوند.

void setDataWipeSkipList ( dataWipeSkipList)

لیست مسیرهای زیر /data را برای جلوگیری از پاک شدن هنگام استفاده از ITestsZipInstaller تنظیم می‌کند.

توجه داشته باشید که جزئیات لیست پرش، فرزندان مستقیم /data هستند.

void setFlashOptions ( flashOptions)

فهرستی از گزینه‌ها را برای ارسال با دستورات flash/update تنظیم می‌کند.

void setFlashingResourcesRetriever ( IFlashingResourcesRetriever retriever)

مکانیزمی را تنظیم می‌کند که توسط آن فلشر می‌تواند فایل‌های منبع را برای فلش کردن بازیابی کند.

void setForceSystemFlash (boolean forceSystemFlash)

تنظیم می‌کند که آیا سیستم حتی در صورت اجرای نسخه فعلی، همیشه باید فلش شود یا خیر

void setIncrementalFlashing ( IncrementalImageUtil incrementalUtil)
void setRamdiskPartition (String ramdiskPartition)

پارتیشن ramdisk را تنظیم می‌کند

void setShouldFlashRamdisk (boolean shouldFlashRamdisk)

تعیین می‌کند که آیا پس از به‌روزرسانی دستگاه از طریق فایل فشرده‌ی ایمیج، باید یک رم‌دیسک اضافی فلش شود یا خیر.

void setUserDataFlashOption ( IDeviceFlasher.UserDataFlashOption flashOption)

مشخص می‌کند که آیا تصویر داده‌های کاربر باید فلش شود، پاک شود یا حفظ شود.

void setWipeTimeout (long timeout)

زمان لازم برای پاک کردن داده‌ها را تنظیم کنید.

boolean shouldFlashRamdisk ()

بررسی می‌کند که آیا فلشر طوری تنظیم شده است که یک رم‌دیسک اضافی پس از به‌روزرسانی دستگاه از طریق فایل فشرده‌ی ایمیج، فلش شود یا خیر.

boolean shouldSkipBootloaderVersionCheck ()
static boolean stderrContainsFailed (String stderr, boolean skipBootloaderVersionCheck)
static boolean stderrContainsFailed (String stderr, boolean skipBootloaderVersionCheck, boolean skipFastbootFailedMessage)

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

void checkAndFlashBaseband ( ITestDevice device, IDeviceBuildInfo deviceBuild)

در صورت نیاز، فایل ایمیج بیس‌باند را روی دستگاه فلش کنید.

boolean checkAndFlashBootloader ( ITestDevice device, IDeviceBuildInfo deviceBuild)

در صورت نیاز، فایل ایمیج بوت لودر را روی دستگاه فلش کنید.

boolean checkAndFlashSystem ( ITestDevice device, String systemBuildId, String systemBuildFlavor, IDeviceBuildInfo deviceBuild)

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

boolean checkShouldFlashBaseband ( ITestDevice device, IDeviceBuildInfo deviceBuild)

بررسی کنید که آیا بیس‌باند دستگاه ارائه شده نیاز به فلش شدن دارد یا خیر.

IFlashingResourcesParser createFlashingResourcesParser ( IDeviceBuildInfo localBuild, DeviceDescriptor descriptor)

متد کارخانه‌ای برای ایجاد یک IFlashingResourcesParser .

void downloadExtraImageFiles ( IFlashingResourcesParser resourceParser, IFlashingResourcesRetriever retriever, IDeviceBuildInfo localBuild)

قلابی برای اجازه دادن به زیرکلاس‌ها تا در صورت نیاز، فایل‌های تصویری سفارشی اضافی را دانلود کنند.

void downloadFlashingResources ( ITestDevice device, IDeviceBuildInfo localBuild)

دانلود فایل‌های ایمیج چشمک‌زن اضافی مورد نیاز است

String executeFastbootCmd ( ITestDevice device, String... cmdArgs)

روش کمکی برای اجرای دستور fastboot.

String executeLongFastbootCmd ( ITestDevice device, String... cmdArgs)

متد کمکی برای اجرای یک دستور fastboot طولانی مدت.

String executeLongFastbootCmd ( ITestDevice device, envVarMap, String... cmdArgs)

متد کمکی برای اجرای یک دستور fastboot طولانی مدت با متغیرهای محیطی.

void flashBaseband ( ITestDevice device, File basebandImageFile)

تصویر باند پایه داده شده را فلش می‌کند و دوباره به بوت لودر راه اندازی مجدد می‌کند

void flashBootloader ( ITestDevice device, File bootloaderImageFile)

ایمیج بوت‌لودر داده شده را فلش می‌کند و دوباره به بوت‌لودر ریبوت می‌کند

void flashExtraImages ( ITestDevice device, IDeviceBuildInfo deviceBuild)

قبل از فلش کردن سیستم و ریبوت کردن، پارتیشن‌های مربوط به هر دستگاه را فلش کنید.

void flashPartition ( ITestDevice device, File imgFile, String partition)

فلش کردن یک پارتیشن جداگانه از یک دستگاه

void flashRamdiskIfNeeded ( ITestDevice device, IDeviceBuildInfo deviceBuild)
void flashSystem ( ITestDevice device, IDeviceBuildInfo deviceBuild)

فایل ایمیج سیستم را روی دستگاه فلش کنید.

void flashUserData ( ITestDevice device, IDeviceBuildInfo deviceBuild)

پارتیشن userdata را روی دستگاه فلش کنید.

void flashUserDataFromDeviceImageFile ( ITestDevice device, IDeviceBuildInfo deviceBuild)

فایل userdata.img را از فایل ایمیج دستگاه استخراج کرده و آن را روی دستگاه فلش می‌کند.

String getBootPartitionName ()

نام پارتیشن بوت را برای این فلشر دستگاه دریافت کنید.

String getBootloaderFilePrefix ( ITestDevice device)

پیشوند فایل بوت لودر را دریافت کنید.

String getCurrentSlot ( ITestDevice device)

متد کمکی برای بازیابی اسلات فعلی (برای دستگاه‌های دارای قابلیت A/B).

IFlashingResourcesRetriever getFlashingResourcesRetriever ()
FuseUtil getFuseUtil ()
String getImageVersion ( ITestDevice device, String imageName)
IRunUtil getRunUtil ()

برای آزمایش در معرض دید قرار گرفت.

void handleUserDataFlashing ( ITestDevice device, IDeviceBuildInfo deviceBuild)

مدیریت فلش کردن پارتیشن userdata/cache

boolean hasPartition ( ITestDevice device, String partition)

با بوت لودر بررسی می‌کند که آیا پارتیشن مشخص شده وجود دارد یا خیر

void preFlashSetup ( ITestDevice device, IDeviceBuildInfo deviceBuild)

هرگونه تنظیمات پیش از فلش اضافی مورد نیاز را انجام دهید.

void setSkipBootloaderVersionCheck (boolean skipBootloaderVersionCheck)
void setSkipFastbootFailedMessage (boolean skipFastbootFailedMessage)
void setSystemBuildInfo (String systemBuildId, String systemBuildFlavor)
void verifyRequiredBoards ( ITestDevice device, IFlashingResourcesParser resourceParser, String deviceProductType)

تأیید کنید که نوع محصول دستگاه از قابلیت فلش شدنِ ساخته‌شده پشتیبانی می‌کند.

void wipeCache ( ITestDevice device)

پارتیشن کش (cache) دستگاه را پاک کنید.

void wipePartition ( ITestDevice device, String partition)

پارتیشن مشخص شده را با دستور `fastboot erase <name>` پاک کنید.

ثابت‌ها

نام تصویر پایه 

public static final String BASEBAND_IMAGE_NAME

مقدار ثابت: "رادیو"

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

فلشر دستگاه فست‌بوت 

public FastbootDeviceFlasher ()

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

واکشی نسخه تصویر 

public static String fetchImageVersion (IRunUtil runUtil, 
                ITestDevice device, 
                String imageName)

متد کمکی برای دریافت نسخه فعلی تصویر روی دستگاه.

پارامترها
runUtil IRunUtil

device ITestDevice : ITestDevice قرار است دستور روی آن اجرا شود

imageName String : نام تصویری که قرار است دریافت شود.

بازگشت‌ها
String خروجی stdout از دستور را رشته‌ای می‌کند

پرتاب‌ها
DeviceNotAvailableException اگر دستگاه در دسترس نباشد
TargetSetupError اگر دستور fastboot با شکست مواجه شد یا نسخه قابل تعیین نبود

فلش 

public void flash (ITestDevice device, 
                IDeviceBuildInfo deviceBuild)

فلش‌ها روی دستگاه ساخته می‌شوند.

بلافاصله پس از اتمام فلش، برمی‌گردد. تماس‌گیرندگان باید قبل از ادامه آزمایش، منتظر آنلاین و در دسترس بودن دستگاه باشند.

پارامترها
device ITestDevice : ITestDevice قرار است فلش شود

deviceBuild IDeviceBuildInfo : فایل IDeviceBuildInfo که قرار است فلش شود

پرتاب‌ها
DeviceNotAvailableException
TargetSetupError

دریافت وضعیت چشمک زن سیستم 

public CommandStatus getSystemFlashingStatus ()

وضعیت اجرای دستور را برای فلش کردن پارتیشن‌های اصلی سیستم بازیابی کنید.

توجه داشته باشید که اگر پارتیشن‌های سیستم فلش نشده باشند (سیستم از قبل ساختار لازم برای فلش شدن را دارد)، وضعیت دستور ممکن است null باشد.

بازگشت‌ها
CommandStatus

گزینه getUserDataFlash 

public IDeviceFlasher.UserDataFlashOption getUserDataFlashOption ()

مشخص می‌کند که آیا تصویر داده کاربر باید فلش شود، پاک شود یا حفظ شود.

بازگشت‌ها
IDeviceFlasher.UserDataFlashOption اینکه آیا تصویر داده کاربر باید فلش شود، پاک شود یا حفظ شود

گزینه‌های دستگاه را نادیده بگیرید 

public void overrideDeviceOptions (ITestDevice device)

لغو گزینه‌های یک دستگاه. برای لغو مقادیر پیش‌فرض گزینه‌ها در صورتی که پیش‌فرض‌ها توسط یک دستگاه خاص پشتیبانی نشوند، استفاده می‌شود.

عملیات پیش از فلش 

public void preFlashOperations (ITestDevice device, 
                IDeviceBuildInfo deviceBuild)

تمام عملیات راه‌اندازی و بررسی‌هایی که باید قبل از راه‌اندازی واقعی بخش بحرانی انجام شوند. هیچ یک از این عملیات‌ها در بخش بحرانی کنترل‌شده همزمانی گنجانده نخواهند شد.

پارامترها
device ITestDevice : ITestDevice قرار است فلش شود

deviceBuild IDeviceBuildInfo : فایل IDeviceBuildInfo که قرار است فلش شود

پرتاب‌ها
DeviceNotAvailableException
TargetSetupError

setDataWipeSkipList 

public void setDataWipeSkipList ( dataWipeSkipList)

لیست مسیرهای زیر /data را برای جلوگیری از پاک شدن هنگام استفاده از ITestsZipInstaller تنظیم می‌کند.

توجه داشته باشید که جزئیات لیست پرش، فرزندان مستقیم /data هستند.

پارامترها
dataWipeSkipList

تنظیمات فلش 

public void setFlashOptions ( flashOptions)

فهرستی از گزینه‌ها را برای ارسال با دستورات flash/update تنظیم می‌کند.

setFlashingResourcesبازیاب 

public void setFlashingResourcesRetriever (IFlashingResourcesRetriever retriever)

مکانیزمی را تنظیم می‌کند که توسط آن فلشر می‌تواند فایل‌های منبع را برای فلش کردن بازیابی کند.

پارامترها
retriever IFlashingResourcesRetriever : IFlashingResourcesRetriever مورد استفاده

setForceSystemFlash 

public void setForceSystemFlash (boolean forceSystemFlash)

تنظیم می‌کند که آیا سیستم حتی در صورت اجرای نسخه فعلی، همیشه باید فلش شود یا خیر

تنظیم چشمک زن افزایشی 

public void setIncrementalFlashing (IncrementalImageUtil incrementalUtil)

پارامترها
incrementalUtil IncrementalImageUtil

تنظیم پارتیشن رم دیسک 

public void setRamdiskPartition (String ramdiskPartition)

پارتیشن ramdisk را تنظیم می‌کند

setShouldFlashRamdisk 

public void setShouldFlashRamdisk (boolean shouldFlashRamdisk)

تعیین می‌کند که آیا پس از به‌روزرسانی دستگاه از طریق فایل فشرده‌ی ایمیج، باید یک رم‌دیسک اضافی فلش شود یا خیر.

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

public void setUserDataFlashOption (IDeviceFlasher.UserDataFlashOption flashOption)

مشخص می‌کند که آیا تصویر داده‌های کاربر باید فلش شود، پاک شود یا حفظ شود.

تنظیم زمان پاک شدن 

public void setWipeTimeout (long timeout)

زمان لازم برای پاک کردن داده‌ها را تنظیم کنید.

پارامترها
timeout long

shouldFlashRamdisk 

public boolean shouldFlashRamdisk ()

بررسی می‌کند که آیا فلشر طوری تنظیم شده است که یک رم‌دیسک اضافی پس از به‌روزرسانی دستگاه از طریق فایل فشرده‌ی ایمیج، فلش شود یا خیر.

بازگشت‌ها
boolean

shouldSkipBootloaderVersionCheck 

public boolean shouldSkipBootloaderVersionCheck ()

بازگشت‌ها
boolean

stderrContainsFailed 

public static boolean stderrContainsFailed (String stderr, 
                boolean skipBootloaderVersionCheck)

پارامترها
stderr String

skipBootloaderVersionCheck boolean

بازگشت‌ها
boolean

stderrContainsFailed 

public static boolean stderrContainsFailed (String stderr, 
                boolean skipBootloaderVersionCheck, 
                boolean skipFastbootFailedMessage)

پارامترها
stderr String

skipBootloaderVersionCheck boolean

skipFastbootFailedMessage boolean

بازگشت‌ها
boolean

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

checkAndFlashBaseband 

protected void checkAndFlashBaseband (ITestDevice device, 
                IDeviceBuildInfo deviceBuild)

در صورت نیاز، فایل ایمیج بیس‌باند را روی دستگاه فلش کنید. فقط در صورتی بیس‌باند فلش می‌شود که نسخه فعلی دستگاه! = نسخه مورد نیاز باشد.

پارامترها
device ITestDevice : ITestDevice قرار است فلش شود

deviceBuild IDeviceBuildInfo : شناسه‌ی IDeviceBuildInfo که شامل ایمیج بیس‌باند برای فلش کردن است.

پرتاب‌ها
DeviceNotAvailableException اگر دستگاه در دسترس نباشد
TargetSetupError اگر فلش کردن بیس باند ناموفق بود

چک اند فلش بوت لودر 

protected boolean checkAndFlashBootloader (ITestDevice device, 
                IDeviceBuildInfo deviceBuild)

در صورت نیاز، فایل ایمیج بوت لودر را روی دستگاه فلش کنید.

فقط در صورتی بوت لودر فلش می‌شود که نسخه فعلی دستگاه! = نسخه مورد نیاز.

پارامترها
device ITestDevice : ITestDevice قرار است فلش شود

deviceBuild IDeviceBuildInfo : IDeviceBuildInfo که شامل ایمیج بوت‌لودر برای فلش کردن است.

بازگشت‌ها
boolean اگر بوت لودر فلش شده باشد، true اگر از آن صرف نظر شده باشد، false

پرتاب‌ها
DeviceNotAvailableException اگر دستگاه در دسترس نباشد
TargetSetupError اگر فلش کردن بوت لودر ناموفق بود

چک اند فلش سیستم 

protected boolean checkAndFlashSystem (ITestDevice device, 
                String systemBuildId, 
                String systemBuildFlavor, 
                IDeviceBuildInfo deviceBuild)

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

لطفا به ERROR(/#shouldFlashSystem(String,String,com.android.tradefed.build.IDeviceBuildInfo)) نگاه کنید.

صرف نظر از مسیر انتخاب شده، پس از اجرای متد، دستگاه باید در فضای کاربری بوت شود.

پارامترها
device ITestDevice : ITestDevice قرار است فلش شود

systemBuildId String : شناسه ساخت فعلی که روی دستگاه اجرا می‌شود

systemBuildFlavor String : نسخه فعلی که روی دستگاه اجرا می‌شود

deviceBuild IDeviceBuildInfo : اطلاعات IDeviceBuildInfo که شامل ایمیج سیستم برای فلش کردن است.

بازگشت‌ها
boolean اگر سیستم فلش شده باشد، true اگر از آن صرف نظر شده باشد false

پرتاب‌ها
DeviceNotAvailableException اگر دستگاه در دسترس نباشد
TargetSetupError اگر فلش کردن بوت لودر ناموفق بود

checkShouldFlashBaseband 

protected boolean checkShouldFlashBaseband (ITestDevice device, 
                IDeviceBuildInfo deviceBuild)

بررسی کنید که آیا بیس‌باند دستگاه ارائه شده نیاز به فلش شدن دارد یا خیر.

پارامترها
device ITestDevice : ITestDevice که باید بررسی شود

deviceBuild IDeviceBuildInfo : شناسه‌ی IDeviceBuildInfo که شامل تصویر باند پایه برای بررسی است

بازگشت‌ها
boolean

پرتاب‌ها
DeviceNotAvailableException اگر دستگاه در دسترس نباشد
TargetSetupError اگر فلش کردن بیس باند ناموفق بود

تجزیه‌کننده‌ی منابع فلش‌ساز 

protected IFlashingResourcesParser createFlashingResourcesParser (IDeviceBuildInfo localBuild, 
                DeviceDescriptor descriptor)

متد کارخانه‌ای برای ایجاد یک IFlashingResourcesParser .

برای تست واحد در معرض نمایش قرار داده شده است.

پارامترها
localBuild IDeviceBuildInfo : اطلاعات IDeviceBuildInfo که باید تجزیه و تحلیل شود

descriptor DeviceDescriptor : توصیفگر دستگاهی که قرار است فلش شود.

بازگشت‌ها
IFlashingResourcesParser یک IFlashingResourcesParser که توسط متد factory ایجاد شده است.

پرتاب‌ها
خطای com.android.tradefed.targetprep.TargetSetupError
TargetSetupError

دانلود فایل‌های تصویر اضافی 

protected void downloadExtraImageFiles (IFlashingResourcesParser resourceParser, 
                IFlashingResourcesRetriever retriever, 
                IDeviceBuildInfo localBuild)

قلابی برای اجازه دادن به زیرکلاس‌ها تا در صورت نیاز، فایل‌های تصویری سفارشی اضافی را دانلود کنند.

پارامترها
resourceParser IFlashingResourcesParser : IFlashingResourcesParser

retriever IFlashingResourcesRetriever : IFlashingResourcesRetriever

localBuild IDeviceBuildInfo : IDeviceBuildInfo

پرتاب‌ها
خطای com.android.tradefed.targetprep.TargetSetupError
TargetSetupError

دانلود منابع فلشینگ 

protected void downloadFlashingResources (ITestDevice device, 
                IDeviceBuildInfo localBuild)

دانلود فایل‌های ایمیج چشمک‌زن اضافی مورد نیاز است

پارامترها
device ITestDevice : ITestDevice برای دانلود منابع

localBuild IDeviceBuildInfo : اطلاعات IDeviceBuildInfo که باید وارد شود. فرض بر این است که فایل تصویر دستگاه از قبل تنظیم شده است.

پرتاب‌ها
DeviceNotAvailableException اگر دستگاه در دسترس نباشد
TargetSetupError اگر بازیابی منابع ناموفق بود

اجرای FastbootCmd 

protected String executeFastbootCmd (ITestDevice device, 
                String... cmdArgs)

روش کمکی برای اجرای دستور fastboot.

پارامترها
device ITestDevice : ITestDevice قرار است دستور روی آن اجرا شود

cmdArgs String : آرگومان‌هایی که باید به fastboot ارائه شوند

بازگشت‌ها
String اگر خروجی دستور stderr خالی نباشد، آن را به صورت رشته نمایش می‌دهد. در غیر این صورت، خروجی stdout را برمی‌گرداند. برخی از دستورات fastboot عجیب هستند زیرا در صورت موفقیت، خروجی را در stderr ذخیره می‌کنند.

پرتاب‌ها
DeviceNotAvailableException اگر دستگاه در دسترس نباشد
TargetSetupError اگر دستور fastboot با شکست مواجه شد

اجرایLongFastbootCmd 

protected String executeLongFastbootCmd (ITestDevice device, 
                String... cmdArgs)

متد کمکی برای اجرای یک دستور fastboot طولانی مدت.

نکته: اکثر دستورات فست‌بوت معمولاً در بازه زمانی مجاز توسط INativeDevice.executeFastbootCommand(String) اجرا می‌شوند. با این حال، وقتی چندین دستگاه به طور همزمان در حال فلش کردن هستند، دستورات فست‌بوت می‌توانند بسیار بیشتر از حالت عادی طول بکشند.

پارامترها
device ITestDevice : ITestDevice قرار است دستور روی آن اجرا شود

cmdArgs String : آرگومان‌هایی که باید به fastboot ارائه شوند

بازگشت‌ها
String اگر خروجی دستور stderr خالی نباشد، آن را به صورت رشته نمایش می‌دهد. در غیر این صورت، خروجی stdout را برمی‌گرداند. برخی از دستورات fastboot عجیب هستند زیرا در صورت موفقیت، خروجی را در stderr ذخیره می‌کنند.

پرتاب‌ها
DeviceNotAvailableException اگر دستگاه در دسترس نباشد
TargetSetupError اگر دستور fastboot با شکست مواجه شد

اجرایLongFastbootCmd 

protected String executeLongFastbootCmd (ITestDevice device, 
                 envVarMap, 
                String... cmdArgs)

متد کمکی برای اجرای یک دستور fastboot طولانی مدت با متغیرهای محیطی.

نکته: اکثر دستورات فست‌بوت معمولاً در بازه زمانی مجاز توسط INativeDevice.executeFastbootCommand(String) اجرا می‌شوند. با این حال، وقتی چندین دستگاه به طور همزمان در حال فلش کردن هستند، دستورات فست‌بوت می‌توانند بسیار بیشتر از حالت عادی طول بکشند.

پارامترها
device ITestDevice : ITestDevice قرار است دستور روی آن اجرا شود

envVarMap : نقشه‌ای که متغیرهای محیطی را در خود جای داده است که باید قبل از اجرای دستور fastboot تنظیم شوند.

cmdArgs String : آرگومان‌هایی که باید به fastboot ارائه شوند

بازگشت‌ها
String اگر خروجی دستور stderr خالی نباشد، آن را به صورت رشته نمایش می‌دهد. در غیر این صورت، خروجی stdout را برمی‌گرداند. برخی از دستورات fastboot عجیب هستند زیرا در صورت موفقیت، خروجی را در stderr ذخیره می‌کنند.

پرتاب‌ها
DeviceNotAvailableException اگر دستگاه در دسترس نباشد
TargetSetupError اگر دستور fastboot با شکست مواجه شد

فلش‌باند 

protected void flashBaseband (ITestDevice device, 
                File basebandImageFile)

تصویر باند پایه داده شده را فلش می‌کند و دوباره به بوت لودر راه اندازی مجدد می‌کند

پارامترها
device ITestDevice : ITestDevice قرار است فلش شود

basebandImageFile File : ERROR(/File)

پرتاب‌ها
DeviceNotAvailableException اگر دستگاه در دسترس نباشد
TargetSetupError اگر فلش کردن بیس باند ناموفق بود

فلش بوت لودر 

protected void flashBootloader (ITestDevice device, 
                File bootloaderImageFile)

ایمیج بوت‌لودر داده شده را فلش می‌کند و دوباره به بوت‌لودر ریبوت می‌کند

پارامترها
device ITestDevice : ITestDevice قرار است فلش شود

bootloaderImageFile File : ERROR(/File)

پرتاب‌ها
DeviceNotAvailableException اگر دستگاه در دسترس نباشد
TargetSetupError اگر فلش نشد

flashExtraImages 

protected void flashExtraImages (ITestDevice device, 
                IDeviceBuildInfo deviceBuild)

قبل از فلش کردن سیستم و راه‌اندازی مجدد، پارتیشن‌های مربوط به هر دستگاه را فلش کنید. نیازی به انجام این کار نیست، مگر اینکه دستور override داده شده باشد.

پارامترها
device ITestDevice : ITestDevice قرار است فلش شود

deviceBuild IDeviceBuildInfo : اطلاعات IDeviceBuildInfo که شامل فایل‌های ساخت است.

پرتاب‌ها
com.android.tradefed.device.DeviceNotAvailableException
خطای com.android.tradefed.targetprep.TargetSetupError
DeviceNotAvailableException
TargetSetupError

فلش پارتیشن 

protected void flashPartition (ITestDevice device, 
                File imgFile, 
                String partition)

فلش کردن یک پارتیشن جداگانه از یک دستگاه

پارامترها
device ITestDevice : ITestDevice قرار است فلش شود

imgFile File : یک ERROR(/File) که به تصویری که باید فلش شود اشاره می‌کند

partition String : نام پارتیشنی که قرار است فلش شود

پرتاب‌ها
DeviceNotAvailableException
TargetSetupError

flashRamdiskIfNeeded 

protected void flashRamdiskIfNeeded (ITestDevice device, 
                IDeviceBuildInfo deviceBuild)

پارامترها
device ITestDevice

deviceBuild IDeviceBuildInfo

پرتاب‌ها
DeviceNotAvailableException
TargetSetupError

فلش سیستم 

protected void flashSystem (ITestDevice device, 
                IDeviceBuildInfo deviceBuild)

فایل ایمیج سیستم را روی دستگاه فلش کنید.

پارامترها
device ITestDevice : ITestDevice قرار است فلش شود

deviceBuild IDeviceBuildInfo : فایل IDeviceBuildInfo که قرار است فلش شود

پرتاب‌ها
DeviceNotAvailableException اگر دستگاه در دسترس نباشد
TargetSetupError اگر دستور fastboot با شکست مواجه شد

flashUserData 

protected void flashUserData (ITestDevice device, 
                IDeviceBuildInfo deviceBuild)

پارتیشن userdata را روی دستگاه فلش کنید.

پارامترها
device ITestDevice : ITestDevice قرار است فلش شود

deviceBuild IDeviceBuildInfo : IDeviceBuildInfo که شامل فایل‌هایی برای فلش کردن است.

پرتاب‌ها
DeviceNotAvailableException اگر دستگاه در دسترس نباشد
TargetSetupError اگر فلش کردن داده‌های کاربر ناموفق بود

flashUserDataFromDeviceImageFile 

protected void flashUserDataFromDeviceImageFile (ITestDevice device, 
                IDeviceBuildInfo deviceBuild)

فایل userdata.img را از فایل ایمیج دستگاه استخراج کرده و آن را روی دستگاه فلش می‌کند.

پارامترها
device ITestDevice : ITestDevice قرار است فلش شود

deviceBuild IDeviceBuildInfo : IDeviceBuildInfo که شامل فایل‌هایی برای فلش کردن است.

پرتاب‌ها
DeviceNotAvailableException اگر دستگاه در دسترس نباشد
TargetSetupError اگر استخراج یا فلش کردن داده‌های کاربر ناموفق بود

دریافت نام پارتیشن بوت 

protected String getBootPartitionName ()

نام پارتیشن بوت را برای این فلشر دستگاه دریافت کنید.

پیش‌فرض روی «bootloader» است. در صورت لزوم، کلاس‌های فرعی باید آن را بازنویسی کنند.

بازگشت‌ها
String

پیشوند فایل دریافت بوت لودر 

protected String getBootloaderFilePrefix (ITestDevice device)

پیشوند فایل بوت لودر را دریافت کنید.

مقدار پیش‌فرض getBootPartitionName() است. در صورت لزوم، کلاس‌های فرزند باید بازنویسی شوند.

پارامترها
device ITestDevice : ITestDevice قرار است فلش شود

بازگشت‌ها
String

پرتاب‌ها
DeviceNotAvailableException اگر دستگاه در دسترس نباشد
TargetSetupError اگر دریافت پیشوند ناموفق بود

دریافت فعلی اسلات 

protected String getCurrentSlot (ITestDevice device)

متد کمکی برای بازیابی اسلات فعلی (برای دستگاه‌های دارای قابلیت A/B).

پارامترها
device ITestDevice : ITestDevice که قرار است دستور روی آن اجرا شود.

بازگشت‌ها
String "a"، "b" یا null (اگر دستگاه قابلیت A/B را ندارد)

پرتاب‌ها
com.android.tradefed.device.DeviceNotAvailableException
خطای com.android.tradefed.targetprep.TargetSetupError
DeviceNotAvailableException
TargetSetupError

بازیابی منابع 

protected IFlashingResourcesRetriever getFlashingResourcesRetriever ()

بازگشت‌ها
IFlashingResourcesRetriever

دریافت فیوز 

protected FuseUtil getFuseUtil ()

بازگشت‌ها
FuseUtil

دریافت نسخه تصویر 

protected String getImageVersion (ITestDevice device, 
                String imageName)

پارامترها
device ITestDevice

imageName String

بازگشت‌ها
String

پرتاب‌ها
DeviceNotAvailableException
TargetSetupError

دریافت RunUtil 

protected IRunUtil getRunUtil ()

برای آزمایش در معرض دید قرار گرفت.

بازگشت‌ها
IRunUtil

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

protected void handleUserDataFlashing (ITestDevice device, 
                IDeviceBuildInfo deviceBuild)

مدیریت فلش کردن پارتیشن userdata/cache

پارامترها
device ITestDevice : ITestDevice قرار است فلش شود

deviceBuild IDeviceBuildInfo : IDeviceBuildInfo که شامل فایل‌هایی برای فلش کردن است.

پرتاب‌ها
com.android.tradefed.device.DeviceNotAvailableException
خطای com.android.tradefed.targetprep.TargetSetupError
DeviceNotAvailableException
TargetSetupError

پارتیشن دارد 

protected boolean hasPartition (ITestDevice device, 
                String partition)

با بوت لودر بررسی می‌کند که آیا پارتیشن مشخص شده وجود دارد یا خیر

پارامترها
device ITestDevice : ITestDevice قرار است روی آن عملیات انجام شود

partition String : نام پارتیشنی که باید بررسی شود

بازگشت‌ها
boolean

پرتاب‌ها
DeviceNotAvailableException

تنظیمات پیش از فلش 

protected void preFlashSetup (ITestDevice device, 
                IDeviceBuildInfo deviceBuild)

هرگونه تنظیمات پیش از فلش اضافی مورد نیاز را انجام دهید. نیازی به انجام نیست، مگر اینکه لغو شده باشد.

پارامترها
device ITestDevice : ITestDevice که باید آماده شود

deviceBuild IDeviceBuildInfo : اطلاعات IDeviceBuildInfo که شامل فایل‌های ساخت است.

پرتاب‌ها
com.android.tradefed.device.DeviceNotAvailableException
خطای com.android.tradefed.targetprep.TargetSetupError
DeviceNotAvailableException
TargetSetupError

تنظیم رد کردن بوت لودر، بررسی نسخه 

protected void setSkipBootloaderVersionCheck (boolean skipBootloaderVersionCheck)

پارامترها
skipBootloaderVersionCheck boolean

پیام ناموفق Fastboot را تنظیم کن و از آن بگذر 

protected void setSkipFastbootFailedMessage (boolean skipFastbootFailedMessage)

پارامترها
skipFastbootFailedMessage boolean

اطلاعات ساخت سیستم را تنظیم کنید 

protected void setSystemBuildInfo (String systemBuildId, 
                String systemBuildFlavor)

پارامترها
systemBuildId String

systemBuildFlavor String

تأیید تخته‌های مورد نیاز 

protected void verifyRequiredBoards (ITestDevice device, 
                IFlashingResourcesParser resourceParser, 
                String deviceProductType)

تأیید کنید که نوع محصول دستگاه از قابلیت فلش شدنِ ساخته‌شده پشتیبانی می‌کند.

پیاده‌سازی پایه بررسی می‌کند که deviceProductType در مجموعه‌ی IFlashingResourcesParser.getRequiredBoards() گنجانده شده است. کلاس‌های فرعی می‌توانند در صورت تمایل بازنویسی شوند.

پارامترها
device ITestDevice : ITestDevice که قرار است فلش شود

resourceParser IFlashingResourcesParser : IFlashingResourcesParser

deviceProductType String : نوع محصول device

پرتاب‌ها
TargetSetupError اگر اطلاعات برد مورد نیاز برای ساخت با دستگاه مطابقت نداشت

وایپ کش 

protected void wipeCache (ITestDevice device)

پارتیشن کش (cache) دستگاه را پاک کنید.

پارامترها
device ITestDevice : ITestDevice قرار است فلش شود

پرتاب‌ها
DeviceNotAvailableException اگر دستگاه در دسترس نباشد
TargetSetupError اگر فلش کردن کش ناموفق بود

پاک کردن پارتیشن 

protected void wipePartition (ITestDevice device, 
                String partition)

پارتیشن مشخص شده را با دستور `fastboot erase <name>` پاک کنید.

پارامترها
device ITestDevice : ITestDevice قرار است روی آن عملیات انجام شود

partition String : نام پارتیشنی که قرار است پاک شود

پرتاب‌ها
DeviceNotAvailableException
TargetSetupError