Menginstal / Mengupdate Bazel menggunakan Bazelisk

Laporkan masalah Lihat sumber Nightly · 8.0 7.4 . 7.3 · 7.2 · 7.1 · 7.0 · 6.5

Menginstal Bazel

Bazelisk adalah cara yang direkomendasikan untuk menginstal Bazel di Ubuntu, Windows, dan macOS. Alat ini otomatis mendownload dan menginstal versi Bazel yang sesuai. Gunakan Bazelisk jika Anda perlu beralih antar-versi Bazel yang berbeda, bergantung pada direktori kerja saat ini, atau untuk selalu mengupdate Bazel ke rilis terbaru.

Untuk mengetahui detail selengkapnya, lihat README resmi.

Mengupdate Bazel

Bazel memiliki kebijakan kompatibilitas mundur (lihat panduan untuk meluncurkan perubahan yang tidak kompatibel jika Anda adalah penulisnya). Halaman tersebut merangkum praktik terbaik tentang cara menguji dan memigrasikan project Anda dengan perubahan yang tidak kompatibel yang akan datang dan cara memberikan masukan kepada penulis perubahan yang tidak kompatibel.

Mengelola versi Bazel dengan Bazelisk

Bazelisk membantu Anda mengelola versi Bazel.

Bazelisk dapat:

  • Mengupdate Bazel secara otomatis ke LTS atau rilis berkelanjutan terbaru.
  • Build project dengan versi Bazel yang ditentukan dalam file .bazelversion. Centang file tersebut ke dalam kontrol versi untuk memastikan reproduksi build Anda.
  • Membantu memigrasikan project Anda untuk perubahan yang tidak kompatibel (lihat di atas)
  • Mencoba kandidat rilis dengan mudah

Proses migrasi yang direkomendasikan

Dalam update minor pada rilis LTS, setiap project dapat disiapkan untuk rilis berikutnya tanpa merusak kompatibilitas dengan rilis saat ini. Namun, mungkin ada perubahan yang tidak kompatibel dengan versi LTS utama.

Ikuti proses ini untuk bermigrasi dari satu versi utama ke versi utama lainnya:

  1. Baca catatan rilis untuk mendapatkan saran tentang cara bermigrasi ke versi berikutnya.
  2. Perubahan besar yang tidak kompatibel harus memiliki tanda --incompatible_* terkait dan masalah GitHub yang sesuai:
    • Panduan migrasi tersedia di masalah GitHub terkait.
    • Alat tersedia untuk beberapa migrasi perubahan yang tidak kompatibel. Misalnya, buildifier.
    • Laporkan masalah migrasi dengan memberikan komentar pada masalah GitHub terkait.

Setelah migrasi, Anda dapat terus mem-build project tanpa perlu mengkhawatirkan kompatibilitas mundur hingga rilis utama berikutnya.