Bazel'a katkıda bulunma

Bazel projesine ve ekosistemine birçok şekilde yardımcı olabilirsiniz.

Geri bildirim gönderme

Bazel'ı kullanırken iyileştirebileceğiniz özellikler bulabilirsiniz. Aşağıdaki durumlarda sorunları bildirerek yardımcı olabilirsiniz:

  • Bazel kilitlenir veya yalnızca bazel clean kullanılarak çözülebilen bir hata ile karşılaşırsanız.
  • Dokümanlar eksik veya net değil. Görüntülediğiniz sayfadaki sorunları, sayfanın sağ üst köşesindeki "Sorun oluştur" bağlantısını kullanarak da bildirebilirsiniz.
  • Bir hata mesajı iyileştirilebilir.

Topluluğa katılın

Bazel topluluğuyla etkileşime geçmek için:

Koda katkıda bulun

Bazel büyük bir projedir ve Bazel kaynak kodunda değişiklik yapmak zor olabilir.

Bazel ekosistemine şu yollarla katkıda bulunabilirsiniz:

  • Pull istekleriyle katkıda bulunarak kural sahiplerine yardımcı olma.
  • Yeni kurallar oluşturma ve bunları açık kaynaklı hale getirme.
  • Taşıma araçları gibi Bazel ile ilgili araçlara katkıda bulunma.
  • Bazel entegrasyonunu diğer IDE'ler ve araçlarla iyileştirme.

Değişiklik yapmadan önce GitHub sorunu oluşturun veya bazel-dev@ adresine e-posta gönderin.

En faydalı katkılar hataları düzeltir veya özellik ekler (biçimsel, yeniden düzenleme veya "temizleme" değişikliklerinin aksine). Yaptığınız değişiklik; geriye dönük uyumluluğu, taşınabilirliği ve bellek kullanımı ile performans üzerindeki etkisini göz önünde bulundurarak testleri ve belgeleri içermelidir.

Değişikliğin nasıl gönderileceği hakkında bilgi edinmek için yama kabul sürecini inceleyin.

Bazel'ın kod açıklaması

Bazel, birden fazla konumda kod içeren geniş bir kod tabanına sahiptir. Daha fazla bilgi için kod tabanı kılavuzuna bakın.

Bazel aşağıdaki gibi düzenlenmiştir:

  • İstemci kodu src/main/cpp dilindedir ve komut satırı arayüzü sunar.
  • Protokol arabellekleri src/main/protobuf konumunda.
  • Sunucu kodu src/main/java ve src/test/java dillerindedir.
    • Çoğunlukla SkyFrame ve bazı yardımcı programlardan oluşan çekirdek koddur.
    • Yerleşik kurallar com.google.devtools.build.lib.rules ve com.google.devtools.build.lib.bazel.rules içindedir. Öncelikle Yazma Kurallarının Zorlukları bölümünü okuyabilirsiniz.
  • Java yerel arayüzleri src/main/native dilindedir.
  • Bazel derleme bölümündeki listede dil desteği için çeşitli araçlar açıklanmaktadır.

Bazel'ın kaynak kodunu arama

Bazel'ın kaynak kodunda hızlıca arama yapmak için Bazel Code Search'ü kullanın. Bazel'ın depolarında, dallarında ve dosyalarında gezinebilirsiniz. Ayrıca geçmişi, farkları ve suçlama bilgilerini de görüntüleyebilirsiniz. Daha fazla bilgi edinmek için Bazel Code Search Kullanıcı Kılavuzu'na bakın.