التحديث عبر الهواء لأجهزة A/B بدون فواصل ديناميكية

يتيح نظام التشغيل Android 10 استخدام الأقسام الديناميكية، وهو نظام لقسمة مساحة المستخدمين يمكنه إنشاء الأقسام وتغيير حجمها ومحوها أثناء عمليات التحديث عبر الهواء.

توضّح هذه الصفحة كيفية تغيير عملاء OTA لحجم الأقسام الديناميكية أثناء تحديث أجهزة A/B التي تم إطلاقها بدون إتاحة الأقسام الديناميكية، وكيفية ترقية عملاء OTA إلى Android 10.

خلفية

أثناء تحديث جهاز A/B لتفعيل الأقسام الديناميكية، يتم الاحتفاظ بجدول تقسيم GUID (GPT) على الجهاز، وبالتالي لا يتوفّر قسم super على الجهاز. يتم تخزين البيانات الوصفية في system_a وsystem_b، ولكن يمكن تعديل ذلك من خلال تغيير BOARD_SUPER_PARTITION_METADATA_DEVICE.

في كل جهاز من أجهزة التخزين بالكتل، تتوفّر خانتان للبيانات الوصفية. لا يتم استخدام سوى واحدة فتحة بيانات وصفية في كل جهاز كتل. على سبيل المثال، تتوافق البيانات الوصفية 0 المتوفّرة في system_a والبيانات الوصفية 1 في system_b مع الأقسام في الخانتَين "أ" و"ب" على التوالي. في أثناء التشغيل، لا يهمّ أيّ خانة يتم تعديلها.

في هذه الصفحة، يُطلق على خانات البيانات الوصفية اسم البيانات الوصفية S (المصدر) والبيانات الوصفية T (الهدف). وبالمثل، تتم الإشارة إلى الأقسام باسم system_s وvendor_t وما إلى ذلك.

لمزيد من المعلومات عن إعدادات نظام الإنشاء، يُرجى الاطّلاع على مقالة ترقية الأجهزة.

لمزيد من المعلومات عن كيفية انتماء الأقسام إلى مجموعات التحديث، يُرجى الاطّلاع على تغييرات إعدادات اللوحة للأجهزة الجديدة.

في ما يلي مثال على البيانات الوصفية على الجهاز:

  • جهاز تخزين فعلي system_a
    • البيانات الوصفية 0
      • المجموعة foo_a
        • القسم المنطقي (الديناميكي) system_a
        • التقسيم المنطقي (الديناميكي) product_services_a
        • تم تحديث الأقسام الأخرى بواسطة Foo
      • المجموعة bar_a
        • القسم المنطقي (الديناميكي) vendor_a
        • قسم منطقي (ديناميكي) product_a
        • الأقسام الأخرى التي عدّلها Bar
    • البيانات الوصفية 1 (غير مستخدَمة)
  • جهاز التخزين المُجمَّع system_b
    • البيانات الوصفية 0 (غير مستخدَمة)
    • البيانات الوصفية 1
      • المجموعة foo_b
        • التقسيم المنطقي (الديناميكي) system_b
        • التقسيم المنطقي (الديناميكي) product_services_b
        • الأقسام الأخرى التي عدّلها فوزي
      • المجموعة bar_b
        • التقسيم المنطقي (الديناميكي) vendor_b
        • التقسيم المنطقي (الديناميكي) product_b
        • الأقسام الأخرى التي عدّلها Bar

يمكنك استخدام أداة lpdump ضمن system/extras/partition_tools لتفريغ البيانات الوصفية على جهازك. مثلاً: 

lpdump --slot 0 /dev/block/by-name/system_a
lpdump --slot 1 /dev/block/by-name/system_b

إجراء تحديث جديد

على الأجهزة التي تعمل بالإصدار 9 من نظام التشغيل Android والإصدارات الأقدم، لا يتيح برنامج OTA على الجهاز إمكانية ربط الأقسام الديناميكية قبل التحديث. يتم إنشاء مجموعة إضافية من الرقع لكي يمكن تطبيق عملية الربط مباشرةً على الأقسام المادية الحالية.

ينشئ أداة إنشاء التحديثات من خلال الهواء ملف super.img النهائي الذي يحتوي على محتوى جميع الأقسام الديناميكية، ثم يقسم الصورة إلى صور متعددة تتطابق مع أحجام أجهزة الكتل المادية التي تتوافق مع النظام والمورّد وما إلى ذلك. يتم تسمية هذه الصور super_system.img وsuper_vendor.img وما إلى ذلك. يطبِّق برنامج OTA هذه الصور على الأقسام المادية بدلاً من تطبيقها على الأقسام المنطقية (الديناميكية).

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

تكون عملية التحديث هي نفسها في Android 9.

قبل التحديث:

ro.boot.dynamic_partitions=
ro.boot.dynamic_partitions_retrofit=

بعد التحديث: 

ro.boot.dynamic_partitions=true
ro.boot.dynamic_partitions_retrofit=true

التحديثات المستقبلية بعد إجراء تعديلات لاحقة

بعد تحديث الجهاز القديم، يتم تحديث برنامج OTA للعمل مع الأقسام الديناميكية. لا تمتد نطاقات الأقسام المصدر أبدًا على مستوى الأقسام المادية المستهدَفة.

خطوات التحديث باستخدام حزمة تحديث عادية

  1. ابدأ البيانات الوصفية للقسيمة super.
    1. أنشئ بيانات وصفية جديدة M من البيانات الوصفية S (البيانات الوصفية للمصدر). على سبيل المثال، إذا كانت البيانات الوصفية S تستخدم [system_s، vendor_s، product_s] كأجهزة حظر، ستستخدم البيانات الوصفية الجديدة M [system_t، vendor_t، product_t] كأجهزة حظر. يتم تجاهل جميع المجموعات والأقسام في M.
    2. أضِف المجموعات والشرائح المستهدَفة وفقًا لحقل dynamic_partition_metadata في بيان التحديث. يمكن العثور على حجم كل قسم في new_partition_info.
    3. اكتب M في البيانات الوصفية T.
    4. يمكنك ربط الأقسام المُضافة في أداة ربط الأجهزة على أنّها قابلة للكتابة.
  2. طبِّق التحديث على الأجهزة المحظورة.
    1. إذا لزم الأمر، يمكنك ربط أقسام المصدر في أداة ربط الأجهزة للقراءة فقط. هذا الإجراء ضروري لتحميل التطبيقات من مصدر غير معروف لأنّه لم يتم ربط أقسام المصدر قبل التحديث.
    2. تطبيق تحديث كامل أو تحديث دلتا على جميع الأجهزة المحظورة في فتحة الاستهداف
    3. شغِّل الوحدات لتتمكّن من تشغيل النص البرمجي لعمليات ما بعد التثبيت، ثم فك ربط الوحدات.
  3. أزِل الربط بين الأقسام المستهدَفة.

تحديث التدفق باستخدام حزمة تحديث التحديث

إذا تم تطبيق حزمة تحديث التعديل على جهاز مفعَّل فيه الأقسام الديناميكية، يطبِّق برنامج OTA ملف super.img المُقسَّم على الأجهزة التي تتضمّن وحدات تخزين مباشرةً. تشبه عملية التحديث عملية تحديث الإصدارات القديمة. اطّلِع على مقالة تعديل تحديث سابق للحصول على التفاصيل.

على سبيل المثال، نفترض ما يلي:

  • الفتحة "أ" هي الفتحة النشطة.
  • يحتوي system_a على البيانات الوصفية النشطة في الفتحة 0.
  • يتم استخدام system_a وvendor_a و product_a كأجهزة حظر.

عندما يتلقّى برنامج OTA حزمة تحديث لجهاز قديم، يطبّق super_system.img على الجهاز system_b، super_vendor.img على الجهاز vendor_b، super_product.img على الجهاز product_b. يحتوي جهاز الكتل المادي system_b على البيانات الوصفية الصحيحة لربط system_b و vendor_b وproduct_b المنطقية في وقت التشغيل.

إنشاء حِزم التحديثات

التحديثات المتزايدة عبر الهواء

عند إنشاء تحديثات OTA متزايدة للأجهزة التي تم تركيبها لاحقًا، تعتمد التحديثات على ما إذا كان الإصدار الأساسي يحدِّد PRODUCT_USE_DYNAMIC_PARTITIONS و PRODUCT_RETROFIT_DYNAMIC_PARTITIONS أم لا.

  • إذا لم يحدّد الإصدار الأساسي المتغيّرات، يكون هذا تعديلاً تكميليًا. تحتوي حزمة التحديث على ملف القسم العميق super.img وتوقِف خطوة ما بعد التثبيت.
  • إذا كانت البنية الأساسية تحدّد المتغيّرات، يكون ذلك مماثلاً لمحاولة إجراء تحديث عادي باستخدام أقسام ديناميكية. تحتوي حزمة التحديث على صور للأقسام المنطقية (الديناميكية). يمكن تفعيل خطوة ما بعد التثبيت.

التحديث عبر الهواء بالكامل

تم إنشاء حزمتين كاملتين عبر الهواء للأجهزة التي تم تعديلها.

  • يحتوي $(PRODUCT)-ota-retrofit-$(TAG).zip دائمًا على قسم super.img ويوقف الخطوة التي تأتي بعد التثبيت لتعديل التحديث.
    • يتم إنشاؤه باستخدام وسيطة إضافية --retrofit_dynamic_partitions للنص البرمجي ota_from_target_files.
    • ويمكن تطبيقها على جميع الإصدارات.
  • يحتوي $(PRODUCT)-ota-$(TAG).zip على صور منطقية ل التحديثات المستقبلية.
    • لا يتم تطبيق هذا الإجراء إلا على الإصدارات التي تم فيها تفعيل الأقسام الديناميكية. يمكنك الاطّلاع أدناه على تفاصيل حول فرض هذا الإجراء.

رفض التحديث غير المتوافق مع الإصدارات القديمة

لا يتم تطبيق حزمة OTA الكاملة العادية إلا للإصدارات التي تم فيها تفعيل الأقسام الديناميكية. إذا تم ضبط إعدادات خادم OTA بشكل غير صحيح وأرسل هذه الحِزم إلى الأجهزة التي تعمل بالإصدار 9 من نظام التشغيل Android أو إصدارًا أقدم، يتعذّر تشغيل الأجهزة. لا يمكن لعميل OTA على الإصدار 9 من Android والإصدارات الأقدم التمييز بين حزمة OTA لتعديل الإصدار السابق وحزمة OTA العادية الكاملة، لذا لن يرفض العميل الحزمة الكاملة.

لمنع الجهاز من قبول حزمة OTA الكاملة، يمكنك طلب خطوة بعد التثبيت للتحقّق من إعدادات الجهاز الحالية. مثلاً:

device/device_name/dynamic_partitions/check_dynamic_partitions 

#!/system/bin/sh
DP_PROPERTY_NAME="ro.boot.dynamic_partitions"
DP_RETROFIT_PROPERTY_NAME="ro.boot.dynamic_partitions_retrofit"

DP_PROPERTY=$(getprop ${DP_PROPERTY_NAME})
DP_RETROFIT_PROPERTY=$(getprop ${DP_RETROFIT_PROPERTY_NAME})

if [ "${DP_PROPERTY}" != "true" ] || [ "${DP_RETROFIT_PROPERTY}" != "true" ] ; then
    echo "Error: applied non-retrofit update on build without dynamic" \
         "partitions."
    echo "${DP_PROPERTY_NAME}=${DP_PROPERTY}"
    echo "${DP_RETROFIT_PROPERTY_NAME}=${DP_RETROFIT_PROPERTY}"
    exit 1
fi

device/device_name/dynamic_partitions/Android.mk 

LOCAL_PATH := $(call my-dir)
include $(CLEAR_VARS)
LOCAL_MODULE:= check_dynamic_partitions
LOCAL_MODULE_TAGS := optional
LOCAL_MODULE_CLASS := EXECUTABLES
LOCAL_SRC_FILES := check_dynamic_partitions
LOCAL_PRODUCT_MODULE := true
include $(BUILD_PREBUILT)

device/device_name/device.mk 

PRODUCT_PACKAGES += check_dynamic_partitions

# OPTIONAL=false so that the error in check_dynamic_partitions will be
# propagated to OTA client.
AB_OTA_POSTINSTALL_CONFIG += \
    RUN_POSTINSTALL_product=true \
    POSTINSTALL_PATH_product=bin/check_dynamic_partitions \
    FILESYSTEM_TYPE_product=ext4 \
    POSTINSTALL_OPTIONAL_product=false \

عند تطبيق حزمة OTA العادية على جهاز بدون تفعيل القسمين الديناميكيين، يُشغِّل برنامج OTA العميل check_dynamic_partitions كخطوة ما بعد التثبيت ويرفض التحديث.