FastbootDeviceFlasher

public class FastbootDeviceFlasher
extends Object implements IDeviceFlasher

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

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

---

מחלקת 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