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

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

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

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

Срок действия сборки GKI для производителей устройств

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

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

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

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

Рисунок 1. Сроки выпуска GKI

Требования к GKI

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

Производители устройств могут получить артефакты для всех версий на сайте ci.android.com.

Дополнительную информацию о непрерывной интеграции, в том числе результаты тестирования, можно найти на панели управления Android Continuous Integration.

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

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

Можно ли создать новый двоичный файл GKI на основе уже выпущенного GKI?

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

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

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

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

Это невозможно. Путь повторного вращения для отдельных OEM-производителей не масштабируется. Вместо этого команда GKI тщательно проверяет каждое изменение, которое вносится в сборки, и тестирует изменения на всем доступном оборудовании, прежде чем создавать новую сборку. Если команда GKI обнаружит, что проблема связана с конкретным OEM, устройством или моделью, она может проверить, выполняется ли код, добавленный в результате изменения, только на затронутом устройстве, модели или SKU.

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

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

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