Cài đặt / cập nhật Bazel bằng Bazelisk

Cài đặt Bazel

Bazelisk là cách nên dùng để cài đặt Bazel trên Ubuntu, Windows và macOS. Công cụ này sẽ tự động tải xuống và cài đặt phiên bản Bazel phù hợp. Hãy sử dụng Bazelisk nếu bạn cần chuyển đổi giữa các phiên bản Bazel tuỳ thuộc vào thư mục làm việc hiện tại hoặc để luôn cập nhật Bazel lên bản phát hành mới nhất.

Để biết thêm thông tin chi tiết, hãy xem tệp README chính thức.

Cập nhật Bazel

Bazel có chính sách tương thích ngược (xem hướng dẫn triển khai các thay đổi không tương thích nếu bạn là tác giả của một thay đổi). Trang đó tóm tắt các phương pháp hay nhất về cách kiểm thử và di chuyển dự án của bạn bằng các thay đổi không tương thích sắp tới, cũng như cách cung cấp ý kiến phản hồi cho tác giả của các thay đổi không tương thích.

Quản lý các phiên bản Bazel bằng Bazelisk

Bazelisk giúp bạn quản lý các phiên bản Bazel.

Bazelisk có thể:

  • Tự động cập nhật Bazel lên bản phát hành LTS hoặc bản phát hành liên tục mới nhất.
  • Dựng dự án bằng phiên bản Bazel được chỉ định trong tệp .bazelversion. Kiểm tra tệp đó vào hệ thống quản lý phiên bản để đảm bảo khả năng tái tạo các bản dựng.
  • Giúp di chuyển dự án của bạn cho các thay đổi không tương thích (xem ở trên)
  • Dễ dàng dùng thử các ứng cử viên phát hành

Quy trình di chuyển nên dùng

Trong các bản cập nhật nhỏ cho bất kỳ bản phát hành LTS nào, mọi dự án đều có thể được chuẩn bị cho bản phát hành tiếp theo mà không làm mất khả năng tương thích với bản phát hành hiện tại. Tuy nhiên, có thể có những thay đổi không tương thích ngược giữa các phiên bản LTS chính.

Hãy làm theo quy trình này để di chuyển từ một phiên bản lớn sang phiên bản khác:

  1. Đọc ghi chú phát hành để được tư vấn về cách di chuyển sang phiên bản tiếp theo.
  2. Các thay đổi không tương thích chính phải có cờ --incompatible_* được liên kết và vấn đề tương ứng trên GitHub:
    • Hướng dẫn di chuyển có trong vấn đề liên kết trên GitHub.
    • Công cụ có sẵn cho một số hoạt động di chuyển thay đổi không tương thích. Ví dụ: buildifier.
    • Báo cáo vấn đề di chuyển bằng cách bình luận về vấn đề liên kết trên GitHub.

Sau khi di chuyển, bạn có thể tiếp tục dựng dự án mà không phải lo lắng về khả năng tương thích ngược cho đến bản phát hành chính tiếp theo.