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

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

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

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

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

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

Выпуски GKI с размером страницы 16 КБ

Команда по выпуску GKI обрабатывает релизы GKI размером 16 КБ с той же периодичностью (раз в квартал), с помощью тех же квалификационных тестов и процесса повторного выпуска, что и релизы GKI размером 4 КБ:

• Поддерживаемые ветви:
  • android15-6.6 (с января 2026 г.)
  • android16-6.12 (с марта 2026 г.)
  • android17-6.18 (с июня 2026 г.)
• Паритет сборок и сертификация. В двоичных файлах GKI с размером страницы 16 КБ используются те же тег источника и идентификатор сборки ядра, что и в соответствующем выпуске GKI с размером страницы 4 КБ. До 2027 года на вкладке 16 KB release build (Конечная сборка 16 КБ) на страницах конечных сборок android15-6.6, android16-6.12 и android17-6.18 будут доступны несертифицированные конечные двоичные файлы GKI 16 КБ. Обновлять ядра с размером страницы 4 КБ и 16 КБ одновременно не обязательно, но мы рекомендуем это делать.
• Пересборка по запросу. Запросите пересборку GKI со страницами памяти размером 16 КБ, используя процесс и форму запроса пересборки для сборок со страницами памяти размером 4 КБ.

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

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

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

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

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

Где найти артефакты сборки

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

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

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

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

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