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

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

وتيرة إصدار GKI

يتم إصدار لوحة التحكّم في المفاتيح (GKI) وفقًا لسلسلة نقاط الوتيرة الشهرية بعد إيقاف خوارزمية KMI.

إصدار Android 13 و14 و15 GKI

لا يسري الجدول التالي إلا على android13-5.10، android13-5.15, أو android14-5.15 يمكنك الاطّلاع على تواريخ الإصدار في أيلول (سبتمبر) 2024 في هذا الإعلان.

الإصدارات المعتمدة شهريًا من GKI	تاريخ الموعد النهائي لتسجيل الوصول	تاريخ جاهزية التحميل المُسبَق في GKI	هل تم التأكيد؟
نوفمبر	11 تشرين الثاني (نوفمبر) 2024	27 تشرين الثاني (نوفمبر) 2024	نعم
كانون الثاني (يناير)	17 كانون الثاني (يناير) 2025	31 كانون الثاني (يناير) 2025	نعم
فبراير	14 شباط (فبراير) 2025	28 فبراير 2025	نعم

لا ينطبق الجدول التالي إلا على android14-6.1 و android15-6.6. يمكنك الاطّلاع على تواريخ الإصدار في أيلول (سبتمبر) 2024 في هذا الإعلان.

الإصدارات المعتمدة شهريًا من GKI	تاريخ الموعد النهائي لتسجيل الوصول	تاريخ جاهزية التحميل المُسبَق في GKI	هل تم التأكيد؟
تشرين الأول (أكتوبر)	1 أكتوبر 2024	14 تشرين الأول (أكتوبر) 2024	نعم
نوفمبر	1 تشرين الثاني (نوفمبر) 2024	15 تشرين الثاني (نوفمبر) 2024	نعم
ديسمبر	2 كانون الأول (ديسمبر) 2024	16 كانون الأول (ديسمبر) 2024	نعم
كانون الثاني (يناير)	6 كانون الثاني (يناير) 2025	22 كانون الثاني (يناير) 2025	نعم

إصدار Android 12 GKI

بعد أيار (مايو) 2024، تُعرَض إصدارات android12-5.10 من GKI بوتيرة ربع سنوية. يتم نشرها في منتصف الشهر. لا يسري الجدول التالي إلا على android12-5.10

الإصدارات المعتمدة شهريًا من GKI	تاريخ الموعد النهائي لتسجيل الوصول	تاريخ جاهزية التحميل المُسبَق في GKI	هل هذا صحيح؟
تموز (يوليو)	3 تموز (يوليو) 2023	14 تموز (يوليو) 2023	نعم
أيلول (سبتمبر)	1 أيلول (سبتمبر) 2023	15 أيلول (سبتمبر) 2023	نعم
نوفمبر	3 تشرين الثاني (نوفمبر) 2023	17 تشرين الثاني (نوفمبر) 2023	نعم
كانون الثاني (يناير)	5 يناير 2024	19 يناير 2024	نعم
مارس	4 مارس 2024	15 مارس 2024	نعم
مايو	1 مايو 2024	17 مايو 2024	نعم
آب (أغسطس)	1 آب (أغسطس) 2024	16 آب (أغسطس) 2024	نعم
نوفمبر	1 تشرين الثاني (نوفمبر) 2024	15 تشرين الثاني (نوفمبر) 2024	نعم
فبراير	3 شباط (فبراير) 2025	17 شباط (فبراير) 2025	نعم

ملاحظة: إنّ التواريخ خاضعة للتغيير.

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

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

إصدارات التطوير الأسبوعية

تم اختبار الإصدارات باستخدام حبّار. لضمان اجتيازهم معيار الجودة الأدنى.

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

الإصدارات المُعتمَدة الشهرية

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

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

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

عملية إعادة المراجعة في حالات الطوارئ

تشير إعادة التثبيت إلى عملية إعادة الدمج وإعادة الإنشاء وإعادة الاختبار إعادة اعتماد برنامج ثنائي بعد إصدار متاح للجميع من نواة GKI: يمكنك طلب إعادة مراجعة برنامج ثنائي معتمد لأي مما يلي: الظروف:

• لتعديل قائمة رموز، اتّبِع الخطوات التالية:
• لتطبيق إصلاح لأحد الأخطاء، بما في ذلك الأخطاء التي يتم العثور عليها أثناء الموافقة على اختبار مشغِّل شبكة الجوّال.
• لإضافة عنصر جذب للمورّدين
• لتطبيق رمز تصحيح على ميزة حالية.
• تطبيق رمز تصحيح الأمان (بعد 6 أشهر)

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

إرشادات طلب إعادة التثبيت

قبل طلب إعادة التثبيت، يُرجى ملاحظة الإرشادات التالية:

• لا يُسمح بإعادة التحميل إلا في فروع الإصدار بعد إصدار أوّلي علني من إصدار شهري إطلاق المنتج.

• لا تُقبل طلبات إعادة التثبيت إلا لفرع إصدار معيّن بعد ستة أشهر كحد أقصى من الإصدار العلني الأولي. بعد ستة أشهر، الفروع مؤهَّلة لإعادة الضبط فقط للتصحيحات الأمنية المذكورة في نشرة أمان Android.

• عند استيفاء متطلبات الدعم الطويل الأمد (LTS) تم تحديده بواسطة نشرة أمان Android (ASB) يتسبب في عدم توافق الفرع، يتم إيقاف الفرع. إعادة تثبيت الطلبات للفروع المتوقفة نهائيًا. تاريخ إيقاف برنامج GKI معيّن يتم إدراج فرع الإصدار في ملاحظات إصدار إصدار GKI الشهرية ضمن الإصدارات: بالنسبة إلى التخطيط المستقبلي، يتم تعديل متطلبات الدعم الطويل الأمد (LTS) في أيار (مايو) وتشرين الثاني (نوفمبر). سنويًا. على سبيل المثال، في android12-5.10-2023-07 الفرع (5.10.177) غير متاح لإعادة التثبيت بعد 1 أيار (مايو) 2024 لأنّ android12-5.10-2023-07 (5.10.177) لا يمتثل لمتطلبات الدعم الطويل الأمد (LTS) الخاصة بمعيار ASB-2024-05.

• لا تنطبق إعادة التثبيت إلا على إصلاحات الأخطاء العاجلة أو تحديثات قائمة الرموز أو لتطبيق رمز تصحيح لإصلاح ميزة حالية.

• يجب دمج جميع التصحيحات التي تنتقل إلى فرع الإصدار الشهري الفرع الرئيسي لتطوير GKI. على سبيل المثال، إذا كان التصحيح مطلوبًا إعادة عرض android12-5.10-2022-09، يجب أن يكون قد تم دمجه في android12-5.10

• ويجب اختيار التصحيحات من فرع تطوير GKI الرئيسي تحميل التصحيح إلى فرع الإصدار الشهري.

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

  درجة الأهمية	ضريبة ESRT
  الأداة 0	يوما عمل
  الأداة 1	‫5 أيام عمل
  الأداة 2	10 أيام عمل
  الأداة 3	15 يوم عمل

ملاحظة: يتم تعريف ESRT على أنه الوقت الذي يستغرقه تقديم برنامج ثنائي معتمد من برنامج GKI الثنائي يتضمّن الحل الذي وافقت عليه (من قِبل فريق GKI) وتمّت مراجعته (من قِبلك).

• يجب إرسال طلب إعادة تسجيل منفصل لكل فرع من فروع الإصدار. على سبيل المثال، إذا كان يلزم إجراء إعادة فحص لكلّ من android12-5.10-2022-08 و android12-5.10-2022-09، عليك إنشاء طلبَي إعادة فحص.

• بعد تقديم إصدار ووضع علامة "تم إصلاحه" على طلب إعادة الفحص، يجب عدم إعادة فتح طلب إعادة الفحص لإضافة طلبات إعادة فحص أخرى. يجب إرسال مستند طلب إعادة التثبيت إذا كانت هناك رموز تصحيح إضافية يجب دمجها.

• أضِف العلامات التالية لكل قائمة إحالات ناجحة حالية.

  • Bug: يجب إضافة معرّف الخطأ إلى رسالة الالتزام لكل CL.
  • Change-Id: يجب أن يكون مطابقًا لرقم تعريف التغيير لتغيير الفرع الأساسي.
  ملاحظة: يتم حظر التقدم في طلب إعادة التثبيت بدون هذه العلامات.

• إذا كان طلب إعادة التثبيت يتطلب ردك، ولم تردّ خلال ثلاثة أيام عمل، يتم خفض الأولوية بمقدار مستوى واحد (على سبيل المثال، تم خفض مستوى P0 إلى P1). إذا لم تردّ لمدة أسبوعين، فهذا يعني أنّ الخطأ هو تم وضع علامة لن يتم إصلاحه (قديم).

إرسال طلب إعادة التثبيت

يوضح الرسم التخطيطي التالي عملية إعادة التركيب. تبدأ العملية عندما يرسل شريك المصنّع الأصلي للجهاز (أنت) طلب إعادة التثبيت.

الشكل 2. عملية إعادة التثبيت

للمشاركة في عملية إعادة التثبيت:

1. املأ نموذج طلب تحديد معلومات GKI. والتواصل مع المدير التقني للحسابات في Google على الفور. هذا النموذج خطأ في طلب إعادة تحديد GKI. تظهر لك أخطاء طلب إعادة التثبيت (مقدِّم الطلب) وفريق GKI والأشخاص المحدّدين الذين تضيفهم إلى ملف الخاصة بالأخطاء البرمجية.
   • إذا كان لديك حل من قبل، يجب أن يشير الطلب إلى رمز التصحيح إرساله في AOSP حتى تتمكن Google من مراجعته. إذا تعذّر إرسال رمز التصحيح يجب إرفاق حزمة التصحيح كملف نصي بالطلب.
   • وإذا لم تكن قد أدخلت إصلاحًا، يجب أن يتضمّن الطلب أكبر قدر ممكن من المعلومات قدر الإمكان، بما في ذلك رقم إصدار النواة والسجلات، ولذلك تتيح Google أن يساعد في تصحيح المشكلة.
2. يراجع فريق Google GKI الطلب ويوافق عليه أو يعيد إسناده إليه إذا احتجت إلى مزيد من المعلومات.
3. بعد الاتفاق على حلّ المشكلة، يراجع رمز فريق Google GKI (CR+2) التغيير. تبدأ عملية المراجعة الإطار الزمني لـ ESRT. دمج فريق GKI وإنشائه واختباره للانحدار، ومصادقة على التغيير.
4. يتم إصدار الملف الثنائي على ci.android.com. وينتهي الإطار الزمني لبرنامج ESRT ويضع فريق Google GKI علامة على الطلب بأنّه تم إصلاحه ويشير إلى إصدار إعادة الطرح. يتم أيضًا نشر إصدار Respin على صفحة إصدارات إصدار صورة النواة (GKI) العامة:

مؤهلات GKI

أنواع إصدارات GKI	فرض الجودة	Notes
أسبوعيًا	اختبار الأسماك حذاء طويل مجموعة فرعية من VTS مجموعة فرعية من CTS	غير معتمَد. فقط للاختبار و جهاز يتم عرضه. لا يمكن استخدامها لتشغيل الأجهزة.
شهريًا (معتمد)	اختبار الأسماك حذاء طويل الإحالات الناجحة المحسّنة للعملاء المحتملين (VTS) مجموعة أدوات اختبار التوافق (CTS) الإحالة إلى اختبار الأجهزة حذاء طويل الإحالات الناجحة المحسّنة للعملاء المحتملين (VTS) مجموعة أدوات اختبار التوافق (CTS)
عمليات إعادة الدوران (معتمدة)	اختبار الأسماك حذاء طويل الإحالات الناجحة المحسّنة للعملاء المحتملين (VTS) مجموعة فرعية من CTS اختبار الأجهزة المرجعية حذاء طويل VTS	صُمِّمت هذه المنصة وفقًا لإصدار معتمد من 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 الثنائي (بما في ذلك رمز التصحيح الدوّار في حالات الطوارئ) استنادًا إلى أحدث قاعدة رموز برمجية؟

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

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

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

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

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

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

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