FastbootDeviceFlasher

public class FastbootDeviceFlasher
extends Object implements IDeviceFlasher

java.lang.Object
   ↳ com.android.tradefed.targetprep.FastbootDeviceFlasher

מחלקת fastboot שמשמשת להעברת תמונה לציוד פיזי של Android.

סיכום

ערכים קבועים

String BASEBAND_IMAGE_NAME

‫Constructors ציבוריים

FastbootDeviceFlasher()

‫methods ציבוריים

static String fetchImageVersion(IRunUtil runUtil, ITestDevice device, String imageName)

שיטת עזר לקבלת הגרסה הנוכחית של התמונה במכשיר.

void flash(ITestDevice device, IDeviceBuildInfo deviceBuild)

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

CommandStatus getSystemFlashingStatus()

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

IDeviceFlasher.UserDataFlashOption getUserDataFlashOption()

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

void overrideDeviceOptions(ITestDevice device)

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

void preFlashOperations(ITestDevice device, IDeviceBuildInfo deviceBuild)

כל פעולות ההגדרה והבדיקות שצריך לבצע לפני ההפעלה בפועל של קטע קריטי.

void setDataWipeSkipList(Collection<String> dataWipeSkipList)

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

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

void setFlashOptions(Collection<String> flashOptions)

מגדירה רשימה של אפשרויות להעברה עם פקודות flash או עדכון.

void setFlashingResourcesRetriever(IFlashingResourcesRetriever retriever)

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

void setForceSystemFlash(boolean forceSystemFlash)

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

void setIncrementalFlashing(IncrementalImageUtil incrementalUtil)
void setRamdiskPartition(String ramdiskPartition)

הגדרת מחיצת ramdisk

void setShouldFlashRamdisk(boolean shouldFlashRamdisk)

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

void setUserDataFlashOption(IDeviceFlasher.UserDataFlashOption flashOption)

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

void setWipeTimeout(long timeout)

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

boolean shouldCheckBasebandVersionAfterFlash()
boolean shouldFlashRamdisk()

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

boolean shouldSkipBasebandVersionCheck()
boolean shouldSkipBootloaderVersionCheck()
static boolean stderrContainsFailed(String stderr, boolean skipBootloaderVersionCheck, boolean skipBasebandVersionCheck, boolean skipFastbootFailedMessage)
static boolean stderrContainsFailed(String stderr, boolean skipBootloaderVersionCheck, boolean skipBasebandVersionCheck)

שיטות מוגנות

void checkAndFlashBaseband(ITestDevice device, IDeviceBuildInfo deviceBuild)

במקרה הצורך, צורבים ROM של קובץ אימג של פס בסיס במכשיר.

boolean checkAndFlashBootloader(ITestDevice device, IDeviceBuildInfo deviceBuild)

במידת הצורך, צורבים ROM של קובץ האימג של תוכנת האתחול במכשיר.

boolean checkAndFlashSystem(ITestDevice device, String systemBuildId, String systemBuildFlavor, IDeviceBuildInfo deviceBuild)

אם צריך, צורבים את קובץ האימג' של המערכת במכשיר.

boolean checkShouldFlashBaseband(ITestDevice device, IDeviceBuildInfo deviceBuild)

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

IFlashingResourcesParser createFlashingResourcesParser(IDeviceBuildInfo localBuild, DeviceDescriptor descriptor)

שיטת יצירה של IFlashingResourcesParser.

void downloadExtraImageFiles(IFlashingResourcesParser resourceParser, IFlashingResourcesRetriever retriever, IDeviceBuildInfo localBuild)

‫Hook שמאפשר למחלקות משנה להוריד קבצים נוספים של תמונות מותאמות אישית, אם צריך.

void downloadFlashingResources(ITestDevice device, IDeviceBuildInfo localBuild)

הורדה של קבצים נוספים של תמונות להפעלה

String executeFastbootCmd(ITestDevice device, String... cmdArgs)

שיטת עזר להרצת פקודת fastboot.

String executeLongFastbootCmd(ITestDevice device, String... cmdArgs)

שיטת עזר להרצת פקודת fastboot ממושכת.

String executeLongFastbootCmd(ITestDevice device, Map<String, String> envVarMap, String... cmdArgs)

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

void flashBaseband(ITestDevice device, File basebandImageFile)

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

void flashBootloader(ITestDevice device, File bootloaderImageFile, boolean requireReboot)

מבצעת פלאשינג של תמונת תוכנת האתחול שצוינה.

void flashBootloader(ITestDevice device, File bootloaderImageFile)

מבצעת פלאשינג של תמונת תוכנת האתחול שצוינה ומפעילה מחדש את המכשיר במצב bootloader

void flashExtraImages(ITestDevice device, IDeviceBuildInfo deviceBuild)

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

void flashPartition(ITestDevice device, File imgFile, String partition)

צריבת ROM של מחיצה ספציפית במכשיר

void flashRamdiskIfNeeded(ITestDevice device, IDeviceBuildInfo deviceBuild)
void flashSystem(ITestDevice device, IDeviceBuildInfo deviceBuild)

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

void flashTrusty(ITestDevice device, File trustyImageFile)

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

void flashUserData(ITestDevice device, IDeviceBuildInfo deviceBuild)

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

void flashUserDataFromDeviceImageFile(ITestDevice device, IDeviceBuildInfo deviceBuild)

מחולץ userdata.img מקובץ אימג' של המכשיר ומועבר למכשיר

String getBootPartitionName()

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

String getBootloaderFilePrefix(ITestDevice device)

מקבלים את הקידומת של קובץ תוכנת האתחול.

String getCurrentSlot(ITestDevice device)

שיטת עזר לאחזור המשבצת הנוכחית (למכשירים עם יכולת בדיקת A/B).

IFlashingResourcesRetriever getFlashingResourcesRetriever()
FuseUtil getFuseUtil()
String getImageVersion(ITestDevice device, String imageName)
IRunUtil getRunUtil()

חשוף לבדיקה.

void handleUserDataFlashing(ITestDevice device, IDeviceBuildInfo deviceBuild)

טיפול בהבזקים של מחיצת נתוני המשתמשים או המטמון

boolean hasPartition(ITestDevice device, String partition)

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

void preFlashSetup(ITestDevice device, IDeviceBuildInfo deviceBuild)

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

void setCheckBasebandVersionAfterFlash(boolean checkBasebandVersionAfterFlash)
void setSkipBasebandVersionCheck(boolean skipBasebandVersionCheck)
void setSkipBootloaderVersionCheck(boolean skipBootloaderVersionCheck)
void setSkipFastbootFailedMessage(boolean skipFastbootFailedMessage)
void setSystemBuildInfo(String systemBuildId, String systemBuildFlavor)
void verifyRequiredBoards(ITestDevice device, IFlashingResourcesParser resourceParser, String deviceProductType)

מוודאים שסוג המוצר של המכשיר תומך בגרסה שרוצים להתקין.

void wipeCache(ITestDevice device)

מחיקת מחיצת המטמון במכשיר.

void wipePartition(ITestDevice device, String partition)

מחיקת המחיצה שצוינה באמצעות הפקודה `fastboot erase <name>`

ערכים קבועים

BASEBAND_IMAGE_NAME

public static final String BASEBAND_IMAGE_NAME

ערך קבוע: "radio"

‫constructors ציבוריים

FastbootDeviceFlasher

public FastbootDeviceFlasher ()

‫methods ציבוריים

fetchImageVersion

public static String fetchImageVersion (IRunUtil runUtil, 
                ITestDevice device, 
                String imageName)

שיטת עזר לקבלת הגרסה הנוכחית של התמונה במכשיר.

פרמטרים
runUtil IRunUtil

device ‫ITestDevice: הפקודה ITestDevice להפעלה
imageName ‫String: השם של התמונה שרוצים לקבל.
החזרות
String מחרוזת של פלט stdout מהפקודה
הקפצת הודעות שגיאה (throw)
DeviceNotAvailableException אם המכשיר לא זמין
TargetSetupError אם פקודת fastboot נכשלת או שלא ניתן לקבוע את הגרסה

פלאש

public void flash (ITestDevice device, 
                IDeviceBuildInfo deviceBuild)

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

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

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

getSystemFlashingStatus

public CommandStatus getSystemFlashingStatus ()

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

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

החזרות
CommandStatus

getUserDataFlashOption

public IDeviceFlasher.UserDataFlashOption getUserDataFlashOption ()

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

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

overrideDeviceOptions

public void overrideDeviceOptions (ITestDevice device)

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

preFlashOperations

public void preFlashOperations (ITestDevice device, 
                IDeviceBuildInfo deviceBuild)

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

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

setDataWipeSkipList

public void setDataWipeSkipList (Collection<String> dataWipeSkipList)

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

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

פרמטרים
dataWipeSkipList Collection

setFlashOptions

public void setFlashOptions (Collection<String> flashOptions)

מגדירה רשימה של אפשרויות להעברה עם פקודות flash או עדכון.

setFlashingResourcesRetriever

public void setFlashingResourcesRetriever (IFlashingResourcesRetriever retriever)

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

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

setForceSystemFlash

public void setForceSystemFlash (boolean forceSystemFlash)

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

setIncrementalFlashing

public void setIncrementalFlashing (IncrementalImageUtil incrementalUtil)

פרמטרים
incrementalUtil IncrementalImageUtil

setRamdiskPartition

public void setRamdiskPartition (String ramdiskPartition)

הגדרת מחיצת ramdisk

setShouldFlashRamdisk

public void setShouldFlashRamdisk (boolean shouldFlashRamdisk)

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

setUserDataFlashOption

public void setUserDataFlashOption (IDeviceFlasher.UserDataFlashOption flashOption)

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

setWipeTimeout

public void setWipeTimeout (long timeout)

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

פרמטרים
timeout long

shouldCheckBasebandVersionAfterFlash

public boolean shouldCheckBasebandVersionAfterFlash ()

החזרות
boolean

shouldFlashRamdisk

public boolean shouldFlashRamdisk ()

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

החזרות
boolean

shouldSkipBasebandVersionCheck

public boolean shouldSkipBasebandVersionCheck ()

החזרות
boolean

shouldSkipBootloaderVersionCheck

public boolean shouldSkipBootloaderVersionCheck ()

החזרות
boolean

stderrContainsFailed

public static boolean stderrContainsFailed (String stderr, 
                boolean skipBootloaderVersionCheck, 
                boolean skipBasebandVersionCheck, 
                boolean skipFastbootFailedMessage)

פרמטרים
stderr String

skipBootloaderVersionCheck boolean

skipBasebandVersionCheck boolean

skipFastbootFailedMessage boolean

החזרות
boolean

stderrContainsFailed

public static boolean stderrContainsFailed (String stderr, 
                boolean skipBootloaderVersionCheck, 
                boolean skipBasebandVersionCheck)

פרמטרים
stderr String

skipBootloaderVersionCheck boolean

skipBasebandVersionCheck boolean

החזרות
boolean

שיטות מוגנות

checkAndFlashBaseband

protected void checkAndFlashBaseband (ITestDevice device, 
                IDeviceBuildInfo deviceBuild)

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

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

checkAndFlashBootloader

protected boolean checkAndFlashBootloader (ITestDevice device, 
                IDeviceBuildInfo deviceBuild)

במידת הצורך, צורבים ROM של קובץ האימג של תוכנת האתחול במכשיר.

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

פרמטרים
device ITestDevice: ITestDevice לצריבת ROM‏ (flash)
deviceBuild ‫IDeviceBuildInfo: ה-IDeviceBuildInfo שמכיל את תמונת הטוען (bootloader) להעברה לזיכרון הפלאש
החזרות
boolean ‫true אם בוצע פלאשינג של תוכנת האתחול, false אם הוא דולג
הקפצת הודעות שגיאה (throw)
DeviceNotAvailableException אם המכשיר לא זמין
TargetSetupError אם ההעברה של תוכנת האתחול נכשלה

checkAndFlashSystem

protected boolean checkAndFlashSystem (ITestDevice device, 
                String systemBuildId, 
                String systemBuildFlavor, 
                IDeviceBuildInfo deviceBuild)

אם צריך, צורבים את קובץ האימג' של המערכת במכשיר.

כדאי לעיין ב-ERROR(shouldFlashSystem(String,String,IDeviceBuildInfo)/#shouldFlashSystem(java.lang.String,java.lang.String,com.android.tradefed.build.IDeviceBuildInfo) shouldFlashSystem(String,String,IDeviceBuildInfo))

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

פרמטרים
device ITestDevice: ITestDevice לצריבת ROM‏ (flash)
systemBuildId ‫String: מזהה ה-build הנוכחי שפועל במכשיר
systemBuildFlavor ‫String: הטעם הנוכחי של הגרסה שפועלת במכשיר
deviceBuild ‫IDeviceBuildInfo: IDeviceBuildInfo שמכיל את תמונת המערכת להעברה לזיכרון הפלאש
החזרות
boolean ‫true אם המערכת הופעלה, false אם היא דולגה
הקפצת הודעות שגיאה (throw)
DeviceNotAvailableException אם המכשיר לא זמין
TargetSetupError אם ההעברה של תוכנת האתחול נכשלה

checkShouldFlashBaseband

protected boolean checkShouldFlashBaseband (ITestDevice device, 
                IDeviceBuildInfo deviceBuild)

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

פרמטרים
device ‫ITestDevice: ITestDevice לבדיקה
deviceBuild ‫IDeviceBuildInfo: IDeviceBuildInfo שמכיל את תמונת פס הבסיס לבדיקה
החזרות
boolean

הקפצת הודעות שגיאה (throw)
DeviceNotAvailableException אם המכשיר לא זמין
TargetSetupError אם ההפעלה של פס הבסיס נכשלה

createFlashingResourcesParser

protected IFlashingResourcesParser createFlashingResourcesParser (IDeviceBuildInfo localBuild, 
                DeviceDescriptor descriptor)

שיטת יצירה של IFlashingResourcesParser.

נחשף לבדיקות יחידה.

פרמטרים
localBuild ‫IDeviceBuildInfo: IDeviceBuildInfo לניתוח
descriptor ‫DeviceDescriptor: התיאור של המכשיר שמתבצעת בו פעולת ה-flash.
החזרות
IFlashingResourcesParser ‫IFlashingResourcesParser שנוצר על ידי שיטת factory.
הקפצת הודעות שגיאה (throw)
com.android.tradefed.targetprep.TargetSetupError
TargetSetupError

downloadExtraImageFiles

protected void downloadExtraImageFiles (IFlashingResourcesParser resourceParser, 
                IFlashingResourcesRetriever retriever, 
                IDeviceBuildInfo localBuild)

‫Hook שמאפשר למחלקות משנה להוריד קבצים נוספים של תמונות מותאמות אישית, אם צריך.

פרמטרים
resourceParser IFlashingResourcesParser: IFlashingResourcesParser
retriever IFlashingResourcesRetriever: IFlashingResourcesRetriever
localBuild IDeviceBuildInfo: IDeviceBuildInfo
הקפצת הודעות שגיאה (throw)
com.android.tradefed.targetprep.TargetSetupError
TargetSetupError

downloadFlashingResources

protected void downloadFlashingResources (ITestDevice device, 
                IDeviceBuildInfo localBuild)

הורדה של קבצים נוספים של תמונות להפעלה

פרמטרים
device ‫ITestDevice: ITestDevice להורדת משאבים
localBuild ‫IDeviceBuildInfo: IDeviceBuildInfo לאכלוס. ההנחה היא שקובץ תמונת המכשיר כבר הוגדר
הקפצת הודעות שגיאה (throw)
DeviceNotAvailableException אם המכשיר לא זמין
TargetSetupError אם אחזור המשאבים נכשל

executeFastbootCmd

protected String executeFastbootCmd (ITestDevice device, 
                String... cmdArgs)

שיטת עזר להרצת פקודת fastboot.

פרמטרים
device ‫ITestDevice: הפקודה ITestDevice להפעלה
cmdArgs ‫String: הארגומנטים שמעבירים ל-fastboot
החזרות
String מחרוזת הפלט של stderr מהפקודה אם היא לא ריקה. אחרת, הפקודה מחזירה את הפלט stdout Some fastboot commands are weird in that they dump output to stderr on success case
הקפצת הודעות שגיאה (throw)
DeviceNotAvailableException אם המכשיר לא זמין
TargetSetupError אם פקודת fastboot נכשלת

executeLongFastbootCmd

protected String executeLongFastbootCmd (ITestDevice device, 
                String... cmdArgs)

שיטת עזר להרצת פקודת fastboot ממושכת.

הערה: רוב פקודות fastboot מופעלות בדרך כלל במסגרת הזמן הקצוב שמוגדר על ידי ITestDevice.executeFastbootCommand(String...). עם זאת, כשמספר מכשירים מהבהבים בו-זמנית, פקודות fastboot יכולות להימשך הרבה יותר זמן מהרגיל.

פרמטרים
device ‫ITestDevice: הפקודה ITestDevice להפעלה
cmdArgs ‫String: הארגומנטים שמעבירים ל-fastboot
החזרות
String מחרוזת הפלט של stderr מהפקודה אם היא לא ריקה. אחרת, הפקודה מחזירה את הפלט stdout Some fastboot commands are weird in that they dump output to stderr on success case
הקפצת הודעות שגיאה (throw)
DeviceNotAvailableException אם המכשיר לא זמין
TargetSetupError אם פקודת fastboot נכשלת

executeLongFastbootCmd

protected String executeLongFastbootCmd (ITestDevice device, 
                Map<String, String> envVarMap, 
                String... cmdArgs)

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

הערה: רוב פקודות fastboot מופעלות בדרך כלל במסגרת הזמן הקצוב שמוגדר על ידי ITestDevice.executeFastbootCommand(String...). עם זאת, כשמספר מכשירים מהבהבים בו-זמנית, פקודות fastboot יכולות להימשך הרבה יותר זמן מהרגיל.

פרמטרים
device ‫ITestDevice: הפקודה ITestDevice להפעלה
envVarMap ‫Map: המפה שכוללת את משתני הסביבה שצריך להגדיר לפני שמריצים את פקודת fastboot
cmdArgs ‫String: הארגומנטים שמעבירים ל-fastboot
החזרות
String מחרוזת הפלט של stderr מהפקודה אם היא לא ריקה. אחרת, הפקודה מחזירה את הפלט stdout Some fastboot commands are weird in that they dump output to stderr on success case
הקפצת הודעות שגיאה (throw)
DeviceNotAvailableException אם המכשיר לא זמין
TargetSetupError אם פקודת fastboot נכשלת

flashBaseband

protected void flashBaseband (ITestDevice device, 
                File basebandImageFile)

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

פרמטרים
device ITestDevice: ITestDevice לצריבת ROM‏ (flash)
basebandImageFile ‫File: תמונת פס הבסיס File
הקפצת הודעות שגיאה (throw)
DeviceNotAvailableException אם המכשיר לא זמין
TargetSetupError אם ההפעלה של פס הבסיס נכשלה

flashBootloader

protected void flashBootloader (ITestDevice device, 
                File bootloaderImageFile, 
                boolean requireReboot)

מבצעת פלאשינג של תמונת תוכנת האתחול שצוינה.

פרמטרים
device ITestDevice: ITestDevice לצריבת ROM‏ (flash)
bootloaderImageFile ‫File: תמונת טוען האתחול File
requireReboot boolean: האם להפעיל מחדש אחרי ההתקנה
הקפצת הודעות שגיאה (throw)
DeviceNotAvailableException אם המכשיר לא זמין
TargetSetupError אם ההבהוב נכשל

flashBootloader

protected void flashBootloader (ITestDevice device, 
                File bootloaderImageFile)

מבצעת פלאשינג של תמונת תוכנת האתחול שצוינה ומפעילה מחדש את המכשיר במצב bootloader

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

flashExtraImages

protected void flashExtraImages (ITestDevice device, 
                IDeviceBuildInfo deviceBuild)

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

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

flashPartition

protected void flashPartition (ITestDevice device, 
                File imgFile, 
                String partition)

צריבת ROM של מחיצה ספציפית במכשיר

פרמטרים
device ITestDevice: ITestDevice לצריבת ROM‏ (flash)
imgFile ‫File: File שמצביע על התמונה שצריך להבזיק
partition ‫String: השם של המחיצה שרוצים להעביר אליה את התוכן
הקפצת הודעות שגיאה (throw)
DeviceNotAvailableException
TargetSetupError

flashRamdiskIfNeeded

protected void flashRamdiskIfNeeded (ITestDevice device, 
                IDeviceBuildInfo deviceBuild)

פרמטרים
device ITestDevice

deviceBuild IDeviceBuildInfo

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

flashSystem

protected void flashSystem (ITestDevice device, 
                IDeviceBuildInfo deviceBuild)

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

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

flashTrusty

protected void flashTrusty (ITestDevice device, 
                File trustyImageFile)

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

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

flashUserData

protected void flashUserData (ITestDevice device, 
                IDeviceBuildInfo deviceBuild)

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

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

flashUserDataFromDeviceImageFile

protected void flashUserDataFromDeviceImageFile (ITestDevice device, 
                IDeviceBuildInfo deviceBuild)

מחולץ userdata.img מקובץ אימג' של המכשיר ומועבר למכשיר

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

getBootPartitionName

protected String getBootPartitionName ()

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

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

החזרות
String

getBootloaderFilePrefix

protected String getBootloaderFilePrefix (ITestDevice device)

מקבלים את הקידומת של קובץ תוכנת האתחול.

ברירת המחדל היא getBootPartitionName(). במקרה הצורך, מחלקות משנה יכולות לבטל את ההגדרה הזו.

פרמטרים
device ITestDevice: ITestDevice לצריבת ROM‏ (flash)
החזרות
String

הקפצת הודעות שגיאה (throw)
DeviceNotAvailableException אם המכשיר לא זמין
TargetSetupError if failed to get prefix

getCurrentSlot

protected String getCurrentSlot (ITestDevice device)

שיטת עזר לאחזור המשבצת הנוכחית (למכשירים עם יכולת בדיקת A/B).

פרמטרים
device ‫ITestDevice: הפקודה ITestDevice להפעלה.
החזרות
String ‫a,‏ b או null (אם המכשיר לא תומך במחיצות A/B)
הקפצת הודעות שגיאה (throw)
com.android.tradefed.device.DeviceNotAvailableException
com.android.tradefed.targetprep.TargetSetupError
DeviceNotAvailableException
TargetSetupError

getFlashingResourcesRetriever

protected IFlashingResourcesRetriever getFlashingResourcesRetriever ()

החזרות
IFlashingResourcesRetriever

getFuseUtil

protected FuseUtil getFuseUtil ()

החזרות
FuseUtil

getImageVersion

protected String getImageVersion (ITestDevice device, 
                String imageName)

פרמטרים
device ITestDevice

imageName String

החזרות
String

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

getRunUtil

protected IRunUtil getRunUtil ()

חשוף לבדיקה.

החזרות
IRunUtil

handleUserDataFlashing

protected void handleUserDataFlashing (ITestDevice device, 
                IDeviceBuildInfo deviceBuild)

טיפול בהבזקים של מחיצת נתוני המשתמשים או המטמון

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

hasPartition

protected boolean hasPartition (ITestDevice device, 
                String partition)

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

פרמטרים
device ‫ITestDevice: ITestDevice שעליו רוצים לבצע את הפעולה
partition ‫String: השם של המחיצה שרוצים לבדוק
החזרות
boolean

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

preFlashSetup

protected void preFlashSetup (ITestDevice device, 
                IDeviceBuildInfo deviceBuild)

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

פרמטרים
device ITestDevice: ITestDevice שרוצים להכין
deviceBuild ‫IDeviceBuildInfo: התיקייה IDeviceBuildInfo שמכילה את קובצי ה-build
הקפצת הודעות שגיאה (throw)
com.android.tradefed.device.DeviceNotAvailableException
com.android.tradefed.targetprep.TargetSetupError
DeviceNotAvailableException
TargetSetupError

setCheckBasebandVersionAfterFlash

protected void setCheckBasebandVersionAfterFlash (boolean checkBasebandVersionAfterFlash)

פרמטרים
checkBasebandVersionAfterFlash boolean

setSkipBasebandVersionCheck

protected void setSkipBasebandVersionCheck (boolean skipBasebandVersionCheck)

פרמטרים
skipBasebandVersionCheck boolean

setSkipBootloaderVersionCheck

protected void setSkipBootloaderVersionCheck (boolean skipBootloaderVersionCheck)

פרמטרים
skipBootloaderVersionCheck boolean

setSkipFastbootFailedMessage

protected void setSkipFastbootFailedMessage (boolean skipFastbootFailedMessage)

פרמטרים
skipFastbootFailedMessage boolean

setSystemBuildInfo

protected void setSystemBuildInfo (String systemBuildId, 
                String systemBuildFlavor)

פרמטרים
systemBuildId String

systemBuildFlavor String

verifyRequiredBoards

protected void verifyRequiredBoards (ITestDevice device, 
                IFlashingResourcesParser resourceParser, 
                String deviceProductType)

מוודאים שסוג המוצר של המכשיר תומך בגרסה שרוצים להתקין.

ההטמעה הבסיסית תאמת שמזהה המוצר של המכשיר נכלל באוסף IFlashingResourcesParser.getRequiredBoards(). מחלקות משנה יכולות לבצע שינוי לפי הצורך.

פרמטרים
device ‫ITestDevice: ה-ITestDevice שיוצג
resourceParser IFlashingResourcesParser: IFlashingResourcesParser
deviceProductType ‫String: סוג המוצר של device
הקפצת הודעות שגיאה (throw)
TargetSetupError אם פרטי הלוח הנדרשים של הגרסה לא תאמו למכשיר

wipeCache

protected void wipeCache (ITestDevice device)

מחיקת מחיצת המטמון במכשיר.

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

wipePartition

protected void wipePartition (ITestDevice device, 
                String partition)

מחיקת המחיצה שצוינה באמצעות הפקודה `fastboot erase <name>`

פרמטרים
device ‫ITestDevice: ITestDevice שעליו רוצים לבצע את הפעולה
partition ‫String: השם של המחיצה שרוצים למחוק
הקפצת הודעות שגיאה (throw)
DeviceNotAvailableException
TargetSetupError