החל משנת 2026, כדי להתאים את התהליך למודל הפיתוח היציב שלנו ולשמור על יציבות הפלטפורמה בסביבה העסקית, נפרסם קוד מקור ב-AOSP ברבעון השני וברבעון הרביעי. כדי ליצור תוספים ל-AOSP ולתרום לו, מומלץ להשתמש ב-android-latest-release במקום ב-aosp-main. ענף המניפסט android-latest-release תמיד יפנה לגרסה העדכנית ביותר שנדחפה ל-AOSP. מידע נוסף זמין במאמר שינויים ב-AOSP.

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)` הגרסה מועברת למכשיר.
`CommandStatus`	`getSystemFlashingStatus()` אחזור סטטוס הביצוע של הפקודה עבור מחיצות ראשיות של המערכת שמוצגות בהבזקים.
`IDeviceFlasher.UserDataFlashOption`	`getUserDataFlashOption()` קבלת מידע על הפעולה שצריך לבצע בתמונת המצב של נתוני המשתמש: מחיקה, שמירה או העברה לזיכרון הבזק
`void`	`overrideDeviceOptions(ITestDevice device)` שינוי האפשרויות למכשיר.
`void`	`preFlashOperations(ITestDevice device, IDeviceBuildInfo deviceBuild)` כל פעולות ההגדרה והבדיקות שצריך לבצע לפני ההפעלה בפועל של החלק הקריטי.
`void`	`setDataWipeSkipList( dataWipeSkipList)` המדיניות הזו מגדירה את רשימת הנתיבים ב-`/data` שלא יימחקו כשמשתמשים ב-`ITestsZipInstaller`. שימו לב: הרשימה של הפריטים שדילגתם עליהם כוללת רק את הצאצאים הישירים של `/data`.
`void`	`setFlashOptions( 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`	`shouldFlashRamdisk()` בודק אם כלי ההעברה מוגדר להעברה של ramdisk נוסף אחרי עדכון המכשיר באמצעות קובץ zip של תמונה
`boolean`	`shouldSkipBootloaderVersionCheck()`
`static boolean`	`stderrContainsFailed(String stderr, boolean skipBootloaderVersionCheck)`
`static boolean`	`stderrContainsFailed(String stderr, boolean skipBootloaderVersionCheck, boolean skipFastbootFailedMessage)`

שיטות מוגנות
`void`	`checkAndFlashBaseband(ITestDevice device, IDeviceBuildInfo deviceBuild)` במידת הצורך, צורבים ROM של קובץ אימג של פס בסיס במכשיר.
`boolean`	`checkAndFlashBootloader(ITestDevice device, IDeviceBuildInfo deviceBuild)` במידת הצורך, צורבים את תמונת תוכנת האתחול במכשיר.
`boolean`	`checkAndFlashSystem(ITestDevice device, String systemBuildId, String systemBuildFlavor, IDeviceBuildInfo deviceBuild)` במקרה הצורך, צורבים את קובץ האימג' של המערכת במכשיר.
`boolean`	`checkShouldFlashBaseband(ITestDevice device, IDeviceBuildInfo deviceBuild)` בודקים אם צריך להפעיל פלאש ב-baseband במכשיר שסופק.
`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, envVarMap, String... cmdArgs)` שיטת עזר להפעלת פקודת fastboot ארוכה עם משתני סביבה.
`void`	`flashBaseband(ITestDevice device, File basebandImageFile)` מבצעת פלאש לתמונת פס הבסיס שצוינה ומפעילה מחדש את המכשיר במצב bootloader
`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`	`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`	`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 מהפקודה

זריקות
`DeviceNotAvailableException`	אם המכשיר לא זמין
`TargetSetupError`	אם פקודת fastboot נכשלת או שלא ניתן לקבוע את הגרסה

Flash

public void flash (ITestDevice device, 
                IDeviceBuildInfo deviceBuild)

הגרסה מועברת למכשיר.

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

פרמטרים
`device`	`ITestDevice`: `ITestDevice` יהבהב
`deviceBuild`	`IDeviceBuildInfo`: `IDeviceBuildInfo` יהבהב

זריקות
`DeviceNotAvailableException`
`TargetSetupError`

getSystemFlashingStatus

public CommandStatus getSystemFlashingStatus ()

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

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

החזרות
`CommandStatus`

getUserDataFlashOption

public IDeviceFlasher.UserDataFlashOption getUserDataFlashOption ()

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

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

overrideDeviceOptions

public void overrideDeviceOptions (ITestDevice device)

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

preFlashOperations

public void preFlashOperations (ITestDevice device, 
                IDeviceBuildInfo deviceBuild)

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

פרמטרים
`device`	`ITestDevice`: `ITestDevice` יהבהב
`deviceBuild`	`IDeviceBuildInfo`: `IDeviceBuildInfo` יהבהב

זריקות
`DeviceNotAvailableException`
`TargetSetupError`

setDataWipeSkipList

public void setDataWipeSkipList ( dataWipeSkipList)

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

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

פרמטרים
`dataWipeSkipList`

setFlashOptions

public void setFlashOptions ( 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`

shouldFlashRamdisk

public boolean shouldFlashRamdisk ()

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

החזרות
`boolean`

shouldSkipBootloaderVersionCheck

public boolean shouldSkipBootloaderVersionCheck ()

החזרות
`boolean`

stderrContainsFailed

public static boolean stderrContainsFailed (String stderr, 
                boolean skipBootloaderVersionCheck)

פרמטרים
`stderr`	`String`
`skipBootloaderVersionCheck`	`boolean`

החזרות
`boolean`

stderrContainsFailed

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

פרמטרים
`stderr`	`String`
`skipBootloaderVersionCheck`	`boolean`
`skipFastbootFailedMessage`	`boolean`

החזרות
`boolean`

שיטות מוגנות

checkAndFlashBaseband

protected void checkAndFlashBaseband (ITestDevice device, 
                IDeviceBuildInfo deviceBuild)

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

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

זריקות
`DeviceNotAvailableException`	אם המכשיר לא זמין
`TargetSetupError`	אם ההפעלה של פס הבסיס נכשלה

checkAndFlashBootloader

protected boolean checkAndFlashBootloader (ITestDevice device, 
                IDeviceBuildInfo deviceBuild)

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

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

פרמטרים
`device`	`ITestDevice`: `ITestDevice` יהבהב
`deviceBuild`	‫`IDeviceBuildInfo`: ה-`IDeviceBuildInfo` שמכיל את תמונת הטוען (bootloader) להעברה לזיכרון הפלאש

החזרות
`boolean`	‫`true` אם בוצע פלאשינג של תוכנת האתחול, `false` אם הוא דולג

זריקות
`DeviceNotAvailableException`	אם המכשיר לא זמין
`TargetSetupError`	אם ההעברה של תוכנת האתחול נכשלה

checkAndFlashSystem

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

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

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

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

פרמטרים
`device`	`ITestDevice`: `ITestDevice` יהבהב
`systemBuildId`	‫`String`: מזהה הגרסה הנוכחית שפועלת במכשיר
`systemBuildFlavor`	‫`String`: הטעם הנוכחי של הגרסה שפועלת במכשיר
`deviceBuild`	‫`IDeviceBuildInfo`: `IDeviceBuildInfo` שמכיל את תמונת המערכת להעברה לזיכרון הפלאש

החזרות
`boolean`	‫`true` אם המערכת הופעלה, `false` אם היא דולגה

זריקות
`DeviceNotAvailableException`	אם המכשיר לא זמין
`TargetSetupError`	אם ההעברה של תוכנת האתחול נכשלה

checkShouldFlashBaseband

protected boolean checkShouldFlashBaseband (ITestDevice device, 
                IDeviceBuildInfo deviceBuild)

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

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

החזרות
`boolean`

זריקות
`DeviceNotAvailableException`	אם המכשיר לא זמין
`TargetSetupError`	אם ההפעלה של פס הבסיס נכשלה

createFlashingResourcesParser

protected IFlashingResourcesParser createFlashingResourcesParser (IDeviceBuildInfo localBuild, 
                DeviceDescriptor descriptor)

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

החשיפה היא לצורך בדיקות יחידה.

פרמטרים
`localBuild`	‫`IDeviceBuildInfo`: `IDeviceBuildInfo` לניתוח
`descriptor`	‫`DeviceDescriptor`: תיאור המכשיר שמתבצעת בו פעולת ה-flash.

החזרות
`IFlashingResourcesParser`	‫`IFlashingResourcesParser` שנוצר על ידי שיטת factory.

זריקות
	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`

זריקות
	com.android.tradefed.targetprep.TargetSetupError
`TargetSetupError`

downloadFlashingResources

protected void downloadFlashingResources (ITestDevice device, 
                IDeviceBuildInfo localBuild)

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

פרמטרים
`device`	‫`ITestDevice`: `ITestDevice` להורדת משאבים
`localBuild`	‫`IDeviceBuildInfo`: `IDeviceBuildInfo` שצריך למלא. ההנחה היא שקובץ תמונת המכשיר כבר מוגדר

זריקות
`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

זריקות
`DeviceNotAvailableException`	אם המכשיר לא זמין
`TargetSetupError`	אם פקודת fastboot נכשלת

executeLongFastbootCmd

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

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

הערה: רוב פקודות fastboot מופעלות בדרך כלל במסגרת הזמן הקצוב שמוגדר על ידי INativeDevice.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

זריקות
`DeviceNotAvailableException`	אם המכשיר לא זמין
`TargetSetupError`	אם פקודת fastboot נכשלת

executeLongFastbootCmd

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

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

פרמטרים
`device`	‫`ITestDevice`: הפקודה `ITestDevice` להפעלה
`envVarMap`	‫: המפה שכוללת את משתני הסביבה שצריך להגדיר לפני שמריצים את הפקודה fastboot
`cmdArgs`	‫`String`: הארגומנטים שמעבירים ל-fastboot

החזרות
`String`	מחרוזת של פלט stderr מהפקודה אם היא לא ריקה. אחרת, הפקודה מחזירה את stdout Some fastboot commands are weird in that they dump output to stderr on success case

זריקות
`DeviceNotAvailableException`	אם המכשיר לא זמין
`TargetSetupError`	אם פקודת fastboot נכשלת

flashBaseband

protected void flashBaseband (ITestDevice device, 
                File basebandImageFile)

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

פרמטרים
`device`	`ITestDevice`: `ITestDevice` יהבהב
`basebandImageFile`	‫`File`: תמונת פס הבסיס `ERROR(/File)`

זריקות
`DeviceNotAvailableException`	אם המכשיר לא זמין
`TargetSetupError`	אם ההפעלה של פס הבסיס נכשלה

flashBootloader

protected void flashBootloader (ITestDevice device, 
                File bootloaderImageFile)

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

פרמטרים
`device`	`ITestDevice`: `ITestDevice` יהבהב
`bootloaderImageFile`	‫`File`: תמונת טוען האתחול `ERROR(/File)`

זריקות
`DeviceNotAvailableException`	אם המכשיר לא זמין
`TargetSetupError`	אם ההבהוב נכשל

flashExtraImages

protected void flashExtraImages (ITestDevice device, 
                IDeviceBuildInfo deviceBuild)

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

פרמטרים
`device`	`ITestDevice`: `ITestDevice` יהבהב
`deviceBuild`	‫`IDeviceBuildInfo`: התיקייה `IDeviceBuildInfo` שמכילה את קובצי ה-build

זריקות
	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` יהבהב
`imgFile`	‫`File`: `ERROR(/File)` שמצביע על התמונה שצריך להבזיק
`partition`	‫`String`: שם המחיצה שרוצים לצרוב

זריקות
`DeviceNotAvailableException`
`TargetSetupError`

flashRamdiskIfNeeded

protected void flashRamdiskIfNeeded (ITestDevice device, 
                IDeviceBuildInfo deviceBuild)

פרמטרים
`device`	`ITestDevice`
`deviceBuild`	`IDeviceBuildInfo`

זריקות
`DeviceNotAvailableException`
`TargetSetupError`

flashSystem

protected void flashSystem (ITestDevice device, 
                IDeviceBuildInfo deviceBuild)

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

פרמטרים
`device`	`ITestDevice`: `ITestDevice` יהבהב
`deviceBuild`	`IDeviceBuildInfo`: `IDeviceBuildInfo` יהבהב

זריקות
`DeviceNotAvailableException`	אם המכשיר לא זמין
`TargetSetupError`	אם פקודת fastboot נכשלת

flashUserData

protected void flashUserData (ITestDevice device, 
                IDeviceBuildInfo deviceBuild)

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

פרמטרים
`device`	`ITestDevice`: `ITestDevice` יהבהב
`deviceBuild`	‫`IDeviceBuildInfo`: `IDeviceBuildInfo` שמכיל את הקבצים להעברה לזיכרון הפלאש

זריקות
`DeviceNotAvailableException`	אם המכשיר לא זמין
`TargetSetupError`	אם לא הצלחתם להפעיל את נתוני המשתמשים

flashUserDataFromDeviceImageFile

protected void flashUserDataFromDeviceImageFile (ITestDevice device, 
                IDeviceBuildInfo deviceBuild)

מחולץ userdata.img מקובץ תמונת המכשיר ומועבר למכשיר

פרמטרים
`device`	`ITestDevice`: `ITestDevice` יהבהב
`deviceBuild`	‫`IDeviceBuildInfo`: `IDeviceBuildInfo` שמכיל את הקבצים להעברה לזיכרון הפלאש

זריקות
`DeviceNotAvailableException`	אם המכשיר לא זמין
`TargetSetupError`	אם לא הצלחתם לחלץ או להעביר את נתוני המשתמש

getBootPartitionName

protected String getBootPartitionName ()

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

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

החזרות
`String`

getBootloaderFilePrefix

protected String getBootloaderFilePrefix (ITestDevice device)

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

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

פרמטרים
`device`	`ITestDevice`: `ITestDevice` יהבהב

החזרות
`String`

זריקות
`DeviceNotAvailableException`	אם המכשיר לא זמין
`TargetSetupError`	if failed to get prefix

getCurrentSlot

protected String getCurrentSlot (ITestDevice device)

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

פרמטרים
`device`	‫`ITestDevice`: הפקודה `ITestDevice` להפעלה.

החזרות
`String`	‫a,‏ b או null (אם המכשיר לא תומך במחיצות A/B)

זריקות
	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`

זריקות
`DeviceNotAvailableException`
`TargetSetupError`

getRunUtil

protected IRunUtil getRunUtil ()

החשיפה היא לצורך בדיקה.

החזרות
`IRunUtil`

handleUserDataFlashing

protected void handleUserDataFlashing (ITestDevice device, 
                IDeviceBuildInfo deviceBuild)

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

פרמטרים
`device`	`ITestDevice`: `ITestDevice` יהבהב
`deviceBuild`	‫`IDeviceBuildInfo`: `IDeviceBuildInfo` שמכיל את הקבצים להעברה לזיכרון הפלאש

זריקות
	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`

זריקות
`DeviceNotAvailableException`

preFlashSetup

protected void preFlashSetup (ITestDevice device, 
                IDeviceBuildInfo deviceBuild)

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

פרמטרים
`device`	`ITestDevice`: `ITestDevice` שרוצים להכין
`deviceBuild`	‫`IDeviceBuildInfo`: התיקייה `IDeviceBuildInfo` שמכילה את קובצי ה-build

זריקות
	com.android.tradefed.device.DeviceNotAvailableException
	com.android.tradefed.targetprep.TargetSetupError
`DeviceNotAvailableException`
`TargetSetupError`

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)

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

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

פרמטרים
`device`	‫`ITestDevice`: `ITestDevice` שיוצג
`resourceParser`	‫`IFlashingResourcesParser`: `IFlashingResourcesParser`
`deviceProductType`	‫`String`: סוג המוצר של `device`

זריקות
`TargetSetupError`	אם פרטי הלוח הנדרשים של הגרסה לא תאמו למכשיר

wipeCache

protected void wipeCache (ITestDevice device)

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

פרמטרים
`device`	`ITestDevice`: `ITestDevice` יהבהב

זריקות
`DeviceNotAvailableException`	אם המכשיר לא זמין
`TargetSetupError`	אם לא הצלחתם לנקות את המטמון

wipePartition

protected void wipePartition (ITestDevice device, 
                String partition)

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

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

זריקות
`DeviceNotAvailableException`
`TargetSetupError`