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

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

קצב ההפצה של GKI

ה-GKI מופץ אחת לרבעון אחרי הקפאת ה-KMI.

תוקף של גרסאות GKI ל-OEM

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

מהדורות מאושרות רבעוניות

מהדורות GKI רבעוניות מכילות boot.img שנבדק וכולל אישור שנוסף על ידי Google כדי לאשר שהקובצים הבינאריים נוצרו מבסיס קוד מקור ידוע.

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

איור 1. ציר הזמן של ההשקה של GKI

דרישות הסף לשימוש ב-GKI

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

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

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

שאלות נפוצות

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

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

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

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

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

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

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

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

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

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