Начиная с 27 марта 2025 г. мы рекомендуем использовать android-latest-release вместо aosp-main для создания и участия в AOSP. Дополнительные сведения см. в разделе Изменения в AOSP .
Оптимизируйте свои подборки
Сохраняйте и классифицируйте контент в соответствии со своими настройками.
На этой странице объясняется, как развернуть двоичный файл GBL.
Требования к загрузочной прошивке
Для использования GBL загрузочная прошивка должна соответствовать следующим требованиям:
Соответствие UEFI. Прошивка должна реализовывать и использовать требуемые протоколы UEFI. Прошивка также должна допускать расширения, специфичные для поставщика, с использованием определенных протоколов UEFI.
Безопасность. Прошивка должна реализовывать все аспекты Android Verified Boot (AVB), гарантируя загрузку только аутентифицированных образов.
Режимы загрузки. Двоичный файл должен уметь обрабатывать различные режимы загрузки, такие как обычная загрузка, загрузка восстановления и быстрая загрузка.
Динамическое разбиение на разделы. Загрузочная прошивка должна реализовывать логику выбора слота, чтобы она поддерживала чтение правильного загрузочного слота A/B и была совместима с динамическими разделами и пользовательскими данными в super.
Конфигурация ОС. Прошивка должна иметь возможность изменять командную строку ядра, дерево устройств (DTB) и конфигурацию загрузки с настройками OEM, необходимыми для загрузки устройства.
Загрузка защищенной виртуальной машины. Двоичный файл должен правильно загружать предварительно проверенную защищенную прошивку виртуальной машины перед ядром Android при наличии защищенных виртуальных машин. Для получения дополнительной информации см. Последовательность загрузки Microdroid.
Управление памятью. Загрузочная прошивка должна поддерживать API распределения памяти UEFI.
Совместимость и обратная совместимость. Прошивка должна работать на устройствах с разными поставщиками, SOC и поддерживать обратную совместимость с соответствующей версией Android.
Поддержка загрузочной прошивки
С учетом изменений, необходимых для поддержки требований, изложенных в предыдущем разделе, с GBF работают следующие реализации прошивки UEFI:
EDK2 (Tianocore) . EDK2 — это популярная реализация UEFI с открытым исходным кодом. Для загрузчиков на основе EDK2 необходима поддержка GBL, а поддержка UEFI уже присутствует.
U-Boot . Гибкий и широко используемый проект загрузчика с открытым исходным кодом, который приобретает совместимость с UEFI для использования GBL.
LittleKernel (LK) . Загрузчик с открытым исходным кодом, используемый некоторыми поставщиками.
Запустить ГБЛ
Вы можете получить готовый двоичный файл GBL для запуска или собрать свой собственный и запустить его.
Получите и запустите двоичный файл GBL
GBL распространяется как единый двоичный файл приложения EFI. Вы можете обновить этот двоичный файл независимо от базовой прошивки устройства, используя стандартный механизм обновления Android.
Начиная с Android 16, если вы поставляете устройство на базе чипсета ARM-64, мы настоятельно рекомендуем вам развернуть последнюю версию GBL, подписанную Google, и интегрировать ее в вашу цепочку загрузки.
Постройте и запустите GBL
Чтобы построить и запустить GBL:
Убедитесь, что у вас установлены инструмент репозитория и загрузчик Bazel:
sudo apt install repo bazel-bootstrap
Инициализируйте текущий каталог для управления исходным кодом с помощью файла манифеста uefi-gbl-mainline :
Если у вас есть вопросы, свяжитесь с командой GBL, отправив электронное письмо на android-gbl@google.com .
Контент и образцы кода на этой странице предоставлены по лицензиям. Java и OpenJDK – это зарегистрированные товарные знаки корпорации Oracle и ее аффилированных лиц.
Последнее обновление: 2025-07-29 UTC.
[[["Прост для понимания","easyToUnderstand","thumb-up"],["Помог мне решить мою проблему","solvedMyProblem","thumb-up"],["Другое","otherUp","thumb-up"]],[["Отсутствует нужная мне информация","missingTheInformationINeed","thumb-down"],["Слишком сложен/слишком много шагов","tooComplicatedTooManySteps","thumb-down"],["Устарел","outOfDate","thumb-down"],["Проблема с переводом текста","translationIssue","thumb-down"],["Проблемы образцов/кода","samplesCodeIssue","thumb-down"],["Другое","otherDown","thumb-down"]],["Последнее обновление: 2025-07-29 UTC."],[],[],null,["# Deploy GBL\n\nThis page explains how to deploy the GBL binary.\n\nBoot firmware requirements\n--------------------------\n\nTo use GBL, the boot firmware must meet the following requirements:\n\n- UEFI compliance. The firmware must implement and use the\n required UEFI protocols. The firmware must also allow for vendor-specific\n extensions using defined UEFI protocols.\n\n- Security. The firmware must implement all aspects of Android\n Verified Boot (AVB), ensuring only authenticated images are loaded.\n\n- Boot modes. The binary should be able to handle various boot modes, such as normal boot, recovery boot, and fastboot.\n\n- Dynamic partitioning. The boot firmware must implement slot selection logic so\n that it supports reading the correct A/B boot slot and is compatible with\n dynamic partitions and userdata in super.\n\n- OS configuration. The firmware must be capable of modifying the kernel\n command line, device tree (DTB), and bootconfig with OEM customizations\n needed to boot the device.\n\n- Protected VM loading. The binary should correctly load preverified protected\n VM firmware before the Android kernel in the presence of protected VMs. For\n further information, see Microdroid [boot sequence](/docs/core/virtualization/microdroid#boot-sequence).\n\n- Memory management. The boot firmware must support the UEFI memory allocation\n API.\n\n- Compatibility and backward compatibility. The firmware should work on devices\n with different vendor, SOCs, and maintain backward compatibility with the\n corresponding Android version.\n\n### Boot firmware support\n\nWith the modifications necessary to support requirements in the previous\nsection, the following UEFI firmware implementations work with the GBF:\n\n- [EDK2 (Tianocore)](https://github.com/tianocore/edk). A EDK2 is a popular open-source UEFI implementation. GBL support is needed for EDK2-based bootloaders, and UEFI support is already present.\n- [U-Boot](https://docs.u-boot.org/en/latest/). A flexible and widely used open-source bootloader project that is gaining UEFI compatibility for GBL usage.\n- [LittleKernel (LK)](https://github.com/littlekernel/lk). An open-source bootloader used by some vendors.\n\nRun GBL\n-------\n\nYou can obtain a prebuilt GBL binary to run or build your own and run it.\n\n### Obtain and run the GBL binary\n\nGBL is distributed as a single EFI app binary. You can update this\nbinary independently from the device's base firmware using Android's standard\nupdate mechanism.\n\nBeginning with Android 16, if you ship a device based\non ARM-64 chipset, we strongly recommend that you deploy the [latest\nGoogle-signed version](https://dl.google.com/android-gbl/android16/20250703/signed-gbl-img-13709664.zip) of GBL and integrate it into your boot chain.\n\n### Build and run the GBL\n\nTo build and run the GBL:\n\n1. Verify that you have the repo tool and Bazel bootstrap installed:\n\n sudo apt install repo bazel-bootstrap\n\n2. Initialize your current directory for source control using the `uefi-gbl-mainline` manifest file:\n\n repo init -u https://android.googlesource.com/kernel/manifest -b uefi-gbl-mainline\n repo sync -j16\n\n3. Build the EFI app:\n\n ./tools/bazel run //bootable/libbootloader:gbl_efi_dist --extra_toolchains=@gbl//toolchain:all\n\n4. Run the EFI app within Cuttlefish:\n\n cvd start --android_efi_loader=\u003cvar translate=\"no\"\u003e\u003cspan class=\"devsite-syntax-n\"\u003epath_to_the_EFI_app\u003c/span\u003e\u003c/var\u003e ...\n\n Instead of booting Android directly, this `cvd start` command uses the EFI\n app to boot Android.\n\n| **Note:** For x86 platform, use the EFI image built for x86_64.\n\nFile bugs and contact the bootloader team\n-----------------------------------------\n\nTo report a bug for the GBL, navigate to the\n[Android Generic Bootloader component in Buganizer](https://issuetracker.google.com/issues/new?component=1602063&template=2011730).\n\nFor questions, contact the GBL team, send an email to `android-gbl@google.com`."]]
