Tất cả mục tiêu thuộc về một gói duy nhất. Tên của mục tiêu là có tên là label. Mỗi nhãn xác định riêng một mục tiêu. Một nhãn điển hình ở dạng chuẩn sẽ có dạng như sau:
@myrepo//my/app/main:app_binary
Phần đầu tiên của nhãn là tên kho lưu trữ, @myrepo//.
Trong trường hợp thông thường, nhãn tham chiếu đến cùng một kho lưu trữ mà từ đó
phần tử này được sử dụng, thì giá trị nhận dạng kho lưu trữ có thể được viết tắt là //.
Vì vậy, bên trong @myrepo, nhãn này thường được viết là
//my/app/main:app_binary
Phần thứ hai của nhãn là tên gói không đủ điều kiện
my/app/main, đường dẫn đến gói
so với gốc của kho lưu trữ. Tên kho lưu trữ và tên gói không đủ điều kiện cùng tạo thành tên gói đủ điều kiện @myrepo//my/app/main. Khi nhãn đề cập đến cùng một
gói mà nó được sử dụng trong, tên gói (và không bắt buộc có dấu hai chấm)
có thể bị bỏ qua. Vì vậy, bên trong @myrepo//my/app/main,
bạn có thể ghi nhãn này theo một trong các cách sau:
app_binary
:app_binary
Theo quy ước, dấu hai chấm sẽ bị bỏ qua đối với tệp nhưng được giữ lại đối với quy tắc. Tuy nhiên, điều này không quan trọng.
Phần của nhãn sau dấu hai chấm, app_binary là tên mục tiêu không đủ điều kiện. Khi khớp với thành phần cuối cùng của đường dẫn gói, bạn có thể bỏ qua thành phần này và dấu hai chấm. Vì vậy, hai nhãn này tương đương với nhau:
//my/app/lib
//my/app/lib:lib
Tên của mục tiêu tệp trong thư mục con của gói là đường dẫn của tệp
so với thư mục gốc của gói (thư mục chứa tệp BUILD). Vì vậy, tệp này nằm trong thư mục con my/app/main/testdata của kho lưu trữ:
//my/app/main:testdata/input.txt
Các chuỗi như //my/app và @some_repo//my/app có hai ý nghĩa tuỳ thuộc vào
ngữ cảnh sử dụng: khi Bazel mong đợi một nhãn, ý nghĩa của các từ khoá đó
//my/app:app và @some_repo//my/app:app. Nhưng, khi Bazel
mong đợi một gói (ví dụ: trong thông số kỹ thuật package_group), chúng tham chiếu đến
gói chứa nhãn đó.
Một lỗi thường gặp trong các tệp BUILD là dùng //my/app để tham chiếu đến một gói, hoặc
cho tất cả mục tiêu trong một gói--ứng dụng thì không. Hãy nhớ rằng, thuộc tính này tương đương với //my/app:app, vì vậy, thuộc tính này sẽ đặt tên cho mục tiêu app trong gói my/app của kho lưu trữ hiện tại.
Tuy nhiên, bạn nên sử dụng //my/app để tham chiếu đến một gói trong thông số kỹ thuật của package_group hoặc trong tệp .bzl, vì thông số này cho biết rõ tên gói là tuyệt đối và bắt nguồn từ thư mục cấp cao nhất của không gian làm việc.
Bạn không thể sử dụng nhãn tương đối để tham chiếu đến các mục tiêu trong các gói khác; bạn phải luôn chỉ định giá trị nhận dạng kho lưu trữ và tên gói trong trường hợp này.
Ví dụ: nếu cây nguồn chứa cả gói my/app và gói my/app/testdata (mỗi thư mục trong số hai thư mục này đều có tệp BUILD riêng), thì gói sau chứa một tệp có tên testdepot.zip. Dưới đây là hai cách (một cách sai, một cách đúng) để tham chiếu đến tệp này trong //my/app:BUILD:
Không đúng – testdata là một gói khác, vì vậy, bạn không thể sử dụng đường dẫn tương đối
testdata/testdepot.zip
Đúng — tham chiếu đến testdata với đường dẫn đầy đủ
//my/app/testdata:testdepot.zip
Nhãn bắt đầu bằng @// là tham chiếu đến biến
kho lưu trữ này vẫn sẽ hoạt động ngay cả từ các kho lưu trữ bên ngoài.
Do đó, @//a/b/c khác với
//a/b/c khi được tham chiếu từ một kho lưu trữ bên ngoài.
Phần trước tham chiếu về kho lưu trữ chính, còn phần sau tham chiếu đến kho lưu trữ chính
tìm //a/b/c trong chính kho lưu trữ bên ngoài.
Điều này đặc biệt liên quan khi viết các quy tắc trong
kho lưu trữ tham chiếu đến các mục tiêu trong kho lưu trữ chính và sẽ là
được sử dụng từ các kho lưu trữ bên ngoài.
Để biết thông tin về các cách bạn có thể tham chiếu đến mục tiêu, hãy xem phần mẫu mục tiêu.
Quy cách từ vựng của nhãn
Cú pháp nhãn không khuyến khích sử dụng siêu ký tự có ý nghĩa đặc biệt đối với vỏ. Điều này giúp tránh việc vô tình trích dẫn và giúp người dùng dễ dàng tạo các công cụ và tập lệnh thao túng nhãn, chẳng hạn như Ngôn ngữ truy vấn Bazel.
Dưới đây là thông tin chi tiết chính xác về các tên mục tiêu được phép.
Tên mục tiêu — package-name:target-name
target-name là tên của mục tiêu trong gói. Tên của quy tắc
là giá trị của thuộc tính name trong phần khai báo của quy tắc trong BUILD
file; tên của tệp là tên đường dẫn tương ứng với thư mục chứa
tệp BUILD.
Tên mục tiêu phải bao gồm toàn bộ các ký tự được lấy từ nhóm a – z,
A – Z, 0 – 9 và các ký hiệu dấu câu !%-@^_"#$&'()*-+,;<=>?[]{|}~/..
Tên tệp phải là đường dẫn tương đối ở dạng thông thường, tức là không được bắt đầu hoặc kết thúc bằng dấu gạch chéo (ví dụ: /foo và foo/ bị cấm) cũng như không được chứa nhiều dấu gạch chéo liên tiếp làm dấu phân cách đường dẫn (ví dụ: foo//bar). Tương tự, các tệp tham chiếu cấp trên (..) và tệp tham chiếu thư mục hiện tại (./) bị cấm.
Sai — Không sử dụng..` để tham chiếu đến các tệp trong các gói khác
Đúng – Sử dụng `//package-name:filename`
Mặc dù mọi người thường sử dụng / khi đặt tên cho mục tiêu tệp, nhưng bạn nên tránh sử dụng
/ trong tên quy tắc. Đặc biệt là khi sử dụng dạng viết tắt của nhãn, điều này có thể gây nhầm lẫn cho người đọc. Nhãn //foo/bar/wiz luôn là viết tắt
cho //foo/bar/wiz:wiz, ngay cả khi không có gói nào như vậy foo/bar/wiz; nó
không bao giờ tham chiếu đến //foo:bar/wiz, ngay cả khi mục tiêu đó tồn tại.
Tuy nhiên, có một số trường hợp việc sử dụng dấu gạch chéo sẽ thuận tiện hoặc đôi khi thậm chí là cần thiết. Ví dụ: tên của một số quy tắc nhất định phải khớp với tệp nguồn chính của quy tắc đó. Tệp nguồn chính có thể nằm trong một thư mục con của gói.
Tên gói – //package-name:target-name
Tên của một gói là tên của thư mục chứa tệp BUILD,
so với thư mục cấp cao nhất của kho lưu trữ chứa.
Ví dụ: my/app.
Tên gói phải bao gồm toàn bộ các ký tự lấy từ tập hợp
A-Z, a – z, 0 – 9, "/", "-", ".", "@" và "_" và không được phép
bắt đầu bằng dấu gạch chéo.
Đối với ngôn ngữ có cấu trúc thư mục quan trọng đối với mô-đun của ngôn ngữ đó hệ thống của mình (ví dụ: Java), thì bạn cần phải chọn tên thư mục giá trị nhận dạng hợp lệ trong ngôn ngữ.
Mặc dù Bazel hỗ trợ các mục tiêu trong gói gốc của không gian làm việc (ví dụ:
//:foo), bạn nên để trống gói đó để tất cả các gói có ý nghĩa
có tên mô tả.
Tên gói không được chứa chuỗi con // và cũng không kết thúc bằng dấu gạch chéo.
Quy tắc
Quy tắc chỉ định mối quan hệ giữa đầu vào và đầu ra, và các bước tạo đầu ra. Quy tắc có thể thuộc một trong nhiều loại (đôi khi được gọi là lớp quy tắc), tạo ra các tệp thực thi và thư viện đã biên dịch, kiểm thử các tệp thực thi và các đầu ra được hỗ trợ khác như mô tả trong Bách khoa toàn thư về bản dựng.
Tệp BUILD khai báo mục tiêu bằng cách gọi quy tắc.
Trong ví dụ bên dưới, chúng ta thấy phần khai báo về my_app mục tiêu
bằng cách sử dụng quy tắc cc_binary.
cc_binary(
name = "my_app",
srcs = ["my_app.cc"],
deps = [
"//absl/base",
"//absl/strings",
],
)
Mỗi lệnh gọi quy tắc đều có một thuộc tính name (phải là một tên mục tiêu hợp lệ), khai báo một mục tiêu trong gói của tệp BUILD.
Mỗi quy tắc đều có một tập hợp các thuộc tính; các thuộc tính có thể áp dụng cho một thuộc tính nhất định và tầm quan trọng và ngữ nghĩa của mỗi thuộc tính là một hàm của loại quy tắc; hãy xem nội dung Xây dựng Bách khoa toàn thư để biết danh sách quy tắc và thuộc tính tương ứng của chúng. Mỗi thuộc tính đều có tên và một loại. Một số loại phổ biến của một thuộc tính là số nguyên, nhãn, danh sách of label (nhãn), string (chuỗi), danh sách chuỗi (Output), output (nhãn đầu ra), danh sách các nhãn đầu ra. Không phải thuộc tính nào cũng cần được chỉ định trong mọi quy tắc. Do đó, các thuộc tính tạo thành từ điển từ khoá (tên) thành giá trị đã nhập tuỳ chọn.
Thuộc tính srcs có trong nhiều quy tắc có loại "danh sách nhãn"; giá trị của thuộc tính này (nếu có) là một danh sách nhãn, mỗi nhãn là tên của một mục tiêu là dữ liệu đầu vào cho quy tắc này.
Trong một số trường hợp, tên của loại quy tắc hơi tuỳ ý, thú vị là tên của các tệp được tạo bởi quy tắc và điều này đúng genrules. Để biết thêm thông tin, hãy xem phần Quy tắc chung: genrule.
Trong các trường hợp khác, tên có ý nghĩa quan trọng: ví dụ: đối với các quy tắc *_binary và *_test, tên quy tắc xác định tên của tệp thực thi do bản dựng tạo ra.
Biểu đồ không tuần hoàn có hướng này trên các mục tiêu được gọi là biểu đồ mục tiêu hoặc biểu đồ phần phụ thuộc bản dựng và là miền mà Công cụ truy vấn Bazel hoạt động.
| Mục tiêu | BUILD files |