IDeviceFlasher

public interface IDeviceFlasher

com.android.tradefed.targetprep.IDeviceFlasher

הפעלה של תמונה של מכשיר במכשיר.

סיכום

‫methods ציבוריים

default boolean checkAntiRollback(ITestDevice device, IDeviceBuildInfo deviceBuild)

בודקים אם הופעל מנגנון למניעת חזרה לגרסה קודמת.

abstract void flash(ITestDevice device, IDeviceBuildInfo deviceBuild)

הפעלת Flash לגרסת ה-build במכשיר.

default Set<String> 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(Collection<String> dataWipeSkipList)

המדיניות הזו מגדירה את רשימת הנתיבים ב-/data שלא יימחקו כשמשתמשים ב-ITestsZipInstaller.

שימו לב שרמת הפירוט של רשימת הדילוג היא צאצאים ישירים של /data.

default void setExtraMetadata(Map<String, String> metadata)

מאפשר לכלי ההצגה לקבל אפשרויות נוספות של מטא-נתונים.

abstract void setFlashingResourcesRetriever(IFlashingResourcesRetriever retriever)

מגדירה את המנגנון שבאמצעותו כלי ההפעלה יכול לאחזר קובצי משאבים להפעלה.

abstract void setForceSystemFlash(boolean forceSystemFlash)

הגדרה אם המערכת תמיד תהבהב גם אם היא מריצה את הגרסה הנוכחית

default void setRamdiskPartition(String ramdiskPartition)

הגדרת מחיצת ramdisk

default void setShouldFlashRamdisk(boolean shouldFlashRamdisk)

ההגדרה קובעת אם צריך להפעיל ramdisk נוסף אחרי עדכון המכשיר באמצעות קובץ zip של תמונה

abstract void setUserDataFlashOption(IDeviceFlasher.UserDataFlashOption flashOption)

הגדרה שקובעת אם תמונת המצב של נתוני המשתמשים תועבר למכשיר, תימחק או תישמר

abstract void setWipeTimeout(long timeout)

מגדירים את הזמן הקצוב לתפוגה למחיקת הנתונים.

default boolean shouldFlashRamdisk()

בודק אם כלי ההצבה מוגדר להצבת ramdisk נוסף אחרי עדכון המכשיר באמצעות קובץ zip של תמונה

default boolean supportsFlashingInFastbootD()

האם אפשר להפעיל במכשיר שבו מופעלת התוכנה להעברת נתונים (flasher) העברה מהירה של נתונים במצב fastbootd.

default void tearDownFlasher()

הזדמנות אחרונה להטמעת ה-flasher כדי לנקות את עצמו

‫methods ציבוריים

checkAntiRollback

public boolean checkAntiRollback (ITestDevice device, 
                IDeviceBuildInfo deviceBuild)

בודקים אם הופעל מנגנון למניעת חזרה לגרסה קודמת.

פרמטרים
device ITestDevice

deviceBuild IDeviceBuildInfo

החזרות
boolean

הקפצת הודעות שגיאה (throw)
DeviceNotAvailableException

פלאש

public abstract void flash (ITestDevice device, 
                IDeviceBuildInfo deviceBuild)

הפעלת Flash לגרסת ה-build במכשיר.

הפונקציה מחזירה ערך מיד אחרי שההפעלה מסתיימת. המתקשרים צריכים להמתין עד שהמכשיר יהיה אונליין וזמין לפני שממשיכים בבדיקה.

פרמטרים
device ITestDevice: ITestDevice לצריבת ROM‏ (flash)
deviceBuild IDeviceBuildInfo: IDeviceBuildInfo לצריבת ROM‏ (flash)
הקפצת הודעות שגיאה (throw)
DeviceNotAvailableException אם המכשיר לא מגיב
TargetSetupError אם ה-flash של ה-build נכשל

getAdditionalFileFilters

public Set<String> getAdditionalFileFilters ()

קבלת מסננים עבור פריטי בנייה נוספים.

חלק מהכלים להצגת הודעות קופצות דורשים פריטי בנייה מסוימים שלא נכללים בפריטי ברירת המחדל. כלי הפעלה כאלה צריכים לבטל את השיטה הזו, כדי שכל משתמש בכלי ההפעלה לא יצטרך לדעת על הקבצים האלה ולספק אפשרויות של שורת פקודה.

שימו לב שהשיטה הזו מופעלת במופע זמני של IDeviceFlasher, ולכן לא צריך להסתמך על מצב מעבר לזה שמופיע בבונה ברירת המחדל.

מחרוזות בערכה מתפרשות כתבניות קבצים, וכל הקבצים שתואמים לתבנית יאוחזרו.

כברירת מחדל, השיטה הזו מחזירה קבוצה ריקה.

החזרות
Set<String>

getSystemFlashingStatus

public abstract CommandStatus getSystemFlashingStatus ()

אחזור סטטוס הביצוע של הפקודה עבור מחיצות מערכת ראשיות שמוצגות בהבזק.

שימו לב שאם מחיצות המערכת לא מופעלות (במערכת כבר יש את הגרסה להפעלה), סטטוס הפקודה עשוי להיות null

החזרות
CommandStatus

getUserDataFlashOption

public abstract IDeviceFlasher.UserDataFlashOption getUserDataFlashOption ()

קובע אם צריך להפעיל, למחוק או לשמור את תמונת המצב של נתוני המשתמש

החזרות
IDeviceFlasher.UserDataFlashOption האם צריך להפעיל Flash, לנגב או לשמור את תמונת המצב של נתוני המשתמש

overrideDeviceOptions

public abstract void overrideDeviceOptions (ITestDevice device)

שינוי האפשרויות של מכשיר. הפרמטר הזה משמש לביטול ערכי ברירת המחדל של האפשרויות אם ברירות המחדל לא נתמכות במכשיר מסוים.

postFlashOperations

public void postFlashOperations (ITestDevice device, 
                IDeviceBuildInfo deviceBuild)

כל פעולות הניקוי והבדיקות שצריכות להתבצע אחרי ההפעלה בפועל של הקטע הקריטי. אף אחת מהפעולות האלה לא תיכלל בקטע הקריטי עם בקרת הגישה.

פרמטרים
device ITestDevice: ITestDevice לצריבת ROM‏ (flash)
deviceBuild IDeviceBuildInfo: IDeviceBuildInfo לצריבת ROM‏ (flash)
הקפצת הודעות שגיאה (throw)
DeviceNotAvailableException אם המכשיר לא מגיב
TargetSetupError אם הגדרה כלשהי נכשלת

preFlashOperations

public void preFlashOperations (ITestDevice device, 
                IDeviceBuildInfo deviceBuild)

כל פעולות ההגדרה והבדיקות שצריך לבצע לפני ההפעלה בפועל של קטע קריטי. אף אחת מהפעולות האלה לא תיכלל בקטע הקריטי עם בקרת הגישה.

פרמטרים
device ITestDevice: ITestDevice לצריבת ROM‏ (flash)
deviceBuild IDeviceBuildInfo: IDeviceBuildInfo לצריבת ROM‏ (flash)
הקפצת הודעות שגיאה (throw)
DeviceNotAvailableException אם המכשיר לא מגיב
TargetSetupError אם אחת מההגדרות נכשלת

setDataWipeSkipList

public abstract void setDataWipeSkipList (Collection<String> dataWipeSkipList)

המדיניות הזו מגדירה את רשימת הנתיבים ב-/data שלא יימחקו כשמשתמשים ב-ITestsZipInstaller.

שימו לב שרמת הפירוט של רשימת הדילוג היא צאצאים ישירים של /data.

פרמטרים
dataWipeSkipList Collection

setExtraMetadata

public void setExtraMetadata (Map<String, String> metadata)

מאפשר לכלי ההצגה לקבל אפשרויות נוספות של מטא-נתונים.

פרמטרים
metadata Map

setFlashingResourcesRetriever

public abstract void setFlashingResourcesRetriever (IFlashingResourcesRetriever retriever)

מגדירה את המנגנון שבאמצעותו כלי ההצבה יכול לאחזר קובצי משאבים להצבה.

פרמטרים
retriever ‫IFlashingResourcesRetriever: IFlashingResourcesRetriever שבו רוצים להשתמש

setForceSystemFlash

public abstract void setForceSystemFlash (boolean forceSystemFlash)

הגדרה אם המערכת תמיד תהבהב גם אם היא מריצה את הגרסה הנוכחית

setRamdiskPartition

public void setRamdiskPartition (String ramdiskPartition)

הגדרת מחיצת ramdisk

setShouldFlashRamdisk

public void setShouldFlashRamdisk (boolean shouldFlashRamdisk)

ההגדרה קובעת אם צריך להפעיל ramdisk נוסף אחרי עדכון המכשיר באמצעות קובץ zip של תמונה

setUserDataFlashOption

public abstract void setUserDataFlashOption (IDeviceFlasher.UserDataFlashOption flashOption)

הגדרה שקובעת אם תמונת המצב של נתוני המשתמשים תועבר למכשיר, תימחק או תישמר

setWipeTimeout

public abstract void setWipeTimeout (long timeout)

מגדירים את הזמן הקצוב לתפוגה למחיקת הנתונים.

פרמטרים
timeout long

shouldFlashRamdisk

public boolean shouldFlashRamdisk ()

בודק אם כלי ההצבה מוגדר להצבת ramdisk נוסף אחרי עדכון המכשיר באמצעות קובץ zip של תמונה

החזרות
boolean

supportsFlashingInFastbootD

public boolean supportsFlashingInFastbootD ()

האם אפשר להפעיל במכשיר שבו מופעלת התוכנה להעברת נתונים (flasher) העברה מהירה של נתונים במצב fastbootd.

החזרות
boolean

tearDownFlasher

public void tearDownFlasher ()

הזדמנות אחרונה להטמעת ה-flasher כדי לנקות את עצמו