FlashingResourcesParser

public class FlashingResourcesParser
extends Object implements IFlashingResourcesParser

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

---

فئة تحلّل الإصدارات المطلوبة من ملفات الصور المساعدة اللازمة لتثبيت ذاكرة ROM على الجهاز (مثل برنامج الإقلاع والنطاق الأساسي وما إلى ذلك)

ملخّص

الصفوف المتداخلة
class	FlashingResourcesParser.AndroidInfo تعريف نوع 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

طُرق وضع التصميم العامة
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 واطلب منه تحليل صورة الجهاز المحدّدة بحثًا عن متطلبات التثبيت.

الإجراءات العامة
String	getRequiredBasebandVersion() تعرض هذه السمة إصدار النطاق الأساسي المطلوب والمحدّد في ملف zip الخاص بصورة الجهاز. إذا تم إدراج إصدارات متعددة، احصل على أحدث إصدار مع افتراض أنّ الإصدارات مرتبة أبجديًا من الأقدم إلى الأحدث.
Collection<String>	getRequiredBoards() يحصل على أنواع اللوحات المطلوبة المحدّدة في ملف zip الخاص بصورة الجهاز.
String	getRequiredBootloaderVersion() يحصل على إصدار برنامج الإقلاع المطلوب والمحدّد في ملف 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

Constant Value: "version-baseband"

BOARD_KEY

public static final String BOARD_KEY

القيمة الثابتة: "board"

BOOTLOADER_VERSION_KEY

public static final String BOOTLOADER_VERSION_KEY

Constant Value: "version-bootloader"

PRODUCT_KEY

public static final String PRODUCT_KEY

القيمة الثابتة: "product"

TRUSTY_VERSION_KEY

public static final String TRUSTY_VERSION_KEY

Constant Value: "version-trusty"

طُرق وضع التصميم العامة

FlashingResourcesParser

public FlashingResourcesParser (BufferedReader infoReader)

تنشئ هذه الدالة FlashingResourcesParser باستخدام أداة قراءة AndroidInfo المتوفّرة

متاحة لاختبار الوحدات

المعلَمات
infoReader	BufferedReader: BufferedReader يحتوي على ما يعادل ملف android-info.txt ليتم تحليله

عمليات الطرح
IOException

FlashingResourcesParser

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

تنشئ هذه الدالة FlashingResourcesParser باستخدام أداة قراءة AndroidInfo المتوفّرة

متاحة لاختبار الوحدات

المعلَمات
infoReader	BufferedReader: BufferedReader يحتوي على ما يعادل ملف android-info.txt ليتم تحليله
c	Map: خريطة من اسم المفتاح إلى Constraint سيتم التحقّق من أسماء الصور للتأكّد من استيفائها للقيود المناسبة (إن وُجدت) كشرط أساسي لإضافتها. يمكن أن تكون القيمة فارغة لإيقاف الفلترة.

عمليات الطرح
IOException

FlashingResourcesParser

public FlashingResourcesParser (File deviceImgZipFile)

أنشئ FlashingResourcesParser واطلب منه تحليل صورة الجهاز المحدّدة بحثًا عن متطلبات التثبيت.

المعلَمات
deviceImgZipFile	File: ملف updater.zip الذي سيتم تثبيته

عمليات الطرح
TargetSetupError

FlashingResourcesParser

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

أنشئ FlashingResourcesParser واطلب منه تحليل صورة الجهاز المحدّدة بحثًا عن متطلبات التثبيت. يجب أن تستوفي متطلبات التحديث السريع القيود المناسبة (إذا كان هناك قيد) قبل إضافتها. سيتم تجاهل المتطلبات المرفوضة بدون إشعار.

المعلَمات
deviceImgZipFile	File: ملف updater.zip الذي سيتم تثبيته
c	Map: خريطة من اسم المفتاح إلى Constraint سيتم التحقّق من أسماء الصور للتأكّد من استيفائها للشرط المناسب (إن وُجد) كشرط أساسي لإضافتها. يمكن أن تكون القيمة فارغة لإيقاف الفلترة.

عمليات الطرح
TargetSetupError

الإجراءات العامة

getRequiredBasebandVersion

public String getRequiredBasebandVersion ()

تعرض هذه السمة إصدار النطاق الأساسي المطلوب والمحدّد في ملف zip الخاص بصورة الجهاز.

إذا تم إدراج إصدارات متعددة، احصل على أحدث إصدار مع افتراض أنّ الإصدارات مرتبة أبجديًا من الأقدم إلى الأحدث.

المرتجعات
String	إصدار النطاق الأساسي أو null في حال عدم تحديده

getRequiredBoards

public Collection<String> getRequiredBoards ()

يحصل على أنواع اللوحات المطلوبة المحدّدة في ملف zip الخاص بصورة الجهاز.

المرتجعات
Collection<String>	أنواع اللوحات أو null في حال عدم تحديدها

getRequiredBootloaderVersion

public String getRequiredBootloaderVersion ()

يحصل على إصدار برنامج الإقلاع المطلوب والمحدّد في ملف 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	إصدار trusty أو null إذا لم يتم تحديده