Proces publikowania ogólnego obrazu jądra (GKI)

Na tej stronie opisujemy, jak udostępniany jest GKI, w tym kwartalne i nadzwyczajne aktualizacje. Celem tej strony jest przekazanie producentom OEM wskazówek dotyczących tego, gdzie można pobrać GKI, oraz procesu wprowadzania awaryjnych poprawek poza pasmem. Producenci OEM mogą też skorzystać z informacji o opracowywaniu GKI, aby dowiedzieć się więcej o tym, jak współpracować z zespołem Android Kernel w celu optymalizacji jądra GKI pod kątem swoich produktów.

Częstotliwość publikowania wersji GKI

GKI jest udostępniany co kwartał po zamrożeniu KMI.

Ważność kompilacji GKI dla producentów OEM

Producenci OEM mogą używać niedawno opublikowanego jądra GKI Androida. Producenci OEM mogą wprowadzać na rynek kompilacje z certyfikatem GKI, o ile są one zgodne z wymaganiami dotyczącymi jądra LTS (Long-Term Supported) określonymi w Biuletynie bezpieczeństwa w Androidzie (ASB).

Kwartalne certyfikowane wersje

Kwartalne wersje GKI zawierają przetestowany boot.img, który zawiera certyfikat wstawiony przez Google, potwierdzający, że pliki binarne zostały utworzone na podstawie znanego źródła kodu.

W każdym kwartale po dacie odcięcia wybierana jest kandydacka wersja kwartalna GKI (niecertyfikowana). Po wybraniu wersji kandydującej do publikacji kwartalnej nowe zmiany nie będą akceptowane w wydaniu z tego miesiąca. W okresie zamkniętym można wprowadzać tylko poprawki błędów, które powodują niepowodzenie testu. Wersja kandydująca do publikacji przechodzi zapewnianie jakości opisaną w sekcji dotyczącej kwalifikacji GKI, aby sprawdzić, czy testy zgodności są zaliczane w przypadku kompilacji GSI+GKI na urządzeniu referencyjnym i na platformie Cuttlefish.

Rysunek 1. Harmonogram wersji GKI

Wymagania dotyczące GKI

Gdzie uzyskać artefakty kompilacji

Producenci OEM mogą pobierać artefakty wszystkich wersji ze strony ci.android.com.

Więcej informacji o CI, w tym wyniki testów, znajdziesz na panelu Android Continuous Integration.

Najczęstsze pytania

Poniżej znajdziesz odpowiedzi na najczęstsze pytania dotyczące procesu wydawania GKI.

Czy można utworzyć nowy plik binarny GKI na podstawie już opublikowanego GKI?

Tak, jest to tzw. ponowne losowanie. Proces tworzenia respinów jest obsługiwany, o ile wydana kompilacja GKI (na podstawie której zgłaszane jest żądanie respinu) jest zgodna z wymaganiami LTS określonymi w biuletynie bezpieczeństwa w Androidzie (ASB).

Czy można odtworzyć pliki binarne GKI?

Tak, oto przykład:

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

Aby odtworzyć przykład, pobierz plik manifest_$id.xml i uruchom to polecenie:

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

Kopię artefaktu GKI możesz pobrać z out/.../dist.

Czy plik binarny GKI (w tym poprawka awaryjna) został utworzony na podstawie najnowszego kodu?

Nie. Ponowne kompilacje zawierają tylko poprawki, które są dodawane do wybranych kwartalnych certyfikowanych jąder. Te ponowne kompilacje zawierają wszystkie poprawki błędów blokujących wprowadzenie na rynek, zgłoszone do danego momentu przez producentów OEM korzystających z odpowiedniej podstawowej wersji kwartalnej. Poniżej znajdziesz przykład, jak może wyglądać taka sytuacja.

• OEM1 i OEM2 decydują się na użycie binarnej wersji GKI z listopada 2021 r.
• OEM1 i OEM2 wykrywają problemy, które wymagają poprawek. Te poprawki mogą się różnić lub być takie same.
• Wersje binarne z listopada 2021 r. zawierają poprawki blokujące uruchomienie zgłoszone przez OEM1 i OEM2 w okresie ponownego przesyłania, ale nic więcej.
• Problemy wymienione w drugim punkcie są też uwzględniane w kolejnych kwartalnych wersjach GKI.

W październikowej wersji poprawionej znajdują się wszystkie poprawki przesłane przez producentów OEM, ale inne poprawki OEM mają na nas wpływ, ponieważ nie zostały specjalnie przetestowane na naszych produktach. Czy można uwzględnić tylko naszą poprawkę?

Nie jest to możliwe. Ścieżka ponownego przesyłania dla poszczególnych producentów OEM nie jest skalowalna. Zespół GKI dokładnie sprawdza każdą zmianę wprowadzaną w wersjach respin i testuje ją na wszystkich dostępnych urządzeniach, zanim utworzy nową wersję. Jeśli zespół GKI stwierdzi, że problem dotyczy konkretnego producenta OEM, urządzenia lub modelu, może sprawdzić, czy kod dodany przez zmianę jest wykonywany tylko na urządzeniu, modelu lub SKU, którego dotyczy problem.

Główną zaletą ujednoliconych wersji jest to, że każde urządzenie korzystające z tej samej wersji bazowej może czerpać korzyści z innych urządzeń, zwłaszcza jeśli wykryte przez nie błędy są ogólne i mają zastosowanie do wszystkich użytkowników. Przykładem tego są błędy w jądrze systemu operacyjnego wykryte podczas testów przeprowadzanych przez operatorów.

Czy w niektórych sytuacjach Google udostępnia konkretne informacje o łatkach OEM i scenariuszach problemów, aby producenci OEM mogli ocenić wpływ i ryzyko wdrożenia tych łatek w swoich produktach?

Google nie wprowadzi zmiany w wersji ponownej kompilacji, dopóki zespół GKI nie zrozumie problemu i nie zbierze wszystkich szczegółów. Możesz to sprawdzić w dzienniku zmian (komunikat zatwierdzenia). Google nie ujawnia, jakiego konkretnie urządzenia dotyczy problem, ale producenci OEM zawsze mogą znaleźć opis problemu i rozwiązanie w dzienniku zmian.