Genel Kernel Görüntüsü (GKI) sürüm işlemi

Bu sayfada, GKI'nın haftalık, üç aylık ve bant dışı acil sürümler de dahil olmak üzere nasıl yayınlandığı açıklanmaktadır. Bu belgenin amacı, OEM'lere GKI'yı nereden alacakları ve bant dışı acil durum düzeltmeleriyle ilgili süreç hakkında yönergeler vermektir. OEM'ler, GKI geliştirme ile Android Kernel ekibiyle nasıl çalışabilecekleri ve GKI çekirdeğini ürünleri için nasıl optimize edebilecekleri hakkında daha fazla bilgi edinebilir.

GKI yayınlama sıklığı

GKI, KMI dondurulduktan sonra üç aylık aralıklarla yayınlanır.

OEM'ler için GKI derleme geçerliliği

OEM'ler, kısa süre önce yayınlanan bir Android GKI'yi kullanabilir. OEM'ler, Android Güvenlik Bülteni'ndeki (ASB) LTS şartlarına uydukları sürece GKI sertifikalı derlemelerle lansman yapabilir.

Haftalık geliştirme sürümleri

GKI ikili dosyaları, değişiklikler birleştirildikçe Android CI'da self servis olarak kullanılabilir. Haftalık derlemeler sertifikalandırılmaz ancak geliştirme ve test için temel olarak kullanılabilir. Haftalık derlemeler, son kullanıcılar için üretim cihazı derlemelerinde kullanılamaz.

Üç aylık sertifikalı sürümler

GKI'nın üç aylık sürümlerinde, ikili dosyaların bilinen bir kaynak kodu temelinden oluşturulduğunu onaylamak için Google tarafından eklenmiş bir sertifika içeren, test edilmiş bir boot.img bulunur.

Her çeyrekte, check-in son tarihinden sonra bir GKI çeyrek sürümü adayı (sertifikalı değil) seçilir. Bu tarih genellikle o ayın ikinci haftalık derlemesidir. Üç aylık yayın adayı seçildikten sonra yeni değişiklikler o ayın sürümüne dahil edilmez. Kapalı dönemde yalnızca testin başarısız olmasına neden olan hatalarla ilgili düzeltmeler yapılabilir. Yayın adayı, referans cihaz ve cuttlefish ile GSI+GKI derlemesinde uygunluk testlerinin geçmesini sağlamak için GKI yeterlilik bölümünde açıklandığı gibi kalite güvencesinden geçer.

1. Şekil. GKI yayın zaman çizelgesi

Acil yeniden inceleme süreci

Yeniden derleme, GKI çekirdeğinin herkese açık sürümünden sonra ikili programın yeniden birleştirilmesi, yeniden derlenmesi, yeniden test edilmesi ve yeniden sertifikalandırılması sürecini ifade eder. Aşağıdaki durumlardan herhangi birinde, onaylı bir ikili dosyanın yeniden döndürülmesini isteyebilirsiniz:

• Bir sembol listesini güncellemek için:
• Kargo şirketi laboratuvarı onayı sırasında bulunanlar da dahil olmak üzere hatalara düzeltme uygulamak için.
• Tedarikçi kancası eklemek için.
• Mevcut bir özelliğe yama uygulamak için.
• Güvenlik yaması uygulamak için (6 ay sonra).

Güvenlik yamaları, dalın yayınlanmasından sonraki 6 aya kadar yayın dalıyla otomatik olarak birleştirilir. 6 aylık süre dolduktan sonra, bir dala güvenlik yamaları uygulamak için yeniden döndürme isteğinde bulunmanız gerekir.

Yeniden yazma isteği yönergeleri

Yeniden döndürme isteğinde bulunmadan önce aşağıdaki yönergeleri göz önünde bulundurun:

• Yeniden döndürmelere yalnızca üç aylık bir derlemenin ilk herkese açık sürümü yayınlandıktan sonra sürüm dallarında izin verilir.

• Yeniden oluşturma istekleri yalnızca belirli bir sürüm dalı için ve ilk herkese açık sürümden sonraki en fazla altı ay içinde kabul edilir. Altı ay sonra, dallar yalnızca bir Android Güvenlik Bülteni'nde belirtilen güvenlik yamaları için yeniden derlenebilir.

• Android Güvenlik Bülteni (ASB) tarafından tanımlanan LTS şartları, dalın uyumsuz olmasına neden olduğunda dalın desteği sonlandırılır. Kullanımdan kaldırılan dallar için yeniden derleme istekleri kabul edilmez. Belirli bir GKI sürüm dalının desteğinin sonlandırılma tarihi, Sürümler bölümündeki üç aylık GKI sürüm derleme notlarında yer alır. Gelecekteki planlama için LTS şartları her yıl Mayıs ve Kasım aylarında güncellenir. Örneğin, android12-5.10-2023-07 dalı (5.10.177), 1 Mayıs 2024'ten sonra yeniden oluşturma için desteklenmez. Bunun nedeni, android12-5.10-2023-07 dalının (5.10.177) ASB-2024-05'in LTS şartlarına uymamasıdır.

• Yeniden gönderme yalnızca acil hata düzeltmeleri, sembol listesi güncellemeleri veya mevcut bir özelliği düzeltmek için yama uygulamak amacıyla kullanılabilir.

• Üç aylık sürüm dalına dahil edilecek tüm yamaların, ana GKI geliştirme dalıyla birleştirilmiş olması gerekir. Örneğin, android12-5.10-2022-09 öğesinin yeniden oluşturulması için bir yama gerekiyorsa bu yama android12-5.10 ile birleştirilmiş olmalıdır.

• Ana GKI geliştirme dalından yamaları seçip üç aylık sürüm dalına yüklemeniz gerekir.

• Yeniden oluşturma isteğinde, isteğe bir öncelik (acil durum) atamanız gerekir. Bu öncelik, GKI ekibinin iş ortaklarına zamanında daha iyi yardımcı olmasına olanak tanır. Kritik veya zamana duyarlı istekler için önceliği P0 olarak işaretleyin. P0 ve P1 taleplerinde aciliyet durumunu da gerekçelendirmeniz gerekir. Aşağıdaki tabloda, hata önceliği ve çözüme ulaşma süresi (ESRT) eşlemesi verilmiştir:

  Öncelik	ESRT
  P0	2 iş günü
  P1	5 iş günü
  P2	10 iş günü
  P3	15 iş günü

• Her yayın dalı için ayrı bir yeniden döndürme isteği göndermeniz gerekir. Örneğin, hem android12-5.10-2022-08 hem de android12-5.10-2022-09 için yeniden döndürme gerekirse iki yeniden döndürme isteği oluşturmanız gerekir.

• Bir derleme sağlandıktan ve yeniden derleme isteği düzeltildi olarak işaretlendikten sonra, ek CL'ler eklemek için yeniden derleme isteğini yeniden açmamalısınız. Birleştirilmesi gereken ek yamalar varsa yeni bir yeniden döndürme isteği göndermeniz gerekir.

• Değerlendirilen her CL için aşağıdaki etiketleri ekleyin.

  • Bug: Her CL için commit mesajına hata kimliği eklenmelidir.
  • Change-Id: Temel dal değişikliğinin Change-Id'siyle aynı olmalıdır.

• Yeniden oynatma isteği yanıtınızı gerektiriyorsa ve üç iş günü içinde yanıt vermezseniz öncelik bir seviye düşürülür (örneğin, P0, P1'e düşürülür). İki hafta boyunca yanıt vermezseniz hata Düzeltilmeyecek (Eski) olarak işaretlenir.

Yeniden döndürme isteği gönderme

Aşağıdaki şemada yeniden döndürme işlemi gösterilmektedir. Süreç, OEM iş ortağı (siz) yeniden döndürme isteğini gönderdiğinde başlar.

Şekil 2. Yeniden döndürme süreci

Yeniden döndürme sürecine girmek için:

1. GKI yeniden döndürme isteği formunu doldurun ve hemen Google Teknik Hesap Yöneticinizle iletişime geçin. Bu form, GKI yeniden döndürme isteği hatası oluşturur. Yeniden oluşturma isteğiyle ilgili hatalar size (istekte bulunan), GKI ekibine ve hatanın CC listesine eklediğiniz belirli kişilere gösterilir.
   • Düzeltme zaten varsa Google'ın inceleyebilmesi için istek, AOSP'deki yama gönderimine yönlendirmelidir. Yama gönderilemiyorsa yama, isteğe metin dosyası olarak eklenmelidir.
   • Düzeltme yoksa Google'ın sorunu ayıklamasına yardımcı olabilmesi için istek, çekirdek sürüm numarası ve günlükler dahil olmak üzere mümkün olduğunca fazla bilgi içermelidir.
2. Google GKI ekibi, isteği inceler ve onaylar ya da daha fazla bilgiye ihtiyaç duyulursa isteği size geri atar.
3. Düzeltme üzerinde anlaşıldıktan sonra Google GKI ekibi değişikliği kod incelemesine (CR+2) tabi tutar. İnceleme, ESRT zaman aralığında başlar. GKI ekibi, değişikliği birleştirir, oluşturur, regresyon için test eder ve sertifikalandırır.
4. İkili, ci.android.com'da yayınlanır. ESRT zaman aralığı sona erer ve Google GKI ekibi, isteği düzeltilmiş olarak işaretleyip yeniden derleme sürümüne referans verir. Yeniden derleme sürümü, Generic Kernel Image (GKI) sürüm derlemeleri sayfasında da yayınlanır.

GKI yeterlilikleri

Derleme yapılarını nereden edinebilirsiniz?

Tüm sürümlerin yapıları ci.android.com adresinden edinilebilir.

Test sonuçları da dahil olmak üzere CI hakkında daha fazla bilgiyi Android Sürekli Entegrasyon kontrol panelinde bulabilirsiniz.

SSS

GKI yayınlama süreciyle ilgili sık sorulan bazı soruları aşağıda bulabilirsiniz.

Daha önce yayınlanmış bir GKI'ye dayalı yeni bir GKI ikili dosyası oluşturmak mümkün mü?

Evet, bu işleme yeniden döndürme denir. Yeniden derleme işlemi, yayınlanan GKI derlemesi (yeniden derlemenin istendiği) Android Güvenlik Bülteni'ndeki (ASB) LTS şartlarına uygun olduğu sürece desteklenir.

GKI ikili dosyalarını yeniden oluşturmak mümkün mü?

Evet, örneği aşağıda görebilirsiniz:

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

Örneği yeniden oluşturmak için manifest_$id.xml dosyasını indirip aşağıdaki komutu çalıştırın:

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 yapay nesne kopyanızı out/.../dist adresinden alabilirsiniz.

GKI ikili dosyası (acil durum yama paketi dahil) en son kod tabanında oluşturuldu mu?

Hayır. Yeniden döndürmeler yalnızca seçilen üç aylık sertifikalı çekirdeklerin üzerine uygulanan yamaları içerir. Bu yeniden derlemeler, ilgili temel üç aylık sürümü kullanan OEM'ler tarafından belirli bir zamana kadar bildirilen tüm lansmanı engelleyen hata düzeltmelerini içerir. Bu tür bir senaryonun nasıl gerçekleştiğine dair aşağıdaki örneğe bakın.

• OEM1 ve OEM2, Kasım 2021'deki GKI ikili sürümünü kullanmaya karar verir.
• OEM1 ve OEM2, destek için yamalar gerektiren sorunlar bulur. Bu yamalar farklı veya aynı olabilir.
• Kasım 2021 ikilisinin üzerinde yeniden oluşturulan sürümlerde, yeniden oluşturma penceresi sırasında hem OEM1 hem de OEM2 tarafından bildirilen lansman engelleme düzeltmeleri bulunur ancak başka bir şey yoktur.
• İkinci madde işaretinde belirtilen sorunlar, sonraki GKI üç aylık sürümlerine de dahil edilir.

Ekim ayındaki yeniden derleme, OEM tarafından gönderilen tüm yamaları içerir ancak diğer OEM yamaları, ürünlerimizle özel olarak test edilmedikleri için bizi etkiler. Yalnızca yama dosyamızı eklemek mümkün mü?

Bu mümkün değildir. "OEM başına" yeniden döndürme yolu ölçeklenebilir değildir. Bunun yerine, GKI ekibi yeniden derleme işlemlerine dahil edilen her değişikliği ayrı ayrı inceler ve yeni bir derleme oluşturmadan önce değişiklikleri mevcut tüm donanımlarla test eder. GKI ekibi, sorunun belirli bir OEM, cihaz veya modelle ilgili olduğunu tespit ederse değişiklikle eklenen kodun yalnızca etkilenen cihazda, modelde veya SKU'da yürütülmesini sağlayabilir.

Birleştirilmiş yeniden döndürmelerin en büyük avantajı, aynı yayın tabanını kullanan her cihazın birbirinden yararlanmasıdır. Özellikle de keşfettikleri hatalar genel ve tüm kullanıcılar için geçerliyse bu avantaj daha da belirginleşir. Operatör testinde bulunan temel çekirdek hataları, bu kavramın belirli bir örneğidir.

Google, OEM'lerin yamaları ürünlerine uygulama etkisini ve riskini değerlendirebilmesi için OEM yamaları ve sorun senaryoları hakkında belirli bilgiler sağladığı durumlar var mı?

Google, sorun anlaşılana ve tüm ayrıntılar toplanana kadar yeniden oluşturulan bir derlemeye hiçbir zaman değişiklik eklemez. Bu durum, değişiklik günlüğünde (commit mesajı) görülür. Google, hangi cihazın etkilendiğini açıklamaz ancak OEM'ler her zaman değişiklik günlüğünde sorunun açıklamasını ve çözümünü bulabilir.