具有动态分区的非 A/B 设备的 OTA

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），则必须在设备特定代码中生成它们的更新。

要生成更新，请在扩展的 Python 模块中实现 FullOTA_GetBlockDifferences() 和 IncrementalOTA_GetBlockDifferences()。这两个函数返回一个 BlockDifference 对象列表，每个对象描述将应用于分区的更新补丁。这两个函数返回的分区不应手动修改或在其他地方验证，例如在 *_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，失败时返回空字符串。

update_dynamic_partitions 的 op_list 参数指向更新包中的一个文件。文件中的每一行指定一个操作。如果任何操作失败，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), …)

用于 update_dynamic_partitions 的 op_list 文件是使用此逻辑生成的

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), …)

用于 update_dynamic_partitions 的 op_list 文件是使用此逻辑生成的

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