FlashingResourcesParser

public class FlashingResourcesParser
extends Object implements IFlashingResourcesParser

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

---

מחלקה שמנתחת את הגרסאות הנדרשות של קבצי תמונות עזר שנדרשים לצריבת ROM‏ (flash) של מכשיר. (למשל, תוכנת אתחול, פס בסיס וכו')

סיכום

כיתות מוטמעות
class	FlashingResourcesParser.AndroidInfo הגדרה של typedef ל-Map<String, MultiMap<String, String>>.
interface	FlashingResourcesParser.Constraint ממשק סינון, שמיועד לאפשר ל-FlashingResourcesParser להתעלם מחלק מהמשאבים שאחרת הוא עשוי להשתמש בהם

ערכים קבועים
String	BASEBAND_VERSION_KEY
String	BOARD_KEY
String	BOOTLOADER_VERSION_KEY
String	PRODUCT_KEY
String	TRUSTY_VERSION_KEY

‫constructors ציבוריים
FlashingResourcesParser(BufferedReader infoReader) יוצר FlashingResourcesParser עם קורא AndroidInfo שסופק נחשף לבדיקות יחידה
FlashingResourcesParser(BufferedReader infoReader, Map<String, FlashingResourcesParser.Constraint> c) יוצר FlashingResourcesParser עם קורא AndroidInfo שסופק נחשף לבדיקות יחידה
FlashingResourcesParser(File deviceImgZipFile) יוצרים FlashingResourcesParser ומנתחים את קובץ האימג' של המכשיר שצוין כדי לזהות דרישות להפעלה.
FlashingResourcesParser(File deviceImgZipFile, Map<String, FlashingResourcesParser.Constraint> c) יוצרים FlashingResourcesParser ומנתחים את קובץ האימג' של המכשיר שצוין כדי לזהות דרישות להפעלה.

‫methods ציבוריים
String	getRequiredBasebandVersion() מקבל את גרסת פס הבסיס הנדרשת שצוינה בקובץ ה-ZIP של תמונת המכשיר. אם מופיעות כמה גרסאות, צריך לבחור את הגרסה העדכנית ביותר, בהנחה שהגרסאות ממוינות מהישנה לחדשה לפי סדר אלפביתי.
Collection<String>	getRequiredBoards() מקבל את סוגי הלוחות הנדרשים שצוינו בקובץ ה-ZIP של תמונת המכשיר.
String	getRequiredBootloaderVersion() מקבל את גרסת ה-bootloader הנדרשת שצוינה בקובץ ה-ZIP של תמונת המכשיר. אם מופיעות כמה גרסאות, צריך לבחור את הגרסה העדכנית ביותר, בהנחה שהגרסאות ממוינות מהישנה לחדשה לפי סדר אלפביתי.
String	getRequiredImageVersion(String imageVersionKey) מקבל את הגרסה הנדרשת של התמונה המותאמת אישית שצוינה בקובץ ה-ZIP של תמונת המכשיר אם מופיעות כמה גרסאות, צריך לבחור את הגרסה העדכנית ביותר, בהנחה שהגרסאות ממוינות מהישנה לחדשה לפי סדר אלפביתי.
String	getRequiredImageVersion(String imageVersionKey, String productName) מקבל את הגרסה הנדרשת של התמונה המותאמת אישית שצוינה בקובץ ה-ZIP של תמונת המכשיר. אם מופיעות כמה גרסאות, צריך לבחור את הגרסה העדכנית ביותר, בהנחה שהגרסאות ממוינות מהישנה לחדשה לפי סדר אלפביתי.
String	getRequiredTrustyVersion() מקבל את הגרסה הנדרשת של trusty שצוינה בקובץ ה-ZIP של תמונת המכשיר. אם מופיעות כמה גרסאות, צריך לבחור את הגרסה העדכנית ביותר, בהנחה שהגרסאות ממוינות מהישנה לחדשה לפי סדר אלפביתי.

ערכים קבועים

BASEBAND_VERSION_KEY

public static final String BASEBAND_VERSION_KEY

ערך קבוע: "version-baseband"

BOARD_KEY

public static final String BOARD_KEY

ערך קבוע: "board"

BOOTLOADER_VERSION_KEY

public static final String BOOTLOADER_VERSION_KEY

ערך קבוע: "version-bootloader"

PRODUCT_KEY

public static final String PRODUCT_KEY

ערך קבוע: "product"

TRUSTY_VERSION_KEY

public static final String TRUSTY_VERSION_KEY

ערך קבוע: "version-trusty"

‫constructors ציבוריים

FlashingResourcesParser

public FlashingResourcesParser (BufferedReader infoReader)

יוצר FlashingResourcesParser עם קורא AndroidInfo שסופק

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

פרמטרים
infoReader	‫BufferedReader: BufferedReader שמכיל את המקבילה של android-info.txt לניתוח

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

FlashingResourcesParser

public FlashingResourcesParser (BufferedReader infoReader, 
                Map<String, FlashingResourcesParser.Constraint> c)

יוצר FlashingResourcesParser עם קורא AndroidInfo שסופק

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

פרמטרים
infoReader	‫BufferedReader: BufferedReader שמכיל את המקבילה של android-info.txt לניתוח
c	‫Map: מיפוי משם המפתח אל Constraint. שמות התמונות ייבדקו מול האילוץ המתאים (אם יש כזה) כתנאי מוקדם להוספה. יכול להיות שערך ה-null יושבת כדי להשבית את הסינון.

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

FlashingResourcesParser

public FlashingResourcesParser (File deviceImgZipFile)

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

פרמטרים
deviceImgZipFile	‫File: קובץ updater.zip שיועבר למכשיר

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

FlashingResourcesParser

public FlashingResourcesParser (File deviceImgZipFile, 
                Map<String, FlashingResourcesParser.Constraint> c)

יוצרים FlashingResourcesParser ומנתחים את קובץ האימג' של המכשיר שצוין כדי לזהות דרישות להפעלה. לפני שמוסיפים דרישות להבהוב, צריך לוודא שהן עומדות במגבלה המתאימה (אם קיימת). המערכת תתעלם מדרישות שנדחו.

פרמטרים
deviceImgZipFile	‫File: קובץ updater.zip שיועבר למכשיר
c	‫Map: מיפוי משם המפתח אל Constraint. שמות התמונות ייבדקו מול האילוץ המתאים (אם יש כזה) כתנאי מוקדם להוספה. יכול להיות שערך ה-null יושבת כדי להשבית את הסינון.

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

‫methods ציבוריים

getRequiredBasebandVersion

public String getRequiredBasebandVersion ()

מקבל את גרסת פס הבסיס הנדרשת שצוינה בקובץ ה-ZIP של תמונת המכשיר.

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

החזרות
String	גירסת פס הבסיס או null אם לא צוין

getRequiredBoards

public Collection<String> getRequiredBoards ()

מקבל את סוגי הלוחות הנדרשים שצוינו בקובץ ה-ZIP של תמונת המכשיר.

החזרות
Collection<String>	סוגי הלוחות או null אם לא מציינים ערך

getRequiredBootloaderVersion

public String getRequiredBootloaderVersion ()

מקבל את גרסת ה-bootloader הנדרשת שצוינה בקובץ ה-ZIP של תמונת המכשיר.

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

החזרות
String	גרסת תוכנת האתחול או null אם לא צוינה גרסה

getRequiredImageVersion

public String getRequiredImageVersion (String imageVersionKey)

מקבל את הגרסה הנדרשת של התמונה המותאמת אישית שצוינה בקובץ ה-ZIP של תמונת המכשיר

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

פרמטרים
imageVersionKey	‫String: המזהה הצפוי של פרטי הגרסה של התמונה

החזרות
String	הגרסה הנדרשת לתמונה נתונה או null אם לא צוינה גרסה

getRequiredImageVersion

public String getRequiredImageVersion (String imageVersionKey, 
                String productName)

מקבל את הגרסה הנדרשת של התמונה המותאמת אישית שצוינה בקובץ ה-ZIP של תמונת המכשיר. אם הערך של productName הוא לא null, השיטה הזו תבדוק אם יש דרישות לגבי תמונות שצוינו למוצר הספציפי הזה (ותחזיר את הדרישות אם הן קיימות). אם אין דרישה ספציפית למוצר, המערכת תחזיר את הדרישה הגלובלית, או null אם אין דרישה כלשהי למוצר הספציפי הזה.versionKey

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

פרמטרים
imageVersionKey	‫String: המזהה הצפוי של פרטי הגרסה של התמונה
productName	‫String: שם מוצר ספציפי לבדיקה

החזרות
String	הגרסה הנדרשת לתמונה נתונה או null אם לא צוינה גרסה

getRequiredTrustyVersion

public String getRequiredTrustyVersion ()

מקבל את הגרסה הנדרשת של trusty שצוינה בקובץ ה-ZIP של תמונת המכשיר.

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

החזרות
String	הגרסה המהימנה או null אם לא צוין