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 sürüm 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.
GKI aylık sertifikalı derlemeleri | Giriş için son tarih | GKI önceden yükleme hazır tarihi | Onaylıyor musunuz? |
---|---|---|---|
Kasım | 11 Kasım 2024 | 27 Kasım 2024 | Evet |
Ocak | 14 Ocak 2025 | 31 Ocak 2025 | Evet |
Mart | 14 Mart 2025 | 31 Mart 2025 | Evet |
Aşağıdaki tablo yalnızca android14-6.1
ve android15-6.6
için geçerlidir.
GKI aylık sertifikalı derlemeleri | Giriş için son tarih | GKI önceden yükleme hazır tarihi | Onaylıyor musunuz? |
---|---|---|---|
Ekim | 1 Ekim 2024 | 14 Ekim 2024 | Evet |
Kasım | 1 Kasım 2024 | 15 Kasım 2024 | Evet |
Aralık | 2 Aralık 2024 | 16 Aralık 2024 | Evet |
Ocak | 6 Ocak 2025 | 22 Ocak 2025 | Evet |
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.
GKI aylık sertifikalı derlemeleri | Giriş için son tarih | GKI önceden yükleme hazır tarihi | Onaylıyor musunuz? |
---|---|---|---|
Kasım | 1 Kasım 2024 | 15 Kasım 2024 | Evet |
Şubat | 3 Şubat 2025 | 17 Şubat 2025 | Evet |
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
Sürümler, minimum kalite eşiğini aştığından emin olmak için Mürekkep Balığı ile test edilir.Değişiklikler birleştirilirken GKI ikili dosyaları, self servis olarak Android CI'den kullanılabilir. Haftalık derlemeler sertifikalandırılmaz ancak geliştirme ve test için referans noktası 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ı pencere döneminde yalnızca testin başarısız olmasına neden olan hatalar için düzeltmeler 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 yeniden gönderme süreci
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
- Satıcı 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 yayınlanmasından sonraki 6 aya kadar bir sürüm dalıyla otomatik olarak 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.
Yeniden gönderme istekleri, yalnızca belirli bir sürüm dalında ilk herkese açık sürümden sonraki en fazla altı ay boyunca kabul edilir. Altı ay sonra, yalnızca Android Güvenlik Bülteninde belirtilen güvenlik yamaları için yeniden gönderme yapılabilir.
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. Desteği sonlandırılan dallar için yeniden gönderme 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 koşulları her yıl Mayıs ve Kasım aylarında 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çinandroid12-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 düzeltme yaması 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
için yeniden dağıtım yama gerekiyorsa bu yamaandroid12-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 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 deandroid12-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 yeniden gönderme 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.
Yanıtınızın gerekli olduğu bir yeniden inceleme isteği üç iş günü içinde yanıtlanmazsa ö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.
Yeniden inceleme isteği gönderme
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. Yeniden gönderme süreci
Yeniden gönderme sürecine girmek için:
- GKI yeniden itiraz isteği formunu doldurun ve hemen Google teknik hesap yöneticinizle iletişime geçin. Bu form, GKI yeniden gönderme 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 düzeltmeyi inceleyebilmesi için istekte AOSP'deki yama gönderimini belirtmeniz gerekir. 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.
- Google GKI ekibi, isteği inceler ve onaylar ya da daha fazla bilgiye ihtiyaç duyulursa size geri atar.
- Bir düzeltme üzerinde anlaşmaya varıldıktan sonra Google GKI ekibi, değişikliği kod incelemesi (CR+2) yapar. İnceleme, ESRT zaman aralığını başlatır. GKI ekibi, değişiklikleri birleştirir, oluşturur, regresyon için test eder ve sertifikalar.
- İ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
GKI derleme türleri | Kalite uygulaması | Notlar |
---|---|---|
Haftalık | Mürekkep balığı testi
|
|
Aylık (sertifikalı) | Mürekkep balığı testi
|
|
Yeniden çevirmeler (sertifikalı) | Mürekkep balığı testi
|
|
Derleme yapılarını nereden edinebilirim?
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ınlama süreciyle ilgili sık sorulan bazı soruları aşağıda 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ı indirip 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
adresinden 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 temel aylık sürümü kullanan OEM'ler tarafından belirli bir tarihe 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 yamalar gerektiren sorunlar bulur. Bu yamalar farklı veya aynı olabilir.
- Kasım 2021 ikilisinin üzerine yapılan yeniden göndermelerde, yeniden gönderme aralığı sırasında hem OEM1 hem de OEM2 tarafından bildirilen başlatma engelleme düzeltmeleri vardır ancak başka bir düzeltme yoktur.
- İ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 yamamız eklenebilir mi?
Bu mümkün değildir. "OEM başına" yeniden gönderme yolu ölçeklenebilir değildir. Bunun yerine GKI ekibi, respin derlemelerine eklenen her değişikliği inceler ve yeni bir derleme oluşturmadan önce değişiklikleri mevcut tüm donanımlarla 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 yeniden gönderme derlemesine hiçbir zaman değişiklik eklemez. 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.