تحديثات نظام A/B

تتّبع المركبات المعرَّفة بالبرامج (SDV) أسلوب Android العادي لتحديثات النظام (السلسة) من النوع أ/ب. تنطبق مستندات مشروع Android المفتوح المصدر (AOSP) بشكل أساسي على المركبات المعرَّفة بالبرامج (SDV). توضّح هذه الصفحة تفاصيل الاستخدام الخاصة بمركبات SDV والمسارات الجيدة المعروفة لإنشاء حِزم التحديث وتطبيقها.

تم ضبط SDV لاستخدام تحديثات A/B غير الافتراضية. لضبط تحديثات نظام التشغيل A/B وتشغيلها لقسم /oem_ab مخصّص من حزمة خدمات، يُرجى الاطّلاع على تحديثات قسم AB من المصنّع الأصلي للجهاز.

تنفيذ طبقة تجريد الأجهزة (HAL) للتحكّم في التشغيل

توفّر صورة SDV Core لجهاز Cuttlefish (sdv_core_cf) طريقة عادية لتنفيذ HAL للتحكّم في التشغيل استنادًا إلى hardware/interfaces/boot/aidl/default/. ويجب أن تنفّذ برامج الإقلاع الأخرى طبقة HAL لإتاحة تحديثات A/B.

يُرجى الرجوع إلى قسم تنفيذ طبقة تجريد الأجهزة (HAL) للتحكّم في التشغيل في مستندات مشروع Android المفتوح المصدر (AOSP) لمزيد من التفاصيل. يمكنك استخدام bootctl المضمّن في صور SDV لتصحيح الأخطاء (eng وuserdebug) لاختبار عملية التنفيذ.

إنشاء حزمة OTA

لمزيد من المعلومات، يُرجى الاطّلاع على مقالة إنشاء حِزم OTA. تتبع التعليمات الواردة في هذه الصفحة مستندات AOSP مع بعض الاختلافات الطفيفة.

تحديث كامل

من جذر المستودع:

source build/envsetup.sh && lunch sdv_core_cf-aosp_current-userdebug
mkdir dist_output
m dist DIST_DIR=dist_output

تنشئ هذه الأوامر ملفات مستهدَفة في دليل dist_output. بالنسبة إلى الإصدارات المحلية من sdv_core_cf، يكون هذا عادةً sdv_core_cf-target_files-$USER.zip.

لإنشاء حزمة OTA، عليك استخدام ota_from_target_files. وعلى عكس AOSP، لا يتم إنشاء الحزمة كجزء من m dist.

m ota_from_target_files
ota_from_target_files \
  dist_output/sdv_core_cf-target_files-$USER.zip \
  ota_update.zip

تحديث تزايدي

استدعاء ota_from_target_files نفسه كما في مشروع Android المفتوح المصدر (AOSP):

ota_from_target_files \
  -i PREVIOUS-sdv_core_cf-target_files.zip \
  dist_new/sdv_core_cf-target_files-$USER.zip \
  incremental_ota_update.zip

تثبيت حزمة OTA

يتم تثبيت التحديثات باستخدام خدمة update_engine. تتضمّن إصدارات تصحيح أخطاء SDV update_engine_client الذي يمكن استخدامه لتصحيح الأخطاء واختبار عملية التحديث.

لتثبيت حزمة OTA، نفِّذ ما يلي:

system/update_engine/scripts/update_device.py ota_update.zip

إذا تم تثبيت التحديث بشكل صحيح (الحالة النهائية هي UPDATE_STATUS_UPDATED_NEED_REBOOT والنتيجة هي ErrorCode::kSuccess)، سيتم تفعيل التحديث عند إعادة التشغيل التالية.

تحديد الإصدار

بالنسبة إلى تحديثات النظام، تستخدم SDV البيانات الوصفية لحزمة OTA في Android لتحديد ما إذا كانت حزمة OTA تستوفي المتطلبات ويمكن تثبيتها.

بالنسبة إلى APEX أيضًا، تتّبع SDV مفاهيم Android في ما يتعلّق بإمكانية التحديث. لذلك، يمكن تحديث ملف APEX عندما لا يكون ملف APEX bootstrap. يجب تحديث Bootstrap APEX من خلال تحديثات النظام، وإما:

  • إذا كان الإصدار المُعلَن عنه أعلى من الإصدار المُثبَّت مسبقًا، وكلاهما أكبر من أو يساوي 1

أو

  • الإصدار المُعلَن عنه هو APEX غير مثبَّت مسبقًا، وهو أحدث من الإصدار المُدرَج في القائمة المحظورة، في حال توفّره.

يتم عادةً نشر SDV على أنظمة متعددة في شبكة. لذلك، يجب التأكّد من تنفيذ التعديلات التي تم إجراؤها على نظام واحد بشكل صحيح. ومع ذلك، لا تضمن هذه الرعاية أنّ جميع الأنظمة يمكنها التواصل بشكل صحيح.

من المهم أيضًا تحديث الشبكة بشكل عام، ما يتطلب نشر تحديثات حِزم الخدمات على جميع الأجهزة في الوقت نفسه أو أن تكون التحديثات خالية من أي تغييرات قد تؤدي إلى عطل. على سبيل المثال، التغييرات غير المتوافقة على الواجهة.

على الرغم من أنّ SDV لا توفّر أدوات لرصد التغييرات غير المتوافقة، توضّح إرشاداتنا كيفية تسوية التغييرات التي تم إجراؤها على الواجهات بالإضافة إلى أفضل الممارسات اللازمة لتطبيق التغييرات.

بالإضافة إلى ذلك، تتيح SDV آليات العودة إلى الإصدارات السابقة من تحديثات النظام وAPEX. إذا دخل النظام عن غير قصد في حالة غير مرضية، فيمكننا استعادة آخر حالة مرضية معروفة.