IDeviceFlasher

public interface IDeviceFlasher

com.android.tradefed.targetprep.IDeviceFlasher


איך מאפסים את המכשיר באמצעות אימג'.

סיכום

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

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.

abstract void setFlashingResourcesRetriever(IFlashingResourcesRetriever retriever)

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

abstract void setForceSystemFlash(boolean forceSystemFlash)

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

default void setRamdiskPartition(String ramdiskPartition)

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

default void setShouldFlashRamdisk(boolean shouldFlashRamdisk)

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

abstract void setUserDataFlashOption(IDeviceFlasher.UserDataFlashOption flashOption)

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

abstract void setWipeTimeout(long timeout)

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

default boolean shouldFlashRamdisk()

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

default boolean supportsFlashingInFastbootD()

האם אפשר לבצע איפוס במכשיר שמטמיע את ה-flasher במצב fastbootd.

default void tearDownFlasher()

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

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

Flash

public abstract void flash (ITestDevice device, 
                IDeviceBuildInfo deviceBuild)

איך מעדכנים את הגרסה במכשיר.

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

פרמטרים
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 אם צריך להפעיל את קובץ האימג' של נתוני המשתמש, למחוק אותו או לשמור אותו

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

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

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

החזרות
boolean

supportsFlashingInFastbootD

public boolean supportsFlashingInFastbootD ()

האם אפשר לבצע איפוס במכשיר שמטמיע את ה-flasher במצב fastbootd.

החזרות
boolean

tearDownFlasher

public void tearDownFlasher ()

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