OtaUpdateDeviceFlasher

public class OtaUpdateDeviceFlasher
extends Object implements IDeviceFlasher

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

أداة لتثبيت البرامج على الأجهزة تشغّل البرنامج النصي system/update_engine/scripts/update_device.py مع حزمة OTA كاملة أو تدريجية لتحديث صورة الجهاز. لاستخدام أداة الفلاش هذه بشكل صحيح، يجب أن تتضمّن معلومات إصدار الجهاز إدخال ملف باسم update-device-script يشير إلى البرنامج النصي المذكور أعلاه.

ملخّص

الثوابت

String OTA_DOWNGRADE_PROP

String UPDATE_DEVICE_SCRIPT

String UPDATE_SUCCESS_OUTPUT

الحقول

protected static final String IN_ZIP_SCRIPT_PATH

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

OtaUpdateDeviceFlasher()

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

void flash(ITestDevice device, IDeviceBuildInfo deviceBuild)

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

CommandStatus getSystemFlashingStatus()

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

IDeviceFlasher.UserDataFlashOption getUserDataFlashOption()

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

void overrideDeviceOptions(ITestDevice device)

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

void preFlashOperations(ITestDevice device, IDeviceBuildInfo deviceBuild)

جميع عمليات الإعداد وعمليات التحقّق التي يجب إجراؤها قبل عرض القسم المهم.

void setDataWipeSkipList(Collection<String> dataWipeSkipList)

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

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

void setFlashingResourcesRetriever(IFlashingResourcesRetriever retriever)

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

void setForceSystemFlash(boolean forceSystemFlash)

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

void setUserDataFlashOption(IDeviceFlasher.UserDataFlashOption flashOption)

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

void setWipeTimeout(long timeout)

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

طُرق محمية

IRunUtil getRunUtil()

الثوابت

OTA_DOWNGRADE_PROP

protected static final String OTA_DOWNGRADE_PROP

Constant Value: "ro.ota.allow_downgrade"

UPDATE_DEVICE_SCRIPT

protected static final String UPDATE_DEVICE_SCRIPT

Constant Value: "update-device-script"

UPDATE_SUCCESS_OUTPUT

protected static final String UPDATE_SUCCESS_OUTPUT

القيمة الثابتة: "onPayloadApplicationComplete(ErrorCode::kSuccess (0)"

الحقول

IN_ZIP_SCRIPT_PATH

protected static final String IN_ZIP_SCRIPT_PATH

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

OtaUpdateDeviceFlasher

public OtaUpdateDeviceFlasher ()

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

الفلاش

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 (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)

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

setWipeTimeout

public void setWipeTimeout (long timeout)

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

المعلَمات
timeout long

طُرق محمية

getRunUtil

protected IRunUtil getRunUtil ()

المرتجعات
IRunUtil