本页面介绍了如何部署通用引导加载程序 (GBL) 二进制文件。
启动固件要求
如需使用 GBL,启动固件必须满足以下要求:
符合统一可扩展固件接口 (UEFI) 标准。固件必须实现并使用所需的 UEFI 协议。固件还必须允许使用定义的 UEFI 协议进行供应商专属扩展。
安全。固件必须实现 Android 启动时验证 (AVB) 的所有要求,以便 GBL 能够对启动映像进行身份验证。
启动模式。该二进制文件应能够处理各种启动模式,例如正常启动、恢复启动和 fastboot。
动态分区。启动固件必须实现槽位选择逻辑,以便支持读取正确的 A/B 启动槽位,并与 super 中的动态分区和 userdata 兼容。
操作系统配置。固件必须能够使用启动设备所需的 OEM 自定义项来修改内核命令行、设备树 (DTB) 和 bootconfig。
正在加载受保护的虚拟机。在存在受保护虚拟机的情况下,该二进制文件应在 Android 内核之前正确加载预先验证的受保护虚拟机固件。如需了解详情,请参阅 Microdroid 启动序列。
内存管理。启动固件必须支持 UEFI 内存分配 API。
实施要求
如需在设备上正确实现 GBL,您必须满足以下要求:
您的设备必须在 SOC 可访问的块存储设备上包含两个名为
android_esp_a和android_esp_b的 8 MB(或更大)FAT 分区。- 块存储设备是一种可以按块为单位进行读取或写入的存储设备。例如 UFS、eMMC 和 SD 卡设备。
- 之所以使用 FAT,是因为它是一种普遍存在且简单的文件系统。
- 我们建议您根据需要从 FAT12、FAT16 和 FAT32 中选择合适的 FAT 文件系统。
- 在此 Android 版本的支持期限内,无线下载 (OTA) 更新和回滚都需要这两个分区。
- GBL 解压后的大小约为 2 MB。8 MB 足以应对未来七年内因额外功能而导致的任何增长。
- 如果 GBL 发生更新,您必须更新整个
android_esp_${SLOT_SUFFIX}分区。Android OTA 不支持仅 GBL 更新。 - 两个 FAT 分区使用的分区类型 GUID 必须与 EFI 系统分区 GUID
C12A7328-F81F-11D2-BA4B-00A0C93EC93B对应。
部署的 GBL 版本必须是相应 GBL 发布分支中的最新认证正式 build。我们建议您使用首选签名解决方案对经过 Google 认证的 GBL 副本进行签名,并将生成的 build 和签名元数据存储在
android_esp_${SLOT_SUFFIX}分区中。- OEM 签名必须使 GBL 证书保持不变,并且不得向二进制文件应用任何标头。
- 开发者 GBL build 仅用于开发和调试目的。 该 build 无法发布,也不会通过 Google 认证。
GBL 必须存储在 FAT 分区内的
/EFI/BOOT/BOOTAA64.EFI路径中。实现所需的 UEFI 和 Android UEFI 协议,以支持 GBL。如果不支持这些接口,GBL 的正式版 build 将无法启动。
EFI_BLOCK_IO_PROTOCOL或EFI_BLOCK_IO2_PROTOCOL从磁盘提取启动映像和 pvmfw 映像EFI_RNG_PROTOCOL,用于堆栈 Canary、KASLR 种子和 RNG 种子- 内存分配服务,用于分配暂存内存以执行 AVB 和 DICE 计算
EFI_SIMPLE_TEXT_OUTPUT_PROTOCOL提供了空操作实现选项,但 GBL 默认通过此协议进行日志记录GBL_EFI_AVB_PROTOCOL访问公钥和回滚索引以验证启动映像GBL_EFI_BOOT_CONTROL_PROTOCOL从固件获取槽位元数据和启动原因GBL_EFI_AVF_PROTOCOL根据 DICE 链生成 AVF 配置数据
固件必须向 GBL 提供 UEFI 变量。这些变量必须设置为
GBL_EFI_VENDOR_GUID值5a6d92f3-a2d0-4083-91a1-a50f6c3d9830,并且在引导加载程序锁定时必须保持只读状态并受到保护,以免被篡改。gbl_fw_api_level必须设置为平台固件的 API 级别,以指示供应商软件的 API 级别。此变量的值必须与ro.board.api_level系统属性的值相同。gbl_fw_product_first_api_level必须设置为设备发布时搭载的 SDK API 级别,并且在整个产品生命周期内必须保持不变,无论软件更新如何。此变量的值必须与ro.product.first_api_level系统属性的值相同。
GBL UEFI 协议中介绍了集成 GBL 时强烈建议使用的 UEFI 协议。
启动固件支持
通过进行必要的修改以支持上一部分中的要求,以下 UEFI 固件实现可与 GBL 搭配使用:
- EDK2 (Tianocore)。EDK2 是一种常用的开源 UEFI 实现。基于 EDK2 的引导加载程序需要 GBL 支持,而 UEFI 支持已经存在。
- U-Boot。一个灵活且广泛使用的开源引导加载程序项目,正在获得 UEFI 兼容性,以便用于 GBL。
- LittleKernel (LK)。部分供应商使用的开源引导加载程序。
运行 GBL
您可以获取预构建的 GBL 二进制文件来运行,也可以自行构建并运行。
获取并运行 GBL 二进制文件
GBL 以单个 UEFI 应用二进制文件的形式分发。您可以使用 Android 的标准更新机制,独立于设备的基本固件更新此二进制文件。
从 Android 16 开始,如果您发布基于 ARM-64 芯片组的设备,我们强烈建议您部署最新的 Google 认证版 GBL,并将其集成到启动链中。
如需调试此 GBL build,您可以下载以下任一制品来协助调试:
- 符号表使用硬件调试程序和 GDB 来调试 Google 认证的 GBL build。
- 清单通过使用
repo从源代码重新创建此 GBL build,对已签名的 build 进行更改。 - 相应的 GBL 开发者 build 可用于启动或对影响已签名 prod build 的问题进行不太复杂的调试。
- 符号表对于使用硬件调试程序和 GDB 的 GBL 开发者 build 非常有用。
如需查看所有版本的经过认证的二进制文件和符号,请参阅 GBL 发布 build。
构建 GBL
如需构建 GBL,请执行以下操作:
验证您是否已安装
repo工具和 Bazel 引导程序:sudo apt install repo bazel-bootstrap使用
uefi-gbl-mainline清单文件初始化当前目录以便控制源代码:repo init -u https://android.googlesource.com/kernel/manifest -b uefi-gbl-mainline repo sync -j16构建 UEFI 应用:
tools/bazel run //bootable/libbootloader:gbl_efi_dist
在 Android 虚拟设备上测试 GBL
在 Cuttlefish 中运行 GBL:
cvd start --android_efi_loader=path_to_the_UEFI_app ...此
cvd start命令不直接启动 Android,而是使用 UEFI 应用启动 Android。
提交 bug 并与引导加载程序团队联系
如需报告 GBL 的 bug,请前往 Buganizer 中的 Android 通用引导加载程序组件。
如有疑问,请发送电子邮件至 android-gbl@google.com,与 GBL 团队联系。