Menginstal / Mengupdate Bazel menggunakan Bazelisk

Laporkan masalah Lihat sumber

Menginstal Bazel

Bazelisk adalah cara yang direkomendasikan untuk menginstal Bazel di Ubuntu, Windows, dan macOS. Fitur ini akan otomatis mendownload dan menginstal versi Bazel yang sesuai. Gunakan Bazelisk jika Anda perlu beralih antara 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 pembuatnya). Halaman tersebut merangkum praktik terbaik tentang cara menguji dan memigrasikan project Anda dengan perubahan mendatang yang tidak kompatibel dan cara memberikan masukan kepada 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.
  • Buat project dengan versi Bazel yang ditentukan dalam file .bazelversion. Periksa file tersebut di 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 kecil 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 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 di 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 mem-build project tanpa mengkhawatirkan kompatibilitas mundur hingga rilis utama berikutnya.