SystemUpdaterDeviceFlasher

public class SystemUpdaterDeviceFlasher
extends Object implements IDeviceFlasher

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

IDeviceFlasher يعتمد على أداة تحديث النظام لتثبيت صورة نظام مضمّنة في حزمة تحديث عبر شبكة غير سلكية (OTA). على وجه الخصوص، لا يعتمد هذا التنفيذ على fastboot.

ملخّص

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

SystemUpdaterDeviceFlasher()

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

void flash(ITestDevice device, IDeviceBuildInfo deviceBuild)

يتم إنشاء حزم البرامج على الجهاز.

يفترض هذا التنفيذ أنّ ملف صورة الجهاز الذي تعرضه الدالة IDeviceBuildInfo.getDeviceImageFile() هو ملف مضغوط لتحديث عبر الأثير.

CommandStatus getSystemFlashingStatus()

استرداد حالة تنفيذ الأمر لتقسيمات النظام الأساسية الوامضة

IDeviceFlasher.UserDataFlashOption getUserDataFlashOption()

تحديد ما إذا كان يجب عرض صورة بيانات المستخدم أو محوها أو الاحتفاظ بها

void overrideDeviceOptions(ITestDevice device)

تجاوز الخيارات لجهاز معيّن

void setDataWipeSkipList(Collection<String> dataWipeSkipList)

تحدِّد هذه السياسة قائمة المسارات ضمن /data التي يجب تجنُّب محوها عند استخدام ITestsZipInstaller.

يُرجى العِلم أنّ مستوى تفصيل قائمة التخطّي هو العناصر الفرعية المباشرة للعنصر /data.

void setFlashingResourcesRetriever(IFlashingResourcesRetriever retriever)

تضبط هذه السمة الآلية التي يمكن من خلالها لبرنامج التحديث استرداد ملفات الموارد اللازمة لتحديث البرنامج.

void setForceSystemFlash(boolean forceSystemFlash)

تحديد ما إذا كان يجب دائمًا إعادة تثبيت النظام حتى إذا كان الإصدار الحالي قيد التشغيل

void setUserDataFlashOption(IDeviceFlasher.UserDataFlashOption flashOption)

تحديد ما إذا كان يجب عرض صورة بيانات المستخدم أو محوها أو الاحتفاظ بها

لا يتيح هذا التنفيذ سوى IDeviceFlasher.UserDataFlashOption.TESTS_ZIP وIDeviceFlasher.UserDataFlashOption.RETAIN كخيارات صالحة.

void setWipeTimeout(long timeout)

اضبط المهلة الزمنية لمحو البيانات.

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

SystemUpdaterDeviceFlasher

public SystemUpdaterDeviceFlasher ()

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

الفلاش

public void flash (ITestDevice device, 
                IDeviceBuildInfo deviceBuild)

يتم إنشاء حزم البرامج على الجهاز.

يتم إرجاع القيمة مباشرةً بعد اكتمال عملية التحديث. على المتصلين الانتظار إلى أن يصبح الجهاز متصلاً بالإنترنت ومتاحًا قبل المتابعة وإجراء الاختبار.

يفترض هذا التنفيذ أنّ ملف صورة الجهاز الذي تعرضه الدالة IDeviceBuildInfo.getDeviceImageFile() هو ملف مضغوط لتحديث عبر الأثير. ولا يُنصح باستخدام أداة التحديث هذه في سياق لا يكون فيه هذا التفسير صحيحًا.

المعلَمات
device ITestDevice: ITestDevice المطلوب عرضه بشكل متقطع
deviceBuild IDeviceBuildInfo: IDeviceBuildInfo المطلوب عرضه بشكل متقطع
عمليات الطرح
com.android.tradefed.device.DeviceNotAvailableException
com.android.tradefed.targetprep.TargetSetupError
DeviceNotAvailableException
TargetSetupError

getSystemFlashingStatus

public CommandStatus getSystemFlashingStatus ()

استرداد حالة تنفيذ الأمر لتقسيمات النظام الأساسية الوامضة

يُرجى العِلم أنّه في حال عدم نقل أقسام النظام (إذا كان النظام يتضمّن الإصدار المطلوب نقله)، قد تكون حالة الأمر null

المرتجعات
CommandStatus

getUserDataFlashOption

public IDeviceFlasher.UserDataFlashOption getUserDataFlashOption ()

تحديد ما إذا كان يجب عرض صورة بيانات المستخدم أو محوها أو الاحتفاظ بها

المرتجعات
IDeviceFlasher.UserDataFlashOption تحديد ما إذا كان يجب عرض صورة بيانات المستخدم أو محوها أو الاحتفاظ بها

overrideDeviceOptions

public void overrideDeviceOptions (ITestDevice device)

تجاوز الخيارات لجهاز معيّن تُستخدَم لإلغاء قيم الخيارات التلقائية إذا كانت القيم التلقائية غير متوافقة مع جهاز معيّن.

setDataWipeSkipList

public void setDataWipeSkipList (Collection<String> dataWipeSkipList)

تحدِّد هذه السياسة قائمة المسارات ضمن /data التي يجب تجنُّب محوها عند استخدام ITestsZipInstaller.

يُرجى العِلم أنّ مستوى تفصيل قائمة التخطّي هو العناصر الفرعية المباشرة للعنصر /data.

المعلَمات
dataWipeSkipList Collection

setFlashingResourcesRetriever

public void setFlashingResourcesRetriever (IFlashingResourcesRetriever retriever)

تحدّد هذه السمة الآلية التي يمكن من خلالها لبرنامج التحديث استرداد ملفات الموارد اللازمة لتحديث البرنامج.

المعلَمات
retriever IFlashingResourcesRetriever: IFlashingResourcesRetriever المطلوب استخدامه

setForceSystemFlash

public void setForceSystemFlash (boolean forceSystemFlash)

تحديد ما إذا كان يجب دائمًا إعادة تثبيت النظام حتى إذا كان الإصدار الحالي قيد التشغيل

setUserDataFlashOption

public void setUserDataFlashOption (IDeviceFlasher.UserDataFlashOption flashOption)

تحديد ما إذا كان يجب عرض صورة بيانات المستخدم أو محوها أو الاحتفاظ بها

لا يتيح هذا التنفيذ سوى IDeviceFlasher.UserDataFlashOption.TESTS_ZIP وIDeviceFlasher.UserDataFlashOption.RETAIN كخيارات صالحة.

setWipeTimeout

public void setWipeTimeout (long timeout)

اضبط المهلة الزمنية لمحو البيانات.

المعلَمات
timeout long