Bazel'e Katkıda Bulunma

Sorun bildirin Kaynağı göster

Bazel projesine ve ekosistemine yardımcı olmanın birçok yolu var.

Geri bildirim gönderme

Bazel'ı kullanırken iyileştirilebilecek şeyler bulabilirsiniz. Aşağıdaki durumlarda sorunları bildirerek yardımcı olabilirsiniz:

  • Bazel kilitlenir veya yalnızca bazel clean kullanılarak çözülebilecek bir hatayla karşılaşırsınız.
  • Dokümanlar eksik veya net değil. Ayrıca, görüntülemekte olduğunuz sayfadaki sorunları, sayfanın sağ üst köşesindeki "Sorun oluştur" bağlantısını kullanarak bildirebilirsiniz.
  • Hata mesajlarıyla ilgili iyileştirmeler yapılabilir.

Topluluğa katılın

Bazel topluluğuyla aşağıdaki şekillerde etkileşim kurabilirsiniz:

Katkıda bulunun

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

Bazel ekosistemine şu yollarla katkıda bulunabilirsiniz:

  • Pull isteklerine katkıda bulunarak kuralların korunmasına 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
  • Diğer IDE'ler ve araçlarla Bazel entegrasyonunu iyileştirme.

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

En faydalı katkılar, hataları düzeltir veya özellikler ekler (biçimlendirme, yeniden düzenleme veya "temizlik" değişikliklerinin aksine). Değişikliğiniz, geriye dönük uyumluluğu, taşınabilirliği ve bellek kullanımı ile performans üzerindeki etkiyi göz önünde bulundurarak testler ve belgeler içermelidir.

Nasıl değişiklik göndereceğinizi öğrenmek için yama kabul etme işlemine bakın.

Bazel'ın kod açıklaması

Bazel'ın, birden fazla konumda kod içeren büyük bir kod tabanı var. Daha fazla bilgi için kod tabanı rehberini inceleyin.

Bazel'ın düzeni aşağıdaki gibidir:

  • İstemci kodu src/main/cpp dilindedir ve komut satırı arayüzünü sağlar.
  • Protokol arabellekleri src/main/protobuf dilindedir.
  • Sunucu kodu src/main/java ve src/test/java dilindedir.
    • Çoğunlukla SkyFrame ve bazı yardımcı programlardan oluşan temel kod.
    • 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ı hakkında bilgi edinebilirsiniz.
  • Java yerel arayüzleri src/main/native dilindedir.
  • Dil desteği için çeşitli araçlar, Bazel derlemesi bölümündeki listede açıklanmıştır.

Bazel'ın kaynak kodu aranıyor

Bazel'ın kaynak kodunda hızlıca arama yapmak için Bazel Code Search'ü kullanın. Bazel'ın depolarında, şubelerinde ve dosyalarında gezinebilirsiniz. Ayrıca geçmişi, farkları ve suçlu bilgilerini de görüntüleyebilirsiniz. Daha fazla bilgi edinmek için Bazel Code Search Kullanıcı Rehberi'ne göz atın.