รูปภาพการกู้คืน

จัดทุกอย่างให้เป็นระเบียบอยู่เสมอด้วยคอลเล็กชัน บันทึกและจัดหมวดหมู่เนื้อหาตามค่ากำหนดของคุณ

ในอุปกรณ์ที่ไม่ใช่ A/B รูปภาพการกู้คืนควรมีข้อมูลจาก Device Tree Blob (DTB) หรือรูปภาพวางซ้อน Advanced Configuration and Power Interface (ACPI) เมื่ออุปกรณ์ดังกล่าวบูตเข้าสู่การกู้คืน บูตโหลดเดอร์จะโหลดรูปภาพวางซ้อนที่เข้ากันได้กับรูปภาพการกู้คืนได้ อุปกรณ์ที่รองรับการอัปเดต A/B (แบบราบรื่น) ควรใช้การกู้คืนเป็นบูตแทนพาร์ติชันการกู้คืนแยกต่างหาก (ดูรายละเอียดที่หัวข้อการใช้การอัปเดต A/B)

ตัวเลือกในการรวม DTBO/ACPIO การกู้คืนไว้เป็นส่วนหนึ่งของการเปิดเครื่อง/การกู้คืน รูปภาพจะแตกต่างกันไปใน Android รุ่นต่างๆ

รุ่น	อัปเดตรูปแบบ	การปฏิบัติตามข้อกำหนดของ GKI	เวอร์ชันส่วนหัวของบูต (อุปกรณ์ที่เปิดใช้งาน)	เวอร์ชันส่วนหัวของบูต (การอัปเกรดอุปกรณ์)	ต้องมีอิมเมจการกู้คืนโดยเฉพาะ
11	A/B, A/B เสมือนจริง	ใช่	3*	ไม่มี	ไม่
	A/B, A/B เสมือนจริง	ไม่	2 3	0, 1, 2, 3	ไม่
	ไม่ใช่ A/B	ใช่	3	ไม่มี	ใช่
	ไม่ใช่ A/B	ไม่	2 3	0, 1, 2, 3	ใช่
10 (Q)	A/B	ไม่มี	2	0, 1, 2	ไม่
	ไม่ใช่ A/B	ไม่มี	2	0, 1, 2	ใช่
9 (P)	อัลฟา/เบต้า	ไม่มี	1	0, 1	ไม่
	ไม่ใช่ A/B	ไม่มี	1	0, 1	ใช่
8 (โอ)	อัลฟา/เบต้า	ไม่มี	ไม่มี (พิจารณา 0)	ไม่มี (ถือว่า 0)	ไม่
	ไม่ใช่ A/B	ไม่มี	ไม่มี (พิจารณา 0)	ไม่มี (พิจารณา 0)	ใช่

* อุปกรณ์ A/B ที่ใช้ Android 11 ขึ้นไปและใช้ Generic Kernel Image (GKI) ต้องใช้ส่วนหัวของบูตเวอร์ชัน 3 หลักเพื่อให้ใช้งานร่วมกับพาร์ติชันบูตของผู้ให้บริการได้

ประเด็นสำคัญ

• อุปกรณ์ A/B ไม่จำเป็นต้องระบุรูปภาพการกู้คืนเนื่องจากการอัปเดต A/B ใช้พาร์ติชัน 2 ชุด (รวมถึง boot และ dtbo) และเปลี่ยนไปมาระหว่างพาร์ติชันดังกล่าวในระหว่างการอัปเดต จึงไม่จำเป็นต้องใช้รูปภาพการกู้คืน อุปกรณ์ A/B จะยังคงใช้ภาพการกู้คืนเฉพาะได้

• อุปกรณ์ที่ไม่ใช่ A/B ซึ่งเปิดตัวด้วย Android 11 ขึ้นไปและใช้ส่วนหัวบูตเวอร์ชัน 3 ต้องระบุส่วนหัวบูตเวอร์ชัน 2 อย่างชัดเจนสำหรับรูปภาพการกู้คืนแยกต่างหาก เช่น

  BOARD_RECOVERY_MKBOOTIMG_ARGS := --header_version 2
  

• สำหรับสถาปัตยกรรมที่ไม่รองรับแผนผังอุปกรณ์ อิมเมจการกู้คืนจะ ใส่รูปภาพ ACPIO แทนรูปภาพ DTBO

เกี่ยวกับการอัปเดต OTA ไม่สำเร็จและรูปภาพการกู้คืน

เพื่อป้องกันไม่ให้มีการอัปเดตผ่านอากาศ (OTA) ล้มเหลวในอุปกรณ์ที่ไม่ใช่ A/B รูปภาพการกู้คืนควรทำงานได้ด้วยตัวเองและแยกจากรูปภาพอื่นๆ ระหว่างการอัปเดต OTA ถ้าปัญหาเกิดขึ้นหลังจากอัปเดตภาพซ้อนทับแล้ว (แต่ก่อน การอัปเดตโดยสมบูรณ์) อุปกรณ์จะพยายามเปิดเครื่องเข้าสู่ Recovery Mode เพื่อ อัปเดต OTA ให้เสร็จสมบูรณ์ อย่างไรก็ตาม เนื่องจากพาร์ติชันการวางซ้อนได้รับ อัปเดตแล้ว อาจไม่ตรงกับอิมเมจการกู้คืน (ซึ่งไม่ได้ อัปเดตเลย)

เพื่อป้องกันไม่ให้การกู้คืนต้องอาศัยพาร์ติชัน DTBO/ACPIO ระหว่างการอัปเดต อุปกรณ์ที่ไม่ใช่ A/B ที่ใช้ Android 9 ขึ้นไปจะระบุรูปภาพ DTBO/ACPIO สำหรับการกู้คืนซึ่งมีข้อมูลจากรูปภาพการวางซ้อนเป็นส่วนแยกต่างหากในรูปแบบรูปภาพสำหรับบูตได้ (ต้องใช้ส่วนหัวสำหรับบูตเวอร์ชัน 1 หรือ 2)

การเปลี่ยนแปลงอิมเมจบูท

หากต้องการอนุญาตให้อิมเมจการกู้คืนมี DTBO หรือ ACPIO สำหรับการกู้คืนที่ไม่มี A/B อุปกรณ์ที่ใช้ Android 9 ขึ้นไป ให้อัปเดตการเปิดเครื่อง โครงสร้างรูปภาพดังต่อไปนี้

ส่วนอิมเมจบูต	จำนวนหน้า
ส่วนหัวของบูต (1 หน้า)	1
เคอร์เนล (หน้า l)	l = (kernel_size + page_size - 1) / page_size
แรมดิสก์ (หน้า m)	นาที = (ramdisk_size + page_size - 1) / page_size
Bootloader ขั้นที่ 2 (n หน้า)	n = (second_size + page_size - 1) / page_size
DTBO หรือ ACPIO สำหรับการกู้คืน (o หน้า)	o = (recovery_[dtbo|acpio]_size + page_size - 1) / page_size

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

นำ DTBO ไปใช้

อุปกรณ์ที่ไม่ใช่ A/B ซึ่งใช้เวอร์ชัน 9 ขึ้นไปสามารถป้อนข้อมูล ส่วน recovery_dtbo ของอิมเมจการกู้คืน วิธีใส่ recovery_dtbo รูปภาพใน recovery.img ในอุปกรณ์ BoardConfig.mk:

• กำหนดค่า BOARD_INCLUDE_RECOVERY_DTBO เป็น true:

   BOARD_INCLUDE_RECOVERY_DTBO := true
  

• ขยายตัวแปร BOARD_MKBOOTIMG_ARGS เพื่อระบุเวอร์ชันส่วนหัวของภาพสำหรับบูต ดังนี้

  BOARD_MKBOOTIMG_ARGS := --ramdisk_offset $(BOARD_RAMDISK_OFFSET) --tags_offset $(BOARD_KERNEL_TAGS_OFFSET) --header_version $(BOARD_BOOTIMG_HEADER_VERSION)
  

• ตรวจสอบว่าได้ตั้งค่าตัวแปร BOARD_PREBUILT_DTBOIMAGE เป็นเส้นทางของ รูปภาพ DTBO ระบบบิลด์ Android ใช้ตัวแปรเพื่อตั้งค่าอาร์กิวเมนต์ recovery_dtbo ของเครื่องมือ mkbootimg ในระหว่างการสร้างรูปภาพการกู้คืน

หากตั้งค่าตัวแปร BOARD_INCLUDE_RECOVERY_DTBO, BOARD_MKBOOTIMG_ARGS และ BOARD_PREBUILT_DTBOIMAGE อย่างถูกต้อง ระบบการสร้างของ Android จะรวม DTBO ที่ระบุโดยตัวแปร BOARD_PREBUILT_DTBOIMAGE ใน recovery.img

ติดตั้งใช้งาน ACPIO

อุปกรณ์ที่ไม่ใช่ A/B ที่ใช้ Android 9 ขึ้นไปสามารถใช้รูปภาพวางซ้อน ACPIO (แทนรูปภาพ DTBO) และสามารถป้อนข้อมูลในส่วน recovery_acpio (แทนที่จะเป็นในส่วน recovery_dtbo) ของรูปภาพการกู้คืน หากต้องการรวมรูปภาพ recovery_acpio ใน recovery.img ในอุปกรณ์ BoardConfig.mk ให้ทำดังนี้

• กำหนดค่า BOARD_INCLUDE_RECOVERY_ACPIO เป็น true:

  BOARD_INCLUDE_RECOVERY_ACPIO := true
  

• ขยายตัวแปร BOARD_MKBOOTIMG_ARGS เพื่อระบุส่วนหัวอิมเมจการเปิดเครื่อง เวอร์ชัน ตัวแปรต้องมากกว่าหรือเท่ากับ 1 เพื่อรองรับการกู้คืน ACPIO

  BOARD_MKBOOTIMG_ARGS += --header_version $(BOARD_BOOTIMG_HEADER_VERSION)
  

• ตรวจสอบว่าได้ตั้งค่าตัวแปร BOARD_RECOVERY_ACPIO เป็นเส้นทางของ รูปภาพ ACPIO ระบบบิลด์ Android ใช้ตัวแปรเพื่อตั้งค่าอาร์กิวเมนต์ recovery_acpio ของเครื่องมือ mkbootimg ในระหว่างการสร้างรูปภาพการกู้คืน

หาก BOARD_INCLUDE_RECOVERY_ACPIO, BOARD_MKBOOTIMG_ARGS และ มีการตั้งค่าตัวแปร BOARD_RECOVERY_ACPIO อย่างถูกต้อง ระบบบิลด์ของ Android รวม ACPIO ที่ระบุโดยตัวแปร BOARD_RECOVERY_ACPIO ใน recovery.img