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

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

وتيرة إصدار GKI

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

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

لا ينطبق الجدول التالي إلا على android13-5.10 وandroid13-5.15 وandroid14-6.1.

الإصدارات المعتمدة شهريًا من GKI تاريخ الموعد النهائي لتسجيل الوصول تاريخ جاهزية التحميل المُسبَق في GKI هل تم التأكيد؟
تشرين الأول (أكتوبر) 14 تشرين الأول (أكتوبر) 2022 31 تشرين الأول (أكتوبر) 2022 نعم
نوفمبر 14 تشرين الثاني (نوفمبر) 2022 30 تشرين الثاني (نوفمبر) 2022 نعم
ديسمبر 9 كانون الأول (ديسمبر) 2022 21 كانون الأول (ديسمبر) 2022 نعم
كانون الثاني (يناير) 17 كانون الثاني (يناير) 2023 31 كانون الثاني (يناير) 2023 نعم
فبراير 15 شباط (فبراير) 2023 28 شباط (فبراير) 2023 نعم
مارس 15 آذار (مارس) 2023 31 آذار (مارس) 2023 نعم
أبريل 13 نيسان (أبريل) 2023 28 نيسان (أبريل) 2023 نعم
مايو 17 أيار (مايو) 2023 31 أيار (مايو) 2023 نعم
حزيران (يونيو) 15 حزيران (يونيو) 2023 30 حزيران (يونيو) 2023 نعم
تموز (يوليو) 18 تموز (يوليو) 2023 31 تموز (يوليو) 2023 نعم
آب (أغسطس) 16 آب (أغسطس) 2023 ‫31 أغسطس 2023 نعم
أيلول (سبتمبر) 14 أيلول (سبتمبر) 2023 29 أيلول (سبتمبر) 2023 نعم
تشرين الأول (أكتوبر) 18 تشرين الأول (أكتوبر) 2023 31 تشرين الأول (أكتوبر) 2023 نعم
نوفمبر 10 تشرين الثاني (نوفمبر) 2023 30 تشرين الثاني (نوفمبر) 2023 نعم
ديسمبر 7 كانون الأوّل (ديسمبر) 2023 22 كانون الأول (ديسمبر) 2023 نعم
كانون الثاني (يناير) 16 يناير 2024 31 يناير 2024 نعم
فبراير 13 فبراير 2024 29 فبراير 2024 نعم
مارس ‫13 آذار (مارس) 2024 29 مارس 2024 نعم
أبريل 16 أبريل 2024 30 أبريل 2024 نعم
مايو 14 مايو 2024 31 مايو 2024 نعم
حزيران (يونيو) 12 يونيو 2024 28 يونيو 2024 نعم
تموز (يوليو) 16 يوليو 2024 31 يوليو 2024 نعم
آب (أغسطس) 15 أغسطس 2024 30 أغسطس 2024 نعم
أيلول (سبتمبر) 17 سبتمبر 2024 30 سبتمبر 2024 نعم
تشرين الأول (أكتوبر) 15 تشرين الأول (أكتوبر) 2024 31 تشرين الأول (أكتوبر) 2024 نعم
نوفمبر 11 تشرين الثاني (نوفمبر) 2024 27 تشرين الثاني (نوفمبر) 2024 نعم
ديسمبر 6 كانون الأول (ديسمبر) 2024 23 كانون الأول (ديسمبر) 2024 نعم

اعتبارًا من كانون الثاني (يناير) 2024، سنستأنف الإصدارات الشهرية من android14-5.15. وفقًا لسلسلة نقاط التواصل الشهرية المحددة الموضّحة في الجدول أدناه. سيتّبع android15-6.6 وتيرة طرح التطبيقات نفسها اعتبارًا من يوليو 2024.

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

إصدار 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 الثنائية للخدمة الذاتية من خلال ci.android.com. عند دمج التغييرات. لن يتم اعتماد الإصدارات الأسبوعية، ولكن يمكن استخدامها أساسًا للتطوير والاختبار. لا يمكن استخدام الإصدارات الأسبوعية من أجل إصدارات أجهزة الإنتاج للمستخدمين النهائيين.

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

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

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

المخطط الزمني لوتيرة إصدار 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 يوم عمل

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

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

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

    • 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. يتم أيضًا نشر إصدار Respin على صفحة إصدارات إصدار صورة النواة (GKI) العامة:

مؤهلات GKI

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

مكان الحصول على عناصر التصميم

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

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

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

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