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

Lệnh và tuỳ chọn

Trang này trình bày các tuỳ chọn có sẵn với nhiều lệnh Bazel, chẳng hạn như bazel build, bazel run và bazel test. Trang này là trang đồng hành với danh sách các lệnh của Bazel trong phần Build with Bazel (Tạo bằng Bazel).

Cú pháp đích

Một số lệnh (như build hoặc test) có thể hoạt động trên một danh sách mục tiêu. Các lớp này sử dụng cú pháp linh hoạt hơn so với nhãn, được nêu trong phần Chỉ định mục tiêu để tạo.

Tùy chọn

Các phần sau đây mô tả các tuỳ chọn có sẵn trong quá trình tạo bản dựng. Khi --long được dùng trong một lệnh trợ giúp, thông báo trợ giúp trực tuyến sẽ cung cấp thông tin tóm tắt về ý nghĩa, loại và giá trị mặc định cho từng tuỳ chọn.

Hầu hết các lựa chọn đều chỉ có thể được chỉ định một lần. Khi được chỉ định nhiều lần, thực thể cuối cùng sẽ thắng. Các tuỳ chọn có thể chỉ định nhiều lần sẽ được xác định trong phần trợ giúp trực tuyến với văn bản "có thể được dùng nhiều lần".

Vị trí gói hàng

`--package_path`

Tuỳ chọn này chỉ định tập hợp các thư mục được tìm kiếm để tìm tệp BUILD cho một gói nhất định.

Bazel tìm các gói của mình bằng cách tìm đường dẫn gói. Đây là một danh sách theo thứ tự được phân tách bằng dấu hai chấm, trong đó mỗi thư mục bazel là gốc của một phần cây nguồn.

Cách chỉ định đường dẫn gói tuỳ chỉnh bằng tuỳ chọn --package_path:

  % bazel build --package_path %workspace%:/some/other/root

Bạn có thể chỉ định các phần tử đường dẫn gói ở 3 định dạng:

Nếu ký tự đầu tiên là /, đường dẫn sẽ là đường dẫn tuyệt đối.
Nếu đường dẫn bắt đầu bằng %workspace%, thì đường dẫn sẽ được thực hiện tương ứng với thư mục bazel bao quanh gần nhất. Ví dụ: nếu thư mục đang hoạt động của bạn là /home/bob/clients/bob_client/bazel/foo, thì chuỗi %workspace% trong đường dẫn gói sẽ được mở rộng thành /home/bob/clients/bob_client/bazel.
Mọi hoạt động khác sẽ được lấy liên quan đến thư mục đang hoạt động. Đây thường không phải là ý bạn muốn làm và có thể hoạt động không như mong đợi nếu bạn sử dụng Bazel từ các thư mục bên dưới không gian làm việc bazel. Ví dụ: nếu bạn sử dụng phần tử package-path . rồi cd vào thư mục /home/bob/clients/bob_client/bazel/foo, thì các gói sẽ được phân giải từ thư mục /home/bob/clients/bob_client/bazel/foo.

Nếu bạn sử dụng một đường dẫn gói không phải mặc định, hãy chỉ định đường dẫn đó trong tệp cấu hình Bazel để thuận tiện.

Bazel không yêu cầu bất kỳ gói nào phải nằm trong thư mục hiện tại. Vì vậy, bạn có thể tạo một bản dựng từ một không gian làm việc bazel trống nếu có thể tìm thấy tất cả các gói cần thiết ở nơi khác trên đường dẫn gói.

Ví dụ: Xây dựng từ một ứng dụng trống

  % mkdir -p foo/bazel
  % cd foo/bazel
  % touch WORKSPACE
  % bazel build --package_path /some/other/path //foo

`--deleted_packages`

Tuỳ chọn này chỉ định một danh sách các gói được phân tách bằng dấu phẩy mà Bazel nên xem xét là đã xoá và không tìm cách tải từ bất kỳ thư mục nào trên đường dẫn gói. Bạn có thể dùng tính năng này để mô phỏng việc xoá các gói mà không thực sự xoá chúng.

Lỗi khi kiểm tra

Các tuỳ chọn này kiểm soát việc kiểm tra lỗi và/hoặc cảnh báo của Bazel.

`--[no]check_visibility`

Nếu bạn đặt tuỳ chọn này thành false, thì tính năng kiểm tra khả năng hiển thị sẽ bị giảm hạng xuống thành cảnh báo. Giá trị mặc định của tuỳ chọn này là true (đúng) để theo mặc định, việc kiểm tra chế độ hiển thị sẽ hoàn tất.

`--output_filter=regex`

Tuỳ chọn --output_filter sẽ chỉ hiển thị cảnh báo về bản dựng và biên dịch cho các mục tiêu khớp với biểu thức chính quy. Nếu một mục tiêu không khớp với biểu thức chính quy đã cho và quá trình thực thi thành công, thì đầu ra chuẩn và lỗi chuẩn của biểu thức đó sẽ bị loại bỏ.

Dưới đây là một số giá trị điển hình cho tuỳ chọn này:

`--output_filter='^//(first/project\|second/project):'`	Hiện kết quả cho các gói được chỉ định.
`--output_filter='^//((?!(first/bad_project\|second/bad_project):).)*$'`	Không hiện kết quả cho các gói được chỉ định.
`--output_filter=`	Hiện mọi thứ.
`--output_filter=DONT_MATCH_ANYTHING`	Không hiển thị gì.

Cờ công cụ

Các tuỳ chọn này kiểm soát những tuỳ chọn mà Bazel sẽ chuyển sang các công cụ khác.

`--copt=cc-option`

Tuỳ chọn này sẽ lấy một đối số sẽ được truyền đến trình biên dịch. Đối số này sẽ được chuyển đến trình biên dịch bất cứ khi nào nó được gọi để xử lý trước, biên dịch và/hoặc tập hợp mã C, C++ hoặc mã tập hợp. Mã này sẽ không được chuyển khi liên kết.

Bạn có thể sử dụng lựa chọn này nhiều lần. Ví dụ:

  % bazel build --copt="-g0" --copt="-fpic" //foo

sẽ biên dịch thư viện foo mà không có bảng gỡ lỗi, tạo ra mã độc lập với vị trí.

`--host_copt=cc-option`

Tuỳ chọn này sẽ lấy một đối số sẽ được truyền đến trình biên dịch cho các tệp nguồn được biên dịch trong cấu hình máy chủ lưu trữ. Lựa chọn này tương tự như tuỳ chọn --copt, nhưng chỉ áp dụng cho cấu hình máy chủ lưu trữ.

`--host_conlyopt=cc-option`

Tuỳ chọn này sẽ lấy một đối số sẽ được truyền đến trình biên dịch cho các tệp nguồn C được biên dịch trong cấu hình máy chủ lưu trữ. Lựa chọn này tương tự như tuỳ chọn --conlyopt, nhưng chỉ áp dụng cho cấu hình máy chủ lưu trữ.

`--host_cxxopt=cc-option`

Tuỳ chọn này sẽ lấy một đối số sẽ được truyền đến trình biên dịch cho các tệp nguồn C++ được biên dịch trong cấu hình máy chủ lưu trữ. Lựa chọn này tương tự như tuỳ chọn --cxxopt, nhưng chỉ áp dụng cho cấu hình máy chủ lưu trữ.

`--host_linkopt=linker-option`

Tuỳ chọn này sẽ lấy một đối số sẽ được truyền đến trình liên kết cho các tệp nguồn được biên dịch trong cấu hình máy chủ lưu trữ. Lựa chọn này tương tự như tuỳ chọn --linkopt, nhưng chỉ áp dụng cho cấu hình máy chủ lưu trữ.

`--conlyopt=cc-option`

Tuỳ chọn này sẽ lấy một đối số sẽ được truyền đến trình biên dịch khi biên dịch tệp nguồn C.

Điều này tương tự như --copt, nhưng chỉ áp dụng cho biên dịch C, không áp dụng cho việc biên dịch hoặc liên kết C++. Vì vậy, bạn có thể chuyển các tuỳ chọn dành riêng cho C (chẳng hạn như -Wno-pointer-sign) bằng cách sử dụng --conlyopt.

`--cxxopt=cc-option`

Tuỳ chọn này sẽ lấy một đối số sẽ được truyền đến trình biên dịch khi biên dịch các tệp nguồn C++.

Điều này tương tự như --copt, nhưng chỉ áp dụng cho biên dịch C++, không áp dụng cho việc biên dịch hoặc liên kết C. Vì vậy, bạn có thể truyền các tuỳ chọn dành riêng cho C++ (chẳng hạn như -fpermissive hoặc -fno-implicit-templates) bằng --cxxopt.

Ví dụ:

  % bazel build --cxxopt="-fpermissive" --cxxopt="-Wno-error" //foo/cruddy_code

`--linkopt=linker-option`

Tuỳ chọn này sẽ lấy một đối số sẽ được truyền đến trình biên dịch khi liên kết.

Điều này tương tự như --copt, nhưng chỉ áp dụng cho việc liên kết chứ không áp dụng cho việc biên dịch. Vì vậy, bạn có thể truyền các tuỳ chọn trình biên dịch chỉ có ý nghĩa tại thời điểm liên kết (chẳng hạn như -lssp hoặc -Wl,--wrap,abort) bằng cách sử dụng --linkopt. Ví dụ:

  % bazel build --copt="-fmudflap" --linkopt="-lmudflap" //foo/buggy_code

Quy tắc tạo cũng có thể chỉ định tuỳ chọn đường liên kết trong các thuộc tính của chúng. Chế độ cài đặt của tuỳ chọn này luôn được ưu tiên. Ngoài ra, hãy xem cc_library.linkopts.

`--strip (always|never|sometimes)`

Tuỳ chọn này xác định xem Bazel có xoá thông tin gỡ lỗi khỏi tất cả các tệp nhị phân và thư viện dùng chung hay không bằng cách gọi trình liên kết với tuỳ chọn -Wl,--strip-debug. --strip=always có nghĩa là luôn xoá thông tin gỡ lỗi. --strip=never có nghĩa là không bao giờ loại bỏ thông tin gỡ lỗi. Giá trị mặc định của --strip=sometimes có nghĩa là xoá nếu --compilation_mode là fastbuild.

  % bazel build --strip=always //foo:bar

sẽ biên dịch mục tiêu trong khi xoá thông tin gỡ lỗi khỏi tất cả các tệp nhị phân được tạo.

Tuỳ chọn --strip của Bazel tương ứng với tuỳ chọn --strip-debug của ld: tuỳ chọn này chỉ xoá thông tin gỡ lỗi. Nếu vì lý do nào đó mà bạn muốn xoá tất cả ký hiệu, chứ không chỉ biểu tượng gỡ lỗi, thì bạn cần sử dụng tuỳ chọn --strip-all của ld. Bạn có thể thực hiện việc này bằng cách truyền --linkopt=-Wl,--strip-all đến Bazel. Ngoài ra, hãy lưu ý rằng việc thiết lập cờ --strip của Bazel sẽ ghi đè --linkopt=-Wl,--strip-all, vì vậy, bạn chỉ nên đặt một trong hai cờ này.

Nếu chỉ tạo một tệp nhị phân duy nhất và muốn xoá tất cả các biểu tượng, thì bạn cũng có thể truyền --stripopt=--strip-all và tạo phiên bản //foo:bar.stripped của mục tiêu một cách rõ ràng. Như đã mô tả trong phần về --stripopt, thao tác này sẽ áp dụng thao tác loại bỏ sau khi tệp nhị phân cuối cùng được liên kết thay vì bao gồm thao tác loại bỏ trong tất cả các thao tác liên kết của bản dựng.

`--stripopt=strip-option`

Đây là một lựa chọn bổ sung để truyền vào lệnh strip khi tạo tệp nhị phân *.stripped. Giá trị mặc định là -S -p. Bạn có thể sử dụng lựa chọn này nhiều lần.

`--fdo_instrument=profile-output-dir`

Tuỳ chọn --fdo_instrument cho phép tạo đầu ra hồ sơ FDO (tối ưu hoá hướng phản hồi) khi tệp nhị phân C/C++ đã tạo được thực thi. Đối với GCC, đối số đã cung cấp được dùng làm tiền tố thư mục cho cây thư mục tệp cho mỗi đối tượng của các tệp .gcda có chứa thông tin hồ sơ của mỗi tệp .o.

Sau khi tạo cây dữ liệu hồ sơ, cây hồ sơ sẽ được nén và cung cấp cho tuỳ chọn Bazel --fdo_optimize=profile-zip để bật tính năng biên dịch được tối ưu hoá cho FDO.

Đối với trình biên dịch LLVM, đối số cũng là thư mục mà(các) tệp dữ liệu hồ sơ LLVM thô được kết xuất. Ví dụ: --fdo_instrument=/path/to/rawprof/dir/.

Bạn không thể sử dụng các tuỳ chọn --fdo_instrument và --fdo_optimize cùng một lúc.

`--fdo_optimize=profile-zip`

Tuỳ chọn --fdo_optimize cho phép sử dụng thông tin hồ sơ tệp theo từng đối tượng để tiến hành tối ưu hoá FDO (tối ưu hoá hướng phản hồi) khi biên dịch. Đối với GCC, đối số được cung cấp là tệp zip chứa cây tệp được tạo trước đó của các tệp .gcda chứa thông tin hồ sơ của từng tệp .o.

Ngoài ra, đối số được cung cấp có thể trỏ đến một hồ sơ tự động được xác định bằng đuôi .afdo.

Đối với trình biên dịch LLVM, đối số được cung cấp phải trỏ đến tệp đầu ra hồ sơ LLVM được lập chỉ mục do công cụ llvm-profdata chuẩn bị và phải có đuôi .profdata.

Bạn không thể sử dụng các tuỳ chọn --fdo_instrument và --fdo_optimize cùng một lúc.

`--[no]output_symbol_counts`

Nếu được bật, mỗi đường liên kết được gọi bằng vàng của một tệp nhị phân thực thi C++ sẽ xuất ra một tệp số lượng biểu tượng (thông qua tuỳ chọn --print-symbol-counts vàng). Đối với mỗi đầu vào của trình liên kết, tệp này sẽ ghi lại số lượng biểu tượng đã xác định và số lượng biểu tượng đã được sử dụng trong tệp nhị phân. Bạn có thể dùng thông tin này để theo dõi các phần phụ thuộc không cần thiết của đường liên kết. Tệp đếm biểu tượng được ghi vào đường dẫn đầu ra của tệp nhị phân có tên là [targetname].sc.

Tuỳ chọn này bị tắt theo mặc định.

`--java_language_version=version`

Tuỳ chọn này chỉ định phiên bản của nguồn Java. Ví dụ:

  % bazel build --java_language_version=8 java/com/example/common/foo:all

biên dịch và chỉ cho phép các cấu trúc tương thích với quy cách Java 8. Giá trị mặc định là 11. --> Các giá trị có thể là: 8, 9, 10, 11, 14 và 15. Bạn có thể mở rộng các giá trị này bằng cách đăng ký chuỗi công cụ Java tuỳ chỉnh bằng default_java_toolchain.

`--tool_java_language_version=version`

Phiên bản ngôn ngữ Java dùng để tạo các công cụ được thực thi trong quá trình tạo bản dựng. Giá trị mặc định là 11.

`--java_runtime_version=version`

Tuỳ chọn này chỉ định phiên bản JVM cần dùng để thực thi mã và chạy kiểm thử. Ví dụ:

  % bazel run --java_runtime_version=remotejdk_11 java/com/example/common/foo:java_application

tải JDK 11 xuống từ một kho lưu trữ từ xa và chạy ứng dụng Java bằng cách sử dụng kho lưu trữ đó.

Giá trị mặc định là localjdk. Các giá trị có thể là: localjdk, localjdk_version, remotejdk_11 và remote_jdk17. Bạn có thể mở rộng các giá trị bằng cách đăng ký JVM tuỳ chỉnh thông qua các quy tắc kho lưu trữ local_java_repository hoặc remote_java_repostory.

`--tool_java_runtime_version=version`

Phiên bản JVM được dùng để thực thi các công cụ cần thiết trong quá trình tạo bản dựng. Giá trị mặc định là remotejdk_11.

`--jvmopt=jvm-option`

Tuỳ chọn này cho phép truyền đối số tuỳ chọn đến máy ảo Java. Hàm này có thể được dùng với một đối số lớn hoặc nhiều lần với các đối số riêng lẻ. Ví dụ:

  % bazel build --jvmopt="-server -Xms256m" java/com/example/common/foo:all

sẽ sử dụng máy chủ ảo để khởi chạy tất cả các tệp nhị phân Java và đặt kích thước vùng nhớ khối xếp khởi động cho máy ảo thành 256 MB.

`--javacopt=javac-option`

Tuỳ chọn này cho phép truyền đối số tuỳ chọn đến javac. Hàm này có thể được dùng với một đối số lớn hoặc nhiều lần với các đối số riêng lẻ. Ví dụ:

  % bazel build --javacopt="-g:source,lines" //myprojects:prog

sẽ xây dựng lại một java_binary bằng thông tin gỡ lỗi mặc định javac (thay vì giá trị mặc định bazel).

Tuỳ chọn này được chuyển đến javac sau các tuỳ chọn mặc định tích hợp sẵn Bazel cho javac và trước các tuỳ chọn theo quy tắc. Thông số kỹ thuật cuối cùng của bất kỳ tuỳ chọn nào cho javac sẽ chiến thắng. Các tuỳ chọn mặc định cho javac là:

  -source 8 -target 8 -encoding UTF-8

`--strict_java_deps (default|strict|off|warn|error)`

Tuỳ chọn này kiểm soát việc javac có kiểm tra để tìm các phần phụ thuộc trực tiếp bị thiếu hay không. Các mục tiêu Java phải khai báo rõ ràng tất cả mục tiêu được sử dụng trực tiếp dưới dạng phần phụ thuộc. Cờ này hướng dẫn javac xác định các tệp jar thực sự được dùng để kiểm tra loại từng tệp java và cảnh báo/lỗi nếu chúng không phải là kết quả của phần phụ thuộc trực tiếp của mục tiêu hiện tại.

off có nghĩa là tính năng kiểm tra đã tắt.
warn có nghĩa là javac sẽ tạo cảnh báo java tiêu chuẩn thuộc loại [strict] cho từng phần phụ thuộc trực tiếp bị thiếu.
default, strict và error đều có nghĩa là javac sẽ tạo lỗi thay vì cảnh báo, khiến mục tiêu hiện tại không xây dựng được nếu tìm thấy bất kỳ phần phụ thuộc trực tiếp nào bị thiếu. Đây cũng là hành vi mặc định khi cờ không được chỉ định.

Xây dựng ngữ nghĩa

Các tuỳ chọn này ảnh hưởng đến các lệnh bản dựng và/hoặc nội dung của tệp đầu ra.

`--compilation_mode (fastbuild|opt|dbg)` (-c)

Tuỳ chọn --compilation_mode (thường được viết tắt thành -c, đặc biệt là -c opt) lấy đối số của fastbuild, dbg hoặc opt và ảnh hưởng đến nhiều tuỳ chọn tạo mã C/C++, chẳng hạn như mức độ tối ưu hoá và tính hoàn chỉnh của bảng gỡ lỗi. Bazel sử dụng một thư mục đầu ra riêng cho từng chế độ biên dịch, vì vậy, bạn có thể chuyển đổi giữa các chế độ mà không cần tạo lại toàn bộ mỗi lần.

fastbuild có nghĩa là tạo bản dựng nhanh nhất có thể: tạo thông tin gỡ lỗi tối thiểu (-gmlt -Wl,-S) và không tối ưu hoá. Đây là lựa chọn mặc định. Lưu ý: -DNDEBUG sẽ không được đặt.
dbg có nghĩa là bản dựng có bật tính năng gỡ lỗi (-g) để bạn có thể sử dụng gdb (hoặc một trình gỡ lỗi khác).
opt có nghĩa là bản dựng có bật tính năng tối ưu hoá và tắt các lệnh gọi assert() (-O2 -DNDEBUG). Thông tin gỡ lỗi sẽ không được tạo ở chế độ opt trừ phi bạn cũng truyền --copt -g.

`--cpu=cpu`

Tuỳ chọn này chỉ định kiến trúc CPU mục tiêu dùng để biên dịch tệp nhị phân trong quá trình tạo bản dựng.

`--action_env=VAR=VALUE`

Chỉ định tập hợp biến môi trường có sẵn trong quá trình thực thi tất cả hành động. Bạn có thể chỉ định biến theo tên, trong trường hợp đó, giá trị sẽ được lấy từ môi trường gọi hoặc bằng cặp name=value đặt giá trị độc lập với môi trường gọi.

Bạn có thể chỉ định cờ --action_env này nhiều lần. Nếu một giá trị được gán cho cùng một biến trên nhiều cờ --action_env, thì phép gán mới nhất sẽ chiến thắng.

`--experimental_action_listener=label`

Tuỳ chọn experimental_action_listener hướng dẫn Bazel sử dụng các thông tin chi tiết từ quy tắc action_listener do label chỉ định để chèn extra_actions vào biểu đồ bản dựng.

`--[no]experimental_extra_action_top_level_only`

Nếu bạn đặt tuỳ chọn này thành true, thì các thao tác bổ sung do tuỳ chọn dòng lệnh --experimental_action_listener chỉ định sẽ chỉ được lên lịch cho các mục tiêu cấp cao nhất.

`--experimental_extra_action_filter=regex`

Tuỳ chọn experimental_extra_action_filter hướng dẫn Bazel lọc tập hợp các mục tiêu để lên lịch cho extra_actions.

Cờ này chỉ áp dụng kết hợp với cờ --experimental_action_listener.

Theo mặc định, tất cả extra_actions trong quá trình đóng bắc cầu của các mục tiêu được yêu cầu cần xây dựng đều được lên lịch thực thi. --experimental_extra_action_filter sẽ hạn chế việc lên lịch ở extra_actions, trong đó nhãn của chủ sở hữu khớp với biểu thức chính quy đã chỉ định.

Ví dụ sau đây sẽ giới hạn việc lên lịch biểu extra_actions để chỉ áp dụng cho các hành động mà nhãn của chủ sở hữu chứa "/bar/":

% bazel build --experimental_action_listener=//test:al //foo/... \
  --experimental_extra_action_filter=.*/bar/.*

`--host_cpu=cpu`

Tuỳ chọn này chỉ định tên của kiến trúc CPU sẽ được dùng để tạo công cụ lưu trữ.

`--fat_apk_cpu=cpu[,cpu]*`

Các CPU để xây dựng thư viện C/C++ trong deps bắc cầu của các quy tắc android_binary. Các quy tắc C/C++ khác sẽ không bị ảnh hưởng. Ví dụ: nếu một cc_library xuất hiện trong deps bắc cầu của quy tắc android_binary và quy tắc cc_binary, thì cc_library sẽ được tạo ít nhất 2 lần: một lần cho mỗi CPU được chỉ định bằng --fat_apk_cpu cho quy tắc android_binary và một lần cho CPU được chỉ định bằng --cpu cho quy tắc cc_binary.

Mặc định là armeabi-v7a.

Một tệp .so được tạo và đóng gói trong APK cho từng CPU được chỉ định bằng --fat_apk_cpu. Tên của tệp .so đứng trước tên của quy tắc android_binary bằng "lib". Ví dụ: nếu tên của android_binary là "foo", thì tệp sẽ là libfoo.so.

`--per_file_copt=[+-]regex[,[+-]regex]...@option[,option]...`

Nếu có, mọi tệp C++ có nhãn hoặc đường dẫn thực thi khớp với một trong các biểu thức chính quy đưa vào nhưng không khớp với bất kỳ biểu thức loại trừ nào sẽ được tạo bằng các tuỳ chọn cho sẵn. Việc so khớp nhãn sử dụng dạng chính tắc của nhãn (tức là //package:label_name).

Đường dẫn thực thi là đường dẫn tương đối đến thư mục không gian làm việc, bao gồm cả tên cơ sở (bao gồm cả phần mở rộng) của tệp C++. Số liệu này cũng bao gồm mọi tiền tố phụ thuộc vào nền tảng.

Để khớp với các tệp đã tạo (chẳng hạn như đầu ra của quy tắc gen), Baazel chỉ có thể sử dụng đường dẫn thực thi. Trong trường hợp này, biểu thức chính quy không nên bắt đầu bằng "//" vì không khớp với bất kỳ đường dẫn thực thi nào. Bạn có thể sử dụng tên gói như sau: --per_file_copt=base/.*\.pb\.cc@-g0. Thao tác này sẽ so khớp mọi tệp .pb.cc trong thư mục có tên là base.

Bạn có thể sử dụng lựa chọn này nhiều lần.

Tuỳ chọn này được áp dụng bất kể chế độ biên dịch được sử dụng là gì. Ví dụ: bạn có thể biên dịch bằng --compilation_mode=opt và biên dịch có chọn lọc một số tệp khi bật tính năng tối ưu hoá mạnh hơn hoặc khi tính năng tối ưu hoá bị tắt.

Caveat: Nếu một số tệp được biên dịch có chọn lọc bằng các biểu tượng gỡ lỗi, thì các biểu tượng có thể bị xoá trong quá trình liên kết. Bạn có thể ngăn điều này bằng cách đặt --strip=never.

Cú pháp: [+-]regex[,[+-]regex]...@option[,option]... Trong đó regex là viết tắt của một biểu thức chính quy có thể có tiền tố + để xác định các mẫu bao gồm và bằng - để xác định các mẫu loại trừ. option là viết tắt của một tuỳ chọn tuỳ ý được truyền đến trình biên dịch C++. Nếu một tuỳ chọn chứa ,, thì tuỳ chọn đó phải được đặt trong dấu ngoặc kép như \,. Các tuỳ chọn cũng có thể chứa @, vì chỉ @ đầu tiên được dùng để phân tách biểu thức chính quy khỏi các tuỳ chọn.

Ví dụ: --per_file_copt=//foo:.*\.cc,-//foo:file\.cc@-O0,-fprofile-arcs sẽ thêm tuỳ chọn -O0 và -fprofile-arcs vào dòng lệnh của trình biên dịch C++ cho tất cả tệp .cc trong //foo/, ngoại trừ file.cc.

`--dynamic_mode=mode`

Xác định xem các tệp nhị phân C++ có được liên kết động bằng cách tương tác với thuộc tính đường liên kết tĩnh trong quy tắc bản dựng hay không.

Chế độ:

auto: Chuyển sang chế độ phụ thuộc vào nền tảng; default cho linux và off cho cygwin.
default: Cho phép bazel chọn có liên kết linh động hay không. Hãy xem linkstatic để biết thêm thông tin.
fully: Liên kết tất cả mục tiêu một cách linh động. Điều này sẽ tăng tốc thời gian liên kết và giảm kích thước của các tệp nhị phân thu được.
off: Liên kết tất cả mục tiêu ở chế độ hầu hết là tĩnh. Nếu bạn đặt -static trong liên kết, thì các mục tiêu sẽ thay đổi thành hoàn toàn tĩnh.

`--fission (yes|no|[dbg][,opt][,fastbuild])`

Bật Fission để ghi thông tin gỡ lỗi C++ vào các tệp .dwo chuyên dụng thay vì các tệp .o. Điều này giúp giảm đáng kể kích thước đầu vào cho các đường liên kết và có thể giảm thời gian liên kết.

Khi được đặt thành [dbg][,opt][,fastbuild] (ví dụ: --fission=dbg,fastbuild), Fission chỉ được bật cho nhóm chế độ biên dịch đã chỉ định. Điều này rất hữu ích cho các chế độ cài đặt bazelrc. Khi bạn đặt thành yes, Fission sẽ bật trên toàn cầu. Khi bạn đặt thành no, Fission sẽ bị tắt trên toàn cầu. Mặc định là no.

`--force_ignore_dash_static`

Nếu bạn đặt cờ này, thì mọi tuỳ chọn -static trong các đường liên kết của các tệp BUILD quy tắc cc_* sẽ bị bỏ qua. Đây chỉ nhằm mục đích giải quyết vấn đề cho các bản dựng tăng cường C++.

`--[no]force_pic`

Nếu được bật, tất cả phần biên dịch C++ sẽ tạo ra mã độc lập với vị trí ("-fPIC"), các đường liên kết sẽ ưu tiên các thư viện tạo sẵn PIC hơn là thư viện không phải PIC và các đường liên kết tạo ra các tệp thực thi độc lập về vị trí ("-pie"). Mặc định là vô hiệu hoá.

`--android_resource_shrinking`

Chọn xem có thực hiện rút gọn tài nguyên cho quy tắc android_binary hay không. Đặt giá trị mặc định cho thuộc tính thu gọn trên quy tắc android_binary; hãy xem tài liệu về quy tắc đó để biết thêm chi tiết. Giá trị mặc định là tắt.

`--custom_malloc=malloc-library-target`

Khi được chỉ định, hãy luôn sử dụng phương thức triển khai Malloc nhất định, ghi đè mọi thuộc tính malloc="target", kể cả trong các mục tiêu sử dụng giá trị mặc định đó (bằng cách không chỉ định malloc nào).

`--crosstool_top=label`

Tuỳ chọn này chỉ định vị trí của bộ trình biên dịch crosstool sẽ được dùng cho tất cả hoạt động biên dịch C++ trong một bản dựng. Bazel sẽ tìm tệp CROSSTOOL ở vị trí đó và sử dụng tệp đó để tự động xác định các chế độ cài đặt cho --compiler.

`--host_crosstool_top=label`

Nếu không được chỉ định, Bazel sẽ sử dụng giá trị của --crosstool_top để biên dịch mã trong cấu hình máy chủ lưu trữ, chẳng hạn như các công cụ chạy trong quá trình tạo bản dựng. Mục đích chính của cờ này là cho phép biên dịch chéo.

`--apple_crosstool_top=label`

Công cụ chéo cần dùng để biên dịch các quy tắc C/C++ trong deps bắc cầu của các quy tắc objc*, ios* và apple*. Đối với các mục tiêu đó, cờ này sẽ ghi đè --crosstool_top.

`--android_crosstool_top=label`

Công cụ chéo dùng để biên dịch các quy tắc C/C++ trong deps bắc cầu của các quy tắc android_binary. Điều này rất hữu ích nếu các mục tiêu khác trong bản dựng yêu cầu một công cụ chéo khác. Tuỳ chọn mặc định là sử dụng công cụ chéo do quy tắc android_ndk_repository tạo trong tệp WORKSPACE. Xem thêm --fat_apk_cpu.

`--compiler=version`

Tuỳ chọn này chỉ định phiên bản trình biên dịch C/C++ (chẳng hạn như gcc-4.1.0) sẽ được dùng để biên dịch tệp nhị phân trong quá trình tạo bản dựng. Nếu muốn tạo bằng công cụ chéo tuỳ chỉnh, bạn nên sử dụng tệp CROSSTOOL thay vì chỉ định cờ này.

`--android_sdk=label`

Tuỳ chọn này chỉ định chuỗi công cụ SDK/nền tảng Android và thư viện Android Runtime sẽ được dùng để tạo mọi quy tắc liên quan đến Android.

SDK Android sẽ được chọn tự động nếu quy tắc android_sdk_repository được xác định trong tệp WORKSPACE.

`--java_toolchain=label`

Tuỳ chọn này chỉ định nhãn của java_toolchain dùng để biên dịch các tệp nguồn Java.

`--host_java_toolchain=label`

Nếu không được chỉ định, bazel sẽ sử dụng giá trị của --java_toolchain để biên dịch mã trong cấu hình máy chủ lưu trữ, chẳng hạn như cho các công cụ chạy trong quá trình tạo bản dựng. Mục đích chính của cờ này là cho phép biên dịch chéo.

`--javabase=(label)`

Tuỳ chọn này sẽ đặt nhãn của bản cài đặt Java cơ sở để dùng cho hoạt động chạy Bazel, kiểm thử Bazel và cho các tệp nhị phân Java được tạo theo quy tắc java_binary và java_test. Biến"Tạo" JAVABASE và JAVA được lấy từ tuỳ chọn này.

`--host_javabase=label`

Tuỳ chọn này sẽ đặt nhãn của bản cài đặt Java cơ sở để sử dụng trong cấu hình máy chủ lưu trữ, ví dụ: các công cụ xây dựng máy chủ lưu trữ như JavaBuilder và Singlejar.

Thao tác này không chọn trình biên dịch Java dùng để biên dịch các tệp nguồn Java. Bạn có thể chọn trình biên dịch bằng cách đặt tuỳ chọn --java_toolchain.

Chiến lược thực thi

Các tuỳ chọn này ảnh hưởng đến cách Bazel thực thi bản dựng. Các lớp này sẽ không ảnh hưởng đáng kể đến các tệp đầu ra do bản dựng tạo ra. Thông thường, tác động chính của chúng là tốc độ tạo bản dựng.

`--spawn_strategy=strategy`

Tuỳ chọn này kiểm soát địa điểm và cách thức thực thi các lệnh.

standalone khiến các lệnh được thực thi dưới dạng quy trình phụ cục bộ. Giá trị này không được dùng nữa. Thay vào đó, hãy sử dụng local.
sandboxed khiến các lệnh được thực thi bên trong hộp cát trên máy cục bộ. Điều này yêu cầu tất cả các tệp đầu vào, phần phụ thuộc dữ liệu và công cụ đều phải được liệt kê dưới dạng phần phụ thuộc trực tiếp trong các thuộc tính srcs, data và tools. Bazel bật hộp cát cục bộ theo mặc định trên các hệ thống hỗ trợ thực thi hộp cát.
local khiến các lệnh được thực thi dưới dạng quy trình phụ cục bộ.
worker khiến các lệnh được thực thi bằng một worker liên tục (nếu có).
docker khiến các lệnh được thực thi bên trong hộp cát Docker trên máy cục bộ. Bạn phải cài đặt Docker.
remote khiến các lệnh được thực thi từ xa; tính năng này chỉ dùng được nếu trình thực thi từ xa đã được định cấu hình riêng.

`--strategy mnemonic=strategy`

Tuỳ chọn này kiểm soát vị trí và cách thức thực thi các lệnh, ghi đè --spawn_strategy (và --genrule_strategy bằng Gen quy tắc ghi nhớ) trên cơ sở từng ghi nhớ. Hãy xem --spawn_strategy để biết các chiến lược được hỗ trợ và hiệu quả của các chiến lược đó.

`--strategy_regexp=<filter,filter,...>=<strategy>`

Tuỳ chọn này chỉ định chiến lược nên dùng để thực thi các lệnh có nội dung mô tả khớp với một regex_filter nhất định. Hãy xem --per_file_copt để biết thông tin chi tiết về việc so khớp regex_filter. Hãy xem --spawn_strategy để biết các chiến lược được hỗ trợ và hiệu quả của các chiến lược đó.

regex_filter cuối cùng khớp với nội dung mô tả sẽ được sử dụng. Tuỳ chọn này sẽ ghi đè các cờ khác để chỉ định chiến lược.

Ví dụ: --strategy_regexp=//foo.*\\.cc,-//foo/bar=local có nghĩa là chạy các hành động sử dụng chiến lược local nếu nội dung mô tả của các hành động đó khớp với //foo.*.cc nhưng không khớp với //foo/bar.
Ví dụ: --strategy_regexp='Compiling.*/bar=local' --strategy_regexp=Compiling=sandboxed chạy "Biên dịch //foo/bar/baz" bằng chiến lược sandboxed nhưng đảo ngược thứ tự chạy phương thức này bằng local.
Ví dụ: --strategy_regexp='Compiling.*/bar=local,sandboxed' chạy "Biên dịch //foo/bar/baz" bằng chiến lược local và quay lại sandboxed nếu không thành công.

`--genrule_strategy=strategy`

Đây là cách viết tắt không dùng nữa cho --strategy=Genrule=strategy.

`--jobs=n` (-j)

Tuỳ chọn này (lấy một đối số số nguyên) để chỉ định giới hạn về số lượng công việc cần được thực thi đồng thời trong giai đoạn thực thi của bản dựng.

`--progress_report_interval=n`

Bazel định kỳ in báo cáo tiến trình về các công việc chưa hoàn tất (chẳng hạn như các kiểm thử chạy trong thời gian dài). Tuỳ chọn này sẽ đặt tần suất báo cáo, tiến trình sẽ được in n giây một lần.

Giá trị mặc định là 0, có nghĩa là một thuật toán gia tăng: báo cáo đầu tiên sẽ được in sau 10 giây, sau đó là 30 giây và sau đó tiến trình đó được báo cáo mỗi phút một lần.

Khi bazel đang sử dụng chế độ điều khiển con trỏ, như chỉ định bằng --curses, tiến trình sẽ được báo cáo mỗi giây.

`--local_{ram,cpu}_resources resources or resource expression`

Các tuỳ chọn này chỉ định dung lượng tài nguyên cục bộ (RAM tính bằng MB và số lõi logic của CPU) mà Bazel có thể xem xét khi lên lịch các hoạt động kiểm thử và bản dựng để chạy cục bộ. Chúng lấy một số nguyên hoặc một từ khoá (HOST_RAM hoặc HOST_CPUS) (không bắt buộc) theo sau là [-|*float] (ví dụ: --local_cpu_resources=2, --local_ram_resources=HOST_RAM*.5, --local_cpu_resources=HOST_CPUS-1). Các cờ này là độc lập; có thể đặt một hoặc cả hai cờ. Theo mặc định, Bazel ước tính dung lượng RAM và số lượng lõi CPU ngay trong cấu hình của hệ thống cục bộ.

`--[no]build_runfile_links`

Tuỳ chọn này (được bật theo mặc định) sẽ chỉ định xem có nên tạo các đường liên kết tượng trưng cho các chương trình kiểm thử và tệp nhị phân trong thư mục đầu ra hay không. Việc sử dụng --nobuild_runfile_links có thể giúp xác thực liệu tất cả các mục tiêu có biên dịch được mà không làm phát sinh chi phí khi tạo cây chạy tệp.

Khi các chương trình kiểm thử (hoặc ứng dụng) được thực thi, các phần phụ thuộc dữ liệu trong thời gian chạy sẽ được tập hợp ở cùng một nơi. Trong cây đầu ra của Bazel, cây "runfiles" này thường bắt nguồn từ tệp đồng cấp của tệp nhị phân hoặc kiểm thử tương ứng. Trong quá trình chạy kiểm thử, bạn có thể truy cập vào các tệp chạy bằng đường dẫn có dạng $TEST_SRCDIR/workspace/packagename/filename. Cây runfiles đảm bảo rằng các chương trình kiểm thử có quyền truy cập vào tất cả các tệp nếu có sự phụ thuộc đã khai báo và không có gì khác. Theo mặc định, cây runfile được triển khai bằng cách tạo một tập hợp các đường liên kết tượng trưng đến các tệp bắt buộc. Khi tập hợp các đường liên kết phát triển, chi phí của hoạt động này cũng tăng lên. Đối với một số bản dựng lớn, chi phí này có thể đóng góp đáng kể vào thời gian xây dựng tổng thể, đặc biệt là vì mỗi lượt kiểm thử (hoặc ứng dụng) riêng lẻ yêu cầu một cây tệp chạy riêng.

`--[no]build_runfile_manifests`

Tuỳ chọn này (được bật theo mặc định) sẽ chỉ định xem có nên ghi tệp kê khai của các tệp runfile vào cây đầu ra hay không. Khi tắt, thao tác này sẽ ngụ ý --nobuild_runfile_links.

Bạn có thể tắt tính năng này khi thực thi các chương trình kiểm thử từ xa, vì cây chạy tệp sẽ được tạo từ xa từ các tệp kê khai trong bộ nhớ.

`--[no]discard_analysis_cache`

Khi bật tuỳ chọn này, Bazel sẽ loại bỏ bộ nhớ đệm phân tích ngay trước khi quá trình thực thi bắt đầu, nhờ đó giải phóng thêm bộ nhớ (khoảng 10%) cho giai đoạn thực thi. Nhược điểm là các bản dựng tăng dần sẽ chậm hơn. Hãy xem thêm bài viết về chế độ tiết kiệm bộ nhớ.

`--[no]keep_going` (-k)

Như trong GNU Make, giai đoạn thực thi của một bản dựng sẽ dừng khi gặp lỗi đầu tiên. Đôi khi, bạn nên cố gắng xây dựng nhiều nhất có thể ngay cả khi xảy ra lỗi. Tuỳ chọn này cho phép hành vi đó và khi được chỉ định, bản dựng sẽ cố gắng tạo mọi mục tiêu có điều kiện tiên quyết đã được tạo thành công, nhưng sẽ bỏ qua các lỗi.

Mặc dù tuỳ chọn này thường liên kết với giai đoạn thực thi của một bản dựng, nhưng nó cũng ảnh hưởng đến giai đoạn phân tích: nếu một số mục tiêu được chỉ định trong một lệnh tạo, nhưng chỉ một số mục tiêu trong số đó có thể phân tích thành công, thì bản dựng sẽ dừng kèm theo lỗi trừ khi --keep_going được chỉ định. Trong trường hợp đó, bản dựng sẽ chuyển sang giai đoạn thực thi, nhưng chỉ dành cho các mục tiêu đã được phân tích thành công.

`--[no]use_ijars`

Tuỳ chọn này thay đổi cách Bazel biên dịch các mục tiêu java_library. Thay vì sử dụng kết quả của java_library để biên dịch các mục tiêu java_library phụ thuộc, Bazel sẽ tạo các tệp jar giao diện chỉ chứa chữ ký của các phương thức truy cập không riêng tư (phương thức và trường truy cập công khai, được bảo vệ và mặc định (gói)), đồng thời sử dụng các tệp giao diện để biên dịch các mục tiêu phụ thuộc. Điều này giúp bạn có thể tránh hoạt động biên dịch lại khi chỉ thực hiện thay đổi đối với phần nội dung phương thức hoặc các thành phần riêng tư của một lớp.

`--[no]interface_shared_objects`

Tuỳ chọn này bật đối tượng dùng chung về giao diện, khiến các tệp nhị phân và thư viện dùng chung khác phụ thuộc vào giao diện của một đối tượng dùng chung, thay vì cách triển khai của đối tượng đó. Khi chỉ có các thay đổi về cách triển khai, Bazel có thể tránh tạo lại các mục tiêu phụ thuộc vào thư viện dùng chung đã thay đổi một cách không cần thiết.

Lựa chọn đầu ra

Các tuỳ chọn này xác định nội dung cần tạo hoặc kiểm thử.

`--[no]build`

Tuỳ chọn này khiến giai đoạn thực thi của bản dựng diễn ra; tuỳ chọn này được bật theo mặc định. Khi bạn tắt chế độ này, giai đoạn thực thi sẽ bị bỏ qua và chỉ có hai giai đoạn đầu tiên (tải và phân tích) xảy ra.

Tuỳ chọn này có thể hữu ích cho việc xác thực các tệp BUILD và phát hiện lỗi trong dữ liệu đầu vào mà không thực sự tạo bất cứ thứ gì.

`--[no]build_tests_only`

Nếu được chỉ định, Bazel sẽ chỉ tạo những nội dung cần thiết để chạy các quy tắc *_test và test_suite không được lọc do kích thước, thời gian chờ, thẻ hoặc ngôn ngữ của chúng. Nếu được chỉ định, Bazel sẽ bỏ qua các mục tiêu khác được chỉ định trên dòng lệnh. Theo mặc định, tuỳ chọn này bị tắt và Bazel sẽ tạo mọi thứ được yêu cầu, bao gồm cả các quy tắc *_test và test_suite được lọc ra khỏi quá trình kiểm thử. Điều này hữu ích vì việc chạy bazel test --build_tests_only foo/... có thể không phát hiện được tất cả lỗi bản dựng trong cây foo.

`--[no]check_up_to_date`

Tuỳ chọn này khiến Bazel không thực hiện một bản dựng mà chỉ kiểm tra xem mọi mục tiêu được chỉ định đã được cập nhật hay chưa. Nếu có, quá trình tạo sẽ hoàn tất thành công như bình thường. Tuy nhiên, nếu có tệp nào đã lỗi thời thì thay vì được tạo, lỗi sẽ được báo cáo và bản dựng sẽ không thành công. Tuỳ chọn này có thể hữu ích khi xác định xem một bản dựng có được thực hiện gần đây hơn so với bản chỉnh sửa nguồn hay không (ví dụ: để kiểm tra trước khi gửi) mà không làm phát sinh chi phí cho bản dựng.

Xem thêm --check_tests_up_to_date.

`--[no]compile_one_dependency`

Biên dịch một phần phụ thuộc của các tệp đối số. Điều này rất hữu ích cho việc kiểm tra cú pháp các tệp nguồn trong IDE, chẳng hạn như bằng cách tạo lại một mục tiêu duy nhất phụ thuộc vào tệp nguồn để phát hiện lỗi sớm nhất có thể trong chu kỳ chỉnh sửa/xây dựng/kiểm thử. Đối số này ảnh hưởng đến cách diễn giải tất cả các đối số không gắn cờ: mỗi đối số phải là một nhãn đích tệp hoặc tên tệp thuần tuý so với thư mục đang hoạt động hiện tại, và một quy tắc phụ thuộc vào từng tên tệp nguồn được tạo. Cho

Nguồn C++ và Java, các quy tắc trong cùng không gian ngôn ngữ sẽ được ưu tiên chọn. Đối với nhiều quy tắc có cùng lựa chọn ưu tiên, quy tắc xuất hiện đầu tiên trong tệp XÂY DỰNG sẽ được chọn. Mẫu mục tiêu được đặt tên rõ ràng không tham chiếu đến tệp nguồn sẽ dẫn đến lỗi.

`--save_temps`

Tuỳ chọn --save_temps sẽ lưu các kết quả tạm thời từ trình biên dịch. Các tệp này bao gồm tệp .s (mã trình kết hợp), tệp .i (C đã xử lý trước) và .ii (đã xử lý trước C++). Những dữ liệu đầu ra này thường hữu ích khi gỡ lỗi. Nhiệt độ sẽ chỉ được tạo cho tập hợp các mục tiêu được chỉ định trên dòng lệnh.

Cờ --save_temps hiện chỉ hoạt động cho các quy tắc cc_*.

Để đảm bảo Bazel in vị trí của các tệp đầu ra bổ sung, hãy kiểm tra để đảm bảo chế độ cài đặt --show_result n của bạn đủ cao.

`--build_tag_filters=tag[,tag]*`

Nếu được chỉ định, Bazel sẽ chỉ tạo các mục tiêu có ít nhất một thẻ bắt buộc (nếu có bất kỳ thẻ nào được chỉ định) và không có bất kỳ thẻ bị loại trừ nào. Bộ lọc thẻ bản dựng được chỉ định dưới dạng danh sách các từ khoá thẻ được phân tách bằng dấu phẩy, có thể đứng trước ký hiệu '-' để biểu thị các thẻ bị loại trừ. Các thẻ bắt buộc cũng có thể có dấu '+' trước đó.

Khi chạy kiểm thử, Bazel bỏ qua --build_tag_filters cho các mục tiêu kiểm thử. Các mục tiêu này được tạo và chạy ngay cả khi chúng không khớp với bộ lọc này. Để tránh tạo các mục tiêu đó, hãy lọc các mục tiêu kiểm thử bằng cách sử dụng --test_tag_filters hoặc bằng cách loại trừ các mục tiêu đó một cách rõ ràng.

`--test_size_filters=size[,size]*`

Nếu được chỉ định, Bazel sẽ kiểm thử (hoặc tạo bản dựng nếu --build_tests_only cũng được chỉ định) chỉ kiểm thử các mục tiêu có kích thước nhất định. Bộ lọc kích thước kiểm thử được chỉ định dưới dạng danh sách được phân tách bằng dấu phẩy gồm các giá trị kích thước kiểm thử được phép (nhỏ, trung bình, lớn hoặc rất lớn), tuỳ ý đứng sau ký hiệu '-' dùng để biểu thị các kích thước kiểm thử bị loại trừ. Ví dụ:

  % bazel test --test_size_filters=small,medium //foo:all

và

  % bazel test --test_size_filters=-large,-enormous //foo:all

sẽ chỉ kiểm thử các chương trình kiểm thử nhỏ và trung bình bên trong //foo.

Theo mặc định, tính năng lọc kích thước thử nghiệm không được áp dụng.

`--test_timeout_filters=timeout[,timeout]*`

Nếu được chỉ định, Bazel sẽ kiểm thử (hoặc tạo bản dựng nếu --build_tests_only cũng được chỉ định) chỉ kiểm thử các mục tiêu với thời gian chờ nhất định. Bộ lọc thời gian chờ kiểm thử được chỉ định dưới dạng danh sách các giá trị thời gian chờ kiểm thử được phép được phân tách bằng dấu phẩy (ngắn, trung bình, dài hoặc vĩnh viễn), đứng trước dấu "-" (không bắt buộc) dùng để biểu thị thời gian chờ kiểm thử bị loại trừ. Hãy xem cú pháp --test_size_filters để biết ví dụ.

Theo mặc định, tính năng lọc hết thời gian thử nghiệm sẽ không được áp dụng.

`--test_tag_filters=tag[,tag]*`

Nếu được chỉ định, Bazel sẽ kiểm thử (hoặc tạo bản dựng nếu --build_tests_only cũng được chỉ định) chỉ kiểm thử các mục tiêu có ít nhất một thẻ bắt buộc (nếu có bất kỳ thẻ nào trong số đó được chỉ định) và không có thẻ bị loại trừ nào. Bộ lọc thẻ thử nghiệm được chỉ định dưới dạng danh sách các từ khoá thẻ được phân tách bằng dấu phẩy, có thể đứng trước ký hiệu '-' để biểu thị các thẻ bị loại trừ. Các thẻ bắt buộc cũng có thể có dấu '+' trước đó.

Ví dụ:

  % bazel test --test_tag_filters=performance,stress,-flaky //myproject:all

sẽ thử nghiệm các mục tiêu được gắn thẻ bằng thẻ performance hoặc stress nhưng không được gắn thẻ bằng thẻ flaky.

Theo mặc định, tính năng lọc thẻ thử nghiệm không được áp dụng. Xin lưu ý rằng bạn cũng có thể lọc trên các thẻ size và local của kiểm thử theo cách này.

`--test_lang_filters=lang[,lang]*`

Chỉ định danh sách ngôn ngữ kiểm thử được phân tách bằng dấu phẩy cho các ngôn ngữ có quy tắc *_test chính thức (xem tạo bách khoa toàn thư để biết danh sách đầy đủ các ngôn ngữ này). Mỗi ngôn ngữ có thể tuỳ ý đứng sau "-" để chỉ định các ngôn ngữ bị loại trừ. Tên dùng cho mỗi ngôn ngữ phải giống với tiền tố ngôn ngữ trong quy tắc *_test, ví dụ: cc, java hoặc sh.

Nếu được chỉ định, Bazel sẽ kiểm thử (hoặc tạo bản dựng nếu --build_tests_only cũng được chỉ định) chỉ kiểm thử các mục tiêu của(các) ngôn ngữ đã chỉ định.

Ví dụ:

  % bazel test --test_lang_filters=cc,java foo/...

sẽ chỉ kiểm thử các bài kiểm thử C/C++ và Java (được xác định bằng cách sử dụng các quy tắc cc_test và java_test tương ứng) trong foo/..., trong khi

  % bazel test --test_lang_filters=-sh,-java foo/...

sẽ chạy tất cả các chương trình kiểm thử trong foo/..., ngoại trừ các chương trình kiểm thử sh_test và java_test.

Theo mặc định, tính năng lọc ngôn ngữ thử nghiệm không được áp dụng.

`--test_filter=filter-expression`

Chỉ định một bộ lọc mà trình chạy kiểm thử có thể sử dụng để chọn một tập hợp con kiểm thử cần chạy. Tất cả các mục tiêu được chỉ định trong lệnh gọi đều được tạo, nhưng tuỳ thuộc vào biểu thức, chỉ một số mục tiêu có thể được thực thi; trong một số trường hợp, chỉ một số phương thức kiểm thử nhất định mới được chạy.

Cách diễn giải cụ thể của filter-expression tuỳ thuộc vào khung kiểm thử chịu trách nhiệm chạy kiểm thử. Đó có thể là một cụm cầu, chuỗi con hoặc biểu thức chính quy. --test_filter rất tiện lợi khi truyền các đối số bộ lọc --test_arg khác nhau, nhưng không phải khung nào cũng hỗ trợ mã này.

Độ chi tiết

Các tuỳ chọn này kiểm soát độ chi tiết của đầu ra của Bazel, đến thiết bị đầu cuối hoặc các tệp nhật ký bổ sung.

`--explain=logfile`

Tuỳ chọn này yêu cầu đối số tên tệp, khiến trình kiểm tra phần phụ thuộc trong giai đoạn thực thi của bazel build giải thích, cho mỗi bước tạo bản dựng, cho biết lý do thực thi hoặc đã cập nhật. Nội dung giải thích được ghi vào logfile.

Nếu bạn gặp phải tình trạng tạo lại không mong muốn, tuỳ chọn này có thể giúp bạn tìm hiểu lý do. Hãy thêm phương thức đó vào .bazelrc để việc ghi nhật ký xảy ra cho tất cả các bản dựng tiếp theo, sau đó kiểm tra nhật ký khi bạn thấy một bước thực thi được thực thi ngoài dự kiến. Tuỳ chọn này có thể gây ra một ảnh hưởng nhỏ về hiệu suất, vì vậy, bạn có thể muốn xoá tuỳ chọn khi không còn cần đến.

`--verbose_explanations`

Tuỳ chọn này làm tăng độ chi tiết của nội dung giải thích được tạo khi bật tuỳ chọn --giải thích.

Cụ thể, nếu bạn bật tính năng giải thích chi tiết và tạo lại tệp đầu ra do lệnh dùng để tạo tệp đã thay đổi, thì kết quả trong tệp giải thích sẽ bao gồm toàn bộ thông tin chi tiết của lệnh mới (ít nhất là đối với hầu hết các lệnh).

Việc sử dụng tuỳ chọn này có thể làm tăng đáng kể thời lượng của tệp giải thích đã tạo và mức giảm về hiệu suất khi sử dụng --explain.

Nếu bạn không bật --explain, thì --verbose_explanations sẽ không có hiệu lực.

`--profile=file`

Tuỳ chọn này lấy đối số tên tệp, khiến Bazel ghi dữ liệu phân tích tài nguyên vào một tệp. Sau đó, dữ liệu có thể được phân tích hoặc phân tích cú pháp bằng lệnh bazel analyze-profile. Hồ sơ Bản dựng có thể hữu ích trong việc hiểu được vị trí mà lệnh build của Bazel đang sử dụng thời gian đó.

`--[no]show_loading_progress`

Tuỳ chọn này khiến Bazel xuất ra các thông báo về tiến trình tải gói. Nếu chế độ cài đặt này bị tắt, các thông báo sẽ không hiển thị.

`--[no]show_progress`

Tuỳ chọn này hiển thị thông báo về tiến trình. Tuỳ chọn này được bật theo mặc định. Khi bạn tắt, thông báo tiến trình sẽ bị chặn.

`--show_progress_rate_limit=n`

Tuỳ chọn này khiến bazel hiển thị tối đa một thông báo tiến trình mỗi n giây, trong đó n là một số thực. Giá trị mặc định cho tuỳ chọn này là 0,02, nghĩa là bazel sẽ giới hạn các thông báo tiến trình thành một thông báo mỗi 0,02 giây.

`--show_result=n`

Tuỳ chọn này kiểm soát việc in thông tin kết quả ở cuối lệnh bazel build. Theo mặc định, nếu một mục tiêu bản dựng được chỉ định, Bazel sẽ in một thông báo cho biết mục tiêu có được cập nhật thành công hay không. Nếu có, danh sách các tệp đầu ra mà mục tiêu đã tạo. Nếu bạn chỉ định nhiều mục tiêu, thì thông tin kết quả sẽ không hiển thị.

Mặc dù thông tin kết quả có thể hữu ích cho các bản dựng chỉ có một mục tiêu hoặc một vài mục tiêu, nhưng đối với các bản dựng lớn (chẳng hạn như toàn bộ cây dự án cấp cao nhất), thông tin này có thể gây choáng ngợp và mất tập trung; tuỳ chọn này cho phép bạn kiểm soát thông tin này. --show_result lấy một đối số số nguyên. Đây là số lượng mục tiêu tối đa mà thông tin kết quả đầy đủ sẽ được in. Theo mặc định, giá trị là 1. Nếu vượt quá ngưỡng này, thì thông tin về kết quả sẽ không hiển thị cho từng mục tiêu riêng lẻ. Do đó, 0 khiến thông tin kết quả luôn bị chặn và giá trị rất lớn khiến kết quả luôn được in.

Người dùng có thể muốn chọn một giá trị ở giữa nếu họ thường xuyên thay thế giữa việc tạo một nhóm nhỏ mục tiêu (ví dụ: trong chu kỳ biên dịch-chỉnh sửa-kiểm thử) và một nhóm lớn các mục tiêu (ví dụ: khi thiết lập không gian làm việc mới hoặc chạy kiểm thử hồi quy). Trong trường hợp trước, thông tin kết quả sẽ rất hữu ích, còn trong trường hợp sau thì thông tin này ít hữu ích hơn. Giống như tất cả tuỳ chọn, bạn có thể chỉ định ngầm thông tin này thông qua tệp .bazelrc.

Các tệp được in để giúp bạn dễ dàng sao chép và dán tên tệp vào shell, để chạy các tệp thực thi đã tạo. Có thể dễ dàng phân tích cú pháp thông báo "cập nhật" hoặc "không thành công" cho từng mục tiêu bằng các tập lệnh thúc đẩy bản dựng.

`--sandbox_debug`

Tuỳ chọn này khiến Bazel in thêm thông tin gỡ lỗi khi sử dụng hộp cát để thực thi hành động. Tuỳ chọn này cũng giữ lại các thư mục hộp cát để bạn có thể kiểm tra các tệp hiển thị với các thao tác trong quá trình thực thi.

`--subcommands` (`-s`)

Tuỳ chọn này khiến giai đoạn thực thi của Bazel in dòng lệnh đầy đủ cho mỗi lệnh trước khi thực thi lệnh đó.

  >>>>> # //examples/cpp:hello-world [action 'Linking examples/cpp/hello-world']
  (cd /home/johndoe/.cache/bazel/_bazel_johndoe/4c084335afceb392cfbe7c31afee3a9f/bazel && \
    exec env - \
    /usr/bin/gcc -o bazel-out/local-fastbuild/bin/examples/cpp/hello-world -B/usr/bin/ -Wl,-z,relro,-z,now -no-canonical-prefixes -pass-exit-codes -Wl,-S -Wl,@bazel-out/local_linux-fastbuild/bin/examples/cpp/hello-world-2.params)

Nếu có thể, các lệnh sẽ được in theo cú pháp tương thích với shell Bourne để có thể dễ dàng sao chép và dán vào dấu nhắc lệnh shell. (Các dấu ngoặc đơn xung quanh được cung cấp để bảo vệ shell của bạn khỏi các lệnh gọi cd và exec; hãy nhớ sao chép chúng!) Tuy nhiên, một số lệnh được triển khai nội bộ trong Bazel, chẳng hạn như tạo cây liên kết tượng trưng. Không có dòng lệnh nào để hiển thị đối với những trường hợp này.

Bạn có thể truyền --subcommands=pretty_print để in các đối số của lệnh dưới dạng danh sách thay vì in một dòng đơn. Điều này có thể giúp các dòng lệnh dài dễ đọc hơn.

Hãy xem thêm --verbose_failures bên dưới.

Để ghi nhật ký các lệnh con vào một tệp ở định dạng phù hợp với công cụ, hãy xem --execution_log_json_file và --execution_log_binary_file.

`--verbose_failures`

Tuỳ chọn này khiến giai đoạn thực thi của Bazel in dòng lệnh đầy đủ đối với các lệnh không thực hiện được. Thao tác này có thể vô giá khi gỡ lỗi một bản dựng không thành công.

Các lệnh không đạt được in theo cú pháp tương thích với shell Bourne, phù hợp để sao chép và dán vào dấu nhắc lệnh shell.

Trạng thái Workspace

Sử dụng các tuỳ chọn sau để "đóng dấu" các tệp nhị phân do Bazel tạo: để nhúng thông tin bổ sung vào tệp nhị phân, chẳng hạn như bản sửa đổi kiểm soát nguồn hoặc thông tin khác liên quan đến không gian làm việc. Bạn có thể sử dụng cơ chế này với các quy tắc hỗ trợ thuộc tính stamp, chẳng hạn như genrule, cc_binary, v.v.

`--workspace_status_command=program`

Cờ này cho phép bạn chỉ định tệp nhị phân mà Bazel chạy trước mỗi bản dựng. Chương trình có thể báo cáo thông tin về trạng thái của không gian làm việc, chẳng hạn như bản sửa đổi kiểm soát nguồn hiện tại.

Giá trị của cờ phải là một đường dẫn đến một chương trình gốc. Trên Linux/macOS, đây có thể là bất kỳ tệp thực thi nào. Trên Windows, tệp này phải là tệp nhị phân gốc, thường là tệp ".exe", ".bat" hoặc tệp ".cmd".

Chương trình sẽ in không hoặc nhiều cặp giá trị/khoá thành đầu ra chuẩn, một mục nhập trên mỗi dòng, sau đó thoát bằng 0 (nếu không, bản dựng sẽ không hoạt động được). Tên khoá có thể là bất kỳ, nhưng chỉ được sử dụng chữ hoa và dấu gạch dưới. Dấu cách đầu tiên sau tên khoá phân tách khoá khỏi giá trị. Giá trị là phần còn lại của dòng (bao gồm cả khoảng trắng bổ sung). Cả khoá và giá trị đều không được kéo dài trên nhiều dòng. Các khoá không được trùng lặp.

Bazel phân vùng các khoá thành hai nhóm: "ổn định" và "tự tính toán lại". (Tên "ổn định" và "biến động" hơi khác thường, vì vậy, đừng nghĩ nhiều về chúng.)

Sau đó, Bazel ghi các cặp khoá-giá trị thành 2 tệp:

bazel-out/stable-status.txt chứa tất cả các khoá và giá trị mà tên khoá bắt đầu bằng STABLE_
bazel-out/volatile-status.txt chứa các khoá còn lại và giá trị của các khoá đó

Hợp đồng này là:

các giá trị của khoá "ổn định" hiếm khi thay đổi, nếu có thể. Nếu nội dung của bazel-out/stable-status.txt thay đổi, Bazel sẽ vô hiệu hoá các hành động phụ thuộc vào những nội dung đó. Nói cách khác, nếu giá trị của một khoá ổn định thay đổi, Bazel sẽ chạy lại các thao tác được đóng dấu. Do đó, trạng thái ổn định không được chứa những nội dung như dấu thời gian vì chúng luôn thay đổi và sẽ khiến Bazel chạy lại các thao tác được đóng dấu trên mỗi bản dựng.

Bazel luôn xuất ra các khoá ổn định sau đây:
- BUILD_EMBED_LABEL: giá trị của --embed_label
- BUILD_HOST: tên của máy chủ lưu trữ mà Bazel đang chạy
- BUILD_USER: tên người dùng mà Bazel đang sử dụng
giá trị của khoá "volatile" có thể thay đổi thường xuyên. Bazel muốn họ luôn thay đổi, giống như dấu thời gian và cập nhật hợp lý tệp bazel-out/volatile-status.txt. Để tránh luôn chạy lại các thao tác được đóng dấu, Bazel giả vờ rằng tệp tự tính toán lại không bao giờ thay đổi. Nói cách khác, nếu tệp trạng thái tự tính toán lại là tệp duy nhất có nội dung thay đổi, thì Bazel sẽ không vô hiệu hoá những hành động phụ thuộc vào tệp đó. Nếu các dữ liệu đầu vào khác của hành động đã thay đổi, thì Bazel sẽ chạy lại hành động đó và hành động đó sẽ thấy trạng thái tự tính toán lại được cập nhật. Tuy nhiên, việc chỉ thay đổi trạng thái tự tính toán lại sẽ không vô hiệu hoá hành động.

Bazel luôn xuất ra các khoá tự tính toán lại sau đây:
- BUILD_TIMESTAMP: thời gian tạo bản dựng tính bằng giây kể từ Unix Epoch (giá trị của System.currentTimeMillis() chia cho một nghìn)
- FORMATTED_DATE: thời gian của bản dựng Được định dạng là yyyy MMM d HH mm ss EEE(ví dụ: ngày 2 tháng 6 năm 2023, ngày 1 tháng 6 năm 2023, thứ Sáu) theo giờ UTC.

Trên Linux/macOS, bạn có thể truyền --workspace_status_command=/bin/true để tắt tính năng truy xuất trạng thái không gian làm việc vì true không làm gì cả (thoát bằng 0) và không in ra kết quả nào. Trên Windows, bạn có thể truyền đường dẫn của true.exe của MSYS để có hiệu quả tương tự.

Nếu lệnh trạng thái không gian làm việc không thành công (thoát khác 0) vì bất kỳ lý do gì, bản dựng sẽ không thành công.

Chương trình mẫu trên Linux sử dụng Git:

#!/bin/bash
echo "CURRENT_TIME $(date +%s)"
echo "RANDOM_HASH $(cat /proc/sys/kernel/random/uuid)"
echo "STABLE_GIT_COMMIT $(git rev-parse HEAD)"
echo "STABLE_USER_NAME $USER"

Truyền đường dẫn của chương trình này bằng --workspace_status_command và tệp trạng thái ổn định sẽ bao gồm các dòng ỔN ĐỊNH, còn tệp trạng thái biến động sẽ bao gồm các dòng còn lại.

`--[no]stamp`

Tuỳ chọn này, cùng với thuộc tính quy tắc stamp, kiểm soát việc có nhúng thông tin bản dựng trong tệp nhị phân hay không.

Bạn có thể bật hoặc tắt tính năng đóng dấu một cách rõ ràng theo từng quy tắc bằng cách sử dụng thuộc tính stamp. Vui lòng tham khảo Bách khoa toàn thư về xây dựng để biết chi tiết. Khi một quy tắc đặt stamp = -1 (mặc định cho các quy tắc *_binary), tuỳ chọn này sẽ xác định xem có bật tính năng đóng dấu hay không.

Bazel không bao giờ đánh dấu các tệp nhị phân được tạo cho cấu hình máy chủ lưu trữ, bất kể tuỳ chọn này hay thuộc tính stamp. Đối với các quy tắc đặt stamp = 0 (mặc định cho các quy tắc *_test), dấu sẽ bị tắt bất kể --[no]stamp là gì. Việc chỉ định --stamp sẽ không buộc các mục tiêu phải tạo lại nếu các phần phụ thuộc của chúng không thay đổi.

Nhìn chung, bạn nên đặt --nostamp để cải thiện hiệu suất của bản dựng, vì chế độ này làm giảm sự biến động đầu vào và tối đa hoá việc lưu vào bộ nhớ đệm của bản dựng.

Nền tảng

Hãy sử dụng các tuỳ chọn này để kiểm soát những nền tảng lưu trữ và nền tảng đích giúp định cấu hình cách hoạt động của các bản dựng, cũng như để kiểm soát những nền tảng thực thi và chuỗi công cụ có sẵn cho các quy tắc Bazel.

Vui lòng xem thông tin cơ bản về Nền tảng và Chuỗi công cụ.

`--platforms=labels`

Nhãn của các quy tắc nền tảng mô tả các nền tảng mục tiêu cho lệnh hiện tại.

`--host_platform=label`

Nhãn của một quy tắc nền tảng mô tả hệ thống lưu trữ.

`--extra_execution_platforms=labels`

Các nền tảng có sẵn dưới dạng nền tảng thực thi để chạy các hành động. Bạn có thể chỉ định nền tảng theo mục tiêu chính xác hoặc dưới dạng mẫu mục tiêu. Các nền tảng này sẽ được xem xét trước những nền tảng được khai báo trong tệp WORKSPACE bằng register_execution_platforms().

`--extra_toolchains=labels`

Các quy tắc chuỗi công cụ cần được xem xét trong quá trình phân giải chuỗi công cụ. Bạn có thể chỉ định chuỗi công cụ theo mục tiêu chính xác hoặc dưới dạng mẫu mục tiêu. Các chuỗi công cụ này sẽ được xem xét trước các chuỗi công cụ được khai báo trong tệp WORKSPACE bằng register_toolchains().

`--toolchain_resolution_debug=regex`

In thông tin gỡ lỗi trong khi tìm chuỗi công cụ nếu loại chuỗi công cụ khớp với biểu thức chính quy. Bạn có thể phân tách nhiều biểu thức chính quy bằng dấu phẩy. Bạn có thể phủ định biểu thức chính quy bằng cách sử dụng - ở đầu. Điều này có thể giúp các nhà phát triển quy tắc Bazel hoặc Starlark gặp lỗi gỡ lỗi do thiếu chuỗi công cụ.

Khác

`--flag_alias=alias_name=target_path`

Một cờ tiện lợi dùng để liên kết chế độ cài đặt bản dựng Starlark dài hơn với một tên ngắn hơn. Để biết thêm thông tin chi tiết, hãy xem Cấu hình Starlark.

`--symlink_prefix=string`

Thay đổi tiền tố của đường liên kết tượng trưng tiện lợi đã tạo. Giá trị mặc định cho tiền tố đường liên kết tượng trưng là bazel-. Giá trị này sẽ tạo các liên kết tượng trưng bazel-bin, bazel-testlogs và bazel-genfiles.

Nếu không thể tạo đường liên kết tượng trưng vì bất kỳ lý do gì, hệ thống sẽ đưa ra cảnh báo nhưng bản dựng vẫn được coi là thành công. Cụ thể, điều này cho phép bạn tạo trong một thư mục chỉ đọc hoặc một thư mục mà bạn không có quyền ghi vào đó. Mọi đường dẫn được in trong thông báo thông tin ở cuối quá trình tạo bản dựng sẽ chỉ sử dụng dạng ngắn tương đối liên kết tượng trưng nếu các đường liên kết tượng trưng trỏ đến vị trí dự kiến; nói cách khác, bạn có thể dựa vào độ chính xác của các đường dẫn đó, ngay cả khi bạn không thể dựa vào các đường liên kết tượng trưng đang được tạo.

Một số giá trị phổ biến của lựa chọn này:

Chặn việc tạo đường liên kết tượng trưng: --symlink_prefix=/ sẽ khiến Bazel không tạo hoặc cập nhật bất kỳ đường liên kết tượng trưng nào, bao gồm cả các đường liên kết tượng trưng bazel-out và bazel-<workspace>. Sử dụng chế độ này để chặn hoàn toàn việc tạo đường liên kết tượng trưng.
Giảm tình trạng lộn xộn: --symlink_prefix=.bazel/ sẽ khiến Bazel tạo các đường liên kết tượng trưng có tên bin (v.v.) bên trong một thư mục ẩn .bazel.

`--platform_suffix=string`

Thêm một hậu tố vào tên ngắn của cấu hình, dùng để xác định thư mục đầu ra. Việc đặt tuỳ chọn này thành các giá trị khác nhau sẽ đặt các tệp vào nhiều thư mục khác nhau, chẳng hạn như để cải thiện tỷ lệ truy cập vào bộ nhớ đệm cho các bản dựng nếu có thể sao chép các tệp đầu ra khác nhau hoặc để giữ lại các tệp đầu ra để so sánh.

`--default_visibility=(private|public)`

Cờ tạm thời để kiểm thử các thay đổi về chế độ hiển thị mặc định của bazel. Không nhằm mục đích sử dụng chung nhưng được ghi lại nhằm mục đích cung cấp đầy đủ thông tin.

`--[no]use_action_cache`

Tuỳ chọn này được bật theo mặc định. Nếu bạn tắt chính sách này, Bazel sẽ không sử dụng bộ nhớ đệm thao tác cục bộ. Việc tắt bộ nhớ đệm thao tác cục bộ sẽ giúp tiết kiệm bộ nhớ và dung lượng ổ đĩa cho các bản dựng sạch, nhưng sẽ làm cho các bản dựng gia tăng chậm hơn.

`--starlark_cpu_profile=_file_`

Cờ này (có giá trị là tên của một tệp) khiến Bazel thu thập số liệu thống kê về mức sử dụng CPU của tất cả các luồng Starlark và ghi hồ sơ (ở định dạng pprof) vào tệp được đặt tên.

Sử dụng tuỳ chọn này để giúp xác định các hàm Starlark khiến quá trình tải và phân tích bị chậm do tính toán quá mức. Ví dụ:

$ bazel build --nobuild --starlark_cpu_profile=/tmp/pprof.gz my/project/...
$ pprof /tmp/pprof.gz
(pprof) top
Type: CPU
Time: Feb 6, 2020 at 12:06pm (PST)
Duration: 5.26s, Total samples = 3.34s (63.55%)
Showing nodes accounting for 3.34s, 100% of 3.34s total
      flat  flat%   sum%        cum   cum%
     1.86s 55.69% 55.69%      1.86s 55.69%  sort_source_files
     1.02s 30.54% 86.23%      1.02s 30.54%  expand_all_combinations
     0.44s 13.17% 99.40%      0.44s 13.17%  range
     0.02s   0.6%   100%      3.34s   100%  sorted
         0     0%   100%      1.38s 41.32%  my/project/main/BUILD
         0     0%   100%      1.96s 58.68%  my/project/library.bzl
         0     0%   100%      3.34s   100%  main

Đối với nhiều chế độ xem của cùng một dữ liệu, hãy thử các lệnh pprof svg, web và list.

Sử dụng Bazel để phát hành

Bazel được cả các kỹ sư phần mềm sử dụng trong chu kỳ phát triển và các kỹ sư phát hành khi chuẩn bị tệp nhị phân để triển khai cho giai đoạn phát hành chính thức. Phần này cung cấp danh sách các mẹo dành cho kỹ sư phát hành sử dụng Bazel.

Lựa chọn quan trọng

Khi sử dụng Bazel cho các bản phát hành, các vấn đề tương tự phát sinh như các tập lệnh khác thực hiện bản dựng. Để biết thêm thông tin, hãy xem phần Gọi cho Bazel từ tập lệnh. Cụ thể, bạn nên thực hiện các lựa chọn sau:

Các tuỳ chọn này cũng quan trọng:

--package_path
--symlink_prefix: để quản lý các bản dựng cho nhiều cấu hình, bạn nên phân biệt từng bản dựng bằng một giá trị nhận dạng riêng biệt, chẳng hạn như "64 bit" so với "32 bit". Tuỳ chọn này sẽ phân biệt các liên kết tượng trưng bazel-bin (v.v.).

Đang chạy kiểm thử

Để tạo và chạy kiểm thử bằng bazel, hãy nhập bazel test theo sau là tên của mục tiêu kiểm thử.

Theo mặc định, lệnh này thực hiện đồng thời hoạt động tạo và kiểm thử, tạo tất cả mục tiêu được chỉ định (bao gồm mọi mục tiêu không kiểm thử được chỉ định trên dòng lệnh) và kiểm thử các mục tiêu *_test và test_suite ngay khi điều kiện tiên quyết được tạo, nghĩa là quá trình thực thi kiểm thử được xen kẽ với bản dựng. Việc này thường giúp tăng đáng kể tốc độ.

Tuỳ chọn cho `bazel test`

`--cache_test_results=(yes|no|auto)` (`-t`)

Nếu bạn đặt tuỳ chọn này thành "auto" (mặc định), thì Bazel sẽ chỉ chạy lại hoạt động kiểm thử nếu bất kỳ điều kiện nào sau đây xảy ra:

Bazel phát hiện các thay đổi trong kiểm thử hoặc các phần phụ thuộc của kiểm thử
kiểm thử được đánh dấu là external
đã yêu cầu nhiều lần chạy kiểm thử với --runs_per_test
kiểm thử không thành công.

Nếu là "không", tất cả các lượt kiểm thử sẽ được thực thi vô điều kiện.

Nếu "yes" (có), hành vi lưu vào bộ nhớ đệm sẽ giống như tự động, ngoại trừ việc có thể lưu các lần kiểm thử thất bại vào bộ nhớ đệm và các lượt chạy kiểm thử bằng --runs_per_test.

Người dùng đã bật tuỳ chọn này theo mặc định trong tệp .bazelrc của họ có thể thấy các chữ viết tắt -t (bật) hoặc -t- (tắt) thuận tiện cho việc ghi đè giá trị mặc định trong một lần chạy cụ thể.

`--check_tests_up_to_date`

Tuỳ chọn này yêu cầu Bazel không chạy kiểm thử mà chỉ kiểm tra và báo cáo kết quả kiểm thử đã lưu vào bộ nhớ đệm. Nếu có bất kỳ chương trình kiểm thử nào chưa được tạo và chạy trước đó hoặc kết quả kiểm thử đã lỗi thời (ví dụ: vì mã nguồn hoặc các tuỳ chọn bản dựng đã thay đổi), thì Bazel sẽ báo cáo một thông báo lỗi ("kết quả kiểm thử không cập nhật"), sẽ ghi lại trạng thái của kiểm thử là "NO STATUS" (màu đỏ, nếu kết quả màu được bật) và sẽ trả về một mã thoát khác 0.

Tuỳ chọn này cũng ngụ ý hành vi của [--check_up_to_date](#check-up-to-date).

Lựa chọn này có thể hữu ích cho các bước kiểm tra trước khi gửi.

`--test_verbose_timeout_warnings`

Tuỳ chọn này yêu cầu Bazel cảnh báo rõ ràng cho người dùng nếu thời gian chờ của chương trình kiểm thử lâu hơn đáng kể so với thời gian thực thi thực tế của chương trình kiểm thử. Mặc dù thời gian chờ của bài kiểm thử phải được đặt sao cho không bị gián đoạn, nhưng bài kiểm thử có thời gian chờ quá mức có thể ẩn các sự cố thực xảy ra ngoài dự kiến.

Ví dụ: một chương trình kiểm thử thường thực thi trong một hoặc hai phút không nên có thời gian chờ là ETERNAL hoặc LONG vì như vậy là quá tốn thời gian.

Tuỳ chọn này rất hữu ích trong việc giúp người dùng quyết định giá trị thời gian chờ phù hợp hoặc giá trị kiểm tra tính hợp lý hiện có.

`--[no]test_keep_going`

Theo mặc định, tất cả các kiểm thử đều chạy đến khi hoàn tất. Tuy nhiên, nếu cờ này bị tắt, thì bản dựng sẽ bị huỷ trong mọi hoạt động kiểm thử không vượt qua. Các bước xây dựng và lệnh gọi kiểm thử tiếp theo sẽ không được chạy và các lệnh gọi đang trong quá trình sẽ bị huỷ. Không chỉ định cả --notest_keep_going và --keep_going.

`--flaky_test_attempts=attempts`

Tuỳ chọn này chỉ định số lần thử nghiệm tối đa nếu không thành công vì bất kỳ lý do gì. Kiểm thử ban đầu không thành công nhưng cuối cùng thành công được báo cáo là FLAKY trong phần tóm tắt kiểm thử. Tuy nhiên, hàm này được coi là được truyền khi xác định mã thoát Bazel hoặc tổng số kiểm thử đã vượt qua. Những kiểm thử không đạt ở tất cả các lần được phép sẽ được coi là không thành công.

Theo mặc định (khi tuỳ chọn này không được chỉ định hoặc khi tuỳ chọn này được đặt thành mặc định), chỉ các lần kiểm thử thông thường được phép thực hiện và 3 lần đối với các quy tắc kiểm thử đã đặt thuộc tính flaky. Bạn có thể chỉ định một giá trị số nguyên để ghi đè giới hạn tối đa về số lần thử kiểm thử. Bazel cho phép tối đa 10 lượt kiểm thử để ngăn chặn hành vi sử dụng hệ thống sai mục đích.

`--runs_per_test=[regex@]number`

Tuỳ chọn này chỉ định số lần thực thi mỗi bài kiểm thử. Tất cả các lượt chạy kiểm thử được coi là kiểm thử riêng biệt (chức năng dự phòng sẽ áp dụng độc lập cho từng lượt kiểm thử).

Trạng thái của một mục tiêu không chạy được phụ thuộc vào giá trị của cờ --runs_per_test_detects_flakes:

Nếu không có, thì mọi lần chạy không thành công đều khiến toàn bộ quy trình kiểm thử không thành công.
Nếu có và 2 lần chạy từ cùng một phân đoạn trả về PASS và FAIL, thì quá trình kiểm thử sẽ nhận được trạng thái không ổn định (trừ phi các lần chạy không thành công khác khiến kiểm thử không thành công).

Nếu bạn chỉ định một số duy nhất, thì tất cả các lượt kiểm thử sẽ chạy nhiều lần như vậy. Ngoài ra, bạn có thể chỉ định một biểu thức chính quy bằng cú pháp regex@number. Thao tác này ràng buộc tác động của --runs_per_test đối với các mục tiêu khớp với biểu thức chính quy (--runs_per_test=^//pizza:.*@4 chạy tất cả các kiểm thử dưới //pizza/ 4 lần). Bạn có thể chỉ định biểu mẫu --runs_per_test này nhiều lần.

`--[no]runs_per_test_detects_flakes`

Nếu tuỳ chọn này được chỉ định (theo mặc định, không được làm), Bazel sẽ phát hiện các phân đoạn kiểm thử không ổn định thông qua --runs_per_test. Nếu một hoặc nhiều lượt chạy cho một phân đoạn không thành công và một hoặc nhiều lần chạy cho cùng một phân đoạn, thì mục tiêu sẽ được coi là không ổn định với cờ này. Nếu chưa chỉ định, mục tiêu sẽ báo cáo trạng thái không đạt.

`--test_summary=output_style`

Chỉ định cách hiển thị bản tóm tắt kết quả kiểm thử.

short in kết quả của mỗi lần kiểm thử cùng với tên của tệp chứa kết quả kiểm thử nếu kiểm thử không thành công. Đây là giá trị mặc định.
terse giống như short, nhưng còn ngắn hơn nữa: chỉ in thông tin về các lượt kiểm thử không đạt.
detailed in từng trường hợp kiểm thử không thành công, không chỉ mỗi trường hợp kiểm thử. Tên của các tệp đầu ra kiểm thử bị bỏ qua.
none không in bản tóm tắt kiểm thử.

`--test_output=output_style`

Chỉ định cách hiển thị đầu ra kiểm thử:

summary hiển thị thông tin tóm tắt về việc từng kiểm thử đạt hay không đạt. Đồng thời cho biết tên tệp nhật ký đầu ra của các lượt kiểm thử không thành công. Bản tóm tắt sẽ được in ở cuối quá trình tạo bản dựng (trong quá trình tạo bản dựng, bạn sẽ chỉ thấy các thông báo tiến trình đơn giản khi quá trình kiểm thử bắt đầu, đạt hoặc không đạt). Đây là hành vi mặc định.
errors chỉ gửi đầu ra stdout/stderr kết hợp từ các lượt kiểm thử không thành công tới stdout ngay sau khi kiểm thử xong, đảm bảo rằng đầu ra kiểm thử từ các lượt kiểm thử đồng thời không xen kẽ với nhau. In một bản tóm tắt tại bản dựng theo kết quả tóm tắt ở trên.
all tương tự như errors nhưng in kết quả cho tất cả các kiểm thử, bao gồm cả những kiểm thử đã đạt.
streamed truyền trực tuyến đầu ra stdout/stderr từ mỗi lần kiểm thử theo thời gian thực.

`--java_debug`

Tuỳ chọn này khiến máy ảo Java của một chương trình kiểm thử java phải chờ kết nối từ trình gỡ lỗi tuân thủ JDK trước khi bắt đầu kiểm thử. Tuỳ chọn này ngụ ý --test_output=streamed.

`--[no]verbose_test_summary`

Theo mặc định, tuỳ chọn này được bật, khiến thời gian kiểm thử và các thông tin bổ sung khác (chẳng hạn như các lượt kiểm thử) được in vào bản tóm tắt kiểm thử. Nếu bạn chỉ định --noverbose_test_summary, thì nội dung tóm tắt kiểm thử sẽ chỉ bao gồm tên kiểm thử, trạng thái kiểm thử và chỉ báo kiểm thử được lưu vào bộ nhớ đệm, đồng thời sẽ được định dạng để không vượt quá 80 ký tự (nếu có thể).

`--test_tmpdir=path`

Chỉ định thư mục tạm thời cho các chương trình kiểm thử được thực thi cục bộ. Mỗi lượt kiểm thử sẽ được thực thi trong một thư mục con riêng biệt bên trong thư mục này. Thư mục này sẽ được xoá ở đầu mỗi lệnh bazel test. Theo mặc định, bazel sẽ đặt thư mục này trong thư mục cơ sở đầu ra Bazel.

`--test_timeout=seconds` HOẶC `--test_timeout=seconds,seconds,seconds,seconds`

Ghi đè giá trị thời gian chờ cho tất cả các lượt kiểm thử bằng cách sử dụng số giây đã chỉ định làm giá trị thời gian chờ mới. Nếu bạn chỉ cung cấp một giá trị, thì giá trị đó sẽ được dùng cho tất cả các danh mục thời gian chờ kiểm thử.

Ngoài ra, bạn có thể cung cấp 4 giá trị phân tách bằng dấu phẩy, chỉ định thời gian chờ riêng lẻ cho các kiểm thử ngắn, trung bình, dài và vĩnh viễn (theo thứ tự đó). Ở cả hai dạng, giá trị 0 hoặc giá trị âm cho bất kỳ kích thước kiểm thử nào cũng sẽ được thay thế bằng thời gian chờ mặc định cho các danh mục thời gian chờ nhất định như được xác định trên trang Viết bài kiểm thử. Theo mặc định, Bazel sẽ sử dụng các thời gian chờ này cho tất cả các lần kiểm thử bằng cách suy ra giới hạn thời gian chờ từ kích thước của quy trình kiểm thử, cho dù kích thước đó được đặt ngầm hay rõ ràng.

Các bài kiểm thử nêu rõ danh mục thời gian chờ khác với kích thước sẽ nhận được cùng một giá trị như thể thời gian chờ đó đã được thẻ kích thước ngầm đặt. Vì vậy, kiểm thử có kích thước "nhỏ" khai báo thời gian chờ "dài" sẽ có cùng thời gian chờ hiệu quả như kiểm thử "lớn" không có thời gian chờ rõ ràng.

`--test_arg=arg`

Truyền các tuỳ chọn/cờ/đối số dòng lệnh cho từng quy trình kiểm thử. Bạn có thể sử dụng tuỳ chọn này nhiều lần để truyền một số đối số. Ví dụ: --test_arg=--logtostderr --test_arg=--v=3.

`--test_env=variable=_value_` HOẶC `--test_env=variable`

Chỉ định các biến bổ sung phải được chèn vào môi trường kiểm thử cho mỗi lần kiểm thử. Nếu bạn không chỉ định value, thì lệnh này sẽ được kế thừa từ môi trường shell dùng để khởi động lệnh bazel test.

Bạn có thể truy cập vào môi trường từ trong một kiểm thử bằng cách sử dụng System.getenv("var") (Java), getenv("var") (C hoặc C++),

`--run_under=command-prefix`

Thao tác này chỉ định một tiền tố mà trình chạy kiểm thử sẽ chèn vào trước lệnh kiểm thử trước khi chạy. command-prefix được chia thành các từ bằng cách sử dụng các quy tắc mã thông báo shell Bourne, sau đó danh sách các từ sẽ được thêm vào trước lệnh sẽ thực thi.

Nếu từ đầu tiên là một nhãn đủ điều kiện (bắt đầu bằng //), thì nhãn đó sẽ được tạo. Sau đó, nhãn sẽ được thay thế bằng vị trí thực thi tương ứng được thêm vào trước lệnh sẽ được thực thi cùng với các từ khác.

Bạn cần lưu ý một số điều sau:

PATH dùng để chạy kiểm thử có thể khác với PATH trong môi trường của bạn, vì vậy, bạn có thể cần phải sử dụng đường dẫn tuyệt đối cho lệnh --run_under (từ đầu tiên trong command-prefix).
stdin chưa được kết nối nên bạn không thể sử dụng --run_under cho các lệnh tương tác.

Ví dụ:

        --run_under=/usr/bin/strace
        --run_under='/usr/bin/strace -c'
        --run_under=/usr/bin/valgrind
        --run_under='/usr/bin/valgrind --quiet --num-callers=20'

Kiểm thử lựa chọn

Như đã nêu trong phần Lựa chọn đầu ra, bạn có thể lọc các bài kiểm thử theo kích thước, thời gian chờ, thẻ hoặc ngôn ngữ. Bộ lọc tên chung tiện lợi có thể chuyển tiếp đối số bộ lọc cụ thể đến trình chạy kiểm thử.

Các lựa chọn khác cho `bazel test`

Cú pháp và các tuỳ chọn còn lại giống hệt như bazel build.

Đang chạy tệp thực thi

Lệnh bazel run tương tự như bazel build, ngoại trừ việc dùng để tạo và chạy một mục tiêu duy nhất. Dưới đây là một phiên điển hình:

  % bazel run java/myapp:myapp -- --arg1 --arg2
  Welcome to Bazel
  INFO: Loading package: java/myapp
  INFO: Loading package: foo/bar
  INFO: Loading complete.  Analyzing...
  INFO: Found 1 target...
  ...
  Target //java/myapp:myapp up-to-date:
    bazel-bin/java/myapp:myapp
  INFO: Elapsed time: 0.638s, Critical Path: 0.34s

  INFO: Running command line: bazel-bin/java/myapp:myapp --arg1 --arg2
  Hello there
  $EXEC_ROOT/java/myapp/myapp
  --arg1
  --arg2

bazel run tương tự nhưng không giống hệt nhau, trong việc gọi trực tiếp tệp nhị phân do Bazel tạo và hành vi của tệp này cũng khác nhau tuỳ thuộc vào việc tệp nhị phân được gọi có phải là một phép kiểm thử hay không.

Khi tệp nhị phân không phải là một bài kiểm thử, thư mục đang hoạt động hiện tại sẽ là cây runfile của tệp nhị phân đó.

Khi tệp nhị phân là một kiểm thử, thư mục đang hoạt động hiện tại sẽ là gốc thực thi và thành thực cố gắng để sao chép các kiểm thử môi trường thường được chạy. Tuy nhiên, quá trình mô phỏng chưa hoàn hảo và không thể chạy các chương trình kiểm thử có nhiều phân đoạn theo cách này (bạn có thể dùng tuỳ chọn dòng lệnh --test_sharding_strategy=disabled để giải quyết vấn đề này)

Các biến môi trường bổ sung sau đây cũng có sẵn cho tệp nhị phân:

BUILD_WORKSPACE_DIRECTORY: gốc của không gian làm việc nơi bản dựng được chạy.
BUILD_WORKING_DIRECTORY: thư mục hoạt động hiện tại nơi Baazel chạy từ đó.

Bạn có thể sử dụng các trình xử lý này, chẳng hạn như để diễn giải tên tệp trên dòng lệnh theo cách thân thiện với người dùng.

Tuỳ chọn cho `bazel run`

`--run_under=command-prefix`

Lựa chọn này có tác dụng tương tự như tuỳ chọn --run_under cho bazel test (xem ở trên), ngoại trừ việc tuỳ chọn này áp dụng cho lệnh do bazel run chạy thay vì các bài kiểm thử do bazel test chạy và không thể chạy trong nhãn.

Lọc kết quả ghi nhật ký từ Bazel

Khi gọi một tệp nhị phân bằng bazel run, Bazel sẽ in kết quả ghi nhật ký từ chính Bazel và tệp nhị phân trong lệnh gọi. Để nhật ký ít nhiễu hơn, bạn có thể chặn kết quả từ chính Bazel bằng cờ --ui_event_filters và --noshow_progress.

Ví dụ: bazel run --ui_event_filters=-info,-stdout,-stderr --noshow_progress //java/myapp:myapp

Thực thi kiểm thử

bazel run cũng có thể thực thi các tệp nhị phân kiểm thử. Việc này có tác dụng chạy kiểm thử trong một khoảng gần đúng môi trường được mô tả trong phần Viết bài kiểm thử. Lưu ý rằng không có đối số --test_* nào có hiệu lực khi chạy kiểm thử theo cách này, ngoại trừ --test_arg .

Dọn dẹp dữ liệu đầu ra của bản dựng

Lệnh `clean`

Bazel có một lệnh clean, tương tự như lệnh của Make. Thao tác này sẽ xoá các thư mục đầu ra cho tất cả cấu hình bản dựng do thực thể Bazel này thực hiện hoặc toàn bộ cây làm việc do thực thể Bazel này tạo và đặt lại bộ nhớ đệm nội bộ. Nếu được thực thi mà không có tuỳ chọn dòng lệnh nào, thì thư mục đầu ra cho tất cả cấu hình sẽ bị xoá.

Hãy nhớ rằng mỗi thực thể Bazel được liên kết với một không gian làm việc duy nhất, do đó lệnh clean sẽ xoá tất cả kết quả của mọi bản dựng mà bạn đã thực hiện với thực thể Bazel đó trong không gian làm việc đó.

Để xoá hoàn toàn toàn bộ cây hoạt động do một thực thể Bazel tạo, bạn có thể chỉ định tuỳ chọn --expunge. Khi được thực thi bằng --expunge, lệnh sạch chỉ cần xoá toàn bộ cây cơ sở đầu ra, ngoài kết quả của bản dựng, còn chứa tất cả các tệp tạm thời do Bazel tạo ra. Thao tác này cũng dừng máy chủ Bazel sau khi dọn dẹp, tương đương với lệnh shutdown. Ví dụ: để dọn dẹp tất cả dấu vết ổ đĩa và bộ nhớ của một thực thể Bazel, bạn có thể chỉ định:

  % bazel clean --expunge

Ngoài ra, bạn có thể dọn sạch trong nền bằng cách sử dụng --expunge_async. Bạn có thể yên tâm gọi lệnh Bazel trong cùng một ứng dụng khách trong khi quá trình dọn sạch không đồng bộ vẫn tiếp tục chạy.

Lệnh clean được cung cấp chủ yếu để phục hồi dung lượng ổ đĩa cho các không gian làm việc không còn cần thiết. Các bản dựng lại gia tăng của Bazel có thể không hoàn hảo, vì vậy, bạn có thể dùng clean để khôi phục trạng thái nhất quán khi có vấn đề phát sinh.

Thiết kế của Bazel là để có thể khắc phục những vấn đề này và những lỗi này có mức độ ưu tiên cao cần khắc phục. Nếu bạn thấy một bản dựng gia tăng không chính xác, hãy gửi báo cáo lỗi và báo cáo lỗi trong công cụ thay vì sử dụng clean.

Truy vấn biểu đồ phần phụ thuộc

Bazel thêm một ngôn ngữ truy vấn để đặt câu hỏi về biểu đồ phần phụ thuộc được dùng trong quá trình tạo bản dựng. Ngôn ngữ truy vấn được sử dụng trong 2 lệnh: truy vấn và cquery. Điểm khác biệt chính giữa 2 lệnh là truy vấn chạy sau giai đoạn tải và cquery chạy sau giai đoạn phân tích. Những công cụ này là sự hỗ trợ vô giá cho nhiều nhiệm vụ kỹ thuật phần mềm.

Ngôn ngữ truy vấn dựa trên ý tưởng về các phép tính đại số trên đồ thị; ngôn ngữ này được ghi lại chi tiết trong

Tài liệu tham khảo về truy vấn Bazel. Vui lòng tham khảo tài liệu đó để tham khảo, xem ví dụ và để biết các tuỳ chọn dòng lệnh dành riêng cho truy vấn.

Công cụ truy vấn chấp nhận một số tuỳ chọn dòng lệnh. --output sẽ chọn định dạng đầu ra. --[no]keep_going (bị tắt theo mặc định) khiến công cụ truy vấn tiếp tục tiến triển khi có lỗi; hành vi này có thể bị vô hiệu hoá nếu kết quả không hoàn chỉnh không được chấp nhận trong trường hợp xảy ra lỗi.

Tuỳ chọn --[no]tool_deps, được bật theo mặc định, khiến các phần phụ thuộc trong cấu hình không phải mục tiêu được đưa vào biểu đồ phần phụ thuộc mà truy vấn hoạt động.

Tuỳ chọn --[no]implicit_deps, được bật theo mặc định, khiến các phần phụ thuộc ngầm ẩn được đưa vào biểu đồ phần phụ thuộc mà truy vấn hoạt động. Phần phụ thuộc ngầm ẩn là phần phụ thuộc không được chỉ định rõ ràng trong tệp BUILD nhưng được thêm bằng bazel.

Ví dụ: "Hiển thị vị trí của các định nghĩa (trong tệp BUILD) của tất cả các quy tắc gen cần thiết để tạo mọi kiểm thử trong cây PEBL."

  bazel query --output location 'kind(genrule, deps(kind(".*_test rule", foo/bar/pebl/...)))'

Truy vấn biểu đồ hành động

Lệnh aquery cho phép bạn truy vấn các hành động trong biểu đồ bản dựng. Nó hoạt động trên biểu đồ mục tiêu đã định cấu hình sau khi phân tích và hiển thị thông tin về các hành động, cấu phần phần mềm và mối quan hệ của chúng.

Công cụ này chấp nhận một số tuỳ chọn dòng lệnh. --output sẽ chọn định dạng đầu ra. Định dạng đầu ra mặc định (text) là định dạng mà con người có thể đọc được. Hãy sử dụng proto hoặc textproto cho định dạng mà máy có thể đọc được. Đáng chú ý là lệnh aquery chạy trên bản dựng Bazel thông thường và kế thừa tập hợp các tuỳ chọn có sẵn trong quá trình tạo bản dựng.

API này hỗ trợ cùng một nhóm hàm hiện có sẵn cho query truyền thống nhưng siblings, buildfiles và tests.

Để biết thêm thông tin chi tiết, hãy xem Truy vấn trong biểu đồ hành động.

Các lệnh và tuỳ chọn khác

`help`

Lệnh help cung cấp sự trợ giúp trực tuyến. Theo mặc định, công cụ này hiển thị bản tóm tắt các lệnh hiện có và chủ đề trợ giúp, như minh hoạ trong nội dung Dùng Bazel để tạo bản dựng. Việc chỉ định một đối số sẽ hiển thị thông tin trợ giúp chi tiết cho một chủ đề cụ thể. Hầu hết các chủ đề là lệnh Bazel, chẳng hạn như build hoặc query, nhưng có một số chủ đề trợ giúp khác không tương ứng với các lệnh.

`--[no]long` (`-l`)

Theo mặc định, bazel help [topic] chỉ in bản tóm tắt các tuỳ chọn có liên quan cho một chủ đề. Nếu bạn chỉ định tuỳ chọn --long, thì loại, giá trị mặc định và thông tin mô tả đầy đủ về từng tuỳ chọn cũng sẽ được in.

`shutdown`

Bạn có thể dừng các quy trình máy chủ Bazel bằng cách sử dụng lệnh shutdown. Lệnh này sẽ khiến máy chủ Bazel thoát ngay khi ở trạng thái rảnh (ví dụ: sau khi hoàn tất một bản dựng hoặc các lệnh khác đang diễn ra). Để biết thêm thông tin chi tiết, hãy xem bài viết Triển khai ứng dụng/máy chủ.

Các máy chủ Bazel tự dừng sau khi hết thời gian chờ ở trạng thái rảnh, vì vậy, lệnh này hiếm khi cần thiết. Tuy nhiên, lệnh này có thể hữu ích trong các tập lệnh khi biết rằng không có bản dựng nào khác sẽ xảy ra trong một không gian làm việc nhất định.

shutdown chấp nhận một tuỳ chọn là --iff_heap_size_greater_than _n_ yêu cầu đối số số nguyên (tính bằng MB). Nếu được chỉ định, thao tác này sẽ tắt có điều kiện đối với dung lượng bộ nhớ đã sử dụng. Điều này rất hữu ích đối với các tập lệnh khởi tạo nhiều bản dựng, vì mọi sự cố rò rỉ bộ nhớ trong máy chủ Bazel đều có thể khiến máy chủ Bazel gặp sự cố một cách bất thường khi đôi khi xảy ra sự cố; việc thực hiện việc khởi động lại có điều kiện sẽ giành ưu tiên điều kiện này.

`info`

Lệnh info in nhiều giá trị liên kết với thực thể máy chủ Bazel hoặc với một cấu hình bản dựng cụ thể. (Các tập lệnh điều khiển bản dựng có thể sử dụng những dữ liệu này.)

Lệnh info cũng cho phép một đối số (không bắt buộc), đó là tên của một trong các khoá trong danh sách bên dưới. Trong trường hợp này, bazel info key sẽ chỉ in giá trị của một khoá đó. (Điều này đặc biệt thuận tiện khi viết tập lệnh Bazel vì bạn không cần phải truyền kết quả thông qua sed -ne /key:/s/key://p:

Dữ liệu không phụ thuộc vào cấu hình

release: nhãn phát hành cho phiên bản Bazel này, hoặc "phiên bản phát triển" nếu đây không phải là tệp nhị phân đã phát hành.
workspace đường dẫn tuyệt đối đến thư mục không gian làm việc cơ sở.
install_base: đường dẫn tuyệt đối đến thư mục cài đặt mà phiên bản Bazel này sử dụng cho người dùng hiện tại. Bazel cài đặt các tệp thực thi bắt buộc trong nội bộ bên dưới thư mục này.
output_base: đường dẫn tuyệt đối đến thư mục đầu ra cơ sở mà phiên bản Bazel này sử dụng cho tổ hợp không gian làm việc và người dùng hiện tại. Bazel đặt tất cả dữ liệu đầu ra và đầu ra của bản dựng vào thư mục này.
execution_root: đường dẫn tuyệt đối đến thư mục gốc thực thi trong output_base. Thư mục này là thư mục gốc của mọi tệp có thể truy cập vào các lệnh được thực thi trong quá trình tạo bản dựng, và là thư mục làm việc cho các lệnh đó. Nếu thư mục không gian làm việc có thể ghi, thì một đường liên kết tượng trưng có tên bazel-<workspace> sẽ được đặt ở đó trỏ đến thư mục này.
output_path: đường dẫn tuyệt đối đến thư mục đầu ra bên dưới thư mục gốc thực thi được dùng cho tất cả các tệp thực sự được tạo qua lệnh bản dựng. Nếu thư mục không gian làm việc có thể ghi, thì một đường liên kết tượng trưng có tên bazel-out sẽ được đặt ở đó trỏ đến thư mục này.
server_pid: mã nhận dạng tiến trình của tiến trình máy chủ Bazel.
server_log: đường dẫn tuyệt đối đến tệp nhật ký gỡ lỗi của máy chủ Bazel. Tệp này chứa thông tin gỡ lỗi cho tất cả các lệnh trong suốt thời gian hoạt động của máy chủ Bazel và dành cho các nhà phát triển Bazel và người dùng quyền sử dụng.
command_log: đường dẫn tuyệt đối đến tệp nhật ký lệnh; tệp này chứa các luồng stdout và stderr xen kẽ của lệnh Bazel gần đây nhất. Xin lưu ý rằng việc chạy bazel info sẽ ghi đè nội dung của tệp này vì sau đó, tệp này sẽ trở thành lệnh Bazel gần đây nhất. Tuy nhiên, vị trí của tệp nhật ký lệnh sẽ không thay đổi trừ phi bạn thay đổi chế độ cài đặt của các tuỳ chọn --output_base hoặc --output_user_root.
used-heap-size, committed-heap-size, max-heap-size: báo cáo các thông số kích thước vùng nhớ khối xếp JVM khác nhau. Tương ứng: bộ nhớ hiện đang được sử dụng, bộ nhớ hiện được đảm bảo có sẵn cho JVM từ hệ thống, phân bổ tối đa có thể.
gc-count, gc-time: Số lượng tích luỹ của các bộ sưu tập rác kể từ khi máy chủ Bazel này bắt đầu hoạt động và thời gian dành để thực hiện các bộ sưu tập đó. Xin lưu ý rằng các giá trị này không được đặt lại khi bắt đầu mỗi bản dựng.
package_path: Danh sách các đường dẫn được phân tách bằng dấu hai chấm sẽ được bazel tìm kiếm các gói. Có cùng định dạng với đối số dòng lệnh của bản dựng --package_path.

Ví dụ: Mã quy trình của máy chủ Bazel.

% bazel info server_pid
1285

Dữ liệu theo cấu hình cụ thể

Những dữ liệu này có thể bị ảnh hưởng bởi các tuỳ chọn cấu hình được truyền đến bazel info, ví dụ: --cpu, --compilation_mode, v.v. Lệnh info chấp nhận tất cả các tuỳ chọn kiểm soát bản phân tích phần phụ thuộc, vì một số tuỳ chọn trong số này xác định vị trí thư mục đầu ra của bản dựng, lựa chọn trình biên dịch, v.v.

bazel-bin, bazel-testlogs, bazel-genfiles: báo cáo đường dẫn tuyệt đối đến các thư mục bazel-* chứa các chương trình do bản dựng tạo ra. Thuộc tính này thường giống với các liên kết tượng trưng bazel-* được tạo trong thư mục không gian làm việc cơ sở sau khi tạo thành công. Tuy nhiên, nếu thư mục không gian làm việc ở chế độ chỉ đọc, thì bạn không thể tạo đường liên kết tượng trưng bazel-*. Các tập lệnh sử dụng giá trị do bazel info báo cáo sẽ mạnh mẽ hơn, thay vì giả định rằng đường liên kết tượng trưng có tồn tại.
Môi trường"Tạo" hoàn chỉnh. Nếu cờ --show_make_env được chỉ định, thì tất cả các biến trong môi trường "Tạo" của cấu hình hiện tại cũng sẽ hiển thị (chẳng hạn như CC, GLIBC_VERSION, v.v.). Đây là các biến được truy cập bằng cú pháp $(CC) hoặc varref("CC") bên trong tệp BUILD.

Ví dụ: trình biên dịch C++ cho cấu hình hiện tại. Đây là biến $(CC) trong môi trường "Tạo", vì vậy, bạn cần phải gắn cờ --show_make_env.

  % bazel info --show_make_env -c opt COMPILATION_MODE
  opt

Ví dụ: Thư mục đầu ra bazel-bin cho cấu hình hiện tại. Điều này đảm bảo sẽ chính xác ngay cả trong trường hợp không thể tạo đường liên kết tượng trưng bazel-bin vì một số lý do (chẳng hạn như khi bạn tạo bản dựng từ một thư mục chỉ có thể đọc).

% bazel info --cpu=piii bazel-bin
/var/tmp/_bazel_johndoe/fbd0e8a34f61ce5d491e3da69d959fe6/execroot/io_bazel/bazel-out/piii-opt/bin
% bazel info --cpu=k8 bazel-bin
/var/tmp/_bazel_johndoe/fbd0e8a34f61ce5d491e3da69d959fe6/execroot/io_bazel/bazel-out/k8-opt/bin

`version` và `--version`

Lệnh phiên bản in thông tin chi tiết phiên bản về tệp nhị phân Bazel đã tạo, bao gồm cả danh sách thay đổi mà tệp được tạo và ngày tạo. Các thao tác này đặc biệt hữu ích trong việc xác định xem bạn có phiên bản Bazel mới nhất hay bạn đang báo cáo lỗi. Sau đây là một số giá trị thú vị:

changelist: danh sách thay đổi phát hành phiên bản Bazel này.
label: nhãn phát hành cho phiên bản Bazel này, hoặc "phiên bản phát triển" nếu đây không phải là tệp nhị phân đã phát hành. Rất hữu ích khi báo cáo lỗi.

bazel --version, không có đối số nào khác, sẽ phát ra cùng một kết quả như bazel version --gnu_format, ngoại trừ trường hợp không có tác dụng phụ của việc có thể khởi động máy chủ Bazel hoặc giải nén kho lưu trữ máy chủ. bazel --version có thể chạy từ mọi nơi mà không cần có thư mục không gian làm việc.

`mobile-install`

Lệnh mobile-install cài đặt ứng dụng vào thiết bị di động. Hiện chỉ hỗ trợ các thiết bị Android chạy ART.

Xem phần cài đặt bazel trên thiết bị di động để biết thêm thông tin.

Các tuỳ chọn sau được hỗ trợ:

`--incremental`

Nếu được thiết lập, Bazel sẽ cố gắng cài đặt ứng dụng tăng dần, tức là chỉ những phần đã thay đổi kể từ bản dựng gần nhất. Thao tác này không thể cập nhật các tài nguyên tham chiếu từ AndroidManifest.xml, mã gốc hoặc tài nguyên Java (chẳng hạn như các tài nguyên được Class.getResource() tham chiếu). Nếu những thay đổi này thay đổi, bạn phải bỏ qua tuỳ chọn này. Trái ngược với tinh thần của Bazel và do những hạn chế của nền tảng Android, trách nhiệm của người dùng là phải biết khi nào lệnh này là đủ hiệu quả và khi nào cần cài đặt toàn bộ.

Nếu bạn đang dùng một thiết bị chạy Marshmallow trở lên, hãy cân nhắc sử dụng cờ --split_apks.

`--split_apks`

Liệu có sử dụng tệp APK phân tách để cài đặt và cập nhật ứng dụng trên thiết bị hay không. Chỉ dùng được trên các thiết bị chạy Marshmallow trở lên. Lưu ý rằng bạn không cần cờ --incremental khi sử dụng --split_apks.

`--start_app`

Khởi động ứng dụng ở trạng thái mới sau khi cài đặt. Tương đương với --start=COLD.

`--debug_app`

Chờ trình gỡ lỗi được đính kèm trước khi khởi động ứng dụng ở trạng thái sạch sau khi cài đặt. Tương đương với --start=DEBUG.

`--start=_start_type_`

Cách khởi động ứng dụng sau khi cài đặt. Các _start_type_s được hỗ trợ:

NO Không khởi động ứng dụng. Đây là tuỳ chọn mặc định.
COLD Khởi động ứng dụng từ trạng thái mới sau khi cài đặt.
WARM Giữ nguyên và khôi phục trạng thái của ứng dụng khi lượt cài đặt gia tăng.
DEBUG Chờ trình gỡ lỗi trước khi khởi động ứng dụng ở trạng thái sạch sau khi cài đặt.

`--adb=path`

Cho biết tệp nhị phân adb sẽ được sử dụng.

Lựa chọn mặc định là sử dụng adb trong SDK Android do --android_sdk chỉ định.

`--adb_arg=serial`

Các đối số bổ sung cho adb. Các lệnh này xuất hiện trước lệnh con trong dòng lệnh và thường dùng để chỉ định thiết bị cần cài đặt. Ví dụ: cách chọn thiết bị Android hoặc trình mô phỏng để sử dụng:

% bazel mobile-install --adb_arg=-s --adb_arg=deadbeef

gọi adb dưới dạng

adb -s deadbeef install ...

`--incremental_install_verbosity=number`

Độ chi tiết khi cài đặt gia tăng. Bạn có thể đặt thành 1 để in nhật ký gỡ lỗi vào bảng điều khiển.

`dump`

Lệnh dump in để xuất chuẩn một tệp kết xuất trạng thái nội bộ của máy chủ Bazel. Lệnh này chủ yếu dành cho các nhà phát triển Bazel sử dụng, vì vậy, kết quả của lệnh này không được chỉ định và có thể thay đổi.

Theo mặc định, lệnh sẽ chỉ in thông báo trợ giúp nêu rõ các tuỳ chọn kết xuất cụ thể của trạng thái Bazel. Để kết xuất trạng thái nội bộ, bạn phải chỉ định ít nhất một trong các lựa chọn.

Các tuỳ chọn sau được hỗ trợ:

--action_cache kết xuất nội dung bộ nhớ đệm của thao tác.
--packages kết xuất nội dung bộ nhớ đệm của gói.
--skyframe trạng thái kết xuất của biểu đồ phần phụ thuộc Bazel nội bộ.
--rules kết xuất thông tin tóm tắt quy tắc cho từng quy tắc và lớp khung hình, bao gồm cả số lượng và số hành động. Điều này bao gồm cả quy tắc gốc và quy tắc Starlark. Nếu tính năng theo dõi bộ nhớ được bật, thì mức sử dụng bộ nhớ của quy tắc cũng được in.
--skylark_memory sẽ kết xuất một tệp .gz tương thích với pprof vào đường dẫn được chỉ định. Bạn phải bật tính năng theo dõi bộ nhớ thì chế độ này mới hoạt động.

Theo dõi bộ nhớ

Một số lệnh dump yêu cầu theo dõi bộ nhớ. Để bật tính năng này, bạn phải truyền cờ khởi động đến Bazel:

--host_jvm_args=-javaagent:$BAZEL/third_party/allocation_instrumenter/java-allocation-instrumenter-3.3.0.jar
--host_jvm_args=-DRULE_MEMORY_TRACKER=1

Tác nhân java được kiểm tra trong Bazel tại third_party/allocation_instrumenter/java-allocation-instrumenter-3.3.0.jar, vì vậy, hãy đảm bảo bạn điều chỉnh $BAZEL cho vị trí bạn lưu trữ kho lưu trữ Bazel của mình.

Đừng quên tiếp tục truyền các tuỳ chọn này cho Bazel đối với mọi lệnh, nếu không máy chủ sẽ khởi động lại.

Ví dụ:

    % bazel --host_jvm_args=-javaagent:$BAZEL/third_party/allocation_instrumenter/java-allocation-instrumenter-3.3.0.jar \
    --host_jvm_args=-DRULE_MEMORY_TRACKER=1 \
    build --nobuild <targets>

    # Dump rules
    % bazel --host_jvm_args=-javaagent:$BAZEL/third_party/allocation_instrumenter/java-allocation-instrumenter-3.3.0.jar \
    --host_jvm_args=-DRULE_MEMORY_TRACKER=1 \
    dump --rules

    # Dump Starlark heap and analyze it with pprof
    % bazel --host_jvm_args=-javaagent:$BAZEL/third_party/allocation_instrumenter/java-allocation-instrumenter-3.3.0.jar \
    --host_jvm_args=-DRULE_MEMORY_TRACKER=1 \
    dump --skylark_memory=$HOME/prof.gz
    % pprof -flame $HOME/prof.gz

`analyze-profile`

Lệnh analyze-profile phân tích dữ liệu đã thu thập trước đó trong quá trình tạo bản dựng bằng cách sử dụng tuỳ chọn --profile. Thư viện này cung cấp một số tuỳ chọn để phân tích quá trình thực thi bản dựng hoặc xuất dữ liệu ở định dạng được chỉ định.

Các tuỳ chọn sau được hỗ trợ:

--dump hiển thị tất cả dữ liệu được thu thập ở định dạng con người có thể đọc được. Tuy nhiên, phiên bản này chưa hỗ trợ các định dạng khác.

Để biết thông tin chi tiết về định dạng và thông tin trợ giúp về cách sử dụng, hãy xem phần Khắc phục sự cố về hiệu suất bằng cách phân tích.

`canonicalize-flags`

Lệnh canonicalize-flags chứa danh sách các tuỳ chọn cho một lệnh Bazel và trả về một danh sách các tuỳ chọn có hiệu quả tương tự. Danh sách các lựa chọn mới là danh sách chuẩn. Ví dụ: 2 danh sách tuỳ chọn có cùng hiệu ứng được chuẩn hoá thành cùng một danh sách mới.

Bạn có thể dùng tuỳ chọn --for_command để chọn giữa các lệnh. Hiện tại, hệ thống chỉ hỗ trợ build và test. Các tuỳ chọn mà lệnh đã cho không hỗ trợ sẽ gây ra lỗi.

Ví dụ:

  % bazel canonicalize-flags -- --config=any_name --test_tag_filters="-lint"
  --config=any_name
  --test_tag_filters=-lint

Tuỳ chọn khởi động

Các tuỳ chọn được mô tả trong phần này ảnh hưởng đến việc khởi động máy ảo Java mà quy trình máy chủ Bazel sử dụng, đồng thời áp dụng cho tất cả các lệnh tiếp theo do máy chủ đó xử lý. Nếu có một máy chủ Bazel đang chạy và các tuỳ chọn khởi động không khớp, thì máy chủ đó sẽ được khởi động lại.

Bạn phải chỉ định tất cả tuỳ chọn được mô tả trong phần này bằng cú pháp --key=value hoặc --key value. Ngoài ra, các tuỳ chọn này phải xuất hiện trước tên của lệnh Bazel. Sử dụng startup --key=value để liệt kê các thành phần này trong tệp .bazelrc.

`--output_base=dir`

Tuỳ chọn này yêu cầu một đối số đường dẫn phải chỉ định thư mục có thể ghi. Bazel sẽ sử dụng vị trí này để ghi tất cả kết quả đầu ra. Cơ sở đầu ra cũng là khoá giúp ứng dụng xác định vị trí máy chủ Bazel. Khi thay đổi cơ sở đầu ra, bạn thay đổi máy chủ sẽ xử lý lệnh.

Theo mặc định, cơ sở đầu ra được lấy từ tên đăng nhập của người dùng và tên của thư mục không gian làm việc (thực tế là chuỗi đại diện MD5), vì vậy, một giá trị thông thường sẽ có dạng như sau: /var/tmp/google/_bazel_johndoe/d41d8cd98f00b204e9800998ecf8427e.

Ví dụ:

 OUTPUT_BASE=/var/tmp/google/_bazel_johndoe/custom_output_base
% bazel --output_base ${OUTPUT_BASE}1 build //foo  &  bazel --output_base ${OUTPUT_BASE}2 build //bar

Trong lệnh này, 2 lệnh Bazel chạy đồng thời (do toán tử shell &), mỗi lệnh sử dụng một thực thể máy chủ Bazel khác nhau (do các cơ sở đầu ra khác nhau). Ngược lại, nếu cơ sở đầu ra mặc định được sử dụng trong cả hai lệnh, thì cả hai yêu cầu sẽ được gửi đến cùng một máy chủ. Máy chủ này sẽ xử lý các yêu cầu đó theo tuần tự: tạo //foo trước, sau đó là bản dựng //bar tăng dần.

`--output_user_root=dir`

Trỏ tới thư mục gốc nơi tạo cơ sở đầu ra và cơ sở cài đặt. Thư mục này không được tồn tại hoặc thuộc sở hữu của người dùng thực hiện lệnh gọi. Trước đây, tính năng này được phép trỏ tới một thư mục mà nhiều người dùng chia sẻ, nhưng hiện không được phép dùng nữa. Điều này có thể được cho phép sau khi bạn giải quyết vấn đề #11100.

Nếu bạn chỉ định tuỳ chọn --output_base, nó sẽ ghi đè bằng cách sử dụng --output_user_root để tính toán cơ sở đầu ra.

Vị trí số lượt cài đặt được tính toán dựa trên --output_user_root, cộng với mã nhận dạng MD5 của các tệp nhị phân được nhúng Bazel.

Bạn có thể sử dụng tuỳ chọn --output_user_root để chọn vị trí cơ sở thay thế cho tất cả dữ liệu đầu ra của Bazel (cơ sở cài đặt và cơ sở đầu ra) nếu bố cục hệ thống tệp của bạn có vị trí tốt hơn.

`--server_javabase=dir`

Chỉ định máy ảo Java mà chính Bazel chạy trong đó. Giá trị này phải là một đường dẫn đến thư mục chứa JDK hoặc JRE. Không được là một nhãn. Tuỳ chọn này sẽ xuất hiện trước mọi lệnh Bazel, ví dụ:

  % bazel --server_javabase=/usr/local/buildtools/java/jdk11 build //foo

Cờ này không ảnh hưởng đến các JVM mà các quy trình phụ Bazel sử dụng, chẳng hạn như ứng dụng, kiểm thử, công cụ, v.v. Thay vào đó, hãy sử dụng các tuỳ chọn bản dựng --javabase hoặc --host_javabase.

Cờ này trước đây có tên là --host_javabase (đôi khi được gọi là --host_javabase "bên trái"), nhưng đã được đổi tên để tránh nhầm lẫn với cờ bản dựng --host_javabase (đôi khi được gọi là --host_javabase "bên phải").

`--host_jvm_args=string`

Chỉ định tuỳ chọn khởi động sẽ được truyền tới máy ảo Java nơi chính Bazel chạy trong đó. Bạn có thể sử dụng thuộc tính này để đặt kích thước ngăn xếp, ví dụ:

  % bazel --host_jvm_args="-Xss256K" build //foo

Bạn có thể dùng tuỳ chọn này nhiều lần với các đối số riêng lẻ. Lưu ý rằng hiếm khi cần đặt cờ này. Bạn cũng có thể truyền một danh sách chuỗi được phân tách bằng dấu cách, mỗi chuỗi sẽ được hiểu là một đối số JVM riêng, nhưng tính năng này sắp ngừng hoạt động.

Điều này không ảnh hưởng đến bất kỳ JVM nào được sử dụng bởi các quy trình phụ của Bazel: ứng dụng, kiểm thử, công cụ, v.v. Để chuyển các tuỳ chọn JVM sang các chương trình Java có thể thực thi, cho dù được chạy bằng bazel run hay trên dòng lệnh, bạn nên sử dụng đối số --jvm_flags mà tất cả các chương trình java_binary và java_test đều hỗ trợ. Ngoài ra, đối với các chương trình kiểm thử, hãy sử dụng bazel test --test_arg=--jvm_flags=foo ....

`--host_jvm_debug`

Tuỳ chọn này khiến máy ảo Java phải đợi kết nối từ trình gỡ lỗi tuân thủ JDWP trước khi gọi phương thức chính của chính Bazel. Trình này chủ yếu dành cho các nhà phát triển Bazel.

`--autodetect_server_javabase`

Tuỳ chọn này khiến Bazel tự động tìm kiếm JDK đã cài đặt khi khởi động và quay trở lại JRE đã cài đặt nếu không có JRE nhúng. Bạn có thể dùng --explicit_server_javabase để chọn một JRE rõ ràng để chạy Bazel.

`--batch`

Chế độ lô khiến Bazel không sử dụng chế độ máy khách/máy chủ chuẩn, mà thay vào đó chạy quy trình java bazel cho một lệnh duy nhất. Chế độ này được dùng cho các ngữ nghĩa dễ dự đoán hơn liên quan đến việc xử lý tín hiệu, điều khiển công việc và kế thừa biến môi trường, đồng thời cần thiết để chạy bazel trong một nhà tù chroot.

Chế độ lô giữ lại ngữ nghĩa hàng đợi thích hợp trong cùng một output_base. Điều này có nghĩa là các lệnh gọi đồng thời sẽ được xử lý theo thứ tự mà không bị trùng lặp. Nếu chế độ hàng loạt Bazel chạy trên một ứng dụng có máy chủ đang chạy, thì trước tiên, thao tác này sẽ tắt máy chủ trước khi xử lý lệnh.

Bazel sẽ chạy chậm hơn ở chế độ hàng loạt hoặc với các giải pháp thay thế được mô tả ở trên. Lý do là ngoài các nội dung khác, bộ nhớ đệm của tệp bản dựng là bộ nhớ thường trú, vì vậy, bộ nhớ đệm không được lưu giữ giữa các lệnh gọi hàng loạt tuần tự. Do đó, việc sử dụng chế độ hàng loạt thường phù hợp hơn trong trường hợp hiệu suất ít quan trọng hơn, chẳng hạn như các bản dựng liên tục.

`--max_idle_secs=n`

Tuỳ chọn này chỉ định khoảng thời gian (tính bằng giây) mà quy trình máy chủ Bazel sẽ đợi sau yêu cầu gần đây nhất của ứng dụng khách trước khi thoát. Giá trị mặc định là 10800 (3 giờ). --max_idle_secs=0 sẽ khiến quy trình máy chủ Bazel tồn tại vô thời hạn.

Các tập lệnh gọi Bazel có thể sử dụng tuỳ chọn này để đảm bảo chúng không rời khỏi các quy trình máy chủ Bazel trên máy của người dùng khi chúng không chạy. Ví dụ: tập lệnh gửi trước có thể cần gọi bazel query để đảm bảo rằng thay đổi đang chờ xử lý của người dùng không tạo ra các phần phụ thuộc không mong muốn. Tuy nhiên, nếu người dùng không tạo một bản dựng gần đây trong không gian làm việc đó, thì việc tập lệnh gửi trước sẽ khởi động máy chủ Bazel chỉ để tập lệnh đó ở trạng thái rảnh trong ngày hôm nay là không như mong muốn. Bằng cách chỉ định một giá trị nhỏ của --max_idle_secs trong yêu cầu truy vấn, tập lệnh có thể đảm bảo rằng if đã khiến một máy chủ mới khởi động, thì máy chủ đó sẽ nhanh chóng thoát, nhưng nếu đã có một máy chủ đang chạy, thì máy chủ đó sẽ tiếp tục chạy cho đến khi không hoạt động như bình thường. Tất nhiên, bộ tính giờ ở trạng thái rảnh của máy chủ hiện tại sẽ được đặt lại.

`--[no]shutdown_on_low_sys_mem`

Nếu bạn bật chính sách này và đặt --max_idle_secs thành một thời lượng dương, thì sau khi máy chủ bản dựng không hoạt động một thời gian, hãy tắt máy chủ khi hệ thống sắp hết bộ nhớ. Chỉ Linux.

Ngoài việc chạy quy trình kiểm tra trạng thái rảnh tương ứng với max_idle_secs, máy chủ bản dựng sẽ bắt đầu theo dõi bộ nhớ hệ thống hiện có sau khi máy chủ không hoạt động một thời gian. Nếu bộ nhớ hệ thống còn trống quá thấp, máy chủ sẽ thoát.

`--[no]block_for_lock`

Nếu được bật, Bazel sẽ đợi các lệnh Bazel khác đang giữ khoá máy chủ hoàn tất trước khi tiếp tục. Nếu bị tắt, Bazel sẽ thoát do nhầm lẫn nếu không thể có được khoá ngay lập tức và tiếp tục.

Nhà phát triển có thể sử dụng thuộc tính này trong các bước kiểm tra trước khi gửi để tránh phải chờ lâu do một lệnh Bazel khác trong cùng một ứng dụng khách gây ra.

`--io_nice_level=n`

Đặt một mức từ 0 đến 7 để lên lịch IO hoạt động hiệu quả nhất. 0 là mức độ ưu tiên cao nhất, 7 là thấp nhất. Trình lập lịch biểu dự đoán chỉ có thể thực hiện tối đa mức độ ưu tiên 4. Bỏ qua các giá trị âm.

`--batch_cpu_scheduling`

Sử dụng tính năng lập lịch CPU batch cho Bazel. Chính sách này hữu ích cho các khối lượng công việc không tương tác, nhưng không muốn giảm giá trị tốt của chúng. Hãy xem "man 2 sched_setscheduler". Chính sách này có thể mang lại khả năng tương tác tốt hơn với hệ thống nhưng làm giảm thông lượng Bazel.

Tuỳ chọn khác

`--[no]announce_rc`

Kiểm soát việc Bazel có thông báo các tuỳ chọn lệnh được đọc từ tệp bazelrc khi khởi động hay không. (Các lựa chọn khởi động được thông báo vô điều kiện.)

`--color (yes|no|auto)`

Tuỳ chọn này xác định liệu Bazel có sử dụng màu để làm nổi bật đầu ra của ứng dụng trên màn hình hay không.

Nếu bạn đặt tuỳ chọn này thành yes, thì đầu ra màu sẽ bật. Nếu bạn đặt tuỳ chọn này thành auto, thì Bazel sẽ chỉ sử dụng đầu ra màu nếu dữ liệu đầu ra đang được gửi đến một thiết bị đầu cuối và biến môi trường TERM được đặt thành một giá trị không phải là dumb, emacs hoặc xterm-mono. Nếu bạn đặt tuỳ chọn này thành no, thì đầu ra màu sẽ bị tắt, bất kể đầu ra có chuyển đến thiết bị đầu cuối hay không và bất kể chế độ cài đặt của biến môi trường TERM.

`--config=name`

Chọn phần cấu hình bổ sung từ các tệp rc; đối với command hiện tại, phần này cũng lấy các tuỳ chọn từ command:name nếu phần đó tồn tại. Có thể được chỉ định nhiều lần để thêm cờ từ một số phần cấu hình. Bản mở rộng có thể tham chiếu đến các định nghĩa khác (ví dụ: bản mở rộng có thể được tạo chuỗi).

`--curses (yes|no|auto)`

Tuỳ chọn này xác định xem Bazel có sử dụng các chế độ điều khiển con trỏ trong đầu ra màn hình hay không. Điều này giúp giảm bớt dữ liệu phải cuộn và cung cấp luồng đầu ra nhỏ gọn, dễ đọc hơn từ Bazel. Tính năng này hoạt động hiệu quả với --color.

Nếu bạn đặt tuỳ chọn này thành yes, thì tính năng sử dụng điều khiển con trỏ sẽ được bật. Nếu bạn đặt tuỳ chọn này thành no, thì tính năng sử dụng điều khiển con trỏ sẽ bị tắt. Nếu bạn đặt tuỳ chọn này thành auto, thì việc sử dụng các thành phần điều khiển con trỏ sẽ được bật trong các điều kiện giống như đối với --color=auto.

`--[no]show_timestamps`

Nếu bạn chỉ định, dấu thời gian sẽ được thêm vào mỗi thông báo do Bazel tạo để chỉ định thời điểm thông báo hiển thị.

Lệnh và tuỳ chọn

Cú pháp đích

Tùy chọn

Vị trí gói hàng

--package_path

--deleted_packages

Lỗi khi kiểm tra

--[no]check_visibility

--output_filter=regex

Cờ công cụ

--copt=cc-option

--host_copt=cc-option

--host_conlyopt=cc-option

--host_cxxopt=cc-option

--host_linkopt=linker-option

--conlyopt=cc-option

--cxxopt=cc-option

--linkopt=linker-option

--strip (always|never|sometimes)

--stripopt=strip-option

--fdo_instrument=profile-output-dir

--fdo_optimize=profile-zip

--[no]output_symbol_counts

--java_language_version=version

--tool_java_language_version=version

--java_runtime_version=version

--tool_java_runtime_version=version

--jvmopt=jvm-option

--javacopt=javac-option

--strict_java_deps (default|strict|off|warn|error)

Xây dựng ngữ nghĩa

--compilation_mode (fastbuild|opt|dbg) (-c)

--cpu=cpu

--action_env=VAR=VALUE

--experimental_action_listener=label

--[no]experimental_extra_action_top_level_only

--experimental_extra_action_filter=regex

--host_cpu=cpu

--fat_apk_cpu=cpu[,cpu]*

--per_file_copt=[+-]regex[,[+-]regex]...@option[,option]...

--dynamic_mode=mode

--fission (yes|no|[dbg][,opt][,fastbuild])

--force_ignore_dash_static

--[no]force_pic

--android_resource_shrinking

--custom_malloc=malloc-library-target

--crosstool_top=label

--host_crosstool_top=label

--apple_crosstool_top=label

--android_crosstool_top=label

--compiler=version

--android_sdk=label

--java_toolchain=label

--host_java_toolchain=label

--javabase=(label)

--host_javabase=label

Chiến lược thực thi

--spawn_strategy=strategy

--strategy mnemonic=strategy

--strategy_regexp=&lt;filter,filter,...&gt;=&lt;strategy&gt;

--genrule_strategy=strategy

--jobs=n (-j)

--progress_report_interval=n

--local_{ram,cpu}_resources resources or resource expression

--[no]build_runfile_links

--[no]build_runfile_manifests

--[no]discard_analysis_cache

--[no]keep_going (-k)

--[no]use_ijars

--[no]interface_shared_objects

Lựa chọn đầu ra

--[no]build

--[no]build_tests_only

--[no]check_up_to_date

--[no]compile_one_dependency

--save_temps

--build_tag_filters=tag[,tag]*

--test_size_filters=size[,size]*

--test_timeout_filters=timeout[,timeout]*

--test_tag_filters=tag[,tag]*

`--package_path`

`--deleted_packages`

`--[no]check_visibility`

`--output_filter=regex`

`--copt=cc-option`

`--host_copt=cc-option`

`--host_conlyopt=cc-option`

`--host_cxxopt=cc-option`

`--host_linkopt=linker-option`

`--conlyopt=cc-option`

`--cxxopt=cc-option`

`--linkopt=linker-option`

`--strip (always|never|sometimes)`

`--stripopt=strip-option`

`--fdo_instrument=profile-output-dir`

`--fdo_optimize=profile-zip`

`--[no]output_symbol_counts`

`--java_language_version=version`

`--tool_java_language_version=version`

`--java_runtime_version=version`

`--tool_java_runtime_version=version`

`--jvmopt=jvm-option`

`--javacopt=javac-option`

`--strict_java_deps (default|strict|off|warn|error)`

`--compilation_mode (fastbuild|opt|dbg)` (-c)

`--cpu=cpu`

`--action_env=VAR=VALUE`

`--experimental_action_listener=label`

`--[no]experimental_extra_action_top_level_only`

`--experimental_extra_action_filter=regex`

`--host_cpu=cpu`

`--fat_apk_cpu=cpu[,cpu]*`

`--per_file_copt=[+-]regex[,[+-]regex]...@option[,option]...`

`--dynamic_mode=mode`

`--fission (yes|no|[dbg][,opt][,fastbuild])`

`--force_ignore_dash_static`

`--[no]force_pic`

`--android_resource_shrinking`

`--custom_malloc=malloc-library-target`

`--crosstool_top=label`

`--host_crosstool_top=label`

`--apple_crosstool_top=label`

`--android_crosstool_top=label`

`--compiler=version`

`--android_sdk=label`

`--java_toolchain=label`

`--host_java_toolchain=label`

`--javabase=(label)`

`--host_javabase=label`

`--spawn_strategy=strategy`

`--strategy mnemonic=strategy`

`--strategy_regexp=<filter,filter,...>=<strategy>`

`--genrule_strategy=strategy`

`--jobs=n` (-j)

`--progress_report_interval=n`

`--local_{ram,cpu}_resources resources or resource expression`

`--[no]build_runfile_links`

`--[no]build_runfile_manifests`

`--[no]discard_analysis_cache`

`--[no]keep_going` (-k)

`--[no]use_ijars`

`--[no]interface_shared_objects`

`--[no]build`

`--[no]build_tests_only`

`--[no]check_up_to_date`

`--[no]compile_one_dependency`

`--save_temps`

`--build_tag_filters=tag[,tag]*`

`--test_size_filters=size[,size]*`

`--test_timeout_filters=timeout[,timeout]*`

`--test_tag_filters=tag[,tag]*`

`--test_lang_filters=lang[,lang]*`

`--test_filter=filter-expression`

`--explain=logfile`

`--verbose_explanations`

`--profile=file`

`--[no]show_loading_progress`

`--[no]show_progress`

`--show_progress_rate_limit=n`

`--show_result=n`