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

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

وتيرة إصدار GKI

يتم إصدار GKI بوتيرة ربع سنوية بعد إيقاف KMI.

صلاحية إصدار GKI لمصنّعي المعدات الأصلية

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

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

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

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

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

مؤهلات GKI

مكان الحصول على عناصر الإنشاء

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

يمكنك العثور على مزيد من المعلومات حول عملية الدمج المتواصل، بما في ذلك نتائج الاختبارات، في لوحة بيانات عملية الدمج المتواصل في 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 الثنائي إصلاحات لحظر التشغيل أبلغ عنها كل من OEM1 وOEM2 خلال فترة إعادة الإنتاج، ولكن لا تتضمّن أي إصلاحات أخرى.
• يتم أيضًا تضمين المشاكل المذكورة في النقطة الثانية في الإصدارات الربع سنوية اللاحقة من GKI.

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

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

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

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

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