iDeviceFlasher

public interface IDeviceFlasher

com.android.tradefed.targetprep.IDeviceFlasher

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

סיכום

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

abstract void flash(ITestDevice device, IDeviceBuildInfo deviceBuild)

קובצי ה-Flash מותאמים למכשיר.

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)

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

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)

קובצי ה-Flash מותאמים למכשיר.

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

פרמטרים
device ITestDevice: ITestDevice להבהב
deviceBuild IDeviceBuildInfo: IDeviceBuildInfo להבהב
קליעות
TargetSetupError אם הפעולה לא הצליחה לבצע Flash build
DeviceNotAvailableException אם המכשיר לא מגיב

getadditionalFileFilters

public  getAdditionalFileFilters ()

קבלת מסננים ליצירת ארטיפקטים נוספים של build.

חלק מה-Flashers דורשים פריטי מידע שנוצרו בתהליך פיתוח (artifacts) בגרסת build שאינם בין ברירת המחדל שנעשה בהם שימוש. כאלה פלאשים צריכים לעקוף את השיטה הזו, כך שכל משתמש בכלי הפלאש לא צריך יודעים על הקבצים האלה ומספקים אפשרויות לשורת הפקודה.

חשוב לשים לב שהשיטה הזו מופעלת במופע זמני של ה-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)

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

setRamdiskPartition

public void setRamdiskPartition (String ramdiskPartition)

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

setShooldFlashRamdisk

public void setShouldFlashRamdisk (boolean shouldFlashRamdisk)

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

הגדרתUserDataFlashOption

public abstract void setUserDataFlashOption (IDeviceFlasher.UserDataFlashOption flashOption)

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

פונקציית ה-setWipeTimeout

public abstract void setWipeTimeout (long timeout)

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

פרמטרים
timeout long

צריךFlashRamdisk

public boolean shouldFlashRamdisk ()

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

החזרות
boolean

תמיכה ב-FlashingInFastbootD

public boolean supportsFlashingInFastbootD ()

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

החזרות
boolean