Bazel projesine ve ekosistemine yardımcı olmanın birçok yolu vardır.
Geri bildirim sağlama
Bazel'i kullanırken iyileştirilebilecek noktalar görebilirsiniz. Sorunları bildirerek yardımcı olabilirsiniz ne zaman:
- Bazen kilitlenir veya yalnızca
bazel clean
kullanılarak çözülebilecek bir hatayla karşılaşırsınız. - Belgeler eksik veya net değil. Ayrıca, sorunları görüntülediğiniz sayfadan "Sorun oluştur"u kullanarak bağlantısını tıklayın.
- Hata mesajı iyileştirilebilir.
Topluluğa katılın
Bazel topluluğuyla şu şekilde etkileşim kurabilirsiniz:
- Stack Overflow'da soruları yanıtlama.
- Slack'te diğer kullanıcılara yardımcı olma.
- Belgeleri iyileştirme veya katkıda bulunan örnekler.
- Deneyiminizi veya ipuçlarınızı paylaşma (örneğin, bir blogda veya sosyal medyada).
Kodla katkıda bulunun
Bazel büyük bir projedir ve Bazel kaynak kodunda değişiklik yapmaktadır zor olabilir.
Bazel ekosistemine katkıda bulunmak için:
- Pull isteği göndererek kural koruyucularına yardımcı olma
- Yeni kurallar oluşturma ve bu kuralları açık kaynaklı hale getirme.
- Bazel ile ilgili araçlara (ör. taşıma araçları) katkıda bulunma
- Diğer IDE'ler ve araçlarla Bazel entegrasyonunu iyileştiriyoruz.
Değişiklik yapmadan önce bir GitHub oluşturun sorun veya bazel-discuss@ adresine e-posta gönderebilirsiniz.
En faydalı katkılar, hataları düzeltir veya özellik ekler (stil, yeniden düzenleme veya "temizlik" değişikliklerinin aksine). Yaptığınız değişiklik geriye dönük uyumluluğu da göz önünde bulundurarak testler ve belgeler dahil etme bellek kullanımı ile performans üzerindeki etkisi hakkında daha fazla bilgi edineceksiniz.
Değişiklikleri nasıl göndereceğinizi öğrenmek için yama kabul süreci hakkında daha fazla bilgi edinin.
Bazel'in kod açıklaması
Bazel, birden fazla konumda kod içeren büyük bir kod tabanına sahiptir. Daha fazla bilgi için kod tabanı kılavuzuna göz atın.
Bazel aşağıdaki şekilde düzenlenmiştir:
- İstemci kodu
src/main/cpp
içindedir ve komut satırı arayüzünü sağlar. - Protokol arabellekleri
src/main/protobuf
konumundadır. - Sunucu kodu
src/main/java
vesrc/test/java
dillerinde.- Çoğunlukla SkyFrame ve bazı yardımcı programlardan oluşan temel kod.
- Yerleşik kurallar
com.google.devtools.build.lib.rules
vecom.google.devtools.build.lib.bazel.rules
'tedir. Öncelikle Kural Yazmanın Zorlukları başlıklı makaleyi okumanızı öneririz.
- Java yerel arayüzleri
src/main/native
içindedir. - Dil desteğine yönelik çeşitli araçlar aşağıdaki listede açıklanmıştır: compering Bazel (Bazel'i derleme) bölümünü inceleyebilirsiniz.
Bazel'ın kaynak kodu aranıyor
Bazel'in kaynak kodunda hızlı bir şekilde arama yapmak için Bazel Code Search. Bazel'in depolarına, dallarına ve dosyalarına gidebilirsiniz. Geçmişi, farkları ve suçu atamaya ilişkin bilgileri de görüntüleyebilirsiniz. Daha fazla bilgi edinmek için Bazel Code Search Kullanım Kılavuzu.