يمكنك استخدام أداة ota_from_target_files
المتوفّرة في build/make/tools/releasetools
لإنشاء حِزم OTA كاملة ومتصاعدة
للأجهزة التي تستخدم تحديثات نظام A/B أو
تحديثات نظام غير A/B. تأخذ الأداة ملف
target-files.zip
الذي ينشئه نظام إنشاء Android كمدخل.
بالنسبة إلى الأجهزة التي تعمل بالإصدار 11 من نظام التشغيل Android أو الإصدارات الأحدث، يمكنك إنشاء حزمة OTA واحدة لأجهزة متعددة برموز تخزين تعريفية مختلفة. يتطلّب ذلك ضبط الأجهزة المستهدَفة لاستخدام البصمات الديناميكية وتعديل البيانات الوصفية لميزة OTA لتضمين اسم الجهاز وبصمته في إدخالات الشرطَين المسبق واللاحق.
أوقف نظام التشغيل Android 8.0 نهائيًا استخدام حِزم التحديثات عبر الهواء المستندة إلى الملفات على الأجهزة غير المزوّدة بميزة A/B، والتي يجب أن تستخدم بدلاً من ذلك حِزم التحديثات عبر الهواء المستندة إلى الوحدات. ل
إنشاء حِزم OTA مستندة إلى مجموعات أو أجهزة تعمل بنظام التشغيل Android 7.x أو الإصدارات الأقدم، نقْل
الخيار --block
إلى المَعلمة ota_from_target_files
.
إنشاء تحديثات كاملة
التحديث الكامل هو حزمة عبر شبكة غير سلكية تحتوي على الحالة النهائية الكاملة
للجهاز (أقسام النظام وبدء التشغيل والاسترداد). طالما أنّ الجهاز قادر
على تلقّي الحزمة وتطبيقها، يمكن للحزمة تثبيت الإصدار
بغض النظر عن الحالة الحالية للجهاز. على سبيل المثال، ما يلي
أدوات الإصدار لإنشاء أرشيف target-files.zip
جهاز واحد (tardis
).
. build/envsetup.sh && lunch tardis-eng
mkdir dist_output
make dist DIST_DIR=dist_output
ينشئ make dist
حزمة كاملة للتحديث عبر الهواء (في $OUT
). يحتوي ملف .zip
الناتج
على كل ما يلزم لإنشاء حِزم تحديث عبر الهواء لجهاز tardis
.
يمكنك أيضًا إنشاء ota_from_target_files
كملف ثنائي لبرنامج Python واستدعائه ل
إنشاء حِزم كاملة أو متزايدة.
ota_from_target_files dist_output/tardis-target_files.zip ota_update.zip
يتم إعداد مسار ota_from_target_files
في $PATH
، ويقع الثنائي python
الناتج في الدليل out/
.
أصبح جهاز "ota_update.zip
" جاهزًا الآن لإرساله إلى أجهزة الاختبار (تم توقيع كل البيانات).
باستخدام مفتاح الاختبار). بالنسبة إلى أجهزة المستخدمين، يمكنك إنشاء مفاتيحك الخاصة واستخدامها كـ
بالتفصيل في إصدارات توقيع الإصدار.
إنشاء تحديثات تدريجية
التحديث المتزايد هو حزمة OTA تحتوي على رموز تصحيح ثنائية للبيانات. الموجودة بالفعل على الجهاز. وتكون الحِزم التي تتضمّن تحديثات متزايدة أصغر حجمًا عادةً لأنّها لا تحتاج إلى تضمين الملفات التي لم يتم تغييرها. بالإضافة إلى ذلك، بما أنّ الملفات التي تم تغييرها غالبًا ما تكون مشابهة جدًا لإصداراتها السابقة، لا تحتاج الحزمة إلا إلى تضمين ترميز للاختلافات بين الملفَّين.
لا يمكنك تثبيت حزمة تحديثات تزايدية إلا على الأجهزة التي تحتوي على
المصدر المستخدم في إنشاء الحزمة. لإنشاء تحديث تزايدي،
ستحتاج إلى ملف target_files.zip
من الإصدار السابق (الملف الذي تريده
المطلوب تحديثها من) بالإضافة إلى ملف target_files.zip
من الإصدار الجديد. على سبيل المثال، تستخدِم الأوامر التالية أدوات الإصدار لإنشاء تحديث تدريجي
لجهاز tardis
.
ota_from_target_files -i PREVIOUS-tardis-target_files.zip dist_output/tardis-target_files.zip incremental_ota_update.zip
هذا الإصدار يشبه إلى حد كبير الإصدار السابق، ويعرض التحديث التدريجي
الحزمة (incremental_ota_update.zip
) أصغر بكثير من الحزمة
تحديث كامل (حوالي 1 ميغابايت بدلاً من 60 ميغابايت).
وزِّع الحزمة المتزايدة فقط على الأجهزة التي تعمل بالإصدار السابق نفسه
الذي تم استخدامه كنقطة بداية للحزمة المتزايدة. يجب أن تومض
الصور في PREVIOUS-tardis-target_files.zip
أو PREVIOUS-tardis-img.zip
(كلاهما تم إنشاؤه باستخدام make dist
، ليتم وميض fastboot update
)، بدلاً من
تلك الموجودة ضمن الدليل PRODUCT_OUT
(التي تم إنشاؤها باستخدام make
، والتي سيتم
امضى باستخدام fastboot flashall
). محاولة تثبيت الحزمة التزايدية
على جهاز مع بعض الإصدارات الأخرى إلى حدوث خطأ في التثبيت. في حال تعذّر اكتمال عملية التثبيت، يبقى الجهاز في حالة العمل نفسها (تشغيل النظام القديم)، وتتحقّق الحزمة من الحالة السابقة لجميع الملفات التي تعدّلها قبل معالجتها، وبالتالي لا يبقى الجهاز في حالة ترقية غير مكتملة.
لتقديم أفضل تجربة للمستخدم، يجب تقديم تحديث كامل لكل 3 إلى 4 فترات متزايدة. التحديثات. يساعد هذا المستخدمين في متابعة أحدث إصدار وتجنب فترة تسلسل تثبيت التحديثات التزايدية.
إنشاء حزم التحديث عبر الهواء لرموز تخزين تعريفية متعددة
يتيح الإصدار 11 من نظام التشغيل Android أو الإصدارات الأحدث استخدام حزمة واحدة عبر الهواء لأجهزة متعددة تتضمّن رموز التخزين التعريفية المختلفة. ويتطلب إجراء ذلك تهيئة الأجهزة المستهدفة لاستخدام البصمة الديناميكية وتحديث البيانات الوصفية لـ OTA (باستخدام أدوات التحديث عبر الهواء) لتضمين اسم الجهاز وبصمة الإصبع في القسمَين السابق واللاحق الإدخالات الشرطية.
لمحة عن رموز التخزين التعريفية
يمثّل تنسيق رمز التخزين التعريفي (SKU) اختلافًا في قيم مَعلمة
الإنشاء المجمّعة، وهو عادةً مجموعة فرعية غير معلَن عنها من مَعلمات build_fingerprint
الحالية.
ويمكن للمصنّعين الأصليين للأجهزة استخدام أي مجموعة من معلَمات الإصدار المعتمَدة من CDD لرمز التخزين التعريفي.
أيضًا استخدام صورة واحدة لرموز التخزين التعريفية هذه. على سبيل المثال، يحتوي رمز التخزين التعريفي التالي على
أشكال متعددة:
SKU = <product><device><modifierA><modifierB><modifierC>
modifierA
هو مستوى الجهاز (مثلاً Pro أو Premium أو Plus)-
modifierB
هو نوع الجهاز (مثل radio) modifierC
هي المنطقة، ويمكن أن تكون عامة (مثل NA أو EMEA أو CHN) أو خاصة بالبلد أو اللغة (مثل JPN أو ENG أو CHN).
يستخدم العديد من المصنّعين الأصليّين للأجهزة صورة واحدة لعدة رموز تخزين تعريفية، ثم يستخرجون اسم المنتج النهائي
ومعرف الجهاز أثناء التشغيل بعد تشغيل الجهاز. هذه العملية
تبسيط عملية تطوير النظام الأساسي، وتمكين الأجهزة ذات البيانات الصغيرة
التخصيصات ولكن مع أسماء المنتجات المختلفة لمشاركة الصور الشائعة (مثل
tardis
وtardispro
).
استخدام بصمات الإصبع الديناميكية
بصمة الإصبع هي سلسلة محدّدة من عناصر البيانات
المَعلمات مثل
ro.product.brand
وro.product.name
وro.product.device
بصمة الإصبع
بيانات الجهاز مشتقًا من الملف المرجعي لقسم النظام وتُستخدم
معرّف فريد للصور (ووحدات البايت) التي تعمل على الجهاز. لإنشاء بصمة ديناميكية، استخدِم المنطق الديناميكي في ملف build.prop
على الجهاز للحصول على قيمة متغيّرات أداة تحميل التشغيل في وقت تشغيل الجهاز، ثم استخدِم هذه البيانات لإنشاء بصمة ديناميكية لهذا الجهاز.
على سبيل المثال، لاستخدام بصمات الأصابع الديناميكية لجهازَين tardis
وtardispro
:
قم بتحديث الملفات التالية كما هو موضح أدناه.
عدِّل ملف
odm/etc/build_std.prop
ليتضمّن السطر التالي.ro.odm.product.device=tardis
عدِّل ملف
odm/etc/build_pro.prop
ليتضمّن السطر التالي.ro.odm.product.device=tardispro
عدِّل ملف
odm/etc/build.prop
ليتضمّن الأسطر التالية.ro.odm.product.device=tardis import /odm/etc/build_${ro.boot.product.hardware.sku}.prop
تحدد هذه الخطوط بشكل ديناميكي اسم الجهاز وبصمة الإصبع
ro.build.fingerprint
من القيم بناءً على قيمة
سمة برنامج الإقلاع في ro.boot.product.hardware.sku
(للقراءة فقط)
تعديل البيانات الوصفية لحزمة التحديث عبر الهواء
تحتوي حزمة OTA على ملف بيانات وصفية (META-INF/com/android/metadata
) يصف الحزمة، بما في ذلك الشرط المسبق والشرط اللاحق لحزمة OTA. على سبيل المثال، الرمز التالي هو ملف البيانات الوصفية لحزمة OTA
الذي يستهدف جهاز tardis
.
post-build=google/tardis/tardis:11/RP1A.200521.001/6516341:userdebug/dev-keys
post-build-incremental=6516341
post-sdk-level=30
post-security-patch-level=2020-07-05
post-timestamp=1590026334
pre-build=google/tardis/tardis:11/RP1A.200519.002.A1/6515794:userdebug/dev-keys
pre-build-incremental=6515794
pre-device=tardis
تحدِّد القيم pre-device
وpre-build-incremental
وpre-build
الحالة التي يجب أن يكون عليها الجهاز قبل تثبيت حزمة OTA. تحدِّد قيم
post-build-incremental
وpost-build
الحالة التي يُتوقّع أن يكون عليها الجهاز
بعد تثبيت حزمة OTA. يتم اشتقاق قيم حقلَي pre-
و
post-
من سمات الإصدار المقابلة التالية.
- يتم اشتقاق قيمة
pre-device
من سمة الإصدارro.product.device
. - يتم استنتاج القيمتَين
pre-build-incremental
وpost-build-incremental
. من خاصية الإصدارro.build.version.incremental
. - يتم اشتقاق القيمتين
pre-build
وpost-build
من السمة موقع الإصدارro.build.fingerprint
.
على الأجهزة التي تعمل بنظام التشغيل Android 11 أو إصدار أحدث، يمكنك استخدام العلامة --boot_variable_file
في أدوات OTA لتحديد مسار إلى ملف يحتوي على قيم متغيّرات وقت التشغيل المستخدَمة في إنشاء بصمة الجهاز الديناميكية. يتم بعد ذلك استخدام البيانات لتحديث بيانات تعريف OTA لتضمين
اسم الجهاز وبصمة الإصبع في الشرطَين pre-
وpost-
(باستخدام
حرف الشرطة الرأسية | المُحدِّد). يحتوي العلامة --boot_variable_file
على الصعيغة والوصف التاليَين:
- البنية:
--boot_variable_file <path>
- الوصف: تُحدِّد مسارًا لملف يحتوي على القيم المحتملة لسمات
ro.boot.*
. يتم استخدام هذه البيانات لاحتساب الملفات المرجعية المحتملة لبيئة التشغيل. عند إلغاء بعض سماتro.product.*
من خلال عبارة الاستيراد. يتوقّع الملف موقعًا واحدًا في كل سطر، حيث يكون لكل سطر التنسيق التالي:prop_name=value1,value2
.
على سبيل المثال، عندما يكون الموقع الإلكتروني هو ro.boot.product.hardware.sku=std,pro
، تكون
البيانات الوصفية لميزة OTA لأجهزة tardis
وtardispro
كما هو موضّح أدناه.
post-build=google/tardis/tardis:11/<suffix>|google/tardis/tardispro:11/<suffix>
pre-build=google/tardis/tardis:11/<suffix>|google/tardis/tardispro:11/<suffix>
pre-device=tardis|tardispro
لتفعيل هذه الوظيفة على الأجهزة التي تعمل بنظام التشغيل Android 10، يُرجى الاطّلاع على مرجع تنفيذ
.
تحلّل قائمة التغييرات هذه عبارات import
بشكل مشروط في build.prop
.
، الذي يتيح التعرّف على إلغاءات الخصائص وإظهارها في
البيانات الوصفية النهائية عبر اتصال لاسلكي.