ضبط ميزات النواة كوحدات GKI

تتناول هذه الصفحة كيفية ضبط ميزة جديدة في kernel كوحدة GKI أو ضبط ميزة kernel مدمجة حالية كوحدة GKI.

ضبط ميزة جديدة كوحدة GKI

  1. بالنسبة إلى الميزة الجديدة، عدِّل gki_defconfig واضبط ملف تكوين ميزة kernel المطلوبة من n إلى m (=m). اضبط هذا الإعداد في كلٍّ من arch/arm64/configs/gki_defconfig وarch/x86/configs/gki_defconfig.

  2. أضِف ملفات KO (.ko) التي تم إنشاؤها للميزة إلى قسم COMMON_GKI_MODULES_LIST في common/modules.bzl. أضِف الملفات بترتيب تصاعدي. إذا لم تكن متأكدًا من جميع الملفات التي تم إنشاؤها، فسيفشل الإصدار ويعرض جميع ملفات KO الضرورية التي ستتم إضافتها إلى القائمة.

  3. أضِف المجموعة نفسها من ملفات KO من الخطوة 2، مرتبةً بترتيب تصاعدي لبحث ملف ثنائي أثناء التشغيل، إلى common/android/gki_{ARCH}_protected_modules لتحديد الوحدة على أنّها وحدة GKI محمية. عدِّل قائمة عمليات التصدير المحمية لتضمين عمليات التصدير من الوحدة التي تمت إضافتها حديثًا في common/android/abi_gki_protected_exports_{ARCH} باستخدام tools/bazel run //common:kernel_aarch64_abi_update_protected_exports لـ aarch64. يجب أن تحصل الوحدات المصنّفة على أنّها وحدات GKI محمية على موافقة Google لتكون وحدات محمية رسمية.

  4. تأكَّد من نسخ ملفات KO التي تمت إضافتها حديثًا من الخطوة 2 إلى ملفَي ‎ out/<androidX-Y.Z>/dist/system_dlkm.img و‎ out/androidX-Y.Z/dist/system_dlkm_staging_archive.tar.gz الخاصَّين بالنواة. يمكن استخدام الوحدات في أرشيف system_dlkm_staging_archive.tar.gz كข้อมูล لإنشاء system_dlkm.img في إصدار المنصة.

  5. يمكنك إرسال التغييرات للمراجعة. وحدات GKI هي ميزة خاصة بالنواة في نظام التشغيل Android فقط، لذا لا يُشترط إرسال تصحيحات تحويل الوحدات إلى الإصدار العلني. ومع ذلك، عليك اتّباع إرشادات أخرى لإرسال تصحيحات "النواة الشائعة لنظام التشغيل Android" (ACK).

ضبط ميزة مضمّنة في النواة على أنّها وحدة GKI

  1. بالنسبة إلى ميزة kernel مضمّنة حالية، عدِّل gki_defconfig واضبط عنصر إعدادات ميزة kernel المطلوبة من y إلى m (=m). اضبط هذا الإعداد في كلّ من arch/arm64/configs/gki_defconfig و arch/x86/configs/gki_defconfig.

  2. أضِف ملفات KO (.ko) التي تم إنشاؤها لهذه الميزة إلى القسم "COMMON_GKI_MODULES_LIST" في common/modules.bzl. أضف الملفات بترتيب مصنف. إذا لم تكن متأكدًا من جميع الملفات التي تم إنشاؤها، يتعذّر إنشاء الحزمة ويتم إدراج جميع ملفات KO اللازمة لإضافتها إلى القائمة.

  3. أضِف مجموعة ملفات KO نفسها الواردة في الخطوة 2، مع ترتيبها تصاعديًا للبحث الثنائي في وقت التشغيل، إلى common/android/gki_{ARCH}_protected_modules لتصنيف الوحدة كوحدة GKI محمية. يمكنك تعديل قائمة عمليات التصدير المحمية لتضمين عمليات التصدير من الوحدة المضافة حديثًا في common/android/abi_gki_protected_exports_{ARCH} باستخدام السمة tools/bazel run //common:kernel_aarch64_abi_update_protected_exports الخاصّة بـ aarch64. يجب أن تحصل الوحدات المصنّفة على أنّها وحدات GKI محمية على موافقة Google لتكون وحدات محمية رسمية.

  4. تأكَّد من نسخ ملفات KO للوحدات التي تم تحويلها حديثًا من الخطوة 2 إلى out/<androidX-Y.Z>/dist/system_dlkm.img و out/androidX-Y.Z/dist/system_dlkm_staging_archive.tar.gz في kernel. يمكن استخدام الوحدات في أرشيف system_dlkm_staging_archive.tar.gz كإدخال لإنشاء system_dlkm.img في إصدار المنصة.

  5. أرسِل التغييرات لمراجعتها. وحدات GKI هي ميزة نواة في Android فقط، لذا لا يُشترَط إرسال رموز تصحيح تحويل الوحدات قبل إطلاقها. ومع ذلك، يجب اتّباع الإرشادات الأخرى لإرسال تصحيحات النواة المشتركة لنظام التشغيل Android (ACK).

تحويل وحدة GKI محمية إلى وحدة غير محمية

  1. أزِل الوحدة التي يتم تحويلها من محمية إلى غير محمية من قائمة الوحدات المحمية في common/android/gki_protected_modules.

  2. يمكنك تعديل قائمة عمليات التصدير المحمية لاستبعاد تلك التي تم تصديرها من الوحدة غير المحمية التي تم تحويلها حديثًا في common/android/abi_gki_protected_exports_{ARCH} باستخدام السمة tools/bazel run //common:kernel_aarch64_abi_update_protected_exports في aarch64.

  3. يمكنك إرسال التغييرات للمراجعة. وحدات GKI هي ميزة خاصة بالنواة في نظام التشغيل Android فقط، لذا لا يُشترط إرسال تصحيحات تحويل الوحدات إلى الإصدار العلني. ومع ذلك، يجب اتّباع الإرشادات الأخرى لإرسال تصحيحات النواة المشتركة لنظام التشغيل Android (ACK).

الدليل السريع لتحديد دقة رموز وحدات GKI

عندما تنتهك الوحدات غير الموقَّعة حماية الرموز المُطبَّقة على وحدات GKI، قد تظهر نوعان من الأخطاء أثناء تحميل الوحدة، ما يؤدي إلى تعذُّر تحميلها.

1. وحدة غير موقَّعة تستخدم الرمز المحمي

الخطأ:

module: Protected symbol: some_kernel_function (err -13)

السبب:

ملف module.ko هو وحدة مورّد غير موقَّعة وتحاول حلّ رمز some_kernel_function الذي تم تصديره من وحدة GKI أثناء التحميل، بدون أن يتم إدراجه في قائمة رموز المورّدين.

الحل:

إذا لم تكن module.ko وحدة GKI محمية، سيؤدي تعديل قائمة الرموز إلى حلّ الخطأ عن طريق تضمين some_kernel_function في قائمة رموز المورّدين. يمكنك بدلاً من ذلك استخدام إصدار GKI من module.ko.

‫2- وحدة غير موقَّعة تصدِّر الرمز المحمي

الخطأ:

module: exports protected symbol some_kernel_function

السبب:

الوحدة التي تُصدِّر some_kernel_function هي وحدة GKI محمية، ومن المرجّح أنّmodule.ko هو إصدار مخصّص غير موقَّع من هذه الوحدة. عندما يحاول module.ko تصدير some_kernel_function، الذي لا يمكن تصديره إلا باستخدام وحدة GKI موقَّعة، يتعذّر التحميل مع ظهور هذه الرسالة.

حلّ المشكلة:

يمكن تصحيح ذلك باستخدام إصدار GKI من الوحدة التي تصدِّر some_kernel_function، إذا كانت الوحدة غير الموقَّعة هي إصدار مخصّص.