عملية إصدار صورة النواة (GKI) العامة

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

وتيرة إصدار GKI

يتم إصدار GKI كل ثلاثة أشهر بعد تجميد KMI.

صلاحية إصدار GKI للمصنّعين الأصليين للأجهزة

يمكن للمصنّعين الأصليين للأجهزة استخدام إصدار GKI من Android تم إصداره مؤخرًا. يمكن للمصنّعين الأصليين للأجهزة إطلاق إصدارات معتمَدة من GKI طالما أنّها متوافقة مع متطلبات النواة ذات الدعم الطويل الأمد (LTS) في نشرة أمان Android‏ (ASB).

إصدارات GKI بحجم 16 كيلوبايت

يتولّى فريق إصدار GKI طرح إصدارات GKI بحجم 16 كيلوبايت باستخدام وتيرة الإصدار ربع السنوية نفسها، واختبارات التأهيل، وعملية إعادة التجميع المتبعة في إصدارات GKI بحجم 4 كيلوبايت:

• الفروع المتوافقة:
  • android15-6.6 (اعتبارًا من يناير 2026)
  • android16-6.12 (اعتبارًا من مارس 2026)
  • android17-6.18 (اعتبارًا من يونيو 2026)
• التوافق والشهادة: تستخدم البرامج الثنائية GKI بحجم 16 كيلوبايت علامة المصدر ومعرّف إصدار النواة نفسيهما المستخدَمان في إصدار GKI بحجم 4 كيلوبايت. حتى عام 2027، ستوفّر علامة التبويب الإصدار 16 كيلوبايت في صفحات إصدارات android15-6.6 وandroid16-6.12 وandroid17-6.18 ثنائيات إصدار GKI غير معتمَدة بحجم 16 كيلوبايت. ليس عليك تحديث النواة المتوافقة مع الصفحات بحجم 4 كيلوبايت و16 كيلوبايت معًا، ولكن ننصحك بذلك.
• إعادة إنشاء الإصدارات عند الطلب: يمكنك طلب إعادة إنشاء إصدارات GKI بحجم 16 كيلوبايت باستخدام عملية ونموذج طلب إعادة إنشاء الإصدارات نفسهما المستخدَمَين في إصدارات 4 كيلوبايت.

الإصدارات المعتمَدة الربع سنوية

تحتوي إصدارات GKI الفصلية على boot.img تم اختباره ويتضمّن شهادة أدرجتها Google للتأكّد من أنّ الملفات الثنائية تم إنشاؤها من أساس معروف للرمز المصدري.

في كل ربع سنة، يتم اختيار إصدار محتمل ربع سنوي من GKI (غير معتمَد) بعد تاريخ انتهاء تسجيل الوصول. بعد اختيار الإصدار المحتمل الفصلي، لن يتم قبول أي تغييرات جديدة في إصدار ذلك الشهر. خلال فترة النافذة المغلقة، يمكن معالجة الأخطاء التي تؤدي إلى تعذُّر إجراء الاختبار فقط. يخضع الإصدار المرشّح لعملية ضمان الجودة، كما هو موضّح في قسم تأهيل GKI، وذلك للتأكّد من اجتياز اختبارات التوافق على إصدار GSI+GKI باستخدام جهاز مرجعي بالإضافة إلى Cuttlefish.

الشكل 1: المخطط الزمني لإصدارات GKI

مؤهّلات GKI

أين يمكن الحصول على عناصر الإصدار؟

يمكن للمصنّعين الأصليين للأجهزة الحصول على عناصر لجميع الإصدارات من ci.android.com.

يمكنك العثور على مزيد من المعلومات حول CI، بما في ذلك نتائج الاختبارات على لوحة بيانات الدمج المتواصل في Android.

الأسئلة الشائعة

في ما يلي بعض الأسئلة الشائعة حول عملية إصدار GKI.

هل يمكن إنشاء ملف ثنائي جديد لـ GKI استنادًا إلى GKI تم إصداره مسبقًا؟

نعم، يُعرف ذلك باسم إعادة التدوير. تتوفّر عملية إعادة الإصدار طالما أنّ إصدار GKI الذي تم طرحه (والذي تم طلب إعادة إصداره) متوافق مع متطلبات الدعم الطويل الأمد (LTS) في نشرة أمان Android‏ (ASB).

هل يمكن إعادة إنتاج ملفات GKI الثنائية؟

نعم، إليك مثالاً:

GKI 2.0
5.10 kernel prebuilts from build 7364300
https://ci.android.com/builds/submitted/7364300/kernel_aarch64/latest

لإعادة إنشاء المثال، نزِّل manifest_$id.xml ونفِّذ الأمر التالي:

repo init -u https://android.googlesource.com/kernel/manifest
mv manifest_7364300.xml .repo/manifests
repo init -m manifest_7364300.xml --depth=1
repo sync
# build the GKI images
# You may want to use LTO=thin to build faster for development
BUILD_CONFIG=common/build.config.gki.aarch64 build/build.sh
# (optional) build virtual platform modules
BUILD_CONFIG=common-modules/virtual-device/build.config.virtual_device.aarch64 build/build.sh

يمكنك استرداد نسخة من ملف GKI من out/.../dist.

هل تم إنشاء ملف GKI الثنائي (بما في ذلك تصحيح الإصدار الطارئ) على أحدث قاعدة رموز برمجية؟

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

• قرّرت الشركتان OEM1 وOEM2 استخدام إصدار GKI الثنائي من نوفمبر 2021.
• يرصد المصنّع الأصلي للجهاز 1 والمصنّع الأصلي للجهاز 2 مشاكل تتطلّب توفير تصحيحات للحصول على الدعم. وقد تكون هذه التصحيحات مختلفة أو متطابقة.
• تتضمّن عمليات إعادة الإصدار فوق الملف الثنائي لشهر نوفمبر 2021 إصلاحات تحظر الإطلاق أبلغت عنها كل من الشركة المصنّعة للأجهزة الأصلية 1 والشركة المصنّعة للأجهزة الأصلية 2 خلال فترة إعادة الإصدار، ولكن ليس أكثر من ذلك.
• المشاكل المذكورة في النقطة الثانية مضمّنة أيضًا في الإصدارات الربع سنوية اللاحقة من GKI.

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

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

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

هل هناك حالات تقدّم فيها Google معلومات محدّدة حول تصحيحات المصنّعين الأصليين للأجهزة وسيناريوهات المشاكل، حتى يتمكّن المصنّعون الأصليون للأجهزة من تقييم تأثير ومخاطر تنفيذ التصحيحات في منتجاتهم؟

لن تضيف Google أي تغيير إلى إصدار مُعاد إنشاؤه إلا بعد أن يفهم فريق GKI المشكلة ويجمع كل التفاصيل. يمكنك الاطّلاع على ذلك في سجلّ التغييرات (رسالة الإضافة). لا تكشف Google عن الجهاز المحدّد الذي يتأثر بالمشكلة، ولكن يمكن للمصنّعين الأصليين للأجهزة دائمًا العثور على وصف المشكلة والحل في سجلّ التغييرات.