يوضِّح هذا المستند كيفية إصدار 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 باستخدام جهاز مرجعي بالإضافة إلى الحبار.
الشكل 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. عملية إعادة التثبيت
للمشاركة في عملية إعادة التثبيت:
- املأ نموذج طلب تحديد معلومات GKI.
والتواصل مع المدير التقني للحسابات في Google على الفور. هذا النموذج
خطأ في طلب إعادة تحديد GKI. تظهر لك أخطاء طلب إعادة التثبيت
(مقدِّم الطلب) وفريق GKI والأشخاص المحدّدين الذين تضيفهم إلى ملف
الخاصة بالأخطاء البرمجية.
- إذا كان لديك حل من قبل، يجب أن يشير الطلب إلى رمز التصحيح إرساله في AOSP حتى تتمكن Google من مراجعته. إذا تعذّر إرسال رمز التصحيح يجب إرفاق حزمة التصحيح كملف نصي بالطلب.
- وإذا لم تكن قد أدخلت إصلاحًا، يجب أن يتضمّن الطلب أكبر قدر ممكن من المعلومات قدر الإمكان، بما في ذلك رقم إصدار النواة والسجلات، ولذلك تتيح Google أن يساعد في تصحيح المشكلة.
- يراجع فريق Google GKI الطلب ويوافق عليه أو يعيد إسناده إليه إذا احتجت إلى مزيد من المعلومات.
- بعد الاتفاق على حلّ المشكلة، يراجع رمز فريق Google GKI (CR+2) التغيير. تبدأ عملية المراجعة الإطار الزمني لـ ESRT. دمج فريق GKI وإنشائه واختباره للانحدار، ومصادقة على التغيير.
- إطلاق البرنامج الثنائي ci.android.com. تشير رسالة الأشكال البيانية ينتهي الإطار الزمني لـ ESRT ويضع فريق Google GKI الطلب على أنّه ثابت الإشارة إلى إصدار respin. يتم أيضًا نشر إصدار Respin على صفحة إصدارات إصدار صورة النواة (GKI) العامة:
مؤهلات GKI
أنواع إصدارات GKI | فرض الجودة | Notes |
---|---|---|
أسبوعيًا | اختبار الأسماك
|
|
شهريًا (معتمد) | اختبار الأسماك
|
|
إعادة التثبيت (معتمدة) | اختبار الأسماك
|
|
مكان الحصول على عناصر التصميم
يمكن الحصول على عناصر جميع الإصدارات من 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 عن نوع الجهاز المحدّد الذي تؤثر فيه، ولكنها يمكن للمصنّعين الأصليين للأجهزة دائمًا العثور على وصف المشكلة وحلها في سجل التغييرات.