IDeviceFlasher

public interface IDeviceFlasher

com.android.tradefed.targetprep.IDeviceFlasher


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

סיכום

שיטות ציבוריות

abstract void flash(ITestDevice device, IDeviceBuildInfo deviceBuild)

מפעילים את ה-build במכשיר.

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.

abstract void setFlashingResourcesRetriever(IFlashingResourcesRetriever retriever)

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

abstract void setForceSystemFlash(boolean forceSystemFlash)

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

default void setRamdiskPartition(String ramdiskPartition)

הגדרת מחיצה של RAM

default void setShouldFlashRamdisk(boolean shouldFlashRamdisk)

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

abstract void setUserDataFlashOption(IDeviceFlasher.UserDataFlashOption flashOption)

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

abstract void setWipeTimeout(long timeout)

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

default boolean shouldFlashRamdisk()

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

default boolean supportsFlashingInFastbootD()

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

שיטות ציבוריות

Flash

public abstract void flash (ITestDevice device, 
                IDeviceBuildInfo deviceBuild)

מפעילים את ה-build במכשיר.

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

פרמטרים
device ITestDevice: ה-ITestDevice שיוצג בפלאש

deviceBuild IDeviceBuildInfo: IDeviceBuildInfo להבהב

זריקות
TargetSetupError if failed to flash build
DeviceNotAvailableException אם המכשיר לא מגיב

getAdditionalFileFilters

public  getAdditionalFileFilters ()

הצגת מסננים לחפצי build נוספים.

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

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

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

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

החזרות

getSystemFlashingStatus

public abstract CommandStatus getSystemFlashingStatus ()

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

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

החזרות
CommandStatus

getUserDataFlashOption

public abstract IDeviceFlasher.UserDataFlashOption getUserDataFlashOption ()

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

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

לשנות את DeviceOptions

public abstract void overrideDeviceOptions (ITestDevice device)

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

postFlashOperations

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

setFlashingResourcesRetriever

public abstract void setFlashingResourcesRetriever (IFlashingResourcesRetriever retriever)

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

פרמטרים
retriever IFlashingResourcesRetriever: IFlashingResourcesRetriever לשימוש

setForceSystemFlash

public abstract void setForceSystemFlash (boolean forceSystemFlash)

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

setRamdiskPartition

public void setRamdiskPartition (String ramdiskPartition)

הגדרת מחיצה של ramdisk

setShouldFlashRamdisk

public void setShouldFlashRamdisk (boolean shouldFlashRamdisk)

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

setUserDataFlashOption

public abstract void setUserDataFlashOption (IDeviceFlasher.UserDataFlashOption flashOption)

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

פונקציית ה-setWipeTimeout

public abstract void setWipeTimeout (long timeout)

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

פרמטרים
timeout long

shouldFlashRamdisk

public boolean shouldFlashRamdisk ()

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

החזרות
boolean

supportsFlashingInFastbootD

public boolean supportsFlashingInFastbootD ()

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

החזרות
boolean