กระบวนการเผยแพร่อิมเมจ Kernel ทั่วไป (GKI)

หน้านี้อธิบายวิธีเผยแพร่ GKI ซึ่งรวมถึงการเผยแพร่รายสัปดาห์ รายไตรมาส และการเผยแพร่ฉุกเฉินนอกแบนด์ เป้าหมายของเอกสารนี้คือการให้คำแนะนำแก่ OEM เกี่ยวกับตำแหน่งที่จะรับ GKI รวมถึงกระบวนการแก้ไขฉุกเฉินนอกแบนด์ นอกจากนี้ OEM ยังใช้การพัฒนา GKI เพื่อดูข้อมูลเพิ่มเติมเกี่ยวกับวิธีทำงานร่วมกับทีม Android Kernel เพื่อเพิ่มประสิทธิภาพ เคอร์เนล GKI สำหรับผลิตภัณฑ์ของตนได้ด้วย

ความถี่ในการเผยแพร่ GKI

GKI จะเผยแพร่ทุกไตรมาสหลังจากที่ KMI หยุดการเปลี่ยนแปลง

ความถูกต้องของบิลด์ GKI สำหรับ OEM

OEM สามารถใช้ Android GKI ที่เพิ่งเปิดตัวได้ OEM สามารถเปิดตัวด้วยบิลด์ที่ได้รับการรับรอง GKI ได้ตราบใดที่เป็นไปตามข้อกำหนด LTS ในประกาศข่าวสารด้านความปลอดภัยของ Android (ASB)

การเปิดตัวที่ได้รับการรับรองรายไตรมาส

การเผยแพร่ GKI ทุกไตรมาสจะมี boot.img ที่ผ่านการทดสอบแล้ว ซึ่งรวมถึงใบรับรองที่ Google แทรกไว้เพื่อยืนยันว่าไบนารีสร้างขึ้นจากซอร์สโค้ดพื้นฐานที่ทราบ

ในแต่ละไตรมาส ระบบจะเลือก GKI Quarterly Release Candidate (ไม่ได้รับการรับรอง) หลังจากวันที่สิ้นสุดการเช็คอิน ซึ่งโดยปกติคือบิลด์รายสัปดาห์ที่ 2 ของ เดือนนั้น หลังจากเลือกเวอร์ชันทดลองที่เผยแพร่ทุกไตรมาสแล้ว ระบบจะไม่ยอมรับการเปลี่ยนแปลงใหม่ ในการเผยแพร่ของเดือนนั้น ในช่วงเวลาที่ปิด เราจะแก้ไขได้เฉพาะข้อบกพร่องที่ทำให้การทดสอบล้มเหลวเท่านั้น รุ่นที่พร้อมใช้งานจะได้รับการประกันคุณภาพตามที่อธิบายไว้ในส่วนการ รับรอง GKI เพื่อให้มั่นใจว่าการทดสอบการปฏิบัติตามข้อกำหนดจะผ่านใน บิลด์ GSI+GKI ที่มีอุปกรณ์อ้างอิงและ Cuttlefish

รูปที่ 1 ลำดับเวลาการเผยแพร่ GKI

กระบวนการส่งใหม่ในกรณีฉุกเฉิน

Respin หมายถึงกระบวนการผสานใหม่ สร้างใหม่ ทดสอบใหม่ และ รับรองไบนารีอีกครั้งหลังจาก การเผยแพร่เคอร์เนล GKI ต่อสาธารณะ คุณขอให้หมุนไบนารีที่ผ่านการรับรองอีกครั้งได้ในกรณีต่อไปนี้

• วิธีอัปเดตรายการสัญลักษณ์
• เพื่อใช้การแก้ไขข้อบกพร่อง รวมถึงข้อบกพร่องที่พบระหว่างการอนุมัติในห้องทดลองของผู้ให้บริการ
• วิธีเพิ่มHook ของผู้ให้บริการ
• หากต้องการใช้แพตช์กับฟีเจอร์ที่มีอยู่
• ใช้แพตช์ความปลอดภัย (หลังจาก 6 เดือน)

ระบบจะผสานรวมแพตช์ความปลอดภัยเข้ากับกิ่งก้านของรุ่นโดยอัตโนมัติเป็นเวลาสูงสุด 6 เดือนหลังจากที่เผยแพร่กิ่งก้าน หลังจากพ้นกำหนด 6 เดือน คุณต้อง ขอ Respin เพื่อใช้แพตช์ด้านความปลอดภัยกับสาขา

หลักเกณฑ์เกี่ยวกับคำขอให้ปั่นใหม่

โปรดทราบหลักเกณฑ์ต่อไปนี้ก่อนขอให้หมุนซ้ำ

• อนุญาตให้หมุนได้เฉพาะในสาขาที่เผยแพร่หลังจากการเผยแพร่ต่อสาธารณะครั้งแรก ของบิลด์รายไตรมาสที่เปิดตัวแล้ว

• ระบบจะยอมรับคำขอ Respin สำหรับสาขาการเผยแพร่ที่กำหนดเท่านั้น โดยจะยอมรับเป็นเวลาสูงสุด 6 เดือนหลังจากเผยแพร่ต่อสาธารณะครั้งแรก หลังจาก 6 เดือน สาขาจะมีสิทธิ์สำหรับ Respin เฉพาะแพตช์ด้านความปลอดภัยที่อ้างอิงในประกาศข่าวสารด้านความปลอดภัยของ Android

• เมื่อข้อกำหนด LTS ที่กำหนดโดยประกาศข่าวสารด้านความปลอดภัยของ Android (ASB) ทำให้สาขาไม่เป็นไปตามข้อกำหนด สาขาจะถูกเลิกใช้งาน ระบบจะไม่ยอมรับคำขอ Respin สำหรับสาขาที่เลิกใช้งานแล้ว วันที่เลิกใช้งานสำหรับ GKI Branch ของรุ่นที่เผยแพร่จะรวมอยู่ในหมายเหตุบิลด์ 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
  P0	2 วันทำการ
  P1	5 วันทำการ
  P2	10 วันทำการ
  P3	15 วันทำการ

• คุณต้องส่งคำขอหมุนใหม่แยกต่างหากต่อสาขาการเผยแพร่ เช่น หากต้องส่งคำขอให้หมุนซ้ำสำหรับทั้ง android12-5.10-2022-08 และ android12-5.10-2022-09 คุณต้องสร้างคำขอให้หมุนซ้ำ 2 รายการ

• หลังจากที่ส่งบิลด์และมีการทำเครื่องหมายคำขอการหมุนใหม่ว่าแก้ไขแล้ว คุณไม่ควรเปิดคำขอการหมุนใหม่เพื่อเพิ่ม CL เพิ่มเติม คุณต้องส่งคำขอ การทดสอบใหม่หากมีแพตช์เพิ่มเติมที่ต้องผสานรวม

• เพิ่มแท็กต่อไปนี้สำหรับ CL แต่ละรายการที่พิจารณา

  • Bug: ต้องเพิ่มรหัสข้อบกพร่องในข้อความคอมมิตสำหรับ CL แต่ละรายการ
  • Change-Id: ต้องเหมือนกับ Change-Id ของการเปลี่ยนแปลงสาขาฐาน

• หากคำขอหมุนซ้ำต้องมีการตอบกลับจากคุณ แต่คุณไม่ตอบกลับภายใน 3 วันทำการ ระบบจะลดระดับความสำคัญลง 1 ระดับ (เช่น P0 จะลดระดับเป็น P1) หากคุณไม่ตอบกลับภายใน 2 สัปดาห์ ระบบจะทําเครื่องหมายข้อบกพร่องเป็นจะไม่แก้ไข (ล้าสมัย)

ส่งคำขอให้หมุนใหม่

แผนภาพต่อไปนี้แสดงกระบวนการหมุนใหม่ กระบวนการจะเริ่มต้นเมื่อพาร์ทเนอร์ OEM (คุณ) ส่งคำขอ Respin

รูปที่ 2 กระบวนการหมุนใหม่

วิธีเข้าสู่กระบวนการ Respin

1. กรอกแบบฟอร์มคำขอ GKI Respin และติดต่อผู้จัดการลูกค้าด้านเทคนิคของ Google ทันที แบบฟอร์มนี้ สร้างข้อบกพร่องคำขอ GKI Respin คุณ (ผู้ขอ) ทีม GKI และบุคคลที่คุณเพิ่มลงในรายการสำเนาของข้อบกพร่องจะมองเห็นข้อบกพร่องของคำขอ Respin
   • หากคุณมีวิธีแก้ไขอยู่แล้ว คำขอควรชี้ไปยังการส่งแพตช์ใน AOSP เพื่อให้ Google ตรวจสอบได้ หากส่งแพตช์ไม่ได้ คุณต้องแนบแพตช์เป็นไฟล์ข้อความไปกับคำขอ
   • หากคุณไม่มีวิธีแก้ไข คำขอต้องมีข้อมูลให้มากที่สุดเท่าที่จะเป็นไปได้ ซึ่งรวมถึงหมายเลขเวอร์ชันของเคอร์เนลและบันทึก เพื่อให้ Google ช่วยแก้ไขข้อบกพร่องของปัญหาได้
2. ทีม GKI ของ Google จะตรวจสอบคำขอและอนุมัติ หรือส่งกลับให้คุณหากต้องการข้อมูลเพิ่มเติม
3. หลังจากตกลงการแก้ไขแล้ว ทีม GKI ของ Google จะตรวจสอบโค้ด (CR+2) ของการเปลี่ยนแปลง การตรวจสอบจะเริ่มในกรอบเวลา ESRT ทีม GKI จะผสาน สร้าง ทดสอบ เพื่อการเกิดปัญหาซ้ำ และรับรองการเปลี่ยนแปลง
4. ไบนารีจะเผยแพร่ไปยัง ci.android.com กรอบเวลา ESRT จะสิ้นสุดลง และทีม Google GKI จะทำเครื่องหมายคำขอว่าแก้ไขแล้วและ อ้างอิงบิลด์ที่สร้างใหม่ นอกจากนี้ เราจะโพสต์บิลด์ที่สร้างใหม่ใน หน้าบิลด์ที่เผยแพร่ของ Generic Kernel Image (GKI) ด้วย

การรับรอง GKI

แหล่งที่มาของอาร์ติแฟกต์บิลด์

คุณสามารถรับอาร์ติแฟกต์สำหรับการเผยแพร่ทั้งหมดได้จาก ci.android.com

ดูข้อมูลเพิ่มเติมเกี่ยวกับ CI รวมถึงผลการทดสอบได้ในแดชบอร์ดการผสานรวมอย่างต่อเนื่องของ Android

คำถามที่พบบ่อย

คำถามที่พบบ่อยเกี่ยวกับการเผยแพร่ GKI มีดังนี้

เป็นไปได้ไหมที่จะสร้างไบนารี GKI ใหม่โดยอิงตาม GKI ที่เผยแพร่แล้ว

ใช่ เราเรียกการดำเนินการนี้ว่าการหมุนซ้ำ กระบวนการ Respin จะได้รับการสนับสนุนตราบใดที่บิลด์ 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 (รวมถึงแพตช์การหมุนฉุกเฉิน) สร้างขึ้นในโค้ดเบสล่าสุดหรือไม่

ไม่ได้ Respin จะมีเฉพาะแพตช์ที่อยู่เหนือเคอร์เนลที่ได้รับการรับรองรายไตรมาสซึ่งเลือกไว้ การส่งต่อเหล่านี้มีการแก้ไขข้อบกพร่องที่บล็อกการเปิดตัวทั้งหมด ที่ OEM รายงานจนถึงเวลาใดก็ตามโดยใช้รุ่นไตรมาสพื้นฐานที่เกี่ยวข้อง ดูตัวอย่างต่อไปนี้เกี่ยวกับวิธีที่สถานการณ์ประเภทนี้เกิดขึ้น

• OEM1 และ OEM2 ตัดสินใจใช้ไบนารี GKI ที่เผยแพร่ตั้งแต่เดือนพฤศจิกายน 2021
• OEM1 และ OEM2 พบปัญหาที่ต้องใช้แพตช์เพื่อรองรับการสนับสนุน แพตช์เหล่านี้ อาจแตกต่างกันหรือเหมือนกันก็ได้
• การรีสปินที่อยู่เหนือไบนารีของเดือนพฤศจิกายน 2021 มีการแก้ไขการบล็อกการเปิดตัว ที่ทั้ง OEM1 และ OEM2 รายงานในช่วงเวลาการรีสปิน แต่ไม่มีการแก้ไขอื่นๆ
• ปัญหาที่กล่าวถึงในหัวข้อย่อยที่ 2 จะรวมอยู่ใน GKI รุ่นรายไตรมาสต่อๆ ไปด้วย

การหมุนเวียนอีกครั้งในเดือนตุลาคมมีแพตช์ทั้งหมดที่ OEM ส่งมา แต่แพตช์อื่นๆ ของ OEM ส่งผลกระทบต่อเราเนื่องจากยังไม่ได้ทดสอบกับผลิตภัณฑ์ของเราโดยเฉพาะ เราจะรวมเฉพาะแพตช์ของเราได้ไหม

ซึ่งเป็นไปไม่ได้ เส้นทางการหมุนซ้ำ "ต่อ OEM" ไม่สามารถปรับขนาดได้ แต่ทีม GKI จะตรวจสอบการเปลี่ยนแปลงทุกรายการที่รวมอยู่ในการสร้างใหม่ และทดสอบการเปลี่ยนแปลงกับฮาร์ดแวร์ทั้งหมดที่มีก่อนที่จะสร้าง บิลด์ใหม่ หากทีม GKI พบว่าปัญหาเกิดขึ้นกับ OEM, อุปกรณ์ หรือ รุ่นใดรุ่นหนึ่งโดยเฉพาะ ทีม GKI จะตรวจสอบว่าโค้ดที่เพิ่มโดยการเปลี่ยนแปลงจะทำงานใน อุปกรณ์ รุ่น หรือ SKU ที่ได้รับผลกระทบเท่านั้น

ประโยชน์หลักของการหมุนซ้ำแบบรวมคืออุปกรณ์ทุกเครื่องที่ใช้ฐานการเผยแพร่เดียวกันจะได้รับประโยชน์จากกันและกัน โดยเฉพาะอย่างยิ่งหากข้อบกพร่องที่พบเป็นข้อบกพร่องทั่วไปและใช้ได้กับผู้ใช้ทุกคน ข้อบกพร่องของเคอร์เนลหลักที่พบ ในการทดสอบของผู้ให้บริการเป็นตัวอย่างที่เฉพาะเจาะจงของแนวคิดนี้

มีสถานการณ์ใดบ้างที่ Google ให้ข้อมูลเฉพาะเกี่ยวกับแพตช์ของ OEM และสถานการณ์ปัญหา เพื่อให้ OEM ประเมินผลกระทบและความเสี่ยงของการใช้แพตช์กับผลิตภัณฑ์ของตนได้

Google จะไม่เพิ่มการเปลี่ยนแปลงลงในบิลด์ที่สร้างใหม่จนกว่าจะเข้าใจปัญหา และรวบรวมรายละเอียดทั้งหมดแล้ว ซึ่งจะเห็นได้ในบันทึกการเปลี่ยนแปลง (ข้อความคอมมิต) Google ไม่ได้ระบุว่าอุปกรณ์ใดที่ได้รับผลกระทบ แต่ OEM สามารถดูคำอธิบายปัญหาและวิธีแก้ปัญหาได้เสมอในบันทึกการเปลี่ยนแปลง