OTA สำหรับอุปกรณ์ที่ไม่ใช่ A/B ที่มีพาร์ติชันแบบไดนามิก

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

Android 10 รองรับพาร์ติชันแบบไดนามิก ซึ่งเป็นระบบการแบ่งพาร์ติชันพื้นที่ผู้ใช้ที่สามารถสร้าง ปรับขนาด และลบพาร์ติชันในระหว่างการอัปเดตผ่านอากาศ (OTA)

หน้านี้อธิบายวิธีปรับขนาดพาร์ติชันแบบไดนามิกของไคลเอ็นต์ OTA ในระหว่างการอัปเดต อุปกรณ์ที่ไม่ใช่ A/B

สำหรับอุปกรณ์ที่ไม่ใช่ A/B ระบบจะใช้การอัปเดต OTA สำหรับพาร์ติชันแบบไดนามิกโดยใช้ updater ในแพ็กเกจการอัปเดต

อัปเดตอุปกรณ์ที่จะเปิดตัว

ส่วนนี้มีผลกับอุปกรณ์ที่ไม่ใช่ A/B ที่เปิดด้วยไดนามิก การสนับสนุนพาร์ติชัน อุปกรณ์เหล่านี้อัปเกรดจาก Android 10 ขึ้นไป

สร้างแพ็กเกจอัปเดต

แพ็กเกจอัปเดต OTA สร้างขึ้นโดยสคริปต์ ota_from_target_files ซึ่งอยู่ภายใต้ build/make/tools/releasetools โดยค่าเริ่มต้น สคริปต์ สร้างแพ็กเกจที่อัปเดต system และ vendor พาร์ติชัน หากมีพาร์ติชันแบบไดนามิกเพิ่มเติม เช่น product, product_services หรือ odm การอัปเดตพาร์ติชันเหล่านี้จะต้องสร้างในโค้ดเฉพาะอุปกรณ์

หากต้องการสร้างการอัปเดต ให้ใช้ FullOTA_GetBlockDifferences() และ IncrementalOTA_GetBlockDifferences() ในโมดูล Python แบบขยาย ฟังก์ชันทั้ง 2 รายการนี้จะแสดงรายการออบเจ็กต์ BlockDifference โดยแต่ละรายการจะอธิบายแพตช์การอัปเดตที่จะใช้กับพาร์ติชัน พาร์ติชันที่แสดงผลโดยฟังก์ชันทั้ง 2 นี้ไม่ควรแก้ไขด้วยตนเองหรือยืนยันที่อื่น เช่น ใน *_InstallBegin() หรือ *_InstallEnd()

ตัวอย่างการสร้างอัปเดต

# device/yoyodyne/tardis/releasetools.py

import os
from common import BlockDifference, EmptyImage, GetUserImage

# The joined list of user image partitions of source and target builds.
# - Items should be added to the list if new dynamic partitions are added.
# - Items should not be removed from the list even if dynamic partitions are
#   deleted. When generating an incremental OTA package, this script needs to
#   know that an image is present in source build but not in target build.
USERIMAGE_PARTITIONS = [
    "product",
    "odm",
]

def GetUserImages(input_tmp, input_zip):
  return {partition: GetUserImage(partition, input_tmp, input_zip)
          for partition in USERIMAGE_PARTITIONS
          if os.path.exists(os.path.join(input_tmp,
                                         "IMAGES", partition + ".img"))}

def FullOTA_GetBlockDifferences(info):
  images = GetUserImages(info.input_tmp, info.input_zip)
  return [BlockDifference(partition, image)
          for partition, image in images.items()]

def IncrementalOTA_GetBlockDifferences(info):
  source_images = GetUserImages(info.source_tmp, info.source_zip)
  target_images = GetUserImages(info.target_tmp, info.target_zip)

  # Use EmptyImage() as a placeholder for partitions that will be deleted.
  for partition in source_images:
    target_images.setdefault(partition, EmptyImage())

  # Use source_images.get() because new partitions are not in source_images.
  return [BlockDifference(partition, target_image, source_images.get(partition))
          for partition, target_image in target_images.items()]

อัปเดตโฟลว์

เบื้องหลัง ระบบจะเพิ่มฟังก์ชันต่อไปนี้ลงในสคริปต์ edify

• unmap_partition(name)
  • ยกเลิกการแมปพาร์ติชันหากแมปไว้ หรือไม่ต้องดำเนินการใดๆ
  • แสดงผลสตริง t เมื่อสําเร็จ หรือสตริงว่างเมื่อไม่สําเร็จ
• map_partition(name)
  • แมปพาร์ติชันหากยังไม่ได้แมป
  • แสดงผลเส้นทางสัมบูรณ์ของอุปกรณ์บล็อกที่แมปหากสําเร็จ หรือสตริงว่างหากไม่สําเร็จ
• update_dynamic_partitions(op_list)
  • ใช้รายการการดำเนินการที่ระบุกับข้อมูลเมตาของพาร์ติชันแบบไดนามิก โดยยกเลิกการแมปพาร์ติชันหากจำเป็น
  • แสดงผล t เมื่อสำเร็จ หรือสตริงว่างเมื่อล้มเหลว

อาร์กิวเมนต์ op_list ของ update_dynamic_partitions ชี้ไปที่ไฟล์ใน อัปเดตแพ็กเกจ แต่ละบรรทัดในไฟล์จะระบุการดำเนินการ หากมี การดำเนินการล้มเหลว update_dynamic_partitions ทันที แสดงผลสตริงว่าง การดำเนินการมีดังนี้

• resize partition-name size
  • ยกเลิกการแมปพาร์ติชัน แล้วปรับขนาดเป็น size
• remove partition_name
  • จากนั้นยกเลิกการแมปพาร์ติชัน แล้วนำออก
• add partition-name group-name
  • เพิ่มพาร์ติชันใหม่ให้กับกลุ่มที่ระบุ
  • ยกเลิกหากไม่มีกลุ่มหรือมีพาร์ติชันอยู่แล้ว
• move partition-name group-name
  • ย้ายพาร์ติชันไปยังกลุ่มที่ระบุ
  • ล้มเลิกหากไม่มีกลุ่มหรือไม่มีพาร์ติชันอยู่
• add_group group-name maximum-size
  • เพิ่มกลุ่มโดยใช้ชื่อและขนาดสูงสุด
  • ยกเลิกหากมีกลุ่มอยู่แล้ว
  • maximum_size เท่ากับ 0 หมายความว่าไม่มีการจำกัดขนาดของพาร์ติชันในกลุ่ม ต้องมีการทดสอบเพิ่มเติมเพื่อให้แน่ใจว่าพาร์ติชันในกลุ่มมีขนาดใหญ่ไม่เกินพื้นที่ว่างในอุปกรณ์
• resize_group group-name maximum-size
  • ปรับขนาดกลุ่มเป็นขนาดสูงสุดที่กำหนด
  • ล้มเลิกถ้าไม่มีกลุ่ม
  • maximum_size จาก 0 หมายความว่าไม่มีการจำกัดขนาด ในพาร์ติชันในกลุ่ม ต้องมีการทดสอบเพิ่มเติมเพื่อให้แน่ใจว่าพาร์ติชันในกลุ่มมีขนาดใหญ่ไม่เกินพื้นที่ว่างในอุปกรณ์
• remove_group group-name
  • นำกลุ่มออก
  • ล้มเลิกหากมีพาร์ติชันในกลุ่ม
• remove_all_groups
  • ยกเลิกการแมปพาร์ติชันทั้งหมดจากตัวแมปอุปกรณ์
  • นำพาร์ติชันและกลุ่มทั้งหมดออก

OTA ที่เพิ่มขึ้น

การอัปเดต OTA ที่เพิ่มขึ้นจะใช้ตรรกะต่อไปนี้

1. ย่อขนาดพาร์ติชัน/ลบพาร์ติชัน/ย้ายพาร์ติชันออกจากกลุ่ม (เพื่อให้มีพื้นที่เพียงพอในการย่อขนาดกลุ่ม)
2. ย่อกลุ่ม (เพื่อให้มีพื้นที่ว่างเพียงพอสำหรับขยายกลุ่ม)
3. ขยายกลุ่ม (เพื่อให้เรามีพื้นที่เพียงพอสำหรับการขยาย/เพิ่ม พาร์ติชัน)
4. ขยายพาร์ติชัน/เพิ่มพาร์ติชัน/ย้ายพาร์ติชันไปยังกลุ่มใหม่

โดยรายละเอียดคือ update-script สร้างขึ้นด้วยตรรกะนี้

for each shrinking partition:
    block_image_update(map_partition(name), …)

update_dynamic_partitions(op_list)

for each growing / adding partition:
    block_image_update(map_partition(name), …)

ระบบจะสร้างไฟล์ op_list สำหรับ update_dynamic_partitions ด้วยตรรกะนี้

for each deleting partition:
    remove
for each partition that changes groups:
    move to "default"
for each shrinking partition:
    resize
for each shrinking / removing group:
    resize_group / remove_group
for each growing / adding group:
    resize_group / add_group
for each adding partition:
    add
for each growing / adding partition:
    resize
for each partition that changes groups:
    move to target group

OTA แบบสมบูรณ์

การอัปเดต OTA แบบสมบูรณ์ใช้ตรรกะต่อไปนี้

1. ลบกลุ่มและพาร์ติชันที่มีอยู่ทั้งหมด
2. เพิ่มกลุ่ม
3. เพิ่มพาร์ติชัน

โดยรายละเอียดคือ update-script สร้างขึ้นด้วยตรรกะนี้

update_dynamic_partitions(op_list)

for each adding partition:
    block_image_update(map_partition(name), …)

ไฟล์ op_list สำหรับ update_dynamic_partitions สร้างขึ้นด้วยตรรกะนี้

remove_all_groups
for each adding group:
    add_group
for each adding partition:
    add
for each adding partition:
    resize