Trang này cung cấp thông tin về cách xử lý khả năng tương thích ngược, bao gồm cả cách di chuyển từ bản phát hành này sang bản phát hành khác và cách truyền đạt các thay đổi không tương thích.
Bazel đang phát triển. Các phiên bản nhỏ được phát hành trong một Phiên bản lớn LTS hoàn toàn tương thích ngược. Những thay đổi giữa các bản phát hành LTS chính có thể chứa những thay đổi không tương thích và đòi hỏi một số nỗ lực di chuyển. Để biết thêm thông tin về quy trình phát hành Bazel hoạt động, xem Công bố bản phát hành Hỗ trợ dài hạn (LTS) của Bazel.
Tóm tắt
- Bạn nên sử dụng cờ
--incompatible_*
cho các thay đổi có thể gây lỗi. - Đối với mỗi cờ
--incompatible_*
, một vấn đề trên GitHub sẽ giải thích sự thay đổi về hành vi và nhằm mục đích cung cấp công thức di chuyển. - Các API và hành vi được bảo vệ bằng cờ
--experimental_*
có thể thay đổi bất cứ lúc nào. - Không bao giờ chạy các bản dựng chính thức có cờ
--experimental_*
hoặc--incompatible_*
.
Cách tuân thủ chính sách này
- Dành cho người dùng Bazel – cách cập nhật Bazel
- Dành cho cộng tác viên – các phương pháp hay nhất cho những thay đổi không tương thích
- Dành cho người quản lý bản phát hành – cách cập nhật nhãn vấn đề và bản phát hành
Chức năng ổn định là gì?
Nhìn chung, các API hoặc hành vi không có cờ --experimental_...
được xem là
các tính năng ổn định và được hỗ trợ trong Bazel.
Nội dung như vậy bao gồm:
- Ngôn ngữ và API của Starlark
- Quy tắc đi kèm với Bazel
- Các API Bazel, chẳng hạn như API Thực thi từ xa hoặc Giao thức sự kiện Xây dựng
- Cờ và ngữ nghĩa của cờ
Công thức di chuyển và thay đổi không tương thích
Đối với mọi thay đổi không tương thích trong bản phát hành mới, nhóm Bazel cố gắng cung cấp
công thức di chuyển giúp bạn cập nhật mã của mình
(Tệp BUILD
và .bzl
, cũng như mọi hoạt động sử dụng Bazel trong tập lệnh,
sử dụng Bazel API, v.v.).
Các thay đổi không tương thích phải có cờ --incompatible_*
đi kèm và
vấn đề tương ứng trên GitHub.
Thông báo về các thay đổi không tương thích
Nguồn thông tin chính về những thay đổi không tương thích là các vấn đề trên GitHub được đánh dấu bằng "thay đổi không tương thích" nhãn.
Đối với mỗi thay đổi không tương thích, vấn đề nêu rõ những nội dung sau:
- Tên của cờ kiểm soát thay đổi không tương thích
- Nội dung mô tả về chức năng đã thay đổi
- Công thức di chuyển
Khi một thay đổi không tương thích đã sẵn sàng để di chuyển bằng Bazel ở HEAD (do đó, cũng với bản phát hành luân phiên tiếp theo của Bazel), bạn nên đánh dấu thay đổi đó bằng nhãn migration-ready
. Vấn đề thay đổi không tương thích sẽ được đóng khi cờ không tương thích được lật ở HEAD.