فلشر دستگاه

public interface IDeviceFlasher

com.android.tradefed.targetprep.IDeviceFlasher

تصویر دستگاه را روی دستگاه چشمک می‌زند.

خلاصه

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

abstract void flash ( ITestDevice device, IDeviceBuildInfo deviceBuild)

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

default getAdditionalFileFilters ()

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

abstract CommandStatus getSystemFlashingStatus ()

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

abstract IDeviceFlasher.UserDataFlashOption getUserDataFlashOption ()

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

abstract void overrideDeviceOptions ( ITestDevice device)

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

default void postFlashOperations ( ITestDevice device, IDeviceBuildInfo deviceBuild)

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

default void preFlashOperations ( ITestDevice device, IDeviceBuildInfo deviceBuild)

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

abstract void setDataWipeSkipList ( dataWipeSkipList)

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

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

default void setExtraMetadata ( metadata)

به flasher اجازه می‌دهد گزینه‌های فراداده اضافی را دریافت کند.

abstract void setFlashingResourcesRetriever ( IFlashingResourcesRetriever retriever)

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

abstract void setForceSystemFlash (boolean forceSystemFlash)

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

default void setRamdiskPartition (String ramdiskPartition)

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

default void setShouldFlashRamdisk (boolean shouldFlashRamdisk)

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

abstract void setUserDataFlashOption ( IDeviceFlasher.UserDataFlashOption flashOption)

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

abstract void setWipeTimeout (long timeout)

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

default boolean shouldFlashRamdisk ()

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

default boolean supportsFlashingInFastbootD ()

آیا دستگاهی که فلشر را پیاده‌سازی می‌کند، می‌تواند در حالت fastbootd فلش شود؟

default void tearDownFlasher ()

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

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

فلش 

public abstract void flash (ITestDevice device, 
                IDeviceBuildInfo deviceBuild)

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

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

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

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

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

فیلترهای فایل اضافی را دریافت کنید 

public  getAdditionalFileFilters ()

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

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

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

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

به طور پیش‌فرض، این متد یک Set خالی برمی‌گرداند.

بازگشت‌ها

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

public abstract CommandStatus getSystemFlashingStatus ()

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

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

بازگشت‌ها
CommandStatus

گزینه getUserDataFlash 

public abstract IDeviceFlasher.UserDataFlashOption getUserDataFlashOption ()

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

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

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

public abstract void overrideDeviceOptions (ITestDevice device)

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

عملیات‌های پس از فلش 

public void postFlashOperations (ITestDevice device, 
                IDeviceBuildInfo deviceBuild)

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

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

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

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

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

public void preFlashOperations (ITestDevice device, 
                IDeviceBuildInfo deviceBuild)

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

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

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

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

setDataWipeSkipList 

public abstract void setDataWipeSkipList ( dataWipeSkipList)

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

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

پارامترها
dataWipeSkipList

setExtraMetadata 

public void setExtraMetadata ( metadata)

به flasher اجازه می‌دهد گزینه‌های فراداده اضافی را دریافت کند.

پارامترها
metadata

setFlashingResourcesبازیاب 

public abstract void setFlashingResourcesRetriever (IFlashingResourcesRetriever retriever)

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

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

setForceSystemFlash 

public abstract void setForceSystemFlash (boolean forceSystemFlash)

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

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

public void setRamdiskPartition (String ramdiskPartition)

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

setShouldFlashRamdisk 

public void setShouldFlashRamdisk (boolean shouldFlashRamdisk)

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

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

public abstract void setUserDataFlashOption (IDeviceFlasher.UserDataFlashOption flashOption)

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

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

public abstract void setWipeTimeout (long timeout)

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

پارامترها
timeout long

shouldFlashRamdisk 

public boolean shouldFlashRamdisk ()

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

بازگشت‌ها
boolean

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

public boolean supportsFlashingInFastbootD ()

آیا دستگاهی که فلشر را پیاده‌سازی می‌کند، می‌تواند در حالت fastbootd فلش شود؟

بازگشت‌ها
boolean

tearDownFlasher 

public void tearDownFlasher ()

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