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:
- Stack Overflow'daki soruları yanıtlama.
- Slack'te diğer kullanıcılara yardımcı olma.
- Belgeleri iyileştirme veya katkıda bulunan örnekler.
- Örneğin, bir blogda veya sosyal medyada deneyiminizi veya ipuçlarınızı paylaşmak.
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
vesrc/test/java
dillerindedir.- Çoğunlukla SkyFrame ve bazı yardımcı programlardan oluşan çekirdek koddur.
- Yerleşik kurallar
com.google.devtools.build.lib.rules
vecom.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.