Menginstal / Mengupdate Bazel menggunakan Bazelisk

7/0.9/2.5. Lihat sumber Nightly {/3/}

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.

Memperbarui Bazel

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

Mengelola versi Bazel dengan Bazelisk

Bazelisk membantu Anda mengelola versi Bazel.

Bazelisk dapat:

  • Update otomatis Bazel ke LTS atau rilis berkelanjutan terbaru.
  • Build project dengan versi Bazel yang ditentukan dalam file .bazelversion. Periksa file tersebut ke kontrol versi untuk memastikan kemampuan 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 untuk rilis LTS apa pun, project apa pun dapat disiapkan untuk rilis berikutnya tanpa merusak kompatibilitas dengan rilis saat ini. Namun, mungkin ada perubahan yang tidak kompatibel dengan versi sebelumnya di antara 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 flag --incompatible_* terkait dan masalah GitHub yang sesuai:
    • Panduan migrasi tersedia dalam masalah GitHub terkait.
    • Alat tersedia untuk beberapa migrasi perubahan yang tidak kompatibel. Misalnya, buildifier.
    • Laporkan masalah migrasi dengan mengomentari masalah GitHub terkait.

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