يتيح نظام التشغيل Android 10 والإصدارات الأحدث إمكانية تغيير حجم الأقسام من خلال نقل عملية تنفيذ Fastboot من برنامج الإقلاع إلى مساحة المستخدم. وتتيح عملية النقل هذه نقل الرمز الوامض إلى موقع شائع يمكن صيانته واختباره مع استخدام أجزاء Fastboot الخاصة بالمورِّد فقط وتنفيذها بواسطة طبقة تجريد الأجهزة (HAL). بالإضافة إلى ذلك، يتوافق Android 12 والإصدارات الأحدث مع وامض RAMD من خلال أمر Fastboot الإضافي.
توحيد Fastboot واسترداد الحساب
نظرًا لأن نظام userspace يكون Fastboot واستعادة البيانات متشابهَين، يمكنك دمجهما في قسم واحد أو برنامج ثنائي. وهذا يوفر مزايا مثل استخدام مساحة أقل، ووجود أقسام أقل بشكل عام، واستخدام Fastboot وعملية الاسترداد لمشاركة النواة والمكتبات.
للتوافق مع fastbootd
، يجب أن ينفِّذ برنامج الإقلاع أمر كتلة تحكم في التشغيل (BCB) جديدًا في boot-fastboot
. للدخول إلى وضع fastbootd
، يكتب برنامج الإقلاع boot-fastboot
في حقل الأوامر لرسالة BCB ويترك الحقل recovery
في BCB بدون تغيير (لتفعيل إعادة تشغيل أي مهام استرداد تمت مقاطعتها). ولم يطرأ أي تغيير على الحقول status
وstage
وreserved
.
يتم تحميل صورة الاسترداد وتشغيلها من خلال برنامج الإقلاع عند رؤية
boot-fastboot
في حقل أوامر BCB. بعد ذلك، تُحلّل عملية الاسترداد رسالة BCB
وتنتقل إلى وضع fastbootd
.
أوامر ADB
يوضِّح هذا القسم الأمر adb
لدمج fastbootd
. ينتج عن
الأمر نتائج مختلفة، بناءً على ما إذا تم تنفيذه بواسطة النظام أو
عن طريق الاسترداد.
الأمر | الوصف |
---|---|
reboot fastboot |
|
أوامر Fastboot
يوضّح هذا القسم أوامر Fastboot المدمجة لدمج fastbootd
،
بما في ذلك الأوامر الجديدة لبرنامج Flashing وإدارة الأقسام المنطقية. تتوفّر نتائج مختلفة لبعض الأوامر، بناءً على ما إذا تم تنفيذها من خلال برنامج الإقلاع أو من خلال fastbootd
.
الأمر | الوصف |
---|---|
reboot recovery |
|
reboot fastboot |
تتم إعادة تشغيل الجهاز في fastbootd . |
getvar is-userspace |
|
getvar is-logical:<partition> |
تعرض yes إذا كان التقسيم المحدد قسمًا منطقيًا، أو يعرض no في الحالات الأخرى.
تتوافق الأقسام المنطقية مع جميع الأوامر الواردة أدناه. |
getvar super-partition-name |
تعرض اسم القسم المميّز. يتضمن الاسم لاحقة الفتحة الحالية إذا كان القسم المتميز عبارة عن قسم A/B (لا يكون كذلك عادةً). |
create-logical-partition <partition> <size> |
تنشئ قسمًا منطقيًا بالاسم والحجم المعطاين. يجب ألا يكون الاسم موجودًا بالفعل كقسم منطقي. |
delete-logical-partition <partition> |
يؤدي هذا الإجراء إلى حذف القسم المنطقي المحدّد (يمحو القسم بشكل فعّال). |
resize-logical-partition <partition> <size> |
لتغيير حجم القسم المنطقي إلى الحجم الجديد بدون تغيير محتواه. يتعذّر تنفيذ تغيير الحجم إذا لم تكن هناك مساحة كافية لإجراء تغيير الحجم. |
update-super <partition> |
يدمج التغييرات التي تم إجراؤها على البيانات الوصفية للقسم المميز. إذا تعذّرت عملية الدمج
(على سبيل المثال، التنسيق على الجهاز هو إصدار غير متوافق)، سيتعذّر تنفيذ هذا الأمر. تؤدي مَعلمة wipe الاختيارية إلى استبدال البيانات الوصفية
للجهاز، بدلاً من إجراء عملية دمج. |
flash <partition> [ <filename> ] |
كتابة ملف في قسم Flash. يجب أن يكون الجهاز في حالة فتح القفل. |
erase <partition> |
محو قسم (غير مطلوب ليتم محو البيانات بأمان). يجب أن يكون الجهاز في حالة فتح القفل. |
getvar <variable> | all |
يعرض متغير برنامج الإقلاع أو جميع المتغيرات. في حالة عدم وجود المتغير، يتم إرجاع خطأ. |
set_active <slot> |
تضبط هذه السياسة خانة تشغيل A/B المحدّدة على بالنسبة إلى دعم A/B، تكون الخانات عبارة عن مجموعات مكررة من الأقسام التي يمكن تشغيلها بشكل مستقل. تُعرف الخانات باسم |
reboot |
يعيد تشغيل الجهاز بشكل طبيعي. |
reboot-bootloader (أو reboot bootloader ) |
يعيد هذا الإجراء تشغيل الجهاز في برنامج الإقلاع. |
fastboot fetch vendor_boot <out.img> |
استخدِم هذا الإصدار في نظام التشغيل Android 12 والإصدارات الأحدث لإتاحة برامج Flash Flash أو إصدار جديد.
تحصل على حجم القسم بالكامل وحجم المجموعة. يجمع البيانات لكل مجموعة، ثم يجمع البيانات معًا في
لمعرفة التفاصيل، يُرجى الاطّلاع على |
fastboot flash vendor_boot:default <vendor-ramdisk.img> |
تُستخدم هذه السياسة في نظام التشغيل Android 12 والإصدارات الأحدث لإتاحة الإصدارات الوامضة من قِبل المورّدين. وهذا شكل خاص من أمر الفلاش. وهي تؤدي وظيفة صورة
لمعرفة التفاصيل، يُرجى الاطّلاع على |
fastboot flash vendor_boot:<foo> <vendor-ramdisk.img> |
تُستخدم هذه السياسة في Android 12 والإصدارات الأحدث لإتاحة الإصدارات الوامضة من قِبل المورّدين. لجلب صورة لمعرفة التفاصيل، يُرجى الاطّلاع على |
برنامج Fastboot وبرنامج الإقلاع
يؤدي برنامج الإقلاع إلى تثبيت الأقسام bootloader
وradio
وboot/recovery
، وبعدها يتم تشغيل الجهاز في Fastboot (مساحة المستخدم) وتشغيل جميع الأقسام الأخرى. يجب أن يتوافق برنامج الإقلاع مع الأوامر التالية:
الأمر | الوصف |
---|---|
download |
يتم تنزيل الصورة للفلاش. |
flash recovery <image>/ flash boot <image>/ flash
bootloader <image>/ |
يؤدي هذا الإجراء إلى وميض قسم "recovery/boot " وبرنامج الإقلاع. |
reboot |
يعيد هذا الإجراء تشغيل الجهاز. |
reboot fastboot |
تتم إعادة تشغيل الجهاز للدخول في وضع Fastboot. |
reboot recovery |
عمليات إعادة التشغيل لاسترداد الحساب. |
getvar |
تحصل على متغيّر برنامج الإقلاع المطلوب لتشغيل نسخة الاسترداد/التمهيد (مثل current-slot و
max-download-size ). |
oem <command> |
الأمر الذي يحدّده المصنّع الأصلي للجهاز. |
الأقسام الديناميكية
يجب ألا يسمح برنامج الإقلاع بوميض الأقسام الديناميكية أو محوها ويجب أن يعرض رسالة خطأ إذا تمت محاولة إجراء هذه العمليات. بالنسبة إلى أجهزة التقسيم الديناميكي التي تم تعديلها، تدعم أداة Fastboot (وبرنامج الإقلاع) وضع الفرض لتحديث قسم ديناميكي بشكل مباشر أثناء استخدام وضع برنامج الإقلاع. على سبيل المثال، إذا كان system
عبارة عن قسم ديناميكي على الجهاز الذي تمت إعادة تعديله، سيؤدي استخدام الأمر fastboot --force flash system
إلى تفعيل برنامج الإقلاع (بدلاً من fastbootd
) من تحديث القسم.
الشحن في وضع عدم الاتصال
إذا كان الجهاز يتيح الشحن في وضع عدم الاتصال أو التشغيل التلقائي بطريقة أخرى في وضع خاص عند استهلاك الطاقة، يجب أن يتجاوز تنفيذ أمر fastboot oem off-mode-charge 0
هذه الأوضاع الخاصة لكي يبدأ الجهاز في التشغيل كما لو ضغط المستخدم على زر التشغيل.
طبقة تجريد الأجهزة (HAL) للمصنّع الأصلي للجهاز في Fastboot
لاستبدال Fastboot برنامج الإقلاع تمامًا، يجب أن يتعامل Fastboot مع جميع أوامر برنامج Fastboot الحالي. العديد من هذه الأوامر من المصنّعين الأصليين للأجهزة ويتم توثيقها ولكنها تتطلب تنفيذًا مخصصًا. لم يتم توثيق العديد من الأوامر الخاصة بالمُصنّع الأصلي. للتعامل مع هذه الأوامر، يحدد برنامج Fastboot HAL أوامر المصنّع الأصلي للجهاز المطلوبة. يمكن للمصنّعين الأصليين للأجهزة أيضًا تنفيذ أوامرهم الخاصة.
فيما يلي تعريف طبقة HAL التي يتم تعريفها في Fastboot:
import IFastbootLogger;
/**
* IFastboot interface implements vendor specific fastboot commands.
*/
interface IFastboot {
/**
* Returns a bool indicating whether the bootloader is enforcing verified
* boot.
*
* @return verifiedBootState True if the bootloader is enforcing verified
* boot and False otherwise.
*/
isVerifiedBootEnabled() generates (bool verifiedBootState);
/**
* Returns a bool indicating the off-mode-charge setting. If off-mode
* charging is enabled, the device autoboots into a special mode when
* power is applied.
*
* @return offModeChargeState True if the setting is enabled and False if
* not.
*/
isOffModeChargeEnabled() generates (bool offModeChargeState);
/**
* Returns the minimum battery voltage required for flashing in mV.
*
* @return batteryVoltage Minimum battery voltage (in mV) required for
* flashing to be successful.
*/
getBatteryVoltageFlashingThreshold() generates (int32_t batteryVoltage);
/**
* Returns the file system type of the partition. This is only required for
* physical partitions that need to be wiped and reformatted.
*
* @return type Can be ext4, f2fs or raw.
* @return result SUCCESS if the operation is successful,
* FAILURE_UNKNOWN if the partition is invalid or does not require
* reformatting.
*/
getPartitionType(string partitionName) generates (FileSystemType type, Result result);
/**
* Executes a fastboot OEM command.
*
* @param oemCmd The oem command that is passed to the fastboot HAL.
* @response result Returns the status SUCCESS if the operation is
* successful,
* INVALID_ARGUMENT for bad arguments,
* FAILURE_UNKNOWN for an invalid/unsupported command.
*/
doOemCommand(string oemCmd) generates (Result result);
};
تفعيل Fastbootd
لتفعيل ميزة "fastbootd
" على جهاز:
إضافة
fastbootd
إلىPRODUCT_PACKAGES
فيdevice.mk
:PRODUCT_PACKAGES += fastbootd
تأكَّد من تضمين HAL وعنصر التحكم في التشغيل (HAL) في Fastboot (HAL) وHAL (HAL) للصحة كجزء من صورة الاسترداد.
أضِف أي أذونات SEPolicy خاصة بالجهاز يطلبها
fastbootd
. على سبيل المثال، يتطلّبfastbootd
إذنًا بالكتابة في قسم خاص بالجهاز لإصلاح هذا القسم. بالإضافة إلى ذلك، قد يتطلب تنفيذ بروتوكول HAL للاستخدام Fastboot أيضًا أذونات خاصة بالجهاز.
للتحقق من صحة سياسة Fastspace for userspace، يمكنك تشغيل أداة اختبار المورِّدين (VTS).
ملفات عشوائية لبائعي Flash
يتيح نظام التشغيل Android 12 والإصدارات الأحدث إمكانية وميض ذاكرة التخزين المؤقت
باستخدام أمر Fastboot المضاف الذي يسحب الصورة vendor_boot
الكاملة من الجهاز. يطلب الأمر أداة Fastboot من جانب المضيف قراءة رأس تشغيل البائع وإعادة إنشاء ووميض الصورة الجديدة.
لسحب صورة vendor_boot
الكاملة، تمت إضافة الأمر fetch:vendor_boot
إلى كل من بروتوكول Fastboot (Fastboot) ، وتنفيذ بروتوكول Fastboot
في Android 12. يُرجى العِلم أنّ برنامج Fastbootd ينفّذ
هذا الإجراء، لكن برنامج الإقلاع نفسه قد لا ينفذه. يمكن للمصنّعين الأصليين للأجهزة إضافة
الأمر fetch:vendor_boot
إلى تنفيذ برنامج الإقلاع
للبروتوكول. ومع ذلك، إذا لم يتم التعرّف على الأمر في وضع برنامج الإقلاع، لن يكون تثبيت ملفات RAMD خاصة بمورّد فردي في وضع برنامج الإقلاع خيارًا متوافقًا مع
المورِّد.
التغييرات التي طرأت على برنامج الإقلاع
تم تنفيذ الأمرين getvar:max-fetch-size
وfetch:name
في
fastbootd
. لدعم عمليات إعادة التوجيه الوامضة للبائع في برنامج الإقلاع، يجب
تنفيذ هذين الأمرين.
تغييرات Fastbootd
getvar:max-fetch-size
مثل max-download-size
. يحدد الحد الأقصى للحجم الذي يمكن للجهاز إرساله في استجابة DATA واحدة. يجب ألا يجلب برنامج التشغيل
حجمًا أكبر من هذه القيمة.
يجري "fetch:name[:offset[:size]]
" سلسلة من عمليات الفحص على الجهاز. إذا انطبقت كل المعلومات التالية، سيعرض الأمر fetch:name[:offset[:size]]
البيانات:
- يعمل الجهاز بإصدار يمكن تصحيح الأخطاء فيه.
- الجهاز غير مقفَل (حالة التشغيل باللون البرتقالي).
- اسم القسم الذي تم استرجاعه هو
vendor_boot
. - تقع قيمة
size
ضمن 0 <size
<=max-fetch-size
.
عند التحقق من ذلك، يعرض fetch:name[:offset[:size]]
حجم القسم والإزاحة.
ملاحظات:
- إنّ
fetch:name
تعادلfetch:name:0
، أي ما يعادلfetch:name:0:partition_size
. fetch:name:offset
تساويfetch:name:offset:(partition_size - offset)
ولذلك تكون fetch:name[:offset[:size]]
=
fetch:name:offset:(partition_size - offset)
.
في حال عدم تحديد قيمة offset
أو partition_size
(أو كليهما)،
يتم استخدام القيمتَين التلقائيتَين، أي قيمة للسمة offset
تساوي 0 والقيمة size
المحسوبة للسمة partition_size - offset
.
- تم تحديد إزاحة، لم يتم تحديد الحجم:
size = partition_size - offset
- لم يتم تحديد أي منهما: القيم التلقائية المستخدمة لكليهما،
size = partition_size
- 0.
على سبيل المثال، يجلب fetch:foo
قسم foo
بالكامل بالإزاحة 0.
تغييرات برامج التشغيل
تمت إضافة أوامر إلى أداة Fastboot لتنفيذ تغييرات برنامج التشغيل. يرتبط كل منها بتعريفه الكامل في جدول Fastboot commands.
fastboot fetch vendor_boot out.img
- تستدعي
getvar max-fetch-size
لتحديد حجم المجموعة. - يمكنك استدعاء
getvar partition-size:vendor_boot[_a]
لتحديد حجم القسم بالكامل. - وتطلب
fastboot fetch vendor_boot[_a]:offset:size
لكل مجموعة. (يكون حجم المقطع أكبر من حجمvendor_boot
، لذا يتوفّر عادةً مقطع واحد فقط). - يتم دمج البيانات معًا من أجل
out.img
.
- تستدعي
fastboot flash vendor_boot:default vendor-ramdisk.img
وهذا شكل خاص من أمر الفلاش. يجلب هذا الزر صورة
vendor_boot
، كما لو تم استدعاءfastboot fetch
.- إذا كان تمهيد المورد هو رأس الإصدار 3، سيتم إجراء ما يلي:
- لاستبدال ذاكرة التخزين المؤقت للبائع بالصورة المحددة.
- يؤدي هذا الإجراء إلى عرض وميض الصورة
vendor_boot
الجديدة.
- إذا كان رأس تشغيل المورّد هو الإصدار 4،
سيتم إجراء ما يلي:
- يستبدل رمز القرص الكامل للمورّد بالصورة المحدّدة بحيث تصبح الصورة المحددة الجزء الوحيد من القرص المضغوط للمورّد في صورة
vendor_boot
. - لإعادة حساب الحجم والإزاحة في جدول RAMD للمورد.
- يؤدي هذا الإجراء إلى عرض وميض الصورة
vendor_boot
الجديدة.
- يستبدل رمز القرص الكامل للمورّد بالصورة المحدّدة بحيث تصبح الصورة المحددة الجزء الوحيد من القرص المضغوط للمورّد في صورة
- إذا كان تمهيد المورد هو رأس الإصدار 3، سيتم إجراء ما يلي:
fastboot flash vendor_boot:foo vendor-ramdisk.img
لجلب
vendor_boot image
، كما لو تم استدعاءfastboot fetch
.- إذا كان رأس تشغيل البائع هو الإصدار 3، فسيعرض خطأ.
إذا كان رأس تشغيل المورِّد هو الإصدار 4، سيتم إجراء ما يلي:
- للعثور على جزء ذاكرة الوصول العشوائي للمورّد الذي يحمل الاسم
foo
. إذا لم يتم العثور عليه، أو إذا كانت هناك مطابقات متعددة، فسيتم إرجاع خطأ. - لاستبدال جزء ذاكرة الوصول العشوائي للمورّد بالصورة المحددة.
- يعيد حساب كل حجم وإزاحة في جدول ذاكرة التخزين المؤقت للمورد.
- يؤدي هذا الإجراء إلى عرض وميض الصورة
vendor_boot
الجديدة.
- للعثور على جزء ذاكرة الوصول العشوائي للمورّد الذي يحمل الاسم
علامة mkbootimg
يتم استخدام الاسم default
لتسمية أجزاء ذاكرة الوصول العشوائي للمورّد في الإصدار 12 من Android والإصدارات الأحدث. ورغم أنّ دلالات flash vendor_boot:default
Fastboot تظل كما هي، يجب عدم تسمية أجزاء ramdisk باسم
default
.
التغييرات على SELinux
تم إجراء تغيير في
fastbootd.te
لدعم التدخُّل الذي يحدثه البائعون.