ข้อมูลเวอร์ชันในพร็อพเพอร์ตี้ AVB

หากต้องการรองรับการเชื่อมโยงเวอร์ชันของ 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'

บูตโหลดเดอร์ของอุปกรณ์สามารถรับพร็อพเพอร์ตี้ 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;