IDeviceFlasher

public interface IDeviceFlasher

com.android.tradefed.targetprep.IDeviceFlasher

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

סיכום

‫methods ציבוריים

abstract void flash(ITestDevice device, IDeviceBuildInfo deviceBuild)

הגרסה מועברת למכשיר.

default getAdditionalFileFilters()

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

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)

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

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 ציבוריים

Flash

public abstract void flash (ITestDevice device, 
                IDeviceBuildInfo deviceBuild)

הגרסה מועברת למכשיר.

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

פרמטרים
device ITestDevice: ITestDevice יהבהב
deviceBuild IDeviceBuildInfo: IDeviceBuildInfo יהבהב
זריקות
TargetSetupError אם ה-flash של ה-build נכשל
DeviceNotAvailableException אם המכשיר לא מגיב

getAdditionalFileFilters

public  getAdditionalFileFilters ()

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

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

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

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

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

החזרות

getSystemFlashingStatus

public abstract CommandStatus getSystemFlashingStatus ()

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

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

החזרות
CommandStatus

getUserDataFlashOption

public abstract IDeviceFlasher.UserDataFlashOption getUserDataFlashOption ()

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

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

overrideDeviceOptions

public abstract void overrideDeviceOptions (ITestDevice device)

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

postFlashOperations

public void postFlashOperations (ITestDevice device, 
                IDeviceBuildInfo deviceBuild)

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

פרמטרים
device ITestDevice: ITestDevice יהבהב
deviceBuild IDeviceBuildInfo: IDeviceBuildInfo יהבהב
זריקות
TargetSetupError אם הגדרה כלשהי נכשלת
DeviceNotAvailableException אם המכשיר לא מגיב

preFlashOperations

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)

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

פרמטרים
metadata

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 ()

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

החזרות
boolean

tearDownFlasher

public void tearDownFlasher ()

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