Процесс выпуска универсального образа ядра (GKI)

На этой странице описывается порядок выпуска GKI, включая еженедельные, ежеквартальные и внеплановые экстренные обновления. Цель этого документа — предоставить производителям оборудования (OEM) руководство по тому, где можно получить GKI, а также по процессу внеплановых экстренных исправлений. Производители оборудования также могут использовать GKI для разработки , чтобы узнать больше о том, как они могут сотрудничать с командой разработчиков ядра Android для оптимизации ядра GKI для своих продуктов.

График выпуска GKI

После заморозки проекта KMI, GKI выпускается ежеквартально.

Проверка корректности сборки GKI для OEM-производителей

Производители оборудования могут использовать недавно выпущенную версию Android GKI. Они могут выпускать сертифицированные GKI сборки, если те соответствуют требованиям LTS, изложенным в бюллетене безопасности Android (ASB).

Ежеквартальные сертифицированные релизы

Ежеквартальные релизы GKI содержат протестированный boot.img , включающий сертификат от Google, подтверждающий, что бинарные файлы были собраны на основе известной базовой версии исходного кода.

Каждый квартал после крайнего срока внесения изменений, который обычно приходится на вторую еженедельную сборку этого месяца, выбирается кандидат на ежеквартальный релиз GKI (несертифицированный). После выбора кандидата на ежеквартальный релиз новые изменения в релиз этого месяца приниматься не будут. В течение закрытого периода принимаются только исправления ошибок, приводящих к сбоям тестирования. Кандидат на релиз проходит проверку качества — как описано в разделе квалификации GKI — для обеспечения прохождения тестов на соответствие требованиям GSI+GKI как с эталонным устройством, так и с использованием модели каракатицы.

Рисунок 1. Хронология выпуска GKI.

Квалификации GKI

Где получить артефакты сборки?

Документацию по всем релизам можно получить на сайте ci.android.com .

Более подробную информацию о системе непрерывной интеграции, включая результаты тестирования, можно найти на панели мониторинга непрерывной интеграции Android .

Часто задаваемые вопросы

Ниже приведены некоторые часто задаваемые вопросы, касающиеся процесса выпуска GKI.

Возможно ли создать новый бинарный файл GKI на основе уже выпущенного GKI?

Да, это называется пересборкой (respin). Процесс пересборки поддерживается до тех пор, пока выпущенная сборка GKI (для которой запрашивается пересборка) соответствует требованиям LTS, указанным в бюллетене безопасности Android (ASB).

Возможно ли воспроизвести ошибки в бинарных файлах GKI?

Да, вот пример:

GKI 2.0
5.10 kernel prebuilts from build 7364300
https://ci.android.com/builds/submitted/7364300/kernel_aarch64/latest

Для воспроизведения примера загрузите файл manifest_$id.xml и выполните следующую команду:

repo init -u https://android.googlesource.com/kernel/manifest
mv manifest_7364300.xml .repo/manifests
repo init -m manifest_7364300.xml --depth=1
repo sync
# build the GKI images
# You may want to use LTO=thin to build faster for development
BUILD_CONFIG=common/build.config.gki.aarch64 build/build.sh
# (optional) build virtual platform modules
BUILD_CONFIG=common-modules/virtual-device/build.config.virtual_device.aarch64 build/build.sh

Вы можете получить копию артефакта GKI из out/.../dist .

Была ли собрана бинарная версия GKI (включая аварийный патч) на основе последней версии кода?

Нет. Переиздания содержат только патчи, которые устанавливаются поверх выбранных ежеквартально сертифицированных ядер. Эти переиздания содержат все исправления ошибок, препятствующие запуску, о которых сообщали производители оборудования, использующие соответствующий базовый ежеквартальный релиз. См. следующий пример того, как происходит подобный сценарий.

• OEM1 и OEM2 решили использовать бинарный релиз GKI от ноября 2021 года.
• OEM1 и OEM2 выявляют проблемы, требующие установки исправлений для обеспечения поддержки. Эти исправления могут быть разными или одинаковыми.
• В ходе повторных запусков версии, выпущенной поверх бинарного файла от ноября 2021 года, как сообщали OEM1 и OEM2, были устранены проблемы, препятствующие запуску, но не более того.
• Вопросы, упомянутые во втором пункте, также освещаются в последующих ежеквартальных отчетах GKI.

В октябрьском обновлении включены все патчи, предоставленные производителями оригинального оборудования (OEM), но другие патчи OEM затрагивают нас, поскольку они не были специально протестированы с нашей продукцией. Можно ли включить только наш патч?

Это невозможно. Создание индивидуальных версий программного обеспечения для каждого производителя (OEM) не масштабируемо. Вместо этого команда GKI тщательно проверяет каждое изменение, вносимое в новые сборки, и тестирует их на всем доступном оборудовании перед созданием новой сборки. Если команда GKI обнаруживает, что проблема специфична для конкретного производителя, устройства или модели, она может гарантировать, что добавленный код будет выполняться только на затронутом устройстве, модели или артикуле.

Главное преимущество унифицированных переизданий заключается в том, что все устройства, использующие одну и ту же базовую версию, получают выгоду от использования одной и той же версии, особенно если обнаруженные ошибки являются общими и применимы ко всем пользователям. Примером этого является обнаружение ошибок ядра в ходе тестирования операторами связи.

Бывают ли ситуации, когда Google предоставляет конкретную информацию об обновлениях для OEM-производителей и сценариях возникновения проблем, чтобы OEM-производители могли оценить влияние и риски внедрения этих обновлений в свою продукцию?

Google никогда не внесет изменения в пересборку, пока проблема не будет понята и не будут собраны все подробности. Это видно в журнале изменений (сообщении коммита). Google не раскрывает, на какие именно устройства это влияет, но производители всегда могут найти описание проблемы и решение в журнале изменений.