فرایند انتشار «تصویر هسته عمومی» (GKI)

این صفحه نحوه انتشار GKI را شرح می‌دهد، ازجمله انتشار اضطراری فصلی و خارج‌از باند. هدف این صفحه ارائه دستورالعملی به سازندگان اصلی سخت‌افزار درباره محل دریافت GKI و همچنین فرایند اصلاحات اضطراری خارج‌از باند است. تولیدکنندگان اصلی سخت‌افزار همچنین می‌توانند از توسعه GKI استفاده کنند تا درباره نحوه همکاری با تیم هسته Android برای بهینه‌سازی هسته GKI برای محصولاتشان بیشتر بدانند.

سرعت انتشار GKI

GKI به‌صورت فصلی پس‌از توقف KMI منتشر می‌شود.

ماه انتشار a12-5.10 a13-5.10 a13-5.15 a14-5.15 a14-6.1 a15-6.6* a16-6.12* a17-6.18* a18-7.3*
اکتبر
۲۰۲۶
اعلام حضور
قطع شد
‫۱۶ اکتبر‫۱۶ اکتبر‫۱ اکتبر‫۱ اکتبر
پیش‌بارگیری GKI آماده است ‫۳۱ اکتبر‫۳۱ اکتبر‫۱۵ اکتبر‫۱۵ اکتبر
‫نوامبر
۲۰۲۶
این ماه نسخه‌ای منتشر نمی‌شود.
دسامبر
۲۰۲۶
اعلام حضور
قطع شد
۱ دسامبر۱ دسامبر۱ دسامبر۱ دسامبر
پیش‌بارگیری GKI آماده است ‫۱۵ دسامبر‫۱۵ دسامبر‫۱۵ دسامبر‫۱۵ دسامبر
ژانویه
۲۰۲۷
اعلام حضور
قطع شد
۱۶ ژانویه۱۶ ژانویه‫۲ ژانویه‫۲ ژانویه
پیش‌بارگیری GKI آماده است ۳۱ ژانویه۳۱ ژانویه‫۱۵ ژانویه‫۱۵ ژانویه
فوریه
۲۰۲۷
این ماه نسخه‌ای منتشر نمی‌شود.
مارس
۲۰۲۷
اعلام حضور
قطع شد
‫۱ مارس۱۶ مارس۱۶ مارس‫۱ مارس
پیش‌بارگیری GKI آماده است ‫۱۵ مارس۳۱ مارس۳۱ مارس‫۱۵ مارس
آوریل
۲۰۲۷
اعلام حضور
قطع شد
۱ آوریل۱ آوریل
پیش‌بارگیری GKI آماده است ‫۱۵ آوریل‫۱۵ آوریل
مه
۲۰۲۷
این ماه نسخه‌ای منتشر نمی‌شود.
ژوئن
۲۰۲۷
اعلام حضور
قطع شد
۱ ژوئن۱۵ ژوئن۱۵ ژوئن۱ ژوئن
پیش‌بارگیری GKI آماده است ۱۵ ژوئن‫۳۰ ژوئن‫۳۰ ژوئن۱۵ ژوئن
ژوئیه
۲۰۲۷
اعلام حضور
قطع شد
۱ ژوئیه۱ ژوئیه۱ ژوئیه
پیش‌بارگیری GKI آماده است ‫۱۵ ژوئیه‫۱۵ ژوئیه‫۱۵ ژوئیه
اوت
۲۰۲۷
این ماه نسخه‌ای منتشر نمی‌شود.
سپتامبر
۲۰۲۷
اعلام حضور
قطع شد
‫۱ سپتامبر‫۱۶ سپتامبر‫۱۶ سپتامبر‫۱ سپتامبر
پیش‌بارگیری GKI آماده است ‫۱۵ سپتامبر‫۳۰ سپتامبر‫۳۰ سپتامبر‫۱۵ سپتامبر
اکتبر
۲۰۲۷
اعلام حضور
قطع شد
‫۱ اکتبر‫۱ اکتبر‫۱ اکتبر
پیش‌بارگیری GKI آماده است ‫۱۵ اکتبر‫۱۵ اکتبر‫۱۵ اکتبر
نوامبر
۲۰۲۷
این ماه نسخه‌ای منتشر نمی‌شود.
دسامبر
۲۰۲۷
اعلام حضور
قطع شد
۱ دسامبر۱ دسامبر۱ دسامبر۱ دسامبر
پیش‌بارگیری GKI آماده است ‫۱۵ دسامبر‫۱۵ دسامبر‫۱۵ دسامبر‫۱۵ دسامبر

اعتبار ساخت GKI برای سازندگان اصلی محصول

سازندگان تجهیزات اصلی می‌توانند از GKI Android که اخیراً منتشر شده است استفاده کنند. تولیدکنندگان اصلی سخت‌افزار می‌توانند با ساخت‌های دارای گواهینامه GKI راه‌اندازی کنند، به‌شرطی که با الزامات هسته «پشتیبانی‌شده بلندمدت» (LTS) در «بولتن امنیتی Android» (ASB) مطابقت داشته باشند.

نسخه‌های پخش تصویر هسته عمومی ۱۶ کیلوبایتی

تیم انتشار GKI نسخه‌های پخش GKI‏ ۱۶ کیلوبایتی را بااستفاده از همان آهنگ انتشار فصلی، آزمایش صلاحیت، و فرایند بازچرخش نسخه‌های پخش GKI‏ ۴ کیلوبایتی مدیریت می‌کند:

  • شعبه‌های پشتیبانی‌شده:
    • android15-6.6 (از ژانویه ۲۰۲۶)
    • ‫android16-6.12 (از مارس ۲۰۲۶)
    • android17-6.18 (از ژوئن ۲۰۲۶)
    • android18-7.3 (از ژوئیه ۲۰۲۷)
  • برابری ساخت و گواهینامه: دودویی‌های GKI‏ ۱۶ کیلوبایتی از همان برچسب منبع و شناسه ساخت هسته نسخه GKI‏ ۴ کیلوبایتی مربوطه استفاده می‌کنند. تا سال ۲۰۲۷، برگه ساخت نسخه پخش ۱۶ کیلوبایتی در صفحه‌های ساخت نسخه پخش android15-6.6، android16-6.12، و android17-6.18 دودویی‌های ساخت نسخه پخش GKI‏ ۱۶ کیلوبایتی تأییدنشده را ارائه می‌دهد. نیازی نیست هسته‌های ۴ کیلوبایتی و ۱۶ کیلوبایتی را باهم به‌روز کنید، اما توصیه می‌کنیم این کار را انجام دهید.
  • بازچرخه‌های درخواستی: بازچرخه‌های GKI‏ ۱۶ کیلوبایتی را بااستفاده از همان فرایند و فرم درخواست بازچرخه برای ساخت‌های ۴ کیلوبایتی درخواست کنید.

نسخه‌های تأییدشده فصلی

نسخه‌های فصلی GKI حاوی boot.img آزمایش‌شده‌ای است که شامل گواهی درج‌شده Google است تا گواهی دهد که دودویی‌ها از خط مبنای کد منبع شناخته‌شده‌ای ساخته شده‌اند.

هر سه‌ماه، یک نامزد انتشار سه‌ماهه GKI (تأییدنشده) پس‌از تاریخ قطع اعلام حضور انتخاب می‌شود. پس‌از انتخاب نامزد انتشار فصلی، تغییرات جدید در انتشار آن ماه پذیرفته نخواهد شد. درطول دوره پنجره بسته، فقط رفع اشکال‌هایی که باعث آزمایش ناموفق می‌شوند قابل رسیدگی است. نامزد انتشار تحت تضمین کیفیت قرار می‌گیرد—همان‌طور که در بخش صلاحیت GKI شرح داده شده است—تا تأیید شود که آزمایش‌های انطباق در ساخت GSI+GKI با دستگاه مرجع و همچنین Cuttlefish موفقیت‌آمیز است.

زمان‌بندی
آهنگ انتشار GKI شکل ۱. خط زمان انتشار GKI

شرایط لازم GKI

انواع ساخت‌های GKI اجرای کیفیت نکته‌ها
سه‌ماهه (تأییدشده) آزمایش Cuttlefish
  • راه‌اندازی
  • VTS
  • مجموعه آزمایش سازگاری
آزمایش سخت‌افزار مرجع
  • راه‌اندازی
  • VTS
  • مجموعه آزمایش سازگاری
بازچرخش‌ها (تأییدشده) آزمایش Cuttlefish
  • راه‌اندازی
  • 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 (ازجمله وصله چرخش اضطراری) در جدیدترین پایگاه کد ساخته شده است؟

نه. بازچرخه‌ها فقط حاوی وصله‌هایی هستند که در بالای هسته‌های تأییدشده فصلی انتخاب‌شده قرار دارند. این نسخه‌های اصلاح‌شده حاوی همه رفع اشکال‌های مسدودکننده راه‌اندازی است که تا زمان مشخصی توسط سازندگان اصلی تجهیزات بااستفاده از نسخه فصلی پایه مربوطه گزارش شده است. مثال زیر را ببینید که نشان می‌دهد این نوع سناریو چگونه اتفاق می‌افتد.

  • OEM1 و OEM2 تصمیم می‌گیرند از نسخه دودویی GKI از نوامبر ۲۰۲۱ استفاده کنند.
  • OEM1 و OEM2 مشکلاتی را پیدا می‌کنند که برای پشتیبانی به وصله نیاز دارند. این وصله‌ها ممکن است متفاوت یا یکسان باشند.
  • نسخه‌های اصلاح‌شده روی باینری نوامبر ۲۰۲۱ دارای اصلاحات مسدودکننده راه‌اندازی هستند که توسط OEM1 و OEM2 درطول پنجره نسخه اصلاح‌شده گزارش شده‌اند، اما نه بیشتر.
  • مشکلات ذکرشده در مورد دوم نیز در نسخه‌های فصلی بعدی GKI گنجانده شده‌اند.

نسخه اصلاحی اکتبر همه وصله‌های ارسالی OEM را دارد، اما وصله‌های OEM دیگر بر ما تأثیر می‌گذارند، زیرا به‌طور خاص با محصولات ما آزمایش نشده‌اند. آیا ممکن است فقط وصله ما را اضافه کنید؟

این کار ممکن نیست. مسیر بازطراحی برای OEMهای تکی مقیاس‌پذیر نیست. درعوض، تیم GKI هر تغییری را که در ساخت‌های respin اعمال می‌شود به‌دقت بررسی می‌کند و تغییرات را با همه سخت‌افزارهای دردسترس قبل‌از ایجاد ساخت جدید آزمایش می‌کند. اگر تیم GKI متوجه شود که مشکل مختص یک OEM، دستگاه، یا مدل است، تیم GKI می‌تواند تأیید کند که کد اضافه‌شده توسط تغییر فقط در دستگاه، مدل، یا SKU تحت‌تأثیر اجرا می‌شود.

مزیت اصلی بازچرخه‌های یکپارچه این است که هر دستگاهی که از همان پایه انتشار استفاده می‌کند، از یکدیگر بهره‌مند می‌شود، به‌ویژه اگر اشکالاتی که کشف می‌کنند عمومی و برای همه کاربران قابل‌اجرا باشد. اشکالات هسته اصلی که در آزمایش شرکت مخابراتی پیدا می‌شود نمونه خاصی از این مفهوم است.

آیا شرایطی وجود دارد که Google اطلاعات خاصی درباره وصله‌های OEM و سناریوهای مشکل ارائه دهد تا OEMها بتوانند تأثیر و خطر اجرای وصله‌ها را با محصولاتشان ارزیابی کنند؟

Google هرگز تغییری به ساخت بازچرخشی اضافه نمی‌کند تا زمانی که تیم GKI مشکل را درک کند و همه جزئیات را جمع‌آوری کند. می‌توانید این را در گزارش تغییرات (پیام ثبت) ببینید. Google مشخص نمی‌کند که این مشکل بر کدام دستگاه خاص تأثیر می‌گذارد، اما سازندگان تجهیزات اصلی همیشه می‌توانند شرح مشکل و راه‌حل آن را در گزارش تغییرات پیدا کنند.