תהליך הפצה גנרי של תמונת ליבה (GKI)

בדף הזה מוסבר איך GKI מתפרסם, כולל גרסאות חירום רבעוניות וגרסאות חירום מחוץ לתחום. מטרת הדף הזה היא לספק ליצרני ציוד מקורי (OEM) הנחיות לגבי המקום שבו אפשר לקבל את ה-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*
אוקטובר
2026
מועד אחרון
לצ'ק-אין
‫16 באוקטובר‫16 באוקטובר‫1 באוקטובר‫1 באוקטובר
הטעינה מראש של GKI מוכנה ‫31 באוקטובר‫31 באוקטובר‫15 באוקטובר‫15 באוקטובר
נובמבר
2026
אין גרסה חדשה החודש.
דצמבר
2026
מועד אחרון
לצ'ק-אין
‫1 בדצמבר‫1 בדצמבר‫1 בדצמבר‫1 בדצמבר
הטעינה מראש של GKI מוכנה ‫15 בדצמבר‫15 בדצמבר‫15 בדצמבר‫15 בדצמבר
ינואר
2027
מועד אחרון
לצ'ק-אין
‫16 בינואר‫16 בינואר‫2 בינואר‫2 בינואר
הטעינה מראש של GKI מוכנה ‫31 בינואר‫31 בינואר‫15 בינואר‫15 בינואר
פברואר
2027
אין גרסה חדשה החודש.
מרץ
2027
מועד אחרון
לצ'ק-אין
‫1 במרץ‫16 במרץ‫16 במרץ‫1 במרץ
הטעינה מראש של GKI מוכנה 15 במרץ31 במרץ31 במרץ15 במרץ
אפריל
2027
מועד אחרון
לצ'ק-אין
‫1 באפריל‫1 באפריל
הטעינה מראש של GKI מוכנה ‫15 באפריל‫15 באפריל
מאי
2027
אין גרסה חדשה החודש.
יוני
2027
מועד אחרון
לצ'ק-אין
‫1 ביוני‫15 ביוני‫15 ביוני‫1 ביוני
הטעינה מראש של GKI מוכנה ‫15 ביוני‫30 ביוני‫30 ביוני‫15 ביוני
יולי
2027
מועד אחרון
לצ'ק-אין
‫1 ביולי‫1 ביולי‫1 ביולי
הטעינה מראש של GKI מוכנה ‫15 ביולי‫15 ביולי‫15 ביולי
אוגוסט
2027
אין גרסה חדשה החודש.
ספטמבר
2027
מועד אחרון
לצ'ק-אין
‫1 בספטמבר‫16 בספטמבר‫16 בספטמבר‫1 בספטמבר
הטעינה מראש של GKI מוכנה ‫15 בספטמבר‫30 בספטמבר‫30 בספטמבר‫15 בספטמבר
אוקטובר
2027
מועד אחרון
לצ'ק-אין
‫1 באוקטובר‫1 באוקטובר‫1 באוקטובר
הטעינה מראש של GKI מוכנה ‫15 באוקטובר‫15 באוקטובר‫15 באוקטובר
נובמבר
2027
אין גרסה חדשה החודש.
דצמבר
2027
מועד אחרון
לצ'ק-אין
‫1 בדצמבר‫1 בדצמבר‫1 בדצמבר‫1 בדצמבר
הטעינה מראש של GKI מוכנה ‫15 בדצמבר‫15 בדצמבר‫15 בדצמבר‫15 בדצמבר

תוקף גרסת ה-GKI ליצרני ציוד מקורי (OEM)

יצרני ציוד מקורי (OEM) יכולים להשתמש ב-GKI של Android שפורסם לאחרונה. יצרני ציוד מקורי (OEM) יכולים להשיק גרסאות build עם אישור GKI, כל עוד הן עומדות בדרישות של ליבה עם תמיכה לטווח ארוך (LTS) שמפורטות בחדשות האבטחה של Android‏ (ASB).

גרסאות GKI של 16KB

צוות ההפצה של GKI מטפל בהפצות של GKI בגודל 16KB באותו קצב הפצה רבעוני, באותן בדיקות התאמה ובאותו תהליך של הפצה מחדש כמו בהפצות של GKI בגודל 4KB:

  • סניפים נתמכים:
    • android15-6.6 (החל מינואר 2026)
    • android16-6.12 (החל ממרץ 2026)
    • ‫android17-6.18 (החל מיוני 2026)
    • android18-7.3 (החל מיולי 2027)
  • תאימות ואישור של גרסאות build: קובצי GKI בינאריים בגודל 16KB משתמשים באותו תג מקור ובאותו מזהה build של ליבה כמו בגרסת GKI תואמת בגודל 4KB. עד 2027, הכרטיסייה גרסת build להפצה של 16KB בדפים של גרסאות ה-build להפצה של android15-6.6,‏ android16-6.12 ו-android17-6.18 מספקת קובצי GKI בינאריים להפצה של 16KB ללא אישור. לא חובה לעדכן את הליבות של 4KB ו-16KB ביחד, אבל מומלץ לעשות את זה.
  • יצירת גרסאות חדשות לפי דרישה: אפשר לבקש גרסאות חדשות של GKI בגודל 16KB באמצעות התהליך והטופס לבקשת גרסה חדשה, כמו ב-builds בגודל 4KB.

גרסאות מאושרות רבעוניות

גרסאות GKI שיוצאות מדי רבעון מכילות boot.img שנבדק וכולל אישור ש-Google הוסיפה כדי להעיד על כך שהבינאריים נוצרו מקוד מקור בסיסי ידוע.

בכל רבעון, נבחרת גרסה מועמדת להפצה רבעונית של GKI (לא מאושרת) אחרי תאריך היעד של הצ'ק-אין. אחרי שבוחרים את הגרסה המועמדת להפצה הרבעונית, לא יתקבלו שינויים חדשים בגרסה של אותו חודש. במהלך תקופת החלון הסגור, אפשר לטפל רק בתיקונים של באגים שגורמים לשגיאות בדיקה. הגרסה המועמדת להפצה עוברת בקרת איכות, כפי שמתואר בקטע "אישור GKI", כדי לוודא שבדיקות התאימות עוברות ב-build של GSI+GKI עם מכשיר בדיקה וירטואלי וגם עם Cuttlefish.

ציר הזמן של קצב ההשקה של GKI איור 1. לוח הזמנים להשקת GKI

דרישות הסף של GKI

סוגים של גרסאות build של GKI אכיפת איכות Notes
רבעוני (מאושר) בדיקות Cuttlefish
  • אתחול
  • VTS
  • CTS
בדיקת חומרה לדוגמה
  • אתחול
  • VTS
  • CTS
סרטונים שנוצרו מחדש (מאושרים) בדיקות Cuttlefish
  • אתחול
  • VTS
  • תת-קבוצה של CTS
בדיקת מכשיר בדיקה וירטואלי
  • אתחול
  • VTS
  • מבוסס על גרסת build מאושרת של GKI.
  • הגרסה מאושרת אחרי שהיא עומדת בדרישות.

איפה אפשר להשיג פריטי מידע שנוצרו

יצרני ציוד מקורי יכולים לקבל ארטיפקטים של כל הגרסאות בכתובת ci.android.com.

מידע נוסף על ה-CI, כולל תוצאות הבדיקה, זמין במרכז הבקרה של Android Continuous Integration.

שאלות נפוצות

ריכזנו כאן כמה שאלות נפוצות שקשורות לתהליך ההשקה של GKI.

האם אפשר ליצור קובץ בינארי חדש של GKI על סמך GKI שכבר פורסם?

כן, זה נקרא "סיבוב מחדש". תהליך ה-respin נתמך כל עוד גרסת ה-build של GKI שפורסמה (שעליה מתבקש ה-respin) תואמת לדרישות ה-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 (כולל תיקון החירום) נוצר בבסיס הקוד העדכני?

לא. גרסאות התיקון מכילות רק את התיקונים שנוספו לקרנלים המאושרים הרבעוניים שנבחרו. הגרסאות האלה מכילות את כל התיקונים לבאגים שחוסמים את ההשקה, שדווחו עד למועד מסוים על ידי יצרני ציוד מקורי (OEM) שמשתמשים בגרסת הבסיס הרבעונית המתאימה. הדוגמה הבאה ממחישה איך תרחיש כזה קורה.

  • OEM1 ו-OEM2 מחליטים להשתמש בגרסה הבינארית של GKI מנובמבר 2021.
  • ‫OEM1 ו-OEM2 מוצאים בעיות שדורשות תיקונים כדי שהמכשירים ימשיכו לקבל תמיכה. התיקונים האלה יכולים להיות שונים או זהים.
  • הגרסאות החדשות של הקובץ הבינארי מנובמבר 2021 כוללות תיקונים שחוסמים את ההשקה, שדווחו על ידי OEM1 ו-OEM2 במהלך חלון הזמן של הגרסאות החדשות, אבל לא יותר מזה.
  • הבעיות שמוזכרות בנקודה השנייה נכללות גם בגרסאות הבאות של GKI שיוצאות מדי רבעון.

הגרסה החדשה של אוקטובר כוללת את כל התיקונים ששלחו יצרני הציוד המקורי (OEM), אבל תיקונים אחרים של יצרני הציוד המקורי משפיעים עלינו כי הם לא נבדקו באופן ספציפי עם המוצרים שלנו. האם אפשר לכלול רק את התיקון שלנו?

אי אפשר לעשות את זה. נתיב respin ל-OEM בודדים לא ניתן להתאמה לעומס. במקום זאת, צוות ה-GKI בוחן כל שינוי שנכנס לגרסאות ה-respin ובודק את השינויים בכל החומרה הזמינה לפני יצירת גרסה חדשה. אם צוות GKI מגלה שהבעיה ספציפית ל-OEM, למכשיר או לדגם, הוא יכול לוודא שהקוד שנוסף בשינוי פועל רק במכשיר, בדגם או במק"ט שמושפעים.

היתרון העיקרי של גרסאות מאוחדות הוא שכל מכשיר שמשתמש באותו בסיס גרסה נהנה מהיתרונות של המכשירים האחרים, במיוחד אם הבאגים שמתגלים הם כלליים ורלוונטיים לכל המשתמשים. דוגמה ספציפית לכך היא באגים בליבת ה-kernel שנמצאו בבדיקות של ספק הסלולר.

האם יש מצבים שבהם Google מספקת מידע ספציפי על תיקונים ותרחישי בעיות של יצרני ציוד מקורי (OEM), כדי שיצרני הציוד המקורי יוכלו להעריך את ההשפעה והסיכון של הטמעת התיקונים במוצרים שלהם?

‫Google לא תוסיף שינוי לגרסת build של respin עד שצוות ה-GKI יבין את הבעיה ויאסוף את כל הפרטים. אפשר לראות את זה ביומן השינויים (הודעת commit). ‫Google לא חושפת את המכשיר הספציפי שמושפע מהבעיה, אבל יצרני ציוד מקורי (OEM) תמיד יכולים למצוא את התיאור של הבעיה ואת הפתרון שלה ביומן השינויים.