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

Bu sayfada, haftalık, aylık ve bant dışı acil sürümler dahil olmak üzere GKI'nın nasıl yayınlandığı açıklanmaktadır. Bu belgenin amacı, OEM'lere GKI'yı nereden alacakları ve bant dışı acil durum düzeltmelerinin süreci hakkında bir kılavuz sunmaktır. OEM'ler, GKI çekirdeğini ürünleri için optimize etmek amacıyla Android çekirdek ekibiyle nasıl çalışabilecekleri hakkında daha fazla bilgi edinmek için GKI geliştirme özelliğini de kullanabilir.

GKI yayınlama sıklığı

GKI, KMI dondurulduktan sonra aylık olarak yayınlanır.

Android 13, 14 ve 15 GKI sürümü

Aşağıdaki tablo yalnızca android13-5.10, android13-5.15 ve android14-5.15 için geçerlidir.

Aşağıdaki tablo yalnızca android14-6.1 ve android15-6.6 için geçerlidir.

Android 12 GKI sürümü

Mayıs 2024'ten sonra android12-5.10 GKI sürümleri üç aylık aralıklarla ayın ortasında yayınlanır. Aşağıdaki tablo yalnızca android12-5.10 için geçerlidir.

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

OEM'ler yakın zamanda yayınlanan bir Android GKI'yı kullanabilir. OEM'ler, Android Güvenlik Bülteni'ndeki (ASB) LTS şartlarına uydukları sürece GKI sertifikalı derlemelerle ürün lansmanı yapabilir.

Haftalık geliştirme sürümleri

Değişiklikler birleştirildiği için Android CI'dan self servis için GKI ikili programları kullanılabilir. Haftalık derlemeler onaylanmasa da geliştirme ve test için bir temel olarak kullanılabilir. Haftalık derlemeler, son kullanıcılar için üretim cihaz derlemeleri olarak kullanılamaz.

Aylık sertifikalı sürümler

GKI'nın aylık sürümleri, ikili programların bilinen bir kaynak kod referans değerinden derlendiğini doğrulamak için Google tarafından eklenen bir sertifika içeren test edilmiş bir boot.img içerir.

Her ay, GKI aylık sürüm adayı (sertifikasız) giriş son tarihi sonrasında seçilir. Bu tarih genellikle ilgili ayın ikinci haftalık derlemesidir. Aylık sürüm adayı seçildikten sonra yeni değişiklikler o ayın sürümünde kabul edilmez. Kapalı zaman aralığında yalnızca test hatasına neden olan hataların düzeltmeleri yapılabilir. Yayın adayı, GSI+GKI derlemesinde referans cihazın yanı sıra mürekkep balığı ile uyumluluk testlerinin geçebilmesi için GKI uygunluk bölümünde açıklandığı şekilde kalite güvencesi sürecinden geçer.

Şekil 1. GKI sürüm zaman çizelgesi

Acil durum yeniden döndürme işlemi

Yeniden derleme, GKI çekirdeğinin herkese açık olarak yayınlanmasından sonra bir ikili dosyayı yeniden birleştirme, yeniden derleme, yeniden test etme ve yeniden sertifikalandırma işlemini ifade eder. Aşağıdaki durumlardan herhangi biri için sertifikalı bir ikili dosyanın yeniden gönderilmesini isteyebilirsiniz:

• Bir simge listesini güncellemek için:
• Operatör laboratuvar onayı sırasında bulunan hatalar da dahil olmak üzere bir hataya düzeltme uygulamak için
• Tedarikçi firma kancası eklemek için.
• Mevcut bir özelliğe yama uygulamak için.
• Güvenlik yaması uygulamak için (6 aydan sonra).

Güvenlik yamaları, dalın kullanıma sunulmasından sonra en fazla 6 ay boyunca otomatik olarak bir sürüm dalında birleştirilir. 6 aylık son tarihten sonra, bir dala güvenlik yamaları uygulamak için yeniden inceleme isteğinde bulunmanız gerekir.

Yeniden çevirme isteği kuralları

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

• Yeniden yayınlamaya yalnızca aylık bir derlemenin ilk herkese açık sürümünün yayınlanmasından sonra sürüm dallarında izin verilir.

• Respin istekleri, yalnızca belirli bir sürüm şubesi için, herkese açık ilk yayından sonra en fazla altı ay boyunca kabul edilir. Altı ay sonra, şubeler yalnızca bir Android Güvenlik Bülteni'nde belirtilen güvenlik yamaları için yeniden etkinleştirme için uygun hale gelir.

• Android Güvenlik Bülteni (ASB) tarafından tanımlanan LTS koşulları, dalın uyumlu olmamasına neden olduğunda dalın desteği sonlandırılır. Kullanımdan kaldırılan dallar için Respin 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ına dahil edilir. Gelecekteki planlama için LTS şartları Mayıs ve Kasım aylarında her yıl güncellenir. Örneğin, android12-5.10-2023-07 şubesi (5.10.177), ASB-2024-05'in LTS şartlarına uymadığı için 1 Mayıs 2024'ten sonra yeniden gönderim için android12-5.10-2023-07 şubesi (5.10.177) tarafından desteklenmez.

• Yeniden yayınlama yalnızca acil hata düzeltmeleri, simge listesi güncellemeleri veya mevcut bir özelliği düzeltmek için bir yama uygulamak için geçerlidir.

• Aylık sürüm dalına eklenen tüm yamalar, ana GKI geliştirme dalıyla birleştirilmiş olmalıdır. Örneğin, android12-5.10-2022-09 Respin'i için yama gerekliyse önceden android12-5.10 ile birleştirilmiş olmalıdır.

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

• Yeniden gönderme isteğinde, isteğe bir öncelik (aciliyet) atamanız gerekir. Bu öncelik, GKI ekibinin iş ortaklarına daha iyi zamanında daha iyi yardımcı olmasına yardımcı olur. Kritik veya zamanı kısıtlı olan istekler için önceliği P0 olarak işaretleyin. P0 ve P1 istekleri için aciliyeti de gerekçelendirmeniz gerekir. Aşağıdaki tabloda, hata önceliği ile çözüme ulaşma süresi (ESRT) arasındaki ilişki gösterilmektedir:

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

• Sürüm dalı başına ayrı bir yeniden gönderme isteği göndermeniz gerekir. Örneğin, hem android12-5.10-2022-08 hem de android12-5.10-2022-09 için yeniden gönderme gerekiyorsa iki yeniden gönderme isteği oluşturmanız gerekir.

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

• İncelenen her CL için aşağıdaki etiketleri ekleyin.

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

• Yeniden inceleme 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 olarak düşürülür). İki hafta boyunca yanıt vermezseniz hata Düzeltilmeyecek (Geçersiz) olarak işaretlenir.

respin isteği gönderin

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

Şekil 2. Respin işlemi

Yeniden gönderme sürecine girmek için:

1. GKI Respin istek formunu doldurun. Hemen Google Teknik Hesap Yöneticinizle iletişime geçin. Bu form, GKI respin isteği hatası oluşturur. Yeniden gönderme isteği hataları size (istemde bulunan kullanıcı), GKI ekibine ve hatanın CC listesine eklediğiniz belirli kullanıcılara görünür.
   • Halihazırda bir düzeltmeniz varsa Google'ın inceleyebilmesi için istek, AOSP'deki yama gönderme işlemine yönlendirmelidir. Yama göndermek mümkün değilse yama isteğe metin dosyası olarak eklenmelidir.
   • Düzeltme sunmuyorsanız Google'ın sorunla ilgili hata ayıklama işlemine yardımcı olabilmesi için istekte çekirdek sürüm numarası ve günlükler dahil olmak üzere mümkün olduğunca fazla bilgi bulunmalıdır.
2. Google GKI ekibi isteği inceleyip onaylar veya daha fazla bilgi gerekirse size geri atar.
3. Bir düzeltme üzerinde anlaşmaya varıldıktan sonra, Google GKI ekibi kodu (CR+2) değişikliği inceler. İnceleme, ESRT zaman aralığını başlatır. GKI ekibi, değişiklikleri birleştirir, oluşturur, regresyon için test eder ve sertifikalar.
4. İkili kod ci.android.com'da yayınlanır. ESRT zaman aralığı sona erer ve Google GKI ekibi isteği düzeltilmiş olarak işaretler ve yeniden gönderme derlemesini referans olarak belirtir. Yeniden gönderme derlemesi, Genel Çekirdek Görüntüsü (GKI) sürüm derlemeleri sayfasında da yayınlanır.

GKI nitelikleri

Derleme yapıları nereden alınır?

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

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

SSS

GKI yayın süreciyle ilgili sık sorulan bazı soruları burada bulabilirsiniz.

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

Evet, buna yeniden çevirme denir. Yeniden gönderme işlemi, yayınlanan GKI derlemesi (yeniden gönderme isteğinin gönderildiği derleme) Android Güvenlik Bültenindeki (ASB) LTS şartlarına uygun olduğu sürece desteklenir.

GKI ikililerini yeniden oluşturmak mümkün mü?

Evet, şu örneği inceleyebilirsiniz:

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ı indirin ve aşağıdaki komutu yürütü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 yapı kopyanızı out/.../dist hizmetinden alabilirsiniz.

GKI ikili dosyası (acil durum spin yaması dahil) en son kod tabanında derlenmiş mi?

Hayır. Yeniden yayınlama işlemi yalnızca seçilen aylık sertifikalı çekirdeklerin üzerinde bulunan yamaları içerir. Bu respin'ler, ilgili aylık temel 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 senaryoyu gösteren aşağıdaki örneğe bakın.

• OEM1 ve OEM2, Kasım 2021'den itibaren GKI ikili sürümünü kullanmaya karar verir.
• OEM1 ve OEM2, destek için düzeltme gerektiren sorunlar bulur. Bu yamalar farklı veya aynı olabilir.
• Kasım 2021 ikili programının üst kısmındaki respin'lerde, yeniden etkinleştirme zaman aralığında hem OEM1 hem de OEM2 tarafından bildirilen lansman engelleme düzeltmeleri var, ancak başka hiçbir şey yok.
• İkinci maddede belirtilen sorunlar, sonraki aylık GKI sürümlerine de dahil edilir.

Ekim ayı respin'inde, OEM tarafından gönderilen tüm yamalar yer alıyor ancak diğer OEM yamaları, ürünlerimizle özel olarak test edilmedikleri için bizi etkiliyor. Yalnızca yamanızı dahil etmek mümkün mü?

Bu mümkün değildir. "OEM başına" yeniden gönderme yolu ölçeklenebilir değildir. Bunun yerine GKI ekibi, yeniden oluşturma derlemelerine dahil edilen her değişikliği inceler ve yeni bir derleme oluşturmadan önce mevcut tüm donanımlarla değişiklikleri test eder. GKI ekibi, sorunun bir OEM'ye, cihaza veya modele özgü olduğunu tespit ederse değişiklikle eklenen kodun yalnızca etkilenen cihaz, model veya SKU'da yürütülmesini sağlayabilir.

Birleştirilmiş respin'lerin en büyük avantajı, aynı sürüm tabanını kullanan her cihazın birbirinden yararlanmasıdır (özellikle de keşfedilen hatalar genel ve tüm kullanıcılar için geçerliyse). Operatör testinde bulunan çekirdek çekirdek hataları bu kavramın özel bir örneğidir.

OEM'lerin, bu yamaları ürünlerine uygulamanın etkisini ve riskini değerlendirebilmesi için Google'ın 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 respin derlemesinde hiçbir zaman değişiklik yapmaz. Bu durum, değişiklik günlüğünde (taahhüt mesajı) gösterilir. Google, bu sorunun hangi cihazı etkilediğini açıklamaz ancak OEM'ler, sorun açıklamasını ve çözümünü her zaman değişiklik günlüğünde bulabilir.