Bu sayfada, geriye dönük uyumluluğun nasıl işleneceği ve ve bu bilgilerin nasıl kullanılacağını uyumsuz değişiklikler var.
Bazel gelişiyor. Küçük sürümler LTS ana sürümü tamamen geriye dönük uyumludur. Ana LTS sürümleri arasındaki değişiklikler, aşağıdakileri yapmayı gerektiren uyumsuz değişiklikler içerebilir: biraz zahmetli olabilir. Bazel yayınlama sıklığı hakkında daha fazla bilgi için çalışır, bakın Bazel Uzun Vadeli Destek (LTS) sürümleri duyurusu.
Özet
- Değişiklikleri zarar vermek için
--incompatible_*işaretinin kullanılması önerilir. - Her
--incompatible_*işareti için bir GitHub sorunu, ve bir geçiş tarifi sunmayı hedefler. --experimental_*işareti tarafından korunan API'ler ve davranışlar herhangi bir zamanda değişebilir.- Üretim derlemelerini hiçbir zaman
--experimental_*veya--incompatible_*işaretleriyle çalıştırmayın.
Bu politikaya nasıl uyabilirsiniz?
- Bazel kullanıcıları için: Bazel'i güncelleme
- Katkıda bulunanlar için - Uyumsuz değişikliklerle ilgili en iyi uygulamalar
- Sürüm yöneticileri için: Sorun etiketlerini ve sürüm güncelleme
Kararlı işlev nedir?
Genel olarak, --experimental_... işareti olmayan API'ler veya davranışlar dikkate alınır
ve Bazel'da desteklenen kararlı
özellikler bulunuyor.
Bunlardan bazıları:
- Starlark dili ve API'ler
- Bazel ile gruplandırılmış kurallar
- Remoteecution API'leri veya Derleme Etkinliği Protokolü gibi Bazel API'leri
- İşaretler ve anlamları
Uyumsuz değişiklikler ve taşıma yöntemleri
Bazel ekibi, yeni bir sürümdeki her uyumsuz değişiklik için
Kodunuzu güncellemenize yardımcı olan taşıma tarifi
(BUILD ve .bzl dosyalarının yanı sıra komut dosyalarındaki Bazel kullanımları,
kullanımı vb.).
Uyumsuz değişiklikler için ilişkili bir --incompatible_* işareti ve
ilgili GitHub sorununu düzeltmenizi sağlar.
Uyumsuz değişiklikleri bildirme
Uyumsuz değişikliklerle ilgili birincil bilgi kaynağı GitHub sorunlarıdır "uyumsuz-değişiklik" ile işaretlendi etiket ekleyin.
Her uyumsuz değişiklik için sorun aşağıdakileri belirtir:
- Uyumsuz değişikliği kontrol eden bayrağın adı
- Değiştirilen işlevin açıklaması
- Taşıma tarifi
HEAD konumunda Bazel ile (dolayısıyla da bir sonraki Bazel sürümü) taşınmaya hazır olan uyumsuz bir değişiklik, migration-ready etiketiyle işaretlenmelidir. Uyumsuz değişiklik sorunu, HEAD bölümünde uyumsuz işaret çevrildiğinde kapatılır.