Berkontribusi pada Bazel

Nightly · 9.1 · 9.0 · 8.7 · 8.6 · 8.5 · 8.4 · 8.3 · 8.2 · 8.1

Ada banyak cara untuk membantu proyek dan ekosistem Bazel.

Berikan masukan

Saat menggunakan Bazel, Anda mungkin menemukan hal-hal yang dapat ditingkatkan. Anda dapat membantu dengan melaporkan masalah saat:

  • Bazel mengalami error atau Anda menemukan bug yang hanya dapat diselesaikan menggunakan bazel clean.
  • Dokumentasi tidak lengkap atau tidak jelas. Anda juga dapat melaporkan masalah dari halaman yang sedang dilihat menggunakan link "Buat masalah" di sudut kanan atas halaman.
  • Pesan error dapat ditingkatkan.

Berpartisipasi dalam komunitas

Anda dapat berinteraksi dengan komunitas Bazel dengan:

Berkontribusi kode

Bazel adalah proyek besar dan membuat perubahan pada kode sumber Bazel bisa jadi sulit.

Anda dapat berkontribusi pada ekosistem Bazel dengan:

  • Membantu pemelihara aturan dengan memberikan kontribusi permintaan pull.
  • Membuat aturan baru dan menjadikannya open source.
  • Berkontribusi pada alat terkait Bazel, misalnya, alat migrasi.
  • Meningkatkan integrasi Bazel dengan IDE dan alat lainnya.

Sebelum melakukan perubahan, buat masalah GitHub atau kirim email ke bazel-dev@.

Kontribusi yang paling membantu adalah memperbaiki bug atau menambahkan fitur (bukan perubahan gaya, refactoring, atau "pembersihan"). Perubahan Anda harus menyertakan pengujian dan dokumentasi, dengan mempertimbangkan kompatibilitas mundur, portabilitas, dan dampaknya terhadap penggunaan memori dan performa.

Untuk mempelajari cara mengirimkan perubahan, lihat proses penerimaan patch.

Deskripsi kode Bazel

Bazel memiliki codebase besar dengan kode di beberapa lokasi. Lihat panduan codebase untuk mengetahui detail selengkapnya.

Bazel diatur sebagai berikut:

  • Kode klien berada di src/main/cpp dan menyediakan antarmuka command line.
  • Buffer protokol berada di src/main/protobuf.
  • Kode server berada di src/main/java dan src/test/java.
    • Kode inti yang sebagian besar terdiri dari SkyFrame dan beberapa utilitas.
    • Aturan bawaan berada di com.google.devtools.build.lib.rules dan di com.google.devtools.build.lib.bazel.rules. Sebaiknya baca tentang Tantangan Menulis Aturan terlebih dahulu.
  • Antarmuka native Java berada di src/main/native.
  • Berbagai alat untuk dukungan bahasa dijelaskan dalam daftar di bagian mengompilasi Bazel.

Menelusuri kode sumber Bazel

Untuk menelusuri kode sumber Bazel dengan cepat, gunakan Bazel Code Search. Anda dapat menavigasi repositori, cabang, dan file Bazel. Anda juga dapat melihat histori, perbedaan, dan informasi blame. Untuk mempelajari lebih lanjut, lihat Panduan Pengguna Bazel Code Search.