ข้อมูลเวอร์ชันในคุณสมบัติ AVB

เพื่อรองรับ การเชื่อมโยงเวอร์ชันของ Keymaster อุปกรณ์บูตโหลดเดอร์จะต้องจัดเตรียมเวอร์ชันระบบปฏิบัติการ (OS) และระดับแพตช์ความปลอดภัยสำหรับแต่ละพาร์ติชัน เวอร์ชันของระบบปฏิบัติการและระดับแพตช์ความปลอดภัยเป็นคู่คีย์ -> ค่าที่แยกจากกันใน คุณสมบัติ 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[.BC] เช่น '12' หรือ '12.0.0':

  • ตอบ: เวอร์ชันหลัก
  • B: เวอร์ชันรอง ค่าเริ่มต้นจะเป็นศูนย์เมื่อไม่มีอยู่
  • C: เวอร์ชันรอง ค่าเริ่มต้นเป็นศูนย์เมื่อไม่มีอยู่

รูปแบบของ 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 เป็นต้นไป อุปกรณ์แต่ละรุ่นจะมีค่าที่กำหนดเองสำหรับเวอร์ชันระบบปฏิบัติการที่โปรแกรมโหลดบูตของอุปกรณ์จะรับรู้ได้ เช่น,

  • SYSTEM_OS_VERSION := 12.0.0 สร้างขึ้น
    • com.android.build.system.os_version -> '12.0.0'
  • BOOT_OS_VERSION := abc สร้าง
    • com.android.build.boot.os_version -> 'abc'
  • 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;