เพื่อรองรับเวอร์ชัน Keymaster การเชื่อมโยง อุปกรณ์ Bootloader ควรมีเวอร์ชันของระบบปฏิบัติการ (OS) และระดับแพตช์ความปลอดภัยสำหรับแต่ละพาร์ติชัน เวอร์ชันของระบบปฏิบัติการและความปลอดภัย ระดับแพตช์เป็นคู่คีย์-ค่า 2 คู่แยกกันใน AVB พร็อพเพอร์ตี้ เช่น
com.android.build.system.os_version -> '12'com.android.build.system.security_patch -> '2022-02-05'com.android.build.vendor.os_version -> '12'com.android.build.vendor.security_patch -> '2022-02-05'com.android.build.boot.os_version -> '12'com.android.build.boot.security_patch -> '2022-02-05'
Bootloader ของอุปกรณ์สามารถรับคุณสมบัติ AVB เหล่านั้นจากอิมเมจ vbmeta โดยใช้
avb_property_lookup().
โหลดรูปภาพ Vbmeta หลายภาพได้โดยใช้
avb_slot_verify()
และจัดเก็บไว้ใน
AvbSlotVerifyData**
out_data
พารามิเตอร์เอาต์พุต
รูปแบบเริ่มต้นของข้อมูลเวอร์ชัน
โดยค่าเริ่มต้น ระบบบิลด์ของ Android จะใช้รูปแบบต่อไปนี้สำหรับระบบปฏิบัติการ และแพตช์ด้านความปลอดภัยตามลำดับ
รูปแบบของ com.android.build.${partition}.os_version คือ A[.B.C]
ตัวอย่างเช่น 12 หรือ 12.0.0
- ตอบ: เวอร์ชันหลัก
- B: เวอร์ชันย่อย ค่าเริ่มต้นคือ 0 เมื่อไม่ระบุ
- C: เวอร์ชันย่อย ค่าเริ่มต้นเป็น 0 เมื่อไม่แสดง
รูปแบบของ com.android.build.${partition}.security_patch คือ YYYY-MM-DD
โดยค่าเริ่มต้น ระบบบิลด์จะสร้าง
com.android.build.${partition}.security_patch สำหรับ system
พาร์ติชัน system_ext และ product ผู้ผลิตอุปกรณ์คือ
คาดว่าจะตั้งค่า BOOT_SECURITY_PATCH, VENDOR_SECURITY_PATCH และอื่นๆ
สำหรับพาร์ติชันที่ไม่ใช่ระบบ เช่น
- สร้างได้
BOOT_SECURITY_PATCH := 2022-01-05รายการcom.android.build.boot.security_patch -> '2022-01-05'
- สร้างได้
VENDOR_SECURITY_PATCH := 2022-02-05รายการcom.android.build.vendor.security_patch -> '2022-02-05'
ผู้ผลิตอุปกรณ์สามารถตั้งค่า *_SECURITY_PATCH เป็น
$(PLATFORM_SECURITY_PATCH)
หากอัปเดตพาร์ติชันทั้งหมดเป็นเวอร์ชันที่มีการรักษาความปลอดภัยเดียวกันเสมอ
ระดับแพตช์
BOOT_SECURITY_PATCH := $(PLATFORM_SECURITY_PATCH)VENDOR_SECURITY_PATCH := $(PLATFORM_SECURITY_PATCH)
ระบุข้อมูลเวอร์ชันที่กำหนดเอง
ตั้งแต่ Android 13 เป็นต้นไป บิลด์ของอุปกรณ์แต่ละบิลด์จะมี ค่าที่กำหนดเองสำหรับเวอร์ชันของระบบปฏิบัติการที่ Bootloader ของอุปกรณ์รับรู้ได้ เช่น
- สร้างได้
SYSTEM_OS_VERSION := 12.0.0รายการcom.android.build.system.os_version -> '12.0.0'
- สร้างได้
BOOT_OS_VERSION := a.b.cรายการcom.android.build.boot.os_version -> 'a.b.c'
- สร้างได้
VENDOR_OS_VERSION := 12.0.1รายการcom.android.build.vendor.os_version -> '12.0.1'
ข้อมูลเวอร์ชันที่ล้าสมัยในส่วนหัวของอิมเมจการเปิดเครื่อง
ตั้งแต่ Android 9, Keymaster
การเชื่อมโยงเวอร์ชัน
แนะนำให้นำ os_version ออกจากส่วนหัว boot.img
เพื่อเปรียบเทียบ การใช้การรับข้อมูลเวอร์ชันที่ล้าสมัย
ส่วนหัวอิมเมจการเปิดเครื่องมีอธิบายไว้ที่นี่ด้วยเช่นกัน โปรดทราบว่า
os_version
ในส่วนหัวการเปิดเครื่องจะรวมทั้งเวอร์ชันของระบบปฏิบัติการและระดับแพตช์ความปลอดภัยไว้ใน
จำนวนเต็ม 32 บิตที่ไม่มีเครื่องหมาย และกลไกนี้จะถือว่ารูปภาพทั้งหมด
มีการอัปเดตร่วมกัน ซึ่งล้าสมัยหลังจากการแบ่งพาร์ติชันโมดูลใน
Project Treble
// Operating system version and security patch level.
// For version "A.B.C" and patch level "Y-M-D":
// (7 bits for each of A, B, C; 7 bits for (Y-2000), 4 bits for M)
// A = os_version[31:25]
// B = os_version[24:18]
// C = os_version[17:11]
// Y = 2000 + os_version[10:4]
// M = os-version[3:0]
uint32_t os_version;