Процесс выпуска универсального образа ядра (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 с эталонным устройством, а также с использованием Cuttlefish.

Рисунок 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 обнаруживает, что проблема специфична для конкретного OEM-производителя, устройства или модели, она может проверить, выполняется ли добавленный код только на затронутом устройстве, модели или артикуле.

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

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

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