Chương trình đăng ký tham gia sự kiện BazelCon 2024 đã bắt đầu!

Trang này được dịch bởi Cloud Translation API.

Xây dựng chương trình bằng Bazel

Báo cáo vấn đề Xem nguồn Hằng đêm · 7,4 của Google. 7.3 · 7,2 · 7.1 · 7 · 6,5

Trang này trình bày cách tạo chương trình bằng Bazel, cú pháp lệnh tạo và mẫu đích.

Bắt đầu nhanh

Để chạy Bazel, hãy chuyển đến thư mục workspace (không gian làm việc) cơ sở hoặc bất kỳ thư mục con nào của thư mục đó rồi nhập bazel. Xem bản dựng nếu bạn cần tạo một không gian làm việc mới.

bazel help
                             [Bazel release bazel version]
Usage: bazel command options ...

Các câu lệnh có thể dùng

analyze-profile: Phân tích dữ liệu hồ sơ bản dựng.
aquery: Thực thi truy vấn trên biểu đồ hành động sau khi phân tích.
build: Tạo các mục tiêu đã chỉ định.
canonicalize-flags: Chuẩn hoá cờ Bazel.
clean: Xoá các tệp đầu ra và tuỳ ý dừng máy chủ.
cquery: Thực thi truy vấn biểu đồ phần phụ thuộc sau khi phân tích.
dump: Kết xuất trạng thái nội bộ của quy trình máy chủ Bazel.
help: In thông tin trợ giúp cho các lệnh hoặc chỉ mục.
info: Hiển thị thông tin về thời gian chạy của máy chủ bazel.
fetch: Tìm nạp tất cả phần phụ thuộc bên ngoài của một mục tiêu.
mobile-install: Cài đặt ứng dụng trên thiết bị di động.
query: Thực thi truy vấn biểu đồ phần phụ thuộc.
run: Chạy mục tiêu đã chỉ định.
shutdown: Dừng máy chủ Bazel.
test: Tạo và chạy các mục tiêu kiểm thử được chỉ định.
version: In thông tin phiên bản cho Bazel.

Nhận trợ giúp

bazel help command: Trợ giúp và tuỳ chọn cho ảnh in command.
bazel helpstartup_options: Các lựa chọn cho máy ảo JVM lưu trữ Bazel.
bazel helptarget-syntax: Giải thích cú pháp để chỉ định mục tiêu.
bazel help info-keys: Hiển thị danh sách các khoá mà lệnh info sử dụng.

Công cụ bazel thực hiện nhiều chức năng, được gọi là lệnh. Các loại phổ biến nhất là bazel build và bazel test. Bạn có thể duyệt qua các thông báo trợ giúp trực tuyến bằng bazel help.

Xây dựng một mục tiêu

Trước khi có thể bắt đầu tạo bản dựng, bạn cần có một không gian làm việc. Không gian làm việc là một cây thư mục chứa tất cả các tệp nguồn cần thiết để tạo . Bazel cho phép bạn tạo bản dựng từ một phương tiện chỉ có thể đọc.

Để tạo một chương trình bằng Bazel, hãy nhập bazel build, theo sau là mục tiêu mà bạn muốn tạo.

bazel build //foo

Sau khi đưa ra lệnh tạo //foo, bạn sẽ thấy kết quả tương tự như sau:

INFO: Analyzed target //foo:foo (14 packages loaded, 48 targets configured).
INFO: Found 1 target...
Target //foo:foo up-to-date:
  bazel-bin/foo/foo
INFO: Elapsed time: 9.905s, Critical Path: 3.25s
INFO: Build completed successfully, 6 total actions

Trước tiên, Bazel tải tất cả các gói trong biểu đồ phần phụ thuộc của mục tiêu. Điều này bao gồm các phần phụ thuộc đã khai báo, các tệp được liệt kê trực tiếp trong tệp BUILD của mục tiêu và các phần phụ thuộc bắc cầu, các tệp được liệt kê trong tệp BUILD của các phần phụ thuộc của mục tiêu. Sau khi xác định tất cả các phần phụ thuộc, Bazel phân tích chúng để đảm bảo tính chính xác và tạo hành động xây dựng. Cuối cùng, Bazel thực thi các trình biên dịch và các công cụ khác của bản dựng.

Trong giai đoạn thực thi của bản dựng, Bazel sẽ in thông báo tiến trình. Tiến trình thông báo bao gồm bước xây dựng hiện tại (chẳng hạn như trình biên dịch hoặc trình liên kết) vì nó và số lượt hoàn thành trên tổng số thao tác đối với bản dựng. Khi quá trình tạo bản dựng bắt đầu, số lượng hành động thường tăng lên khi Bazel khám phá toàn bộ biểu đồ hành động, nhưng con số này sẽ ổn định trong vòng vài giây.

Vào cuối quá trình tạo bản dựng, Bazel in các mục tiêu được yêu cầu, cho dù không phải chúng đã được tạo thành công và nếu có, nơi các tệp đầu ra có thể đã tìm thấy. Các tập lệnh chạy bản dựng có thể phân tích cú pháp đáng tin cậy kết quả này; hãy xem --show_result để biết thêm chi tiết.

Nếu bạn nhập lại cùng một lệnh, quá trình tạo bản dựng sẽ hoàn tất nhanh hơn nhiều.

bazel build //foo
INFO: Analyzed target //foo:foo (0 packages loaded, 0 targets configured).
INFO: Found 1 target...
Target //foo:foo up-to-date:
  bazel-bin/foo/foo
INFO: Elapsed time: 0.144s, Critical Path: 0.00s
INFO: Build completed successfully, 1 total action

Đây là bản dựng rỗng. Vì không có gì thay đổi nên không có gói nào để tải lại và không có bước xây dựng nào để thực thi. Nếu có gì thay đổi trong "foo" hoặc các phần phụ thuộc của lớp này, Bazel sẽ thực thi lại một số thao tác bản dựng hoặc hoàn tất một bản dựng gia tăng.

Xây dựng nhiều mục tiêu

Bazel cho phép một số cách để chỉ định các mục tiêu cần tạo. Nói chung, chúng được gọi là mẫu mục tiêu. Cú pháp này được dùng trong các lệnh như build, test hoặc query.

Trong khi đó, nhãn được dùng để chỉ định từng mục tiêu, chẳng hạn như để khai báo các phần phụ thuộc trong tệp BUILD, mục tiêu của Bazel chỉ định nhiều mục tiêu. Mẫu mục tiêu là một khái quát của cú pháp nhãn cho nhóm mục tiêu, sử dụng ký tự đại diện. Trong trường hợp đơn giản nhất, mọi nhãn hợp lệ cũng là một mẫu mục tiêu hợp lệ, xác định một tập hợp gồm đúng một mục tiêu.

Tất cả mẫu mục tiêu bắt đầu bằng // đều được phân giải tương ứng với mẫu hiện tại Workspace.

`//foo/bar:wiz`	Chỉ `//foo/bar:wiz` mục tiêu duy nhất.
`//foo/bar`	Tương đương với `//foo/bar:bar`.
`//foo/bar:all`	Tất cả mục tiêu quy tắc trong gói `foo/bar`.
`//foo/...`	Tất cả mục tiêu quy tắc trong mọi gói trong thư mục `foo`.
`//foo/...:all`	Tất cả mục tiêu quy tắc trong tất cả gói bên dưới thư mục `foo`.
`//foo/...:*`	Tất cả mục tiêu (quy tắc và tệp) trong tất cả các gói bên dưới thư mục `foo`.
`//foo/...:all-targets`	Tất cả mục tiêu (quy tắc và tệp) trong tất cả các gói bên dưới thư mục `foo`.
`//...`	Tất cả mục tiêu trong các gói trong không gian làm việc. Điều này không bao gồm mục tiêu từ kho lưu trữ bên ngoài.
`//:all`	Tất cả các mục tiêu trong gói cấp cao nhất, nếu có tệp "BUILD" trong gốc của không gian làm việc.

Các mẫu mục tiêu không bắt đầu bằng // sẽ được phân giải tương ứng với thư mục làm việc hiện tại. Những ví dụ sau giả định một thư mục đang hoạt động là foo:

`:foo`	Tương đương với `//foo:foo`.
`bar:wiz`	Tương đương với `//foo/bar:wiz`.
`bar/wiz`	Tương đương với: `//foo/bar/wiz:wiz` nếu `foo/bar/wiz` là một gói `//foo/bar:wiz` nếu `foo/bar` là một gói Nếu không thì là `//foo:bar/wiz`
`bar:all`	Tương đương với `//foo/bar:all`.
`:all`	Tương đương với `//foo:all`.
`...:all`	Tương đương với `//foo/...:all`.
`...`	Tương đương với `//foo/...:all`.
`bar/...:all`	Tương đương với `//foo/bar/...:all`.

Theo mặc định, các đường liên kết tượng trưng của thư mục sẽ được tuân theo các mẫu mục tiêu đệ quy, ngoại trừ các đường liên kết tượng trưng trỏ đến trong cơ sở đầu ra, chẳng hạn như các đường liên kết tượng trưng thuận tiện được tạo trong thư mục gốc của không gian làm việc.

Ngoài ra, Bazel không tuân theo đường liên kết tượng trưng khi đánh giá các mẫu mục tiêu đệ quy trong bất kỳ thư mục nào chứa tệp có tên như sau: DONT_FOLLOW_SYMLINKS_WHEN_TRAVERSING_THIS_DIRECTORY_VIA_A_RECURSIVE_TARGET_PATTERN

foo/... là ký tự đại diện cho gói, cho biết tất cả các gói theo cách đệ quy bên dưới thư mục foo (đối với tất cả thư mục gốc của đường dẫn gói). :all là một ký tự đại diện trên mục tiêu, khớp với tất cả quy tắc trong một gói. Bạn có thể kết hợp hai ký tự này, như trong foo/...:all, và khi sử dụng cả hai ký tự đại diện, bạn có thể viết tắt là foo/....

Ngoài ra, :* (hoặc :all-targets) là ký tự đại diện khớp với mọi mục tiêu trong các gói được so khớp, bao gồm cả các tệp thường không được tạo theo quy tắc nào, chẳng hạn như các tệp _deploy.jar liên kết với các quy tắc java_binary.

Điều này ngụ ý rằng :* biểu thị một tập hợp con của :all; mặc dù có thể gây nhầm lẫn, nhưng cú pháp này cho phép sử dụng ký tự đại diện :all quen thuộc cho các bản dựng thông thường, trong đó không mong muốn các mục tiêu bản dựng như _deploy.jar.

Ngoài ra, Bazel cho phép sử dụng dấu gạch chéo thay vì dấu hai chấm theo yêu cầu của cú pháp nhãn; điều này thường thuận tiện khi sử dụng tính năng mở rộng tên tệp Bash. Ví dụ: foo/bar/wiz tương đương với //foo/bar:wiz (nếu có gói foo/bar) hoặc với //foo:bar/wiz (nếu có gói foo).

Nhiều lệnh Bazel chấp nhận danh sách các mẫu mục tiêu làm đối số và tất cả các lệnh này đều tuân theo toán tử phủ định tiền tố -. Bạn có thể dùng hàm này để trừ một tập hợp mục tiêu khỏi tập hợp do các đối số trước chỉ định. Xin lưu ý rằng điều này có nghĩa là đơn đặt hàng rất quan trọng. Ví dụ:

bazel build foo/... bar/...

nghĩa là "xây dựng tất cả các mục tiêu có giá trị thấp hơn foo và tất cả các mục tiêu có giá trị dưới bar", trong khi

bazel build -- foo/... -foo/bar/...

có nghĩa là "tạo tất cả mục tiêu bên dưới foo ngoại trừ các mục tiêu bên dưới foo/bar". (Bạn bắt buộc phải sử dụng đối số -- để ngăn các đối số tiếp theo bắt đầu bằng - được diễn giải là các tuỳ chọn bổ sung.)

Điều quan trọng cần chỉ ra là việc trừ các mục tiêu theo cách này sẽ không đảm bảo rằng các mã đó sẽ không được tạo, vì chúng có thể là phần phụ thuộc của mục tiêu chưa bị trừ. Ví dụ: nếu có //foo:all-apis mục tiêu cái này trong số các thành phần khác phụ thuộc vào //foo/bar:api, thì cái sau sẽ được xây dựng dưới dạng một phần của quá trình xây dựng mô hình trước đó.

Các mục tiêu có tags = ["manual"] không được đưa vào mẫu mục tiêu ký tự đại diện (..., :*, :all, v.v.) khi được chỉ định trong các lệnh như bazel build và bazel test (nhưng các mục tiêu này được đưa vào mẫu mục tiêu ký tự đại diện âm, tức là các mục tiêu này sẽ được trừ đi). Bạn nên chỉ định các mục tiêu kiểm thử như vậy bằng các mẫu mục tiêu rõ ràng trên dòng lệnh nếu bạn muốn Bazel tạo/kiểm thử các mục tiêu đó. Ngược lại, bazel query không tự động thực hiện bất kỳ hoạt động lọc nào như vậy (điều này sẽ làm mất mục đích của bazel query).

Tìm nạp phần phụ thuộc bên ngoài

Theo mặc định, Bazel sẽ tải xuống và liên kết tượng trưng các phần phụ thuộc bên ngoài trong quá trình tạo bản dựng. Tuy nhiên, điều này có thể không mong muốn, vì bạn muốn biết thời điểm thêm các phần phụ thuộc bên ngoài mới hoặc vì bạn muốn "tải trước" các phần phụ thuộc (ví dụ: trước chuyến bay mà bạn sẽ không có mạng). Nếu bạn muốn ngăn chặn việc thêm các phần phụ thuộc mới trong quá trình xây dựng, bạn có thể chỉ định cờ --fetch=false. Xin lưu ý rằng cờ này chỉ áp dụng cho các quy tắc kho lưu trữ không trỏ đến một thư mục trong hệ thống tệp cục bộ. Các thay đổi, ví dụ như thành local_repository, new_local_repository và các quy tắc về kho lưu trữ NDK và SDK Android sẽ luôn có hiệu lực bất kể giá trị --fetch là gì .

Nếu bạn không cho phép tìm nạp trong quá trình tạo bản dựng và Bazel tìm thấy các phần phụ thuộc bên ngoài mới, thì bản dựng của bạn sẽ không thành công.

Bạn có thể tìm nạp các phần phụ thuộc theo cách thủ công bằng cách chạy bazel fetch. Nếu bạn không cho phép trong quá trình tìm nạp bản dựng, bạn cần chạy bazel fetch:

Trước khi bạn tạo bản dựng lần đầu tiên.
Sau khi bạn thêm một phần phụ thuộc bên ngoài mới.

Sau khi chạy chương trình khuyến mãi, bạn không cần chạy lại cho đến khi WORKSPACE tệp thay đổi.

fetch lấy danh sách mục tiêu để tìm nạp các phần phụ thuộc. Ví dụ: lệnh này sẽ tìm nạp các phần phụ thuộc cần thiết để tạo //foo:bar và //bar:baz:

bazel fetch //foo:bar //bar:baz

Để tìm nạp tất cả phần phụ thuộc bên ngoài cho một không gian làm việc, hãy chạy:

bazel fetch //...

Bạn không cần chạy tìm nạp bazel nếu có tất cả các công cụ hiện có bằng cách sử dụng (từ các lọ thư viện đến chính JDK) trong thư mục gốc của không gian làm việc. Tuy nhiên, nếu bạn đang sử dụng bất kỳ mục nào bên ngoài thư mục không gian làm việc thì Bazel sẽ tự động chạy bazel fetch trước khi chạy bazel build.

Bộ nhớ đệm của kho lưu trữ

Bazel cố gắng tránh tìm nạp cùng một tệp nhiều lần, ngay cả khi cùng một tệp cần tệp trong các không gian làm việc khác nhau hoặc nếu định nghĩa về một kho lưu trữ đã thay đổi nhưng vẫn cần tải xuống cùng một tệp. Để làm như vậy, bazel lưu tất cả các tệp đã tải xuống vào bộ nhớ đệm của kho lưu trữ vào bộ nhớ đệm. Theo mặc định, đặt tại ~/.cache/bazel/_bazel_$USER/cache/repos/v1/. Chiến lược phát hành đĩa đơn vị trí có thể được thay đổi bằng tuỳ chọn --repository_cache. Chiến lược phát hành đĩa đơn bộ nhớ đệm được chia sẻ giữa mọi không gian làm việc và các phiên bản bazel đã cài đặt. Một mục nhập được lấy từ bộ nhớ đệm nếu Bazel biết chắc chắn rằng mình có bản sao của đúng tệp, tức là nếu yêu cầu tải xuống có tổng SHA256 của tệp được chỉ định và một tệp có tổng đó hàm băm trong bộ nhớ đệm. Vì vậy, việc chỉ định hàm băm cho từng tệp bên ngoài là không chỉ là một ý tưởng hay về khía cạnh bảo mật; điều này cũng giúp tránh tải xuống không cần thiết.

Mỗi khi có một lượt truy cập vào bộ nhớ đệm, thời gian sửa đổi của tệp trong bộ nhớ đệm sẽ được cập nhật. Bằng cách này, bạn có thể dễ dàng xác định lần sử dụng gần đây nhất của một tệp trong thư mục bộ nhớ đệm, chẳng hạn như để dọn dẹp bộ nhớ đệm theo cách thủ công. Bộ nhớ đệm không bao giờ được tự động dọn dẹp, vì tệp này có thể chứa bản sao của một tệp không có sẵn lâu hơn ở thượng nguồn.

Thư mục tệp phân phối

Thư mục phân phối là một cơ chế Bazel khác để tránh việc không cần thiết nội dung tải xuống. Bazel tìm kiếm các thư mục phân phối trước bộ nhớ đệm của kho lưu trữ. Điểm khác biệt chính là thư mục phân phối yêu cầu bạn phải chuẩn bị theo cách thủ công.

Sử dụng --distdir=/path/to-directory , bạn có thể chỉ định thêm các thư mục chỉ đọc để tìm kiếm tệp thay vì tìm nạp chúng. Một tệp sẽ được lấy từ thư mục như vậy nếu tên tệp bằng với tên cơ sở của URL và thêm vào đó, hàm băm của tệp bằng với hàm băm được chỉ định trong yêu cầu tải xuống. Điều này chỉ hoạt động nếu hàm băm tệp được chỉ định trong phần khai báo WORKSPACE.

Mặc dù điều kiện về tên tệp không cần thiết để đảm bảo tính chính xác, nhưng điều kiện này sẽ giảm số lượng tệp đề xuất xuống còn một tệp cho mỗi thư mục được chỉ định. Trong phần này việc chỉ định thư mục tệp phân phối vẫn mang lại hiệu quả, ngay cả khi số lượng tệp trong thư mục như vậy sẽ tăng lên.

Chạy Bazel trong môi trường tách biệt

Để giữ cho kích thước tệp nhị phân của Bazel nhỏ, các phần phụ thuộc ngầm ẩn của Bazel được tìm nạp qua mạng trong lần chạy đầu tiên. Các phần phụ thuộc ngầm ẩn này chứa các chuỗi công cụ và quy tắc có thể không cần thiết cho mọi người. Cho ví dụ: các công cụ Android được tách nhóm và chỉ tìm nạp khi tạo bản dựng Android dự án.

Tuy nhiên, những phần phụ thuộc ngầm ẩn này có thể gây ra sự cố khi chạy trong một môi trường thoáng đãng, ngay cả khi bạn đã bán tất cả Các phần phụ thuộc WORKSPACE. Để giải quyết vấn đề đó, bạn có thể chuẩn bị một thư mục phân phối chứa các phần phụ thuộc này trên một máy có quyền truy cập mạng, sau đó chuyển các phần phụ thuộc đó sang môi trường tách biệt bằng phương pháp ngoại tuyến.

Để chuẩn bị thư mục phân phối, hãy sử dụng --distdir cờ. Bạn sẽ phải thực hiện việc này một lần cho mỗi phiên bản nhị phân mới của Bazel, vì các phần phụ thuộc ngầm ẩn có thể khác nhau đối với mỗi bản phát hành.

Để tạo các phần phụ thuộc này bên ngoài môi trường tách biệt, trước tiên, hãy kiểm tra cây nguồn Bazel ở phiên bản phù hợp:

git clone https://github.com/bazelbuild/bazel "$BAZEL_DIR"
cd "$BAZEL_DIR"
git checkout "$BAZEL_VERSION"

Sau đó, hãy tạo tệp tar chứa các phần phụ thuộc thời gian chạy ngầm ẩn cho phiên bản Bazel cụ thể đó:

bazel build @additional_distfiles//:archives.tar

Xuất tệp tar này vào một thư mục có thể sao chép vào môi trường tách biệt. Lưu ý cờ --strip-components, vì --distdir có thể khá khó chịu với cấp độ lồng thư mục:

tar xvf bazel-bin/external/additional_distfiles/archives.tar \
  -C "$NEW_DIRECTORY" --strip-components=3

Cuối cùng, khi bạn sử dụng Bazel trong môi trường không gian thoáng mát, hãy truyền --distdir cờ trỏ tới thư mục. Để thuận tiện, bạn có thể thêm tệp này dưới dạng .bazelrc mục nhập:

build --distdir=path/to/directory

Cấu hình bản dựng và biên dịch chéo

Tất cả dữ liệu đầu vào chỉ định hành vi và kết quả của một bản dựng nhất định có thể được chia thành hai danh mục riêng biệt. Loại đầu tiên là nội tại thông tin được lưu trữ trong các tệp BUILD của dự án: quy tắc bản dựng, giá trị của các thuộc tính và tập hợp hoàn chỉnh các phần phụ thuộc bắc cầu của nó. Loại thứ hai là dữ liệu bên ngoài hoặc môi trường, do người dùng hoặc công cụ xây dựng cung cấp: lựa chọn cấu trúc mục tiêu, tuỳ chọn biên dịch và liên kết, cũng như các tuỳ chọn cấu hình chuỗi công cụ khác. Chúng tôi đề cập đến một tập hợp đầy đủ của dữ liệu môi trường dưới dạng một cấu hình.

Trong bất kỳ bản dựng nhất định nào, có thể có nhiều cấu hình. Hãy cân nhắc việc biên dịch chéo, trong đó bạn tạo một tệp thực thi //foo:bin cho kiến trúc 64 bit, nhưng máy trạm của bạn là máy 32 bit. Rõ ràng, bản dựng sẽ yêu cầu tạo //foo:bin bằng một chuỗi công cụ có khả năng tạo 64 bit tệp thực thi, nhưng hệ thống xây dựng cũng phải xây dựng nhiều công cụ khác nhau được dùng trong quá trình ví dụ: các công cụ được tạo từ nguồn, sau đó tạo được sử dụng trong máy trạm – và các quy tắc này phải được xây dựng để chạy trên máy trạm của bạn. Do đó, chúng ta có thể xác định hai cấu hình: cấu hình thực thi dùng để tạo các công cụ chạy trong quá trình xây dựng và cấu hình mục tiêu (hoặc cấu hình yêu cầu, nhưng chúng ta thường nói "cấu hình mục tiêu" mặc dù từ đó đã có nhiều nghĩa), dùng để tạo tệp nhị phân mà bạn đã yêu cầu.

Thông thường, có nhiều thư viện là điều kiện tiên quyết của cả mục tiêu bản dựng được yêu cầu (//foo:bin) và một hoặc nhiều công cụ thực thi, ví dụ: một số thư viện cơ sở. Bạn phải tạo các thư viện đó hai lần, một lần cho cấu hình thực thi và một lần cho cấu hình mục tiêu. Bazel chăm sóc đảm bảo rằng cả hai biến thể đều được tạo và các tệp phát sinh được giữ lại tách biệt để tránh can nhiễu; thường thì các mục tiêu như vậy có thể được xây dựng đồng thời, vì chúng độc lập với nhau. Nếu bạn thấy thông báo tiến độ cho thấy một mục tiêu cụ thể đang được xây dựng hai lần, thì rất có thể đây là nội dung giải thích.

Cấu hình exec được lấy từ cấu hình mục tiêu như sau:

Sử dụng cùng một phiên bản Crosstool (--crosstool_top) như đã chỉ định trong cấu hình yêu cầu, trừ phi bạn chỉ định --host_crosstool_top.
Sử dụng giá trị --host_cpu cho --cpu (mặc định: k8).
Sử dụng cùng một giá trị của các tuỳ chọn này như được chỉ định trong cấu hình yêu cầu: --compiler, --use_ijars và nếu sử dụng --host_crosstool_top, thì giá trị của --host_cpu sẽ được dùng để tra cứu default_toolchain trong Crosstool (bỏ qua --compiler) cho cấu hình thực thi.
Sử dụng giá trị của --host_javabase cho --javabase
Sử dụng giá trị của --host_java_toolchain cho --java_toolchain
Sử dụng các bản dựng được tối ưu hoá cho mã C++ (-c opt).
Không tạo thông tin gỡ lỗi (--copt=-g0).
Xoá thông tin gỡ lỗi khỏi tệp thực thi và thư viện dùng chung (--strip=always).
Đặt tất cả tệp phái sinh ở một vị trí đặc biệt, khác với vị trí mà mọi cấu hình yêu cầu có thể sử dụng.
Ngăn chặn việc đóng dấu tệp nhị phân bằng dữ liệu bản dựng (xem các tuỳ chọn --embed_*).
Tất cả các giá trị khác vẫn giữ nguyên giá trị mặc định.

Có nhiều lý do khiến bạn nên chọn một cấu hình thực thi khác với cấu hình yêu cầu. Quan trọng nhất:

Trước tiên, bằng cách sử dụng các tệp nhị phân đã loại bỏ và tối ưu hoá, bạn sẽ giảm thời gian liên kết và thực thi các công cụ, dung lượng ổ đĩa mà các công cụ chiếm dụng và thời gian I/O mạng trong các bản dựng được phân phối.

Thứ hai, bằng cách tách riêng cấu hình thực thi và cấu hình yêu cầu trong tất cả các bản dựng, bạn tránh việc xây dựng lại rất tốn kém dẫn đến từ những thay đổi nhỏ đối với cấu hình yêu cầu (chẳng hạn như thay đổi tuỳ chọn trình liên kết), như mô tả trước đó.

Chỉnh sửa bản dựng lại tăng dần

Một trong những mục tiêu chính của dự án Bazel là đảm bảo chính xác mức độ gia tăng tạo lại bản dựng. Các công cụ xây dựng trước đây, đặc biệt là những công cụ dựa trên Make, hãy thực hiện những giả định sai lầm trong việc triển khai các bản dựng tăng dần.

Thứ nhất, dấu thời gian của các tệp tăng lên đơn điệu. Mặc dù đây là trường hợp điển hình, nhưng bạn rất dễ mắc phải giả định này; việc đồng bộ hoá với bản sửa đổi trước đó của một tệp sẽ làm giảm thời gian sửa đổi của tệp đó; các hệ thống dựa trên Make sẽ không tạo lại.

Nói chung, tính năng Make phát hiện các thay đổi đối với tệp sẽ không phát hiện thấy các thay đổi vào các lệnh. Nếu bạn thay đổi các tuỳ chọn được truyền đến trình biên dịch trong một bước bản dựng nhất định, thì Make sẽ không chạy lại trình biên dịch và bạn cần phải loại bỏ kết quả không hợp lệ của bản dựng trước đó theo cách thủ công bằng make clean.

Ngoài ra, Make không đủ mạnh để chống lại việc chấm dứt không thành công của một trong các quy trình con sau khi quy trình con đó bắt đầu ghi vào tệp đầu ra. Mặc dù quá trình thực thi hiện tại của Make sẽ không thành công, nhưng lệnh gọi tiếp theo của Make sẽ giả định một cách mù quáng rằng tệp đầu ra bị cắt ngắn là hợp lệ (vì tệp này mới hơn các dữ liệu đầu vào) và tệp này sẽ không được tạo lại. Tương tự, nếu quá trình Tạo bị huỷ, thì một tình huống tương tự có thể xảy ra.

Bazel tránh những giả định này và các giả định khác. Bazel duy trì một cơ sở dữ liệu về tất cả công việc đã thực hiện trước đó và sẽ chỉ bỏ qua một bước tạo bản dựng nếu tập hợp của tệp đầu vào (và dấu thời gian của chúng) đến bước tạo bản dựng đó và quá trình biên dịch cho bước tạo bản dựng đó, khớp chính xác với một lệnh trong cơ sở dữ liệu và rằng tập hợp các tệp đầu ra (và dấu thời gian của chúng) cho mục nhập cơ sở dữ liệu khớp chính xác dấu thời gian của các tệp trên đĩa. Mọi thay đổi đối với tệp đầu vào hoặc tệp đầu ra hoặc đối với chính lệnh sẽ khiến bước tạo bản dựng được thực thi lại.

Lợi ích đối với người dùng của các bản dựng tăng dần là: ít lãng phí thời gian hơn do nhầm lẫn. (Ngoài ra, bạn sẽ mất ít thời gian hơn để chờ tạo lại do sử dụng make clean, cho dù cần thiết hay phòng ngừa.)

Xây dựng tính nhất quán và các bản dựng gia tăng

Về mặt chính thức, chúng ta xác định trạng thái của bản dựng là nhất quán khi tất cả các giá trị dự kiến có tồn tại các tệp đầu ra và nội dung của chúng chính xác không, như được chỉ định trong các bước hoặc các quy tắc cần thiết để tạo các quảng cáo đó. Khi bạn chỉnh sửa một tệp nguồn, trạng thái của bản dựng được cho là không nhất quán và không nhất quán cho đến khi bạn chạy công cụ xây dựng để hoàn tất thành công. Chúng tôi mô tả tình huống này là không ổn định tính không nhất quán, bởi vì tính nhất quán chỉ là tạm thời và tính nhất quán sẽ được khôi phục bằng chạy công cụ bản dựng.

Có một loại sự không nhất quán khác gây nguy hại: ổn định sự không nhất quán. Nếu bản dựng đạt đến trạng thái không nhất quán ổn định, thì lặp lại việc gọi thành công công cụ tạo không khôi phục tính nhất quán: bản dựng gặp sự cố "mắc kẹt" và kết quả đầu ra vẫn không chính xác. Trạng thái không nhất quán ổn định là lý do chính khiến người dùng thuộc loại Make (và các công cụ xây dựng khác) loại make clean. Việc phát hiện công cụ xây dựng không hoạt động theo cách này (rồi khôi phục từ công cụ đó) có thể tốn thời gian và rất khó chịu.

Về mặt khái niệm, cách đơn giản nhất để đạt được một bản dựng nhất quán là loại bỏ tất cả các kết quả bản dựng trước đó và bắt đầu lại: tạo mọi bản dựng là một bản dựng sạch. Phương pháp này rõ ràng tốn quá nhiều thời gian nên khó thực thi (ngoại trừ dành cho kỹ sư phát hành) và do đó, để trở nên hữu ích, công cụ xây dựng phải có khả năng để tạo các bản dựng tăng dần mà không làm ảnh hưởng đến tính nhất quán.

Rất khó để phân tích chính xác phần phụ thuộc gia tăng và như mô tả ở trên, nhiều công cụ xây dựng khác không hiệu quả trong việc tránh các trạng thái không nhất quán ổn định trong các bản dựng gia tăng. Ngược lại, Bazel đưa ra bảo đảm sau: sau khi gọi thành công công cụ xây dựng mà trong thời gian đó bạn không thực hiện chỉnh sửa nào, bản dựng sẽ ở trạng thái nhất quán. (Nếu bạn chỉnh sửa tệp nguồn trong một bản dựng, Bazel không đảm bảo về tính nhất quán của kết quả của bản dựng hiện tại. Tuy nhiên, điều này đảm bảo rằng kết quả của bản dựng tiếp theo sẽ khôi phục tính nhất quán.)

Giống như tất cả các bảo đảm, có một số dòng chữ in nhỏ: có một số cách đã biết chuyển sang trạng thái không nhất quán ổn định với Bazel. Chúng tôi không đảm bảo sẽ điều tra những vấn đề như vậy phát sinh từ việc cố tình tìm lỗi trong phân tích phần phụ thuộc gia tăng, nhưng chúng tôi sẽ điều tra và cố gắng hết sức để khắc phục tất cả các trạng thái không nhất quán ổn định phát sinh từ việc sử dụng công cụ bản dựng theo cách thông thường hoặc "hợp lý".

Nếu bạn phát hiện thấy trạng thái không nhất quán ổn định với Bazel, vui lòng báo cáo lỗi.

Thực thi trong hộp cát

Bazel sử dụng hộp cát để đảm bảo các hành động chạy một cách khép kín và chính xác. Bazel chạy spawn (nói một cách đơn giản là: hành động) trong hộp cát chỉ chứa tập hợp tệp tối thiểu mà công cụ cần để thực hiện công việc của mình. Hiện tại, tính năng hộp cát hoạt động trên Linux 3.12 trở lên khi bật tuỳ chọn CONFIG_USER_NS, cũng như trên macOS 10.11 trở lên.

Bazel sẽ in một cảnh báo nếu hệ thống của bạn không hỗ trợ hộp cát để cảnh báo bạn thấy rằng các bản dựng không được đảm bảo mang tính khép kín và có thể ảnh hưởng hệ thống lưu trữ theo những cách không xác định. Để tắt cảnh báo này, bạn có thể truyền cờ --ignore_unsupported_sandboxing đến Bazel.

Trên một số nền tảng như nút cụm Google Kubernetes Engine hoặc Debian, theo mặc định, không gian tên người dùng sẽ bị vô hiệu hoá do các vấn đề về bảo mật. Bạn có thể kiểm tra điều này bằng cách xem tệp /proc/sys/kernel/unprivileged_userns_clone: nếu mã này tồn tại và chứa giá trị 0, thì bạn có thể kích hoạt không gian tên của người dùng bằng sudo sysctl kernel.unprivileged_userns_clone=1.

Trong một số trường hợp, hộp cát Bazel không thể thực thi các quy tắc do hệ thống thiết lập. Triệu chứng thường là một lỗi đưa ra thông báo tương tự như namespace-sandbox.c:633: execvp(argv[0], argv): No such file or directory. Trong trường hợp đó, hãy thử huỷ kích hoạt hộp cát cho genrules bằng --strategy=Genrule=standalone và với các quy tắc khác có --spawn_strategy=standalone. Ngoài ra, vui lòng báo cáo lỗi trên trình theo dõi lỗi của chúng tôi và đề cập đến bản phân phối Linux mà bạn đang sử dụng để chúng tôi có thể điều tra và cung cấp bản sửa lỗi trong bản phát hành tiếp theo.

Các giai đoạn của bản dựng

Trong Bazel, một quá trình xây dựng sẽ diễn ra theo ba giai đoạn riêng biệt; với vai trò là người dùng, việc hiểu rõ sự khác biệt giữa chúng cung cấp thông tin chi tiết về các tuỳ chọn kiểm soát bản dựng (xem bên dưới).

Giai đoạn tải

Đầu tiên là tải trong đó tất cả các tệp BUILD cần thiết cho các mục tiêu ban đầu và đóng gói bắc cầu của các phần phụ thuộc sẽ được tải, được phân tích cú pháp, đánh giá và lưu vào bộ nhớ đệm.

Đối với bản dựng đầu tiên sau khi máy chủ Bazel khởi động, giai đoạn tải thường mất nhiều giây khi số tệp BUILD được tải từ hệ thống tệp. Trong các bản dựng tiếp theo, đặc biệt là nếu không có tệp BUILD nào thay đổi, quá trình tải sẽ diễn ra rất nhanh.

Các lỗi được báo cáo trong giai đoạn này bao gồm: không tìm thấy gói, không tìm thấy mục tiêu, lỗi từ vựng và ngữ pháp trong tệp BUILD và lỗi đánh giá.

Giai đoạn phân tích

Giai đoạn thứ hai, phân tích, bao gồm việc phân tích ngữ nghĩa và xác thực từng quy tắc bản dựng, tạo biểu đồ phần phụ thuộc bản dựng và xác định chính xác công việc cần làm trong từng bước của bản dựng.

Giống như quá trình tải, quá trình phân tích cũng mất vài giây khi được tính toán toàn bộ. Tuy nhiên, Bazel lưu biểu đồ phần phụ thuộc vào bộ nhớ đệm từ bản dựng này sang bản dựng tiếp theo và chỉ phân tích lại những gì cần thiết, nhờ đó có thể tạo các bản dựng gia tăng cực nhanh trong trường hợp các gói không thay đổi kể từ bản dựng trước.

Các lỗi được báo cáo ở giai đoạn này bao gồm: phần phụ thuộc không phù hợp, không hợp lệ đầu vào vào quy tắc và tất cả các thông báo lỗi dành riêng cho quy tắc.

Giai đoạn tải và phân tích diễn ra nhanh vì Bazel tránh được các tệp không cần thiết I/O ở giai đoạn này, chỉ đọc tệp BUILD để xác định công việc cần xong. Điều này là do thiết kế và khiến Bazel trở thành một nền tảng tốt cho các công cụ phân tích, chẳng hạn như lệnh query của Bazel được triển khai ở đầu quá trình tải pha.

Giai đoạn thực thi

Giai đoạn thứ ba và cuối cùng của bản dựng là thực thi. Giai đoạn này đảm bảo rằng đầu ra của từng bước trong bản dựng nhất quán với đầu vào của bước đó, việc chạy lại biên dịch/liên kết/v.v. khi cần thiết. Bước này là nơi bản dựng dành phần lớn thời gian, từ vài giây đến hơn một giờ cho bản dựng. Các lỗi được báo cáo trong giai đoạn này bao gồm: thiếu tệp nguồn, lỗi trong một công cụ do một số thao tác bản dựng thực thi hoặc lỗi một công cụ không tạo ra được tập hợp đầu ra dự kiến.