bazel [<startup options>] <command> [<args>]
bazel [<startup options>] <command> [<args>] -- [<target patterns>]
Cú pháp tuỳ chọn
Bạn có thể truyền các tuỳ chọn đến Bazel theo nhiều cách. Bạn có thể truyền các tuỳ chọn yêu cầu giá trị bằng dấu bằng hoặc dấu cách:
--<option>=<value> --<option> <value>
-<short_form> <value>
Bạn có thể bật các tuỳ chọn Boolean như sau:
--<option> --<option>=[true|yes|1]
--no<option> --<option>=[false|no|0]
Các tuỳ chọn ba trạng thái thường được đặt thành tự động theo mặc định và có thể được buộc bật như sau:
--<option>=[true|yes|1]
--no<option> --<option>=[false|no|0]
Lệnh
analyze-profile |
Phân tích dữ liệu hồ sơ bản dựng. |
aquery |
Phân tích các mục tiêu đã cho và truy vấn biểu đồ hành động. |
build |
Tạo các mục tiêu đã chỉ định. |
canonicalize-flags |
Tiêu chuẩn hoá danh sách các tuỳ chọn bazel. |
clean |
Xoá các tệp đầu ra và tuỳ ý dừng máy chủ. |
coverage |
Tạo báo cáo mức độ sử dụng mã cho các mục tiêu kiểm thử đã chỉ định. |
cquery |
Tải, phân tích và truy vấn các mục tiêu đã chỉ định bằng cấu hình. |
dump |
Kết xuất trạng thái nội bộ của quy trình máy chủ bazel. |
fetch |
Tìm nạp các kho lưu trữ bên ngoài là điều kiện tiên quyết cho các mục tiêu. |
help |
In nội dung trợ giúp cho các lệnh hoặc chỉ mục. |
info |
Hiển thị thông tin về thời gian chạy của máy chủ bazel. |
license |
In giấy phép của phần mềm này. |
mobile-install |
Cài đặt mục tiêu cho thiết bị di động. |
mod |
Truy vấn biểu đồ phần phụ thuộc bên ngoài Bzlmod |
print_action |
In các đối số dòng lệnh để biên dịch tệp. |
query |
Thực thi truy vấn biểu đồ phần phụ thuộc. |
run |
Chạy mục tiêu đã chỉ định. |
shutdown |
Dừng máy chủ bazel. |
sync |
Đồng bộ hoá tất cả kho lưu trữ được chỉ định trong tệp không gian làm việc |
test |
Tạo và chạy các mục tiêu kiểm thử đã chỉ định. |
vendor |
Tìm nạp các kho lưu trữ bên ngoài vào một thư mục do cờ --vendor_dir chỉ định. |
version |
In thông tin phiên bản cho bazel. |
Tuỳ chọn khởi động
- Các tuỳ chọn xuất hiện trước lệnh và được máy khách phân tích cú pháp:
- Giá trị mặc định của
--[no]autodetect_server_javabase
: "true" -
Khi truyền --noautodetect_server_javabase, Bazel không quay lại JDK cục bộ để chạy máy chủ bazel mà thoát.
Thẻ:affects_outputs
,loses_incremental_state
- Giá trị mặc định của
--[no]batch
: "false" - Nếu được đặt, Bazel sẽ chỉ chạy dưới dạng một quy trình ứng dụng không có máy chủ, thay vì ở chế độ ứng dụng/máy chủ tiêu chuẩn. Tính năng này không còn được dùng nữa và sẽ bị xoá. Vui lòng tắt máy chủ một cách rõ ràng nếu bạn muốn tránh các máy chủ bị treo.
Thẻ:loses_incremental_state
,bazel_internal_configuration
,deprecated
- Giá trị mặc định của
--[no]batch_cpu_scheduling
: "false" - Chỉ trên Linux; sử dụng tính năng lên lịch CPU "tập hợp" cho Blaze. 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. Xem "man 2 sched_setscheduler". Nếu giá trị là false, thì Bazel sẽ không thực hiện lệnh gọi hệ thống.
Thẻ:host_machine_resource_optimizations
--bazelrc=<path>
mặc định: xem nội dung mô tả-
Vị trí của tệp .bazelrc của người dùng chứa các giá trị mặc định của các tuỳ chọn Bazel. /dev/null cho biết tất cả các `--bazelrc`khác sẽ bị bỏ qua. Điều này hữu ích để tắt tính năng tìm kiếm tệp rc của người dùng, ví dụ: trong các bản phát hành.
Bạn cũng có thể chỉ định tuỳ chọn này nhiều lần.
Ví dụ: với `--bazelrc=x.rc --bazelrc=y.rc --bazelrc=/dev/null --bazelrc=z.rc`,
1) x.rc và y.rc được đọc.
2) z.rc bị bỏ qua do /dev/null trước đó.
Nếu không chỉ định, Bazel sẽ sử dụng tệp .bazelrc đầu tiên tìm thấy ở hai vị trí sau: thư mục không gian làm việc, sau đó là thư mục gốc của người dùng.
Lưu ý: các tuỳ chọn dòng lệnh sẽ luôn thay thế mọi tuỳ chọn trong bazelrc.
Thẻ:changes_inputs
- Giá trị mặc định của
--[no]block_for_lock
: "true" -
Khi truyền --noblock_for_lock, Bazel không chờ lệnh đang chạy hoàn tất mà thoát ngay lập tức.
Thẻ:eagerness_to_exit
- Giá trị mặc định của
--[no]client_debug
: "false" - Nếu đúng, hãy ghi lại thông tin gỡ lỗi từ ứng dụng vào stderr. Việc thay đổi tuỳ chọn này sẽ không khiến máy chủ khởi động lại.
Thẻ:affects_outputs
,bazel_monitoring
- Giá trị mặc định của
--connect_timeout_secs=<an integer>
: "30" - Thời gian mà ứng dụng chờ mỗi lần thử kết nối với máy chủ
Thẻ:bazel_internal_configuration
--digest_function=<hash function>
mặc định: xem nội dung mô tả-
Hàm băm để sử dụng khi tính toán chuỗi đại diện tệp.
Thẻ:loses_incremental_state
,bazel_internal_configuration
- Giá trị mặc định của
--[no]expand_configs_in_place
: "true" -
Thay đổi việc mở rộng cờ --config để thực hiện tại chỗ, thay vì mở rộng tại một điểm cố định giữa các tuỳ chọn rc thông thường và các tuỳ chọn được chỉ định bằng dòng lệnh.
Thẻ:no_op
,deprecated
--failure_detail_out=<path>
mặc định: xem nội dung mô tả- Nếu được đặt, hãy chỉ định vị trí để ghi thông báo protobuf failure_detail nếu máy chủ gặp lỗi và không thể báo cáo lỗi đó qua gRPC như bình thường. Nếu không, vị trí sẽ là ${OUTPUT_BASE}/failure_detail.rawproto.
Thẻ:affects_outputs
,loses_incremental_state
- Giá trị mặc định của
--[no]home_rc
: "true" -
Có tìm tệp bazelrc gốc tại $HOME/.bazelrc hay không
Thẻ:changes_inputs
- Giá trị mặc định của
--[no]idle_server_tasks
: "true" -
Chạy System.gc() khi máy chủ ở trạng thái rảnh
Thẻ:loses_incremental_state
,host_machine_resource_optimizations
- Giá trị mặc định của
--[no]ignore_all_rc_files
: "false" -
Tắt tất cả tệp rc, bất kể giá trị của các cờ sửa đổi rc khác, ngay cả khi các cờ này xuất hiện sau trong danh sách các tuỳ chọn khởi động.
Thẻ:changes_inputs
--io_nice_level={-1,0,1,2,3,4,5,6,7}
mặc định: "-1"-
Chỉ trên Linux; đặt cấp từ 0 đến 7 để lập lịch biểu IO hiệu quả nhất bằng lệnh gọi hệ thống sys_ioprio_set. 0 là mức độ ưu tiên cao nhất, 7 là mức độ ưu tiên thấp nhất. Trình lập lịch biểu dự đoán chỉ có thể tuân thủ mức độ ưu tiên tối đa là 4. Nếu bạn đặt giá trị âm, thì Bazel sẽ không thực hiện lệnh gọi hệ thống.
Thẻ:host_machine_resource_optimizations
--local_startup_timeout_secs=<an integer>
mặc định: "120"- Thời gian tối đa mà ứng dụng chờ để kết nối với máy chủ
Thẻ:bazel_internal_configuration
- Giá trị mặc định của
--macos_qos_class=<a string>
: "mặc định" -
Đặt lớp dịch vụ QoS của máy chủ bazel khi chạy trên macOS. Cờ này không ảnh hưởng đến tất cả các nền tảng khác nhưng được hỗ trợ để đảm bảo có thể chia sẻ các tệp rc giữa các nền tảng mà không cần thay đổi. Các giá trị có thể là: tương tác với người dùng, do người dùng khởi tạo, mặc định, tiện ích và nền.
Thẻ:host_machine_resource_optimizations
--max_idle_secs=<integer>
mặc định: "10800"- Số giây mà máy chủ bản dựng sẽ chờ ở trạng thái rảnh trước khi tắt. Giá trị 0 có nghĩa là máy chủ sẽ không bao giờ tắt. Tùy chọn này chỉ được đọc khi khởi động máy chủ, việc thay đổi tuỳ chọn này sẽ không khiến máy chủ khởi động lại.
Thẻ:eagerness_to_exit
,loses_incremental_state
--output_base=<path>
mặc định: xem nội dung mô tả- Nếu được đặt, hãy chỉ định vị trí đầu ra mà tất cả đầu ra của bản dựng sẽ được ghi vào. Nếu không, vị trí sẽ là ${OUTPUT_ROOT}/_blaze_${USER}/${MD5_OF_WORKSPACE_ROOT}. Lưu ý: Nếu chỉ định một tuỳ chọn khác cho lệnh gọi Bazel tiếp theo cho giá trị này, bạn có thể sẽ khởi động một máy chủ Bazel mới. Bazel khởi động đúng một máy chủ cho mỗi cơ sở đầu ra được chỉ định. Thông thường, mỗi không gian làm việc có một cơ sở đầu ra. Tuy nhiên, với tuỳ chọn này, bạn có thể có nhiều cơ sở đầu ra cho mỗi không gian làm việc và do đó, chạy đồng thời nhiều bản dựng cho cùng một ứng dụng trên cùng một máy. Xem phần "bazel help shutdown" (bazel help shutdown) để biết cách tắt máy chủ Bazel.
Thẻ:affects_outputs
,loses_incremental_state
--output_user_root=<path>
mặc định: xem nội dung mô tả-
Thư mục dành riêng cho người dùng, trong đó tất cả các đầu ra của bản dựng được ghi; theo mặc định, đây là một hàm của $USER, nhưng bằng cách chỉ định một hằng số, các đầu ra của bản dựng có thể được chia sẻ giữa những người dùng cộng tác.
Thẻ:affects_outputs
,loses_incremental_state
- Giá trị mặc định của
--[no]preemptible
: "false" - Nếu đúng, lệnh này có thể được ưu tiên nếu một lệnh khác được bắt đầu.
Thẻ:eagerness_to_exit
--server_jvm_out=<path>
mặc định: xem nội dung mô tả-
Vị trí ghi đầu ra của JVM của máy chủ. Nếu không được đặt, giá trị mặc định sẽ là một vị trí trong output_base.
Thẻ:affects_outputs
,loses_incremental_state
- Giá trị mặc định của
--[no]shutdown_on_low_sys_mem
: "false" - Nếu bạn đặt max_idle_secs và máy chủ bản dựng đã ở trạng thái rảnh trong một thời gian, hãy tắt máy chủ khi hệ thống sắp hết RAM trống. Chỉ dành cho Linux.
Thẻ:eagerness_to_exit
,loses_incremental_state
- Giá trị mặc định của
--[no]system_rc
: "true" -
Liệu có tìm bazelrc trên toàn hệ thống hay không.
Thẻ:changes_inputs
- Giá trị mặc định của
--[no]unlimit_coredumps
: "false" -
Tăng giới hạn tệp báo lỗi lõi mềm lên giới hạn cứng để tạo tệp báo lỗi lõi của máy chủ (bao gồm cả JVM) và máy khách trong các điều kiện phổ biến. Chỉ cần thêm cờ này vào bazelrc một lần và quên đi để bạn có thể nhận được tệp coredump khi thực sự gặp phải một điều kiện kích hoạt các tệp đó.
Thẻ:bazel_internal_configuration
- Giá trị mặc định của
--[no]watchfs
: "false" - Nếu đúng, bazel sẽ cố gắng sử dụng dịch vụ theo dõi tệp của hệ điều hành cho các thay đổi cục bộ thay vì quét mọi tệp để tìm thay đổi.
Thẻ:deprecated
- Giá trị mặc định của
--[no]windows_enable_symlinks
: "false" - Nếu đúng, các đường liên kết tượng trưng thực sẽ được tạo trên Windows thay vì sao chép tệp. Yêu cầu bật chế độ nhà phát triển Windows và Windows 10 phiên bản 1703 trở lên.
Thẻ:bazel_internal_configuration
- Giá trị mặc định của
--[no]workspace_rc
: "true" -
Có tìm tệp bazelrc của không gian làm việc tại $workspace/.bazelrc hay không
Thẻ:changes_inputs
- Các tuỳ chọn khác, không được phân loại.:
--host_jvm_args=<jvm_arg>
nhiều lần sử dụng được tích luỹ- Cờ để truyền đến JVM thực thi Blaze.
--host_jvm_debug
- Tuỳ chọn thuận tiện để thêm một số cờ khởi động JVM bổ sung, khiến JVM chờ trong quá trình khởi động cho đến khi bạn kết nối từ trình gỡ lỗi tuân thủ JDWP (chẳng hạn như Eclipse) với cổng 5005.
Mở rộng thành:
--host_jvm_args=-Xdebug
--host_jvm_args=-Xrunjdwp:transport=dt_socket,server=y,address=5005
--host_jvm_profile=<profiler_name>
mặc định: ""- Tuỳ chọn thuận tiện để thêm một số cờ khởi động JVM dành riêng cho trình phân tích tài nguyên/trình gỡ lỗi. Bazel có một danh sách các giá trị đã biết mà nó liên kết với cờ khởi động JVM được mã hoá cứng, có thể tìm kiếm một số đường dẫn được mã hoá cứng cho một số tệp nhất định.
--server_javabase=<jvm path>
mặc định: ""- Đường dẫn đến JVM dùng để tự thực thi Bazel.
Các tuỳ chọn phổ biến cho tất cả lệnh
- Các tuỳ chọn xuất hiện trước lệnh và được máy khách phân tích cú pháp:
--http_connector_attempts=<an integer>
mặc định: "8"-
Số lần thử tải xuống http tối đa.
Thẻ:bazel_internal_configuration
--http_connector_retry_max_timeout=<An immutable length of time.>
mặc định: "0 giây"- Thời gian chờ tối đa cho các lần thử tải xuống http lại. Với giá trị 0, hệ thống sẽ không xác định thời gian chờ tối đa.
Thẻ:bazel_internal_configuration
--http_max_parallel_downloads=<an integer>
mặc định: "8"-
Số lượt tải xuống http song song tối đa.
Thẻ:bazel_internal_configuration
--http_timeout_scaling=<a double>
mặc định: "1.0"-
Điều chỉnh tất cả thời gian chờ liên quan đến lượt tải xuống http theo hệ số đã cho
Thẻ:bazel_internal_configuration
- Các tuỳ chọn kiểm soát việc thực thi bản dựng:
--experimental_ui_max_stdouterr_bytes=<an integer in (-1)-1073741819 range>
mặc định: "1048576"-
Kích thước tối đa của tệp stdout / stderr sẽ được in vào bảng điều khiển. -1 ngụ ý không có giới hạn.
Thẻ:execution
- Giá trị mặc định của
--[no]incompatible_remote_dangling_symlinks
: "true" - Nếu bạn đặt thành true, các đường liên kết tượng trưng được tải lên bộ nhớ đệm từ xa hoặc bộ nhớ đệm của ổ đĩa sẽ được phép treo.
Thẻ:execution
,incompatible_change
- Giá trị mặc định của
--[no]incompatible_remote_symlinks
: "true" - Nếu bạn đặt thành true, Bazel sẽ luôn tải các đường liên kết tượng trưng lên bộ nhớ đệm từ xa hoặc bộ nhớ đệm trên ổ đĩa. Nếu không, các đường liên kết tượng trưng tương đối không bị treo (và chỉ những đường liên kết đó) sẽ được tải lên dưới dạng tệp hoặc thư mục mà các đường liên kết đó trỏ đến.
Thẻ:execution
,incompatible_change
- Các tuỳ chọn định cấu hình chuỗi công cụ dùng để thực thi hành động:
- Giá trị mặc định của
--[no]incompatible_enable_proto_toolchain_resolution
: "false" - Nếu đúng, các quy tắc ngôn ngữ proto sẽ xác định chuỗi công cụ từ các kho lưu trữ rules_proto, rules_java, rules_cc.
Thẻ:loading_and_analysis
,incompatible_change
- Các tuỳ chọn cho phép người dùng định cấu hình đầu ra dự kiến, ảnh hưởng đến giá trị của đầu ra đó, thay vì sự tồn tại của đầu ra:
--bep_maximum_open_remote_upload_files=<an integer>
mặc định: "-1"- Số lượng tệp mở tối đa được phép trong quá trình tải cấu phần phần mềm BEP lên.
Thẻ:affects_outputs
--remote_download_all
-
Tải tất cả đầu ra từ xa xuống máy cục bộ. Cờ này là đại diện cho --remote_download_outputs=all.
Mở rộng thành:
--remote_download_outputs=all
Thẻ:affects_outputs
--remote_download_minimal
-
Không tải bất kỳ đầu ra bản dựng từ xa nào xuống máy cục bộ. Cờ này là bí danh của --remote_download_outputs=minimal.
Mở rộng thành:
--remote_download_outputs=minimal
Thẻ:affects_outputs
--remote_download_outputs=<all, minimal or toplevel>
mặc định: "toplevel"- Nếu được đặt thành "minimal" (tối thiểu), thì sẽ không tải bất kỳ đầu ra bản dựng từ xa nào xuống máy cục bộ, ngoại trừ những đầu ra mà các hành động cục bộ yêu cầu. Nếu được đặt thành "toplevel", thì chế độ này sẽ hoạt động giống như "minimal", ngoại trừ việc chế độ này cũng tải kết quả của các mục tiêu cấp cao nhất xuống máy cục bộ. Cả hai tuỳ chọn này đều có thể giảm đáng kể thời gian xây dựng nếu băng thông mạng là nút thắt cổ chai.
Thẻ:affects_outputs
--remote_download_symlink_template=<a string>
mặc định: ""- Thay vì tải các đầu ra bản dựng từ xa xuống máy cục bộ, hãy tạo các đường liên kết tượng trưng. Bạn có thể chỉ định mục tiêu của đường liên kết tượng trưng ở dạng chuỗi mẫu. Chuỗi mẫu này có thể chứa {hash} và {size_bytes} lần lượt mở rộng thành hàm băm của đối tượng và kích thước tính bằng byte. Ví dụ: các đường liên kết tượng trưng này có thể trỏ đến một hệ thống tệp FUSE tải các đối tượng từ CAS theo yêu cầu.
Thẻ:affects_outputs
--remote_download_toplevel
-
Chỉ tải các đầu ra từ xa của mục tiêu cấp cao nhất xuống máy cục bộ. Cờ này là bí danh của --remote_download_outputs=toplevel.
Mở rộng thành:
--remote_download_outputs=toplevel
Thẻ:affects_outputs
--repo_env=<a 'name=value' assignment with an optional value part>
nhiều lần sử dụng được tích luỹ- Chỉ định các biến môi trường bổ sung chỉ dành cho các quy tắc kho lưu trữ. Xin lưu ý rằng các quy tắc kho lưu trữ vẫn xem được toàn bộ môi trường, nhưng theo cách này, thông tin cấu hình có thể được truyền đến kho lưu trữ thông qua các tuỳ chọn mà không làm mất hiệu lực biểu đồ hành động.
Thẻ:action_command_lines
- Các tuỳ chọn ảnh hưởng đến mức độ nghiêm ngặt mà Bazel thực thi các dữ liệu đầu vào bản dựng hợp lệ (xác định quy tắc, tổ hợp cờ, v.v.):
- Giá trị mặc định của
--[no]check_bzl_visibility
: "true" - Nếu bị tắt, lỗi hiển thị tải .bzl sẽ bị hạ cấp thành cảnh báo.
Thẻ:build_file_semantics
- Tuỳ chọn này ảnh hưởng đến ngữ nghĩa của ngôn ngữ Starlark hoặc API bản dựng có thể truy cập vào các tệp BUILD, tệp .bzl hoặc tệp WORKSPACE.:
- Giá trị mặc định của
--[no]enable_bzlmod
: "true" - Nếu đúng, hãy bật hệ thống quản lý phần phụ thuộc Bzlmod, được ưu tiên hơn WORKSPACE. Hãy xem https://bazel.build/docs/bzlmod để biết thêm thông tin.
Thẻ:loading_and_analysis
- Giá trị mặc định của
--[no]enable_workspace
: "true" - Nếu đúng, hãy bật hệ thống WORKSPACE cũ cho các phần phụ thuộc bên ngoài. Hãy xem https://bazel.build/external/overview để biết thêm thông tin.
Thẻ:loading_and_analysis
- Giá trị mặc định của
--[no]experimental_action_resource_set
: "true" - Nếu được đặt thành true, ctx.actions.run() và ctx.actions.run_shell() sẽ chấp nhận tham số resource_set để thực thi cục bộ. Nếu không, dung lượng bộ nhớ sẽ mặc định là 250 MB và 1 CPU.
Thẻ:execution
,build_file_semantics
,experimental
- Giá trị mặc định của
--[no]experimental_bzl_visibility
: "true" - Nếu được bật, hãy thêm một hàm `visibility()` mà các tệp .bzl có thể gọi trong quá trình đánh giá cấp cao nhất để đặt chế độ hiển thị cho mục đích của câu lệnh load().
Thẻ:loading_and_analysis
,experimental
- Nếu được đặt thành true, các thuộc tính quy tắc và phương thức API Starlark cần thiết cho quy tắc cc_shared_library sẽ có sẵn.
Thẻ:build_file_semantics
,loading_and_analysis
,experimental
- Giá trị mặc định của
--[no]experimental_cc_static_library
: "false" - Nếu được đặt thành true, các thuộc tính quy tắc và phương thức API Starlark cần thiết cho quy tắc cc_static_library sẽ có sẵn.
Thẻ:build_file_semantics
,loading_and_analysis
,experimental
- Giá trị mặc định của
--[no]experimental_disable_external_package
: "false" - Nếu bạn đặt thành true, gói //external được tạo tự động sẽ không còn hoạt động nữa. Bazel vẫn không thể phân tích cú pháp tệp "external/BUILD", nhưng các glob truy cập vào external/ từ gói chưa được đặt tên sẽ hoạt động.
Thẻ:loading_and_analysis
,loses_incremental_state
,experimental
- Giá trị mặc định của
--[no]experimental_enable_android_migration_apis
: "false" - Nếu bạn đặt thành true, hãy bật các API cần thiết để hỗ trợ việc di chuyển Android Starlark.
Thẻ:build_file_semantics
- Giá trị mặc định của
--[no]experimental_enable_scl_dialect
: "false" - Nếu bạn đặt thành true, thì các tệp .scl có thể được dùng trong câu lệnh load().
Thẻ:build_file_semantics
- Giá trị mặc định của
--[no]experimental_google_legacy_api
: "false" - Nếu được đặt thành true, sẽ hiển thị một số phần thử nghiệm của API bản dựng Starlark liên quan đến mã cũ của Google.
Thẻ:loading_and_analysis
,experimental
- Giá trị mặc định của
--[no]experimental_isolated_extension_usages
: "false" - Nếu đúng, hãy bật tham số <code>isolate</code> trong hàm <a href="https://bazel.build/rules/lib/globals/module#use_extension"><code>use_extension</code></a>.
Thẻ:loading_and_analysis
- Giá trị mặc định của
--[no]experimental_java_library_export
: "false" - Nếu được bật, mô-đun experimental_java_library_export_do_not_use sẽ có sẵn.
Thẻ:loading_and_analysis
,incompatible_change
- Giá trị mặc định của
--[no]experimental_platforms_api
: "false" - Nếu được đặt thành true, hãy bật một số API Starlark liên quan đến nền tảng hữu ích cho việc gỡ lỗi.
Thẻ:loading_and_analysis
,experimental
- Giá trị mặc định của
--[no]experimental_repo_remote_exec
: "false" - Nếu được đặt thành true, repository_rule sẽ có một số chức năng thực thi từ xa.
Thẻ:build_file_semantics
,loading_and_analysis
,experimental
- Giá trị mặc định của
--[no]experimental_sibling_repository_layout
: "false" - Nếu được đặt thành true, các kho lưu trữ không phải chính sẽ được trồng dưới dạng đường liên kết tượng trưng đến kho lưu trữ chính trong thư mục gốc thực thi. Tức là tất cả kho lưu trữ đều là phần tử con trực tiếp của thư mục $output_base/execution_root. Việc này có tác dụng phụ là giải phóng $output_base/execution_root/__main__/external cho thư mục "external" cấp cao nhất thực sự.
Thẻ:action_command_lines
,bazel_internal_configuration
,loading_and_analysis
,loses_incremental_state
,experimental
- Nếu được đặt thành true, thẻ sẽ được truyền từ một mục tiêu đến các yêu cầu thực thi của hành động; nếu không, thẻ sẽ không được truyền. Hãy xem https://github.com/bazelbuild/bazel/issues/8830 để biết thông tin chi tiết.
Thẻ:build_file_semantics
,experimental
- Giá trị mặc định của
--[no]incompatible_always_check_depset_elements
: "true" -
Kiểm tra tính hợp lệ của các phần tử được thêm vào depset, trong tất cả hàm khởi tạo. Các phần tử phải bất biến, nhưng trước đây hàm khởi tạo depset(direct=...) đã quên kiểm tra. Sử dụng các bộ dữ liệu thay vì danh sách trong các phần tử depset. Hãy xem https://github.com/bazelbuild/bazel/issues/10313 để biết thông tin chi tiết.
Thẻ:build_file_semantics
,incompatible_change
--incompatible_autoload_externally=<comma-separated set of options>
mặc định: ""-
Danh sách các quy tắc (hoặc các ký hiệu khác) được phân tách bằng dấu phẩy trước đây là một phần của Bazel và hiện sẽ được truy xuất từ các kho lưu trữ bên ngoài tương ứng. Cờ này được dùng để hỗ trợ di chuyển các quy tắc ra khỏi Bazel. Xem thêm https://github.com/bazelbuild/bazel/issues/23043.
Một biểu tượng được tự động tải trong tệp sẽ hoạt động như thể định nghĩa tích hợp sẵn trong Bazel được thay thế bằng định nghĩa mới chuẩn trong kho lưu trữ bên ngoài. Đối với tệp BUILD, về cơ bản, điều này có nghĩa là ngầm thêm câu lệnh load(). Đối với tệp .bzl, đó là câu lệnh load() hoặc thay đổi đối với trường của đối tượng "native", tuỳ thuộc vào việc biểu tượng tự động tải có phải là quy tắc hay không.
Bazel duy trì một danh sách được mã hoá cứng gồm tất cả các ký hiệu có thể được tự động tải; chỉ những ký hiệu đó mới có thể xuất hiện trong cờ này. Đối với mỗi biểu tượng, Bazel biết vị trí định nghĩa mới trong kho lưu trữ bên ngoài, cũng như một tập hợp các kho lưu trữ đặc biệt không được tự động tải biểu tượng đó để tránh tạo chu kỳ.
Mục danh sách "+foo" trong cờ này sẽ khiến biểu tượng foo được tự động tải, ngoại trừ trong các kho lưu trữ miễn trừ của foo, trong đó phiên bản foo do Bazel xác định vẫn có sẵn.
Mục danh sách "foo" kích hoạt tính năng tự động tải như trên, nhưng phiên bản foo do Bazel xác định không được cung cấp cho các kho lưu trữ bị loại trừ. Điều này đảm bảo rằng kho lưu trữ bên ngoài của foo không phụ thuộc vào cách triển khai Bazel cũ của foo
Mục danh sách "-foo" không kích hoạt bất kỳ tính năng tự động tải nào, nhưng khiến phiên bản foo do Bazel xác định không truy cập được trong toàn bộ không gian làm việc. Thao tác này dùng để xác thực rằng không gian làm việc đã sẵn sàng để xoá định nghĩa của foo khỏi Bazel.
Nếu một biểu tượng không được đặt tên trong cờ này, thì biểu tượng đó sẽ tiếp tục hoạt động như bình thường – không có quá trình tự động tải nào được thực hiện và phiên bản do Bazel xác định cũng không bị chặn. Để biết cấu hình, hãy xem https://github.com/bazelbuild/bazel/blob/master/src/main/java/com/google/devtools/build/lib/packages/AutoloadSymbols.java. Bạn cũng có thể sử dụng toàn bộ kho lưu trữ dưới dạng lối tắt, ví dụ: +@rules_python sẽ tự động tải tất cả quy tắc Python.
Thẻ:loses_incremental_state
,build_file_semantics
,incompatible_change
- Giá trị mặc định của
--[no]incompatible_depset_for_java_output_source_jars
: "true" -
Khi đúng, Bazel không còn trả về danh sách từ java_info.java_output[0].source_jars mà trả về một depset.
Thẻ:loading_and_analysis
,incompatible_change
- Giá trị mặc định của
--[no]incompatible_depset_for_libraries_to_link_getter
: "true" -
Khi đúng, Bazel không còn trả về danh sách từ linking_context.libraries_to_link mà trả về một depset.
Thẻ:loading_and_analysis
,incompatible_change
- Giá trị mặc định của
--[no]incompatible_disable_objc_library_transition
: "true" -
Tắt hiệu ứng chuyển đổi tuỳ chỉnh của objc_library và kế thừa từ mục tiêu cấp cao nhất
Thẻ:build_file_semantics
,incompatible_change
- Giá trị mặc định của
--[no]incompatible_disable_starlark_host_transitions
: "false" - Nếu được đặt thành đúng, các thuộc tính quy tắc không thể đặt "cfg = "host"". Thay vào đó, các quy tắc nên đặt "cfg = "exec"".
Thẻ:loading_and_analysis
,incompatible_change
- Giá trị mặc định của
--[no]incompatible_disable_target_provider_fields
: "false" - Nếu bạn đặt thành true, hãy tắt khả năng truy cập vào trình cung cấp trên các đối tượng "target" (mục tiêu) thông qua cú pháp trường. Thay vào đó, hãy sử dụng cú pháp khoá nhà cung cấp. Ví dụ: thay vì sử dụng `ctx.attr.dep.my_info` để truy cập vào `my_info` từ bên trong hàm triển khai quy tắc, hãy sử dụng `ctx.attr.dep[MyInfo]`. Hãy xem https://github.com/bazelbuild/bazel/issues/9014 để biết thông tin chi tiết.
Thẻ:build_file_semantics
,incompatible_change
- Giá trị mặc định của
--[no]incompatible_disallow_empty_glob
: "false" - Nếu được đặt thành true, giá trị mặc định của đối số `allow_empty` của glob() là False.
Thẻ:build_file_semantics
,incompatible_change
- Giá trị mặc định của
--[no]incompatible_disallow_struct_provider_syntax
: "false" - Nếu được đặt thành true, các hàm triển khai quy tắc có thể không trả về một cấu trúc. Thay vào đó, các phương thức này phải trả về danh sách các thực thể của trình cung cấp.
Thẻ:build_file_semantics
,incompatible_change
- Giá trị mặc định của
--[no]incompatible_enable_deprecated_label_apis
: "true" - Nếu được bật, bạn có thể sử dụng một số API không dùng nữa (native.repository_name, Label.workspace_name, Label.relative).
Thẻ:loading_and_analysis
- Giá trị mặc định của
--[no]incompatible_existing_rules_immutable_view
: "true" - Nếu được đặt thành true, native.existing_rule và native.existing_rules sẽ trả về các đối tượng thành phần hiển thị không thể thay đổi có trọng lượng nhẹ thay vì các từ điển có thể thay đổi.
Thẻ:build_file_semantics
,loading_and_analysis
,incompatible_change
- Giá trị mặc định của
--[no]incompatible_fail_on_unknown_attributes
: "true" - Nếu bạn bật, các mục tiêu có thuộc tính không xác định được đặt thành Không sẽ không thành công.
Thẻ:loading_and_analysis
,incompatible_change
- Giá trị mặc định của
--[no]incompatible_fix_package_group_reporoot_syntax
: "true" -
Trong thuộc tính "packages" của package_group, hãy thay đổi ý nghĩa của giá trị "//..." để tham chiếu đến tất cả các gói trong kho lưu trữ hiện tại thay vì tất cả các gói trong bất kỳ kho lưu trữ nào. Bạn có thể sử dụng giá trị đặc biệt "public" thay vì "//..." để lấy hành vi cũ. Cờ này yêu cầu bạn cũng phải bật --incompatible_package_group_has_public_syntax.
Thẻ:build_file_semantics
,incompatible_change
- Giá trị mặc định của
--[no]incompatible_java_common_parameters
: "true" - Nếu được đặt thành true, tất cả tham số output_jar và host_javabase trong pack_sources và host_javabase trong quá trình biên dịch sẽ bị xoá.
Thẻ:build_file_semantics
,incompatible_change
- Giá trị mặc định của
--[no]incompatible_merge_fixed_and_default_shell_env
: "true" - Nếu được bật, các hành động được đăng ký bằng ctx.actions.run và ctx.actions.run_shell với cả "env" và "use_default_shell_env = True" được chỉ định sẽ sử dụng môi trường lấy được từ môi trường shell mặc định bằng cách ghi đè bằng các giá trị được truyền vào "env". Trong trường hợp này, nếu bị tắt, giá trị của "env" sẽ bị bỏ qua hoàn toàn.
Thẻ:loading_and_analysis
,incompatible_change
- Giá trị mặc định của
--[no]incompatible_new_actions_api
: "true" - Nếu được đặt thành true, API để tạo hành động chỉ có trên `ctx.actions`, chứ không có trên `ctx`.
Thẻ:build_file_semantics
,incompatible_change
- Giá trị mặc định của
--[no]incompatible_no_attr_license
: "true" - Nếu được đặt thành true, sẽ tắt hàm `attr.license`.
Thẻ:build_file_semantics
,incompatible_change
- Giá trị mặc định của
--[no]incompatible_no_implicit_file_export
: "false" - Nếu được đặt, các tệp nguồn (được sử dụng) sẽ là gói riêng tư trừ khi được xuất một cách rõ ràng. Xem https://github.com/bazelbuild/proposals/blob/master/designs/2019-10-24-file-visibility.md
Thẻ:build_file_semantics
,incompatible_change
- Giá trị mặc định của
--[no]incompatible_no_implicit_watch_label
: "false" - Nếu đúng, thì các phương thức trên <code>repository_ctx</code> được truyền một Nhãn sẽ không còn tự động theo dõi tệp trong nhãn đó để tìm thay đổi ngay cả khi <code>watch = "no"</code> và <code>repository_ctx.path</code> không còn khiến đường dẫn được trả về được theo dõi. Thay vào đó, hãy sử dụng <code>repository_ctx.watch</code>.
Thẻ:loading_and_analysis
,incompatible_change
- Giá trị mặc định của
--[no]incompatible_no_rule_outputs_param
: "false" - Nếu được đặt thành đúng, hãy tắt tham số "outputs" của hàm Starlark "rule()".
Thẻ:build_file_semantics
,incompatible_change
- Giá trị mặc định của
--[no]incompatible_objc_provider_remove_linking_info
: "false" - Nếu bạn đặt thành true, các API của ObjcProvider để liên kết thông tin sẽ bị xoá.
Thẻ:build_file_semantics
,incompatible_change
- Giá trị mặc định của
--[no]incompatible_package_group_has_public_syntax
: "true" - Trong thuộc tính "packages" của package_group, cho phép ghi "public" hoặc "private" để tham chiếu đến tất cả các gói hoặc không có gói nào tương ứng.
Thẻ:build_file_semantics
,incompatible_change
- Giá trị mặc định của
--[no]incompatible_require_linker_input_cc_api
: "true" - Nếu bạn đặt thành true, quy tắc create_linking_context sẽ yêu cầu linker_inputs thay vì libraries_to_link. Các phương thức getter cũ của linking_context cũng sẽ bị vô hiệu hoá và chỉ có linker_inputs.
Thẻ:build_file_semantics
,loading_and_analysis
,incompatible_change
- Giá trị mặc định của
--[no]incompatible_run_shell_command_string
: "true" - Nếu được đặt thành true, tham số lệnh của actions.run_shell sẽ chỉ chấp nhận chuỗi Thẻ
:build_file_semantics
,incompatible_change
- Giá trị mặc định của
--[no]incompatible_stop_exporting_language_modules
: "false" - Nếu được bật, một số mô-đun dành riêng cho ngôn ngữ (chẳng hạn như `cc_common`) sẽ không có trong tệp .bzl của người dùng và chỉ có thể được gọi từ kho lưu trữ quy tắc tương ứng.
Thẻ:loading_and_analysis
,incompatible_change
- Giá trị mặc định của
--[no]incompatible_struct_has_no_methods
: "false" -
Tắt các phương thức to_json và to_proto của cấu trúc, làm ô nhiễm không gian tên trường cấu trúc. Thay vào đó, hãy sử dụng json.encode hoặc json.encode_indent cho JSON hoặc proto.encode_text cho textproto.
Thẻ:build_file_semantics
,incompatible_change
- Giá trị mặc định của
--[no]incompatible_top_level_aspects_require_providers
: "false" - Nếu được đặt thành true, phương diện cấp cao nhất sẽ tuân thủ các nhà cung cấp bắt buộc và chỉ chạy trên các mục tiêu cấp cao nhất mà nhà cung cấp được quảng cáo của quy tắc đáp ứng các nhà cung cấp bắt buộc của phương diện.
Thẻ:loading_and_analysis
,incompatible_change
- Giá trị mặc định của
--[no]incompatible_unambiguous_label_stringification
: "true" -
Khi đúng, Bazel sẽ chuyển đổi nhãn @//foo:bar thành @//foo:bar, thay vì //foo:bar. Điều này chỉ ảnh hưởng đến hành vi của str(), toán tử %, v.v.; hành vi của repr() không thay đổi. Hãy xem https://github.com/bazelbuild/bazel/issues/15916 để biết thêm thông tin.
Thẻ:loading_and_analysis
,incompatible_change
- Giá trị mặc định của
--[no]incompatible_use_cc_configure_from_rules_cc
: "false" -
Khi đúng, Bazel sẽ không còn cho phép sử dụng cc_configure từ @bazel_tools. Vui lòng xem https://github.com/bazelbuild/bazel/issues/10134 để biết thông tin chi tiết và hướng dẫn di chuyển.
Thẻ:loading_and_analysis
,incompatible_change
- Giá trị mặc định của
--[no]incompatible_use_plus_in_repo_names
: "false" - Nếu đúng, hãy sử dụng dấu cộng (+) làm dấu phân cách trong tên kho lưu trữ chính tắc, thay vì dấu ngã (~). Điều này là để giải quyết các vấn đề nghiêm trọng về hiệu suất trên Windows; hãy xem https://github.com/bazelbuild/bazel/issues/22865 để biết thêm thông tin.
Thẻ:loading_and_analysis
- Giá trị mặc định của
--[no]incompatible_visibility_private_attributes_at_definition
: "true" - Nếu được đặt thành true, chế độ hiển thị của các thuộc tính quy tắc riêng tư sẽ được kiểm tra theo định nghĩa quy tắc, quay lại chế độ sử dụng quy tắc nếu không hiển thị.
Thẻ:build_file_semantics
,incompatible_change
--max_computation_steps=<a long integer>
mặc định: "0"-
Số bước tính toán Starlark tối đa mà tệp BUILD có thể thực thi (0 nghĩa là không có giới hạn).
Thẻ:build_file_semantics
--nested_set_depth_limit=<an integer>
mặc định: "3500"-
Độ sâu tối đa của biểu đồ nội bộ trong một depset (còn gọi là NestedSet), trên đó hàm dựng depset() sẽ không thành công.
Thẻ:loading_and_analysis
--repositories_without_autoloads=<comma-separated set of options>
mặc định: ""-
Danh sách các kho lưu trữ bổ sung (ngoài các kho lưu trữ được mã hoá cứng mà Bazel biết) mà bạn không nên thêm tính năng tự động tải. Thuộc tính này thường chứa các kho lưu trữ phụ thuộc bắc cầu vào một kho lưu trữ có thể được tải tự động (và do đó có thể tạo ra một chu kỳ).
Thẻ:loses_incremental_state
,build_file_semantics
,incompatible_change
- Các tuỳ chọn kích hoạt tính năng tối ưu hoá thời gian xây dựng:
- Giá trị mặc định của
--[no]heuristically_drop_nodes
: "false" - Nếu đúng, Blaze sẽ xoá các nút FileState và DirectoryListingState sau khi hoàn tất nút File và DirectoryListing có liên quan để tiết kiệm bộ nhớ. Chúng tôi dự kiến rằng khả năng cần đến các nút này một lần nữa sẽ ít xảy ra hơn. Nếu có, chương trình sẽ đánh giá lại các giá trị đó.
Thẻ:loses_incremental_state
- Giá trị mặc định của
--[no]incompatible_do_not_split_linking_cmdline
: "true" -
Khi đúng, Bazel không còn sửa đổi các cờ dòng lệnh dùng để liên kết và cũng không chọn lọc quyết định cờ nào sẽ chuyển đến tệp param và cờ nào không. Hãy xem https://github.com/bazelbuild/bazel/issues/7670 để biết thông tin chi tiết.
Thẻ:loading_and_analysis
,incompatible_change
- Giá trị mặc định của
--[no]keep_state_after_build
: "true" - Nếu giá trị là false, Blaze sẽ loại bỏ trạng thái inmemory khỏi bản dựng này khi bản dựng hoàn tất. Các bản dựng tiếp theo sẽ không có bất kỳ sự gia tăng nào so với bản dựng này.
Thẻ:loses_incremental_state
- Giá trị mặc định của
--[no]track_incremental_state
: "true" - Nếu giá trị là false, Blaze sẽ không duy trì dữ liệu cho phép vô hiệu hoá và đánh giá lại trên các bản dựng gia tăng để tiết kiệm bộ nhớ trên bản dựng này. Các bản dựng tiếp theo sẽ không có bất kỳ sự gia tăng nào so với bản dựng này. Thông thường, bạn sẽ muốn chỉ định --batch khi đặt giá trị này thành false.
Thẻ:loses_incremental_state
- Các tuỳ chọn ảnh hưởng đến mức độ chi tiết, định dạng hoặc vị trí ghi nhật ký:
- Giá trị mặc định của
--[no]announce_rc
: "false" -
Liệu có thông báo các tuỳ chọn rc hay không.
Thẻ:affects_outputs
- Giá trị mặc định của
--[no]attempt_to_print_relative_paths
: "false" -
Khi in phần vị trí của thông báo, hãy cố gắng sử dụng đường dẫn tương ứng với thư mục không gian làm việc hoặc một trong các thư mục do --package_path chỉ định.
Thẻ:terminal_output
--bes_backend=<a string>
mặc định: ""-
Chỉ định điểm cuối phụ trợ của dịch vụ sự kiện bản dựng (BES) ở dạng [SCHEME://]HOST[:PORT]. Chế độ mặc định là tắt tính năng tải lên BES. Các giao thức được hỗ trợ là grpc và grpcs (grpc đã bật TLS). Nếu bạn không cung cấp lược đồ, Bazel sẽ giả định là grpcs.
Thẻ:affects_outputs
- Giá trị mặc định của
--[no]bes_check_preceding_lifecycle_events
: "false" -
Đặt trường check_preceding_lifecycle_events_present trên PublishBuildToolEventStreamRequest để yêu cầu BES kiểm tra xem trước đó có nhận được sự kiện InvocationAttemptStarted và BuildEnqueued khớp với sự kiện công cụ hiện tại hay không.
Thẻ:affects_outputs
--bes_header=<a 'name=value' assignment>
nhiều lần sử dụng được tích luỹ-
Chỉ định một tiêu đề ở dạng NAME=VALUE sẽ được đưa vào các yêu cầu BES. Bạn có thể truyền nhiều tiêu đề bằng cách chỉ định cờ nhiều lần. Nhiều giá trị cho cùng một tên sẽ được chuyển đổi thành danh sách được phân tách bằng dấu phẩy.
Thẻ:affects_outputs
--bes_instance_name=<a string>
mặc định: xem nội dung mô tả-
Chỉ định tên thực thể mà BES sẽ duy trì BEP đã tải lên. Giá trị mặc định là rỗng.
Thẻ:affects_outputs
--bes_keywords=<comma-separated list of options>
nhiều lần sử dụng được tích luỹ-
Chỉ định danh sách từ khoá thông báo sẽ được thêm vào nhóm từ khoá mặc định được phát hành cho BES ("command_name=<command_name> ", "protocol_name=BEP"). Giá trị mặc định là không có.
Thẻ:affects_outputs
- Giá trị mặc định của
--[no]bes_lifecycle_events
: "true" -
Chỉ định việc có xuất bản các sự kiện trong vòng đời của BES hay không. (mặc định là "true").
Thẻ:affects_outputs
--bes_oom_finish_upload_timeout=<An immutable length of time.>
mặc định: "10m"-
Chỉ định thời gian bazel phải chờ quá trình tải BES/BEP lên hoàn tất trong khi OOM. Cờ này đảm bảo việc chấm dứt khi JVM bị GC làm hao tổn nghiêm trọng và không thể tiến hành trên bất kỳ luồng người dùng nào.
Thẻ:bazel_monitoring
--bes_outerr_buffer_size=<an integer>
mặc định: "10240"-
Xác định kích thước tối đa của stdout hoặc stderr cần được lưu vào vùng đệm trong BEP, trước khi được báo cáo dưới dạng sự kiện tiến trình. Các lượt ghi riêng lẻ vẫn được báo cáo trong một sự kiện, ngay cả khi lớn hơn giá trị đã chỉ định lên đến --bes_outerr_chunk_size.
Thẻ:affects_outputs
--bes_outerr_chunk_size=<an integer>
mặc định: "1048576"- Chỉ định kích thước tối đa của stdout hoặc stderr sẽ được gửi đến BEP trong một thông báo.
Thẻ:affects_outputs
--bes_proxy=<a string>
mặc định: xem nội dung mô tả- Kết nối với Dịch vụ sự kiện bản dựng thông qua một proxy. Hiện tại, bạn chỉ có thể dùng cờ này để định cấu hình ổ cắm miền Unix (unix:/path/to/socket).
--bes_results_url=<a string>
mặc định: ""-
Chỉ định URL cơ sở mà người dùng có thể xem thông tin được truyền trực tuyến đến phần phụ trợ BES. Bazel sẽ xuất URL được nối thêm bằng mã gọi đến thiết bị đầu cuối.
Thẻ:terminal_output
--bes_system_keywords=<comma-separated list of options>
nhiều lần sử dụng được tích luỹ-
Chỉ định danh sách từ khoá thông báo cần đưa vào trực tiếp, không bao gồm tiền tố "user_keyword=" cho từ khoá được cung cấp thông qua --bes_keywords. Dành cho các toán tử dịch vụ Build (Tạo) đặt --bes_lifecycle_events=false và bao gồm các từ khoá khi gọi PublishLifecycleEvent. Việc tạo toán tử dịch vụ bằng cờ này sẽ ngăn người dùng ghi đè giá trị cờ.
Thẻ:affects_outputs
--bes_timeout=<An immutable length of time.>
mặc định: "0 giây"-
Chỉ định thời gian bazel phải đợi quá trình tải BES/BEP lên hoàn tất sau khi bản dựng và kiểm thử hoàn tất. Thời gian chờ hợp lệ là một số tự nhiên, theo sau là một đơn vị: Ngày (d), giờ (h), phút (m), giây (s) và mili giây (ms). Giá trị mặc định là "0", nghĩa là không có thời gian chờ.
Thẻ:affects_outputs
--bes_upload_mode=<wait_for_upload_complete, nowait_for_upload_complete or fully_async>
mặc định: "wait_for_upload_complete"-
Chỉ định xem quá trình tải Dịch vụ sự kiện bản dựng lên có nên chặn quá trình hoàn tất bản dựng hay không hoặc có nên kết thúc lệnh gọi ngay lập tức và hoàn tất quá trình tải lên ở chế độ nền hay không. "wait_for_upload_complete" (mặc định), "nowait_for_upload_complete" hoặc "fully_async".
Thẻ:eagerness_to_exit
--build_event_binary_file=<a string>
mặc định: ""- Nếu không để trống, hãy ghi một bản trình bày nhị phân được phân tách bằng varint của giao thức sự kiện bản dựng vào tệp đó. Tuỳ chọn này ngụ ý --bes_upload_mode=wait_for_upload_complete.
Thẻ:affects_outputs
- Giá trị mặc định của
--[no]build_event_binary_file_path_conversion
: "true" -
Chuyển đổi các đường dẫn trong bản trình bày tệp nhị phân của giao thức sự kiện bản dựng thành các URI hợp lệ trên toàn cầu bất cứ khi nào có thể; nếu bị tắt, giao thức uri file:// sẽ luôn được sử dụng
Thẻ:affects_outputs
--build_event_binary_file_upload_mode=<wait_for_upload_complete, nowait_for_upload_complete or fully_async>
mặc định: "wait_for_upload_complete"-
Chỉ định xem quá trình tải lên Dịch vụ sự kiện bản dựng cho --build_event_binary_file có nên chặn quá trình hoàn tất bản dựng hay không hoặc có nên kết thúc lệnh gọi ngay lập tức và hoàn tất quá trình tải lên ở chế độ nền hay không. "wait_for_upload_complete" (mặc định), "nowait_for_upload_complete" hoặc "fully_async".
Thẻ:eagerness_to_exit
--build_event_json_file=<a string>
mặc định: ""- Nếu không để trống, hãy ghi một chuỗi JSON của giao thức sự kiện bản dựng vào tệp đó. Tuỳ chọn này ngụ ý --bes_upload_mode=wait_for_upload_complete.
Thẻ:affects_outputs
- Giá trị mặc định của
--[no]build_event_json_file_path_conversion
: "true" -
Chuyển đổi các đường dẫn trong bản trình bày tệp json của giao thức sự kiện bản dựng thành các URI hợp lệ trên toàn cầu bất cứ khi nào có thể; nếu bị tắt, giao thức uri file:// sẽ luôn được sử dụng
Thẻ:affects_outputs
--build_event_json_file_upload_mode=<wait_for_upload_complete, nowait_for_upload_complete or fully_async>
mặc định: "wait_for_upload_complete"-
Chỉ định xem quá trình tải Dịch vụ sự kiện bản dựng lên cho --build_event_json_file có nên chặn quá trình hoàn tất bản dựng hay không hoặc có nên kết thúc lệnh gọi ngay lập tức và hoàn tất quá trình tải lên ở chế độ nền hay không. "wait_for_upload_complete" (mặc định), "nowait_for_upload_complete" hoặc "fully_async".
Thẻ:eagerness_to_exit
--build_event_max_named_set_of_file_entries=<an integer>
mặc định: "-1"-
Số mục nhập tối đa cho một sự kiện named_set_of_files; các giá trị nhỏ hơn 2 sẽ bị bỏ qua và không có sự kiện phân tách nào được thực hiện. Mục đích của việc này là giới hạn kích thước sự kiện tối đa trong giao thức sự kiện bản dựng, mặc dù không trực tiếp kiểm soát kích thước sự kiện. Tổng kích thước sự kiện là một hàm của cấu trúc tập hợp cũng như độ dài tệp và uri, điều này có thể phụ thuộc vào hàm băm.
Thẻ:affects_outputs
- Giá trị mặc định của
--[no]build_event_publish_all_actions
: "false" -
Liệu tất cả hành động có được xuất bản hay không.
Thẻ:affects_outputs
--build_event_text_file=<a string>
mặc định: ""- Nếu không trống, hãy ghi nội dung đại diện cho giao thức sự kiện bản dựng vào tệp đó
Thẻ:affects_outputs
- Giá trị mặc định của
--[no]build_event_text_file_path_conversion
: "true" -
Chuyển đổi các đường dẫn trong tệp văn bản đại diện cho giao thức sự kiện bản dựng thành các URI hợp lệ trên toàn cầu bất cứ khi nào có thể; nếu bị tắt, giao thức uri file:// sẽ luôn được sử dụng
Thẻ:affects_outputs
--build_event_text_file_upload_mode=<wait_for_upload_complete, nowait_for_upload_complete or fully_async>
mặc định: "wait_for_upload_complete"-
Chỉ định liệu quá trình tải lên Dịch vụ sự kiện bản dựng cho --build_event_text_file có nên chặn quá trình hoàn tất bản dựng hay không hoặc có nên kết thúc lệnh gọi ngay lập tức và hoàn tất quá trình tải lên ở chế độ nền hay không. "wait_for_upload_complete" (mặc định), "nowait_for_upload_complete" hoặc "fully_async".
Thẻ:eagerness_to_exit
- Giá trị mặc định của
--[no]experimental_announce_profile_path
: "false" - Nếu được bật, hãy thêm đường dẫn hồ sơ JSON vào nhật ký.
Thẻ:bazel_monitoring
- Giá trị mặc định của
--[no]experimental_bep_target_summary
: "false" - Liệu có xuất bản sự kiện TargetSummary hay không.
- Giá trị mặc định của
--[no]experimental_build_event_expand_filesets
: "false" - Nếu đúng, hãy mở rộng Filesets (Nhóm tệp) trong BEP khi trình bày các tệp đầu ra.
Thẻ:affects_outputs
- Giá trị mặc định của
--[no]experimental_build_event_fully_resolve_fileset_symlinks
: "false" - Nếu đúng, hãy phân giải đầy đủ các đường liên kết tượng trưng của Tập hợp tệp tương đối trong BEP khi trình bày các tệp đầu ra. Yêu cầu --experimental_build_event_expand_filesets.
Thẻ:affects_outputs
--experimental_build_event_upload_max_retries=<an integer>
mặc định: "4"-
Số lần tối đa mà Bazel sẽ thử tải lại một sự kiện bản dựng.
Thẻ:bazel_internal_configuration
--experimental_build_event_upload_retry_minimum_delay=<An immutable length of time.>
mặc định: "1 giây"-
Độ trễ ban đầu, tối thiểu để thử lại thời gian đợi luỹ thừa khi tải BEP không thành công. (chỉ số: 1,6)
Thẻ:bazel_internal_configuration
--experimental_build_event_upload_strategy=<a string>
mặc định: xem nội dung mô tả-
Chọn cách tải các cấu phần phần mềm được tham chiếu trong giao thức sự kiện bản dựng lên.
Thẻ:affects_outputs
- Giá trị mặc định của
--[no]experimental_collect_load_average_in_profiler
: "true" - Nếu được bật, trình phân tích tài nguyên sẽ thu thập mức tải trung bình tổng thể của hệ thống.
Thẻ:bazel_monitoring
- Giá trị mặc định của
--[no]experimental_collect_pressure_stall_indicators
: "false" - Nếu được bật, trình phân tích tài nguyên sẽ thu thập dữ liệu PSI của Linux.
Thẻ:bazel_monitoring
- Giá trị mặc định của
--[no]experimental_collect_resource_estimation
: "false" - Nếu được bật, trình phân tích tài nguyên sẽ thu thập thông tin ước tính về mức sử dụng CPU và bộ nhớ cho các thao tác cục bộ.
Thẻ:bazel_monitoring
- Giá trị mặc định của
--[no]experimental_collect_system_network_usage
: "false" - Nếu được bật, trình phân tích tài nguyên sẽ thu thập mức sử dụng mạng của hệ thống.
Thẻ:bazel_monitoring
- Giá trị mặc định của
--[no]experimental_collect_worker_data_in_profiler
: "false" - Nếu được bật, trình phân tích tài nguyên sẽ thu thập dữ liệu tài nguyên tổng hợp của worker.
Thẻ:bazel_monitoring
--experimental_profile_additional_tasks=<phase, action, action_check, action_lock, action_release, action_update, action_complete, bzlmod, info, create_package, remote_execution, local_execution, scanner, local_parse, upload_time, remote_process_time, remote_queue, remote_setup, fetch, local_process_time, vfs_stat, vfs_dir, vfs_readlink, vfs_md5, vfs_xattr, vfs_delete, vfs_open, vfs_read, vfs_write, vfs_glob, vfs_vmfs_stat, vfs_vmfs_dir, vfs_vmfs_read, wait, thread_name, thread_sort_index, skyframe_eval, skyfunction, critical_path, critical_path_component, handle_gc_notification, action_counts, action_cache_counts, local_cpu_usage, system_cpu_usage, cpu_usage_estimation, local_memory_usage, system_memory_usage, memory_usage_estimation, system_network_up_usage, system_network_down_usage, workers_memory_usage, system_load_average, starlark_parser, starlark_user_fn, starlark_builtin_fn, starlark_user_compiled_fn, starlark_repository_fn, action_fs_staging, remote_cache_check, remote_download, remote_network, filesystem_traversal, worker_execution, worker_setup, worker_borrow, worker_working, worker_copying_outputs, credential_helper, pressure_stall_io, pressure_stall_memory, conflict_check, dynamic_lock, repository_fetch, repository_vendor or unknown>
nhiều lần sử dụng được tích luỹ-
Chỉ định các tác vụ hồ sơ bổ sung cần đưa vào hồ sơ.
Thẻ:bazel_monitoring
- Giá trị mặc định của
--[no]experimental_profile_include_primary_output
: "false" -
Bao gồm thuộc tính "out" bổ sung trong các sự kiện hành động chứa đường dẫn thực thi đến đầu ra chính của hành động.
Thẻ:bazel_monitoring
- Giá trị mặc định của
--[no]experimental_profile_include_target_label
: "false" -
Bao gồm nhãn mục tiêu trong dữ liệu hồ sơ JSON của sự kiện hành động.
Thẻ:bazel_monitoring
- Giá trị mặc định của
--[no]experimental_run_bep_event_include_residue
: "false" -
Liệu có đưa phần dư thừa dòng lệnh vào các sự kiện bản dựng chạy có thể chứa phần dư thừa đó hay không. Theo mặc định, phần dư không được đưa vào các sự kiện bản dựng lệnh chạy có thể chứa phần dư.
Thẻ:affects_outputs
- Giá trị mặc định của
--[no]experimental_stream_log_file_uploads
: "false" -
Tải tệp nhật ký trực tuyến lên bộ nhớ từ xa thay vì ghi vào ổ đĩa.
Thẻ:affects_outputs
--experimental_workspace_rules_log_file=<a path>
mặc định: xem nội dung mô tả- Ghi lại một số sự kiện Quy tắc Workspace nhất định vào tệp này dưới dạng proto WorkspaceEvent được phân tách.
- Giá trị mặc định của
--[no]generate_json_trace_profile
: "tự động" - Nếu được bật, Bazel sẽ lập hồ sơ bản dựng và ghi hồ sơ ở định dạng JSON vào một tệp trong cơ sở đầu ra. Xem hồ sơ bằng cách tải vào chrome://tracing. Theo mặc định, Bazel sẽ ghi hồ sơ cho tất cả các lệnh và truy vấn giống như bản dựng.
Thẻ:bazel_monitoring
- Giá trị mặc định của
--[no]heap_dump_on_oom
: "false" -
Liệu có xuất tệp báo lỗi OOM theo cách thủ công nếu xảy ra lỗi OOM (bao gồm cả lỗi OOM theo cách thủ công do đạt đến --gc_thrashing_limits) hay không. Tệp báo lỗi sẽ được ghi vào <output_base>/<invocation_id>.heapdump.hprof. Tuỳ chọn này thay thế hiệu quả -XX:+HeapDumpOnOutOfMemoryError, không có hiệu lực đối với OOM thủ công.
Thẻ:bazel_monitoring
- Giá trị mặc định của
--[no]legacy_important_outputs
: "true" -
Sử dụng thuộc tính này để ngăn tạo trường important_outputs cũ trong sự kiện TargetComplete. Bạn cần có important_outputs để tích hợp Bazel với ResultStore.
Thẻ:affects_outputs
--logging=<0 <= an integer <= 6>
mặc định: "3"-
Cấp độ ghi nhật ký.
Thẻ:affects_outputs
--memory_profile=<a path>
mặc định: xem nội dung mô tả- Nếu được đặt, hãy ghi dữ liệu mức sử dụng bộ nhớ vào tệp đã chỉ định khi kết thúc giai đoạn và vùng nhớ khối xếp ổn định vào nhật ký chính khi kết thúc bản dựng.
Thẻ:bazel_monitoring
--memory_profile_stable_heap_parameters=<integers, separated by a comma expected in pairs>
mặc định: "1,0"-
Điều chỉnh tính toán của hồ sơ bộ nhớ về vùng nhớ khối xếp ổn định ở cuối bản dựng. Phải là số chẵn số nguyên được phân tách bằng dấu phẩy. Trong mỗi cặp, số nguyên đầu tiên là số lần GC cần thực hiện. Số nguyên thứ hai trong mỗi cặp là số giây chờ giữa các GC. Ví dụ: 2,4,4,0 sẽ là 2 GC với thời điểm tạm dừng 4 giây, theo sau là 4 GC với thời điểm tạm dừng 0 giây
Thẻ:bazel_monitoring
--profile=<a path>
mặc định: xem nội dung mô tả- Nếu được đặt, hãy lập hồ sơ Bazel và ghi dữ liệu vào tệp đã chỉ định. Sử dụng bazel analyze-profile để phân tích hồ sơ.
Thẻ:bazel_monitoring
- Giá trị mặc định của
--[no]record_full_profiler_data
: "false" - Theo mặc định, trình phân tích tài nguyên Bazel sẽ chỉ ghi lại dữ liệu tổng hợp cho các sự kiện nhanh nhưng nhiều (chẳng hạn như tạo tệp). Nếu bạn bật tuỳ chọn này, trình phân tích tài nguyên sẽ ghi lại từng sự kiện – dẫn đến dữ liệu phân tích tài nguyên chính xác hơn nhưng hiệu suất bị ảnh hưởng LỚN. Tuỳ chọn này chỉ có hiệu lực nếu bạn cũng sử dụng --profile.
Thẻ:bazel_monitoring
- Giá trị mặc định của
--remote_print_execution_messages=<failure, success or all>
: "failure" -
Chọn thời điểm in thông báo thực thi từ xa. Các giá trị hợp lệ là "failure" (lỗi) để chỉ in khi xảy ra lỗi, "success" (thành công) để chỉ in khi thành công và "all" (tất cả) để luôn in.
Thẻ:terminal_output
- Giá trị mặc định của
--[no]slim_profile
: "true" - Giảm kích thước của hồ sơ JSON bằng cách hợp nhất các sự kiện nếu hồ sơ quá lớn.
Thẻ:bazel_monitoring
--starlark_cpu_profile=<a string>
mặc định: ""- Ghi vào tệp đã chỉ định hồ sơ pprof về mức sử dụng CPU của tất cả luồng Starlark.
Thẻ:bazel_monitoring
--tool_tag=<a string>
mặc định: ""-
Tên công cụ để phân bổ lệnh gọi Bazel này.
Thẻ:affects_outputs
,bazel_monitoring
--ui_event_filters=<Convert list of comma separated event kind to list of filters>
nhiều lần sử dụng được tích luỹ- Chỉ định những sự kiện sẽ hiển thị trong giao diện người dùng. Bạn có thể thêm hoặc xoá các sự kiện vào các sự kiện mặc định bằng cách sử dụng dấu +/- ở đầu hoặc ghi đè hoàn toàn tập hợp mặc định bằng cách chỉ định trực tiếp. Tập hợp các loại sự kiện được hỗ trợ bao gồm INFO, DEBUG, ERROR và nhiều loại khác.
Thẻ:terminal_output
- Các tuỳ chọn lưu vào bộ nhớ đệm và thực thi từ xa:
--experimental_circuit_breaker_strategy=<failure>
mặc định: xem nội dung mô tả- Chỉ định chiến lược để cầu dao sử dụng. Các chiến lược có thể sử dụng là "không thành công". Đối với giá trị không hợp lệ cho tuỳ chọn, hành vi giống như tuỳ chọn sẽ không được đặt.
Thẻ:execution
- Giá trị mặc định của
--[no]experimental_guard_against_concurrent_changes
: "false" - Tắt tuỳ chọn này để tắt tính năng kiểm tra ctime của tệp đầu vào của một thao tác trước khi tải tệp đó lên bộ nhớ đệm từ xa. Có thể xảy ra trường hợp nhân Linux trì hoãn việc ghi tệp, điều này có thể gây ra kết quả dương tính giả.
- Giá trị mặc định của
--[no]experimental_remote_cache_async
: "false" - Nếu đúng, I/O bộ nhớ đệm từ xa sẽ diễn ra ở chế độ nền thay vì diễn ra trong quá trình tạo.
--experimental_remote_cache_compression_threshold=<an integer>
mặc định: "0"- Kích thước blob tối thiểu cần thiết để nén/giải nén bằng zstd. Không có hiệu lực trừ khi bạn đặt --remote_cache_compression.
- Giá trị mặc định của
--[no]experimental_remote_cache_lease_extension
: "false" - Nếu bạn đặt thành true, Bazel sẽ gia hạn thời gian thuê cho các đầu ra của các thao tác từ xa trong quá trình xây dựng bằng cách gửi định kỳ các lệnh gọi "FindMissingBlobs" đến bộ nhớ đệm từ xa. Tần suất dựa trên giá trị của `--experimental_remote_cache_ttl`.
--experimental_remote_cache_ttl=<An immutable length of time.>
mặc định: "3h"-
TTL tối thiểu được đảm bảo của các blob trong bộ nhớ đệm từ xa sau khi các chuỗi đại diện của chúng được tham chiếu gần đây, ví dụ: bằng ActionResult hoặc FindMissingBlobs. Bazel thực hiện một số hoạt động tối ưu hoá dựa trên TTL của các blob, ví dụ: không gọi lại GetActionResult trong một bản dựng gia tăng. Bạn nên đặt giá trị này thấp hơn một chút so với TTL thực tế vì có một khoảng thời gian giữa thời điểm máy chủ trả về chuỗi đại diện và thời điểm Bazel nhận được chuỗi đại diện đó.
Thẻ:execution
--experimental_remote_capture_corrupted_outputs=<a path>
mặc định: xem nội dung mô tả- Đường dẫn đến thư mục nơi các đầu ra bị hỏng sẽ được lưu vào.
- Giá trị mặc định của
--[no]experimental_remote_discard_merkle_trees
: "false" - Nếu được đặt thành true, hãy loại bỏ các bản sao trong bộ nhớ của cây Merkle của gốc đầu vào và các ánh xạ đầu vào liên quan trong các lệnh gọi đến GetActionResult() và Execute(). Điều này làm giảm đáng kể mức sử dụng bộ nhớ, nhưng yêu cầu Bazel tính toán lại các bản sao đó khi không tìm thấy bộ nhớ đệm từ xa và thử lại.
--experimental_remote_downloader=<a string>
mặc định: xem nội dung mô tả- URI điểm cuối của API thành phần từ xa, dùng làm proxy tải xuống từ xa. Các giản đồ được hỗ trợ là grpc, grpcs (grpc đã bật TLS) và unix (ổ cắm UNIX cục bộ). Nếu bạn không cung cấp giản đồ, Bazel sẽ mặc định sử dụng grpcs. Xem: https://github.com/bazelbuild/remote-apis/blob/master/build/bazel/remote/asset/v1/remote_asset.proto
- Giá trị mặc định của
--[no]experimental_remote_downloader_local_fallback
: "false" - Liệu có quay lại trình tải xuống cục bộ nếu trình tải xuống từ xa không thành công hay không.
- Giá trị mặc định của
--[no]experimental_remote_execution_keepalive
: "false" - Liệu có nên sử dụng tính năng duy trì kết nối cho các lệnh gọi thực thi từ xa hay không.
--experimental_remote_failure_rate_threshold=<an integer in 0-100 range>
mặc định: "10"-
Đặt số tỷ lệ lỗi được phép theo tỷ lệ phần trăm cho một khoảng thời gian cụ thể, sau đó sẽ ngừng gọi đến bộ nhớ đệm/trình thực thi từ xa. Theo mặc định, giá trị này là 10. Việc đặt giá trị này thành 0 có nghĩa là không có giới hạn.
Thẻ:execution
--experimental_remote_failure_window_interval=<An immutable length of time.>
mặc định: "60 giây"- Khoảng thời gian tính tỷ lệ lỗi của các yêu cầu từ xa. Đối với giá trị bằng 0 hoặc giá trị âm, thời lượng lỗi được tính là toàn bộ thời lượng thực thi.Bạn có thể sử dụng các đơn vị sau: Ngày (d), giờ (h), phút (m), giây (s) và mili giây (ms). Nếu bạn bỏ qua đơn vị, giá trị này sẽ được hiểu là giây.
Thẻ:execution
- Giá trị mặc định của
--[no]experimental_remote_mark_tool_inputs
: "false" - Nếu bạn đặt thành true, Bazel sẽ đánh dấu dữ liệu đầu vào là dữ liệu đầu vào của công cụ cho trình thực thi từ xa. Bạn có thể dùng tính năng này để triển khai worker liên tục từ xa.
- Giá trị mặc định của
--[no]experimental_remote_merkle_tree_cache
: "false" - Nếu bạn đặt thành true, các phép tính trên cây Merkle sẽ được lưu vào bộ nhớ đệm để cải thiện tốc độ kiểm tra lượt truy cập vào bộ nhớ đệm từ xa. Mức sử dụng bộ nhớ của bộ nhớ đệm được kiểm soát bằng --experimental_remote_merkle_tree_cache_size.
--experimental_remote_merkle_tree_cache_size=<a long integer>
mặc định: "1000"- Số lượng cây Merkle cần lưu vào bộ nhớ đệm để cải thiện tốc độ kiểm tra lượt truy cập vào bộ nhớ đệm từ xa. Mặc dù bộ nhớ đệm được tự động cắt bớt theo cách xử lý tham chiếu mềm của Java, nhưng lỗi hết bộ nhớ có thể xảy ra nếu bạn đặt quá cao. Nếu bạn đặt thành 0, kích thước bộ nhớ đệm sẽ không giới hạn. Giá trị tối ưu thay đổi tuỳ thuộc vào kích thước của dự án. Giá trị mặc định là 1000.
--experimental_remote_output_service=<a string>
mặc định: xem nội dung mô tả- HOST hoặc HOST:PORT của điểm cuối dịch vụ đầu ra từ xa. Các giản đồ được hỗ trợ là grpc, grpcs (grpc đã bật TLS) và unix (ổ cắm UNIX cục bộ). Nếu bạn không cung cấp giản đồ, Bazel sẽ mặc định sử dụng grpcs. Chỉ định giản đồ grpc:// hoặc unix: để tắt TLS.
--experimental_remote_output_service_output_path_prefix=<a string>
mặc định: ""- Đường dẫn chứa nội dung của các thư mục đầu ra do --experimental_remote_output_service quản lý. Thư mục đầu ra thực tế mà bản dựng sử dụng sẽ là thư mục con của đường dẫn này và do dịch vụ đầu ra xác định.
- Giá trị mặc định của
--[no]experimental_remote_require_cached
: "false" - Nếu bạn đặt thành đúng, hãy thực thi việc lưu tất cả các thao tác có thể chạy từ xa vào bộ nhớ đệm, nếu không bản dựng sẽ không thành công. Điều này hữu ích để khắc phục các vấn đề không xác định vì cho phép kiểm tra xem các hành động cần được lưu vào bộ nhớ đệm có thực sự được lưu vào bộ nhớ đệm hay không mà không cần chèn kết quả mới vào bộ nhớ đệm một cách ngẫu nhiên.
--experimental_remote_scrubbing_config=<Converts to a Scrubber>
mặc định: xem nội dung mô tả- Bật tính năng xoá khoá bộ nhớ đệm từ xa bằng tệp cấu hình được cung cấp, tệp này phải là vùng đệm giao thức ở định dạng văn bản (xem src/main/protobuf/remote_scrubbing.proto). Tính năng này nhằm hỗ trợ việc chia sẻ bộ nhớ đệm từ xa/bộ nhớ đệm trên ổ đĩa giữa các thao tác thực thi trên nhiều nền tảng nhưng nhắm đến cùng một nền tảng. Bạn nên sử dụng tính năng này một cách thận trọng vì các chế độ cài đặt không phù hợp có thể khiến các mục nhập bộ nhớ đệm bị vô tình chia sẻ và dẫn đến các bản dựng không chính xác. Việc xoá không ảnh hưởng đến cách thực thi một hành động, mà chỉ ảnh hưởng đến cách tính toán khoá bộ nhớ đệm từ xa/đĩa của hành động đó cho mục đích truy xuất hoặc lưu trữ kết quả của hành động. Các thao tác đã xoá không tương thích với việc thực thi từ xa và sẽ luôn được thực thi cục bộ. Việc sửa đổi cấu hình xoá sẽ không làm mất hiệu lực các đầu ra có trong hệ thống tệp cục bộ hoặc bộ nhớ đệm nội bộ; bạn cần có một bản dựng sạch để thực thi lại các hành động bị ảnh hưởng. Để sử dụng thành công tính năng này, bạn nên đặt --host_platform tuỳ chỉnh cùng với --experimental_platform_in_output_dir (để chuẩn hoá tiền tố đầu ra) và --incompatible_strict_action_env (để chuẩn hoá các biến môi trường).
- Giá trị mặc định của
--[no]incompatible_remote_build_event_upload_respect_no_cache
: "false" - Không dùng nữa. Không hoạt động. Thay vào đó, hãy sử dụng --remote_build_event_upload=minimal.
- Giá trị mặc định của
--[no]incompatible_remote_downloader_send_all_headers
: "true" -
Liệu có gửi tất cả giá trị của tiêu đề nhiều giá trị đến trình tải xuống từ xa thay vì chỉ giá trị đầu tiên hay không.
Thẻ:incompatible_change
- Giá trị mặc định của
--[no]incompatible_remote_output_paths_relative_to_input_root
: "false" - Nếu bạn đặt thành true, đường dẫn đầu ra sẽ tương ứng với thư mục gốc đầu vào thay vì thư mục đang hoạt động.
Thẻ:incompatible_change
- Giá trị mặc định của
--[no]incompatible_remote_results_ignore_disk
: "true" - Thẻ
không hoạt động:incompatible_change
- Giá trị mặc định của
--[no]remote_accept_cached
: "true" - Liệu có chấp nhận kết quả hành động được lưu vào bộ nhớ đệm từ xa hay không.
--remote_build_event_upload=<all or minimal>
mặc định: "minimal"- Nếu được đặt thành "tất cả", tất cả đầu ra cục bộ mà BEP tham chiếu sẽ được tải lên bộ nhớ đệm từ xa. Nếu bạn đặt thành "minimal" (tối thiểu), thì các đầu ra cục bộ mà BEP tham chiếu sẽ không được tải lên bộ nhớ đệm từ xa, ngoại trừ các tệp quan trọng đối với người dùng BEP (ví dụ: nhật ký kiểm thử và hồ sơ thời gian). Lược đồ bytestream:// luôn được dùng cho uri của các tệp ngay cả khi các tệp đó bị thiếu trong bộ nhớ đệm từ xa. Giá trị mặc định là "minimal" (tối thiểu).
--remote_bytestream_uri_prefix=<a string>
mặc định: xem nội dung mô tả- Tên máy chủ và tên thực thể sẽ được sử dụng trong các URI bytestream:// được ghi vào luồng sự kiện bản dựng. Bạn có thể đặt tuỳ chọn này khi các bản dựng được thực hiện bằng proxy, khiến các giá trị của --remote_executor và --remote_instance_name không còn tương ứng với tên chuẩn của dịch vụ thực thi từ xa. Nếu không được đặt, giá trị này sẽ mặc định là "${hostname}/${instance_name}".
--remote_cache=<a string>
mặc định: xem nội dung mô tả- URI của điểm cuối lưu vào bộ nhớ đệm. Các giản đồ được hỗ trợ là http, https, grpc, grpcs (grpc đã bật TLS) và unix (ổ cắm UNIX cục bộ). Nếu bạn không cung cấp giản đồ, Bazel sẽ mặc định sử dụng grpcs. Chỉ định giao thức grpc://, http:// hoặc unix: để tắt TLS. Xem https://bazel.build/remote/caching
- Giá trị mặc định của
--[no]remote_cache_compression
: "false" - Nếu được bật, hãy nén/giải nén các blob bộ nhớ đệm bằng zstd khi kích thước của các blob đó ít nhất là --experimental_remote_cache_compression_threshold.
--remote_cache_header=<a 'name=value' assignment>
nhiều lần sử dụng được tích luỹ- Chỉ định một tiêu đề sẽ có trong các yêu cầu bộ nhớ đệm: --remote_cache_header=Name=Value. Bạn có thể truyền nhiều tiêu đề bằng cách chỉ định cờ nhiều lần. Nhiều giá trị cho cùng một tên sẽ được chuyển đổi thành danh sách được phân tách bằng dấu phẩy.
--remote_default_exec_properties=<a 'name=value' assignment>
nhiều lần sử dụng được tích luỹ- Đặt các thuộc tính exec mặc định để dùng làm nền tảng thực thi từ xa nếu nền tảng thực thi chưa đặt exec_properties.
Thẻ:affects_outputs
--remote_default_platform_properties=<a string>
mặc định: ""- Đặt các thuộc tính nền tảng mặc định để đặt cho API thực thi từ xa, nếu nền tảng thực thi chưa đặt remote_execution_properties. Giá trị này cũng sẽ được dùng nếu nền tảng lưu trữ được chọn làm nền tảng thực thi để thực thi từ xa.
--remote_download_regex=<a valid Java regular expression>
nhiều lần sử dụng được tích luỹ- Buộc tải các đầu ra bản dựng từ xa có đường dẫn khớp với mẫu này, bất kể --remote_download_outputs. Bạn có thể chỉ định nhiều mẫu bằng cách lặp lại cờ này.
Thẻ:affects_outputs
--remote_downloader_header=<a 'name=value' assignment>
nhiều lần sử dụng được tích luỹ- Chỉ định một tiêu đề sẽ có trong các yêu cầu trình tải xuống từ xa: --remote_downloader_header=Name=Value. Bạn có thể truyền nhiều tiêu đề bằng cách chỉ định cờ nhiều lần. Nhiều giá trị cho cùng một tên sẽ được chuyển đổi thành danh sách được phân tách bằng dấu phẩy.
--remote_exec_header=<a 'name=value' assignment>
nhiều lần sử dụng được tích luỹ- Chỉ định một tiêu đề sẽ có trong các yêu cầu thực thi: --remote_exec_header=Name=Value. Bạn có thể truyền nhiều tiêu đề bằng cách chỉ định cờ nhiều lần. Nhiều giá trị cho cùng một tên sẽ được chuyển đổi thành danh sách được phân tách bằng dấu phẩy.
--remote_execution_priority=<an integer>
mặc định: "0"- Mức độ ưu tiên tương đối của các hành động sẽ được thực thi từ xa. Ngữ nghĩa của các giá trị ưu tiên cụ thể phụ thuộc vào máy chủ.
--remote_executor=<a string>
mặc định: xem nội dung mô tả- HOST hoặc HOST:PORT của một điểm cuối thực thi từ xa. Các giản đồ được hỗ trợ là grpc, grpcs (grpc đã bật TLS) và unix (ổ cắm UNIX cục bộ). Nếu bạn không cung cấp giản đồ, Bazel sẽ mặc định sử dụng grpcs. Chỉ định giản đồ grpc:// hoặc unix: để tắt TLS.
--remote_grpc_log=<a path>
mặc định: xem nội dung mô tả- Nếu được chỉ định, đường dẫn đến tệp để ghi lại thông tin chi tiết liên quan đến lệnh gọi gRPC. Nhật ký này bao gồm một chuỗi các protobuf com.google.devtools.build.lib.remote.logging.RemoteExecutionLog.LogEntry đã chuyển đổi tuần tự, trong đó mỗi thông báo có tiền tố là một varint biểu thị kích thước của thông báo protobuf đã chuyển đổi tuần tự sau, như được thực hiện bằng phương thức LogEntry.writeDelimitedTo(OutputStream).
--remote_header=<a 'name=value' assignment>
nhiều lần sử dụng được tích luỹ- Chỉ định một tiêu đề sẽ được đưa vào các yêu cầu: --remote_header=Name=Value. Bạn có thể truyền nhiều tiêu đề bằng cách chỉ định cờ nhiều lần. Nhiều giá trị cho cùng một tên sẽ được chuyển đổi thành danh sách được phân tách bằng dấu phẩy.
--remote_instance_name=<a string>
mặc định: ""- Giá trị cần truyền dưới dạng instance_name trong API thực thi từ xa.
- Giá trị mặc định của
--[no]remote_local_fallback
: "false" - Liệu có quay lại chiến lược thực thi cục bộ độc lập nếu thực thi từ xa không thành công hay không.
--remote_local_fallback_strategy=<a string>
mặc định: "local"- Không hoạt động, không dùng nữa. Hãy xem https://github.com/bazelbuild/bazel/issues/7480 để biết thông tin chi tiết.
- Giá trị mặc định của
--remote_max_connections=<an integer>
: "100" - Giới hạn số lượng kết nối đồng thời tối đa đến bộ nhớ đệm/trình thực thi từ xa. Theo mặc định, giá trị này là 100. Việc đặt giá trị này thành 0 có nghĩa là không có giới hạn.
Đối với bộ nhớ đệm từ xa HTTP, một kết nối TCP có thể xử lý một yêu cầu tại một thời điểm, vì vậy, Bazel có thể tạo tối đa --remote_max_connections yêu cầu đồng thời.
Đối với bộ nhớ đệm/trình thực thi từ xa gRPC, một kênh gRPC thường có thể xử lý hơn 100 yêu cầu đồng thời, vì vậy, Bazel có thể tạo khoảng `--remote_max_connections * 100` yêu cầu đồng thời.
Thẻ:host_machine_resource_optimizations
--remote_proxy=<a string>
mặc định: xem nội dung mô tả- Kết nối với bộ nhớ đệm từ xa thông qua proxy. Hiện tại, bạn chỉ có thể dùng cờ này để định cấu hình ổ cắm miền Unix (unix:/path/to/socket).
--remote_result_cache_priority=<an integer>
mặc định: "0"- Mức độ ưu tiên tương đối của các thao tác từ xa sẽ được lưu trữ trong bộ nhớ đệm từ xa. Ngữ nghĩa của các giá trị ưu tiên cụ thể phụ thuộc vào máy chủ.
--remote_retries=<an integer>
mặc định: "5"- Số lần thử tối đa để thử lại một lỗi tạm thời. Nếu bạn đặt thành 0, thì tính năng thử lại sẽ bị tắt.
--remote_retry_max_delay=<An immutable length of time.>
mặc định: "5 giây"- Độ trễ thời gian đợi tối đa giữa các lần thử lại từ xa. Bạn có thể sử dụng các đơn vị sau: Ngày (d), giờ (h), phút (m), giây (s) và mili giây (ms). Nếu bạn bỏ qua đơn vị, giá trị này sẽ được hiểu là giây.
--remote_timeout=<An immutable length of time.>
mặc định: "60 giây"- Thời gian tối đa để chờ thực thi từ xa và các lệnh gọi bộ nhớ đệm. Đối với bộ nhớ đệm REST, đây là cả thời gian chờ kết nối và thời gian chờ đọc. Bạn có thể sử dụng các đơn vị sau: Ngày (d), giờ (h), phút (m), giây (s) và mili giây (ms). Nếu bạn bỏ qua đơn vị, giá trị này sẽ được hiểu là giây.
- Giá trị mặc định của
--[no]remote_upload_local_results
: "true" - Liệu có tải kết quả hành động được thực thi cục bộ lên bộ nhớ đệm từ xa hay không nếu bộ nhớ đệm từ xa hỗ trợ và người dùng được phép thực hiện việc này.
- Giá trị mặc định của
--[no]remote_verify_downloads
: "true" - Nếu được đặt thành true, Bazel sẽ tính tổng hàm băm của tất cả tệp tải xuống từ xa và loại bỏ các giá trị được lưu vào bộ nhớ đệm từ xa nếu các giá trị đó không khớp với giá trị dự kiến.
- Các tuỳ chọn khác, không được phân loại theo cách khác.:
--build_metadata=<a 'name=value' assignment>
nhiều lần sử dụng được tích luỹ-
Cặp chuỗi khoá-giá trị tuỳ chỉnh để cung cấp trong một sự kiện bản dựng.
Thẻ:terminal_output
- Giá trị mặc định của
--color=<yes, no or auto>
: "tự động" - Sử dụng các chế độ điều khiển dòng lệnh để tô màu đầu ra.
--config=<a string>
nhiều lần sử dụng được tích luỹ- Chọn các phần cấu hình bổ sung từ tệp rc; đối với mỗi <command>, phần này cũng lấy các tuỳ chọn từ <command>:<config> nếu có phần như vậy; nếu phần này không tồn tại trong tệp .rc nào, Blaze sẽ không thành công và báo lỗi. Các phần cấu hình và tổ hợp cờ tương đương với các phần cấu hình và tổ hợp cờ này nằm trong tệp cấu hình tools/*.blazerc.
--credential_helper=<Path to a credential helper. It may be absolute, relative to the PATH environment variable, or %workspace%-relative. The path be optionally prefixed by a scope followed by an '='. The scope is a domain name, optionally with a single leading '*' wildcard component. A helper applies to URIs matching its scope, with more specific scopes preferred. If a helper has no scope, it applies to every URI.>
nhiều lần sử dụng được tích luỹ- Định cấu hình trình trợ giúp thông tin xác thực tuân thủ <a href="https://github.com/EngFlow/credential-helper-spec">Thông số kỹ thuật của trình trợ giúp thông tin xác thực</a> để sử dụng cho việc truy xuất thông tin xác thực uỷ quyền cho việc tìm nạp kho lưu trữ, lưu vào bộ nhớ đệm từ xa và thực thi, cũng như dịch vụ sự kiện bản dựng. Thông tin xác thực do trình trợ giúp cung cấp được ưu tiên hơn thông tin xác thực do `--google_default_credentials`, `--google_credentials`, tệp `.netrc` hoặc tham số xác thực cung cấp cho `repository_ctx.download()` và `repository_ctx.download_and_extract()`. Có thể được chỉ định nhiều lần để thiết lập nhiều trình trợ giúp. Hãy xem https://blog.engflow.com/2023/10/09/configuring-bazels-credential-helper/ để biết hướng dẫn.
--credential_helper_cache_duration=<An immutable length of time.>
mặc định: "30m"- Thời lượng mặc định mà thông tin xác thực do trình trợ giúp thông tin xác thực cung cấp được lưu vào bộ nhớ đệm nếu trình trợ giúp không cung cấp thời điểm thông tin xác thực hết hạn.
--credential_helper_timeout=<An immutable length of time.>
mặc định: "10 giây"- Định cấu hình thời gian chờ cho trình trợ giúp thông tin xác thực. Nếu trình trợ giúp thông tin xác thực không phản hồi trong khoảng thời gian chờ này, thì lệnh gọi sẽ không thành công.
- Giá trị mặc định của
--curses=<yes, no or auto>
: "tự động" - Sử dụng các nút điều khiển con trỏ của thiết bị đầu cuối để giảm thiểu đầu ra cuộn.
--disk_cache=<a path>
mặc định: xem nội dung mô tả- Đường dẫn đến thư mục mà Bazel có thể đọc và ghi các hành động cũng như kết quả hành động. Nếu thư mục không tồn tại, thư mục đó sẽ được tạo.
- Giá trị mặc định của
--[no]enable_platform_specific_config
: "false" - Nếu đúng, Bazel sẽ nhận các dòng cấu hình dành riêng cho máy chủ lưu trữ-hệ điều hành từ các tệp bazelrc. Ví dụ: nếu hệ điều hành lưu trữ là Linux và bạn chạy bản dựng bazel, thì Bazel sẽ chọn các dòng bắt đầu bằng build:linux. Các giá trị nhận dạng hệ điều hành được hỗ trợ là linux, macos, windows, freebsd và openbsd. Việc bật cờ này tương đương với việc sử dụng --config=linux trên Linux, --config=windows trên Windows, v.v.
--experimental_disk_cache_gc_idle_delay=<An immutable length of time.>
mặc định: "5m"- Thời gian mà máy chủ phải ở trạng thái rảnh trước khi quá trình thu gom rác của bộ nhớ đệm trên ổ đĩa diễn ra. Để chỉ định chính sách thu gom rác, hãy đặt --experimental_disk_cache_gc_max_size và/hoặc --experimental_disk_cache_gc_max_age.
--experimental_disk_cache_gc_max_age=<An immutable length of time.>
mặc định: "0"- Nếu bạn đặt thành một giá trị dương, bộ nhớ đệm trên ổ đĩa sẽ được thu thập rác định kỳ để xoá các mục cũ hơn tuổi này. Nếu được đặt cùng với --experimental_disk_cache_gc_max_size, cả hai tiêu chí sẽ được áp dụng. Quá trình thu gom rác diễn ra ở chế độ nền sau khi máy chủ trở nên rảnh, như được xác định bằng cờ --experimental_disk_cache_gc_idle_delay.
--experimental_disk_cache_gc_max_size=<a size in bytes, optionally followed by a K, M, G or T multiplier>
mặc định: "0"- Nếu bạn đặt giá trị dương, bộ nhớ đệm ổ đĩa sẽ được thu thập rác định kỳ để luôn nằm trong kích thước này. Nếu được đặt cùng với --experimental_disk_cache_gc_max_age, cả hai tiêu chí này sẽ được áp dụng. Quá trình thu gom rác diễn ra ở chế độ nền sau khi máy chủ trở nên rảnh, như được xác định bằng cờ --experimental_disk_cache_gc_idle_delay.
- Giá trị mặc định của
--[no]experimental_rule_extension_api
: "false" -
Bật API tiện ích quy tắc thử nghiệm và API quy tắc phụ
Thẻ:loading_and_analysis
,experimental
- Giá trị mặc định của
--[no]experimental_windows_watchfs
: "false" - Nếu đúng, tính năng hỗ trợ Windows thử nghiệm cho --watchfs sẽ được bật. Nếu không, --watchfs sẽ không hoạt động trên Windows. Hãy nhớ bật cả --watchfs.
--google_auth_scopes=<comma-separated list of options>
mặc định: "https://www.googleapis.com/auth/cloud-platform"- Danh sách các phạm vi xác thực Google Cloud được phân tách bằng dấu phẩy.
--google_credentials=<a string>
mặc định: xem nội dung mô tả- Chỉ định tệp để lấy thông tin xác thực. Hãy xem https://cloud.google.com/docs/authentication để biết thông tin chi tiết.
- Giá trị mặc định của
--[no]google_default_credentials
: "false" - Liệu có sử dụng "Thông tin xác thực mặc định của ứng dụng trên Google" để xác thực hay không. Hãy xem https://cloud.google.com/docs/authentication để biết thông tin chi tiết. Tắt theo mặc định.
--grpc_keepalive_time=<An immutable length of time.>
mặc định: xem nội dung mô tả- Định cấu hình ping duy trì kết nối cho các kết nối gRPC đi. Nếu bạn đặt giá trị này, Bazel sẽ gửi ping sau khoảng thời gian không có thao tác đọc nào trên kết nối, nhưng chỉ khi có ít nhất một lệnh gọi gRPC đang chờ xử lý. Thời gian được coi là độ chi tiết giây; việc đặt giá trị nhỏ hơn một giây sẽ gây ra lỗi. Theo mặc định, ping duy trì kết nối sẽ bị tắt. Bạn nên phối hợp với chủ sở hữu dịch vụ trước khi bật chế độ cài đặt này. Ví dụ: để đặt giá trị 30 giây cho cờ này, bạn nên thực hiện như sau --grpc_keepalive_time=30s
--grpc_keepalive_timeout=<An immutable length of time.>
mặc định: "20 giây"- Định cấu hình thời gian chờ duy trì kết nối cho các kết nối gRPC đi. Nếu bạn bật ping duy trì kết nối bằng --grpc_keepalive_time, thì Bazel sẽ hết thời gian chờ kết nối nếu không nhận được phản hồi ping sau khoảng thời gian này. Thời gian được coi là độ chi tiết giây; việc đặt giá trị nhỏ hơn một giây sẽ gây ra lỗi. Nếu bạn tắt tính năng ping duy trì kết nối, thì chế độ cài đặt này sẽ bị bỏ qua.
- Giá trị mặc định của
--[no]incompatible_disable_non_executable_java_binary
: "false" - Nếu đúng, java_binary luôn có thể thực thi. Thuộc tính create_executable sẽ bị xoá.
Thẻ:loading_and_analysis
,incompatible_change
- Giá trị mặc định của
--[no]incompatible_disallow_symlink_file_to_dir
: "true" - Không hoạt động.
Thẻ:loading_and_analysis
,incompatible_change
--invocation_id=<a UUID>
mặc định: ""-
Giá trị nhận dạng duy nhất, ở định dạng UUID, cho lệnh đang chạy. Nếu giá trị được chỉ định rõ ràng, thì phương thức gọi phải đảm bảo tính duy nhất. UUID được in vào stderr, BEP và giao thức thực thi từ xa.
Thẻ:bazel_monitoring
,bazel_internal_configuration
- Giá trị mặc định của
--[no]progress_in_terminal_title
: "false" - Hiển thị tiến trình của lệnh trong tiêu đề của dòng lệnh. Hữu ích để xem bazel đang làm gì khi có nhiều thẻ dòng lệnh.
- Giá trị mặc định của
--[no]show_progress
: "true" - Hiển thị thông báo tiến trình trong quá trình tạo bản dựng.
--show_progress_rate_limit=<a double>
mặc định: "0,2"- Số giây tối thiểu giữa các thông báo tiến trình trong kết quả.
- Giá trị mặc định của
--[no]show_timestamps
: "false" - Thêm dấu thời gian vào tin nhắn
--tls_certificate=<a string>
mặc định: xem nội dung mô tả- Chỉ định đường dẫn đến một chứng chỉ TLS đáng tin cậy để ký chứng chỉ máy chủ.
--tls_client_certificate=<a string>
mặc định: xem nội dung mô tả- Chỉ định chứng chỉ ứng dụng TLS cần sử dụng; bạn cũng cần cung cấp khoá ứng dụng để bật tính năng xác thực ứng dụng.
--tls_client_key=<a string>
mặc định: xem nội dung mô tả- Chỉ định khoá ứng dụng TLS cần sử dụng; bạn cũng cần cung cấp chứng chỉ ứng dụng để bật tính năng xác thực ứng dụng.
--ui_actions_shown=<an integer>
mặc định: "8"- Số hành động đồng thời hiển thị trong thanh tiến trình chi tiết; mỗi hành động hiển thị trên một dòng riêng biệt. Thanh tiến trình luôn hiển thị ít nhất một phần trăm, tất cả các số nhỏ hơn 1 đều được liên kết với 1.
Thẻ:terminal_output
- Giá trị mặc định của
--[no]watchfs
: "false" - Trên Linux/macOS: Nếu đúng, bazel sẽ cố gắng sử dụng dịch vụ theo dõi tệp của hệ điều hành cho các thay đổi cục bộ thay vì quét mọi tệp để tìm thay đổi. Trên Windows: cờ này hiện không hoạt động nhưng có thể được bật cùng với --experimental_windows_watchfs. Trên mọi hệ điều hành: Hành vi này không xác định nếu không gian làm việc của bạn nằm trên hệ thống tệp mạng và các tệp được chỉnh sửa trên máy từ xa.
Tuỳ chọn phân tích hồ sơ
- Các tuỳ chọn xuất hiện trước lệnh và được máy khách phân tích cú pháp:
--distdir=<a path>
nhiều lần sử dụng được tích luỹ-
Các vị trí khác để tìm kiếm bản lưu trữ trước khi truy cập vào mạng để tải xuống.
Thẻ:bazel_internal_configuration
- Giá trị mặc định của
--[no]experimental_repository_cache_hardlinks
: "false" - Nếu được đặt, bộ nhớ đệm kho lưu trữ sẽ liên kết cứng tệp trong trường hợp có lượt truy cập vào bộ nhớ đệm, thay vì sao chép. Việc này nhằm tiết kiệm dung lượng ổ đĩa.
Thẻ:bazel_internal_configuration
--experimental_repository_downloader_retries=<an integer>
mặc định: "0"-
Số lần thử tối đa để thử lại lỗi tải xuống. Nếu bạn đặt thành 0, thì tính năng thử lại sẽ bị tắt.
Thẻ:experimental
--experimental_scale_timeouts=<a double>
mặc định: "1.0"- Điều chỉnh tất cả thời gian chờ trong quy tắc kho lưu trữ Starlark theo hệ số này. Bằng cách này, bạn có thể làm cho kho lưu trữ bên ngoài hoạt động trên các máy chạy chậm hơn dự kiến của tác giả quy tắc mà không cần thay đổi mã nguồn
Thẻ:bazel_internal_configuration
,experimental
- Giá trị mặc định của
--[no]incompatible_disable_native_repo_rules
: "false" - Nếu giá trị là false, bạn có thể sử dụng các quy tắc kho lưu trữ gốc trong WORKSPACE; nếu không, bạn phải sử dụng các quy tắc kho lưu trữ Starlark. Các quy tắc kho lưu trữ gốc bao gồm local_repository, new_local_repository, local_config_platform, android_sdk_repository và android_ndk_repository.
Thẻ:bazel_internal_configuration
--repository_cache=<a path>
mặc định: xem nội dung mô tả- Chỉ định vị trí bộ nhớ đệm của các giá trị đã tải xuống thu được trong quá trình tìm nạp kho lưu trữ bên ngoài. Chuỗi trống làm đối số yêu cầu tắt bộ nhớ đệm, nếu không, giá trị mặc định là "<output_user_root>/cache/repos/v1" sẽ được sử dụng
Thẻ:bazel_internal_configuration
- Giá trị mặc định của
--[no]repository_disable_download
: "false" - Nếu được đặt, bạn không được phép tải xuống bằng ctx.download{,_and_extract} trong quá trình tìm nạp kho lưu trữ. Xin lưu ý rằng quyền truy cập mạng không bị tắt hoàn toàn; ctx.execute vẫn có thể chạy một tệp thực thi tuỳ ý truy cập Internet.
Thẻ:bazel_internal_configuration
- Các tuỳ chọn kiểm soát việc thực thi bản dựng:
- Giá trị mặc định của
--gc_thrashing_threshold=<an integer in 0-100 range>
: "100" -
Tỷ lệ phần trăm không gian cố định bị chiếm dụng (0-100) mà tại đó GcThrashingDetector xem xét các sự kiện áp lực bộ nhớ so với giới hạn của nó (--gc_thrashing_limits). Nếu bạn đặt thành 100, GcThrashingDetector sẽ bị tắt.
Thẻ:host_machine_resource_optimizations
- Tuỳ chọn liên quan đến đầu ra và ngữ nghĩa của Bzlmod:
--allow_yanked_versions=<a string>
nhiều lần sử dụng được tích luỹ-
Chỉ định các phiên bản mô-đun ở dạng `<module1>@<version1>,<module2>@<version2>` sẽ được cho phép trong biểu đồ phần phụ thuộc đã phân giải ngay cả khi các phiên bản đó được khai báo là đã bị xoá trong sổ đăng ký nơi chúng đến (nếu không đến từ NonRegistryOverride). Nếu không, các phiên bản bị xoá sẽ khiến việc phân giải không thành công. Bạn cũng có thể xác định phiên bản bị xoá được phép bằng biến môi trường `BZLMOD_ALLOW_YANKED_VERSIONS`. Bạn có thể tắt tính năng kiểm tra này bằng cách sử dụng từ khoá "tất cả" (không nên dùng).
Thẻ:loading_and_analysis
--check_bazel_compatibility=<error, warning or off>
mặc định: "lỗi"-
Kiểm tra khả năng tương thích của phiên bản bazel của các mô-đun Bazel. Các giá trị hợp lệ là "error" để chuyển vấn đề này lên lỗi phân giải, "off" để tắt tính năng kiểm tra hoặc "warning" để in cảnh báo khi phát hiện thấy không khớp.
Thẻ:loading_and_analysis
--check_direct_dependencies=<off, warning or error>
mặc định: "cảnh báo"-
Kiểm tra xem các phần phụ thuộc `bazel_dep` trực tiếp được khai báo trong mô-đun gốc có phải là các phiên bản mà bạn nhận được trong biểu đồ phần phụ thuộc đã được phân giải hay không. Các giá trị hợp lệ là "off" để tắt tính năng kiểm tra, "warning" để in cảnh báo khi phát hiện thấy không khớp hoặc "error" để chuyển lên lỗi phân giải.
Thẻ:loading_and_analysis
- Giá trị mặc định của
--[no]ignore_dev_dependency
: "false" - Nếu đúng, Bazel sẽ bỏ qua "bazel_dep" và "use_extension" được khai báo là "dev_dependency" trong MODULE.bazel của mô-đun gốc. Xin lưu ý rằng các phần phụ thuộc dành cho nhà phát triển đó luôn bị bỏ qua trong MODULE.bazel nếu đó không phải là mô-đun gốc, bất kể giá trị của cờ này là gì.
Thẻ:loading_and_analysis
--lockfile_mode=<off, update, refresh or error>
mặc định: "cập nhật"-
Chỉ định cách thức và liệu có sử dụng tệp khoá hay không. Các giá trị hợp lệ là "update" để sử dụng tệp khoá và cập nhật tệp khoá nếu có thay đổi, "refresh" để thỉnh thoảng làm mới thông tin có thể thay đổi (các phiên bản bị loại bỏ và các mô-đun bị thiếu trước đó) từ các sổ đăng ký từ xa, "error" để sử dụng tệp khoá nhưng gửi lỗi nếu tệp khoá không được cập nhật hoặc "off" để không đọc hoặc ghi vào tệp khoá.
Thẻ:loading_and_analysis
--override_module=<an equals-separated mapping of module name to path>
nhiều lần sử dụng được tích luỹ- Ghi đè một mô-đun bằng đường dẫn cục bộ ở dạng <tên mô-đun>=<đường dẫn>. Nếu đường dẫn đã cho là đường dẫn tuyệt đối, thì đường dẫn đó sẽ được sử dụng nguyên trạng. Nếu đường dẫn đã cho là đường dẫn tương đối, thì đường dẫn đó sẽ tương ứng với thư mục đang hoạt động. Nếu đường dẫn đã cho bắt đầu bằng "%workspace%", thì đường dẫn đó sẽ tương ứng với thư mục gốc của không gian làm việc, là kết quả của lệnh "bazel info workspace". Nếu đường dẫn đã cho trống, hãy xoá mọi chế độ ghi đè trước đó.
--registry=<a string>
nhiều lần sử dụng được tích luỹ- Chỉ định các sổ đăng ký cần sử dụng để xác định vị trí các phần phụ thuộc mô-đun Bazel. Thứ tự rất quan trọng: các mô-đun sẽ được tra cứu trong các sổ đăng ký trước đó trước tiên và chỉ quay lại các sổ đăng ký sau này khi các mô-đun đó bị thiếu trong các sổ đăng ký trước đó.
Thẻ:changes_inputs
--vendor_dir=<a path>
mặc định: xem nội dung mô tả-
Chỉ định thư mục sẽ chứa các kho lưu trữ bên ngoài ở chế độ nhà cung cấp, cho dù mục đích là tìm nạp các kho lưu trữ đó vào thư mục hay sử dụng các kho lưu trữ đó trong khi xây dựng. Bạn có thể chỉ định đường dẫn dưới dạng đường dẫn tuyệt đối hoặc đường dẫn tương đối đến thư mục không gian làm việc.
Thẻ:loading_and_analysis
- Các tuỳ chọn kích hoạt tính năng tối ưu hoá thời gian xây dựng:
--gc_thrashing_limits=<comma separated pairs of <period>:<count>>
mặc định: "1s:2,20s:3,1m:5"-
Các giới hạn nếu đạt đến sẽ khiến GcThrashingDetector gặp sự cố Bazel với OOM. Mỗi giới hạn được chỉ định là <period>:<count>, trong đó period là thời lượng và count là số nguyên dương. Nếu hơn --gc_thrashing_threshold phần trăm không gian cố định (vùng nhớ khối xếp cũ) vẫn bị chiếm dụng sau <count> lần GC đầy đủ liên tiếp trong <period>, thì lỗi OOM sẽ được kích hoạt. Bạn có thể chỉ định nhiều giới hạn, phân tách bằng dấu phẩy.
Thẻ:host_machine_resource_optimizations
--skyframe_high_water_mark_full_gc_drops_per_invocation=<an integer, >= 0>
mặc định: "2147483647"-
Cờ cho cấu hình nâng cao của công cụ Skyframe nội bộ của Bazel. Nếu phát hiện mức sử dụng phần trăm vùng nhớ khối xếp được giữ lại vượt quá ngưỡng do --skyframe_high_water_mark_threshold đặt ra, thì khi một sự kiện GC đầy đủ xảy ra, Bazel sẽ loại bỏ trạng thái Skyframe tạm thời không cần thiết, lên đến nhiều lần như vậy cho mỗi lệnh gọi. Mặc định là Integer.MAX_VALUE; không giới hạn về mặt hiệu quả. Giá trị 0 có nghĩa là các sự kiện GC đầy đủ sẽ không bao giờ kích hoạt sự kiện thả. Nếu đạt đến giới hạn, trạng thái Skyframe sẽ không còn bị loại bỏ khi một sự kiện GC đầy đủ xảy ra và vượt quá ngưỡng phần trăm vùng nhớ khối xếp được giữ lại đó.
Thẻ:host_machine_resource_optimizations
--skyframe_high_water_mark_minor_gc_drops_per_invocation=<an integer, >= 0>
mặc định: "2147483647"-
Cờ cho cấu hình nâng cao của công cụ Skyframe nội bộ của Bazel. Nếu phát hiện mức sử dụng phần trăm vùng nhớ khối xếp được giữ lại vượt quá ngưỡng do --skyframe_high_water_mark_threshold đặt ra, thì khi một sự kiện GC nhỏ xảy ra, Bazel sẽ loại bỏ trạng thái Skyframe tạm thời không cần thiết, lên đến nhiều lần như vậy mỗi lần gọi. Mặc định là Integer.MAX_VALUE; không giới hạn về mặt hiệu quả. Giá trị 0 có nghĩa là các sự kiện GC nhỏ sẽ không bao giờ kích hoạt sự kiện thả. Nếu đạt đến giới hạn, trạng thái Skyframe sẽ không còn bị loại bỏ khi một sự kiện GC nhỏ xảy ra và vượt quá ngưỡng phần trăm vùng nhớ khối xếp được giữ lại.
Thẻ:host_machine_resource_optimizations
--skyframe_high_water_mark_threshold=<an integer>
mặc định: "85"-
Cờ cho cấu hình nâng cao của công cụ Skyframe nội bộ của Bazel. Nếu phát hiện mức sử dụng phần trăm vùng nhớ khối xếp được giữ lại ít nhất là ngưỡng này, Bazel sẽ loại bỏ trạng thái Skyframe tạm thời không cần thiết. Việc điều chỉnh điều này có thể giúp bạn giảm thiểu tác động của tình trạng GC bị lỗi khi (i) tình trạng này là do mức sử dụng bộ nhớ của trạng thái tạm thời và (ii) tốn kém hơn so với việc tạo lại trạng thái khi cần.
Thẻ:host_machine_resource_optimizations
- Các tuỳ chọn ảnh hưởng đến mức độ chi tiết, định dạng hoặc vị trí ghi nhật ký:
--dump=<text or raw>
[-d
] mặc định: xem nội dung mô tả- xuất dữ liệu hồ sơ đầy đủ ở định dạng "văn bản" mà con người có thể đọc được hoặc định dạng "thô" phù hợp với tập lệnh.
Thẻ:affects_outputs
--experimental_command_profile=<cpu, wall, alloc or lock>
mặc định: xem nội dung mô tả- Ghi hồ sơ Trình ghi chuyến bay Java trong thời gian thực thi lệnh. Bạn phải cung cấp một trong các loại sự kiện phân tích tài nguyên được hỗ trợ (cpu, wall, alloc hoặc lock) dưới dạng đối số. Hồ sơ được ghi vào một tệp được đặt tên theo loại sự kiện trong thư mục cơ sở đầu ra. Cú pháp và ngữ nghĩa của cờ này có thể thay đổi trong tương lai để hỗ trợ thêm các loại hồ sơ hoặc định dạng đầu ra; bạn tự chịu rủi ro khi sử dụng.
- Giá trị mặc định của
--[no]experimental_record_metrics_for_all_mnemonics
: "false" - Theo mặc định, số lượng loại thao tác được giới hạn ở 20 câu thần chú có số lượng thao tác được thực thi nhiều nhất. Việc đặt tuỳ chọn này sẽ ghi số liệu thống kê cho tất cả các câu thần chú.
- Các tuỳ chọn chỉ định hoặc thay đổi dữ liệu đầu vào chung thành một lệnh Bazel không thuộc các danh mục khác.:
--experimental_resolved_file_instead_of_workspace=<a string>
mặc định: ""- Nếu không trống, hãy đọc tệp đã phân giải được chỉ định thay vì tệp WORKSPACE
Thẻ:changes_inputs
- Các tuỳ chọn thực thi và lưu vào bộ nhớ đệm từ xa:
--experimental_downloader_config=<a string>
mặc định: xem nội dung mô tả- Chỉ định một tệp để định cấu hình trình tải xuống từ xa. Tệp này bao gồm các dòng, mỗi dòng bắt đầu bằng một lệnh (`allow`, `block` hoặc `rewrite`), theo sau là tên máy chủ lưu trữ (đối với lệnh `allow` và `block`) hoặc hai mẫu, một mẫu để so khớp và một mẫu để sử dụng làm URL thay thế, với các tệp tham chiếu ngược bắt đầu từ `$1`. Bạn có thể cung cấp nhiều lệnh `rewrite` cho cùng một URL và trong trường hợp này, nhiều URL sẽ được trả về.
- Giá trị mặc định của
--experimental_worker_for_repo_fetching=<off, platform, virtual or auto>
: "tự động" - Chế độ tạo luồng để tìm nạp kho lưu trữ. Nếu bạn đặt thành "tắt", thì không có luồng worker nào được sử dụng và quá trình tìm nạp kho lưu trữ sẽ phải khởi động lại. Nếu không, hãy sử dụng luồng worker ảo.
- Các tuỳ chọn khác, không được phân loại theo cách khác.:
--override_repository=<an equals-separated mapping of repository name to path>
nhiều lần sử dụng được tích luỹ- Ghi đè kho lưu trữ bằng một đường dẫn cục bộ ở dạng <repository name>=<path>. Nếu đường dẫn đã cho là đường dẫn tuyệt đối, thì đường dẫn đó sẽ được sử dụng nguyên trạng. Nếu đường dẫn đã cho là đường dẫn tương đối, thì đường dẫn đó sẽ tương ứng với thư mục đang hoạt động. Nếu đường dẫn đã cho bắt đầu bằng "%workspace%", thì đường dẫn đó sẽ tương ứng với thư mục gốc của không gian làm việc, là kết quả của lệnh "bazel info workspace". Nếu đường dẫn đã cho trống, hãy xoá mọi chế độ ghi đè trước đó.
Tuỳ chọn truy vấn
Kế thừa tất cả các tuỳ chọn từ build.
- Các tuỳ chọn xuất hiện trước lệnh và được máy khách phân tích cú pháp:
--distdir=<a path>
nhiều lần sử dụng được tích luỹ-
Các vị trí khác để tìm kiếm bản lưu trữ trước khi truy cập vào mạng để tải xuống.
Thẻ:bazel_internal_configuration
- Giá trị mặc định của
--[no]experimental_repository_cache_hardlinks
: "false" - Nếu được đặt, bộ nhớ đệm kho lưu trữ sẽ liên kết cứng tệp trong trường hợp có lượt truy cập vào bộ nhớ đệm, thay vì sao chép. Việc này nhằm tiết kiệm dung lượng ổ đĩa.
Thẻ:bazel_internal_configuration
--experimental_repository_downloader_retries=<an integer>
mặc định: "0"-
Số lần thử tối đa để thử lại lỗi tải xuống. Nếu bạn đặt thành 0, thì tính năng thử lại sẽ bị tắt.
Thẻ:experimental
--experimental_scale_timeouts=<a double>
mặc định: "1.0"- Điều chỉnh tất cả thời gian chờ trong quy tắc kho lưu trữ Starlark theo hệ số này. Bằng cách này, bạn có thể làm cho kho lưu trữ bên ngoài hoạt động trên các máy chạy chậm hơn dự kiến của tác giả quy tắc mà không cần thay đổi mã nguồn
Thẻ:bazel_internal_configuration
,experimental
- Giá trị mặc định của
--[no]incompatible_disable_native_repo_rules
: "false" - Nếu giá trị là false, bạn có thể sử dụng các quy tắc kho lưu trữ gốc trong WORKSPACE; nếu không, bạn phải sử dụng các quy tắc kho lưu trữ Starlark. Các quy tắc kho lưu trữ gốc bao gồm local_repository, new_local_repository, local_config_platform, android_sdk_repository và android_ndk_repository.
Thẻ:bazel_internal_configuration
--repository_cache=<a path>
mặc định: xem nội dung mô tả- Chỉ định vị trí bộ nhớ đệm của các giá trị đã tải xuống thu được trong quá trình tìm nạp kho lưu trữ bên ngoài. Chuỗi trống làm đối số yêu cầu tắt bộ nhớ đệm, nếu không, giá trị mặc định là "<output_user_root>/cache/repos/v1" sẽ được sử dụng
Thẻ:bazel_internal_configuration
- Giá trị mặc định của
--[no]repository_disable_download
: "false" - Nếu được đặt, bạn không được phép tải xuống bằng ctx.download{,_and_extract} trong quá trình tìm nạp kho lưu trữ. Xin lưu ý rằng quyền truy cập mạng không bị tắt hoàn toàn; ctx.execute vẫn có thể chạy một tệp thực thi tuỳ ý truy cập Internet.
Thẻ:bazel_internal_configuration
- Các tuỳ chọn kiểm soát việc thực thi bản dựng:
- Giá trị mặc định của
--gc_thrashing_threshold=<an integer in 0-100 range>
: "100" -
Tỷ lệ phần trăm không gian cố định bị chiếm dụng (0-100) mà tại đó GcThrashingDetector xem xét các sự kiện áp lực bộ nhớ so với giới hạn của nó (--gc_thrashing_limits). Nếu bạn đặt thành 100, GcThrashingDetector sẽ bị tắt.
Thẻ:host_machine_resource_optimizations
- Tuỳ chọn liên quan đến kết quả truy vấn và ngữ nghĩa:
- Giá trị mặc định của
--aspect_deps=<off, conservative or precise>
: "conservative" -
Cách phân giải các phần phụ thuộc của khía cạnh khi định dạng đầu ra là một trong các {xml,proto,record}. "tắt" có nghĩa là không có phần phụ thuộc khía cạnh nào được phân giải, "cẩn thận" (mặc định) có nghĩa là tất cả phần phụ thuộc khía cạnh đã khai báo đều được thêm vào bất kể chúng có được cấp lớp quy tắc của phần phụ thuộc trực tiếp hay không, "chính xác" có nghĩa là chỉ những khía cạnh có thể hoạt động mới được thêm vào dựa trên lớp quy tắc của phần phụ thuộc trực tiếp. Xin lưu ý rằng chế độ chính xác yêu cầu tải các gói khác để đánh giá một mục tiêu duy nhất, do đó, chế độ này sẽ chậm hơn các chế độ khác. Ngoài ra, xin lưu ý rằng ngay cả chế độ chính xác cũng không hoàn toàn chính xác: quyết định có tính toán một khía cạnh hay không được quyết định trong giai đoạn phân tích, giai đoạn này không chạy trong "truy vấn bazel".
Thẻ:build_file_semantics
- Giá trị mặc định của
--[no]consistent_labels
: "false" - Nếu được bật, mọi lệnh truy vấn sẽ phát ra nhãn như thể bằng hàm Starlark <code>str</code> áp dụng cho một thực thể <code>Label</code>. Điều này rất hữu ích đối với các công cụ cần so khớp kết quả của các lệnh truy vấn và/hoặc nhãn khác nhau do các quy tắc phát ra. Nếu không được bật, trình định dạng đầu ra có thể tự do phát ra tên kho lưu trữ rõ ràng (so với kho lưu trữ chính) để giúp đầu ra dễ đọc hơn.
Thẻ:terminal_output
- Giá trị mặc định của
--[no]experimental_explicit_aspects
: "false" -
aquery, cquery: liệu có đưa các hành động do phương diện tạo ra vào kết quả hay không. query: không hoạt động (các phương diện luôn được tuân theo).
Thẻ:terminal_output
- Giá trị mặc định của
--[no]graph:factored
: "true" - Nếu đúng, thì biểu đồ sẽ được phát "được nhân", tức là các nút tương đương về mặt tô pô sẽ được hợp nhất với nhau và các nhãn của chúng sẽ được nối với nhau. Tuỳ chọn này chỉ áp dụng cho --output=graph.
Thẻ:terminal_output
--graph:node_limit=<an integer>
mặc định: "512"-
Độ dài tối đa của chuỗi nhãn cho một nút biểu đồ trong kết quả. Nhãn dài hơn sẽ bị cắt ngắn; -1 có nghĩa là không cắt ngắn. Tuỳ chọn này chỉ áp dụng cho --output=graph.
Thẻ:terminal_output
- Giá trị mặc định của
--[no]implicit_deps
: "true" - Nếu được bật, các phần phụ thuộc ngầm sẽ đượ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 bazel thêm vào. Đối với cquery, tuỳ chọn này kiểm soát việc lọc các chuỗi công cụ đã phân giải.
Thẻ:build_file_semantics
- Giá trị mặc định của
--[no]include_artifacts
: "true" - Bao gồm tên của đầu vào và đầu ra của hành động trong kết quả (có thể lớn).
Thẻ:terminal_output
- Giá trị mặc định của
--[no]include_aspects
: "true" -
aquery, cquery: liệu có đưa các hành động do phương diện tạo ra vào kết quả hay không. query: không hoạt động (các phương diện luôn được tuân theo).
Thẻ:terminal_output
- Giá trị mặc định của
--[no]include_commandline
: "true" -
Bao gồm nội dung của các dòng lệnh hành động trong kết quả (có thể lớn).
Thẻ:terminal_output
- Giá trị mặc định của
--[no]include_file_write_contents
: "false" -
Bao gồm nội dung tệp cho các thao tác FileWrite, SourceSymlinkManifest và RepoMappingManifest (có thể lớn).
Thẻ:terminal_output
- Giá trị mặc định của
--[no]include_param_files
: "false" -
Thêm nội dung của các tệp tham số được dùng trong lệnh (có thể lớn). Lưu ý: Việc bật cờ này sẽ tự động bật cờ --include_commandline.
Thẻ:terminal_output
- Giá trị mặc định của
--[no]incompatible_package_group_includes_double_slash
: "true" - Nếu được bật, khi xuất thuộc tính "packages" của package_group, dấu "//" ở đầu sẽ không bị bỏ qua.
Thẻ:terminal_output
,incompatible_change
- Giá trị mặc định của
--[no]infer_universe_scope
: "false" - Nếu bạn đặt và không đặt --universe_scope, thì giá trị của --universe_scope sẽ được suy ra là danh sách các mẫu mục tiêu duy nhất trong biểu thức truy vấn. Xin lưu ý rằng giá trị --universe_scope được suy ra cho biểu thức truy vấn sử dụng các hàm trong phạm vi vũ trụ (ví dụ: "allrdeps") có thể không phải là giá trị bạn muốn. Vì vậy, bạn chỉ nên sử dụng tuỳ chọn này nếu biết mình đang làm gì. Hãy xem https://bazel.build/reference/query#sky-query để biết thông tin chi tiết và ví dụ. Nếu bạn đặt --universe_scope, thì giá trị của tuỳ chọn này sẽ bị bỏ qua. Lưu ý: tuỳ chọn này chỉ áp dụng cho "truy vấn" (tức là không phải "cquery").
Thẻ:loading_and_analysis
- Giá trị mặc định của
--[no]line_terminator_null
: "false" -
Liệu mỗi định dạng có được kết thúc bằng \0 thay vì dòng mới hay không.
Thẻ:terminal_output
- Giá trị mặc định của
--[no]nodep_deps
: "true" - Nếu được bật, các phần phụ thuộc từ thuộc tính "nodep" sẽ được đưa vào biểu đồ phần phụ thuộc mà truy vấn hoạt động. Một ví dụ phổ biến về thuộc tính "nodep" là "visibility" (mức độ hiển thị). Chạy và phân tích cú pháp kết quả của lệnh `info build-language` để tìm hiểu về tất cả thuộc tính "nodep" trong ngôn ngữ bản dựng.
Thẻ:build_file_semantics
--output=<a string>
mặc định: "text"-
Định dạng in kết quả truy vấn. Các giá trị được phép cho aquery là: text, textproto, proto, streamed_proto, jsonproto.
Thẻ:terminal_output
- Giá trị mặc định của
--[no]proto:default_values
: "true" - Nếu đúng, các thuộc tính có giá trị không được chỉ định rõ ràng trong tệp BUILD sẽ được đưa vào; nếu không, các thuộc tính đó sẽ bị bỏ qua. Bạn có thể áp dụng tuỳ chọn này cho --output=proto
Thẻ:terminal_output
- Giá trị mặc định của
--[no]proto:definition_stack
: "false" - Điền vào trường proto definition_stack. Trường này ghi lại cho mỗi thực thể quy tắc ngăn xếp lệnh gọi Starlark tại thời điểm lớp của quy tắc được xác định.
Thẻ:terminal_output
- Giá trị mặc định của
--[no]proto:flatten_selects
: "true" - Nếu được bật, các thuộc tính có thể định cấu hình do select() tạo sẽ được làm phẳng. Đối với các loại danh sách, bản trình bày được làm phẳng là một danh sách chứa mỗi giá trị của bản đồ chọn chính xác một lần. Các loại đại lượng vô hướng được làm phẳng thành giá trị rỗng.
Thẻ:build_file_semantics
- Giá trị mặc định của
--[no]proto:include_attribute_source_aspects
: "false" - Điền phương diện nguồn mà thuộc tính đến từ vào trường proto source_aspect_name của mỗi Thuộc tính (chuỗi trống nếu không có).
Thẻ:terminal_output
- Giá trị mặc định của
--[no]proto:include_synthetic_attribute_hash
: "false" -
Liệu có tính toán và điền thuộc tính $internal_attr_hash hay không.
Thẻ:terminal_output
- Giá trị mặc định của
--[no]proto:instantiation_stack
: "false" - Điền ngăn xếp lệnh gọi bản sao của từng quy tắc. Xin lưu ý rằng việc này yêu cầu ngăn xếp phải có mặt
Thẻ
:terminal_output
- Giá trị mặc định của
--[no]proto:locations
: "true" -
Liệu có xuất thông tin vị trí trong đầu ra proto hay không.
Thẻ:terminal_output
--proto:output_rule_attrs=<comma-separated list of options>
mặc định: "tất cả"- Danh sách các thuộc tính được phân tách bằng dấu phẩy để đưa vào đầu ra. Giá trị mặc định là tất cả thuộc tính. Đặt thành chuỗi trống để không xuất ra thuộc tính nào. Tuỳ chọn này áp dụng cho --output=proto.
Thẻ:terminal_output
- Giá trị mặc định của
--[no]proto:rule_inputs_and_outputs
: "true" -
Liệu có điền sẵn các trường rule_input và rule_output hay không.
Thẻ:terminal_output
--query_file=<a string>
mặc định: ""- Nếu được đặt, truy vấn sẽ đọc truy vấn từ tệp được đặt tên tại đây, thay vì trên dòng lệnh. Bạn sẽ gặp lỗi nếu chỉ định một tệp tại đây cũng như một truy vấn dòng lệnh.
Thẻ:changes_inputs
- Giá trị mặc định của
--[no]relative_locations
: "false" - Nếu đúng, vị trí của các tệp BUILD trong đầu ra xml và proto sẽ tương đối. Theo mặc định, đầu ra vị trí là một đường dẫn tuyệt đối và sẽ không nhất quán trên các máy. Bạn có thể đặt tuỳ chọn này thành đúng để có kết quả nhất quán trên các máy.
Thẻ:terminal_output
- Giá trị mặc định của
--[no]skyframe_state
: "false" -
Không thực hiện thêm phân tích, hãy kết xuất Biểu đồ hành động hiện tại từ Skyframe. Lưu ý: Hiện tại, chúng tôi không hỗ trợ việc chỉ định mục tiêu bằng --skyframe_state. Cờ này chỉ có với --output=proto hoặc --output=textproto.
Thẻ:terminal_output
- Giá trị mặc định của
--[no]tool_deps
: "true" - Truy vấn: Nếu bị tắt, các phần phụ thuộc trên "cấu hình thực thi" sẽ không được đưa vào biểu đồ phần phụ thuộc mà truy vấn hoạt động. Cạnh phần phụ thuộc "cấu hình thực thi", chẳng hạn như cạnh từ quy tắc "proto_library" bất kỳ đến Trình biên dịch giao thức, thường trỏ đến một công cụ được thực thi trong quá trình xây dựng thay vì một phần của cùng một chương trình "mục tiêu".
Cquery: Nếu bị tắt, sẽ lọc ra tất cả các mục tiêu đã định cấu hình vượt qua quá trình chuyển đổi thực thi từ mục tiêu cấp cao nhất đã phát hiện mục tiêu đã định cấu hình này. Điều đó có nghĩa là nếu mục tiêu cấp cao nhất nằm trong cấu hình mục tiêu, thì chỉ những mục tiêu được định cấu hình cũng nằm trong cấu hình mục tiêu mới được trả về. Nếu mục tiêu cấp cao nhất nằm trong cấu hình thực thi, thì chỉ các mục tiêu được định cấu hình thực thi mới được trả về. Tuỳ chọn này KHÔNG loại trừ các chuỗi công cụ đã phân giải.
Thẻ:build_file_semantics
--universe_scope=<comma-separated list of options>
mặc định: ""-
Một tập hợp các mẫu mục tiêu được phân tách bằng dấu phẩy (bổ sung và trừ). Truy vấn có thể được thực hiện trong vũ trụ được xác định bằng phép đóng bắc cầu của các mục tiêu đã chỉ định. Tuỳ chọn này được dùng cho các lệnh truy vấn và cquery.
Đối với cquery, dữ liệu đầu vào cho tuỳ chọn này là các mục tiêu mà tất cả câu trả lời được tạo trong đó. Do đó, tuỳ chọn này có thể ảnh hưởng đến cấu hình và quá trình chuyển đổi. Nếu bạn không chỉ định tuỳ chọn này, thì các mục tiêu cấp cao nhất được giả định là các mục tiêu được phân tích cú pháp từ biểu thức truy vấn. Lưu ý: Đối với cquery, việc không chỉ định tuỳ chọn này có thể khiến bản dựng bị lỗi nếu các mục tiêu được phân tích cú pháp từ biểu thức truy vấn không thể tạo bằng các tuỳ chọn cấp cao nhất.
Thẻ:loading_and_analysis
- Các tuỳ chọn liên quan đến đầu ra và ngữ nghĩa của Bzlmod:
--allow_yanked_versions=<a string>
nhiều lần sử dụng được tích luỹ-
Chỉ định các phiên bản mô-đun ở dạng `<module1>@<version1>,<module2>@<version2>` sẽ được cho phép trong biểu đồ phần phụ thuộc đã phân giải ngay cả khi các phiên bản đó được khai báo là đã bị xoá trong sổ đăng ký nơi chúng đến (nếu không đến từ NonRegistryOverride). Nếu không, các phiên bản bị xoá sẽ khiến việc phân giải không thành công. Bạn cũng có thể xác định phiên bản bị xoá được phép bằng biến môi trường `BZLMOD_ALLOW_YANKED_VERSIONS`. Bạn có thể tắt tính năng kiểm tra này bằng cách sử dụng từ khoá "tất cả" (không nên dùng).
Thẻ:loading_and_analysis
--check_bazel_compatibility=<error, warning or off>
mặc định: "lỗi"-
Kiểm tra khả năng tương thích của phiên bản bazel của các mô-đun Bazel. Các giá trị hợp lệ là "error" để chuyển vấn đề này lên lỗi phân giải, "off" để tắt tính năng kiểm tra hoặc "warning" để in cảnh báo khi phát hiện thấy không khớp.
Thẻ:loading_and_analysis
--check_direct_dependencies=<off, warning or error>
mặc định: "cảnh báo"-
Kiểm tra xem các phần phụ thuộc `bazel_dep` trực tiếp được khai báo trong mô-đun gốc có phải là các phiên bản mà bạn nhận được trong biểu đồ phần phụ thuộc đã được phân giải hay không. Các giá trị hợp lệ là "off" để tắt tính năng kiểm tra, "warning" để in cảnh báo khi phát hiện thấy không khớp hoặc "error" để chuyển lên lỗi phân giải.
Thẻ:loading_and_analysis
- Giá trị mặc định của
--[no]ignore_dev_dependency
: "false" - Nếu đúng, Bazel sẽ bỏ qua "bazel_dep" và "use_extension" được khai báo là "dev_dependency" trong MODULE.bazel của mô-đun gốc. Xin lưu ý rằng các phần phụ thuộc dành cho nhà phát triển đó luôn bị bỏ qua trong MODULE.bazel nếu đó không phải là mô-đun gốc, bất kể giá trị của cờ này là gì.
Thẻ:loading_and_analysis
--lockfile_mode=<off, update, refresh or error>
mặc định: "cập nhật"-
Chỉ định cách thức và liệu có sử dụng tệp khoá hay không. Các giá trị hợp lệ là "update" để sử dụng tệp khoá và cập nhật tệp khoá nếu có thay đổi, "refresh" để thỉnh thoảng làm mới thông tin có thể thay đổi (các phiên bản bị loại bỏ và các mô-đun bị thiếu trước đó) từ các sổ đăng ký từ xa, "error" để sử dụng tệp khoá nhưng gửi lỗi nếu tệp khoá không được cập nhật hoặc "off" để không đọc hoặc ghi vào tệp khoá.
Thẻ:loading_and_analysis
--override_module=<an equals-separated mapping of module name to path>
nhiều lần sử dụng được tích luỹ- Ghi đè một mô-đun bằng đường dẫn cục bộ ở dạng <tên mô-đun>=<đường dẫn>. Nếu đường dẫn đã cho là đường dẫn tuyệt đối, thì đường dẫn đó sẽ được sử dụng nguyên trạng. Nếu đường dẫn đã cho là đường dẫn tương đối, thì đường dẫn đó sẽ tương ứng với thư mục đang hoạt động. Nếu đường dẫn đã cho bắt đầu bằng "%workspace%", thì đường dẫn đó sẽ tương ứng với thư mục gốc của không gian làm việc, là kết quả của lệnh "bazel info workspace". Nếu đường dẫn đã cho trống, hãy xoá mọi chế độ ghi đè trước đó.
--registry=<a string>
nhiều lần sử dụng được tích luỹ- Chỉ định các sổ đăng ký cần sử dụng để xác định vị trí các phần phụ thuộc mô-đun Bazel. Thứ tự rất quan trọng: các mô-đun sẽ được tra cứu trong các sổ đăng ký trước đó trước tiên và chỉ quay lại các sổ đăng ký sau này khi các mô-đun đó bị thiếu trong các sổ đăng ký trước đó.
Thẻ:changes_inputs
--vendor_dir=<a path>
mặc định: xem nội dung mô tả-
Chỉ định thư mục sẽ chứa các kho lưu trữ bên ngoài ở chế độ nhà cung cấp, cho dù mục đích là tìm nạp các kho lưu trữ đó vào thư mục hay sử dụng các kho lưu trữ đó trong khi xây dựng. Bạn có thể chỉ định đường dẫn dưới dạng đường dẫn tuyệt đối hoặc đường dẫn tương đối đến thư mục không gian làm việc.
Thẻ:loading_and_analysis
- Các tuỳ chọn kích hoạt tính năng tối ưu hoá thời gian xây dựng:
--gc_thrashing_limits=<comma separated pairs of <period>:<count>>
mặc định: "1s:2,20s:3,1m:5"-
Các giới hạn nếu đạt đến sẽ khiến GcThrashingDetector gặp sự cố Bazel với OOM. Mỗi giới hạn được chỉ định là <period>:<count>, trong đó period là thời lượng và count là số nguyên dương. Nếu hơn --gc_thrashing_threshold phần trăm không gian cố định (vùng nhớ khối xếp cũ) vẫn bị chiếm dụng sau <count> lần GC đầy đủ liên tiếp trong <period>, thì lỗi OOM sẽ được kích hoạt. Bạn có thể chỉ định nhiều giới hạn, phân tách bằng dấu phẩy.
Thẻ:host_machine_resource_optimizations
--skyframe_high_water_mark_full_gc_drops_per_invocation=<an integer, >= 0>
mặc định: "2147483647"-
Cờ cho cấu hình nâng cao của công cụ Skyframe nội bộ của Bazel. Nếu phát hiện mức sử dụng phần trăm vùng nhớ khối xếp được giữ lại vượt quá ngưỡng do --skyframe_high_water_mark_threshold đặt ra, thì khi một sự kiện GC đầy đủ xảy ra, Bazel sẽ loại bỏ trạng thái Skyframe tạm thời không cần thiết, lên đến nhiều lần như vậy cho mỗi lệnh gọi. Mặc định là Integer.MAX_VALUE; không giới hạn về mặt hiệu quả. Giá trị 0 có nghĩa là các sự kiện GC đầy đủ sẽ không bao giờ kích hoạt sự kiện thả. Nếu đạt đến giới hạn, trạng thái Skyframe sẽ không còn bị loại bỏ khi một sự kiện GC đầy đủ xảy ra và vượt quá ngưỡng phần trăm vùng nhớ khối xếp được giữ lại đó.
Thẻ:host_machine_resource_optimizations
--skyframe_high_water_mark_minor_gc_drops_per_invocation=<an integer, >= 0>
mặc định: "2147483647"-
Cờ cho cấu hình nâng cao của công cụ Skyframe nội bộ của Bazel. Nếu phát hiện mức sử dụng phần trăm vùng nhớ khối xếp được giữ lại vượt quá ngưỡng do --skyframe_high_water_mark_threshold đặt ra, thì khi một sự kiện GC nhỏ xảy ra, Bazel sẽ loại bỏ trạng thái Skyframe tạm thời không cần thiết, lên đến nhiều lần như vậy mỗi lần gọi. Mặc định là Integer.MAX_VALUE; không giới hạn về mặt hiệu quả. Giá trị 0 có nghĩa là các sự kiện GC nhỏ sẽ không bao giờ kích hoạt sự kiện thả. Nếu đạt đến giới hạn, trạng thái Skyframe sẽ không còn bị loại bỏ khi một sự kiện GC nhỏ xảy ra và vượt quá ngưỡng phần trăm vùng nhớ khối xếp được giữ lại.
Thẻ:host_machine_resource_optimizations
--skyframe_high_water_mark_threshold=<an integer>
mặc định: "85"-
Cờ cho cấu hình nâng cao của công cụ Skyframe nội bộ của Bazel. Nếu phát hiện mức sử dụng phần trăm vùng nhớ khối xếp được giữ lại ít nhất là ngưỡng này, Bazel sẽ loại bỏ trạng thái Skyframe tạm thời không cần thiết. Việc điều chỉnh điều này có thể giúp bạn giảm thiểu tác động của tình trạng GC bị lỗi khi (i) tình trạng này là do mức sử dụng bộ nhớ của trạng thái tạm thời và (ii) tốn kém hơn so với việc tạo lại trạng thái khi cần.
Thẻ:host_machine_resource_optimizations
- Các tuỳ chọn ảnh hưởng đến mức độ chi tiết, định dạng hoặc vị trí ghi nhật ký:
--experimental_command_profile=<cpu, wall, alloc or lock>
mặc định: xem nội dung mô tả- Ghi hồ sơ Trình ghi chuyến bay Java trong thời gian thực thi lệnh. Bạn phải cung cấp một trong các loại sự kiện phân tích tài nguyên được hỗ trợ (cpu, wall, alloc hoặc lock) dưới dạng đối số. Hồ sơ được ghi vào một tệp được đặt tên theo loại sự kiện trong thư mục cơ sở đầu ra. Cú pháp và ngữ nghĩa của cờ này có thể thay đổi trong tương lai để hỗ trợ thêm các loại hồ sơ hoặc định dạng đầu ra; bạn tự chịu rủi ro khi sử dụng.
- Giá trị mặc định của
--[no]experimental_record_metrics_for_all_mnemonics
: "false" - Theo mặc định, số lượng loại thao tác được giới hạn ở 20 câu thần chú có số lượng thao tác được thực thi nhiều nhất. Việc đặt tuỳ chọn này sẽ ghi số liệu thống kê cho tất cả các câu thần chú.
- Các tuỳ chọn chỉ định hoặc thay đổi dữ liệu đầu vào chung thành một lệnh Bazel không thuộc các danh mục khác.:
--experimental_resolved_file_instead_of_workspace=<a string>
mặc định: ""- Nếu không trống, hãy đọc tệp đã phân giải được chỉ định thay vì tệp WORKSPACE
Thẻ:changes_inputs
- Các tuỳ chọn thực thi và lưu vào bộ nhớ đệm từ xa:
--experimental_downloader_config=<a string>
mặc định: xem nội dung mô tả- Chỉ định một tệp để định cấu hình trình tải xuống từ xa. Tệp này bao gồm các dòng, mỗi dòng bắt đầu bằng một lệnh (`allow`, `block` hoặc `rewrite`), theo sau là tên máy chủ lưu trữ (đối với lệnh `allow` và `block`) hoặc hai mẫu, một mẫu để so khớp và một mẫu để sử dụng làm URL thay thế, với các tệp tham chiếu ngược bắt đầu từ `$1`. Bạn có thể cung cấp nhiều lệnh `rewrite` cho cùng một URL và trong trường hợp này, nhiều URL sẽ được trả về.
- Giá trị mặc định của
--experimental_worker_for_repo_fetching=<off, platform, virtual or auto>
: "tự động" - Chế độ tạo luồng để tìm nạp kho lưu trữ. Nếu bạn đặt thành "tắt", thì không có luồng worker nào được sử dụng và quá trình tìm nạp kho lưu trữ sẽ phải khởi động lại. Nếu không, hãy sử dụng luồng worker ảo.
- Các tuỳ chọn khác, không được phân loại theo cách khác.:
--override_repository=<an equals-separated mapping of repository name to path>
nhiều lần sử dụng được tích luỹ- Ghi đè kho lưu trữ bằng một đường dẫn cục bộ ở dạng <repository name>=<path>. Nếu đường dẫn đã cho là đường dẫn tuyệt đối, thì đường dẫn đó sẽ được sử dụng nguyên trạng. Nếu đường dẫn đã cho là đường dẫn tương đối, thì đường dẫn đó sẽ tương ứng với thư mục đang hoạt động. Nếu đường dẫn đã cho bắt đầu bằng "%workspace%", thì đường dẫn đó sẽ tương ứng với thư mục gốc của không gian làm việc, là kết quả của lệnh "bazel info workspace". Nếu đường dẫn đã cho trống, hãy xoá mọi chế độ ghi đè trước đó.
- Các tuỳ chọn kiểm soát quá trình thực thi bản dựng:
- Giá trị mặc định của
--[no]experimental_inprocess_symlink_creation
: "false" -
Liệu có thực hiện lệnh gọi hệ thống tệp trực tiếp để tạo cây đường liên kết tượng trưng hay không
Thẻ:loading_and_analysis
,execution
,experimental
- Giá trị mặc định của
--[no]experimental_persistent_aar_extractor
: "false" -
Bật trình trích xuất aar liên tục bằng cách sử dụng worker.
Thẻ:execution
- Giá trị mặc định của
--[no]experimental_remotable_source_manifests
: "false" -
Liệu có nên thực hiện các thao tác trong tệp kê khai nguồn từ xa hay không
Thẻ:loading_and_analysis
,execution
,experimental
- Giá trị mặc định của
--[no]experimental_split_coverage_postprocessing
: "false" - Nếu đúng, Bazel sẽ chạy quy trình xử lý sau khi kiểm thử để kiểm thử trong một quá trình tạo mới.
Thẻ:execution
- Giá trị mặc định của
--[no]experimental_strict_fileset_output
: "false" - Nếu bạn bật tuỳ chọn này, các tập hợp tệp sẽ coi tất cả cấu phần phần mềm đầu ra là tệp thông thường. Các tệp này sẽ không duyệt qua các thư mục hoặc nhạy cảm với các đường liên kết tượng trưng.
Thẻ:execution
- Giá trị mặc định của
--[no]incompatible_disallow_unsound_directory_outputs
: "true" - Nếu được đặt, thao tác hiện thực hoá tệp đầu ra dưới dạng thư mục sẽ gây ra lỗi. Không ảnh hưởng đến thư mục nguồn. Xem https://github.com/bazelbuild/bazel/issues/18646.
Thẻ:bazel_internal_configuration
,incompatible_change
- Giá trị mặc định của
--[no]incompatible_modify_execution_info_additive
: "false" -
Khi được bật, việc truyền nhiều cờ --modify_execution_info sẽ có tính chất cộng gộp. Khi bị tắt, hệ thống sẽ chỉ xem xét cờ gần đây nhất.
Thẻ:execution
,affects_outputs
,loading_and_analysis
,incompatible_change
--modify_execution_info=<regex=[+-]key,regex=[+-]key,...>
nhiều lần sử dụng được tích luỹ-
Thêm hoặc xoá các khoá khỏi thông tin thực thi của một hành động dựa trên câu thần chú hành động. Chỉ áp dụng cho các hành động hỗ trợ thông tin thực thi. Nhiều hành động phổ biến hỗ trợ thông tin thực thi, ví dụ: Genrule, CppCompile, Javac, StarlarkAction, TestRunner. Khi chỉ định nhiều giá trị, thứ tự sẽ rất quan trọng vì nhiều biểu thức chính quy có thể áp dụng cho cùng một câu thần chú.
Cú pháp: "regex=[+-]key,regex=[+-]key,...".
Ví dụ: ".*=+x,.*=-y,.*=+z" sẽ thêm "x" và "z" vào, đồng thời xoá "y" khỏi thông tin thực thi cho tất cả các hành động.
"Genrule=+requires-x" sẽ thêm "requires-x" vào thông tin thực thi cho tất cả các hành động Genrule.
"(?!Genrule).*=-requires-x" xoá "requires-x" khỏi thông tin thực thi cho tất cả các hành động không phải Genrule.
Thẻ:execution
,affects_outputs
,loading_and_analysis
--persistent_android_dex_desugar
-
Bật các thao tác dex và đơn giản hoá Android liên tục bằng cách sử dụng worker.
Mở rộng thành:
--internal_persistent_android_dex_desugar
--strategy=Desugar=worker
--strategy=DexBuilder=worker
Thẻ:host_machine_resource_optimizations
,execution
--persistent_android_resource_processor
- Bật trình xử lý tài nguyên Android liên tục bằng cách sử dụng worker.
Mở rộng thành:
--internal_persistent_busybox_tools
--strategy=AaptPackage=worker
--strategy=AndroidResourceParser=worker
--strategy=AndroidResourceValidator=worker
--strategy=AndroidResourceCompiler=worker
--strategy=RClassGenerator=worker
--strategy=AndroidResourceLink=worker
--strategy=AndroidAapt2=worker
--strategy=AndroidAssetMerger=worker
--strategy=AndroidResourceMerger=worker
--strategy=AndroidCompiledResourceMerger=worker
--strategy=ManifestMerger=worker
--strategy=AndroidManifestMerger=worker
--strategy=Aapt2Optimize=worker
--strategy=AARGenerator=worker
--strategy=ProcessDatabinding=worker
--strategy=GenerateDataBindingBaseClasses=worker
Thẻ:host_machine_resource_optimizations
,execution
--persistent_multiplex_android_dex_desugar
-
Bật các thao tác dex và đơn giản hoá Android được đa kênh liên tục bằng cách sử dụng worker.
Mở rộng thành:
--persistent_android_dex_desugar
--internal_persistent_multiplex_android_dex_desugar
Thẻ:host_machine_resource_optimizations
,execution
--persistent_multiplex_android_resource_processor
-
Bật trình xử lý tài nguyên Android được đa kênh liên tục bằng cách sử dụng worker.
Mở rộng thành:
--persistent_android_resource_processor
--modify_execution_info=AaptPackage=+supports-multiplex-workers
--modify_execution_info=AndroidResourceParser=+supports-multiplex-workers
--modify_execution_info=AndroidResourceValidator=+supports-multiplex-workers
--modify_execution_info=AndroidResourceCompiler=+supports-multiplex-workers
--modify_execution_info=RClassGenerator=+supports-multiplex-workers
--modify_execution_info=AndroidResourceLink=+supports-multiplex-workers
--modify_execution_info=AndroidAapt2=+supports-multiplex-workers
--modify_execution_info=AndroidAssetMerger=+supports-multiplex-workers
--modify_execution_info=AndroidResourceMerger=+supports-multiplex-workers
--modify_execution_info=AndroidCompiledResourceMerger=+supports-multiplex-workers
--modify_execution_info=ManifestMerger=+supports-multiplex-workers
--modify_execution_info=AndroidManifestMerger=+supports-multiplex-workers
--modify_execution_info=Aapt2Optimize=+supports-multiplex-workers
--modify_execution_info=AARGenerator=+supports-multiplex-workers
Thẻ:host_machine_resource_optimizations
,execution
--persistent_multiplex_android_tools
- Bật các công cụ Android liên tục và đa kênh (dexing, desugaring, xử lý tài nguyên).
Mở rộng thành:
--internal_persistent_multiplex_busybox_tools
--persistent_multiplex_android_resource_processor
--persistent_multiplex_android_dex_desugar
Thẻ:host_machine_resource_optimizations
,execution
- Giá trị mặc định của
--[no]use_target_platform_for_tests
: "false" - Nếu đúng, Bazel sẽ sử dụng nền tảng mục tiêu để chạy kiểm thử thay vì nhóm thực thi kiểm thử.
Thẻ:execution
- Các tuỳ chọn định cấu hình chuỗi công cụ dùng để thực thi hành động:
--android_compiler=<a string>
mặc định: xem nội dung mô tả-
Trình biên dịch mục tiêu Android.
Thẻ:affects_outputs
,loading_and_analysis
,loses_incremental_state
--android_crosstool_top=<a build target label>
mặc định: "//external:android/crosstool"-
Vị trí của trình biên dịch C++ dùng cho các bản dựng Android.
Thẻ:affects_outputs
,changes_inputs
,loading_and_analysis
,loses_incremental_state
--android_grte_top=<a label>
mặc định: xem nội dung mô tả-
Mục tiêu Android grte_top.
Thẻ:changes_inputs
,loading_and_analysis
,loses_incremental_state
--android_manifest_merger=<legacy, android or force_android>
mặc định: "android"-
Chọn trình hợp nhất tệp kê khai để sử dụng cho các quy tắc android_binary. Cờ để giúp chuyển đổi sang trình hợp nhất tệp kê khai Android từ trình hợp nhất cũ.
Thẻ:affects_outputs
,loading_and_analysis
,loses_incremental_state
--android_platforms=<a build target label>
mặc định: ""-
Đặt các nền tảng mà mục tiêu android_binary sử dụng. Nếu bạn chỉ định nhiều nền tảng, thì tệp nhị phân sẽ là tệp APK lớn, chứa các tệp nhị phân gốc cho từng nền tảng mục tiêu được chỉ định.
Thẻ:changes_inputs
,loading_and_analysis
,loses_incremental_state
--android_sdk=<a build target label>
mặc định: "@bazel_tools//tools/android:sdk"- Chỉ định SDK/nền tảng Android dùng để tạo ứng dụng Android.
Thẻ:changes_inputs
,loading_and_analysis
,loses_incremental_state
--apple_crosstool_top=<a build target label>
mặc định: "@bazel_tools//tools/cpp:toolchain"-
Nhãn của gói công cụ đa nền tảng sẽ được dùng trong các quy tắc của Apple và Objc cũng như các phần phụ thuộc của các quy tắc đó.
Thẻ:loses_incremental_state
,changes_inputs
--cc_output_directory_tag=<a string>
mặc định: ""- Chỉ định hậu tố cần thêm vào thư mục cấu hình.
Thẻ:affects_outputs
--compiler=<a string>
mặc định: xem nội dung mô tả-
Trình biên dịch C++ dùng để biên dịch mục tiêu.
Thẻ:loading_and_analysis
,execution
--coverage_output_generator=<a build target label>
mặc định: "@bazel_tools//tools/test:lcov_merger"-
Vị trí của tệp nhị phân dùng để xử lý sau các báo cáo phạm vi thô. Hiện tại, đây phải là một nhóm tệp chứa một tệp duy nhất, tệp nhị phân. Giá trị mặc định là "//tools/test:lcov_merger".
Thẻ:changes_inputs
,affects_outputs
,loading_and_analysis
--coverage_report_generator=<a build target label>
mặc định: "@bazel_tools//tools/test:coverage_report_generator"-
Vị trí của tệp nhị phân dùng để tạo báo cáo mức độ sử dụng. Hiện tại, đây phải là một nhóm tệp chứa một tệp duy nhất, tệp nhị phân. Giá trị mặc định là "//tools/test:coverage_report_generator".
Thẻ:changes_inputs
,affects_outputs
,loading_and_analysis
--coverage_support=<a build target label>
mặc định: "@bazel_tools//tools/test:coverage_support"-
Vị trí của các tệp hỗ trợ bắt buộc trên dữ liệu đầu vào của mọi hành động kiểm thử thu thập mức độ sử dụng mã. Giá trị mặc định là "//tools/test:coverage_support".
Thẻ:changes_inputs
,affects_outputs
,loading_and_analysis
--crosstool_top=<a build target label>
mặc định: "@bazel_tools//tools/cpp:toolchain"-
Nhãn của gói công cụ đa nền tảng dùng để biên dịch mã C++.
Thẻ:loading_and_analysis
,changes_inputs
,affects_outputs
--custom_malloc=<a build target label>
mặc định: xem nội dung mô tả-
Chỉ định cách triển khai malloc tuỳ chỉnh. Chế độ cài đặt này sẽ ghi đè các thuộc tính malloc trong quy tắc bản dựng.
Thẻ:changes_inputs
,affects_outputs
--experimental_add_exec_constraints_to_targets=<a '<RegexFilter>=<label1>[,<label2>,...]' assignment>
nhiều lần sử dụng được tích luỹ-
Danh sách biểu thức chính quy được phân tách bằng dấu phẩy, mỗi biểu thức có thể có tiền tố là - (biểu thức phủ định), được gán (=) cho danh sách các mục tiêu giá trị quy tắc ràng buộc được phân tách bằng dấu phẩy. Nếu một mục tiêu không khớp với biểu thức âm và ít nhất một biểu thức dương, thì độ phân giải chuỗi công cụ của mục tiêu đó sẽ được thực hiện như thể mục tiêu đó đã khai báo các giá trị ràng buộc dưới dạng các ràng buộc thực thi. Ví dụ: //demo,-test=@platforms//cpus:x86_64 sẽ thêm "x86_64" vào bất kỳ mục tiêu nào trong //demo, ngoại trừ những mục tiêu có tên chứa "test".
Thẻ:loading_and_analysis
- Giá trị mặc định của
--[no]experimental_include_xcode_execution_requirements
: "false" - Nếu bạn đặt, hãy thêm yêu cầu thực thi "requires-xcode:{version}" vào mọi thao tác Xcode. Nếu phiên bản xcode có nhãn được nối bằng dấu gạch nối, hãy thêm yêu cầu thực thi "requires-xcode-label:{version_label}".
Thẻ:loses_incremental_state
,loading_and_analysis
,execution
- Giá trị mặc định của
--[no]experimental_prefer_mutual_xcode
: "true" - Nếu đúng, hãy sử dụng Xcode mới nhất có sẵn cả cục bộ và từ xa. Nếu giá trị là false hoặc nếu không có phiên bản nào có sẵn, hãy sử dụng phiên bản Xcode cục bộ được chọn thông qua xcode-select.
Thẻ:loses_incremental_state
--extra_execution_platforms=<comma-separated list of options>
mặc định: ""-
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(). Bạn chỉ có thể đặt tuỳ chọn này một lần; các thực thể sau đó sẽ ghi đè các chế độ cài đặt cờ trước đó.
Thẻ:execution
--extra_toolchains=<comma-separated list of options>
nhiều lần sử dụng được tích luỹ-
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 những chuỗi công cụ được khai báo trong tệp WORKSPACE bằng register_toolchains().
Thẻ:affects_outputs
,changes_inputs
,loading_and_analysis
--grte_top=<a label>
mặc định: xem nội dung mô tả-
Nhãn cho thư viện libc đã kiểm tra. Giá trị mặc định được chuỗi công cụ crosstool chọn và bạn hầu như không bao giờ cần ghi đè giá trị này.
Thẻ:action_command_lines
,affects_outputs
--host_compiler=<a string>
mặc định: xem nội dung mô tả-
Trình biên dịch C++ để sử dụng cho quá trình biên dịch máy chủ lưu trữ. Giá trị này sẽ bị bỏ qua nếu bạn không đặt --host_crosstool_top.
Thẻ:loading_and_analysis
,execution
--host_crosstool_top=<a build target label>
mặc định: xem nội dung mô tả- Theo mặc định, các tuỳ chọn --crosstool_top và --compiler cũng được dùng cho cấu hình exec. Nếu bạn cung cấp cờ này, Bazel sẽ sử dụng libc và trình biên dịch mặc định cho crosstool_top đã cho.
Thẻ:loading_and_analysis
,changes_inputs
,affects_outputs
--host_grte_top=<a label>
mặc định: xem nội dung mô tả- Nếu được chỉ định, chế độ cài đặt này sẽ ghi đè thư mục cấp cao nhất libc (--grte_top) cho cấu hình thực thi.
Thẻ:action_command_lines
,affects_outputs
--host_platform=<a build target label>
mặc định: "@bazel_tools//tools:host_platform"-
Nhãn của quy tắc nền tảng mô tả hệ thống lưu trữ.
Thẻ:affects_outputs
,changes_inputs
,loading_and_analysis
- Giá trị mặc định của
--[no]incompatible_dont_enable_host_nonhost_crosstool_features
: "true" - Nếu đúng, Bazel sẽ không bật các tính năng "máy chủ" và "không phải máy chủ" trong chuỗi công cụ c++ (xem https://github.com/bazelbuild/bazel/issues/7407 để biết thêm thông tin).
Thẻ:loading_and_analysis
,incompatible_change
- Giá trị mặc định của
--[no]incompatible_enable_android_toolchain_resolution
: "true" -
Sử dụng độ phân giải chuỗi công cụ để chọn SDK Android cho các quy tắc Android (Starlark và gốc)
Thẻ:loading_and_analysis
,incompatible_change
- Giá trị mặc định của
--[no]incompatible_enable_apple_toolchain_resolution
: "false" -
Sử dụng độ phân giải chuỗi công cụ để chọn SDK Apple cho các quy tắc của Apple (Starlark và gốc)
Thẻ:loading_and_analysis
,incompatible_change
- Giá trị mặc định của
--[no]incompatible_make_thinlto_command_lines_standalone
: "true" - Nếu đúng, Bazel sẽ không sử dụng lại các dòng lệnh thao tác liên kết C++ cho các dòng lệnh lập chỉ mục lto (xem https://github.com/bazelbuild/bazel/issues/6791 để biết thêm thông tin).
Thẻ:loading_and_analysis
,incompatible_change
- Giá trị mặc định của
--[no]incompatible_remove_legacy_whole_archive
: "true" - Nếu đúng, theo mặc định, Bazel sẽ không liên kết các phần phụ thuộc thư viện dưới dạng toàn bộ bản lưu trữ (xem https://github.com/bazelbuild/bazel/issues/7362 để biết hướng dẫn di chuyển).
Thẻ:loading_and_analysis
,incompatible_change
- Giá trị mặc định của
--[no]incompatible_require_ctx_in_configure_features
: "true" - Nếu đúng, Bazel sẽ yêu cầu tham số "ctx" trong cc_common.configure_features (xem https://github.com/bazelbuild/bazel/issues/7793 để biết thêm thông tin).
Thẻ:loading_and_analysis
,incompatible_change
- Sử dụng đối tượng dùng chung giao diện nếu chuỗi công cụ hỗ trợ. Tất cả chuỗi công cụ ELF hiện đều hỗ trợ chế độ cài đặt này.
Thẻ:loading_and_analysis
,affects_outputs
,affects_outputs
--ios_sdk_version=<a dotted version (for example '2.3' or '3.3alpha2.4')>
mặc định: xem nội dung mô tả-
Chỉ định phiên bản SDK iOS để sử dụng nhằm xây dựng ứng dụng iOS. Nếu không chỉ định, hãy sử dụng phiên bản SDK iOS mặc định từ "xcode_version".
Thẻ:loses_incremental_state
--macos_sdk_version=<a dotted version (for example '2.3' or '3.3alpha2.4')>
mặc định: xem nội dung mô tả-
Chỉ định phiên bản SDK macOS để sử dụng nhằm tạo ứng dụng macOS. Nếu không chỉ định, sẽ sử dụng phiên bản SDK macOS mặc định từ "xcode_version".
Thẻ:loses_incremental_state
--minimum_os_version=<a string>
mặc định: xem nội dung mô tả- Phiên bản hệ điều hành tối thiểu mà mục tiêu biên dịch của bạn nhắm đến.
Thẻ:loading_and_analysis
,affects_outputs
--platform_mappings=<a relative path>
mặc định: ""-
Vị trí của tệp ánh xạ mô tả nền tảng nào sẽ sử dụng nếu không có nền tảng nào được đặt hoặc cờ nào sẽ được đặt khi nền tảng đã tồn tại. Phải tương ứng với thư mục gốc của không gian làm việc chính. Mặc định là "platform_mappings" (một tệp nằm ngay trong thư mục gốc của không gian làm việc).
Thẻ:affects_outputs
,changes_inputs
,loading_and_analysis
--platforms=<a build target label>
mặc định: ""-
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.
Thẻ:affects_outputs
,changes_inputs
,loading_and_analysis
--python2_path=<a string>
mặc định: xem nội dung mô tả-
Không dùng nữa, không hoạt động. Tắt bằng `--incompatible_use_python_toolchains`.
Thẻ:no_op
,deprecated
--python3_path=<a string>
mặc định: xem nội dung mô tả-
Không dùng nữa, không hoạt động. Tắt bằng `--incompatible_use_python_toolchains`.
Thẻ:no_op
,deprecated
--python_path=<a string>
mặc định: xem nội dung mô tả-
Đường dẫn tuyệt đối của trình thông dịch Python được gọi để chạy các mục tiêu Python trên nền tảng mục tiêu. Không dùng nữa; bị vô hiệu hoá bằng --incompatible_use_python_toolchains.
Thẻ:loading_and_analysis
,affects_outputs
--python_top=<a build target label>
mặc định: xem nội dung mô tả-
Nhãn của py_runtime đại diện cho trình thông dịch Python được gọi để chạy các mục tiêu Python trên nền tảng mục tiêu. Không dùng nữa; bị vô hiệu hoá bằng --incompatible_use_python_toolchains.
Thẻ:loading_and_analysis
,affects_outputs
--tvos_sdk_version=<a dotted version (for example '2.3' or '3.3alpha2.4')>
mặc định: xem nội dung mô tả-
Chỉ định phiên bản SDK tvOS để sử dụng nhằm xây dựng ứng dụng tvOS. Nếu không chỉ định, hãy sử dụng phiên bản SDK tvOS mặc định từ "xcode_version".
Thẻ:loses_incremental_state
--watchos_sdk_version=<a dotted version (for example '2.3' or '3.3alpha2.4')>
mặc định: xem nội dung mô tả- Chỉ định phiên bản SDK watchOS để sử dụng nhằm xây dựng ứng dụng watchOS. Nếu không chỉ định, hãy sử dụng phiên bản SDK watchOS mặc định từ "xcode_version".
Thẻ:loses_incremental_state
--xcode_version=<a string>
mặc định: xem nội dung mô tả- Nếu được chỉ định, hãy sử dụng Xcode của phiên bản đã cho cho các thao tác bản dựng có liên quan. Nếu không chỉ định, hãy sử dụng phiên bản trình thực thi mặc định của Xcode.
Thẻ:loses_incremental_state
--xcode_version_config=<a build target label>
mặc định: "@bazel_tools//tools/cpp:host_xcodes"-
Nhãn của quy tắc xcode_config dùng để chọn phiên bản Xcode trong cấu hình bản dựng.
Thẻ:loses_incremental_state
,loading_and_analysis
- Các tuỳ chọn kiểm soát đầu ra của lệnh:
- Giá trị mặc định của
--[no]apple_generate_dsym
: "false" -
Liệu có tạo (các) tệp biểu tượng gỡ lỗi (.dSYM) hay không.
Thẻ:affects_outputs
,action_command_lines
- Giá trị mặc định của
--[no]build_runfile_links
: "true" - Nếu đúng, hãy tạo rừng đường liên kết tượng trưng cho tệp chạy cho tất cả các mục tiêu. Nếu giá trị là false, chỉ ghi các tệp này khi một hành động cục bộ, lệnh kiểm thử hoặc chạy yêu cầu.
Thẻ:affects_outputs
- Giá trị mặc định của
--[no]build_runfile_manifests
: "true" - Nếu đúng, hãy ghi tệp kê khai tệp chạy cho tất cả các mục tiêu. Nếu sai, hãy bỏ qua các giá trị này. Các kiểm thử cục bộ sẽ không chạy được khi giá trị là false.
Thẻ:affects_outputs
- Giá trị mặc định của
--[no]build_test_dwp
: "false" - Nếu được bật, khi tạo các chương trình kiểm thử C++ một cách tĩnh và có tính năng phân tách, tệp .dwp cho tệp nhị phân kiểm thử cũng sẽ được tạo tự động.
Thẻ:loading_and_analysis
,affects_outputs
--cc_proto_library_header_suffixes=<comma-separated set of options>
mặc định: ".pb.h"- Đặt hậu tố của các tệp tiêu đề mà cc_proto_library tạo.
Thẻ:affects_outputs
,loading_and_analysis
--cc_proto_library_source_suffixes=<comma-separated set of options>
mặc định: ".pb.cc"-
Đặt hậu tố của các tệp nguồn mà cc_proto_library tạo.
Thẻ:affects_outputs
,loading_and_analysis
- Giá trị mặc định của
--[no]experimental_proto_descriptor_sets_include_source_info
: "false" -
Chạy các thao tác bổ sung cho các phiên bản API Java thay thế trong proto_library.
Thẻ:affects_outputs
,loading_and_analysis
,experimental
- Giá trị mặc định của
--[no]experimental_proto_extra_actions
: "false" -
Chạy các thao tác bổ sung cho các phiên bản API Java thay thế trong proto_library.
Thẻ:affects_outputs
,loading_and_analysis
,experimental
- Giá trị mặc định của
--[no]experimental_save_feature_state
: "false" -
Lưu trạng thái của các tính năng đã bật và được yêu cầu dưới dạng kết quả biên dịch.
Thẻ:affects_outputs
,experimental
--fission=<a set of compilation modes>
mặc định: "no"- Chỉ định chế độ biên dịch nào sử dụng tính năng phân hạch cho các bản biên dịch và đường liên kết C++. Có thể là bất kỳ tổ hợp nào của {'fastbuild', 'dbg', 'opt'} hoặc các giá trị đặc biệt "yes" để bật tất cả chế độ và "no" để tắt tất cả chế độ.
Thẻ:loading_and_analysis
,action_command_lines
,affects_outputs
- Giá trị mặc định của
--[no]incompatible_always_include_files_in_data
: "true" - Nếu đúng, các quy tắc gốc sẽ thêm <code>DefaultInfo.files</code> của các phần phụ thuộc dữ liệu vào tệp chạy của chúng, khớp với hành vi được đề xuất cho các quy tắc Starlark (https://bazel.build/extending/rules#runfiles_features_to_avoid).
Thẻ:affects_outputs
,incompatible_change
- Giá trị mặc định của
--[no]legacy_external_runfiles
: "true" - Nếu đúng, hãy tạo rừng đường liên kết tượng trưng cho tệp chạy cho các kho lưu trữ bên ngoài trong .runfiles/wsname/external/repo (ngoài .runfiles/repo).
Thẻ:affects_outputs
- Giá trị mặc định của
--[no]objc_generate_linkmap
: "false" -
Chỉ định xem có tạo tệp liên kết hay không.
Thẻ:affects_outputs
- Giá trị mặc định của
--[no]save_temps
: "false" - Nếu được đặt, kết quả tạm thời từ gcc sẽ được lưu. Các tệp này bao gồm tệp .s (mã tập hợp), tệp .i (C được xử lý trước) và tệp .ii (C++ được xử lý trước).
Thẻ:affects_outputs
- Các tuỳ chọn cho phép người dùng định cấu hình đầu ra dự kiến, ảnh hưởng đến giá trị của đầu ra đó, thay vì sự tồn tại của đầu ra:
--action_env=<a 'name=value' assignment with an optional value part>
nhiều lần sử dụng được tích luỹ-
Chỉ định tập hợp các biến môi trường có sẵn cho các hành động có cấu hình mục tiêu. Bạn có thể chỉ định biến theo tên, trong trường hợp này giá trị sẽ được lấy từ môi trường gọi, hoặc theo cặp name=value để đặt giá trị độc lập với môi trường gọi. Bạn có thể sử dụng tuỳ chọn này nhiều lần; đối với các tuỳ chọn được đưa ra cho cùng một biến, tuỳ chọn mới nhất sẽ thắng, còn các tuỳ chọn cho các biến khác nhau sẽ được tích luỹ.
Thẻ:action_command_lines
--android_cpu=<a string>
mặc định: "armeabi-v7a"- CPU mục tiêu của Android.
Thẻ:affects_outputs
,loading_and_analysis
,loses_incremental_state
- Giá trị mặc định của
--[no]android_databinding_use_androidx
: "true" - Tạo các tệp liên kết dữ liệu tương thích với AndroidX. Phương thức này chỉ được dùng với databinding v2. Cờ này không có tác dụng.
Thẻ:affects_outputs
,loading_and_analysis
,loses_incremental_state
,experimental
- Giá trị mặc định của
--[no]android_databinding_use_v3_4_args
: "true" -
Sử dụng android databinding v2 với đối số 3.4.0. Cờ này không có tác dụng.
Thẻ:affects_outputs
,loading_and_analysis
,loses_incremental_state
,experimental
--android_dynamic_mode=<off, default or fully>
mặc định: "off"- xác định xem các phần phụ thuộc C++ của quy tắc Android có được liên kết động khi cc_binary không tạo thư viện dùng chung một cách rõ ràng hay không. "mặc định" có nghĩa là bazel sẽ chọn xem có liên kết động hay không. "đầy đủ" có nghĩa là tất cả thư viện sẽ được liên kết động. "tắt" có nghĩa là tất cả thư viện sẽ được liên kết chủ yếu ở chế độ tĩnh.
Thẻ:affects_outputs
,loading_and_analysis
--android_manifest_merger_order=<alphabetical, alphabetical_by_configuration or dependency>
mặc định: "alphabetical"-
Đặt thứ tự của tệp kê khai được chuyển đến trình sáp nhập tệp kê khai cho tệp nhị phân Android. ALPHABETICAL (TĂNG DẦN) nghĩa là tệp kê khai được sắp xếp theo đường dẫn tương ứng với execroot. ALPHABETICAL_BY_CONFIGURATION có nghĩa là tệp kê khai được sắp xếp theo đường dẫn tương ứng với thư mục cấu hình trong thư mục đầu ra. DEPENDENCY (PHẦN PHỤ THUỘC) có nghĩa là tệp kê khai được sắp xếp theo thứ tự tệp kê khai của mỗi thư viện đứng trước tệp kê khai của các phần phụ thuộc.
Thẻ:action_command_lines
,execution
- Giá trị mặc định của
--[no]android_resource_shrinking
: "false" - Bật tính năng rút gọn tài nguyên cho các tệp APK android_binary sử dụng ProGuard.
Thẻ:affects_outputs
,loading_and_analysis
- Giá trị mặc định của
--[no]build_python_zip
: "tự động" -
Tạo tệp zip có thể thực thi python; bật trên Windows, tắt trên các nền tảng khác
Thẻ:affects_outputs
--catalyst_cpus=<comma-separated list of options>
nhiều lần sử dụng được tích luỹ-
Danh sách các cấu trúc được phân tách bằng dấu phẩy để tạo tệp nhị phân Apple Catalyst.
Thẻ:loses_incremental_state
,loading_and_analysis
- Giá trị mặc định của
--[no]collect_code_coverage
: "false" - Nếu được chỉ định, Bazel sẽ đo lường mã (sử dụng công cụ đo lường ngoại tuyến nếu có thể) và sẽ thu thập thông tin về mức độ sử dụng trong quá trình kiểm thử. Chỉ những mục tiêu khớp với --instrumentation_filter mới bị ảnh hưởng. Thông thường, bạn không nên chỉ định trực tiếp tuỳ chọn này – thay vào đó, hãy sử dụng lệnh "bazel coverage".
Thẻ:affects_outputs
--compilation_mode=<fastbuild, dbg or opt>
[-c
] mặc định: "fastbuild"-
Chỉ định chế độ mà tệp nhị phân sẽ được tạo. Giá trị: "fastbuild", "dbg", "opt".
Thẻ:affects_outputs
,action_command_lines
--conlyopt=<a string>
nhiều lần sử dụng được tích luỹ- Tuỳ chọn bổ sung để truyền đến gcc khi biên dịch tệp nguồn C.
Thẻ:action_command_lines
,affects_outputs
--copt=<a string>
nhiều lần sử dụng được tích luỹ-
Các tuỳ chọn bổ sung để truyền đến gcc.
Thẻ:action_command_lines
,affects_outputs
--cpu=<a string>
mặc định: ""- CPU mục tiêu.
Thẻ:changes_inputs
,affects_outputs
--cs_fdo_absolute_path=<a string>
mặc định: xem nội dung mô tả-
Sử dụng thông tin hồ sơ CSFDO để tối ưu hoá quá trình biên dịch. Chỉ định tên đường dẫn tuyệt đối của tệp zip chứa tệp hồ sơ, tệp hồ sơ LLVM thô hoặc được lập chỉ mục.
Thẻ:affects_outputs
--cs_fdo_instrument=<a string>
mặc định: xem nội dung mô tả-
Tạo tệp nhị phân bằng khả năng đo lường FDO nhạy cảm với ngữ cảnh. Với trình biên dịch Clang/LLVM, trình biên dịch này cũng chấp nhận tên thư mục mà(các) tệp hồ sơ thô sẽ được kết xuất trong thời gian chạy.
Thẻ:affects_outputs
--cs_fdo_profile=<a build target label>
mặc định: xem nội dung mô tả-
cs_fdo_profile đại diện cho hồ sơ nhạy cảm theo ngữ cảnh sẽ được dùng để tối ưu hoá.
Thẻ:affects_outputs
--cxxopt=<a string>
nhiều lần sử dụng được tích luỹ- Tuỳ chọn bổ sung để truyền đến gcc khi biên dịch tệp nguồn C++.
Thẻ:action_command_lines
,affects_outputs
--define=<a 'name=value' assignment>
nhiều lần sử dụng được tích luỹ-
Mỗi tuỳ chọn --define chỉ định một giá trị gán cho một biến bản dựng.
Thẻ:changes_inputs
,affects_outputs
- Giá trị mặc định của
--dynamic_mode=<off, default or fully>
: "mặc định" - Xác định xem tệp nhị phân C++ có được liên kết động hay không. "mặc định" có nghĩa là Bazel sẽ chọn xem có liên kết động hay không. "đầy đủ" có nghĩa là tất cả thư viện sẽ được liên kết động. "tắt" có nghĩa là tất cả thư viện sẽ được liên kết chủ yếu ở chế độ tĩnh.
Thẻ:loading_and_analysis
,affects_outputs
- Giá trị mặc định của
--[no]enable_fdo_profile_absolute_path
: "true" - Nếu bạn đặt, việc sử dụng fdo_absolute_profile_path sẽ gây ra lỗi.
Thẻ:affects_outputs
- Giá trị mặc định của
--[no]enable_runfiles
: "tự động" - Bật cây đường liên kết tượng trưng của tệp chạy; Theo mặc định, tính năng này sẽ tắt trên Windows và trên các nền tảng khác.
Thẻ:affects_outputs
--experimental_action_listener=<a build target label>
nhiều lần sử dụng được tích luỹ- Ngừng sử dụng và thay bằng các khía cạnh. Sử dụng action_listener để đính kèm extra_action vào các hành động bản dựng hiện có.
Thẻ:execution
,experimental
- Giá trị mặc định của
--[no]experimental_android_compress_java_resources
: "false" -
Nén tài nguyên Java trong tệp APK
Thẻ:affects_outputs
,loading_and_analysis
,experimental
- Giá trị mặc định của
--[no]experimental_android_databinding_v2
: "true" -
Sử dụng android databinding v2. Cờ này không có tác dụng.
Thẻ:affects_outputs
,loading_and_analysis
,loses_incremental_state
,experimental
- Giá trị mặc định của
--[no]experimental_android_resource_shrinking
: "false" - Bật tính năng rút gọn tài nguyên cho các tệp APK android_binary sử dụng ProGuard.
Thẻ:affects_outputs
,loading_and_analysis
- Giá trị mặc định của
--[no]experimental_android_rewrite_dexes_with_rex
: "false" -
sử dụng công cụ rex để ghi lại các tệp dex
Thẻ:affects_outputs
,loading_and_analysis
,loses_incremental_state
,experimental
- Giá trị mặc định của
--[no]experimental_collect_code_coverage_for_generated_files
: "false" - Nếu được chỉ định, Bazel cũng sẽ tạo thông tin thu thập mức độ sử dụng cho các tệp đã tạo.
Thẻ:affects_outputs
--experimental_objc_fastbuild_options=<comma-separated list of options>
mặc định: "-O0,-DDEBUG=1"-
Sử dụng các chuỗi này làm tuỳ chọn trình biên dịch bản dựng nhanh objc.
Thẻ:action_command_lines
- Giá trị mặc định của
--[no]experimental_omitfp
: "false" - Nếu đúng, hãy sử dụng libunwind để gỡ bỏ ngăn xếp và biên dịch bằng -fomit-frame-pointer và -fasynchronous-unwind-tables.
Thẻ:action_command_lines
,affects_outputs
,experimental
--experimental_output_paths=<off, content or strip>
mặc định: "off"-
Mô hình nào sẽ được sử dụng cho vị trí trong quy tắc cây đầu ra ghi đầu ra của chúng, đặc biệt là đối với các bản dựng đa nền tảng / đa cấu hình. Đây là một tính năng thử nghiệm. Hãy xem https://github.com/bazelbuild/bazel/issues/6526 để biết thông tin chi tiết. Các hành động Starlark có thể chọn sử dụng tính năng liên kết đường dẫn bằng cách thêm khoá "supports-path-mapping" vào tập hợp "execution_requirements".
Thẻ:loses_incremental_state
,bazel_internal_configuration
,affects_outputs
,execution
--experimental_override_name_platform_in_output_dir=<a 'label=value' assignment>
nhiều lần sử dụng được tích luỹ-
Mỗi mục nhập phải có dạng label=value, trong đó label (nhãn) tham chiếu đến một nền tảng và value (giá trị) là tên ngắn mong muốn để sử dụng trong đường dẫn đầu ra. Chỉ được dùng khi --experimental_platform_in_output_dir là true. Có mức độ ưu tiên đặt tên cao nhất.
Thẻ:affects_outputs
,experimental
- Giá trị mặc định của
--[no]experimental_platform_in_output_dir
: "false" - Nếu đúng, tên ngắn cho nền tảng mục tiêu sẽ được dùng trong tên thư mục đầu ra thay vì CPU. Lược đồ chính xác là thử nghiệm và có thể thay đổi: Trước tiên, trong trường hợp hiếm hoi tuỳ chọn --platforms không có đúng một giá trị, thì một hàm băm của tuỳ chọn platforms sẽ được sử dụng. Tiếp theo, nếu bất kỳ tên ngắn nào cho nền tảng hiện tại được đăng ký bằng --experimental_override_name_platform_in_output_dir, thì tên ngắn đó sẽ được sử dụng. Sau đó, nếu bạn đặt --experimental_use_platforms_in_output_dir_legacy_heuristic, hãy sử dụng tên ngắn dựa trên Nhãn nền tảng hiện tại. Cuối cùng, hàm băm của tuỳ chọn nền tảng sẽ được dùng làm phương án cuối cùng.
Thẻ:affects_outputs
,experimental
- Giá trị mặc định của
--[no]experimental_use_llvm_covmap
: "false" - Nếu được chỉ định, Bazel sẽ tạo thông tin bản đồ mức độ sử dụng llvm-cov thay vì gcov khi bật collect_code_coverage.
Thẻ:changes_inputs
,affects_outputs
,loading_and_analysis
,experimental
- Giá trị mặc định của
--[no]experimental_use_platforms_in_output_dir_legacy_heuristic
: "true" -
Vui lòng chỉ sử dụng cờ này trong chiến lược di chuyển hoặc kiểm thử được đề xuất. Xin lưu ý rằng phương pháp phỏng đoán có những thiếu sót đã biết và bạn nên chuyển sang chỉ dựa vào --experimental_override_name_platform_in_output_dir.
Thẻ:affects_outputs
,experimental
--fat_apk_cpu=<comma-separated set of options>
mặc định: "armeabi-v7a"-
Việc đặt tuỳ chọn này sẽ bật các tệp APK lớn, chứa các tệp nhị phân gốc cho tất cả các cấu trúc mục tiêu được chỉ định, ví dụ: --fat_apk_cpu=x86,armeabi-v7a. Nếu bạn chỉ định cờ này, thì --android_cpu sẽ bị bỏ qua đối với các phần phụ thuộc của quy tắc android_binary.
Thẻ:affects_outputs
,loading_and_analysis
,loses_incremental_state
- Giá trị mặc định của
--[no]fat_apk_hwasan
: "false" -
Liệu có tạo các phần phân tách HWASAN hay không.
Thẻ:affects_outputs
,loading_and_analysis
,loses_incremental_state
--fdo_instrument=<a string>
mặc định: xem nội dung mô tả-
Tạo tệp nhị phân bằng khả năng đo lường FDO. Với trình biên dịch Clang/LLVM, trình biên dịch này cũng chấp nhận tên thư mục mà(các) tệp hồ sơ thô sẽ được kết xuất trong thời gian chạy.
Thẻ:affects_outputs
--fdo_optimize=<a string>
mặc định: xem nội dung mô tả- Sử dụng thông tin hồ sơ FDO để tối ưu hoá quá trình biên dịch. Chỉ định tên của tệp zip chứa cây tệp .gcda, tệp afdo chứa hồ sơ tự động hoặc tệp hồ sơ LLVM. Cờ này cũng chấp nhận các tệp được chỉ định làm nhãn (ví dụ: `//foo/bar:file.afdo` – bạn có thể cần thêm một lệnh `exports_files` vào gói tương ứng) và các nhãn trỏ đến mục tiêu `fdo_profile`. Cờ này sẽ được thay thế bằng quy tắc `fdo_profile`.
Thẻ:affects_outputs
--fdo_prefetch_hints=<a build target label>
mặc định: xem nội dung mô tả-
Sử dụng gợi ý tìm nạp trước bộ nhớ đệm.
Thẻ:affects_outputs
--fdo_profile=<a build target label>
mặc định: xem nội dung mô tả-
fdo_profile đại diện cho hồ sơ sẽ được dùng để tối ưu hoá.
Thẻ:affects_outputs
--features=<a string>
nhiều lần sử dụng được tích luỹ- Theo mặc định, các tính năng đã cho sẽ được bật hoặc tắt đối với các mục tiêu được tạo trong cấu hình mục tiêu. Việc chỉ định -<feature> sẽ tắt tính năng đó. Các đặc điểm tiêu cực luôn ghi đè các đặc điểm tích cực. Xem thêm --host_features
Thẻ
:changes_inputs
,affects_outputs
- Giá trị mặc định của
--[no]force_pic
: "false" - Nếu được bật, tất cả các bản biên dịch C++ sẽ tạo mã không phụ thuộc vào vị trí ("-fPIC"), các đường liên kết sẽ ưu tiên thư viện tạo sẵn PIC hơn thư viện không phải PIC và các đường liên kết sẽ tạo tệp thực thi không phụ thuộc vào vị trí ("-pie").
Thẻ:loading_and_analysis
,affects_outputs
--host_action_env=<a 'name=value' assignment with an optional value part>
nhiều lần sử dụng được tích luỹ- Chỉ định tập hợp các biến môi trường có sẵn cho các hành động có cấu hình thực thi. Bạn có thể chỉ định biến theo tên, trong trường hợp này giá trị sẽ được lấy từ môi trường gọi, hoặc theo cặp name=value để đặt giá trị độc lập với môi trường gọi. Bạn có thể sử dụng tuỳ chọn này nhiều lần; đối với các tuỳ chọn được đưa ra cho cùng một biến, tuỳ chọn mới nhất sẽ thắng, còn các tuỳ chọn cho các biến khác nhau sẽ được tích luỹ.
Thẻ:action_command_lines
--host_compilation_mode=<fastbuild, dbg or opt>
mặc định: "opt"-
Chỉ định chế độ mà các công cụ dùng trong quá trình xây dựng sẽ được tạo. Giá trị: "fastbuild", "dbg", "opt".
Thẻ:affects_outputs
,action_command_lines
--host_conlyopt=<a string>
nhiều lần sử dụng được tích luỹ- Tuỳ chọn bổ sung để truyền đến trình biên dịch C khi biên dịch tệp nguồn C (nhưng không phải C++) trong cấu hình thực thi.
Thẻ:action_command_lines
,affects_outputs
--host_copt=<a string>
nhiều lần sử dụng được tích luỹ-
Các tuỳ chọn bổ sung để chuyển đến trình biên dịch C cho các công cụ được tạo trong cấu hình thực thi.
Thẻ:action_command_lines
,affects_outputs
--host_cpu=<a string>
mặc định: ""-
CPU lưu trữ.
Thẻ:changes_inputs
,affects_outputs
--host_cxxopt=<a string>
nhiều lần sử dụng được tích luỹ-
Các tuỳ chọn bổ sung để truyền đến trình biên dịch C++ cho các công cụ được tạo trong cấu hình thực thi.
Thẻ:action_command_lines
,affects_outputs
--host_features=<a string>
nhiều lần sử dụng được tích luỹ- Theo mặc định, các tính năng đã cho sẽ được bật hoặc tắt đối với các mục tiêu được tạo trong cấu hình thực thi. Việc chỉ định -<feature> sẽ tắt tính năng đó. Các đặc điểm tiêu cực luôn ghi đè các đặc điểm tích cực.
Thẻ:changes_inputs
,affects_outputs
--host_force_python=<PY2 or PY3>
mặc định: xem nội dung mô tả- Ghi đè phiên bản Python cho cấu hình thực thi. Có thể là "PY2" hoặc "PY3".
Thẻ:loading_and_analysis
,affects_outputs
--host_linkopt=<a string>
nhiều lần sử dụng được tích luỹ-
Tuỳ chọn bổ sung để truyền đến trình liên kết khi liên kết các công cụ trong cấu hình thực thi.
Thẻ:action_command_lines
,affects_outputs
--host_macos_minimum_os=<a dotted version (for example '2.3' or '3.3alpha2.4')>
mặc định: xem nội dung mô tả-
Phiên bản macOS tương thích tối thiểu cho các mục tiêu lưu trữ. Nếu không chỉ định, hãy sử dụng "macos_sdk_version".
Thẻ:loses_incremental_state
--host_per_file_copt=<a comma-separated list of regex expressions with prefix '-' specifying excluded paths followed by an @ and a comma separated list of options>
nhiều lần sử dụng được tích luỹ-
Các tuỳ chọn bổ sung để truyền có chọn lọc đến trình biên dịch C/C++ khi biên dịch một số tệp nhất định trong cấu hình thực thi. Bạn có thể truyền tuỳ chọn này nhiều lần. Cú pháp: bộ_lọc_biểu_thức_định_liệu@tuỳ_chọn_1,tuỳ_chọn_2,...,tuỳ_chọn_n. Trong đó, regex_filter là danh sách các mẫu biểu thức chính quy bao gồm và loại trừ (Xem thêm --instrumentation_filter). option_1 đến option_n là các tuỳ chọn dòng lệnh tuỳ ý. Nếu một tuỳ chọn chứa dấu phẩy, thì bạn phải đặt tuỳ chọn đó trong dấu ngoặc kép có dấu gạch chéo ngược. Tuỳ chọn có thể chứa @. Chỉ @ đầu tiên mới được dùng để phân tách chuỗi. Ví dụ: --host_per_file_copt=//foo/.*\.cc,-//foo/bar\.cc@-O0 thêm tuỳ chọn dòng lệnh -O0 vào dòng lệnh gcc của tất cả tệp cc trong //foo/ ngoại trừ bar.cc.
Thẻ:action_command_lines
,affects_outputs
--host_swiftcopt=<a string>
nhiều lần sử dụng được tích luỹ-
Các tuỳ chọn bổ sung để truyền đến swiftc cho các công cụ thực thi.
Thẻ:action_command_lines
,affects_outputs
- Giá trị mặc định của
--[no]incompatible_auto_exec_groups
: "false" -
Khi được bật, một nhóm thực thi sẽ tự động được tạo cho mỗi chuỗi công cụ mà một quy tắc sử dụng. Để quy tắc này hoạt động, bạn cần chỉ định tham số "toolchain" (chuỗi công cụ) trên các hành động của quy tắc. Để biết thêm thông tin, hãy xem https://github.com/bazelbuild/bazel/issues/17134.
Thẻ:affects_outputs
,incompatible_change
- Giá trị mặc định của
--[no]incompatible_merge_genfiles_directory
: "true" - Nếu đúng, thư mục genfiles sẽ được gộp vào thư mục bin.
Thẻ:affects_outputs
,incompatible_change
- Giá trị mặc định của
--[no]incompatible_use_host_features
: "true" - Nếu đúng, hãy chỉ sử dụng --features cho cấu hình mục tiêu và --host_features cho cấu hình thực thi.
Thẻ:changes_inputs
,affects_outputs
,incompatible_change
- Giá trị mặc định của
--[no]instrument_test_targets
: "false" -
Khi bật mức độ sử dụng, hãy chỉ định xem có nên cân nhắc việc đo lường các quy tắc kiểm thử hay không. Khi được đặt, các quy tắc kiểm thử do --instrumentation_filter bao gồm sẽ được đo lường. Nếu không, các quy tắc kiểm thử sẽ luôn bị loại trừ khỏi hoạt động đo lường mức độ sử dụng.
Thẻ:affects_outputs
--instrumentation_filter=<a comma-separated list of regex expressions with prefix '-' specifying excluded paths>
mặc định: "-/javatests[/:],-/test/java[/:]"- Khi bạn bật tính năng mức độ sử dụng, chỉ những quy tắc có tên được bộ lọc dựa trên biểu thức chính quy chỉ định mới được đo lường. Thay vào đó, các quy tắc có tiền tố là "-" sẽ bị loại trừ. Xin lưu ý rằng chỉ các quy tắc không phải quy tắc kiểm thử mới được đo lường, trừ phi bạn bật --instrument_test_targets.
Thẻ:affects_outputs
--ios_minimum_os=<a dotted version (for example '2.3' or '3.3alpha2.4')>
mặc định: xem nội dung mô tả-
Phiên bản iOS tương thích tối thiểu cho trình mô phỏng và thiết bị mục tiêu. Nếu không chỉ định, hãy sử dụng "ios_sdk_version".
Thẻ:loses_incremental_state
--ios_multi_cpus=<comma-separated list of options>
nhiều lần sử dụng được tích luỹ-
Danh sách các cấu trúc được phân tách bằng dấu phẩy để tạo ios_application. Kết quả là một tệp nhị phân phổ quát chứa tất cả các cấu trúc đã chỉ định.
Thẻ:loses_incremental_state
,loading_and_analysis
- Giá trị mặc định của
--[no]legacy_whole_archive
: "true" -
Không dùng nữa, thay vào đó là --incompatible_remove_legacy_whole_archive (xem https://github.com/bazelbuild/bazel/issues/7362 để biết thông tin chi tiết). Khi bật, hãy sử dụng --whole-archive cho các quy tắc cc_binary có linkshared=True và linkstatic=True hoặc "-static" trong linkopts. Việc này chỉ nhằm mục đích tương thích ngược. Một cách thay thế tốt hơn là sử dụng alwayslink=1 khi cần.
Thẻ:action_command_lines
,affects_outputs
,deprecated
--linkopt=<a string>
nhiều lần sử dụng được tích luỹ- Tuỳ chọn bổ sung để truyền đến gcc khi liên kết.
Thẻ:action_command_lines
,affects_outputs
--ltobackendopt=<a string>
nhiều lần sử dụng được tích luỹ-
Tuỳ chọn bổ sung để chuyển đến bước phụ trợ LTO (trong --features=thin_lto).
Thẻ:action_command_lines
,affects_outputs
--ltoindexopt=<a string>
nhiều lần sử dụng được tích luỹ-
Tuỳ chọn bổ sung để chuyển đến bước lập chỉ mục LTO (trong --features=thin_lto).
Thẻ:action_command_lines
,affects_outputs
--macos_cpus=<comma-separated list of options>
nhiều lần sử dụng được tích luỹ-
Danh sách các cấu trúc được phân tách bằng dấu phẩy để tạo tệp nhị phân Apple macOS.
Thẻ:loses_incremental_state
,loading_and_analysis
--macos_minimum_os=<a dotted version (for example '2.3' or '3.3alpha2.4')>
mặc định: xem nội dung mô tả-
Phiên bản macOS tương thích tối thiểu cho các mục tiêu. Nếu không chỉ định, hãy sử dụng "macos_sdk_version".
Thẻ:loses_incremental_state
--memprof_profile=<a build target label>
mặc định: xem nội dung mô tả-
Sử dụng hồ sơ memprof.
Thẻ:affects_outputs
- Giá trị mặc định của
--[no]objc_debug_with_GLIBCXX
: "false" - Nếu bạn đặt và chế độ biên dịch được đặt thành "dbg", hãy xác định GLIBCXX_DEBUG, GLIBCXX_DEBUG_PEDANTIC và GLIBCPP_CONCEPT_CHECKS.
Thẻ:action_command_lines
- Giá trị mặc định của
--[no]objc_enable_binary_stripping
: "false" -
Liệu có thực hiện việc xoá ký hiệu và mã chết trên các tệp nhị phân được liên kết hay không. Thao tác loại bỏ tệp nhị phân sẽ được thực hiện nếu bạn chỉ định cả cờ này và --compilation_mode=opt.
Thẻ:action_command_lines
--objccopt=<a string>
nhiều lần sử dụng được tích luỹ-
Các tuỳ chọn bổ sung để truyền đến gcc khi biên dịch tệp nguồn Objective-C/C++.
Thẻ:action_command_lines
--per_file_copt=<a comma-separated list of regex expressions with prefix '-' specifying excluded paths followed by an @ and a comma separated list of options>
nhiều lần sử dụng được tích luỹ-
Các tuỳ chọn bổ sung để truyền có chọn lọc đến gcc khi biên dịch một số tệp nhất định. Bạn có thể truyền tuỳ chọn này nhiều lần. Cú pháp: bộ_lọc_biểu_thức_định_liệu@tuỳ_chọn_1,tuỳ_chọn_2,...,tuỳ_chọn_n. Trong đó, regex_filter là danh sách các mẫu biểu thức chính quy bao gồm và loại trừ (Xem thêm --instrumentation_filter). option_1 đến option_n là các tuỳ chọn dòng lệnh tuỳ ý. Nếu một tuỳ chọn chứa dấu phẩy, thì bạn phải đặt tuỳ chọn đó trong dấu ngoặc kép có dấu gạch chéo ngược. Tuỳ chọn có thể chứa @. Chỉ @ đầu tiên mới được dùng để phân tách chuỗi. Ví dụ: --per_file_copt=//foo/.*\.cc,-//foo/bar\.cc@-O0 thêm tuỳ chọn dòng lệnh -O0 vào dòng lệnh gcc của tất cả tệp cc trong //foo/ ngoại trừ bar.cc.
Thẻ:action_command_lines
,affects_outputs
--per_file_ltobackendopt=<a comma-separated list of regex expressions with prefix '-' specifying excluded paths followed by an @ and a comma separated list of options>
nhiều lần sử dụng được tích luỹ-
Các tuỳ chọn bổ sung để chuyển có chọn lọc đến phần phụ trợ LTO (trong --features=thin_lto) khi biên dịch một số đối tượng phụ trợ nhất định. Bạn có thể truyền tuỳ chọn này nhiều lần. Cú pháp: bộ_lọc_biểu_thức_định_liệu@tuỳ_chọn_1,tuỳ_chọn_2,...,tuỳ_chọn_n. Trong đó, regex_filter là danh sách các mẫu biểu thức chính quy bao gồm và loại trừ. option_1 đến option_n là các tuỳ chọn dòng lệnh tuỳ ý. Nếu một tuỳ chọn chứa dấu phẩy, thì bạn phải đặt tuỳ chọn đó trong dấu ngoặc kép có dấu gạch chéo ngược. Tuỳ chọn có thể chứa @. Chỉ @ đầu tiên mới được dùng để phân tách chuỗi. Ví dụ: --per_file_ltobackendopt=//foo/.*\.o,-//foo/bar\.o@-O0 sẽ thêm tuỳ chọn dòng lệnh -O0 vào dòng lệnh phụ trợ LTO của tất cả tệp o trong //foo/ ngoại trừ bar.o.
Thẻ:action_command_lines
,affects_outputs
--platform_suffix=<a string>
mặc định: xem nội dung mô tả- Chỉ định hậu tố cần thêm vào thư mục cấu hình.
Thẻ:loses_incremental_state
,affects_outputs
,loading_and_analysis
--propeller_optimize=<a build target label>
mặc định: xem nội dung mô tả-
Sử dụng thông tin hồ sơ Propeller để tối ưu hoá mục tiêu bản dựng.Hồ sơ Propeller phải bao gồm ít nhất một trong hai tệp, hồ sơ cc và hồ sơ ld. Cờ này chấp nhận nhãn bản dựng phải tham chiếu đến các tệp đầu vào của hồ sơ cánh quạt. Ví dụ: tệp BUILD xác định nhãn, trong a/b/BUILD:propeller_optimize( name = "propeller_profile", cc_profile = "propeller_cc_profile.txt", ld_profile = "propeller_ld_profile.txt",)Có thể bạn phải thêm một lệnh exports_files vào gói tương ứng để Bazel có thể thấy các tệp này. Bạn phải sử dụng tuỳ chọn này như sau: --propeller_optimize=//a/b:propeller_profile
Thẻ:action_command_lines
,affects_outputs
--propeller_optimize_absolute_cc_profile=<a string>
mặc định: xem nội dung mô tả- Tên đường dẫn tuyệt đối của tệp cc_profile cho các bản dựng được tối ưu hoá bằng Propeller.
Thẻ:affects_outputs
--propeller_optimize_absolute_ld_profile=<a string>
mặc định: xem nội dung mô tả- Tên đường dẫn tuyệt đối của tệp ld_profile cho các bản dựng được tối ưu hoá bằng Propeller.
Thẻ:affects_outputs
--run_under=<a prefix in front of command>
mặc định: xem nội dung mô tả-
Tiền tố để chèn trước các tệp thực thi cho lệnh "test" (kiểm thử) và "run" (chạy). Nếu giá trị là "foo -bar" và dòng lệnh thực thi là "test_binary -baz", thì dòng lệnh cuối cùng sẽ là "foo -bar test_binary -baz".Đây cũng có thể là nhãn cho một mục tiêu có thể thực thi. Một số ví dụ: "valgrind", "strace", "strace -c", "valgrind --quiet --num-callers=20", "//package:target", '//package:target --options'.
Thẻ:action_command_lines
- Nếu đúng, các thư viện gốc chứa chức năng giống hệt nhau sẽ được chia sẻ giữa các mục tiêu khác nhau
Thẻ
:loading_and_analysis
,affects_outputs
- Giá trị mặc định của
--[no]stamp
: "false" -
Đóng dấu tệp nhị phân bằng ngày, tên người dùng, tên máy chủ, thông tin về không gian làm việc, v.v.
Thẻ:affects_outputs
- Giá trị mặc định của
--strip=<always, sometimes or never>
: "đôi khi" - Chỉ định xem có xoá các tệp nhị phân và thư viện dùng chung hay không (sử dụng "-Wl,--strip-debug"). Giá trị mặc định là "sometimes" (đôi khi) có nghĩa là xoá nếu --compilation_mode=fastbuild.
Thẻ:affects_outputs
--stripopt=<a string>
nhiều lần sử dụng được tích luỹ-
Các tuỳ chọn bổ sung để truyền vào tính năng loại bỏ khi tạo tệp nhị phân "<name>.stripped".
Thẻ:action_command_lines
,affects_outputs
--swiftcopt=<a string>
nhiều lần sử dụng được tích luỹ-
Các tuỳ chọn bổ sung để truyền đến quá trình biên dịch Swift.
Thẻ:action_command_lines
--tvos_cpus=<comma-separated list of options>
nhiều lần sử dụng được tích luỹ-
Danh sách kiến trúc được phân tách bằng dấu phẩy để tạo tệp nhị phân Apple tvOS.
Thẻ:loses_incremental_state
,loading_and_analysis
--tvos_minimum_os=<a dotted version (for example '2.3' or '3.3alpha2.4')>
mặc định: xem nội dung mô tả-
Phiên bản tvOS tối thiểu tương thích cho trình mô phỏng và thiết bị mục tiêu. Nếu không chỉ định, hãy sử dụng "tvos_sdk_version".
Thẻ:loses_incremental_state
--visionos_cpus=<comma-separated list of options>
nhiều lần sử dụng được tích luỹ-
Danh sách kiến trúc được phân tách bằng dấu phẩy để tạo tệp nhị phân visionOS của Apple.
Thẻ:loses_incremental_state
,loading_and_analysis
--watchos_cpus=<comma-separated list of options>
nhiều lần sử dụng được tích luỹ-
Danh sách được phân tách bằng dấu phẩy gồm các cấu trúc để tạo tệp nhị phân Apple watchOS.
Thẻ:loses_incremental_state
,loading_and_analysis
--watchos_minimum_os=<a dotted version (for example '2.3' or '3.3alpha2.4')>
mặc định: xem nội dung mô tả- Phiên bản watchOS tối thiểu tương thích với trình mô phỏng và thiết bị mục tiêu. Nếu không chỉ định, hãy sử dụng "watchos_sdk_version".
Thẻ:loses_incremental_state
--xbinary_fdo=<a build target label>
mặc định: xem nội dung mô tả-
Sử dụng thông tin hồ sơ XbinaryFDO để tối ưu hoá quá trình biên dịch. Chỉ định tên của hồ sơ tệp nhị phân chéo mặc định. Khi tuỳ chọn này được sử dụng cùng với --fdo_instrument/--fdo_optimize/--fdo_profile, các tuỳ chọn đó sẽ luôn chiếm ưu thế như thể xbinary_fdo không bao giờ được chỉ định.
Thẻ:affects_outputs
- Các tuỳ chọn ảnh hưởng đến mức độ nghiêm ngặt mà Bazel thực thi các dữ liệu đầu vào bản dựng hợp lệ (xác định quy tắc, tổ hợp cờ, v.v.):
--auto_cpu_environment_group=<a build target label>
mặc định: ""- khai báo environment_group để sử dụng cho việc tự động liên kết các giá trị cpu với các giá trị target_environment.
Thẻ:changes_inputs
,loading_and_analysis
,experimental
- Giá trị mặc định của
--[no]check_licenses
: "false" -
Kiểm tra để đảm bảo các quy tắc hạn chế về giấy phép do các gói phụ thuộc áp đặt không xung đột với chế độ phân phối của các mục tiêu đang được tạo. Theo mặc định, giấy phép sẽ không được kiểm tra.
Thẻ:build_file_semantics
- Giá trị mặc định của
--[no]check_visibility
: "true" - Nếu bị tắt, các lỗi về chế độ hiển thị trong phần phụ thuộc mục tiêu sẽ bị hạ cấp thành cảnh báo.
Thẻ:build_file_semantics
- Giá trị mặc định của
--[no]desugar_for_android
: "true" -
Liệu có đơn giản hoá mã byte Java 8 trước khi tạo tệp dex hay không.
Thẻ:affects_outputs
,loading_and_analysis
,loses_incremental_state
- Giá trị mặc định của
--[no]desugar_java8_libs
: "false" -
Liệu có đưa các thư viện Java 8 được hỗ trợ vào ứng dụng cho các thiết bị cũ hay không.
Thẻ:affects_outputs
,loading_and_analysis
,loses_incremental_state
,experimental
- Giá trị mặc định của
--[no]enforce_constraints
: "true" -
Kiểm tra môi trường mà mỗi mục tiêu tương thích và báo cáo lỗi nếu có mục tiêu nào có các phần phụ thuộc không hỗ trợ cùng một môi trường
Thẻ:build_file_semantics
- Giá trị mặc định của
--[no]experimental_check_desugar_deps
: "true" -
Liệu có nên kiểm tra kỹ việc đơn giản hoá chính xác ở cấp tệp nhị phân Android hay không.
Thẻ:eagerness_to_exit
,loading_and_analysis
,experimental
- Giá trị mặc định của
--experimental_import_deps_checking=<off, warning or error>
: "OFF" -
Khi bật, hãy kiểm tra xem các phần phụ thuộc của aar_import đã hoàn tất hay chưa. Việc thực thi này có thể làm hỏng bản dựng hoặc chỉ dẫn đến cảnh báo.
Thẻ:loading_and_analysis
- Giá trị mặc định của
--experimental_one_version_enforcement=<off, warning or error>
: "OFF" -
Khi bật, hãy thực thi quy tắc java_binary không được chứa nhiều phiên bản của cùng một tệp lớp trên đường dẫn lớp. Việc thực thi này có thể làm hỏng bản dựng hoặc chỉ dẫn đến cảnh báo.
Thẻ:loading_and_analysis
- Giá trị mặc định của
--experimental_strict_java_deps=<off, warn, error, strict or default>
: "mặc định" - Nếu đúng, hãy kiểm tra để đảm bảo rằng một mục tiêu Java khai báo rõ ràng tất cả các mục tiêu được sử dụng trực tiếp dưới dạng phần phụ thuộc.
Thẻ:build_file_semantics
,eagerness_to_exit
- Giá trị mặc định của
--[no]incompatible_check_testonly_for_output_files
: "false" - Nếu được bật, hãy kiểm tra testonly cho các mục tiêu tiên quyết là tệp đầu ra bằng cách tra cứu testonly của quy tắc tạo. Điều này khớp với việc kiểm tra chế độ hiển thị.
Thẻ:build_file_semantics
,incompatible_change
- Giá trị mặc định của
--[no]incompatible_check_visibility_for_toolchains
: "false" - Nếu được bật, tính năng kiểm tra chế độ hiển thị cũng áp dụng cho việc triển khai chuỗi công cụ.
Thẻ:build_file_semantics
,incompatible_change
- Giá trị mặc định của
--[no]incompatible_disable_native_android_rules
: "false" - Nếu được bật, tính năng sử dụng trực tiếp các quy tắc Android gốc sẽ bị tắt. Vui lòng sử dụng các quy tắc Android Starlark từ https://github.com/bazelbuild/rules_android
Thẻ:eagerness_to_exit
,incompatible_change
- Giá trị mặc định của
--[no]incompatible_disable_native_apple_binary_rule
: "false" - Không hoạt động. Được giữ lại ở đây để tương thích ngược.
Thẻ:eagerness_to_exit
,incompatible_change
- Giá trị mặc định của
--[no]incompatible_python_disable_py2
: "true" - Nếu đúng, việc sử dụng chế độ cài đặt Python 2 sẽ gây ra lỗi. Bao gồm cả python_version=PY2, srcs_version=PY2 và srcs_version=PY2ONLY. Hãy xem https://github.com/bazelbuild/bazel/issues/15684 để biết thêm thông tin.
Thẻ:loading_and_analysis
,incompatible_change
- Giá trị mặc định của
--[no]incompatible_validate_top_level_header_inclusions
: "true" - Nếu đúng, Bazel cũng sẽ xác thực việc đưa tiêu đề thư mục cấp cao nhất vào (xem https://github.com/bazelbuild/bazel/issues/10047 để biết thêm thông tin).
Thẻ:loading_and_analysis
,incompatible_change
- Giá trị mặc định của
--[no]one_version_enforcement_on_java_tests
: "true" -
Khi được bật và experimental_one_version_enforcement được đặt thành một giá trị khác NONE, hãy thực thi một phiên bản trên các mục tiêu java_test. Bạn có thể tắt cờ này để cải thiện hiệu suất kiểm thử gia tăng nhưng sẽ bỏ lỡ các lỗi vi phạm tiềm ẩn về một phiên bản.
Thẻ:loading_and_analysis
--python_native_rules_allowlist=<a build target label>
mặc định: xem nội dung mô tả-
Danh sách cho phép (mục tiêu package_group) để sử dụng khi thực thi --incompatible_python_disallow_native_rules.
Thẻ:loading_and_analysis
- Giá trị mặc định của
--[no]strict_filesets
: "false" - Nếu bạn bật tuỳ chọn này, các tệp nhóm sẽ vượt quá giới hạn gói sẽ được báo cáo là lỗi.
Thẻ:build_file_semantics
,eagerness_to_exit
--strict_proto_deps=<off, warn, error, strict or default>
mặc định: "lỗi"- Nếu không tắt, hãy kiểm tra để đảm bảo rằng mục tiêu proto_library 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.
Thẻ:build_file_semantics
,eagerness_to_exit
,incompatible_change
--strict_public_imports=<off, warn, error, strict or default>
mặc định: "off"-
Trừ khi TẮT, hãy kiểm tra để đảm bảo rằng mục tiêu proto_library khai báo rõ ràng tất cả các mục tiêu được sử dụng trong "import public" là mục tiêu đã xuất.
Thẻ:build_file_semantics
,eagerness_to_exit
,incompatible_change
- Giá trị mặc định của
--[no]strict_system_includes
: "false" - Nếu là true, bạn cũng phải khai báo các tiêu đề tìm thấy thông qua hệ thống bao gồm các đường dẫn (-isystem).
Thẻ:loading_and_analysis
,eagerness_to_exit
--target_environment=<a build target label>
nhiều lần sử dụng được tích luỹ-
Khai báo môi trường mục tiêu của bản dựng này. Phải là tham chiếu nhãn đến quy tắc "môi trường". Nếu được chỉ định, tất cả mục tiêu cấp cao nhất phải tương thích với môi trường này.
Thẻ:changes_inputs
- Các tuỳ chọn ảnh hưởng đến kết quả ký của một bản dựng:
--apk_signing_method=<v1, v2, v1_v2 or v4>
mặc định: "v1_v2"-
Cách triển khai để ký tệp APK
Thẻ:action_command_lines
,affects_outputs
,loading_and_analysis
- Giá trị mặc định của
--[no]device_debug_entitlements
: "true" - Nếu bạn đặt và chế độ biên dịch không phải là "opt", thì các ứng dụng objc sẽ bao gồm các quyền gỡ lỗi khi ký.
Thẻ:changes_inputs
--ios_signing_cert_name=<a string>
mặc định: xem nội dung mô tả- Tên chứng chỉ dùng để ký ứng dụng iOS. Nếu không được đặt, hệ thống sẽ quay lại sử dụng hồ sơ cấp phép. Có thể là lựa chọn ưu tiên về danh tính chuỗi khoá của chứng chỉ hoặc (chuỗi con) của tên chung của chứng chỉ, theo trang man của codesign (SIGNING IDENTITIES).
Thẻ:action_command_lines
- Tuỳ chọn này ảnh hưởng đến ngữ nghĩa của ngôn ngữ Starlark hoặc API bản dựng mà các tệp BUILD, tệp .bzl hoặc tệp WORKSPACE có thể truy cập.:
- Giá trị mặc định của
--[no]incompatible_disallow_legacy_py_provider
: "true" - Không hoạt động, sẽ sớm bị xoá.
Thẻ:loading_and_analysis
,incompatible_change
- Giá trị mặc định của
--[no]incompatible_disallow_sdk_frameworks_attributes
: "false" - Nếu đúng, không cho phép các thuộc tính sdk_frameworks và weak_sdk_frameworks trong objc_library và objc_import.
Thẻ:build_file_semantics
,incompatible_change
- Giá trị mặc định của
--[no]incompatible_objc_alwayslink_by_default
: "false" - Nếu đúng, hãy đặt giá trị mặc định thành đúng cho các thuộc tính alwayslink trong objc_library và objc_import.
Thẻ:build_file_semantics
,incompatible_change
- Giá trị mặc định của
--[no]incompatible_python_disallow_native_rules
: "false" -
Khi giá trị là true, lỗi sẽ xảy ra khi sử dụng các quy tắc py_* tích hợp; thay vào đó, bạn nên sử dụng các quy tắc rule_python. Hãy xem https://github.com/bazelbuild/bazel/issues/17773 để biết thêm thông tin và hướng dẫn di chuyển.
Thẻ:loading_and_analysis
,incompatible_change
- Các tuỳ chọn điều chỉnh hành vi của môi trường kiểm thử hoặc trình chạy kiểm thử:
- Giá trị mặc định của
--[no]allow_analysis_failures
: "false" - Nếu đúng, lỗi phân tích của một mục tiêu quy tắc sẽ dẫn đến việc mục tiêu truyền một thực thể của AnalysisFailureInfo chứa nội dung mô tả lỗi, thay vì dẫn đến lỗi bản dựng.
Thẻ:loading_and_analysis
,experimental
- Giá trị mặc định của
--analysis_testing_deps_limit=<an integer>
: "2000" -
Đặt số lượng phần phụ thuộc bắc cầu tối đa thông qua một thuộc tính quy tắc có chuyển đổi cấu hình for_analysis_testing. Nếu vượt quá giới hạn này, bạn sẽ gặp lỗi quy tắc.
Thẻ:loading_and_analysis
- Giá trị mặc định của
--[no]break_build_on_parallel_dex2oat_failure
: "false" - Nếu lỗi thao tác dex2oat là đúng thì bản dựng sẽ bị lỗi thay vì thực thi dex2oat trong thời gian chạy kiểm thử.
Thẻ:loading_and_analysis
,experimental
--default_test_resources=<a resource name followed by equal and 1 float or 4 float, e.g. memory=10,30,60,100>
nhiều lần sử dụng được tích luỹ- Ghi đè số lượng tài nguyên mặc định cho các chương trình kiểm thử. Định dạng dự kiến là <tài nguyên>=<giá trị>. Nếu một số dương duy nhất được chỉ định là <giá trị>, thì số này sẽ ghi đè các tài nguyên mặc định cho tất cả kích thước kiểm thử. Nếu bạn chỉ định 4 số được phân tách bằng dấu phẩy, thì các số này sẽ ghi đè lượng tài nguyên tương ứng cho các kích thước kiểm thử nhỏ, trung bình, lớn, rất lớn. Giá trị cũng có thể là HOST_RAM/HOST_CPU, theo sau là [-|*]<float> (ví dụ: memory=HOST_RAM*.1,HOST_RAM*.2,HOST_RAM*.3,HOST_RAM*.4). Tài nguyên kiểm thử mặc định do cờ này chỉ định sẽ bị ghi đè bởi tài nguyên rõ ràng được chỉ định trong thẻ.
- Giá trị mặc định của
--[no]experimental_android_use_parallel_dex2oat
: "false" -
Sử dụng dex2oat song song để có thể tăng tốc android_test.
Thẻ:loading_and_analysis
,host_machine_resource_optimizations
,experimental
- Giá trị mặc định của
--[no]ios_memleaks
: "false" -
Bật tính năng kiểm tra rò rỉ bộ nhớ trong các mục tiêu ios_test.
Thẻ:action_command_lines
--ios_simulator_device=<a string>
mặc định: xem nội dung mô tả-
Thiết bị để mô phỏng khi chạy ứng dụng iOS trong trình mô phỏng, ví dụ: "iPhone 6". Bạn có thể lấy danh sách thiết bị bằng cách chạy lệnh "xcrun simctl list devicetypes" trên máy mà trình mô phỏng sẽ chạy.
Thẻ:test_runner
--ios_simulator_version=<a dotted version (for example '2.3' or '3.3alpha2.4')>
mặc định: xem nội dung mô tả-
Phiên bản iOS để chạy trên trình mô phỏng khi chạy hoặc kiểm thử. Quy tắc này sẽ bị bỏ qua đối với các quy tắc ios_test nếu bạn chỉ định một thiết bị mục tiêu trong quy tắc.
Thẻ:test_runner
--runs_per_test=<a positive integer or test_regex@runs. This flag may be passed more than once>
nhiều lần sử dụng được tích luỹ- Chỉ định số lần chạy mỗi chương trình kiểm thử. Nếu bất kỳ lần thử nào trong số đó không thành công vì bất kỳ lý do gì, thì toàn bộ kiểm thử sẽ được coi là không thành công. Thông thường, giá trị được chỉ định chỉ là một số nguyên. Ví dụ: --runs_per_test=3 sẽ chạy tất cả các bài kiểm thử 3 lần. Cú pháp thay thế: bộ_lọc_biểu_thức_tìm_kiếm@số_lần_chạy_mỗi_bài_kiểm_ thử. Trong đó, runs_per_test là một giá trị số nguyên và regex_filter là danh sách các mẫu biểu thức chính quy bao gồm và loại trừ (Xem thêm --instrumentation_filter). Ví dụ: --runs_per_test=//foo/.*,-//foo/bar/.*@3 chạy tất cả các bài kiểm thử trong //foo/ ngoại trừ các bài kiểm thử trong foo/bar ba lần. Bạn có thể truyền tuỳ chọn này nhiều lần. Đối số khớp được truyền gần đây nhất sẽ được ưu tiên. Nếu không có kết quả nào khớp, thì quy trình kiểm thử sẽ chỉ chạy một lần.
--test_env=<a 'name=value' assignment with an optional value part>
nhiều lần sử dụng được tích luỹ- Chỉ định các biến môi trường bổ sung sẽ được chèn vào môi trường trình chạy kiểm thử. Bạn có thể chỉ định biến theo tên, trong trường hợp này, giá trị của biến sẽ được đọc từ môi trường ứng dụng Bazel hoặc theo cặp name=value. Bạn có thể sử dụng tuỳ chọn này nhiều lần để chỉ định một số biến. Chỉ được lệnh "bazel test" sử dụng.
Thẻ:test_runner
--test_timeout=<a single integer or comma-separated list of 4 integers>
mặc định: "-1"- Ghi đè các giá trị thời gian chờ kiểm thử mặc định cho thời gian chờ kiểm thử (tính bằng giây). Nếu bạn chỉ định một giá trị số nguyên dương, thì giá trị đó sẽ ghi đè tất cả các danh mục. Nếu bạn chỉ định 4 số nguyên được phân tách bằng dấu phẩy, thì các số này sẽ ghi đè thời gian chờ cho thời gian ngắn, trung bình, dài và vĩnh viễn (theo thứ tự đó). Trong cả hai hình thức, giá trị -1 sẽ yêu cầu blaze sử dụng thời gian chờ mặc định cho danh mục đó.
- Giá trị mặc định của
--[no]zip_undeclared_test_outputs
: "true" - Nếu đúng, các kết quả kiểm thử chưa khai báo sẽ được lưu trữ trong một tệp zip.
Thẻ:test_runner
- Các tuỳ chọn liên quan đến kết quả truy vấn và ngữ nghĩa:
- Giá trị mặc định của
--aspect_deps=<off, conservative or precise>
: "conservative" -
Cách phân giải các phần phụ thuộc của khía cạnh khi định dạng đầu ra là một trong các {xml,proto,record}. "tắt" có nghĩa là không có phần phụ thuộc khía cạnh nào được phân giải, "cẩn thận" (mặc định) có nghĩa là tất cả phần phụ thuộc khía cạnh đã khai báo đều được thêm vào bất kể chúng có được cấp lớp quy tắc của phần phụ thuộc trực tiếp hay không, "chính xác" có nghĩa là chỉ những khía cạnh có thể hoạt động mới được thêm vào dựa trên lớp quy tắc của phần phụ thuộc trực tiếp. Xin lưu ý rằng chế độ chính xác yêu cầu tải các gói khác để đánh giá một mục tiêu duy nhất, do đó, chế độ này sẽ chậm hơn các chế độ khác. Ngoài ra, xin lưu ý rằng ngay cả chế độ chính xác cũng không hoàn toàn chính xác: quyết định có tính toán một khía cạnh hay không được quyết định trong giai đoạn phân tích, giai đoạn này không chạy trong "truy vấn bazel".
Thẻ:build_file_semantics
- Giá trị mặc định của
--[no]consistent_labels
: "false" - Nếu được bật, mọi lệnh truy vấn sẽ phát ra nhãn như thể bằng hàm Starlark <code>str</code> áp dụng cho một thực thể <code>Label</code>. Điều này rất hữu ích đối với các công cụ cần so khớp kết quả của các lệnh truy vấn và/hoặc nhãn khác nhau do các quy tắc phát ra. Nếu không được bật, trình định dạng đầu ra có thể tự do phát ra tên kho lưu trữ rõ ràng (so với kho lưu trữ chính) để giúp đầu ra dễ đọc hơn.
Thẻ:terminal_output
- Giá trị mặc định của
--[no]experimental_explicit_aspects
: "false" -
aquery, cquery: liệu có đưa các hành động do phương diện tạo ra vào kết quả hay không. query: không hoạt động (các phương diện luôn được tuân theo).
Thẻ:terminal_output
- Giá trị mặc định của
--[no]graph:factored
: "true" - Nếu đúng, thì biểu đồ sẽ được phát "được nhân", tức là các nút tương đương về mặt tô pô sẽ được hợp nhất với nhau và các nhãn của chúng sẽ được nối với nhau. Tuỳ chọn này chỉ áp dụng cho --output=graph.
Thẻ:terminal_output
--graph:node_limit=<an integer>
mặc định: "512"-
Độ dài tối đa của chuỗi nhãn cho một nút biểu đồ trong kết quả. Nhãn dài hơn sẽ bị cắt ngắn; -1 có nghĩa là không cắt ngắn. Tuỳ chọn này chỉ áp dụng cho --output=graph.
Thẻ:terminal_output
- Giá trị mặc định của
--[no]implicit_deps
: "true" - Nếu được bật, các phần phụ thuộc ngầm sẽ đượ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 bazel thêm vào. Đối với cquery, tuỳ chọn này kiểm soát việc lọc các chuỗi công cụ đã phân giải.
Thẻ:build_file_semantics
- Giá trị mặc định của
--[no]include_artifacts
: "true" - Bao gồm tên của đầu vào và đầu ra của hành động trong kết quả (có thể lớn).
Thẻ:terminal_output
- Giá trị mặc định của
--[no]include_aspects
: "true" -
aquery, cquery: liệu có đưa các hành động do phương diện tạo ra vào kết quả hay không. query: không hoạt động (các phương diện luôn được tuân theo).
Thẻ:terminal_output
- Giá trị mặc định của
--[no]include_commandline
: "true" -
Bao gồm nội dung của các dòng lệnh hành động trong kết quả (có thể lớn).
Thẻ:terminal_output
- Giá trị mặc định của
--[no]include_file_write_contents
: "false" -
Bao gồm nội dung tệp cho các thao tác FileWrite, SourceSymlinkManifest và RepoMappingManifest (có thể lớn).
Thẻ:terminal_output
- Giá trị mặc định của
--[no]include_param_files
: "false" -
Thêm nội dung của các tệp tham số được dùng trong lệnh (có thể lớn). Lưu ý: Việc bật cờ này sẽ tự động bật cờ --include_commandline.
Thẻ:terminal_output
- Giá trị mặc định của
--[no]incompatible_package_group_includes_double_slash
: "true" - Nếu được bật, khi xuất thuộc tính "packages" của package_group, dấu "//" ở đầu sẽ không bị bỏ qua.
Thẻ:terminal_output
,incompatible_change
- Giá trị mặc định của
--[no]infer_universe_scope
: "false" - Nếu bạn đặt và không đặt --universe_scope, thì giá trị của --universe_scope sẽ được suy ra là danh sách các mẫu mục tiêu duy nhất trong biểu thức truy vấn. Xin lưu ý rằng giá trị --universe_scope được suy ra cho biểu thức truy vấn sử dụng các hàm trong phạm vi vũ trụ (ví dụ: "allrdeps") có thể không phải là giá trị bạn muốn. Vì vậy, bạn chỉ nên sử dụng tuỳ chọn này nếu biết mình đang làm gì. Hãy xem https://bazel.build/reference/query#sky-query để biết thông tin chi tiết và ví dụ. Nếu bạn đặt --universe_scope, thì giá trị của tuỳ chọn này sẽ bị bỏ qua. Lưu ý: tuỳ chọn này chỉ áp dụng cho "truy vấn" (tức là không phải "cquery").
Thẻ:loading_and_analysis
- Giá trị mặc định của
--[no]line_terminator_null
: "false" -
Liệu mỗi định dạng có được kết thúc bằng \0 thay vì dòng mới hay không.
Thẻ:terminal_output
- Giá trị mặc định của
--[no]nodep_deps
: "true" - Nếu được bật, các phần phụ thuộc từ thuộc tính "nodep" sẽ được đưa vào biểu đồ phần phụ thuộc mà truy vấn hoạt động. Một ví dụ phổ biến về thuộc tính "nodep" là "visibility" (mức độ hiển thị). Chạy và phân tích cú pháp kết quả của lệnh `info build-language` để tìm hiểu về tất cả thuộc tính "nodep" trong ngôn ngữ bản dựng.
Thẻ:build_file_semantics
--output=<a string>
mặc định: "text"-
Định dạng in kết quả truy vấn. Các giá trị được phép cho aquery là: text, textproto, proto, streamed_proto, jsonproto.
Thẻ:terminal_output
- Giá trị mặc định của
--[no]proto:default_values
: "true" - Nếu đúng, các thuộc tính có giá trị không được chỉ định rõ ràng trong tệp BUILD sẽ được đưa vào; nếu không, các thuộc tính đó sẽ bị bỏ qua. Bạn có thể áp dụng tuỳ chọn này cho --output=proto
Thẻ:terminal_output
- Giá trị mặc định của
--[no]proto:definition_stack
: "false" - Điền vào trường proto definition_stack. Trường này ghi lại cho mỗi thực thể quy tắc ngăn xếp lệnh gọi Starlark tại thời điểm lớp của quy tắc được xác định.
Thẻ:terminal_output
- Giá trị mặc định của
--[no]proto:flatten_selects
: "true" - Nếu được bật, các thuộc tính có thể định cấu hình do select() tạo sẽ được làm phẳng. Đối với các loại danh sách, bản trình bày được làm phẳng là một danh sách chứa mỗi giá trị của bản đồ chọn chính xác một lần. Các loại đại lượng vô hướng được làm phẳng thành giá trị rỗng.
Thẻ:build_file_semantics
- Giá trị mặc định của
--[no]proto:include_attribute_source_aspects
: "false" - Điền phương diện nguồn mà thuộc tính đến từ vào trường proto source_aspect_name của mỗi Thuộc tính (chuỗi trống nếu không có).
Thẻ:terminal_output
- Giá trị mặc định của
--[no]proto:include_synthetic_attribute_hash
: "false" -
Liệu có tính toán và điền thuộc tính $internal_attr_hash hay không.
Thẻ:terminal_output
- Giá trị mặc định của
--[no]proto:instantiation_stack
: "false" - Điền ngăn xếp lệnh gọi bản sao của từng quy tắc. Xin lưu ý rằng việc này yêu cầu ngăn xếp phải có mặt
Thẻ
:terminal_output
- Giá trị mặc định của
--[no]proto:locations
: "true" -
Liệu có xuất thông tin vị trí trong đầu ra proto hay không.
Thẻ:terminal_output
--proto:output_rule_attrs=<comma-separated list of options>
mặc định: "tất cả"- Danh sách các thuộc tính được phân tách bằng dấu phẩy để đưa vào đầu ra. Giá trị mặc định là tất cả thuộc tính. Đặt thành chuỗi trống để không xuất ra thuộc tính nào. Tuỳ chọn này áp dụng cho --output=proto.
Thẻ:terminal_output
- Giá trị mặc định của
--[no]proto:rule_inputs_and_outputs
: "true" -
Liệu có điền sẵn các trường rule_input và rule_output hay không.
Thẻ:terminal_output
--query_file=<a string>
mặc định: ""- Nếu được đặt, truy vấn sẽ đọc truy vấn từ tệp được đặt tên tại đây, thay vì trên dòng lệnh. Bạn sẽ gặp lỗi nếu chỉ định một tệp tại đây cũng như một truy vấn dòng lệnh.
Thẻ:changes_inputs
- Giá trị mặc định của
--[no]relative_locations
: "false" - Nếu đúng, vị trí của các tệp BUILD trong đầu ra xml và proto sẽ tương đối. Theo mặc định, đầu ra vị trí là một đường dẫn tuyệt đối và sẽ không nhất quán trên các máy. Bạn có thể đặt tuỳ chọn này thành đúng để có kết quả nhất quán trên các máy.
Thẻ:terminal_output
- Giá trị mặc định của
--[no]skyframe_state
: "false" -
Không thực hiện thêm phân tích, hãy kết xuất Biểu đồ hành động hiện tại từ Skyframe. Lưu ý: Hiện tại, chúng tôi không hỗ trợ việc chỉ định mục tiêu bằng --skyframe_state. Cờ này chỉ có với --output=proto hoặc --output=textproto.
Thẻ:terminal_output
- Giá trị mặc định của
--[no]tool_deps
: "true" - Truy vấn: Nếu bị tắt, các phần phụ thuộc trên "cấu hình thực thi" sẽ không được đưa vào biểu đồ phần phụ thuộc mà truy vấn hoạt động. Cạnh phần phụ thuộc "cấu hình thực thi", chẳng hạn như cạnh từ quy tắc "proto_library" bất kỳ đến Trình biên dịch giao thức, thường trỏ đến một công cụ được thực thi trong quá trình xây dựng thay vì một phần của cùng một chương trình "mục tiêu".
Cquery: Nếu bị tắt, sẽ lọc ra tất cả các mục tiêu đã định cấu hình vượt qua quá trình chuyển đổi thực thi từ mục tiêu cấp cao nhất đã phát hiện mục tiêu đã định cấu hình này. Điều đó có nghĩa là nếu mục tiêu cấp cao nhất nằm trong cấu hình mục tiêu, thì chỉ những mục tiêu được định cấu hình cũng nằm trong cấu hình mục tiêu mới được trả về. Nếu mục tiêu cấp cao nhất nằm trong cấu hình thực thi, thì chỉ các mục tiêu được định cấu hình thực thi mới được trả về. Tuỳ chọn này KHÔNG loại trừ các chuỗi công cụ đã phân giải.
Thẻ:build_file_semantics
--universe_scope=<comma-separated list of options>
mặc định: ""-
Một tập hợp các mẫu mục tiêu được phân tách bằng dấu phẩy (bổ sung và trừ). Truy vấn có thể được thực hiện trong vũ trụ được xác định bằng phép đóng bắc cầu của các mục tiêu đã chỉ định. Tuỳ chọn này được dùng cho các lệnh truy vấn và cquery.
Đối với cquery, dữ liệu đầu vào cho tuỳ chọn này là các mục tiêu mà tất cả câu trả lời được tạo trong đó. Do đó, tuỳ chọn này có thể ảnh hưởng đến cấu hình và quá trình chuyển đổi. Nếu bạn không chỉ định tuỳ chọn này, thì các mục tiêu cấp cao nhất được giả định là các mục tiêu được phân tích cú pháp từ biểu thức truy vấn. Lưu ý: Đối với cquery, việc không chỉ định tuỳ chọn này có thể khiến bản dựng bị lỗi nếu các mục tiêu được phân tích cú pháp từ biểu thức truy vấn không thể tạo bằng các tuỳ chọn cấp cao nhất.
Thẻ:loading_and_analysis
- Các tuỳ chọn kích hoạt tính năng tối ưu hoá thời gian xây dựng:
- Giá trị mặc định của
--[no]experimental_filter_library_jar_with_program_jar
: "false" -
Lọc ProGuard ProgramJar để xoá mọi lớp cũng có trong LibraryJar.
Thẻ:action_command_lines
- Giá trị mặc định của
--[no]experimental_inmemory_dotd_files
: "true" - Nếu được bật, các tệp .d C++ sẽ được truyền trực tiếp trong bộ nhớ từ các nút bản dựng từ xa thay vì được ghi vào ổ đĩa.
Thẻ:loading_and_analysis
,execution
,affects_outputs
,experimental
- Giá trị mặc định của
--[no]experimental_inmemory_jdeps_files
: "true" - Nếu được bật, các tệp phần phụ thuộc (.jdeps) được tạo từ các bản biên dịch Java sẽ được truyền trực tiếp trong bộ nhớ từ các nút bản dựng từ xa thay vì được ghi vào ổ đĩa.
Thẻ:loading_and_analysis
,execution
,affects_outputs
,experimental
- Giá trị mặc định của
--[no]experimental_objc_include_scanning
: "false" -
Liệu có thực hiện việc quét tìm C/C++ khách quan hay không.
Thẻ:loading_and_analysis
,execution
,changes_inputs
- Giá trị mặc định của
--[no]experimental_retain_test_configuration_across_testonly
: "false" -
Khi được bật, --trim_test_configuration sẽ không cắt bớt cấu hình kiểm thử cho các quy tắc được đánh dấu testonly=1. Điều này nhằm giảm các vấn đề xung đột hành động khi các quy tắc không phải quy tắc kiểm thử phụ thuộc vào quy tắc cc_test. Không có hiệu lực nếu --trim_test_configuration là false.
Thẻ:loading_and_analysis
,loses_incremental_state
- Giá trị mặc định của
--[no]experimental_starlark_cc_import
: "false" - Nếu được bật, bạn có thể sử dụng phiên bản Starlark của cc_import.
Thẻ:loading_and_analysis
,experimental
- Giá trị mặc định của
--[no]experimental_unsupported_and_brittle_include_scanning
: "false" -
Liệu có thu hẹp dữ liệu đầu vào cho quá trình biên dịch C/C++ bằng cách phân tích cú pháp các dòng #include từ tệp đầu vào hay không. Điều này có thể cải thiện hiệu suất và tính tăng dần bằng cách giảm kích thước của cây đầu vào biên dịch. Tuy nhiên, việc này cũng có thể làm hỏng các bản dựng vì trình quét bao gồm không triển khai đầy đủ ngữ nghĩa của trình xử lý trước C. Cụ thể, trình biên dịch này không hiểu các lệnh #include động và bỏ qua logic có điều kiện của trình xử lý trước. Bạn tự chịu rủi ro khi sử dụng. Mọi vấn đề liên quan đến cờ này đều sẽ bị đóng.
Thẻ:loading_and_analysis
,execution
,changes_inputs
- Giá trị mặc định của
--[no]incremental_dexing
: "true" -
Thực hiện hầu hết công việc tạo tệp DEX riêng cho từng tệp Jar.
Thẻ:affects_outputs
,loading_and_analysis
,loses_incremental_state
- Giá trị mặc định của
--[no]objc_use_dotd_pruning
: "true" - Nếu được đặt, các tệp .d do clang phát ra sẽ được dùng để cắt bớt tập hợp đầu vào được truyền vào các bản biên dịch objc.
Thẻ:changes_inputs
,loading_and_analysis
- Giá trị mặc định của
--[no]process_headers_in_dependencies
: "false" -
Khi tạo một mục tiêu //a:a, hãy xử lý các tiêu đề trong tất cả các mục tiêu mà //a:a phụ thuộc vào (nếu bạn bật tính năng xử lý tiêu đề cho chuỗi công cụ).
Thẻ:execution
- Giá trị mặc định của
--[no]trim_test_configuration
: "true" -
Khi được bật, các tuỳ chọn liên quan đến kiểm thử sẽ bị xoá bên dưới cấp cao nhất của bản dựng. Khi cờ này đang hoạt động, bạn không thể tạo kiểm thử dưới dạng phần phụ thuộc của các quy tắc không phải kiểm thử, nhưng các thay đổi đối với các tuỳ chọn liên quan đến kiểm thử sẽ không khiến các quy tắc không phải kiểm thử được phân tích lại.
Thẻ
:loading_and_analysis
,loses_incremental_state
- Các tuỳ chọn ảnh hưởng đến mức độ chi tiết, định dạng hoặc vị trí ghi nhật ký:
--toolchain_resolution_debug=<a comma-separated list of regex expressions with prefix '-' specifying excluded paths>
mặc định: "-.*"-
In thông tin gỡ lỗi trong quá trình phân giải chuỗi công cụ. Cờ này lấy một biểu thức chính quy, được kiểm tra dựa trên các loại chuỗi công cụ và mục tiêu cụ thể để xem cần gỡ lỗi mục nào. Bạn có thể phân tách nhiều biểu thức chính quy bằng dấu phẩy, sau đó mỗi biểu thức chính quy sẽ được kiểm tra riêng. Lưu ý: Kết quả của cờ này rất phức tạp và có thể chỉ hữu ích cho các chuyên gia về độ phân giải chuỗi công cụ.
Thẻ:terminal_output
- Các tuỳ chọn chỉ định hoặc thay đổi dữ liệu đầu vào chung cho một lệnh Bazel không thuộc các danh mục khác.:
--flag_alias=<a 'name=value' flag alias>
nhiều lần sử dụng được tích luỹ-
Đặt tên viết tắt cho cờ Starlark. Hàm này nhận một cặp khoá-giá trị duy nhất ở dạng "<khoá>=<giá trị>" làm đối số.
Thẻ:changes_inputs
- Giá trị mặc định của
--[no]incompatible_default_to_explicit_init_py
: "false" -
Cờ này thay đổi hành vi mặc định để các tệp __init__.py không còn được tạo tự động trong các tệp chạy của mục tiêu Python. Chính xác là khi mục tiêu py_binary hoặc py_test có legacy_create_init được đặt thành "tự động" (mặc định), mục tiêu đó được coi là sai nếu và chỉ khi bạn đặt cờ này. Xem https://github.com/bazelbuild/bazel/issues/10076.
Thẻ:affects_outputs
,incompatible_change
- Giá trị mặc định của
--[no]incompatible_py2_outputs_are_suffixed
: "true" - Nếu đúng, các mục tiêu được tạo trong cấu hình Python 2 sẽ xuất hiện trong thư mục gốc đầu ra có hậu tố "-py2", trong khi các mục tiêu được tạo cho Python 3 sẽ xuất hiện trong thư mục gốc không có hậu tố liên quan đến Python. Điều này có nghĩa là đường liên kết tượng trưng thuận tiện `bazel-bin` sẽ trỏ đến các mục tiêu Python 3 thay vì Python 2. Nếu bật tuỳ chọn này, bạn cũng nên bật `--incompatible_py3_is_default`.
Thẻ:affects_outputs
,incompatible_change
- Giá trị mặc định của
--[no]incompatible_py3_is_default
: "true" - Nếu đúng, các mục tiêu `py_binary` và `py_test` không đặt thuộc tính `python_version` (hoặc `default_python_version`) sẽ mặc định là PY3 thay vì PY2. Nếu đặt cờ này, bạn cũng nên đặt `--incompatible_py2_outputs_are_suffixed`.
Thẻ
:loading_and_analysis
,affects_outputs
,incompatible_change
- Giá trị mặc định của
--[no]incompatible_use_python_toolchains
: "true" - Nếu bạn đặt thành true, các quy tắc Python gốc có thể thực thi sẽ sử dụng môi trường thời gian chạy Python do chuỗi công cụ Python chỉ định, thay vì môi trường thời gian chạy do các cờ cũ như --python_top cung cấp.
Thẻ:loading_and_analysis
,incompatible_change
--python_version=<PY2 or PY3>
mặc định: xem nội dung mô tả-
Chế độ phiên bản chính của Python, "PY2" hoặc "PY3". Xin lưu ý rằng chế độ này sẽ bị ghi đè bởi các mục tiêu "py_binary" và "py_test" (ngay cả khi các mục tiêu này không chỉ định rõ ràng một phiên bản), vì vậy, thường không có lý do gì để cung cấp cờ này.
Thẻ:loading_and_analysis
,affects_outputs
- Các tuỳ chọn khác, không được phân loại.:
--[no]cache_test_results
[-t
] mặc định: "tự động"- Nếu được đặt thành "tự động", Bazel sẽ chạy lại một kiểm thử nếu và chỉ khi: (1) Bazel phát hiện thấy các thay đổi trong kiểm thử hoặc các phần phụ thuộc của kiểm thử, (2) kiểm thử được đánh dấu là bên ngoài, (3) nhiều lần chạy kiểm thử được yêu cầu bằng --runs_per_test hoặc(4) kiểm thử trước đó không thành công. Nếu được đặt thành "yes" (có), Bazel sẽ lưu tất cả kết quả kiểm thử vào bộ nhớ đệm, ngoại trừ các kiểm thử được đánh dấu là bên ngoài. Nếu bạn đặt thành "no" (không), Bazel sẽ không lưu kết quả kiểm thử vào bộ nhớ đệm.
- Giá trị mặc định của
--[no]experimental_cancel_concurrent_tests
: "false" - Nếu đúng, Blaze sẽ huỷ các chương trình kiểm thử đang chạy đồng thời trong lần chạy thành công đầu tiên. Điều này chỉ hữu ích khi kết hợp với --runs_per_test_detects_flakes.
Thẻ:affects_outputs
,loading_and_analysis
- Giá trị mặc định của
--[no]experimental_fetch_all_coverage_outputs
: "false" - Nếu đúng, thì Bazel sẽ tìm nạp toàn bộ thư mục dữ liệu mức độ sử dụng cho mỗi lần kiểm thử trong một lần chạy mức độ sử dụng.
Thẻ:affects_outputs
,loading_and_analysis
- Giá trị mặc định của
--[no]experimental_generate_llvm_lcov
: "false" - Nếu đúng, mức độ sử dụng cho clang sẽ tạo ra một báo cáo LCOV.
Thẻ:affects_outputs
,loading_and_analysis
- Giá trị mặc định của
--[no]experimental_j2objc_header_map
: "true" - Liệu có tạo bản đồ tiêu đề J2ObjC song song với quá trình biên dịch chuyển đổi J2ObjC hay không.
- Giá trị mặc định của
--[no]experimental_j2objc_shorter_header_path
: "false" -
Liệu có tạo bằng đường dẫn tiêu đề ngắn hơn hay không (sử dụng "_ios" thay vì "_j2objc").
Thẻ:affects_outputs
--experimental_java_classpath=<off, javabuilder or bazel>
mặc định: "javabuilder"- Bật các đường dẫn lớp rút gọn cho các bản biên dịch Java.
- Giá trị mặc định của
--[no]experimental_limit_android_lint_to_android_constrained_java
: "false" -
Giới hạn --experimental_run_android_lint_on_java_rules ở các thư viện tương thích với Android.
Thẻ:affects_outputs
- Giá trị mặc định của
--[no]experimental_run_android_lint_on_java_rules
: "false" -
Liệu có xác thực các nguồn java_* hay không.
Thẻ:affects_outputs
- Giá trị mặc định của
--[no]explicit_java_test_deps
: "false" - Chỉ định rõ ràng phần phụ thuộc cho JUnit hoặc Hamcrest trong java_test thay vì vô tình lấy từ phần phụ thuộc của TestRunner. Hiện chỉ hoạt động cho bazel.
--host_java_launcher=<a build target label>
mặc định: xem nội dung mô tả- Trình chạy Java mà các công cụ thực thi trong quá trình tạo bản dựng sử dụng.
--host_javacopt=<a string>
nhiều lần sử dụng được tích luỹ- Các tuỳ chọn bổ sung để truyền vào javac khi tạo các công cụ được thực thi trong quá trình tạo bản dựng.
--host_jvmopt=<a string>
nhiều lần sử dụng được tích luỹ- Các tuỳ chọn bổ sung để truyền đến máy ảo Java khi tạo các công cụ được thực thi trong quá trình xây dựng. Các tuỳ chọn này sẽ được thêm vào tuỳ chọn khởi động máy ảo của mỗi mục tiêu java_binary.
- Giá trị mặc định của
--[no]incompatible_check_sharding_support
: "true" - Nếu giá trị là true, Bazel sẽ không kiểm thử được nếu trình chạy kiểm thử không cho biết rằng nó hỗ trợ phân đoạn bằng cách chạm vào tệp tại đường dẫn trong TEST_SHARD_STATUS_FILE. Nếu giá trị là false, trình chạy kiểm thử không hỗ trợ phân đoạn sẽ dẫn đến tất cả các kiểm thử chạy trong mỗi phân đoạn.
Thẻ:incompatible_change
- Giá trị mặc định của
--[no]incompatible_exclusive_test_sandboxed
: "true" - Nếu đúng, các thử nghiệm độc quyền sẽ chạy bằng chiến lược hộp cát. Thêm thẻ "local" để buộc chạy một kiểm thử độc quyền trên máy
Thẻ:incompatible_change
- Giá trị mặc định của
--[no]incompatible_strict_action_env
: "false" - Nếu đúng, Bazel sẽ sử dụng một môi trường có giá trị tĩnh cho PATH và không kế thừa LD_LIBRARY_PATH. Sử dụng --action_env=ENV_VARIABLE nếu bạn muốn kế thừa các biến môi trường cụ thể từ ứng dụng, nhưng lưu ý rằng việc này có thể ngăn việc lưu vào bộ nhớ đệm trên nhiều người dùng nếu bạn sử dụng bộ nhớ đệm dùng chung.
Thẻ:loading_and_analysis
,incompatible_change
--j2objc_translation_flags=<comma-separated list of options>
nhiều lần sử dụng được tích luỹ- Các tuỳ chọn bổ sung để truyền đến công cụ J2ObjC.
--java_debug
-
Khiến máy ảo Java của một kiểm thử java chờ kết nối từ trình gỡ lỗi tuân thủ JDWP (chẳng hạn như jdb) trước khi bắt đầu kiểm thử. Ngụ ý -test_output=streamed.
Mở rộng thành:
--test_arg=--wrapper_script_flag=--debug
--test_output=streamed
--test_strategy=exclusive
--test_timeout=9999
--nocache_test_results
- Giá trị mặc định của
--[no]java_deps
: "true" - Tạo thông tin phần phụ thuộc (hiện tại là đường dẫn lớp thời gian biên dịch) cho mỗi mục tiêu Java.
- Giá trị mặc định của
--[no]java_header_compilation
: "true" - Biên dịch ijar trực tiếp từ nguồn.
--java_language_version=<a string>
mặc định: ""- Phiên bản ngôn ngữ Java
--java_launcher=<a build target label>
mặc định: xem nội dung mô tả- Trình chạy Java để sử dụng khi tạo tệp nhị phân Java. Nếu bạn đặt cờ này thành chuỗi trống, trình chạy JDK sẽ được sử dụng. Thuộc tính "launcher" (trình chạy) sẽ ghi đè cờ này.
--java_runtime_version=<a string>
mặc định: "local_jdk"- Phiên bản môi trường thời gian chạy Java
--javacopt=<a string>
nhiều lần sử dụng được tích luỹ- Các tuỳ chọn bổ sung để truyền đến javac.
--jvmopt=<a string>
nhiều lần sử dụng được tích luỹ- Các tuỳ chọn bổ sung để truyền đến máy ảo Java. Các tuỳ chọn này sẽ được thêm vào tuỳ chọn khởi động máy ảo của mỗi mục tiêu java_binary.
--legacy_main_dex_list_generator=<a build target label>
mặc định: xem nội dung mô tả- Chỉ định một tệp nhị phân để sử dụng nhằm tạo danh sách các lớp phải có trong dex chính khi biên dịch multidex cũ.
--optimizing_dexer=<a build target label>
mặc định: xem nội dung mô tả- Chỉ định một tệp nhị phân để sử dụng cho việc tạo tệp dex mà không phân đoạn.
--plugin=<a build target label>
nhiều lần sử dụng được tích luỹ- Trình bổ trợ để sử dụng trong bản dựng. Hiện hoạt động với java_plugin.
--proguard_top=<a build target label>
mặc định: xem nội dung mô tả- Chỉ định phiên bản ProGuard sẽ dùng để xoá mã khi tạo tệp nhị phân Java.
--proto_compiler=<a build target label>
mặc định: "@bazel_tools//tools/proto:protoc"-
Nhãn của trình biên dịch proto.
Thẻ:affects_outputs
,loading_and_analysis
--proto_toolchain_for_cc=<a build target label>
mặc định: "@bazel_tools//tools/proto:cc_toolchain"-
Nhãn của proto_lang_toolchain() mô tả cách biên dịch proto C++
Thẻ:affects_outputs
,loading_and_analysis
--proto_toolchain_for_j2objc=<a build target label>
mặc định: "@bazel_tools//tools/j2objc:j2objc_proto_toolchain"-
Nhãn của proto_lang_toolchain() mô tả cách biên dịch proto j2objc
Thẻ:affects_outputs
,loading_and_analysis
--proto_toolchain_for_java=<a build target label>
mặc định: "@bazel_tools//tools/proto:java_toolchain"-
Nhãn của proto_lang_toolchain() mô tả cách biên dịch proto Java
Thẻ:affects_outputs
,loading_and_analysis
--proto_toolchain_for_javalite=<a build target label>
mặc định: "@bazel_tools//tools/proto:javalite_toolchain"-
Nhãn của proto_lang_toolchain() mô tả cách biên dịch proto JavaLite
Thẻ:affects_outputs
,loading_and_analysis
--protocopt=<a string>
nhiều lần sử dụng được tích luỹ-
Các tuỳ chọn bổ sung để truyền đến trình biên dịch protobuf.
Thẻ:affects_outputs
- Giá trị mặc định của
--[no]runs_per_test_detects_flakes
: "false" - Nếu đúng, mọi phân mảnh có ít nhất một lần chạy/thử nghiệm thành công và ít nhất một lần chạy/thử nghiệm không thành công sẽ có trạng thái FLAKY.
--shell_executable=<a path>
mặc định: xem nội dung mô tả-
Đường dẫn tuyệt đối đến tệp thực thi shell để Bazel sử dụng. Nếu bạn không đặt biến này nhưng đặt biến môi trường BAZEL_SH trong lệnh gọi Bazel đầu tiên (lệnh gọi này sẽ khởi động máy chủ Bazel), thì Bazel sẽ sử dụng biến đó. Nếu bạn không đặt cả hai, Bazel sẽ sử dụng đường dẫn mặc định được mã hoá cứng tuỳ thuộc vào hệ điều hành mà nó chạy (Windows: c:/tools/msys64/usr/bin/bash.exe, FreeBSD: /usr/local/bin/bash, tất cả các hệ điều hành khác: /bin/bash). Xin lưu ý rằng việc sử dụng một shell không tương thích với bash có thể dẫn đến lỗi bản dựng hoặc lỗi thời gian chạy của các tệp nhị phân được tạo.
Thẻ:loading_and_analysis
--test_arg=<a string>
nhiều lần sử dụng được tích luỹ- Chỉ định các tuỳ chọn và đối số bổ sung cần được truyền đến tệp thực thi kiểm thử. Có thể sử dụng nhiều lần để chỉ định một số đối số. Nếu nhiều chương trình kiểm thử được thực thi, thì mỗi chương trình kiểm thử sẽ nhận được các đối số giống hệt nhau. Chỉ được lệnh "bazel test" sử dụng.
--test_filter=<a string>
mặc định: xem nội dung mô tả- Chỉ định một bộ lọc để chuyển tiếp đến khung kiểm thử. Dùng để giới hạn số lượng kiểm thử được chạy. Xin lưu ý rằng điều này không ảnh hưởng đến việc xây dựng mục tiêu nào.
--test_result_expiration=<an integer>
mặc định: "-1"- Tuỳ chọn này không được dùng nữa và không có hiệu lực.
- Giá trị mặc định của
--[no]test_runner_fail_fast
: "false" - Chuyển tiếp tuỳ chọn thất bại nhanh đến trình chạy kiểm thử. Trình chạy kiểm thử sẽ dừng thực thi khi gặp lỗi đầu tiên.
--test_sharding_strategy=<explicit, disabled or forced=k where k is the number of shards to enforce>
mặc định: "explicit"- Chỉ định chiến lược phân đoạn kiểm thử: "rõ ràng" để chỉ sử dụng phân đoạn nếu có thuộc tính BUILD "shard_count". "disabled" để không bao giờ sử dụng tính năng phân đoạn kiểm thử. "forced=k" để thực thi các phân đoạn "k" cho hoạt động kiểm thử bất kể thuộc tính BUILD "shard_count".
--tool_java_language_version=<a string>
mặc định: ""- Phiên bản ngôn ngữ Java dùng để thực thi các công cụ cần thiết trong quá trình tạo bản dựng
--tool_java_runtime_version=<a string>
mặc định: "remotejdk_11"- Phiên bản thời gian chạy Java dùng để thực thi các công cụ trong quá trình tạo bản dựng
- Giá trị mặc định của
--[no]use_ijars
: "true" - Nếu được bật, tuỳ chọn này sẽ khiến quá trình biên dịch Java sử dụng các tệp jar giao diện. Điều này sẽ giúp quá trình biên dịch tăng dần diễn ra nhanh hơn, nhưng thông báo lỗi có thể khác.
Build Options (Tuỳ chọn bản dựng)
- Các tuỳ chọn xuất hiện trước lệnh và được máy khách phân tích cú pháp:
--distdir=<a path>
nhiều lần sử dụng được tích luỹ-
Các vị trí khác để tìm kiếm bản lưu trữ trước khi truy cập vào mạng để tải xuống.
Thẻ:bazel_internal_configuration
- Giá trị mặc định của
--[no]experimental_repository_cache_hardlinks
: "false" - Nếu được đặt, bộ nhớ đệm kho lưu trữ sẽ liên kết cứng tệp trong trường hợp có lượt truy cập vào bộ nhớ đệm, thay vì sao chép. Việc này nhằm tiết kiệm dung lượng ổ đĩa.
Thẻ:bazel_internal_configuration
--experimental_repository_downloader_retries=<an integer>
mặc định: "0"-
Số lần thử tối đa để thử lại lỗi tải xuống. Nếu bạn đặt thành 0, thì tính năng thử lại sẽ bị tắt.
Thẻ:experimental
--experimental_scale_timeouts=<a double>
mặc định: "1.0"- Điều chỉnh tất cả thời gian chờ trong quy tắc kho lưu trữ Starlark theo hệ số này. Bằng cách này, bạn có thể làm cho kho lưu trữ bên ngoài hoạt động trên các máy chạy chậm hơn dự kiến của tác giả quy tắc mà không cần thay đổi mã nguồn
Thẻ:bazel_internal_configuration
,experimental
- Giá trị mặc định của
--[no]incompatible_disable_native_repo_rules
: "false" - Nếu giá trị là false, bạn có thể sử dụng các quy tắc kho lưu trữ gốc trong WORKSPACE; nếu không, bạn phải sử dụng các quy tắc kho lưu trữ Starlark. Các quy tắc kho lưu trữ gốc bao gồm local_repository, new_local_repository, local_config_platform, android_sdk_repository và android_ndk_repository.
Thẻ:bazel_internal_configuration
--repository_cache=<a path>
mặc định: xem nội dung mô tả- Chỉ định vị trí bộ nhớ đệm của các giá trị đã tải xuống thu được trong quá trình tìm nạp kho lưu trữ bên ngoài. Chuỗi trống làm đối số yêu cầu tắt bộ nhớ đệm, nếu không, giá trị mặc định là "<output_user_root>/cache/repos/v1" sẽ được sử dụng
Thẻ:bazel_internal_configuration
- Giá trị mặc định của
--[no]repository_disable_download
: "false" - Nếu được đặt, bạn không được phép tải xuống bằng ctx.download{,_and_extract} trong quá trình tìm nạp kho lưu trữ. Xin lưu ý rằng quyền truy cập mạng không bị tắt hoàn toàn; ctx.execute vẫn có thể chạy một tệp thực thi tuỳ ý truy cập Internet.
Thẻ:bazel_internal_configuration
- Các tuỳ chọn kiểm soát việc thực thi bản dựng:
- Giá trị mặc định của
--[no]check_up_to_date
: "false" -
Đừng tạo bản dựng, chỉ cần kiểm tra xem bản dựng đó có được cập nhật hay không. Nếu tất cả các mục tiêu đều được cập nhật, thì bản dựng sẽ hoàn tất thành công. Nếu cần thực thi bất kỳ bước nào, lỗi sẽ được báo cáo và bản dựng sẽ không thành công.
Thẻ:execution
--dynamic_local_execution_delay=<an integer>
mặc định: "1000"- Nếu quá trình thực thi từ xa nhanh hơn ít nhất một lần trong quá trình tạo bản dựng, thì quá trình thực thi cục bộ sẽ bị trì hoãn bao nhiêu mili giây?
Thẻ:execution
,host_machine_resource_optimizations
--dynamic_local_strategy=<a '[name=]value1[,..,valueN]' assignment>
nhiều lần sử dụng được tích luỹ- Các chiến lược cục bộ, theo thứ tự, để sử dụng cho câu thần chú đã cho – chiến lược đầu tiên có thể áp dụng sẽ được sử dụng. Ví dụ: `worker,sandboxed` chạy các hành động hỗ trợ worker ổn định bằng cách sử dụng chiến lược worker và tất cả các hành động khác bằng cách sử dụng chiến lược hộp cát. Nếu không có câu khẩu hiệu nào được cung cấp, danh sách chiến lược sẽ được dùng làm phương án dự phòng cho tất cả câu khẩu hiệu. Danh sách dự phòng mặc định là "worker,sandboxed" hoặc "worker,sandboxed,standalone" nếu bạn đặt "experimental_local_lockfree_output". Nhận [mnemonic=]local_strategy[,local_strategy,...]
Thẻ:execution
,host_machine_resource_optimizations
--dynamic_remote_strategy=<a '[name=]value1[,..,valueN]' assignment>
nhiều lần sử dụng được tích luỹ-
Các chiến lược từ xa, theo thứ tự, để sử dụng cho câu thần chú đã cho – chiến lược đầu tiên có thể áp dụng sẽ được sử dụng. Nếu không có câu khẩu hiệu nào được cung cấp, danh sách chiến lược sẽ được dùng làm phương án dự phòng cho tất cả câu khẩu hiệu. Danh sách dự phòng mặc định là "từ xa", vì vậy, bạn thường không cần đặt cờ này một cách rõ ràng. Nhận [mnemonic=]remote_strategy[,remote_strategy,...]
Thẻ:execution
,host_machine_resource_optimizations
--experimental_docker_image=<a string>
mặc định: ""-
Chỉ định tên hình ảnh Docker (ví dụ: "ubuntu:latest") sẽ được dùng để thực thi một hành động trong hộp cát khi sử dụng chiến lược docker và chính hành động đó chưa có thuộc tính hình ảnh vùng chứa trong remote_execution_properties trong phần mô tả nền tảng. Giá trị của cờ này được truyền nguyên văn đến lệnh "docker run", do đó, cờ này hỗ trợ cùng một cú pháp và cơ chế như chính Docker.
Thẻ:execution
- Giá trị mặc định của
--[no]experimental_docker_use_customized_images
: "true" - Nếu được bật, sẽ chèn uid và gid của người dùng hiện tại vào hình ảnh Docker trước khi sử dụng. Bạn phải cung cấp thông tin này nếu bản dựng / quy trình kiểm thử của bạn phụ thuộc vào việc người dùng có tên và thư mục gốc bên trong vùng chứa. Chế độ này được bật theo mặc định, nhưng bạn có thể tắt chế độ này trong trường hợp tính năng tự động tuỳ chỉnh hình ảnh không hoạt động trong trường hợp của bạn hoặc bạn biết rằng bạn không cần tính năng này.
Thẻ:execution
- Giá trị mặc định của
--[no]experimental_dynamic_exclude_tools
: "true" -
Khi được đặt, các mục tiêu được tạo "cho công cụ" sẽ không tuân theo phương thức thực thi động. Rất khó để xây dựng các mục tiêu như vậy một cách gia tăng, do đó, bạn không nên sử dụng các chu kỳ cục bộ.
Thẻ:execution
,host_machine_resource_optimizations
--experimental_dynamic_local_load_factor=<a double>
mặc định: "0"-
Kiểm soát lượng tải từ quá trình thực thi động để đặt trên máy cục bộ. Cờ này điều chỉnh số lượng hành động trong quá trình thực thi động mà chúng ta sẽ lên lịch đồng thời. Giá trị này dựa trên số lượng CPU mà Blaze cho là có sẵn, có thể được kiểm soát bằng cờ --local_cpu_resources.
Nếu cờ này là 0, tất cả các hành động sẽ được lên lịch ngay lập tức trên máy. Nếu > 0, số lượng hành động được lên lịch cục bộ sẽ bị giới hạn bởi số lượng CPU có sẵn. Nếu < 1, hệ số tải được dùng để giảm số lượng hành động được lên lịch cục bộ khi số lượng hành động đang chờ lên lịch cao. Điều này làm giảm tải trên máy cục bộ trong trường hợp bản dựng sạch, trong đó máy cục bộ không đóng góp nhiều.
Thẻ:execution
,host_machine_resource_optimizations
--experimental_dynamic_slow_remote_time=<An immutable length of time.>
mặc định: "0"- Nếu >0, thời gian một hành động chạy động phải chạy chỉ từ xa trước khi chúng ta ưu tiên thực thi cục bộ để tránh hết thời gian chờ từ xa. Điều này có thể che giấu một số vấn đề trên hệ thống thực thi từ xa. Đừng bật tính năng này nếu không theo dõi các vấn đề về việc thực thi từ xa.
Thẻ:execution
,host_machine_resource_optimizations
- Giá trị mặc định của
--[no]experimental_enable_docker_sandbox
: "false" - Bật tính năng hộp cát dựa trên Docker. Tuỳ chọn này không có hiệu lực nếu bạn chưa cài đặt Docker.
Thẻ:execution
- Giá trị mặc định của
--[no]experimental_inmemory_sandbox_stashes
: "false" - Nếu bạn đặt thành true, nội dung của hộp cát được lưu vào bộ nhớ đệm cho reuse_sandbox_directories sẽ được theo dõi trong bộ nhớ. Điều này làm giảm lượng I/O cần thiết trong quá trình sử dụng lại. Tuỳ thuộc vào bản dựng, cờ này có thể cải thiện thời gian thực tế. Tuỳ thuộc vào bản dựng, cờ này có thể sử dụng thêm một lượng đáng kể bộ nhớ.
Thẻ:host_machine_resource_optimizations
,execution
--experimental_sandbox_async_tree_delete_idle_threads=<an integer, or a keyword ("auto", "HOST_CPUS", "HOST_RAM"), optionally followed by an operation ([-|*]<float>) eg. "auto", "HOST_CPUS*.5">
mặc định: "4"- Nếu 0, hãy xoá cây hộp cát ngay khi một hành động hoàn tất (khiến hành động bị trì hoãn). Nếu lớn hơn 0, hãy thực thi việc xoá các bộ ba như vậy trên một nhóm luồng không đồng bộ có kích thước 1 khi bản dựng đang chạy và tăng lên kích thước do cờ này chỉ định khi máy chủ ở trạng thái rảnh.
Thẻ:host_machine_resource_optimizations
,execution
--experimental_sandbox_memory_limit_mb=<an integer number of MBs, or "HOST_RAM", optionally followed by [-|*]<float>.>
mặc định: "0"- Nếu > 0, mỗi hộp cát Linux sẽ bị giới hạn ở một lượng bộ nhớ nhất định (tính bằng MB). Yêu cầu cgroups v1 hoặc v2 và quyền cho người dùng đối với thư mục cgroups.
Thẻ:execution
- Giá trị mặc định của
--[no]experimental_shrink_worker_pool
: "false" - Nếu được bật, có thể thu hẹp nhóm worker nếu áp lực bộ nhớ của worker cao. Cờ này chỉ hoạt động khi cờ experimental_total_worker_memory_limit_mb được bật.
Thẻ:execution
,host_machine_resource_optimizations
- Giá trị mặc định của
--[no]experimental_split_xml_generation
: "true" - Nếu bạn đặt cờ này và thao tác kiểm thử không tạo tệp test.xml, thì Bazel sẽ sử dụng một thao tác riêng để tạo tệp test.xml giả chứa nhật ký kiểm thử. Nếu không, Bazel sẽ tạo một tệp test.xml trong thao tác kiểm thử.
Thẻ:execution
--experimental_total_worker_memory_limit_mb=<an integer number of MBs, or "HOST_RAM", optionally followed by [-|*]<float>.>
mặc định: "0"- Nếu giới hạn này lớn hơn 0, thì các worker rảnh có thể bị huỷ nếu tổng mức sử dụng bộ nhớ của tất cả worker vượt quá giới hạn.
Thẻ:execution
,host_machine_resource_optimizations
- Giá trị mặc định của
--[no]experimental_use_hermetic_linux_sandbox
: "false" - Nếu bạn đặt thành true, đừng gắn thư mục gốc, chỉ gắn những gì được cung cấp bằng sandbox_add_mount_pair. Các tệp đầu vào sẽ được liên kết cứng với hộp cát thay vì liên kết tượng trưng với hộp cát. Nếu các tệp đầu vào hành động nằm trên một hệ thống tệp khác với hộp cát, thì các tệp đầu vào sẽ được sao chép.
Thẻ:execution
- Giá trị mặc định của
--[no]experimental_use_semaphore_for_jobs
: "true" - Nếu bạn đặt thành true, hãy sử dụng thêm semaphore để giới hạn số lượng công việc đồng thời.
Thẻ:host_machine_resource_optimizations
,execution
- Giá trị mặc định của
--[no]experimental_use_windows_sandbox
: "false" -
Sử dụng hộp cát Windows để chạy các thao tác. Nếu "có", tệp nhị phân do --experimental_windows_sandbox_path cung cấp phải hợp lệ và tương ứng với một phiên bản sandboxfs được hỗ trợ. Nếu là "tự động", tệp nhị phân có thể bị thiếu hoặc không tương thích.
Thẻ:execution
--experimental_windows_sandbox_path=<a string>
mặc định: "BazelSandbox.exe"-
Đường dẫn đến tệp nhị phân hộp cát Windows để sử dụng khi --experimental_use_windows_sandbox là true. Nếu là tên trần, hãy sử dụng tệp nhị phân đầu tiên của tên đó có trong PATH.
Thẻ:execution
--experimental_worker_allowlist=<comma-separated set of options>
mặc định: xem nội dung mô tả- Nếu không trống, chỉ cho phép sử dụng worker ổn định với cụm từ gợi nhớ khoá worker đã cho.
Thẻ:execution
,host_machine_resource_optimizations
- Giá trị mặc định của
--[no]experimental_worker_as_resource
: "true" - Không hoạt động, sẽ sớm bị xoá.
Thẻ:no_op
- Giá trị mặc định của
--[no]experimental_worker_cancellation
: "false" - Nếu được bật, Bazel có thể gửi yêu cầu huỷ đến các worker hỗ trợ yêu cầu đó.
Thẻ:execution
--experimental_worker_memory_limit_mb=<an integer number of MBs, or "HOST_RAM", optionally followed by [-|*]<float>.>
mặc định: "0"- Nếu giới hạn này lớn hơn 0, thì worker có thể bị huỷ nếu mức sử dụng bộ nhớ của worker vượt quá giới hạn. Nếu không được sử dụng cùng với tính năng thực thi động và `--experimental_dynamic_ignore_local_signals=9`, thì điều này có thể làm hỏng bản dựng của bạn.
Thẻ:execution
,host_machine_resource_optimizations
--experimental_worker_metrics_poll_interval=<An immutable length of time.>
mặc định: "5 giây"- Khoảng thời gian giữa việc thu thập chỉ số worker và có thể thử xoá. Không thể ít hơn 1 giây vì lý do hiệu suất.
Thẻ:execution
,host_machine_resource_optimizations
- Giá trị mặc định của
--[no]experimental_worker_multiplex_sandboxing
: "false" - Nếu được bật, các worker đa kênh sẽ được đưa vào hộp cát, sử dụng một thư mục hộp cát riêng cho mỗi yêu cầu công việc. Chỉ những worker có yêu cầu thực thi "supports-multiplex-sandboxing" mới được đưa vào hộp cát.
Thẻ:execution
- Giá trị mặc định của
--[no]experimental_worker_sandbox_hardening
: "false" - Nếu được bật, worker sẽ chạy trong một hộp cát cứng, nếu quá trình triển khai cho phép.
Thẻ:execution
- Giá trị mặc định của
--[no]experimental_worker_strict_flagfiles
: "false" - Nếu được bật, các đối số hành động cho worker không tuân theo thông số kỹ thuật của worker sẽ gây ra lỗi. Đối số worker phải có đúng một đối số @flagfile là đối số cuối cùng trong danh sách đối số.
Thẻ:execution
- Giá trị mặc định của
--gc_thrashing_threshold=<an integer in 0-100 range>
: "100" -
Tỷ lệ phần trăm không gian cố định bị chiếm dụng (0-100) mà tại đó GcThrashingDetector xem xét các sự kiện áp lực bộ nhớ so với giới hạn của nó (--gc_thrashing_limits). Nếu bạn đặt thành 100, GcThrashingDetector sẽ bị tắt.
Thẻ:host_machine_resource_optimizations
--genrule_strategy=<comma-separated list of options>
mặc định: ""-
Chỉ định cách thực thi genrules. Cờ này sẽ ngừng hoạt động. Thay vào đó, hãy sử dụng --spawn_strategy=<value> để kiểm soát tất cả các hành động hoặc --strategy=Genrule=<value> để chỉ kiểm soát genrules.
Thẻ:execution
--high_priority_workers=<a string>
nhiều lần sử dụng được tích luỹ- Không hoạt động, sẽ sớm bị xoá.
Thẻ:execution
- Giá trị mặc định của
--[no]incompatible_remote_dangling_symlinks
: "true" - Nếu bạn đặt thành true, các đường liên kết tượng trưng được tải lên bộ nhớ đệm từ xa hoặc bộ nhớ đệm của ổ đĩa sẽ được phép treo.
Thẻ:execution
,incompatible_change
- Giá trị mặc định của
--[no]incompatible_remote_symlinks
: "true" - Nếu bạn đặt thành true, Bazel sẽ luôn tải các đường liên kết tượng trưng lên bộ nhớ đệm từ xa hoặc bộ nhớ đệm trên ổ đĩa. Nếu không, các đường liên kết tượng trưng tương đối không bị treo (và chỉ những đường liên kết đó) sẽ được tải lên dưới dạng tệp hoặc thư mục mà các đường liên kết đó trỏ đến.
Thẻ:execution
,incompatible_change
- Giá trị mặc định của
--[no]incompatible_sandbox_hermetic_tmp
: "true" - Nếu bạn đặt thành true, mỗi hộp cát Linux sẽ có thư mục trống chuyên dụng riêng được gắn dưới dạng /tmp thay vì chia sẻ /tmp với hệ thống tệp máy chủ. Sử dụng --sandbox_add_mount_pair=/tmp để tiếp tục xem /tmp của máy chủ trong tất cả các hộp cát.
Thẻ:execution
- Giá trị mặc định của
--[no]internal_spawn_scheduler
: "false" - Tuỳ chọn phần giữ chỗ để chúng ta có thể biết trong Blaze liệu trình lập lịch biểu tạo đã được bật hay chưa.
Thẻ:execution
,host_machine_resource_optimizations
--jobs=<an integer, or a keyword ("auto", "HOST_CPUS", "HOST_RAM"), optionally followed by an operation ([-|*]<float>) eg. "auto", "HOST_CPUS*.5">
[-j
] mặc định: "tự động"-
Số lượng công việc đồng thời cần chạy. Nhận một số nguyên hoặc từ khoá ("tự động", "HOST_CPUS", "HOST_RAM"), theo sau có thể là một phép toán ([-|*]<float>) ví dụ: "tự động", "HOST_CPUS*.5". Giá trị phải nằm trong khoảng từ 1 đến 5000. Các giá trị trên 2500 có thể gây ra vấn đề về bộ nhớ. "tự động" tính toán một giá trị mặc định hợp lý dựa trên tài nguyên của máy chủ lưu trữ.
Thẻ:host_machine_resource_optimizations
,execution
--[no]keep_going
[-k
] mặc định: "false"-
Tiếp tục nhiều nhất có thể sau khi xảy ra lỗi. Mặc dù không thể phân tích mục tiêu không thành công và các mục tiêu phụ thuộc vào mục tiêu đó, nhưng bạn có thể phân tích các điều kiện tiên quyết khác của các mục tiêu này.
Thẻ:eagerness_to_exit
- Giá trị mặc định của
--loading_phase_threads=<an integer, or a keyword ("auto", "HOST_CPUS", "HOST_RAM"), optionally followed by an operation ([-|*]<float>) eg. "auto", "HOST_CPUS*.5">
: "tự động" - Số luồng song song cần sử dụng cho giai đoạn tải/phân tích. Nhận một số nguyên hoặc từ khoá ("tự động", "HOST_CPUS", "HOST_RAM"), theo sau có thể là một phép toán ([-|*]<float>) ví dụ: "tự động", "HOST_CPUS*.5". "tự động" đặt giá trị mặc định hợp lý dựa trên tài nguyên của máy chủ lưu trữ. Phải ít nhất là 1.
Thẻ:bazel_internal_configuration
- Giá trị mặc định của
--[no]reuse_sandbox_directories
: "true" - Nếu được đặt thành true, các thư mục mà quá trình thực thi không phải worker trong hộp cát sử dụng có thể được sử dụng lại để tránh các chi phí thiết lập không cần thiết.
Thẻ:host_machine_resource_optimizations
,execution
--sandbox_base=<a string>
mặc định: ""- Cho phép hộp cát tạo các thư mục hộp cát bên dưới đường dẫn này. Chỉ định một đường dẫn trên tmpfs (chẳng hạn như /run/shm) để có thể cải thiện đáng kể hiệu suất khi bản dựng / kiểm thử của bạn có nhiều tệp đầu vào. Lưu ý: Bạn cần có đủ RAM và dung lượng trống trên tmpfs để lưu trữ các tệp đầu ra và tệp trung gian được tạo bằng các thao tác đang chạy.
Thẻ:host_machine_resource_optimizations
,execution
- Giá trị mặc định của
--[no]sandbox_explicit_pseudoterminal
: "false" -
Bật rõ ràng tính năng tạo pseudoterminals cho các thao tác trong hộp cát. Một số bản phân phối Linux yêu cầu đặt mã nhận dạng nhóm của quy trình thành "tty" bên trong hộp cát để các thiết bị đầu cuối giả hoạt động. Nếu điều này gây ra vấn đề, bạn có thể tắt cờ này để cho phép sử dụng các nhóm khác.
Thẻ:execution
--sandbox_tmpfs_path=<an absolute path>
nhiều lần sử dụng được tích luỹ-
Đối với các thao tác trong hộp cát, hãy gắn một thư mục trống, có thể ghi tại đường dẫn tuyệt đối này (nếu việc triển khai hộp cát hỗ trợ, nếu không thì sẽ bị bỏ qua).
Thẻ:host_machine_resource_optimizations
,execution
- Giá trị mặc định của
--[no]skip_incompatible_explicit_targets
: "false" -
Bỏ qua các mục tiêu không tương thích được liệt kê rõ ràng trên dòng lệnh. Theo mặc định, việc tạo các mục tiêu như vậy sẽ dẫn đến lỗi nhưng các mục tiêu đó sẽ bị bỏ qua khi bạn bật tuỳ chọn này. Xem: https://bazel.build/extending/platforms#skipping-incompatible-targets
Thẻ:loading_and_analysis
--spawn_strategy=<comma-separated list of options>
mặc định: ""-
Chỉ định cách thực thi các hành động tạo theo mặc định. Chấp nhận danh sách chiến lược được phân tách bằng dấu phẩy theo thứ tự ưu tiên từ cao nhất đến thấp nhất. Đối với mỗi hành động, Bazel sẽ chọn chiến lược có mức độ ưu tiên cao nhất có thể thực thi hành động đó. Giá trị mặc định là "remote,worker,sandboxed,local". Hãy xem https://blog.bazel.build/2019/06/19/list-strategy.html để biết thông tin chi tiết.
Thẻ:execution
--strategy=<a '[name=]value1[,..,valueN]' assignment>
nhiều lần sử dụng được tích luỹ-
Chỉ định cách phân phối quá trình biên dịch của các thao tác tạo khác. Chấp nhận danh sách chiến lược được phân tách bằng dấu phẩy theo thứ tự ưu tiên từ cao nhất đến thấp nhất. Đối với mỗi hành động, Bazel sẽ chọn chiến lược có mức độ ưu tiên cao nhất có thể thực thi hành động đó. Giá trị mặc định là "remote,worker,sandboxed,local". Cờ này ghi đè các giá trị do --spawn_strategy đặt (và --genrule_strategy nếu được sử dụng với Genrule mnemonic). Hãy xem https://blog.bazel.build/2019/06/19/list-strategy.html để biết thông tin chi tiết.
Thẻ:execution
--strategy_regexp=<a '<RegexFilter>=value[,value]' assignment>
nhiều lần sử dụng được tích luỹ- Ghi đè chiến lược tạo nào sẽ được dùng để thực thi các thao tác tạo có nội dung mô tả khớp với một bộ lọc 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ệ thống sẽ sử dụng regex_filter cuối cùng khớp với nội dung mô tả. Tuỳ chọn này 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 bằng chiến lược cục bộ 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 sẽ chạy 'Compiling //foo/bar/baz' bằng chiến lược 'local', nhưng việc đảo ngược thứ tự sẽ chạy chiến lược đó bằng 'sandboxed'.
Thẻ:execution
--worker_extra_flag=<a 'name=value' assignment>
nhiều lần sử dụng được tích luỹ-
Các cờ lệnh bổ sung sẽ được truyền đến các quy trình worker ngoài --persistent_worker, được khoá bằng câu thần chú (ví dụ: --worker_extra_flag=Javac=--debug.
Thẻ:execution
,host_machine_resource_optimizations
--worker_max_instances=<[name=]value, where value is an integer, or a keyword ("auto", "HOST_CPUS", "HOST_RAM"), optionally followed by an operation ([-|*]<float>) eg. "auto", "HOST_CPUS*.5">
nhiều lần sử dụng được tích luỹ-
Số lượng thực thể của mỗi loại worker ổn định có thể được khởi chạy nếu bạn sử dụng chiến lược "worker". Có thể được chỉ định là [name=value] để cung cấp một giá trị khác nhau cho mỗi câu thần chú. Giới hạn này dựa trên khoá worker, được phân biệt dựa trên câu thần chú, nhưng cũng dựa trên cờ khởi động và môi trường. Vì vậy, trong một số trường hợp, có thể có nhiều worker hơn trên mỗi câu thần chú so với cờ này chỉ định. Nhận một số nguyên hoặc từ khoá ("tự động", "HOST_CPUS", "HOST_RAM"), theo sau có thể là một phép toán ([-|*]<float>) ví dụ: "tự động", "HOST_CPUS*.5". "tự động" tính toán một giá trị mặc định hợp lý dựa trên dung lượng máy. "=value" đặt giá trị mặc định cho các từ viết tắt chưa chỉ định.
Thẻ:execution
,host_machine_resource_optimizations
--worker_max_multiplex_instances=<[name=]value, where value is an integer, or a keyword ("auto", "HOST_CPUS", "HOST_RAM"), optionally followed by an operation ([-|*]<float>) eg. "auto", "HOST_CPUS*.5">
nhiều lần sử dụng được tích luỹ-
Số lượng WorkRequest mà một quy trình worker đa kênh có thể nhận được song song nếu bạn sử dụng chiến lược "worker" với --worker_multiplex. Có thể được chỉ định là [name=value] để cung cấp một giá trị khác nhau cho mỗi câu thần chú. Giới hạn này dựa trên khoá worker, được phân biệt dựa trên câu thần chú, nhưng cũng dựa trên cờ khởi động và môi trường. Vì vậy, trong một số trường hợp, có thể có nhiều worker hơn trên mỗi câu thần chú so với cờ này chỉ định. Nhận một số nguyên hoặc từ khoá ("tự động", "HOST_CPUS", "HOST_RAM"), theo sau có thể là một phép toán ([-|*]<float>) ví dụ: "tự động", "HOST_CPUS*.5". "tự động" tính toán một giá trị mặc định hợp lý dựa trên dung lượng máy. "=value" đặt giá trị mặc định cho các từ viết tắt chưa chỉ định.
Thẻ:execution
,host_machine_resource_optimizations
- Giá trị mặc định của
--[no]worker_multiplex
: "true" - Nếu được bật, worker sẽ sử dụng tính năng đa kênh nếu chúng hỗ trợ tính năng này.
Thẻ:execution
,host_machine_resource_optimizations
- Giá trị mặc định của
--[no]worker_quit_after_build
: "false" - Nếu được bật, tất cả worker sẽ thoát sau khi bản dựng hoàn tất.
Thẻ:execution
,host_machine_resource_optimizations
- Giá trị mặc định của
--[no]worker_sandboxing
: "false" - Nếu được bật, worker sẽ được thực thi trong môi trường hộp cát.
Thẻ:execution
- Giá trị mặc định của
--[no]worker_verbose
: "false" - Nếu được bật, sẽ in thông báo chi tiết khi các worker được khởi động, tắt, ...
- Các tuỳ chọn định cấu hình chuỗi công cụ dùng để thực thi hành động:
--target_platform_fallback=<a string>
mặc định: ""- Tuỳ chọn này không được dùng nữa và không có hiệu lực.
Thẻ:affects_outputs
,changes_inputs
,loading_and_analysis
- Các tuỳ chọn kiểm soát đầu ra của lệnh:
- Giá trị mặc định của
--[no]build
: "true" -
Thực thi bản dựng; đây là hành vi thông thường. Việc chỉ định --nobuild sẽ khiến bản dựng dừng trước khi thực thi các thao tác bản dựng, trả về giá trị 0 nếu các giai đoạn tải và phân tích gói hoàn tất thành công; chế độ này hữu ích để kiểm thử các giai đoạn đó.
Thẻ:execution
,affects_outputs
- Giá trị mặc định của
--[no]experimental_use_validation_aspect
: "false" -
Liệu có chạy các thao tác xác thực bằng phương diện (để chạy song song với các kiểm thử) hay không.
Thẻ:execution
,affects_outputs
--output_groups=<comma-separated list of options>
nhiều lần sử dụng được tích luỹ-
Danh sách tên nhóm đầu ra được phân tách bằng dấu phẩy, mỗi tên có thể có tiền tố là + hoặc -. Nhóm có tiền tố là + sẽ được thêm vào nhóm đầu ra mặc định, còn nhóm có tiền tố là - sẽ bị xoá khỏi nhóm mặc định. Nếu ít nhất một nhóm không có tiền tố, thì nhóm đầu ra mặc định sẽ bị bỏ qua. Ví dụ: --output_groups=+foo,+bar sẽ tạo tập hợp hợp nhất của tập hợp mặc định, foo và bar, trong khi --output_groups=foo,bar sẽ ghi đè tập hợp mặc định để chỉ tạo foo và bar.
Thẻ:execution
,affects_outputs
- Giá trị mặc định của
--[no]run_validations
: "true" -
Liệu có chạy các hành động xác thực trong bản dựng hay không. Xem https://bazel.build/extending/rules#validation_actions
Thẻ:execution
,affects_outputs
- Các tuỳ chọn cho phép người dùng định cấu hình đầu ra dự kiến, ảnh hưởng đến giá trị của đầu ra đó, thay vì sự tồn tại của đầu ra:
--aspects=<comma-separated list of options>
nhiều lần sử dụng được tích luỹ- Danh sách được phân tách bằng dấu phẩy gồm các khía cạnh sẽ được áp dụng cho các mục tiêu cấp cao nhất. Trong danh sách, nếu một_phương_diện chỉ định các nhà cung cấp phương diện bắt buộc thông qua required_aspect_providers, thì một_phương_diện sẽ chạy sau mọi phương diện được đề cập trước đó trong danh sách phương diện mà các nhà cung cấp được quảng cáo đáp ứng các nhà cung cấp phương diện bắt buộc của một_phương_diện. Hơn nữa, some_aspect sẽ chạy sau khi tất cả các khía cạnh bắt buộc được chỉ định bằng thuộc tính requires. Sau đó, some_aspect sẽ có quyền truy cập vào các giá trị của trình cung cấp khía cạnh đó. <bzl-file-label>%<aspect_name>, ví dụ: '//tools:my_def.bzl%my_aspect', trong đó 'my_aspect' là một giá trị cấp cao nhất từ tệp tools/my_def.bzl
--bep_maximum_open_remote_upload_files=<an integer>
mặc định: "-1"- Số lượng tệp mở tối đa được phép trong quá trình tải cấu phần phần mềm BEP lên.
Thẻ:affects_outputs
--[no]experimental_convenience_symlinks
mặc định: "bình thường"-
Cờ này kiểm soát cách quản lý các đường liên kết tượng trưng thuận tiện (đường liên kết tượng trưng xuất hiện trong không gian làm việc sau khi tạo bản dựng). Giá trị có thể có:
normal (mặc định): Mỗi loại đường liên kết tượng trưng thuận tiện sẽ được tạo hoặc xoá, tuỳ thuộc vào bản dựng.
clean: Tất cả đường liên kết tượng trưng sẽ bị xoá vô điều kiện.
ignore: Đường liên kết tượng trưng sẽ không bị ảnh hưởng.
log_only: Tạo thông điệp nhật ký như thể đã truyền "bình thường", nhưng thực sự không thực hiện bất kỳ thao tác nào trên hệ thống tệp (hữu ích cho các công cụ).
Xin lưu ý rằng chỉ những đường liên kết tượng trưng có tên được tạo bằng giá trị hiện tại của --symlink_prefix mới có thể bị ảnh hưởng; nếu tiền tố thay đổi, mọi đường liên kết tượng trưng hiện có sẽ không bị ảnh hưởng.
Thẻ:affects_outputs
- Giá trị mặc định của
--[no]experimental_convenience_symlinks_bep_event
: "false" -
Cờ này kiểm soát việc chúng ta có đăng sự kiện buildConvenienceSymlinksIdentified lên BuildEventProtocol hay không. Nếu giá trị là true, BuildEventProtocol sẽ có một mục nhập cho convenienceSymlinksIdentified, liệt kê tất cả các đường liên kết tượng trưng tiện lợi được tạo trong không gian làm việc của bạn. Nếu giá trị là false, thì mục convenienceSymlinksIdentified trong BuildEventProtocol sẽ trống.
Thẻ:affects_outputs
--remote_download_all
-
Tải tất cả đầu ra từ xa xuống máy cục bộ. Cờ này là đại diện cho --remote_download_outputs=all.
Mở rộng thành:
--remote_download_outputs=all
Thẻ:affects_outputs
--remote_download_minimal
-
Không tải bất kỳ đầu ra bản dựng từ xa nào xuống máy cục bộ. Cờ này là bí danh của --remote_download_outputs=minimal.
Mở rộng thành:
--remote_download_outputs=minimal
Thẻ:affects_outputs
--remote_download_outputs=<all, minimal or toplevel>
mặc định: "toplevel"- Nếu được đặt thành "minimal" (tối thiểu), thì sẽ không tải bất kỳ đầu ra bản dựng từ xa nào xuống máy cục bộ, ngoại trừ những đầu ra mà các hành động cục bộ yêu cầu. Nếu được đặt thành "toplevel", thì chế độ này sẽ hoạt động giống như "minimal", ngoại trừ việc chế độ này cũng tải kết quả của các mục tiêu cấp cao nhất xuống máy cục bộ. Cả hai tuỳ chọn này đều có thể giảm đáng kể thời gian xây dựng nếu băng thông mạng là nút thắt cổ chai.
Thẻ:affects_outputs
--remote_download_symlink_template=<a string>
mặc định: ""- Thay vì tải các đầu ra bản dựng từ xa xuống máy cục bộ, hãy tạo các đường liên kết tượng trưng. Bạn có thể chỉ định mục tiêu của đường liên kết tượng trưng ở dạng chuỗi mẫu. Chuỗi mẫu này có thể chứa {hash} và {size_bytes} lần lượt mở rộng thành hàm băm của đối tượng và kích thước tính bằng byte. Ví dụ: các đường liên kết tượng trưng này có thể trỏ đến một hệ thống tệp FUSE tải các đối tượng từ CAS theo yêu cầu.
Thẻ:affects_outputs
--remote_download_toplevel
-
Chỉ tải các đầu ra từ xa của mục tiêu cấp cao nhất xuống máy cục bộ. Cờ này là bí danh của --remote_download_outputs=toplevel.
Mở rộng thành:
--remote_download_outputs=toplevel
Thẻ:affects_outputs
--symlink_prefix=<a string>
mặc định: xem nội dung mô tả-
Tiền tố được thêm vào bất kỳ đường liên kết tượng trưng tiện lợi nào được tạo sau một bản dựng. Nếu bị bỏ qua, giá trị mặc định là tên của công cụ xây dựng, theo sau là dấu gạch nối. Nếu bạn truyền "/", thì hệ thống sẽ không tạo đường liên kết tượng trưng và không phát ra cảnh báo nào. Cảnh báo: chức năng đặc biệt cho "/" sẽ sớm ngừng hoạt động; hãy sử dụng --experimental_convenience_symlinks=ignore.
Thẻ:affects_outputs
- Các tuỳ chọn ảnh hưởng đến mức độ nghiêm ngặt mà Bazel thực thi các dữ liệu đầu vào bản dựng hợp lệ (xác định quy tắc, tổ hợp cờ, v.v.):
- Giá trị mặc định của
--[no]experimental_docker_privileged
: "false" - Nếu được bật, Bazel sẽ truyền cờ --privileged đến "docker run" khi chạy các hành động. Điều này có thể là yêu cầu của bản dựng, nhưng cũng có thể làm giảm tính kín khít.
Thẻ:execution
- Giá trị mặc định của
--[no]experimental_sandboxfs_map_symlink_targets
: "false" -
Không hoạt động
Thẻ:host_machine_resource_optimizations
,execution
- Giá trị mặc định của
--[no]incompatible_legacy_local_fallback
: "false" - Nếu bạn đặt thành true, thì chế độ dự phòng ngầm ẩn cũ sẽ được bật từ chiến lược hộp cát sang chiến lược cục bộ. Cờ này cuối cùng sẽ mặc định là false và sau đó trở thành không hoạt động. Thay vào đó, hãy sử dụng --strategy, --spawn_strategy hoặc --dynamic_local_strategy để định cấu hình dự phòng.
Thẻ:execution
,incompatible_change
--sandbox_add_mount_pair=<a single path or a 'source:target' pair>
nhiều lần sử dụng được tích luỹ-
Thêm cặp đường dẫn bổ sung để gắn trong hộp cát.
Thẻ:execution
--sandbox_block_path=<a string>
nhiều lần sử dụng được tích luỹ-
Đối với các hành động trong hộp cát, không cho phép truy cập vào đường dẫn này.
Thẻ:execution
- Giá trị mặc định của
--[no]sandbox_default_allow_network
: "true" - Theo mặc định, cho phép truy cập mạng cho các hành động; tuỳ chọn này có thể không hoạt động với tất cả các cách triển khai hộp cát.
Thẻ:execution
- Giá trị mặc định của
--[no]sandbox_fake_hostname
: "false" -
Thay đổi tên máy chủ hiện tại thành "localhost" cho các hành động trong hộp cát.
Thẻ:execution
- Giá trị mặc định của
--[no]sandbox_fake_username
: "false" -
Thay đổi tên người dùng hiện tại thành "nobody" (không ai) cho các hành động trong hộp cát.
Thẻ:execution
--sandbox_writable_path=<a string>
nhiều lần sử dụng được tích luỹ-
Đối với các thao tác trong hộp cát, hãy tạo một thư mục hiện có có thể ghi trong hộp cát (nếu việc triển khai hộp cát hỗ trợ, nếu không thì sẽ bị bỏ qua).
Thẻ:execution
- Tuỳ chọn này ảnh hưởng đến ngữ nghĩa của ngôn ngữ Starlark hoặc API bản dựng có thể truy cập vào các tệp BUILD, tệp .bzl hoặc tệp WORKSPACE.:
- Giá trị mặc định của
--[no]incompatible_config_setting_private_default_visibility
: "false" - Nếu incompatible_enforce_config_setting_visibility=false, thì đây là một thao tác không có tác dụng. Nếu không, nếu cờ này là false, mọi config_setting không có thuộc tính chế độ hiển thị rõ ràng sẽ là //visibility:public. Nếu cờ này là true, config_setting sẽ tuân theo logic hiển thị giống như tất cả các quy tắc khác. Xem https://github.com/bazelbuild/bazel/issues/12933.
Thẻ:loading_and_analysis
,incompatible_change
- Giá trị mặc định của
--[no]incompatible_enforce_config_setting_visibility
: "true" - Nếu đúng, hãy thực thi các quy định hạn chế về chế độ hiển thị config_setting. Nếu giá trị là false, mọi mục config_setting đều hiển thị với mọi mục tiêu. Xem https://github.com/bazelbuild/bazel/issues/12932.
Thẻ:loading_and_analysis
,incompatible_change
- Các tuỳ chọn điều chỉnh hành vi của môi trường kiểm thử hoặc trình chạy kiểm thử:
- Giá trị mặc định của
--[no]check_tests_up_to_date
: "false" -
Đừng chạy kiểm thử, chỉ cần kiểm tra xem các kiểm thử đó có được cập nhật hay không. Nếu tất cả kết quả kiểm thử đều mới nhất, thì quá trình kiểm thử sẽ hoàn tất thành công. Nếu cần tạo hoặc thực thi bất kỳ chương trình kiểm thử nào, lỗi sẽ được báo cáo và quá trình kiểm thử sẽ không thành công. Tuỳ chọn này ngụ ý hành vi --check_up_to_date.
Thẻ:execution
--flaky_test_attempts=<a positive integer, the string "default", or test_regex@attempts. This flag may be passed more than once>
nhiều lần sử dụng được tích luỹ-
Mỗi lượt kiểm thử sẽ được thử lại tối đa số lần đã chỉ định trong trường hợp có bất kỳ lượt kiểm thử nào không thành công. Các kiểm thử cần nhiều lần thử mới vượt qua được sẽ được đánh dấu là "KHÔNG ĐÁNG TIN CẬY" trong phần tóm tắt kiểm thử. Thông thường, giá trị được chỉ định chỉ là một số nguyên hoặc chuỗi "mặc định". Nếu là số nguyên, thì tất cả các chương trình kiểm thử sẽ chạy tối đa N lần. Nếu là "mặc định", thì chỉ một lần thử nghiệm sẽ được thực hiện cho các kiểm thử thông thường và 3 lần cho các kiểm thử được đánh dấu rõ ràng là không ổn định theo quy tắc của chúng (thuộc tính flaky=1). Cú pháp thay thế: regex_filter@flaky_test_attempts. Trong đó, flaky_test_attempts như trên và regex_filter là danh sách các mẫu biểu thức chính quy bao gồm và loại trừ (Xem thêm --runs_per_test). Ví dụ: --flaky_test_attempts=//foo/.*,-//foo/bar/.*@3 sẽ loại bỏ tất cả các lần kiểm thử trong //foo/ ngoại trừ các lần kiểm thử trong foo/bar ba lần. Bạn có thể truyền tuỳ chọn này nhiều lần. Đối số khớp được truyền gần đây nhất sẽ được ưu tiên. Nếu không có giá trị nào khớp, hành vi sẽ giống như "mặc định" ở trên.
Thẻ:execution
- Giá trị mặc định của
--local_test_jobs=<an integer, or a keyword ("auto", "HOST_CPUS", "HOST_RAM"), optionally followed by an operation ([-|*]<float>) eg. "auto", "HOST_CPUS*.5">
: "tự động" -
Số lượng công việc kiểm thử cục bộ tối đa để chạy đồng thời. Nhận một số nguyên hoặc từ khoá ("tự động", "HOST_CPUS", "HOST_RAM"), theo sau có thể là một phép toán ([-|*]<float>) ví dụ: "tự động", "HOST_CPUS*.5". 0 có nghĩa là tài nguyên cục bộ sẽ giới hạn số lượng công việc kiểm thử cục bộ để chạy đồng thời. Việc đặt giá trị này lớn hơn giá trị cho --jobs sẽ không hiệu quả.
Thẻ:execution
- Giá trị mặc định của
--[no]test_keep_going
: "true" -
Khi bị tắt, mọi kiểm thử không đạt sẽ khiến toàn bộ bản dựng dừng lại. Theo mặc định, tất cả các bài kiểm thử đều chạy, ngay cả khi một số bài kiểm thử không đạt.
Thẻ:execution
--test_strategy=<a string>
mặc định: ""-
Chỉ định chiến lược nào sẽ được sử dụng khi chạy kiểm thử.
Thẻ:execution
--test_tmpdir=<a path>
mặc định: xem nội dung mô tả- Chỉ định thư mục tạm thời cơ sở để "kiểm thử bazel" sử dụng.
- Các tuỳ chọn liên quan đến kết quả truy vấn và ngữ nghĩa:
- Giá trị mặc định của
--[no]experimental_parallel_aquery_output
: "true" - Không hoạt động.
- Các tuỳ chọn liên quan đến đầu ra và ngữ nghĩa của Bzlmod:
--allow_yanked_versions=<a string>
nhiều lần sử dụng được tích luỹ-
Chỉ định các phiên bản mô-đun ở dạng `<module1>@<version1>,<module2>@<version2>` sẽ được cho phép trong biểu đồ phần phụ thuộc đã phân giải ngay cả khi các phiên bản đó được khai báo là đã bị xoá trong sổ đăng ký nơi chúng đến (nếu không đến từ NonRegistryOverride). Nếu không, các phiên bản bị xoá sẽ khiến việc phân giải không thành công. Bạn cũng có thể xác định phiên bản bị xoá được phép bằng biến môi trường `BZLMOD_ALLOW_YANKED_VERSIONS`. Bạn có thể tắt tính năng kiểm tra này bằng cách sử dụng từ khoá "tất cả" (không nên dùng).
Thẻ:loading_and_analysis
--check_bazel_compatibility=<error, warning or off>
mặc định: "lỗi"-
Kiểm tra khả năng tương thích của phiên bản bazel của các mô-đun Bazel. Các giá trị hợp lệ là "error" để chuyển vấn đề này lên lỗi phân giải, "off" để tắt tính năng kiểm tra hoặc "warning" để in cảnh báo khi phát hiện thấy không khớp.
Thẻ:loading_and_analysis
--check_direct_dependencies=<off, warning or error>
mặc định: "cảnh báo"-
Kiểm tra xem các phần phụ thuộc `bazel_dep` trực tiếp được khai báo trong mô-đun gốc có phải là các phiên bản mà bạn nhận được trong biểu đồ phần phụ thuộc đã được phân giải hay không. Các giá trị hợp lệ là "off" để tắt tính năng kiểm tra, "warning" để in cảnh báo khi phát hiện thấy không khớp hoặc "error" để chuyển lên lỗi phân giải.
Thẻ:loading_and_analysis
- Giá trị mặc định của
--[no]ignore_dev_dependency
: "false" - Nếu đúng, Bazel sẽ bỏ qua "bazel_dep" và "use_extension" được khai báo là "dev_dependency" trong MODULE.bazel của mô-đun gốc. Xin lưu ý rằng các phần phụ thuộc dành cho nhà phát triển đó luôn bị bỏ qua trong MODULE.bazel nếu đó không phải là mô-đun gốc, bất kể giá trị của cờ này là gì.
Thẻ:loading_and_analysis
--lockfile_mode=<off, update, refresh or error>
mặc định: "cập nhật"-
Chỉ định cách thức và liệu có sử dụng tệp khoá hay không. Các giá trị hợp lệ là "update" để sử dụng tệp khoá và cập nhật tệp khoá nếu có thay đổi, "refresh" để thỉnh thoảng làm mới thông tin có thể thay đổi (các phiên bản bị loại bỏ và các mô-đun bị thiếu trước đó) từ các sổ đăng ký từ xa, "error" để sử dụng tệp khoá nhưng gửi lỗi nếu tệp khoá không được cập nhật hoặc "off" để không đọc hoặc ghi vào tệp khoá.
Thẻ:loading_and_analysis
--override_module=<an equals-separated mapping of module name to path>
nhiều lần sử dụng được tích luỹ- Ghi đè một mô-đun bằng đường dẫn cục bộ ở dạng <tên mô-đun>=<đường dẫn>. Nếu đường dẫn đã cho là đường dẫn tuyệt đối, thì đường dẫn đó sẽ được sử dụng nguyên trạng. Nếu đường dẫn đã cho là đường dẫn tương đối, thì đường dẫn đó sẽ tương ứng với thư mục đang hoạt động. Nếu đường dẫn đã cho bắt đầu bằng "%workspace%", thì đường dẫn đó sẽ tương ứng với thư mục gốc của không gian làm việc, là kết quả của lệnh "bazel info workspace". Nếu đường dẫn đã cho trống, hãy xoá mọi chế độ ghi đè trước đó.
--registry=<a string>
nhiều lần sử dụng được tích luỹ- Chỉ định các sổ đăng ký cần sử dụng để xác định vị trí các phần phụ thuộc mô-đun Bazel. Thứ tự rất quan trọng: các mô-đun sẽ được tra cứu trong các sổ đăng ký trước đó trước tiên và chỉ quay lại các sổ đăng ký sau này khi các mô-đun đó bị thiếu trong các sổ đăng ký trước đó.
Thẻ:changes_inputs
--vendor_dir=<a path>
mặc định: xem nội dung mô tả-
Chỉ định thư mục sẽ chứa các kho lưu trữ bên ngoài ở chế độ nhà cung cấp, cho dù mục đích là tìm nạp các kho lưu trữ đó vào thư mục hay sử dụng các kho lưu trữ đó trong khi xây dựng. Bạn có thể chỉ định đường dẫn dưới dạng đường dẫn tuyệt đối hoặc đường dẫn tương đối đến thư mục không gian làm việc.
Thẻ:loading_and_analysis
- Các tuỳ chọn kích hoạt tính năng tối ưu hoá thời gian xây dựng:
--cache_computed_file_digests=<a long integer>
mặc định: "50000"- Nếu lớn hơn 0, hãy định cấu hình Bazel để lưu các chuỗi đại diện tệp vào bộ nhớ đệm dựa trên siêu dữ liệu của các chuỗi đại diện đó thay vì tính toán lại các chuỗi đại diện từ ổ đĩa mỗi khi cần. Việc đặt giá trị này thành 0 sẽ đảm bảo tính chính xác vì không phải mọi thay đổi về tệp đều có thể được ghi nhận từ siêu dữ liệu tệp. Khi không bằng 0, số này cho biết kích thước của bộ nhớ đệm dưới dạng số lượng hàm băm tệp cần lưu vào bộ nhớ đệm.
--experimental_dynamic_ignore_local_signals=<a comma-separated list of signal numbers>
mặc định: xem nội dung mô tả- Lấy danh sách số tín hiệu của hệ điều hành. Nếu một nhánh cục bộ của quá trình thực thi động bị huỷ bằng bất kỳ tín hiệu nào trong số này, thì nhánh từ xa sẽ được phép hoàn tất. Đối với worker liên tục, điều này chỉ ảnh hưởng đến các tín hiệu huỷ quy trình worker.
Thẻ:execution
--gc_thrashing_limits=<comma separated pairs of <period>:<count>>
mặc định: "1s:2,20s:3,1m:5"-
Các giới hạn nếu đạt đến sẽ khiến GcThrashingDetector gặp sự cố Bazel với OOM. Mỗi giới hạn được chỉ định là <period>:<count>, trong đó period là thời lượng và count là số nguyên dương. Nếu hơn --gc_thrashing_threshold phần trăm không gian cố định (vùng nhớ khối xếp cũ) vẫn bị chiếm dụng sau <count> lần GC đầy đủ liên tiếp trong <period>, thì lỗi OOM sẽ được kích hoạt. Bạn có thể chỉ định nhiều giới hạn, phân tách bằng dấu phẩy.
Thẻ:host_machine_resource_optimizations
--local_cpu_resources=<an integer, or "HOST_CPUS", optionally followed by [-|*]<float>.>
mặc định: "HOST_CPUS"-
Đặt rõ ràng tổng số lõi CPU cục bộ có sẵn cho Bazel để dành cho các thao tác xây dựng được thực thi cục bộ. Nhận một số nguyên hoặc "HOST_CPUS", theo sau có thể là [-|*]<float> (ví dụ: HOST_CPUS*.5 để sử dụng một nửa số lõi CPU có sẵn). Theo mặc định ("HOST_CPUS"), Bazel sẽ truy vấn cấu hình hệ thống để ước tính số lõi CPU có sẵn.
Thẻ:host_machine_resource_optimizations
--local_extra_resources=<a named float, 'name=value'>
nhiều lần sử dụng được tích luỹ-
Đặt số lượng tài nguyên bổ sung có sẵn cho Bazel. Nhận một cặp chuỗi-float. Có thể sử dụng nhiều lần để chỉ định nhiều loại tài nguyên bổ sung. Bazel sẽ giới hạn các thao tác chạy đồng thời dựa trên tài nguyên bổ sung hiện có và tài nguyên bổ sung cần thiết. Các chương trình kiểm thử có thể khai báo lượng tài nguyên bổ sung cần thiết bằng cách sử dụng thẻ có định dạng "resources:<resoucename>:<amount>". Bạn không thể đặt CPU, RAM và tài nguyên có sẵn bằng cờ này.
Thẻ:host_machine_resource_optimizations
--local_ram_resources=<an integer number of MBs, or "HOST_RAM", optionally followed by [-|*]<float>.>
mặc định: "HOST_RAM*.67"-
Đặt rõ ràng tổng dung lượng RAM của máy chủ cục bộ (tính bằng MB) mà Bazel có thể sử dụng cho các thao tác tạo bản dựng được thực thi cục bộ. Nhận một số nguyên hoặc "HOST_RAM", theo sau có thể là [-|*]<float> (ví dụ: HOST_RAM*.5 để sử dụng một nửa RAM có sẵn). Theo mặc định, ("HOST_RAM*.67"), Bazel sẽ truy vấn cấu hình hệ thống để ước tính dung lượng RAM có sẵn và sẽ sử dụng 67% dung lượng đó.
Thẻ:host_machine_resource_optimizations
--local_resources=<a named double, 'name=value', where value is an integer, or a keyword ("auto", "HOST_CPUS", "HOST_RAM"), optionally followed by an operation ([-|*]<float>) eg. "auto", "HOST_CPUS*.5">
nhiều lần sử dụng được tích luỹ-
Đặt số lượng tài nguyên có sẵn cho Bazel. Nhận một giá trị gán cho float hoặc HOST_RAM/HOST_CPUS, theo sau có thể là [-|*]<float> (ví dụ: memory=HOST_RAM*.5 để sử dụng một nửa RAM có sẵn). Có thể sử dụng nhiều lần để chỉ định nhiều loại tài nguyên. Bazel sẽ giới hạn các thao tác chạy đồng thời dựa trên tài nguyên có sẵn và tài nguyên cần thiết. Các chương trình kiểm thử có thể khai báo lượng tài nguyên cần thiết bằng cách sử dụng thẻ có định dạng "resources:<resource name>:<amount>". Ghi đè các tài nguyên do --local_{cpu|ram|extra}_resources chỉ định.
Thẻ:host_machine_resource_optimizations
--skyframe_high_water_mark_full_gc_drops_per_invocation=<an integer, >= 0>
mặc định: "2147483647"-
Cờ cho cấu hình nâng cao của công cụ Skyframe nội bộ của Bazel. Nếu phát hiện mức sử dụng phần trăm vùng nhớ khối xếp được giữ lại vượt quá ngưỡng do --skyframe_high_water_mark_threshold đặt ra, thì khi một sự kiện GC đầy đủ xảy ra, Bazel sẽ loại bỏ trạng thái Skyframe tạm thời không cần thiết, lên đến nhiều lần như vậy cho mỗi lệnh gọi. Mặc định là Integer.MAX_VALUE; không giới hạn về mặt hiệu quả. Giá trị 0 có nghĩa là các sự kiện GC đầy đủ sẽ không bao giờ kích hoạt sự kiện thả. Nếu đạt đến giới hạn, trạng thái Skyframe sẽ không còn bị loại bỏ khi một sự kiện GC đầy đủ xảy ra và vượt quá ngưỡng phần trăm vùng nhớ khối xếp được giữ lại đó.
Thẻ:host_machine_resource_optimizations
--skyframe_high_water_mark_minor_gc_drops_per_invocation=<an integer, >= 0>
mặc định: "2147483647"-
Cờ cho cấu hình nâng cao của công cụ Skyframe nội bộ của Bazel. Nếu phát hiện mức sử dụng phần trăm vùng nhớ khối xếp được giữ lại vượt quá ngưỡng do --skyframe_high_water_mark_threshold đặt ra, thì khi một sự kiện GC nhỏ xảy ra, Bazel sẽ loại bỏ trạng thái Skyframe tạm thời không cần thiết, lên đến nhiều lần như vậy mỗi lần gọi. Mặc định là Integer.MAX_VALUE; không giới hạn về mặt hiệu quả. Giá trị 0 có nghĩa là các sự kiện GC nhỏ sẽ không bao giờ kích hoạt sự kiện thả. Nếu đạt đến giới hạn, trạng thái Skyframe sẽ không còn bị loại bỏ khi một sự kiện GC nhỏ xảy ra và vượt quá ngưỡng phần trăm vùng nhớ khối xếp được giữ lại.
Thẻ:host_machine_resource_optimizations
--skyframe_high_water_mark_threshold=<an integer>
mặc định: "85"-
Cờ cho cấu hình nâng cao của công cụ Skyframe nội bộ của Bazel. Nếu phát hiện mức sử dụng phần trăm vùng nhớ khối xếp được giữ lại ít nhất là ngưỡng này, Bazel sẽ loại bỏ trạng thái Skyframe tạm thời không cần thiết. Việc điều chỉnh điều này có thể giúp bạn giảm thiểu tác động của tình trạng GC bị lỗi khi (i) tình trạng này là do mức sử dụng bộ nhớ của trạng thái tạm thời và (ii) tốn kém hơn so với việc tạo lại trạng thái khi cần.
Thẻ:host_machine_resource_optimizations
- Các tuỳ chọn ảnh hưởng đến mức độ chi tiết, định dạng hoặc vị trí ghi nhật ký:
- Giá trị mặc định của
--[no]debug_spawn_scheduler
: "false" - Giá trị mặc định của
--[no]experimental_bep_target_summary
: "false" - Liệu có xuất bản sự kiện TargetSummary hay không.
- Giá trị mặc định của
--[no]experimental_build_event_expand_filesets
: "false" - Nếu đúng, hãy mở rộng Filesets (Nhóm tệp) trong BEP khi trình bày các tệp đầu ra.
Thẻ:affects_outputs
- Giá trị mặc định của
--[no]experimental_build_event_fully_resolve_fileset_symlinks
: "false" - Nếu đúng, hãy phân giải đầy đủ các đường liên kết tượng trưng của Tập hợp tệp tương đối trong BEP khi trình bày các tệp đầu ra. Yêu cầu --experimental_build_event_expand_filesets.
Thẻ:affects_outputs
--experimental_build_event_upload_max_retries=<an integer>
mặc định: "4"-
Số lần tối đa mà Bazel sẽ thử tải lại một sự kiện bản dựng.
Thẻ:bazel_internal_configuration
--experimental_build_event_upload_retry_minimum_delay=<An immutable length of time.>
mặc định: "1 giây"-
Độ trễ ban đầu, tối thiểu để thử lại thời gian đợi luỹ thừa khi tải BEP không thành công. (chỉ số: 1,6)
Thẻ:bazel_internal_configuration
--experimental_build_event_upload_strategy=<a string>
mặc định: xem nội dung mô tả-
Chọn cách tải các cấu phần phần mềm được tham chiếu trong giao thức sự kiện bản dựng lên.
Thẻ:affects_outputs
- Giá trị mặc định của
--[no]experimental_collect_local_sandbox_action_metrics
: "true" -
Không dùng nữa.
Thẻ:execution
--experimental_command_profile=<cpu, wall, alloc or lock>
mặc định: xem nội dung mô tả- Ghi hồ sơ Trình ghi chuyến bay Java trong thời gian thực thi lệnh. Bạn phải cung cấp một trong các loại sự kiện phân tích tài nguyên được hỗ trợ (cpu, wall, alloc hoặc lock) dưới dạng đối số. Hồ sơ được ghi vào một tệp được đặt tên theo loại sự kiện trong thư mục cơ sở đầu ra. Cú pháp và ngữ nghĩa của cờ này có thể thay đổi trong tương lai để hỗ trợ thêm các loại hồ sơ hoặc định dạng đầu ra; bạn tự chịu rủi ro khi sử dụng.
- Giá trị mặc định của
--[no]experimental_docker_verbose
: "false" - Nếu được bật, Bazel sẽ in nhiều thông báo chi tiết hơn về chiến lược hộp cát Docker.
Thẻ:execution
- Giá trị mặc định của
--[no]experimental_materialize_param_files_directly
: "false" - Nếu bạn hiện thực hoá các tệp tham số, hãy thực hiện việc này bằng cách ghi trực tiếp vào ổ đĩa.
Thẻ:execution
- Giá trị mặc định của
--[no]experimental_record_metrics_for_all_mnemonics
: "false" - Theo mặc định, số lượng loại thao tác được giới hạn ở 20 câu thần chú có số lượng thao tác được thực thi nhiều nhất. Việc đặt tuỳ chọn này sẽ ghi số liệu thống kê cho tất cả các câu thần chú.
--experimental_repository_resolved_file=<a string>
mặc định: ""- Nếu không trống, hãy ghi một giá trị Starlark có thông tin đã phân giải của tất cả các quy tắc kho lưu trữ Starlark đã được thực thi.
Thẻ:affects_outputs
- Giá trị mặc định của
--[no]experimental_run_bep_event_include_residue
: "false" -
Liệu có đưa phần dư thừa dòng lệnh vào các sự kiện bản dựng chạy có thể chứa phần dư thừa đó hay không. Theo mặc định, phần dư không được đưa vào các sự kiện bản dựng lệnh chạy có thể chứa phần dư.
Thẻ:affects_outputs
- Giá trị mặc định của
--[no]experimental_stream_log_file_uploads
: "false" -
Tải tệp nhật ký trực tuyến lên bộ nhớ từ xa thay vì ghi vào ổ đĩa.
Thẻ:affects_outputs
--explain=<a path>
mặc định: xem nội dung mô tả-
Khiến hệ thống xây dựng giải thích từng bước thực thi của bản dựng. Nội dung giải thích được ghi vào tệp nhật ký được chỉ định.
Thẻ:affects_outputs
- Giá trị mặc định của
--[no]ignore_unsupported_sandboxing
: "false" -
Không in cảnh báo khi hệ thống này không hỗ trợ tính năng thực thi trong hộp cát.
Thẻ:terminal_output
- Giá trị mặc định của
--[no]legacy_important_outputs
: "true" -
Sử dụng thuộc tính này để ngăn tạo trường important_outputs cũ trong sự kiện TargetComplete. Bạn cần có important_outputs để tích hợp Bazel với ResultStore.
Thẻ:affects_outputs
- Giá trị mặc định của
--[no]materialize_param_files
: "false" -
Ghi các tệp tham số trung gian vào cây đầu ra ngay cả khi sử dụng tính năng thực thi thao tác từ xa. Hữu ích khi gỡ lỗi các thao tác. Điều này được ngụ ý bởi --subcommands và --verbose_failures.
Thẻ:execution
--max_config_changes_to_show=<an integer>
mặc định: "3"-
Khi loại bỏ bộ nhớ đệm phân tích do thay đổi trong các tuỳ chọn bản dựng, hãy hiển thị tối đa số lượng tên tuỳ chọn đã thay đổi. Nếu số được cung cấp là -1, tất cả các tuỳ chọn đã thay đổi sẽ hiển thị.
Thẻ:terminal_output
--max_test_output_bytes=<an integer>
mặc định: "-1"- Chỉ định kích thước tối đa cho mỗi nhật ký kiểm thử có thể được phát ra khi --test_output là "errors" hoặc "all". Hữu ích để tránh làm quá tải đầu ra bằng đầu ra kiểm thử quá ồn. Tiêu đề kiểm thử được đưa vào kích thước nhật ký. Giá trị âm có nghĩa là không có giới hạn. Kết quả là tất cả hoặc không có gì.
Thẻ:test_runner
,terminal_output
,execution
--output_filter=<a valid Java regular expression>
mặc định: xem nội dung mô tả-
Chỉ hiển thị cảnh báo và kết quả hành động cho các quy tắc có tên khớp với biểu thức chính quy đã cung cấp.
Thẻ:affects_outputs
--progress_report_interval=<an integer in 0-3600 range>
mặc định: "0"-
Số giây chờ giữa các báo cáo về công việc vẫn đang chạy. Giá trị mặc định 0 có nghĩa là 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 sẽ được báo cáo mỗi phút một lần. Khi bạn bật --curses, tiến trình sẽ được báo cáo mỗi giây.
Thẻ:affects_outputs
- Giá trị mặc định của
--remote_print_execution_messages=<failure, success or all>
: "failure" -
Chọn thời điểm in thông báo thực thi từ xa. Các giá trị hợp lệ là "failure" (lỗi) để chỉ in khi xảy ra lỗi, "success" (thành công) để chỉ in khi thành công và "all" (tất cả) để luôn in.
Thẻ:terminal_output
- Giá trị mặc định của
--[no]sandbox_debug
: "false" - Bật các tính năng gỡ lỗi cho tính năng hộp cát. Điều này bao gồm hai điều: thứ nhất, nội dung gốc của hộp cát không bị thay đổi sau khi tạo bản dựng; và thứ hai, in thêm thông tin gỡ lỗi khi thực thi. Điều này có thể giúp các nhà phát triển quy tắc Bazel hoặc Starlark khắc phục lỗi gỡ lỗi do thiếu tệp đầu vào, v.v.
Thẻ:terminal_output
--show_result=<an integer>
mặc định: "1"- Hiện kết quả của bản dựng. Đối với mỗi mục tiêu, hãy cho biết mục tiêu đó có được cập nhật hay không và nếu có, hãy liệt kê danh sách các tệp đầu ra đã được tạo. Các tệp được in là các chuỗi thuận tiện để sao chép + dán vào shell, để thực thi các tệp đó.
Tuỳ chọn này yêu cầu một đối số số nguyên, là số lượng mục tiêu ngưỡng mà nếu vượt quá thì thông tin kết quả sẽ không được in. Do đó, giá trị 0 sẽ khiến thông báo bị chặn và MAX_INT sẽ luôn in kết quả. Giá trị mặc định là 1.
Nếu không có mục tiêu nào được tạo, thì kết quả của mục tiêu đó có thể bị bỏ qua để giữ cho đầu ra nằm dưới ngưỡng.
Thẻ:affects_outputs
--[no]subcommands
[-s
] mặc định: "false"- Hiển thị các lệnh con được thực thi trong quá trình tạo bản dựng. Cờ liên quan: --execution_log_json_file, --execution_log_binary_file (để ghi nhật ký các lệnh con vào một tệp ở định dạng thân thiện với công cụ).
Thẻ:terminal_output
- Giá trị mặc định của
--test_output=<summary, errors, all or streamed>
: "summary" -
Chỉ định chế độ đầu ra mong muốn. Các giá trị hợp lệ là "summary" (tóm tắt) để chỉ xuất ra bản tóm tắt trạng thái kiểm thử, "errors" (lỗi) để cũng in nhật ký kiểm thử cho các kiểm thử không thành công, "all" (tất cả) để in nhật ký cho tất cả các kiểm thử và "streamed" (truyền trực tuyến) để xuất nhật ký cho tất cả các kiểm thử theo thời gian thực (điều này sẽ buộc các kiểm thử được thực thi cục bộ từng kiểm thử một bất kể giá trị --test_strategy).
Thẻ:test_runner
,terminal_output
,execution
--test_summary=<short, terse, detailed, none or testcase>
mặc định: "short"- Chỉ định định dạng mong muốn của bản tóm tắt kiểm thử. Các giá trị hợp lệ là "short" (ngắn) để chỉ in thông tin về các chương trình kiểm thử đã thực thi, "terse" (gọn) để chỉ in thông tin về các chương trình kiểm thử không thành công đã chạy, "detailed" (chi tiết) để in thông tin chi tiết về các trường hợp kiểm thử không thành công, "testcase" (trường hợp kiểm thử) để in bản tóm tắt trong độ phân giải trường hợp kiểm thử, không in thông tin chi tiết về các trường hợp kiểm thử không thành công và "none" (không có) để bỏ qua bản tóm tắt.
Thẻ:terminal_output
- Giá trị mặc định của
--[no]verbose_explanations
: "false" -
Tăng độ chi tiết của nội dung giải thích được đưa ra nếu bạn bật tuỳ chọn --explain. Không có hiệu lực nếu bạn không bật --explain.
Thẻ:affects_outputs
- Giá trị mặc định của
--[no]verbose_failures
: "false" - Nếu một lệnh không thành công, hãy in toàn bộ dòng lệnh.
Thẻ:terminal_output
- Các tuỳ chọn chỉ định hoặc thay đổi dữ liệu đầu vào chung cho một lệnh Bazel không thuộc các danh mục khác.:
--aspects_parameters=<a 'name=value' assignment>
nhiều lần sử dụng được tích luỹ-
Chỉ định giá trị của các tham số khía cạnh dòng lệnh. Mỗi giá trị tham số được chỉ định thông qua <param_name>=<param_value>, ví dụ: "my_param=my_val", trong đó "my_param" là một tham số của một số khía cạnh trong danh sách --aspects hoặc bắt buộc đối với một khía cạnh trong danh sách. Bạn có thể sử dụng tuỳ chọn này nhiều lần. Tuy nhiên, bạn không được chỉ định giá trị cho cùng một tham số nhiều lần.
Thẻ:loading_and_analysis
--experimental_resolved_file_instead_of_workspace=<a string>
mặc định: ""- Nếu không trống, hãy đọc tệp đã phân giải được chỉ định thay vì tệp WORKSPACE Thẻ
:changes_inputs
--target_pattern_file=<a string>
mặc định: ""- Nếu được đặt, bản dựng sẽ đọc các mẫu từ tệp được đặt tên tại đây, thay vì trên dòng lệnh. Bạn sẽ gặp lỗi nếu chỉ định tệp tại đây cũng như các mẫu dòng lệnh.
Thẻ:changes_inputs
- Các tuỳ chọn thực thi và lưu vào bộ nhớ đệm từ xa:
--experimental_circuit_breaker_strategy=<failure>
mặc định: xem nội dung mô tả- Chỉ định chiến lược để cầu dao sử dụng. Các chiến lược có thể sử dụng là "không thành công". Đối với giá trị không hợp lệ cho tuỳ chọn, hành vi giống như tuỳ chọn sẽ không được đặt.
Thẻ:execution
--experimental_downloader_config=<a string>
mặc định: xem nội dung mô tả- Chỉ định một tệp để định cấu hình trình tải xuống từ xa. Tệp này bao gồm các dòng, mỗi dòng bắt đầu bằng một lệnh (`allow`, `block` hoặc `rewrite`), theo sau là tên máy chủ lưu trữ (đối với lệnh `allow` và `block`) hoặc hai mẫu, một mẫu để so khớp và một mẫu để sử dụng làm URL thay thế, với các tệp tham chiếu ngược bắt đầu từ `$1`. Bạn có thể cung cấp nhiều lệnh `rewrite` cho cùng một URL và trong trường hợp này, nhiều URL sẽ được trả về.
- Giá trị mặc định của
--[no]experimental_guard_against_concurrent_changes
: "false" - Tắt tuỳ chọn này để tắt tính năng kiểm tra ctime của tệp đầu vào của một thao tác trước khi tải tệp đó lên bộ nhớ đệm từ xa. Có thể xảy ra trường hợp nhân Linux trì hoãn việc ghi tệp, điều này có thể gây ra kết quả dương tính giả.
- Giá trị mặc định của
--[no]experimental_remote_cache_async
: "false" - Nếu đúng, I/O bộ nhớ đệm từ xa sẽ diễn ra ở chế độ nền thay vì diễn ra trong quá trình tạo.
--experimental_remote_cache_compression_threshold=<an integer>
mặc định: "0"- Kích thước blob tối thiểu cần thiết để nén/giải nén bằng zstd. Không có hiệu lực trừ khi bạn đặt --remote_cache_compression.
--experimental_remote_cache_eviction_retries=<an integer>
mặc định: "0"- Số lần thử lại tối đa nếu bản dựng gặp lỗi tạm thời về bộ nhớ đệm từ xa khiến bản dựng không thành công. Ví dụ: áp dụng khi các cấu phần phần mềm bị xoá khỏi bộ nhớ đệm từ xa hoặc trong một số điều kiện lỗi bộ nhớ đệm nhất định. Giá trị khác 0 sẽ ngầm đặt --incompatible_remote_use_new_exit_code_for_lost_inputs thành true. Hệ thống sẽ tạo một mã gọi mới cho mỗi lần thử. Nếu tạo mã gọi và cung cấp mã gọi đó cho Bazel bằng --invocation_id, bạn không nên sử dụng cờ này. Thay vào đó, hãy đặt cờ --incompatible_remote_use_new_exit_code_for_lost_inputs và kiểm tra mã thoát 39.
Thẻ:execution
- Giá trị mặc định của
--[no]experimental_remote_cache_lease_extension
: "false" - Nếu bạn đặt thành true, Bazel sẽ gia hạn thời gian thuê cho các đầu ra của các thao tác từ xa trong quá trình xây dựng bằng cách gửi định kỳ các lệnh gọi "FindMissingBlobs" đến bộ nhớ đệm từ xa. Tần suất dựa trên giá trị của `--experimental_remote_cache_ttl`.
--experimental_remote_cache_ttl=<An immutable length of time.>
mặc định: "3h"-
TTL tối thiểu được đảm bảo của các blob trong bộ nhớ đệm từ xa sau khi các chuỗi đại diện của chúng được tham chiếu gần đây, ví dụ: bằng ActionResult hoặc FindMissingBlobs. Bazel thực hiện một số hoạt động tối ưu hoá dựa trên TTL của các blob, ví dụ: không gọi lại GetActionResult trong một bản dựng gia tăng. Bạn nên đặt giá trị này thấp hơn một chút so với TTL thực tế vì có một khoảng thời gian giữa thời điểm máy chủ trả về chuỗi đại diện và thời điểm Bazel nhận được chuỗi đại diện đó.
Thẻ:execution
--experimental_remote_capture_corrupted_outputs=<a path>
mặc định: xem nội dung mô tả- Đường dẫn đến thư mục nơi các đầu ra bị hỏng sẽ được lưu vào.
- Giá trị mặc định của
--[no]experimental_remote_discard_merkle_trees
: "false" - Nếu được đặt thành true, hãy loại bỏ các bản sao trong bộ nhớ của cây Merkle của gốc đầu vào và các ánh xạ đầu vào liên quan trong các lệnh gọi đến GetActionResult() và Execute(). Điều này làm giảm đáng kể mức sử dụng bộ nhớ, nhưng yêu cầu Bazel tính toán lại các bản sao đó khi không tìm thấy bộ nhớ đệm từ xa và thử lại.
--experimental_remote_downloader=<a string>
mặc định: xem nội dung mô tả- URI điểm cuối của API thành phần từ xa, dùng làm proxy tải xuống từ xa. Các giản đồ được hỗ trợ là grpc, grpcs (grpc đã bật TLS) và unix (ổ cắm UNIX cục bộ). Nếu bạn không cung cấp giản đồ, Bazel sẽ mặc định sử dụng grpcs. Xem: https://github.com/bazelbuild/remote-apis/blob/master/build/bazel/remote/asset/v1/remote_asset.proto
- Giá trị mặc định của
--[no]experimental_remote_downloader_local_fallback
: "false" - Liệu có quay lại trình tải xuống cục bộ nếu trình tải xuống từ xa không thành công hay không.
- Giá trị mặc định của
--[no]experimental_remote_execution_keepalive
: "false" - Liệu có nên sử dụng tính năng duy trì kết nối cho các lệnh gọi thực thi từ xa hay không.
--experimental_remote_failure_rate_threshold=<an integer in 0-100 range>
mặc định: "10"-
Đặt số tỷ lệ lỗi được phép theo tỷ lệ phần trăm cho một khoảng thời gian cụ thể, sau đó sẽ ngừng gọi đến bộ nhớ đệm/trình thực thi từ xa. Theo mặc định, giá trị này là 10. Việc đặt giá trị này thành 0 có nghĩa là không có giới hạn.
Thẻ:execution
--experimental_remote_failure_window_interval=<An immutable length of time.>
mặc định: "60 giây"- Khoảng thời gian tính tỷ lệ lỗi của các yêu cầu từ xa. Đối với giá trị bằng 0 hoặc giá trị âm, thời lượng lỗi được tính là toàn bộ thời lượng thực thi.Bạn có thể sử dụng các đơn vị sau: Ngày (d), giờ (h), phút (m), giây (s) và mili giây (ms). Nếu bạn bỏ qua đơn vị, giá trị này sẽ được hiểu là giây.
Thẻ:execution
- Giá trị mặc định của
--[no]experimental_remote_mark_tool_inputs
: "false" - Nếu bạn đặt thành true, Bazel sẽ đánh dấu dữ liệu đầu vào là dữ liệu đầu vào của công cụ cho trình thực thi từ xa. Bạn có thể dùng tính năng này để triển khai worker liên tục từ xa.
- Giá trị mặc định của
--[no]experimental_remote_merkle_tree_cache
: "false" - Nếu bạn đặt thành true, các phép tính trên cây Merkle sẽ được lưu vào bộ nhớ đệm để cải thiện tốc độ kiểm tra lượt truy cập vào bộ nhớ đệm từ xa. Mức sử dụng bộ nhớ của bộ nhớ đệm được kiểm soát bằng --experimental_remote_merkle_tree_cache_size.
--experimental_remote_merkle_tree_cache_size=<a long integer>
mặc định: "1000"- Số lượng cây Merkle cần lưu vào bộ nhớ đệm để cải thiện tốc độ kiểm tra lượt truy cập vào bộ nhớ đệm từ xa. Mặc dù bộ nhớ đệm được tự động cắt bớt theo cách xử lý tham chiếu mềm của Java, nhưng lỗi hết bộ nhớ có thể xảy ra nếu bạn đặt quá cao. Nếu bạn đặt thành 0, kích thước bộ nhớ đệm sẽ không giới hạn. Giá trị tối ưu thay đổi tuỳ thuộc vào kích thước của dự án. Giá trị mặc định là 1000.
--experimental_remote_output_service=<a string>
mặc định: xem nội dung mô tả- HOST hoặc HOST:PORT của điểm cuối dịch vụ đầu ra từ xa. Các giản đồ được hỗ trợ là grpc, grpcs (grpc đã bật TLS) và unix (ổ cắm UNIX cục bộ). Nếu bạn không cung cấp giản đồ, Bazel sẽ mặc định sử dụng grpcs. Chỉ định giản đồ grpc:// hoặc unix: để tắt TLS.
--experimental_remote_output_service_output_path_prefix=<a string>
mặc định: ""- Đường dẫn chứa nội dung của các thư mục đầu ra do --experimental_remote_output_service quản lý. Thư mục đầu ra thực tế mà bản dựng sử dụng sẽ là thư mục con của đường dẫn này và do dịch vụ đầu ra xác định.
- Giá trị mặc định của
--[no]experimental_remote_require_cached
: "false" - Nếu bạn đặt thành đúng, hãy thực thi việc lưu tất cả các thao tác có thể chạy từ xa vào bộ nhớ đệm, nếu không bản dựng sẽ không thành công. Điều này hữu ích để khắc phục các vấn đề không xác định vì cho phép kiểm tra xem các hành động cần được lưu vào bộ nhớ đệm có thực sự được lưu vào bộ nhớ đệm hay không mà không cần chèn kết quả mới vào bộ nhớ đệm một cách ngẫu nhiên.
--experimental_remote_scrubbing_config=<Converts to a Scrubber>
mặc định: xem nội dung mô tả- Bật tính năng xoá khoá bộ nhớ đệm từ xa bằng tệp cấu hình được cung cấp, tệp này phải là vùng đệm giao thức ở định dạng văn bản (xem src/main/protobuf/remote_scrubbing.proto). Tính năng này nhằm hỗ trợ việc chia sẻ bộ nhớ đệm từ xa/bộ nhớ đệm trên ổ đĩa giữa các thao tác thực thi trên nhiều nền tảng nhưng nhắm đến cùng một nền tảng. Bạn nên sử dụng tính năng này một cách thận trọng vì các chế độ cài đặt không phù hợp có thể khiến các mục nhập bộ nhớ đệm bị vô tình chia sẻ và dẫn đến các bản dựng không chính xác. Việc xoá không ảnh hưởng đến cách thực thi một hành động, mà chỉ ảnh hưởng đến cách tính toán khoá bộ nhớ đệm từ xa/đĩa của hành động đó cho mục đích truy xuất hoặc lưu trữ kết quả của hành động. Các thao tác đã xoá không tương thích với việc thực thi từ xa và sẽ luôn được thực thi cục bộ. Việc sửa đổi cấu hình xoá sẽ không làm mất hiệu lực các đầu ra có trong hệ thống tệp cục bộ hoặc bộ nhớ đệm nội bộ; bạn cần có một bản dựng sạch để thực thi lại các hành động bị ảnh hưởng. Để sử dụng thành công tính năng này, bạn nên đặt --host_platform tuỳ chỉnh cùng với --experimental_platform_in_output_dir (để chuẩn hoá tiền tố đầu ra) và --incompatible_strict_action_env (để chuẩn hoá các biến môi trường).
- Giá trị mặc định của
--experimental_worker_for_repo_fetching=<off, platform, virtual or auto>
: "tự động" - Chế độ tạo luồng để tìm nạp kho lưu trữ. Nếu bạn đặt thành "tắt", thì không có luồng worker nào được sử dụng và quá trình tìm nạp kho lưu trữ sẽ phải khởi động lại. Nếu không, hãy sử dụng luồng worker ảo.
- Giá trị mặc định của
--[no]incompatible_remote_build_event_upload_respect_no_cache
: "false" - Không dùng nữa. Không hoạt động. Thay vào đó, hãy sử dụng --remote_build_event_upload=minimal.
- Giá trị mặc định của
--[no]incompatible_remote_downloader_send_all_headers
: "true" -
Liệu có gửi tất cả giá trị của tiêu đề nhiều giá trị đến trình tải xuống từ xa thay vì chỉ giá trị đầu tiên hay không.
Thẻ:incompatible_change
- Giá trị mặc định của
--[no]incompatible_remote_output_paths_relative_to_input_root
: "false" - Nếu bạn đặt thành true, đường dẫn đầu ra sẽ tương ứng với thư mục gốc đầu vào thay vì thư mục đang hoạt động.
Thẻ:incompatible_change
- Giá trị mặc định của
--[no]incompatible_remote_results_ignore_disk
: "true" - Thẻ
không hoạt động:incompatible_change
- Giá trị mặc định của
--[no]incompatible_remote_use_new_exit_code_for_lost_inputs
: "true" - Nếu được đặt thành true, Bazel sẽ sử dụng mã thoát mới 39 thay vì 34 nếu lỗi bộ nhớ đệm từ xa (bao gồm cả việc xoá bộ nhớ đệm) khiến bản dựng không thành công.
Thẻ:incompatible_change
- Giá trị mặc định của
--[no]remote_accept_cached
: "true" - Liệu có chấp nhận kết quả hành động được lưu vào bộ nhớ đệm từ xa hay không.
--remote_build_event_upload=<all or minimal>
mặc định: "minimal"- Nếu được đặt thành "tất cả", tất cả đầu ra cục bộ mà BEP tham chiếu sẽ được tải lên bộ nhớ đệm từ xa. Nếu bạn đặt thành "minimal" (tối thiểu), thì các đầu ra cục bộ mà BEP tham chiếu sẽ không được tải lên bộ nhớ đệm từ xa, ngoại trừ các tệp quan trọng đối với người dùng BEP (ví dụ: nhật ký kiểm thử và hồ sơ thời gian). Lược đồ bytestream:// luôn được dùng cho uri của các tệp ngay cả khi các tệp đó bị thiếu trong bộ nhớ đệm từ xa. Giá trị mặc định là "minimal" (tối thiểu).
--remote_bytestream_uri_prefix=<a string>
mặc định: xem nội dung mô tả- Tên máy chủ và tên thực thể sẽ được sử dụng trong các URI bytestream:// được ghi vào luồng sự kiện bản dựng. Bạn có thể đặt tuỳ chọn này khi các bản dựng được thực hiện bằng proxy, khiến các giá trị của --remote_executor và --remote_instance_name không còn tương ứng với tên chuẩn của dịch vụ thực thi từ xa. Nếu không được đặt, giá trị này sẽ mặc định là "${hostname}/${instance_name}".
--remote_cache=<a string>
mặc định: xem nội dung mô tả- URI của điểm cuối lưu vào bộ nhớ đệm. Các giản đồ được hỗ trợ là http, https, grpc, grpcs (grpc đã bật TLS) và unix (ổ cắm UNIX cục bộ). Nếu bạn không cung cấp giản đồ, Bazel sẽ mặc định sử dụng grpcs. Chỉ định giao thức grpc://, http:// hoặc unix: để tắt TLS. Xem https://bazel.build/remote/caching
- Giá trị mặc định của
--[no]remote_cache_compression
: "false" - Nếu được bật, hãy nén/giải nén các blob bộ nhớ đệm bằng zstd khi kích thước của các blob đó ít nhất là --experimental_remote_cache_compression_threshold.
--remote_cache_header=<a 'name=value' assignment>
nhiều lần sử dụng được tích luỹ- Chỉ định một tiêu đề sẽ có trong các yêu cầu bộ nhớ đệm: --remote_cache_header=Name=Value. Bạn có thể truyền nhiều tiêu đề bằng cách chỉ định cờ nhiều lần. Nhiều giá trị cho cùng một tên sẽ được chuyển đổi thành danh sách được phân tách bằng dấu phẩy.
--remote_default_exec_properties=<a 'name=value' assignment>
nhiều lần sử dụng được tích luỹ- Đặt các thuộc tính exec mặc định để dùng làm nền tảng thực thi từ xa nếu nền tảng thực thi chưa đặt exec_properties.
Thẻ:affects_outputs
--remote_default_platform_properties=<a string>
mặc định: ""- Đặt các thuộc tính nền tảng mặc định để đặt cho API thực thi từ xa, nếu nền tảng thực thi chưa đặt remote_execution_properties. Giá trị này cũng sẽ được dùng nếu nền tảng lưu trữ được chọn làm nền tảng thực thi để thực thi từ xa.
--remote_download_regex=<a valid Java regular expression>
nhiều lần sử dụng được tích luỹ- Buộc tải các đầu ra bản dựng từ xa có đường dẫn khớp với mẫu này, bất kể --remote_download_outputs. Bạn có thể chỉ định nhiều mẫu bằng cách lặp lại cờ này.
Thẻ:affects_outputs
--remote_downloader_header=<a 'name=value' assignment>
nhiều lần sử dụng được tích luỹ- Chỉ định một tiêu đề sẽ có trong các yêu cầu trình tải xuống từ xa: --remote_downloader_header=Name=Value. Bạn có thể truyền nhiều tiêu đề bằng cách chỉ định cờ nhiều lần. Nhiều giá trị cho cùng một tên sẽ được chuyển đổi thành danh sách được phân tách bằng dấu phẩy.
--remote_exec_header=<a 'name=value' assignment>
nhiều lần sử dụng được tích luỹ- Chỉ định một tiêu đề sẽ có trong các yêu cầu thực thi: --remote_exec_header=Name=Value. Bạn có thể truyền nhiều tiêu đề bằng cách chỉ định cờ nhiều lần. Nhiều giá trị cho cùng một tên sẽ được chuyển đổi thành danh sách được phân tách bằng dấu phẩy.
--remote_execution_priority=<an integer>
mặc định: "0"- Mức độ ưu tiên tương đối của các hành động sẽ được thực thi từ xa. Ngữ nghĩa của các giá trị ưu tiên cụ thể phụ thuộc vào máy chủ.
--remote_executor=<a string>
mặc định: xem nội dung mô tả- HOST hoặc HOST:PORT của một điểm cuối thực thi từ xa. Các giản đồ được hỗ trợ là grpc, grpcs (grpc đã bật TLS) và unix (ổ cắm UNIX cục bộ). Nếu bạn không cung cấp giản đồ, Bazel sẽ mặc định sử dụng grpcs. Chỉ định giản đồ grpc:// hoặc unix: để tắt TLS.
--remote_grpc_log=<a path>
mặc định: xem nội dung mô tả- Nếu được chỉ định, đường dẫn đến tệp để ghi lại thông tin chi tiết liên quan đến lệnh gọi gRPC. Nhật ký này bao gồm một chuỗi các protobuf com.google.devtools.build.lib.remote.logging.RemoteExecutionLog.LogEntry đã chuyển đổi tuần tự, trong đó mỗi thông báo có tiền tố là một varint biểu thị kích thước của thông báo protobuf đã chuyển đổi tuần tự sau, như được thực hiện bằng phương thức LogEntry.writeDelimitedTo(OutputStream).
--remote_header=<a 'name=value' assignment>
nhiều lần sử dụng được tích luỹ- Chỉ định một tiêu đề sẽ được đưa vào các yêu cầu: --remote_header=Name=Value. Bạn có thể truyền nhiều tiêu đề bằng cách chỉ định cờ nhiều lần. Nhiều giá trị cho cùng một tên sẽ được chuyển đổi thành danh sách được phân tách bằng dấu phẩy.
--remote_instance_name=<a string>
mặc định: ""- Giá trị cần truyền dưới dạng instance_name trong API thực thi từ xa.
- Giá trị mặc định của
--[no]remote_local_fallback
: "false" - Liệu có quay lại chiến lược thực thi cục bộ độc lập nếu thực thi từ xa không thành công hay không.
--remote_local_fallback_strategy=<a string>
mặc định: "local"- Không hoạt động, không dùng nữa. Hãy xem https://github.com/bazelbuild/bazel/issues/7480 để biết thông tin chi tiết.
- Giá trị mặc định của
--remote_max_connections=<an integer>
: "100" - Giới hạn số lượng kết nối đồng thời tối đa đến bộ nhớ đệm/trình thực thi từ xa. Theo mặc định, giá trị này là 100. Việc đặt giá trị này thành 0 có nghĩa là không có giới hạn.
Đối với bộ nhớ đệm từ xa HTTP, một kết nối TCP có thể xử lý một yêu cầu tại một thời điểm, vì vậy, Bazel có thể tạo tối đa --remote_max_connections yêu cầu đồng thời.
Đối với bộ nhớ đệm/trình thực thi từ xa gRPC, một kênh gRPC thường có thể xử lý hơn 100 yêu cầu đồng thời, vì vậy, Bazel có thể tạo khoảng `--remote_max_connections * 100` yêu cầu đồng thời.
Thẻ:host_machine_resource_optimizations
--remote_proxy=<a string>
mặc định: xem nội dung mô tả- Kết nối với bộ nhớ đệm từ xa thông qua proxy. Hiện tại, bạn chỉ có thể dùng cờ này để định cấu hình ổ cắm miền Unix (unix:/path/to/socket).
--remote_result_cache_priority=<an integer>
mặc định: "0"- Mức độ ưu tiên tương đối của các thao tác từ xa sẽ được lưu trữ trong bộ nhớ đệm từ xa. Ngữ nghĩa của các giá trị ưu tiên cụ thể phụ thuộc vào máy chủ.
--remote_retries=<an integer>
mặc định: "5"- Số lần thử tối đa để thử lại một lỗi tạm thời. Nếu bạn đặt thành 0, thì tính năng thử lại sẽ bị tắt.
--remote_retry_max_delay=<An immutable length of time.>
mặc định: "5 giây"- Độ trễ thời gian đợi tối đa giữa các lần thử lại từ xa. Bạn có thể sử dụng các đơn vị sau: Ngày (d), giờ (h), phút (m), giây (s) và mili giây (ms). Nếu bạn bỏ qua đơn vị, giá trị này sẽ được hiểu là giây.
--remote_timeout=<An immutable length of time.>
mặc định: "60 giây"- Thời gian tối đa để chờ thực thi từ xa và các lệnh gọi bộ nhớ đệm. Đối với bộ nhớ đệm REST, đây là cả thời gian chờ kết nối và thời gian chờ đọc. Bạn có thể sử dụng các đơn vị sau: Ngày (d), giờ (h), phút (m), giây (s) và mili giây (ms). Nếu bạn bỏ qua đơn vị, giá trị này sẽ được hiểu là giây.
- Giá trị mặc định của
--[no]remote_upload_local_results
: "true" - Liệu có tải kết quả hành động được thực thi cục bộ lên bộ nhớ đệm từ xa hay không nếu bộ nhớ đệm từ xa hỗ trợ và người dùng được phép thực hiện việc này.
- Giá trị mặc định của
--[no]remote_verify_downloads
: "true" - Nếu được đặt thành true, Bazel sẽ tính tổng hàm băm của tất cả tệp tải xuống từ xa và loại bỏ các giá trị được lưu vào bộ nhớ đệm từ xa nếu các giá trị đó không khớp với giá trị dự kiến.
- Các tuỳ chọn khác, không được phân loại theo cách khác.:
- Giá trị mặc định của
--[no]allow_analysis_cache_discard
: "true" - Nếu loại bỏ bộ nhớ đệm phân tích do có thay đổi trong hệ thống xây dựng, thì việc đặt tuỳ chọn này thành false sẽ khiến bazel thoát, thay vì tiếp tục bản dựng. Tuỳ chọn này không có hiệu lực khi bạn cũng đặt "discard_analysis_cache".
Thẻ:eagerness_to_exit
--auto_output_filter=<none, all, packages or subpackages>
mặc định: "none"- Nếu bạn không chỉ định --output_filter, thì giá trị cho tuỳ chọn này sẽ được dùng để tự động tạo bộ lọc. Các giá trị được phép là "none" (không lọc gì / hiển thị mọi thứ), "all" (lọc mọi thứ / không hiển thị gì), "packages" (bao gồm kết quả từ các quy tắc trong các gói được đề cập trên dòng lệnh Blaze) và "subpackages" (tương tự như "packages", nhưng cũng bao gồm các gói con). Đối với các giá trị "gói" và "gói con", //java/foo và //javatests/foo được coi là một gói).
- Giá trị mặc định của
--[no]build_manual_tests
: "false" - Buộc tạo các mục tiêu kiểm thử được gắn thẻ "thủ công". Các kiểm thử "thủ công" sẽ không được xử lý. Tuỳ chọn này buộc các lớp này phải được tạo (nhưng không được thực thi).
--build_tag_filters=<comma-separated list of options>
mặc định: ""- Chỉ định danh sách thẻ được phân tách bằng dấu phẩy. Bạn có thể thêm dấu "-" vào đầu mỗi thẻ để chỉ định các thẻ bị loại trừ. Chỉ những mục tiêu chứa ít nhất một thẻ được đưa vào và không chứa thẻ nào bị loại trừ mới được tạo. Tuỳ chọn này không ảnh hưởng đến tập hợp các chương trình kiểm thử được thực thi bằng lệnh "test"; các chương trình kiểm thử đó được điều chỉnh theo các tuỳ chọn lọc kiểm thử, ví dụ: "--test_tag_filters"
- Giá trị mặc định của
--[no]build_tests_only
: "false" - Nếu được chỉ định, chỉ các quy tắc *_test và test_suite mới được tạo và các mục tiêu khác được chỉ định trên dòng lệnh sẽ bị bỏ qua. Theo mặc định, mọi nội dung được yêu cầu sẽ được tạo.
--combined_report=<none or lcov>
mặc định: "none"- Chỉ định loại báo cáo mức độ bao phủ tích luỹ mong muốn. Hiện tại, chúng tôi chỉ hỗ trợ LCOV.
- Giá trị mặc định của
--[no]compile_one_dependency
: "false" - Biên dịch một phần phụ thuộc của tệp đối số. Điều này rất hữu ích khi kiểm tra cú pháp của 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 phụ thuộc vào tệp nguồn để phát hiện lỗi sớm nhất có thể trong chu trình 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ả đối số không phải cờ; thay vì là mục tiêu để tạo, đó là tên tệp nguồn. Đối với mỗi tên tệp nguồn, một mục tiêu tuỳ ý phụ thuộc vào tên tệp đó sẽ được tạo.
--deleted_packages=<comma-separated list of package names>
nhiều lần sử dụng được tích luỹ- Danh sách tên gói được phân tách bằng dấu phẩy mà hệ thống xây dựng sẽ coi là không tồn tại, ngay cả khi các gói đó xuất hiện ở đâu đó trên đường dẫn gói. Sử dụng tuỳ chọn này khi xoá một gói con "x/y" của một gói hiện có "x". Ví dụ: sau khi xoá x/y/BUILD trong ứng dụng, hệ thống xây dựng có thể khiếu nại nếu gặp nhãn "//x:y/z" nếu nhãn đó vẫn được cung cấp bởi một mục package_path khác. Bạn có thể chỉ định --deleted_packages x/y để tránh vấn đề này.
- Giá trị mặc định của
--[no]discard_analysis_cache
: "false" - Huỷ bộ nhớ đệm phân tích ngay sau khi giai đoạn phân tích hoàn tất. Giảm mức sử dụng bộ nhớ khoảng 10%, nhưng làm chậm các bản dựng gia tăng hơn nữa.
--disk_cache=<a path>
mặc định: xem nội dung mô tả- Đường dẫn đến thư mục mà Bazel có thể đọc và ghi các hành động cũng như kết quả hành động. Nếu thư mục không tồn tại, thư mục đó sẽ được tạo.
--embed_label=<a one-line string>
mặc định: ""- Nhúng bản sửa đổi hoặc nhãn phát hành của hệ thống kiểm soát nguồn vào tệp nhị phân
--execution_log_binary_file=<a path>
mặc định: xem nội dung mô tả- Ghi lại các lần tạo được thực thi vào tệp này dưới dạng các proto SpawnExec được phân tách theo độ dài, theo src/main/protobuf/spawn.proto. Ưu tiên --execution_log_compact_file, tệp này nhỏ hơn và rẻ hơn đáng kể. Cờ liên quan: --execution_log_compact_file (định dạng thu gọn; loại trừ lẫn nhau), --execution_log_json_file (định dạng JSON văn bản; loại trừ lẫn nhau), --execution_log_sort (có sắp xếp nhật ký thực thi hay không), --subcommands (để hiển thị các lệnh con trong đầu ra của thiết bị đầu cuối).
--execution_log_compact_file=<a path>
mặc định: xem nội dung mô tả- Ghi lại các lần tạo được thực thi vào tệp này dưới dạng các proto ExecLogEntry được phân tách theo độ dài, theo src/main/protobuf/spawn.proto. Toàn bộ tệp được nén bằng thuật toán zstd. Cờ liên quan: --execution_log_binary_file (định dạng protobuf nhị phân; loại trừ lẫn nhau), --execution_log_json_file (định dạng JSON văn bản; loại trừ lẫn nhau), --subcommands (để hiển thị các lệnh con trong đầu ra của thiết bị đầu cuối).
--execution_log_json_file=<a path>
mặc định: xem nội dung mô tả- Ghi lại các lần tạo được thực thi vào tệp này dưới dạng bản trình bày JSON phân tách dòng mới của các nguyên mẫu SpawnExec, theo src/main/protobuf/spawn.proto. Ưu tiên --execution_log_compact_file, tệp này nhỏ hơn và rẻ hơn đáng kể. Cờ liên quan: --execution_log_compact_file (định dạng thu gọn; loại trừ lẫn nhau), --execution_log_binary_file (định dạng protobuf nhị phân; loại trừ lẫn nhau), --execution_log_sort (có sắp xếp nhật ký thực thi hay không), --subcommands (để hiển thị các lệnh con trong đầu ra của thiết bị đầu cuối).
- Giá trị mặc định của
--[no]execution_log_sort
: "true" - Liệu có sắp xếp nhật ký thực thi hay không, giúp dễ dàng so sánh nhật ký giữa các lệnh gọi. Đặt thành false để tránh việc sử dụng CPU và bộ nhớ có thể đáng kể khi kết thúc lệnh gọi, với chi phí tạo nhật ký theo thứ tự thực thi không xác định. Chỉ áp dụng cho định dạng tệp nhị phân và JSON; định dạng thu gọn không bao giờ được sắp xếp.
- Giá trị mặc định của
--[no]expand_test_suites
: "true" -
Mở rộng các mục tiêu test_suite thành các kiểm thử thành phần trước khi phân tích. Khi cờ này được bật (mặc định), các mẫu mục tiêu âm sẽ áp dụng cho các chương trình kiểm thử thuộc bộ kiểm thử, nếu không thì các mẫu này sẽ không áp dụng. Việc tắt cờ này sẽ hữu ích khi các khía cạnh cấp cao nhất được áp dụng tại dòng lệnh: sau đó, các khía cạnh này có thể phân tích các mục tiêu test_suite.
Thẻ:loading_and_analysis
--experimental_disk_cache_gc_idle_delay=<An immutable length of time.>
mặc định: "5m"- Thời gian mà máy chủ phải ở trạng thái rảnh trước khi quá trình thu gom rác của bộ nhớ đệm trên ổ đĩa diễn ra. Để chỉ định chính sách thu gom rác, hãy đặt --experimental_disk_cache_gc_max_size và/hoặc --experimental_disk_cache_gc_max_age.
--experimental_disk_cache_gc_max_age=<An immutable length of time.>
mặc định: "0"- Nếu bạn đặt thành một giá trị dương, bộ nhớ đệm trên ổ đĩa sẽ được thu thập rác định kỳ để xoá các mục cũ hơn tuổi này. Nếu được đặt cùng với --experimental_disk_cache_gc_max_size, cả hai tiêu chí sẽ được áp dụng. Quá trình thu gom rác diễn ra ở chế độ nền sau khi máy chủ trở nên rảnh, như được xác định bằng cờ --experimental_disk_cache_gc_idle_delay.
--experimental_disk_cache_gc_max_size=<a size in bytes, optionally followed by a K, M, G or T multiplier>
mặc định: "0"- Nếu bạn đặt giá trị dương, bộ nhớ đệm ổ đĩa sẽ được thu thập rác định kỳ để luôn nằm trong kích thước này. Nếu được đặt cùng với --experimental_disk_cache_gc_max_age, cả hai tiêu chí này sẽ được áp dụng. Quá trình thu gom rác diễn ra ở chế độ nền sau khi máy chủ trở nên rảnh, như được xác định bằng cờ --experimental_disk_cache_gc_idle_delay.
--experimental_extra_action_filter=<a comma-separated list of regex expressions with prefix '-' specifying excluded paths>
mặc định: ""- Ngừng sử dụng và thay bằng các khía cạnh. Lọc tập hợp mục tiêu để lên lịch extra_actions.
- Giá trị mặc định của
--[no]experimental_extra_action_top_level_only
: "false" - Ngừng sử dụng và thay bằng các khía cạnh. Chỉ lên lịch extra_actions cho các mục tiêu cấp cao nhất.
--experimental_spawn_scheduler
-
Bật tính năng thực thi động bằng cách chạy song song các thao tác trên máy và từ xa. Bazel tạo ra từng hành động cục bộ và từ xa, đồng thời chọn hành động hoàn tất trước tiên. Nếu một thao tác hỗ trợ worker, thì thao tác cục bộ sẽ chạy ở chế độ worker liên tục. Để bật tính năng thực thi động cho một cụm từ gợi nhắc hành động riêng lẻ, hãy sử dụng cờ `--internal_spawn_scheduler` và `--strategy=<mnemonic>=dynamic`.
Mở rộng thành:
--internal_spawn_scheduler
--spawn_strategy=dynamic
- Giá trị mặc định của
--[no]fetch
: "true" - Cho phép lệnh tìm nạp các phần phụ thuộc bên ngoài. Nếu bạn đặt thành false, lệnh sẽ sử dụng bất kỳ phiên bản nào của phần phụ thuộc được lưu vào bộ nhớ đệm và nếu không có phiên bản nào, lệnh sẽ không thành công.
- Giá trị mặc định của
--[no]incompatible_dont_use_javasourceinfoprovider
: "false" - Thẻ
không hoạt động:incompatible_change
--local_termination_grace_seconds=<an integer>
mặc định: "15"- Thời gian chờ giữa việc chấm dứt một quy trình cục bộ do hết thời gian chờ và buộc tắt quy trình đó.
--override_repository=<an equals-separated mapping of repository name to path>
nhiều lần sử dụng được tích luỹ- Ghi đè kho lưu trữ bằng một đường dẫn cục bộ ở dạng <repository name>=<path>. Nếu đường dẫn đã cho là đường dẫn tuyệt đối, thì đường dẫn đó sẽ được sử dụng nguyên trạng. Nếu đường dẫn đã cho là đường dẫn tương đối, thì đường dẫn đó sẽ tương ứng với thư mục đang hoạt động. Nếu đường dẫn đã cho bắt đầu bằng "%workspace%", thì đường dẫn đó sẽ tương ứng với thư mục gốc của không gian làm việc, là kết quả của lệnh "bazel info workspace". Nếu đường dẫn đã cho trống, hãy xoá mọi chế độ ghi đè trước đó.
--package_path=<colon-separated list of options>
mặc định: "%workspace%"- Danh sách được phân tách bằng dấu hai chấm về nơi tìm kiếm các gói. Các phần tử bắt đầu bằng "%workspace%" có liên quan đến không gian làm việc bao quanh. Nếu bạn bỏ qua hoặc để trống, giá trị mặc định sẽ là kết quả của lệnh "bazel info default-package-path".
- Giá trị mặc định của
--[no]show_loading_progress
: "true" - Nếu được bật, sẽ khiến Bazel in thông báo "Loading package" ("Đang tải gói").
--test_lang_filters=<comma-separated list of options>
mặc định: ""- Chỉ định danh sách ngôn ngữ kiểm thử được phân tách bằng dấu phẩy. Bạn có thể thêm dấu "-" vào đầu mỗi ngôn ngữ để chỉ định các ngôn ngữ bị loại trừ. Chỉ những mục tiêu kiểm thử được viết bằng các ngôn ngữ đã chỉ định mới được tìm thấy. 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ụ: một trong các tên "cc", "java", "py", v.v. Tuỳ chọn này ảnh hưởng đến hành vi --build_tests_only và lệnh kiểm thử.
--test_size_filters=<comma-separated list of values: small, medium, large or enormous>
mặc định: ""- Chỉ định danh sách kích thước kiểm thử được phân tách bằng dấu phẩy. Bạn có thể thêm dấu "-" vào trước mỗi kích thước để chỉ định các kích thước bị loại trừ (không bắt buộc). Chỉ những mục tiêu kiểm thử chứa ít nhất một kích thước được đưa vào và không chứa kích thước nào bị loại trừ mới được tìm thấy. Tuỳ chọn này ảnh hưởng đến hành vi --build_tests_only và lệnh kiểm thử.
--test_tag_filters=<comma-separated list of options>
mặc định: ""- Chỉ định danh sách thẻ kiểm thử được phân tách bằng dấu phẩy. Bạn có thể thêm dấu "-" vào đầu mỗi thẻ để chỉ định các thẻ bị loại trừ. Chỉ những mục tiêu kiểm thử chứa ít nhất một thẻ được đưa vào và không chứa thẻ nào bị loại trừ mới được tìm thấy. Tuỳ chọn này ảnh hưởng đến hành vi --build_tests_only và lệnh kiểm thử.
--test_timeout_filters=<comma-separated list of values: short, moderate, long or eternal>
mặc định: ""- Chỉ định danh sách thời gian chờ kiểm thử được phân tách bằng dấu phẩy. Bạn có thể thêm dấu "-" vào trước mỗi khoảng thời gian chờ để chỉ định các khoảng thời gian chờ bị loại trừ. Chỉ những mục tiêu kiểm thử chứa ít nhất một thời gian chờ được đưa vào và không chứa bất kỳ thời gian chờ nào bị loại trừ mới được tìm thấy. Tuỳ chọn này ảnh hưởng đến hành vi --build_tests_only và lệnh kiểm thử.
--workspace_status_command=<path>
mặc định: ""- Lệnh được gọi ở đầu bản dựng để cung cấp thông tin trạng thái về không gian làm việc ở dạng cặp khoá/giá trị. Hãy xem Hướng dẫn sử dụng để biết thông số kỹ thuật đầy đủ. Ngoài ra, hãy xem tools/buildstamp/get_workspace_status để biết ví dụ.
- Các tuỳ chọn kiểm soát quá trình thực thi bản dựng:
- Giá trị mặc định của
--[no]check_up_to_date
: "false" -
Đừng tạo bản dựng, chỉ cần kiểm tra xem bản dựng đó có được cập nhật hay không. Nếu tất cả các mục tiêu đều được cập nhật, thì bản dựng sẽ hoàn tất thành công. Nếu cần thực thi bất kỳ bước nào, lỗi sẽ được báo cáo và bản dựng sẽ không thành công.
Thẻ:execution
- Giá trị mặc định của
--[no]experimental_inprocess_symlink_creation
: "false" -
Liệu có thực hiện lệnh gọi hệ thống tệp trực tiếp để tạo cây đường liên kết tượng trưng hay không
Thẻ:loading_and_analysis
,execution
,experimental
- Giá trị mặc định của
--[no]experimental_persistent_aar_extractor
: "false" -
Bật trình trích xuất aar liên tục bằng cách sử dụng worker.
Thẻ:execution
- Giá trị mặc định của
--[no]experimental_remotable_source_manifests
: "false" -
Liệu có nên thực hiện các thao tác trong tệp kê khai nguồn từ xa hay không
Thẻ:loading_and_analysis
,execution
,experimental
- Giá trị mặc định của
--[no]experimental_split_coverage_postprocessing
: "false" - Nếu đúng, Bazel sẽ chạy quy trình xử lý sau khi kiểm thử để kiểm thử trong một quá trình tạo mới.
Thẻ:execution
- Giá trị mặc định của
--[no]experimental_split_xml_generation
: "true" - Nếu bạn đặt cờ này và thao tác kiểm thử không tạo tệp test.xml, thì Bazel sẽ sử dụng một thao tác riêng để tạo tệp test.xml giả chứa nhật ký kiểm thử. Nếu không, Bazel sẽ tạo một tệp test.xml trong thao tác kiểm thử.
Thẻ:execution
- Giá trị mặc định của
--[no]experimental_strict_fileset_output
: "false" - Nếu bạn bật tuỳ chọn này, các tập hợp tệp sẽ coi tất cả cấu phần phần mềm đầu ra là tệp thông thường. Các tệp này sẽ không duyệt qua các thư mục hoặc nhạy cảm với các đường liên kết tượng trưng.
Thẻ:execution
- Giá trị mặc định của
--[no]experimental_use_semaphore_for_jobs
: "true" - Nếu bạn đặt thành true, hãy sử dụng thêm semaphore để giới hạn số lượng công việc đồng thời.
Thẻ:host_machine_resource_optimizations
,execution
--genrule_strategy=<comma-separated list of options>
mặc định: ""-
Chỉ định cách thực thi genrules. Cờ này sẽ ngừng hoạt động. Thay vào đó, hãy sử dụng --spawn_strategy=<value> để kiểm soát tất cả các hành động hoặc --strategy=Genrule=<value> để chỉ kiểm soát genrules.
Thẻ:execution
- Giá trị mặc định của
--[no]incompatible_disallow_unsound_directory_outputs
: "true" - Nếu được đặt, thao tác hiện thực hoá tệp đầu ra dưới dạng thư mục sẽ gây ra lỗi. Không ảnh hưởng đến thư mục nguồn. Xem https://github.com/bazelbuild/bazel/issues/18646.
Thẻ:bazel_internal_configuration
,incompatible_change
- Giá trị mặc định của
--[no]incompatible_modify_execution_info_additive
: "false" -
Khi được bật, việc truyền nhiều cờ --modify_execution_info sẽ có tính chất cộng gộp. Khi bị tắt, hệ thống sẽ chỉ xem xét cờ gần đây nhất.
Thẻ:execution
,affects_outputs
,loading_and_analysis
,incompatible_change
--jobs=<an integer, or a keyword ("auto", "HOST_CPUS", "HOST_RAM"), optionally followed by an operation ([-|*]<float>) eg. "auto", "HOST_CPUS*.5">
[-j
] mặc định: "tự động"-
Số lượng công việc đồng thời cần chạy. Nhận một số nguyên hoặc từ khoá ("tự động", "HOST_CPUS", "HOST_RAM"), theo sau có thể là một phép toán ([-|*]<float>) ví dụ: "tự động", "HOST_CPUS*.5". Giá trị phải nằm trong khoảng từ 1 đến 5000. Các giá trị trên 2500 có thể gây ra vấn đề về bộ nhớ. "tự động" tính toán một giá trị mặc định hợp lý dựa trên tài nguyên của máy chủ lưu trữ.
Thẻ:host_machine_resource_optimizations
,execution
--[no]keep_going
[-k
] mặc định: "false"-
Tiếp tục nhiều nhất có thể sau khi xảy ra lỗi. Mặc dù không thể phân tích mục tiêu không thành công và các mục tiêu phụ thuộc vào mục tiêu đó, nhưng bạn có thể phân tích các điều kiện tiên quyết khác của các mục tiêu này.
Thẻ:eagerness_to_exit
- Giá trị mặc định của
--loading_phase_threads=<an integer, or a keyword ("auto", "HOST_CPUS", "HOST_RAM"), optionally followed by an operation ([-|*]<float>) eg. "auto", "HOST_CPUS*.5">
: "tự động" - Số luồng song song cần sử dụng cho giai đoạn tải/phân tích. Nhận một số nguyên hoặc từ khoá ("tự động", "HOST_CPUS", "HOST_RAM"), theo sau có thể là một phép toán ([-|*]<float>) ví dụ: "tự động", "HOST_CPUS*.5". "tự động" đặt giá trị mặc định hợp lý dựa trên tài nguyên của máy chủ lưu trữ. Phải ít nhất là 1.
Thẻ:bazel_internal_configuration
--modify_execution_info=<regex=[+-]key,regex=[+-]key,...>
nhiều lần sử dụng được tích luỹ-
Thêm hoặc xoá các khoá khỏi thông tin thực thi của một hành động dựa trên câu thần chú hành động. Chỉ áp dụng cho các hành động hỗ trợ thông tin thực thi. Nhiều hành động phổ biến hỗ trợ thông tin thực thi, ví dụ: Genrule, CppCompile, Javac, StarlarkAction, TestRunner. Khi chỉ định nhiều giá trị, thứ tự sẽ rất quan trọng vì nhiều biểu thức chính quy có thể áp dụng cho cùng một câu thần chú.
Cú pháp: "regex=[+-]key,regex=[+-]key,...".
Ví dụ: ".*=+x,.*=-y,.*=+z" sẽ thêm "x" và "z" vào, đồng thời xoá "y" khỏi thông tin thực thi cho tất cả các hành động.
"Genrule=+requires-x" sẽ thêm "requires-x" vào thông tin thực thi cho tất cả các hành động Genrule.
"(?!Genrule).*=-requires-x" xoá "requires-x" khỏi thông tin thực thi cho tất cả các hành động không phải Genrule.
Thẻ:execution
,affects_outputs
,loading_and_analysis
--persistent_android_dex_desugar
-
Bật các thao tác dex và đơn giản hoá Android liên tục bằng cách sử dụng worker.
Mở rộng thành:
--internal_persistent_android_dex_desugar
--strategy=Desugar=worker
--strategy=DexBuilder=worker
Thẻ:host_machine_resource_optimizations
,execution
--persistent_android_resource_processor
- Bật trình xử lý tài nguyên Android liên tục bằng cách sử dụng worker.
Mở rộng thành:
--internal_persistent_busybox_tools
--strategy=AaptPackage=worker
--strategy=AndroidResourceParser=worker
--strategy=AndroidResourceValidator=worker
--strategy=AndroidResourceCompiler=worker
--strategy=RClassGenerator=worker
--strategy=AndroidResourceLink=worker
--strategy=AndroidAapt2=worker
--strategy=AndroidAssetMerger=worker
--strategy=AndroidResourceMerger=worker
--strategy=AndroidCompiledResourceMerger=worker
--strategy=ManifestMerger=worker
--strategy=AndroidManifestMerger=worker
--strategy=Aapt2Optimize=worker
--strategy=AARGenerator=worker
--strategy=ProcessDatabinding=worker
--strategy=GenerateDataBindingBaseClasses=worker
Thẻ:host_machine_resource_optimizations
,execution
--persistent_multiplex_android_dex_desugar
-
Bật các thao tác dex và đơn giản hoá Android được đa kênh liên tục bằng cách sử dụng worker.
Mở rộng thành:
--persistent_android_dex_desugar
--internal_persistent_multiplex_android_dex_desugar
Thẻ:host_machine_resource_optimizations
,execution
--persistent_multiplex_android_resource_processor
-
Bật trình xử lý tài nguyên Android được đa kênh liên tục bằng cách sử dụng worker.
Mở rộng thành:
--persistent_android_resource_processor
--modify_execution_info=AaptPackage=+supports-multiplex-workers
--modify_execution_info=AndroidResourceParser=+supports-multiplex-workers
--modify_execution_info=AndroidResourceValidator=+supports-multiplex-workers
--modify_execution_info=AndroidResourceCompiler=+supports-multiplex-workers
--modify_execution_info=RClassGenerator=+supports-multiplex-workers
--modify_execution_info=AndroidResourceLink=+supports-multiplex-workers
--modify_execution_info=AndroidAapt2=+supports-multiplex-workers
--modify_execution_info=AndroidAssetMerger=+supports-multiplex-workers
--modify_execution_info=AndroidResourceMerger=+supports-multiplex-workers
--modify_execution_info=AndroidCompiledResourceMerger=+supports-multiplex-workers
--modify_execution_info=ManifestMerger=+supports-multiplex-workers
--modify_execution_info=AndroidManifestMerger=+supports-multiplex-workers
--modify_execution_info=Aapt2Optimize=+supports-multiplex-workers
--modify_execution_info=AARGenerator=+supports-multiplex-workers
Thẻ:host_machine_resource_optimizations
,execution
--persistent_multiplex_android_tools
- Bật các công cụ Android liên tục và đa kênh (dexing, desugaring, xử lý tài nguyên).
Mở rộng thành:
--internal_persistent_multiplex_busybox_tools
--persistent_multiplex_android_resource_processor
--persistent_multiplex_android_dex_desugar
Thẻ:host_machine_resource_optimizations
,execution
- Giá trị mặc định của
--[no]skip_incompatible_explicit_targets
: "false" -
Bỏ qua các mục tiêu không tương thích được liệt kê rõ ràng trên dòng lệnh. Theo mặc định, việc tạo các mục tiêu như vậy sẽ dẫn đến lỗi nhưng các mục tiêu đó sẽ bị bỏ qua khi bạn bật tuỳ chọn này. Xem: https://bazel.build/extending/platforms#skipping-incompatible-targets
Thẻ:loading_and_analysis
--spawn_strategy=<comma-separated list of options>
mặc định: ""-
Chỉ định cách thực thi các hành động tạo theo mặc định. Chấp nhận danh sách chiến lược được phân tách bằng dấu phẩy theo thứ tự ưu tiên từ cao nhất đến thấp nhất. Đối với mỗi hành động, Bazel sẽ chọn chiến lược có mức độ ưu tiên cao nhất có thể thực thi hành động đó. Giá trị mặc định là "remote,worker,sandboxed,local". Hãy xem https://blog.bazel.build/2019/06/19/list-strategy.html để biết thông tin chi tiết.
Thẻ:execution
--strategy=<a '[name=]value1[,..,valueN]' assignment>
nhiều lần sử dụng được tích luỹ-
Chỉ định cách phân phối quá trình biên dịch của các thao tác tạo khác. Chấp nhận danh sách chiến lược được phân tách bằng dấu phẩy theo thứ tự ưu tiên từ cao nhất đến thấp nhất. Đối với mỗi hành động, Bazel sẽ chọn chiến lược có mức độ ưu tiên cao nhất có thể thực thi hành động đó. Giá trị mặc định là "remote,worker,sandboxed,local". Cờ này ghi đè các giá trị do --spawn_strategy đặt (và --genrule_strategy nếu được sử dụng với Genrule mnemonic). Hãy xem https://blog.bazel.build/2019/06/19/list-strategy.html để biết thông tin chi tiết.
Thẻ:execution
--strategy_regexp=<a '<RegexFilter>=value[,value]' assignment>
nhiều lần sử dụng được tích luỹ- Ghi đè chiến lược tạo nào sẽ được dùng để thực thi các thao tác tạo có nội dung mô tả khớp với một bộ lọc 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ệ thống sẽ sử dụng regex_filter cuối cùng khớp với nội dung mô tả. Tuỳ chọn này 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 bằng chiến lược cục bộ 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 sẽ chạy 'Compiling //foo/bar/baz' bằng chiến lược 'local', nhưng việc đảo ngược thứ tự sẽ chạy chiến lược đó bằng 'sandboxed'.
Thẻ:execution
- Giá trị mặc định của
--[no]use_target_platform_for_tests
: "false" - Nếu đúng, Bazel sẽ sử dụng nền tảng mục tiêu để chạy kiểm thử thay vì nhóm thực thi kiểm thử.
Thẻ:execution
- Các tuỳ chọn định cấu hình chuỗi công cụ dùng để thực thi hành động:
--android_compiler=<a string>
mặc định: xem nội dung mô tả-
Trình biên dịch mục tiêu Android.
Thẻ:affects_outputs
,loading_and_analysis
,loses_incremental_state
--android_crosstool_top=<a build target label>
mặc định: "//external:android/crosstool"-
Vị trí của trình biên dịch C++ dùng cho các bản dựng Android.
Thẻ:affects_outputs
,changes_inputs
,loading_and_analysis
,loses_incremental_state
--android_grte_top=<a label>
mặc định: xem nội dung mô tả-
Mục tiêu Android grte_top.
Thẻ:changes_inputs
,loading_and_analysis
,loses_incremental_state
--android_manifest_merger=<legacy, android or force_android>
mặc định: "android"-
Chọn trình hợp nhất tệp kê khai để sử dụng cho các quy tắc android_binary. Cờ để giúp chuyển đổi sang trình hợp nhất tệp kê khai Android từ trình hợp nhất cũ.
Thẻ:affects_outputs
,loading_and_analysis
,loses_incremental_state
--android_platforms=<a build target label>
mặc định: ""-
Đặt các nền tảng mà mục tiêu android_binary sử dụng. Nếu bạn chỉ định nhiều nền tảng, thì tệp nhị phân sẽ là tệp APK lớn, chứa các tệp nhị phân gốc cho từng nền tảng mục tiêu được chỉ định.
Thẻ:changes_inputs
,loading_and_analysis
,loses_incremental_state
--android_sdk=<a build target label>
mặc định: "@bazel_tools//tools/android:sdk"- Chỉ định SDK/nền tảng Android dùng để tạo ứng dụng Android.
Thẻ:changes_inputs
,loading_and_analysis
,loses_incremental_state
--apple_crosstool_top=<a build target label>
mặc định: "@bazel_tools//tools/cpp:toolchain"-
Nhãn của gói công cụ đa nền tảng sẽ được dùng trong các quy tắc của Apple và Objc cũng như các phần phụ thuộc của các quy tắc đó.
Thẻ:loses_incremental_state
,changes_inputs
--cc_output_directory_tag=<a string>
mặc định: ""- Chỉ định hậu tố cần thêm vào thư mục cấu hình.
Thẻ:affects_outputs
--compiler=<a string>
mặc định: xem nội dung mô tả-
Trình biên dịch C++ dùng để biên dịch mục tiêu.
Thẻ:loading_and_analysis
,execution
--coverage_output_generator=<a build target label>
mặc định: "@bazel_tools//tools/test:lcov_merger"-
Vị trí của tệp nhị phân dùng để xử lý sau các báo cáo phạm vi thô. Hiện tại, đây phải là một nhóm tệp chứa một tệp duy nhất, tệp nhị phân. Giá trị mặc định là "//tools/test:lcov_merger".
Thẻ:changes_inputs
,affects_outputs
,loading_and_analysis
--coverage_report_generator=<a build target label>
mặc định: "@bazel_tools//tools/test:coverage_report_generator"-
Vị trí của tệp nhị phân dùng để tạo báo cáo mức độ sử dụng. Hiện tại, đây phải là một nhóm tệp chứa một tệp duy nhất, tệp nhị phân. Giá trị mặc định là "//tools/test:coverage_report_generator".
Thẻ:changes_inputs
,affects_outputs
,loading_and_analysis
--coverage_support=<a build target label>
mặc định: "@bazel_tools//tools/test:coverage_support"-
Vị trí của các tệp hỗ trợ bắt buộc trên dữ liệu đầu vào của mọi hành động kiểm thử thu thập mức độ sử dụng mã. Giá trị mặc định là "//tools/test:coverage_support".
Thẻ:changes_inputs
,affects_outputs
,loading_and_analysis
--crosstool_top=<a build target label>
mặc định: "@bazel_tools//tools/cpp:toolchain"-
Nhãn của gói công cụ đa nền tảng dùng để biên dịch mã C++.
Thẻ:loading_and_analysis
,changes_inputs
,affects_outputs
--custom_malloc=<a build target label>
mặc định: xem nội dung mô tả-
Chỉ định cách triển khai malloc tuỳ chỉnh. Chế độ cài đặt này sẽ ghi đè các thuộc tính malloc trong quy tắc bản dựng.
Thẻ:changes_inputs
,affects_outputs
--experimental_add_exec_constraints_to_targets=<a '<RegexFilter>=<label1>[,<label2>,...]' assignment>
nhiều lần sử dụng được tích luỹ-
Danh sách biểu thức chính quy được phân tách bằng dấu phẩy, mỗi biểu thức có thể có tiền tố là - (biểu thức phủ định), được gán (=) cho danh sách các mục tiêu giá trị quy tắc ràng buộc được phân tách bằng dấu phẩy. Nếu một mục tiêu không khớp với biểu thức âm và ít nhất một biểu thức dương, thì độ phân giải chuỗi công cụ của mục tiêu đó sẽ được thực hiện như thể mục tiêu đó đã khai báo các giá trị ràng buộc dưới dạng các ràng buộc thực thi. Ví dụ: //demo,-test=@platforms//cpus:x86_64 sẽ thêm "x86_64" vào bất kỳ mục tiêu nào trong //demo, ngoại trừ những mục tiêu có tên chứa "test".
Thẻ:loading_and_analysis
- Giá trị mặc định của
--[no]experimental_include_xcode_execution_requirements
: "false" - Nếu bạn đặt, hãy thêm yêu cầu thực thi "requires-xcode:{version}" vào mọi thao tác Xcode. Nếu phiên bản xcode có nhãn được nối bằng dấu gạch nối, hãy thêm yêu cầu thực thi "requires-xcode-label:{version_label}".
Thẻ:loses_incremental_state
,loading_and_analysis
,execution
- Giá trị mặc định của
--[no]experimental_prefer_mutual_xcode
: "true" - Nếu đúng, hãy sử dụng Xcode mới nhất có sẵn cả cục bộ và từ xa. Nếu giá trị là false hoặc nếu không có phiên bản nào có sẵn, hãy sử dụng phiên bản Xcode cục bộ được chọn thông qua xcode-select.
Thẻ:loses_incremental_state
--extra_execution_platforms=<comma-separated list of options>
mặc định: ""-
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(). Bạn chỉ có thể đặt tuỳ chọn này một lần; các thực thể sau đó sẽ ghi đè các chế độ cài đặt cờ trước đó.
Thẻ:execution
--extra_toolchains=<comma-separated list of options>
nhiều lần sử dụng được tích luỹ-
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 những chuỗi công cụ được khai báo trong tệp WORKSPACE bằng register_toolchains().
Thẻ:affects_outputs
,changes_inputs
,loading_and_analysis
--grte_top=<a label>
mặc định: xem nội dung mô tả-
Nhãn cho thư viện libc đã kiểm tra. Giá trị mặc định được chuỗi công cụ crosstool chọn và bạn hầu như không bao giờ cần ghi đè giá trị này.
Thẻ:action_command_lines
,affects_outputs
--host_compiler=<a string>
mặc định: xem nội dung mô tả-
Trình biên dịch C++ để sử dụng cho quá trình biên dịch máy chủ lưu trữ. Giá trị này sẽ bị bỏ qua nếu bạn không đặt --host_crosstool_top.
Thẻ:loading_and_analysis
,execution
--host_crosstool_top=<a build target label>
mặc định: xem nội dung mô tả- Theo mặc định, các tuỳ chọn --crosstool_top và --compiler cũng được dùng cho cấu hình exec. Nếu bạn cung cấp cờ này, Bazel sẽ sử dụng libc và trình biên dịch mặc định cho crosstool_top đã cho.
Thẻ:loading_and_analysis
,changes_inputs
,affects_outputs
--host_grte_top=<a label>
mặc định: xem nội dung mô tả- Nếu được chỉ định, chế độ cài đặt này sẽ ghi đè thư mục cấp cao nhất libc (--grte_top) cho cấu hình thực thi.
Thẻ:action_command_lines
,affects_outputs
--host_platform=<a build target label>
mặc định: "@bazel_tools//tools:host_platform"-
Nhãn của quy tắc nền tảng mô tả hệ thống lưu trữ.
Thẻ:affects_outputs
,changes_inputs
,loading_and_analysis
- Giá trị mặc định của
--[no]incompatible_dont_enable_host_nonhost_crosstool_features
: "true" - Nếu đúng, Bazel sẽ không bật các tính năng "máy chủ" và "không phải máy chủ" trong chuỗi công cụ c++ (xem https://github.com/bazelbuild/bazel/issues/7407 để biết thêm thông tin).
Thẻ:loading_and_analysis
,incompatible_change
- Giá trị mặc định của
--[no]incompatible_enable_android_toolchain_resolution
: "true" -
Sử dụng độ phân giải chuỗi công cụ để chọn SDK Android cho các quy tắc Android (Starlark và gốc)
Thẻ:loading_and_analysis
,incompatible_change
- Giá trị mặc định của
--[no]incompatible_enable_apple_toolchain_resolution
: "false" -
Sử dụng độ phân giải chuỗi công cụ để chọn SDK Apple cho các quy tắc của Apple (Starlark và gốc)
Thẻ:loading_and_analysis
,incompatible_change
- Giá trị mặc định của
--[no]incompatible_make_thinlto_command_lines_standalone
: "true" - Nếu đúng, Bazel sẽ không sử dụng lại các dòng lệnh thao tác liên kết C++ cho các dòng lệnh lập chỉ mục lto (xem https://github.com/bazelbuild/bazel/issues/6791 để biết thêm thông tin).
Thẻ:loading_and_analysis
,incompatible_change
- Giá trị mặc định của
--[no]incompatible_remove_legacy_whole_archive
: "true" - Nếu đúng, theo mặc định, Bazel sẽ không liên kết các phần phụ thuộc thư viện dưới dạng toàn bộ bản lưu trữ (xem https://github.com/bazelbuild/bazel/issues/7362 để biết hướng dẫn di chuyển).
Thẻ:loading_and_analysis
,incompatible_change
- Giá trị mặc định của
--[no]incompatible_require_ctx_in_configure_features
: "true" - Nếu đúng, Bazel sẽ yêu cầu tham số "ctx" trong cc_common.configure_features (xem https://github.com/bazelbuild/bazel/issues/7793 để biết thêm thông tin).
Thẻ:loading_and_analysis
,incompatible_change
- Sử dụng đối tượng dùng chung giao diện nếu chuỗi công cụ hỗ trợ. Tất cả chuỗi công cụ ELF hiện đều hỗ trợ chế độ cài đặt này.
Thẻ:loading_and_analysis
,affects_outputs
,affects_outputs
--ios_sdk_version=<a dotted version (for example '2.3' or '3.3alpha2.4')>
mặc định: xem nội dung mô tả-
Chỉ định phiên bản SDK iOS để sử dụng nhằm xây dựng ứng dụng iOS. Nếu không chỉ định, hãy sử dụng phiên bản SDK iOS mặc định từ "xcode_version".
Thẻ:loses_incremental_state
--macos_sdk_version=<a dotted version (for example '2.3' or '3.3alpha2.4')>
mặc định: xem nội dung mô tả-
Chỉ định phiên bản SDK macOS để sử dụng nhằm tạo ứng dụng macOS. Nếu không chỉ định, sẽ sử dụng phiên bản SDK macOS mặc định từ "xcode_version".
Thẻ:loses_incremental_state
--minimum_os_version=<a string>
mặc định: xem nội dung mô tả- Phiên bản hệ điều hành tối thiểu mà mục tiêu biên dịch của bạn nhắm đến.
Thẻ:loading_and_analysis
,affects_outputs
--platform_mappings=<a relative path>
mặc định: ""-
Vị trí của tệp ánh xạ mô tả nền tảng nào sẽ sử dụng nếu không có nền tảng nào được đặt hoặc cờ nào sẽ được đặt khi nền tảng đã tồn tại. Phải tương ứng với thư mục gốc của không gian làm việc chính. Mặc định là "platform_mappings" (một tệp nằm ngay trong thư mục gốc của không gian làm việc).
Thẻ:affects_outputs
,changes_inputs
,loading_and_analysis
--platforms=<a build target label>
mặc định: ""-
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.
Thẻ:affects_outputs
,changes_inputs
,loading_and_analysis
--python2_path=<a string>
mặc định: xem nội dung mô tả-
Không dùng nữa, không hoạt động. Tắt bằng `--incompatible_use_python_toolchains`.
Thẻ:no_op
,deprecated
--python3_path=<a string>
mặc định: xem nội dung mô tả-
Không dùng nữa, không hoạt động. Tắt bằng `--incompatible_use_python_toolchains`.
Thẻ:no_op
,deprecated
--python_path=<a string>
mặc định: xem nội dung mô tả-
Đường dẫn tuyệt đối của trình thông dịch Python được gọi để chạy các mục tiêu Python trên nền tảng mục tiêu. Không dùng nữa; bị vô hiệu hoá bằng --incompatible_use_python_toolchains.
Thẻ:loading_and_analysis
,affects_outputs
--python_top=<a build target label>
mặc định: xem nội dung mô tả-
Nhãn của py_runtime đại diện cho trình thông dịch Python được gọi để chạy các mục tiêu Python trên nền tảng mục tiêu. Không dùng nữa; bị vô hiệu hoá bằng --incompatible_use_python_toolchains.
Thẻ:loading_and_analysis
,affects_outputs
--tvos_sdk_version=<a dotted version (for example '2.3' or '3.3alpha2.4')>
mặc định: xem nội dung mô tả-
Chỉ định phiên bản SDK tvOS để sử dụng nhằm xây dựng ứng dụng tvOS. Nếu không chỉ định, hãy sử dụng phiên bản SDK tvOS mặc định từ "xcode_version".
Thẻ:loses_incremental_state
--watchos_sdk_version=<a dotted version (for example '2.3' or '3.3alpha2.4')>
mặc định: xem nội dung mô tả- Chỉ định phiên bản SDK watchOS để sử dụng nhằm xây dựng ứng dụng watchOS. Nếu không chỉ định, hãy sử dụng phiên bản SDK watchOS mặc định từ "xcode_version".
Thẻ:loses_incremental_state
--xcode_version=<a string>
mặc định: xem nội dung mô tả- Nếu được chỉ định, hãy sử dụng Xcode của phiên bản đã cho cho các thao tác bản dựng có liên quan. Nếu không chỉ định, hãy sử dụng phiên bản trình thực thi mặc định của Xcode.
Thẻ:loses_incremental_state
--xcode_version_config=<a build target label>
mặc định: "@bazel_tools//tools/cpp:host_xcodes"-
Nhãn của quy tắc xcode_config dùng để chọn phiên bản Xcode trong cấu hình bản dựng.
Thẻ:loses_incremental_state
,loading_and_analysis
- Các tuỳ chọn kiểm soát đầu ra của lệnh:
- Giá trị mặc định của
--[no]apple_generate_dsym
: "false" -
Liệu có tạo (các) tệp biểu tượng gỡ lỗi (.dSYM) hay không.
Thẻ:affects_outputs
,action_command_lines
- Giá trị mặc định của
--[no]build
: "true" -
Thực thi bản dựng; đây là hành vi thông thường. Việc chỉ định --nobuild sẽ khiến bản dựng dừng trước khi thực thi các thao tác bản dựng, trả về giá trị 0 nếu các giai đoạn tải và phân tích gói hoàn tất thành công; chế độ này hữu ích để kiểm thử các giai đoạn đó.
Thẻ:execution
,affects_outputs
- Giá trị mặc định của
--[no]build_runfile_links
: "true" - Nếu đúng, hãy tạo rừng đường liên kết tượng trưng cho tệp chạy cho tất cả các mục tiêu. Nếu giá trị là false, chỉ ghi các tệp này khi một hành động cục bộ, lệnh kiểm thử hoặc chạy yêu cầu.
Thẻ:affects_outputs
- Giá trị mặc định của
--[no]build_runfile_manifests
: "true" - Nếu đúng, hãy ghi tệp kê khai tệp chạy cho tất cả các mục tiêu. Nếu sai, hãy bỏ qua các giá trị này. Các kiểm thử cục bộ sẽ không chạy được khi giá trị là false.
Thẻ:affects_outputs
- Giá trị mặc định của
--[no]build_test_dwp
: "false" - Nếu được bật, khi tạo các chương trình kiểm thử C++ một cách tĩnh và có tính năng phân tách, tệp .dwp cho tệp nhị phân kiểm thử cũng sẽ được tạo tự động.
Thẻ:loading_and_analysis
,affects_outputs
--cc_proto_library_header_suffixes=<comma-separated set of options>
mặc định: ".pb.h"- Đặt hậu tố của các tệp tiêu đề mà cc_proto_library tạo.
Thẻ:affects_outputs
,loading_and_analysis
--cc_proto_library_source_suffixes=<comma-separated set of options>
mặc định: ".pb.cc"-
Đặt hậu tố của các tệp nguồn mà cc_proto_library tạo.
Thẻ:affects_outputs
,loading_and_analysis
- Giá trị mặc định của
--[no]experimental_proto_descriptor_sets_include_source_info
: "false" -
Chạy các thao tác bổ sung cho các phiên bản API Java thay thế trong proto_library.
Thẻ:affects_outputs
,loading_and_analysis
,experimental
- Giá trị mặc định của
--[no]experimental_proto_extra_actions
: "false" -
Chạy các thao tác bổ sung cho các phiên bản API Java thay thế trong proto_library.
Thẻ:affects_outputs
,loading_and_analysis
,experimental
- Giá trị mặc định của
--[no]experimental_save_feature_state
: "false" -
Lưu trạng thái của các tính năng đã bật và được yêu cầu dưới dạng kết quả biên dịch.
Thẻ:affects_outputs
,experimental
- Giá trị mặc định của
--[no]experimental_use_validation_aspect
: "false" -
Liệu có chạy các thao tác xác thực bằng phương diện (để chạy song song với các kiểm thử) hay không.
Thẻ:execution
,affects_outputs
--fission=<a set of compilation modes>
mặc định: "no"- Chỉ định chế độ biên dịch nào sử dụng tính năng phân hạch cho các bản biên dịch và đường liên kết C++. Có thể là bất kỳ tổ hợp nào của {'fastbuild', 'dbg', 'opt'} hoặc các giá trị đặc biệt "yes" để bật tất cả chế độ và "no" để tắt tất cả chế độ.
Thẻ:loading_and_analysis
,action_command_lines
,affects_outputs
- Giá trị mặc định của
--[no]incompatible_always_include_files_in_data
: "true" - Nếu đúng, các quy tắc gốc sẽ thêm <code>DefaultInfo.files</code> của các phần phụ thuộc dữ liệu vào tệp chạy của chúng, khớp với hành vi được đề xuất cho các quy tắc Starlark (https://bazel.build/extending/rules#runfiles_features_to_avoid).
Thẻ:affects_outputs
,incompatible_change
- Giá trị mặc định của
--[no]legacy_external_runfiles
: "true" - Nếu đúng, hãy tạo rừng đường liên kết tượng trưng cho tệp chạy cho các kho lưu trữ bên ngoài trong .runfiles/wsname/external/repo (ngoài .runfiles/repo).
Thẻ:affects_outputs
- Giá trị mặc định của
--[no]objc_generate_linkmap
: "false" -
Chỉ định xem có tạo tệp liên kết hay không.
Thẻ:affects_outputs
--output_groups=<comma-separated list of options>
nhiều lần sử dụng được tích luỹ-
Danh sách tên nhóm đầu ra được phân tách bằng dấu phẩy, mỗi tên có thể có tiền tố là + hoặc -. Nhóm có tiền tố là + sẽ được thêm vào nhóm đầu ra mặc định, còn nhóm có tiền tố là - sẽ bị xoá khỏi nhóm mặc định. Nếu ít nhất một nhóm không có tiền tố, thì nhóm đầu ra mặc định sẽ bị bỏ qua. Ví dụ: --output_groups=+foo,+bar sẽ tạo tập hợp hợp nhất của tập hợp mặc định, foo và bar, trong khi --output_groups=foo,bar sẽ ghi đè tập hợp mặc định để chỉ tạo foo và bar.
Thẻ:execution
,affects_outputs
- Giá trị mặc định của
--[no]run_validations
: "true" -
Liệu có chạy các hành động xác thực trong bản dựng hay không. Xem https://bazel.build/extending/rules#validation_actions
Thẻ:execution
,affects_outputs
- Giá trị mặc định của
--[no]save_temps
: "false" - Nếu được đặt, kết quả tạm thời từ gcc sẽ được lưu. Các tệp này bao gồm tệp .s (mã tập hợp), tệp .i (C được xử lý trước) và tệp .ii (C++ được xử lý trước).
Thẻ:affects_outputs
- Các tuỳ chọn cho phép người dùng định cấu hình đầu ra dự kiến, ảnh hưởng đến giá trị của đầu ra đó, thay vì sự tồn tại của đầu ra:
--action_env=<a 'name=value' assignment with an optional value part>
nhiều lần sử dụng được tích luỹ-
Chỉ định tập hợp các biến môi trường có sẵn cho các hành động có cấu hình mục tiêu. Bạn có thể chỉ định biến theo tên, trong trường hợp này giá trị sẽ được lấy từ môi trường gọi, hoặc theo cặp name=value để đặt giá trị độc lập với môi trường gọi. Bạn có thể sử dụng tuỳ chọn này nhiều lần; đối với các tuỳ chọn được đưa ra cho cùng một biến, tuỳ chọn mới nhất sẽ thắng, còn các tuỳ chọn cho các biến khác nhau sẽ được tích luỹ.
Thẻ:action_command_lines
--android_cpu=<a string>
mặc định: "armeabi-v7a"- CPU mục tiêu của Android.
Thẻ:affects_outputs
,loading_and_analysis
,loses_incremental_state
- Giá trị mặc định của
--[no]android_databinding_use_androidx
: "true" - Tạo các tệp liên kết dữ liệu tương thích với AndroidX. Phương thức này chỉ được dùng với databinding v2. Cờ này không có tác dụng.
Thẻ:affects_outputs
,loading_and_analysis
,loses_incremental_state
,experimental
- Giá trị mặc định của
--[no]android_databinding_use_v3_4_args
: "true" -
Sử dụng android databinding v2 với đối số 3.4.0. Cờ này không có tác dụng.
Thẻ:affects_outputs
,loading_and_analysis
,loses_incremental_state
,experimental
--android_dynamic_mode=<off, default or fully>
mặc định: "off"- xác định xem các phần phụ thuộc C++ của quy tắc Android có được liên kết động khi cc_binary không tạo thư viện dùng chung một cách rõ ràng hay không. "mặc định" có nghĩa là bazel sẽ chọn xem có liên kết động hay không. "đầy đủ" có nghĩa là tất cả thư viện sẽ được liên kết động. "tắt" có nghĩa là tất cả thư viện sẽ được liên kết chủ yếu ở chế độ tĩnh.
Thẻ:affects_outputs
,loading_and_analysis
--android_manifest_merger_order=<alphabetical, alphabetical_by_configuration or dependency>
mặc định: "alphabetical"-
Đặt thứ tự của tệp kê khai được chuyển đến trình sáp nhập tệp kê khai cho tệp nhị phân Android. ALPHABETICAL (TĂNG DẦN) nghĩa là tệp kê khai được sắp xếp theo đường dẫn tương ứng với execroot. ALPHABETICAL_BY_CONFIGURATION có nghĩa là tệp kê khai được sắp xếp theo đường dẫn tương ứng với thư mục cấu hình trong thư mục đầu ra. DEPENDENCY (PHẦN PHỤ THUỘC) có nghĩa là tệp kê khai được sắp xếp theo thứ tự tệp kê khai của mỗi thư viện đứng trước tệp kê khai của các phần phụ thuộc.
Thẻ:action_command_lines
,execution
- Giá trị mặc định của
--[no]android_resource_shrinking
: "false" - Bật tính năng rút gọn tài nguyên cho các tệp APK android_binary sử dụng ProGuard.
Thẻ:affects_outputs
,loading_and_analysis
--aspects=<comma-separated list of options>
nhiều lần sử dụng được tích luỹ- Danh sách được phân tách bằng dấu phẩy gồm các khía cạnh sẽ được áp dụng cho các mục tiêu cấp cao nhất. Trong danh sách, nếu một_phương_diện chỉ định các nhà cung cấp phương diện bắt buộc thông qua required_aspect_providers, thì một_phương_diện sẽ chạy sau mọi phương diện được đề cập trước đó trong danh sách phương diện mà các nhà cung cấp được quảng cáo đáp ứng các nhà cung cấp phương diện bắt buộc của một_phương_diện. Hơn nữa, some_aspect sẽ chạy sau khi tất cả các khía cạnh bắt buộc được chỉ định bằng thuộc tính requires. Sau đó, some_aspect sẽ có quyền truy cập vào các giá trị của trình cung cấp khía cạnh đó. <bzl-file-label>%<aspect_name>, ví dụ: '//tools:my_def.bzl%my_aspect', trong đó 'my_aspect' là một giá trị cấp cao nhất từ tệp tools/my_def.bzl
- Giá trị mặc định của
--[no]build_python_zip
: "tự động" -
Tạo tệp zip có thể thực thi python; bật trên Windows, tắt trên các nền tảng khác
Thẻ:affects_outputs
--catalyst_cpus=<comma-separated list of options>
nhiều lần sử dụng được tích luỹ-
Danh sách các cấu trúc được phân tách bằng dấu phẩy để tạo tệp nhị phân Apple Catalyst.
Thẻ:loses_incremental_state
,loading_and_analysis
- Giá trị mặc định của
--[no]collect_code_coverage
: "false" - Nếu được chỉ định, Bazel sẽ đo lường mã (sử dụng công cụ đo lường ngoại tuyến nếu có thể) và sẽ thu thập thông tin về mức độ sử dụng trong quá trình kiểm thử. Chỉ những mục tiêu khớp với --instrumentation_filter mới bị ảnh hưởng. Thông thường, bạn không nên chỉ định trực tiếp tuỳ chọn này – thay vào đó, hãy sử dụng lệnh "bazel coverage".
Thẻ:affects_outputs
--compilation_mode=<fastbuild, dbg or opt>
[-c
] mặc định: "fastbuild"-
Chỉ định chế độ mà tệp nhị phân sẽ được tạo. Giá trị: "fastbuild", "dbg", "opt".
Thẻ:affects_outputs
,action_command_lines
--conlyopt=<a string>
nhiều lần sử dụng được tích luỹ- Tuỳ chọn bổ sung để truyền đến gcc khi biên dịch tệp nguồn C.
Thẻ:action_command_lines
,affects_outputs
--copt=<a string>
nhiều lần sử dụng được tích luỹ-
Các tuỳ chọn bổ sung để truyền đến gcc.
Thẻ:action_command_lines
,affects_outputs
--cpu=<a string>
mặc định: ""- CPU mục tiêu.
Thẻ:changes_inputs
,affects_outputs
--cs_fdo_absolute_path=<a string>
mặc định: xem nội dung mô tả-
Sử dụng thông tin hồ sơ CSFDO để tối ưu hoá quá trình biên dịch. Chỉ định tên đường dẫn tuyệt đối của tệp zip chứa tệp hồ sơ, tệp hồ sơ LLVM thô hoặc được lập chỉ mục.
Thẻ:affects_outputs
--cs_fdo_instrument=<a string>
mặc định: xem nội dung mô tả-
Tạo tệp nhị phân bằng khả năng đo lường FDO nhạy cảm với ngữ cảnh. Với trình biên dịch Clang/LLVM, trình biên dịch này cũng chấp nhận tên thư mục mà(các) tệp hồ sơ thô sẽ được kết xuất trong thời gian chạy.
Thẻ:affects_outputs
--cs_fdo_profile=<a build target label>
mặc định: xem nội dung mô tả-
cs_fdo_profile đại diện cho hồ sơ nhạy cảm theo ngữ cảnh sẽ được dùng để tối ưu hoá.
Thẻ:affects_outputs
--cxxopt=<a string>
nhiều lần sử dụng được tích luỹ- Tuỳ chọn bổ sung để truyền đến gcc khi biên dịch tệp nguồn C++.
Thẻ:action_command_lines
,affects_outputs
--define=<a 'name=value' assignment>
nhiều lần sử dụng được tích luỹ-
Mỗi tuỳ chọn --define chỉ định một giá trị gán cho một biến bản dựng.
Thẻ:changes_inputs
,affects_outputs
- Giá trị mặc định của
--dynamic_mode=<off, default or fully>
: "mặc định" - Xác định xem tệp nhị phân C++ có được liên kết động hay không. "mặc định" có nghĩa là Bazel sẽ chọn xem có liên kết động hay không. "đầy đủ" có nghĩa là tất cả thư viện sẽ được liên kết động. "tắt" có nghĩa là tất cả thư viện sẽ được liên kết chủ yếu ở chế độ tĩnh.
Thẻ:loading_and_analysis
,affects_outputs
- Giá trị mặc định của
--[no]enable_fdo_profile_absolute_path
: "true" - Nếu bạn đặt, việc sử dụng fdo_absolute_profile_path sẽ gây ra lỗi.
Thẻ:affects_outputs
- Giá trị mặc định của
--[no]enable_runfiles
: "tự động" - Bật cây đường liên kết tượng trưng của tệp chạy; Theo mặc định, tính năng này sẽ tắt trên Windows và trên các nền tảng khác.
Thẻ:affects_outputs
--experimental_action_listener=<a build target label>
nhiều lần sử dụng được tích luỹ- Ngừng sử dụng và thay bằng các khía cạnh. Sử dụng action_listener để đính kèm extra_action vào các hành động bản dựng hiện có.
Thẻ:execution
,experimental
- Giá trị mặc định của
--[no]experimental_android_compress_java_resources
: "false" -
Nén tài nguyên Java trong tệp APK
Thẻ:affects_outputs
,loading_and_analysis
,experimental
- Giá trị mặc định của
--[no]experimental_android_databinding_v2
: "true" -
Sử dụng android databinding v2. Cờ này không có tác dụng.
Thẻ:affects_outputs
,loading_and_analysis
,loses_incremental_state
,experimental
- Giá trị mặc định của
--[no]experimental_android_resource_shrinking
: "false" - Bật tính năng rút gọn tài nguyên cho các tệp APK android_binary sử dụng ProGuard.
Thẻ:affects_outputs
,loading_and_analysis
- Giá trị mặc định của
--[no]experimental_android_rewrite_dexes_with_rex
: "false" -
sử dụng công cụ rex để ghi lại các tệp dex
Thẻ:affects_outputs
,loading_and_analysis
,loses_incremental_state
,experimental
- Giá trị mặc định của
--[no]experimental_collect_code_coverage_for_generated_files
: "false" - Nếu được chỉ định, Bazel cũng sẽ tạo thông tin thu thập mức độ sử dụng cho các tệp đã tạo.
Thẻ:affects_outputs
--[no]experimental_convenience_symlinks
mặc định: "bình thường"-
Cờ này kiểm soát cách quản lý các đường liên kết tượng trưng thuận tiện (đường liên kết tượng trưng xuất hiện trong không gian làm việc sau khi tạo bản dựng). Giá trị có thể có:
normal (mặc định): Mỗi loại đường liên kết tượng trưng thuận tiện sẽ được tạo hoặc xoá, tuỳ thuộc vào bản dựng.
clean: Tất cả đường liên kết tượng trưng sẽ bị xoá vô điều kiện.
ignore: Đường liên kết tượng trưng sẽ không bị ảnh hưởng.
log_only: Tạo thông điệp nhật ký như thể đã truyền "bình thường", nhưng thực sự không thực hiện bất kỳ thao tác nào trên hệ thống tệp (hữu ích cho các công cụ).
Xin lưu ý rằng chỉ những đường liên kết tượng trưng có tên được tạo bằng giá trị hiện tại của --symlink_prefix mới có thể bị ảnh hưởng; nếu tiền tố thay đổi, mọi đường liên kết tượng trưng hiện có sẽ không bị ảnh hưởng.
Thẻ:affects_outputs
- Giá trị mặc định của
--[no]experimental_convenience_symlinks_bep_event
: "false" -
Cờ này kiểm soát việc chúng ta có đăng sự kiện buildConvenienceSymlinksIdentified lên BuildEventProtocol hay không. Nếu giá trị là true, BuildEventProtocol sẽ có một mục nhập cho convenienceSymlinksIdentified, liệt kê tất cả các đường liên kết tượng trưng tiện lợi được tạo trong không gian làm việc của bạn. Nếu giá trị là false, thì mục convenienceSymlinksIdentified trong BuildEventProtocol sẽ trống.
Thẻ:affects_outputs
--experimental_objc_fastbuild_options=<comma-separated list of options>
mặc định: "-O0,-DDEBUG=1"-
Sử dụng các chuỗi này làm tuỳ chọn trình biên dịch bản dựng nhanh objc.
Thẻ:action_command_lines
- Giá trị mặc định của
--[no]experimental_omitfp
: "false" - Nếu đúng, hãy sử dụng libunwind để gỡ bỏ ngăn xếp và biên dịch bằng -fomit-frame-pointer và -fasynchronous-unwind-tables.
Thẻ:action_command_lines
,affects_outputs
,experimental
--experimental_output_paths=<off, content or strip>
mặc định: "off"-
Mô hình nào sẽ được sử dụng cho vị trí trong quy tắc cây đầu ra ghi đầu ra của chúng, đặc biệt là đối với các bản dựng đa nền tảng / đa cấu hình. Đây là một tính năng thử nghiệm. Hãy xem https://github.com/bazelbuild/bazel/issues/6526 để biết thông tin chi tiết. Các hành động Starlark có thể chọn sử dụng tính năng liên kết đường dẫn bằng cách thêm khoá "supports-path-mapping" vào tập hợp "execution_requirements".
Thẻ:loses_incremental_state
,bazel_internal_configuration
,affects_outputs
,execution
--experimental_override_name_platform_in_output_dir=<a 'label=value' assignment>
nhiều lần sử dụng được tích luỹ-
Mỗi mục nhập phải có dạng label=value, trong đó label (nhãn) tham chiếu đến một nền tảng và value (giá trị) là tên ngắn mong muốn để sử dụng trong đường dẫn đầu ra. Chỉ được dùng khi --experimental_platform_in_output_dir là true. Có mức độ ưu tiên đặt tên cao nhất.
Thẻ:affects_outputs
,experimental
- Giá trị mặc định của
--[no]experimental_platform_in_output_dir
: "false" - Nếu đúng, tên ngắn cho nền tảng mục tiêu sẽ được dùng trong tên thư mục đầu ra thay vì CPU. Lược đồ chính xác là thử nghiệm và có thể thay đổi: Trước tiên, trong trường hợp hiếm hoi tuỳ chọn --platforms không có đúng một giá trị, thì một hàm băm của tuỳ chọn platforms sẽ được sử dụng. Tiếp theo, nếu bất kỳ tên ngắn nào cho nền tảng hiện tại được đăng ký bằng --experimental_override_name_platform_in_output_dir, thì tên ngắn đó sẽ được sử dụng. Sau đó, nếu bạn đặt --experimental_use_platforms_in_output_dir_legacy_heuristic, hãy sử dụng tên ngắn dựa trên Nhãn nền tảng hiện tại. Cuối cùng, hàm băm của tuỳ chọn nền tảng sẽ được dùng làm phương án cuối cùng.
Thẻ:affects_outputs
,experimental
- Giá trị mặc định của
--[no]experimental_use_llvm_covmap
: "false" - Nếu được chỉ định, Bazel sẽ tạo thông tin bản đồ mức độ sử dụng llvm-cov thay vì gcov khi bật collect_code_coverage.
Thẻ:changes_inputs
,affects_outputs
,loading_and_analysis
,experimental
- Giá trị mặc định của
--[no]experimental_use_platforms_in_output_dir_legacy_heuristic
: "true" -
Vui lòng chỉ sử dụng cờ này trong chiến lược di chuyển hoặc kiểm thử được đề xuất. Xin lưu ý rằng phương pháp phỏng đoán có những thiếu sót đã biết và bạn nên chuyển sang chỉ dựa vào --experimental_override_name_platform_in_output_dir.
Thẻ:affects_outputs
,experimental
--fat_apk_cpu=<comma-separated set of options>
mặc định: "armeabi-v7a"-
Việc đặt tuỳ chọn này sẽ bật các tệp APK lớn, chứa các tệp nhị phân gốc cho tất cả các cấu trúc mục tiêu được chỉ định, ví dụ: --fat_apk_cpu=x86,armeabi-v7a. Nếu bạn chỉ định cờ này, thì --android_cpu sẽ bị bỏ qua đối với các phần phụ thuộc của quy tắc android_binary.
Thẻ:affects_outputs
,loading_and_analysis
,loses_incremental_state
- Giá trị mặc định của
--[no]fat_apk_hwasan
: "false" -
Liệu có tạo các phần phân tách HWASAN hay không.
Thẻ:affects_outputs
,loading_and_analysis
,loses_incremental_state
--fdo_instrument=<a string>
mặc định: xem nội dung mô tả-
Tạo tệp nhị phân bằng khả năng đo lường FDO. Với trình biên dịch Clang/LLVM, trình biên dịch này cũng chấp nhận tên thư mục mà(các) tệp hồ sơ thô sẽ được kết xuất trong thời gian chạy.
Thẻ:affects_outputs
--fdo_optimize=<a string>
mặc định: xem nội dung mô tả- Sử dụng thông tin hồ sơ FDO để tối ưu hoá quá trình biên dịch. Chỉ định tên của tệp zip chứa cây tệp .gcda, tệp afdo chứa hồ sơ tự động hoặc tệp hồ sơ LLVM. Cờ này cũng chấp nhận các tệp được chỉ định làm nhãn (ví dụ: `//foo/bar:file.afdo` – bạn có thể cần thêm một lệnh `exports_files` vào gói tương ứng) và các nhãn trỏ đến mục tiêu `fdo_profile`. Cờ này sẽ được thay thế bằng quy tắc `fdo_profile`.
Thẻ:affects_outputs
--fdo_prefetch_hints=<a build target label>
mặc định: xem nội dung mô tả-
Sử dụng gợi ý tìm nạp trước bộ nhớ đệm.
Thẻ:affects_outputs
--fdo_profile=<a build target label>
mặc định: xem nội dung mô tả-
fdo_profile đại diện cho hồ sơ sẽ được dùng để tối ưu hoá.
Thẻ:affects_outputs
--features=<a string>
nhiều lần sử dụng được tích luỹ- Theo mặc định, các tính năng đã cho sẽ được bật hoặc tắt đối với các mục tiêu được tạo trong cấu hình mục tiêu. Việc chỉ định -<feature> sẽ tắt tính năng đó. Các đặc điểm tiêu cực luôn ghi đè các đặc điểm tích cực. Xem thêm --host_features
Thẻ
:changes_inputs
,affects_outputs
- Giá trị mặc định của
--[no]force_pic
: "false" - Nếu được bật, tất cả các bản biên dịch C++ sẽ tạo mã không phụ thuộc vào vị trí ("-fPIC"), các đường liên kết sẽ ưu tiên thư viện tạo sẵn PIC hơn thư viện không phải PIC và các đường liên kết sẽ tạo tệp thực thi không phụ thuộc vào vị trí ("-pie").
Thẻ:loading_and_analysis
,affects_outputs
--host_action_env=<a 'name=value' assignment with an optional value part>
nhiều lần sử dụng được tích luỹ- Chỉ định tập hợp các biến môi trường có sẵn cho các hành động có cấu hình thực thi. Bạn có thể chỉ định biến theo tên, trong trường hợp này giá trị sẽ được lấy từ môi trường gọi, hoặc theo cặp name=value để đặt giá trị độc lập với môi trường gọi. Bạn có thể sử dụng tuỳ chọn này nhiều lần; đối với các tuỳ chọn được đưa ra cho cùng một biến, tuỳ chọn mới nhất sẽ thắng, còn các tuỳ chọn cho các biến khác nhau sẽ được tích luỹ.
Thẻ:action_command_lines
--host_compilation_mode=<fastbuild, dbg or opt>
mặc định: "opt"-
Chỉ định chế độ mà các công cụ dùng trong quá trình xây dựng sẽ được tạo. Giá trị: "fastbuild", "dbg", "opt".
Thẻ:affects_outputs
,action_command_lines
--host_conlyopt=<a string>
nhiều lần sử dụng được tích luỹ- Tuỳ chọn bổ sung để truyền đến trình biên dịch C khi biên dịch tệp nguồn C (nhưng không phải C++) trong cấu hình thực thi.
Thẻ:action_command_lines
,affects_outputs
--host_copt=<a string>
nhiều lần sử dụng được tích luỹ-
Các tuỳ chọn bổ sung để chuyển đến trình biên dịch C cho các công cụ được tạo trong cấu hình thực thi.
Thẻ:action_command_lines
,affects_outputs
--host_cpu=<a string>
mặc định: ""-
CPU lưu trữ.
Thẻ:changes_inputs
,affects_outputs
--host_cxxopt=<a string>
nhiều lần sử dụng được tích luỹ-
Các tuỳ chọn bổ sung để truyền đến trình biên dịch C++ cho các công cụ được tạo trong cấu hình thực thi.
Thẻ:action_command_lines
,affects_outputs
--host_features=<a string>
nhiều lần sử dụng được tích luỹ- Theo mặc định, các tính năng đã cho sẽ được bật hoặc tắt đối với các mục tiêu được tạo trong cấu hình thực thi. Việc chỉ định -<feature> sẽ tắt tính năng đó. Các đặc điểm tiêu cực luôn ghi đè các đặc điểm tích cực.
Thẻ:changes_inputs
,affects_outputs
--host_force_python=<PY2 or PY3>
mặc định: xem nội dung mô tả- Ghi đè phiên bản Python cho cấu hình thực thi. Có thể là "PY2" hoặc "PY3".
Thẻ:loading_and_analysis
,affects_outputs
--host_linkopt=<a string>
nhiều lần sử dụng được tích luỹ-
Tuỳ chọn bổ sung để truyền đến trình liên kết khi liên kết các công cụ trong cấu hình thực thi.
Thẻ:action_command_lines
,affects_outputs
--host_macos_minimum_os=<a dotted version (for example '2.3' or '3.3alpha2.4')>
mặc định: xem nội dung mô tả-
Phiên bản macOS tương thích tối thiểu cho các mục tiêu lưu trữ. Nếu không chỉ định, hãy sử dụng "macos_sdk_version".
Thẻ:loses_incremental_state
--host_per_file_copt=<a comma-separated list of regex expressions with prefix '-' specifying excluded paths followed by an @ and a comma separated list of options>
nhiều lần sử dụng được tích luỹ-
Các tuỳ chọn bổ sung để truyền có chọn lọc đến trình biên dịch C/C++ khi biên dịch một số tệp nhất định trong cấu hình thực thi. Bạn có thể truyền tuỳ chọn này nhiều lần. Cú pháp: bộ_lọc_biểu_thức_định_liệu@tuỳ_chọn_1,tuỳ_chọn_2,...,tuỳ_chọn_n. Trong đó, regex_filter là danh sách các mẫu biểu thức chính quy bao gồm và loại trừ (Xem thêm --instrumentation_filter). option_1 đến option_n là các tuỳ chọn dòng lệnh tuỳ ý. Nếu một tuỳ chọn chứa dấu phẩy, thì bạn phải đặt tuỳ chọn đó trong dấu ngoặc kép có dấu gạch chéo ngược. Tuỳ chọn có thể chứa @. Chỉ @ đầu tiên mới được dùng để phân tách chuỗi. Ví dụ: --host_per_file_copt=//foo/.*\.cc,-//foo/bar\.cc@-O0 thêm tuỳ chọn dòng lệnh -O0 vào dòng lệnh gcc của tất cả tệp cc trong //foo/ ngoại trừ bar.cc.
Thẻ:action_command_lines
,affects_outputs
--host_swiftcopt=<a string>
nhiều lần sử dụng được tích luỹ-
Các tuỳ chọn bổ sung để truyền đến swiftc cho các công cụ thực thi.
Thẻ:action_command_lines
,affects_outputs
- Giá trị mặc định của
--[no]incompatible_auto_exec_groups
: "false" -
Khi được bật, một nhóm thực thi sẽ tự động được tạo cho mỗi chuỗi công cụ mà một quy tắc sử dụng. Để quy tắc này hoạt động, bạn cần chỉ định tham số "toolchain" (chuỗi công cụ) trên các hành động của quy tắc. Để biết thêm thông tin, hãy xem https://github.com/bazelbuild/bazel/issues/17134.
Thẻ:affects_outputs
,incompatible_change
- Giá trị mặc định của
--[no]incompatible_merge_genfiles_directory
: "true" - Nếu đúng, thư mục genfiles sẽ được gộp vào thư mục bin.
Thẻ:affects_outputs
,incompatible_change
- Giá trị mặc định của
--[no]incompatible_use_host_features
: "true" - Nếu đúng, hãy chỉ sử dụng --features cho cấu hình mục tiêu và --host_features cho cấu hình thực thi.
Thẻ:changes_inputs
,affects_outputs
,incompatible_change
- Giá trị mặc định của
--[no]instrument_test_targets
: "false" -
Khi bật mức độ sử dụng, hãy chỉ định xem có nên cân nhắc việc đo lường các quy tắc kiểm thử hay không. Khi được đặt, các quy tắc kiểm thử do --instrumentation_filter bao gồm sẽ được đo lường. Nếu không, các quy tắc kiểm thử sẽ luôn bị loại trừ khỏi hoạt động đo lường mức độ sử dụng.
Thẻ:affects_outputs
--instrumentation_filter=<a comma-separated list of regex expressions with prefix '-' specifying excluded paths>
mặc định: "-/javatests[/:],-/test/java[/:]"- Khi bạn bật tính năng mức độ sử dụng, chỉ những quy tắc có tên được bộ lọc dựa trên biểu thức chính quy chỉ định mới được đo lường. Thay vào đó, các quy tắc có tiền tố là "-" sẽ bị loại trừ. Xin lưu ý rằng chỉ các quy tắc không phải quy tắc kiểm thử mới được đo lường, trừ phi bạn bật --instrument_test_targets.
Thẻ:affects_outputs
--ios_minimum_os=<a dotted version (for example '2.3' or '3.3alpha2.4')>
mặc định: xem nội dung mô tả-
Phiên bản iOS tương thích tối thiểu cho trình mô phỏng và thiết bị mục tiêu. Nếu không chỉ định, hãy sử dụng "ios_sdk_version".
Thẻ:loses_incremental_state
--ios_multi_cpus=<comma-separated list of options>
nhiều lần sử dụng được tích luỹ-
Danh sách các cấu trúc được phân tách bằng dấu phẩy để tạo ios_application. Kết quả là một tệp nhị phân phổ quát chứa tất cả các cấu trúc đã chỉ định.
Thẻ:loses_incremental_state
,loading_and_analysis
- Giá trị mặc định của
--[no]legacy_whole_archive
: "true" -
Không dùng nữa, thay vào đó là --incompatible_remove_legacy_whole_archive (xem https://github.com/bazelbuild/bazel/issues/7362 để biết thông tin chi tiết). Khi bật, hãy sử dụng --whole-archive cho các quy tắc cc_binary có linkshared=True và linkstatic=True hoặc "-static" trong linkopts. Việc này chỉ nhằm mục đích tương thích ngược. Một cách thay thế tốt hơn là sử dụng alwayslink=1 khi cần.
Thẻ:action_command_lines
,affects_outputs
,deprecated
--linkopt=<a string>
nhiều lần sử dụng được tích luỹ- Tuỳ chọn bổ sung để truyền đến gcc khi liên kết.
Thẻ:action_command_lines
,affects_outputs
--ltobackendopt=<a string>
nhiều lần sử dụng được tích luỹ-
Tuỳ chọn bổ sung để chuyển đến bước phụ trợ LTO (trong --features=thin_lto).
Thẻ:action_command_lines
,affects_outputs
--ltoindexopt=<a string>
nhiều lần sử dụng được tích luỹ-
Tuỳ chọn bổ sung để chuyển đến bước lập chỉ mục LTO (trong --features=thin_lto).
Thẻ:action_command_lines
,affects_outputs
--macos_cpus=<comma-separated list of options>
nhiều lần sử dụng được tích luỹ-
Danh sách các cấu trúc được phân tách bằng dấu phẩy để tạo tệp nhị phân Apple macOS.
Thẻ:loses_incremental_state
,loading_and_analysis
--macos_minimum_os=<a dotted version (for example '2.3' or '3.3alpha2.4')>
mặc định: xem nội dung mô tả-
Phiên bản macOS tương thích tối thiểu cho các mục tiêu. Nếu không chỉ định, hãy sử dụng "macos_sdk_version".
Thẻ:loses_incremental_state
--memprof_profile=<a build target label>
mặc định: xem nội dung mô tả-
Sử dụng hồ sơ memprof.
Thẻ:affects_outputs
- Giá trị mặc định của
--[no]objc_debug_with_GLIBCXX
: "false" - Nếu bạn đặt và chế độ biên dịch được đặt thành "dbg", hãy xác định GLIBCXX_DEBUG, GLIBCXX_DEBUG_PEDANTIC và GLIBCPP_CONCEPT_CHECKS.
Thẻ:action_command_lines
- Giá trị mặc định của
--[no]objc_enable_binary_stripping
: "false" -
Liệu có thực hiện việc xoá ký hiệu và mã chết trên các tệp nhị phân được liên kết hay không. Thao tác loại bỏ tệp nhị phân sẽ được thực hiện nếu bạn chỉ định cả cờ này và --compilation_mode=opt.
Thẻ:action_command_lines
--objccopt=<a string>
nhiều lần sử dụng được tích luỹ-
Các tuỳ chọn bổ sung để truyền đến gcc khi biên dịch tệp nguồn Objective-C/C++.
Thẻ:action_command_lines
--per_file_copt=<a comma-separated list of regex expressions with prefix '-' specifying excluded paths followed by an @ and a comma separated list of options>
nhiều lần sử dụng được tích luỹ-
Các tuỳ chọn bổ sung để truyền có chọn lọc đến gcc khi biên dịch một số tệp nhất định. Bạn có thể truyền tuỳ chọn này nhiều lần. Cú pháp: bộ_lọc_biểu_thức_định_liệu@tuỳ_chọn_1,tuỳ_chọn_2,...,tuỳ_chọn_n. Trong đó, regex_filter là danh sách các mẫu biểu thức chính quy bao gồm và loại trừ (Xem thêm --instrumentation_filter). option_1 đến option_n là các tuỳ chọn dòng lệnh tuỳ ý. Nếu một tuỳ chọn chứa dấu phẩy, thì bạn phải đặt tuỳ chọn đó trong dấu ngoặc kép có dấu gạch chéo ngược. Tuỳ chọn có thể chứa @. Chỉ @ đầu tiên mới được dùng để phân tách chuỗi. Ví dụ: --per_file_copt=//foo/.*\.cc,-//foo/bar\.cc@-O0 thêm tuỳ chọn dòng lệnh -O0 vào dòng lệnh gcc của tất cả tệp cc trong //foo/ ngoại trừ bar.cc.
Thẻ:action_command_lines
,affects_outputs
--per_file_ltobackendopt=<a comma-separated list of regex expressions with prefix '-' specifying excluded paths followed by an @ and a comma separated list of options>
nhiều lần sử dụng được tích luỹ-
Các tuỳ chọn bổ sung để chuyển có chọn lọc đến phần phụ trợ LTO (trong --features=thin_lto) khi biên dịch một số đối tượng phụ trợ nhất định. Bạn có thể truyền tuỳ chọn này nhiều lần. Cú pháp: bộ_lọc_biểu_thức_định_liệu@tuỳ_chọn_1,tuỳ_chọn_2,...,tuỳ_chọn_n. Trong đó, regex_filter là danh sách các mẫu biểu thức chính quy bao gồm và loại trừ. option_1 đến option_n là các tuỳ chọn dòng lệnh tuỳ ý. Nếu một tuỳ chọn chứa dấu phẩy, thì bạn phải đặt tuỳ chọn đó trong dấu ngoặc kép có dấu gạch chéo ngược. Tuỳ chọn có thể chứa @. Chỉ @ đầu tiên mới được dùng để phân tách chuỗi. Ví dụ: --per_file_ltobackendopt=//foo/.*\.o,-//foo/bar\.o@-O0 sẽ thêm tuỳ chọn dòng lệnh -O0 vào dòng lệnh phụ trợ LTO của tất cả tệp o trong //foo/ ngoại trừ bar.o.
Thẻ:action_command_lines
,affects_outputs
--platform_suffix=<a string>
mặc định: xem nội dung mô tả- Chỉ định hậu tố cần thêm vào thư mục cấu hình.
Thẻ:loses_incremental_state
,affects_outputs
,loading_and_analysis
--propeller_optimize=<a build target label>
mặc định: xem nội dung mô tả-
Sử dụng thông tin hồ sơ Propeller để tối ưu hoá mục tiêu bản dựng.Hồ sơ Propeller phải bao gồm ít nhất một trong hai tệp, hồ sơ cc và hồ sơ ld. Cờ này chấp nhận nhãn bản dựng phải tham chiếu đến các tệp đầu vào của hồ sơ cánh quạt. Ví dụ: tệp BUILD xác định nhãn, trong a/b/BUILD:propeller_optimize( name = "propeller_profile", cc_profile = "propeller_cc_profile.txt", ld_profile = "propeller_ld_profile.txt",)Có thể bạn phải thêm một lệnh exports_files vào gói tương ứng để Bazel có thể thấy các tệp này. Bạn phải sử dụng tuỳ chọn này như sau: --propeller_optimize=//a/b:propeller_profile
Thẻ:action_command_lines
,affects_outputs
--propeller_optimize_absolute_cc_profile=<a string>
mặc định: xem nội dung mô tả- Tên đường dẫn tuyệt đối của tệp cc_profile cho các bản dựng được tối ưu hoá bằng Propeller.
Thẻ:affects_outputs
--propeller_optimize_absolute_ld_profile=<a string>
mặc định: xem nội dung mô tả- Tên đường dẫn tuyệt đối của tệp ld_profile cho các bản dựng được tối ưu hoá bằng Propeller.
Thẻ:affects_outputs
--run_under=<a prefix in front of command>
mặc định: xem nội dung mô tả-
Tiền tố để chèn trước các tệp thực thi cho lệnh "test" (kiểm thử) và "run" (chạy). Nếu giá trị là "foo -bar" và dòng lệnh thực thi là "test_binary -baz", thì dòng lệnh cuối cùng sẽ là "foo -bar test_binary -baz".Đây cũng có thể là nhãn cho một mục tiêu có thể thực thi. Một số ví dụ: "valgrind", "strace", "strace -c", "valgrind --quiet --num-callers=20", "//package:target", '//package:target --options'.
Thẻ:action_command_lines
- Nếu đúng, các thư viện gốc chứa chức năng giống hệt nhau sẽ được chia sẻ giữa các mục tiêu khác nhau
Thẻ
:loading_and_analysis
,affects_outputs
- Giá trị mặc định của
--[no]stamp
: "false" -
Đóng dấu tệp nhị phân bằng ngày, tên người dùng, tên máy chủ, thông tin về không gian làm việc, v.v.
Thẻ:affects_outputs
- Giá trị mặc định của
--strip=<always, sometimes or never>
: "đôi khi" - Chỉ định xem có xoá các tệp nhị phân và thư viện dùng chung hay không (sử dụng "-Wl,--strip-debug"). Giá trị mặc định là "sometimes" (đôi khi) có nghĩa là xoá nếu --compilation_mode=fastbuild.
Thẻ:affects_outputs
--stripopt=<a string>
nhiều lần sử dụng được tích luỹ-
Các tuỳ chọn bổ sung để truyền vào tính năng loại bỏ khi tạo tệp nhị phân "<name>.stripped".
Thẻ:action_command_lines
,affects_outputs
--swiftcopt=<a string>
nhiều lần sử dụng được tích luỹ-
Các tuỳ chọn bổ sung để truyền đến quá trình biên dịch Swift.
Thẻ:action_command_lines
--symlink_prefix=<a string>
mặc định: xem nội dung mô tả-
Tiền tố được thêm vào bất kỳ đường liên kết tượng trưng tiện lợi nào được tạo sau một bản dựng. Nếu bị bỏ qua, giá trị mặc định là tên của công cụ xây dựng, theo sau là dấu gạch nối. Nếu bạn truyền "/", thì hệ thống sẽ không tạo đường liên kết tượng trưng và không phát ra cảnh báo nào. Cảnh báo: chức năng đặc biệt cho "/" sẽ sớm ngừng hoạt động; hãy sử dụng --experimental_convenience_symlinks=ignore.
Thẻ:affects_outputs
--tvos_cpus=<comma-separated list of options>
nhiều lần sử dụng được tích luỹ-
Danh sách kiến trúc được phân tách bằng dấu phẩy để tạo tệp nhị phân Apple tvOS.
Thẻ:loses_incremental_state
,loading_and_analysis
--tvos_minimum_os=<a dotted version (for example '2.3' or '3.3alpha2.4')>
mặc định: xem nội dung mô tả-
Phiên bản tvOS tối thiểu tương thích cho trình mô phỏng và thiết bị mục tiêu. Nếu không chỉ định, hãy sử dụng "tvos_sdk_version".
Thẻ:loses_incremental_state
--visionos_cpus=<comma-separated list of options>
nhiều lần sử dụng được tích luỹ-
Danh sách kiến trúc được phân tách bằng dấu phẩy để tạo tệp nhị phân visionOS của Apple.
Thẻ:loses_incremental_state
,loading_and_analysis
--watchos_cpus=<comma-separated list of options>
nhiều lần sử dụng được tích luỹ-
Danh sách được phân tách bằng dấu phẩy gồm các cấu trúc để tạo tệp nhị phân Apple watchOS.
Thẻ:loses_incremental_state
,loading_and_analysis
--watchos_minimum_os=<a dotted version (for example '2.3' or '3.3alpha2.4')>
mặc định: xem nội dung mô tả- Phiên bản watchOS tối thiểu tương thích với trình mô phỏng và thiết bị mục tiêu. Nếu không chỉ định, hãy sử dụng "watchos_sdk_version".
Thẻ:loses_incremental_state
--xbinary_fdo=<a build target label>
mặc định: xem nội dung mô tả-
Sử dụng thông tin hồ sơ XbinaryFDO để tối ưu hoá quá trình biên dịch. Chỉ định tên của hồ sơ tệp nhị phân chéo mặc định. Khi tuỳ chọn này được sử dụng cùng với --fdo_instrument/--fdo_optimize/--fdo_profile, các tuỳ chọn đó sẽ luôn chiếm ưu thế như thể xbinary_fdo không bao giờ được chỉ định.
Thẻ:affects_outputs
- Các tuỳ chọn ảnh hưởng đến mức độ nghiêm ngặt mà Bazel thực thi các dữ liệu đầu vào bản dựng hợp lệ (xác định quy tắc, tổ hợp cờ, v.v.):
--auto_cpu_environment_group=<a build target label>
mặc định: ""- khai báo environment_group để sử dụng cho việc tự động liên kết các giá trị cpu với các giá trị target_environment.
Thẻ:changes_inputs
,loading_and_analysis
,experimental
- Giá trị mặc định của
--[no]check_licenses
: "false" -
Kiểm tra để đảm bảo các quy tắc hạn chế về giấy phép do các gói phụ thuộc áp đặt không xung đột với chế độ phân phối của các mục tiêu đang được tạo. Theo mặc định, giấy phép sẽ không được kiểm tra.
Thẻ:build_file_semantics
- Giá trị mặc định của
--[no]check_visibility
: "true" - Nếu bị tắt, các lỗi về chế độ hiển thị trong phần phụ thuộc mục tiêu sẽ bị hạ cấp thành cảnh báo.
Thẻ:build_file_semantics
- Giá trị mặc định của
--[no]desugar_for_android
: "true" -
Liệu có đơn giản hoá mã byte Java 8 trước khi tạo tệp dex hay không.
Thẻ:affects_outputs
,loading_and_analysis
,loses_incremental_state
- Giá trị mặc định của
--[no]desugar_java8_libs
: "false" -
Liệu có đưa các thư viện Java 8 được hỗ trợ vào ứng dụng cho các thiết bị cũ hay không.
Thẻ:affects_outputs
,loading_and_analysis
,loses_incremental_state
,experimental
- Giá trị mặc định của
--[no]enforce_constraints
: "true" -
Kiểm tra môi trường mà mỗi mục tiêu tương thích và báo cáo lỗi nếu có mục tiêu nào có các phần phụ thuộc không hỗ trợ cùng một môi trường
Thẻ:build_file_semantics
- Giá trị mặc định của
--[no]experimental_check_desugar_deps
: "true" -
Liệu có nên kiểm tra kỹ việc đơn giản hoá chính xác ở cấp tệp nhị phân Android hay không.
Thẻ:eagerness_to_exit
,loading_and_analysis
,experimental
- Giá trị mặc định của
--experimental_import_deps_checking=<off, warning or error>
: "OFF" -
Khi bật, hãy kiểm tra xem các phần phụ thuộc của aar_import đã hoàn tất hay chưa. Việc thực thi này có thể làm hỏng bản dựng hoặc chỉ dẫn đến cảnh báo.
Thẻ:loading_and_analysis
- Giá trị mặc định của
--experimental_one_version_enforcement=<off, warning or error>
: "OFF" -
Khi bật, hãy thực thi quy tắc java_binary không được chứa nhiều phiên bản của cùng một tệp lớp trên đường dẫn lớp. Việc thực thi này có thể làm hỏng bản dựng hoặc chỉ dẫn đến cảnh báo.
Thẻ:loading_and_analysis
- Giá trị mặc định của
--experimental_strict_java_deps=<off, warn, error, strict or default>
: "mặc định" - Nếu đúng, hãy kiểm tra để đảm bảo rằng một mục tiêu Java khai báo rõ ràng tất cả các mục tiêu được sử dụng trực tiếp dưới dạng phần phụ thuộc.
Thẻ:build_file_semantics
,eagerness_to_exit
- Giá trị mặc định của
--[no]incompatible_check_testonly_for_output_files
: "false" - Nếu được bật, hãy kiểm tra testonly cho các mục tiêu tiên quyết là tệp đầu ra bằng cách tra cứu testonly của quy tắc tạo. Điều này khớp với việc kiểm tra chế độ hiển thị.
Thẻ:build_file_semantics
,incompatible_change
- Giá trị mặc định của
--[no]incompatible_check_visibility_for_toolchains
: "false" - Nếu được bật, tính năng kiểm tra chế độ hiển thị cũng áp dụng cho việc triển khai chuỗi công cụ.
Thẻ:build_file_semantics
,incompatible_change
- Giá trị mặc định của
--[no]incompatible_disable_native_android_rules
: "false" - Nếu được bật, tính năng sử dụng trực tiếp các quy tắc Android gốc sẽ bị tắt. Vui lòng sử dụng các quy tắc Android Starlark từ https://github.com/bazelbuild/rules_android
Thẻ:eagerness_to_exit
,incompatible_change
- Giá trị mặc định của
--[no]incompatible_disable_native_apple_binary_rule
: "false" - Không hoạt động. Được giữ lại ở đây để tương thích ngược.
Thẻ:eagerness_to_exit
,incompatible_change
- Giá trị mặc định của
--[no]incompatible_python_disable_py2
: "true" - Nếu đúng, việc sử dụng chế độ cài đặt Python 2 sẽ gây ra lỗi. Bao gồm cả python_version=PY2, srcs_version=PY2 và srcs_version=PY2ONLY. Hãy xem https://github.com/bazelbuild/bazel/issues/15684 để biết thêm thông tin.
Thẻ:loading_and_analysis
,incompatible_change
- Giá trị mặc định của
--[no]incompatible_validate_top_level_header_inclusions
: "true" - Nếu đúng, Bazel cũng sẽ xác thực việc đưa tiêu đề thư mục cấp cao nhất vào (xem https://github.com/bazelbuild/bazel/issues/10047 để biết thêm thông tin).
Thẻ:loading_and_analysis
,incompatible_change
- Giá trị mặc định của
--[no]one_version_enforcement_on_java_tests
: "true" -
Khi được bật và experimental_one_version_enforcement được đặt thành một giá trị khác NONE, hãy thực thi một phiên bản trên các mục tiêu java_test. Bạn có thể tắt cờ này để cải thiện hiệu suất kiểm thử gia tăng nhưng sẽ bỏ lỡ các lỗi vi phạm tiềm ẩn về một phiên bản.
Thẻ:loading_and_analysis
--python_native_rules_allowlist=<a build target label>
mặc định: xem nội dung mô tả-
Danh sách cho phép (mục tiêu package_group) để sử dụng khi thực thi --incompatible_python_disallow_native_rules.
Thẻ:loading_and_analysis
- Giá trị mặc định của
--[no]strict_filesets
: "false" - Nếu bạn bật tuỳ chọn này, các tệp nhóm sẽ vượt quá giới hạn gói sẽ được báo cáo là lỗi.
Thẻ:build_file_semantics
,eagerness_to_exit
--strict_proto_deps=<off, warn, error, strict or default>
mặc định: "lỗi"- Nếu không tắt, hãy kiểm tra để đảm bảo rằng mục tiêu proto_library 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.
Thẻ:build_file_semantics
,eagerness_to_exit
,incompatible_change
--strict_public_imports=<off, warn, error, strict or default>
mặc định: "off"-
Trừ khi TẮT, hãy kiểm tra để đảm bảo rằng mục tiêu proto_library khai báo rõ ràng tất cả các mục tiêu được sử dụng trong "import public" là mục tiêu đã xuất.
Thẻ:build_file_semantics
,eagerness_to_exit
,incompatible_change
- Giá trị mặc định của
--[no]strict_system_includes
: "false" - Nếu là true, bạn cũng phải khai báo các tiêu đề tìm thấy thông qua hệ thống bao gồm các đường dẫn (-isystem).
Thẻ:loading_and_analysis
,eagerness_to_exit
--target_environment=<a build target label>
nhiều lần sử dụng được tích luỹ-
Khai báo môi trường mục tiêu của bản dựng này. Phải là tham chiếu nhãn đến quy tắc "môi trường". Nếu được chỉ định, tất cả mục tiêu cấp cao nhất phải tương thích với môi trường này.
Thẻ:changes_inputs
- Các tuỳ chọn ảnh hưởng đến kết quả ký của một bản dựng:
--apk_signing_method=<v1, v2, v1_v2 or v4>
mặc định: "v1_v2"-
Cách triển khai để ký tệp APK
Thẻ:action_command_lines
,affects_outputs
,loading_and_analysis
- Giá trị mặc định của
--[no]device_debug_entitlements
: "true" - Nếu bạn đặt và chế độ biên dịch không phải là "opt", thì các ứng dụng objc sẽ bao gồm các quyền gỡ lỗi khi ký.
Thẻ:changes_inputs
--ios_signing_cert_name=<a string>
mặc định: xem nội dung mô tả- Tên chứng chỉ dùng để ký ứng dụng iOS. Nếu không được đặt, hệ thống sẽ quay lại sử dụng hồ sơ cấp phép. Có thể là lựa chọn ưu tiên về danh tính chuỗi khoá của chứng chỉ hoặc (chuỗi con) của tên chung của chứng chỉ, theo trang man của codesign (SIGNING IDENTITIES).
Thẻ:action_command_lines
- Tuỳ chọn này ảnh hưởng đến ngữ nghĩa của ngôn ngữ Starlark hoặc API bản dựng mà các tệp BUILD, tệp .bzl hoặc tệp WORKSPACE có thể truy cập.:
- Giá trị mặc định của
--[no]incompatible_config_setting_private_default_visibility
: "false" - Nếu incompatible_enforce_config_setting_visibility=false, thì đây là một thao tác không có tác dụng. Nếu không, nếu cờ này là false, mọi config_setting không có thuộc tính chế độ hiển thị rõ ràng sẽ là //visibility:public. Nếu cờ này là true, config_setting sẽ tuân theo logic hiển thị giống như tất cả các quy tắc khác. Xem https://github.com/bazelbuild/bazel/issues/12933.
Thẻ:loading_and_analysis
,incompatible_change
- Giá trị mặc định của
--[no]incompatible_disallow_legacy_py_provider
: "true" - Không hoạt động, sẽ sớm bị xoá.
Thẻ:loading_and_analysis
,incompatible_change
- Giá trị mặc định của
--[no]incompatible_disallow_sdk_frameworks_attributes
: "false" - Nếu đúng, không cho phép các thuộc tính sdk_frameworks và weak_sdk_frameworks trong objc_library và objc_import.
Thẻ:build_file_semantics
,incompatible_change
- Giá trị mặc định của
--[no]incompatible_enforce_config_setting_visibility
: "true" - Nếu đúng, hãy thực thi các quy định hạn chế về chế độ hiển thị config_setting. Nếu giá trị là false, mọi mục config_setting đều hiển thị với mọi mục tiêu. Xem https://github.com/bazelbuild/bazel/issues/12932.
Thẻ:loading_and_analysis
,incompatible_change
- Giá trị mặc định của
--[no]incompatible_objc_alwayslink_by_default
: "false" - Nếu đúng, hãy đặt giá trị mặc định thành đúng cho các thuộc tính alwayslink trong objc_library và objc_import.
Thẻ:build_file_semantics
,incompatible_change
- Giá trị mặc định của
--[no]incompatible_python_disallow_native_rules
: "false" -
Khi giá trị là true, lỗi sẽ xảy ra khi sử dụng các quy tắc py_* tích hợp; thay vào đó, bạn nên sử dụng các quy tắc rule_python. Hãy xem https://github.com/bazelbuild/bazel/issues/17773 để biết thêm thông tin và hướng dẫn di chuyển.
Thẻ:loading_and_analysis
,incompatible_change
- Các tuỳ chọn điều chỉnh hành vi của môi trường kiểm thử hoặc trình chạy kiểm thử:
- Giá trị mặc định của
--[no]allow_analysis_failures
: "false" - Nếu đúng, lỗi phân tích của một mục tiêu quy tắc sẽ dẫn đến việc mục tiêu truyền một thực thể của AnalysisFailureInfo chứa nội dung mô tả lỗi, thay vì dẫn đến lỗi bản dựng.
Thẻ:loading_and_analysis
,experimental
- Giá trị mặc định của
--analysis_testing_deps_limit=<an integer>
: "2000" -
Đặt số lượng phần phụ thuộc bắc cầu tối đa thông qua một thuộc tính quy tắc có chuyển đổi cấu hình for_analysis_testing. Nếu vượt quá giới hạn này, bạn sẽ gặp lỗi quy tắc.
Thẻ:loading_and_analysis
- Giá trị mặc định của
--[no]break_build_on_parallel_dex2oat_failure
: "false" - Nếu lỗi thao tác dex2oat là đúng thì bản dựng sẽ bị lỗi thay vì thực thi dex2oat trong thời gian chạy kiểm thử.
Thẻ:loading_and_analysis
,experimental
- Giá trị mặc định của
--[no]check_tests_up_to_date
: "false" -
Đừng chạy kiểm thử, chỉ cần kiểm tra xem các kiểm thử đó có được cập nhật hay không. Nếu tất cả kết quả kiểm thử đều mới nhất, thì quá trình kiểm thử sẽ hoàn tất thành công. Nếu cần tạo hoặc thực thi bất kỳ chương trình kiểm thử nào, lỗi sẽ được báo cáo và quá trình kiểm thử sẽ không thành công. Tuỳ chọn này ngụ ý hành vi --check_up_to_date.
Thẻ:execution
--default_test_resources=<a resource name followed by equal and 1 float or 4 float, e.g. memory=10,30,60,100>
nhiều lần sử dụng được tích luỹ- Ghi đè số lượng tài nguyên mặc định cho các chương trình kiểm thử. Định dạng dự kiến là <tài nguyên>=<giá trị>. Nếu một số dương duy nhất được chỉ định là <giá trị>, thì số này sẽ ghi đè các tài nguyên mặc định cho tất cả kích thước kiểm thử. Nếu bạn chỉ định 4 số được phân tách bằng dấu phẩy, thì các số này sẽ ghi đè lượng tài nguyên tương ứng cho các kích thước kiểm thử nhỏ, trung bình, lớn, rất lớn. Giá trị cũng có thể là HOST_RAM/HOST_CPU, theo sau là [-|*]<float> (ví dụ: memory=HOST_RAM*.1,HOST_RAM*.2,HOST_RAM*.3,HOST_RAM*.4). Tài nguyên kiểm thử mặc định do cờ này chỉ định sẽ bị ghi đè bởi tài nguyên rõ ràng được chỉ định trong thẻ.
- Giá trị mặc định của
--[no]experimental_android_use_parallel_dex2oat
: "false" -
Sử dụng dex2oat song song để có thể tăng tốc android_test.
Thẻ:loading_and_analysis
,host_machine_resource_optimizations
,experimental
--flaky_test_attempts=<a positive integer, the string "default", or test_regex@attempts. This flag may be passed more than once>
nhiều lần sử dụng được tích luỹ-
Mỗi lượt kiểm thử sẽ được thử lại tối đa số lần đã chỉ định trong trường hợp có bất kỳ lượt kiểm thử nào không thành công. Các kiểm thử cần nhiều lần thử mới vượt qua được sẽ được đánh dấu là "KHÔNG ĐÁNG TIN CẬY" trong phần tóm tắt kiểm thử. Thông thường, giá trị được chỉ định chỉ là một số nguyên hoặc chuỗi "mặc định". Nếu là số nguyên, thì tất cả các chương trình kiểm thử sẽ chạy tối đa N lần. Nếu là "mặc định", thì chỉ một lần thử nghiệm sẽ được thực hiện cho các kiểm thử thông thường và 3 lần cho các kiểm thử được đánh dấu rõ ràng là không ổn định theo quy tắc của chúng (thuộc tính flaky=1). Cú pháp thay thế: regex_filter@flaky_test_attempts. Trong đó, flaky_test_attempts như trên và regex_filter là danh sách các mẫu biểu thức chính quy bao gồm và loại trừ (Xem thêm --runs_per_test). Ví dụ: --flaky_test_attempts=//foo/.*,-//foo/bar/.*@3 sẽ loại bỏ tất cả các lần kiểm thử trong //foo/ ngoại trừ các lần kiểm thử trong foo/bar ba lần. Bạn có thể truyền tuỳ chọn này nhiều lần. Đối số khớp được truyền gần đây nhất sẽ được ưu tiên. Nếu không có giá trị nào khớp, hành vi sẽ giống như "mặc định" ở trên.
Thẻ:execution
- Giá trị mặc định của
--[no]ios_memleaks
: "false" -
Bật tính năng kiểm tra rò rỉ bộ nhớ trong các mục tiêu ios_test.
Thẻ:action_command_lines
--ios_simulator_device=<a string>
mặc định: xem nội dung mô tả-
Thiết bị để mô phỏng khi chạy ứng dụng iOS trong trình mô phỏng, ví dụ: "iPhone 6". Bạn có thể lấy danh sách thiết bị bằng cách chạy lệnh "xcrun simctl list devicetypes" trên máy mà trình mô phỏng sẽ chạy.
Thẻ:test_runner
--ios_simulator_version=<a dotted version (for example '2.3' or '3.3alpha2.4')>
mặc định: xem nội dung mô tả-
Phiên bản iOS để chạy trên trình mô phỏng khi chạy hoặc kiểm thử. Quy tắc này sẽ bị bỏ qua đối với các quy tắc ios_test nếu bạn chỉ định một thiết bị mục tiêu trong quy tắc.
Thẻ:test_runner
- Giá trị mặc định của
--local_test_jobs=<an integer, or a keyword ("auto", "HOST_CPUS", "HOST_RAM"), optionally followed by an operation ([-|*]<float>) eg. "auto", "HOST_CPUS*.5">
: "tự động" -
Số lượng công việc kiểm thử cục bộ tối đa để chạy đồng thời. Nhận một số nguyên hoặc từ khoá ("tự động", "HOST_CPUS", "HOST_RAM"), theo sau có thể là một phép toán ([-|*]<float>) ví dụ: "tự động", "HOST_CPUS*.5". 0 có nghĩa là tài nguyên cục bộ sẽ giới hạn số lượng công việc kiểm thử cục bộ để chạy đồng thời. Việc đặt giá trị này lớn hơn giá trị cho --jobs sẽ không hiệu quả.
Thẻ:execution
--runs_per_test=<a positive integer or test_regex@runs. This flag may be passed more than once>
nhiều lần sử dụng được tích luỹ- Chỉ định số lần chạy mỗi chương trình kiểm thử. Nếu bất kỳ lần thử nào trong số đó không thành công vì bất kỳ lý do gì, thì toàn bộ kiểm thử sẽ được coi là không thành công. Thông thường, giá trị được chỉ định chỉ là một số nguyên. Ví dụ: --runs_per_test=3 sẽ chạy tất cả các bài kiểm thử 3 lần. Cú pháp thay thế: bộ_lọc_biểu_thức_tìm_kiếm@số_lần_chạy_mỗi_bài_kiểm_ thử. Trong đó, runs_per_test là một giá trị số nguyên và regex_filter là danh sách các mẫu biểu thức chính quy bao gồm và loại trừ (Xem thêm --instrumentation_filter). Ví dụ: --runs_per_test=//foo/.*,-//foo/bar/.*@3 chạy tất cả các bài kiểm thử trong //foo/ ngoại trừ các bài kiểm thử trong foo/bar ba lần. Bạn có thể truyền tuỳ chọn này nhiều lần. Đối số khớp được truyền gần đây nhất sẽ được ưu tiên. Nếu không có kết quả nào khớp, thì quy trình kiểm thử sẽ chỉ chạy một lần.
--test_env=<a 'name=value' assignment with an optional value part>
nhiều lần sử dụng được tích luỹ- Chỉ định các biến môi trường bổ sung sẽ được chèn vào môi trường trình chạy kiểm thử. Bạn có thể chỉ định biến theo tên, trong trường hợp này, giá trị của biến sẽ được đọc từ môi trường ứng dụng Bazel hoặc theo cặp name=value. Bạn có thể sử dụng tuỳ chọn này nhiều lần để chỉ định một số biến. Chỉ được lệnh "bazel test" sử dụng.
Thẻ:test_runner
- Giá trị mặc định của
--[no]test_keep_going
: "true" -
Khi bị tắt, mọi kiểm thử không đạt sẽ khiến toàn bộ bản dựng dừng lại. Theo mặc định, tất cả các bài kiểm thử đều chạy, ngay cả khi một số bài kiểm thử không đạt.
Thẻ:execution
--test_strategy=<a string>
mặc định: ""-
Chỉ định chiến lược nào sẽ được sử dụng khi chạy kiểm thử.
Thẻ:execution
--test_timeout=<a single integer or comma-separated list of 4 integers>
mặc định: "-1"- Ghi đè các giá trị thời gian chờ kiểm thử mặc định cho thời gian chờ kiểm thử (tính bằng giây). Nếu bạn chỉ định một giá trị số nguyên dương, thì giá trị đó sẽ ghi đè tất cả các danh mục. Nếu bạn chỉ định 4 số nguyên được phân tách bằng dấu phẩy, thì các số này sẽ ghi đè thời gian chờ cho thời gian ngắn, trung bình, dài và vĩnh viễn (theo thứ tự đó). Trong cả hai hình thức, giá trị -1 sẽ yêu cầu blaze sử dụng thời gian chờ mặc định cho danh mục đó.
--test_tmpdir=<a path>
mặc định: xem nội dung mô tả- Chỉ định thư mục tạm thời cơ sở để "kiểm thử bazel" sử dụng.
- Giá trị mặc định của
--[no]zip_undeclared_test_outputs
: "true" - Nếu đúng, các kết quả kiểm thử chưa khai báo sẽ được lưu trữ trong một tệp zip.
Thẻ:test_runner
- Các tuỳ chọn kích hoạt tính năng tối ưu hoá thời gian xây dựng:
--cache_computed_file_digests=<a long integer>
mặc định: "50000"- Nếu lớn hơn 0, hãy định cấu hình Bazel để lưu các chuỗi đại diện tệp vào bộ nhớ đệm dựa trên siêu dữ liệu của các chuỗi đại diện đó thay vì tính toán lại các chuỗi đại diện từ ổ đĩa mỗi khi cần. Việc đặt giá trị này thành 0 sẽ đảm bảo tính chính xác vì không phải mọi thay đổi về tệp đều có thể được ghi nhận từ siêu dữ liệu tệp. Khi không bằng 0, số này cho biết kích thước của bộ nhớ đệm dưới dạng số lượng hàm băm tệp cần lưu vào bộ nhớ đệm.
- Giá trị mặc định của
--[no]experimental_filter_library_jar_with_program_jar
: "false" -
Lọc ProGuard ProgramJar để xoá mọi lớp cũng có trong LibraryJar.
Thẻ:action_command_lines
- Giá trị mặc định của
--[no]experimental_inmemory_dotd_files
: "true" - Nếu được bật, các tệp .d C++ sẽ được truyền trực tiếp trong bộ nhớ từ các nút bản dựng từ xa thay vì được ghi vào ổ đĩa.
Thẻ:loading_and_analysis
,execution
,affects_outputs
,experimental
- Giá trị mặc định của
--[no]experimental_inmemory_jdeps_files
: "true" - Nếu được bật, các tệp phần phụ thuộc (.jdeps) được tạo từ các bản biên dịch Java sẽ được truyền trực tiếp trong bộ nhớ từ các nút bản dựng từ xa thay vì được ghi vào ổ đĩa.
Thẻ:loading_and_analysis
,execution
,affects_outputs
,experimental
- Giá trị mặc định của
--[no]experimental_objc_include_scanning
: "false" -
Liệu có thực hiện việc quét tìm C/C++ khách quan hay không.
Thẻ:loading_and_analysis
,execution
,changes_inputs
- Giá trị mặc định của
--[no]experimental_retain_test_configuration_across_testonly
: "false" -
Khi được bật, --trim_test_configuration sẽ không cắt bớt cấu hình kiểm thử cho các quy tắc được đánh dấu testonly=1. Điều này nhằm giảm các vấn đề xung đột hành động khi các quy tắc không phải quy tắc kiểm thử phụ thuộc vào quy tắc cc_test. Không có hiệu lực nếu --trim_test_configuration là false.
Thẻ:loading_and_analysis
,loses_incremental_state
- Giá trị mặc định của
--[no]experimental_starlark_cc_import
: "false" - Nếu được bật, bạn có thể sử dụng phiên bản Starlark của cc_import.
Thẻ:loading_and_analysis
,experimental
- Giá trị mặc định của
--[no]experimental_unsupported_and_brittle_include_scanning
: "false" -
Liệu có thu hẹp dữ liệu đầu vào cho quá trình biên dịch C/C++ bằng cách phân tích cú pháp các dòng #include từ tệp đầu vào hay không. Điều này có thể cải thiện hiệu suất và tính tăng dần bằng cách giảm kích thước của cây đầu vào biên dịch. Tuy nhiên, việc này cũng có thể làm hỏng các bản dựng vì trình quét bao gồm không triển khai đầy đủ ngữ nghĩa của trình xử lý trước C. Cụ thể, trình biên dịch này không hiểu các lệnh #include động và bỏ qua logic có điều kiện của trình xử lý trước. Bạn tự chịu rủi ro khi sử dụng. Mọi vấn đề liên quan đến cờ này đều sẽ bị đóng.
Thẻ:loading_and_analysis
,execution
,changes_inputs
- Giá trị mặc định của
--[no]incremental_dexing
: "true" -
Thực hiện hầu hết công việc tạo tệp DEX riêng cho từng tệp Jar.
Thẻ:affects_outputs
,loading_and_analysis
,loses_incremental_state
--local_cpu_resources=<an integer, or "HOST_CPUS", optionally followed by [-|*]<float>.>
mặc định: "HOST_CPUS"-
Đặt rõ ràng tổng số lõi CPU cục bộ có sẵn cho Bazel để dành cho các thao tác xây dựng được thực thi cục bộ. Nhận một số nguyên hoặc "HOST_CPUS", theo sau có thể là [-|*]<float> (ví dụ: HOST_CPUS*.5 để sử dụng một nửa số lõi CPU có sẵn). Theo mặc định ("HOST_CPUS"), Bazel sẽ truy vấn cấu hình hệ thống để ước tính số lõi CPU có sẵn.
Thẻ:host_machine_resource_optimizations
--local_extra_resources=<a named float, 'name=value'>
nhiều lần sử dụng được tích luỹ-
Đặt số lượng tài nguyên bổ sung có sẵn cho Bazel. Nhận một cặp chuỗi-float. Có thể sử dụng nhiều lần để chỉ định nhiều loại tài nguyên bổ sung. Bazel sẽ giới hạn các thao tác chạy đồng thời dựa trên tài nguyên bổ sung hiện có và tài nguyên bổ sung cần thiết. Các chương trình kiểm thử có thể khai báo lượng tài nguyên bổ sung cần thiết bằng cách sử dụng thẻ có định dạng "resources:<resoucename>:<amount>". Bạn không thể đặt CPU, RAM và tài nguyên có sẵn bằng cờ này.
Thẻ:host_machine_resource_optimizations
--local_ram_resources=<an integer number of MBs, or "HOST_RAM", optionally followed by [-|*]<float>.>
mặc định: "HOST_RAM*.67"-
Đặt rõ ràng tổng dung lượng RAM của máy chủ cục bộ (tính bằng MB) mà Bazel có thể sử dụng cho các thao tác tạo bản dựng được thực thi cục bộ. Nhận một số nguyên hoặc "HOST_RAM", theo sau có thể là [-|*]<float> (ví dụ: HOST_RAM*.5 để sử dụng một nửa RAM có sẵn). Theo mặc định, ("HOST_RAM*.67"), Bazel sẽ truy vấn cấu hình hệ thống để ước tính dung lượng RAM có sẵn và sẽ sử dụng 67% dung lượng đó.
Thẻ:host_machine_resource_optimizations
--local_resources=<a named double, 'name=value', where value is an integer, or a keyword ("auto", "HOST_CPUS", "HOST_RAM"), optionally followed by an operation ([-|*]<float>) eg. "auto", "HOST_CPUS*.5">
nhiều lần sử dụng được tích luỹ-
Đặt số lượng tài nguyên có sẵn cho Bazel. Nhận một giá trị gán cho float hoặc HOST_RAM/HOST_CPUS, theo sau có thể là [-|*]<float> (ví dụ: memory=HOST_RAM*.5 để sử dụng một nửa RAM có sẵn). Có thể sử dụng nhiều lần để chỉ định nhiều loại tài nguyên. Bazel sẽ giới hạn các thao tác chạy đồng thời dựa trên tài nguyên có sẵn và tài nguyên cần thiết. Các chương trình kiểm thử có thể khai báo lượng tài nguyên cần thiết bằng cách sử dụng thẻ có định dạng "resources:<resource name>:<amount>". Ghi đè các tài nguyên do --local_{cpu|ram|extra}_resources chỉ định.
Thẻ:host_machine_resource_optimizations
- Giá trị mặc định của
--[no]objc_use_dotd_pruning
: "true" - Nếu được đặt, các tệp .d do clang phát ra sẽ được dùng để cắt bớt tập hợp đầu vào được truyền vào các bản biên dịch objc.
Thẻ:changes_inputs
,loading_and_analysis
- Giá trị mặc định của
--[no]process_headers_in_dependencies
: "false" -
Khi tạo một mục tiêu //a:a, hãy xử lý các tiêu đề trong tất cả các mục tiêu mà //a:a phụ thuộc vào (nếu bạn bật tính năng xử lý tiêu đề cho chuỗi công cụ).
Thẻ:execution
- Giá trị mặc định của
--[no]trim_test_configuration
: "true" -
Khi được bật, các tuỳ chọn liên quan đến kiểm thử sẽ bị xoá bên dưới cấp cao nhất của bản dựng. Khi cờ này đang hoạt động, bạn không thể tạo kiểm thử dưới dạng phần phụ thuộc của các quy tắc không phải kiểm thử, nhưng các thay đổi đối với các tuỳ chọn liên quan đến kiểm thử sẽ không khiến các quy tắc không phải kiểm thử được phân tích lại.
Thẻ
:loading_and_analysis
,loses_incremental_state
- Các tuỳ chọn ảnh hưởng đến mức độ chi tiết, định dạng hoặc vị trí ghi nhật ký:
- Giá trị mặc định của
--[no]experimental_bep_target_summary
: "false" - Liệu có xuất bản sự kiện TargetSummary hay không.
- Giá trị mặc định của
--[no]experimental_build_event_expand_filesets
: "false" - Nếu đúng, hãy mở rộng Filesets (Nhóm tệp) trong BEP khi trình bày các tệp đầu ra.
Thẻ:affects_outputs
- Giá trị mặc định của
--[no]experimental_build_event_fully_resolve_fileset_symlinks
: "false" - Nếu đúng, hãy phân giải đầy đủ các đường liên kết tượng trưng của Tập hợp tệp tương đối trong BEP khi trình bày các tệp đầu ra. Yêu cầu --experimental_build_event_expand_filesets.
Thẻ:affects_outputs
--experimental_build_event_upload_max_retries=<an integer>
mặc định: "4"-
Số lần tối đa mà Bazel sẽ thử tải lại một sự kiện bản dựng.
Thẻ:bazel_internal_configuration
--experimental_build_event_upload_retry_minimum_delay=<An immutable length of time.>
mặc định: "1 giây"-
Độ trễ ban đầu, tối thiểu để thử lại thời gian đợi luỹ thừa khi tải BEP không thành công. (chỉ số: 1,6)
Thẻ:bazel_internal_configuration
--experimental_build_event_upload_strategy=<a string>
mặc định: xem nội dung mô tả-
Chọn cách tải các cấu phần phần mềm được tham chiếu trong giao thức sự kiện bản dựng lên.
Thẻ:affects_outputs
- Giá trị mặc định của
--[no]experimental_materialize_param_files_directly
: "false" - Nếu bạn hiện thực hoá các tệp tham số, hãy thực hiện việc này bằng cách ghi trực tiếp vào ổ đĩa.
Thẻ:execution
- Giá trị mặc định của
--[no]experimental_run_bep_event_include_residue
: "false" -
Liệu có đưa phần dư thừa dòng lệnh vào các sự kiện bản dựng chạy có thể chứa phần dư thừa đó hay không. Theo mặc định, phần dư không được đưa vào các sự kiện bản dựng lệnh chạy có thể chứa phần dư.
Thẻ:affects_outputs
- Giá trị mặc định của
--[no]experimental_stream_log_file_uploads
: "false" -
Tải tệp nhật ký trực tuyến lên bộ nhớ từ xa thay vì ghi vào ổ đĩa.
Thẻ:affects_outputs
--explain=<a path>
mặc định: xem nội dung mô tả-
Khiến hệ thống xây dựng giải thích từng bước thực thi của bản dựng. Nội dung giải thích được ghi vào tệp nhật ký được chỉ định.
Thẻ:affects_outputs
- Giá trị mặc định của
--[no]legacy_important_outputs
: "true" -
Sử dụng thuộc tính này để ngăn tạo trường important_outputs cũ trong sự kiện TargetComplete. Bạn cần có important_outputs để tích hợp Bazel với ResultStore.
Thẻ:affects_outputs
- Giá trị mặc định của
--[no]materialize_param_files
: "false" -
Ghi các tệp tham số trung gian vào cây đầu ra ngay cả khi sử dụng tính năng thực thi thao tác từ xa. Hữu ích khi gỡ lỗi các thao tác. Điều này được ngụ ý bởi --subcommands và --verbose_failures.
Thẻ:execution
--max_config_changes_to_show=<an integer>
mặc định: "3"-
Khi loại bỏ bộ nhớ đệm phân tích do thay đổi trong các tuỳ chọn bản dựng, hãy hiển thị tối đa số lượng tên tuỳ chọn đã thay đổi. Nếu số được cung cấp là -1, tất cả các tuỳ chọn đã thay đổi sẽ hiển thị.
Thẻ:terminal_output
--max_test_output_bytes=<an integer>
mặc định: "-1"- Chỉ định kích thước tối đa cho mỗi nhật ký kiểm thử có thể được phát ra khi --test_output là "errors" hoặc "all". Hữu ích để tránh làm quá tải đầu ra bằng đầu ra kiểm thử quá ồn. Tiêu đề kiểm thử được đưa vào kích thước nhật ký. Giá trị âm có nghĩa là không có giới hạn. Kết quả là tất cả hoặc không có gì.
Thẻ:test_runner
,terminal_output
,execution
--output_filter=<a valid Java regular expression>
mặc định: xem nội dung mô tả-
Chỉ hiển thị cảnh báo và kết quả hành động cho các quy tắc có tên khớp với biểu thức chính quy đã cung cấp.
Thẻ:affects_outputs
--progress_report_interval=<an integer in 0-3600 range>
mặc định: "0"-
Số giây chờ giữa các báo cáo về công việc vẫn đang chạy. Giá trị mặc định 0 có nghĩa là 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 sẽ được báo cáo mỗi phút một lần. Khi bạn bật --curses, tiến trình sẽ được báo cáo mỗi giây.
Thẻ:affects_outputs
--show_result=<an integer>
mặc định: "1"- Hiện kết quả của bản dựng. Đối với mỗi mục tiêu, hãy cho biết mục tiêu đó có được cập nhật hay không và nếu có, hãy liệt kê danh sách các tệp đầu ra đã được tạo. Các tệp được in là các chuỗi thuận tiện để sao chép + dán vào shell, để thực thi các tệp đó.
Tuỳ chọn này yêu cầu một đối số số nguyên, là số lượng mục tiêu ngưỡng mà nếu vượt quá thì thông tin kết quả sẽ không được in. Do đó, giá trị 0 sẽ khiến thông báo bị chặn và MAX_INT sẽ luôn in kết quả. Giá trị mặc định là 1.
Nếu không có mục tiêu nào được tạo, thì kết quả của mục tiêu đó có thể bị bỏ qua để giữ cho đầu ra nằm dưới ngưỡng.
Thẻ:affects_outputs
--[no]subcommands
[-s
] mặc định: "false"- Hiển thị các lệnh con được thực thi trong quá trình tạo bản dựng. Cờ liên quan: --execution_log_json_file, --execution_log_binary_file (để ghi nhật ký các lệnh con vào một tệp ở định dạng thân thiện với công cụ).
Thẻ:terminal_output
- Giá trị mặc định của
--test_output=<summary, errors, all or streamed>
: "summary" -
Chỉ định chế độ đầu ra mong muốn. Các giá trị hợp lệ là "summary" (tóm tắt) để chỉ xuất ra bản tóm tắt trạng thái kiểm thử, "errors" (lỗi) để cũng in nhật ký kiểm thử cho các kiểm thử không thành công, "all" (tất cả) để in nhật ký cho tất cả các kiểm thử và "streamed" (truyền trực tuyến) để xuất nhật ký cho tất cả các kiểm thử theo thời gian thực (điều này sẽ buộc các kiểm thử được thực thi cục bộ từng kiểm thử một bất kể giá trị --test_strategy).
Thẻ:test_runner
,terminal_output
,execution
--test_summary=<short, terse, detailed, none or testcase>
mặc định: "short"- Chỉ định định dạng mong muốn của bản tóm tắt kiểm thử. Các giá trị hợp lệ là "short" (ngắn) để chỉ in thông tin về các chương trình kiểm thử đã thực thi, "terse" (gọn) để chỉ in thông tin về các chương trình kiểm thử không thành công đã chạy, "detailed" (chi tiết) để in thông tin chi tiết về các trường hợp kiểm thử không thành công, "testcase" (trường hợp kiểm thử) để in bản tóm tắt trong độ phân giải trường hợp kiểm thử, không in thông tin chi tiết về các trường hợp kiểm thử không thành công và "none" (không có) để bỏ qua bản tóm tắt.
Thẻ:terminal_output
--toolchain_resolution_debug=<a comma-separated list of regex expressions with prefix '-' specifying excluded paths>
mặc định: "-.*"-
In thông tin gỡ lỗi trong quá trình phân giải chuỗi công cụ. Cờ này lấy một biểu thức chính quy, được kiểm tra dựa trên các loại chuỗi công cụ và mục tiêu cụ thể để xem cần gỡ lỗi mục nào. Bạn có thể phân tách nhiều biểu thức chính quy bằng dấu phẩy, sau đó mỗi biểu thức chính quy sẽ được kiểm tra riêng. Lưu ý: Kết quả của cờ này rất phức tạp và có thể chỉ hữu ích cho các chuyên gia về độ phân giải chuỗi công cụ.
Thẻ:terminal_output
- Giá trị mặc định của
--[no]verbose_explanations
: "false" -
Tăng độ chi tiết của nội dung giải thích được đưa ra nếu bạn bật tuỳ chọn --explain. Không có hiệu lực nếu bạn không bật --explain.
Thẻ:affects_outputs
- Giá trị mặc định của
--[no]verbose_failures
: "false" - Nếu một lệnh không thành công, hãy in toàn bộ dòng lệnh.
Thẻ:terminal_output
- Các tuỳ chọn chỉ định hoặc thay đổi dữ liệu đầu vào chung cho một lệnh Bazel không thuộc các danh mục khác.:
--aspects_parameters=<a 'name=value' assignment>
nhiều lần sử dụng được tích luỹ-
Chỉ định giá trị của các tham số khía cạnh dòng lệnh. Mỗi giá trị tham số được chỉ định thông qua <param_name>=<param_value>, ví dụ: "my_param=my_val", trong đó "my_param" là một tham số của một số khía cạnh trong danh sách --aspects hoặc bắt buộc đối với một khía cạnh trong danh sách. Bạn có thể sử dụng tuỳ chọn này nhiều lần. Tuy nhiên, bạn không được chỉ định giá trị cho cùng một tham số nhiều lần.
Thẻ:loading_and_analysis
--flag_alias=<a 'name=value' flag alias>
nhiều lần sử dụng được tích luỹ-
Đặt tên viết tắt cho cờ Starlark. Hàm này nhận một cặp khoá-giá trị duy nhất ở dạng "<khoá>=<giá trị>" làm đối số.
Thẻ:changes_inputs
- Giá trị mặc định của
--[no]incompatible_default_to_explicit_init_py
: "false" -
Cờ này thay đổi hành vi mặc định để các tệp __init__.py không còn được tạo tự động trong các tệp chạy của mục tiêu Python. Chính xác là khi mục tiêu py_binary hoặc py_test có legacy_create_init được đặt thành "tự động" (mặc định), mục tiêu đó được coi là sai nếu và chỉ khi bạn đặt cờ này. Xem https://github.com/bazelbuild/bazel/issues/10076.
Thẻ:affects_outputs
,incompatible_change
- Giá trị mặc định của
--[no]incompatible_py2_outputs_are_suffixed
: "true" - Nếu đúng, các mục tiêu được tạo trong cấu hình Python 2 sẽ xuất hiện trong thư mục gốc đầu ra có hậu tố "-py2", trong khi các mục tiêu được tạo cho Python 3 sẽ xuất hiện trong thư mục gốc không có hậu tố liên quan đến Python. Điều này có nghĩa là đường liên kết tượng trưng thuận tiện `bazel-bin` sẽ trỏ đến các mục tiêu Python 3 thay vì Python 2. Nếu bật tuỳ chọn này, bạn cũng nên bật `--incompatible_py3_is_default`.
Thẻ:affects_outputs
,incompatible_change
- Giá trị mặc định của
--[no]incompatible_py3_is_default
: "true" - Nếu đúng, các mục tiêu `py_binary` và `py_test` không đặt thuộc tính `python_version` (hoặc `default_python_version`) sẽ mặc định là PY3 thay vì PY2. Nếu đặt cờ này, bạn cũng nên đặt `--incompatible_py2_outputs_are_suffixed`.
Thẻ
:loading_and_analysis
,affects_outputs
,incompatible_change
- Giá trị mặc định của
--[no]incompatible_use_python_toolchains
: "true" - Nếu bạn đặt thành true, các quy tắc Python gốc có thể thực thi sẽ sử dụng môi trường thời gian chạy Python do chuỗi công cụ Python chỉ định, thay vì môi trường thời gian chạy do các cờ cũ như --python_top cung cấp.
Thẻ:loading_and_analysis
,incompatible_change
--python_version=<PY2 or PY3>
mặc định: xem nội dung mô tả-
Chế độ phiên bản chính của Python, "PY2" hoặc "PY3". Xin lưu ý rằng chế độ này sẽ bị ghi đè bởi các mục tiêu "py_binary" và "py_test" (ngay cả khi các mục tiêu này không chỉ định rõ ràng một phiên bản), vì vậy, thường không có lý do gì để cung cấp cờ này.
Thẻ:loading_and_analysis
,affects_outputs
--target_pattern_file=<a string>
mặc định: ""- Nếu được đặt, bản dựng sẽ đọc các mẫu từ tệp được đặt tên tại đây, thay vì trên dòng lệnh. Bạn sẽ gặp lỗi nếu chỉ định tệp tại đây cũng như các mẫu dòng lệnh.
Thẻ:changes_inputs
- Các tuỳ chọn thực thi và lưu vào bộ nhớ đệm từ xa:
--experimental_remote_cache_eviction_retries=<an integer>
mặc định: "0"- Số lần thử lại tối đa nếu bản dựng gặp lỗi tạm thời về bộ nhớ đệm từ xa khiến bản dựng không thành công. Ví dụ: áp dụng khi các cấu phần phần mềm bị xoá khỏi bộ nhớ đệm từ xa hoặc trong một số điều kiện lỗi bộ nhớ đệm nhất định. Giá trị khác 0 sẽ ngầm đặt --incompatible_remote_use_new_exit_code_for_lost_inputs thành true. Hệ thống sẽ tạo một mã gọi mới cho mỗi lần thử. Nếu tạo mã gọi và cung cấp mã gọi đó cho Bazel bằng --invocation_id, bạn không nên sử dụng cờ này. Thay vào đó, hãy đặt cờ --incompatible_remote_use_new_exit_code_for_lost_inputs và kiểm tra mã thoát 39.
Thẻ:execution
- Giá trị mặc định của
--[no]incompatible_remote_use_new_exit_code_for_lost_inputs
: "true" - Nếu được đặt thành true, Bazel sẽ sử dụng mã thoát mới 39 thay vì 34 nếu lỗi bộ nhớ đệm từ xa (bao gồm cả việc xoá bộ nhớ đệm) khiến bản dựng không thành công.
Thẻ:incompatible_change
- Các lựa chọn khác, không được phân loại.:
- Giá trị mặc định của
--[no]allow_analysis_cache_discard
: "true" - Nếu loại bỏ bộ nhớ đệm phân tích do có thay đổi trong hệ thống xây dựng, thì việc đặt tuỳ chọn này thành false sẽ khiến bazel thoát, thay vì tiếp tục bản dựng. Tuỳ chọn này không có hiệu lực khi bạn cũng đặt "discard_analysis_cache".
Thẻ:eagerness_to_exit
- Giá trị mặc định của
--[no]build_manual_tests
: "false" - Buộc tạo các mục tiêu kiểm thử được gắn thẻ "thủ công". Các kiểm thử "thủ công" sẽ không được xử lý. Tuỳ chọn này buộc các lớp này phải được tạo (nhưng không được thực thi).
--build_tag_filters=<comma-separated list of options>
mặc định: ""- Chỉ định danh sách thẻ được phân tách bằng dấu phẩy. Bạn có thể thêm dấu "-" vào đầu mỗi thẻ để chỉ định các thẻ bị loại trừ. Chỉ những mục tiêu chứa ít nhất một thẻ được đưa vào và không chứa thẻ nào bị loại trừ mới được tạo. Tuỳ chọn này không ảnh hưởng đến tập hợp các chương trình kiểm thử được thực thi bằng lệnh "test"; các chương trình kiểm thử đó được điều chỉnh theo các tuỳ chọn lọc kiểm thử, ví dụ: "--test_tag_filters"
- Giá trị mặc định của
--[no]build_tests_only
: "false" - Nếu được chỉ định, chỉ các quy tắc *_test và test_suite mới được tạo và các mục tiêu khác được chỉ định trên dòng lệnh sẽ bị bỏ qua. Theo mặc định, mọi nội dung được yêu cầu sẽ được tạo.
--[no]cache_test_results
[-t
] mặc định: "tự động"- Nếu được đặt thành "tự động", Bazel sẽ chạy lại một kiểm thử nếu và chỉ khi: (1) Bazel phát hiện thấy các thay đổi trong kiểm thử hoặc các phần phụ thuộc của kiểm thử, (2) kiểm thử được đánh dấu là bên ngoài, (3) nhiều lần chạy kiểm thử được yêu cầu bằng --runs_per_test hoặc(4) kiểm thử trước đó không thành công. Nếu được đặt thành "yes" (có), Bazel sẽ lưu tất cả kết quả kiểm thử vào bộ nhớ đệm, ngoại trừ các kiểm thử được đánh dấu là bên ngoài. Nếu bạn đặt thành "no" (không), Bazel sẽ không lưu kết quả kiểm thử vào bộ nhớ đệm.
- Giá trị mặc định của
--[no]compile_one_dependency
: "false" - Biên dịch một phần phụ thuộc của tệp đối số. Điều này rất hữu ích khi kiểm tra cú pháp của 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 phụ thuộc vào tệp nguồn để phát hiện lỗi sớm nhất có thể trong chu trình 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ả đối số không phải cờ; thay vì là mục tiêu để tạo, đó là tên tệp nguồn. Đối với mỗi tên tệp nguồn, một mục tiêu tuỳ ý phụ thuộc vào tên tệp đó sẽ được tạo.
--deleted_packages=<comma-separated list of package names>
nhiều lần sử dụng được tích luỹ- Danh sách tên gói được phân tách bằng dấu phẩy mà hệ thống xây dựng sẽ coi là không tồn tại, ngay cả khi các gói đó xuất hiện ở đâu đó trên đường dẫn gói. Sử dụng tuỳ chọn này khi xoá một gói con "x/y" của một gói hiện có "x". Ví dụ: sau khi xoá x/y/BUILD trong ứng dụng, hệ thống xây dựng có thể khiếu nại nếu gặp nhãn "//x:y/z" nếu nhãn đó vẫn được cung cấp bởi một mục package_path khác. Bạn có thể chỉ định --deleted_packages x/y để tránh vấn đề này.
- Giá trị mặc định của
--[no]discard_analysis_cache
: "false" - Huỷ bộ nhớ đệm phân tích ngay sau khi giai đoạn phân tích hoàn tất. Giảm mức sử dụng bộ nhớ khoảng 10%, nhưng làm chậm các bản dựng gia tăng hơn nữa.
--execution_log_binary_file=<a path>
mặc định: xem nội dung mô tả- Ghi lại các lần tạo được thực thi vào tệp này dưới dạng các proto SpawnExec được phân tách theo độ dài, theo src/main/protobuf/spawn.proto. Ưu tiên --execution_log_compact_file, tệp này nhỏ hơn và rẻ hơn đáng kể. Cờ liên quan: --execution_log_compact_file (định dạng thu gọn; loại trừ lẫn nhau), --execution_log_json_file (định dạng JSON văn bản; loại trừ lẫn nhau), --execution_log_sort (có sắp xếp nhật ký thực thi hay không), --subcommands (để hiển thị các lệnh con trong đầu ra của thiết bị đầu cuối).
--execution_log_compact_file=<a path>
mặc định: xem nội dung mô tả- Ghi lại các lần tạo được thực thi vào tệp này dưới dạng các proto ExecLogEntry được phân tách theo độ dài, theo src/main/protobuf/spawn.proto. Toàn bộ tệp được nén bằng thuật toán zstd. Cờ liên quan: --execution_log_binary_file (định dạng protobuf nhị phân; loại trừ lẫn nhau), --execution_log_json_file (định dạng JSON văn bản; loại trừ lẫn nhau), --subcommands (để hiển thị các lệnh con trong đầu ra của thiết bị đầu cuối).
--execution_log_json_file=<a path>
mặc định: xem nội dung mô tả- Ghi lại các lần tạo được thực thi vào tệp này dưới dạng bản trình bày JSON phân tách dòng mới của các nguyên mẫu SpawnExec, theo src/main/protobuf/spawn.proto. Ưu tiên --execution_log_compact_file, tệp này nhỏ hơn và rẻ hơn đáng kể. Cờ liên quan: --execution_log_compact_file (định dạng thu gọn; loại trừ lẫn nhau), --execution_log_binary_file (định dạng protobuf nhị phân; loại trừ lẫn nhau), --execution_log_sort (có sắp xếp nhật ký thực thi hay không), --subcommands (để hiển thị các lệnh con trong đầu ra của thiết bị đầu cuối).
- Giá trị mặc định của
--[no]execution_log_sort
: "true" - Liệu có sắp xếp nhật ký thực thi hay không, giúp dễ dàng so sánh nhật ký giữa các lệnh gọi. Đặt thành false để tránh việc sử dụng CPU và bộ nhớ có thể đáng kể khi kết thúc lệnh gọi, với chi phí tạo nhật ký theo thứ tự thực thi không xác định. Chỉ áp dụng cho định dạng tệp nhị phân và JSON; định dạng thu gọn không bao giờ được sắp xếp.
- Giá trị mặc định của
--[no]expand_test_suites
: "true" -
Mở rộng các mục tiêu test_suite thành các kiểm thử thành phần trước khi phân tích. Khi cờ này được bật (mặc định), các mẫu mục tiêu âm sẽ áp dụng cho các chương trình kiểm thử thuộc bộ kiểm thử, nếu không thì các mẫu này sẽ không áp dụng. Việc tắt cờ này sẽ hữu ích khi các khía cạnh cấp cao nhất được áp dụng tại dòng lệnh: sau đó, các khía cạnh này có thể phân tích các mục tiêu test_suite.
Thẻ:loading_and_analysis
- Giá trị mặc định của
--[no]experimental_cancel_concurrent_tests
: "false" - Nếu đúng, Blaze sẽ huỷ các chương trình kiểm thử đang chạy đồng thời trong lần chạy thành công đầu tiên. Điều này chỉ hữu ích khi kết hợp với --runs_per_test_detects_flakes.
Thẻ:affects_outputs
,loading_and_analysis
--experimental_extra_action_filter=<a comma-separated list of regex expressions with prefix '-' specifying excluded paths>
mặc định: ""- Ngừng sử dụng và thay bằng các khía cạnh. Lọc tập hợp mục tiêu để lên lịch extra_actions.
- Giá trị mặc định của
--[no]experimental_extra_action_top_level_only
: "false" - Ngừng sử dụng và thay bằng các khía cạnh. Chỉ lên lịch extra_actions cho các mục tiêu cấp cao nhất.
- Giá trị mặc định của
--[no]experimental_fetch_all_coverage_outputs
: "false" - Nếu đúng, thì Bazel sẽ tìm nạp toàn bộ thư mục dữ liệu mức độ sử dụng cho mỗi lần kiểm thử trong một lần chạy mức độ sử dụng.
Thẻ:affects_outputs
,loading_and_analysis
- Giá trị mặc định của
--[no]experimental_generate_llvm_lcov
: "false" - Nếu đúng, mức độ sử dụng cho clang sẽ tạo ra một báo cáo LCOV.
Thẻ:affects_outputs
,loading_and_analysis
- Giá trị mặc định của
--[no]experimental_j2objc_header_map
: "true" - Liệu có tạo bản đồ tiêu đề J2ObjC song song với quá trình biên dịch chuyển đổi J2ObjC hay không.
- Giá trị mặc định của
--[no]experimental_j2objc_shorter_header_path
: "false" -
Liệu có tạo bằng đường dẫn tiêu đề ngắn hơn hay không (sử dụng "_ios" thay vì "_j2objc").
Thẻ:affects_outputs
--experimental_java_classpath=<off, javabuilder or bazel>
mặc định: "javabuilder"- Bật các đường dẫn lớp rút gọn cho các bản biên dịch Java.
- Giá trị mặc định của
--[no]experimental_limit_android_lint_to_android_constrained_java
: "false" -
Giới hạn --experimental_run_android_lint_on_java_rules ở các thư viện tương thích với Android.
Thẻ:affects_outputs
- Giá trị mặc định của
--[no]experimental_run_android_lint_on_java_rules
: "false" -
Liệu có xác thực các nguồn java_* hay không.
Thẻ:affects_outputs
- Giá trị mặc định của
--[no]explicit_java_test_deps
: "false" - Chỉ định rõ ràng phần phụ thuộc cho JUnit hoặc Hamcrest trong java_test thay vì vô tình lấy từ phần phụ thuộc của TestRunner. Hiện chỉ hoạt động cho bazel.
- Giá trị mặc định của
--[no]fetch
: "true" - Cho phép lệnh tìm nạp các phần phụ thuộc bên ngoài. Nếu bạn đặt thành false, lệnh sẽ sử dụng bất kỳ phiên bản nào của phần phụ thuộc được lưu vào bộ nhớ đệm và nếu không có phiên bản nào, lệnh sẽ không thành công.
--host_java_launcher=<a build target label>
mặc định: xem nội dung mô tả- Trình chạy Java mà các công cụ thực thi trong quá trình tạo bản dựng sử dụng.
--host_javacopt=<a string>
nhiều lần sử dụng được tích luỹ- Các tuỳ chọn bổ sung để truyền vào javac khi tạo các công cụ được thực thi trong quá trình tạo bản dựng.
--host_jvmopt=<a string>
nhiều lần sử dụng được tích luỹ- Các tuỳ chọn bổ sung để truyền đến máy ảo Java khi tạo các công cụ được thực thi trong quá trình xây dựng. Các tuỳ chọn này sẽ được thêm vào tuỳ chọn khởi động máy ảo của mỗi mục tiêu java_binary.
- Giá trị mặc định của
--[no]incompatible_check_sharding_support
: "true" - Nếu giá trị là true, Bazel sẽ không kiểm thử được nếu trình chạy kiểm thử không cho biết rằng nó hỗ trợ phân đoạn bằng cách chạm vào tệp tại đường dẫn trong TEST_SHARD_STATUS_FILE. Nếu giá trị là false, trình chạy kiểm thử không hỗ trợ phân đoạn sẽ dẫn đến tất cả các kiểm thử chạy trong mỗi phân đoạn.
Thẻ:incompatible_change
- Giá trị mặc định của
--[no]incompatible_exclusive_test_sandboxed
: "true" - Nếu đúng, các thử nghiệm độc quyền sẽ chạy bằng chiến lược hộp cát. Thêm thẻ "local" để buộc chạy một kiểm thử độc quyền trên máy
Thẻ:incompatible_change
- Giá trị mặc định của
--[no]incompatible_strict_action_env
: "false" - Nếu đúng, Bazel sẽ sử dụng một môi trường có giá trị tĩnh cho PATH và không kế thừa LD_LIBRARY_PATH. Sử dụng --action_env=ENV_VARIABLE nếu bạn muốn kế thừa các biến môi trường cụ thể từ ứng dụng, nhưng lưu ý rằng việc này có thể ngăn việc lưu vào bộ nhớ đệm trên nhiều người dùng nếu bạn sử dụng bộ nhớ đệm dùng chung.
Thẻ:loading_and_analysis
,incompatible_change
--j2objc_translation_flags=<comma-separated list of options>
nhiều lần sử dụng được tích luỹ- Các tuỳ chọn bổ sung để truyền đến công cụ J2ObjC.
--java_debug
-
Khiến máy ảo Java của một kiểm thử java chờ kết nối từ trình gỡ lỗi tuân thủ JDWP (chẳng hạn như jdb) trước khi bắt đầu kiểm thử. Ngụ ý -test_output=streamed.
Mở rộng thành:
--test_arg=--wrapper_script_flag=--debug
--test_output=streamed
--test_strategy=exclusive
--test_timeout=9999
--nocache_test_results
- Giá trị mặc định của
--[no]java_deps
: "true" - Tạo thông tin phần phụ thuộc (hiện tại là đường dẫn lớp thời gian biên dịch) cho mỗi mục tiêu Java.
- Giá trị mặc định của
--[no]java_header_compilation
: "true" - Biên dịch ijar trực tiếp từ nguồn.
--java_language_version=<a string>
mặc định: ""- Phiên bản ngôn ngữ Java
--java_launcher=<a build target label>
mặc định: xem nội dung mô tả- Trình chạy Java để sử dụng khi tạo tệp nhị phân Java. Nếu bạn đặt cờ này thành chuỗi trống, trình chạy JDK sẽ được sử dụng. Thuộc tính "launcher" (trình chạy) sẽ ghi đè cờ này.
--java_runtime_version=<a string>
mặc định: "local_jdk"- Phiên bản môi trường thời gian chạy Java
--javacopt=<a string>
nhiều lần sử dụng được tích luỹ- Các tuỳ chọn bổ sung để truyền đến javac.
--jvmopt=<a string>
nhiều lần sử dụng được tích luỹ- Các tuỳ chọn bổ sung để truyền đến máy ảo Java. Các tuỳ chọn này sẽ được thêm vào tuỳ chọn khởi động máy ảo của mỗi mục tiêu java_binary.
--legacy_main_dex_list_generator=<a build target label>
mặc định: xem nội dung mô tả- Chỉ định một tệp nhị phân để sử dụng nhằm tạo danh sách các lớp phải có trong dex chính khi biên dịch multidex cũ.
--local_termination_grace_seconds=<an integer>
mặc định: "15"- Thời gian chờ giữa việc chấm dứt một quy trình cục bộ do hết thời gian chờ và buộc tắt quy trình đó.
--optimizing_dexer=<a build target label>
mặc định: xem nội dung mô tả- Chỉ định một tệp nhị phân để sử dụng cho việc tạo tệp dex mà không phân đoạn.
--package_path=<colon-separated list of options>
mặc định: "%workspace%"- Danh sách được phân tách bằng dấu hai chấm về nơi tìm kiếm các gói. Các phần tử bắt đầu bằng "%workspace%" có liên quan đến không gian làm việc bao quanh. Nếu bạn bỏ qua hoặc để trống, giá trị mặc định sẽ là kết quả của lệnh "bazel info default-package-path".
--plugin=<a build target label>
nhiều lần sử dụng được tích luỹ- Trình bổ trợ để sử dụng trong bản dựng. Hiện hoạt động với java_plugin.
--proguard_top=<a build target label>
mặc định: xem nội dung mô tả- Chỉ định phiên bản ProGuard sẽ dùng để xoá mã khi tạo tệp nhị phân Java.
--proto_compiler=<a build target label>
mặc định: "@bazel_tools//tools/proto:protoc"-
Nhãn của trình biên dịch proto.
Thẻ:affects_outputs
,loading_and_analysis
--proto_toolchain_for_cc=<a build target label>
mặc định: "@bazel_tools//tools/proto:cc_toolchain"-
Nhãn của proto_lang_toolchain() mô tả cách biên dịch proto C++
Thẻ:affects_outputs
,loading_and_analysis
--proto_toolchain_for_j2objc=<a build target label>
mặc định: "@bazel_tools//tools/j2objc:j2objc_proto_toolchain"-
Nhãn của proto_lang_toolchain() mô tả cách biên dịch proto j2objc
Thẻ:affects_outputs
,loading_and_analysis
--proto_toolchain_for_java=<a build target label>
mặc định: "@bazel_tools//tools/proto:java_toolchain"-
Nhãn của proto_lang_toolchain() mô tả cách biên dịch proto Java
Thẻ:affects_outputs
,loading_and_analysis
--proto_toolchain_for_javalite=<a build target label>
mặc định: "@bazel_tools//tools/proto:javalite_toolchain"-
Nhãn của proto_lang_toolchain() mô tả cách biên dịch proto JavaLite
Thẻ:affects_outputs
,loading_and_analysis
--protocopt=<a string>
nhiều lần sử dụng được tích luỹ-
Các tuỳ chọn bổ sung để truyền đến trình biên dịch protobuf.
Thẻ:affects_outputs
- Giá trị mặc định của
--[no]runs_per_test_detects_flakes
: "false" - Nếu đúng, mọi phân mảnh có ít nhất một lần chạy/thử nghiệm thành công và ít nhất một lần chạy/thử nghiệm không thành công sẽ có trạng thái FLAKY.
--shell_executable=<a path>
mặc định: xem nội dung mô tả-
Đường dẫn tuyệt đối đến tệp thực thi shell để Bazel sử dụng. Nếu bạn không đặt biến này nhưng đặt biến môi trường BAZEL_SH trong lệnh gọi Bazel đầu tiên (lệnh gọi này sẽ khởi động máy chủ Bazel), thì Bazel sẽ sử dụng biến đó. Nếu bạn không đặt cả hai, Bazel sẽ sử dụng đường dẫn mặc định được mã hoá cứng tuỳ thuộc vào hệ điều hành mà nó chạy (Windows: c:/tools/msys64/usr/bin/bash.exe, FreeBSD: /usr/local/bin/bash, tất cả các hệ điều hành khác: /bin/bash). Xin lưu ý rằng việc sử dụng một shell không tương thích với bash có thể dẫn đến lỗi bản dựng hoặc lỗi thời gian chạy của các tệp nhị phân được tạo.
Thẻ:loading_and_analysis
- Giá trị mặc định của
--[no]show_loading_progress
: "true" - Nếu được bật, sẽ khiến Bazel in thông báo "Loading package" ("Đang tải gói").
--test_arg=<a string>
nhiều lần sử dụng được tích luỹ- Chỉ định các tuỳ chọn và đối số bổ sung cần được truyền đến tệp thực thi kiểm thử. Có thể sử dụng nhiều lần để chỉ định một số đối số. Nếu nhiều chương trình kiểm thử được thực thi, thì mỗi chương trình kiểm thử sẽ nhận được các đối số giống hệt nhau. Chỉ được lệnh "bazel test" sử dụng.
--test_filter=<a string>
mặc định: xem nội dung mô tả- Chỉ định một bộ lọc để chuyển tiếp đến khung kiểm thử. Dùng để giới hạn số lượng kiểm thử được chạy. Xin lưu ý rằng điều này không ảnh hưởng đến việc xây dựng mục tiêu nào.
--test_lang_filters=<comma-separated list of options>
mặc định: ""- Chỉ định danh sách ngôn ngữ kiểm thử được phân tách bằng dấu phẩy. Bạn có thể thêm dấu "-" vào đầu mỗi ngôn ngữ để chỉ định các ngôn ngữ bị loại trừ. Chỉ những mục tiêu kiểm thử được viết bằng các ngôn ngữ đã chỉ định mới được tìm thấy. 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ụ: một trong các tên "cc", "java", "py", v.v. Tuỳ chọn này ảnh hưởng đến hành vi --build_tests_only và lệnh kiểm thử.
--test_result_expiration=<an integer>
mặc định: "-1"- Tuỳ chọn này không được dùng nữa và không có hiệu lực.
- Giá trị mặc định của
--[no]test_runner_fail_fast
: "false" - Chuyển tiếp tuỳ chọn thất bại nhanh đến trình chạy kiểm thử. Trình chạy kiểm thử sẽ dừng thực thi khi gặp lỗi đầu tiên.
--test_sharding_strategy=<explicit, disabled or forced=k where k is the number of shards to enforce>
mặc định: "explicit"- Chỉ định chiến lược phân đoạn kiểm thử: "rõ ràng" để chỉ sử dụng phân đoạn nếu có thuộc tính BUILD "shard_count". "disabled" để không bao giờ sử dụng tính năng phân đoạn kiểm thử. "forced=k" để thực thi các phân đoạn "k" cho hoạt động kiểm thử bất kể thuộc tính BUILD "shard_count".
--test_size_filters=<comma-separated list of values: small, medium, large or enormous>
mặc định: ""- Chỉ định danh sách kích thước kiểm thử được phân tách bằng dấu phẩy. Bạn có thể thêm dấu "-" vào trước mỗi kích thước để chỉ định các kích thước bị loại trừ (không bắt buộc). Chỉ những mục tiêu kiểm thử chứa ít nhất một kích thước được đưa vào và không chứa kích thước nào bị loại trừ mới được tìm thấy. Tuỳ chọn này ảnh hưởng đến hành vi --build_tests_only và lệnh kiểm thử.
--test_tag_filters=<comma-separated list of options>
mặc định: ""- Chỉ định danh sách thẻ kiểm thử được phân tách bằng dấu phẩy. Bạn có thể thêm dấu "-" vào đầu mỗi thẻ để chỉ định các thẻ bị loại trừ. Chỉ những mục tiêu kiểm thử chứa ít nhất một thẻ được đưa vào và không chứa thẻ nào bị loại trừ mới được tìm thấy. Tuỳ chọn này ảnh hưởng đến hành vi --build_tests_only và lệnh kiểm thử.
--test_timeout_filters=<comma-separated list of values: short, moderate, long or eternal>
mặc định: ""- Chỉ định danh sách thời gian chờ kiểm thử được phân tách bằng dấu phẩy. Bạn có thể thêm dấu "-" vào trước mỗi khoảng thời gian chờ để chỉ định các khoảng thời gian chờ bị loại trừ. Chỉ những mục tiêu kiểm thử chứa ít nhất một thời gian chờ được đưa vào và không chứa bất kỳ thời gian chờ nào bị loại trừ mới được tìm thấy. Tuỳ chọn này ảnh hưởng đến hành vi --build_tests_only và lệnh kiểm thử.
--tool_java_language_version=<a string>
mặc định: ""- Phiên bản ngôn ngữ Java dùng để thực thi các công cụ cần thiết trong quá trình tạo bản dựng
--tool_java_runtime_version=<a string>
mặc định: "remotejdk_11"- Phiên bản thời gian chạy Java dùng để thực thi các công cụ trong quá trình tạo bản dựng
- Giá trị mặc định của
--[no]use_ijars
: "true" - Nếu được bật, tuỳ chọn này sẽ khiến quá trình biên dịch Java sử dụng các tệp jar giao diện. Điều này sẽ giúp quá trình biên dịch tăng dần diễn ra nhanh hơn, nhưng thông báo lỗi có thể khác.
Tuỳ chọn cờ chuẩn hoá
Kế thừa tất cả các tuỳ chọn từ build.
- Các tuỳ chọn xuất hiện trước lệnh và được máy khách phân tích cú pháp:
--distdir=<a path>
nhiều lần sử dụng được tích luỹ-
Các vị trí khác để tìm kiếm bản lưu trữ trước khi truy cập vào mạng để tải xuống.
Thẻ:bazel_internal_configuration
- Giá trị mặc định của
--[no]experimental_repository_cache_hardlinks
: "false" - Nếu được đặt, bộ nhớ đệm kho lưu trữ sẽ liên kết cứng tệp trong trường hợp có lượt truy cập vào bộ nhớ đệm, thay vì sao chép. Việc này nhằm tiết kiệm dung lượng ổ đĩa.
Thẻ:bazel_internal_configuration
--experimental_repository_downloader_retries=<an integer>
mặc định: "0"-
Số lần thử tối đa để thử lại lỗi tải xuống. Nếu bạn đặt thành 0, thì tính năng thử lại sẽ bị tắt.
Thẻ:experimental
--experimental_scale_timeouts=<a double>
mặc định: "1.0"- Điều chỉnh tất cả thời gian chờ trong quy tắc kho lưu trữ Starlark theo hệ số này. Bằng cách này, bạn có thể làm cho kho lưu trữ bên ngoài hoạt động trên các máy chạy chậm hơn dự kiến của tác giả quy tắc mà không cần thay đổi mã nguồn
Thẻ:bazel_internal_configuration
,experimental
- Giá trị mặc định của
--[no]incompatible_disable_native_repo_rules
: "false" - Nếu giá trị là false, bạn có thể sử dụng các quy tắc kho lưu trữ gốc trong WORKSPACE; nếu không, bạn phải sử dụng các quy tắc kho lưu trữ Starlark. Các quy tắc kho lưu trữ gốc bao gồm local_repository, new_local_repository, local_config_platform, android_sdk_repository và android_ndk_repository.
Thẻ:bazel_internal_configuration
--repository_cache=<a path>
mặc định: xem nội dung mô tả- Chỉ định vị trí bộ nhớ đệm của các giá trị đã tải xuống thu được trong quá trình tìm nạp kho lưu trữ bên ngoài. Chuỗi trống làm đối số yêu cầu tắt bộ nhớ đệm, nếu không, giá trị mặc định là "<output_user_root>/cache/repos/v1" sẽ được sử dụng
Thẻ:bazel_internal_configuration
- Giá trị mặc định của
--[no]repository_disable_download
: "false" - Nếu được đặt, bạn không được phép tải xuống bằng ctx.download{,_and_extract} trong quá trình tìm nạp kho lưu trữ. Xin lưu ý rằng quyền truy cập mạng không bị tắt hoàn toàn; ctx.execute vẫn có thể chạy một tệp thực thi tuỳ ý truy cập Internet.
Thẻ:bazel_internal_configuration
- Các tuỳ chọn kiểm soát việc thực thi bản dựng:
- Giá trị mặc định của
--gc_thrashing_threshold=<an integer in 0-100 range>
: "100" -
Tỷ lệ phần trăm không gian cố định bị chiếm dụng (0-100) mà tại đó GcThrashingDetector xem xét các sự kiện áp lực bộ nhớ so với giới hạn của nó (--gc_thrashing_limits). Nếu bạn đặt thành 100, GcThrashingDetector sẽ bị tắt.
Thẻ:host_machine_resource_optimizations
- Các tuỳ chọn kiểm soát đầu ra của lệnh:
- Giá trị mặc định của
--[no]canonicalize_policy
: "false" -
Xuất chính sách chuẩn hoá, sau khi mở rộng và lọc. Để giữ cho kết quả luôn rõ ràng, các đối số lệnh đã chuẩn hoá sẽ KHÔNG xuất hiện khi bạn đặt tuỳ chọn này thành true. Xin lưu ý rằng lệnh do --for_command chỉ định sẽ ảnh hưởng đến chính sách đã lọc và nếu không có lệnh nào được chỉ định, thì lệnh mặc định sẽ là "build".
Thẻ:affects_outputs
,terminal_output
- Giá trị mặc định của
--[no]experimental_include_default_values
: "false" -
Liệu các tuỳ chọn Starlark được đặt thành giá trị mặc định có được đưa vào kết quả hay không.
Thẻ:affects_outputs
,terminal_output
- Tuỳ chọn này ảnh hưởng đến ngữ nghĩa của ngôn ngữ Starlark hoặc API bản dựng có thể truy cập vào các tệp BUILD, tệp .bzl hoặc tệp WORKSPACE.:
- Giá trị mặc định của
--[no]incompatible_config_setting_private_default_visibility
: "false" - Nếu incompatible_enforce_config_setting_visibility=false, thì đây là một thao tác không có tác dụng. Nếu không, nếu cờ này là false, mọi config_setting không có thuộc tính chế độ hiển thị rõ ràng sẽ là //visibility:public. Nếu cờ này là true, config_setting sẽ tuân theo logic hiển thị giống như tất cả các quy tắc khác. Xem https://github.com/bazelbuild/bazel/issues/12933.
Thẻ:loading_and_analysis
,incompatible_change
- Giá trị mặc định của
--[no]incompatible_enforce_config_setting_visibility
: "true" - Nếu đúng, hãy thực thi các quy định hạn chế về chế độ hiển thị config_setting. Nếu giá trị là false, mọi mục config_setting đều hiển thị với mọi mục tiêu. Xem https://github.com/bazelbuild/bazel/issues/12932.
Thẻ:loading_and_analysis
,incompatible_change
- Các tuỳ chọn liên quan đến kết quả và ngữ nghĩa của Bzlmod:
--allow_yanked_versions=<a string>
nhiều lần sử dụng được tích luỹ-
Chỉ định các phiên bản mô-đun ở dạng `<module1>@<version1>,<module2>@<version2>` sẽ được cho phép trong biểu đồ phần phụ thuộc đã phân giải ngay cả khi các phiên bản đó được khai báo là đã bị xoá trong sổ đăng ký nơi chúng đến (nếu không đến từ NonRegistryOverride). Nếu không, các phiên bản bị xoá sẽ khiến việc phân giải không thành công. Bạn cũng có thể xác định phiên bản bị xoá được phép bằng biến môi trường `BZLMOD_ALLOW_YANKED_VERSIONS`. Bạn có thể tắt tính năng kiểm tra này bằng cách sử dụng từ khoá "tất cả" (không nên dùng).
Thẻ:loading_and_analysis
--check_bazel_compatibility=<error, warning or off>
mặc định: "lỗi"-
Kiểm tra khả năng tương thích của phiên bản bazel của các mô-đun Bazel. Các giá trị hợp lệ là "error" để chuyển vấn đề này lên lỗi phân giải, "off" để tắt tính năng kiểm tra hoặc "warning" để in cảnh báo khi phát hiện thấy không khớp.
Thẻ:loading_and_analysis
--check_direct_dependencies=<off, warning or error>
mặc định: "cảnh báo"-
Kiểm tra xem các phần phụ thuộc `bazel_dep` trực tiếp được khai báo trong mô-đun gốc có phải là các phiên bản mà bạn nhận được trong biểu đồ phần phụ thuộc đã được phân giải hay không. Các giá trị hợp lệ là "off" để tắt tính năng kiểm tra, "warning" để in cảnh báo khi phát hiện thấy không khớp hoặc "error" để chuyển lên lỗi phân giải.
Thẻ:loading_and_analysis
- Giá trị mặc định của
--[no]ignore_dev_dependency
: "false" - Nếu đúng, Bazel sẽ bỏ qua "bazel_dep" và "use_extension" được khai báo là "dev_dependency" trong MODULE.bazel của mô-đun gốc. Xin lưu ý rằng các phần phụ thuộc dành cho nhà phát triển đó luôn bị bỏ qua trong MODULE.bazel nếu đó không phải là mô-đun gốc, bất kể giá trị của cờ này là gì.
Thẻ:loading_and_analysis
--lockfile_mode=<off, update, refresh or error>
mặc định: "cập nhật"-
Chỉ định cách thức và liệu có sử dụng tệp khoá hay không. Các giá trị hợp lệ là "update" để sử dụng tệp khoá và cập nhật tệp khoá nếu có thay đổi, "refresh" để thỉnh thoảng làm mới thông tin có thể thay đổi (các phiên bản bị loại bỏ và các mô-đun bị thiếu trước đó) từ các sổ đăng ký từ xa, "error" để sử dụng tệp khoá nhưng gửi lỗi nếu tệp khoá không được cập nhật hoặc "off" để không đọc hoặc ghi vào tệp khoá.
Thẻ:loading_and_analysis
--override_module=<an equals-separated mapping of module name to path>
nhiều lần sử dụng được tích luỹ- Ghi đè một mô-đun bằng đường dẫn cục bộ ở dạng <tên mô-đun>=<đường dẫn>. Nếu đường dẫn đã cho là đường dẫn tuyệt đối, thì đường dẫn đó sẽ được sử dụng nguyên trạng. Nếu đường dẫn đã cho là đường dẫn tương đối, thì đường dẫn đó sẽ tương ứng với thư mục đang hoạt động. Nếu đường dẫn đã cho bắt đầu bằng "%workspace%", thì đường dẫn đó sẽ tương ứng với thư mục gốc của không gian làm việc, là kết quả của lệnh "bazel info workspace". Nếu đường dẫn đã cho trống, hãy xoá mọi chế độ ghi đè trước đó.
--registry=<a string>
nhiều lần sử dụng được tích luỹ- Chỉ định các sổ đăng ký cần sử dụng để xác định vị trí các phần phụ thuộc mô-đun Bazel. Thứ tự rất quan trọng: các mô-đun sẽ được tra cứu trong các sổ đăng ký trước đó trước tiên và chỉ quay lại các sổ đăng ký sau này khi các mô-đun đó bị thiếu trong các sổ đăng ký trước đó.
Thẻ:changes_inputs
--vendor_dir=<a path>
mặc định: xem nội dung mô tả-
Chỉ định thư mục sẽ chứa các kho lưu trữ bên ngoài ở chế độ nhà cung cấp, cho dù mục đích là tìm nạp các kho lưu trữ đó vào thư mục hay sử dụng các kho lưu trữ đó trong khi xây dựng. Bạn có thể chỉ định đường dẫn dưới dạng đường dẫn tuyệt đối hoặc đường dẫn tương đối đến thư mục không gian làm việc.
Thẻ:loading_and_analysis
- Các tuỳ chọn kích hoạt tính năng tối ưu hoá thời gian xây dựng:
--gc_thrashing_limits=<comma separated pairs of <period>:<count>>
mặc định: "1s:2,20s:3,1m:5"-
Các giới hạn nếu đạt đến sẽ khiến GcThrashingDetector gặp sự cố Bazel với OOM. Mỗi giới hạn được chỉ định là <period>:<count>, trong đó period là thời lượng và count là số nguyên dương. Nếu hơn --gc_thrashing_threshold phần trăm không gian cố định (vùng nhớ khối xếp cũ) vẫn bị chiếm dụng sau <count> lần GC đầy đủ liên tiếp trong <period>, thì lỗi OOM sẽ được kích hoạt. Bạn có thể chỉ định nhiều giới hạn, phân tách bằng dấu phẩy.
Thẻ:host_machine_resource_optimizations
--skyframe_high_water_mark_full_gc_drops_per_invocation=<an integer, >= 0>
mặc định: "2147483647"-
Cờ cho cấu hình nâng cao của công cụ Skyframe nội bộ của Bazel. Nếu phát hiện mức sử dụng phần trăm vùng nhớ khối xếp được giữ lại vượt quá ngưỡng do --skyframe_high_water_mark_threshold đặt ra, thì khi một sự kiện GC đầy đủ xảy ra, Bazel sẽ loại bỏ trạng thái Skyframe tạm thời không cần thiết, lên đến nhiều lần như vậy cho mỗi lệnh gọi. Mặc định là Integer.MAX_VALUE; không giới hạn về mặt hiệu quả. Giá trị 0 có nghĩa là các sự kiện GC đầy đủ sẽ không bao giờ kích hoạt sự kiện thả. Nếu đạt đến giới hạn, trạng thái Skyframe sẽ không còn bị loại bỏ khi một sự kiện GC đầy đủ xảy ra và vượt quá ngưỡng phần trăm vùng nhớ khối xếp được giữ lại đó.
Thẻ:host_machine_resource_optimizations
--skyframe_high_water_mark_minor_gc_drops_per_invocation=<an integer, >= 0>
mặc định: "2147483647"-
Cờ cho cấu hình nâng cao của công cụ Skyframe nội bộ của Bazel. Nếu phát hiện mức sử dụng phần trăm vùng nhớ khối xếp được giữ lại vượt quá ngưỡng do --skyframe_high_water_mark_threshold đặt ra, thì khi một sự kiện GC nhỏ xảy ra, Bazel sẽ loại bỏ trạng thái Skyframe tạm thời không cần thiết, lên đến nhiều lần như vậy mỗi lần gọi. Mặc định là Integer.MAX_VALUE; không giới hạn về mặt hiệu quả. Giá trị 0 có nghĩa là các sự kiện GC nhỏ sẽ không bao giờ kích hoạt sự kiện thả. Nếu đạt đến giới hạn, trạng thái Skyframe sẽ không còn bị loại bỏ khi một sự kiện GC nhỏ xảy ra và vượt quá ngưỡng phần trăm vùng nhớ khối xếp được giữ lại.
Thẻ:host_machine_resource_optimizations
--skyframe_high_water_mark_threshold=<an integer>
mặc định: "85"-
Cờ cho cấu hình nâng cao của công cụ Skyframe nội bộ của Bazel. Nếu phát hiện mức sử dụng phần trăm vùng nhớ khối xếp được giữ lại ít nhất là ngưỡng này, Bazel sẽ loại bỏ trạng thái Skyframe tạm thời không cần thiết. Việc điều chỉnh điều này có thể giúp bạn giảm thiểu tác động của tình trạng GC bị lỗi khi (i) tình trạng này là do mức sử dụng bộ nhớ của trạng thái tạm thời và (ii) tốn kém hơn so với việc tạo lại trạng thái khi cần.
Thẻ:host_machine_resource_optimizations
- Các tuỳ chọn ảnh hưởng đến mức độ chi tiết, định dạng hoặc vị trí ghi nhật ký:
--experimental_command_profile=<cpu, wall, alloc or lock>
mặc định: xem nội dung mô tả- Ghi hồ sơ Trình ghi chuyến bay Java trong thời gian thực thi lệnh. Bạn phải cung cấp một trong các loại sự kiện phân tích tài nguyên được hỗ trợ (cpu, wall, alloc hoặc lock) dưới dạng đối số. Hồ sơ được ghi vào một tệp được đặt tên theo loại sự kiện trong thư mục cơ sở đầu ra. Cú pháp và ngữ nghĩa của cờ này có thể thay đổi trong tương lai để hỗ trợ thêm các loại hồ sơ hoặc định dạng đầu ra; bạn tự chịu rủi ro khi sử dụng.
- Giá trị mặc định của
--[no]experimental_record_metrics_for_all_mnemonics
: "false" - Theo mặc định, số lượng loại thao tác được giới hạn ở 20 câu thần chú có số lượng thao tác được thực thi nhiều nhất. Việc đặt tuỳ chọn này sẽ ghi số liệu thống kê cho tất cả các câu thần chú.
- Các tuỳ chọn chỉ định hoặc thay đổi dữ liệu đầu vào chung thành một lệnh Bazel không thuộc các danh mục khác.:
--experimental_resolved_file_instead_of_workspace=<a string>
mặc định: ""- Nếu không trống, hãy đọc tệp đã phân giải được chỉ định thay vì tệp WORKSPACE Thẻ
:changes_inputs
--for_command=<a string>
mặc định: "build"- Lệnh mà các tuỳ chọn phải được chuẩn hoá.
Thẻ:affects_outputs
,terminal_output
--invocation_policy=<a string>
mặc định: ""-
Áp dụng chính sách gọi cho các tuỳ chọn cần được chuẩn hoá.
Thẻ:affects_outputs
,terminal_output
- Các tuỳ chọn thực thi và lưu vào bộ nhớ đệm từ xa:
--experimental_downloader_config=<a string>
mặc định: xem nội dung mô tả- Chỉ định một tệp để định cấu hình trình tải xuống từ xa. Tệp này bao gồm các dòng, mỗi dòng bắt đầu bằng một lệnh (`allow`, `block` hoặc `rewrite`), theo sau là tên máy chủ lưu trữ (đối với lệnh `allow` và `block`) hoặc hai mẫu, một mẫu để so khớp và một mẫu để sử dụng làm URL thay thế, với các tệp tham chiếu ngược bắt đầu từ `$1`. Bạn có thể cung cấp nhiều lệnh `rewrite` cho cùng một URL và trong trường hợp này, nhiều URL sẽ được trả về.
- Giá trị mặc định của
--experimental_worker_for_repo_fetching=<off, platform, virtual or auto>
: "tự động" - Chế độ tạo luồng để tìm nạp kho lưu trữ. Nếu bạn đặt thành "tắt", thì không có luồng worker nào được sử dụng và quá trình tìm nạp kho lưu trữ sẽ phải khởi động lại. Nếu không, hãy sử dụng luồng worker ảo.
- Các tuỳ chọn khác, không được phân loại theo cách khác.:
--deleted_packages=<comma-separated list of package names>
nhiều lần sử dụng được tích luỹ- Danh sách tên gói được phân tách bằng dấu phẩy mà hệ thống xây dựng sẽ coi là không tồn tại, ngay cả khi các gói đó xuất hiện ở đâu đó trên đường dẫn gói. Sử dụng tuỳ chọn này khi xoá một gói con "x/y" của một gói hiện có "x". Ví dụ: sau khi xoá x/y/BUILD trong ứng dụng, hệ thống xây dựng có thể khiếu nại nếu gặp nhãn "//x:y/z" nếu nhãn đó vẫn được cung cấp bởi một mục package_path khác. Bạn có thể chỉ định --deleted_packages x/y để tránh vấn đề này.
- Giá trị mặc định của
--[no]fetch
: "true" - Cho phép lệnh tìm nạp các phần phụ thuộc bên ngoài. Nếu bạn đặt thành false, lệnh sẽ sử dụng bất kỳ phiên bản nào của phần phụ thuộc được lưu vào bộ nhớ đệm và nếu không có phiên bản nào, lệnh sẽ không thành công.
--override_repository=<an equals-separated mapping of repository name to path>
nhiều lần sử dụng được tích luỹ- Ghi đè kho lưu trữ bằng một đường dẫn cục bộ ở dạng <repository name>=<path>. Nếu đường dẫn đã cho là đường dẫn tuyệt đối, thì đường dẫn đó sẽ được sử dụng nguyên trạng. Nếu đường dẫn đã cho là đường dẫn tương đối, thì đường dẫn đó sẽ tương ứng với thư mục đang hoạt động. Nếu đường dẫn đã cho bắt đầu bằng "%workspace%", thì đường dẫn đó sẽ tương ứng với thư mục gốc của không gian làm việc, là kết quả của lệnh "bazel info workspace". Nếu đường dẫn đã cho trống, hãy xoá mọi chế độ ghi đè trước đó.
--package_path=<colon-separated list of options>
mặc định: "%workspace%"- Danh sách được phân tách bằng dấu hai chấm về nơi tìm kiếm các gói. Các phần tử bắt đầu bằng "%workspace%" có liên quan đến không gian làm việc bao quanh. Nếu bạn bỏ qua hoặc để trống, giá trị mặc định sẽ là kết quả của lệnh "bazel info default-package-path".
- Giá trị mặc định của
--[no]show_loading_progress
: "true" - Nếu được bật, sẽ khiến Bazel in thông báo "Loading package" ("Đang tải gói").
Lựa chọn dọn dẹp
Kế thừa tất cả các tuỳ chọn từ build.
- Các tuỳ chọn xuất hiện trước lệnh và được máy khách phân tích cú pháp:
--distdir=<a path>
nhiều lần sử dụng được tích luỹ-
Các vị trí khác để tìm kiếm bản lưu trữ trước khi truy cập vào mạng để tải xuống.
Thẻ:bazel_internal_configuration
- Giá trị mặc định của
--[no]experimental_repository_cache_hardlinks
: "false" - Nếu được đặt, bộ nhớ đệm kho lưu trữ sẽ liên kết cứng tệp trong trường hợp có lượt truy cập vào bộ nhớ đệm, thay vì sao chép. Việc này nhằm tiết kiệm dung lượng ổ đĩa.
Thẻ:bazel_internal_configuration
--experimental_repository_downloader_retries=<an integer>
mặc định: "0"-
Số lần thử tối đa để thử lại lỗi tải xuống. Nếu bạn đặt thành 0, thì tính năng thử lại sẽ bị tắt.
Thẻ:experimental
--experimental_scale_timeouts=<a double>
mặc định: "1.0"- Điều chỉnh tất cả thời gian chờ trong quy tắc kho lưu trữ Starlark theo hệ số này. Bằng cách này, bạn có thể làm cho kho lưu trữ bên ngoài hoạt động trên các máy chạy chậm hơn dự kiến của tác giả quy tắc mà không cần thay đổi mã nguồn
Thẻ:bazel_internal_configuration
,experimental
- Giá trị mặc định của
--[no]incompatible_disable_native_repo_rules
: "false" - Nếu giá trị là false, bạn có thể sử dụng các quy tắc kho lưu trữ gốc trong WORKSPACE; nếu không, bạn phải sử dụng các quy tắc kho lưu trữ Starlark. Các quy tắc kho lưu trữ gốc bao gồm local_repository, new_local_repository, local_config_platform, android_sdk_repository và android_ndk_repository.
Thẻ:bazel_internal_configuration
--repository_cache=<a path>
mặc định: xem nội dung mô tả- Chỉ định vị trí bộ nhớ đệm của các giá trị đã tải xuống thu được trong quá trình tìm nạp kho lưu trữ bên ngoài. Chuỗi trống làm đối số yêu cầu tắt bộ nhớ đệm, nếu không, giá trị mặc định là "<output_user_root>/cache/repos/v1" sẽ được sử dụng
Thẻ:bazel_internal_configuration
- Giá trị mặc định của
--[no]repository_disable_download
: "false" - Nếu được đặt, bạn không được phép tải xuống bằng ctx.download{,_and_extract} trong quá trình tìm nạp kho lưu trữ. Xin lưu ý rằng quyền truy cập mạng không bị tắt hoàn toàn; ctx.execute vẫn có thể chạy một tệp thực thi tuỳ ý truy cập Internet.
Thẻ:bazel_internal_configuration
- Các tuỳ chọn kiểm soát việc thực thi bản dựng:
- Giá trị mặc định của
--gc_thrashing_threshold=<an integer in 0-100 range>
: "100" -
Tỷ lệ phần trăm không gian cố định bị chiếm dụng (0-100) mà tại đó GcThrashingDetector xem xét các sự kiện áp lực bộ nhớ so với giới hạn của nó (--gc_thrashing_limits). Nếu bạn đặt thành 100, GcThrashingDetector sẽ bị tắt.
Thẻ:host_machine_resource_optimizations
- Các tuỳ chọn kiểm soát đầu ra của lệnh:
- Giá trị mặc định của
--[no]async
: "false" - Nếu đúng, việc dọn dẹp đầu ra sẽ không đồng bộ. Khi lệnh này hoàn tất, bạn có thể an toàn thực thi các lệnh mới trong cùng một ứng dụng, mặc dù quá trình xoá có thể tiếp tục trong nền.
Thẻ:host_machine_resource_optimizations
- Giá trị mặc định của
--[no]expunge
: "false" - Nếu đúng, lệnh clean sẽ xoá toàn bộ cây hoạt động cho thực thể bazel này, bao gồm tất cả các tệp đầu ra tạm thời và bản dựng do bazel tạo, đồng thời dừng máy chủ bazel nếu máy chủ này đang chạy.
Thẻ:host_machine_resource_optimizations
--expunge_async
- Nếu được chỉ định, lệnh dọn sạch sẽ xoá không đồng bộ toàn bộ cây hoạt động cho thực thể bazel này, bao gồm tất cả các tệp đầu ra tạm thời và bản dựng do bazel tạo, đồng thời dừng máy chủ bazel nếu đang chạy. Khi lệnh này hoàn tất, bạn có thể an toàn thực thi các lệnh mới trong cùng một ứng dụng, mặc dù quá trình xoá có thể tiếp tục trong nền.
Mở rộng thành:
--expunge
--async
Thẻ:host_machine_resource_optimizations
- Tuỳ chọn liên quan đến kết quả và ngữ nghĩa của Bzlmod:
--allow_yanked_versions=<a string>
nhiều lần sử dụng được tích luỹ-
Chỉ định các phiên bản mô-đun ở dạng `<module1>@<version1>,<module2>@<version2>` sẽ được cho phép trong biểu đồ phần phụ thuộc đã phân giải ngay cả khi các phiên bản đó được khai báo là đã bị xoá trong sổ đăng ký nơi chúng đến (nếu không đến từ NonRegistryOverride). Nếu không, các phiên bản bị xoá sẽ khiến việc phân giải không thành công. Bạn cũng có thể xác định phiên bản bị xoá được phép bằng biến môi trường `BZLMOD_ALLOW_YANKED_VERSIONS`. Bạn có thể tắt tính năng kiểm tra này bằng cách sử dụng từ khoá "tất cả" (không nên dùng).
Thẻ:loading_and_analysis
--check_bazel_compatibility=<error, warning or off>
mặc định: "lỗi"-
Kiểm tra khả năng tương thích của phiên bản bazel của các mô-đun Bazel. Các giá trị hợp lệ là "error" để chuyển vấn đề này lên lỗi phân giải, "off" để tắt tính năng kiểm tra hoặc "warning" để in cảnh báo khi phát hiện thấy không khớp.
Thẻ:loading_and_analysis
--check_direct_dependencies=<off, warning or error>
mặc định: "cảnh báo"-
Kiểm tra xem các phần phụ thuộc `bazel_dep` trực tiếp được khai báo trong mô-đun gốc có phải là các phiên bản mà bạn nhận được trong biểu đồ phần phụ thuộc đã được phân giải hay không. Các giá trị hợp lệ là "off" để tắt tính năng kiểm tra, "warning" để in cảnh báo khi phát hiện thấy không khớp hoặc "error" để chuyển lên lỗi phân giải.
Thẻ:loading_and_analysis
- Giá trị mặc định của
--[no]ignore_dev_dependency
: "false" - Nếu đúng, Bazel sẽ bỏ qua "bazel_dep" và "use_extension" được khai báo là "dev_dependency" trong MODULE.bazel của mô-đun gốc. Xin lưu ý rằng các phần phụ thuộc dành cho nhà phát triển đó luôn bị bỏ qua trong MODULE.bazel nếu đó không phải là mô-đun gốc, bất kể giá trị của cờ này là gì.
Thẻ:loading_and_analysis
--lockfile_mode=<off, update, refresh or error>
mặc định: "cập nhật"-
Chỉ định cách thức và liệu có sử dụng tệp khoá hay không. Các giá trị hợp lệ là "update" để sử dụng tệp khoá và cập nhật tệp khoá nếu có thay đổi, "refresh" để thỉnh thoảng làm mới thông tin có thể thay đổi (các phiên bản bị loại bỏ và các mô-đun bị thiếu trước đó) từ các sổ đăng ký từ xa, "error" để sử dụng tệp khoá nhưng gửi lỗi nếu tệp khoá không được cập nhật hoặc "off" để không đọc hoặc ghi vào tệp khoá.
Thẻ:loading_and_analysis
--override_module=<an equals-separated mapping of module name to path>
nhiều lần sử dụng được tích luỹ- Ghi đè một mô-đun bằng đường dẫn cục bộ ở dạng <tên mô-đun>=<đường dẫn>. Nếu đường dẫn đã cho là đường dẫn tuyệt đối, thì đường dẫn đó sẽ được sử dụng nguyên trạng. Nếu đường dẫn đã cho là đường dẫn tương đối, thì đường dẫn đó sẽ tương ứng với thư mục đang hoạt động. Nếu đường dẫn đã cho bắt đầu bằng "%workspace%", thì đường dẫn đó sẽ tương ứng với thư mục gốc của không gian làm việc, là kết quả của lệnh "bazel info workspace". Nếu đường dẫn đã cho trống, hãy xoá mọi chế độ ghi đè trước đó.
--registry=<a string>
nhiều lần sử dụng được tích luỹ- Chỉ định các sổ đăng ký cần sử dụng để xác định vị trí các phần phụ thuộc mô-đun Bazel. Thứ tự rất quan trọng: các mô-đun sẽ được tra cứu trong các sổ đăng ký trước đó trước tiên và chỉ quay lại các sổ đăng ký sau này khi các mô-đun đó bị thiếu trong các sổ đăng ký trước đó.
Thẻ:changes_inputs
--vendor_dir=<a path>
mặc định: xem nội dung mô tả-
Chỉ định thư mục sẽ chứa các kho lưu trữ bên ngoài ở chế độ nhà cung cấp, cho dù mục đích là tìm nạp các kho lưu trữ đó vào thư mục hay sử dụng các kho lưu trữ đó trong khi xây dựng. Bạn có thể chỉ định đường dẫn dưới dạng đường dẫn tuyệt đối hoặc đường dẫn tương đối đến thư mục không gian làm việc.
Thẻ:loading_and_analysis
- Các tuỳ chọn kích hoạt tính năng tối ưu hoá thời gian xây dựng:
--gc_thrashing_limits=<comma separated pairs of <period>:<count>>
mặc định: "1s:2,20s:3,1m:5"-
Các giới hạn nếu đạt đến sẽ khiến GcThrashingDetector gặp sự cố Bazel với OOM. Mỗi giới hạn được chỉ định là <period>:<count>, trong đó period là thời lượng và count là số nguyên dương. Nếu hơn --gc_thrashing_threshold phần trăm không gian cố định (vùng nhớ khối xếp cũ) vẫn bị chiếm dụng sau <count> lần GC đầy đủ liên tiếp trong <period>, thì lỗi OOM sẽ được kích hoạt. Bạn có thể chỉ định nhiều giới hạn, phân tách bằng dấu phẩy.
Thẻ:host_machine_resource_optimizations
--skyframe_high_water_mark_full_gc_drops_per_invocation=<an integer, >= 0>
mặc định: "2147483647"-
Cờ cho cấu hình nâng cao của công cụ Skyframe nội bộ của Bazel. Nếu phát hiện mức sử dụng phần trăm vùng nhớ khối xếp được giữ lại vượt quá ngưỡng do --skyframe_high_water_mark_threshold đặt ra, thì khi một sự kiện GC đầy đủ xảy ra, Bazel sẽ loại bỏ trạng thái Skyframe tạm thời không cần thiết, lên đến nhiều lần như vậy cho mỗi lệnh gọi. Mặc định là Integer.MAX_VALUE; không giới hạn về mặt hiệu quả. Giá trị 0 có nghĩa là các sự kiện GC đầy đủ sẽ không bao giờ kích hoạt sự kiện thả. Nếu đạt đến giới hạn, trạng thái Skyframe sẽ không còn bị loại bỏ khi một sự kiện GC đầy đủ xảy ra và vượt quá ngưỡng phần trăm vùng nhớ khối xếp được giữ lại đó.
Thẻ:host_machine_resource_optimizations
--skyframe_high_water_mark_minor_gc_drops_per_invocation=<an integer, >= 0>
mặc định: "2147483647"-
Cờ cho cấu hình nâng cao của công cụ Skyframe nội bộ của Bazel. Nếu phát hiện mức sử dụng phần trăm vùng nhớ khối xếp được giữ lại vượt quá ngưỡng do --skyframe_high_water_mark_threshold đặt ra, thì khi một sự kiện GC nhỏ xảy ra, Bazel sẽ loại bỏ trạng thái Skyframe tạm thời không cần thiết, lên đến nhiều lần như vậy mỗi lần gọi. Mặc định là Integer.MAX_VALUE; không giới hạn về mặt hiệu quả. Giá trị 0 có nghĩa là các sự kiện GC nhỏ sẽ không bao giờ kích hoạt sự kiện thả. Nếu đạt đến giới hạn, trạng thái Skyframe sẽ không còn bị loại bỏ khi một sự kiện GC nhỏ xảy ra và vượt quá ngưỡng phần trăm vùng nhớ khối xếp được giữ lại.
Thẻ:host_machine_resource_optimizations
--skyframe_high_water_mark_threshold=<an integer>
mặc định: "85"-
Cờ cho cấu hình nâng cao của công cụ Skyframe nội bộ của Bazel. Nếu phát hiện mức sử dụng phần trăm vùng nhớ khối xếp được giữ lại ít nhất là ngưỡng này, Bazel sẽ loại bỏ trạng thái Skyframe tạm thời không cần thiết. Việc điều chỉnh điều này có thể giúp bạn giảm thiểu tác động của tình trạng GC bị lỗi khi (i) tình trạng này là do mức sử dụng bộ nhớ của trạng thái tạm thời và (ii) tốn kém hơn so với việc tạo lại trạng thái khi cần.
Thẻ:host_machine_resource_optimizations
- Các tuỳ chọn ảnh hưởng đến mức độ chi tiết, định dạng hoặc vị trí ghi nhật ký:
--experimental_command_profile=<cpu, wall, alloc or lock>
mặc định: xem nội dung mô tả- Ghi hồ sơ Trình ghi chuyến bay Java trong thời gian thực thi lệnh. Bạn phải cung cấp một trong các loại sự kiện phân tích tài nguyên được hỗ trợ (cpu, wall, alloc hoặc lock) dưới dạng đối số. Hồ sơ được ghi vào một tệp được đặt tên theo loại sự kiện trong thư mục cơ sở đầu ra. Cú pháp và ngữ nghĩa của cờ này có thể thay đổi trong tương lai để hỗ trợ thêm các loại hồ sơ hoặc định dạng đầu ra; bạn tự chịu rủi ro khi sử dụng.
- Giá trị mặc định của
--[no]experimental_record_metrics_for_all_mnemonics
: "false" - Theo mặc định, số lượng loại thao tác được giới hạn ở 20 câu thần chú có số lượng thao tác được thực thi nhiều nhất. Việc đặt tuỳ chọn này sẽ ghi số liệu thống kê cho tất cả các câu thần chú.
- Các tuỳ chọn chỉ định hoặc thay đổi dữ liệu đầu vào chung thành một lệnh Bazel không thuộc các danh mục khác.:
--experimental_resolved_file_instead_of_workspace=<a string>
mặc định: ""- Nếu không trống, hãy đọc tệp đã phân giải được chỉ định thay vì tệp WORKSPACE
Thẻ:changes_inputs
- Các tuỳ chọn thực thi và lưu vào bộ nhớ đệm từ xa:
--experimental_downloader_config=<a string>
mặc định: xem nội dung mô tả- Chỉ định một tệp để định cấu hình trình tải xuống từ xa. Tệp này bao gồm các dòng, mỗi dòng bắt đầu bằng một lệnh (`allow`, `block` hoặc `rewrite`), theo sau là tên máy chủ lưu trữ (đối với lệnh `allow` và `block`) hoặc hai mẫu, một mẫu để so khớp và một mẫu để sử dụng làm URL thay thế, với các tệp tham chiếu ngược bắt đầu từ `$1`. Bạn có thể cung cấp nhiều lệnh `rewrite` cho cùng một URL và trong trường hợp này, nhiều URL sẽ được trả về.
- Giá trị mặc định của
--experimental_worker_for_repo_fetching=<off, platform, virtual or auto>
: "tự động" - Chế độ tạo luồng để tìm nạp kho lưu trữ. Nếu bạn đặt thành "tắt", thì không có luồng worker nào được sử dụng và quá trình tìm nạp kho lưu trữ sẽ phải khởi động lại. Nếu không, hãy sử dụng luồng worker ảo.
- Các tuỳ chọn khác, không được phân loại theo cách khác.:
--override_repository=<an equals-separated mapping of repository name to path>
nhiều lần sử dụng được tích luỹ- Ghi đè kho lưu trữ bằng một đường dẫn cục bộ ở dạng <repository name>=<path>. Nếu đường dẫn đã cho là đường dẫn tuyệt đối, thì đường dẫn đó sẽ được sử dụng nguyên trạng. Nếu đường dẫn đã cho là đường dẫn tương đối, thì đường dẫn đó sẽ tương ứng với thư mục đang hoạt động. Nếu đường dẫn đã cho bắt đầu bằng "%workspace%", thì đường dẫn đó sẽ tương ứng với thư mục gốc của không gian làm việc, là kết quả của lệnh "bazel info workspace". Nếu đường dẫn đã cho trống, hãy xoá mọi chế độ ghi đè trước đó.
Tuỳ chọn cấu hình
Các lựa chọn về mức độ phù hợp
Kế thừa tất cả các tuỳ chọn từ test.
- Các tuỳ chọn xuất hiện trước lệnh và được máy khách phân tích cú pháp:
--distdir=<a path>
nhiều lần sử dụng được tích luỹ-
Các vị trí khác để tìm kiếm bản lưu trữ trước khi truy cập vào mạng để tải xuống.
Thẻ:bazel_internal_configuration
- Giá trị mặc định của
--[no]experimental_repository_cache_hardlinks
: "false" - Nếu được đặt, bộ nhớ đệm kho lưu trữ sẽ liên kết cứng tệp trong trường hợp có lượt truy cập vào bộ nhớ đệm, thay vì sao chép. Việc này nhằm tiết kiệm dung lượng ổ đĩa.
Thẻ:bazel_internal_configuration
--experimental_repository_downloader_retries=<an integer>
mặc định: "0"-
Số lần thử tối đa để thử lại lỗi tải xuống. Nếu bạn đặt thành 0, thì tính năng thử lại sẽ bị tắt.
Thẻ:experimental
--experimental_scale_timeouts=<a double>
mặc định: "1.0"- Điều chỉnh tất cả thời gian chờ trong quy tắc kho lưu trữ Starlark theo hệ số này. Bằng cách này, bạn có thể làm cho kho lưu trữ bên ngoài hoạt động trên các máy chạy chậm hơn dự kiến của tác giả quy tắc mà không cần thay đổi mã nguồn
Thẻ:bazel_internal_configuration
,experimental
- Giá trị mặc định của
--[no]incompatible_disable_native_repo_rules
: "false" - Nếu giá trị là false, bạn có thể sử dụng các quy tắc kho lưu trữ gốc trong WORKSPACE; nếu không, bạn phải sử dụng các quy tắc kho lưu trữ Starlark. Các quy tắc kho lưu trữ gốc bao gồm local_repository, new_local_repository, local_config_platform, android_sdk_repository và android_ndk_repository.
Thẻ:bazel_internal_configuration
--repository_cache=<a path>
mặc định: xem nội dung mô tả- Chỉ định vị trí bộ nhớ đệm của các giá trị đã tải xuống thu được trong quá trình tìm nạp kho lưu trữ bên ngoài. Chuỗi trống làm đối số yêu cầu tắt bộ nhớ đệm, nếu không, giá trị mặc định là "<output_user_root>/cache/repos/v1" sẽ được sử dụng
Thẻ:bazel_internal_configuration
- Giá trị mặc định của
--[no]repository_disable_download
: "false" - Nếu được đặt, bạn không được phép tải xuống bằng ctx.download{,_and_extract} trong quá trình tìm nạp kho lưu trữ. Xin lưu ý rằng quyền truy cập mạng không bị tắt hoàn toàn; ctx.execute vẫn có thể chạy một tệp thực thi tuỳ ý truy cập Internet.
Thẻ:bazel_internal_configuration
- Các tuỳ chọn kiểm soát việc thực thi bản dựng:
- Giá trị mặc định của
--gc_thrashing_threshold=<an integer in 0-100 range>
: "100" -
Tỷ lệ phần trăm không gian cố định bị chiếm dụng (0-100) mà tại đó GcThrashingDetector xem xét các sự kiện áp lực bộ nhớ so với giới hạn của nó (--gc_thrashing_limits). Nếu bạn đặt thành 100, GcThrashingDetector sẽ bị tắt.
Thẻ:host_machine_resource_optimizations
- Tuỳ chọn liên quan đến đầu ra và ngữ nghĩa của Bzlmod:
--allow_yanked_versions=<a string>
nhiều lần sử dụng được tích luỹ-
Chỉ định các phiên bản mô-đun ở dạng `<module1>@<version1>,<module2>@<version2>` sẽ được cho phép trong biểu đồ phần phụ thuộc đã phân giải ngay cả khi các phiên bản đó được khai báo là đã bị xoá trong sổ đăng ký nơi chúng đến (nếu không đến từ NonRegistryOverride). Nếu không, các phiên bản bị xoá sẽ khiến việc phân giải không thành công. Bạn cũng có thể xác định phiên bản bị xoá được phép bằng biến môi trường `BZLMOD_ALLOW_YANKED_VERSIONS`. Bạn có thể tắt tính năng kiểm tra này bằng cách sử dụng từ khoá "tất cả" (không nên dùng).
Thẻ:loading_and_analysis
--check_bazel_compatibility=<error, warning or off>
mặc định: "lỗi"-
Kiểm tra khả năng tương thích của phiên bản bazel của các mô-đun Bazel. Các giá trị hợp lệ là "error" để chuyển vấn đề này lên lỗi phân giải, "off" để tắt tính năng kiểm tra hoặc "warning" để in cảnh báo khi phát hiện thấy không khớp.
Thẻ:loading_and_analysis
--check_direct_dependencies=<off, warning or error>
mặc định: "cảnh báo"-
Kiểm tra xem các phần phụ thuộc `bazel_dep` trực tiếp được khai báo trong mô-đun gốc có phải là các phiên bản mà bạn nhận được trong biểu đồ phần phụ thuộc đã được phân giải hay không. Các giá trị hợp lệ là "off" để tắt tính năng kiểm tra, "warning" để in cảnh báo khi phát hiện thấy không khớp hoặc "error" để chuyển lên lỗi phân giải.
Thẻ:loading_and_analysis
- Giá trị mặc định của
--[no]ignore_dev_dependency
: "false" - Nếu đúng, Bazel sẽ bỏ qua "bazel_dep" và "use_extension" được khai báo là "dev_dependency" trong MODULE.bazel của mô-đun gốc. Xin lưu ý rằng các phần phụ thuộc dành cho nhà phát triển đó luôn bị bỏ qua trong MODULE.bazel nếu đó không phải là mô-đun gốc, bất kể giá trị của cờ này là gì.
Thẻ:loading_and_analysis
--lockfile_mode=<off, update, refresh or error>
mặc định: "cập nhật"-
Chỉ định cách thức và liệu có sử dụng tệp khoá hay không. Các giá trị hợp lệ là "update" để sử dụng tệp khoá và cập nhật tệp khoá nếu có thay đổi, "refresh" để thỉnh thoảng làm mới thông tin có thể thay đổi (các phiên bản bị loại bỏ và các mô-đun bị thiếu trước đó) từ các sổ đăng ký từ xa, "error" để sử dụng tệp khoá nhưng gửi lỗi nếu tệp khoá không được cập nhật hoặc "off" để không đọc hoặc ghi vào tệp khoá.
Thẻ:loading_and_analysis
--override_module=<an equals-separated mapping of module name to path>
nhiều lần sử dụng được tích luỹ- Ghi đè một mô-đun bằng đường dẫn cục bộ ở dạng <tên mô-đun>=<đường dẫn>. Nếu đường dẫn đã cho là đường dẫn tuyệt đối, thì đường dẫn đó sẽ được sử dụng nguyên trạng. Nếu đường dẫn đã cho là đường dẫn tương đối, thì đường dẫn đó sẽ tương ứng với thư mục đang hoạt động. Nếu đường dẫn đã cho bắt đầu bằng "%workspace%", thì đường dẫn đó sẽ tương ứng với thư mục gốc của không gian làm việc, là kết quả của lệnh "bazel info workspace". Nếu đường dẫn đã cho trống, hãy xoá mọi chế độ ghi đè trước đó.
--registry=<a string>
nhiều lần sử dụng được tích luỹ- Chỉ định các sổ đăng ký cần sử dụng để xác định vị trí các phần phụ thuộc mô-đun Bazel. Thứ tự rất quan trọng: các mô-đun sẽ được tra cứu trong các sổ đăng ký trước đó trước tiên và chỉ quay lại các sổ đăng ký sau này khi các mô-đun đó bị thiếu trong các sổ đăng ký trước đó.
Thẻ:changes_inputs
--vendor_dir=<a path>
mặc định: xem nội dung mô tả-
Chỉ định thư mục sẽ chứa các kho lưu trữ bên ngoài ở chế độ nhà cung cấp, cho dù mục đích là tìm nạp các kho lưu trữ đó vào thư mục hay sử dụng các kho lưu trữ đó trong khi xây dựng. Bạn có thể chỉ định đường dẫn dưới dạng đường dẫn tuyệt đối hoặc đường dẫn tương đối đến thư mục không gian làm việc.
Thẻ:loading_and_analysis
- Các tuỳ chọn kích hoạt tính năng tối ưu hoá thời gian xây dựng:
--gc_thrashing_limits=<comma separated pairs of <period>:<count>>
mặc định: "1s:2,20s:3,1m:5"-
Các giới hạn nếu đạt đến sẽ khiến GcThrashingDetector gặp sự cố Bazel với OOM. Mỗi giới hạn được chỉ định là <period>:<count>, trong đó period là thời lượng và count là số nguyên dương. Nếu hơn --gc_thrashing_threshold phần trăm không gian cố định (vùng nhớ khối xếp cũ) vẫn bị chiếm dụng sau <count> lần GC đầy đủ liên tiếp trong <period>, thì lỗi OOM sẽ được kích hoạt. Bạn có thể chỉ định nhiều giới hạn, phân tách bằng dấu phẩy.
Thẻ:host_machine_resource_optimizations
--skyframe_high_water_mark_full_gc_drops_per_invocation=<an integer, >= 0>
mặc định: "2147483647"-
Cờ cho cấu hình nâng cao của công cụ Skyframe nội bộ của Bazel. Nếu phát hiện mức sử dụng phần trăm vùng nhớ khối xếp được giữ lại vượt quá ngưỡng do --skyframe_high_water_mark_threshold đặt ra, thì khi một sự kiện GC đầy đủ xảy ra, Bazel sẽ loại bỏ trạng thái Skyframe tạm thời không cần thiết, lên đến nhiều lần như vậy cho mỗi lệnh gọi. Mặc định là Integer.MAX_VALUE; không giới hạn về mặt hiệu quả. Giá trị 0 có nghĩa là các sự kiện GC đầy đủ sẽ không bao giờ kích hoạt sự kiện thả. Nếu đạt đến giới hạn, trạng thái Skyframe sẽ không còn bị loại bỏ khi một sự kiện GC đầy đủ xảy ra và vượt quá ngưỡng phần trăm vùng nhớ khối xếp được giữ lại đó.
Thẻ:host_machine_resource_optimizations
--skyframe_high_water_mark_minor_gc_drops_per_invocation=<an integer, >= 0>
mặc định: "2147483647"-
Cờ cho cấu hình nâng cao của công cụ Skyframe nội bộ của Bazel. Nếu phát hiện mức sử dụng phần trăm vùng nhớ khối xếp được giữ lại vượt quá ngưỡng do --skyframe_high_water_mark_threshold đặt ra, thì khi một sự kiện GC nhỏ xảy ra, Bazel sẽ loại bỏ trạng thái Skyframe tạm thời không cần thiết, lên đến nhiều lần như vậy mỗi lần gọi. Mặc định là Integer.MAX_VALUE; không giới hạn về mặt hiệu quả. Giá trị 0 có nghĩa là các sự kiện GC nhỏ sẽ không bao giờ kích hoạt sự kiện thả. Nếu đạt đến giới hạn, trạng thái Skyframe sẽ không còn bị loại bỏ khi một sự kiện GC nhỏ xảy ra và vượt quá ngưỡng phần trăm vùng nhớ khối xếp được giữ lại.
Thẻ:host_machine_resource_optimizations
--skyframe_high_water_mark_threshold=<an integer>
mặc định: "85"-
Cờ cho cấu hình nâng cao của công cụ Skyframe nội bộ của Bazel. Nếu phát hiện mức sử dụng phần trăm vùng nhớ khối xếp được giữ lại ít nhất là ngưỡng này, Bazel sẽ loại bỏ trạng thái Skyframe tạm thời không cần thiết. Việc điều chỉnh điều này có thể giúp bạn giảm thiểu tác động của tình trạng GC bị lỗi khi (i) tình trạng này là do mức sử dụng bộ nhớ của trạng thái tạm thời và (ii) tốn kém hơn so với việc tạo lại trạng thái khi cần.
Thẻ:host_machine_resource_optimizations
- Các tuỳ chọn ảnh hưởng đến mức độ chi tiết, định dạng hoặc vị trí ghi nhật ký:
--experimental_command_profile=<cpu, wall, alloc or lock>
mặc định: xem nội dung mô tả- Ghi hồ sơ Trình ghi chuyến bay Java trong thời gian thực thi lệnh. Bạn phải cung cấp một trong các loại sự kiện phân tích tài nguyên được hỗ trợ (cpu, wall, alloc hoặc lock) dưới dạng đối số. Hồ sơ được ghi vào một tệp được đặt tên theo loại sự kiện trong thư mục cơ sở đầu ra. Cú pháp và ngữ nghĩa của cờ này có thể thay đổi trong tương lai để hỗ trợ thêm các loại hồ sơ hoặc định dạng đầu ra; bạn tự chịu rủi ro khi sử dụng.
- Giá trị mặc định của
--[no]experimental_record_metrics_for_all_mnemonics
: "false" - Theo mặc định, số lượng loại thao tác được giới hạn ở 20 câu thần chú có số lượng thao tác được thực thi nhiều nhất. Việc đặt tuỳ chọn này sẽ ghi số liệu thống kê cho tất cả các câu thần chú.
- Các tuỳ chọn chỉ định hoặc thay đổi dữ liệu đầu vào chung thành một lệnh Bazel không thuộc các danh mục khác.:
--experimental_resolved_file_instead_of_workspace=<a string>
mặc định: ""- Nếu không trống, hãy đọc tệp đã phân giải được chỉ định thay vì tệp WORKSPACE
Thẻ:changes_inputs
- Các tuỳ chọn thực thi và lưu vào bộ nhớ đệm từ xa:
--experimental_downloader_config=<a string>
mặc định: xem nội dung mô tả- Chỉ định một tệp để định cấu hình trình tải xuống từ xa. Tệp này bao gồm các dòng, mỗi dòng bắt đầu bằng một lệnh (`allow`, `block` hoặc `rewrite`), theo sau là tên máy chủ lưu trữ (đối với lệnh `allow` và `block`) hoặc hai mẫu, một mẫu để so khớp và một mẫu để sử dụng làm URL thay thế, với các tệp tham chiếu ngược bắt đầu từ `$1`. Bạn có thể cung cấp nhiều lệnh `rewrite` cho cùng một URL và trong trường hợp này, nhiều URL sẽ được trả về.
- Giá trị mặc định của
--experimental_worker_for_repo_fetching=<off, platform, virtual or auto>
: "tự động" - Chế độ tạo luồng để tìm nạp kho lưu trữ. Nếu bạn đặt thành "tắt", thì không có luồng worker nào được sử dụng và quá trình tìm nạp kho lưu trữ sẽ phải khởi động lại. Nếu không, hãy sử dụng luồng worker ảo.
- Các tuỳ chọn khác, không được phân loại theo cách khác.:
--override_repository=<an equals-separated mapping of repository name to path>
nhiều lần sử dụng được tích luỹ- Ghi đè kho lưu trữ bằng một đường dẫn cục bộ ở dạng <repository name>=<path>. Nếu đường dẫn đã cho là đường dẫn tuyệt đối, thì đường dẫn đó sẽ được sử dụng nguyên trạng. Nếu đường dẫn đã cho là đường dẫn tương đối, thì đường dẫn đó sẽ tương ứng với thư mục đang hoạt động. Nếu đường dẫn đã cho bắt đầu bằng "%workspace%", thì đường dẫn đó sẽ tương ứng với thư mục gốc của không gian làm việc, là kết quả của lệnh "bazel info workspace". Nếu đường dẫn đã cho trống, hãy xoá mọi chế độ ghi đè trước đó.
Tuỳ chọn cquery
Kế thừa tất cả các tuỳ chọn từ test.
- Các tuỳ chọn xuất hiện trước lệnh và được máy khách phân tích cú pháp:
--distdir=<a path>
nhiều lần sử dụng được tích luỹ-
Các vị trí khác để tìm kiếm bản lưu trữ trước khi truy cập vào mạng để tải xuống.
Thẻ:bazel_internal_configuration
- Giá trị mặc định của
--[no]experimental_repository_cache_hardlinks
: "false" - Nếu được đặt, bộ nhớ đệm kho lưu trữ sẽ liên kết cứng tệp trong trường hợp có lượt truy cập vào bộ nhớ đệm, thay vì sao chép. Việc này nhằm tiết kiệm dung lượng ổ đĩa.
Thẻ:bazel_internal_configuration
--experimental_repository_downloader_retries=<an integer>
mặc định: "0"-
Số lần thử tối đa để thử lại lỗi tải xuống. Nếu bạn đặt thành 0, thì tính năng thử lại sẽ bị tắt.
Thẻ:experimental
--experimental_scale_timeouts=<a double>
mặc định: "1.0"- Điều chỉnh tất cả thời gian chờ trong quy tắc kho lưu trữ Starlark theo hệ số này. Bằng cách này, bạn có thể làm cho kho lưu trữ bên ngoài hoạt động trên các máy chạy chậm hơn dự kiến của tác giả quy tắc mà không cần thay đổi mã nguồn
Thẻ:bazel_internal_configuration
,experimental
- Giá trị mặc định của
--[no]incompatible_disable_native_repo_rules
: "false" - Nếu giá trị là false, bạn có thể sử dụng các quy tắc kho lưu trữ gốc trong WORKSPACE; nếu không, bạn phải sử dụng các quy tắc kho lưu trữ Starlark. Các quy tắc kho lưu trữ gốc bao gồm local_repository, new_local_repository, local_config_platform, android_sdk_repository và android_ndk_repository.
Thẻ:bazel_internal_configuration
--repository_cache=<a path>
mặc định: xem nội dung mô tả- Chỉ định vị trí bộ nhớ đệm của các giá trị đã tải xuống thu được trong quá trình tìm nạp kho lưu trữ bên ngoài. Chuỗi trống làm đối số yêu cầu tắt bộ nhớ đệm, nếu không, giá trị mặc định là "<output_user_root>/cache/repos/v1" sẽ được sử dụng
Thẻ:bazel_internal_configuration
- Giá trị mặc định của
--[no]repository_disable_download
: "false" - Nếu được đặt, bạn không được phép tải xuống bằng ctx.download{,_and_extract} trong quá trình tìm nạp kho lưu trữ. Xin lưu ý rằng quyền truy cập mạng không bị tắt hoàn toàn; ctx.execute vẫn có thể chạy một tệp thực thi tuỳ ý truy cập Internet.
Thẻ:bazel_internal_configuration
- Các tuỳ chọn kiểm soát việc thực thi bản dựng:
- Giá trị mặc định của
--gc_thrashing_threshold=<an integer in 0-100 range>
: "100" -
Tỷ lệ phần trăm không gian cố định bị chiếm dụng (0-100) mà tại đó GcThrashingDetector xem xét các sự kiện áp lực bộ nhớ so với giới hạn của nó (--gc_thrashing_limits). Nếu bạn đặt thành 100, GcThrashingDetector sẽ bị tắt.
Thẻ:host_machine_resource_optimizations
- Tuỳ chọn liên quan đến kết quả truy vấn và ngữ nghĩa:
- Giá trị mặc định của
--aspect_deps=<off, conservative or precise>
: "conservative" -
Cách phân giải các phần phụ thuộc của khía cạnh khi định dạng đầu ra là một trong các {xml,proto,record}. "tắt" có nghĩa là không có phần phụ thuộc khía cạnh nào được phân giải, "cẩn thận" (mặc định) có nghĩa là tất cả phần phụ thuộc khía cạnh đã khai báo đều được thêm vào bất kể chúng có được cấp lớp quy tắc của phần phụ thuộc trực tiếp hay không, "chính xác" có nghĩa là chỉ những khía cạnh có thể hoạt động mới được thêm vào dựa trên lớp quy tắc của phần phụ thuộc trực tiếp. Xin lưu ý rằng chế độ chính xác yêu cầu tải các gói khác để đánh giá một mục tiêu duy nhất, do đó, chế độ này sẽ chậm hơn các chế độ khác. Ngoài ra, xin lưu ý rằng ngay cả chế độ chính xác cũng không hoàn toàn chính xác: quyết định có tính toán một khía cạnh hay không được quyết định trong giai đoạn phân tích, giai đoạn này không chạy trong "truy vấn bazel".
Thẻ:build_file_semantics
- Giá trị mặc định của
--[no]consistent_labels
: "false" - Nếu được bật, mọi lệnh truy vấn sẽ phát ra nhãn như thể bằng hàm Starlark <code>str</code> áp dụng cho một thực thể <code>Label</code>. Điều này rất hữu ích đối với các công cụ cần so khớp kết quả của các lệnh truy vấn và/hoặc nhãn khác nhau do các quy tắc phát ra. Nếu không được bật, trình định dạng đầu ra có thể tự do phát ra tên kho lưu trữ rõ ràng (so với kho lưu trữ chính) để giúp đầu ra dễ đọc hơn.
Thẻ:terminal_output
- Giá trị mặc định của
--[no]experimental_explicit_aspects
: "false" -
aquery, cquery: liệu có đưa các hành động do phương diện tạo ra vào kết quả hay không. query: không hoạt động (các phương diện luôn được tuân theo).
Thẻ:terminal_output
- Giá trị mặc định của
--[no]graph:factored
: "true" - Nếu đúng, thì biểu đồ sẽ được phát "được nhân", tức là các nút tương đương về mặt tô pô sẽ được hợp nhất với nhau và các nhãn của chúng sẽ được nối với nhau. Tuỳ chọn này chỉ áp dụng cho --output=graph.
Thẻ:terminal_output
--graph:node_limit=<an integer>
mặc định: "512"-
Độ dài tối đa của chuỗi nhãn cho một nút biểu đồ trong kết quả. Nhãn dài hơn sẽ bị cắt ngắn; -1 có nghĩa là không cắt ngắn. Tuỳ chọn này chỉ áp dụng cho --output=graph.
Thẻ:terminal_output
- Giá trị mặc định của
--[no]implicit_deps
: "true" - Nếu được bật, các phần phụ thuộc ngầm sẽ đượ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 bazel thêm vào. Đối với cquery, tuỳ chọn này kiểm soát việc lọc các chuỗi công cụ đã phân giải.
Thẻ:build_file_semantics
- Giá trị mặc định của
--[no]include_aspects
: "true" -
aquery, cquery: liệu có đưa các hành động do phương diện tạo ra vào kết quả hay không. query: không hoạt động (các phương diện luôn được tuân theo).
Thẻ:terminal_output
- Giá trị mặc định của
--[no]incompatible_package_group_includes_double_slash
: "true" - Nếu được bật, khi xuất thuộc tính "packages" của package_group, dấu "//" ở đầu sẽ không bị bỏ qua.
Thẻ:terminal_output
,incompatible_change
- Giá trị mặc định của
--[no]infer_universe_scope
: "false" - Nếu bạn đặt và không đặt --universe_scope, thì giá trị của --universe_scope sẽ được suy ra là danh sách các mẫu mục tiêu duy nhất trong biểu thức truy vấn. Xin lưu ý rằng giá trị --universe_scope được suy ra cho biểu thức truy vấn sử dụng các hàm trong phạm vi vũ trụ (ví dụ: "allrdeps") có thể không phải là giá trị bạn muốn. Vì vậy, bạn chỉ nên sử dụng tuỳ chọn này nếu biết mình đang làm gì. Hãy xem https://bazel.build/reference/query#sky-query để biết thông tin chi tiết và ví dụ. Nếu bạn đặt --universe_scope, thì giá trị của tuỳ chọn này sẽ bị bỏ qua. Lưu ý: tuỳ chọn này chỉ áp dụng cho "truy vấn" (tức là không phải "cquery").
Thẻ:loading_and_analysis
- Giá trị mặc định của
--[no]line_terminator_null
: "false" -
Liệu mỗi định dạng có được kết thúc bằng \0 thay vì dòng mới hay không.
Thẻ:terminal_output
- Giá trị mặc định của
--[no]nodep_deps
: "true" - Nếu được bật, các phần phụ thuộc từ thuộc tính "nodep" sẽ được đưa vào biểu đồ phần phụ thuộc mà truy vấn hoạt động. Một ví dụ phổ biến về thuộc tính "nodep" là "visibility" (mức độ hiển thị). Chạy và phân tích cú pháp kết quả của lệnh `info build-language` để tìm hiểu về tất cả thuộc tính "nodep" trong ngôn ngữ bản dựng.
Thẻ:build_file_semantics
--output=<a string>
mặc định: "label"-
Định dạng in kết quả cquery. Các giá trị được phép cho cquery là: label, label_kind, textproto, transitions, proto, streamed_proto, jsonproto. Nếu chọn "transitions" (hiệu ứng chuyển đổi), bạn cũng phải chỉ định tuỳ chọn --transitions=(lite|full).
Thẻ:terminal_output
- Giá trị mặc định của
--[no]proto:default_values
: "true" - Nếu đúng, các thuộc tính có giá trị không được chỉ định rõ ràng trong tệp BUILD sẽ được đưa vào; nếu không, các thuộc tính đó sẽ bị bỏ qua. Bạn có thể áp dụng tuỳ chọn này cho --output=proto
Thẻ:terminal_output
- Giá trị mặc định của
--[no]proto:definition_stack
: "false" - Điền vào trường proto definition_stack. Trường này ghi lại cho mỗi thực thể quy tắc ngăn xếp lệnh gọi Starlark tại thời điểm lớp của quy tắc được xác định.
Thẻ:terminal_output
- Giá trị mặc định của
--[no]proto:flatten_selects
: "true" - Nếu được bật, các thuộc tính có thể định cấu hình do select() tạo sẽ được làm phẳng. Đối với các loại danh sách, bản trình bày được làm phẳng là một danh sách chứa mỗi giá trị của bản đồ chọn chính xác một lần. Các loại đại lượng vô hướng được làm phẳng thành giá trị rỗng.
Thẻ:build_file_semantics
- Giá trị mặc định của
--[no]proto:include_attribute_source_aspects
: "false" - Điền phương diện nguồn mà thuộc tính đến từ vào trường proto source_aspect_name của mỗi Thuộc tính (chuỗi trống nếu không có).
Thẻ:terminal_output
- Giá trị mặc định của
--[no]proto:include_configurations
: "true" - nếu được bật, đầu ra proto sẽ bao gồm thông tin về cấu hình. Khi bị tắt,định dạng đầu ra proto của cquery sẽ giống với định dạng đầu ra truy vấn.
Thẻ:affects_outputs
- Giá trị mặc định của
--[no]proto:include_synthetic_attribute_hash
: "false" -
Liệu có tính toán và điền thuộc tính $internal_attr_hash hay không.
Thẻ:terminal_output
- Giá trị mặc định của
--[no]proto:instantiation_stack
: "false" - Điền ngăn xếp lệnh gọi bản sao của từng quy tắc. Xin lưu ý rằng việc này yêu cầu ngăn xếp phải có mặt
Thẻ
:terminal_output
- Giá trị mặc định của
--[no]proto:locations
: "true" -
Liệu có xuất thông tin vị trí trong đầu ra proto hay không.
Thẻ:terminal_output
--proto:output_rule_attrs=<comma-separated list of options>
mặc định: "tất cả"- Danh sách các thuộc tính được phân tách bằng dấu phẩy để đưa vào đầu ra. Giá trị mặc định là tất cả thuộc tính. Đặt thành chuỗi trống để không xuất ra thuộc tính nào. Tuỳ chọn này áp dụng cho --output=proto.
Thẻ:terminal_output
- Giá trị mặc định của
--[no]proto:rule_inputs_and_outputs
: "true" -
Liệu có điền sẵn các trường rule_input và rule_output hay không.
Thẻ:terminal_output
--query_file=<a string>
mặc định: ""- Nếu được đặt, truy vấn sẽ đọc truy vấn từ tệp được đặt tên tại đây, thay vì trên dòng lệnh. Bạn sẽ gặp lỗi nếu chỉ định một tệp tại đây cũng như một truy vấn dòng lệnh.
Thẻ:changes_inputs
- Giá trị mặc định của
--[no]relative_locations
: "false" - Nếu đúng, vị trí của các tệp BUILD trong đầu ra xml và proto sẽ tương đối. Theo mặc định, đầu ra vị trí là một đường dẫn tuyệt đối và sẽ không nhất quán trên các máy. Bạn có thể đặt tuỳ chọn này thành đúng để có kết quả nhất quán trên các máy.
Thẻ:terminal_output
--show_config_fragments=<off, direct or transitive>
mặc định: "off"- Hiển thị các mảnh cấu hình mà quy tắc yêu cầu và các phần phụ thuộc bắc cầu của mảnh đó. Điều này có thể hữu ích để đánh giá mức độ cắt bớt của biểu đồ mục tiêu đã định cấu hình.
Thẻ:affects_outputs
--starlark:expr=<a string>
mặc định: ""-
Biểu thức Starlark để định dạng từng mục tiêu đã định cấu hình ở chế độ --output=starlark của cquery. Mục tiêu được định cấu hình được liên kết với "target". Nếu bạn không chỉ định --starlark:expr hoặc --starlark:file, tuỳ chọn này sẽ mặc định là "str(target.label)". Bạn sẽ gặp lỗi nếu chỉ định cả --starlark:expr và --starlark:file.
Thẻ:terminal_output
--starlark:file=<a string>
mặc định: ""-
Tên của tệp xác định một hàm Starlark có tên là "format" (định dạng), của một đối số, được áp dụng cho từng mục tiêu đã định cấu hình để định dạng đối số đó dưới dạng một chuỗi. Bạn sẽ gặp lỗi nếu chỉ định cả --starlark:expr và --starlark:file. Hãy xem phần trợ giúp cho --output=starlark để biết thêm thông tin chi tiết.
Thẻ:terminal_output
- Giá trị mặc định của
--[no]tool_deps
: "true" - Truy vấn: Nếu bị tắt, các phần phụ thuộc trên "cấu hình thực thi" sẽ không được đưa vào biểu đồ phần phụ thuộc mà truy vấn hoạt động. Cạnh phần phụ thuộc "cấu hình thực thi", chẳng hạn như cạnh từ quy tắc "proto_library" bất kỳ đến Trình biên dịch giao thức, thường trỏ đến một công cụ được thực thi trong quá trình xây dựng thay vì một phần của cùng một chương trình "mục tiêu".
Cquery: Nếu bị tắt, sẽ lọc ra tất cả các mục tiêu đã định cấu hình vượt qua quá trình chuyển đổi thực thi từ mục tiêu cấp cao nhất đã phát hiện mục tiêu đã định cấu hình này. Điều đó có nghĩa là nếu mục tiêu cấp cao nhất nằm trong cấu hình mục tiêu, thì chỉ những mục tiêu được định cấu hình cũng nằm trong cấu hình mục tiêu mới được trả về. Nếu mục tiêu cấp cao nhất nằm trong cấu hình thực thi, thì chỉ các mục tiêu được định cấu hình thực thi mới được trả về. Tuỳ chọn này KHÔNG loại trừ các chuỗi công cụ đã phân giải.
Thẻ:build_file_semantics
--transitions=<full, lite or none>
mặc định: "none"-
Định dạng mà cquery sẽ in thông tin chuyển đổi.
Thẻ:affects_outputs
--universe_scope=<comma-separated list of options>
mặc định: ""-
Một tập hợp các mẫu mục tiêu được phân tách bằng dấu phẩy (bổ sung và trừ). Truy vấn có thể được thực hiện trong vũ trụ được xác định bằng phép đóng bắc cầu của các mục tiêu đã chỉ định. Tuỳ chọn này được dùng cho các lệnh truy vấn và cquery.
Đối với cquery, dữ liệu đầu vào cho tuỳ chọn này là các mục tiêu mà tất cả câu trả lời được tạo trong đó. Do đó, tuỳ chọn này có thể ảnh hưởng đến cấu hình và quá trình chuyển đổi. Nếu bạn không chỉ định tuỳ chọn này, thì các mục tiêu cấp cao nhất được giả định là các mục tiêu được phân tích cú pháp từ biểu thức truy vấn. Lưu ý: Đối với cquery, việc không chỉ định tuỳ chọn này có thể khiến bản dựng bị lỗi nếu các mục tiêu được phân tích cú pháp từ biểu thức truy vấn không thể tạo bằng các tuỳ chọn cấp cao nhất.
Thẻ:loading_and_analysis
- Các tuỳ chọn liên quan đến đầu ra và ngữ nghĩa của Bzlmod:
--allow_yanked_versions=<a string>
nhiều lần sử dụng được tích luỹ-
Chỉ định các phiên bản mô-đun ở dạng `<module1>@<version1>,<module2>@<version2>` sẽ được cho phép trong biểu đồ phần phụ thuộc đã phân giải ngay cả khi các phiên bản đó được khai báo là đã bị xoá trong sổ đăng ký nơi chúng đến (nếu không đến từ NonRegistryOverride). Nếu không, các phiên bản bị xoá sẽ khiến việc phân giải không thành công. Bạn cũng có thể xác định phiên bản bị xoá được phép bằng biến môi trường `BZLMOD_ALLOW_YANKED_VERSIONS`. Bạn có thể tắt tính năng kiểm tra này bằng cách sử dụng từ khoá "tất cả" (không nên dùng).
Thẻ:loading_and_analysis
--check_bazel_compatibility=<error, warning or off>
mặc định: "lỗi"-
Kiểm tra khả năng tương thích của phiên bản bazel của các mô-đun Bazel. Các giá trị hợp lệ là "error" để chuyển vấn đề này lên lỗi phân giải, "off" để tắt tính năng kiểm tra hoặc "warning" để in cảnh báo khi phát hiện thấy không khớp.
Thẻ:loading_and_analysis
--check_direct_dependencies=<off, warning or error>
mặc định: "cảnh báo"-
Kiểm tra xem các phần phụ thuộc `bazel_dep` trực tiếp được khai báo trong mô-đun gốc có phải là các phiên bản mà bạn nhận được trong biểu đồ phần phụ thuộc đã được phân giải hay không. Các giá trị hợp lệ là "off" để tắt tính năng kiểm tra, "warning" để in cảnh báo khi phát hiện thấy không khớp hoặc "error" để chuyển lên lỗi phân giải.
Thẻ:loading_and_analysis
- Giá trị mặc định của
--[no]ignore_dev_dependency
: "false" - Nếu đúng, Bazel sẽ bỏ qua "bazel_dep" và "use_extension" được khai báo là "dev_dependency" trong MODULE.bazel của mô-đun gốc. Xin lưu ý rằng các phần phụ thuộc dành cho nhà phát triển đó luôn bị bỏ qua trong MODULE.bazel nếu đó không phải là mô-đun gốc, bất kể giá trị của cờ này là gì.
Thẻ:loading_and_analysis
--lockfile_mode=<off, update, refresh or error>
mặc định: "cập nhật"-
Chỉ định cách thức và liệu có sử dụng tệp khoá hay không. Các giá trị hợp lệ là "update" để sử dụng tệp khoá và cập nhật tệp khoá nếu có thay đổi, "refresh" để thỉnh thoảng làm mới thông tin có thể thay đổi (các phiên bản bị loại bỏ và các mô-đun bị thiếu trước đó) từ các sổ đăng ký từ xa, "error" để sử dụng tệp khoá nhưng gửi lỗi nếu tệp khoá không được cập nhật hoặc "off" để không đọc hoặc ghi vào tệp khoá.
Thẻ:loading_and_analysis
--override_module=<an equals-separated mapping of module name to path>
nhiều lần sử dụng được tích luỹ- Ghi đè một mô-đun bằng đường dẫn cục bộ ở dạng <tên mô-đun>=<đường dẫn>. Nếu đường dẫn đã cho là đường dẫn tuyệt đối, thì đường dẫn đó sẽ được sử dụng nguyên trạng. Nếu đường dẫn đã cho là đường dẫn tương đối, thì đường dẫn đó sẽ tương ứng với thư mục đang hoạt động. Nếu đường dẫn đã cho bắt đầu bằng "%workspace%", thì đường dẫn đó sẽ tương ứng với thư mục gốc của không gian làm việc, là kết quả của lệnh "bazel info workspace". Nếu đường dẫn đã cho trống, hãy xoá mọi chế độ ghi đè trước đó.
--registry=<a string>
nhiều lần sử dụng được tích luỹ- Chỉ định các sổ đăng ký cần sử dụng để xác định vị trí các phần phụ thuộc mô-đun Bazel. Thứ tự rất quan trọng: các mô-đun sẽ được tra cứu trong các sổ đăng ký trước đó trước tiên và chỉ quay lại các sổ đăng ký sau này khi các mô-đun đó bị thiếu trong các sổ đăng ký trước đó.
Thẻ:changes_inputs
--vendor_dir=<a path>
mặc định: xem nội dung mô tả-
Chỉ định thư mục sẽ chứa các kho lưu trữ bên ngoài ở chế độ nhà cung cấp, cho dù mục đích là tìm nạp các kho lưu trữ đó vào thư mục hay sử dụng các kho lưu trữ đó trong khi xây dựng. Bạn có thể chỉ định đường dẫn dưới dạng đường dẫn tuyệt đối hoặc đường dẫn tương đối đến thư mục không gian làm việc.
Thẻ:loading_and_analysis
- Các tuỳ chọn kích hoạt tính năng tối ưu hoá thời gian xây dựng:
--gc_thrashing_limits=<comma separated pairs of <period>:<count>>
mặc định: "1s:2,20s:3,1m:5"-
Các giới hạn nếu đạt đến sẽ khiến GcThrashingDetector gặp sự cố Bazel với OOM. Mỗi giới hạn được chỉ định là <period>:<count>, trong đó period là thời lượng và count là số nguyên dương. Nếu hơn --gc_thrashing_threshold phần trăm không gian cố định (vùng nhớ khối xếp cũ) vẫn bị chiếm dụng sau <count> lần GC đầy đủ liên tiếp trong <period>, thì lỗi OOM sẽ được kích hoạt. Bạn có thể chỉ định nhiều giới hạn, phân tách bằng dấu phẩy.
Thẻ:host_machine_resource_optimizations
--skyframe_high_water_mark_full_gc_drops_per_invocation=<an integer, >= 0>
mặc định: "2147483647"-
Cờ cho cấu hình nâng cao của công cụ Skyframe nội bộ của Bazel. Nếu phát hiện mức sử dụng phần trăm vùng nhớ khối xếp được giữ lại vượt quá ngưỡng do --skyframe_high_water_mark_threshold đặt ra, thì khi một sự kiện GC đầy đủ xảy ra, Bazel sẽ loại bỏ trạng thái Skyframe tạm thời không cần thiết, lên đến nhiều lần như vậy cho mỗi lệnh gọi. Mặc định là Integer.MAX_VALUE; không giới hạn về mặt hiệu quả. Giá trị 0 có nghĩa là các sự kiện GC đầy đủ sẽ không bao giờ kích hoạt sự kiện thả. Nếu đạt đến giới hạn, trạng thái Skyframe sẽ không còn bị loại bỏ khi một sự kiện GC đầy đủ xảy ra và vượt quá ngưỡng phần trăm vùng nhớ khối xếp được giữ lại đó.
Thẻ:host_machine_resource_optimizations
--skyframe_high_water_mark_minor_gc_drops_per_invocation=<an integer, >= 0>
mặc định: "2147483647"-
Cờ cho cấu hình nâng cao của công cụ Skyframe nội bộ của Bazel. Nếu phát hiện mức sử dụng phần trăm vùng nhớ khối xếp được giữ lại vượt quá ngưỡng do --skyframe_high_water_mark_threshold đặt ra, thì khi một sự kiện GC nhỏ xảy ra, Bazel sẽ loại bỏ trạng thái Skyframe tạm thời không cần thiết, lên đến nhiều lần như vậy mỗi lần gọi. Mặc định là Integer.MAX_VALUE; không giới hạn về mặt hiệu quả. Giá trị 0 có nghĩa là các sự kiện GC nhỏ sẽ không bao giờ kích hoạt sự kiện thả. Nếu đạt đến giới hạn, trạng thái Skyframe sẽ không còn bị loại bỏ khi một sự kiện GC nhỏ xảy ra và vượt quá ngưỡng phần trăm vùng nhớ khối xếp được giữ lại.
Thẻ:host_machine_resource_optimizations
--skyframe_high_water_mark_threshold=<an integer>
mặc định: "85"-
Cờ cho cấu hình nâng cao của công cụ Skyframe nội bộ của Bazel. Nếu phát hiện mức sử dụng phần trăm vùng nhớ khối xếp được giữ lại ít nhất là ngưỡng này, Bazel sẽ loại bỏ trạng thái Skyframe tạm thời không cần thiết. Việc điều chỉnh điều này có thể giúp bạn giảm thiểu tác động của tình trạng GC bị lỗi khi (i) tình trạng này là do mức sử dụng bộ nhớ của trạng thái tạm thời và (ii) tốn kém hơn so với việc tạo lại trạng thái khi cần.
Thẻ:host_machine_resource_optimizations
- Các tuỳ chọn ảnh hưởng đến mức độ chi tiết, định dạng hoặc vị trí ghi nhật ký:
--experimental_command_profile=<cpu, wall, alloc or lock>
mặc định: xem nội dung mô tả- Ghi hồ sơ Trình ghi chuyến bay Java trong thời gian thực thi lệnh. Bạn phải cung cấp một trong các loại sự kiện phân tích tài nguyên được hỗ trợ (cpu, wall, alloc hoặc lock) dưới dạng đối số. Hồ sơ được ghi vào một tệp được đặt tên theo loại sự kiện trong thư mục cơ sở đầu ra. Cú pháp và ngữ nghĩa của cờ này có thể thay đổi trong tương lai để hỗ trợ thêm các loại hồ sơ hoặc định dạng đầu ra; bạn tự chịu rủi ro khi sử dụng.
- Giá trị mặc định của
--[no]experimental_record_metrics_for_all_mnemonics
: "false" - Theo mặc định, số lượng loại thao tác được giới hạn ở 20 câu thần chú có số lượng thao tác được thực thi nhiều nhất. Việc đặt tuỳ chọn này sẽ ghi số liệu thống kê cho tất cả các câu thần chú.
- Các tuỳ chọn chỉ định hoặc thay đổi dữ liệu đầu vào chung thành một lệnh Bazel không thuộc các danh mục khác.:
--experimental_resolved_file_instead_of_workspace=<a string>
mặc định: ""- Nếu không trống, hãy đọc tệp đã phân giải được chỉ định thay vì tệp WORKSPACE
Thẻ:changes_inputs
- Các tuỳ chọn thực thi và lưu vào bộ nhớ đệm từ xa:
--experimental_downloader_config=<a string>
mặc định: xem nội dung mô tả- Chỉ định một tệp để định cấu hình trình tải xuống từ xa. Tệp này bao gồm các dòng, mỗi dòng bắt đầu bằng một lệnh (`allow`, `block` hoặc `rewrite`), theo sau là tên máy chủ lưu trữ (đối với lệnh `allow` và `block`) hoặc hai mẫu, một mẫu để so khớp và một mẫu để sử dụng làm URL thay thế, với các tệp tham chiếu ngược bắt đầu từ `$1`. Bạn có thể cung cấp nhiều lệnh `rewrite` cho cùng một URL và trong trường hợp này, nhiều URL sẽ được trả về.
- Giá trị mặc định của
--experimental_worker_for_repo_fetching=<off, platform, virtual or auto>
: "tự động" - Chế độ tạo luồng để tìm nạp kho lưu trữ. Nếu bạn đặt thành "tắt", thì không có luồng worker nào được sử dụng và quá trình tìm nạp kho lưu trữ sẽ phải khởi động lại. Nếu không, hãy sử dụng luồng worker ảo.
- Các tuỳ chọn khác, không được phân loại theo cách khác.:
--override_repository=<an equals-separated mapping of repository name to path>
nhiều lần sử dụng được tích luỹ- Ghi đè kho lưu trữ bằng một đường dẫn cục bộ ở dạng <repository name>=<path>. Nếu đường dẫn đã cho là đường dẫn tuyệt đối, thì đường dẫn đó sẽ được sử dụng nguyên trạng. Nếu đường dẫn đã cho là đường dẫn tương đối, thì đường dẫn đó sẽ tương ứng với thư mục đang hoạt động. Nếu đường dẫn đã cho bắt đầu bằng "%workspace%", thì đường dẫn đó sẽ tương ứng với thư mục gốc của không gian làm việc, là kết quả của lệnh "bazel info workspace". Nếu đường dẫn đã cho trống, hãy xoá mọi chế độ ghi đè trước đó.
- Các tuỳ chọn kiểm soát quá trình thực thi bản dựng:
- Giá trị mặc định của
--[no]experimental_inprocess_symlink_creation
: "false" -
Liệu có thực hiện lệnh gọi hệ thống tệp trực tiếp để tạo cây đường liên kết tượng trưng hay không
Thẻ:loading_and_analysis
,execution
,experimental
- Giá trị mặc định của
--[no]experimental_persistent_aar_extractor
: "false" -
Bật trình trích xuất aar liên tục bằng cách sử dụng worker.
Thẻ:execution
- Giá trị mặc định của
--[no]experimental_remotable_source_manifests
: "false" -
Liệu có nên thực hiện các thao tác trong tệp kê khai nguồn từ xa hay không
Thẻ:loading_and_analysis
,execution
,experimental
- Giá trị mặc định của
--[no]experimental_split_coverage_postprocessing
: "false" - Nếu đúng, Bazel sẽ chạy quy trình xử lý sau khi kiểm thử để kiểm thử trong một quá trình tạo mới.
Thẻ:execution
- Giá trị mặc định của
--[no]experimental_strict_fileset_output
: "false" - Nếu bạn bật tuỳ chọn này, các tập hợp tệp sẽ coi tất cả cấu phần phần mềm đầu ra là tệp thông thường. Các tệp này sẽ không duyệt qua các thư mục hoặc nhạy cảm với các đường liên kết tượng trưng.
Thẻ:execution
- Giá trị mặc định của
--[no]incompatible_disallow_unsound_directory_outputs
: "true" - Nếu được đặt, thao tác hiện thực hoá tệp đầu ra dưới dạng thư mục sẽ gây ra lỗi. Không ảnh hưởng đến thư mục nguồn. Xem https://github.com/bazelbuild/bazel/issues/18646.
Thẻ:bazel_internal_configuration
,incompatible_change
- Giá trị mặc định của
--[no]incompatible_modify_execution_info_additive
: "false" -
Khi được bật, việc truyền nhiều cờ --modify_execution_info sẽ có tính chất cộng gộp. Khi bị tắt, hệ thống sẽ chỉ xem xét cờ gần đây nhất.
Thẻ:execution
,affects_outputs
,loading_and_analysis
,incompatible_change
--modify_execution_info=<regex=[+-]key,regex=[+-]key,...>
nhiều lần sử dụng được tích luỹ-
Thêm hoặc xoá các khoá khỏi thông tin thực thi của một hành động dựa trên câu thần chú hành động. Chỉ áp dụng cho các hành động hỗ trợ thông tin thực thi. Nhiều hành động phổ biến hỗ trợ thông tin thực thi, ví dụ: Genrule, CppCompile, Javac, StarlarkAction, TestRunner. Khi chỉ định nhiều giá trị, thứ tự sẽ rất quan trọng vì nhiều biểu thức chính quy có thể áp dụng cho cùng một câu thần chú.
Cú pháp: "regex=[+-]key,regex=[+-]key,...".
Ví dụ: ".*=+x,.*=-y,.*=+z" sẽ thêm "x" và "z" vào, đồng thời xoá "y" khỏi thông tin thực thi cho tất cả các hành động.
"Genrule=+requires-x" sẽ thêm "requires-x" vào thông tin thực thi cho tất cả các hành động Genrule.
"(?!Genrule).*=-requires-x" xoá "requires-x" khỏi thông tin thực thi cho tất cả các hành động không phải Genrule.
Thẻ:execution
,affects_outputs
,loading_and_analysis
--persistent_android_dex_desugar
-
Bật các thao tác dex và đơn giản hoá Android liên tục bằng cách sử dụng worker.
Mở rộng thành:
--internal_persistent_android_dex_desugar
--strategy=Desugar=worker
--strategy=DexBuilder=worker
Thẻ:host_machine_resource_optimizations
,execution
--persistent_android_resource_processor
- Bật trình xử lý tài nguyên Android liên tục bằng cách sử dụng worker.
Mở rộng thành:
--internal_persistent_busybox_tools
--strategy=AaptPackage=worker
--strategy=AndroidResourceParser=worker
--strategy=AndroidResourceValidator=worker
--strategy=AndroidResourceCompiler=worker
--strategy=RClassGenerator=worker
--strategy=AndroidResourceLink=worker
--strategy=AndroidAapt2=worker
--strategy=AndroidAssetMerger=worker
--strategy=AndroidResourceMerger=worker
--strategy=AndroidCompiledResourceMerger=worker
--strategy=ManifestMerger=worker
--strategy=AndroidManifestMerger=worker
--strategy=Aapt2Optimize=worker
--strategy=AARGenerator=worker
--strategy=ProcessDatabinding=worker
--strategy=GenerateDataBindingBaseClasses=worker
Thẻ:host_machine_resource_optimizations
,execution
--persistent_multiplex_android_dex_desugar
-
Bật các thao tác dex và đơn giản hoá Android được đa kênh liên tục bằng cách sử dụng worker.
Mở rộng thành:
--persistent_android_dex_desugar
--internal_persistent_multiplex_android_dex_desugar
Thẻ:host_machine_resource_optimizations
,execution
--persistent_multiplex_android_resource_processor
-
Bật trình xử lý tài nguyên Android được đa kênh liên tục bằng cách sử dụng worker.
Mở rộng thành:
--persistent_android_resource_processor
--modify_execution_info=AaptPackage=+supports-multiplex-workers
--modify_execution_info=AndroidResourceParser=+supports-multiplex-workers
--modify_execution_info=AndroidResourceValidator=+supports-multiplex-workers
--modify_execution_info=AndroidResourceCompiler=+supports-multiplex-workers
--modify_execution_info=RClassGenerator=+supports-multiplex-workers
--modify_execution_info=AndroidResourceLink=+supports-multiplex-workers
--modify_execution_info=AndroidAapt2=+supports-multiplex-workers
--modify_execution_info=AndroidAssetMerger=+supports-multiplex-workers
--modify_execution_info=AndroidResourceMerger=+supports-multiplex-workers
--modify_execution_info=AndroidCompiledResourceMerger=+supports-multiplex-workers
--modify_execution_info=ManifestMerger=+supports-multiplex-workers
--modify_execution_info=AndroidManifestMerger=+supports-multiplex-workers
--modify_execution_info=Aapt2Optimize=+supports-multiplex-workers
--modify_execution_info=AARGenerator=+supports-multiplex-workers
Thẻ:host_machine_resource_optimizations
,execution
--persistent_multiplex_android_tools
- Bật các công cụ Android liên tục và đa kênh (dexing, desugaring, xử lý tài nguyên).
Mở rộng thành:
--internal_persistent_multiplex_busybox_tools
--persistent_multiplex_android_resource_processor
--persistent_multiplex_android_dex_desugar
Thẻ:host_machine_resource_optimizations
,execution
- Giá trị mặc định của
--[no]use_target_platform_for_tests
: "false" - Nếu đúng, Bazel sẽ sử dụng nền tảng mục tiêu để chạy kiểm thử thay vì nhóm thực thi kiểm thử.
Thẻ:execution
- Các tuỳ chọn định cấu hình chuỗi công cụ dùng để thực thi hành động:
--android_compiler=<a string>
mặc định: xem nội dung mô tả-
Trình biên dịch mục tiêu Android.
Thẻ:affects_outputs
,loading_and_analysis
,loses_incremental_state
--android_crosstool_top=<a build target label>
mặc định: "//external:android/crosstool"-
Vị trí của trình biên dịch C++ dùng cho các bản dựng Android.
Thẻ:affects_outputs
,changes_inputs
,loading_and_analysis
,loses_incremental_state
--android_grte_top=<a label>
mặc định: xem nội dung mô tả-
Mục tiêu Android grte_top.
Thẻ:changes_inputs
,loading_and_analysis
,loses_incremental_state
--android_manifest_merger=<legacy, android or force_android>
mặc định: "android"-
Chọn trình hợp nhất tệp kê khai để sử dụng cho các quy tắc android_binary. Cờ để giúp chuyển đổi sang trình hợp nhất tệp kê khai Android từ trình hợp nhất cũ.
Thẻ:affects_outputs
,loading_and_analysis
,loses_incremental_state
--android_platforms=<a build target label>
mặc định: ""-
Đặt các nền tảng mà mục tiêu android_binary sử dụng. Nếu bạn chỉ định nhiều nền tảng, thì tệp nhị phân sẽ là tệp APK lớn, chứa các tệp nhị phân gốc cho từng nền tảng mục tiêu được chỉ định.
Thẻ:changes_inputs
,loading_and_analysis
,loses_incremental_state
--android_sdk=<a build target label>
mặc định: "@bazel_tools//tools/android:sdk"- Chỉ định SDK/nền tảng Android dùng để tạo ứng dụng Android.
Thẻ:changes_inputs
,loading_and_analysis
,loses_incremental_state
--apple_crosstool_top=<a build target label>
mặc định: "@bazel_tools//tools/cpp:toolchain"-
Nhãn của gói công cụ đa nền tảng sẽ được dùng trong các quy tắc của Apple và Objc cũng như các phần phụ thuộc của các quy tắc đó.
Thẻ:loses_incremental_state
,changes_inputs
--cc_output_directory_tag=<a string>
mặc định: ""- Chỉ định hậu tố cần thêm vào thư mục cấu hình.
Thẻ:affects_outputs
--compiler=<a string>
mặc định: xem nội dung mô tả-
Trình biên dịch C++ dùng để biên dịch mục tiêu.
Thẻ:loading_and_analysis
,execution
--coverage_output_generator=<a build target label>
mặc định: "@bazel_tools//tools/test:lcov_merger"-
Vị trí của tệp nhị phân dùng để xử lý sau các báo cáo phạm vi thô. Hiện tại, đây phải là một nhóm tệp chứa một tệp duy nhất, tệp nhị phân. Giá trị mặc định là "//tools/test:lcov_merger".
Thẻ:changes_inputs
,affects_outputs
,loading_and_analysis
--coverage_report_generator=<a build target label>
mặc định: "@bazel_tools//tools/test:coverage_report_generator"-
Vị trí của tệp nhị phân dùng để tạo báo cáo mức độ sử dụng. Hiện tại, đây phải là một nhóm tệp chứa một tệp duy nhất, tệp nhị phân. Giá trị mặc định là "//tools/test:coverage_report_generator".
Thẻ:changes_inputs
,affects_outputs
,loading_and_analysis
--coverage_support=<a build target label>
mặc định: "@bazel_tools//tools/test:coverage_support"-
Vị trí của các tệp hỗ trợ bắt buộc trên dữ liệu đầu vào của mọi hành động kiểm thử thu thập mức độ sử dụng mã. Giá trị mặc định là "//tools/test:coverage_support".
Thẻ:changes_inputs
,affects_outputs
,loading_and_analysis
--crosstool_top=<a build target label>
mặc định: "@bazel_tools//tools/cpp:toolchain"-
Nhãn của gói công cụ đa nền tảng dùng để biên dịch mã C++.
Thẻ:loading_and_analysis
,changes_inputs
,affects_outputs
--custom_malloc=<a build target label>
mặc định: xem nội dung mô tả-
Chỉ định cách triển khai malloc tuỳ chỉnh. Chế độ cài đặt này sẽ ghi đè các thuộc tính malloc trong quy tắc bản dựng.
Thẻ:changes_inputs
,affects_outputs
--experimental_add_exec_constraints_to_targets=<a '<RegexFilter>=<label1>[,<label2>,...]' assignment>
nhiều lần sử dụng được tích luỹ-
Danh sách biểu thức chính quy được phân tách bằng dấu phẩy, mỗi biểu thức có thể có tiền tố là - (biểu thức phủ định), được gán (=) cho danh sách các mục tiêu giá trị quy tắc ràng buộc được phân tách bằng dấu phẩy. Nếu một mục tiêu không khớp với biểu thức âm và ít nhất một biểu thức dương, thì độ phân giải chuỗi công cụ của mục tiêu đó sẽ được thực hiện như thể mục tiêu đó đã khai báo các giá trị ràng buộc dưới dạng các ràng buộc thực thi. Ví dụ: //demo,-test=@platforms//cpus:x86_64 sẽ thêm "x86_64" vào bất kỳ mục tiêu nào trong //demo, ngoại trừ những mục tiêu có tên chứa "test".
Thẻ:loading_and_analysis
- Giá trị mặc định của
--[no]experimental_include_xcode_execution_requirements
: "false" - Nếu bạn đặt, hãy thêm yêu cầu thực thi "requires-xcode:{version}" vào mọi thao tác Xcode. Nếu phiên bản xcode có nhãn được nối bằng dấu gạch nối, hãy thêm yêu cầu thực thi "requires-xcode-label:{version_label}".
Thẻ:loses_incremental_state
,loading_and_analysis
,execution
- Giá trị mặc định của
--[no]experimental_prefer_mutual_xcode
: "true" - Nếu đúng, hãy sử dụng Xcode mới nhất có sẵn cả cục bộ và từ xa. Nếu giá trị là false hoặc nếu không có phiên bản nào có sẵn, hãy sử dụng phiên bản Xcode cục bộ được chọn thông qua xcode-select.
Thẻ:loses_incremental_state
--extra_execution_platforms=<comma-separated list of options>
mặc định: ""-
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(). Bạn chỉ có thể đặt tuỳ chọn này một lần; các thực thể sau đó sẽ ghi đè các chế độ cài đặt cờ trước đó.
Thẻ:execution
--extra_toolchains=<comma-separated list of options>
nhiều lần sử dụng được tích luỹ-
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 những chuỗi công cụ được khai báo trong tệp WORKSPACE bằng register_toolchains().
Thẻ:affects_outputs
,changes_inputs
,loading_and_analysis
--grte_top=<a label>
mặc định: xem nội dung mô tả-
Nhãn cho thư viện libc đã kiểm tra. Giá trị mặc định được chuỗi công cụ crosstool chọn và bạn hầu như không bao giờ cần ghi đè giá trị này.
Thẻ:action_command_lines
,affects_outputs
--host_compiler=<a string>
mặc định: xem nội dung mô tả-
Trình biên dịch C++ để sử dụng cho quá trình biên dịch máy chủ lưu trữ. Giá trị này sẽ bị bỏ qua nếu bạn không đặt --host_crosstool_top.
Thẻ:loading_and_analysis
,execution
--host_crosstool_top=<a build target label>
mặc định: xem nội dung mô tả- Theo mặc định, các tuỳ chọn --crosstool_top và --compiler cũng được dùng cho cấu hình exec. Nếu bạn cung cấp cờ này, Bazel sẽ sử dụng libc và trình biên dịch mặc định cho crosstool_top đã cho.
Thẻ:loading_and_analysis
,changes_inputs
,affects_outputs
--host_grte_top=<a label>
mặc định: xem nội dung mô tả- Nếu được chỉ định, chế độ cài đặt này sẽ ghi đè thư mục cấp cao nhất libc (--grte_top) cho cấu hình thực thi.
Thẻ:action_command_lines
,affects_outputs
--host_platform=<a build target label>
mặc định: "@bazel_tools//tools:host_platform"-
Nhãn của quy tắc nền tảng mô tả hệ thống lưu trữ.
Thẻ:affects_outputs
,changes_inputs
,loading_and_analysis
- Giá trị mặc định của
--[no]incompatible_dont_enable_host_nonhost_crosstool_features
: "true" - Nếu đúng, Bazel sẽ không bật các tính năng "máy chủ" và "không phải máy chủ" trong chuỗi công cụ c++ (xem https://github.com/bazelbuild/bazel/issues/7407 để biết thêm thông tin).
Thẻ:loading_and_analysis
,incompatible_change
- Giá trị mặc định của
--[no]incompatible_enable_android_toolchain_resolution
: "true" -
Sử dụng độ phân giải chuỗi công cụ để chọn SDK Android cho các quy tắc Android (Starlark và gốc)
Thẻ:loading_and_analysis
,incompatible_change
- Giá trị mặc định của
--[no]incompatible_enable_apple_toolchain_resolution
: "false" -
Sử dụng độ phân giải chuỗi công cụ để chọn SDK Apple cho các quy tắc của Apple (Starlark và gốc)
Thẻ:loading_and_analysis
,incompatible_change
- Giá trị mặc định của
--[no]incompatible_make_thinlto_command_lines_standalone
: "true" - Nếu đúng, Bazel sẽ không sử dụng lại các dòng lệnh thao tác liên kết C++ cho các dòng lệnh lập chỉ mục lto (xem https://github.com/bazelbuild/bazel/issues/6791 để biết thêm thông tin).
Thẻ:loading_and_analysis
,incompatible_change
- Giá trị mặc định của
--[no]incompatible_remove_legacy_whole_archive
: "true" - Nếu đúng, theo mặc định, Bazel sẽ không liên kết các phần phụ thuộc thư viện dưới dạng toàn bộ bản lưu trữ (xem https://github.com/bazelbuild/bazel/issues/7362 để biết hướng dẫn di chuyển).
Thẻ:loading_and_analysis
,incompatible_change
- Giá trị mặc định của
--[no]incompatible_require_ctx_in_configure_features
: "true" - Nếu đúng, Bazel sẽ yêu cầu tham số "ctx" trong cc_common.configure_features (xem https://github.com/bazelbuild/bazel/issues/7793 để biết thêm thông tin).
Thẻ:loading_and_analysis
,incompatible_change
- Sử dụng đối tượng dùng chung giao diện nếu chuỗi công cụ hỗ trợ. Tất cả chuỗi công cụ ELF hiện đều hỗ trợ chế độ cài đặt này.
Thẻ:loading_and_analysis
,affects_outputs
,affects_outputs
--ios_sdk_version=<a dotted version (for example '2.3' or '3.3alpha2.4')>
mặc định: xem nội dung mô tả-
Chỉ định phiên bản SDK iOS để sử dụng nhằm xây dựng ứng dụng iOS. Nếu không chỉ định, hãy sử dụng phiên bản SDK iOS mặc định từ "xcode_version".
Thẻ:loses_incremental_state
--macos_sdk_version=<a dotted version (for example '2.3' or '3.3alpha2.4')>
mặc định: xem nội dung mô tả-
Chỉ định phiên bản SDK macOS để sử dụng nhằm tạo ứng dụng macOS. Nếu không chỉ định, sẽ sử dụng phiên bản SDK macOS mặc định từ "xcode_version".
Thẻ:loses_incremental_state
--minimum_os_version=<a string>
mặc định: xem nội dung mô tả- Phiên bản hệ điều hành tối thiểu mà mục tiêu biên dịch của bạn nhắm đến.
Thẻ:loading_and_analysis
,affects_outputs
--platform_mappings=<a relative path>
mặc định: ""-
Vị trí của tệp ánh xạ mô tả nền tảng nào sẽ sử dụng nếu không có nền tảng nào được đặt hoặc cờ nào sẽ được đặt khi nền tảng đã tồn tại. Phải tương ứng với thư mục gốc của không gian làm việc chính. Mặc định là "platform_mappings" (một tệp nằm ngay trong thư mục gốc của không gian làm việc).
Thẻ:affects_outputs
,changes_inputs
,loading_and_analysis
--platforms=<a build target label>
mặc định: ""-
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.
Thẻ:affects_outputs
,changes_inputs
,loading_and_analysis
--python2_path=<a string>
mặc định: xem nội dung mô tả-
Không dùng nữa, không hoạt động. Tắt bằng `--incompatible_use_python_toolchains`.
Thẻ:no_op
,deprecated
--python3_path=<a string>
mặc định: xem nội dung mô tả-
Không dùng nữa, không hoạt động. Tắt bằng `--incompatible_use_python_toolchains`.
Thẻ:no_op
,deprecated
--python_path=<a string>
mặc định: xem nội dung mô tả-
Đường dẫn tuyệt đối của trình thông dịch Python được gọi để chạy các mục tiêu Python trên nền tảng mục tiêu. Không dùng nữa; bị vô hiệu hoá bằng --incompatible_use_python_toolchains.
Thẻ:loading_and_analysis
,affects_outputs
--python_top=<a build target label>
mặc định: xem nội dung mô tả-
Nhãn của py_runtime đại diện cho trình thông dịch Python được gọi để chạy các mục tiêu Python trên nền tảng mục tiêu. Không dùng nữa; bị vô hiệu hoá bằng --incompatible_use_python_toolchains.
Thẻ:loading_and_analysis
,affects_outputs
--tvos_sdk_version=<a dotted version (for example '2.3' or '3.3alpha2.4')>
mặc định: xem nội dung mô tả-
Chỉ định phiên bản SDK tvOS để sử dụng nhằm xây dựng ứng dụng tvOS. Nếu không chỉ định, hãy sử dụng phiên bản SDK tvOS mặc định từ "xcode_version".
Thẻ:loses_incremental_state
--watchos_sdk_version=<a dotted version (for example '2.3' or '3.3alpha2.4')>
mặc định: xem nội dung mô tả- Chỉ định phiên bản SDK watchOS để sử dụng nhằm xây dựng ứng dụng watchOS. Nếu không chỉ định, hãy sử dụng phiên bản SDK watchOS mặc định từ "xcode_version".
Thẻ:loses_incremental_state
--xcode_version=<a string>
mặc định: xem nội dung mô tả- Nếu được chỉ định, hãy sử dụng Xcode của phiên bản đã cho cho các thao tác bản dựng có liên quan. Nếu không chỉ định, hãy sử dụng phiên bản trình thực thi mặc định của Xcode.
Thẻ:loses_incremental_state
--xcode_version_config=<a build target label>
mặc định: "@bazel_tools//tools/cpp:host_xcodes"-
Nhãn của quy tắc xcode_config dùng để chọn phiên bản Xcode trong cấu hình bản dựng.
Thẻ:loses_incremental_state
,loading_and_analysis
- Các tuỳ chọn kiểm soát đầu ra của lệnh:
- Giá trị mặc định của
--[no]apple_generate_dsym
: "false" -
Liệu có tạo (các) tệp biểu tượng gỡ lỗi (.dSYM) hay không.
Thẻ:affects_outputs
,action_command_lines
- Giá trị mặc định của
--[no]build_runfile_links
: "true" - Nếu đúng, hãy tạo rừng đường liên kết tượng trưng cho tệp chạy cho tất cả các mục tiêu. Nếu giá trị là false, chỉ ghi các tệp này khi một hành động cục bộ, lệnh kiểm thử hoặc chạy yêu cầu.
Thẻ:affects_outputs
- Giá trị mặc định của
--[no]build_runfile_manifests
: "true" - Nếu đúng, hãy ghi tệp kê khai tệp chạy cho tất cả các mục tiêu. Nếu sai, hãy bỏ qua các giá trị này. Các kiểm thử cục bộ sẽ không chạy được khi giá trị là false.
Thẻ:affects_outputs
- Giá trị mặc định của
--[no]build_test_dwp
: "false" - Nếu được bật, khi tạo các chương trình kiểm thử C++ một cách tĩnh và có tính năng phân tách, tệp .dwp cho tệp nhị phân kiểm thử cũng sẽ được tạo tự động.
Thẻ:loading_and_analysis
,affects_outputs
--cc_proto_library_header_suffixes=<comma-separated set of options>
mặc định: ".pb.h"- Đặt hậu tố của các tệp tiêu đề mà cc_proto_library tạo.
Thẻ:affects_outputs
,loading_and_analysis
--cc_proto_library_source_suffixes=<comma-separated set of options>
mặc định: ".pb.cc"-
Đặt hậu tố của các tệp nguồn mà cc_proto_library tạo.
Thẻ:affects_outputs
,loading_and_analysis
- Giá trị mặc định của
--[no]experimental_proto_descriptor_sets_include_source_info
: "false" -
Chạy các thao tác bổ sung cho các phiên bản API Java thay thế trong proto_library.
Thẻ:affects_outputs
,loading_and_analysis
,experimental
- Giá trị mặc định của
--[no]experimental_proto_extra_actions
: "false" -
Chạy các thao tác bổ sung cho các phiên bản API Java thay thế trong proto_library.
Thẻ:affects_outputs
,loading_and_analysis
,experimental
- Giá trị mặc định của
--[no]experimental_save_feature_state
: "false" -
Lưu trạng thái của các tính năng đã bật và được yêu cầu dưới dạng kết quả biên dịch.
Thẻ:affects_outputs
,experimental
--fission=<a set of compilation modes>
mặc định: "no"- Chỉ định chế độ biên dịch nào sử dụng tính năng phân hạch cho các bản biên dịch và đường liên kết C++. Có thể là bất kỳ tổ hợp nào của {'fastbuild', 'dbg', 'opt'} hoặc các giá trị đặc biệt "yes" để bật tất cả chế độ và "no" để tắt tất cả chế độ.
Thẻ:loading_and_analysis
,action_command_lines
,affects_outputs
- Giá trị mặc định của
--[no]incompatible_always_include_files_in_data
: "true" - Nếu đúng, các quy tắc gốc sẽ thêm <code>DefaultInfo.files</code> của các phần phụ thuộc dữ liệu vào tệp chạy của chúng, khớp với hành vi được đề xuất cho các quy tắc Starlark (https://bazel.build/extending/rules#runfiles_features_to_avoid).
Thẻ:affects_outputs
,incompatible_change
- Giá trị mặc định của
--[no]legacy_external_runfiles
: "true" - Nếu đúng, hãy tạo rừng đường liên kết tượng trưng cho tệp chạy cho các kho lưu trữ bên ngoài trong .runfiles/wsname/external/repo (ngoài .runfiles/repo).
Thẻ:affects_outputs
- Giá trị mặc định của
--[no]objc_generate_linkmap
: "false" -
Chỉ định xem có tạo tệp liên kết hay không.
Thẻ:affects_outputs
- Giá trị mặc định của
--[no]save_temps
: "false" - Nếu được đặt, kết quả tạm thời từ gcc sẽ được lưu. Các tệp này bao gồm tệp .s (mã tập hợp), tệp .i (C được xử lý trước) và tệp .ii (C++ được xử lý trước).
Thẻ:affects_outputs
- Các tuỳ chọn cho phép người dùng định cấu hình đầu ra dự kiến, ảnh hưởng đến giá trị của đầu ra đó, thay vì sự tồn tại của đầu ra:
--action_env=<a 'name=value' assignment with an optional value part>
nhiều lần sử dụng được tích luỹ-
Chỉ định tập hợp các biến môi trường có sẵn cho các hành động có cấu hình mục tiêu. Bạn có thể chỉ định biến theo tên, trong trường hợp này giá trị sẽ được lấy từ môi trường gọi, hoặc theo cặp name=value để đặt giá trị độc lập với môi trường gọi. Bạn có thể sử dụng tuỳ chọn này nhiều lần; đối với các tuỳ chọn được đưa ra cho cùng một biến, tuỳ chọn mới nhất sẽ thắng, còn các tuỳ chọn cho các biến khác nhau sẽ được tích luỹ.
Thẻ:action_command_lines
--android_cpu=<a string>
mặc định: "armeabi-v7a"- CPU mục tiêu của Android.
Thẻ:affects_outputs
,loading_and_analysis
,loses_incremental_state
- Giá trị mặc định của
--[no]android_databinding_use_androidx
: "true" - Tạo các tệp liên kết dữ liệu tương thích với AndroidX. Phương thức này chỉ được dùng với databinding v2. Cờ này không có tác dụng.
Thẻ:affects_outputs
,loading_and_analysis
,loses_incremental_state
,experimental
- Giá trị mặc định của
--[no]android_databinding_use_v3_4_args
: "true" -
Sử dụng android databinding v2 với đối số 3.4.0. Cờ này không có tác dụng.
Thẻ:affects_outputs
,loading_and_analysis
,loses_incremental_state
,experimental
--android_dynamic_mode=<off, default or fully>
mặc định: "off"- xác định xem các phần phụ thuộc C++ của quy tắc Android có được liên kết động khi cc_binary không tạo thư viện dùng chung một cách rõ ràng hay không. "mặc định" có nghĩa là bazel sẽ chọn xem có liên kết động hay không. "đầy đủ" có nghĩa là tất cả thư viện sẽ được liên kết động. "tắt" có nghĩa là tất cả thư viện sẽ được liên kết chủ yếu ở chế độ tĩnh.
Thẻ:affects_outputs
,loading_and_analysis
--android_manifest_merger_order=<alphabetical, alphabetical_by_configuration or dependency>
mặc định: "alphabetical"-
Đặt thứ tự của tệp kê khai được chuyển đến trình sáp nhập tệp kê khai cho tệp nhị phân Android. ALPHABETICAL (TĂNG DẦN) nghĩa là tệp kê khai được sắp xếp theo đường dẫn tương ứng với execroot. ALPHABETICAL_BY_CONFIGURATION có nghĩa là tệp kê khai được sắp xếp theo đường dẫn tương ứng với thư mục cấu hình trong thư mục đầu ra. DEPENDENCY (PHẦN PHỤ THUỘC) có nghĩa là tệp kê khai được sắp xếp theo thứ tự tệp kê khai của mỗi thư viện đứng trước tệp kê khai của các phần phụ thuộc.
Thẻ:action_command_lines
,execution
- Giá trị mặc định của
--[no]android_resource_shrinking
: "false" - Bật tính năng rút gọn tài nguyên cho các tệp APK android_binary sử dụng ProGuard.
Thẻ:affects_outputs
,loading_and_analysis
- Giá trị mặc định của
--[no]build_python_zip
: "tự động" -
Tạo tệp zip có thể thực thi python; bật trên Windows, tắt trên các nền tảng khác
Thẻ:affects_outputs
--catalyst_cpus=<comma-separated list of options>
nhiều lần sử dụng được tích luỹ-
Danh sách các cấu trúc được phân tách bằng dấu phẩy để tạo tệp nhị phân Apple Catalyst.
Thẻ:loses_incremental_state
,loading_and_analysis
- Giá trị mặc định của
--[no]collect_code_coverage
: "false" - Nếu được chỉ định, Bazel sẽ đo lường mã (sử dụng công cụ đo lường ngoại tuyến nếu có thể) và sẽ thu thập thông tin về mức độ sử dụng trong quá trình kiểm thử. Chỉ những mục tiêu khớp với --instrumentation_filter mới bị ảnh hưởng. Thông thường, bạn không nên chỉ định trực tiếp tuỳ chọn này – thay vào đó, hãy sử dụng lệnh "bazel coverage".
Thẻ:affects_outputs
--compilation_mode=<fastbuild, dbg or opt>
[-c
] mặc định: "fastbuild"-
Chỉ định chế độ mà tệp nhị phân sẽ được tạo. Giá trị: "fastbuild", "dbg", "opt".
Thẻ:affects_outputs
,action_command_lines
--conlyopt=<a string>
nhiều lần sử dụng được tích luỹ- Tuỳ chọn bổ sung để truyền đến gcc khi biên dịch tệp nguồn C.
Thẻ:action_command_lines
,affects_outputs
--copt=<a string>
nhiều lần sử dụng được tích luỹ-
Các tuỳ chọn bổ sung để truyền đến gcc.
Thẻ:action_command_lines
,affects_outputs
--cpu=<a string>
mặc định: ""- CPU mục tiêu.
Thẻ:changes_inputs
,affects_outputs
--cs_fdo_absolute_path=<a string>
mặc định: xem nội dung mô tả-
Sử dụng thông tin hồ sơ CSFDO để tối ưu hoá quá trình biên dịch. Chỉ định tên đường dẫn tuyệt đối của tệp zip chứa tệp hồ sơ, tệp hồ sơ LLVM thô hoặc được lập chỉ mục.
Thẻ:affects_outputs
--cs_fdo_instrument=<a string>
mặc định: xem nội dung mô tả-
Tạo tệp nhị phân bằng khả năng đo lường FDO nhạy cảm với ngữ cảnh. Với trình biên dịch Clang/LLVM, trình biên dịch này cũng chấp nhận tên thư mục mà(các) tệp hồ sơ thô sẽ được kết xuất trong thời gian chạy.
Thẻ:affects_outputs
--cs_fdo_profile=<a build target label>
mặc định: xem nội dung mô tả-
cs_fdo_profile đại diện cho hồ sơ nhạy cảm theo ngữ cảnh sẽ được dùng để tối ưu hoá.
Thẻ:affects_outputs
--cxxopt=<a string>
nhiều lần sử dụng được tích luỹ- Tuỳ chọn bổ sung để truyền đến gcc khi biên dịch tệp nguồn C++.
Thẻ:action_command_lines
,affects_outputs
--define=<a 'name=value' assignment>
nhiều lần sử dụng được tích luỹ-
Mỗi tuỳ chọn --define chỉ định một giá trị gán cho một biến bản dựng.
Thẻ:changes_inputs
,affects_outputs
- Giá trị mặc định của
--dynamic_mode=<off, default or fully>
: "mặc định" - Xác định xem tệp nhị phân C++ có được liên kết động hay không. "mặc định" có nghĩa là Bazel sẽ chọn xem có liên kết động hay không. "đầy đủ" có nghĩa là tất cả thư viện sẽ được liên kết động. "tắt" có nghĩa là tất cả thư viện sẽ được liên kết chủ yếu ở chế độ tĩnh.
Thẻ:loading_and_analysis
,affects_outputs
- Giá trị mặc định của
--[no]enable_fdo_profile_absolute_path
: "true" - Nếu bạn đặt, việc sử dụng fdo_absolute_profile_path sẽ gây ra lỗi.
Thẻ:affects_outputs
- Giá trị mặc định của
--[no]enable_runfiles
: "tự động" - Bật cây đường liên kết tượng trưng của tệp chạy; Theo mặc định, tính năng này sẽ tắt trên Windows và trên các nền tảng khác.
Thẻ:affects_outputs
--experimental_action_listener=<a build target label>
nhiều lần sử dụng được tích luỹ- Ngừng sử dụng và thay bằng các khía cạnh. Sử dụng action_listener để đính kèm extra_action vào các hành động bản dựng hiện có.
Thẻ:execution
,experimental
- Giá trị mặc định của
--[no]experimental_android_compress_java_resources
: "false" -
Nén tài nguyên Java trong tệp APK
Thẻ:affects_outputs
,loading_and_analysis
,experimental
- Giá trị mặc định của
--[no]experimental_android_databinding_v2
: "true" -
Sử dụng android databinding v2. Cờ này không có tác dụng.
Thẻ:affects_outputs
,loading_and_analysis
,loses_incremental_state
,experimental
- Giá trị mặc định của
--[no]experimental_android_resource_shrinking
: "false" - Bật tính năng rút gọn tài nguyên cho các tệp APK android_binary sử dụng ProGuard.
Thẻ:affects_outputs
,loading_and_analysis
- Giá trị mặc định của
--[no]experimental_android_rewrite_dexes_with_rex
: "false" -
sử dụng công cụ rex để ghi lại các tệp dex
Thẻ:affects_outputs
,loading_and_analysis
,loses_incremental_state
,experimental
- Giá trị mặc định của
--[no]experimental_collect_code_coverage_for_generated_files
: "false" - Nếu được chỉ định, Bazel cũng sẽ tạo thông tin thu thập mức độ sử dụng cho các tệp đã tạo.
Thẻ:affects_outputs
--experimental_objc_fastbuild_options=<comma-separated list of options>
mặc định: "-O0,-DDEBUG=1"-
Sử dụng các chuỗi này làm tuỳ chọn trình biên dịch bản dựng nhanh objc.
Thẻ:action_command_lines
- Giá trị mặc định của
--[no]experimental_omitfp
: "false" - Nếu đúng, hãy sử dụng libunwind để gỡ bỏ ngăn xếp và biên dịch bằng -fomit-frame-pointer và -fasynchronous-unwind-tables.
Thẻ:action_command_lines
,affects_outputs
,experimental
--experimental_output_paths=<off, content or strip>
mặc định: "off"-
Mô hình nào sẽ được sử dụng cho vị trí trong quy tắc cây đầu ra ghi đầu ra của chúng, đặc biệt là đối với các bản dựng đa nền tảng / đa cấu hình. Đây là một tính năng thử nghiệm. Hãy xem https://github.com/bazelbuild/bazel/issues/6526 để biết thông tin chi tiết. Các hành động Starlark có thể chọn sử dụng tính năng liên kết đường dẫn bằng cách thêm khoá "supports-path-mapping" vào tập hợp "execution_requirements".
Thẻ:loses_incremental_state
,bazel_internal_configuration
,affects_outputs
,execution
--experimental_override_name_platform_in_output_dir=<a 'label=value' assignment>
nhiều lần sử dụng được tích luỹ-
Mỗi mục nhập phải có dạng label=value, trong đó label (nhãn) tham chiếu đến một nền tảng và value (giá trị) là tên ngắn mong muốn để sử dụng trong đường dẫn đầu ra. Chỉ được dùng khi --experimental_platform_in_output_dir là true. Có mức độ ưu tiên đặt tên cao nhất.
Thẻ:affects_outputs
,experimental
- Giá trị mặc định của
--[no]experimental_platform_in_output_dir
: "false" - Nếu đúng, tên ngắn cho nền tảng mục tiêu sẽ được dùng trong tên thư mục đầu ra thay vì CPU. Lược đồ chính xác là thử nghiệm và có thể thay đổi: Trước tiên, trong trường hợp hiếm hoi tuỳ chọn --platforms không có đúng một giá trị, thì một hàm băm của tuỳ chọn platforms sẽ được sử dụng. Tiếp theo, nếu bất kỳ tên ngắn nào cho nền tảng hiện tại được đăng ký bằng --experimental_override_name_platform_in_output_dir, thì tên ngắn đó sẽ được sử dụng. Sau đó, nếu bạn đặt --experimental_use_platforms_in_output_dir_legacy_heuristic, hãy sử dụng tên ngắn dựa trên Nhãn nền tảng hiện tại. Cuối cùng, hàm băm của tuỳ chọn nền tảng sẽ được dùng làm phương án cuối cùng.
Thẻ:affects_outputs
,experimental
- Giá trị mặc định của
--[no]experimental_use_llvm_covmap
: "false" - Nếu được chỉ định, Bazel sẽ tạo thông tin bản đồ mức độ sử dụng llvm-cov thay vì gcov khi bật collect_code_coverage.
Thẻ:changes_inputs
,affects_outputs
,loading_and_analysis
,experimental
- Giá trị mặc định của
--[no]experimental_use_platforms_in_output_dir_legacy_heuristic
: "true" -
Vui lòng chỉ sử dụng cờ này trong chiến lược di chuyển hoặc kiểm thử được đề xuất. Xin lưu ý rằng phương pháp phỏng đoán có những thiếu sót đã biết và bạn nên chuyển sang chỉ dựa vào --experimental_override_name_platform_in_output_dir.
Thẻ:affects_outputs
,experimental
--fat_apk_cpu=<comma-separated set of options>
mặc định: "armeabi-v7a"-
Việc đặt tuỳ chọn này sẽ bật các tệp APK lớn, chứa các tệp nhị phân gốc cho tất cả các cấu trúc mục tiêu được chỉ định, ví dụ: --fat_apk_cpu=x86,armeabi-v7a. Nếu bạn chỉ định cờ này, thì --android_cpu sẽ bị bỏ qua đối với các phần phụ thuộc của quy tắc android_binary.
Thẻ:affects_outputs
,loading_and_analysis
,loses_incremental_state
- Giá trị mặc định của
--[no]fat_apk_hwasan
: "false" -
Liệu có tạo các phần phân tách HWASAN hay không.
Thẻ:affects_outputs
,loading_and_analysis
,loses_incremental_state
--fdo_instrument=<a string>
mặc định: xem nội dung mô tả-
Tạo tệp nhị phân bằng khả năng đo lường FDO. Với trình biên dịch Clang/LLVM, trình biên dịch này cũng chấp nhận tên thư mục mà(các) tệp hồ sơ thô sẽ được kết xuất trong thời gian chạy.
Thẻ:affects_outputs
--fdo_optimize=<a string>
mặc định: xem nội dung mô tả- Sử dụng thông tin hồ sơ FDO để tối ưu hoá quá trình biên dịch. Chỉ định tên của tệp zip chứa cây tệp .gcda, tệp afdo chứa hồ sơ tự động hoặc tệp hồ sơ LLVM. Cờ này cũng chấp nhận các tệp được chỉ định làm nhãn (ví dụ: `//foo/bar:file.afdo` – bạn có thể cần thêm một lệnh `exports_files` vào gói tương ứng) và các nhãn trỏ đến mục tiêu `fdo_profile`. Cờ này sẽ được thay thế bằng quy tắc `fdo_profile`.
Thẻ:affects_outputs
--fdo_prefetch_hints=<a build target label>
mặc định: xem nội dung mô tả-
Sử dụng gợi ý tìm nạp trước bộ nhớ đệm.
Thẻ:affects_outputs
--fdo_profile=<a build target label>
mặc định: xem nội dung mô tả-
fdo_profile đại diện cho hồ sơ sẽ được dùng để tối ưu hoá.
Thẻ:affects_outputs
--features=<a string>
nhiều lần sử dụng được tích luỹ- Theo mặc định, các tính năng đã cho sẽ được bật hoặc tắt đối với các mục tiêu được tạo trong cấu hình mục tiêu. Việc chỉ định -<feature> sẽ tắt tính năng đó. Các đặc điểm tiêu cực luôn ghi đè các đặc điểm tích cực. Xem thêm --host_features
Thẻ
:changes_inputs
,affects_outputs
- Giá trị mặc định của
--[no]force_pic
: "false" - Nếu được bật, tất cả các bản biên dịch C++ sẽ tạo mã không phụ thuộc vào vị trí ("-fPIC"), các đường liên kết sẽ ưu tiên thư viện tạo sẵn PIC hơn thư viện không phải PIC và các đường liên kết sẽ tạo tệp thực thi không phụ thuộc vào vị trí ("-pie").
Thẻ:loading_and_analysis
,affects_outputs
--host_action_env=<a 'name=value' assignment with an optional value part>
nhiều lần sử dụng được tích luỹ- Chỉ định tập hợp các biến môi trường có sẵn cho các hành động có cấu hình thực thi. Bạn có thể chỉ định biến theo tên, trong trường hợp này giá trị sẽ được lấy từ môi trường gọi, hoặc theo cặp name=value để đặt giá trị độc lập với môi trường gọi. Bạn có thể sử dụng tuỳ chọn này nhiều lần; đối với các tuỳ chọn được đưa ra cho cùng một biến, tuỳ chọn mới nhất sẽ thắng, còn các tuỳ chọn cho các biến khác nhau sẽ được tích luỹ.
Thẻ:action_command_lines
--host_compilation_mode=<fastbuild, dbg or opt>
mặc định: "opt"-
Chỉ định chế độ mà các công cụ dùng trong quá trình xây dựng sẽ được tạo. Giá trị: "fastbuild", "dbg", "opt".
Thẻ:affects_outputs
,action_command_lines
--host_conlyopt=<a string>
nhiều lần sử dụng được tích luỹ- Tuỳ chọn bổ sung để truyền đến trình biên dịch C khi biên dịch tệp nguồn C (nhưng không phải C++) trong cấu hình thực thi.
Thẻ:action_command_lines
,affects_outputs
--host_copt=<a string>
nhiều lần sử dụng được tích luỹ-
Các tuỳ chọn bổ sung để chuyển đến trình biên dịch C cho các công cụ được tạo trong cấu hình thực thi.
Thẻ:action_command_lines
,affects_outputs
--host_cpu=<a string>
mặc định: ""-
CPU lưu trữ.
Thẻ:changes_inputs
,affects_outputs
--host_cxxopt=<a string>
nhiều lần sử dụng được tích luỹ-
Các tuỳ chọn bổ sung để truyền đến trình biên dịch C++ cho các công cụ được tạo trong cấu hình thực thi.
Thẻ:action_command_lines
,affects_outputs
--host_features=<a string>
nhiều lần sử dụng được tích luỹ- Theo mặc định, các tính năng đã cho sẽ được bật hoặc tắt đối với các mục tiêu được tạo trong cấu hình thực thi. Việc chỉ định -<feature> sẽ tắt tính năng đó. Các đặc điểm tiêu cực luôn ghi đè các đặc điểm tích cực.
Thẻ:changes_inputs
,affects_outputs
--host_force_python=<PY2 or PY3>
mặc định: xem nội dung mô tả- Ghi đè phiên bản Python cho cấu hình thực thi. Có thể là "PY2" hoặc "PY3".
Thẻ:loading_and_analysis
,affects_outputs
--host_linkopt=<a string>
nhiều lần sử dụng được tích luỹ-
Tuỳ chọn bổ sung để truyền đến trình liên kết khi liên kết các công cụ trong cấu hình thực thi.
Thẻ:action_command_lines
,affects_outputs
--host_macos_minimum_os=<a dotted version (for example '2.3' or '3.3alpha2.4')>
mặc định: xem nội dung mô tả-
Phiên bản macOS tương thích tối thiểu cho các mục tiêu lưu trữ. Nếu không chỉ định, hãy sử dụng "macos_sdk_version".
Thẻ:loses_incremental_state
--host_per_file_copt=<a comma-separated list of regex expressions with prefix '-' specifying excluded paths followed by an @ and a comma separated list of options>
nhiều lần sử dụng được tích luỹ-
Các tuỳ chọn bổ sung để truyền có chọn lọc đến trình biên dịch C/C++ khi biên dịch một số tệp nhất định trong cấu hình thực thi. Bạn có thể truyền tuỳ chọn này nhiều lần. Cú pháp: bộ_lọc_biểu_thức_định_liệu@tuỳ_chọn_1,tuỳ_chọn_2,...,tuỳ_chọn_n. Trong đó, regex_filter là danh sách các mẫu biểu thức chính quy bao gồm và loại trừ (Xem thêm --instrumentation_filter). option_1 đến option_n là các tuỳ chọn dòng lệnh tuỳ ý. Nếu một tuỳ chọn chứa dấu phẩy, thì bạn phải đặt tuỳ chọn đó trong dấu ngoặc kép có dấu gạch chéo ngược. Tuỳ chọn có thể chứa @. Chỉ @ đầu tiên mới được dùng để phân tách chuỗi. Ví dụ: --host_per_file_copt=//foo/.*\.cc,-//foo/bar\.cc@-O0 thêm tuỳ chọn dòng lệnh -O0 vào dòng lệnh gcc của tất cả tệp cc trong //foo/ ngoại trừ bar.cc.
Thẻ:action_command_lines
,affects_outputs
--host_swiftcopt=<a string>
nhiều lần sử dụng được tích luỹ-
Các tuỳ chọn bổ sung để truyền đến swiftc cho các công cụ thực thi.
Thẻ:action_command_lines
,affects_outputs
- Giá trị mặc định của
--[no]incompatible_auto_exec_groups
: "false" -
Khi được bật, một nhóm thực thi sẽ tự động được tạo cho mỗi chuỗi công cụ mà một quy tắc sử dụng. Để quy tắc này hoạt động, bạn cần chỉ định tham số "toolchain" (chuỗi công cụ) trên các hành động của quy tắc. Để biết thêm thông tin, hãy xem https://github.com/bazelbuild/bazel/issues/17134.
Thẻ:affects_outputs
,incompatible_change
- Giá trị mặc định của
--[no]incompatible_merge_genfiles_directory
: "true" - Nếu đúng, thư mục genfiles sẽ được gộp vào thư mục bin.
Thẻ:affects_outputs
,incompatible_change
- Giá trị mặc định của
--[no]incompatible_use_host_features
: "true" - Nếu đúng, hãy chỉ sử dụng --features cho cấu hình mục tiêu và --host_features cho cấu hình thực thi.
Thẻ:changes_inputs
,affects_outputs
,incompatible_change
- Giá trị mặc định của
--[no]instrument_test_targets
: "false" -
Khi bật mức độ sử dụng, hãy chỉ định xem có nên cân nhắc việc đo lường các quy tắc kiểm thử hay không. Khi được đặt, các quy tắc kiểm thử do --instrumentation_filter bao gồm sẽ được đo lường. Nếu không, các quy tắc kiểm thử sẽ luôn bị loại trừ khỏi hoạt động đo lường mức độ sử dụng.
Thẻ:affects_outputs
--instrumentation_filter=<a comma-separated list of regex expressions with prefix '-' specifying excluded paths>
mặc định: "-/javatests[/:],-/test/java[/:]"- Khi bạn bật tính năng mức độ sử dụng, chỉ những quy tắc có tên được bộ lọc dựa trên biểu thức chính quy chỉ định mới được đo lường. Thay vào đó, các quy tắc có tiền tố là "-" sẽ bị loại trừ. Xin lưu ý rằng chỉ các quy tắc không phải quy tắc kiểm thử mới được đo lường, trừ phi bạn bật --instrument_test_targets.
Thẻ:affects_outputs
--ios_minimum_os=<a dotted version (for example '2.3' or '3.3alpha2.4')>
mặc định: xem nội dung mô tả-
Phiên bản iOS tương thích tối thiểu cho trình mô phỏng và thiết bị mục tiêu. Nếu không chỉ định, hãy sử dụng "ios_sdk_version".
Thẻ:loses_incremental_state
--ios_multi_cpus=<comma-separated list of options>
nhiều lần sử dụng được tích luỹ-
Danh sách các cấu trúc được phân tách bằng dấu phẩy để tạo ios_application. Kết quả là một tệp nhị phân phổ quát chứa tất cả các cấu trúc đã chỉ định.
Thẻ:loses_incremental_state
,loading_and_analysis
- Giá trị mặc định của
--[no]legacy_whole_archive
: "true" -
Không dùng nữa, thay vào đó là --incompatible_remove_legacy_whole_archive (xem https://github.com/bazelbuild/bazel/issues/7362 để biết thông tin chi tiết). Khi bật, hãy sử dụng --whole-archive cho các quy tắc cc_binary có linkshared=True và linkstatic=True hoặc "-static" trong linkopts. Việc này chỉ nhằm mục đích tương thích ngược. Một cách thay thế tốt hơn là sử dụng alwayslink=1 khi cần.
Thẻ:action_command_lines
,affects_outputs
,deprecated
--linkopt=<a string>
nhiều lần sử dụng được tích luỹ- Tuỳ chọn bổ sung để truyền đến gcc khi liên kết.
Thẻ:action_command_lines
,affects_outputs
--ltobackendopt=<a string>
nhiều lần sử dụng được tích luỹ-
Tuỳ chọn bổ sung để chuyển đến bước phụ trợ LTO (trong --features=thin_lto).
Thẻ:action_command_lines
,affects_outputs
--ltoindexopt=<a string>
nhiều lần sử dụng được tích luỹ-
Tuỳ chọn bổ sung để chuyển đến bước lập chỉ mục LTO (trong --features=thin_lto).
Thẻ:action_command_lines
,affects_outputs
--macos_cpus=<comma-separated list of options>
nhiều lần sử dụng được tích luỹ-
Danh sách các cấu trúc được phân tách bằng dấu phẩy để tạo tệp nhị phân Apple macOS.
Thẻ:loses_incremental_state
,loading_and_analysis
--macos_minimum_os=<a dotted version (for example '2.3' or '3.3alpha2.4')>
mặc định: xem nội dung mô tả-
Phiên bản macOS tương thích tối thiểu cho các mục tiêu. Nếu không chỉ định, hãy sử dụng "macos_sdk_version".
Thẻ:loses_incremental_state
--memprof_profile=<a build target label>
mặc định: xem nội dung mô tả-
Sử dụng hồ sơ memprof.
Thẻ:affects_outputs
- Giá trị mặc định của
--[no]objc_debug_with_GLIBCXX
: "false" - Nếu bạn đặt và chế độ biên dịch được đặt thành "dbg", hãy xác định GLIBCXX_DEBUG, GLIBCXX_DEBUG_PEDANTIC và GLIBCPP_CONCEPT_CHECKS.
Thẻ:action_command_lines
- Giá trị mặc định của
--[no]objc_enable_binary_stripping
: "false" -
Liệu có thực hiện việc xoá ký hiệu và mã chết trên các tệp nhị phân được liên kết hay không. Thao tác loại bỏ tệp nhị phân sẽ được thực hiện nếu bạn chỉ định cả cờ này và --compilation_mode=opt.
Thẻ:action_command_lines
--objccopt=<a string>
nhiều lần sử dụng được tích luỹ-
Các tuỳ chọn bổ sung để truyền đến gcc khi biên dịch tệp nguồn Objective-C/C++.
Thẻ:action_command_lines
--per_file_copt=<a comma-separated list of regex expressions with prefix '-' specifying excluded paths followed by an @ and a comma separated list of options>
nhiều lần sử dụng được tích luỹ-
Các tuỳ chọn bổ sung để truyền có chọn lọc đến gcc khi biên dịch một số tệp nhất định. Bạn có thể truyền tuỳ chọn này nhiều lần. Cú pháp: bộ_lọc_biểu_thức_định_liệu@tuỳ_chọn_1,tuỳ_chọn_2,...,tuỳ_chọn_n. Trong đó, regex_filter là danh sách các mẫu biểu thức chính quy bao gồm và loại trừ (Xem thêm --instrumentation_filter). option_1 đến option_n là các tuỳ chọn dòng lệnh tuỳ ý. Nếu một tuỳ chọn chứa dấu phẩy, thì bạn phải đặt tuỳ chọn đó trong dấu ngoặc kép có dấu gạch chéo ngược. Tuỳ chọn có thể chứa @. Chỉ @ đầu tiên mới được dùng để phân tách chuỗi. Ví dụ: --per_file_copt=//foo/.*\.cc,-//foo/bar\.cc@-O0 thêm tuỳ chọn dòng lệnh -O0 vào dòng lệnh gcc của tất cả tệp cc trong //foo/ ngoại trừ bar.cc.
Thẻ:action_command_lines
,affects_outputs
--per_file_ltobackendopt=<a comma-separated list of regex expressions with prefix '-' specifying excluded paths followed by an @ and a comma separated list of options>
nhiều lần sử dụng được tích luỹ-
Các tuỳ chọn bổ sung để chuyển có chọn lọc đến phần phụ trợ LTO (trong --features=thin_lto) khi biên dịch một số đối tượng phụ trợ nhất định. Bạn có thể truyền tuỳ chọn này nhiều lần. Cú pháp: bộ_lọc_biểu_thức_định_liệu@tuỳ_chọn_1,tuỳ_chọn_2,...,tuỳ_chọn_n. Trong đó, regex_filter là danh sách các mẫu biểu thức chính quy bao gồm và loại trừ. option_1 đến option_n là các tuỳ chọn dòng lệnh tuỳ ý. Nếu một tuỳ chọn chứa dấu phẩy, thì bạn phải đặt tuỳ chọn đó trong dấu ngoặc kép có dấu gạch chéo ngược. Tuỳ chọn có thể chứa @. Chỉ @ đầu tiên mới được dùng để phân tách chuỗi. Ví dụ: --per_file_ltobackendopt=//foo/.*\.o,-//foo/bar\.o@-O0 sẽ thêm tuỳ chọn dòng lệnh -O0 vào dòng lệnh phụ trợ LTO của tất cả tệp o trong //foo/ ngoại trừ bar.o.
Thẻ:action_command_lines
,affects_outputs
--platform_suffix=<a string>
mặc định: xem nội dung mô tả- Chỉ định hậu tố cần thêm vào thư mục cấu hình.
Thẻ:loses_incremental_state
,affects_outputs
,loading_and_analysis
--propeller_optimize=<a build target label>
mặc định: xem nội dung mô tả-
Sử dụng thông tin hồ sơ Propeller để tối ưu hoá mục tiêu bản dựng.Hồ sơ Propeller phải bao gồm ít nhất một trong hai tệp, hồ sơ cc và hồ sơ ld. Cờ này chấp nhận nhãn bản dựng phải tham chiếu đến các tệp đầu vào của hồ sơ cánh quạt. Ví dụ: tệp BUILD xác định nhãn, trong a/b/BUILD:propeller_optimize( name = "propeller_profile", cc_profile = "propeller_cc_profile.txt", ld_profile = "propeller_ld_profile.txt",)Có thể bạn phải thêm một lệnh exports_files vào gói tương ứng để Bazel có thể thấy các tệp này. Bạn phải sử dụng tuỳ chọn này như sau: --propeller_optimize=//a/b:propeller_profile
Thẻ:action_command_lines
,affects_outputs
--propeller_optimize_absolute_cc_profile=<a string>
mặc định: xem nội dung mô tả- Tên đường dẫn tuyệt đối của tệp cc_profile cho các bản dựng được tối ưu hoá bằng Propeller.
Thẻ:affects_outputs
--propeller_optimize_absolute_ld_profile=<a string>
mặc định: xem nội dung mô tả- Tên đường dẫn tuyệt đối của tệp ld_profile cho các bản dựng được tối ưu hoá bằng Propeller.
Thẻ:affects_outputs
--run_under=<a prefix in front of command>
mặc định: xem nội dung mô tả-
Tiền tố để chèn trước các tệp thực thi cho lệnh "test" (kiểm thử) và "run" (chạy). Nếu giá trị là "foo -bar" và dòng lệnh thực thi là "test_binary -baz", thì dòng lệnh cuối cùng sẽ là "foo -bar test_binary -baz".Đây cũng có thể là nhãn cho một mục tiêu có thể thực thi. Một số ví dụ: "valgrind", "strace", "strace -c", "valgrind --quiet --num-callers=20", "//package:target", '//package:target --options'.
Thẻ:action_command_lines
- Nếu đúng, các thư viện gốc chứa chức năng giống hệt nhau sẽ được chia sẻ giữa các mục tiêu khác nhau
Thẻ
:loading_and_analysis
,affects_outputs
- Giá trị mặc định của
--[no]stamp
: "false" -
Đóng dấu tệp nhị phân bằng ngày, tên người dùng, tên máy chủ, thông tin về không gian làm việc, v.v.
Thẻ:affects_outputs
- Giá trị mặc định của
--strip=<always, sometimes or never>
: "đôi khi" - Chỉ định xem có xoá các tệp nhị phân và thư viện dùng chung hay không (sử dụng "-Wl,--strip-debug"). Giá trị mặc định là "sometimes" (đôi khi) có nghĩa là xoá nếu --compilation_mode=fastbuild.
Thẻ:affects_outputs
--stripopt=<a string>
nhiều lần sử dụng được tích luỹ-
Các tuỳ chọn bổ sung để truyền vào tính năng loại bỏ khi tạo tệp nhị phân "<name>.stripped".
Thẻ:action_command_lines
,affects_outputs
--swiftcopt=<a string>
nhiều lần sử dụng được tích luỹ-
Các tuỳ chọn bổ sung để truyền đến quá trình biên dịch Swift.
Thẻ:action_command_lines
--tvos_cpus=<comma-separated list of options>
nhiều lần sử dụng được tích luỹ-
Danh sách kiến trúc được phân tách bằng dấu phẩy để tạo tệp nhị phân Apple tvOS.
Thẻ:loses_incremental_state
,loading_and_analysis
--tvos_minimum_os=<a dotted version (for example '2.3' or '3.3alpha2.4')>
mặc định: xem nội dung mô tả-
Phiên bản tvOS tối thiểu tương thích cho trình mô phỏng và thiết bị mục tiêu. Nếu không chỉ định, hãy sử dụng "tvos_sdk_version".
Thẻ:loses_incremental_state
--visionos_cpus=<comma-separated list of options>
nhiều lần sử dụng được tích luỹ-
Danh sách kiến trúc được phân tách bằng dấu phẩy để tạo tệp nhị phân visionOS của Apple.
Thẻ:loses_incremental_state
,loading_and_analysis
--watchos_cpus=<comma-separated list of options>
nhiều lần sử dụng được tích luỹ-
Danh sách được phân tách bằng dấu phẩy gồm các cấu trúc để tạo tệp nhị phân Apple watchOS.
Thẻ:loses_incremental_state
,loading_and_analysis
--watchos_minimum_os=<a dotted version (for example '2.3' or '3.3alpha2.4')>
mặc định: xem nội dung mô tả- Phiên bản watchOS tối thiểu tương thích với trình mô phỏng và thiết bị mục tiêu. Nếu không chỉ định, hãy sử dụng "watchos_sdk_version".
Thẻ:loses_incremental_state
--xbinary_fdo=<a build target label>
mặc định: xem nội dung mô tả-
Sử dụng thông tin hồ sơ XbinaryFDO để tối ưu hoá quá trình biên dịch. Chỉ định tên của hồ sơ tệp nhị phân chéo mặc định. Khi tuỳ chọn này được sử dụng cùng với --fdo_instrument/--fdo_optimize/--fdo_profile, các tuỳ chọn đó sẽ luôn chiếm ưu thế như thể xbinary_fdo không bao giờ được chỉ định.
Thẻ:affects_outputs
- Các tuỳ chọn ảnh hưởng đến mức độ nghiêm ngặt mà Bazel thực thi các dữ liệu đầu vào bản dựng hợp lệ (xác định quy tắc, tổ hợp cờ, v.v.):
--auto_cpu_environment_group=<a build target label>
mặc định: ""- khai báo environment_group để sử dụng cho việc tự động liên kết các giá trị cpu với các giá trị target_environment.
Thẻ:changes_inputs
,loading_and_analysis
,experimental
- Giá trị mặc định của
--[no]check_licenses
: "false" -
Kiểm tra để đảm bảo các quy tắc hạn chế về giấy phép do các gói phụ thuộc áp đặt không xung đột với chế độ phân phối của các mục tiêu đang được tạo. Theo mặc định, giấy phép sẽ không được kiểm tra.
Thẻ:build_file_semantics
- Giá trị mặc định của
--[no]check_visibility
: "true" - Nếu bị tắt, các lỗi về chế độ hiển thị trong phần phụ thuộc mục tiêu sẽ bị hạ cấp thành cảnh báo.
Thẻ:build_file_semantics
- Giá trị mặc định của
--[no]desugar_for_android
: "true" -
Liệu có đơn giản hoá mã byte Java 8 trước khi tạo tệp dex hay không.
Thẻ:affects_outputs
,loading_and_analysis
,loses_incremental_state
- Giá trị mặc định của
--[no]desugar_java8_libs
: "false" -
Liệu có đưa các thư viện Java 8 được hỗ trợ vào ứng dụng cho các thiết bị cũ hay không.
Thẻ:affects_outputs
,loading_and_analysis
,loses_incremental_state
,experimental
- Giá trị mặc định của
--[no]enforce_constraints
: "true" -
Kiểm tra môi trường mà mỗi mục tiêu tương thích và báo cáo lỗi nếu có mục tiêu nào có các phần phụ thuộc không hỗ trợ cùng một môi trường
Thẻ:build_file_semantics
- Giá trị mặc định của
--[no]experimental_check_desugar_deps
: "true" -
Liệu có nên kiểm tra kỹ việc đơn giản hoá chính xác ở cấp tệp nhị phân Android hay không.
Thẻ:eagerness_to_exit
,loading_and_analysis
,experimental
- Giá trị mặc định của
--experimental_import_deps_checking=<off, warning or error>
: "OFF" -
Khi bật, hãy kiểm tra xem các phần phụ thuộc của aar_import đã hoàn tất hay chưa. Việc thực thi này có thể làm hỏng bản dựng hoặc chỉ dẫn đến cảnh báo.
Thẻ:loading_and_analysis
- Giá trị mặc định của
--experimental_one_version_enforcement=<off, warning or error>
: "OFF" -
Khi bật, hãy thực thi quy tắc java_binary không được chứa nhiều phiên bản của cùng một tệp lớp trên đường dẫn lớp. Việc thực thi này có thể làm hỏng bản dựng hoặc chỉ dẫn đến cảnh báo.
Thẻ:loading_and_analysis
- Giá trị mặc định của
--experimental_strict_java_deps=<off, warn, error, strict or default>
: "mặc định" - Nếu đúng, hãy kiểm tra để đảm bảo rằng một mục tiêu Java khai báo rõ ràng tất cả các mục tiêu được sử dụng trực tiếp dưới dạng phần phụ thuộc.
Thẻ:build_file_semantics
,eagerness_to_exit
- Giá trị mặc định của
--[no]incompatible_check_testonly_for_output_files
: "false" - Nếu được bật, hãy kiểm tra testonly cho các mục tiêu tiên quyết là tệp đầu ra bằng cách tra cứu testonly của quy tắc tạo. Điều này khớp với việc kiểm tra chế độ hiển thị.
Thẻ:build_file_semantics
,incompatible_change
- Giá trị mặc định của
--[no]incompatible_check_visibility_for_toolchains
: "false" - Nếu được bật, tính năng kiểm tra chế độ hiển thị cũng áp dụng cho việc triển khai chuỗi công cụ.
Thẻ:build_file_semantics
,incompatible_change
- Giá trị mặc định của
--[no]incompatible_disable_native_android_rules
: "false" - Nếu được bật, tính năng sử dụng trực tiếp các quy tắc Android gốc sẽ bị tắt. Vui lòng sử dụng các quy tắc Android Starlark từ https://github.com/bazelbuild/rules_android
Thẻ:eagerness_to_exit
,incompatible_change
- Giá trị mặc định của
--[no]incompatible_disable_native_apple_binary_rule
: "false" - Không hoạt động. Được giữ lại ở đây để tương thích ngược.
Thẻ:eagerness_to_exit
,incompatible_change
- Giá trị mặc định của
--[no]incompatible_python_disable_py2
: "true" - Nếu đúng, việc sử dụng chế độ cài đặt Python 2 sẽ gây ra lỗi. Bao gồm cả python_version=PY2, srcs_version=PY2 và srcs_version=PY2ONLY. Hãy xem https://github.com/bazelbuild/bazel/issues/15684 để biết thêm thông tin.
Thẻ:loading_and_analysis
,incompatible_change
- Giá trị mặc định của
--[no]incompatible_validate_top_level_header_inclusions
: "true" - Nếu đúng, Bazel cũng sẽ xác thực việc đưa tiêu đề thư mục cấp cao nhất vào (xem https://github.com/bazelbuild/bazel/issues/10047 để biết thêm thông tin).
Thẻ:loading_and_analysis
,incompatible_change
- Giá trị mặc định của
--[no]one_version_enforcement_on_java_tests
: "true" -
Khi được bật và experimental_one_version_enforcement được đặt thành một giá trị khác NONE, hãy thực thi một phiên bản trên các mục tiêu java_test. Bạn có thể tắt cờ này để cải thiện hiệu suất kiểm thử gia tăng nhưng sẽ bỏ lỡ các lỗi vi phạm tiềm ẩn về một phiên bản.
Thẻ:loading_and_analysis
--python_native_rules_allowlist=<a build target label>
mặc định: xem nội dung mô tả-
Danh sách cho phép (mục tiêu package_group) để sử dụng khi thực thi --incompatible_python_disallow_native_rules.
Thẻ:loading_and_analysis
- Giá trị mặc định của
--[no]strict_filesets
: "false" - Nếu bạn bật tuỳ chọn này, các tệp nhóm sẽ vượt quá giới hạn gói sẽ được báo cáo là lỗi.
Thẻ:build_file_semantics
,eagerness_to_exit
--strict_proto_deps=<off, warn, error, strict or default>
mặc định: "lỗi"- Nếu không tắt, hãy kiểm tra để đảm bảo rằng mục tiêu proto_library 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.
Thẻ:build_file_semantics
,eagerness_to_exit
,incompatible_change
--strict_public_imports=<off, warn, error, strict or default>
mặc định: "off"-
Trừ khi TẮT, hãy kiểm tra để đảm bảo rằng mục tiêu proto_library khai báo rõ ràng tất cả các mục tiêu được sử dụng trong "import public" là mục tiêu đã xuất.
Thẻ:build_file_semantics
,eagerness_to_exit
,incompatible_change
- Giá trị mặc định của
--[no]strict_system_includes
: "false" - Nếu là true, bạn cũng phải khai báo các tiêu đề tìm thấy thông qua hệ thống bao gồm các đường dẫn (-isystem).
Thẻ:loading_and_analysis
,eagerness_to_exit
--target_environment=<a build target label>
nhiều lần sử dụng được tích luỹ-
Khai báo môi trường mục tiêu của bản dựng này. Phải là tham chiếu nhãn đến quy tắc "môi trường". Nếu được chỉ định, tất cả mục tiêu cấp cao nhất phải tương thích với môi trường này.
Thẻ:changes_inputs
- Các tuỳ chọn ảnh hưởng đến kết quả ký của một bản dựng:
--apk_signing_method=<v1, v2, v1_v2 or v4>
mặc định: "v1_v2"-
Cách triển khai để ký tệp APK
Thẻ:action_command_lines
,affects_outputs
,loading_and_analysis
- Giá trị mặc định của
--[no]device_debug_entitlements
: "true" - Nếu bạn đặt và chế độ biên dịch không phải là "opt", thì các ứng dụng objc sẽ bao gồm các quyền gỡ lỗi khi ký.
Thẻ:changes_inputs
--ios_signing_cert_name=<a string>
mặc định: xem nội dung mô tả- Tên chứng chỉ dùng để ký ứng dụng iOS. Nếu không được đặt, hệ thống sẽ quay lại sử dụng hồ sơ cấp phép. Có thể là lựa chọn ưu tiên về danh tính chuỗi khoá của chứng chỉ hoặc (chuỗi con) của tên chung của chứng chỉ, theo trang man của codesign (SIGNING IDENTITIES).
Thẻ:action_command_lines
- Tuỳ chọn này ảnh hưởng đến ngữ nghĩa của ngôn ngữ Starlark hoặc API bản dựng mà các tệp BUILD, tệp .bzl hoặc tệp WORKSPACE có thể truy cập.:
- Giá trị mặc định của
--[no]incompatible_disallow_legacy_py_provider
: "true" - Không hoạt động, sẽ sớm bị xoá.
Thẻ:loading_and_analysis
,incompatible_change
- Giá trị mặc định của
--[no]incompatible_disallow_sdk_frameworks_attributes
: "false" - Nếu đúng, không cho phép các thuộc tính sdk_frameworks và weak_sdk_frameworks trong objc_library và objc_import.
Thẻ:build_file_semantics
,incompatible_change
- Giá trị mặc định của
--[no]incompatible_objc_alwayslink_by_default
: "false" - Nếu đúng, hãy đặt giá trị mặc định thành đúng cho các thuộc tính alwayslink trong objc_library và objc_import.
Thẻ:build_file_semantics
,incompatible_change
- Giá trị mặc định của
--[no]incompatible_python_disallow_native_rules
: "false" -
Khi giá trị là true, lỗi sẽ xảy ra khi sử dụng các quy tắc py_* tích hợp; thay vào đó, bạn nên sử dụng các quy tắc rule_python. Hãy xem https://github.com/bazelbuild/bazel/issues/17773 để biết thêm thông tin và hướng dẫn di chuyển.
Thẻ:loading_and_analysis
,incompatible_change
- Các tuỳ chọn điều chỉnh hành vi của môi trường kiểm thử hoặc trình chạy kiểm thử:
- Giá trị mặc định của
--[no]allow_analysis_failures
: "false" - Nếu đúng, lỗi phân tích của một mục tiêu quy tắc sẽ dẫn đến việc mục tiêu truyền một thực thể của AnalysisFailureInfo chứa nội dung mô tả lỗi, thay vì dẫn đến lỗi bản dựng.
Thẻ:loading_and_analysis
,experimental
- Giá trị mặc định của
--analysis_testing_deps_limit=<an integer>
: "2000" -
Đặt số lượng phần phụ thuộc bắc cầu tối đa thông qua một thuộc tính quy tắc có chuyển đổi cấu hình for_analysis_testing. Nếu vượt quá giới hạn này, bạn sẽ gặp lỗi quy tắc.
Thẻ:loading_and_analysis
- Giá trị mặc định của
--[no]break_build_on_parallel_dex2oat_failure
: "false" - Nếu lỗi thao tác dex2oat là đúng thì bản dựng sẽ bị lỗi thay vì thực thi dex2oat trong thời gian chạy kiểm thử.
Thẻ:loading_and_analysis
,experimental
--default_test_resources=<a resource name followed by equal and 1 float or 4 float, e.g. memory=10,30,60,100>
nhiều lần sử dụng được tích luỹ- Ghi đè số lượng tài nguyên mặc định cho các chương trình kiểm thử. Định dạng dự kiến là <tài nguyên>=<giá trị>. Nếu một số dương duy nhất được chỉ định là <giá trị>, thì số này sẽ ghi đè các tài nguyên mặc định cho tất cả kích thước kiểm thử. Nếu bạn chỉ định 4 số được phân tách bằng dấu phẩy, thì các số này sẽ ghi đè lượng tài nguyên tương ứng cho các kích thước kiểm thử nhỏ, trung bình, lớn, rất lớn. Giá trị cũng có thể là HOST_RAM/HOST_CPU, theo sau là [-|*]<float> (ví dụ: memory=HOST_RAM*.1,HOST_RAM*.2,HOST_RAM*.3,HOST_RAM*.4). Tài nguyên kiểm thử mặc định do cờ này chỉ định sẽ bị ghi đè bởi tài nguyên rõ ràng được chỉ định trong thẻ.
- Giá trị mặc định của
--[no]experimental_android_use_parallel_dex2oat
: "false" -
Sử dụng dex2oat song song để có thể tăng tốc android_test.
Thẻ:loading_and_analysis
,host_machine_resource_optimizations
,experimental
- Giá trị mặc định của
--[no]ios_memleaks
: "false" -
Bật tính năng kiểm tra rò rỉ bộ nhớ trong các mục tiêu ios_test.
Thẻ:action_command_lines
--ios_simulator_device=<a string>
mặc định: xem nội dung mô tả-
Thiết bị để mô phỏng khi chạy ứng dụng iOS trong trình mô phỏng, ví dụ: "iPhone 6". Bạn có thể lấy danh sách thiết bị bằng cách chạy lệnh "xcrun simctl list devicetypes" trên máy mà trình mô phỏng sẽ chạy.
Thẻ:test_runner
--ios_simulator_version=<a dotted version (for example '2.3' or '3.3alpha2.4')>
mặc định: xem nội dung mô tả-
Phiên bản iOS để chạy trên trình mô phỏng khi chạy hoặc kiểm thử. Quy tắc này sẽ bị bỏ qua đối với các quy tắc ios_test nếu bạn chỉ định một thiết bị mục tiêu trong quy tắc.
Thẻ:test_runner
--runs_per_test=<a positive integer or test_regex@runs. This flag may be passed more than once>
nhiều lần sử dụng được tích luỹ- Chỉ định số lần chạy mỗi chương trình kiểm thử. Nếu bất kỳ lần thử nào trong số đó không thành công vì bất kỳ lý do gì, thì toàn bộ kiểm thử sẽ được coi là không thành công. Thông thường, giá trị được chỉ định chỉ là một số nguyên. Ví dụ: --runs_per_test=3 sẽ chạy tất cả các bài kiểm thử 3 lần. Cú pháp thay thế: bộ_lọc_biểu_thức_tìm_kiếm@số_lần_chạy_mỗi_bài_kiểm_ thử. Trong đó, runs_per_test là một giá trị số nguyên và regex_filter là danh sách các mẫu biểu thức chính quy bao gồm và loại trừ (Xem thêm --instrumentation_filter). Ví dụ: --runs_per_test=//foo/.*,-//foo/bar/.*@3 chạy tất cả các bài kiểm thử trong //foo/ ngoại trừ các bài kiểm thử trong foo/bar ba lần. Bạn có thể truyền tuỳ chọn này nhiều lần. Đối số khớp được truyền gần đây nhất sẽ được ưu tiên. Nếu không có kết quả nào khớp, thì quy trình kiểm thử sẽ chỉ chạy một lần.
--test_env=<a 'name=value' assignment with an optional value part>
nhiều lần sử dụng được tích luỹ- Chỉ định các biến môi trường bổ sung sẽ được chèn vào môi trường trình chạy kiểm thử. Bạn có thể chỉ định biến theo tên, trong trường hợp này, giá trị của biến sẽ được đọc từ môi trường ứng dụng Bazel hoặc theo cặp name=value. Bạn có thể sử dụng tuỳ chọn này nhiều lần để chỉ định một số biến. Chỉ được lệnh "bazel test" sử dụng.
Thẻ:test_runner
--test_timeout=<a single integer or comma-separated list of 4 integers>
mặc định: "-1"- Ghi đè các giá trị thời gian chờ kiểm thử mặc định cho thời gian chờ kiểm thử (tính bằng giây). Nếu bạn chỉ định một giá trị số nguyên dương, thì giá trị đó sẽ ghi đè tất cả các danh mục. Nếu bạn chỉ định 4 số nguyên được phân tách bằng dấu phẩy, thì các số này sẽ ghi đè thời gian chờ cho thời gian ngắn, trung bình, dài và vĩnh viễn (theo thứ tự đó). Trong cả hai hình thức, giá trị -1 sẽ yêu cầu blaze sử dụng thời gian chờ mặc định cho danh mục đó.
- Giá trị mặc định của
--[no]zip_undeclared_test_outputs
: "true" - Nếu đúng, các kết quả kiểm thử chưa khai báo sẽ được lưu trữ trong một tệp zip.
Thẻ:test_runner
- Các tuỳ chọn liên quan đến kết quả truy vấn và ngữ nghĩa:
- Giá trị mặc định của
--aspect_deps=<off, conservative or precise>
: "conservative" -
Cách phân giải các phần phụ thuộc của khía cạnh khi định dạng đầu ra là một trong các {xml,proto,record}. "tắt" có nghĩa là không có phần phụ thuộc khía cạnh nào được phân giải, "cẩn thận" (mặc định) có nghĩa là tất cả phần phụ thuộc khía cạnh đã khai báo đều được thêm vào bất kể chúng có được cấp lớp quy tắc của phần phụ thuộc trực tiếp hay không, "chính xác" có nghĩa là chỉ những khía cạnh có thể hoạt động mới được thêm vào dựa trên lớp quy tắc của phần phụ thuộc trực tiếp. Xin lưu ý rằng chế độ chính xác yêu cầu tải các gói khác để đánh giá một mục tiêu duy nhất, do đó, chế độ này sẽ chậm hơn các chế độ khác. Ngoài ra, xin lưu ý rằng ngay cả chế độ chính xác cũng không hoàn toàn chính xác: quyết định có tính toán một khía cạnh hay không được quyết định trong giai đoạn phân tích, giai đoạn này không chạy trong "truy vấn bazel".
Thẻ:build_file_semantics
- Giá trị mặc định của
--[no]consistent_labels
: "false" - Nếu được bật, mọi lệnh truy vấn sẽ phát ra nhãn như thể bằng hàm Starlark <code>str</code> áp dụng cho một thực thể <code>Label</code>. Điều này rất hữu ích đối với các công cụ cần so khớp kết quả của các lệnh truy vấn và/hoặc nhãn khác nhau do các quy tắc phát ra. Nếu không được bật, trình định dạng đầu ra có thể tự do phát ra tên kho lưu trữ rõ ràng (so với kho lưu trữ chính) để giúp đầu ra dễ đọc hơn.
Thẻ:terminal_output
- Giá trị mặc định của
--[no]experimental_explicit_aspects
: "false" -
aquery, cquery: liệu có đưa các hành động do phương diện tạo ra vào kết quả hay không. query: không hoạt động (các phương diện luôn được tuân theo).
Thẻ:terminal_output
- Giá trị mặc định của
--[no]graph:factored
: "true" - Nếu đúng, thì biểu đồ sẽ được phát "được nhân", tức là các nút tương đương về mặt tô pô sẽ được hợp nhất với nhau và các nhãn của chúng sẽ được nối với nhau. Tuỳ chọn này chỉ áp dụng cho --output=graph.
Thẻ:terminal_output
--graph:node_limit=<an integer>
mặc định: "512"-
Độ dài tối đa của chuỗi nhãn cho một nút biểu đồ trong kết quả. Nhãn dài hơn sẽ bị cắt ngắn; -1 có nghĩa là không cắt ngắn. Tuỳ chọn này chỉ áp dụng cho --output=graph.
Thẻ:terminal_output
- Giá trị mặc định của
--[no]implicit_deps
: "true" - Nếu được bật, các phần phụ thuộc ngầm sẽ đượ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 bazel thêm vào. Đối với cquery, tuỳ chọn này kiểm soát việc lọc các chuỗi công cụ đã phân giải.
Thẻ:build_file_semantics
- Giá trị mặc định của
--[no]include_aspects
: "true" -
aquery, cquery: liệu có đưa các hành động do phương diện tạo ra vào kết quả hay không. query: không hoạt động (các phương diện luôn được tuân theo).
Thẻ:terminal_output
- Giá trị mặc định của
--[no]incompatible_package_group_includes_double_slash
: "true" - Nếu được bật, khi xuất thuộc tính "packages" của package_group, dấu "//" ở đầu sẽ không bị bỏ qua.
Thẻ:terminal_output
,incompatible_change
- Giá trị mặc định của
--[no]infer_universe_scope
: "false" - Nếu bạn đặt và không đặt --universe_scope, thì giá trị của --universe_scope sẽ được suy ra là danh sách các mẫu mục tiêu duy nhất trong biểu thức truy vấn. Xin lưu ý rằng giá trị --universe_scope được suy ra cho biểu thức truy vấn sử dụng các hàm trong phạm vi vũ trụ (ví dụ: "allrdeps") có thể không phải là giá trị bạn muốn. Vì vậy, bạn chỉ nên sử dụng tuỳ chọn này nếu biết mình đang làm gì. Hãy xem https://bazel.build/reference/query#sky-query để biết thông tin chi tiết và ví dụ. Nếu bạn đặt --universe_scope, thì giá trị của tuỳ chọn này sẽ bị bỏ qua. Lưu ý: tuỳ chọn này chỉ áp dụng cho "truy vấn" (tức là không phải "cquery").
Thẻ:loading_and_analysis
- Giá trị mặc định của
--[no]line_terminator_null
: "false" -
Liệu mỗi định dạng có được kết thúc bằng \0 thay vì dòng mới hay không.
Thẻ:terminal_output
- Giá trị mặc định của
--[no]nodep_deps
: "true" - Nếu được bật, các phần phụ thuộc từ thuộc tính "nodep" sẽ được đưa vào biểu đồ phần phụ thuộc mà truy vấn hoạt động. Một ví dụ phổ biến về thuộc tính "nodep" là "visibility" (mức độ hiển thị). Chạy và phân tích cú pháp kết quả của lệnh `info build-language` để tìm hiểu về tất cả thuộc tính "nodep" trong ngôn ngữ bản dựng.
Thẻ:build_file_semantics
--output=<a string>
mặc định: "label"-
Định dạng in kết quả cquery. Các giá trị được phép cho cquery là: label, label_kind, textproto, transitions, proto, streamed_proto, jsonproto. Nếu chọn "transitions" (hiệu ứng chuyển đổi), bạn cũng phải chỉ định tuỳ chọn --transitions=(lite|full).
Thẻ:terminal_output
- Giá trị mặc định của
--[no]proto:default_values
: "true" - Nếu đúng, các thuộc tính có giá trị không được chỉ định rõ ràng trong tệp BUILD sẽ được đưa vào; nếu không, các thuộc tính đó sẽ bị bỏ qua. Bạn có thể áp dụng tuỳ chọn này cho --output=proto
Thẻ:terminal_output
- Giá trị mặc định của
--[no]proto:definition_stack
: "false" - Điền vào trường proto definition_stack. Trường này ghi lại cho mỗi thực thể quy tắc ngăn xếp lệnh gọi Starlark tại thời điểm lớp của quy tắc được xác định.
Thẻ:terminal_output
- Giá trị mặc định của
--[no]proto:flatten_selects
: "true" - Nếu được bật, các thuộc tính có thể định cấu hình do select() tạo sẽ được làm phẳng. Đối với các loại danh sách, bản trình bày được làm phẳng là một danh sách chứa mỗi giá trị của bản đồ chọn chính xác một lần. Các loại đại lượng vô hướng được làm phẳng thành giá trị rỗng.
Thẻ:build_file_semantics
- Giá trị mặc định của
--[no]proto:include_attribute_source_aspects
: "false" - Điền phương diện nguồn mà thuộc tính đến từ vào trường proto source_aspect_name của mỗi Thuộc tính (chuỗi trống nếu không có).
Thẻ:terminal_output
- Giá trị mặc định của
--[no]proto:include_configurations
: "true" - nếu được bật, đầu ra proto sẽ bao gồm thông tin về cấu hình. Khi bị tắt,định dạng đầu ra proto của cquery sẽ giống với định dạng đầu ra truy vấn.
Thẻ:affects_outputs
- Giá trị mặc định của
--[no]proto:include_synthetic_attribute_hash
: "false" -
Liệu có tính toán và điền thuộc tính $internal_attr_hash hay không.
Thẻ:terminal_output
- Giá trị mặc định của
--[no]proto:instantiation_stack
: "false" - Điền ngăn xếp lệnh gọi bản sao của từng quy tắc. Xin lưu ý rằng việc này yêu cầu ngăn xếp phải có mặt
Thẻ
:terminal_output
- Giá trị mặc định của
--[no]proto:locations
: "true" -
Liệu có xuất thông tin vị trí trong đầu ra proto hay không.
Thẻ:terminal_output
--proto:output_rule_attrs=<comma-separated list of options>
mặc định: "tất cả"- Danh sách các thuộc tính được phân tách bằng dấu phẩy để đưa vào đầu ra. Giá trị mặc định là tất cả thuộc tính. Đặt thành chuỗi trống để không xuất ra thuộc tính nào. Tuỳ chọn này áp dụng cho --output=proto.
Thẻ:terminal_output
- Giá trị mặc định của
--[no]proto:rule_inputs_and_outputs
: "true" -
Liệu có điền sẵn các trường rule_input và rule_output hay không.
Thẻ:terminal_output
--query_file=<a string>
mặc định: ""- Nếu được đặt, truy vấn sẽ đọc truy vấn từ tệp được đặt tên tại đây, thay vì trên dòng lệnh. Bạn sẽ gặp lỗi nếu chỉ định một tệp tại đây cũng như một truy vấn dòng lệnh.
Thẻ:changes_inputs
- Giá trị mặc định của
--[no]relative_locations
: "false" - Nếu đúng, vị trí của các tệp BUILD trong đầu ra xml và proto sẽ tương đối. Theo mặc định, đầu ra vị trí là một đường dẫn tuyệt đối và sẽ không nhất quán trên các máy. Bạn có thể đặt tuỳ chọn này thành đúng để có kết quả nhất quán trên các máy.
Thẻ:terminal_output
--show_config_fragments=<off, direct or transitive>
mặc định: "off"- Hiển thị các mảnh cấu hình mà quy tắc yêu cầu và các phần phụ thuộc bắc cầu của mảnh đó. Điều này có thể hữu ích để đánh giá mức độ cắt bớt của biểu đồ mục tiêu đã định cấu hình.
Thẻ:affects_outputs
--starlark:expr=<a string>
mặc định: ""-
Biểu thức Starlark để định dạng từng mục tiêu đã định cấu hình ở chế độ --output=starlark của cquery. Mục tiêu được định cấu hình được liên kết với "target". Nếu bạn không chỉ định --starlark:expr hoặc --starlark:file, tuỳ chọn này sẽ mặc định là "str(target.label)". Bạn sẽ gặp lỗi nếu chỉ định cả --starlark:expr và --starlark:file.
Thẻ:terminal_output
--starlark:file=<a string>
mặc định: ""-
Tên của tệp xác định một hàm Starlark có tên là "format" (định dạng), của một đối số, được áp dụng cho từng mục tiêu đã định cấu hình để định dạng đối số đó dưới dạng một chuỗi. Bạn sẽ gặp lỗi nếu chỉ định cả --starlark:expr và --starlark:file. Hãy xem phần trợ giúp cho --output=starlark để biết thêm thông tin chi tiết.
Thẻ:terminal_output
- Giá trị mặc định của
--[no]tool_deps
: "true" - Truy vấn: Nếu bị tắt, các phần phụ thuộc trên "cấu hình thực thi" sẽ không được đưa vào biểu đồ phần phụ thuộc mà truy vấn hoạt động. Cạnh phần phụ thuộc "cấu hình thực thi", chẳng hạn như cạnh từ quy tắc "proto_library" bất kỳ đến Trình biên dịch giao thức, thường trỏ đến một công cụ được thực thi trong quá trình xây dựng thay vì một phần của cùng một chương trình "mục tiêu".
Cquery: Nếu bị tắt, sẽ lọc ra tất cả các mục tiêu đã định cấu hình vượt qua quá trình chuyển đổi thực thi từ mục tiêu cấp cao nhất đã phát hiện mục tiêu đã định cấu hình này. Điều đó có nghĩa là nếu mục tiêu cấp cao nhất nằm trong cấu hình mục tiêu, thì chỉ những mục tiêu được định cấu hình cũng nằm trong cấu hình mục tiêu mới được trả về. Nếu mục tiêu cấp cao nhất nằm trong cấu hình thực thi, thì chỉ các mục tiêu được định cấu hình thực thi mới được trả về. Tuỳ chọn này KHÔNG loại trừ các chuỗi công cụ đã phân giải.
Thẻ:build_file_semantics
--transitions=<full, lite or none>
mặc định: "none"-
Định dạng mà cquery sẽ in thông tin chuyển đổi.
Thẻ:affects_outputs
--universe_scope=<comma-separated list of options>
mặc định: ""-
Một tập hợp các mẫu mục tiêu được phân tách bằng dấu phẩy (bổ sung và trừ). Truy vấn có thể được thực hiện trong vũ trụ được xác định bằng phép đóng bắc cầu của các mục tiêu đã chỉ định. Tuỳ chọn này được dùng cho các lệnh truy vấn và cquery.
Đối với cquery, dữ liệu đầu vào cho tuỳ chọn này là các mục tiêu mà tất cả câu trả lời được tạo trong đó. Do đó, tuỳ chọn này có thể ảnh hưởng đến cấu hình và quá trình chuyển đổi. Nếu bạn không chỉ định tuỳ chọn này, thì các mục tiêu cấp cao nhất được giả định là các mục tiêu được phân tích cú pháp từ biểu thức truy vấn. Lưu ý: Đối với cquery, việc không chỉ định tuỳ chọn này có thể khiến bản dựng bị lỗi nếu các mục tiêu được phân tích cú pháp từ biểu thức truy vấn không thể tạo bằng các tuỳ chọn cấp cao nhất.
Thẻ:loading_and_analysis
- Các tuỳ chọn kích hoạt tính năng tối ưu hoá thời gian xây dựng:
- Giá trị mặc định của
--[no]experimental_filter_library_jar_with_program_jar
: "false" -
Lọc ProGuard ProgramJar để xoá mọi lớp cũng có trong LibraryJar.
Thẻ:action_command_lines
- Giá trị mặc định của
--[no]experimental_inmemory_dotd_files
: "true" - Nếu được bật, các tệp .d C++ sẽ được truyền trực tiếp trong bộ nhớ từ các nút bản dựng từ xa thay vì được ghi vào ổ đĩa.
Thẻ:loading_and_analysis
,execution
,affects_outputs
,experimental
- Giá trị mặc định của
--[no]experimental_inmemory_jdeps_files
: "true" - Nếu được bật, các tệp phần phụ thuộc (.jdeps) được tạo từ các bản biên dịch Java sẽ được truyền trực tiếp trong bộ nhớ từ các nút bản dựng từ xa thay vì được ghi vào ổ đĩa.
Thẻ:loading_and_analysis
,execution
,affects_outputs
,experimental
- Giá trị mặc định của
--[no]experimental_objc_include_scanning
: "false" -
Liệu có thực hiện việc quét tìm C/C++ khách quan hay không.
Thẻ:loading_and_analysis
,execution
,changes_inputs
- Giá trị mặc định của
--[no]experimental_retain_test_configuration_across_testonly
: "false" -
Khi được bật, --trim_test_configuration sẽ không cắt bớt cấu hình kiểm thử cho các quy tắc được đánh dấu testonly=1. Điều này nhằm giảm các vấn đề xung đột hành động khi các quy tắc không phải quy tắc kiểm thử phụ thuộc vào quy tắc cc_test. Không có hiệu lực nếu --trim_test_configuration là false.
Thẻ:loading_and_analysis
,loses_incremental_state
- Giá trị mặc định của
--[no]experimental_starlark_cc_import
: "false" - Nếu được bật, bạn có thể sử dụng phiên bản Starlark của cc_import.
Thẻ:loading_and_analysis
,experimental
- Giá trị mặc định của
--[no]experimental_unsupported_and_brittle_include_scanning
: "false" -
Liệu có thu hẹp dữ liệu đầu vào cho quá trình biên dịch C/C++ bằng cách phân tích cú pháp các dòng #include từ tệp đầu vào hay không. Điều này có thể cải thiện hiệu suất và tính tăng dần bằng cách giảm kích thước của cây đầu vào biên dịch. Tuy nhiên, việc này cũng có thể làm hỏng các bản dựng vì trình quét bao gồm không triển khai đầy đủ ngữ nghĩa của trình xử lý trước C. Cụ thể, trình biên dịch này không hiểu các lệnh #include động và bỏ qua logic có điều kiện của trình xử lý trước. Bạn tự chịu rủi ro khi sử dụng. Mọi vấn đề liên quan đến cờ này đều sẽ bị đóng.
Thẻ:loading_and_analysis
,execution
,changes_inputs
- Giá trị mặc định của
--[no]incremental_dexing
: "true" -
Thực hiện hầu hết công việc tạo tệp DEX riêng cho từng tệp Jar.
Thẻ:affects_outputs
,loading_and_analysis
,loses_incremental_state
- Giá trị mặc định của
--[no]objc_use_dotd_pruning
: "true" - Nếu được đặt, các tệp .d do clang phát ra sẽ được dùng để cắt bớt tập hợp đầu vào được truyền vào các bản biên dịch objc.
Thẻ:changes_inputs
,loading_and_analysis
- Giá trị mặc định của
--[no]process_headers_in_dependencies
: "false" -
Khi tạo một mục tiêu //a:a, hãy xử lý các tiêu đề trong tất cả các mục tiêu mà //a:a phụ thuộc vào (nếu bạn bật tính năng xử lý tiêu đề cho chuỗi công cụ).
Thẻ:execution
- Giá trị mặc định của
--[no]trim_test_configuration
: "true" -
Khi được bật, các tuỳ chọn liên quan đến kiểm thử sẽ bị xoá bên dưới cấp cao nhất của bản dựng. Khi cờ này đang hoạt động, bạn không thể tạo kiểm thử dưới dạng phần phụ thuộc của các quy tắc không phải kiểm thử, nhưng các thay đổi đối với các tuỳ chọn liên quan đến kiểm thử sẽ không khiến các quy tắc không phải kiểm thử được phân tích lại.
Thẻ
:loading_and_analysis
,loses_incremental_state
- Các tuỳ chọn ảnh hưởng đến mức độ chi tiết, định dạng hoặc vị trí ghi nhật ký:
--toolchain_resolution_debug=<a comma-separated list of regex expressions with prefix '-' specifying excluded paths>
mặc định: "-.*"-
In thông tin gỡ lỗi trong quá trình phân giải chuỗi công cụ. Cờ này lấy một biểu thức chính quy, được kiểm tra dựa trên các loại chuỗi công cụ và mục tiêu cụ thể để xem cần gỡ lỗi mục nào. Bạn có thể phân tách nhiều biểu thức chính quy bằng dấu phẩy, sau đó mỗi biểu thức chính quy sẽ được kiểm tra riêng. Lưu ý: Kết quả của cờ này rất phức tạp và có thể chỉ hữu ích cho các chuyên gia về độ phân giải chuỗi công cụ.
Thẻ:terminal_output
- Các tuỳ chọn chỉ định hoặc thay đổi dữ liệu đầu vào chung cho một lệnh Bazel không thuộc các danh mục khác.:
--flag_alias=<a 'name=value' flag alias>
nhiều lần sử dụng được tích luỹ-
Đặt tên viết tắt cho cờ Starlark. Hàm này nhận một cặp khoá-giá trị duy nhất ở dạng "<khoá>=<giá trị>" làm đối số.
Thẻ:changes_inputs
- Giá trị mặc định của
--[no]incompatible_default_to_explicit_init_py
: "false" -
Cờ này thay đổi hành vi mặc định để các tệp __init__.py không còn được tạo tự động trong các tệp chạy của mục tiêu Python. Chính xác là khi mục tiêu py_binary hoặc py_test có legacy_create_init được đặt thành "tự động" (mặc định), mục tiêu đó được coi là sai nếu và chỉ khi bạn đặt cờ này. Xem https://github.com/bazelbuild/bazel/issues/10076.
Thẻ:affects_outputs
,incompatible_change
- Giá trị mặc định của
--[no]incompatible_py2_outputs_are_suffixed
: "true" - Nếu đúng, các mục tiêu được tạo trong cấu hình Python 2 sẽ xuất hiện trong thư mục gốc đầu ra có hậu tố "-py2", trong khi các mục tiêu được tạo cho Python 3 sẽ xuất hiện trong thư mục gốc không có hậu tố liên quan đến Python. Điều này có nghĩa là đường liên kết tượng trưng thuận tiện `bazel-bin` sẽ trỏ đến các mục tiêu Python 3 thay vì Python 2. Nếu bật tuỳ chọn này, bạn cũng nên bật `--incompatible_py3_is_default`.
Thẻ:affects_outputs
,incompatible_change
- Giá trị mặc định của
--[no]incompatible_py3_is_default
: "true" - Nếu đúng, các mục tiêu `py_binary` và `py_test` không đặt thuộc tính `python_version` (hoặc `default_python_version`) sẽ mặc định là PY3 thay vì PY2. Nếu đặt cờ này, bạn cũng nên đặt `--incompatible_py2_outputs_are_suffixed`.
Thẻ
:loading_and_analysis
,affects_outputs
,incompatible_change
- Giá trị mặc định của
--[no]incompatible_use_python_toolchains
: "true" - Nếu bạn đặt thành true, các quy tắc Python gốc có thể thực thi sẽ sử dụng môi trường thời gian chạy Python do chuỗi công cụ Python chỉ định, thay vì môi trường thời gian chạy do các cờ cũ như --python_top cung cấp.
Thẻ:loading_and_analysis
,incompatible_change
--python_version=<PY2 or PY3>
mặc định: xem nội dung mô tả-
Chế độ phiên bản chính của Python, "PY2" hoặc "PY3". Xin lưu ý rằng chế độ này sẽ bị ghi đè bởi các mục tiêu "py_binary" và "py_test" (ngay cả khi các mục tiêu này không chỉ định rõ ràng một phiên bản), vì vậy, thường không có lý do gì để cung cấp cờ này.
Thẻ:loading_and_analysis
,affects_outputs
- Các tuỳ chọn khác, không được phân loại.:
--[no]cache_test_results
[-t
] mặc định: "tự động"- Nếu được đặt thành "tự động", Bazel sẽ chạy lại một kiểm thử nếu và chỉ khi: (1) Bazel phát hiện thấy các thay đổi trong kiểm thử hoặc các phần phụ thuộc của kiểm thử, (2) kiểm thử được đánh dấu là bên ngoài, (3) nhiều lần chạy kiểm thử được yêu cầu bằng --runs_per_test hoặc(4) kiểm thử trước đó không thành công. Nếu được đặt thành "yes" (có), Bazel sẽ lưu tất cả kết quả kiểm thử vào bộ nhớ đệm, ngoại trừ các kiểm thử được đánh dấu là bên ngoài. Nếu bạn đặt thành "no" (không), Bazel sẽ không lưu kết quả kiểm thử vào bộ nhớ đệm.
- Giá trị mặc định của
--[no]experimental_cancel_concurrent_tests
: "false" - Nếu đúng, Blaze sẽ huỷ các chương trình kiểm thử đang chạy đồng thời trong lần chạy thành công đầu tiên. Điều này chỉ hữu ích khi kết hợp với --runs_per_test_detects_flakes.
Thẻ:affects_outputs
,loading_and_analysis
- Giá trị mặc định của
--[no]experimental_fetch_all_coverage_outputs
: "false" - Nếu đúng, thì Bazel sẽ tìm nạp toàn bộ thư mục dữ liệu mức độ sử dụng cho mỗi lần kiểm thử trong một lần chạy mức độ sử dụng.
Thẻ:affects_outputs
,loading_and_analysis
- Giá trị mặc định của
--[no]experimental_generate_llvm_lcov
: "false" - Nếu đúng, mức độ sử dụng cho clang sẽ tạo ra một báo cáo LCOV.
Thẻ:affects_outputs
,loading_and_analysis
- Giá trị mặc định của
--[no]experimental_j2objc_header_map
: "true" - Liệu có tạo bản đồ tiêu đề J2ObjC song song với quá trình biên dịch chuyển đổi J2ObjC hay không.
- Giá trị mặc định của
--[no]experimental_j2objc_shorter_header_path
: "false" -
Liệu có tạo bằng đường dẫn tiêu đề ngắn hơn hay không (sử dụng "_ios" thay vì "_j2objc").
Thẻ:affects_outputs
--experimental_java_classpath=<off, javabuilder or bazel>
mặc định: "javabuilder"- Bật các đường dẫn lớp rút gọn cho các bản biên dịch Java.
- Giá trị mặc định của
--[no]experimental_limit_android_lint_to_android_constrained_java
: "false" -
Giới hạn --experimental_run_android_lint_on_java_rules ở các thư viện tương thích với Android.
Thẻ:affects_outputs
- Giá trị mặc định của
--[no]experimental_run_android_lint_on_java_rules
: "false" -
Liệu có xác thực các nguồn java_* hay không.
Thẻ:affects_outputs
- Giá trị mặc định của
--[no]explicit_java_test_deps
: "false" - Chỉ định rõ ràng phần phụ thuộc cho JUnit hoặc Hamcrest trong java_test thay vì vô tình lấy từ phần phụ thuộc của TestRunner. Hiện chỉ hoạt động cho bazel.
--host_java_launcher=<a build target label>
mặc định: xem nội dung mô tả- Trình chạy Java mà các công cụ thực thi trong quá trình tạo bản dựng sử dụng.
--host_javacopt=<a string>
nhiều lần sử dụng được tích luỹ- Các tuỳ chọn bổ sung để truyền vào javac khi tạo các công cụ được thực thi trong quá trình tạo bản dựng.
--host_jvmopt=<a string>
nhiều lần sử dụng được tích luỹ- Các tuỳ chọn bổ sung để truyền đến máy ảo Java khi tạo các công cụ được thực thi trong quá trình xây dựng. Các tuỳ chọn này sẽ được thêm vào tuỳ chọn khởi động máy ảo của mỗi mục tiêu java_binary.
- Giá trị mặc định của
--[no]incompatible_check_sharding_support
: "true" - Nếu giá trị là true, Bazel sẽ không kiểm thử được nếu trình chạy kiểm thử không cho biết rằng nó hỗ trợ phân đoạn bằng cách chạm vào tệp tại đường dẫn trong TEST_SHARD_STATUS_FILE. Nếu giá trị là false, trình chạy kiểm thử không hỗ trợ phân đoạn sẽ dẫn đến tất cả các kiểm thử chạy trong mỗi phân đoạn.
Thẻ:incompatible_change
- Giá trị mặc định của
--[no]incompatible_exclusive_test_sandboxed
: "true" - Nếu đúng, các thử nghiệm độc quyền sẽ chạy bằng chiến lược hộp cát. Thêm thẻ "local" để buộc chạy một kiểm thử độc quyền trên máy
Thẻ:incompatible_change
- Giá trị mặc định của
--[no]incompatible_strict_action_env
: "false" - Nếu đúng, Bazel sẽ sử dụng một môi trường có giá trị tĩnh cho PATH và không kế thừa LD_LIBRARY_PATH. Sử dụng --action_env=ENV_VARIABLE nếu bạn muốn kế thừa các biến môi trường cụ thể từ ứng dụng, nhưng lưu ý rằng việc này có thể ngăn việc lưu vào bộ nhớ đệm trên nhiều người dùng nếu bạn sử dụng bộ nhớ đệm dùng chung.
Thẻ:loading_and_analysis
,incompatible_change
--j2objc_translation_flags=<comma-separated list of options>
nhiều lần sử dụng được tích luỹ- Các tuỳ chọn bổ sung để truyền đến công cụ J2ObjC.
--java_debug
-
Khiến máy ảo Java của một kiểm thử java chờ kết nối từ trình gỡ lỗi tuân thủ JDWP (chẳng hạn như jdb) trước khi bắt đầu kiểm thử. Ngụ ý -test_output=streamed.
Mở rộng thành:
--test_arg=--wrapper_script_flag=--debug
--test_output=streamed
--test_strategy=exclusive
--test_timeout=9999
--nocache_test_results
- Giá trị mặc định của
--[no]java_deps
: "true" - Tạo thông tin phần phụ thuộc (hiện tại là đường dẫn lớp thời gian biên dịch) cho mỗi mục tiêu Java.
- Giá trị mặc định của
--[no]java_header_compilation
: "true" - Biên dịch ijar trực tiếp từ nguồn.
--java_language_version=<a string>
mặc định: ""- Phiên bản ngôn ngữ Java
--java_launcher=<a build target label>
mặc định: xem nội dung mô tả- Trình chạy Java để sử dụng khi tạo tệp nhị phân Java. Nếu bạn đặt cờ này thành chuỗi trống, trình chạy JDK sẽ được sử dụng. Thuộc tính "launcher" (trình chạy) sẽ ghi đè cờ này.
--java_runtime_version=<a string>
mặc định: "local_jdk"- Phiên bản môi trường thời gian chạy Java
--javacopt=<a string>
nhiều lần sử dụng được tích luỹ- Các tuỳ chọn bổ sung để truyền đến javac.
--jvmopt=<a string>
nhiều lần sử dụng được tích luỹ- Các tuỳ chọn bổ sung để truyền đến máy ảo Java. Các tuỳ chọn này sẽ được thêm vào tuỳ chọn khởi động máy ảo của mỗi mục tiêu java_binary.
--legacy_main_dex_list_generator=<a build target label>
mặc định: xem nội dung mô tả- Chỉ định một tệp nhị phân để sử dụng nhằm tạo danh sách các lớp phải có trong dex chính khi biên dịch multidex cũ.
--optimizing_dexer=<a build target label>
mặc định: xem nội dung mô tả- Chỉ định một tệp nhị phân để sử dụng cho việc tạo tệp dex mà không phân đoạn.
--plugin=<a build target label>
nhiều lần sử dụng được tích luỹ- Trình bổ trợ để sử dụng trong bản dựng. Hiện hoạt động với java_plugin.
--proguard_top=<a build target label>
mặc định: xem nội dung mô tả- Chỉ định phiên bản ProGuard sẽ dùng để xoá mã khi tạo tệp nhị phân Java.
--proto_compiler=<a build target label>
mặc định: "@bazel_tools//tools/proto:protoc"-
Nhãn của trình biên dịch proto.
Thẻ:affects_outputs
,loading_and_analysis
--proto_toolchain_for_cc=<a build target label>
mặc định: "@bazel_tools//tools/proto:cc_toolchain"-
Nhãn của proto_lang_toolchain() mô tả cách biên dịch proto C++
Thẻ:affects_outputs
,loading_and_analysis
--proto_toolchain_for_j2objc=<a build target label>
mặc định: "@bazel_tools//tools/j2objc:j2objc_proto_toolchain"-
Nhãn của proto_lang_toolchain() mô tả cách biên dịch proto j2objc
Thẻ:affects_outputs
,loading_and_analysis
--proto_toolchain_for_java=<a build target label>
mặc định: "@bazel_tools//tools/proto:java_toolchain"-
Nhãn của proto_lang_toolchain() mô tả cách biên dịch proto Java
Thẻ:affects_outputs
,loading_and_analysis
--proto_toolchain_for_javalite=<a build target label>
mặc định: "@bazel_tools//tools/proto:javalite_toolchain"-
Nhãn của proto_lang_toolchain() mô tả cách biên dịch proto JavaLite
Thẻ:affects_outputs
,loading_and_analysis
--protocopt=<a string>
nhiều lần sử dụng được tích luỹ-
Các tuỳ chọn bổ sung để truyền đến trình biên dịch protobuf.
Thẻ:affects_outputs
- Giá trị mặc định của
--[no]runs_per_test_detects_flakes
: "false" - Nếu đúng, mọi phân mảnh có ít nhất một lần chạy/thử nghiệm thành công và ít nhất một lần chạy/thử nghiệm không thành công sẽ có trạng thái FLAKY.
--shell_executable=<a path>
mặc định: xem nội dung mô tả-
Đường dẫn tuyệt đối đến tệp thực thi shell để Bazel sử dụng. Nếu bạn không đặt biến này nhưng đặt biến môi trường BAZEL_SH trong lệnh gọi Bazel đầu tiên (lệnh gọi này sẽ khởi động máy chủ Bazel), thì Bazel sẽ sử dụng biến đó. Nếu bạn không đặt cả hai, Bazel sẽ sử dụng đường dẫn mặc định được mã hoá cứng tuỳ thuộc vào hệ điều hành mà nó chạy (Windows: c:/tools/msys64/usr/bin/bash.exe, FreeBSD: /usr/local/bin/bash, tất cả các hệ điều hành khác: /bin/bash). Xin lưu ý rằng việc sử dụng một shell không tương thích với bash có thể dẫn đến lỗi bản dựng hoặc lỗi thời gian chạy của các tệp nhị phân được tạo.
Thẻ:loading_and_analysis
--test_arg=<a string>
nhiều lần sử dụng được tích luỹ- Chỉ định các tuỳ chọn và đối số bổ sung cần được truyền đến tệp thực thi kiểm thử. Có thể sử dụng nhiều lần để chỉ định một số đối số. Nếu nhiều chương trình kiểm thử được thực thi, thì mỗi chương trình kiểm thử sẽ nhận được các đối số giống hệt nhau. Chỉ được lệnh "bazel test" sử dụng.
--test_filter=<a string>
mặc định: xem nội dung mô tả- Chỉ định một bộ lọc để chuyển tiếp đến khung kiểm thử. Dùng để giới hạn số lượng kiểm thử được chạy. Xin lưu ý rằng điều này không ảnh hưởng đến việc xây dựng mục tiêu nào.
--test_result_expiration=<an integer>
mặc định: "-1"- Tuỳ chọn này không được dùng nữa và không có hiệu lực.
- Giá trị mặc định của
--[no]test_runner_fail_fast
: "false" - Chuyển tiếp tuỳ chọn thất bại nhanh đến trình chạy kiểm thử. Trình chạy kiểm thử sẽ dừng thực thi khi gặp lỗi đầu tiên.
--test_sharding_strategy=<explicit, disabled or forced=k where k is the number of shards to enforce>
mặc định: "explicit"- Chỉ định chiến lược phân đoạn kiểm thử: "rõ ràng" để chỉ sử dụng phân đoạn nếu có thuộc tính BUILD "shard_count". "disabled" để không bao giờ sử dụng tính năng phân đoạn kiểm thử. "forced=k" để thực thi các phân đoạn "k" cho hoạt động kiểm thử bất kể thuộc tính BUILD "shard_count".
--tool_java_language_version=<a string>
mặc định: ""- Phiên bản ngôn ngữ Java dùng để thực thi các công cụ cần thiết trong quá trình tạo bản dựng
--tool_java_runtime_version=<a string>
mặc định: "remotejdk_11"- Phiên bản thời gian chạy Java dùng để thực thi các công cụ trong quá trình tạo bản dựng
- Giá trị mặc định của
--[no]use_ijars
: "true" - Nếu được bật, tuỳ chọn này sẽ khiến quá trình biên dịch Java sử dụng các tệp jar giao diện. Điều này sẽ giúp quá trình biên dịch tăng dần diễn ra nhanh hơn, nhưng thông báo lỗi có thể khác.
Tuỳ chọn kết xuất
- Các tuỳ chọn xuất hiện trước lệnh và được máy khách phân tích cú pháp:
--distdir=<a path>
nhiều lần sử dụng được tích luỹ-
Các vị trí khác để tìm kiếm bản lưu trữ trước khi truy cập vào mạng để tải xuống.
Thẻ:bazel_internal_configuration
- Giá trị mặc định của
--[no]experimental_repository_cache_hardlinks
: "false" - Nếu được đặt, bộ nhớ đệm kho lưu trữ sẽ liên kết cứng tệp trong trường hợp có lượt truy cập vào bộ nhớ đệm, thay vì sao chép. Việc này nhằm tiết kiệm dung lượng ổ đĩa.
Thẻ:bazel_internal_configuration
--experimental_repository_downloader_retries=<an integer>
mặc định: "0"-
Số lần thử tối đa để thử lại lỗi tải xuống. Nếu bạn đặt thành 0, thì tính năng thử lại sẽ bị tắt.
Thẻ:experimental
--experimental_scale_timeouts=<a double>
mặc định: "1.0"- Điều chỉnh tất cả thời gian chờ trong quy tắc kho lưu trữ Starlark theo hệ số này. Bằng cách này, bạn có thể làm cho kho lưu trữ bên ngoài hoạt động trên các máy chạy chậm hơn dự kiến của tác giả quy tắc mà không cần thay đổi mã nguồn
Thẻ:bazel_internal_configuration
,experimental
- Giá trị mặc định của
--[no]incompatible_disable_native_repo_rules
: "false" - Nếu giá trị là false, bạn có thể sử dụng các quy tắc kho lưu trữ gốc trong WORKSPACE; nếu không, bạn phải sử dụng các quy tắc kho lưu trữ Starlark. Các quy tắc kho lưu trữ gốc bao gồm local_repository, new_local_repository, local_config_platform, android_sdk_repository và android_ndk_repository.
Thẻ:bazel_internal_configuration
--repository_cache=<a path>
mặc định: xem nội dung mô tả- Chỉ định vị trí bộ nhớ đệm của các giá trị đã tải xuống thu được trong quá trình tìm nạp kho lưu trữ bên ngoài. Chuỗi trống làm đối số yêu cầu tắt bộ nhớ đệm, nếu không, giá trị mặc định là "<output_user_root>/cache/repos/v1" sẽ được sử dụng
Thẻ:bazel_internal_configuration
- Giá trị mặc định của
--[no]repository_disable_download
: "false" - Nếu được đặt, bạn không được phép tải xuống bằng ctx.download{,_and_extract} trong quá trình tìm nạp kho lưu trữ. Xin lưu ý rằng quyền truy cập mạng không bị tắt hoàn toàn; ctx.execute vẫn có thể chạy một tệp thực thi tuỳ ý truy cập Internet.
Thẻ:bazel_internal_configuration
- Các tuỳ chọn kiểm soát việc thực thi bản dựng:
- Giá trị mặc định của
--gc_thrashing_threshold=<an integer in 0-100 range>
: "100" -
Tỷ lệ phần trăm không gian cố định bị chiếm dụng (0-100) mà tại đó GcThrashingDetector xem xét các sự kiện áp lực bộ nhớ so với giới hạn của nó (--gc_thrashing_limits). Nếu bạn đặt thành 100, GcThrashingDetector sẽ bị tắt.
Thẻ:host_machine_resource_optimizations
- Các tuỳ chọn kiểm soát đầu ra của lệnh:
- Giá trị mặc định của
--[no]action_cache
: "false" -
Tải nội dung bộ nhớ đệm hành động.
Thẻ:bazel_monitoring
- Giá trị mặc định của
--[no]packages
: "false" -
Trích xuất nội dung bộ nhớ đệm gói.
Thẻ:bazel_monitoring
- Giá trị mặc định của
--[no]rule_classes
: "false" -
Tải các lớp quy tắc xuống.
Thẻ:bazel_monitoring
- Giá trị mặc định của
--[no]rules
: "false" -
Tạo quy tắc kết xuất, bao gồm cả số lượng và mức sử dụng bộ nhớ (nếu bộ nhớ được theo dõi).
Thẻ:bazel_monitoring
--skyframe=<off, summary, count, deps or rdeps>
mặc định: "off"-
Tải đồ thị Skyframe xuống: "off", "summary", "count", "deps" hoặc "rdeps".
Thẻ:bazel_monitoring
--skykey_filter=<a comma-separated list of regex expressions with prefix '-' specifying excluded paths>
mặc định: ".*"-
Bộ lọc biểu thức chính quy của tên SkyKey để xuất. Chỉ được sử dụng với --skyframe=deps, rdeps.
Thẻ:bazel_monitoring
--skylark_memory=<a string>
mặc định: xem nội dung mô tả-
Tải một hồ sơ bộ nhớ tương thích với pprof vào đường dẫn đã chỉ định. Để tìm hiểu thêm, vui lòng xem https://github.com/google/pprof.
Thẻ:bazel_monitoring
- Tuỳ chọn liên quan đến đầu ra và ngữ nghĩa của Bzlmod:
--allow_yanked_versions=<a string>
nhiều lần sử dụng được tích luỹ-
Chỉ định các phiên bản mô-đun ở dạng `<module1>@<version1>,<module2>@<version2>` sẽ được cho phép trong biểu đồ phần phụ thuộc đã phân giải ngay cả khi các phiên bản đó được khai báo là đã bị xoá trong sổ đăng ký nơi chúng đến (nếu không đến từ NonRegistryOverride). Nếu không, các phiên bản bị xoá sẽ khiến việc phân giải không thành công. Bạn cũng có thể xác định phiên bản bị xoá được phép bằng biến môi trường `BZLMOD_ALLOW_YANKED_VERSIONS`. Bạn có thể tắt tính năng kiểm tra này bằng cách sử dụng từ khoá "tất cả" (không nên dùng).
Thẻ:loading_and_analysis
--check_bazel_compatibility=<error, warning or off>
mặc định: "lỗi"-
Kiểm tra khả năng tương thích của phiên bản bazel của các mô-đun Bazel. Các giá trị hợp lệ là "error" để chuyển vấn đề này lên lỗi phân giải, "off" để tắt tính năng kiểm tra hoặc "warning" để in cảnh báo khi phát hiện thấy không khớp.
Thẻ:loading_and_analysis
--check_direct_dependencies=<off, warning or error>
mặc định: "cảnh báo"-
Kiểm tra xem các phần phụ thuộc `bazel_dep` trực tiếp được khai báo trong mô-đun gốc có phải là các phiên bản mà bạn nhận được trong biểu đồ phần phụ thuộc đã được phân giải hay không. Các giá trị hợp lệ là "off" để tắt tính năng kiểm tra, "warning" để in cảnh báo khi phát hiện thấy không khớp hoặc "error" để chuyển lên lỗi phân giải.
Thẻ:loading_and_analysis
- Giá trị mặc định của
--[no]ignore_dev_dependency
: "false" - Nếu đúng, Bazel sẽ bỏ qua "bazel_dep" và "use_extension" được khai báo là "dev_dependency" trong MODULE.bazel của mô-đun gốc. Xin lưu ý rằng các phần phụ thuộc dành cho nhà phát triển đó luôn bị bỏ qua trong MODULE.bazel nếu đó không phải là mô-đun gốc, bất kể giá trị của cờ này là gì.
Thẻ:loading_and_analysis
--lockfile_mode=<off, update, refresh or error>
mặc định: "cập nhật"-
Chỉ định cách thức và liệu có sử dụng tệp khoá hay không. Các giá trị hợp lệ là "update" để sử dụng tệp khoá và cập nhật tệp khoá nếu có thay đổi, "refresh" để thỉnh thoảng làm mới thông tin có thể thay đổi (các phiên bản bị loại bỏ và các mô-đun bị thiếu trước đó) từ các sổ đăng ký từ xa, "error" để sử dụng tệp khoá nhưng gửi lỗi nếu tệp khoá không được cập nhật hoặc "off" để không đọc hoặc ghi vào tệp khoá.
Thẻ:loading_and_analysis
--override_module=<an equals-separated mapping of module name to path>
nhiều lần sử dụng được tích luỹ- Ghi đè một mô-đun bằng đường dẫn cục bộ ở dạng <tên mô-đun>=<đường dẫn>. Nếu đường dẫn đã cho là đường dẫn tuyệt đối, thì đường dẫn đó sẽ được sử dụng nguyên trạng. Nếu đường dẫn đã cho là đường dẫn tương đối, thì đường dẫn đó sẽ tương ứng với thư mục đang hoạt động. Nếu đường dẫn đã cho bắt đầu bằng "%workspace%", thì đường dẫn đó sẽ tương ứng với thư mục gốc của không gian làm việc, là kết quả của lệnh "bazel info workspace". Nếu đường dẫn đã cho trống, hãy xoá mọi chế độ ghi đè trước đó.
--registry=<a string>
nhiều lần sử dụng được tích luỹ- Chỉ định các sổ đăng ký cần sử dụng để xác định vị trí các phần phụ thuộc mô-đun Bazel. Thứ tự rất quan trọng: các mô-đun sẽ được tra cứu trong các sổ đăng ký trước đó trước tiên và chỉ quay lại các sổ đăng ký sau này khi các mô-đun đó bị thiếu trong các sổ đăng ký trước đó.
Thẻ:changes_inputs
--vendor_dir=<a path>
mặc định: xem nội dung mô tả-
Chỉ định thư mục sẽ chứa các kho lưu trữ bên ngoài ở chế độ nhà cung cấp, cho dù mục đích là tìm nạp các kho lưu trữ đó vào thư mục hay sử dụng các kho lưu trữ đó trong khi xây dựng. Bạn có thể chỉ định đường dẫn dưới dạng đường dẫn tuyệt đối hoặc đường dẫn tương đối đến thư mục không gian làm việc.
Thẻ:loading_and_analysis
- Các tuỳ chọn kích hoạt tính năng tối ưu hoá thời gian xây dựng:
--gc_thrashing_limits=<comma separated pairs of <period>:<count>>
mặc định: "1s:2,20s:3,1m:5"-
Các giới hạn nếu đạt đến sẽ khiến GcThrashingDetector gặp sự cố Bazel với OOM. Mỗi giới hạn được chỉ định là <period>:<count>, trong đó period là thời lượng và count là số nguyên dương. Nếu hơn --gc_thrashing_threshold phần trăm không gian cố định (vùng nhớ khối xếp cũ) vẫn bị chiếm dụng sau <count> lần GC đầy đủ liên tiếp trong <period>, thì lỗi OOM sẽ được kích hoạt. Bạn có thể chỉ định nhiều giới hạn, phân tách bằng dấu phẩy.
Thẻ:host_machine_resource_optimizations
--skyframe_high_water_mark_full_gc_drops_per_invocation=<an integer, >= 0>
mặc định: "2147483647"-
Cờ cho cấu hình nâng cao của công cụ Skyframe nội bộ của Bazel. Nếu phát hiện mức sử dụng phần trăm vùng nhớ khối xếp được giữ lại vượt quá ngưỡng do --skyframe_high_water_mark_threshold đặt ra, thì khi một sự kiện GC đầy đủ xảy ra, Bazel sẽ loại bỏ trạng thái Skyframe tạm thời không cần thiết, lên đến nhiều lần như vậy cho mỗi lệnh gọi. Mặc định là Integer.MAX_VALUE; không giới hạn về mặt hiệu quả. Giá trị 0 có nghĩa là các sự kiện GC đầy đủ sẽ không bao giờ kích hoạt sự kiện thả. Nếu đạt đến giới hạn, trạng thái Skyframe sẽ không còn bị loại bỏ khi một sự kiện GC đầy đủ xảy ra và vượt quá ngưỡng phần trăm vùng nhớ khối xếp được giữ lại đó.
Thẻ:host_machine_resource_optimizations
--skyframe_high_water_mark_minor_gc_drops_per_invocation=<an integer, >= 0>
mặc định: "2147483647"-
Cờ cho cấu hình nâng cao của công cụ Skyframe nội bộ của Bazel. Nếu phát hiện mức sử dụng phần trăm vùng nhớ khối xếp được giữ lại vượt quá ngưỡng do --skyframe_high_water_mark_threshold đặt ra, thì khi một sự kiện GC nhỏ xảy ra, Bazel sẽ loại bỏ trạng thái Skyframe tạm thời không cần thiết, lên đến nhiều lần như vậy mỗi lần gọi. Mặc định là Integer.MAX_VALUE; không giới hạn về mặt hiệu quả. Giá trị 0 có nghĩa là các sự kiện GC nhỏ sẽ không bao giờ kích hoạt sự kiện thả. Nếu đạt đến giới hạn, trạng thái Skyframe sẽ không còn bị loại bỏ khi một sự kiện GC nhỏ xảy ra và vượt quá ngưỡng phần trăm vùng nhớ khối xếp được giữ lại.
Thẻ:host_machine_resource_optimizations
--skyframe_high_water_mark_threshold=<an integer>
mặc định: "85"-
Cờ cho cấu hình nâng cao của công cụ Skyframe nội bộ của Bazel. Nếu phát hiện mức sử dụng phần trăm vùng nhớ khối xếp được giữ lại ít nhất là ngưỡng này, Bazel sẽ loại bỏ trạng thái Skyframe tạm thời không cần thiết. Việc điều chỉnh điều này có thể giúp bạn giảm thiểu tác động của tình trạng GC bị lỗi khi (i) tình trạng này là do mức sử dụng bộ nhớ của trạng thái tạm thời và (ii) tốn kém hơn so với việc tạo lại trạng thái khi cần.
Thẻ:host_machine_resource_optimizations
- Các tuỳ chọn ảnh hưởng đến mức độ chi tiết, định dạng hoặc vị trí ghi nhật ký:
--experimental_command_profile=<cpu, wall, alloc or lock>
mặc định: xem nội dung mô tả- Ghi hồ sơ Trình ghi chuyến bay Java trong thời gian thực thi lệnh. Bạn phải cung cấp một trong các loại sự kiện phân tích tài nguyên được hỗ trợ (cpu, wall, alloc hoặc lock) dưới dạng đối số. Hồ sơ được ghi vào một tệp được đặt tên theo loại sự kiện trong thư mục cơ sở đầu ra. Cú pháp và ngữ nghĩa của cờ này có thể thay đổi trong tương lai để hỗ trợ thêm các loại hồ sơ hoặc định dạng đầu ra; bạn tự chịu rủi ro khi sử dụng.
- Giá trị mặc định của
--[no]experimental_record_metrics_for_all_mnemonics
: "false" - Theo mặc định, số lượng loại thao tác được giới hạn ở 20 câu thần chú có số lượng thao tác được thực thi nhiều nhất. Việc đặt tuỳ chọn này sẽ ghi số liệu thống kê cho tất cả các câu thần chú.
- Các tuỳ chọn chỉ định hoặc thay đổi dữ liệu đầu vào chung thành một lệnh Bazel không thuộc các danh mục khác.:
--experimental_resolved_file_instead_of_workspace=<a string>
mặc định: ""- Nếu không trống, hãy đọc tệp đã phân giải được chỉ định thay vì tệp WORKSPACE
Thẻ:changes_inputs
- Các tuỳ chọn thực thi và lưu vào bộ nhớ đệm từ xa:
--experimental_downloader_config=<a string>
mặc định: xem nội dung mô tả- Chỉ định một tệp để định cấu hình trình tải xuống từ xa. Tệp này bao gồm các dòng, mỗi dòng bắt đầu bằng một lệnh (`allow`, `block` hoặc `rewrite`), theo sau là tên máy chủ lưu trữ (đối với lệnh `allow` và `block`) hoặc hai mẫu, một mẫu để so khớp và một mẫu để sử dụng làm URL thay thế, với các tệp tham chiếu ngược bắt đầu từ `$1`. Bạn có thể cung cấp nhiều lệnh `rewrite` cho cùng một URL và trong trường hợp này, nhiều URL sẽ được trả về.
- Giá trị mặc định của
--experimental_worker_for_repo_fetching=<off, platform, virtual or auto>
: "tự động" - Chế độ tạo luồng để tìm nạp kho lưu trữ. Nếu bạn đặt thành "tắt", thì không có luồng worker nào được sử dụng và quá trình tìm nạp kho lưu trữ sẽ phải khởi động lại. Nếu không, hãy sử dụng luồng worker ảo.
- Các tuỳ chọn khác, không được phân loại theo cách khác.:
--override_repository=<an equals-separated mapping of repository name to path>
nhiều lần sử dụng được tích luỹ- Ghi đè kho lưu trữ bằng một đường dẫn cục bộ ở dạng <repository name>=<path>. Nếu đường dẫn đã cho là đường dẫn tuyệt đối, thì đường dẫn đó sẽ được sử dụng nguyên trạng. Nếu đường dẫn đã cho là đường dẫn tương đối, thì đường dẫn đó sẽ tương ứng với thư mục đang hoạt động. Nếu đường dẫn đã cho bắt đầu bằng "%workspace%", thì đường dẫn đó sẽ tương ứng với thư mục gốc của không gian làm việc, là kết quả của lệnh "bazel info workspace". Nếu đường dẫn đã cho trống, hãy xoá mọi chế độ ghi đè trước đó.
Tuỳ chọn tìm nạp
Kế thừa tất cả các tuỳ chọn từ test.
- Các tuỳ chọn xuất hiện trước lệnh và được máy khách phân tích cú pháp:
--distdir=<a path>
nhiều lần sử dụng được tích luỹ-
Các vị trí khác để tìm kiếm bản lưu trữ trước khi truy cập vào mạng để tải xuống.
Thẻ:bazel_internal_configuration
- Giá trị mặc định của
--[no]experimental_repository_cache_hardlinks
: "false" - Nếu được đặt, bộ nhớ đệm kho lưu trữ sẽ liên kết cứng tệp trong trường hợp có lượt truy cập vào bộ nhớ đệm, thay vì sao chép. Việc này nhằm tiết kiệm dung lượng ổ đĩa.
Thẻ:bazel_internal_configuration
--experimental_repository_downloader_retries=<an integer>
mặc định: "0"-
Số lần thử tối đa để thử lại lỗi tải xuống. Nếu bạn đặt thành 0, thì tính năng thử lại sẽ bị tắt.
Thẻ:experimental
--experimental_scale_timeouts=<a double>
mặc định: "1.0"- Điều chỉnh tất cả thời gian chờ trong quy tắc kho lưu trữ Starlark theo hệ số này. Bằng cách này, bạn có thể làm cho kho lưu trữ bên ngoài hoạt động trên các máy chạy chậm hơn dự kiến của tác giả quy tắc mà không cần thay đổi mã nguồn
Thẻ:bazel_internal_configuration
,experimental
- Giá trị mặc định của
--[no]incompatible_disable_native_repo_rules
: "false" - Nếu giá trị là false, bạn có thể sử dụng các quy tắc kho lưu trữ gốc trong WORKSPACE; nếu không, bạn phải sử dụng các quy tắc kho lưu trữ Starlark. Các quy tắc kho lưu trữ gốc bao gồm local_repository, new_local_repository, local_config_platform, android_sdk_repository và android_ndk_repository.
Thẻ:bazel_internal_configuration
--repository_cache=<a path>
mặc định: xem nội dung mô tả- Chỉ định vị trí bộ nhớ đệm của các giá trị đã tải xuống thu được trong quá trình tìm nạp kho lưu trữ bên ngoài. Chuỗi trống làm đối số yêu cầu tắt bộ nhớ đệm, nếu không, giá trị mặc định là "<output_user_root>/cache/repos/v1" sẽ được sử dụng
Thẻ:bazel_internal_configuration
- Giá trị mặc định của
--[no]repository_disable_download
: "false" - Nếu được đặt, bạn không được phép tải xuống bằng ctx.download{,_and_extract} trong quá trình tìm nạp kho lưu trữ. Xin lưu ý rằng quyền truy cập mạng không bị tắt hoàn toàn; ctx.execute vẫn có thể chạy một tệp thực thi tuỳ ý truy cập Internet.
Thẻ:bazel_internal_configuration
- Các tuỳ chọn kiểm soát việc thực thi bản dựng:
- Giá trị mặc định của
--[no]all
: "false" -
Tìm nạp tất cả kho lưu trữ bên ngoài cần thiết để tạo bất kỳ mục tiêu hoặc kho lưu trữ nào. Đây là giá trị mặc định nếu không có cờ và đối số nào khác được cung cấp. Chỉ hoạt động khi --enable_bzlmod đang bật.
Thẻ:changes_inputs
- Giá trị mặc định của
--gc_thrashing_threshold=<an integer in 0-100 range>
: "100" -
Tỷ lệ phần trăm không gian cố định bị chiếm dụng (0-100) mà tại đó GcThrashingDetector xem xét các sự kiện áp lực bộ nhớ so với giới hạn của nó (--gc_thrashing_limits). Nếu bạn đặt thành 100, GcThrashingDetector sẽ bị tắt.
Thẻ:host_machine_resource_optimizations
--[no]keep_going
[-k
] mặc định: "false"-
Tiếp tục nhiều nhất có thể sau khi xảy ra lỗi. Mặc dù không thể phân tích mục tiêu không thành công và các mục tiêu phụ thuộc vào mục tiêu đó, nhưng bạn có thể phân tích các điều kiện tiên quyết khác của các mục tiêu này.
Thẻ:eagerness_to_exit
- Giá trị mặc định của
--loading_phase_threads=<an integer, or a keyword ("auto", "HOST_CPUS", "HOST_RAM"), optionally followed by an operation ([-|*]<float>) eg. "auto", "HOST_CPUS*.5">
: "tự động" - Số luồng song song cần sử dụng cho giai đoạn tải/phân tích. Nhận một số nguyên hoặc từ khoá ("tự động", "HOST_CPUS", "HOST_RAM"), theo sau có thể là một phép toán ([-|*]<float>) ví dụ: "tự động", "HOST_CPUS*.5". "tự động" đặt giá trị mặc định hợp lý dựa trên tài nguyên của máy chủ lưu trữ. Phải ít nhất là 1.
Thẻ:bazel_internal_configuration
- Tuỳ chọn này ảnh hưởng đến ngữ nghĩa của ngôn ngữ Starlark hoặc API bản dựng có thể truy cập vào các tệp BUILD, tệp .bzl hoặc tệp WORKSPACE.:
- Giá trị mặc định của
--[no]incompatible_config_setting_private_default_visibility
: "false" - Nếu incompatible_enforce_config_setting_visibility=false, thì đây là một thao tác không có tác dụng. Nếu không, nếu cờ này là false, mọi config_setting không có thuộc tính chế độ hiển thị rõ ràng sẽ là //visibility:public. Nếu cờ này là true, config_setting sẽ tuân theo logic hiển thị giống như tất cả các quy tắc khác. Xem https://github.com/bazelbuild/bazel/issues/12933.
Thẻ:loading_and_analysis
,incompatible_change
- Giá trị mặc định của
--[no]incompatible_enforce_config_setting_visibility
: "true" - Nếu đúng, hãy thực thi các quy định hạn chế về chế độ hiển thị config_setting. Nếu giá trị là false, mọi mục config_setting đều hiển thị với mọi mục tiêu. Xem https://github.com/bazelbuild/bazel/issues/12932.
Thẻ:loading_and_analysis
,incompatible_change
- Các tuỳ chọn liên quan đến kết quả và ngữ nghĩa của Bzlmod:
--allow_yanked_versions=<a string>
nhiều lần sử dụng được tích luỹ-
Chỉ định các phiên bản mô-đun ở dạng `<module1>@<version1>,<module2>@<version2>` sẽ được cho phép trong biểu đồ phần phụ thuộc đã phân giải ngay cả khi các phiên bản đó được khai báo là đã bị xoá trong sổ đăng ký nơi chúng đến (nếu không đến từ NonRegistryOverride). Nếu không, các phiên bản bị xoá sẽ khiến việc phân giải không thành công. Bạn cũng có thể xác định phiên bản bị xoá được phép bằng biến môi trường `BZLMOD_ALLOW_YANKED_VERSIONS`. Bạn có thể tắt tính năng kiểm tra này bằng cách sử dụng từ khoá "tất cả" (không nên dùng).
Thẻ:loading_and_analysis
--check_bazel_compatibility=<error, warning or off>
mặc định: "lỗi"-
Kiểm tra khả năng tương thích của phiên bản bazel của các mô-đun Bazel. Các giá trị hợp lệ là "error" để chuyển vấn đề này lên lỗi phân giải, "off" để tắt tính năng kiểm tra hoặc "warning" để in cảnh báo khi phát hiện thấy không khớp.
Thẻ:loading_and_analysis
--check_direct_dependencies=<off, warning or error>
mặc định: "cảnh báo"-
Kiểm tra xem các phần phụ thuộc `bazel_dep` trực tiếp được khai báo trong mô-đun gốc có phải là các phiên bản mà bạn nhận được trong biểu đồ phần phụ thuộc đã được phân giải hay không. Các giá trị hợp lệ là "off" để tắt tính năng kiểm tra, "warning" để in cảnh báo khi phát hiện thấy không khớp hoặc "error" để chuyển lên lỗi phân giải.
Thẻ:loading_and_analysis
- Giá trị mặc định của
--[no]configure
: "false" -
Chỉ tìm nạp các kho lưu trữ được đánh dấu là "định cấu hình" cho mục đích định cấu hình hệ thống. Chỉ hoạt động khi --enable_bzlmod đang bật.
Thẻ:changes_inputs
- Giá trị mặc định của
--[no]force
: "false" -
Bỏ qua kho lưu trữ hiện có (nếu có) và buộc tìm nạp lại kho lưu trữ. Chỉ hoạt động khi --enable_bzlmod đang bật.
Thẻ:changes_inputs
- Giá trị mặc định của
--[no]ignore_dev_dependency
: "false" - Nếu đúng, Bazel sẽ bỏ qua "bazel_dep" và "use_extension" được khai báo là "dev_dependency" trong MODULE.bazel của mô-đun gốc. Xin lưu ý rằng các phần phụ thuộc dành cho nhà phát triển đó luôn bị bỏ qua trong MODULE.bazel nếu đó không phải là mô-đun gốc, bất kể giá trị của cờ này là gì.
Thẻ:loading_and_analysis
--lockfile_mode=<off, update, refresh or error>
mặc định: "cập nhật"-
Chỉ định cách thức và liệu có sử dụng tệp khoá hay không. Các giá trị hợp lệ là "update" để sử dụng tệp khoá và cập nhật tệp khoá nếu có thay đổi, "refresh" để thỉnh thoảng làm mới thông tin có thể thay đổi (các phiên bản bị loại bỏ và các mô-đun bị thiếu trước đó) từ các sổ đăng ký từ xa, "error" để sử dụng tệp khoá nhưng gửi lỗi nếu tệp khoá không được cập nhật hoặc "off" để không đọc hoặc ghi vào tệp khoá.
Thẻ:loading_and_analysis
--override_module=<an equals-separated mapping of module name to path>
nhiều lần sử dụng được tích luỹ- Ghi đè một mô-đun bằng đường dẫn cục bộ ở dạng <tên mô-đun>=<đường dẫn>. Nếu đường dẫn đã cho là đường dẫn tuyệt đối, thì đường dẫn đó sẽ được sử dụng nguyên trạng. Nếu đường dẫn đã cho là đường dẫn tương đối, thì đường dẫn đó sẽ tương ứng với thư mục đang hoạt động. Nếu đường dẫn đã cho bắt đầu bằng "%workspace%", thì đường dẫn đó sẽ tương ứng với thư mục gốc của không gian làm việc, là kết quả của lệnh "bazel info workspace". Nếu đường dẫn đã cho trống, hãy xoá mọi chế độ ghi đè trước đó.
--registry=<a string>
nhiều lần sử dụng được tích luỹ- Chỉ định các sổ đăng ký cần sử dụng để xác định vị trí các phần phụ thuộc mô-đun Bazel. Thứ tự rất quan trọng: các mô-đun sẽ được tra cứu trong các sổ đăng ký trước đó trước tiên và chỉ quay lại các sổ đăng ký sau này khi các mô-đun đó bị thiếu trong các sổ đăng ký trước đó.
Thẻ:changes_inputs
--repo=<a string>
nhiều lần sử dụng được tích luỹ-
Chỉ tìm nạp kho lưu trữ được chỉ định, có thể là {@apparent_repo_name} hoặc {@@canonical_repo_name}. Chỉ hoạt động khi --enable_bzlmod đang bật.
Thẻ:changes_inputs
--vendor_dir=<a path>
mặc định: xem nội dung mô tả-
Chỉ định thư mục sẽ chứa các kho lưu trữ bên ngoài ở chế độ nhà cung cấp, cho dù mục đích là tìm nạp các kho lưu trữ đó vào thư mục hay sử dụng các kho lưu trữ đó trong khi xây dựng. Bạn có thể chỉ định đường dẫn dưới dạng đường dẫn tuyệt đối hoặc đường dẫn tương đối đến thư mục không gian làm việc.
Thẻ:loading_and_analysis
- Các tuỳ chọn kích hoạt tính năng tối ưu hoá thời gian xây dựng:
--gc_thrashing_limits=<comma separated pairs of <period>:<count>>
mặc định: "1s:2,20s:3,1m:5"-
Các giới hạn nếu đạt đến sẽ khiến GcThrashingDetector gặp sự cố Bazel với OOM. Mỗi giới hạn được chỉ định là <period>:<count>, trong đó period là thời lượng và count là số nguyên dương. Nếu hơn --gc_thrashing_threshold phần trăm không gian cố định (vùng nhớ khối xếp cũ) vẫn bị chiếm dụng sau <count> lần GC đầy đủ liên tiếp trong <period>, thì lỗi OOM sẽ được kích hoạt. Bạn có thể chỉ định nhiều giới hạn, phân tách bằng dấu phẩy.
Thẻ:host_machine_resource_optimizations
--skyframe_high_water_mark_full_gc_drops_per_invocation=<an integer, >= 0>
mặc định: "2147483647"-
Cờ cho cấu hình nâng cao của công cụ Skyframe nội bộ của Bazel. Nếu phát hiện mức sử dụng phần trăm vùng nhớ khối xếp được giữ lại vượt quá ngưỡng do --skyframe_high_water_mark_threshold đặt ra, thì khi một sự kiện GC đầy đủ xảy ra, Bazel sẽ loại bỏ trạng thái Skyframe tạm thời không cần thiết, lên đến nhiều lần như vậy cho mỗi lệnh gọi. Mặc định là Integer.MAX_VALUE; không giới hạn về mặt hiệu quả. Giá trị 0 có nghĩa là các sự kiện GC đầy đủ sẽ không bao giờ kích hoạt sự kiện thả. Nếu đạt đến giới hạn, trạng thái Skyframe sẽ không còn bị loại bỏ khi một sự kiện GC đầy đủ xảy ra và vượt quá ngưỡng phần trăm vùng nhớ khối xếp được giữ lại đó.
Thẻ:host_machine_resource_optimizations
--skyframe_high_water_mark_minor_gc_drops_per_invocation=<an integer, >= 0>
mặc định: "2147483647"-
Cờ cho cấu hình nâng cao của công cụ Skyframe nội bộ của Bazel. Nếu phát hiện mức sử dụng phần trăm vùng nhớ khối xếp được giữ lại vượt quá ngưỡng do --skyframe_high_water_mark_threshold đặt ra, thì khi một sự kiện GC nhỏ xảy ra, Bazel sẽ loại bỏ trạng thái Skyframe tạm thời không cần thiết, lên đến nhiều lần như vậy mỗi lần gọi. Mặc định là Integer.MAX_VALUE; không giới hạn về mặt hiệu quả. Giá trị 0 có nghĩa là các sự kiện GC nhỏ sẽ không bao giờ kích hoạt sự kiện thả. Nếu đạt đến giới hạn, trạng thái Skyframe sẽ không còn bị loại bỏ khi một sự kiện GC nhỏ xảy ra và vượt quá ngưỡng phần trăm vùng nhớ khối xếp được giữ lại.
Thẻ:host_machine_resource_optimizations
--skyframe_high_water_mark_threshold=<an integer>
mặc định: "85"-
Cờ cho cấu hình nâng cao của công cụ Skyframe nội bộ của Bazel. Nếu phát hiện mức sử dụng phần trăm vùng nhớ khối xếp được giữ lại ít nhất là ngưỡng này, Bazel sẽ loại bỏ trạng thái Skyframe tạm thời không cần thiết. Việc điều chỉnh điều này có thể giúp bạn giảm thiểu tác động của tình trạng GC bị lỗi khi (i) tình trạng này là do mức sử dụng bộ nhớ của trạng thái tạm thời và (ii) tốn kém hơn so với việc tạo lại trạng thái khi cần.
Thẻ:host_machine_resource_optimizations
- Các tuỳ chọn ảnh hưởng đến mức độ chi tiết, định dạng hoặc vị trí ghi nhật ký:
--experimental_command_profile=<cpu, wall, alloc or lock>
mặc định: xem nội dung mô tả- Ghi hồ sơ Trình ghi chuyến bay Java trong thời gian thực thi lệnh. Bạn phải cung cấp một trong các loại sự kiện phân tích tài nguyên được hỗ trợ (cpu, wall, alloc hoặc lock) dưới dạng đối số. Hồ sơ được ghi vào một tệp được đặt tên theo loại sự kiện trong thư mục cơ sở đầu ra. Cú pháp và ngữ nghĩa của cờ này có thể thay đổi trong tương lai để hỗ trợ thêm các loại hồ sơ hoặc định dạng đầu ra; bạn tự chịu rủi ro khi sử dụng.
- Giá trị mặc định của
--[no]experimental_record_metrics_for_all_mnemonics
: "false" - Theo mặc định, số lượng loại thao tác được giới hạn ở 20 câu thần chú có số lượng thao tác được thực thi nhiều nhất. Việc đặt tuỳ chọn này sẽ ghi số liệu thống kê cho tất cả các câu thần chú.
--experimental_repository_resolved_file=<a string>
mặc định: ""- Nếu không trống, hãy ghi một giá trị Starlark có thông tin đã phân giải của tất cả các quy tắc kho lưu trữ Starlark đã được thực thi.
Thẻ:affects_outputs
- Các tuỳ chọn chỉ định hoặc thay đổi dữ liệu đầu vào chung cho một lệnh Bazel không thuộc các danh mục khác.:
--experimental_resolved_file_instead_of_workspace=<a string>
mặc định: ""- Nếu không trống, hãy đọc tệp đã phân giải được chỉ định thay vì tệp WORKSPACE
Thẻ:changes_inputs
- Các tuỳ chọn thực thi và lưu vào bộ nhớ đệm từ xa:
--experimental_downloader_config=<a string>
mặc định: xem nội dung mô tả- Chỉ định một tệp để định cấu hình trình tải xuống từ xa. Tệp này bao gồm các dòng, mỗi dòng bắt đầu bằng một lệnh (`allow`, `block` hoặc `rewrite`), theo sau là tên máy chủ lưu trữ (đối với lệnh `allow` và `block`) hoặc hai mẫu, một mẫu để so khớp và một mẫu để sử dụng làm URL thay thế, với các tệp tham chiếu ngược bắt đầu từ `$1`. Bạn có thể cung cấp nhiều lệnh `rewrite` cho cùng một URL và trong trường hợp này, nhiều URL sẽ được trả về.
- Giá trị mặc định của
--experimental_worker_for_repo_fetching=<off, platform, virtual or auto>
: "tự động" - Chế độ tạo luồng để tìm nạp kho lưu trữ. Nếu bạn đặt thành "tắt", thì không có luồng worker nào được sử dụng và quá trình tìm nạp kho lưu trữ sẽ phải khởi động lại. Nếu không, hãy sử dụng luồng worker ảo.
- Các tuỳ chọn khác, không được phân loại theo cách khác.:
--deleted_packages=<comma-separated list of package names>
nhiều lần sử dụng được tích luỹ- Danh sách tên gói được phân tách bằng dấu phẩy mà hệ thống xây dựng sẽ coi là không tồn tại, ngay cả khi các gói đó xuất hiện ở đâu đó trên đường dẫn gói. Sử dụng tuỳ chọn này khi xoá một gói con "x/y" của một gói hiện có "x". Ví dụ: sau khi xoá x/y/BUILD trong ứng dụng, hệ thống xây dựng có thể khiếu nại nếu gặp nhãn "//x:y/z" nếu nhãn đó vẫn được cung cấp bởi một mục package_path khác. Bạn có thể chỉ định --deleted_packages x/y để tránh vấn đề này.
- Giá trị mặc định của
--[no]fetch
: "true" - Cho phép lệnh tìm nạp các phần phụ thuộc bên ngoài. Nếu bạn đặt thành false, lệnh sẽ sử dụng bất kỳ phiên bản nào của phần phụ thuộc được lưu vào bộ nhớ đệm và nếu không có phiên bản nào, lệnh sẽ không thành công.
--override_repository=<an equals-separated mapping of repository name to path>
nhiều lần sử dụng được tích luỹ- Ghi đè kho lưu trữ bằng một đường dẫn cục bộ ở dạng <repository name>=<path>. Nếu đường dẫn đã cho là đường dẫn tuyệt đối, thì đường dẫn đó sẽ được sử dụng nguyên trạng. Nếu đường dẫn đã cho là đường dẫn tương đối, thì đường dẫn đó sẽ tương ứng với thư mục đang hoạt động. Nếu đường dẫn đã cho bắt đầu bằng "%workspace%", thì đường dẫn đó sẽ tương ứng với thư mục gốc của không gian làm việc, là kết quả của lệnh "bazel info workspace". Nếu đường dẫn đã cho trống, hãy xoá mọi chế độ ghi đè trước đó.
--package_path=<colon-separated list of options>
mặc định: "%workspace%"- Danh sách được phân tách bằng dấu hai chấm về nơi tìm kiếm các gói. Các phần tử bắt đầu bằng "%workspace%" có liên quan đến không gian làm việc bao quanh. Nếu bạn bỏ qua hoặc để trống, giá trị mặc định sẽ là kết quả của lệnh "bazel info default-package-path".
- Giá trị mặc định của
--[no]show_loading_progress
: "true" - Nếu được bật, sẽ khiến Bazel in thông báo "Loading package" ("Đang tải gói").
- Các tuỳ chọn kiểm soát quá trình thực thi bản dựng:
- Giá trị mặc định của
--[no]all
: "false" -
Tìm nạp tất cả kho lưu trữ bên ngoài cần thiết để tạo bất kỳ mục tiêu hoặc kho lưu trữ nào. Đây là giá trị mặc định nếu không có cờ và đối số nào khác được cung cấp. Chỉ hoạt động khi --enable_bzlmod đang bật.
Thẻ:changes_inputs
- Giá trị mặc định của
--[no]experimental_inprocess_symlink_creation
: "false" -
Liệu có thực hiện lệnh gọi hệ thống tệp trực tiếp để tạo cây đường liên kết tượng trưng hay không
Thẻ:loading_and_analysis
,execution
,experimental
- Giá trị mặc định của
--[no]experimental_persistent_aar_extractor
: "false" -
Bật trình trích xuất aar liên tục bằng cách sử dụng worker.
Thẻ:execution
- Giá trị mặc định của
--[no]experimental_remotable_source_manifests
: "false" -
Liệu có nên thực hiện các thao tác trong tệp kê khai nguồn từ xa hay không
Thẻ:loading_and_analysis
,execution
,experimental
- Giá trị mặc định của
--[no]experimental_split_coverage_postprocessing
: "false" - Nếu đúng, Bazel sẽ chạy quy trình xử lý sau khi kiểm thử để kiểm thử trong một quá trình tạo mới.
Thẻ:execution
- Giá trị mặc định của
--[no]experimental_strict_fileset_output
: "false" - Nếu bạn bật tuỳ chọn này, các tập hợp tệp sẽ coi tất cả cấu phần phần mềm đầu ra là tệp thông thường. Các tệp này sẽ không duyệt qua các thư mục hoặc nhạy cảm với các đường liên kết tượng trưng.
Thẻ:execution
- Giá trị mặc định của
--[no]incompatible_disallow_unsound_directory_outputs
: "true" - Nếu được đặt, thao tác hiện thực hoá tệp đầu ra dưới dạng thư mục sẽ gây ra lỗi. Không ảnh hưởng đến thư mục nguồn. Xem https://github.com/bazelbuild/bazel/issues/18646.
Thẻ:bazel_internal_configuration
,incompatible_change
- Giá trị mặc định của
--[no]incompatible_modify_execution_info_additive
: "false" -
Khi được bật, việc truyền nhiều cờ --modify_execution_info sẽ có tính chất cộng gộp. Khi bị tắt, hệ thống sẽ chỉ xem xét cờ gần đây nhất.
Thẻ:execution
,affects_outputs
,loading_and_analysis
,incompatible_change
--[no]keep_going
[-k
] mặc định: "false"-
Tiếp tục nhiều nhất có thể sau khi xảy ra lỗi. Mặc dù không thể phân tích mục tiêu không thành công và các mục tiêu phụ thuộc vào mục tiêu đó, nhưng bạn có thể phân tích các điều kiện tiên quyết khác của các mục tiêu này.
Thẻ:eagerness_to_exit
- Giá trị mặc định của
--loading_phase_threads=<an integer, or a keyword ("auto", "HOST_CPUS", "HOST_RAM"), optionally followed by an operation ([-|*]<float>) eg. "auto", "HOST_CPUS*.5">
: "tự động" - Số luồng song song cần sử dụng cho giai đoạn tải/phân tích. Nhận một số nguyên hoặc từ khoá ("tự động", "HOST_CPUS", "HOST_RAM"), theo sau có thể là một phép toán ([-|*]<float>) ví dụ: "tự động", "HOST_CPUS*.5". "tự động" đặt giá trị mặc định hợp lý dựa trên tài nguyên của máy chủ lưu trữ. Phải ít nhất là 1.
Thẻ:bazel_internal_configuration
--modify_execution_info=<regex=[+-]key,regex=[+-]key,...>
nhiều lần sử dụng được tích luỹ-
Thêm hoặc xoá các khoá khỏi thông tin thực thi của một hành động dựa trên câu thần chú hành động. Chỉ áp dụng cho các hành động hỗ trợ thông tin thực thi. Nhiều hành động phổ biến hỗ trợ thông tin thực thi, ví dụ: Genrule, CppCompile, Javac, StarlarkAction, TestRunner. Khi chỉ định nhiều giá trị, thứ tự sẽ rất quan trọng vì nhiều biểu thức chính quy có thể áp dụng cho cùng một câu thần chú.
Cú pháp: "regex=[+-]key,regex=[+-]key,...".
Ví dụ: ".*=+x,.*=-y,.*=+z" sẽ thêm "x" và "z" vào, đồng thời xoá "y" khỏi thông tin thực thi cho tất cả các hành động.
"Genrule=+requires-x" sẽ thêm "requires-x" vào thông tin thực thi cho tất cả các hành động Genrule.
"(?!Genrule).*=-requires-x" xoá "requires-x" khỏi thông tin thực thi cho tất cả các hành động không phải Genrule.
Thẻ:execution
,affects_outputs
,loading_and_analysis
--persistent_android_dex_desugar
-
Bật các thao tác dex và đơn giản hoá Android liên tục bằng cách sử dụng worker.
Mở rộng thành:
--internal_persistent_android_dex_desugar
--strategy=Desugar=worker
--strategy=DexBuilder=worker
Thẻ:host_machine_resource_optimizations
,execution
--persistent_android_resource_processor
- Bật trình xử lý tài nguyên Android liên tục bằng cách sử dụng worker.
Mở rộng thành:
--internal_persistent_busybox_tools
--strategy=AaptPackage=worker
--strategy=AndroidResourceParser=worker
--strategy=AndroidResourceValidator=worker
--strategy=AndroidResourceCompiler=worker
--strategy=RClassGenerator=worker
--strategy=AndroidResourceLink=worker
--strategy=AndroidAapt2=worker
--strategy=AndroidAssetMerger=worker
--strategy=AndroidResourceMerger=worker
--strategy=AndroidCompiledResourceMerger=worker
--strategy=ManifestMerger=worker
--strategy=AndroidManifestMerger=worker
--strategy=Aapt2Optimize=worker
--strategy=AARGenerator=worker
--strategy=ProcessDatabinding=worker
--strategy=GenerateDataBindingBaseClasses=worker
Thẻ:host_machine_resource_optimizations
,execution
--persistent_multiplex_android_dex_desugar
-
Bật các thao tác dex và đơn giản hoá Android được đa kênh liên tục bằng cách sử dụng worker.
Mở rộng thành:
--persistent_android_dex_desugar
--internal_persistent_multiplex_android_dex_desugar
Thẻ:host_machine_resource_optimizations
,execution
--persistent_multiplex_android_resource_processor
-
Bật trình xử lý tài nguyên Android được đa kênh liên tục bằng cách sử dụng worker.
Mở rộng thành:
--persistent_android_resource_processor
--modify_execution_info=AaptPackage=+supports-multiplex-workers
--modify_execution_info=AndroidResourceParser=+supports-multiplex-workers
--modify_execution_info=AndroidResourceValidator=+supports-multiplex-workers
--modify_execution_info=AndroidResourceCompiler=+supports-multiplex-workers
--modify_execution_info=RClassGenerator=+supports-multiplex-workers
--modify_execution_info=AndroidResourceLink=+supports-multiplex-workers
--modify_execution_info=AndroidAapt2=+supports-multiplex-workers
--modify_execution_info=AndroidAssetMerger=+supports-multiplex-workers
--modify_execution_info=AndroidResourceMerger=+supports-multiplex-workers
--modify_execution_info=AndroidCompiledResourceMerger=+supports-multiplex-workers
--modify_execution_info=ManifestMerger=+supports-multiplex-workers
--modify_execution_info=AndroidManifestMerger=+supports-multiplex-workers
--modify_execution_info=Aapt2Optimize=+supports-multiplex-workers
--modify_execution_info=AARGenerator=+supports-multiplex-workers
Thẻ:host_machine_resource_optimizations
,execution
--persistent_multiplex_android_tools
- Bật các công cụ Android liên tục và đa kênh (dexing, desugaring, xử lý tài nguyên).
Mở rộng thành:
--internal_persistent_multiplex_busybox_tools
--persistent_multiplex_android_resource_processor
--persistent_multiplex_android_dex_desugar
Thẻ:host_machine_resource_optimizations
,execution
- Giá trị mặc định của
--[no]use_target_platform_for_tests
: "false" - Nếu đúng, Bazel sẽ sử dụng nền tảng mục tiêu để chạy kiểm thử thay vì nhóm thực thi kiểm thử.
Thẻ:execution
- Các tuỳ chọn định cấu hình chuỗi công cụ dùng để thực thi hành động:
--android_compiler=<a string>
mặc định: xem nội dung mô tả-
Trình biên dịch mục tiêu Android.
Thẻ:affects_outputs
,loading_and_analysis
,loses_incremental_state
--android_crosstool_top=<a build target label>
mặc định: "//external:android/crosstool"-
Vị trí của trình biên dịch C++ dùng cho các bản dựng Android.
Thẻ:affects_outputs
,changes_inputs
,loading_and_analysis
,loses_incremental_state
--android_grte_top=<a label>
mặc định: xem nội dung mô tả-
Mục tiêu Android grte_top.
Thẻ:changes_inputs
,loading_and_analysis
,loses_incremental_state
--android_manifest_merger=<legacy, android or force_android>
mặc định: "android"-
Chọn trình hợp nhất tệp kê khai để sử dụng cho các quy tắc android_binary. Cờ để giúp chuyển đổi sang trình hợp nhất tệp kê khai Android từ trình hợp nhất cũ.
Thẻ:affects_outputs
,loading_and_analysis
,loses_incremental_state
--android_platforms=<a build target label>
mặc định: ""-
Đặt các nền tảng mà mục tiêu android_binary sử dụng. Nếu bạn chỉ định nhiều nền tảng, thì tệp nhị phân sẽ là tệp APK lớn, chứa các tệp nhị phân gốc cho từng nền tảng mục tiêu được chỉ định.
Thẻ:changes_inputs
,loading_and_analysis
,loses_incremental_state
--android_sdk=<a build target label>
mặc định: "@bazel_tools//tools/android:sdk"- Chỉ định SDK/nền tảng Android dùng để tạo ứng dụng Android.
Thẻ:changes_inputs
,loading_and_analysis
,loses_incremental_state
--apple_crosstool_top=<a build target label>
mặc định: "@bazel_tools//tools/cpp:toolchain"-
Nhãn của gói công cụ đa nền tảng sẽ được dùng trong các quy tắc của Apple và Objc cũng như các phần phụ thuộc của các quy tắc đó.
Thẻ:loses_incremental_state
,changes_inputs
--cc_output_directory_tag=<a string>
mặc định: ""- Chỉ định hậu tố cần thêm vào thư mục cấu hình.
Thẻ:affects_outputs
--compiler=<a string>
mặc định: xem nội dung mô tả-
Trình biên dịch C++ dùng để biên dịch mục tiêu.
Thẻ:loading_and_analysis
,execution
--coverage_output_generator=<a build target label>
mặc định: "@bazel_tools//tools/test:lcov_merger"-
Vị trí của tệp nhị phân dùng để xử lý sau các báo cáo phạm vi thô. Hiện tại, đây phải là một nhóm tệp chứa một tệp duy nhất, tệp nhị phân. Giá trị mặc định là "//tools/test:lcov_merger".
Thẻ:changes_inputs
,affects_outputs
,loading_and_analysis
--coverage_report_generator=<a build target label>
mặc định: "@bazel_tools//tools/test:coverage_report_generator"-
Vị trí của tệp nhị phân dùng để tạo báo cáo mức độ sử dụng. Hiện tại, đây phải là một nhóm tệp chứa một tệp duy nhất, tệp nhị phân. Giá trị mặc định là "//tools/test:coverage_report_generator".
Thẻ:changes_inputs
,affects_outputs
,loading_and_analysis
--coverage_support=<a build target label>
mặc định: "@bazel_tools//tools/test:coverage_support"-
Vị trí của các tệp hỗ trợ bắt buộc trên dữ liệu đầu vào của mọi hành động kiểm thử thu thập mức độ sử dụng mã. Giá trị mặc định là "//tools/test:coverage_support".
Thẻ:changes_inputs
,affects_outputs
,loading_and_analysis
--crosstool_top=<a build target label>
mặc định: "@bazel_tools//tools/cpp:toolchain"-
Nhãn của gói công cụ đa nền tảng dùng để biên dịch mã C++.
Thẻ:loading_and_analysis
,changes_inputs
,affects_outputs
--custom_malloc=<a build target label>
mặc định: xem nội dung mô tả-
Chỉ định cách triển khai malloc tuỳ chỉnh. Chế độ cài đặt này sẽ ghi đè các thuộc tính malloc trong quy tắc bản dựng.
Thẻ:changes_inputs
,affects_outputs
--experimental_add_exec_constraints_to_targets=<a '<RegexFilter>=<label1>[,<label2>,...]' assignment>
nhiều lần sử dụng được tích luỹ-
Danh sách biểu thức chính quy được phân tách bằng dấu phẩy, mỗi biểu thức có thể có tiền tố là - (biểu thức phủ định), được gán (=) cho danh sách các mục tiêu giá trị quy tắc ràng buộc được phân tách bằng dấu phẩy. Nếu một mục tiêu không khớp với biểu thức âm và ít nhất một biểu thức dương, thì độ phân giải chuỗi công cụ của mục tiêu đó sẽ được thực hiện như thể mục tiêu đó đã khai báo các giá trị ràng buộc dưới dạng các ràng buộc thực thi. Ví dụ: //demo,-test=@platforms//cpus:x86_64 sẽ thêm "x86_64" vào bất kỳ mục tiêu nào trong //demo, ngoại trừ những mục tiêu có tên chứa "test".
Thẻ:loading_and_analysis
- Giá trị mặc định của
--[no]experimental_include_xcode_execution_requirements
: "false" - Nếu bạn đặt, hãy thêm yêu cầu thực thi "requires-xcode:{version}" vào mọi thao tác Xcode. Nếu phiên bản xcode có nhãn được nối bằng dấu gạch nối, hãy thêm yêu cầu thực thi "requires-xcode-label:{version_label}".
Thẻ:loses_incremental_state
,loading_and_analysis
,execution
- Giá trị mặc định của
--[no]experimental_prefer_mutual_xcode
: "true" - Nếu đúng, hãy sử dụng Xcode mới nhất có sẵn cả cục bộ và từ xa. Nếu giá trị là false hoặc nếu không có phiên bản nào có sẵn, hãy sử dụng phiên bản Xcode cục bộ được chọn thông qua xcode-select.
Thẻ:loses_incremental_state
--extra_execution_platforms=<comma-separated list of options>
mặc định: ""-
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(). Bạn chỉ có thể đặt tuỳ chọn này một lần; các thực thể sau đó sẽ ghi đè các chế độ cài đặt cờ trước đó.
Thẻ:execution
--extra_toolchains=<comma-separated list of options>
nhiều lần sử dụng được tích luỹ-
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 những chuỗi công cụ được khai báo trong tệp WORKSPACE bằng register_toolchains().
Thẻ:affects_outputs
,changes_inputs
,loading_and_analysis
--grte_top=<a label>
mặc định: xem nội dung mô tả-
Nhãn cho thư viện libc đã kiểm tra. Giá trị mặc định được chuỗi công cụ crosstool chọn và bạn hầu như không bao giờ cần ghi đè giá trị này.
Thẻ:action_command_lines
,affects_outputs
--host_compiler=<a string>
mặc định: xem nội dung mô tả-
Trình biên dịch C++ để sử dụng cho quá trình biên dịch máy chủ lưu trữ. Giá trị này sẽ bị bỏ qua nếu bạn không đặt --host_crosstool_top.
Thẻ:loading_and_analysis
,execution
--host_crosstool_top=<a build target label>
mặc định: xem nội dung mô tả- Theo mặc định, các tuỳ chọn --crosstool_top và --compiler cũng được dùng cho cấu hình exec. Nếu bạn cung cấp cờ này, Bazel sẽ sử dụng libc và trình biên dịch mặc định cho crosstool_top đã cho.
Thẻ:loading_and_analysis
,changes_inputs
,affects_outputs
--host_grte_top=<a label>
mặc định: xem nội dung mô tả- Nếu được chỉ định, chế độ cài đặt này sẽ ghi đè thư mục cấp cao nhất libc (--grte_top) cho cấu hình thực thi.
Thẻ:action_command_lines
,affects_outputs
--host_platform=<a build target label>
mặc định: "@bazel_tools//tools:host_platform"-
Nhãn của quy tắc nền tảng mô tả hệ thống lưu trữ.
Thẻ:affects_outputs
,changes_inputs
,loading_and_analysis
- Giá trị mặc định của
--[no]incompatible_dont_enable_host_nonhost_crosstool_features
: "true" - Nếu đúng, Bazel sẽ không bật các tính năng "máy chủ" và "không phải máy chủ" trong chuỗi công cụ c++ (xem https://github.com/bazelbuild/bazel/issues/7407 để biết thêm thông tin).
Thẻ:loading_and_analysis
,incompatible_change
- Giá trị mặc định của
--[no]incompatible_enable_android_toolchain_resolution
: "true" -
Sử dụng độ phân giải chuỗi công cụ để chọn SDK Android cho các quy tắc Android (Starlark và gốc)
Thẻ:loading_and_analysis
,incompatible_change
- Giá trị mặc định của
--[no]incompatible_enable_apple_toolchain_resolution
: "false" -
Sử dụng độ phân giải chuỗi công cụ để chọn SDK Apple cho các quy tắc của Apple (Starlark và gốc)
Thẻ:loading_and_analysis
,incompatible_change
- Giá trị mặc định của
--[no]incompatible_make_thinlto_command_lines_standalone
: "true" - Nếu đúng, Bazel sẽ không sử dụng lại các dòng lệnh thao tác liên kết C++ cho các dòng lệnh lập chỉ mục lto (xem https://github.com/bazelbuild/bazel/issues/6791 để biết thêm thông tin).
Thẻ:loading_and_analysis
,incompatible_change
- Giá trị mặc định của
--[no]incompatible_remove_legacy_whole_archive
: "true" - Nếu đúng, theo mặc định, Bazel sẽ không liên kết các phần phụ thuộc thư viện dưới dạng toàn bộ bản lưu trữ (xem https://github.com/bazelbuild/bazel/issues/7362 để biết hướng dẫn di chuyển).
Thẻ:loading_and_analysis
,incompatible_change
- Giá trị mặc định của
--[no]incompatible_require_ctx_in_configure_features
: "true" - Nếu đúng, Bazel sẽ yêu cầu tham số "ctx" trong cc_common.configure_features (xem https://github.com/bazelbuild/bazel/issues/7793 để biết thêm thông tin).
Thẻ:loading_and_analysis
,incompatible_change
- Sử dụng đối tượng dùng chung giao diện nếu chuỗi công cụ hỗ trợ. Tất cả chuỗi công cụ ELF hiện đều hỗ trợ chế độ cài đặt này.
Thẻ:loading_and_analysis
,affects_outputs
,affects_outputs
--ios_sdk_version=<a dotted version (for example '2.3' or '3.3alpha2.4')>
mặc định: xem nội dung mô tả-
Chỉ định phiên bản SDK iOS để sử dụng nhằm xây dựng ứng dụng iOS. Nếu không chỉ định, hãy sử dụng phiên bản SDK iOS mặc định từ "xcode_version".
Thẻ:loses_incremental_state
--macos_sdk_version=<a dotted version (for example '2.3' or '3.3alpha2.4')>
mặc định: xem nội dung mô tả-
Chỉ định phiên bản SDK macOS để sử dụng nhằm tạo ứng dụng macOS. Nếu không chỉ định, sẽ sử dụng phiên bản SDK macOS mặc định từ "xcode_version".
Thẻ:loses_incremental_state
--minimum_os_version=<a string>
mặc định: xem nội dung mô tả- Phiên bản hệ điều hành tối thiểu mà mục tiêu biên dịch của bạn nhắm đến.
Thẻ:loading_and_analysis
,affects_outputs
--platform_mappings=<a relative path>
mặc định: ""-
Vị trí của tệp ánh xạ mô tả nền tảng nào sẽ sử dụng nếu không có nền tảng nào được đặt hoặc cờ nào sẽ được đặt khi nền tảng đã tồn tại. Phải tương ứng với thư mục gốc của không gian làm việc chính. Mặc định là "platform_mappings" (một tệp nằm ngay trong thư mục gốc của không gian làm việc).
Thẻ:affects_outputs
,changes_inputs
,loading_and_analysis
--platforms=<a build target label>
mặc định: ""-
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.
Thẻ:affects_outputs
,changes_inputs
,loading_and_analysis
--python2_path=<a string>
mặc định: xem nội dung mô tả-
Không dùng nữa, không hoạt động. Tắt bằng `--incompatible_use_python_toolchains`.
Thẻ:no_op
,deprecated
--python3_path=<a string>
mặc định: xem nội dung mô tả-
Không dùng nữa, không hoạt động. Tắt bằng `--incompatible_use_python_toolchains`.
Thẻ:no_op
,deprecated
--python_path=<a string>
mặc định: xem nội dung mô tả-
Đường dẫn tuyệt đối của trình thông dịch Python được gọi để chạy các mục tiêu Python trên nền tảng mục tiêu. Không dùng nữa; bị vô hiệu hoá bằng --incompatible_use_python_toolchains.
Thẻ:loading_and_analysis
,affects_outputs
--python_top=<a build target label>
mặc định: xem nội dung mô tả-
Nhãn của py_runtime đại diện cho trình thông dịch Python được gọi để chạy các mục tiêu Python trên nền tảng mục tiêu. Không dùng nữa; bị vô hiệu hoá bằng --incompatible_use_python_toolchains.
Thẻ:loading_and_analysis
,affects_outputs
--tvos_sdk_version=<a dotted version (for example '2.3' or '3.3alpha2.4')>
mặc định: xem nội dung mô tả-
Chỉ định phiên bản SDK tvOS để sử dụng nhằm xây dựng ứng dụng tvOS. Nếu không chỉ định, hãy sử dụng phiên bản SDK tvOS mặc định từ "xcode_version".
Thẻ:loses_incremental_state
--watchos_sdk_version=<a dotted version (for example '2.3' or '3.3alpha2.4')>
mặc định: xem nội dung mô tả- Chỉ định phiên bản SDK watchOS để sử dụng nhằm xây dựng ứng dụng watchOS. Nếu không chỉ định, hãy sử dụng phiên bản SDK watchOS mặc định từ "xcode_version".
Thẻ:loses_incremental_state
--xcode_version=<a string>
mặc định: xem nội dung mô tả- Nếu được chỉ định, hãy sử dụng Xcode của phiên bản đã cho cho các thao tác bản dựng có liên quan. Nếu không chỉ định, hãy sử dụng phiên bản trình thực thi mặc định của Xcode.
Thẻ:loses_incremental_state
--xcode_version_config=<a build target label>
mặc định: "@bazel_tools//tools/cpp:host_xcodes"-
Nhãn của quy tắc xcode_config dùng để chọn phiên bản Xcode trong cấu hình bản dựng.
Thẻ:loses_incremental_state
,loading_and_analysis
- Các tuỳ chọn kiểm soát đầu ra của lệnh:
- Giá trị mặc định của
--[no]apple_generate_dsym
: "false" -
Liệu có tạo (các) tệp biểu tượng gỡ lỗi (.dSYM) hay không.
Thẻ:affects_outputs
,action_command_lines
- Giá trị mặc định của
--[no]build_runfile_links
: "true" - Nếu đúng, hãy tạo rừng đường liên kết tượng trưng cho tệp chạy cho tất cả các mục tiêu. Nếu giá trị là false, chỉ ghi các tệp này khi một hành động cục bộ, lệnh kiểm thử hoặc chạy yêu cầu.
Thẻ:affects_outputs
- Giá trị mặc định của
--[no]build_runfile_manifests
: "true" - Nếu đúng, hãy ghi tệp kê khai tệp chạy cho tất cả các mục tiêu. Nếu sai, hãy bỏ qua các giá trị này. Các kiểm thử cục bộ sẽ không chạy được khi giá trị là false.
Thẻ:affects_outputs
- Giá trị mặc định của
--[no]build_test_dwp
: "false" - Nếu được bật, khi tạo các chương trình kiểm thử C++ một cách tĩnh và có tính năng phân tách, tệp .dwp cho tệp nhị phân kiểm thử cũng sẽ được tạo tự động.
Thẻ:loading_and_analysis
,affects_outputs
--cc_proto_library_header_suffixes=<comma-separated set of options>
mặc định: ".pb.h"- Đặt hậu tố của các tệp tiêu đề mà cc_proto_library tạo.
Thẻ:affects_outputs
,loading_and_analysis
--cc_proto_library_source_suffixes=<comma-separated set of options>
mặc định: ".pb.cc"-
Đặt hậu tố của các tệp nguồn mà cc_proto_library tạo.
Thẻ:affects_outputs
,loading_and_analysis
- Giá trị mặc định của
--[no]experimental_proto_descriptor_sets_include_source_info
: "false" -
Chạy các thao tác bổ sung cho các phiên bản API Java thay thế trong proto_library.
Thẻ:affects_outputs
,loading_and_analysis
,experimental
- Giá trị mặc định của
--[no]experimental_proto_extra_actions
: "false" -
Chạy các thao tác bổ sung cho các phiên bản API Java thay thế trong proto_library.
Thẻ:affects_outputs
,loading_and_analysis
,experimental
- Giá trị mặc định của
--[no]experimental_save_feature_state
: "false" -
Lưu trạng thái của các tính năng đã bật và được yêu cầu dưới dạng kết quả biên dịch.
Thẻ:affects_outputs
,experimental
--fission=<a set of compilation modes>
mặc định: "no"- Chỉ định chế độ biên dịch nào sử dụng tính năng phân hạch cho các bản biên dịch và đường liên kết C++. Có thể là bất kỳ tổ hợp nào của {'fastbuild', 'dbg', 'opt'} hoặc các giá trị đặc biệt "yes" để bật tất cả chế độ và "no" để tắt tất cả chế độ.
Thẻ:loading_and_analysis
,action_command_lines
,affects_outputs
- Giá trị mặc định của
--[no]incompatible_always_include_files_in_data
: "true" - Nếu đúng, các quy tắc gốc sẽ thêm <code>DefaultInfo.files</code> của các phần phụ thuộc dữ liệu vào tệp chạy của chúng, khớp với hành vi được đề xuất cho các quy tắc Starlark (https://bazel.build/extending/rules#runfiles_features_to_avoid).
Thẻ:affects_outputs
,incompatible_change
- Giá trị mặc định của
--[no]legacy_external_runfiles
: "true" - Nếu đúng, hãy tạo rừng đường liên kết tượng trưng cho tệp chạy cho các kho lưu trữ bên ngoài trong .runfiles/wsname/external/repo (ngoài .runfiles/repo).
Thẻ:affects_outputs
- Giá trị mặc định của
--[no]objc_generate_linkmap
: "false" -
Chỉ định xem có tạo tệp liên kết hay không.
Thẻ:affects_outputs
- Giá trị mặc định của
--[no]save_temps
: "false" - Nếu được đặt, kết quả tạm thời từ gcc sẽ được lưu. Các tệp này bao gồm tệp .s (mã tập hợp), tệp .i (C được xử lý trước) và tệp .ii (C++ được xử lý trước).
Thẻ:affects_outputs
- Các tuỳ chọn cho phép người dùng định cấu hình đầu ra dự kiến, ảnh hưởng đến giá trị của đầu ra đó, thay vì sự tồn tại của đầu ra:
--action_env=<a 'name=value' assignment with an optional value part>
nhiều lần sử dụng được tích luỹ-
Chỉ định tập hợp các biến môi trường có sẵn cho các hành động có cấu hình mục tiêu. Bạn có thể chỉ định biến theo tên, trong trường hợp này giá trị sẽ được lấy từ môi trường gọi, hoặc theo cặp name=value để đặt giá trị độc lập với môi trường gọi. Bạn có thể sử dụng tuỳ chọn này nhiều lần; đối với các tuỳ chọn được đưa ra cho cùng một biến, tuỳ chọn mới nhất sẽ thắng, còn các tuỳ chọn cho các biến khác nhau sẽ được tích luỹ.
Thẻ:action_command_lines
--android_cpu=<a string>
mặc định: "armeabi-v7a"- CPU mục tiêu của Android.
Thẻ:affects_outputs
,loading_and_analysis
,loses_incremental_state
- Giá trị mặc định của
--[no]android_databinding_use_androidx
: "true" - Tạo các tệp liên kết dữ liệu tương thích với AndroidX. Phương thức này chỉ được dùng với databinding v2. Cờ này không có tác dụng.
Thẻ:affects_outputs
,loading_and_analysis
,loses_incremental_state
,experimental
- Giá trị mặc định của
--[no]android_databinding_use_v3_4_args
: "true" -
Sử dụng android databinding v2 với đối số 3.4.0. Cờ này không có tác dụng.
Thẻ:affects_outputs
,loading_and_analysis
,loses_incremental_state
,experimental
--android_dynamic_mode=<off, default or fully>
mặc định: "off"- xác định xem các phần phụ thuộc C++ của quy tắc Android có được liên kết động khi cc_binary không tạo thư viện dùng chung một cách rõ ràng hay không. "mặc định" có nghĩa là bazel sẽ chọn xem có liên kết động hay không. "đầy đủ" có nghĩa là tất cả thư viện sẽ được liên kết động. "tắt" có nghĩa là tất cả thư viện sẽ được liên kết chủ yếu ở chế độ tĩnh.
Thẻ:affects_outputs
,loading_and_analysis
--android_manifest_merger_order=<alphabetical, alphabetical_by_configuration or dependency>
mặc định: "alphabetical"-
Đặt thứ tự của tệp kê khai được chuyển đến trình sáp nhập tệp kê khai cho tệp nhị phân Android. ALPHABETICAL (TĂNG DẦN) nghĩa là tệp kê khai được sắp xếp theo đường dẫn tương ứng với execroot. ALPHABETICAL_BY_CONFIGURATION có nghĩa là tệp kê khai được sắp xếp theo đường dẫn tương ứng với thư mục cấu hình trong thư mục đầu ra. DEPENDENCY (PHẦN PHỤ THUỘC) có nghĩa là tệp kê khai được sắp xếp theo thứ tự tệp kê khai của mỗi thư viện đứng trước tệp kê khai của các phần phụ thuộc.
Thẻ:action_command_lines
,execution
- Giá trị mặc định của
--[no]android_resource_shrinking
: "false" - Bật tính năng rút gọn tài nguyên cho các tệp APK android_binary sử dụng ProGuard.
Thẻ:affects_outputs
,loading_and_analysis
- Giá trị mặc định của
--[no]build_python_zip
: "tự động" -
Tạo tệp zip có thể thực thi python; bật trên Windows, tắt trên các nền tảng khác
Thẻ:affects_outputs
--catalyst_cpus=<comma-separated list of options>
nhiều lần sử dụng được tích luỹ-
Danh sách các cấu trúc được phân tách bằng dấu phẩy để tạo tệp nhị phân Apple Catalyst.
Thẻ:loses_incremental_state
,loading_and_analysis
- Giá trị mặc định của
--[no]collect_code_coverage
: "false" - Nếu được chỉ định, Bazel sẽ đo lường mã (sử dụng công cụ đo lường ngoại tuyến nếu có thể) và sẽ thu thập thông tin về mức độ sử dụng trong quá trình kiểm thử. Chỉ những mục tiêu khớp với --instrumentation_filter mới bị ảnh hưởng. Thông thường, bạn không nên chỉ định trực tiếp tuỳ chọn này – thay vào đó, hãy sử dụng lệnh "bazel coverage".
Thẻ:affects_outputs
--compilation_mode=<fastbuild, dbg or opt>
[-c
] mặc định: "fastbuild"-
Chỉ định chế độ mà tệp nhị phân sẽ được tạo. Giá trị: "fastbuild", "dbg", "opt".
Thẻ:affects_outputs
,action_command_lines
--conlyopt=<a string>
nhiều lần sử dụng được tích luỹ- Tuỳ chọn bổ sung để truyền đến gcc khi biên dịch tệp nguồn C.
Thẻ:action_command_lines
,affects_outputs
--copt=<a string>
nhiều lần sử dụng được tích luỹ-
Các tuỳ chọn bổ sung để truyền đến gcc.
Thẻ:action_command_lines
,affects_outputs
--cpu=<a string>
mặc định: ""- CPU mục tiêu.
Thẻ:changes_inputs
,affects_outputs
--cs_fdo_absolute_path=<a string>
mặc định: xem nội dung mô tả-
Sử dụng thông tin hồ sơ CSFDO để tối ưu hoá quá trình biên dịch. Chỉ định tên đường dẫn tuyệt đối của tệp zip chứa tệp hồ sơ, tệp hồ sơ LLVM thô hoặc được lập chỉ mục.
Thẻ:affects_outputs
--cs_fdo_instrument=<a string>
mặc định: xem nội dung mô tả-
Tạo tệp nhị phân bằng khả năng đo lường FDO nhạy cảm với ngữ cảnh. Với trình biên dịch Clang/LLVM, trình biên dịch này cũng chấp nhận tên thư mục mà(các) tệp hồ sơ thô sẽ được kết xuất trong thời gian chạy.
Thẻ:affects_outputs
--cs_fdo_profile=<a build target label>
mặc định: xem nội dung mô tả-
cs_fdo_profile đại diện cho hồ sơ nhạy cảm theo ngữ cảnh sẽ được dùng để tối ưu hoá.
Thẻ:affects_outputs
--cxxopt=<a string>
nhiều lần sử dụng được tích luỹ- Tuỳ chọn bổ sung để truyền đến gcc khi biên dịch tệp nguồn C++.
Thẻ:action_command_lines
,affects_outputs
--define=<a 'name=value' assignment>
nhiều lần sử dụng được tích luỹ-
Mỗi tuỳ chọn --define chỉ định một giá trị gán cho một biến bản dựng.
Thẻ:changes_inputs
,affects_outputs
- Giá trị mặc định của
--dynamic_mode=<off, default or fully>
: "mặc định" - Xác định xem tệp nhị phân C++ có được liên kết động hay không. "mặc định" có nghĩa là Bazel sẽ chọn xem có liên kết động hay không. "đầy đủ" có nghĩa là tất cả thư viện sẽ được liên kết động. "tắt" có nghĩa là tất cả thư viện sẽ được liên kết chủ yếu ở chế độ tĩnh.
Thẻ:loading_and_analysis
,affects_outputs
- Giá trị mặc định của
--[no]enable_fdo_profile_absolute_path
: "true" - Nếu bạn đặt, việc sử dụng fdo_absolute_profile_path sẽ gây ra lỗi.
Thẻ:affects_outputs
- Giá trị mặc định của
--[no]enable_runfiles
: "tự động" - Bật cây đường liên kết tượng trưng của tệp chạy; Theo mặc định, tính năng này sẽ tắt trên Windows và trên các nền tảng khác.
Thẻ:affects_outputs
--experimental_action_listener=<a build target label>
nhiều lần sử dụng được tích luỹ- Ngừng sử dụng và thay bằng các khía cạnh. Sử dụng action_listener để đính kèm extra_action vào các hành động bản dựng hiện có.
Thẻ:execution
,experimental
- Giá trị mặc định của
--[no]experimental_android_compress_java_resources
: "false" -
Nén tài nguyên Java trong tệp APK
Thẻ:affects_outputs
,loading_and_analysis
,experimental
- Giá trị mặc định của
--[no]experimental_android_databinding_v2
: "true" -
Sử dụng android databinding v2. Cờ này không có tác dụng.
Thẻ:affects_outputs
,loading_and_analysis
,loses_incremental_state
,experimental
- Giá trị mặc định của
--[no]experimental_android_resource_shrinking
: "false" - Bật tính năng rút gọn tài nguyên cho các tệp APK android_binary sử dụng ProGuard.
Thẻ:affects_outputs
,loading_and_analysis
- Giá trị mặc định của
--[no]experimental_android_rewrite_dexes_with_rex
: "false" -
sử dụng công cụ rex để ghi lại các tệp dex
Thẻ:affects_outputs
,loading_and_analysis
,loses_incremental_state
,experimental
- Giá trị mặc định của
--[no]experimental_collect_code_coverage_for_generated_files
: "false" - Nếu được chỉ định, Bazel cũng sẽ tạo thông tin thu thập mức độ sử dụng cho các tệp đã tạo.
Thẻ:affects_outputs
--experimental_objc_fastbuild_options=<comma-separated list of options>
mặc định: "-O0,-DDEBUG=1"-
Sử dụng các chuỗi này làm tuỳ chọn trình biên dịch bản dựng nhanh objc.
Thẻ:action_command_lines
- Giá trị mặc định của
--[no]experimental_omitfp
: "false" - Nếu đúng, hãy sử dụng libunwind để gỡ bỏ ngăn xếp và biên dịch bằng -fomit-frame-pointer và -fasynchronous-unwind-tables.
Thẻ:action_command_lines
,affects_outputs
,experimental
--experimental_output_paths=<off, content or strip>
mặc định: "off"-
Mô hình nào sẽ được sử dụng cho vị trí trong quy tắc cây đầu ra ghi đầu ra của chúng, đặc biệt là đối với các bản dựng đa nền tảng / đa cấu hình. Đây là một tính năng thử nghiệm. Hãy xem https://github.com/bazelbuild/bazel/issues/6526 để biết thông tin chi tiết. Các hành động Starlark có thể chọn sử dụng tính năng liên kết đường dẫn bằng cách thêm khoá "supports-path-mapping" vào tập hợp "execution_requirements".
Thẻ:loses_incremental_state
,bazel_internal_configuration
,affects_outputs
,execution
--experimental_override_name_platform_in_output_dir=<a 'label=value' assignment>
nhiều lần sử dụng được tích luỹ-
Mỗi mục nhập phải có dạng label=value, trong đó label (nhãn) tham chiếu đến một nền tảng và value (giá trị) là tên ngắn mong muốn để sử dụng trong đường dẫn đầu ra. Chỉ được dùng khi --experimental_platform_in_output_dir là true. Có mức độ ưu tiên đặt tên cao nhất.
Thẻ:affects_outputs
,experimental
- Giá trị mặc định của
--[no]experimental_platform_in_output_dir
: "false" - Nếu đúng, tên ngắn cho nền tảng mục tiêu sẽ được dùng trong tên thư mục đầu ra thay vì CPU. Lược đồ chính xác là thử nghiệm và có thể thay đổi: Trước tiên, trong trường hợp hiếm hoi tuỳ chọn --platforms không có đúng một giá trị, thì một hàm băm của tuỳ chọn platforms sẽ được sử dụng. Tiếp theo, nếu bất kỳ tên ngắn nào cho nền tảng hiện tại được đăng ký bằng --experimental_override_name_platform_in_output_dir, thì tên ngắn đó sẽ được sử dụng. Sau đó, nếu bạn đặt --experimental_use_platforms_in_output_dir_legacy_heuristic, hãy sử dụng tên ngắn dựa trên Nhãn nền tảng hiện tại. Cuối cùng, hàm băm của tuỳ chọn nền tảng sẽ được dùng làm phương án cuối cùng.
Thẻ:affects_outputs
,experimental
- Giá trị mặc định của
--[no]experimental_use_llvm_covmap
: "false" - Nếu được chỉ định, Bazel sẽ tạo thông tin bản đồ mức độ sử dụng llvm-cov thay vì gcov khi bật collect_code_coverage.
Thẻ:changes_inputs
,affects_outputs
,loading_and_analysis
,experimental
- Giá trị mặc định của
--[no]experimental_use_platforms_in_output_dir_legacy_heuristic
: "true" -
Vui lòng chỉ sử dụng cờ này trong chiến lược di chuyển hoặc kiểm thử được đề xuất. Xin lưu ý rằng phương pháp phỏng đoán có những thiếu sót đã biết và bạn nên chuyển sang chỉ dựa vào --experimental_override_name_platform_in_output_dir.
Thẻ:affects_outputs
,experimental
--fat_apk_cpu=<comma-separated set of options>
mặc định: "armeabi-v7a"-
Việc đặt tuỳ chọn này sẽ bật các tệp APK lớn, chứa các tệp nhị phân gốc cho tất cả các cấu trúc mục tiêu được chỉ định, ví dụ: --fat_apk_cpu=x86,armeabi-v7a. Nếu bạn chỉ định cờ này, thì --android_cpu sẽ bị bỏ qua đối với các phần phụ thuộc của quy tắc android_binary.
Thẻ:affects_outputs
,loading_and_analysis
,loses_incremental_state
- Giá trị mặc định của
--[no]fat_apk_hwasan
: "false" -
Liệu có tạo các phần phân tách HWASAN hay không.
Thẻ:affects_outputs
,loading_and_analysis
,loses_incremental_state
--fdo_instrument=<a string>
mặc định: xem nội dung mô tả-
Tạo tệp nhị phân bằng khả năng đo lường FDO. Với trình biên dịch Clang/LLVM, trình biên dịch này cũng chấp nhận tên thư mục mà(các) tệp hồ sơ thô sẽ được kết xuất trong thời gian chạy.
Thẻ:affects_outputs
--fdo_optimize=<a string>
mặc định: xem nội dung mô tả- Sử dụng thông tin hồ sơ FDO để tối ưu hoá quá trình biên dịch. Chỉ định tên của tệp zip chứa cây tệp .gcda, tệp afdo chứa hồ sơ tự động hoặc tệp hồ sơ LLVM. Cờ này cũng chấp nhận các tệp được chỉ định làm nhãn (ví dụ: `//foo/bar:file.afdo` – bạn có thể cần thêm một lệnh `exports_files` vào gói tương ứng) và các nhãn trỏ đến mục tiêu `fdo_profile`. Cờ này sẽ được thay thế bằng quy tắc `fdo_profile`.
Thẻ:affects_outputs
--fdo_prefetch_hints=<a build target label>
mặc định: xem nội dung mô tả-
Sử dụng gợi ý tìm nạp trước bộ nhớ đệm.
Thẻ:affects_outputs
--fdo_profile=<a build target label>
mặc định: xem nội dung mô tả-
fdo_profile đại diện cho hồ sơ sẽ được dùng để tối ưu hoá.
Thẻ:affects_outputs
--features=<a string>
nhiều lần sử dụng được tích luỹ- Theo mặc định, các tính năng đã cho sẽ được bật hoặc tắt đối với các mục tiêu được tạo trong cấu hình mục tiêu. Việc chỉ định -<feature> sẽ tắt tính năng đó. Các đặc điểm tiêu cực luôn ghi đè các đặc điểm tích cực. Xem thêm --host_features
Thẻ
:changes_inputs
,affects_outputs
- Giá trị mặc định của
--[no]force_pic
: "false" - Nếu được bật, tất cả các bản biên dịch C++ sẽ tạo mã không phụ thuộc vào vị trí ("-fPIC"), các đường liên kết sẽ ưu tiên thư viện tạo sẵn PIC hơn thư viện không phải PIC và các đường liên kết sẽ tạo tệp thực thi không phụ thuộc vào vị trí ("-pie").
Thẻ:loading_and_analysis
,affects_outputs
--host_action_env=<a 'name=value' assignment with an optional value part>
nhiều lần sử dụng được tích luỹ- Chỉ định tập hợp các biến môi trường có sẵn cho các hành động có cấu hình thực thi. Bạn có thể chỉ định biến theo tên, trong trường hợp này giá trị sẽ được lấy từ môi trường gọi, hoặc theo cặp name=value để đặt giá trị độc lập với môi trường gọi. Bạn có thể sử dụng tuỳ chọn này nhiều lần; đối với các tuỳ chọn được đưa ra cho cùng một biến, tuỳ chọn mới nhất sẽ thắng, còn các tuỳ chọn cho các biến khác nhau sẽ được tích luỹ.
Thẻ:action_command_lines
--host_compilation_mode=<fastbuild, dbg or opt>
mặc định: "opt"-
Chỉ định chế độ mà các công cụ dùng trong quá trình xây dựng sẽ được tạo. Giá trị: "fastbuild", "dbg", "opt".
Thẻ:affects_outputs
,action_command_lines
--host_conlyopt=<a string>
nhiều lần sử dụng được tích luỹ- Tuỳ chọn bổ sung để truyền đến trình biên dịch C khi biên dịch tệp nguồn C (nhưng không phải C++) trong cấu hình thực thi.
Thẻ:action_command_lines
,affects_outputs
--host_copt=<a string>
nhiều lần sử dụng được tích luỹ-
Các tuỳ chọn bổ sung để chuyển đến trình biên dịch C cho các công cụ được tạo trong cấu hình thực thi.
Thẻ:action_command_lines
,affects_outputs
--host_cpu=<a string>
mặc định: ""-
CPU lưu trữ.
Thẻ:changes_inputs
,affects_outputs
--host_cxxopt=<a string>
nhiều lần sử dụng được tích luỹ-
Các tuỳ chọn bổ sung để truyền đến trình biên dịch C++ cho các công cụ được tạo trong cấu hình thực thi.
Thẻ:action_command_lines
,affects_outputs
--host_features=<a string>
nhiều lần sử dụng được tích luỹ- Theo mặc định, các tính năng đã cho sẽ được bật hoặc tắt đối với các mục tiêu được tạo trong cấu hình thực thi. Việc chỉ định -<feature> sẽ tắt tính năng đó. Các đặc điểm tiêu cực luôn ghi đè các đặc điểm tích cực.
Thẻ:changes_inputs
,affects_outputs
--host_force_python=<PY2 or PY3>
mặc định: xem nội dung mô tả- Ghi đè phiên bản Python cho cấu hình thực thi. Có thể là "PY2" hoặc "PY3".
Thẻ:loading_and_analysis
,affects_outputs
--host_linkopt=<a string>
nhiều lần sử dụng được tích luỹ-
Tuỳ chọn bổ sung để truyền đến trình liên kết khi liên kết các công cụ trong cấu hình thực thi.
Thẻ:action_command_lines
,affects_outputs
--host_macos_minimum_os=<a dotted version (for example '2.3' or '3.3alpha2.4')>
mặc định: xem nội dung mô tả-
Phiên bản macOS tương thích tối thiểu cho các mục tiêu lưu trữ. Nếu không chỉ định, hãy sử dụng "macos_sdk_version".
Thẻ:loses_incremental_state
--host_per_file_copt=<a comma-separated list of regex expressions with prefix '-' specifying excluded paths followed by an @ and a comma separated list of options>
nhiều lần sử dụng được tích luỹ-
Các tuỳ chọn bổ sung để truyền có chọn lọc đến trình biên dịch C/C++ khi biên dịch một số tệp nhất định trong cấu hình thực thi. Bạn có thể truyền tuỳ chọn này nhiều lần. Cú pháp: bộ_lọc_biểu_thức_định_liệu@tuỳ_chọn_1,tuỳ_chọn_2,...,tuỳ_chọn_n. Trong đó, regex_filter là danh sách các mẫu biểu thức chính quy bao gồm và loại trừ (Xem thêm --instrumentation_filter). option_1 đến option_n là các tuỳ chọn dòng lệnh tuỳ ý. Nếu một tuỳ chọn chứa dấu phẩy, thì bạn phải đặt tuỳ chọn đó trong dấu ngoặc kép có dấu gạch chéo ngược. Tuỳ chọn có thể chứa @. Chỉ @ đầu tiên mới được dùng để phân tách chuỗi. Ví dụ: --host_per_file_copt=//foo/.*\.cc,-//foo/bar\.cc@-O0 thêm tuỳ chọn dòng lệnh -O0 vào dòng lệnh gcc của tất cả tệp cc trong //foo/ ngoại trừ bar.cc.
Thẻ:action_command_lines
,affects_outputs
--host_swiftcopt=<a string>
nhiều lần sử dụng được tích luỹ-
Các tuỳ chọn bổ sung để truyền đến swiftc cho các công cụ thực thi.
Thẻ:action_command_lines
,affects_outputs
- Giá trị mặc định của
--[no]incompatible_auto_exec_groups
: "false" -
Khi được bật, một nhóm thực thi sẽ tự động được tạo cho mỗi chuỗi công cụ mà một quy tắc sử dụng. Để quy tắc này hoạt động, bạn cần chỉ định tham số "toolchain" (chuỗi công cụ) trên các hành động của quy tắc. Để biết thêm thông tin, hãy xem https://github.com/bazelbuild/bazel/issues/17134.
Thẻ:affects_outputs
,incompatible_change
- Giá trị mặc định của
--[no]incompatible_merge_genfiles_directory
: "true" - Nếu đúng, thư mục genfiles sẽ được gộp vào thư mục bin.
Thẻ:affects_outputs
,incompatible_change
- Giá trị mặc định của
--[no]incompatible_use_host_features
: "true" - Nếu đúng, hãy chỉ sử dụng --features cho cấu hình mục tiêu và --host_features cho cấu hình thực thi.
Thẻ:changes_inputs
,affects_outputs
,incompatible_change
- Giá trị mặc định của
--[no]instrument_test_targets
: "false" -
Khi bật mức độ sử dụng, hãy chỉ định xem có nên cân nhắc việc đo lường các quy tắc kiểm thử hay không. Khi được đặt, các quy tắc kiểm thử do --instrumentation_filter bao gồm sẽ được đo lường. Nếu không, các quy tắc kiểm thử sẽ luôn bị loại trừ khỏi hoạt động đo lường mức độ sử dụng.
Thẻ:affects_outputs
--instrumentation_filter=<a comma-separated list of regex expressions with prefix '-' specifying excluded paths>
mặc định: "-/javatests[/:],-/test/java[/:]"- Khi bạn bật tính năng mức độ sử dụng, chỉ những quy tắc có tên được bộ lọc dựa trên biểu thức chính quy chỉ định mới được đo lường. Thay vào đó, các quy tắc có tiền tố là "-" sẽ bị loại trừ. Xin lưu ý rằng chỉ các quy tắc không phải quy tắc kiểm thử mới được đo lường, trừ phi bạn bật --instrument_test_targets.
Thẻ:affects_outputs
--ios_minimum_os=<a dotted version (for example '2.3' or '3.3alpha2.4')>
mặc định: xem nội dung mô tả-
Phiên bản iOS tương thích tối thiểu cho trình mô phỏng và thiết bị mục tiêu. Nếu không chỉ định, hãy sử dụng "ios_sdk_version".
Thẻ:loses_incremental_state
--ios_multi_cpus=<comma-separated list of options>
nhiều lần sử dụng được tích luỹ-
Danh sách các cấu trúc được phân tách bằng dấu phẩy để tạo ios_application. Kết quả là một tệp nhị phân phổ quát chứa tất cả các cấu trúc đã chỉ định.
Thẻ:loses_incremental_state
,loading_and_analysis
- Giá trị mặc định của
--[no]legacy_whole_archive
: "true" -
Không dùng nữa, thay vào đó là --incompatible_remove_legacy_whole_archive (xem https://github.com/bazelbuild/bazel/issues/7362 để biết thông tin chi tiết). Khi bật, hãy sử dụng --whole-archive cho các quy tắc cc_binary có linkshared=True và linkstatic=True hoặc "-static" trong linkopts. Việc này chỉ nhằm mục đích tương thích ngược. Một cách thay thế tốt hơn là sử dụng alwayslink=1 khi cần.
Thẻ:action_command_lines
,affects_outputs
,deprecated
--linkopt=<a string>
nhiều lần sử dụng được tích luỹ- Tuỳ chọn bổ sung để truyền đến gcc khi liên kết.
Thẻ:action_command_lines
,affects_outputs
--ltobackendopt=<a string>
nhiều lần sử dụng được tích luỹ-
Tuỳ chọn bổ sung để chuyển đến bước phụ trợ LTO (trong --features=thin_lto).
Thẻ:action_command_lines
,affects_outputs
--ltoindexopt=<a string>
nhiều lần sử dụng được tích luỹ-
Tuỳ chọn bổ sung để chuyển đến bước lập chỉ mục LTO (trong --features=thin_lto).
Thẻ:action_command_lines
,affects_outputs
--macos_cpus=<comma-separated list of options>
nhiều lần sử dụng được tích luỹ-
Danh sách các cấu trúc được phân tách bằng dấu phẩy để tạo tệp nhị phân Apple macOS.
Thẻ:loses_incremental_state
,loading_and_analysis
--macos_minimum_os=<a dotted version (for example '2.3' or '3.3alpha2.4')>
mặc định: xem nội dung mô tả-
Phiên bản macOS tương thích tối thiểu cho các mục tiêu. Nếu không chỉ định, hãy sử dụng "macos_sdk_version".
Thẻ:loses_incremental_state
--memprof_profile=<a build target label>
mặc định: xem nội dung mô tả-
Sử dụng hồ sơ memprof.
Thẻ:affects_outputs
- Giá trị mặc định của
--[no]objc_debug_with_GLIBCXX
: "false" - Nếu bạn đặt và chế độ biên dịch được đặt thành "dbg", hãy xác định GLIBCXX_DEBUG, GLIBCXX_DEBUG_PEDANTIC và GLIBCPP_CONCEPT_CHECKS.
Thẻ:action_command_lines
- Giá trị mặc định của
--[no]objc_enable_binary_stripping
: "false" -
Liệu có thực hiện việc xoá ký hiệu và mã chết trên các tệp nhị phân được liên kết hay không. Thao tác loại bỏ tệp nhị phân sẽ được thực hiện nếu bạn chỉ định cả cờ này và --compilation_mode=opt.
Thẻ:action_command_lines
--objccopt=<a string>
nhiều lần sử dụng được tích luỹ-
Các tuỳ chọn bổ sung để truyền đến gcc khi biên dịch tệp nguồn Objective-C/C++.
Thẻ:action_command_lines
--per_file_copt=<a comma-separated list of regex expressions with prefix '-' specifying excluded paths followed by an @ and a comma separated list of options>
nhiều lần sử dụng được tích luỹ-
Các tuỳ chọn bổ sung để truyền có chọn lọc đến gcc khi biên dịch một số tệp nhất định. Bạn có thể truyền tuỳ chọn này nhiều lần. Cú pháp: bộ_lọc_biểu_thức_định_liệu@tuỳ_chọn_1,tuỳ_chọn_2,...,tuỳ_chọn_n. Trong đó, regex_filter là danh sách các mẫu biểu thức chính quy bao gồm và loại trừ (Xem thêm --instrumentation_filter). option_1 đến option_n là các tuỳ chọn dòng lệnh tuỳ ý. Nếu một tuỳ chọn chứa dấu phẩy, thì bạn phải đặt tuỳ chọn đó trong dấu ngoặc kép có dấu gạch chéo ngược. Tuỳ chọn có thể chứa @. Chỉ @ đầu tiên mới được dùng để phân tách chuỗi. Ví dụ: --per_file_copt=//foo/.*\.cc,-//foo/bar\.cc@-O0 thêm tuỳ chọn dòng lệnh -O0 vào dòng lệnh gcc của tất cả tệp cc trong //foo/ ngoại trừ bar.cc.
Thẻ:action_command_lines
,affects_outputs
--per_file_ltobackendopt=<a comma-separated list of regex expressions with prefix '-' specifying excluded paths followed by an @ and a comma separated list of options>
nhiều lần sử dụng được tích luỹ-
Các tuỳ chọn bổ sung để chuyển có chọn lọc đến phần phụ trợ LTO (trong --features=thin_lto) khi biên dịch một số đối tượng phụ trợ nhất định. Bạn có thể truyền tuỳ chọn này nhiều lần. Cú pháp: bộ_lọc_biểu_thức_định_liệu@tuỳ_chọn_1,tuỳ_chọn_2,...,tuỳ_chọn_n. Trong đó, regex_filter là danh sách các mẫu biểu thức chính quy bao gồm và loại trừ. option_1 đến option_n là các tuỳ chọn dòng lệnh tuỳ ý. Nếu một tuỳ chọn chứa dấu phẩy, thì bạn phải đặt tuỳ chọn đó trong dấu ngoặc kép có dấu gạch chéo ngược. Tuỳ chọn có thể chứa @. Chỉ @ đầu tiên mới được dùng để phân tách chuỗi. Ví dụ: --per_file_ltobackendopt=//foo/.*\.o,-//foo/bar\.o@-O0 sẽ thêm tuỳ chọn dòng lệnh -O0 vào dòng lệnh phụ trợ LTO của tất cả tệp o trong //foo/ ngoại trừ bar.o.
Thẻ:action_command_lines
,affects_outputs
--platform_suffix=<a string>
mặc định: xem nội dung mô tả- Chỉ định hậu tố cần thêm vào thư mục cấu hình.
Thẻ:loses_incremental_state
,affects_outputs
,loading_and_analysis
--propeller_optimize=<a build target label>
mặc định: xem nội dung mô tả-
Sử dụng thông tin hồ sơ Propeller để tối ưu hoá mục tiêu bản dựng.Hồ sơ Propeller phải bao gồm ít nhất một trong hai tệp, hồ sơ cc và hồ sơ ld. Cờ này chấp nhận nhãn bản dựng phải tham chiếu đến các tệp đầu vào của hồ sơ cánh quạt. Ví dụ: tệp BUILD xác định nhãn, trong a/b/BUILD:propeller_optimize( name = "propeller_profile", cc_profile = "propeller_cc_profile.txt", ld_profile = "propeller_ld_profile.txt",)Có thể bạn phải thêm một lệnh exports_files vào gói tương ứng để Bazel có thể thấy các tệp này. Bạn phải sử dụng tuỳ chọn này như sau: --propeller_optimize=//a/b:propeller_profile
Thẻ:action_command_lines
,affects_outputs
--propeller_optimize_absolute_cc_profile=<a string>
mặc định: xem nội dung mô tả- Tên đường dẫn tuyệt đối của tệp cc_profile cho các bản dựng được tối ưu hoá bằng Propeller.
Thẻ:affects_outputs
--propeller_optimize_absolute_ld_profile=<a string>
mặc định: xem nội dung mô tả- Tên đường dẫn tuyệt đối của tệp ld_profile cho các bản dựng được tối ưu hoá bằng Propeller.
Thẻ:affects_outputs
--run_under=<a prefix in front of command>
mặc định: xem nội dung mô tả-
Tiền tố để chèn trước các tệp thực thi cho lệnh "test" (kiểm thử) và "run" (chạy). Nếu giá trị là "foo -bar" và dòng lệnh thực thi là "test_binary -baz", thì dòng lệnh cuối cùng sẽ là "foo -bar test_binary -baz".Đây cũng có thể là nhãn cho một mục tiêu có thể thực thi. Một số ví dụ: "valgrind", "strace", "strace -c", "valgrind --quiet --num-callers=20", "//package:target", '//package:target --options'.
Thẻ:action_command_lines
- Nếu đúng, các thư viện gốc chứa chức năng giống hệt nhau sẽ được chia sẻ giữa các mục tiêu khác nhau
Thẻ
:loading_and_analysis
,affects_outputs
- Giá trị mặc định của
--[no]stamp
: "false" -
Đóng dấu tệp nhị phân bằng ngày, tên người dùng, tên máy chủ, thông tin về không gian làm việc, v.v.
Thẻ:affects_outputs
- Giá trị mặc định của
--strip=<always, sometimes or never>
: "đôi khi" - Chỉ định xem có xoá các tệp nhị phân và thư viện dùng chung hay không (sử dụng "-Wl,--strip-debug"). Giá trị mặc định là "sometimes" (đôi khi) có nghĩa là xoá nếu --compilation_mode=fastbuild.
Thẻ:affects_outputs
--stripopt=<a string>
nhiều lần sử dụng được tích luỹ-
Các tuỳ chọn bổ sung để truyền vào tính năng loại bỏ khi tạo tệp nhị phân "<name>.stripped".
Thẻ:action_command_lines
,affects_outputs
--swiftcopt=<a string>
nhiều lần sử dụng được tích luỹ-
Các tuỳ chọn bổ sung để truyền đến quá trình biên dịch Swift.
Thẻ:action_command_lines
--tvos_cpus=<comma-separated list of options>
nhiều lần sử dụng được tích luỹ-
Danh sách kiến trúc được phân tách bằng dấu phẩy để tạo tệp nhị phân Apple tvOS.
Thẻ:loses_incremental_state
,loading_and_analysis
--tvos_minimum_os=<a dotted version (for example '2.3' or '3.3alpha2.4')>
mặc định: xem nội dung mô tả-
Phiên bản tvOS tối thiểu tương thích cho trình mô phỏng và thiết bị mục tiêu. Nếu không chỉ định, hãy sử dụng "tvos_sdk_version".
Thẻ:loses_incremental_state
--visionos_cpus=<comma-separated list of options>
nhiều lần sử dụng được tích luỹ-
Danh sách kiến trúc được phân tách bằng dấu phẩy để tạo tệp nhị phân visionOS của Apple.
Thẻ:loses_incremental_state
,loading_and_analysis
--watchos_cpus=<comma-separated list of options>
nhiều lần sử dụng được tích luỹ-
Danh sách được phân tách bằng dấu phẩy gồm các cấu trúc để tạo tệp nhị phân Apple watchOS.
Thẻ:loses_incremental_state
,loading_and_analysis
--watchos_minimum_os=<a dotted version (for example '2.3' or '3.3alpha2.4')>
mặc định: xem nội dung mô tả- Phiên bản watchOS tối thiểu tương thích với trình mô phỏng và thiết bị mục tiêu. Nếu không chỉ định, hãy sử dụng "watchos_sdk_version".
Thẻ:loses_incremental_state
--xbinary_fdo=<a build target label>
mặc định: xem nội dung mô tả-
Sử dụng thông tin hồ sơ XbinaryFDO để tối ưu hoá quá trình biên dịch. Chỉ định tên của hồ sơ tệp nhị phân chéo mặc định. Khi tuỳ chọn này được sử dụng cùng với --fdo_instrument/--fdo_optimize/--fdo_profile, các tuỳ chọn đó sẽ luôn chiếm ưu thế như thể xbinary_fdo không bao giờ được chỉ định.
Thẻ:affects_outputs
- Các tuỳ chọn ảnh hưởng đến mức độ nghiêm ngặt mà Bazel thực thi các dữ liệu đầu vào bản dựng hợp lệ (xác định quy tắc, tổ hợp cờ, v.v.):
--auto_cpu_environment_group=<a build target label>
mặc định: ""- khai báo environment_group để sử dụng cho việc tự động liên kết các giá trị cpu với các giá trị target_environment.
Thẻ:changes_inputs
,loading_and_analysis
,experimental
- Giá trị mặc định của
--[no]check_licenses
: "false" -
Kiểm tra để đảm bảo các quy tắc hạn chế về giấy phép do các gói phụ thuộc áp đặt không xung đột với chế độ phân phối của các mục tiêu đang được tạo. Theo mặc định, giấy phép sẽ không được kiểm tra.
Thẻ:build_file_semantics
- Giá trị mặc định của
--[no]check_visibility
: "true" - Nếu bị tắt, các lỗi về chế độ hiển thị trong phần phụ thuộc mục tiêu sẽ bị hạ cấp thành cảnh báo.
Thẻ:build_file_semantics
- Giá trị mặc định của
--[no]desugar_for_android
: "true" -
Liệu có đơn giản hoá mã byte Java 8 trước khi tạo tệp dex hay không.
Thẻ:affects_outputs
,loading_and_analysis
,loses_incremental_state
- Giá trị mặc định của
--[no]desugar_java8_libs
: "false" -
Liệu có đưa các thư viện Java 8 được hỗ trợ vào ứng dụng cho các thiết bị cũ hay không.
Thẻ:affects_outputs
,loading_and_analysis
,loses_incremental_state
,experimental
- Giá trị mặc định của
--[no]enforce_constraints
: "true" -
Kiểm tra môi trường mà mỗi mục tiêu tương thích và báo cáo lỗi nếu có mục tiêu nào có các phần phụ thuộc không hỗ trợ cùng một môi trường
Thẻ:build_file_semantics
- Giá trị mặc định của
--[no]experimental_check_desugar_deps
: "true" -
Liệu có nên kiểm tra kỹ việc đơn giản hoá chính xác ở cấp tệp nhị phân Android hay không.
Thẻ:eagerness_to_exit
,loading_and_analysis
,experimental
- Giá trị mặc định của
--experimental_import_deps_checking=<off, warning or error>
: "OFF" -
Khi bật, hãy kiểm tra xem các phần phụ thuộc của aar_import đã hoàn tất hay chưa. Việc thực thi này có thể làm hỏng bản dựng hoặc chỉ dẫn đến cảnh báo.
Thẻ:loading_and_analysis
- Giá trị mặc định của
--experimental_one_version_enforcement=<off, warning or error>
: "OFF" -
Khi bật, hãy thực thi quy tắc java_binary không được chứa nhiều phiên bản của cùng một tệp lớp trên đường dẫn lớp. Việc thực thi này có thể làm hỏng bản dựng hoặc chỉ dẫn đến cảnh báo.
Thẻ:loading_and_analysis
- Giá trị mặc định của
--experimental_strict_java_deps=<off, warn, error, strict or default>
: "mặc định" - Nếu đúng, hãy kiểm tra để đảm bảo rằng một mục tiêu Java khai báo rõ ràng tất cả các mục tiêu được sử dụng trực tiếp dưới dạng phần phụ thuộc.
Thẻ:build_file_semantics
,eagerness_to_exit
- Giá trị mặc định của
--[no]incompatible_check_testonly_for_output_files
: "false" - Nếu được bật, hãy kiểm tra testonly cho các mục tiêu tiên quyết là tệp đầu ra bằng cách tra cứu testonly của quy tắc tạo. Điều này khớp với việc kiểm tra chế độ hiển thị.
Thẻ:build_file_semantics
,incompatible_change
- Giá trị mặc định của
--[no]incompatible_check_visibility_for_toolchains
: "false" - Nếu được bật, tính năng kiểm tra chế độ hiển thị cũng áp dụng cho việc triển khai chuỗi công cụ.
Thẻ:build_file_semantics
,incompatible_change
- Giá trị mặc định của
--[no]incompatible_disable_native_android_rules
: "false" - Nếu được bật, tính năng sử dụng trực tiếp các quy tắc Android gốc sẽ bị tắt. Vui lòng sử dụng các quy tắc Android Starlark từ https://github.com/bazelbuild/rules_android
Thẻ:eagerness_to_exit
,incompatible_change
- Giá trị mặc định của
--[no]incompatible_disable_native_apple_binary_rule
: "false" - Không hoạt động. Được giữ lại ở đây để tương thích ngược.
Thẻ:eagerness_to_exit
,incompatible_change
- Giá trị mặc định của
--[no]incompatible_python_disable_py2
: "true" - Nếu đúng, việc sử dụng chế độ cài đặt Python 2 sẽ gây ra lỗi. Bao gồm cả python_version=PY2, srcs_version=PY2 và srcs_version=PY2ONLY. Hãy xem https://github.com/bazelbuild/bazel/issues/15684 để biết thêm thông tin.
Thẻ:loading_and_analysis
,incompatible_change
- Giá trị mặc định của
--[no]incompatible_validate_top_level_header_inclusions
: "true" - Nếu đúng, Bazel cũng sẽ xác thực việc đưa tiêu đề thư mục cấp cao nhất vào (xem https://github.com/bazelbuild/bazel/issues/10047 để biết thêm thông tin).
Thẻ:loading_and_analysis
,incompatible_change
- Giá trị mặc định của
--[no]one_version_enforcement_on_java_tests
: "true" -
Khi được bật và experimental_one_version_enforcement được đặt thành một giá trị khác NONE, hãy thực thi một phiên bản trên các mục tiêu java_test. Bạn có thể tắt cờ này để cải thiện hiệu suất kiểm thử gia tăng nhưng sẽ bỏ lỡ các lỗi vi phạm tiềm ẩn về một phiên bản.
Thẻ:loading_and_analysis
--python_native_rules_allowlist=<a build target label>
mặc định: xem nội dung mô tả-
Danh sách cho phép (mục tiêu package_group) để sử dụng khi thực thi --incompatible_python_disallow_native_rules.
Thẻ:loading_and_analysis
- Giá trị mặc định của
--[no]strict_filesets
: "false" - Nếu bạn bật tuỳ chọn này, các tệp nhóm sẽ vượt quá giới hạn gói sẽ được báo cáo là lỗi.
Thẻ:build_file_semantics
,eagerness_to_exit
--strict_proto_deps=<off, warn, error, strict or default>
mặc định: "lỗi"- Nếu không tắt, hãy kiểm tra để đảm bảo rằng mục tiêu proto_library 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.
Thẻ:build_file_semantics
,eagerness_to_exit
,incompatible_change
--strict_public_imports=<off, warn, error, strict or default>
mặc định: "off"-
Trừ khi TẮT, hãy kiểm tra để đảm bảo rằng mục tiêu proto_library khai báo rõ ràng tất cả các mục tiêu được sử dụng trong "import public" là mục tiêu đã xuất.
Thẻ:build_file_semantics
,eagerness_to_exit
,incompatible_change
- Giá trị mặc định của
--[no]strict_system_includes
: "false" - Nếu là true, bạn cũng phải khai báo các tiêu đề tìm thấy thông qua hệ thống bao gồm các đường dẫn (-isystem).
Thẻ:loading_and_analysis
,eagerness_to_exit
--target_environment=<a build target label>
nhiều lần sử dụng được tích luỹ-
Khai báo môi trường mục tiêu của bản dựng này. Phải là tham chiếu nhãn đến quy tắc "môi trường". Nếu được chỉ định, tất cả mục tiêu cấp cao nhất phải tương thích với môi trường này.
Thẻ:changes_inputs
- Các tuỳ chọn ảnh hưởng đến kết quả ký của một bản dựng:
--apk_signing_method=<v1, v2, v1_v2 or v4>
mặc định: "v1_v2"-
Cách triển khai để ký tệp APK
Thẻ:action_command_lines
,affects_outputs
,loading_and_analysis
- Giá trị mặc định của
--[no]device_debug_entitlements
: "true" - Nếu bạn đặt và chế độ biên dịch không phải là "opt", thì các ứng dụng objc sẽ bao gồm các quyền gỡ lỗi khi ký.
Thẻ:changes_inputs
--ios_signing_cert_name=<a string>
mặc định: xem nội dung mô tả- Tên chứng chỉ dùng để ký ứng dụng iOS. Nếu không được đặt, hệ thống sẽ quay lại sử dụng hồ sơ cấp phép. Có thể là lựa chọn ưu tiên về danh tính chuỗi khoá của chứng chỉ hoặc (chuỗi con) của tên chung của chứng chỉ, theo trang man của codesign (SIGNING IDENTITIES).
Thẻ:action_command_lines
- Tuỳ chọn này ảnh hưởng đến ngữ nghĩa của ngôn ngữ Starlark hoặc API bản dựng mà các tệp BUILD, tệp .bzl hoặc tệp WORKSPACE có thể truy cập.:
- Giá trị mặc định của
--[no]incompatible_config_setting_private_default_visibility
: "false" - Nếu incompatible_enforce_config_setting_visibility=false, thì đây là một thao tác không có tác dụng. Nếu không, nếu cờ này là false, mọi config_setting không có thuộc tính chế độ hiển thị rõ ràng sẽ là //visibility:public. Nếu cờ này là true, config_setting sẽ tuân theo logic hiển thị giống như tất cả các quy tắc khác. Xem https://github.com/bazelbuild/bazel/issues/12933.
Thẻ:loading_and_analysis
,incompatible_change
- Giá trị mặc định của
--[no]incompatible_disallow_legacy_py_provider
: "true" - Không hoạt động, sẽ sớm bị xoá.
Thẻ:loading_and_analysis
,incompatible_change
- Giá trị mặc định của
--[no]incompatible_disallow_sdk_frameworks_attributes
: "false" - Nếu đúng, không cho phép các thuộc tính sdk_frameworks và weak_sdk_frameworks trong objc_library và objc_import.
Thẻ:build_file_semantics
,incompatible_change
- Giá trị mặc định của
--[no]incompatible_enforce_config_setting_visibility
: "true" - Nếu đúng, hãy thực thi các quy định hạn chế về chế độ hiển thị config_setting. Nếu giá trị là false, mọi mục config_setting đều hiển thị với mọi mục tiêu. Xem https://github.com/bazelbuild/bazel/issues/12932.
Thẻ:loading_and_analysis
,incompatible_change
- Giá trị mặc định của
--[no]incompatible_objc_alwayslink_by_default
: "false" - Nếu đúng, hãy đặt giá trị mặc định thành đúng cho các thuộc tính alwayslink trong objc_library và objc_import.
Thẻ:build_file_semantics
,incompatible_change
- Giá trị mặc định của
--[no]incompatible_python_disallow_native_rules
: "false" -
Khi giá trị là true, lỗi sẽ xảy ra khi sử dụng các quy tắc py_* tích hợp; thay vào đó, bạn nên sử dụng các quy tắc rule_python. Hãy xem https://github.com/bazelbuild/bazel/issues/17773 để biết thêm thông tin và hướng dẫn di chuyển.
Thẻ:loading_and_analysis
,incompatible_change
- Các tuỳ chọn điều chỉnh hành vi của môi trường kiểm thử hoặc trình chạy kiểm thử:
- Giá trị mặc định của
--[no]allow_analysis_failures
: "false" - Nếu đúng, lỗi phân tích của một mục tiêu quy tắc sẽ dẫn đến việc mục tiêu truyền một thực thể của AnalysisFailureInfo chứa nội dung mô tả lỗi, thay vì dẫn đến lỗi bản dựng.
Thẻ:loading_and_analysis
,experimental
- Giá trị mặc định của
--analysis_testing_deps_limit=<an integer>
: "2000" -
Đặt số lượng phần phụ thuộc bắc cầu tối đa thông qua một thuộc tính quy tắc có chuyển đổi cấu hình for_analysis_testing. Nếu vượt quá giới hạn này, bạn sẽ gặp lỗi quy tắc.
Thẻ:loading_and_analysis
- Giá trị mặc định của
--[no]break_build_on_parallel_dex2oat_failure
: "false" - Nếu lỗi thao tác dex2oat là đúng thì bản dựng sẽ bị lỗi thay vì thực thi dex2oat trong thời gian chạy kiểm thử.
Thẻ:loading_and_analysis
,experimental
--default_test_resources=<a resource name followed by equal and 1 float or 4 float, e.g. memory=10,30,60,100>
nhiều lần sử dụng được tích luỹ- Ghi đè số lượng tài nguyên mặc định cho các chương trình kiểm thử. Định dạng dự kiến là <tài nguyên>=<giá trị>. Nếu một số dương duy nhất được chỉ định là <giá trị>, thì số này sẽ ghi đè các tài nguyên mặc định cho tất cả kích thước kiểm thử. Nếu bạn chỉ định 4 số được phân tách bằng dấu phẩy, thì các số này sẽ ghi đè lượng tài nguyên tương ứng cho các kích thước kiểm thử nhỏ, trung bình, lớn, rất lớn. Giá trị cũng có thể là HOST_RAM/HOST_CPU, theo sau là [-|*]<float> (ví dụ: memory=HOST_RAM*.1,HOST_RAM*.2,HOST_RAM*.3,HOST_RAM*.4). Tài nguyên kiểm thử mặc định do cờ này chỉ định sẽ bị ghi đè bởi tài nguyên rõ ràng được chỉ định trong thẻ.
- Giá trị mặc định của
--[no]experimental_android_use_parallel_dex2oat
: "false" -
Sử dụng dex2oat song song để có thể tăng tốc android_test.
Thẻ:loading_and_analysis
,host_machine_resource_optimizations
,experimental
- Giá trị mặc định của
--[no]ios_memleaks
: "false" -
Bật tính năng kiểm tra rò rỉ bộ nhớ trong các mục tiêu ios_test.
Thẻ:action_command_lines
--ios_simulator_device=<a string>
mặc định: xem nội dung mô tả-
Thiết bị để mô phỏng khi chạy ứng dụng iOS trong trình mô phỏng, ví dụ: "iPhone 6". Bạn có thể lấy danh sách thiết bị bằng cách chạy lệnh "xcrun simctl list devicetypes" trên máy mà trình mô phỏng sẽ chạy.
Thẻ:test_runner
--ios_simulator_version=<a dotted version (for example '2.3' or '3.3alpha2.4')>
mặc định: xem nội dung mô tả-
Phiên bản iOS để chạy trên trình mô phỏng khi chạy hoặc kiểm thử. Quy tắc này sẽ bị bỏ qua đối với các quy tắc ios_test nếu bạn chỉ định một thiết bị mục tiêu trong quy tắc.
Thẻ:test_runner
--runs_per_test=<a positive integer or test_regex@runs. This flag may be passed more than once>
nhiều lần sử dụng được tích luỹ- Chỉ định số lần chạy mỗi chương trình kiểm thử. Nếu bất kỳ lần thử nào trong số đó không thành công vì bất kỳ lý do gì, thì toàn bộ kiểm thử sẽ được coi là không thành công. Thông thường, giá trị được chỉ định chỉ là một số nguyên. Ví dụ: --runs_per_test=3 sẽ chạy tất cả các bài kiểm thử 3 lần. Cú pháp thay thế: bộ_lọc_biểu_thức_tìm_kiếm@số_lần_chạy_mỗi_bài_kiểm_ thử. Trong đó, runs_per_test là một giá trị số nguyên và regex_filter là danh sách các mẫu biểu thức chính quy bao gồm và loại trừ (Xem thêm --instrumentation_filter). Ví dụ: --runs_per_test=//foo/.*,-//foo/bar/.*@3 chạy tất cả các bài kiểm thử trong //foo/ ngoại trừ các bài kiểm thử trong foo/bar ba lần. Bạn có thể truyền tuỳ chọn này nhiều lần. Đối số khớp được truyền gần đây nhất sẽ được ưu tiên. Nếu không có kết quả nào khớp, thì quy trình kiểm thử sẽ chỉ chạy một lần.
--test_env=<a 'name=value' assignment with an optional value part>
nhiều lần sử dụng được tích luỹ- Chỉ định các biến môi trường bổ sung sẽ được chèn vào môi trường trình chạy kiểm thử. Bạn có thể chỉ định biến theo tên, trong trường hợp này, giá trị của biến sẽ được đọc từ môi trường ứng dụng Bazel hoặc theo cặp name=value. Bạn có thể sử dụng tuỳ chọn này nhiều lần để chỉ định một số biến. Chỉ được lệnh "bazel test" sử dụng.
Thẻ:test_runner
--test_timeout=<a single integer or comma-separated list of 4 integers>
mặc định: "-1"- Ghi đè các giá trị thời gian chờ kiểm thử mặc định cho thời gian chờ kiểm thử (tính bằng giây). Nếu bạn chỉ định một giá trị số nguyên dương, thì giá trị đó sẽ ghi đè tất cả các danh mục. Nếu bạn chỉ định 4 số nguyên được phân tách bằng dấu phẩy, thì các số này sẽ ghi đè thời gian chờ cho thời gian ngắn, trung bình, dài và vĩnh viễn (theo thứ tự đó). Trong cả hai hình thức, giá trị -1 sẽ yêu cầu blaze sử dụng thời gian chờ mặc định cho danh mục đó.
- Giá trị mặc định của
--[no]zip_undeclared_test_outputs
: "true" - Nếu đúng, các kết quả kiểm thử chưa khai báo sẽ được lưu trữ trong một tệp zip.
Thẻ:test_runner
- Các tuỳ chọn liên quan đến đầu ra và ngữ nghĩa của Bzlmod:
- Giá trị mặc định của
--[no]configure
: "false" -
Chỉ tìm nạp các kho lưu trữ được đánh dấu là "định cấu hình" cho mục đích định cấu hình hệ thống. Chỉ hoạt động khi --enable_bzlmod đang bật.
Thẻ:changes_inputs
- Giá trị mặc định của
--[no]force
: "false" -
Bỏ qua kho lưu trữ hiện có (nếu có) và buộc tìm nạp lại kho lưu trữ. Chỉ hoạt động khi --enable_bzlmod đang bật.
Thẻ:changes_inputs
--repo=<a string>
nhiều lần sử dụng được tích luỹ-
Chỉ tìm nạp kho lưu trữ được chỉ định, có thể là {@apparent_repo_name} hoặc {@@canonical_repo_name}. Chỉ hoạt động khi --enable_bzlmod đang bật.
Thẻ:changes_inputs
- Các tuỳ chọn kích hoạt tính năng tối ưu hoá thời gian xây dựng:
- Giá trị mặc định của
--[no]experimental_filter_library_jar_with_program_jar
: "false" -
Lọc ProGuard ProgramJar để xoá mọi lớp cũng có trong LibraryJar.
Thẻ:action_command_lines
- Giá trị mặc định của
--[no]experimental_inmemory_dotd_files
: "true" - Nếu được bật, các tệp .d C++ sẽ được truyền trực tiếp trong bộ nhớ từ các nút bản dựng từ xa thay vì được ghi vào ổ đĩa.
Thẻ:loading_and_analysis
,execution
,affects_outputs
,experimental
- Giá trị mặc định của
--[no]experimental_inmemory_jdeps_files
: "true" - Nếu được bật, các tệp phần phụ thuộc (.jdeps) được tạo từ các bản biên dịch Java sẽ được truyền trực tiếp trong bộ nhớ từ các nút bản dựng từ xa thay vì được ghi vào ổ đĩa.
Thẻ:loading_and_analysis
,execution
,affects_outputs
,experimental
- Giá trị mặc định của
--[no]experimental_objc_include_scanning
: "false" -
Liệu có thực hiện việc quét tìm C/C++ khách quan hay không.
Thẻ:loading_and_analysis
,execution
,changes_inputs
- Giá trị mặc định của
--[no]experimental_retain_test_configuration_across_testonly
: "false" -
Khi được bật, --trim_test_configuration sẽ không cắt bớt cấu hình kiểm thử cho các quy tắc được đánh dấu testonly=1. Điều này nhằm giảm các vấn đề xung đột hành động khi các quy tắc không phải quy tắc kiểm thử phụ thuộc vào quy tắc cc_test. Không có hiệu lực nếu --trim_test_configuration là false.
Thẻ:loading_and_analysis
,loses_incremental_state
- Giá trị mặc định của
--[no]experimental_starlark_cc_import
: "false" - Nếu được bật, bạn có thể sử dụng phiên bản Starlark của cc_import.
Thẻ:loading_and_analysis
,experimental
- Giá trị mặc định của
--[no]experimental_unsupported_and_brittle_include_scanning
: "false" -
Liệu có thu hẹp dữ liệu đầu vào cho quá trình biên dịch C/C++ bằng cách phân tích cú pháp các dòng #include từ tệp đầu vào hay không. Điều này có thể cải thiện hiệu suất và tính tăng dần bằng cách giảm kích thước của cây đầu vào biên dịch. Tuy nhiên, việc này cũng có thể làm hỏng các bản dựng vì trình quét bao gồm không triển khai đầy đủ ngữ nghĩa của trình xử lý trước C. Cụ thể, trình biên dịch này không hiểu các lệnh #include động và bỏ qua logic có điều kiện của trình xử lý trước. Bạn tự chịu rủi ro khi sử dụng. Mọi vấn đề liên quan đến cờ này đều sẽ bị đóng.
Thẻ:loading_and_analysis
,execution
,changes_inputs
- Giá trị mặc định của
--[no]incremental_dexing
: "true" -
Thực hiện hầu hết công việc tạo tệp DEX riêng cho từng tệp Jar.
Thẻ:affects_outputs
,loading_and_analysis
,loses_incremental_state
- Giá trị mặc định của
--[no]objc_use_dotd_pruning
: "true" - Nếu được đặt, các tệp .d do clang phát ra sẽ được dùng để cắt bớt tập hợp đầu vào được truyền vào các bản biên dịch objc.
Thẻ:changes_inputs
,loading_and_analysis
- Giá trị mặc định của
--[no]process_headers_in_dependencies
: "false" -
Khi tạo một mục tiêu //a:a, hãy xử lý các tiêu đề trong tất cả các mục tiêu mà //a:a phụ thuộc vào (nếu bạn bật tính năng xử lý tiêu đề cho chuỗi công cụ).
Thẻ:execution
- Giá trị mặc định của
--[no]trim_test_configuration
: "true" -
Khi được bật, các tuỳ chọn liên quan đến kiểm thử sẽ bị xoá bên dưới cấp cao nhất của bản dựng. Khi cờ này đang hoạt động, bạn không thể tạo kiểm thử dưới dạng phần phụ thuộc của các quy tắc không phải kiểm thử, nhưng các thay đổi đối với các tuỳ chọn liên quan đến kiểm thử sẽ không khiến các quy tắc không phải kiểm thử được phân tích lại.
Thẻ
:loading_and_analysis
,loses_incremental_state
- Các tuỳ chọn ảnh hưởng đến mức độ chi tiết, định dạng hoặc vị trí ghi nhật ký:
--toolchain_resolution_debug=<a comma-separated list of regex expressions with prefix '-' specifying excluded paths>
mặc định: "-.*"-
In thông tin gỡ lỗi trong quá trình phân giải chuỗi công cụ. Cờ này lấy một biểu thức chính quy, được kiểm tra dựa trên các loại chuỗi công cụ và mục tiêu cụ thể để xem cần gỡ lỗi mục nào. Bạn có thể phân tách nhiều biểu thức chính quy bằng dấu phẩy, sau đó mỗi biểu thức chính quy sẽ được kiểm tra riêng. Lưu ý: Kết quả của cờ này rất phức tạp và có thể chỉ hữu ích cho các chuyên gia về độ phân giải chuỗi công cụ.
Thẻ:terminal_output
- Các tuỳ chọn chỉ định hoặc thay đổi dữ liệu đầu vào chung cho một lệnh Bazel không thuộc các danh mục khác.:
--flag_alias=<a 'name=value' flag alias>
nhiều lần sử dụng được tích luỹ-
Đặt tên viết tắt cho cờ Starlark. Hàm này nhận một cặp khoá-giá trị duy nhất ở dạng "<khoá>=<giá trị>" làm đối số.
Thẻ:changes_inputs
- Giá trị mặc định của
--[no]incompatible_default_to_explicit_init_py
: "false" -
Cờ này thay đổi hành vi mặc định để các tệp __init__.py không còn được tạo tự động trong các tệp chạy của mục tiêu Python. Chính xác là khi mục tiêu py_binary hoặc py_test có legacy_create_init được đặt thành "tự động" (mặc định), mục tiêu đó được coi là sai nếu và chỉ khi bạn đặt cờ này. Xem https://github.com/bazelbuild/bazel/issues/10076.
Thẻ:affects_outputs
,incompatible_change
- Giá trị mặc định của
--[no]incompatible_py2_outputs_are_suffixed
: "true" - Nếu đúng, các mục tiêu được tạo trong cấu hình Python 2 sẽ xuất hiện trong thư mục gốc đầu ra có hậu tố "-py2", trong khi các mục tiêu được tạo cho Python 3 sẽ xuất hiện trong thư mục gốc không có hậu tố liên quan đến Python. Điều này có nghĩa là đường liên kết tượng trưng thuận tiện `bazel-bin` sẽ trỏ đến các mục tiêu Python 3 thay vì Python 2. Nếu bật tuỳ chọn này, bạn cũng nên bật `--incompatible_py3_is_default`.
Thẻ:affects_outputs
,incompatible_change
- Giá trị mặc định của
--[no]incompatible_py3_is_default
: "true" - Nếu đúng, các mục tiêu `py_binary` và `py_test` không đặt thuộc tính `python_version` (hoặc `default_python_version`) sẽ mặc định là PY3 thay vì PY2. Nếu đặt cờ này, bạn cũng nên đặt `--incompatible_py2_outputs_are_suffixed`.
Thẻ
:loading_and_analysis
,affects_outputs
,incompatible_change
- Giá trị mặc định của
--[no]incompatible_use_python_toolchains
: "true" - Nếu bạn đặt thành true, các quy tắc Python gốc có thể thực thi sẽ sử dụng môi trường thời gian chạy Python do chuỗi công cụ Python chỉ định, thay vì môi trường thời gian chạy do các cờ cũ như --python_top cung cấp.
Thẻ:loading_and_analysis
,incompatible_change
--python_version=<PY2 or PY3>
mặc định: xem nội dung mô tả-
Chế độ phiên bản chính của Python, "PY2" hoặc "PY3". Xin lưu ý rằng chế độ này sẽ bị ghi đè bởi các mục tiêu "py_binary" và "py_test" (ngay cả khi các mục tiêu này không chỉ định rõ ràng một phiên bản), vì vậy, thường không có lý do gì để cung cấp cờ này.
Thẻ:loading_and_analysis
,affects_outputs
- Các tuỳ chọn khác, không được phân loại.:
--[no]cache_test_results
[-t
] mặc định: "tự động"- Nếu được đặt thành "tự động", Bazel sẽ chạy lại một kiểm thử nếu và chỉ khi: (1) Bazel phát hiện thấy các thay đổi trong kiểm thử hoặc các phần phụ thuộc của kiểm thử, (2) kiểm thử được đánh dấu là bên ngoài, (3) nhiều lần chạy kiểm thử được yêu cầu bằng --runs_per_test hoặc(4) kiểm thử trước đó không thành công. Nếu được đặt thành "yes" (có), Bazel sẽ lưu tất cả kết quả kiểm thử vào bộ nhớ đệm, ngoại trừ các kiểm thử được đánh dấu là bên ngoài. Nếu bạn đặt thành "no" (không), Bazel sẽ không lưu kết quả kiểm thử vào bộ nhớ đệm.
--deleted_packages=<comma-separated list of package names>
nhiều lần sử dụng được tích luỹ- Danh sách tên gói được phân tách bằng dấu phẩy mà hệ thống xây dựng sẽ coi là không tồn tại, ngay cả khi các gói đó xuất hiện ở đâu đó trên đường dẫn gói. Sử dụng tuỳ chọn này khi xoá một gói con "x/y" của một gói hiện có "x". Ví dụ: sau khi xoá x/y/BUILD trong ứng dụng, hệ thống xây dựng có thể khiếu nại nếu gặp nhãn "//x:y/z" nếu nhãn đó vẫn được cung cấp bởi một mục package_path khác. Bạn có thể chỉ định --deleted_packages x/y để tránh vấn đề này.
- Giá trị mặc định của
--[no]experimental_cancel_concurrent_tests
: "false" - Nếu đúng, Blaze sẽ huỷ các chương trình kiểm thử đang chạy đồng thời trong lần chạy thành công đầu tiên. Điều này chỉ hữu ích khi kết hợp với --runs_per_test_detects_flakes.
Thẻ:affects_outputs
,loading_and_analysis
- Giá trị mặc định của
--[no]experimental_fetch_all_coverage_outputs
: "false" - Nếu đúng, thì Bazel sẽ tìm nạp toàn bộ thư mục dữ liệu mức độ sử dụng cho mỗi lần kiểm thử trong một lần chạy mức độ sử dụng.
Thẻ:affects_outputs
,loading_and_analysis
- Giá trị mặc định của
--[no]experimental_generate_llvm_lcov
: "false" - Nếu đúng, mức độ sử dụng cho clang sẽ tạo ra một báo cáo LCOV.
Thẻ:affects_outputs
,loading_and_analysis
- Giá trị mặc định của
--[no]experimental_j2objc_header_map
: "true" - Liệu có tạo bản đồ tiêu đề J2ObjC song song với quá trình biên dịch chuyển đổi J2ObjC hay không.
- Giá trị mặc định của
--[no]experimental_j2objc_shorter_header_path
: "false" -
Liệu có tạo bằng đường dẫn tiêu đề ngắn hơn hay không (sử dụng "_ios" thay vì "_j2objc").
Thẻ:affects_outputs
--experimental_java_classpath=<off, javabuilder or bazel>
mặc định: "javabuilder"- Bật các đường dẫn lớp rút gọn cho các bản biên dịch Java.
- Giá trị mặc định của
--[no]experimental_limit_android_lint_to_android_constrained_java
: "false" -
Giới hạn --experimental_run_android_lint_on_java_rules ở các thư viện tương thích với Android.
Thẻ:affects_outputs
- Giá trị mặc định của
--[no]experimental_run_android_lint_on_java_rules
: "false" -
Liệu có xác thực các nguồn java_* hay không.
Thẻ:affects_outputs
- Giá trị mặc định của
--[no]explicit_java_test_deps
: "false" - Chỉ định rõ ràng phần phụ thuộc cho JUnit hoặc Hamcrest trong java_test thay vì vô tình lấy từ phần phụ thuộc của TestRunner. Hiện chỉ hoạt động cho bazel.
- Giá trị mặc định của
--[no]fetch
: "true" - Cho phép lệnh tìm nạp các phần phụ thuộc bên ngoài. Nếu bạn đặt thành false, lệnh sẽ sử dụng bất kỳ phiên bản nào của phần phụ thuộc được lưu vào bộ nhớ đệm và nếu không có phiên bản nào, lệnh sẽ không thành công.
--host_java_launcher=<a build target label>
mặc định: xem nội dung mô tả- Trình chạy Java mà các công cụ thực thi trong quá trình tạo bản dựng sử dụng.
--host_javacopt=<a string>
nhiều lần sử dụng được tích luỹ- Các tuỳ chọn bổ sung để truyền vào javac khi tạo các công cụ được thực thi trong quá trình tạo bản dựng.
--host_jvmopt=<a string>
nhiều lần sử dụng được tích luỹ- Các tuỳ chọn bổ sung để truyền đến máy ảo Java khi tạo các công cụ được thực thi trong quá trình xây dựng. Các tuỳ chọn này sẽ được thêm vào tuỳ chọn khởi động máy ảo của mỗi mục tiêu java_binary.
- Giá trị mặc định của
--[no]incompatible_check_sharding_support
: "true" - Nếu giá trị là true, Bazel sẽ không kiểm thử được nếu trình chạy kiểm thử không cho biết rằng nó hỗ trợ phân đoạn bằng cách chạm vào tệp tại đường dẫn trong TEST_SHARD_STATUS_FILE. Nếu giá trị là false, trình chạy kiểm thử không hỗ trợ phân đoạn sẽ dẫn đến tất cả các kiểm thử chạy trong mỗi phân đoạn.
Thẻ:incompatible_change
- Giá trị mặc định của
--[no]incompatible_exclusive_test_sandboxed
: "true" - Nếu đúng, các thử nghiệm độc quyền sẽ chạy bằng chiến lược hộp cát. Thêm thẻ "local" để buộc chạy một kiểm thử độc quyền trên máy
Thẻ:incompatible_change
- Giá trị mặc định của
--[no]incompatible_strict_action_env
: "false" - Nếu đúng, Bazel sẽ sử dụng một môi trường có giá trị tĩnh cho PATH và không kế thừa LD_LIBRARY_PATH. Sử dụng --action_env=ENV_VARIABLE nếu bạn muốn kế thừa các biến môi trường cụ thể từ ứng dụng, nhưng lưu ý rằng việc này có thể ngăn việc lưu vào bộ nhớ đệm trên nhiều người dùng nếu bạn sử dụng bộ nhớ đệm dùng chung.
Thẻ:loading_and_analysis
,incompatible_change
--j2objc_translation_flags=<comma-separated list of options>
nhiều lần sử dụng được tích luỹ- Các tuỳ chọn bổ sung để truyền đến công cụ J2ObjC.
--java_debug
-
Khiến máy ảo Java của một kiểm thử java chờ kết nối từ trình gỡ lỗi tuân thủ JDWP (chẳng hạn như jdb) trước khi bắt đầu kiểm thử. Ngụ ý -test_output=streamed.
Mở rộng thành:
--test_arg=--wrapper_script_flag=--debug
--test_output=streamed
--test_strategy=exclusive
--test_timeout=9999
--nocache_test_results
- Giá trị mặc định của
--[no]java_deps
: "true" - Tạo thông tin phần phụ thuộc (hiện tại là đường dẫn lớp thời gian biên dịch) cho mỗi mục tiêu Java.
- Giá trị mặc định của
--[no]java_header_compilation
: "true" - Biên dịch ijar trực tiếp từ nguồn.
--java_language_version=<a string>
mặc định: ""- Phiên bản ngôn ngữ Java
--java_launcher=<a build target label>
mặc định: xem nội dung mô tả- Trình chạy Java để sử dụng khi tạo tệp nhị phân Java. Nếu bạn đặt cờ này thành chuỗi trống, trình chạy JDK sẽ được sử dụng. Thuộc tính "launcher" (trình chạy) sẽ ghi đè cờ này.
--java_runtime_version=<a string>
mặc định: "local_jdk"- Phiên bản môi trường thời gian chạy Java
--javacopt=<a string>
nhiều lần sử dụng được tích luỹ- Các tuỳ chọn bổ sung để truyền đến javac.
--jvmopt=<a string>
nhiều lần sử dụng được tích luỹ- Các tuỳ chọn bổ sung để truyền đến máy ảo Java. Các tuỳ chọn này sẽ được thêm vào tuỳ chọn khởi động máy ảo của mỗi mục tiêu java_binary.
--legacy_main_dex_list_generator=<a build target label>
mặc định: xem nội dung mô tả- Chỉ định một tệp nhị phân để sử dụng nhằm tạo danh sách các lớp phải có trong dex chính khi biên dịch multidex cũ.
--optimizing_dexer=<a build target label>
mặc định: xem nội dung mô tả- Chỉ định một tệp nhị phân để sử dụng cho việc tạo tệp dex mà không phân đoạn.
--package_path=<colon-separated list of options>
mặc định: "%workspace%"- Danh sách được phân tách bằng dấu hai chấm về nơi tìm kiếm các gói. Các phần tử bắt đầu bằng "%workspace%" có liên quan đến không gian làm việc bao quanh. Nếu bạn bỏ qua hoặc để trống, giá trị mặc định sẽ là kết quả của lệnh "bazel info default-package-path".
--plugin=<a build target label>
nhiều lần sử dụng được tích luỹ- Trình bổ trợ để sử dụng trong bản dựng. Hiện hoạt động với java_plugin.
--proguard_top=<a build target label>
mặc định: xem nội dung mô tả- Chỉ định phiên bản ProGuard sẽ dùng để xoá mã khi tạo tệp nhị phân Java.
--proto_compiler=<a build target label>
mặc định: "@bazel_tools//tools/proto:protoc"-
Nhãn của trình biên dịch proto.
Thẻ:affects_outputs
,loading_and_analysis
--proto_toolchain_for_cc=<a build target label>
mặc định: "@bazel_tools//tools/proto:cc_toolchain"-
Nhãn của proto_lang_toolchain() mô tả cách biên dịch proto C++
Thẻ:affects_outputs
,loading_and_analysis
--proto_toolchain_for_j2objc=<a build target label>
mặc định: "@bazel_tools//tools/j2objc:j2objc_proto_toolchain"-
Nhãn của proto_lang_toolchain() mô tả cách biên dịch proto j2objc
Thẻ:affects_outputs
,loading_and_analysis
--proto_toolchain_for_java=<a build target label>
mặc định: "@bazel_tools//tools/proto:java_toolchain"-
Nhãn của proto_lang_toolchain() mô tả cách biên dịch proto Java
Thẻ:affects_outputs
,loading_and_analysis
--proto_toolchain_for_javalite=<a build target label>
mặc định: "@bazel_tools//tools/proto:javalite_toolchain"-
Nhãn của proto_lang_toolchain() mô tả cách biên dịch proto JavaLite
Thẻ:affects_outputs
,loading_and_analysis
--protocopt=<a string>
nhiều lần sử dụng được tích luỹ-
Các tuỳ chọn bổ sung để truyền đến trình biên dịch protobuf.
Thẻ:affects_outputs
- Giá trị mặc định của
--[no]runs_per_test_detects_flakes
: "false" - Nếu đúng, mọi phân mảnh có ít nhất một lần chạy/thử nghiệm thành công và ít nhất một lần chạy/thử nghiệm không thành công sẽ có trạng thái FLAKY.
--shell_executable=<a path>
mặc định: xem nội dung mô tả-
Đường dẫn tuyệt đối đến tệp thực thi shell để Bazel sử dụng. Nếu bạn không đặt biến này nhưng đặt biến môi trường BAZEL_SH trong lệnh gọi Bazel đầu tiên (lệnh gọi này sẽ khởi động máy chủ Bazel), thì Bazel sẽ sử dụng biến đó. Nếu bạn không đặt cả hai, Bazel sẽ sử dụng đường dẫn mặc định được mã hoá cứng tuỳ thuộc vào hệ điều hành mà nó chạy (Windows: c:/tools/msys64/usr/bin/bash.exe, FreeBSD: /usr/local/bin/bash, tất cả các hệ điều hành khác: /bin/bash). Xin lưu ý rằng việc sử dụng một shell không tương thích với bash có thể dẫn đến lỗi bản dựng hoặc lỗi thời gian chạy của các tệp nhị phân được tạo.
Thẻ:loading_and_analysis
- Giá trị mặc định của
--[no]show_loading_progress
: "true" - Nếu được bật, sẽ khiến Bazel in thông báo "Loading package" ("Đang tải gói").
--test_arg=<a string>
nhiều lần sử dụng được tích luỹ- Chỉ định các tuỳ chọn và đối số bổ sung cần được truyền đến tệp thực thi kiểm thử. Có thể sử dụng nhiều lần để chỉ định một số đối số. Nếu nhiều chương trình kiểm thử được thực thi, thì mỗi chương trình kiểm thử sẽ nhận được các đối số giống hệt nhau. Chỉ được lệnh "bazel test" sử dụng.
--test_filter=<a string>
mặc định: xem nội dung mô tả- Chỉ định một bộ lọc để chuyển tiếp đến khung kiểm thử. Dùng để giới hạn số lượng kiểm thử được chạy. Xin lưu ý rằng điều này không ảnh hưởng đến việc xây dựng mục tiêu nào.
--test_result_expiration=<an integer>
mặc định: "-1"- Tuỳ chọn này không được dùng nữa và không có hiệu lực.
- Giá trị mặc định của
--[no]test_runner_fail_fast
: "false" - Chuyển tiếp tuỳ chọn thất bại nhanh đến trình chạy kiểm thử. Trình chạy kiểm thử sẽ dừng thực thi khi gặp lỗi đầu tiên.
--test_sharding_strategy=<explicit, disabled or forced=k where k is the number of shards to enforce>
mặc định: "explicit"- Chỉ định chiến lược phân đoạn kiểm thử: "rõ ràng" để chỉ sử dụng phân đoạn nếu có thuộc tính BUILD "shard_count". "disabled" để không bao giờ sử dụng tính năng phân đoạn kiểm thử. "forced=k" để thực thi các phân đoạn "k" cho hoạt động kiểm thử bất kể thuộc tính BUILD "shard_count".
--tool_java_language_version=<a string>
mặc định: ""- Phiên bản ngôn ngữ Java dùng để thực thi các công cụ cần thiết trong quá trình tạo bản dựng
--tool_java_runtime_version=<a string>
mặc định: "remotejdk_11"- Phiên bản thời gian chạy Java dùng để thực thi các công cụ trong quá trình tạo bản dựng
- Giá trị mặc định của
--[no]use_ijars
: "true" - Nếu được bật, tuỳ chọn này sẽ khiến quá trình biên dịch Java sử dụng các tệp jar giao diện. Điều này sẽ giúp quá trình biên dịch tăng dần diễn ra nhanh hơn, nhưng thông báo lỗi có thể khác.
Các lựa chọn trợ giúp
- Các tuỳ chọn xuất hiện trước lệnh và được máy khách phân tích cú pháp:
--distdir=<a path>
nhiều lần sử dụng được tích luỹ-
Các vị trí khác để tìm kiếm bản lưu trữ trước khi truy cập vào mạng để tải xuống.
Thẻ:bazel_internal_configuration
- Giá trị mặc định của
--[no]experimental_repository_cache_hardlinks
: "false" - Nếu được đặt, bộ nhớ đệm kho lưu trữ sẽ liên kết cứng tệp trong trường hợp có lượt truy cập vào bộ nhớ đệm, thay vì sao chép. Việc này nhằm tiết kiệm dung lượng ổ đĩa.
Thẻ:bazel_internal_configuration
--experimental_repository_downloader_retries=<an integer>
mặc định: "0"-
Số lần thử tối đa để thử lại lỗi tải xuống. Nếu bạn đặt thành 0, thì tính năng thử lại sẽ bị tắt.
Thẻ:experimental
--experimental_scale_timeouts=<a double>
mặc định: "1.0"- Điều chỉnh tất cả thời gian chờ trong quy tắc kho lưu trữ Starlark theo hệ số này. Bằng cách này, bạn có thể làm cho kho lưu trữ bên ngoài hoạt động trên các máy chạy chậm hơn dự kiến của tác giả quy tắc mà không cần thay đổi mã nguồn
Thẻ:bazel_internal_configuration
,experimental
- Giá trị mặc định của
--[no]incompatible_disable_native_repo_rules
: "false" - Nếu giá trị là false, bạn có thể sử dụng các quy tắc kho lưu trữ gốc trong WORKSPACE; nếu không, bạn phải sử dụng các quy tắc kho lưu trữ Starlark. Các quy tắc kho lưu trữ gốc bao gồm local_repository, new_local_repository, local_config_platform, android_sdk_repository và android_ndk_repository.
Thẻ:bazel_internal_configuration
--repository_cache=<a path>
mặc định: xem nội dung mô tả- Chỉ định vị trí bộ nhớ đệm của các giá trị đã tải xuống thu được trong quá trình tìm nạp kho lưu trữ bên ngoài. Chuỗi trống làm đối số yêu cầu tắt bộ nhớ đệm, nếu không, giá trị mặc định là "<output_user_root>/cache/repos/v1" sẽ được sử dụng
Thẻ:bazel_internal_configuration
- Giá trị mặc định của
--[no]repository_disable_download
: "false" - Nếu được đặt, bạn không được phép tải xuống bằng ctx.download{,_and_extract} trong quá trình tìm nạp kho lưu trữ. Xin lưu ý rằng quyền truy cập mạng không bị tắt hoàn toàn; ctx.execute vẫn có thể chạy một tệp thực thi tuỳ ý truy cập Internet.
Thẻ:bazel_internal_configuration
- Các tuỳ chọn kiểm soát việc thực thi bản dựng:
- Giá trị mặc định của
--gc_thrashing_threshold=<an integer in 0-100 range>
: "100" -
Tỷ lệ phần trăm không gian cố định bị chiếm dụng (0-100) mà tại đó GcThrashingDetector xem xét các sự kiện áp lực bộ nhớ so với giới hạn của nó (--gc_thrashing_limits). Nếu bạn đặt thành 100, GcThrashingDetector sẽ bị tắt.
Thẻ:host_machine_resource_optimizations
- Tuỳ chọn liên quan đến đầu ra và ngữ nghĩa của Bzlmod:
--allow_yanked_versions=<a string>
nhiều lần sử dụng được tích luỹ-
Chỉ định các phiên bản mô-đun ở dạng `<module1>@<version1>,<module2>@<version2>` sẽ được cho phép trong biểu đồ phần phụ thuộc đã phân giải ngay cả khi các phiên bản đó được khai báo là đã bị xoá trong sổ đăng ký nơi chúng đến (nếu không đến từ NonRegistryOverride). Nếu không, các phiên bản bị xoá sẽ khiến việc phân giải không thành công. Bạn cũng có thể xác định phiên bản bị xoá được phép bằng biến môi trường `BZLMOD_ALLOW_YANKED_VERSIONS`. Bạn có thể tắt tính năng kiểm tra này bằng cách sử dụng từ khoá "tất cả" (không nên dùng).
Thẻ:loading_and_analysis
--check_bazel_compatibility=<error, warning or off>
mặc định: "lỗi"-
Kiểm tra khả năng tương thích của phiên bản bazel của các mô-đun Bazel. Các giá trị hợp lệ là "error" để chuyển vấn đề này lên lỗi phân giải, "off" để tắt tính năng kiểm tra hoặc "warning" để in cảnh báo khi phát hiện thấy không khớp.
Thẻ:loading_and_analysis
--check_direct_dependencies=<off, warning or error>
mặc định: "cảnh báo"-
Kiểm tra xem các phần phụ thuộc `bazel_dep` trực tiếp được khai báo trong mô-đun gốc có phải là các phiên bản mà bạn nhận được trong biểu đồ phần phụ thuộc đã được phân giải hay không. Các giá trị hợp lệ là "off" để tắt tính năng kiểm tra, "warning" để in cảnh báo khi phát hiện thấy không khớp hoặc "error" để chuyển lên lỗi phân giải.
Thẻ:loading_and_analysis
- Giá trị mặc định của
--[no]ignore_dev_dependency
: "false" - Nếu đúng, Bazel sẽ bỏ qua "bazel_dep" và "use_extension" được khai báo là "dev_dependency" trong MODULE.bazel của mô-đun gốc. Xin lưu ý rằng các phần phụ thuộc dành cho nhà phát triển đó luôn bị bỏ qua trong MODULE.bazel nếu đó không phải là mô-đun gốc, bất kể giá trị của cờ này là gì.
Thẻ:loading_and_analysis
--lockfile_mode=<off, update, refresh or error>
mặc định: "cập nhật"-
Chỉ định cách thức và liệu có sử dụng tệp khoá hay không. Các giá trị hợp lệ là "update" để sử dụng tệp khoá và cập nhật tệp khoá nếu có thay đổi, "refresh" để thỉnh thoảng làm mới thông tin có thể thay đổi (các phiên bản bị loại bỏ và các mô-đun bị thiếu trước đó) từ các sổ đăng ký từ xa, "error" để sử dụng tệp khoá nhưng gửi lỗi nếu tệp khoá không được cập nhật hoặc "off" để không đọc hoặc ghi vào tệp khoá.
Thẻ:loading_and_analysis
--override_module=<an equals-separated mapping of module name to path>
nhiều lần sử dụng được tích luỹ- Ghi đè một mô-đun bằng đường dẫn cục bộ ở dạng <tên mô-đun>=<đường dẫn>. Nếu đường dẫn đã cho là đường dẫn tuyệt đối, thì đường dẫn đó sẽ được sử dụng nguyên trạng. Nếu đường dẫn đã cho là đường dẫn tương đối, thì đường dẫn đó sẽ tương ứng với thư mục đang hoạt động. Nếu đường dẫn đã cho bắt đầu bằng "%workspace%", thì đường dẫn đó sẽ tương ứng với thư mục gốc của không gian làm việc, là kết quả của lệnh "bazel info workspace". Nếu đường dẫn đã cho trống, hãy xoá mọi chế độ ghi đè trước đó.
--registry=<a string>
nhiều lần sử dụng được tích luỹ- Chỉ định các sổ đăng ký cần sử dụng để xác định vị trí các phần phụ thuộc mô-đun Bazel. Thứ tự rất quan trọng: các mô-đun sẽ được tra cứu trong các sổ đăng ký trước đó trước tiên và chỉ quay lại các sổ đăng ký sau này khi các mô-đun đó bị thiếu trong các sổ đăng ký trước đó.
Thẻ:changes_inputs
--vendor_dir=<a path>
mặc định: xem nội dung mô tả-
Chỉ định thư mục sẽ chứa các kho lưu trữ bên ngoài ở chế độ nhà cung cấp, cho dù mục đích là tìm nạp các kho lưu trữ đó vào thư mục hay sử dụng các kho lưu trữ đó trong khi xây dựng. Bạn có thể chỉ định đường dẫn dưới dạng đường dẫn tuyệt đối hoặc đường dẫn tương đối đến thư mục không gian làm việc.
Thẻ:loading_and_analysis
- Các tuỳ chọn kích hoạt tính năng tối ưu hoá thời gian xây dựng:
--gc_thrashing_limits=<comma separated pairs of <period>:<count>>
mặc định: "1s:2,20s:3,1m:5"-
Các giới hạn nếu đạt đến sẽ khiến GcThrashingDetector gặp sự cố Bazel với OOM. Mỗi giới hạn được chỉ định là <period>:<count>, trong đó period là thời lượng và count là số nguyên dương. Nếu hơn --gc_thrashing_threshold phần trăm không gian cố định (vùng nhớ khối xếp cũ) vẫn bị chiếm dụng sau <count> lần GC đầy đủ liên tiếp trong <period>, thì lỗi OOM sẽ được kích hoạt. Bạn có thể chỉ định nhiều giới hạn, phân tách bằng dấu phẩy.
Thẻ:host_machine_resource_optimizations
--skyframe_high_water_mark_full_gc_drops_per_invocation=<an integer, >= 0>
mặc định: "2147483647"-
Cờ cho cấu hình nâng cao của công cụ Skyframe nội bộ của Bazel. Nếu phát hiện mức sử dụng phần trăm vùng nhớ khối xếp được giữ lại vượt quá ngưỡng do --skyframe_high_water_mark_threshold đặt ra, thì khi một sự kiện GC đầy đủ xảy ra, Bazel sẽ loại bỏ trạng thái Skyframe tạm thời không cần thiết, lên đến nhiều lần như vậy cho mỗi lệnh gọi. Mặc định là Integer.MAX_VALUE; không giới hạn về mặt hiệu quả. Giá trị 0 có nghĩa là các sự kiện GC đầy đủ sẽ không bao giờ kích hoạt sự kiện thả. Nếu đạt đến giới hạn, trạng thái Skyframe sẽ không còn bị loại bỏ khi một sự kiện GC đầy đủ xảy ra và vượt quá ngưỡng phần trăm vùng nhớ khối xếp được giữ lại đó.
Thẻ:host_machine_resource_optimizations
--skyframe_high_water_mark_minor_gc_drops_per_invocation=<an integer, >= 0>
mặc định: "2147483647"-
Cờ cho cấu hình nâng cao của công cụ Skyframe nội bộ của Bazel. Nếu phát hiện mức sử dụng phần trăm vùng nhớ khối xếp được giữ lại vượt quá ngưỡng do --skyframe_high_water_mark_threshold đặt ra, thì khi một sự kiện GC nhỏ xảy ra, Bazel sẽ loại bỏ trạng thái Skyframe tạm thời không cần thiết, lên đến nhiều lần như vậy mỗi lần gọi. Mặc định là Integer.MAX_VALUE; không giới hạn về mặt hiệu quả. Giá trị 0 có nghĩa là các sự kiện GC nhỏ sẽ không bao giờ kích hoạt sự kiện thả. Nếu đạt đến giới hạn, trạng thái Skyframe sẽ không còn bị loại bỏ khi một sự kiện GC nhỏ xảy ra và vượt quá ngưỡng phần trăm vùng nhớ khối xếp được giữ lại.
Thẻ:host_machine_resource_optimizations
--skyframe_high_water_mark_threshold=<an integer>
mặc định: "85"-
Cờ cho cấu hình nâng cao của công cụ Skyframe nội bộ của Bazel. Nếu phát hiện mức sử dụng phần trăm vùng nhớ khối xếp được giữ lại ít nhất là ngưỡng này, Bazel sẽ loại bỏ trạng thái Skyframe tạm thời không cần thiết. Việc điều chỉnh điều này có thể giúp bạn giảm thiểu tác động của tình trạng GC bị lỗi khi (i) tình trạng này là do mức sử dụng bộ nhớ của trạng thái tạm thời và (ii) tốn kém hơn so với việc tạo lại trạng thái khi cần.
Thẻ:host_machine_resource_optimizations
- Các tuỳ chọn ảnh hưởng đến mức độ chi tiết, định dạng hoặc vị trí ghi nhật ký:
--experimental_command_profile=<cpu, wall, alloc or lock>
mặc định: xem nội dung mô tả- Ghi hồ sơ Trình ghi chuyến bay Java trong thời gian thực thi lệnh. Bạn phải cung cấp một trong các loại sự kiện phân tích tài nguyên được hỗ trợ (cpu, wall, alloc hoặc lock) dưới dạng đối số. Hồ sơ được ghi vào một tệp được đặt tên theo loại sự kiện trong thư mục cơ sở đầu ra. Cú pháp và ngữ nghĩa của cờ này có thể thay đổi trong tương lai để hỗ trợ thêm các loại hồ sơ hoặc định dạng đầu ra; bạn tự chịu rủi ro khi sử dụng.
- Giá trị mặc định của
--[no]experimental_record_metrics_for_all_mnemonics
: "false" - Theo mặc định, số lượng loại thao tác được giới hạn ở 20 câu thần chú có số lượng thao tác được thực thi nhiều nhất. Việc đặt tuỳ chọn này sẽ ghi số liệu thống kê cho tất cả các câu thần chú.
--help_verbosity=<long, medium or short>
mặc định: "medium"-
Chọn mức độ chi tiết của lệnh trợ giúp.
Thẻ:affects_outputs
,terminal_output
--long
[-l
]- Hiển thị nội dung mô tả đầy đủ của từng tuỳ chọn, thay vì chỉ tên tuỳ chọn.
Mở rộng thành:
--help_verbosity=long
Thẻ:affects_outputs
,terminal_output
--short
-
Chỉ hiển thị tên của các tuỳ chọn, chứ không phải loại hoặc ý nghĩa của các tuỳ chọn đó.
Mở rộng thành:
--help_verbosity=short
Thẻ:affects_outputs
,terminal_output
- Các tuỳ chọn chỉ định hoặc thay đổi dữ liệu đầu vào chung thành một lệnh Bazel không thuộc các danh mục khác.:
--experimental_resolved_file_instead_of_workspace=<a string>
mặc định: ""- Nếu không trống, hãy đọc tệp đã phân giải được chỉ định thay vì tệp WORKSPACE
Thẻ:changes_inputs
- Các tuỳ chọn thực thi và lưu vào bộ nhớ đệm từ xa:
--experimental_downloader_config=<a string>
mặc định: xem nội dung mô tả- Chỉ định một tệp để định cấu hình trình tải xuống từ xa. Tệp này bao gồm các dòng, mỗi dòng bắt đầu bằng một lệnh (`allow`, `block` hoặc `rewrite`), theo sau là tên máy chủ lưu trữ (đối với lệnh `allow` và `block`) hoặc hai mẫu, một mẫu để so khớp và một mẫu để sử dụng làm URL thay thế, với các tệp tham chiếu ngược bắt đầu từ `$1`. Bạn có thể cung cấp nhiều lệnh `rewrite` cho cùng một URL và trong trường hợp này, nhiều URL sẽ được trả về.
- Giá trị mặc định của
--experimental_worker_for_repo_fetching=<off, platform, virtual or auto>
: "tự động" - Chế độ tạo luồng để tìm nạp kho lưu trữ. Nếu bạn đặt thành "tắt", thì không có luồng worker nào được sử dụng và quá trình tìm nạp kho lưu trữ sẽ phải khởi động lại. Nếu không, hãy sử dụng luồng worker ảo.
- Các tuỳ chọn khác, không được phân loại theo cách khác.:
--override_repository=<an equals-separated mapping of repository name to path>
nhiều lần sử dụng được tích luỹ- Ghi đè kho lưu trữ bằng một đường dẫn cục bộ ở dạng <repository name>=<path>. Nếu đường dẫn đã cho là đường dẫn tuyệt đối, thì đường dẫn đó sẽ được sử dụng nguyên trạng. Nếu đường dẫn đã cho là đường dẫn tương đối, thì đường dẫn đó sẽ tương ứng với thư mục đang hoạt động. Nếu đường dẫn đã cho bắt đầu bằng "%workspace%", thì đường dẫn đó sẽ tương ứng với thư mục gốc của không gian làm việc, là kết quả của lệnh "bazel info workspace". Nếu đường dẫn đã cho trống, hãy xoá mọi chế độ ghi đè trước đó.
Tuỳ chọn thông tin
Kế thừa tất cả các tuỳ chọn từ build.
- Các tuỳ chọn xuất hiện trước lệnh và được máy khách phân tích cú pháp:
--distdir=<a path>
nhiều lần sử dụng được tích luỹ-
Các vị trí khác để tìm kiếm bản lưu trữ trước khi truy cập vào mạng để tải xuống.
Thẻ:bazel_internal_configuration
- Giá trị mặc định của
--[no]experimental_repository_cache_hardlinks
: "false" - Nếu được đặt, bộ nhớ đệm kho lưu trữ sẽ liên kết cứng tệp trong trường hợp có lượt truy cập vào bộ nhớ đệm, thay vì sao chép. Việc này nhằm tiết kiệm dung lượng ổ đĩa.
Thẻ:bazel_internal_configuration
--experimental_repository_downloader_retries=<an integer>
mặc định: "0"-
Số lần thử tối đa để thử lại lỗi tải xuống. Nếu bạn đặt thành 0, thì tính năng thử lại sẽ bị tắt.
Thẻ:experimental
--experimental_scale_timeouts=<a double>
mặc định: "1.0"- Điều chỉnh tất cả thời gian chờ trong quy tắc kho lưu trữ Starlark theo hệ số này. Bằng cách này, bạn có thể làm cho kho lưu trữ bên ngoài hoạt động trên các máy chạy chậm hơn dự kiến của tác giả quy tắc mà không cần thay đổi mã nguồn
Thẻ:bazel_internal_configuration
,experimental
- Giá trị mặc định của
--[no]incompatible_disable_native_repo_rules
: "false" - Nếu giá trị là false, bạn có thể sử dụng các quy tắc kho lưu trữ gốc trong WORKSPACE; nếu không, bạn phải sử dụng các quy tắc kho lưu trữ Starlark. Các quy tắc kho lưu trữ gốc bao gồm local_repository, new_local_repository, local_config_platform, android_sdk_repository và android_ndk_repository.
Thẻ:bazel_internal_configuration
--repository_cache=<a path>
mặc định: xem nội dung mô tả- Chỉ định vị trí bộ nhớ đệm của các giá trị đã tải xuống thu được trong quá trình tìm nạp kho lưu trữ bên ngoài. Chuỗi trống làm đối số yêu cầu tắt bộ nhớ đệm, nếu không, giá trị mặc định là "<output_user_root>/cache/repos/v1" sẽ được sử dụng
Thẻ:bazel_internal_configuration
- Giá trị mặc định của
--[no]repository_disable_download
: "false" - Nếu được đặt, bạn không được phép tải xuống bằng ctx.download{,_and_extract} trong quá trình tìm nạp kho lưu trữ. Xin lưu ý rằng quyền truy cập mạng không bị tắt hoàn toàn; ctx.execute vẫn có thể chạy một tệp thực thi tuỳ ý truy cập Internet.
Thẻ:bazel_internal_configuration
- Các tuỳ chọn kiểm soát việc thực thi bản dựng:
- Giá trị mặc định của
--gc_thrashing_threshold=<an integer in 0-100 range>
: "100" -
Tỷ lệ phần trăm không gian cố định bị chiếm dụng (0-100) mà tại đó GcThrashingDetector xem xét các sự kiện áp lực bộ nhớ so với giới hạn của nó (--gc_thrashing_limits). Nếu bạn đặt thành 100, GcThrashingDetector sẽ bị tắt.
Thẻ:host_machine_resource_optimizations
- Tuỳ chọn liên quan đến đầu ra và ngữ nghĩa của Bzlmod:
--allow_yanked_versions=<a string>
nhiều lần sử dụng được tích luỹ-
Chỉ định các phiên bản mô-đun ở dạng `<module1>@<version1>,<module2>@<version2>` sẽ được cho phép trong biểu đồ phần phụ thuộc đã phân giải ngay cả khi các phiên bản đó được khai báo là đã bị xoá trong sổ đăng ký nơi chúng đến (nếu không đến từ NonRegistryOverride). Nếu không, các phiên bản bị xoá sẽ khiến việc phân giải không thành công. Bạn cũng có thể xác định phiên bản bị xoá được phép bằng biến môi trường `BZLMOD_ALLOW_YANKED_VERSIONS`. Bạn có thể tắt tính năng kiểm tra này bằng cách sử dụng từ khoá "tất cả" (không nên dùng).
Thẻ:loading_and_analysis
--check_bazel_compatibility=<error, warning or off>
mặc định: "lỗi"-
Kiểm tra khả năng tương thích của phiên bản bazel của các mô-đun Bazel. Các giá trị hợp lệ là "error" để chuyển vấn đề này lên lỗi phân giải, "off" để tắt tính năng kiểm tra hoặc "warning" để in cảnh báo khi phát hiện thấy không khớp.
Thẻ:loading_and_analysis
--check_direct_dependencies=<off, warning or error>
mặc định: "cảnh báo"-
Kiểm tra xem các phần phụ thuộc `bazel_dep` trực tiếp được khai báo trong mô-đun gốc có phải là các phiên bản mà bạn nhận được trong biểu đồ phần phụ thuộc đã được phân giải hay không. Các giá trị hợp lệ là "off" để tắt tính năng kiểm tra, "warning" để in cảnh báo khi phát hiện thấy không khớp hoặc "error" để chuyển lên lỗi phân giải.
Thẻ:loading_and_analysis
- Giá trị mặc định của
--[no]ignore_dev_dependency
: "false" - Nếu đúng, Bazel sẽ bỏ qua "bazel_dep" và "use_extension" được khai báo là "dev_dependency" trong MODULE.bazel của mô-đun gốc. Xin lưu ý rằng các phần phụ thuộc dành cho nhà phát triển đó luôn bị bỏ qua trong MODULE.bazel nếu đó không phải là mô-đun gốc, bất kể giá trị của cờ này là gì.
Thẻ:loading_and_analysis
--lockfile_mode=<off, update, refresh or error>
mặc định: "cập nhật"-
Chỉ định cách thức và liệu có sử dụng tệp khoá hay không. Các giá trị hợp lệ là "update" để sử dụng tệp khoá và cập nhật tệp khoá nếu có thay đổi, "refresh" để thỉnh thoảng làm mới thông tin có thể thay đổi (các phiên bản bị loại bỏ và các mô-đun bị thiếu trước đó) từ các sổ đăng ký từ xa, "error" để sử dụng tệp khoá nhưng gửi lỗi nếu tệp khoá không được cập nhật hoặc "off" để không đọc hoặc ghi vào tệp khoá.
Thẻ:loading_and_analysis
--override_module=<an equals-separated mapping of module name to path>
nhiều lần sử dụng được tích luỹ- Ghi đè một mô-đun bằng đường dẫn cục bộ ở dạng <tên mô-đun>=<đường dẫn>. Nếu đường dẫn đã cho là đường dẫn tuyệt đối, thì đường dẫn đó sẽ được sử dụng nguyên trạng. Nếu đường dẫn đã cho là đường dẫn tương đối, thì đường dẫn đó sẽ tương ứng với thư mục đang hoạt động. Nếu đường dẫn đã cho bắt đầu bằng "%workspace%", thì đường dẫn đó sẽ tương ứng với thư mục gốc của không gian làm việc, là kết quả của lệnh "bazel info workspace". Nếu đường dẫn đã cho trống, hãy xoá mọi chế độ ghi đè trước đó.
--registry=<a string>
nhiều lần sử dụng được tích luỹ- Chỉ định các sổ đăng ký cần sử dụng để xác định vị trí các phần phụ thuộc mô-đun Bazel. Thứ tự rất quan trọng: các mô-đun sẽ được tra cứu trong các sổ đăng ký trước đó trước tiên và chỉ quay lại các sổ đăng ký sau này khi các mô-đun đó bị thiếu trong các sổ đăng ký trước đó.
Thẻ:changes_inputs
--vendor_dir=<a path>
mặc định: xem nội dung mô tả-
Chỉ định thư mục sẽ chứa các kho lưu trữ bên ngoài ở chế độ nhà cung cấp, cho dù mục đích là tìm nạp các kho lưu trữ đó vào thư mục hay sử dụng các kho lưu trữ đó trong khi xây dựng. Bạn có thể chỉ định đường dẫn dưới dạng đường dẫn tuyệt đối hoặc đường dẫn tương đối đến thư mục không gian làm việc.
Thẻ:loading_and_analysis
- Các tuỳ chọn kích hoạt tính năng tối ưu hoá thời gian xây dựng:
--gc_thrashing_limits=<comma separated pairs of <period>:<count>>
mặc định: "1s:2,20s:3,1m:5"-
Các giới hạn nếu đạt đến sẽ khiến GcThrashingDetector gặp sự cố Bazel với OOM. Mỗi giới hạn được chỉ định là <period>:<count>, trong đó period là thời lượng và count là số nguyên dương. Nếu hơn --gc_thrashing_threshold phần trăm không gian cố định (vùng nhớ khối xếp cũ) vẫn bị chiếm dụng sau <count> lần GC đầy đủ liên tiếp trong <period>, thì lỗi OOM sẽ được kích hoạt. Bạn có thể chỉ định nhiều giới hạn, phân tách bằng dấu phẩy.
Thẻ:host_machine_resource_optimizations
--skyframe_high_water_mark_full_gc_drops_per_invocation=<an integer, >= 0>
mặc định: "2147483647"-
Cờ cho cấu hình nâng cao của công cụ Skyframe nội bộ của Bazel. Nếu phát hiện mức sử dụng phần trăm vùng nhớ khối xếp được giữ lại vượt quá ngưỡng do --skyframe_high_water_mark_threshold đặt ra, thì khi một sự kiện GC đầy đủ xảy ra, Bazel sẽ loại bỏ trạng thái Skyframe tạm thời không cần thiết, lên đến nhiều lần như vậy cho mỗi lệnh gọi. Mặc định là Integer.MAX_VALUE; không giới hạn về mặt hiệu quả. Giá trị 0 có nghĩa là các sự kiện GC đầy đủ sẽ không bao giờ kích hoạt sự kiện thả. Nếu đạt đến giới hạn, trạng thái Skyframe sẽ không còn bị loại bỏ khi một sự kiện GC đầy đủ xảy ra và vượt quá ngưỡng phần trăm vùng nhớ khối xếp được giữ lại đó.
Thẻ:host_machine_resource_optimizations
--skyframe_high_water_mark_minor_gc_drops_per_invocation=<an integer, >= 0>
mặc định: "2147483647"-
Cờ cho cấu hình nâng cao của công cụ Skyframe nội bộ của Bazel. Nếu phát hiện mức sử dụng phần trăm vùng nhớ khối xếp được giữ lại vượt quá ngưỡng do --skyframe_high_water_mark_threshold đặt ra, thì khi một sự kiện GC nhỏ xảy ra, Bazel sẽ loại bỏ trạng thái Skyframe tạm thời không cần thiết, lên đến nhiều lần như vậy mỗi lần gọi. Mặc định là Integer.MAX_VALUE; không giới hạn về mặt hiệu quả. Giá trị 0 có nghĩa là các sự kiện GC nhỏ sẽ không bao giờ kích hoạt sự kiện thả. Nếu đạt đến giới hạn, trạng thái Skyframe sẽ không còn bị loại bỏ khi một sự kiện GC nhỏ xảy ra và vượt quá ngưỡng phần trăm vùng nhớ khối xếp được giữ lại.
Thẻ:host_machine_resource_optimizations
--skyframe_high_water_mark_threshold=<an integer>
mặc định: "85"-
Cờ cho cấu hình nâng cao của công cụ Skyframe nội bộ của Bazel. Nếu phát hiện mức sử dụng phần trăm vùng nhớ khối xếp được giữ lại ít nhất là ngưỡng này, Bazel sẽ loại bỏ trạng thái Skyframe tạm thời không cần thiết. Việc điều chỉnh điều này có thể giúp bạn giảm thiểu tác động của tình trạng GC bị lỗi khi (i) tình trạng này là do mức sử dụng bộ nhớ của trạng thái tạm thời và (ii) tốn kém hơn so với việc tạo lại trạng thái khi cần.
Thẻ:host_machine_resource_optimizations
- Các tuỳ chọn ảnh hưởng đến mức độ chi tiết, định dạng hoặc vị trí ghi nhật ký:
--experimental_command_profile=<cpu, wall, alloc or lock>
mặc định: xem nội dung mô tả- Ghi hồ sơ Trình ghi chuyến bay Java trong thời gian thực thi lệnh. Bạn phải cung cấp một trong các loại sự kiện phân tích tài nguyên được hỗ trợ (cpu, wall, alloc hoặc lock) dưới dạng đối số. Hồ sơ được ghi vào một tệp được đặt tên theo loại sự kiện trong thư mục cơ sở đầu ra. Cú pháp và ngữ nghĩa của cờ này có thể thay đổi trong tương lai để hỗ trợ thêm các loại hồ sơ hoặc định dạng đầu ra; bạn tự chịu rủi ro khi sử dụng.
- Giá trị mặc định của
--[no]experimental_record_metrics_for_all_mnemonics
: "false" - Theo mặc định, số lượng loại thao tác được giới hạn ở 20 câu thần chú có số lượng thao tác được thực thi nhiều nhất. Việc đặt tuỳ chọn này sẽ ghi số liệu thống kê cho tất cả các câu thần chú.
- Giá trị mặc định của
--[no]show_make_env
: "false" -
Thêm môi trường "Tạo" vào kết quả.
Thẻ:affects_outputs
,terminal_output
- Các tuỳ chọn chỉ định hoặc thay đổi dữ liệu đầu vào chung thành một lệnh Bazel không thuộc các danh mục khác.:
--experimental_resolved_file_instead_of_workspace=<a string>
mặc định: ""- Nếu không trống, hãy đọc tệp đã phân giải được chỉ định thay vì tệp WORKSPACE
Thẻ:changes_inputs
- Các tuỳ chọn thực thi và lưu vào bộ nhớ đệm từ xa:
--experimental_downloader_config=<a string>
mặc định: xem nội dung mô tả- Chỉ định một tệp để định cấu hình trình tải xuống từ xa. Tệp này bao gồm các dòng, mỗi dòng bắt đầu bằng một lệnh (`allow`, `block` hoặc `rewrite`), theo sau là tên máy chủ lưu trữ (đối với lệnh `allow` và `block`) hoặc hai mẫu, một mẫu để so khớp và một mẫu để sử dụng làm URL thay thế, với các tệp tham chiếu ngược bắt đầu từ `$1`. Bạn có thể cung cấp nhiều lệnh `rewrite` cho cùng một URL và trong trường hợp này, nhiều URL sẽ được trả về.
- Giá trị mặc định của
--experimental_worker_for_repo_fetching=<off, platform, virtual or auto>
: "tự động" - Chế độ tạo luồng để tìm nạp kho lưu trữ. Nếu bạn đặt thành "tắt", thì không có luồng worker nào được sử dụng và quá trình tìm nạp kho lưu trữ sẽ phải khởi động lại. Nếu không, hãy sử dụng luồng worker ảo.
- Các tuỳ chọn khác, không được phân loại theo cách khác.:
--override_repository=<an equals-separated mapping of repository name to path>
nhiều lần sử dụng được tích luỹ- Ghi đè kho lưu trữ bằng một đường dẫn cục bộ ở dạng <repository name>=<path>. Nếu đường dẫn đã cho là đường dẫn tuyệt đối, thì đường dẫn đó sẽ được sử dụng nguyên trạng. Nếu đường dẫn đã cho là đường dẫn tương đối, thì đường dẫn đó sẽ tương ứng với thư mục đang hoạt động. Nếu đường dẫn đã cho bắt đầu bằng "%workspace%", thì đường dẫn đó sẽ tương ứng với thư mục gốc của không gian làm việc, là kết quả của lệnh "bazel info workspace". Nếu đường dẫn đã cho trống, hãy xoá mọi chế độ ghi đè trước đó.
Các lựa chọn về giấy phép
- Các tuỳ chọn xuất hiện trước lệnh và được máy khách phân tích cú pháp:
--distdir=<a path>
nhiều lần sử dụng được tích luỹ-
Các vị trí khác để tìm kiếm bản lưu trữ trước khi truy cập vào mạng để tải xuống.
Thẻ:bazel_internal_configuration
- Giá trị mặc định của
--[no]experimental_repository_cache_hardlinks
: "false" - Nếu được đặt, bộ nhớ đệm kho lưu trữ sẽ liên kết cứng tệp trong trường hợp có lượt truy cập vào bộ nhớ đệm, thay vì sao chép. Việc này nhằm tiết kiệm dung lượng ổ đĩa.
Thẻ:bazel_internal_configuration
--experimental_repository_downloader_retries=<an integer>
mặc định: "0"-
Số lần thử tối đa để thử lại lỗi tải xuống. Nếu bạn đặt thành 0, thì tính năng thử lại sẽ bị tắt.
Thẻ:experimental
--experimental_scale_timeouts=<a double>
mặc định: "1.0"- Điều chỉnh tất cả thời gian chờ trong quy tắc kho lưu trữ Starlark theo hệ số này. Bằng cách này, bạn có thể làm cho kho lưu trữ bên ngoài hoạt động trên các máy chạy chậm hơn dự kiến của tác giả quy tắc mà không cần thay đổi mã nguồn
Thẻ:bazel_internal_configuration
,experimental
- Giá trị mặc định của
--[no]incompatible_disable_native_repo_rules
: "false" - Nếu giá trị là false, bạn có thể sử dụng các quy tắc kho lưu trữ gốc trong WORKSPACE; nếu không, bạn phải sử dụng các quy tắc kho lưu trữ Starlark. Các quy tắc kho lưu trữ gốc bao gồm local_repository, new_local_repository, local_config_platform, android_sdk_repository và android_ndk_repository.
Thẻ:bazel_internal_configuration
--repository_cache=<a path>
mặc định: xem nội dung mô tả- Chỉ định vị trí bộ nhớ đệm của các giá trị đã tải xuống thu được trong quá trình tìm nạp kho lưu trữ bên ngoài. Chuỗi trống làm đối số yêu cầu tắt bộ nhớ đệm, nếu không, giá trị mặc định là "<output_user_root>/cache/repos/v1" sẽ được sử dụng
Thẻ:bazel_internal_configuration
- Giá trị mặc định của
--[no]repository_disable_download
: "false" - Nếu được đặt, bạn không được phép tải xuống bằng ctx.download{,_and_extract} trong quá trình tìm nạp kho lưu trữ. Xin lưu ý rằng quyền truy cập mạng không bị tắt hoàn toàn; ctx.execute vẫn có thể chạy một tệp thực thi tuỳ ý truy cập Internet.
Thẻ:bazel_internal_configuration
- Các tuỳ chọn kiểm soát việc thực thi bản dựng:
- Giá trị mặc định của
--gc_thrashing_threshold=<an integer in 0-100 range>
: "100" -
Tỷ lệ phần trăm không gian cố định bị chiếm dụng (0-100) mà tại đó GcThrashingDetector xem xét các sự kiện áp lực bộ nhớ so với giới hạn của nó (--gc_thrashing_limits). Nếu bạn đặt thành 100, GcThrashingDetector sẽ bị tắt.
Thẻ:host_machine_resource_optimizations
- Tuỳ chọn liên quan đến đầu ra và ngữ nghĩa của Bzlmod:
--allow_yanked_versions=<a string>
nhiều lần sử dụng được tích luỹ-
Chỉ định các phiên bản mô-đun ở dạng `<module1>@<version1>,<module2>@<version2>` sẽ được cho phép trong biểu đồ phần phụ thuộc đã phân giải ngay cả khi các phiên bản đó được khai báo là đã bị xoá trong sổ đăng ký nơi chúng đến (nếu không đến từ NonRegistryOverride). Nếu không, các phiên bản bị xoá sẽ khiến việc phân giải không thành công. Bạn cũng có thể xác định phiên bản bị xoá được phép bằng biến môi trường `BZLMOD_ALLOW_YANKED_VERSIONS`. Bạn có thể tắt tính năng kiểm tra này bằng cách sử dụng từ khoá "tất cả" (không nên dùng).
Thẻ:loading_and_analysis
--check_bazel_compatibility=<error, warning or off>
mặc định: "lỗi"-
Kiểm tra khả năng tương thích của phiên bản bazel của các mô-đun Bazel. Các giá trị hợp lệ là "error" để chuyển vấn đề này lên lỗi phân giải, "off" để tắt tính năng kiểm tra hoặc "warning" để in cảnh báo khi phát hiện thấy không khớp.
Thẻ:loading_and_analysis
--check_direct_dependencies=<off, warning or error>
mặc định: "cảnh báo"-
Kiểm tra xem các phần phụ thuộc `bazel_dep` trực tiếp được khai báo trong mô-đun gốc có phải là các phiên bản mà bạn nhận được trong biểu đồ phần phụ thuộc đã được phân giải hay không. Các giá trị hợp lệ là "off" để tắt tính năng kiểm tra, "warning" để in cảnh báo khi phát hiện thấy không khớp hoặc "error" để chuyển lên lỗi phân giải.
Thẻ:loading_and_analysis
- Giá trị mặc định của
--[no]ignore_dev_dependency
: "false" - Nếu đúng, Bazel sẽ bỏ qua "bazel_dep" và "use_extension" được khai báo là "dev_dependency" trong MODULE.bazel của mô-đun gốc. Xin lưu ý rằng các phần phụ thuộc dành cho nhà phát triển đó luôn bị bỏ qua trong MODULE.bazel nếu đó không phải là mô-đun gốc, bất kể giá trị của cờ này là gì.
Thẻ:loading_and_analysis
--lockfile_mode=<off, update, refresh or error>
mặc định: "cập nhật"-
Chỉ định cách thức và liệu có sử dụng tệp khoá hay không. Các giá trị hợp lệ là "update" để sử dụng tệp khoá và cập nhật tệp khoá nếu có thay đổi, "refresh" để thỉnh thoảng làm mới thông tin có thể thay đổi (các phiên bản bị loại bỏ và các mô-đun bị thiếu trước đó) từ các sổ đăng ký từ xa, "error" để sử dụng tệp khoá nhưng gửi lỗi nếu tệp khoá không được cập nhật hoặc "off" để không đọc hoặc ghi vào tệp khoá.
Thẻ:loading_and_analysis
--override_module=<an equals-separated mapping of module name to path>
nhiều lần sử dụng được tích luỹ- Ghi đè một mô-đun bằng đường dẫn cục bộ ở dạng <tên mô-đun>=<đường dẫn>. Nếu đường dẫn đã cho là đường dẫn tuyệt đối, thì đường dẫn đó sẽ được sử dụng nguyên trạng. Nếu đường dẫn đã cho là đường dẫn tương đối, thì đường dẫn đó sẽ tương ứng với thư mục đang hoạt động. Nếu đường dẫn đã cho bắt đầu bằng "%workspace%", thì đường dẫn đó sẽ tương ứng với thư mục gốc của không gian làm việc, là kết quả của lệnh "bazel info workspace". Nếu đường dẫn đã cho trống, hãy xoá mọi chế độ ghi đè trước đó.
--registry=<a string>
nhiều lần sử dụng được tích luỹ- Chỉ định các sổ đăng ký cần sử dụng để xác định vị trí các phần phụ thuộc mô-đun Bazel. Thứ tự rất quan trọng: các mô-đun sẽ được tra cứu trong các sổ đăng ký trước đó trước tiên và chỉ quay lại các sổ đăng ký sau này khi các mô-đun đó bị thiếu trong các sổ đăng ký trước đó.
Thẻ:changes_inputs
--vendor_dir=<a path>
mặc định: xem nội dung mô tả-
Chỉ định thư mục sẽ chứa các kho lưu trữ bên ngoài ở chế độ nhà cung cấp, cho dù mục đích là tìm nạp các kho lưu trữ đó vào thư mục hay sử dụng các kho lưu trữ đó trong khi xây dựng. Bạn có thể chỉ định đường dẫn dưới dạng đường dẫn tuyệt đối hoặc đường dẫn tương đối đến thư mục không gian làm việc.
Thẻ:loading_and_analysis
- Các tuỳ chọn kích hoạt tính năng tối ưu hoá thời gian xây dựng:
--gc_thrashing_limits=<comma separated pairs of <period>:<count>>
mặc định: "1s:2,20s:3,1m:5"-
Các giới hạn nếu đạt đến sẽ khiến GcThrashingDetector gặp sự cố Bazel với OOM. Mỗi giới hạn được chỉ định là <period>:<count>, trong đó period là thời lượng và count là số nguyên dương. Nếu hơn --gc_thrashing_threshold phần trăm không gian cố định (vùng nhớ khối xếp cũ) vẫn bị chiếm dụng sau <count> lần GC đầy đủ liên tiếp trong <period>, thì lỗi OOM sẽ được kích hoạt. Bạn có thể chỉ định nhiều giới hạn, phân tách bằng dấu phẩy.
Thẻ:host_machine_resource_optimizations
--skyframe_high_water_mark_full_gc_drops_per_invocation=<an integer, >= 0>
mặc định: "2147483647"-
Cờ cho cấu hình nâng cao của công cụ Skyframe nội bộ của Bazel. Nếu phát hiện mức sử dụng phần trăm vùng nhớ khối xếp được giữ lại vượt quá ngưỡng do --skyframe_high_water_mark_threshold đặt ra, thì khi một sự kiện GC đầy đủ xảy ra, Bazel sẽ loại bỏ trạng thái Skyframe tạm thời không cần thiết, lên đến nhiều lần như vậy cho mỗi lệnh gọi. Mặc định là Integer.MAX_VALUE; không giới hạn về mặt hiệu quả. Giá trị 0 có nghĩa là các sự kiện GC đầy đủ sẽ không bao giờ kích hoạt sự kiện thả. Nếu đạt đến giới hạn, trạng thái Skyframe sẽ không còn bị loại bỏ khi một sự kiện GC đầy đủ xảy ra và vượt quá ngưỡng phần trăm vùng nhớ khối xếp được giữ lại đó.
Thẻ:host_machine_resource_optimizations
--skyframe_high_water_mark_minor_gc_drops_per_invocation=<an integer, >= 0>
mặc định: "2147483647"-
Cờ cho cấu hình nâng cao của công cụ Skyframe nội bộ của Bazel. Nếu phát hiện mức sử dụng phần trăm vùng nhớ khối xếp được giữ lại vượt quá ngưỡng do --skyframe_high_water_mark_threshold đặt ra, thì khi một sự kiện GC nhỏ xảy ra, Bazel sẽ loại bỏ trạng thái Skyframe tạm thời không cần thiết, lên đến nhiều lần như vậy mỗi lần gọi. Mặc định là Integer.MAX_VALUE; không giới hạn về mặt hiệu quả. Giá trị 0 có nghĩa là các sự kiện GC nhỏ sẽ không bao giờ kích hoạt sự kiện thả. Nếu đạt đến giới hạn, trạng thái Skyframe sẽ không còn bị loại bỏ khi một sự kiện GC nhỏ xảy ra và vượt quá ngưỡng phần trăm vùng nhớ khối xếp được giữ lại.
Thẻ:host_machine_resource_optimizations
--skyframe_high_water_mark_threshold=<an integer>
mặc định: "85"-
Cờ cho cấu hình nâng cao của công cụ Skyframe nội bộ của Bazel. Nếu phát hiện mức sử dụng phần trăm vùng nhớ khối xếp được giữ lại ít nhất là ngưỡng này, Bazel sẽ loại bỏ trạng thái Skyframe tạm thời không cần thiết. Việc điều chỉnh điều này có thể giúp bạn giảm thiểu tác động của tình trạng GC bị lỗi khi (i) tình trạng này là do mức sử dụng bộ nhớ của trạng thái tạm thời và (ii) tốn kém hơn so với việc tạo lại trạng thái khi cần.
Thẻ:host_machine_resource_optimizations
- Các tuỳ chọn ảnh hưởng đến mức độ chi tiết, định dạng hoặc vị trí ghi nhật ký:
--experimental_command_profile=<cpu, wall, alloc or lock>
mặc định: xem nội dung mô tả- Ghi hồ sơ Trình ghi chuyến bay Java trong thời gian thực thi lệnh. Bạn phải cung cấp một trong các loại sự kiện phân tích tài nguyên được hỗ trợ (cpu, wall, alloc hoặc lock) dưới dạng đối số. Hồ sơ được ghi vào một tệp được đặt tên theo loại sự kiện trong thư mục cơ sở đầu ra. Cú pháp và ngữ nghĩa của cờ này có thể thay đổi trong tương lai để hỗ trợ thêm các loại hồ sơ hoặc định dạng đầu ra; bạn tự chịu rủi ro khi sử dụng.
- Giá trị mặc định của
--[no]experimental_record_metrics_for_all_mnemonics
: "false" - Theo mặc định, số lượng loại thao tác được giới hạn ở 20 câu thần chú có số lượng thao tác được thực thi nhiều nhất. Việc đặt tuỳ chọn này sẽ ghi số liệu thống kê cho tất cả các câu thần chú.
- Các tuỳ chọn chỉ định hoặc thay đổi dữ liệu đầu vào chung thành một lệnh Bazel không thuộc các danh mục khác.:
--experimental_resolved_file_instead_of_workspace=<a string>
mặc định: ""- Nếu không trống, hãy đọc tệp đã phân giải được chỉ định thay vì tệp WORKSPACE
Thẻ:changes_inputs
- Các tuỳ chọn thực thi và lưu vào bộ nhớ đệm từ xa:
--experimental_downloader_config=<a string>
mặc định: xem nội dung mô tả- Chỉ định một tệp để định cấu hình trình tải xuống từ xa. Tệp này bao gồm các dòng, mỗi dòng bắt đầu bằng một lệnh (`allow`, `block` hoặc `rewrite`), theo sau là tên máy chủ lưu trữ (đối với lệnh `allow` và `block`) hoặc hai mẫu, một mẫu để so khớp và một mẫu để sử dụng làm URL thay thế, với các tệp tham chiếu ngược bắt đầu từ `$1`. Bạn có thể cung cấp nhiều lệnh `rewrite` cho cùng một URL và trong trường hợp này, nhiều URL sẽ được trả về.
- Giá trị mặc định của
--experimental_worker_for_repo_fetching=<off, platform, virtual or auto>
: "tự động" - Chế độ tạo luồng để tìm nạp kho lưu trữ. Nếu bạn đặt thành "tắt", thì không có luồng worker nào được sử dụng và quá trình tìm nạp kho lưu trữ sẽ phải khởi động lại. Nếu không, hãy sử dụng luồng worker ảo.
- Các tuỳ chọn khác, không được phân loại theo cách khác.:
--override_repository=<an equals-separated mapping of repository name to path>
nhiều lần sử dụng được tích luỹ- Ghi đè kho lưu trữ bằng một đường dẫn cục bộ ở dạng <repository name>=<path>. Nếu đường dẫn đã cho là đường dẫn tuyệt đối, thì đường dẫn đó sẽ được sử dụng nguyên trạng. Nếu đường dẫn đã cho là đường dẫn tương đối, thì đường dẫn đó sẽ tương ứng với thư mục đang hoạt động. Nếu đường dẫn đã cho bắt đầu bằng "%workspace%", thì đường dẫn đó sẽ tương ứng với thư mục gốc của không gian làm việc, là kết quả của lệnh "bazel info workspace". Nếu đường dẫn đã cho trống, hãy xoá mọi chế độ ghi đè trước đó.
Tuỳ chọn cài đặt trên thiết bị di động
Kế thừa tất cả các tuỳ chọn từ build.
- Các tuỳ chọn xuất hiện trước lệnh và được máy khách phân tích cú pháp:
--distdir=<a path>
nhiều lần sử dụng được tích luỹ-
Các vị trí khác để tìm kiếm bản lưu trữ trước khi truy cập vào mạng để tải xuống.
Thẻ:bazel_internal_configuration
- Giá trị mặc định của
--[no]experimental_repository_cache_hardlinks
: "false" - Nếu được đặt, bộ nhớ đệm kho lưu trữ sẽ liên kết cứng tệp trong trường hợp có lượt truy cập vào bộ nhớ đệm, thay vì sao chép. Việc này nhằm tiết kiệm dung lượng ổ đĩa.
Thẻ:bazel_internal_configuration
--experimental_repository_downloader_retries=<an integer>
mặc định: "0"-
Số lần thử tối đa để thử lại lỗi tải xuống. Nếu bạn đặt thành 0, thì tính năng thử lại sẽ bị tắt.
Thẻ:experimental
--experimental_scale_timeouts=<a double>
mặc định: "1.0"- Điều chỉnh tất cả thời gian chờ trong quy tắc kho lưu trữ Starlark theo hệ số này. Bằng cách này, bạn có thể làm cho kho lưu trữ bên ngoài hoạt động trên các máy chạy chậm hơn dự kiến của tác giả quy tắc mà không cần thay đổi mã nguồn
Thẻ:bazel_internal_configuration
,experimental
- Giá trị mặc định của
--[no]incompatible_disable_native_repo_rules
: "false" - Nếu giá trị là false, bạn có thể sử dụng các quy tắc kho lưu trữ gốc trong WORKSPACE; nếu không, bạn phải sử dụng các quy tắc kho lưu trữ Starlark. Các quy tắc kho lưu trữ gốc bao gồm local_repository, new_local_repository, local_config_platform, android_sdk_repository và android_ndk_repository.
Thẻ:bazel_internal_configuration
--repository_cache=<a path>
mặc định: xem nội dung mô tả- Chỉ định vị trí bộ nhớ đệm của các giá trị đã tải xuống thu được trong quá trình tìm nạp kho lưu trữ bên ngoài. Chuỗi trống làm đối số yêu cầu tắt bộ nhớ đệm, nếu không, giá trị mặc định là "<output_user_root>/cache/repos/v1" sẽ được sử dụng
Thẻ:bazel_internal_configuration
- Giá trị mặc định của
--[no]repository_disable_download
: "false" - Nếu được đặt, bạn không được phép tải xuống bằng ctx.download{,_and_extract} trong quá trình tìm nạp kho lưu trữ. Xin lưu ý rằng quyền truy cập mạng không bị tắt hoàn toàn; ctx.execute vẫn có thể chạy một tệp thực thi tuỳ ý truy cập Internet.
Thẻ:bazel_internal_configuration
- Các tuỳ chọn kiểm soát việc thực thi bản dựng:
- Giá trị mặc định của
--gc_thrashing_threshold=<an integer in 0-100 range>
: "100" -
Tỷ lệ phần trăm không gian cố định bị chiếm dụng (0-100) mà tại đó GcThrashingDetector xem xét các sự kiện áp lực bộ nhớ so với giới hạn của nó (--gc_thrashing_limits). Nếu bạn đặt thành 100, GcThrashingDetector sẽ bị tắt.
Thẻ:host_machine_resource_optimizations
--mode=<classic, classic_internal_test_do_not_use or skylark>
mặc định: "cổ điển"-
Chọn cách chạy lượt cài đặt trên thiết bị di động. "classic" chạy phiên bản hiện tại của mobile-install. "skylark" sử dụng phiên bản Starlark mới, có hỗ trợ cho android_test.
Thẻ:loading_and_analysis
,execution
,incompatible_change
- Các tuỳ chọn định cấu hình chuỗi công cụ dùng để thực thi hành động:
--adb=<a string>
mặc định: ""
Tệp nhị phân adb - để sử dụng cho lệnh "mobile-install". Nếu không chỉ định, SDK trong SDK Android do tuỳ chọn dòng lệnh --android_sdk chỉ định (hoặc SDK mặc định nếu không chỉ định --android_sdk) sẽ được sử dụng.
Thẻ:changes_inputs
- Các tuỳ chọn kiểm soát đầu ra của lệnh:
- Giá trị mặc định của
--[no]incremental
: "false" -
Liệu có nên cài đặt tăng dần hay không. Nếu đúng, hãy cố gắng tránh làm thêm công việc không cần thiết bằng cách đọc trạng thái của thiết bị mà mã sẽ được cài đặt và sử dụng thông tin đó để tránh làm thêm công việc không cần thiết. Nếu giá trị là false (mặc định), hãy luôn cài đặt đầy đủ.
Thẻ:loading_and_analysis
- Giá trị mặc định của
--[no]split_apks
: "false" -
Liệu có nên 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ỉ hoạt động với các thiết bị chạy Marshmallow trở lên
Thẻ
:loading_and_analysis
,affects_outputs
- Các tuỳ chọn cho phép người dùng định cấu hình đầu ra dự kiến, ảnh hưởng đến giá trị của đầu ra đó, thay vì sự tồn tại của đầu ra:
--adb_arg=<a string>
nhiều lần sử dụng được tích luỹ-
Các đối số bổ sung để truyền đến adb. Thường dùng để chỉ định một thiết bị để cài đặt.
Thẻ:action_command_lines
--debug_app
-
Có nên chờ trình gỡ lỗi trước khi khởi động ứng dụng hay không.
Mở rộng thành:
--start=DEBUG
Thẻ:execution
--device=<a string>
mặc định: ""- Số sê-ri của thiết bị adb. Nếu bạn không chỉ định, hệ thống sẽ sử dụng thiết bị đầu tiên.
Thẻ:action_command_lines
- Giá trị mặc định của
--start=<no, cold, warm or debug>
: "KHÔNG" -
Cách khởi động ứng dụng sau khi cài đặt. Đặt thành WARM để giữ lại và khôi phục trạng thái ứng dụng trên các lượt cài đặt gia tăng.
Thẻ:execution
--start_app
-
Liệu có khởi động ứng dụng sau khi cài đặt hay không.
Mở rộng thành:
--start=COLD
Thẻ:execution
- Các tuỳ chọn liên quan đến kết quả và ngữ nghĩa của Bzlmod:
--allow_yanked_versions=<a string>
nhiều lần sử dụng được tích luỹ-
Chỉ định các phiên bản mô-đun ở dạng `<module1>@<version1>,<module2>@<version2>` sẽ được cho phép trong biểu đồ phần phụ thuộc đã phân giải ngay cả khi các phiên bản đó được khai báo là đã bị xoá trong sổ đăng ký nơi chúng đến (nếu không đến từ NonRegistryOverride). Nếu không, các phiên bản bị xoá sẽ khiến việc phân giải không thành công. Bạn cũng có thể xác định phiên bản bị xoá được phép bằng biến môi trường `BZLMOD_ALLOW_YANKED_VERSIONS`. Bạn có thể tắt tính năng kiểm tra này bằng cách sử dụng từ khoá "tất cả" (không nên dùng).
Thẻ:loading_and_analysis
--check_bazel_compatibility=<error, warning or off>
mặc định: "lỗi"-
Kiểm tra khả năng tương thích của phiên bản bazel của các mô-đun Bazel. Các giá trị hợp lệ là "error" để chuyển vấn đề này lên lỗi phân giải, "off" để tắt tính năng kiểm tra hoặc "warning" để in cảnh báo khi phát hiện thấy không khớp.
Thẻ:loading_and_analysis
--check_direct_dependencies=<off, warning or error>
mặc định: "cảnh báo"-
Kiểm tra xem các phần phụ thuộc `bazel_dep` trực tiếp được khai báo trong mô-đun gốc có phải là các phiên bản mà bạn nhận được trong biểu đồ phần phụ thuộc đã được phân giải hay không. Các giá trị hợp lệ là "off" để tắt tính năng kiểm tra, "warning" để in cảnh báo khi phát hiện thấy không khớp hoặc "error" để chuyển lên lỗi phân giải.
Thẻ:loading_and_analysis
- Giá trị mặc định của
--[no]ignore_dev_dependency
: "false" - Nếu đúng, Bazel sẽ bỏ qua "bazel_dep" và "use_extension" được khai báo là "dev_dependency" trong MODULE.bazel của mô-đun gốc. Xin lưu ý rằng các phần phụ thuộc dành cho nhà phát triển đó luôn bị bỏ qua trong MODULE.bazel nếu đó không phải là mô-đun gốc, bất kể giá trị của cờ này là gì.
Thẻ:loading_and_analysis
--lockfile_mode=<off, update, refresh or error>
mặc định: "cập nhật"-
Chỉ định cách thức và liệu có sử dụng tệp khoá hay không. Các giá trị hợp lệ là "update" để sử dụng tệp khoá và cập nhật tệp khoá nếu có thay đổi, "refresh" để thỉnh thoảng làm mới thông tin có thể thay đổi (các phiên bản bị loại bỏ và các mô-đun bị thiếu trước đó) từ các sổ đăng ký từ xa, "error" để sử dụng tệp khoá nhưng gửi lỗi nếu tệp khoá không được cập nhật hoặc "off" để không đọc hoặc ghi vào tệp khoá.
Thẻ:loading_and_analysis
--override_module=<an equals-separated mapping of module name to path>
nhiều lần sử dụng được tích luỹ- Ghi đè một mô-đun bằng đường dẫn cục bộ ở dạng <tên mô-đun>=<đường dẫn>. Nếu đường dẫn đã cho là đường dẫn tuyệt đối, thì đường dẫn đó sẽ được sử dụng nguyên trạng. Nếu đường dẫn đã cho là đường dẫn tương đối, thì đường dẫn đó sẽ tương ứng với thư mục đang hoạt động. Nếu đường dẫn đã cho bắt đầu bằng "%workspace%", thì đường dẫn đó sẽ tương ứng với thư mục gốc của không gian làm việc, là kết quả của lệnh "bazel info workspace". Nếu đường dẫn đã cho trống, hãy xoá mọi chế độ ghi đè trước đó.
--registry=<a string>
nhiều lần sử dụng được tích luỹ- Chỉ định các sổ đăng ký cần sử dụng để xác định vị trí các phần phụ thuộc mô-đun Bazel. Thứ tự rất quan trọng: các mô-đun sẽ được tra cứu trong các sổ đăng ký trước đó trước tiên và chỉ quay lại các sổ đăng ký sau này khi các mô-đun đó bị thiếu trong các sổ đăng ký trước đó.
Thẻ:changes_inputs
--vendor_dir=<a path>
mặc định: xem nội dung mô tả-
Chỉ định thư mục sẽ chứa các kho lưu trữ bên ngoài ở chế độ nhà cung cấp, cho dù mục đích là tìm nạp các kho lưu trữ đó vào thư mục hay sử dụng các kho lưu trữ đó trong khi xây dựng. Bạn có thể chỉ định đường dẫn dưới dạng đường dẫn tuyệt đối hoặc đường dẫn tương đối đến thư mục không gian làm việc.
Thẻ:loading_and_analysis
- Các tuỳ chọn kích hoạt tính năng tối ưu hoá thời gian xây dựng:
--gc_thrashing_limits=<comma separated pairs of <period>:<count>>
mặc định: "1s:2,20s:3,1m:5"-
Các giới hạn nếu đạt đến sẽ khiến GcThrashingDetector gặp sự cố Bazel với OOM. Mỗi giới hạn được chỉ định là <period>:<count>, trong đó period là thời lượng và count là số nguyên dương. Nếu hơn --gc_thrashing_threshold phần trăm không gian cố định (vùng nhớ khối xếp cũ) vẫn bị chiếm dụng sau <count> lần GC đầy đủ liên tiếp trong <period>, thì lỗi OOM sẽ được kích hoạt. Bạn có thể chỉ định nhiều giới hạn, phân tách bằng dấu phẩy.
Thẻ:host_machine_resource_optimizations
--skyframe_high_water_mark_full_gc_drops_per_invocation=<an integer, >= 0>
mặc định: "2147483647"-
Cờ cho cấu hình nâng cao của công cụ Skyframe nội bộ của Bazel. Nếu phát hiện mức sử dụng phần trăm vùng nhớ khối xếp được giữ lại vượt quá ngưỡng do --skyframe_high_water_mark_threshold đặt ra, thì khi một sự kiện GC đầy đủ xảy ra, Bazel sẽ loại bỏ trạng thái Skyframe tạm thời không cần thiết, lên đến nhiều lần như vậy cho mỗi lệnh gọi. Mặc định là Integer.MAX_VALUE; không giới hạn về mặt hiệu quả. Giá trị 0 có nghĩa là các sự kiện GC đầy đủ sẽ không bao giờ kích hoạt sự kiện thả. Nếu đạt đến giới hạn, trạng thái Skyframe sẽ không còn bị loại bỏ khi một sự kiện GC đầy đủ xảy ra và vượt quá ngưỡng phần trăm vùng nhớ khối xếp được giữ lại đó.
Thẻ:host_machine_resource_optimizations
--skyframe_high_water_mark_minor_gc_drops_per_invocation=<an integer, >= 0>
mặc định: "2147483647"-
Cờ cho cấu hình nâng cao của công cụ Skyframe nội bộ của Bazel. Nếu phát hiện mức sử dụng phần trăm vùng nhớ khối xếp được giữ lại vượt quá ngưỡng do --skyframe_high_water_mark_threshold đặt ra, thì khi một sự kiện GC nhỏ xảy ra, Bazel sẽ loại bỏ trạng thái Skyframe tạm thời không cần thiết, lên đến nhiều lần như vậy mỗi lần gọi. Mặc định là Integer.MAX_VALUE; không giới hạn về mặt hiệu quả. Giá trị 0 có nghĩa là các sự kiện GC nhỏ sẽ không bao giờ kích hoạt sự kiện thả. Nếu đạt đến giới hạn, trạng thái Skyframe sẽ không còn bị loại bỏ khi một sự kiện GC nhỏ xảy ra và vượt quá ngưỡng phần trăm vùng nhớ khối xếp được giữ lại.
Thẻ:host_machine_resource_optimizations
--skyframe_high_water_mark_threshold=<an integer>
mặc định: "85"-
Cờ cho cấu hình nâng cao của công cụ Skyframe nội bộ của Bazel. Nếu phát hiện mức sử dụng phần trăm vùng nhớ khối xếp được giữ lại ít nhất là ngưỡng này, Bazel sẽ loại bỏ trạng thái Skyframe tạm thời không cần thiết. Việc điều chỉnh điều này có thể giúp bạn giảm thiểu tác động của tình trạng GC bị lỗi khi (i) tình trạng này là do mức sử dụng bộ nhớ của trạng thái tạm thời và (ii) tốn kém hơn so với việc tạo lại trạng thái khi cần.
Thẻ:host_machine_resource_optimizations
- Các tuỳ chọn ảnh hưởng đến mức độ chi tiết, định dạng hoặc vị trí ghi nhật ký:
--experimental_command_profile=<cpu, wall, alloc or lock>
mặc định: xem nội dung mô tả- Ghi hồ sơ Trình ghi chuyến bay Java trong thời gian thực thi lệnh. Bạn phải cung cấp một trong các loại sự kiện phân tích tài nguyên được hỗ trợ (cpu, wall, alloc hoặc lock) dưới dạng đối số. Hồ sơ được ghi vào một tệp được đặt tên theo loại sự kiện trong thư mục cơ sở đầu ra. Cú pháp và ngữ nghĩa của cờ này có thể thay đổi trong tương lai để hỗ trợ thêm các loại hồ sơ hoặc định dạng đầu ra; bạn tự chịu rủi ro khi sử dụng.
- Giá trị mặc định của
--[no]experimental_record_metrics_for_all_mnemonics
: "false" - Theo mặc định, số lượng loại thao tác được giới hạn ở 20 câu thần chú có số lượng thao tác được thực thi nhiều nhất. Việc đặt tuỳ chọn này sẽ ghi số liệu thống kê cho tất cả các câu thần chú.
--incremental_install_verbosity=<a string>
mặc định: ""-
Mức độ chi tiết cho quá trình cài đặt gia tăng. Đặt thành 1 để ghi nhật ký gỡ lỗi.
Thẻ:bazel_monitoring
- Các tuỳ chọn chỉ định hoặc thay đổi dữ liệu đầu vào chung cho một lệnh Bazel không thuộc các danh mục khác.:
--experimental_resolved_file_instead_of_workspace=<a string>
mặc định: ""- Nếu không trống, hãy đọc tệp đã phân giải được chỉ định thay vì tệp WORKSPACE
Thẻ:changes_inputs
- Các tuỳ chọn thực thi và lưu vào bộ nhớ đệm từ xa:
--experimental_downloader_config=<a string>
mặc định: xem nội dung mô tả- Chỉ định một tệp để định cấu hình trình tải xuống từ xa. Tệp này bao gồm các dòng, mỗi dòng bắt đầu bằng một lệnh (`allow`, `block` hoặc `rewrite`), theo sau là tên máy chủ lưu trữ (đối với lệnh `allow` và `block`) hoặc hai mẫu, một mẫu để so khớp và một mẫu để sử dụng làm URL thay thế, với các tệp tham chiếu ngược bắt đầu từ `$1`. Bạn có thể cung cấp nhiều lệnh `rewrite` cho cùng một URL và trong trường hợp này, nhiều URL sẽ được trả về.
- Giá trị mặc định của
--experimental_worker_for_repo_fetching=<off, platform, virtual or auto>
: "tự động" - Chế độ tạo luồng để tìm nạp kho lưu trữ. Nếu bạn đặt thành "tắt", thì không có luồng worker nào được sử dụng và quá trình tìm nạp kho lưu trữ sẽ phải khởi động lại. Nếu không, hãy sử dụng luồng worker ảo.
- Các tuỳ chọn khác, không được phân loại theo cách khác.:
--override_repository=<an equals-separated mapping of repository name to path>
nhiều lần sử dụng được tích luỹ- Ghi đè kho lưu trữ bằng một đường dẫn cục bộ ở dạng <repository name>=<path>. Nếu đường dẫn đã cho là đường dẫn tuyệt đối, thì đường dẫn đó sẽ được sử dụng nguyên trạng. Nếu đường dẫn đã cho là đường dẫn tương đối, thì đường dẫn đó sẽ tương ứng với thư mục đang hoạt động. Nếu đường dẫn đã cho bắt đầu bằng "%workspace%", thì đường dẫn đó sẽ tương ứng với thư mục gốc của không gian làm việc, là kết quả của lệnh "bazel info workspace". Nếu đường dẫn đã cho trống, hãy xoá mọi chế độ ghi đè trước đó.
Tuỳ chọn mod
- Các tuỳ chọn xuất hiện trước lệnh và được máy khách phân tích cú pháp:
--distdir=<a path>
nhiều lần sử dụng được tích luỹ-
Các vị trí khác để tìm kiếm bản lưu trữ trước khi truy cập vào mạng để tải xuống.
Thẻ:bazel_internal_configuration
- Giá trị mặc định của
--[no]experimental_repository_cache_hardlinks
: "false" - Nếu được đặt, bộ nhớ đệm kho lưu trữ sẽ liên kết cứng tệp trong trường hợp có lượt truy cập vào bộ nhớ đệm, thay vì sao chép. Việc này nhằm tiết kiệm dung lượng ổ đĩa.
Thẻ:bazel_internal_configuration
--experimental_repository_downloader_retries=<an integer>
mặc định: "0"-
Số lần thử tối đa để thử lại lỗi tải xuống. Nếu bạn đặt thành 0, thì tính năng thử lại sẽ bị tắt.
Thẻ:experimental
--experimental_scale_timeouts=<a double>
mặc định: "1.0"- Điều chỉnh tất cả thời gian chờ trong quy tắc kho lưu trữ Starlark theo hệ số này. Bằng cách này, bạn có thể làm cho kho lưu trữ bên ngoài hoạt động trên các máy chạy chậm hơn dự kiến của tác giả quy tắc mà không cần thay đổi mã nguồn
Thẻ:bazel_internal_configuration
,experimental
- Giá trị mặc định của
--[no]incompatible_disable_native_repo_rules
: "false" - Nếu giá trị là false, bạn có thể sử dụng các quy tắc kho lưu trữ gốc trong WORKSPACE; nếu không, bạn phải sử dụng các quy tắc kho lưu trữ Starlark. Các quy tắc kho lưu trữ gốc bao gồm local_repository, new_local_repository, local_config_platform, android_sdk_repository và android_ndk_repository.
Thẻ:bazel_internal_configuration
--repository_cache=<a path>
mặc định: xem nội dung mô tả- Chỉ định vị trí bộ nhớ đệm của các giá trị đã tải xuống thu được trong quá trình tìm nạp kho lưu trữ bên ngoài. Chuỗi trống làm đối số yêu cầu tắt bộ nhớ đệm, nếu không, giá trị mặc định là "<output_user_root>/cache/repos/v1" sẽ được sử dụng
Thẻ:bazel_internal_configuration
- Giá trị mặc định của
--[no]repository_disable_download
: "false" - Nếu được đặt, bạn không được phép tải xuống bằng ctx.download{,_and_extract} trong quá trình tìm nạp kho lưu trữ. Xin lưu ý rằng quyền truy cập mạng không bị tắt hoàn toàn; ctx.execute vẫn có thể chạy một tệp thực thi tuỳ ý truy cập Internet.
Thẻ:bazel_internal_configuration
- Các tuỳ chọn kiểm soát việc thực thi bản dựng:
- Giá trị mặc định của
--gc_thrashing_threshold=<an integer in 0-100 range>
: "100" -
Tỷ lệ phần trăm không gian cố định bị chiếm dụng (0-100) mà tại đó GcThrashingDetector xem xét các sự kiện áp lực bộ nhớ so với giới hạn của nó (--gc_thrashing_limits). Nếu bạn đặt thành 100, GcThrashingDetector sẽ bị tắt.
Thẻ:host_machine_resource_optimizations
--[no]keep_going
[-k
] mặc định: "false"-
Tiếp tục nhiều nhất có thể sau khi xảy ra lỗi. Mặc dù không thể phân tích mục tiêu không thành công và các mục tiêu phụ thuộc vào mục tiêu đó, nhưng bạn có thể phân tích các điều kiện tiên quyết khác của các mục tiêu này.
Thẻ:eagerness_to_exit
- Giá trị mặc định của
--loading_phase_threads=<an integer, or a keyword ("auto", "HOST_CPUS", "HOST_RAM"), optionally followed by an operation ([-|*]<float>) eg. "auto", "HOST_CPUS*.5">
: "tự động" - Số luồng song song cần sử dụng cho giai đoạn tải/phân tích. Nhận một số nguyên hoặc từ khoá ("tự động", "HOST_CPUS", "HOST_RAM"), theo sau có thể là một phép toán ([-|*]<float>) ví dụ: "tự động", "HOST_CPUS*.5". "tự động" đặt giá trị mặc định hợp lý dựa trên tài nguyên của máy chủ lưu trữ. Phải ít nhất là 1.
Thẻ:bazel_internal_configuration
- Tuỳ chọn này ảnh hưởng đến ngữ nghĩa của ngôn ngữ Starlark hoặc API bản dựng có thể truy cập vào các tệp BUILD, tệp .bzl hoặc tệp WORKSPACE.:
- Giá trị mặc định của
--[no]incompatible_config_setting_private_default_visibility
: "false" - Nếu incompatible_enforce_config_setting_visibility=false, thì đây là một thao tác không có tác dụng. Nếu không, nếu cờ này là false, mọi config_setting không có thuộc tính chế độ hiển thị rõ ràng sẽ là //visibility:public. Nếu cờ này là true, config_setting sẽ tuân theo logic hiển thị giống như tất cả các quy tắc khác. Xem https://github.com/bazelbuild/bazel/issues/12933.
Thẻ:loading_and_analysis
,incompatible_change
- Giá trị mặc định của
--[no]incompatible_enforce_config_setting_visibility
: "true" - Nếu đúng, hãy thực thi các quy định hạn chế về chế độ hiển thị config_setting. Nếu giá trị là false, mọi mục config_setting đều hiển thị với mọi mục tiêu. Xem https://github.com/bazelbuild/bazel/issues/12932.
Thẻ:loading_and_analysis
,incompatible_change
- Các tuỳ chọn liên quan đến đầu ra và ngữ nghĩa của lệnh con `mod`:
--base_module=<"<root>" for the root module; <module>@<version> for a specific version of a module; <module> for all versions of a module; @<name> for a repo with the given apparent name; or @@<name> for a repo with the given canonical name>
mặc định: "<root>"-
Chỉ định một mô-đun tương ứng với các kho lưu trữ mục tiêu đã chỉ định sẽ được diễn giải.
Thẻ:terminal_output
--charset=<utf8 or ascii>
mặc định: "utf8"- Chọn bộ ký tự để sử dụng cho cây. Chỉ ảnh hưởng đến đầu ra văn bản. Các giá trị hợp lệ là "utf8" hoặc "ascii". Mặc định là "utf8"
Thẻ:terminal_output
- Giá trị mặc định của
--[no]cycles
: "false" -
Chỉ ra các vòng lặp phần phụ thuộc bên trong cây hiển thị, thường bị bỏ qua theo mặc định.
Thẻ:terminal_output
--depth=<an integer>
mặc định: "-1"-
Độ sâu hiển thị tối đa của cây phần phụ thuộc. Ví dụ: độ sâu 1 hiển thị các phần phụ thuộc trực tiếp. Đối với tree, path và all_paths, giá trị mặc định là Integer.MAX_VALUE, trong khi đối với deps và explain, giá trị mặc định là 1 (chỉ hiển thị các phần phụ thuộc trực tiếp của thư mục gốc ngoài các lá mục tiêu và phần phụ thuộc mẹ của chúng).
Thẻ:terminal_output
--extension_filter=<a comma-separated list of <extension>s>
mặc định: xem nội dung mô tả-
Chỉ hiển thị cách sử dụng các tiện ích mô-đun này và kho lưu trữ do các tiện ích đó tạo ra nếu bạn đặt cờ tương ứng. Nếu được đặt, biểu đồ kết quả sẽ chỉ bao gồm các đường dẫn chứa các mô-đun sử dụng các tiện ích đã chỉ định. Danh sách trống sẽ vô hiệu hoá bộ lọc, giúp chỉ định hiệu quả tất cả các tiện ích có thể có.
Thẻ:terminal_output
--extension_info=<hidden, usages, repos or all>
mặc định: "ẩn"- Chỉ định mức độ chi tiết về cách sử dụng tiện ích để đưa vào kết quả truy vấn. "Số lượt sử dụng" sẽ chỉ hiển thị tên tiện ích, "kho lưu trữ" cũng sẽ bao gồm các kho lưu trữ được nhập bằng use_repo và "tất cả" cũng sẽ hiển thị các kho lưu trữ khác do tiện ích tạo.
Thẻ:terminal_output
--extension_usages=<a comma-separated list of <module>s>
mặc định: ""-
Chỉ định các mô-đun có cách sử dụng tiện ích sẽ hiển thị trong truy vấn show_extension.
Thẻ:terminal_output
--from=<a comma-separated list of <module>s>
mặc định: "<root>"- (Các) mô-đun bắt đầu từ đó truy vấn biểu đồ phần phụ thuộc sẽ hiển thị. Kiểm tra nội dung mô tả của từng truy vấn để biết ngữ nghĩa chính xác. Giá trị mặc định là <root>.
Thẻ:terminal_output
- Giá trị mặc định của
--[no]include_builtin
: "false" -
Thêm các mô-đun tích hợp sẵn vào biểu đồ phần phụ thuộc. Tắt theo mặc định vì khá ồn.
Thẻ:terminal_output
- Giá trị mặc định của
--[no]include_unused
: "false" -
Các truy vấn cũng sẽ tính đến và hiển thị các mô-đun không sử dụng, không có trong biểu đồ phân giải mô-đun sau khi chọn (do lựa chọn Phiên bản tối thiểu hoặc các quy tắc ghi đè). Điều này có thể có các hiệu ứng khác nhau đối với từng loại truy vấn, tức là bao gồm các đường dẫn mới trong lệnh all_paths hoặc các phần phụ thuộc bổ sung trong lệnh explain.
Thẻ:terminal_output
--output=<text, json or graph>
mặc định: "text"-
Định dạng in kết quả truy vấn. Các giá trị được phép cho truy vấn là: văn bản, json, biểu đồ
Thẻ:terminal_output
- Giá trị mặc định của
--[no]verbose
: "false" -
Các truy vấn cũng sẽ cho biết lý do các mô-đun được phân giải thành phiên bản hiện tại (nếu thay đổi). Giá trị mặc định là đúng chỉ dành cho truy vấn giải thích.
Thẻ:terminal_output
- Các tuỳ chọn liên quan đến đầu ra và ngữ nghĩa của Bzlmod:
--allow_yanked_versions=<a string>
nhiều lần sử dụng được tích luỹ-
Chỉ định các phiên bản mô-đun ở dạng `<module1>@<version1>,<module2>@<version2>` sẽ được cho phép trong biểu đồ phần phụ thuộc đã phân giải ngay cả khi các phiên bản đó được khai báo là đã bị xoá trong sổ đăng ký nơi chúng đến (nếu không đến từ NonRegistryOverride). Nếu không, các phiên bản bị xoá sẽ khiến việc phân giải không thành công. Bạn cũng có thể xác định phiên bản bị xoá được phép bằng biến môi trường `BZLMOD_ALLOW_YANKED_VERSIONS`. Bạn có thể tắt tính năng kiểm tra này bằng cách sử dụng từ khoá "tất cả" (không nên dùng).
Thẻ:loading_and_analysis
--check_bazel_compatibility=<error, warning or off>
mặc định: "lỗi"-
Kiểm tra khả năng tương thích của phiên bản bazel của các mô-đun Bazel. Các giá trị hợp lệ là "error" để chuyển vấn đề này lên lỗi phân giải, "off" để tắt tính năng kiểm tra hoặc "warning" để in cảnh báo khi phát hiện thấy không khớp.
Thẻ:loading_and_analysis
--check_direct_dependencies=<off, warning or error>
mặc định: "cảnh báo"-
Kiểm tra xem các phần phụ thuộc `bazel_dep` trực tiếp được khai báo trong mô-đun gốc có phải là các phiên bản mà bạn nhận được trong biểu đồ phần phụ thuộc đã được phân giải hay không. Các giá trị hợp lệ là "off" để tắt tính năng kiểm tra, "warning" để in cảnh báo khi phát hiện thấy không khớp hoặc "error" để chuyển lên lỗi phân giải.
Thẻ:loading_and_analysis
- Giá trị mặc định của
--[no]ignore_dev_dependency
: "false" - Nếu đúng, Bazel sẽ bỏ qua "bazel_dep" và "use_extension" được khai báo là "dev_dependency" trong MODULE.bazel của mô-đun gốc. Xin lưu ý rằng các phần phụ thuộc dành cho nhà phát triển đó luôn bị bỏ qua trong MODULE.bazel nếu đó không phải là mô-đun gốc, bất kể giá trị của cờ này là gì.
Thẻ:loading_and_analysis
--lockfile_mode=<off, update, refresh or error>
mặc định: "cập nhật"-
Chỉ định cách thức và liệu có sử dụng tệp khoá hay không. Các giá trị hợp lệ là "update" để sử dụng tệp khoá và cập nhật tệp khoá nếu có thay đổi, "refresh" để thỉnh thoảng làm mới thông tin có thể thay đổi (các phiên bản bị loại bỏ và các mô-đun bị thiếu trước đó) từ các sổ đăng ký từ xa, "error" để sử dụng tệp khoá nhưng gửi lỗi nếu tệp khoá không được cập nhật hoặc "off" để không đọc hoặc ghi vào tệp khoá.
Thẻ:loading_and_analysis
--override_module=<an equals-separated mapping of module name to path>
nhiều lần sử dụng được tích luỹ- Ghi đè một mô-đun bằng đường dẫn cục bộ ở dạng <tên mô-đun>=<đường dẫn>. Nếu đường dẫn đã cho là đường dẫn tuyệt đối, thì đường dẫn đó sẽ được sử dụng nguyên trạng. Nếu đường dẫn đã cho là đường dẫn tương đối, thì đường dẫn đó sẽ tương ứng với thư mục đang hoạt động. Nếu đường dẫn đã cho bắt đầu bằng "%workspace%", thì đường dẫn đó sẽ tương ứng với thư mục gốc của không gian làm việc, là kết quả của lệnh "bazel info workspace". Nếu đường dẫn đã cho trống, hãy xoá mọi chế độ ghi đè trước đó.
--registry=<a string>
nhiều lần sử dụng được tích luỹ- Chỉ định các sổ đăng ký cần sử dụng để xác định vị trí các phần phụ thuộc mô-đun Bazel. Thứ tự rất quan trọng: các mô-đun sẽ được tra cứu trong các sổ đăng ký trước đó trước tiên và chỉ quay lại các sổ đăng ký sau này khi các mô-đun đó bị thiếu trong các sổ đăng ký trước đó.
Thẻ:changes_inputs
--vendor_dir=<a path>
mặc định: xem nội dung mô tả-
Chỉ định thư mục sẽ chứa các kho lưu trữ bên ngoài ở chế độ nhà cung cấp, cho dù mục đích là tìm nạp các kho lưu trữ đó vào thư mục hay sử dụng các kho lưu trữ đó trong khi xây dựng. Bạn có thể chỉ định đường dẫn dưới dạng đường dẫn tuyệt đối hoặc đường dẫn tương đối đến thư mục không gian làm việc.
Thẻ:loading_and_analysis
- Các tuỳ chọn kích hoạt tính năng tối ưu hoá thời gian xây dựng:
--gc_thrashing_limits=<comma separated pairs of <period>:<count>>
mặc định: "1s:2,20s:3,1m:5"-
Các giới hạn nếu đạt đến sẽ khiến GcThrashingDetector gặp sự cố Bazel với OOM. Mỗi giới hạn được chỉ định là <period>:<count>, trong đó period là thời lượng và count là số nguyên dương. Nếu hơn --gc_thrashing_threshold phần trăm không gian cố định (vùng nhớ khối xếp cũ) vẫn bị chiếm dụng sau <count> lần GC đầy đủ liên tiếp trong <period>, thì lỗi OOM sẽ được kích hoạt. Bạn có thể chỉ định nhiều giới hạn, phân tách bằng dấu phẩy.
Thẻ:host_machine_resource_optimizations
--skyframe_high_water_mark_full_gc_drops_per_invocation=<an integer, >= 0>
mặc định: "2147483647"-
Cờ cho cấu hình nâng cao của công cụ Skyframe nội bộ của Bazel. Nếu phát hiện mức sử dụng phần trăm vùng nhớ khối xếp được giữ lại vượt quá ngưỡng do --skyframe_high_water_mark_threshold đặt ra, thì khi một sự kiện GC đầy đủ xảy ra, Bazel sẽ loại bỏ trạng thái Skyframe tạm thời không cần thiết, lên đến nhiều lần như vậy cho mỗi lệnh gọi. Mặc định là Integer.MAX_VALUE; không giới hạn về mặt hiệu quả. Giá trị 0 có nghĩa là các sự kiện GC đầy đủ sẽ không bao giờ kích hoạt sự kiện thả. Nếu đạt đến giới hạn, trạng thái Skyframe sẽ không còn bị loại bỏ khi một sự kiện GC đầy đủ xảy ra và vượt quá ngưỡng phần trăm vùng nhớ khối xếp được giữ lại đó.
Thẻ:host_machine_resource_optimizations
--skyframe_high_water_mark_minor_gc_drops_per_invocation=<an integer, >= 0>
mặc định: "2147483647"-
Cờ cho cấu hình nâng cao của công cụ Skyframe nội bộ của Bazel. Nếu phát hiện mức sử dụng phần trăm vùng nhớ khối xếp được giữ lại vượt quá ngưỡng do --skyframe_high_water_mark_threshold đặt ra, thì khi một sự kiện GC nhỏ xảy ra, Bazel sẽ loại bỏ trạng thái Skyframe tạm thời không cần thiết, lên đến nhiều lần như vậy mỗi lần gọi. Mặc định là Integer.MAX_VALUE; không giới hạn về mặt hiệu quả. Giá trị 0 có nghĩa là các sự kiện GC nhỏ sẽ không bao giờ kích hoạt sự kiện thả. Nếu đạt đến giới hạn, trạng thái Skyframe sẽ không còn bị loại bỏ khi một sự kiện GC nhỏ xảy ra và vượt quá ngưỡng phần trăm vùng nhớ khối xếp được giữ lại.
Thẻ:host_machine_resource_optimizations
--skyframe_high_water_mark_threshold=<an integer>
mặc định: "85"-
Cờ cho cấu hình nâng cao của công cụ Skyframe nội bộ của Bazel. Nếu phát hiện mức sử dụng phần trăm vùng nhớ khối xếp được giữ lại ít nhất là ngưỡng này, Bazel sẽ loại bỏ trạng thái Skyframe tạm thời không cần thiết. Việc điều chỉnh điều này có thể giúp bạn giảm thiểu tác động của tình trạng GC bị lỗi khi (i) tình trạng này là do mức sử dụng bộ nhớ của trạng thái tạm thời và (ii) tốn kém hơn so với việc tạo lại trạng thái khi cần.
Thẻ:host_machine_resource_optimizations
- Các tuỳ chọn ảnh hưởng đến mức độ chi tiết, định dạng hoặc vị trí ghi nhật ký:
--experimental_command_profile=<cpu, wall, alloc or lock>
mặc định: xem nội dung mô tả- Ghi hồ sơ Trình ghi chuyến bay Java trong thời gian thực thi lệnh. Bạn phải cung cấp một trong các loại sự kiện phân tích tài nguyên được hỗ trợ (cpu, wall, alloc hoặc lock) dưới dạng đối số. Hồ sơ được ghi vào một tệp được đặt tên theo loại sự kiện trong thư mục cơ sở đầu ra. Cú pháp và ngữ nghĩa của cờ này có thể thay đổi trong tương lai để hỗ trợ thêm các loại hồ sơ hoặc định dạng đầu ra; bạn tự chịu rủi ro khi sử dụng.
- Giá trị mặc định của
--[no]experimental_record_metrics_for_all_mnemonics
: "false" - Theo mặc định, số lượng loại thao tác được giới hạn ở 20 câu thần chú có số lượng thao tác được thực thi nhiều nhất. Việc đặt tuỳ chọn này sẽ ghi số liệu thống kê cho tất cả các câu thần chú.
- Các tuỳ chọn chỉ định hoặc thay đổi dữ liệu đầu vào chung thành một lệnh Bazel không thuộc các danh mục khác.:
--experimental_resolved_file_instead_of_workspace=<a string>
mặc định: ""- Nếu không trống, hãy đọc tệp đã phân giải được chỉ định thay vì tệp WORKSPACE
Thẻ:changes_inputs
- Các tuỳ chọn thực thi và lưu vào bộ nhớ đệm từ xa:
--experimental_downloader_config=<a string>
mặc định: xem nội dung mô tả- Chỉ định một tệp để định cấu hình trình tải xuống từ xa. Tệp này bao gồm các dòng, mỗi dòng bắt đầu bằng một lệnh (`allow`, `block` hoặc `rewrite`), theo sau là tên máy chủ lưu trữ (đối với lệnh `allow` và `block`) hoặc hai mẫu, một mẫu để so khớp và một mẫu để sử dụng làm URL thay thế, với các tệp tham chiếu ngược bắt đầu từ `$1`. Bạn có thể cung cấp nhiều lệnh `rewrite` cho cùng một URL và trong trường hợp này, nhiều URL sẽ được trả về.
- Giá trị mặc định của
--experimental_worker_for_repo_fetching=<off, platform, virtual or auto>
: "tự động" - Chế độ tạo luồng để tìm nạp kho lưu trữ. Nếu bạn đặt thành "tắt", thì không có luồng worker nào được sử dụng và quá trình tìm nạp kho lưu trữ sẽ phải khởi động lại. Nếu không, hãy sử dụng luồng worker ảo.
- Các tuỳ chọn khác, không được phân loại theo cách khác.:
--deleted_packages=<comma-separated list of package names>
nhiều lần sử dụng được tích luỹ- Danh sách tên gói được phân tách bằng dấu phẩy mà hệ thống xây dựng sẽ coi là không tồn tại, ngay cả khi các gói đó xuất hiện ở đâu đó trên đường dẫn gói. Sử dụng tuỳ chọn này khi xoá một gói con "x/y" của một gói hiện có "x". Ví dụ: sau khi xoá x/y/BUILD trong ứng dụng, hệ thống xây dựng có thể khiếu nại nếu gặp nhãn "//x:y/z" nếu nhãn đó vẫn được cung cấp bởi một mục package_path khác. Bạn có thể chỉ định --deleted_packages x/y để tránh vấn đề này.
- Giá trị mặc định của
--[no]fetch
: "true" - Cho phép lệnh tìm nạp các phần phụ thuộc bên ngoài. Nếu bạn đặt thành false, lệnh sẽ sử dụng bất kỳ phiên bản nào của phần phụ thuộc được lưu vào bộ nhớ đệm và nếu không có phiên bản nào, lệnh sẽ không thành công.
--override_repository=<an equals-separated mapping of repository name to path>
nhiều lần sử dụng được tích luỹ- Ghi đè kho lưu trữ bằng một đường dẫn cục bộ ở dạng <repository name>=<path>. Nếu đường dẫn đã cho là đường dẫn tuyệt đối, thì đường dẫn đó sẽ được sử dụng nguyên trạng. Nếu đường dẫn đã cho là đường dẫn tương đối, thì đường dẫn đó sẽ tương ứng với thư mục đang hoạt động. Nếu đường dẫn đã cho bắt đầu bằng "%workspace%", thì đường dẫn đó sẽ tương ứng với thư mục gốc của không gian làm việc, là kết quả của lệnh "bazel info workspace". Nếu đường dẫn đã cho trống, hãy xoá mọi chế độ ghi đè trước đó.
--package_path=<colon-separated list of options>
mặc định: "%workspace%"- Danh sách được phân tách bằng dấu hai chấm về nơi tìm kiếm các gói. Các phần tử bắt đầu bằng "%workspace%" có liên quan đến không gian làm việc bao quanh. Nếu bạn bỏ qua hoặc để trống, giá trị mặc định sẽ là kết quả của lệnh "bazel info default-package-path".
- Giá trị mặc định của
--[no]show_loading_progress
: "true" - Nếu được bật, sẽ khiến Bazel in thông báo "Loading package" ("Đang tải gói").
Tuỳ chọn Print_action
Kế thừa tất cả các tuỳ chọn từ build.
- Các tuỳ chọn xuất hiện trước lệnh và được máy khách phân tích cú pháp:
--distdir=<a path>
nhiều lần sử dụng được tích luỹ-
Các vị trí khác để tìm kiếm bản lưu trữ trước khi truy cập vào mạng để tải xuống.
Thẻ:bazel_internal_configuration
- Giá trị mặc định của
--[no]experimental_repository_cache_hardlinks
: "false" - Nếu được đặt, bộ nhớ đệm kho lưu trữ sẽ liên kết cứng tệp trong trường hợp có lượt truy cập vào bộ nhớ đệm, thay vì sao chép. Việc này nhằm tiết kiệm dung lượng ổ đĩa.
Thẻ:bazel_internal_configuration
--experimental_repository_downloader_retries=<an integer>
mặc định: "0"-
Số lần thử tối đa để thử lại lỗi tải xuống. Nếu bạn đặt thành 0, thì tính năng thử lại sẽ bị tắt.
Thẻ:experimental
--experimental_scale_timeouts=<a double>
mặc định: "1.0"- Điều chỉnh tất cả thời gian chờ trong quy tắc kho lưu trữ Starlark theo hệ số này. Bằng cách này, bạn có thể làm cho kho lưu trữ bên ngoài hoạt động trên các máy chạy chậm hơn dự kiến của tác giả quy tắc mà không cần thay đổi mã nguồn
Thẻ:bazel_internal_configuration
,experimental
- Giá trị mặc định của
--[no]incompatible_disable_native_repo_rules
: "false" - Nếu giá trị là false, bạn có thể sử dụng các quy tắc kho lưu trữ gốc trong WORKSPACE; nếu không, bạn phải sử dụng các quy tắc kho lưu trữ Starlark. Các quy tắc kho lưu trữ gốc bao gồm local_repository, new_local_repository, local_config_platform, android_sdk_repository và android_ndk_repository.
Thẻ:bazel_internal_configuration
--repository_cache=<a path>
mặc định: xem nội dung mô tả- Chỉ định vị trí bộ nhớ đệm của các giá trị đã tải xuống thu được trong quá trình tìm nạp kho lưu trữ bên ngoài. Chuỗi trống làm đối số yêu cầu tắt bộ nhớ đệm, nếu không, giá trị mặc định là "<output_user_root>/cache/repos/v1" sẽ được sử dụng
Thẻ:bazel_internal_configuration
- Giá trị mặc định của
--[no]repository_disable_download
: "false" - Nếu được đặt, bạn không được phép tải xuống bằng ctx.download{,_and_extract} trong quá trình tìm nạp kho lưu trữ. Xin lưu ý rằng quyền truy cập mạng không bị tắt hoàn toàn; ctx.execute vẫn có thể chạy một tệp thực thi tuỳ ý truy cập Internet.
Thẻ:bazel_internal_configuration
- Các tuỳ chọn kiểm soát việc thực thi bản dựng:
- Giá trị mặc định của
--gc_thrashing_threshold=<an integer in 0-100 range>
: "100" -
Tỷ lệ phần trăm không gian cố định bị chiếm dụng (0-100) mà tại đó GcThrashingDetector xem xét các sự kiện áp lực bộ nhớ so với giới hạn của nó (--gc_thrashing_limits). Nếu bạn đặt thành 100, GcThrashingDetector sẽ bị tắt.
Thẻ:host_machine_resource_optimizations
- Tuỳ chọn liên quan đến đầu ra và ngữ nghĩa của Bzlmod:
--allow_yanked_versions=<a string>
nhiều lần sử dụng được tích luỹ-
Chỉ định các phiên bản mô-đun ở dạng `<module1>@<version1>,<module2>@<version2>` sẽ được cho phép trong biểu đồ phần phụ thuộc đã phân giải ngay cả khi các phiên bản đó được khai báo là đã bị xoá trong sổ đăng ký nơi chúng đến (nếu không đến từ NonRegistryOverride). Nếu không, các phiên bản bị xoá sẽ khiến việc phân giải không thành công. Bạn cũng có thể xác định phiên bản bị xoá được phép bằng biến môi trường `BZLMOD_ALLOW_YANKED_VERSIONS`. Bạn có thể tắt tính năng kiểm tra này bằng cách sử dụng từ khoá "tất cả" (không nên dùng).
Thẻ:loading_and_analysis
--check_bazel_compatibility=<error, warning or off>
mặc định: "lỗi"-
Kiểm tra khả năng tương thích của phiên bản bazel của các mô-đun Bazel. Các giá trị hợp lệ là "error" để chuyển vấn đề này lên lỗi phân giải, "off" để tắt tính năng kiểm tra hoặc "warning" để in cảnh báo khi phát hiện thấy không khớp.
Thẻ:loading_and_analysis
--check_direct_dependencies=<off, warning or error>
mặc định: "cảnh báo"-
Kiểm tra xem các phần phụ thuộc `bazel_dep` trực tiếp được khai báo trong mô-đun gốc có phải là các phiên bản mà bạn nhận được trong biểu đồ phần phụ thuộc đã được phân giải hay không. Các giá trị hợp lệ là "off" để tắt tính năng kiểm tra, "warning" để in cảnh báo khi phát hiện thấy không khớp hoặc "error" để chuyển lên lỗi phân giải.
Thẻ:loading_and_analysis
- Giá trị mặc định của
--[no]ignore_dev_dependency
: "false" - Nếu đúng, Bazel sẽ bỏ qua "bazel_dep" và "use_extension" được khai báo là "dev_dependency" trong MODULE.bazel của mô-đun gốc. Xin lưu ý rằng các phần phụ thuộc dành cho nhà phát triển đó luôn bị bỏ qua trong MODULE.bazel nếu đó không phải là mô-đun gốc, bất kể giá trị của cờ này là gì.
Thẻ:loading_and_analysis
--lockfile_mode=<off, update, refresh or error>
mặc định: "cập nhật"-
Chỉ định cách thức và liệu có sử dụng tệp khoá hay không. Các giá trị hợp lệ là "update" để sử dụng tệp khoá và cập nhật tệp khoá nếu có thay đổi, "refresh" để thỉnh thoảng làm mới thông tin có thể thay đổi (các phiên bản bị loại bỏ và các mô-đun bị thiếu trước đó) từ các sổ đăng ký từ xa, "error" để sử dụng tệp khoá nhưng gửi lỗi nếu tệp khoá không được cập nhật hoặc "off" để không đọc hoặc ghi vào tệp khoá.
Thẻ:loading_and_analysis
--override_module=<an equals-separated mapping of module name to path>
nhiều lần sử dụng được tích luỹ- Ghi đè một mô-đun bằng đường dẫn cục bộ ở dạng <tên mô-đun>=<đường dẫn>. Nếu đường dẫn đã cho là đường dẫn tuyệt đối, thì đường dẫn đó sẽ được sử dụng nguyên trạng. Nếu đường dẫn đã cho là đường dẫn tương đối, thì đường dẫn đó sẽ tương ứng với thư mục đang hoạt động. Nếu đường dẫn đã cho bắt đầu bằng "%workspace%", thì đường dẫn đó sẽ tương ứng với thư mục gốc của không gian làm việc, là kết quả của lệnh "bazel info workspace". Nếu đường dẫn đã cho trống, hãy xoá mọi chế độ ghi đè trước đó.
--registry=<a string>
nhiều lần sử dụng được tích luỹ- Chỉ định các sổ đăng ký cần sử dụng để xác định vị trí các phần phụ thuộc mô-đun Bazel. Thứ tự rất quan trọng: các mô-đun sẽ được tra cứu trong các sổ đăng ký trước đó trước tiên và chỉ quay lại các sổ đăng ký sau này khi các mô-đun đó bị thiếu trong các sổ đăng ký trước đó.
Thẻ:changes_inputs
--vendor_dir=<a path>
mặc định: xem nội dung mô tả-
Chỉ định thư mục sẽ chứa các kho lưu trữ bên ngoài ở chế độ nhà cung cấp, cho dù mục đích là tìm nạp các kho lưu trữ đó vào thư mục hay sử dụng các kho lưu trữ đó trong khi xây dựng. Bạn có thể chỉ định đường dẫn dưới dạng đường dẫn tuyệt đối hoặc đường dẫn tương đối đến thư mục không gian làm việc.
Thẻ:loading_and_analysis
- Các tuỳ chọn kích hoạt tính năng tối ưu hoá thời gian xây dựng:
--gc_thrashing_limits=<comma separated pairs of <period>:<count>>
mặc định: "1s:2,20s:3,1m:5"-
Các giới hạn nếu đạt đến sẽ khiến GcThrashingDetector gặp sự cố Bazel với OOM. Mỗi giới hạn được chỉ định là <period>:<count>, trong đó period là thời lượng và count là số nguyên dương. Nếu hơn --gc_thrashing_threshold phần trăm không gian cố định (vùng nhớ khối xếp cũ) vẫn bị chiếm dụng sau <count> lần GC đầy đủ liên tiếp trong <period>, thì lỗi OOM sẽ được kích hoạt. Bạn có thể chỉ định nhiều giới hạn, phân tách bằng dấu phẩy.
Thẻ:host_machine_resource_optimizations
--skyframe_high_water_mark_full_gc_drops_per_invocation=<an integer, >= 0>
mặc định: "2147483647"-
Cờ cho cấu hình nâng cao của công cụ Skyframe nội bộ của Bazel. Nếu phát hiện mức sử dụng phần trăm vùng nhớ khối xếp được giữ lại vượt quá ngưỡng do --skyframe_high_water_mark_threshold đặt ra, thì khi một sự kiện GC đầy đủ xảy ra, Bazel sẽ loại bỏ trạng thái Skyframe tạm thời không cần thiết, lên đến nhiều lần như vậy cho mỗi lệnh gọi. Mặc định là Integer.MAX_VALUE; không giới hạn về mặt hiệu quả. Giá trị 0 có nghĩa là các sự kiện GC đầy đủ sẽ không bao giờ kích hoạt sự kiện thả. Nếu đạt đến giới hạn, trạng thái Skyframe sẽ không còn bị loại bỏ khi một sự kiện GC đầy đủ xảy ra và vượt quá ngưỡng phần trăm vùng nhớ khối xếp được giữ lại đó.
Thẻ:host_machine_resource_optimizations
--skyframe_high_water_mark_minor_gc_drops_per_invocation=<an integer, >= 0>
mặc định: "2147483647"-
Cờ cho cấu hình nâng cao của công cụ Skyframe nội bộ của Bazel. Nếu phát hiện mức sử dụng phần trăm vùng nhớ khối xếp được giữ lại vượt quá ngưỡng do --skyframe_high_water_mark_threshold đặt ra, thì khi một sự kiện GC nhỏ xảy ra, Bazel sẽ loại bỏ trạng thái Skyframe tạm thời không cần thiết, lên đến nhiều lần như vậy mỗi lần gọi. Mặc định là Integer.MAX_VALUE; không giới hạn về mặt hiệu quả. Giá trị 0 có nghĩa là các sự kiện GC nhỏ sẽ không bao giờ kích hoạt sự kiện thả. Nếu đạt đến giới hạn, trạng thái Skyframe sẽ không còn bị loại bỏ khi một sự kiện GC nhỏ xảy ra và vượt quá ngưỡng phần trăm vùng nhớ khối xếp được giữ lại.
Thẻ:host_machine_resource_optimizations
--skyframe_high_water_mark_threshold=<an integer>
mặc định: "85"-
Cờ cho cấu hình nâng cao của công cụ Skyframe nội bộ của Bazel. Nếu phát hiện mức sử dụng phần trăm vùng nhớ khối xếp được giữ lại ít nhất là ngưỡng này, Bazel sẽ loại bỏ trạng thái Skyframe tạm thời không cần thiết. Việc điều chỉnh điều này có thể giúp bạn giảm thiểu tác động của tình trạng GC bị lỗi khi (i) tình trạng này là do mức sử dụng bộ nhớ của trạng thái tạm thời và (ii) tốn kém hơn so với việc tạo lại trạng thái khi cần.
Thẻ:host_machine_resource_optimizations
- Các tuỳ chọn ảnh hưởng đến mức độ chi tiết, định dạng hoặc vị trí ghi nhật ký:
--experimental_command_profile=<cpu, wall, alloc or lock>
mặc định: xem nội dung mô tả- Ghi hồ sơ Trình ghi chuyến bay Java trong thời gian thực thi lệnh. Bạn phải cung cấp một trong các loại sự kiện phân tích tài nguyên được hỗ trợ (cpu, wall, alloc hoặc lock) dưới dạng đối số. Hồ sơ được ghi vào một tệp được đặt tên theo loại sự kiện trong thư mục cơ sở đầu ra. Cú pháp và ngữ nghĩa của cờ này có thể thay đổi trong tương lai để hỗ trợ thêm các loại hồ sơ hoặc định dạng đầu ra; bạn tự chịu rủi ro khi sử dụng.
- Giá trị mặc định của
--[no]experimental_record_metrics_for_all_mnemonics
: "false" - Theo mặc định, số lượng loại thao tác được giới hạn ở 20 câu thần chú có số lượng thao tác được thực thi nhiều nhất. Việc đặt tuỳ chọn này sẽ ghi số liệu thống kê cho tất cả các câu thần chú.
- Các tuỳ chọn chỉ định hoặc thay đổi dữ liệu đầu vào chung thành một lệnh Bazel không thuộc các danh mục khác.:
--experimental_resolved_file_instead_of_workspace=<a string>
mặc định: ""- Nếu không trống, hãy đọc tệp đã phân giải được chỉ định thay vì tệp WORKSPACE
Thẻ:changes_inputs
- Các tuỳ chọn thực thi và lưu vào bộ nhớ đệm từ xa:
--experimental_downloader_config=<a string>
mặc định: xem nội dung mô tả- Chỉ định một tệp để định cấu hình trình tải xuống từ xa. Tệp này bao gồm các dòng, mỗi dòng bắt đầu bằng một lệnh (`allow`, `block` hoặc `rewrite`), theo sau là tên máy chủ lưu trữ (đối với lệnh `allow` và `block`) hoặc hai mẫu, một mẫu để so khớp và một mẫu để sử dụng làm URL thay thế, với các tệp tham chiếu ngược bắt đầu từ `$1`. Bạn có thể cung cấp nhiều lệnh `rewrite` cho cùng một URL và trong trường hợp này, nhiều URL sẽ được trả về.
- Giá trị mặc định của
--experimental_worker_for_repo_fetching=<off, platform, virtual or auto>
: "tự động" - Chế độ tạo luồng để tìm nạp kho lưu trữ. Nếu bạn đặt thành "tắt", thì không có luồng worker nào được sử dụng và quá trình tìm nạp kho lưu trữ sẽ phải khởi động lại. Nếu không, hãy sử dụng luồng worker ảo.
- Các tuỳ chọn khác, không được phân loại theo cách khác.:
--override_repository=<an equals-separated mapping of repository name to path>
nhiều lần sử dụng được tích luỹ- Ghi đè kho lưu trữ bằng một đường dẫn cục bộ ở dạng <repository name>=<path>. Nếu đường dẫn đã cho là đường dẫn tuyệt đối, thì đường dẫn đó sẽ được sử dụng nguyên trạng. Nếu đường dẫn đã cho là đường dẫn tương đối, thì đường dẫn đó sẽ tương ứng với thư mục đang hoạt động. Nếu đường dẫn đã cho bắt đầu bằng "%workspace%", thì đường dẫn đó sẽ tương ứng với thư mục gốc của không gian làm việc, là kết quả của lệnh "bazel info workspace". Nếu đường dẫn đã cho trống, hãy xoá mọi chế độ ghi đè trước đó.
--print_action_mnemonics=<a string>
nhiều lần sử dụng được tích luỹ- Liệt kê các câu thần chú để lọc dữ liệu print_action, không có hoạt động lọc nào diễn ra khi để trống.
Tuỳ chọn truy vấn
- Các tuỳ chọn xuất hiện trước lệnh và được máy khách phân tích cú pháp:
--distdir=<a path>
nhiều lần sử dụng được tích luỹ-
Các vị trí khác để tìm kiếm bản lưu trữ trước khi truy cập vào mạng để tải xuống.
Thẻ:bazel_internal_configuration
- Giá trị mặc định của
--[no]experimental_repository_cache_hardlinks
: "false" - Nếu được đặt, bộ nhớ đệm kho lưu trữ sẽ liên kết cứng tệp trong trường hợp có lượt truy cập vào bộ nhớ đệm, thay vì sao chép. Việc này nhằm tiết kiệm dung lượng ổ đĩa.
Thẻ:bazel_internal_configuration
--experimental_repository_downloader_retries=<an integer>
mặc định: "0"-
Số lần thử tối đa để thử lại lỗi tải xuống. Nếu bạn đặt thành 0, thì tính năng thử lại sẽ bị tắt.
Thẻ:experimental
--experimental_scale_timeouts=<a double>
mặc định: "1.0"- Điều chỉnh tất cả thời gian chờ trong quy tắc kho lưu trữ Starlark theo hệ số này. Bằng cách này, bạn có thể làm cho kho lưu trữ bên ngoài hoạt động trên các máy chạy chậm hơn dự kiến của tác giả quy tắc mà không cần thay đổi mã nguồn
Thẻ:bazel_internal_configuration
,experimental
- Giá trị mặc định của
--[no]incompatible_disable_native_repo_rules
: "false" - Nếu giá trị là false, bạn có thể sử dụng các quy tắc kho lưu trữ gốc trong WORKSPACE; nếu không, bạn phải sử dụng các quy tắc kho lưu trữ Starlark. Các quy tắc kho lưu trữ gốc bao gồm local_repository, new_local_repository, local_config_platform, android_sdk_repository và android_ndk_repository.
Thẻ:bazel_internal_configuration
--repository_cache=<a path>
mặc định: xem nội dung mô tả- Chỉ định vị trí bộ nhớ đệm của các giá trị đã tải xuống thu được trong quá trình tìm nạp kho lưu trữ bên ngoài. Chuỗi trống làm đối số yêu cầu tắt bộ nhớ đệm, nếu không, giá trị mặc định là "<output_user_root>/cache/repos/v1" sẽ được sử dụng
Thẻ:bazel_internal_configuration
- Giá trị mặc định của
--[no]repository_disable_download
: "false" - Nếu được đặt, bạn không được phép tải xuống bằng ctx.download{,_and_extract} trong quá trình tìm nạp kho lưu trữ. Xin lưu ý rằng quyền truy cập mạng không bị tắt hoàn toàn; ctx.execute vẫn có thể chạy một tệp thực thi tuỳ ý truy cập Internet.
Thẻ:bazel_internal_configuration
- Các tuỳ chọn kiểm soát việc thực thi bản dựng:
- Giá trị mặc định của
--gc_thrashing_threshold=<an integer in 0-100 range>
: "100" -
Tỷ lệ phần trăm không gian cố định bị chiếm dụng (0-100) mà tại đó GcThrashingDetector xem xét các sự kiện áp lực bộ nhớ so với giới hạn của nó (--gc_thrashing_limits). Nếu bạn đặt thành 100, GcThrashingDetector sẽ bị tắt.
Thẻ:host_machine_resource_optimizations
--[no]keep_going
[-k
] mặc định: "false"-
Tiếp tục nhiều nhất có thể sau khi xảy ra lỗi. Mặc dù không thể phân tích mục tiêu không thành công và các mục tiêu phụ thuộc vào mục tiêu đó, nhưng bạn có thể phân tích các điều kiện tiên quyết khác của các mục tiêu này.
Thẻ:eagerness_to_exit
- Giá trị mặc định của
--loading_phase_threads=<an integer, or a keyword ("auto", "HOST_CPUS", "HOST_RAM"), optionally followed by an operation ([-|*]<float>) eg. "auto", "HOST_CPUS*.5">
: "tự động" - Số luồng song song cần sử dụng cho giai đoạn tải/phân tích. Nhận một số nguyên hoặc từ khoá ("tự động", "HOST_CPUS", "HOST_RAM"), theo sau có thể là một phép toán ([-|*]<float>) ví dụ: "tự động", "HOST_CPUS*.5". "tự động" đặt giá trị mặc định hợp lý dựa trên tài nguyên của máy chủ lưu trữ. Phải ít nhất là 1.
Thẻ:bazel_internal_configuration
- Tuỳ chọn này ảnh hưởng đến ngữ nghĩa của ngôn ngữ Starlark hoặc API bản dựng có thể truy cập vào các tệp BUILD, tệp .bzl hoặc tệp WORKSPACE.:
- Giá trị mặc định của
--[no]incompatible_config_setting_private_default_visibility
: "false" - Nếu incompatible_enforce_config_setting_visibility=false, thì đây là một thao tác không có tác dụng. Nếu không, nếu cờ này là false, mọi config_setting không có thuộc tính chế độ hiển thị rõ ràng sẽ là //visibility:public. Nếu cờ này là true, config_setting sẽ tuân theo logic hiển thị giống như tất cả các quy tắc khác. Xem https://github.com/bazelbuild/bazel/issues/12933.
Thẻ:loading_and_analysis
,incompatible_change
- Giá trị mặc định của
--[no]incompatible_enforce_config_setting_visibility
: "true" - Nếu đúng, hãy thực thi các quy định hạn chế về chế độ hiển thị config_setting. Nếu giá trị là false, mọi mục config_setting đều hiển thị với mọi mục tiêu. Xem https://github.com/bazelbuild/bazel/issues/12932.
Thẻ:loading_and_analysis
,incompatible_change
- Các tuỳ chọn liên quan đến kết quả truy vấn và ngữ nghĩa:
- Giá trị mặc định của
--aspect_deps=<off, conservative or precise>
: "conservative" -
Cách phân giải các phần phụ thuộc của khía cạnh khi định dạng đầu ra là một trong các {xml,proto,record}. "tắt" có nghĩa là không có phần phụ thuộc khía cạnh nào được phân giải, "cẩn thận" (mặc định) có nghĩa là tất cả phần phụ thuộc khía cạnh đã khai báo đều được thêm vào bất kể chúng có được cấp lớp quy tắc của phần phụ thuộc trực tiếp hay không, "chính xác" có nghĩa là chỉ những khía cạnh có thể hoạt động mới được thêm vào dựa trên lớp quy tắc của phần phụ thuộc trực tiếp. Xin lưu ý rằng chế độ chính xác yêu cầu tải các gói khác để đánh giá một mục tiêu duy nhất, do đó, chế độ này sẽ chậm hơn các chế độ khác. Ngoài ra, xin lưu ý rằng ngay cả chế độ chính xác cũng không hoàn toàn chính xác: quyết định có tính toán một khía cạnh hay không được quyết định trong giai đoạn phân tích, giai đoạn này không chạy trong "truy vấn bazel".
Thẻ:build_file_semantics
- Giá trị mặc định của
--[no]consistent_labels
: "false" - Nếu được bật, mọi lệnh truy vấn sẽ phát ra nhãn như thể bằng hàm Starlark <code>str</code> áp dụng cho một thực thể <code>Label</code>. Điều này rất hữu ích đối với các công cụ cần so khớp kết quả của các lệnh truy vấn và/hoặc nhãn khác nhau do các quy tắc phát ra. Nếu không được bật, trình định dạng đầu ra có thể tự do phát ra tên kho lưu trữ rõ ràng (so với kho lưu trữ chính) để giúp đầu ra dễ đọc hơn.
Thẻ:terminal_output
- Giá trị mặc định của
--[no]experimental_explicit_aspects
: "false" -
aquery, cquery: liệu có đưa các hành động do phương diện tạo ra vào kết quả hay không. query: không hoạt động (các phương diện luôn được tuân theo).
Thẻ:terminal_output
- Giá trị mặc định của
--[no]experimental_graphless_query
: "tự động" - Nếu đúng, hãy sử dụng phương thức triển khai Truy vấn không tạo bản sao của biểu đồ. Cách triển khai mới chỉ hỗ trợ --order_output=no, cũng như chỉ một tập hợp con của các trình định dạng đầu ra.
Thẻ:build_file_semantics
,eagerness_to_exit
--graph:conditional_edges_limit=<an integer>
mặc định: "4"-
Số lượng nhãn điều kiện tối đa sẽ hiển thị. -1 có nghĩa là không cắt bớt và 0 có nghĩa là không có chú giải. Tuỳ chọn này chỉ áp dụng cho --output=graph.
Thẻ:terminal_output
- Giá trị mặc định của
--[no]graph:factored
: "true" - Nếu đúng, thì biểu đồ sẽ được phát "được nhân", tức là các nút tương đương về mặt tô pô sẽ được hợp nhất với nhau và các nhãn của chúng sẽ được nối với nhau. Tuỳ chọn này chỉ áp dụng cho --output=graph.
Thẻ:terminal_output
--graph:node_limit=<an integer>
mặc định: "512"-
Độ dài tối đa của chuỗi nhãn cho một nút biểu đồ trong kết quả. Nhãn dài hơn sẽ bị cắt ngắn; -1 có nghĩa là không cắt ngắn. Tuỳ chọn này chỉ áp dụng cho --output=graph.
Thẻ:terminal_output
- Giá trị mặc định của
--[no]implicit_deps
: "true" - Nếu được bật, các phần phụ thuộc ngầm sẽ đượ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 bazel thêm vào. Đối với cquery, tuỳ chọn này kiểm soát việc lọc các chuỗi công cụ đã phân giải.
Thẻ:build_file_semantics
- Giá trị mặc định của
--[no]include_aspects
: "true" -
aquery, cquery: liệu có đưa các hành động do phương diện tạo ra vào kết quả hay không. query: không hoạt động (các phương diện luôn được tuân theo).
Thẻ:terminal_output
- Giá trị mặc định của
--[no]incompatible_lexicographical_output
: "true" - Nếu bạn đặt tuỳ chọn này, thì kết quả đầu ra --order_output=auto sẽ được sắp xếp theo thứ tự bảng chữ cái.
Thẻ:terminal_output
,incompatible_change
- Giá trị mặc định của
--[no]incompatible_package_group_includes_double_slash
: "true" - Nếu được bật, khi xuất thuộc tính "packages" của package_group, dấu "//" ở đầu sẽ không bị bỏ qua.
Thẻ:terminal_output
,incompatible_change
- Giá trị mặc định của
--[no]infer_universe_scope
: "false" - Nếu bạn đặt và không đặt --universe_scope, thì giá trị của --universe_scope sẽ được suy ra là danh sách các mẫu mục tiêu duy nhất trong biểu thức truy vấn. Xin lưu ý rằng giá trị --universe_scope được suy ra cho biểu thức truy vấn sử dụng các hàm trong phạm vi vũ trụ (ví dụ: "allrdeps") có thể không phải là giá trị bạn muốn. Vì vậy, bạn chỉ nên sử dụng tuỳ chọn này nếu biết mình đang làm gì. Hãy xem https://bazel.build/reference/query#sky-query để biết thông tin chi tiết và ví dụ. Nếu bạn đặt --universe_scope, thì giá trị của tuỳ chọn này sẽ bị bỏ qua. Lưu ý: tuỳ chọn này chỉ áp dụng cho "truy vấn" (tức là không phải "cquery").
Thẻ:loading_and_analysis
- Giá trị mặc định của
--[no]line_terminator_null
: "false" -
Liệu mỗi định dạng có được kết thúc bằng \0 thay vì dòng mới hay không.
Thẻ:terminal_output
- Giá trị mặc định của
--[no]nodep_deps
: "true" - Nếu được bật, các phần phụ thuộc từ thuộc tính "nodep" sẽ được đưa vào biểu đồ phần phụ thuộc mà truy vấn hoạt động. Một ví dụ phổ biến về thuộc tính "nodep" là "visibility" (mức độ hiển thị). Chạy và phân tích cú pháp kết quả của lệnh `info build-language` để tìm hiểu về tất cả thuộc tính "nodep" trong ngôn ngữ bản dựng.
Thẻ:build_file_semantics
--noorder_results
-
Xuất kết quả theo thứ tự phần phụ thuộc (mặc định) hoặc không theo thứ tự. Kết quả không theo thứ tự nhanh hơn nhưng chỉ được hỗ trợ khi --output không phải là minrank, maxrank hoặc graph.
Mở rộng thành:
--order_output=no
Thẻ:terminal_output
--null
-
Liệu mỗi định dạng có được kết thúc bằng \0 thay vì dòng mới hay không.
Mở rộng thành:
--line_terminator_null=true
Thẻ:terminal_output
- Giá trị mặc định của
--order_output=<no, deps, auto or full>
: "tự động" -
Đưa ra kết quả không theo thứ tự (no), theo thứ tự phần phụ thuộc (deps) hoặc theo thứ tự đầy đủ (full). Giá trị mặc định là "tự động", nghĩa là kết quả được xuất theo thứ tự phần phụ thuộc hoặc được sắp xếp đầy đủ, tuỳ thuộc vào trình định dạng đầu ra (theo thứ tự phần phụ thuộc cho proto, minrank, maxrank và biểu đồ, được sắp xếp đầy đủ cho tất cả các giá trị khác). Khi đầu ra được sắp xếp đầy đủ, các nút sẽ được in theo thứ tự xác định đầy đủ (tổng). Trước tiên, tất cả các nút được sắp xếp theo thứ tự bảng chữ cái. Sau đó, mỗi nút trong danh sách được dùng làm điểm bắt đầu của một lượt tìm kiếm sâu theo thứ tự sau, trong đó các cạnh đi đến các nút chưa được truy cập được duyệt theo thứ tự bảng chữ cái của các nút kế tiếp. Cuối cùng, các nút được in theo thứ tự ngược lại với thứ tự được truy cập.
Thẻ:terminal_output
--order_results
-
Xuất kết quả theo thứ tự phần phụ thuộc (mặc định) hoặc không theo thứ tự. Kết quả không theo thứ tự nhanh hơn nhưng chỉ được hỗ trợ khi --output không phải là minrank, maxrank hoặc graph.
Mở rộng thành:
--order_output=auto
Thẻ:terminal_output
--output=<a string>
mặc định: "label"-
Định dạng in kết quả truy vấn. Các giá trị được phép cho truy vấn là: build, graph, streamed_jsonproto, label, label_kind, location, maxrank, minrank, package, proto, streamed_proto, textproto, xml.
Thẻ:terminal_output
- Giá trị mặc định của
--[no]proto:default_values
: "true" - Nếu đúng, các thuộc tính có giá trị không được chỉ định rõ ràng trong tệp BUILD sẽ được đưa vào; nếu không, các thuộc tính đó sẽ bị bỏ qua. Bạn có thể áp dụng tuỳ chọn này cho --output=proto
Thẻ:terminal_output
- Giá trị mặc định của
--[no]proto:definition_stack
: "false" - Điền vào trường proto definition_stack. Trường này ghi lại cho mỗi thực thể quy tắc ngăn xếp lệnh gọi Starlark tại thời điểm lớp của quy tắc được xác định.
Thẻ:terminal_output
- Giá trị mặc định của
--[no]proto:flatten_selects
: "true" - Nếu được bật, các thuộc tính có thể định cấu hình do select() tạo sẽ được làm phẳng. Đối với các loại danh sách, bản trình bày được làm phẳng là một danh sách chứa mỗi giá trị của bản đồ chọn chính xác một lần. Các loại đại lượng vô hướng được làm phẳng thành giá trị rỗng.
Thẻ:build_file_semantics
- Giá trị mặc định của
--[no]proto:include_attribute_source_aspects
: "false" - Điền phương diện nguồn mà thuộc tính đến từ vào trường proto source_aspect_name của mỗi Thuộc tính (chuỗi trống nếu không có).
Thẻ:terminal_output
- Giá trị mặc định của
--[no]proto:include_synthetic_attribute_hash
: "false" -
Liệu có tính toán và điền thuộc tính $internal_attr_hash hay không.
Thẻ:terminal_output
- Giá trị mặc định của
--[no]proto:instantiation_stack
: "false" - Điền ngăn xếp lệnh gọi bản sao của từng quy tắc. Xin lưu ý rằng việc này yêu cầu ngăn xếp phải có mặt
Thẻ
:terminal_output
- Giá trị mặc định của
--[no]proto:locations
: "true" -
Liệu có xuất thông tin vị trí trong đầu ra proto hay không.
Thẻ:terminal_output
--proto:output_rule_attrs=<comma-separated list of options>
mặc định: "tất cả"- Danh sách các thuộc tính được phân tách bằng dấu phẩy để đưa vào đầu ra. Giá trị mặc định là tất cả thuộc tính. Đặt thành chuỗi trống để không xuất ra thuộc tính nào. Tuỳ chọn này áp dụng cho --output=proto.
Thẻ:terminal_output
- Giá trị mặc định của
--[no]proto:rule_inputs_and_outputs
: "true" -
Liệu có điền sẵn các trường rule_input và rule_output hay không.
Thẻ:terminal_output
--query_file=<a string>
mặc định: ""- Nếu được đặt, truy vấn sẽ đọc truy vấn từ tệp được đặt tên tại đây, thay vì trên dòng lệnh. Bạn sẽ gặp lỗi nếu chỉ định một tệp tại đây cũng như một truy vấn dòng lệnh.
Thẻ:changes_inputs
- Giá trị mặc định của
--[no]relative_locations
: "false" - Nếu đúng, vị trí của các tệp BUILD trong đầu ra xml và proto sẽ tương đối. Theo mặc định, đầu ra vị trí là một đường dẫn tuyệt đối và sẽ không nhất quán trên các máy. Bạn có thể đặt tuỳ chọn này thành đúng để có kết quả nhất quán trên các máy.
Thẻ:terminal_output
- Giá trị mặc định của
--[no]strict_test_suite
: "false" - Nếu đúng, biểu thức tests() sẽ báo lỗi nếu gặp phải một test_suite chứa các mục tiêu không phải là kiểm thử.
Thẻ:build_file_semantics
,eagerness_to_exit
- Giá trị mặc định của
--[no]tool_deps
: "true" - Truy vấn: Nếu bị tắt, các phần phụ thuộc trên "cấu hình thực thi" sẽ không được đưa vào biểu đồ phần phụ thuộc mà truy vấn hoạt động. Cạnh phần phụ thuộc "cấu hình thực thi", chẳng hạn như cạnh từ quy tắc "proto_library" bất kỳ đến Trình biên dịch giao thức, thường trỏ đến một công cụ được thực thi trong quá trình xây dựng thay vì một phần của cùng một chương trình "mục tiêu".
Cquery: Nếu bị tắt, sẽ lọc ra tất cả các mục tiêu đã định cấu hình vượt qua quá trình chuyển đổi thực thi từ mục tiêu cấp cao nhất đã phát hiện mục tiêu đã định cấu hình này. Điều đó có nghĩa là nếu mục tiêu cấp cao nhất nằm trong cấu hình mục tiêu, thì chỉ những mục tiêu được định cấu hình cũng nằm trong cấu hình mục tiêu mới được trả về. Nếu mục tiêu cấp cao nhất nằm trong cấu hình thực thi, thì chỉ các mục tiêu được định cấu hình thực thi mới được trả về. Tuỳ chọn này KHÔNG loại trừ các chuỗi công cụ đã phân giải.
Thẻ:build_file_semantics
--universe_scope=<comma-separated list of options>
mặc định: ""-
Một tập hợp các mẫu mục tiêu được phân tách bằng dấu phẩy (bổ sung và trừ). Truy vấn có thể được thực hiện trong vũ trụ được xác định bằng phép đóng bắc cầu của các mục tiêu đã chỉ định. Tuỳ chọn này được dùng cho các lệnh truy vấn và cquery.
Đối với cquery, dữ liệu đầu vào cho tuỳ chọn này là các mục tiêu mà tất cả câu trả lời được tạo trong đó. Do đó, tuỳ chọn này có thể ảnh hưởng đến cấu hình và quá trình chuyển đổi. Nếu bạn không chỉ định tuỳ chọn này, thì các mục tiêu cấp cao nhất được giả định là các mục tiêu được phân tích cú pháp từ biểu thức truy vấn. Lưu ý: Đối với cquery, việc không chỉ định tuỳ chọn này có thể khiến bản dựng bị lỗi nếu các mục tiêu được phân tích cú pháp từ biểu thức truy vấn không thể tạo bằng các tuỳ chọn cấp cao nhất.
Thẻ:loading_and_analysis
- Giá trị mặc định của
--[no]xml:default_values
: "false" - Nếu đúng, các thuộc tính quy tắc có giá trị không được chỉ định rõ ràng trong tệp BUILD sẽ được in; nếu không, các thuộc tính đó sẽ bị bỏ qua.
Thẻ:terminal_output
- Giá trị mặc định của
--[no]xml:line_numbers
: "true" - Nếu đúng, đầu ra XML sẽ chứa số dòng. Việc tắt tuỳ chọn này có thể giúp bạn dễ đọc các thay đổi hơn. Tuỳ chọn này chỉ áp dụng cho --output=xml.
Thẻ:terminal_output
- Các tuỳ chọn liên quan đến đầu ra và ngữ nghĩa của Bzlmod:
--allow_yanked_versions=<a string>
nhiều lần sử dụng được tích luỹ-
Chỉ định các phiên bản mô-đun ở dạng `<module1>@<version1>,<module2>@<version2>` sẽ được cho phép trong biểu đồ phần phụ thuộc đã phân giải ngay cả khi các phiên bản đó được khai báo là đã bị xoá trong sổ đăng ký nơi chúng đến (nếu không đến từ NonRegistryOverride). Nếu không, các phiên bản bị xoá sẽ khiến việc phân giải không thành công. Bạn cũng có thể xác định phiên bản bị xoá được phép bằng biến môi trường `BZLMOD_ALLOW_YANKED_VERSIONS`. Bạn có thể tắt tính năng kiểm tra này bằng cách sử dụng từ khoá "tất cả" (không nên dùng).
Thẻ:loading_and_analysis
--check_bazel_compatibility=<error, warning or off>
mặc định: "lỗi"-
Kiểm tra khả năng tương thích của phiên bản bazel của các mô-đun Bazel. Các giá trị hợp lệ là "error" để chuyển vấn đề này lên lỗi phân giải, "off" để tắt tính năng kiểm tra hoặc "warning" để in cảnh báo khi phát hiện thấy không khớp.
Thẻ:loading_and_analysis
--check_direct_dependencies=<off, warning or error>
mặc định: "cảnh báo"-
Kiểm tra xem các phần phụ thuộc `bazel_dep` trực tiếp được khai báo trong mô-đun gốc có phải là các phiên bản mà bạn nhận được trong biểu đồ phần phụ thuộc đã được phân giải hay không. Các giá trị hợp lệ là "off" để tắt tính năng kiểm tra, "warning" để in cảnh báo khi phát hiện thấy không khớp hoặc "error" để chuyển lên lỗi phân giải.
Thẻ:loading_and_analysis
- Giá trị mặc định của
--[no]ignore_dev_dependency
: "false" - Nếu đúng, Bazel sẽ bỏ qua "bazel_dep" và "use_extension" được khai báo là "dev_dependency" trong MODULE.bazel của mô-đun gốc. Xin lưu ý rằng các phần phụ thuộc dành cho nhà phát triển đó luôn bị bỏ qua trong MODULE.bazel nếu đó không phải là mô-đun gốc, bất kể giá trị của cờ này là gì.
Thẻ:loading_and_analysis
--lockfile_mode=<off, update, refresh or error>
mặc định: "cập nhật"-
Chỉ định cách thức và liệu có sử dụng tệp khoá hay không. Các giá trị hợp lệ là "update" để sử dụng tệp khoá và cập nhật tệp khoá nếu có thay đổi, "refresh" để thỉnh thoảng làm mới thông tin có thể thay đổi (các phiên bản bị loại bỏ và các mô-đun bị thiếu trước đó) từ các sổ đăng ký từ xa, "error" để sử dụng tệp khoá nhưng gửi lỗi nếu tệp khoá không được cập nhật hoặc "off" để không đọc hoặc ghi vào tệp khoá.
Thẻ:loading_and_analysis
--override_module=<an equals-separated mapping of module name to path>
nhiều lần sử dụng được tích luỹ- Ghi đè một mô-đun bằng đường dẫn cục bộ ở dạng <tên mô-đun>=<đường dẫn>. Nếu đường dẫn đã cho là đường dẫn tuyệt đối, thì đường dẫn đó sẽ được sử dụng nguyên trạng. Nếu đường dẫn đã cho là đường dẫn tương đối, thì đường dẫn đó sẽ tương ứng với thư mục đang hoạt động. Nếu đường dẫn đã cho bắt đầu bằng "%workspace%", thì đường dẫn đó sẽ tương ứng với thư mục gốc của không gian làm việc, là kết quả của lệnh "bazel info workspace". Nếu đường dẫn đã cho trống, hãy xoá mọi chế độ ghi đè trước đó.
--registry=<a string>
nhiều lần sử dụng được tích luỹ- Chỉ định các sổ đăng ký cần sử dụng để xác định vị trí các phần phụ thuộc mô-đun Bazel. Thứ tự rất quan trọng: các mô-đun sẽ được tra cứu trong các sổ đăng ký trước đó trước tiên và chỉ quay lại các sổ đăng ký sau này khi các mô-đun đó bị thiếu trong các sổ đăng ký trước đó.
Thẻ:changes_inputs
--vendor_dir=<a path>
mặc định: xem nội dung mô tả-
Chỉ định thư mục sẽ chứa các kho lưu trữ bên ngoài ở chế độ nhà cung cấp, cho dù mục đích là tìm nạp các kho lưu trữ đó vào thư mục hay sử dụng các kho lưu trữ đó trong khi xây dựng. Bạn có thể chỉ định đường dẫn dưới dạng đường dẫn tuyệt đối hoặc đường dẫn tương đối đến thư mục không gian làm việc.
Thẻ:loading_and_analysis
- Các tuỳ chọn kích hoạt tính năng tối ưu hoá thời gian xây dựng:
--gc_thrashing_limits=<comma separated pairs of <period>:<count>>
mặc định: "1s:2,20s:3,1m:5"-
Các giới hạn nếu đạt đến sẽ khiến GcThrashingDetector gặp sự cố Bazel với OOM. Mỗi giới hạn được chỉ định là <period>:<count>, trong đó period là thời lượng và count là số nguyên dương. Nếu hơn --gc_thrashing_threshold phần trăm không gian cố định (vùng nhớ khối xếp cũ) vẫn bị chiếm dụng sau <count> lần GC đầy đủ liên tiếp trong <period>, thì lỗi OOM sẽ được kích hoạt. Bạn có thể chỉ định nhiều giới hạn, phân tách bằng dấu phẩy.
Thẻ:host_machine_resource_optimizations
--skyframe_high_water_mark_full_gc_drops_per_invocation=<an integer, >= 0>
mặc định: "2147483647"-
Cờ cho cấu hình nâng cao của công cụ Skyframe nội bộ của Bazel. Nếu phát hiện mức sử dụng phần trăm vùng nhớ khối xếp được giữ lại vượt quá ngưỡng do --skyframe_high_water_mark_threshold đặt ra, thì khi một sự kiện GC đầy đủ xảy ra, Bazel sẽ loại bỏ trạng thái Skyframe tạm thời không cần thiết, lên đến nhiều lần như vậy cho mỗi lệnh gọi. Mặc định là Integer.MAX_VALUE; không giới hạn về mặt hiệu quả. Giá trị 0 có nghĩa là các sự kiện GC đầy đủ sẽ không bao giờ kích hoạt sự kiện thả. Nếu đạt đến giới hạn, trạng thái Skyframe sẽ không còn bị loại bỏ khi một sự kiện GC đầy đủ xảy ra và vượt quá ngưỡng phần trăm vùng nhớ khối xếp được giữ lại đó.
Thẻ:host_machine_resource_optimizations
--skyframe_high_water_mark_minor_gc_drops_per_invocation=<an integer, >= 0>
mặc định: "2147483647"-
Cờ cho cấu hình nâng cao của công cụ Skyframe nội bộ của Bazel. Nếu phát hiện mức sử dụng phần trăm vùng nhớ khối xếp được giữ lại vượt quá ngưỡng do --skyframe_high_water_mark_threshold đặt ra, thì khi một sự kiện GC nhỏ xảy ra, Bazel sẽ loại bỏ trạng thái Skyframe tạm thời không cần thiết, lên đến nhiều lần như vậy mỗi lần gọi. Mặc định là Integer.MAX_VALUE; không giới hạn về mặt hiệu quả. Giá trị 0 có nghĩa là các sự kiện GC nhỏ sẽ không bao giờ kích hoạt sự kiện thả. Nếu đạt đến giới hạn, trạng thái Skyframe sẽ không còn bị loại bỏ khi một sự kiện GC nhỏ xảy ra và vượt quá ngưỡng phần trăm vùng nhớ khối xếp được giữ lại.
Thẻ:host_machine_resource_optimizations
--skyframe_high_water_mark_threshold=<an integer>
mặc định: "85"-
Cờ cho cấu hình nâng cao của công cụ Skyframe nội bộ của Bazel. Nếu phát hiện mức sử dụng phần trăm vùng nhớ khối xếp được giữ lại ít nhất là ngưỡng này, Bazel sẽ loại bỏ trạng thái Skyframe tạm thời không cần thiết. Việc điều chỉnh điều này có thể giúp bạn giảm thiểu tác động của tình trạng GC bị lỗi khi (i) tình trạng này là do mức sử dụng bộ nhớ của trạng thái tạm thời và (ii) tốn kém hơn so với việc tạo lại trạng thái khi cần.
Thẻ:host_machine_resource_optimizations
- Các tuỳ chọn ảnh hưởng đến mức độ chi tiết, định dạng hoặc vị trí ghi nhật ký:
--experimental_command_profile=<cpu, wall, alloc or lock>
mặc định: xem nội dung mô tả- Ghi hồ sơ Trình ghi chuyến bay Java trong thời gian thực thi lệnh. Bạn phải cung cấp một trong các loại sự kiện phân tích tài nguyên được hỗ trợ (cpu, wall, alloc hoặc lock) dưới dạng đối số. Hồ sơ được ghi vào một tệp được đặt tên theo loại sự kiện trong thư mục cơ sở đầu ra. Cú pháp và ngữ nghĩa của cờ này có thể thay đổi trong tương lai để hỗ trợ thêm các loại hồ sơ hoặc định dạng đầu ra; bạn tự chịu rủi ro khi sử dụng.
- Giá trị mặc định của
--[no]experimental_record_metrics_for_all_mnemonics
: "false" - Theo mặc định, số lượng loại thao tác được giới hạn ở 20 câu thần chú có số lượng thao tác được thực thi nhiều nhất. Việc đặt tuỳ chọn này sẽ ghi số liệu thống kê cho tất cả các câu thần chú.
--experimental_repository_resolved_file=<a string>
mặc định: ""- Nếu không trống, hãy ghi một giá trị Starlark có thông tin đã phân giải của tất cả các quy tắc kho lưu trữ Starlark đã được thực thi.
Thẻ:affects_outputs
- Các tuỳ chọn chỉ định hoặc thay đổi dữ liệu đầu vào chung cho một lệnh Bazel không thuộc các danh mục khác.:
--experimental_resolved_file_instead_of_workspace=<a string>
mặc định: ""- Nếu không trống, hãy đọc tệp đã phân giải được chỉ định thay vì tệp WORKSPACE
Thẻ:changes_inputs
- Các tuỳ chọn thực thi và lưu vào bộ nhớ đệm từ xa:
--experimental_downloader_config=<a string>
mặc định: xem nội dung mô tả- Chỉ định một tệp để định cấu hình trình tải xuống từ xa. Tệp này bao gồm các dòng, mỗi dòng bắt đầu bằng một lệnh (`allow`, `block` hoặc `rewrite`), theo sau là tên máy chủ lưu trữ (đối với lệnh `allow` và `block`) hoặc hai mẫu, một mẫu để so khớp và một mẫu để sử dụng làm URL thay thế, với các tệp tham chiếu ngược bắt đầu từ `$1`. Bạn có thể cung cấp nhiều lệnh `rewrite` cho cùng một URL và trong trường hợp này, nhiều URL sẽ được trả về.
- Giá trị mặc định của
--experimental_worker_for_repo_fetching=<off, platform, virtual or auto>
: "tự động" - Chế độ tạo luồng để tìm nạp kho lưu trữ. Nếu bạn đặt thành "tắt", thì không có luồng worker nào được sử dụng và quá trình tìm nạp kho lưu trữ sẽ phải khởi động lại. Nếu không, hãy sử dụng luồng worker ảo.
- Các tuỳ chọn khác, không được phân loại theo cách khác.:
--deleted_packages=<comma-separated list of package names>
nhiều lần sử dụng được tích luỹ- Danh sách tên gói được phân tách bằng dấu phẩy mà hệ thống xây dựng sẽ coi là không tồn tại, ngay cả khi các gói đó xuất hiện ở đâu đó trên đường dẫn gói. Sử dụng tuỳ chọn này khi xoá một gói con "x/y" của một gói hiện có "x". Ví dụ: sau khi xoá x/y/BUILD trong ứng dụng, hệ thống xây dựng có thể khiếu nại nếu gặp nhãn "//x:y/z" nếu nhãn đó vẫn được cung cấp bởi một mục package_path khác. Bạn có thể chỉ định --deleted_packages x/y để tránh vấn đề này.
- Giá trị mặc định của
--[no]fetch
: "true" - Cho phép lệnh tìm nạp các phần phụ thuộc bên ngoài. Nếu bạn đặt thành false, lệnh sẽ sử dụng bất kỳ phiên bản nào của phần phụ thuộc được lưu vào bộ nhớ đệm và nếu không có phiên bản nào, lệnh sẽ không thành công.
--override_repository=<an equals-separated mapping of repository name to path>
nhiều lần sử dụng được tích luỹ- Ghi đè kho lưu trữ bằng một đường dẫn cục bộ ở dạng <repository name>=<path>. Nếu đường dẫn đã cho là đường dẫn tuyệt đối, thì đường dẫn đó sẽ được sử dụng nguyên trạng. Nếu đường dẫn đã cho là đường dẫn tương đối, thì đường dẫn đó sẽ tương ứng với thư mục đang hoạt động. Nếu đường dẫn đã cho bắt đầu bằng "%workspace%", thì đường dẫn đó sẽ tương ứng với thư mục gốc của không gian làm việc, là kết quả của lệnh "bazel info workspace". Nếu đường dẫn đã cho trống, hãy xoá mọi chế độ ghi đè trước đó.
--package_path=<colon-separated list of options>
mặc định: "%workspace%"- Danh sách được phân tách bằng dấu hai chấm về nơi tìm kiếm các gói. Các phần tử bắt đầu bằng "%workspace%" có liên quan đến không gian làm việc bao quanh. Nếu bạn bỏ qua hoặc để trống, giá trị mặc định sẽ là kết quả của lệnh "bazel info default-package-path".
- Giá trị mặc định của
--[no]show_loading_progress
: "true" - Nếu được bật, sẽ khiến Bazel in thông báo "Loading package" ("Đang tải gói").
Run Options (Tuỳ chọn chạy)
Kế thừa tất cả các tuỳ chọn từ build.
- Các tuỳ chọn xuất hiện trước lệnh và được máy khách phân tích cú pháp:
--distdir=<a path>
nhiều lần sử dụng được tích luỹ-
Các vị trí khác để tìm kiếm bản lưu trữ trước khi truy cập vào mạng để tải xuống.
Thẻ:bazel_internal_configuration
- Giá trị mặc định của
--[no]experimental_repository_cache_hardlinks
: "false" - Nếu được đặt, bộ nhớ đệm kho lưu trữ sẽ liên kết cứng tệp trong trường hợp có lượt truy cập vào bộ nhớ đệm, thay vì sao chép. Việc này nhằm tiết kiệm dung lượng ổ đĩa.
Thẻ:bazel_internal_configuration
--experimental_repository_downloader_retries=<an integer>
mặc định: "0"-
Số lần thử tối đa để thử lại lỗi tải xuống. Nếu bạn đặt thành 0, thì tính năng thử lại sẽ bị tắt.
Thẻ:experimental
--experimental_scale_timeouts=<a double>
mặc định: "1.0"- Điều chỉnh tất cả thời gian chờ trong quy tắc kho lưu trữ Starlark theo hệ số này. Bằng cách này, bạn có thể làm cho kho lưu trữ bên ngoài hoạt động trên các máy chạy chậm hơn dự kiến của tác giả quy tắc mà không cần thay đổi mã nguồn
Thẻ:bazel_internal_configuration
,experimental
- Giá trị mặc định của
--[no]incompatible_disable_native_repo_rules
: "false" - Nếu giá trị là false, bạn có thể sử dụng các quy tắc kho lưu trữ gốc trong WORKSPACE; nếu không, bạn phải sử dụng các quy tắc kho lưu trữ Starlark. Các quy tắc kho lưu trữ gốc bao gồm local_repository, new_local_repository, local_config_platform, android_sdk_repository và android_ndk_repository.
Thẻ:bazel_internal_configuration
--repository_cache=<a path>
mặc định: xem nội dung mô tả- Chỉ định vị trí bộ nhớ đệm của các giá trị đã tải xuống thu được trong quá trình tìm nạp kho lưu trữ bên ngoài. Chuỗi trống làm đối số yêu cầu tắt bộ nhớ đệm, nếu không, giá trị mặc định là "<output_user_root>/cache/repos/v1" sẽ được sử dụng
Thẻ:bazel_internal_configuration
- Giá trị mặc định của
--[no]repository_disable_download
: "false" - Nếu được đặt, bạn không được phép tải xuống bằng ctx.download{,_and_extract} trong quá trình tìm nạp kho lưu trữ. Xin lưu ý rằng quyền truy cập mạng không bị tắt hoàn toàn; ctx.execute vẫn có thể chạy một tệp thực thi tuỳ ý truy cập Internet.
Thẻ:bazel_internal_configuration
- Giá trị mặc định của
--[no]run
: "true" - Nếu giá trị là false, hãy bỏ qua việc chạy dòng lệnh được tạo cho mục tiêu đã tạo.
Thẻ:affects_outputs
- Các tuỳ chọn kiểm soát việc thực thi bản dựng:
- Giá trị mặc định của
--gc_thrashing_threshold=<an integer in 0-100 range>
: "100" -
Tỷ lệ phần trăm không gian cố định bị chiếm dụng (0-100) mà tại đó GcThrashingDetector xem xét các sự kiện áp lực bộ nhớ so với giới hạn của nó (--gc_thrashing_limits). Nếu bạn đặt thành 100, GcThrashingDetector sẽ bị tắt.
Thẻ:host_machine_resource_optimizations
- Các tuỳ chọn cho phép người dùng định cấu hình đầu ra dự kiến, ảnh hưởng đến giá trị của đầu ra đó, thay vì sự tồn tại của đầu ra:
--script_path=<a path>
mặc định: xem nội dung mô tả- Nếu được đặt, hãy ghi tập lệnh shell vào tệp đã cho để gọi mục tiêu. Nếu bạn đặt tuỳ chọn này, mục tiêu sẽ không chạy từ bazel. Sử dụng lệnh "bazel run --script_path=foo //foo && ./foo" để gọi mục tiêu "//foo". Thao tác này khác với lệnh "bazel run //foo" ở chỗ khoá bazel được phát hành và tệp thực thi được kết nối với stdin của thiết bị đầu cuối.
Thẻ:affects_outputs
,execution
- Các tuỳ chọn liên quan đến ngữ nghĩa và đầu ra của Bzlmod:
--allow_yanked_versions=<a string>
nhiều lần sử dụng được tích luỹ-
Chỉ định các phiên bản mô-đun ở dạng `<module1>@<version1>,<module2>@<version2>` sẽ được cho phép trong biểu đồ phần phụ thuộc đã phân giải ngay cả khi các phiên bản đó được khai báo là đã bị xoá trong sổ đăng ký nơi chúng đến (nếu không đến từ NonRegistryOverride). Nếu không, các phiên bản bị xoá sẽ khiến việc phân giải không thành công. Bạn cũng có thể xác định phiên bản bị xoá được phép bằng biến môi trường `BZLMOD_ALLOW_YANKED_VERSIONS`. Bạn có thể tắt tính năng kiểm tra này bằng cách sử dụng từ khoá "tất cả" (không nên dùng).
Thẻ:loading_and_analysis
--check_bazel_compatibility=<error, warning or off>
mặc định: "lỗi"-
Kiểm tra khả năng tương thích của phiên bản bazel của các mô-đun Bazel. Các giá trị hợp lệ là "error" để chuyển vấn đề này lên lỗi phân giải, "off" để tắt tính năng kiểm tra hoặc "warning" để in cảnh báo khi phát hiện thấy không khớp.
Thẻ:loading_and_analysis
--check_direct_dependencies=<off, warning or error>
mặc định: "cảnh báo"-
Kiểm tra xem các phần phụ thuộc `bazel_dep` trực tiếp được khai báo trong mô-đun gốc có phải là các phiên bản mà bạn nhận được trong biểu đồ phần phụ thuộc đã được phân giải hay không. Các giá trị hợp lệ là "off" để tắt tính năng kiểm tra, "warning" để in cảnh báo khi phát hiện thấy không khớp hoặc "error" để chuyển lên lỗi phân giải.
Thẻ:loading_and_analysis
- Giá trị mặc định của
--[no]ignore_dev_dependency
: "false" - Nếu đúng, Bazel sẽ bỏ qua "bazel_dep" và "use_extension" được khai báo là "dev_dependency" trong MODULE.bazel của mô-đun gốc. Xin lưu ý rằng các phần phụ thuộc dành cho nhà phát triển đó luôn bị bỏ qua trong MODULE.bazel nếu đó không phải là mô-đun gốc, bất kể giá trị của cờ này là gì.
Thẻ:loading_and_analysis
--lockfile_mode=<off, update, refresh or error>
mặc định: "cập nhật"-
Chỉ định cách thức và liệu có sử dụng tệp khoá hay không. Các giá trị hợp lệ là "update" để sử dụng tệp khoá và cập nhật tệp khoá nếu có thay đổi, "refresh" để thỉnh thoảng làm mới thông tin có thể thay đổi (các phiên bản bị loại bỏ và các mô-đun bị thiếu trước đó) từ các sổ đăng ký từ xa, "error" để sử dụng tệp khoá nhưng gửi lỗi nếu tệp khoá không được cập nhật hoặc "off" để không đọc hoặc ghi vào tệp khoá.
Thẻ:loading_and_analysis
--override_module=<an equals-separated mapping of module name to path>
nhiều lần sử dụng được tích luỹ- Ghi đè một mô-đun bằng đường dẫn cục bộ ở dạng <tên mô-đun>=<đường dẫn>. Nếu đường dẫn đã cho là đường dẫn tuyệt đối, thì đường dẫn đó sẽ được sử dụng nguyên trạng. Nếu đường dẫn đã cho là đường dẫn tương đối, thì đường dẫn đó sẽ tương ứng với thư mục đang hoạt động. Nếu đường dẫn đã cho bắt đầu bằng "%workspace%", thì đường dẫn đó sẽ tương ứng với thư mục gốc của không gian làm việc, là kết quả của lệnh "bazel info workspace". Nếu đường dẫn đã cho trống, hãy xoá mọi chế độ ghi đè trước đó.
--registry=<a string>
nhiều lần sử dụng được tích luỹ- Chỉ định các sổ đăng ký cần sử dụng để xác định vị trí các phần phụ thuộc mô-đun Bazel. Thứ tự rất quan trọng: các mô-đun sẽ được tra cứu trong các sổ đăng ký trước đó trước tiên và chỉ quay lại các sổ đăng ký sau này khi các mô-đun đó bị thiếu trong các sổ đăng ký trước đó.
Thẻ:changes_inputs
--vendor_dir=<a path>
mặc định: xem nội dung mô tả-
Chỉ định thư mục sẽ chứa các kho lưu trữ bên ngoài ở chế độ nhà cung cấp, cho dù mục đích là tìm nạp các kho lưu trữ đó vào thư mục hay sử dụng các kho lưu trữ đó trong khi xây dựng. Bạn có thể chỉ định đường dẫn dưới dạng đường dẫn tuyệt đối hoặc đường dẫn tương đối đến thư mục không gian làm việc.
Thẻ:loading_and_analysis
- Các tuỳ chọn kích hoạt tính năng tối ưu hoá thời gian xây dựng:
--gc_thrashing_limits=<comma separated pairs of <period>:<count>>
mặc định: "1s:2,20s:3,1m:5"-
Các giới hạn nếu đạt đến sẽ khiến GcThrashingDetector gặp sự cố Bazel với OOM. Mỗi giới hạn được chỉ định là <period>:<count>, trong đó period là thời lượng và count là số nguyên dương. Nếu hơn --gc_thrashing_threshold phần trăm không gian cố định (vùng nhớ khối xếp cũ) vẫn bị chiếm dụng sau <count> lần GC đầy đủ liên tiếp trong <period>, thì lỗi OOM sẽ được kích hoạt. Bạn có thể chỉ định nhiều giới hạn, phân tách bằng dấu phẩy.
Thẻ:host_machine_resource_optimizations
--skyframe_high_water_mark_full_gc_drops_per_invocation=<an integer, >= 0>
mặc định: "2147483647"-
Cờ cho cấu hình nâng cao của công cụ Skyframe nội bộ của Bazel. Nếu phát hiện mức sử dụng phần trăm vùng nhớ khối xếp được giữ lại vượt quá ngưỡng do --skyframe_high_water_mark_threshold đặt ra, thì khi một sự kiện GC đầy đủ xảy ra, Bazel sẽ loại bỏ trạng thái Skyframe tạm thời không cần thiết, lên đến nhiều lần như vậy cho mỗi lệnh gọi. Mặc định là Integer.MAX_VALUE; không giới hạn về mặt hiệu quả. Giá trị 0 có nghĩa là các sự kiện GC đầy đủ sẽ không bao giờ kích hoạt sự kiện thả. Nếu đạt đến giới hạn, trạng thái Skyframe sẽ không còn bị loại bỏ khi một sự kiện GC đầy đủ xảy ra và vượt quá ngưỡng phần trăm vùng nhớ khối xếp được giữ lại đó.
Thẻ:host_machine_resource_optimizations
--skyframe_high_water_mark_minor_gc_drops_per_invocation=<an integer, >= 0>
mặc định: "2147483647"-
Cờ cho cấu hình nâng cao của công cụ Skyframe nội bộ của Bazel. Nếu phát hiện mức sử dụng phần trăm vùng nhớ khối xếp được giữ lại vượt quá ngưỡng do --skyframe_high_water_mark_threshold đặt ra, thì khi một sự kiện GC nhỏ xảy ra, Bazel sẽ loại bỏ trạng thái Skyframe tạm thời không cần thiết, lên đến nhiều lần như vậy mỗi lần gọi. Mặc định là Integer.MAX_VALUE; không giới hạn về mặt hiệu quả. Giá trị 0 có nghĩa là các sự kiện GC nhỏ sẽ không bao giờ kích hoạt sự kiện thả. Nếu đạt đến giới hạn, trạng thái Skyframe sẽ không còn bị loại bỏ khi một sự kiện GC nhỏ xảy ra và vượt quá ngưỡng phần trăm vùng nhớ khối xếp được giữ lại.
Thẻ:host_machine_resource_optimizations
--skyframe_high_water_mark_threshold=<an integer>
mặc định: "85"-
Cờ cho cấu hình nâng cao của công cụ Skyframe nội bộ của Bazel. Nếu phát hiện mức sử dụng phần trăm vùng nhớ khối xếp được giữ lại ít nhất là ngưỡng này, Bazel sẽ loại bỏ trạng thái Skyframe tạm thời không cần thiết. Việc điều chỉnh điều này có thể giúp bạn giảm thiểu tác động của tình trạng GC bị lỗi khi (i) tình trạng này là do mức sử dụng bộ nhớ của trạng thái tạm thời và (ii) tốn kém hơn so với việc tạo lại trạng thái khi cần.
Thẻ:host_machine_resource_optimizations
- Các tuỳ chọn ảnh hưởng đến mức độ chi tiết, định dạng hoặc vị trí ghi nhật ký:
--experimental_command_profile=<cpu, wall, alloc or lock>
mặc định: xem nội dung mô tả- Ghi hồ sơ Trình ghi chuyến bay Java trong thời gian thực thi lệnh. Bạn phải cung cấp một trong các loại sự kiện phân tích tài nguyên được hỗ trợ (cpu, wall, alloc hoặc lock) dưới dạng đối số. Hồ sơ được ghi vào một tệp được đặt tên theo loại sự kiện trong thư mục cơ sở đầu ra. Cú pháp và ngữ nghĩa của cờ này có thể thay đổi trong tương lai để hỗ trợ thêm các loại hồ sơ hoặc định dạng đầu ra; bạn tự chịu rủi ro khi sử dụng.
- Giá trị mặc định của
--[no]experimental_record_metrics_for_all_mnemonics
: "false" - Theo mặc định, số lượng loại thao tác được giới hạn ở 20 câu thần chú có số lượng thao tác được thực thi nhiều nhất. Việc đặt tuỳ chọn này sẽ ghi số liệu thống kê cho tất cả các câu thần chú.
- Các tuỳ chọn chỉ định hoặc thay đổi dữ liệu đầu vào chung thành một lệnh Bazel không thuộc các danh mục khác.:
--experimental_resolved_file_instead_of_workspace=<a string>
mặc định: ""- Nếu không trống, hãy đọc tệp đã phân giải được chỉ định thay vì tệp WORKSPACE
Thẻ:changes_inputs
- Các tuỳ chọn thực thi và lưu vào bộ nhớ đệm từ xa:
--experimental_downloader_config=<a string>
mặc định: xem nội dung mô tả- Chỉ định một tệp để định cấu hình trình tải xuống từ xa. Tệp này bao gồm các dòng, mỗi dòng bắt đầu bằng một lệnh (`allow`, `block` hoặc `rewrite`), theo sau là tên máy chủ lưu trữ (đối với lệnh `allow` và `block`) hoặc hai mẫu, một mẫu để so khớp và một mẫu để sử dụng làm URL thay thế, với các tệp tham chiếu ngược bắt đầu từ `$1`. Bạn có thể cung cấp nhiều lệnh `rewrite` cho cùng một URL và trong trường hợp này, nhiều URL sẽ được trả về.
- Giá trị mặc định của
--experimental_worker_for_repo_fetching=<off, platform, virtual or auto>
: "tự động" - Chế độ tạo luồng để tìm nạp kho lưu trữ. Nếu bạn đặt thành "tắt", thì không có luồng worker nào được sử dụng và quá trình tìm nạp kho lưu trữ sẽ phải khởi động lại. Nếu không, hãy sử dụng luồng worker ảo.
- Các tuỳ chọn khác, không được phân loại theo cách khác.:
--override_repository=<an equals-separated mapping of repository name to path>
nhiều lần sử dụng được tích luỹ- Ghi đè kho lưu trữ bằng một đường dẫn cục bộ ở dạng <repository name>=<path>. Nếu đường dẫn đã cho là đường dẫn tuyệt đối, thì đường dẫn đó sẽ được sử dụng nguyên trạng. Nếu đường dẫn đã cho là đường dẫn tương đối, thì đường dẫn đó sẽ tương ứng với thư mục đang hoạt động. Nếu đường dẫn đã cho bắt đầu bằng "%workspace%", thì đường dẫn đó sẽ tương ứng với thư mục gốc của không gian làm việc, là kết quả của lệnh "bazel info workspace". Nếu đường dẫn đã cho trống, hãy xoá mọi chế độ ghi đè trước đó.
Tuỳ chọn tắt máy
- Các tuỳ chọn xuất hiện trước lệnh và được máy khách phân tích cú pháp:
--distdir=<a path>
nhiều lần sử dụng được tích luỹ-
Các vị trí khác để tìm kiếm bản lưu trữ trước khi truy cập vào mạng để tải xuống.
Thẻ:bazel_internal_configuration
- Giá trị mặc định của
--[no]experimental_repository_cache_hardlinks
: "false" - Nếu được đặt, bộ nhớ đệm kho lưu trữ sẽ liên kết cứng tệp trong trường hợp có lượt truy cập vào bộ nhớ đệm, thay vì sao chép. Việc này nhằm tiết kiệm dung lượng ổ đĩa.
Thẻ:bazel_internal_configuration
--experimental_repository_downloader_retries=<an integer>
mặc định: "0"-
Số lần thử tối đa để thử lại lỗi tải xuống. Nếu bạn đặt thành 0, thì tính năng thử lại sẽ bị tắt.
Thẻ:experimental
--experimental_scale_timeouts=<a double>
mặc định: "1.0"- Điều chỉnh tất cả thời gian chờ trong quy tắc kho lưu trữ Starlark theo hệ số này. Bằng cách này, bạn có thể làm cho kho lưu trữ bên ngoài hoạt động trên các máy chạy chậm hơn dự kiến của tác giả quy tắc mà không cần thay đổi mã nguồn
Thẻ:bazel_internal_configuration
,experimental
- Giá trị mặc định của
--[no]incompatible_disable_native_repo_rules
: "false" - Nếu giá trị là false, bạn có thể sử dụng các quy tắc kho lưu trữ gốc trong WORKSPACE; nếu không, bạn phải sử dụng các quy tắc kho lưu trữ Starlark. Các quy tắc kho lưu trữ gốc bao gồm local_repository, new_local_repository, local_config_platform, android_sdk_repository và android_ndk_repository.
Thẻ:bazel_internal_configuration
--repository_cache=<a path>
mặc định: xem nội dung mô tả- Chỉ định vị trí bộ nhớ đệm của các giá trị đã tải xuống thu được trong quá trình tìm nạp kho lưu trữ bên ngoài. Chuỗi trống làm đối số yêu cầu tắt bộ nhớ đệm, nếu không, giá trị mặc định là "<output_user_root>/cache/repos/v1" sẽ được sử dụng
Thẻ:bazel_internal_configuration
- Giá trị mặc định của
--[no]repository_disable_download
: "false" - Nếu được đặt, bạn không được phép tải xuống bằng ctx.download{,_and_extract} trong quá trình tìm nạp kho lưu trữ. Xin lưu ý rằng quyền truy cập mạng không bị tắt hoàn toàn; ctx.execute vẫn có thể chạy một tệp thực thi tuỳ ý truy cập Internet.
Thẻ:bazel_internal_configuration
- Các tuỳ chọn kiểm soát việc thực thi bản dựng:
- Giá trị mặc định của
--gc_thrashing_threshold=<an integer in 0-100 range>
: "100" -
Tỷ lệ phần trăm không gian cố định bị chiếm dụng (0-100) mà tại đó GcThrashingDetector xem xét các sự kiện áp lực bộ nhớ so với giới hạn của nó (--gc_thrashing_limits). Nếu bạn đặt thành 100, GcThrashingDetector sẽ bị tắt.
Thẻ:host_machine_resource_optimizations
- Các tuỳ chọn kiểm soát đầu ra của lệnh:
--iff_heap_size_greater_than=<an integer>
mặc định: "0"- Nếu không bằng 0, thì thao tác tắt sẽ chỉ tắt máy chủ nếu tổng dung lượng bộ nhớ (tính bằng MB) mà JVM sử dụng vượt quá giá trị này.
Thẻ:loses_incremental_state
,eagerness_to_exit
- Các tuỳ chọn liên quan đến ngữ nghĩa và đầu ra của Bzlmod:
--allow_yanked_versions=<a string>
nhiều lần sử dụng được tích luỹ-
Chỉ định các phiên bản mô-đun ở dạng `<module1>@<version1>,<module2>@<version2>` sẽ được cho phép trong biểu đồ phần phụ thuộc đã phân giải ngay cả khi các phiên bản đó được khai báo là đã bị xoá trong sổ đăng ký nơi chúng đến (nếu không đến từ NonRegistryOverride). Nếu không, các phiên bản bị xoá sẽ khiến việc phân giải không thành công. Bạn cũng có thể xác định phiên bản bị xoá được phép bằng biến môi trường `BZLMOD_ALLOW_YANKED_VERSIONS`. Bạn có thể tắt tính năng kiểm tra này bằng cách sử dụng từ khoá "tất cả" (không nên dùng).
Thẻ:loading_and_analysis
--check_bazel_compatibility=<error, warning or off>
mặc định: "lỗi"-
Kiểm tra khả năng tương thích của phiên bản bazel của các mô-đun Bazel. Các giá trị hợp lệ là "error" để chuyển vấn đề này lên lỗi phân giải, "off" để tắt tính năng kiểm tra hoặc "warning" để in cảnh báo khi phát hiện thấy không khớp.
Thẻ:loading_and_analysis
--check_direct_dependencies=<off, warning or error>
mặc định: "cảnh báo"-
Kiểm tra xem các phần phụ thuộc `bazel_dep` trực tiếp được khai báo trong mô-đun gốc có phải là các phiên bản mà bạn nhận được trong biểu đồ phần phụ thuộc đã được phân giải hay không. Các giá trị hợp lệ là "off" để tắt tính năng kiểm tra, "warning" để in cảnh báo khi phát hiện thấy không khớp hoặc "error" để chuyển lên lỗi phân giải.
Thẻ:loading_and_analysis
- Giá trị mặc định của
--[no]ignore_dev_dependency
: "false" - Nếu đúng, Bazel sẽ bỏ qua "bazel_dep" và "use_extension" được khai báo là "dev_dependency" trong MODULE.bazel của mô-đun gốc. Xin lưu ý rằng các phần phụ thuộc dành cho nhà phát triển đó luôn bị bỏ qua trong MODULE.bazel nếu đó không phải là mô-đun gốc, bất kể giá trị của cờ này là gì.
Thẻ:loading_and_analysis
--lockfile_mode=<off, update, refresh or error>
mặc định: "cập nhật"-
Chỉ định cách thức và liệu có sử dụng tệp khoá hay không. Các giá trị hợp lệ là "update" để sử dụng tệp khoá và cập nhật tệp khoá nếu có thay đổi, "refresh" để thỉnh thoảng làm mới thông tin có thể thay đổi (các phiên bản bị loại bỏ và các mô-đun bị thiếu trước đó) từ các sổ đăng ký từ xa, "error" để sử dụng tệp khoá nhưng gửi lỗi nếu tệp khoá không được cập nhật hoặc "off" để không đọc hoặc ghi vào tệp khoá.
Thẻ:loading_and_analysis
--override_module=<an equals-separated mapping of module name to path>
nhiều lần sử dụng được tích luỹ- Ghi đè một mô-đun bằng đường dẫn cục bộ ở dạng <tên mô-đun>=<đường dẫn>. Nếu đường dẫn đã cho là đường dẫn tuyệt đối, thì đường dẫn đó sẽ được sử dụng nguyên trạng. Nếu đường dẫn đã cho là đường dẫn tương đối, thì đường dẫn đó sẽ tương ứng với thư mục đang hoạt động. Nếu đường dẫn đã cho bắt đầu bằng "%workspace%", thì đường dẫn đó sẽ tương ứng với thư mục gốc của không gian làm việc, là kết quả của lệnh "bazel info workspace". Nếu đường dẫn đã cho trống, hãy xoá mọi chế độ ghi đè trước đó.
--registry=<a string>
nhiều lần sử dụng được tích luỹ- Chỉ định các sổ đăng ký cần sử dụng để xác định vị trí các phần phụ thuộc mô-đun Bazel. Thứ tự rất quan trọng: các mô-đun sẽ được tra cứu trong các sổ đăng ký trước đó trước tiên và chỉ quay lại các sổ đăng ký sau này khi các mô-đun đó bị thiếu trong các sổ đăng ký trước đó.
Thẻ:changes_inputs
--vendor_dir=<a path>
mặc định: xem nội dung mô tả-
Chỉ định thư mục sẽ chứa các kho lưu trữ bên ngoài ở chế độ nhà cung cấp, cho dù mục đích là tìm nạp các kho lưu trữ đó vào thư mục hay sử dụng các kho lưu trữ đó trong khi xây dựng. Bạn có thể chỉ định đường dẫn dưới dạng đường dẫn tuyệt đối hoặc đường dẫn tương đối đến thư mục không gian làm việc.
Thẻ:loading_and_analysis
- Các tuỳ chọn kích hoạt tính năng tối ưu hoá thời gian xây dựng:
--gc_thrashing_limits=<comma separated pairs of <period>:<count>>
mặc định: "1s:2,20s:3,1m:5"-
Các giới hạn nếu đạt đến sẽ khiến GcThrashingDetector gặp sự cố Bazel với OOM. Mỗi giới hạn được chỉ định là <period>:<count>, trong đó period là thời lượng và count là số nguyên dương. Nếu hơn --gc_thrashing_threshold phần trăm không gian cố định (vùng nhớ khối xếp cũ) vẫn bị chiếm dụng sau <count> lần GC đầy đủ liên tiếp trong <period>, thì lỗi OOM sẽ được kích hoạt. Bạn có thể chỉ định nhiều giới hạn, phân tách bằng dấu phẩy.
Thẻ:host_machine_resource_optimizations
--skyframe_high_water_mark_full_gc_drops_per_invocation=<an integer, >= 0>
mặc định: "2147483647"-
Cờ cho cấu hình nâng cao của công cụ Skyframe nội bộ của Bazel. Nếu phát hiện mức sử dụng phần trăm vùng nhớ khối xếp được giữ lại vượt quá ngưỡng do --skyframe_high_water_mark_threshold đặt ra, thì khi một sự kiện GC đầy đủ xảy ra, Bazel sẽ loại bỏ trạng thái Skyframe tạm thời không cần thiết, lên đến nhiều lần như vậy cho mỗi lệnh gọi. Mặc định là Integer.MAX_VALUE; không giới hạn về mặt hiệu quả. Giá trị 0 có nghĩa là các sự kiện GC đầy đủ sẽ không bao giờ kích hoạt sự kiện thả. Nếu đạt đến giới hạn, trạng thái Skyframe sẽ không còn bị loại bỏ khi một sự kiện GC đầy đủ xảy ra và vượt quá ngưỡng phần trăm vùng nhớ khối xếp được giữ lại đó.
Thẻ:host_machine_resource_optimizations
--skyframe_high_water_mark_minor_gc_drops_per_invocation=<an integer, >= 0>
mặc định: "2147483647"-
Cờ cho cấu hình nâng cao của công cụ Skyframe nội bộ của Bazel. Nếu phát hiện mức sử dụng phần trăm vùng nhớ khối xếp được giữ lại vượt quá ngưỡng do --skyframe_high_water_mark_threshold đặt ra, thì khi một sự kiện GC nhỏ xảy ra, Bazel sẽ loại bỏ trạng thái Skyframe tạm thời không cần thiết, lên đến nhiều lần như vậy mỗi lần gọi. Mặc định là Integer.MAX_VALUE; không giới hạn về mặt hiệu quả. Giá trị 0 có nghĩa là các sự kiện GC nhỏ sẽ không bao giờ kích hoạt sự kiện thả. Nếu đạt đến giới hạn, trạng thái Skyframe sẽ không còn bị loại bỏ khi một sự kiện GC nhỏ xảy ra và vượt quá ngưỡng phần trăm vùng nhớ khối xếp được giữ lại.
Thẻ:host_machine_resource_optimizations
--skyframe_high_water_mark_threshold=<an integer>
mặc định: "85"-
Cờ cho cấu hình nâng cao của công cụ Skyframe nội bộ của Bazel. Nếu phát hiện mức sử dụng phần trăm vùng nhớ khối xếp được giữ lại ít nhất là ngưỡng này, Bazel sẽ loại bỏ trạng thái Skyframe tạm thời không cần thiết. Việc điều chỉnh điều này có thể giúp bạn giảm thiểu tác động của tình trạng GC bị lỗi khi (i) tình trạng này là do mức sử dụng bộ nhớ của trạng thái tạm thời và (ii) tốn kém hơn so với việc tạo lại trạng thái khi cần.
Thẻ:host_machine_resource_optimizations
- Các tuỳ chọn ảnh hưởng đến mức độ chi tiết, định dạng hoặc vị trí ghi nhật ký:
--experimental_command_profile=<cpu, wall, alloc or lock>
mặc định: xem nội dung mô tả- Ghi hồ sơ Trình ghi chuyến bay Java trong thời gian thực thi lệnh. Bạn phải cung cấp một trong các loại sự kiện phân tích tài nguyên được hỗ trợ (cpu, wall, alloc hoặc lock) dưới dạng đối số. Hồ sơ được ghi vào một tệp được đặt tên theo loại sự kiện trong thư mục cơ sở đầu ra. Cú pháp và ngữ nghĩa của cờ này có thể thay đổi trong tương lai để hỗ trợ thêm các loại hồ sơ hoặc định dạng đầu ra; bạn tự chịu rủi ro khi sử dụng.
- Giá trị mặc định của
--[no]experimental_record_metrics_for_all_mnemonics
: "false" - Theo mặc định, số lượng loại thao tác được giới hạn ở 20 câu thần chú có số lượng thao tác được thực thi nhiều nhất. Việc đặt tuỳ chọn này sẽ ghi số liệu thống kê cho tất cả các câu thần chú.
- Các tuỳ chọn chỉ định hoặc thay đổi dữ liệu đầu vào chung thành một lệnh Bazel không thuộc các danh mục khác.:
--experimental_resolved_file_instead_of_workspace=<a string>
mặc định: ""- Nếu không trống, hãy đọc tệp đã phân giải được chỉ định thay vì tệp WORKSPACE
Thẻ:changes_inputs
- Các tuỳ chọn thực thi và lưu vào bộ nhớ đệm từ xa:
--experimental_downloader_config=<a string>
mặc định: xem nội dung mô tả- Chỉ định một tệp để định cấu hình trình tải xuống từ xa. Tệp này bao gồm các dòng, mỗi dòng bắt đầu bằng một lệnh (`allow`, `block` hoặc `rewrite`), theo sau là tên máy chủ lưu trữ (đối với lệnh `allow` và `block`) hoặc hai mẫu, một mẫu để so khớp và một mẫu để sử dụng làm URL thay thế, với các tệp tham chiếu ngược bắt đầu từ `$1`. Bạn có thể cung cấp nhiều lệnh `rewrite` cho cùng một URL và trong trường hợp này, nhiều URL sẽ được trả về.
- Giá trị mặc định của
--experimental_worker_for_repo_fetching=<off, platform, virtual or auto>
: "tự động" - Chế độ tạo luồng để tìm nạp kho lưu trữ. Nếu bạn đặt thành "tắt", thì không có luồng worker nào được sử dụng và quá trình tìm nạp kho lưu trữ sẽ phải khởi động lại. Nếu không, hãy sử dụng luồng worker ảo.
- Các tuỳ chọn khác, không được phân loại theo cách khác.:
--override_repository=<an equals-separated mapping of repository name to path>
nhiều lần sử dụng được tích luỹ- Ghi đè kho lưu trữ bằng một đường dẫn cục bộ ở dạng <repository name>=<path>. Nếu đường dẫn đã cho là đường dẫn tuyệt đối, thì đường dẫn đó sẽ được sử dụng nguyên trạng. Nếu đường dẫn đã cho là đường dẫn tương đối, thì đường dẫn đó sẽ tương ứng với thư mục đang hoạt động. Nếu đường dẫn đã cho bắt đầu bằng "%workspace%", thì đường dẫn đó sẽ tương ứng với thư mục gốc của không gian làm việc, là kết quả của lệnh "bazel info workspace". Nếu đường dẫn đã cho trống, hãy xoá mọi chế độ ghi đè trước đó.
Tuỳ chọn đồng bộ hoá
- Các tuỳ chọn xuất hiện trước lệnh và được máy khách phân tích cú pháp:
--distdir=<a path>
nhiều lần sử dụng được tích luỹ-
Các vị trí khác để tìm kiếm bản lưu trữ trước khi truy cập vào mạng để tải xuống.
Thẻ:bazel_internal_configuration
- Giá trị mặc định của
--[no]experimental_repository_cache_hardlinks
: "false" - Nếu được đặt, bộ nhớ đệm kho lưu trữ sẽ liên kết cứng tệp trong trường hợp có lượt truy cập vào bộ nhớ đệm, thay vì sao chép. Việc này nhằm tiết kiệm dung lượng ổ đĩa.
Thẻ:bazel_internal_configuration
--experimental_repository_downloader_retries=<an integer>
mặc định: "0"-
Số lần thử tối đa để thử lại lỗi tải xuống. Nếu bạn đặt thành 0, thì tính năng thử lại sẽ bị tắt.
Thẻ:experimental
--experimental_scale_timeouts=<a double>
mặc định: "1.0"- Điều chỉnh tất cả thời gian chờ trong quy tắc kho lưu trữ Starlark theo hệ số này. Bằng cách này, bạn có thể làm cho kho lưu trữ bên ngoài hoạt động trên các máy chạy chậm hơn dự kiến của tác giả quy tắc mà không cần thay đổi mã nguồn
Thẻ:bazel_internal_configuration
,experimental
- Giá trị mặc định của
--[no]incompatible_disable_native_repo_rules
: "false" - Nếu giá trị là false, bạn có thể sử dụng các quy tắc kho lưu trữ gốc trong WORKSPACE; nếu không, bạn phải sử dụng các quy tắc kho lưu trữ Starlark. Các quy tắc kho lưu trữ gốc bao gồm local_repository, new_local_repository, local_config_platform, android_sdk_repository và android_ndk_repository.
Thẻ:bazel_internal_configuration
--repository_cache=<a path>
mặc định: xem nội dung mô tả- Chỉ định vị trí bộ nhớ đệm của các giá trị đã tải xuống thu được trong quá trình tìm nạp kho lưu trữ bên ngoài. Chuỗi trống làm đối số yêu cầu tắt bộ nhớ đệm, nếu không, giá trị mặc định là "<output_user_root>/cache/repos/v1" sẽ được sử dụng
Thẻ:bazel_internal_configuration
- Giá trị mặc định của
--[no]repository_disable_download
: "false" - Nếu được đặt, bạn không được phép tải xuống bằng ctx.download{,_and_extract} trong quá trình tìm nạp kho lưu trữ. Xin lưu ý rằng quyền truy cập mạng không bị tắt hoàn toàn; ctx.execute vẫn có thể chạy một tệp thực thi tuỳ ý truy cập Internet.
Thẻ:bazel_internal_configuration
- Các tuỳ chọn kiểm soát việc thực thi bản dựng:
- Giá trị mặc định của
--[no]configure
: "False" -
Chỉ đồng bộ hoá các kho lưu trữ được đánh dấu là "định cấu hình" cho mục đích định cấu hình hệ thống.
Thẻ:changes_inputs
- Giá trị mặc định của
--gc_thrashing_threshold=<an integer in 0-100 range>
: "100" -
Tỷ lệ phần trăm không gian cố định bị chiếm dụng (0-100) mà tại đó GcThrashingDetector xem xét các sự kiện áp lực bộ nhớ so với giới hạn của nó (--gc_thrashing_limits). Nếu bạn đặt thành 100, GcThrashingDetector sẽ bị tắt.
Thẻ:host_machine_resource_optimizations
--[no]keep_going
[-k
] mặc định: "false"-
Tiếp tục nhiều nhất có thể sau khi xảy ra lỗi. Mặc dù không thể phân tích mục tiêu không thành công và các mục tiêu phụ thuộc vào mục tiêu đó, nhưng bạn có thể phân tích các điều kiện tiên quyết khác của các mục tiêu này.
Thẻ:eagerness_to_exit
- Giá trị mặc định của
--loading_phase_threads=<an integer, or a keyword ("auto", "HOST_CPUS", "HOST_RAM"), optionally followed by an operation ([-|*]<float>) eg. "auto", "HOST_CPUS*.5">
: "tự động" - Số luồng song song cần sử dụng cho giai đoạn tải/phân tích. Nhận một số nguyên hoặc từ khoá ("tự động", "HOST_CPUS", "HOST_RAM"), theo sau có thể là một phép toán ([-|*]<float>) ví dụ: "tự động", "HOST_CPUS*.5". "tự động" đặt giá trị mặc định hợp lý dựa trên tài nguyên của máy chủ lưu trữ. Phải ít nhất là 1.
Thẻ:bazel_internal_configuration
--only=<a string>
nhiều lần sử dụng được tích luỹ- Nếu bạn cung cấp tuỳ chọn này, chỉ đồng bộ hoá các kho lưu trữ được chỉ định bằng tuỳ chọn này. Vẫn coi tất cả (hoặc tất cả các cấu hình tương tự, của --configure được cung cấp) là lỗi thời.
Thẻ:changes_inputs
- Tuỳ chọn này ảnh hưởng đến ngữ nghĩa của ngôn ngữ Starlark hoặc API bản dựng có thể truy cập vào các tệp BUILD, tệp .bzl hoặc tệp WORKSPACE.:
- Giá trị mặc định của
--[no]incompatible_config_setting_private_default_visibility
: "false" - Nếu incompatible_enforce_config_setting_visibility=false, thì đây là một thao tác không có tác dụng. Nếu không, nếu cờ này là false, mọi config_setting không có thuộc tính chế độ hiển thị rõ ràng sẽ là //visibility:public. Nếu cờ này là true, config_setting sẽ tuân theo logic hiển thị giống như tất cả các quy tắc khác. Xem https://github.com/bazelbuild/bazel/issues/12933.
Thẻ:loading_and_analysis
,incompatible_change
- Giá trị mặc định của
--[no]incompatible_enforce_config_setting_visibility
: "true" - Nếu đúng, hãy thực thi các quy định hạn chế về chế độ hiển thị config_setting. Nếu giá trị là false, mọi mục config_setting đều hiển thị với mọi mục tiêu. Xem https://github.com/bazelbuild/bazel/issues/12932.
Thẻ:loading_and_analysis
,incompatible_change
- Các tuỳ chọn liên quan đến kết quả và ngữ nghĩa của Bzlmod:
--allow_yanked_versions=<a string>
nhiều lần sử dụng được tích luỹ-
Chỉ định các phiên bản mô-đun ở dạng `<module1>@<version1>,<module2>@<version2>` sẽ được cho phép trong biểu đồ phần phụ thuộc đã phân giải ngay cả khi các phiên bản đó được khai báo là đã bị xoá trong sổ đăng ký nơi chúng đến (nếu không đến từ NonRegistryOverride). Nếu không, các phiên bản bị xoá sẽ khiến việc phân giải không thành công. Bạn cũng có thể xác định phiên bản bị xoá được phép bằng biến môi trường `BZLMOD_ALLOW_YANKED_VERSIONS`. Bạn có thể tắt tính năng kiểm tra này bằng cách sử dụng từ khoá "tất cả" (không nên dùng).
Thẻ:loading_and_analysis
--check_bazel_compatibility=<error, warning or off>
mặc định: "lỗi"-
Kiểm tra khả năng tương thích của phiên bản bazel của các mô-đun Bazel. Các giá trị hợp lệ là "error" để chuyển vấn đề này lên lỗi phân giải, "off" để tắt tính năng kiểm tra hoặc "warning" để in cảnh báo khi phát hiện thấy không khớp.
Thẻ:loading_and_analysis
--check_direct_dependencies=<off, warning or error>
mặc định: "cảnh báo"-
Kiểm tra xem các phần phụ thuộc `bazel_dep` trực tiếp được khai báo trong mô-đun gốc có phải là các phiên bản mà bạn nhận được trong biểu đồ phần phụ thuộc đã được phân giải hay không. Các giá trị hợp lệ là "off" để tắt tính năng kiểm tra, "warning" để in cảnh báo khi phát hiện thấy không khớp hoặc "error" để chuyển lên lỗi phân giải.
Thẻ:loading_and_analysis
- Giá trị mặc định của
--[no]ignore_dev_dependency
: "false" - Nếu đúng, Bazel sẽ bỏ qua "bazel_dep" và "use_extension" được khai báo là "dev_dependency" trong MODULE.bazel của mô-đun gốc. Xin lưu ý rằng các phần phụ thuộc dành cho nhà phát triển đó luôn bị bỏ qua trong MODULE.bazel nếu đó không phải là mô-đun gốc, bất kể giá trị của cờ này là gì.
Thẻ:loading_and_analysis
--lockfile_mode=<off, update, refresh or error>
mặc định: "cập nhật"-
Chỉ định cách thức và liệu có sử dụng tệp khoá hay không. Các giá trị hợp lệ là "update" để sử dụng tệp khoá và cập nhật tệp khoá nếu có thay đổi, "refresh" để thỉnh thoảng làm mới thông tin có thể thay đổi (các phiên bản bị loại bỏ và các mô-đun bị thiếu trước đó) từ các sổ đăng ký từ xa, "error" để sử dụng tệp khoá nhưng gửi lỗi nếu tệp khoá không được cập nhật hoặc "off" để không đọc hoặc ghi vào tệp khoá.
Thẻ:loading_and_analysis
--override_module=<an equals-separated mapping of module name to path>
nhiều lần sử dụng được tích luỹ- Ghi đè một mô-đun bằng đường dẫn cục bộ ở dạng <tên mô-đun>=<đường dẫn>. Nếu đường dẫn đã cho là đường dẫn tuyệt đối, thì đường dẫn đó sẽ được sử dụng nguyên trạng. Nếu đường dẫn đã cho là đường dẫn tương đối, thì đường dẫn đó sẽ tương ứng với thư mục đang hoạt động. Nếu đường dẫn đã cho bắt đầu bằng "%workspace%", thì đường dẫn đó sẽ tương ứng với thư mục gốc của không gian làm việc, là kết quả của lệnh "bazel info workspace". Nếu đường dẫn đã cho trống, hãy xoá mọi chế độ ghi đè trước đó.
--registry=<a string>
nhiều lần sử dụng được tích luỹ- Chỉ định các sổ đăng ký cần sử dụng để xác định vị trí các phần phụ thuộc mô-đun Bazel. Thứ tự rất quan trọng: các mô-đun sẽ được tra cứu trong các sổ đăng ký trước đó trước tiên và chỉ quay lại các sổ đăng ký sau này khi các mô-đun đó bị thiếu trong các sổ đăng ký trước đó.
Thẻ:changes_inputs
--vendor_dir=<a path>
mặc định: xem nội dung mô tả-
Chỉ định thư mục sẽ chứa các kho lưu trữ bên ngoài ở chế độ nhà cung cấp, cho dù mục đích là tìm nạp các kho lưu trữ đó vào thư mục hay sử dụng các kho lưu trữ đó trong khi xây dựng. Bạn có thể chỉ định đường dẫn dưới dạng đường dẫn tuyệt đối hoặc đường dẫn tương đối đến thư mục không gian làm việc.
Thẻ:loading_and_analysis
- Các tuỳ chọn kích hoạt tính năng tối ưu hoá thời gian xây dựng:
--gc_thrashing_limits=<comma separated pairs of <period>:<count>>
mặc định: "1s:2,20s:3,1m:5"-
Các giới hạn nếu đạt đến sẽ khiến GcThrashingDetector gặp sự cố Bazel với OOM. Mỗi giới hạn được chỉ định là <period>:<count>, trong đó period là thời lượng và count là số nguyên dương. Nếu hơn --gc_thrashing_threshold phần trăm không gian cố định (vùng nhớ khối xếp cũ) vẫn bị chiếm dụng sau <count> lần GC đầy đủ liên tiếp trong <period>, thì lỗi OOM sẽ được kích hoạt. Bạn có thể chỉ định nhiều giới hạn, phân tách bằng dấu phẩy.
Thẻ:host_machine_resource_optimizations
--skyframe_high_water_mark_full_gc_drops_per_invocation=<an integer, >= 0>
mặc định: "2147483647"-
Cờ cho cấu hình nâng cao của công cụ Skyframe nội bộ của Bazel. Nếu phát hiện mức sử dụng phần trăm vùng nhớ khối xếp được giữ lại vượt quá ngưỡng do --skyframe_high_water_mark_threshold đặt ra, thì khi một sự kiện GC đầy đủ xảy ra, Bazel sẽ loại bỏ trạng thái Skyframe tạm thời không cần thiết, lên đến nhiều lần như vậy cho mỗi lệnh gọi. Mặc định là Integer.MAX_VALUE; không giới hạn về mặt hiệu quả. Giá trị 0 có nghĩa là các sự kiện GC đầy đủ sẽ không bao giờ kích hoạt sự kiện thả. Nếu đạt đến giới hạn, trạng thái Skyframe sẽ không còn bị loại bỏ khi một sự kiện GC đầy đủ xảy ra và vượt quá ngưỡng phần trăm vùng nhớ khối xếp được giữ lại đó.
Thẻ:host_machine_resource_optimizations
--skyframe_high_water_mark_minor_gc_drops_per_invocation=<an integer, >= 0>
mặc định: "2147483647"-
Cờ cho cấu hình nâng cao của công cụ Skyframe nội bộ của Bazel. Nếu phát hiện mức sử dụng phần trăm vùng nhớ khối xếp được giữ lại vượt quá ngưỡng do --skyframe_high_water_mark_threshold đặt ra, thì khi một sự kiện GC nhỏ xảy ra, Bazel sẽ loại bỏ trạng thái Skyframe tạm thời không cần thiết, lên đến nhiều lần như vậy mỗi lần gọi. Mặc định là Integer.MAX_VALUE; không giới hạn về mặt hiệu quả. Giá trị 0 có nghĩa là các sự kiện GC nhỏ sẽ không bao giờ kích hoạt sự kiện thả. Nếu đạt đến giới hạn, trạng thái Skyframe sẽ không còn bị loại bỏ khi một sự kiện GC nhỏ xảy ra và vượt quá ngưỡng phần trăm vùng nhớ khối xếp được giữ lại.
Thẻ:host_machine_resource_optimizations
--skyframe_high_water_mark_threshold=<an integer>
mặc định: "85"-
Cờ cho cấu hình nâng cao của công cụ Skyframe nội bộ của Bazel. Nếu phát hiện mức sử dụng phần trăm vùng nhớ khối xếp được giữ lại ít nhất là ngưỡng này, Bazel sẽ loại bỏ trạng thái Skyframe tạm thời không cần thiết. Việc điều chỉnh điều này có thể giúp bạn giảm thiểu tác động của tình trạng GC bị lỗi khi (i) tình trạng này là do mức sử dụng bộ nhớ của trạng thái tạm thời và (ii) tốn kém hơn so với việc tạo lại trạng thái khi cần.
Thẻ:host_machine_resource_optimizations
- Các tuỳ chọn ảnh hưởng đến mức độ chi tiết, định dạng hoặc vị trí ghi nhật ký:
--experimental_command_profile=<cpu, wall, alloc or lock>
mặc định: xem nội dung mô tả- Ghi hồ sơ Trình ghi chuyến bay Java trong thời gian thực thi lệnh. Bạn phải cung cấp một trong các loại sự kiện phân tích tài nguyên được hỗ trợ (cpu, wall, alloc hoặc lock) dưới dạng đối số. Hồ sơ được ghi vào một tệp được đặt tên theo loại sự kiện trong thư mục cơ sở đầu ra. Cú pháp và ngữ nghĩa của cờ này có thể thay đổi trong tương lai để hỗ trợ thêm các loại hồ sơ hoặc định dạng đầu ra; bạn tự chịu rủi ro khi sử dụng.
- Giá trị mặc định của
--[no]experimental_record_metrics_for_all_mnemonics
: "false" - Theo mặc định, số lượng loại thao tác được giới hạn ở 20 câu thần chú có số lượng thao tác được thực thi nhiều nhất. Việc đặt tuỳ chọn này sẽ ghi số liệu thống kê cho tất cả các câu thần chú.
--experimental_repository_resolved_file=<a string>
mặc định: ""- Nếu không trống, hãy ghi một giá trị Starlark có thông tin đã phân giải của tất cả các quy tắc kho lưu trữ Starlark đã được thực thi.
Thẻ:affects_outputs
- Các tuỳ chọn chỉ định hoặc thay đổi dữ liệu đầu vào chung cho một lệnh Bazel không thuộc các danh mục khác.:
--experimental_resolved_file_instead_of_workspace=<a string>
mặc định: ""- Nếu không trống, hãy đọc tệp đã phân giải được chỉ định thay vì tệp WORKSPACE
Thẻ:changes_inputs
- Các tuỳ chọn thực thi và lưu vào bộ nhớ đệm từ xa:
--experimental_downloader_config=<a string>
mặc định: xem nội dung mô tả- Chỉ định một tệp để định cấu hình trình tải xuống từ xa. Tệp này bao gồm các dòng, mỗi dòng bắt đầu bằng một lệnh (`allow`, `block` hoặc `rewrite`), theo sau là tên máy chủ lưu trữ (đối với lệnh `allow` và `block`) hoặc hai mẫu, một mẫu để so khớp và một mẫu để sử dụng làm URL thay thế, với các tệp tham chiếu ngược bắt đầu từ `$1`. Bạn có thể cung cấp nhiều lệnh `rewrite` cho cùng một URL và trong trường hợp này, nhiều URL sẽ được trả về.
- Giá trị mặc định của
--experimental_worker_for_repo_fetching=<off, platform, virtual or auto>
: "tự động" - Chế độ tạo luồng để tìm nạp kho lưu trữ. Nếu bạn đặt thành "tắt", thì không có luồng worker nào được sử dụng và quá trình tìm nạp kho lưu trữ sẽ phải khởi động lại. Nếu không, hãy sử dụng luồng worker ảo.
- Các tuỳ chọn khác, không được phân loại theo cách khác.:
--deleted_packages=<comma-separated list of package names>
nhiều lần sử dụng được tích luỹ- Danh sách tên gói được phân tách bằng dấu phẩy mà hệ thống xây dựng sẽ coi là không tồn tại, ngay cả khi các gói đó xuất hiện ở đâu đó trên đường dẫn gói. Sử dụng tuỳ chọn này khi xoá một gói con "x/y" của một gói hiện có "x". Ví dụ: sau khi xoá x/y/BUILD trong ứng dụng, hệ thống xây dựng có thể khiếu nại nếu gặp nhãn "//x:y/z" nếu nhãn đó vẫn được cung cấp bởi một mục package_path khác. Bạn có thể chỉ định --deleted_packages x/y để tránh vấn đề này.
- Giá trị mặc định của
--[no]fetch
: "true" - Cho phép lệnh tìm nạp các phần phụ thuộc bên ngoài. Nếu bạn đặt thành false, lệnh sẽ sử dụng bất kỳ phiên bản nào của phần phụ thuộc được lưu vào bộ nhớ đệm và nếu không có phiên bản nào, lệnh sẽ không thành công.
--override_repository=<an equals-separated mapping of repository name to path>
nhiều lần sử dụng được tích luỹ- Ghi đè kho lưu trữ bằng một đường dẫn cục bộ ở dạng <repository name>=<path>. Nếu đường dẫn đã cho là đường dẫn tuyệt đối, thì đường dẫn đó sẽ được sử dụng nguyên trạng. Nếu đường dẫn đã cho là đường dẫn tương đối, thì đường dẫn đó sẽ tương ứng với thư mục đang hoạt động. Nếu đường dẫn đã cho bắt đầu bằng "%workspace%", thì đường dẫn đó sẽ tương ứng với thư mục gốc của không gian làm việc, là kết quả của lệnh "bazel info workspace". Nếu đường dẫn đã cho trống, hãy xoá mọi chế độ ghi đè trước đó.
--package_path=<colon-separated list of options>
mặc định: "%workspace%"- Danh sách được phân tách bằng dấu hai chấm về nơi tìm kiếm các gói. Các phần tử bắt đầu bằng "%workspace%" có liên quan đến không gian làm việc bao quanh. Nếu bạn bỏ qua hoặc để trống, giá trị mặc định sẽ là kết quả của lệnh "bazel info default-package-path".
- Giá trị mặc định của
--[no]show_loading_progress
: "true" - Nếu được bật, sẽ khiến Bazel in thông báo "Loading package" ("Đang tải gói").
Tuỳ chọn kiểm thử
Kế thừa tất cả các tuỳ chọn từ build.
- Các tuỳ chọn xuất hiện trước lệnh và được máy khách phân tích cú pháp:
--distdir=<a path>
nhiều lần sử dụng được tích luỹ-
Các vị trí khác để tìm kiếm bản lưu trữ trước khi truy cập vào mạng để tải xuống.
Thẻ:bazel_internal_configuration
- Giá trị mặc định của
--[no]experimental_repository_cache_hardlinks
: "false" - Nếu được đặt, bộ nhớ đệm kho lưu trữ sẽ liên kết cứng tệp trong trường hợp có lượt truy cập vào bộ nhớ đệm, thay vì sao chép. Việc này nhằm tiết kiệm dung lượng ổ đĩa.
Thẻ:bazel_internal_configuration
--experimental_repository_downloader_retries=<an integer>
mặc định: "0"-
Số lần thử tối đa để thử lại lỗi tải xuống. Nếu bạn đặt thành 0, thì tính năng thử lại sẽ bị tắt.
Thẻ:experimental
--experimental_scale_timeouts=<a double>
mặc định: "1.0"- Điều chỉnh tất cả thời gian chờ trong quy tắc kho lưu trữ Starlark theo hệ số này. Bằng cách này, bạn có thể làm cho kho lưu trữ bên ngoài hoạt động trên các máy chạy chậm hơn dự kiến của tác giả quy tắc mà không cần thay đổi mã nguồn
Thẻ:bazel_internal_configuration
,experimental
- Giá trị mặc định của
--[no]incompatible_disable_native_repo_rules
: "false" - Nếu giá trị là false, bạn có thể sử dụng các quy tắc kho lưu trữ gốc trong WORKSPACE; nếu không, bạn phải sử dụng các quy tắc kho lưu trữ Starlark. Các quy tắc kho lưu trữ gốc bao gồm local_repository, new_local_repository, local_config_platform, android_sdk_repository và android_ndk_repository.
Thẻ:bazel_internal_configuration
--repository_cache=<a path>
mặc định: xem nội dung mô tả- Chỉ định vị trí bộ nhớ đệm của các giá trị đã tải xuống thu được trong quá trình tìm nạp kho lưu trữ bên ngoài. Chuỗi trống làm đối số yêu cầu tắt bộ nhớ đệm, nếu không, giá trị mặc định là "<output_user_root>/cache/repos/v1" sẽ được sử dụng
Thẻ:bazel_internal_configuration
- Giá trị mặc định của
--[no]repository_disable_download
: "false" - Nếu được đặt, bạn không được phép tải xuống bằng ctx.download{,_and_extract} trong quá trình tìm nạp kho lưu trữ. Xin lưu ý rằng quyền truy cập mạng không bị tắt hoàn toàn; ctx.execute vẫn có thể chạy một tệp thực thi tuỳ ý truy cập Internet.
Thẻ:bazel_internal_configuration
- Các tuỳ chọn kiểm soát việc thực thi bản dựng:
- Giá trị mặc định của
--gc_thrashing_threshold=<an integer in 0-100 range>
: "100" -
Tỷ lệ phần trăm không gian cố định bị chiếm dụng (0-100) mà tại đó GcThrashingDetector xem xét các sự kiện áp lực bộ nhớ so với giới hạn của nó (--gc_thrashing_limits). Nếu bạn đặt thành 100, GcThrashingDetector sẽ bị tắt.
Thẻ:host_machine_resource_optimizations
- Tuỳ chọn liên quan đến đầu ra và ngữ nghĩa của Bzlmod:
--allow_yanked_versions=<a string>
nhiều lần sử dụng được tích luỹ-
Chỉ định các phiên bản mô-đun ở dạng `<module1>@<version1>,<module2>@<version2>` sẽ được cho phép trong biểu đồ phần phụ thuộc đã phân giải ngay cả khi các phiên bản đó được khai báo là đã bị xoá trong sổ đăng ký nơi chúng đến (nếu không đến từ NonRegistryOverride). Nếu không, các phiên bản bị xoá sẽ khiến việc phân giải không thành công. Bạn cũng có thể xác định phiên bản bị xoá được phép bằng biến môi trường `BZLMOD_ALLOW_YANKED_VERSIONS`. Bạn có thể tắt tính năng kiểm tra này bằng cách sử dụng từ khoá "tất cả" (không nên dùng).
Thẻ:loading_and_analysis
--check_bazel_compatibility=<error, warning or off>
mặc định: "lỗi"-
Kiểm tra khả năng tương thích của phiên bản bazel của các mô-đun Bazel. Các giá trị hợp lệ là "error" để chuyển vấn đề này lên lỗi phân giải, "off" để tắt tính năng kiểm tra hoặc "warning" để in cảnh báo khi phát hiện thấy không khớp.
Thẻ:loading_and_analysis
--check_direct_dependencies=<off, warning or error>
mặc định: "cảnh báo"-
Kiểm tra xem các phần phụ thuộc `bazel_dep` trực tiếp được khai báo trong mô-đun gốc có phải là các phiên bản mà bạn nhận được trong biểu đồ phần phụ thuộc đã được phân giải hay không. Các giá trị hợp lệ là "off" để tắt tính năng kiểm tra, "warning" để in cảnh báo khi phát hiện thấy không khớp hoặc "error" để chuyển lên lỗi phân giải.
Thẻ:loading_and_analysis
- Giá trị mặc định của
--[no]ignore_dev_dependency
: "false" - Nếu đúng, Bazel sẽ bỏ qua "bazel_dep" và "use_extension" được khai báo là "dev_dependency" trong MODULE.bazel của mô-đun gốc. Xin lưu ý rằng các phần phụ thuộc dành cho nhà phát triển đó luôn bị bỏ qua trong MODULE.bazel nếu đó không phải là mô-đun gốc, bất kể giá trị của cờ này là gì.
Thẻ:loading_and_analysis
--lockfile_mode=<off, update, refresh or error>
mặc định: "cập nhật"-
Chỉ định cách thức và liệu có sử dụng tệp khoá hay không. Các giá trị hợp lệ là "update" để sử dụng tệp khoá và cập nhật tệp khoá nếu có thay đổi, "refresh" để thỉnh thoảng làm mới thông tin có thể thay đổi (các phiên bản bị loại bỏ và các mô-đun bị thiếu trước đó) từ các sổ đăng ký từ xa, "error" để sử dụng tệp khoá nhưng gửi lỗi nếu tệp khoá không được cập nhật hoặc "off" để không đọc hoặc ghi vào tệp khoá.
Thẻ:loading_and_analysis
--override_module=<an equals-separated mapping of module name to path>
nhiều lần sử dụng được tích luỹ- Ghi đè một mô-đun bằng đường dẫn cục bộ ở dạng <tên mô-đun>=<đường dẫn>. Nếu đường dẫn đã cho là đường dẫn tuyệt đối, thì đường dẫn đó sẽ được sử dụng nguyên trạng. Nếu đường dẫn đã cho là đường dẫn tương đối, thì đường dẫn đó sẽ tương ứng với thư mục đang hoạt động. Nếu đường dẫn đã cho bắt đầu bằng "%workspace%", thì đường dẫn đó sẽ tương ứng với thư mục gốc của không gian làm việc, là kết quả của lệnh "bazel info workspace". Nếu đường dẫn đã cho trống, hãy xoá mọi chế độ ghi đè trước đó.
--registry=<a string>
nhiều lần sử dụng được tích luỹ- Chỉ định các sổ đăng ký cần sử dụng để xác định vị trí các phần phụ thuộc mô-đun Bazel. Thứ tự rất quan trọng: các mô-đun sẽ được tra cứu trong các sổ đăng ký trước đó trước tiên và chỉ quay lại các sổ đăng ký sau này khi các mô-đun đó bị thiếu trong các sổ đăng ký trước đó.
Thẻ:changes_inputs
--vendor_dir=<a path>
mặc định: xem nội dung mô tả-
Chỉ định thư mục sẽ chứa các kho lưu trữ bên ngoài ở chế độ nhà cung cấp, cho dù mục đích là tìm nạp các kho lưu trữ đó vào thư mục hay sử dụng các kho lưu trữ đó trong khi xây dựng. Bạn có thể chỉ định đường dẫn dưới dạng đường dẫn tuyệt đối hoặc đường dẫn tương đối đến thư mục không gian làm việc.
Thẻ:loading_and_analysis
- Các tuỳ chọn kích hoạt tính năng tối ưu hoá thời gian xây dựng:
--gc_thrashing_limits=<comma separated pairs of <period>:<count>>
mặc định: "1s:2,20s:3,1m:5"-
Các giới hạn nếu đạt đến sẽ khiến GcThrashingDetector gặp sự cố Bazel với OOM. Mỗi giới hạn được chỉ định là <period>:<count>, trong đó period là thời lượng và count là số nguyên dương. Nếu hơn --gc_thrashing_threshold phần trăm không gian cố định (vùng nhớ khối xếp cũ) vẫn bị chiếm dụng sau <count> lần GC đầy đủ liên tiếp trong <period>, thì lỗi OOM sẽ được kích hoạt. Bạn có thể chỉ định nhiều giới hạn, phân tách bằng dấu phẩy.
Thẻ:host_machine_resource_optimizations
--skyframe_high_water_mark_full_gc_drops_per_invocation=<an integer, >= 0>
mặc định: "2147483647"-
Cờ cho cấu hình nâng cao của công cụ Skyframe nội bộ của Bazel. Nếu phát hiện mức sử dụng phần trăm vùng nhớ khối xếp được giữ lại vượt quá ngưỡng do --skyframe_high_water_mark_threshold đặt ra, thì khi một sự kiện GC đầy đủ xảy ra, Bazel sẽ loại bỏ trạng thái Skyframe tạm thời không cần thiết, lên đến nhiều lần như vậy cho mỗi lệnh gọi. Mặc định là Integer.MAX_VALUE; không giới hạn về mặt hiệu quả. Giá trị 0 có nghĩa là các sự kiện GC đầy đủ sẽ không bao giờ kích hoạt sự kiện thả. Nếu đạt đến giới hạn, trạng thái Skyframe sẽ không còn bị loại bỏ khi một sự kiện GC đầy đủ xảy ra và vượt quá ngưỡng phần trăm vùng nhớ khối xếp được giữ lại đó.
Thẻ:host_machine_resource_optimizations
--skyframe_high_water_mark_minor_gc_drops_per_invocation=<an integer, >= 0>
mặc định: "2147483647"-
Cờ cho cấu hình nâng cao của công cụ Skyframe nội bộ của Bazel. Nếu phát hiện mức sử dụng phần trăm vùng nhớ khối xếp được giữ lại vượt quá ngưỡng do --skyframe_high_water_mark_threshold đặt ra, thì khi một sự kiện GC nhỏ xảy ra, Bazel sẽ loại bỏ trạng thái Skyframe tạm thời không cần thiết, lên đến nhiều lần như vậy mỗi lần gọi. Mặc định là Integer.MAX_VALUE; không giới hạn về mặt hiệu quả. Giá trị 0 có nghĩa là các sự kiện GC nhỏ sẽ không bao giờ kích hoạt sự kiện thả. Nếu đạt đến giới hạn, trạng thái Skyframe sẽ không còn bị loại bỏ khi một sự kiện GC nhỏ xảy ra và vượt quá ngưỡng phần trăm vùng nhớ khối xếp được giữ lại.
Thẻ:host_machine_resource_optimizations
--skyframe_high_water_mark_threshold=<an integer>
mặc định: "85"-
Cờ cho cấu hình nâng cao của công cụ Skyframe nội bộ của Bazel. Nếu phát hiện mức sử dụng phần trăm vùng nhớ khối xếp được giữ lại ít nhất là ngưỡng này, Bazel sẽ loại bỏ trạng thái Skyframe tạm thời không cần thiết. Việc điều chỉnh điều này có thể giúp bạn giảm thiểu tác động của tình trạng GC bị lỗi khi (i) tình trạng này là do mức sử dụng bộ nhớ của trạng thái tạm thời và (ii) tốn kém hơn so với việc tạo lại trạng thái khi cần.
Thẻ:host_machine_resource_optimizations
- Các tuỳ chọn ảnh hưởng đến mức độ chi tiết, định dạng hoặc vị trí ghi nhật ký:
--experimental_command_profile=<cpu, wall, alloc or lock>
mặc định: xem nội dung mô tả- Ghi hồ sơ Trình ghi chuyến bay Java trong thời gian thực thi lệnh. Bạn phải cung cấp một trong các loại sự kiện phân tích tài nguyên được hỗ trợ (cpu, wall, alloc hoặc lock) dưới dạng đối số. Hồ sơ được ghi vào một tệp được đặt tên theo loại sự kiện trong thư mục cơ sở đầu ra. Cú pháp và ngữ nghĩa của cờ này có thể thay đổi trong tương lai để hỗ trợ thêm các loại hồ sơ hoặc định dạng đầu ra; bạn tự chịu rủi ro khi sử dụng.
- Giá trị mặc định của
--[no]experimental_record_metrics_for_all_mnemonics
: "false" - Theo mặc định, số lượng loại thao tác được giới hạn ở 20 câu thần chú có số lượng thao tác được thực thi nhiều nhất. Việc đặt tuỳ chọn này sẽ ghi số liệu thống kê cho tất cả các câu thần chú.
- Giá trị mặc định của
--[no]print_relative_test_log_paths
: "false" - Nếu đúng, khi in đường dẫn đến nhật ký kiểm thử, hãy sử dụng đường dẫn tương đối sử dụng đường liên kết tượng trưng tiện lợi "testlogs". Lưu ý: Lệnh gọi "build"/"test"/etc tiếp theo với cấu hình khác có thể khiến mục tiêu của đường liên kết tượng trưng này thay đổi, khiến đường dẫn được in trước đó không còn hữu ích nữa.
Thẻ:affects_outputs
- Giá trị mặc định của
--[no]test_verbose_timeout_warnings
: "false" - Nếu đúng, hãy in thêm các cảnh báo khi thời gian thực thi kiểm thử không khớp với thời gian chờ do kiểm thử xác định (dù ngầm ẩn hay rõ ràng).
Thẻ:affects_outputs
- Giá trị mặc định của
--[no]verbose_test_summary
: "true" - Nếu đúng, hãy in thêm thông tin (thời gian, số lần chạy không thành công, v.v.) trong bản tóm tắt kiểm thử.
Thẻ:affects_outputs
- Các tuỳ chọn chỉ định hoặc thay đổi dữ liệu đầu vào chung cho một lệnh Bazel không thuộc các danh mục khác.:
--experimental_resolved_file_instead_of_workspace=<a string>
mặc định: ""- Nếu không trống, hãy đọc tệp đã phân giải được chỉ định thay vì tệp WORKSPACE
Thẻ:changes_inputs
- Các tuỳ chọn thực thi và lưu vào bộ nhớ đệm từ xa:
--experimental_downloader_config=<a string>
mặc định: xem nội dung mô tả- Chỉ định một tệp để định cấu hình trình tải xuống từ xa. Tệp này bao gồm các dòng, mỗi dòng bắt đầu bằng một lệnh (`allow`, `block` hoặc `rewrite`), theo sau là tên máy chủ lưu trữ (đối với lệnh `allow` và `block`) hoặc hai mẫu, một mẫu để so khớp và một mẫu để sử dụng làm URL thay thế, với các tệp tham chiếu ngược bắt đầu từ `$1`. Bạn có thể cung cấp nhiều lệnh `rewrite` cho cùng một URL và trong trường hợp này, nhiều URL sẽ được trả về.
- Giá trị mặc định của
--experimental_worker_for_repo_fetching=<off, platform, virtual or auto>
: "tự động" - Chế độ tạo luồng để tìm nạp kho lưu trữ. Nếu bạn đặt thành "tắt", thì không có luồng worker nào được sử dụng và quá trình tìm nạp kho lưu trữ sẽ phải khởi động lại. Nếu không, hãy sử dụng luồng worker ảo.
- Các tuỳ chọn khác, không được phân loại theo cách khác.:
--override_repository=<an equals-separated mapping of repository name to path>
nhiều lần sử dụng được tích luỹ- Ghi đè kho lưu trữ bằng một đường dẫn cục bộ ở dạng <repository name>=<path>. Nếu đường dẫn đã cho là đường dẫn tuyệt đối, thì đường dẫn đó sẽ được sử dụng nguyên trạng. Nếu đường dẫn đã cho là đường dẫn tương đối, thì đường dẫn đó sẽ tương ứng với thư mục đang hoạt động. Nếu đường dẫn đã cho bắt đầu bằng "%workspace%", thì đường dẫn đó sẽ tương ứng với thư mục gốc của không gian làm việc, là kết quả của lệnh "bazel info workspace". Nếu đường dẫn đã cho trống, hãy xoá mọi chế độ ghi đè trước đó.
Tuỳ chọn cho nhà cung cấp
Kế thừa tất cả các tuỳ chọn từ test.
- Các tuỳ chọn xuất hiện trước lệnh và được máy khách phân tích cú pháp:
--distdir=<a path>
nhiều lần sử dụng được tích luỹ-
Các vị trí khác để tìm kiếm bản lưu trữ trước khi truy cập vào mạng để tải xuống.
Thẻ:bazel_internal_configuration
- Giá trị mặc định của
--[no]experimental_repository_cache_hardlinks
: "false" - Nếu được đặt, bộ nhớ đệm kho lưu trữ sẽ liên kết cứng tệp trong trường hợp có lượt truy cập vào bộ nhớ đệm, thay vì sao chép. Việc này nhằm tiết kiệm dung lượng ổ đĩa.
Thẻ:bazel_internal_configuration
--experimental_repository_downloader_retries=<an integer>
mặc định: "0"-
Số lần thử tối đa để thử lại lỗi tải xuống. Nếu bạn đặt thành 0, thì tính năng thử lại sẽ bị tắt.
Thẻ:experimental
--experimental_scale_timeouts=<a double>
mặc định: "1.0"- Điều chỉnh tất cả thời gian chờ trong quy tắc kho lưu trữ Starlark theo hệ số này. Bằng cách này, bạn có thể làm cho kho lưu trữ bên ngoài hoạt động trên các máy chạy chậm hơn dự kiến của tác giả quy tắc mà không cần thay đổi mã nguồn
Thẻ:bazel_internal_configuration
,experimental
- Giá trị mặc định của
--[no]incompatible_disable_native_repo_rules
: "false" - Nếu giá trị là false, bạn có thể sử dụng các quy tắc kho lưu trữ gốc trong WORKSPACE; nếu không, bạn phải sử dụng các quy tắc kho lưu trữ Starlark. Các quy tắc kho lưu trữ gốc bao gồm local_repository, new_local_repository, local_config_platform, android_sdk_repository và android_ndk_repository.
Thẻ:bazel_internal_configuration
--repository_cache=<a path>
mặc định: xem nội dung mô tả- Chỉ định vị trí bộ nhớ đệm của các giá trị đã tải xuống thu được trong quá trình tìm nạp kho lưu trữ bên ngoài. Chuỗi trống làm đối số yêu cầu tắt bộ nhớ đệm, nếu không, giá trị mặc định là "<output_user_root>/cache/repos/v1" sẽ được sử dụng
Thẻ:bazel_internal_configuration
- Giá trị mặc định của
--[no]repository_disable_download
: "false" - Nếu được đặt, bạn không được phép tải xuống bằng ctx.download{,_and_extract} trong quá trình tìm nạp kho lưu trữ. Xin lưu ý rằng quyền truy cập mạng không bị tắt hoàn toàn; ctx.execute vẫn có thể chạy một tệp thực thi tuỳ ý truy cập Internet.
Thẻ:bazel_internal_configuration
- Các tuỳ chọn kiểm soát việc thực thi bản dựng:
- Giá trị mặc định của
--gc_thrashing_threshold=<an integer in 0-100 range>
: "100" -
Tỷ lệ phần trăm không gian cố định bị chiếm dụng (0-100) mà tại đó GcThrashingDetector xem xét các sự kiện áp lực bộ nhớ so với giới hạn của nó (--gc_thrashing_limits). Nếu bạn đặt thành 100, GcThrashingDetector sẽ bị tắt.
Thẻ:host_machine_resource_optimizations
--[no]keep_going
[-k
] mặc định: "false"-
Tiếp tục nhiều nhất có thể sau khi xảy ra lỗi. Mặc dù không thể phân tích mục tiêu không thành công và các mục tiêu phụ thuộc vào mục tiêu đó, nhưng bạn có thể phân tích các điều kiện tiên quyết khác của các mục tiêu này.
Thẻ:eagerness_to_exit
- Giá trị mặc định của
--loading_phase_threads=<an integer, or a keyword ("auto", "HOST_CPUS", "HOST_RAM"), optionally followed by an operation ([-|*]<float>) eg. "auto", "HOST_CPUS*.5">
: "tự động" - Số luồng song song cần sử dụng cho giai đoạn tải/phân tích. Nhận một số nguyên hoặc từ khoá ("tự động", "HOST_CPUS", "HOST_RAM"), theo sau có thể là một phép toán ([-|*]<float>) ví dụ: "tự động", "HOST_CPUS*.5". "tự động" đặt giá trị mặc định hợp lý dựa trên tài nguyên của máy chủ lưu trữ. Phải ít nhất là 1.
Thẻ:bazel_internal_configuration
- Tuỳ chọn này ảnh hưởng đến ngữ nghĩa của ngôn ngữ Starlark hoặc API bản dựng có thể truy cập vào các tệp BUILD, tệp .bzl hoặc tệp WORKSPACE.:
- Giá trị mặc định của
--[no]incompatible_config_setting_private_default_visibility
: "false" - Nếu incompatible_enforce_config_setting_visibility=false, thì đây là một thao tác không có tác dụng. Nếu không, nếu cờ này là false, mọi config_setting không có thuộc tính chế độ hiển thị rõ ràng sẽ là //visibility:public. Nếu cờ này là true, config_setting sẽ tuân theo logic hiển thị giống như tất cả các quy tắc khác. Xem https://github.com/bazelbuild/bazel/issues/12933.
Thẻ:loading_and_analysis
,incompatible_change
- Giá trị mặc định của
--[no]incompatible_enforce_config_setting_visibility
: "true" - Nếu đúng, hãy thực thi các quy định hạn chế về chế độ hiển thị config_setting. Nếu giá trị là false, mọi mục config_setting đều hiển thị với mọi mục tiêu. Xem https://github.com/bazelbuild/bazel/issues/12932.
Thẻ:loading_and_analysis
,incompatible_change
- Các tuỳ chọn liên quan đến kết quả và ngữ nghĩa của Bzlmod:
--allow_yanked_versions=<a string>
nhiều lần sử dụng được tích luỹ-
Chỉ định các phiên bản mô-đun ở dạng `<module1>@<version1>,<module2>@<version2>` sẽ được cho phép trong biểu đồ phần phụ thuộc đã phân giải ngay cả khi các phiên bản đó được khai báo là đã bị xoá trong sổ đăng ký nơi chúng đến (nếu không đến từ NonRegistryOverride). Nếu không, các phiên bản bị xoá sẽ khiến việc phân giải không thành công. Bạn cũng có thể xác định phiên bản bị xoá được phép bằng biến môi trường `BZLMOD_ALLOW_YANKED_VERSIONS`. Bạn có thể tắt tính năng kiểm tra này bằng cách sử dụng từ khoá "tất cả" (không nên dùng).
Thẻ:loading_and_analysis
--check_bazel_compatibility=<error, warning or off>
mặc định: "lỗi"-
Kiểm tra khả năng tương thích của phiên bản bazel của các mô-đun Bazel. Các giá trị hợp lệ là "error" để chuyển vấn đề này lên lỗi phân giải, "off" để tắt tính năng kiểm tra hoặc "warning" để in cảnh báo khi phát hiện thấy không khớp.
Thẻ:loading_and_analysis
--check_direct_dependencies=<off, warning or error>
mặc định: "cảnh báo"-
Kiểm tra xem các phần phụ thuộc `bazel_dep` trực tiếp được khai báo trong mô-đun gốc có phải là các phiên bản mà bạn nhận được trong biểu đồ phần phụ thuộc đã được phân giải hay không. Các giá trị hợp lệ là "off" để tắt tính năng kiểm tra, "warning" để in cảnh báo khi phát hiện thấy không khớp hoặc "error" để chuyển lên lỗi phân giải.
Thẻ:loading_and_analysis
- Giá trị mặc định của
--[no]ignore_dev_dependency
: "false" - Nếu đúng, Bazel sẽ bỏ qua "bazel_dep" và "use_extension" được khai báo là "dev_dependency" trong MODULE.bazel của mô-đun gốc. Xin lưu ý rằng các phần phụ thuộc dành cho nhà phát triển đó luôn bị bỏ qua trong MODULE.bazel nếu đó không phải là mô-đun gốc, bất kể giá trị của cờ này là gì.
Thẻ:loading_and_analysis
--lockfile_mode=<off, update, refresh or error>
mặc định: "cập nhật"-
Chỉ định cách thức và liệu có sử dụng tệp khoá hay không. Các giá trị hợp lệ là "update" để sử dụng tệp khoá và cập nhật tệp khoá nếu có thay đổi, "refresh" để thỉnh thoảng làm mới thông tin có thể thay đổi (các phiên bản bị loại bỏ và các mô-đun bị thiếu trước đó) từ các sổ đăng ký từ xa, "error" để sử dụng tệp khoá nhưng gửi lỗi nếu tệp khoá không được cập nhật hoặc "off" để không đọc hoặc ghi vào tệp khoá.
Thẻ:loading_and_analysis
--override_module=<an equals-separated mapping of module name to path>
nhiều lần sử dụng được tích luỹ- Ghi đè một mô-đun bằng đường dẫn cục bộ ở dạng <tên mô-đun>=<đường dẫn>. Nếu đường dẫn đã cho là đường dẫn tuyệt đối, thì đường dẫn đó sẽ được sử dụng nguyên trạng. Nếu đường dẫn đã cho là đường dẫn tương đối, thì đường dẫn đó sẽ tương ứng với thư mục đang hoạt động. Nếu đường dẫn đã cho bắt đầu bằng "%workspace%", thì đường dẫn đó sẽ tương ứng với thư mục gốc của không gian làm việc, là kết quả của lệnh "bazel info workspace". Nếu đường dẫn đã cho trống, hãy xoá mọi chế độ ghi đè trước đó.
--registry=<a string>
nhiều lần sử dụng được tích luỹ- Chỉ định các sổ đăng ký cần sử dụng để xác định vị trí các phần phụ thuộc mô-đun Bazel. Thứ tự rất quan trọng: các mô-đun sẽ được tra cứu trong các sổ đăng ký trước đó trước tiên và chỉ quay lại các sổ đăng ký sau này khi các mô-đun đó bị thiếu trong các sổ đăng ký trước đó.
Thẻ:changes_inputs
--repo=<a string>
nhiều lần sử dụng được tích luỹ-
Chỉ nhà cung cấp kho lưu trữ được chỉ định, có thể là `@apparent_repo_name` hoặc `@@canonical_repo_name`. Bạn có thể đặt tuỳ chọn này nhiều lần
Thẻ:changes_inputs
--vendor_dir=<a path>
mặc định: xem nội dung mô tả-
Chỉ định thư mục sẽ chứa các kho lưu trữ bên ngoài ở chế độ nhà cung cấp, cho dù mục đích là tìm nạp các kho lưu trữ đó vào thư mục hay sử dụng các kho lưu trữ đó trong khi xây dựng. Bạn có thể chỉ định đường dẫn dưới dạng đường dẫn tuyệt đối hoặc đường dẫn tương đối đến thư mục không gian làm việc.
Thẻ:loading_and_analysis
- Các tuỳ chọn kích hoạt tính năng tối ưu hoá thời gian xây dựng:
--gc_thrashing_limits=<comma separated pairs of <period>:<count>>
mặc định: "1s:2,20s:3,1m:5"-
Các giới hạn nếu đạt đến sẽ khiến GcThrashingDetector gặp sự cố Bazel với OOM. Mỗi giới hạn được chỉ định là <period>:<count>, trong đó period là thời lượng và count là số nguyên dương. Nếu hơn --gc_thrashing_threshold phần trăm không gian cố định (vùng nhớ khối xếp cũ) vẫn bị chiếm dụng sau <count> lần GC đầy đủ liên tiếp trong <period>, thì lỗi OOM sẽ được kích hoạt. Bạn có thể chỉ định nhiều giới hạn, phân tách bằng dấu phẩy.
Thẻ:host_machine_resource_optimizations
--skyframe_high_water_mark_full_gc_drops_per_invocation=<an integer, >= 0>
mặc định: "2147483647"-
Cờ cho cấu hình nâng cao của công cụ Skyframe nội bộ của Bazel. Nếu phát hiện mức sử dụng phần trăm vùng nhớ khối xếp được giữ lại vượt quá ngưỡng do --skyframe_high_water_mark_threshold đặt ra, thì khi một sự kiện GC đầy đủ xảy ra, Bazel sẽ loại bỏ trạng thái Skyframe tạm thời không cần thiết, lên đến nhiều lần như vậy cho mỗi lệnh gọi. Mặc định là Integer.MAX_VALUE; không giới hạn về mặt hiệu quả. Giá trị 0 có nghĩa là các sự kiện GC đầy đủ sẽ không bao giờ kích hoạt sự kiện thả. Nếu đạt đến giới hạn, trạng thái Skyframe sẽ không còn bị loại bỏ khi một sự kiện GC đầy đủ xảy ra và vượt quá ngưỡng phần trăm vùng nhớ khối xếp được giữ lại đó.
Thẻ:host_machine_resource_optimizations
--skyframe_high_water_mark_minor_gc_drops_per_invocation=<an integer, >= 0>
mặc định: "2147483647"-
Cờ cho cấu hình nâng cao của công cụ Skyframe nội bộ của Bazel. Nếu phát hiện mức sử dụng phần trăm vùng nhớ khối xếp được giữ lại vượt quá ngưỡng do --skyframe_high_water_mark_threshold đặt ra, thì khi một sự kiện GC nhỏ xảy ra, Bazel sẽ loại bỏ trạng thái Skyframe tạm thời không cần thiết, lên đến nhiều lần như vậy mỗi lần gọi. Mặc định là Integer.MAX_VALUE; không giới hạn về mặt hiệu quả. Giá trị 0 có nghĩa là các sự kiện GC nhỏ sẽ không bao giờ kích hoạt sự kiện thả. Nếu đạt đến giới hạn, trạng thái Skyframe sẽ không còn bị loại bỏ khi một sự kiện GC nhỏ xảy ra và vượt quá ngưỡng phần trăm vùng nhớ khối xếp được giữ lại.
Thẻ:host_machine_resource_optimizations
--skyframe_high_water_mark_threshold=<an integer>
mặc định: "85"-
Cờ cho cấu hình nâng cao của công cụ Skyframe nội bộ của Bazel. Nếu phát hiện mức sử dụng phần trăm vùng nhớ khối xếp được giữ lại ít nhất là ngưỡng này, Bazel sẽ loại bỏ trạng thái Skyframe tạm thời không cần thiết. Việc điều chỉnh điều này có thể giúp bạn giảm thiểu tác động của tình trạng GC bị lỗi khi (i) tình trạng này là do mức sử dụng bộ nhớ của trạng thái tạm thời và (ii) tốn kém hơn so với việc tạo lại trạng thái khi cần.
Thẻ:host_machine_resource_optimizations
- Các tuỳ chọn ảnh hưởng đến mức độ chi tiết, định dạng hoặc vị trí ghi nhật ký:
--experimental_command_profile=<cpu, wall, alloc or lock>
mặc định: xem nội dung mô tả- Ghi hồ sơ Trình ghi chuyến bay Java trong thời gian thực thi lệnh. Bạn phải cung cấp một trong các loại sự kiện phân tích tài nguyên được hỗ trợ (cpu, wall, alloc hoặc lock) dưới dạng đối số. Hồ sơ được ghi vào một tệp được đặt tên theo loại sự kiện trong thư mục cơ sở đầu ra. Cú pháp và ngữ nghĩa của cờ này có thể thay đổi trong tương lai để hỗ trợ thêm các loại hồ sơ hoặc định dạng đầu ra; bạn tự chịu rủi ro khi sử dụng.
- Giá trị mặc định của
--[no]experimental_record_metrics_for_all_mnemonics
: "false" - Theo mặc định, số lượng loại thao tác được giới hạn ở 20 câu thần chú có số lượng thao tác được thực thi nhiều nhất. Việc đặt tuỳ chọn này sẽ ghi số liệu thống kê cho tất cả các câu thần chú.
- Các tuỳ chọn chỉ định hoặc thay đổi dữ liệu đầu vào chung thành một lệnh Bazel không thuộc các danh mục khác.:
--experimental_resolved_file_instead_of_workspace=<a string>
mặc định: ""- Nếu không trống, hãy đọc tệp đã phân giải được chỉ định thay vì tệp WORKSPACE
Thẻ:changes_inputs
- Các tuỳ chọn thực thi và lưu vào bộ nhớ đệm từ xa:
--experimental_downloader_config=<a string>
mặc định: xem nội dung mô tả- Chỉ định một tệp để định cấu hình trình tải xuống từ xa. Tệp này bao gồm các dòng, mỗi dòng bắt đầu bằng một lệnh (`allow`, `block` hoặc `rewrite`), theo sau là tên máy chủ lưu trữ (đối với lệnh `allow` và `block`) hoặc hai mẫu, một mẫu để so khớp và một mẫu để sử dụng làm URL thay thế, với các tệp tham chiếu ngược bắt đầu từ `$1`. Bạn có thể cung cấp nhiều lệnh `rewrite` cho cùng một URL và trong trường hợp này, nhiều URL sẽ được trả về.
- Giá trị mặc định của
--experimental_worker_for_repo_fetching=<off, platform, virtual or auto>
: "tự động" - Chế độ tạo luồng để tìm nạp kho lưu trữ. Nếu bạn đặt thành "tắt", thì không có luồng worker nào được sử dụng và quá trình tìm nạp kho lưu trữ sẽ phải khởi động lại. Nếu không, hãy sử dụng luồng worker ảo.
- Các tuỳ chọn khác, không được phân loại theo cách khác.:
--deleted_packages=<comma-separated list of package names>
nhiều lần sử dụng được tích luỹ- Danh sách tên gói được phân tách bằng dấu phẩy mà hệ thống xây dựng sẽ coi là không tồn tại, ngay cả khi các gói đó xuất hiện ở đâu đó trên đường dẫn gói. Sử dụng tuỳ chọn này khi xoá một gói con "x/y" của một gói hiện có "x". Ví dụ: sau khi xoá x/y/BUILD trong ứng dụng, hệ thống xây dựng có thể khiếu nại nếu gặp nhãn "//x:y/z" nếu nhãn đó vẫn được cung cấp bởi một mục package_path khác. Bạn có thể chỉ định --deleted_packages x/y để tránh vấn đề này.
- Giá trị mặc định của
--[no]fetch
: "true" - Cho phép lệnh tìm nạp các phần phụ thuộc bên ngoài. Nếu bạn đặt thành false, lệnh sẽ sử dụng bất kỳ phiên bản nào của phần phụ thuộc được lưu vào bộ nhớ đệm và nếu không có phiên bản nào, lệnh sẽ không thành công.
--override_repository=<an equals-separated mapping of repository name to path>
nhiều lần sử dụng được tích luỹ- Ghi đè kho lưu trữ bằng một đường dẫn cục bộ ở dạng <repository name>=<path>. Nếu đường dẫn đã cho là đường dẫn tuyệt đối, thì đường dẫn đó sẽ được sử dụng nguyên trạng. Nếu đường dẫn đã cho là đường dẫn tương đối, thì đường dẫn đó sẽ tương ứng với thư mục đang hoạt động. Nếu đường dẫn đã cho bắt đầu bằng "%workspace%", thì đường dẫn đó sẽ tương ứng với thư mục gốc của không gian làm việc, là kết quả của lệnh "bazel info workspace". Nếu đường dẫn đã cho trống, hãy xoá mọi chế độ ghi đè trước đó.
--package_path=<colon-separated list of options>
mặc định: "%workspace%"- Danh sách được phân tách bằng dấu hai chấm về nơi tìm kiếm các gói. Các phần tử bắt đầu bằng "%workspace%" có liên quan đến không gian làm việc bao quanh. Nếu bạn bỏ qua hoặc để trống, giá trị mặc định sẽ là kết quả của lệnh "bazel info default-package-path".
- Giá trị mặc định của
--[no]show_loading_progress
: "true" - Nếu được bật, sẽ khiến Bazel in thông báo "Loading package" ("Đang tải gói").
- Các tuỳ chọn kiểm soát quá trình thực thi bản dựng:
- Giá trị mặc định của
--[no]experimental_inprocess_symlink_creation
: "false" -
Liệu có thực hiện lệnh gọi hệ thống tệp trực tiếp để tạo cây đường liên kết tượng trưng hay không
Thẻ:loading_and_analysis
,execution
,experimental
- Giá trị mặc định của
--[no]experimental_persistent_aar_extractor
: "false" -
Bật trình trích xuất aar liên tục bằng cách sử dụng worker.
Thẻ:execution
- Giá trị mặc định của
--[no]experimental_remotable_source_manifests
: "false" -
Liệu có nên thực hiện các thao tác trong tệp kê khai nguồn từ xa hay không
Thẻ:loading_and_analysis
,execution
,experimental
- Giá trị mặc định của
--[no]experimental_split_coverage_postprocessing
: "false" - Nếu đúng, Bazel sẽ chạy quy trình xử lý sau khi kiểm thử để kiểm thử trong một quá trình tạo mới.
Thẻ:execution
- Giá trị mặc định của
--[no]experimental_strict_fileset_output
: "false" - Nếu bạn bật tuỳ chọn này, các tập hợp tệp sẽ coi tất cả cấu phần phần mềm đầu ra là tệp thông thường. Các tệp này sẽ không duyệt qua các thư mục hoặc nhạy cảm với các đường liên kết tượng trưng.
Thẻ:execution
- Giá trị mặc định của
--[no]incompatible_disallow_unsound_directory_outputs
: "true" - Nếu được đặt, thao tác hiện thực hoá tệp đầu ra dưới dạng thư mục sẽ gây ra lỗi. Không ảnh hưởng đến thư mục nguồn. Xem https://github.com/bazelbuild/bazel/issues/18646.
Thẻ:bazel_internal_configuration
,incompatible_change
- Giá trị mặc định của
--[no]incompatible_modify_execution_info_additive
: "false" -
Khi được bật, việc truyền nhiều cờ --modify_execution_info sẽ có tính chất cộng gộp. Khi bị tắt, hệ thống sẽ chỉ xem xét cờ gần đây nhất.
Thẻ:execution
,affects_outputs
,loading_and_analysis
,incompatible_change
--[no]keep_going
[-k
] mặc định: "false"-
Tiếp tục nhiều nhất có thể sau khi xảy ra lỗi. Mặc dù không thể phân tích mục tiêu không thành công và các mục tiêu phụ thuộc vào mục tiêu đó, nhưng bạn có thể phân tích các điều kiện tiên quyết khác của các mục tiêu này.
Thẻ:eagerness_to_exit
- Giá trị mặc định của
--loading_phase_threads=<an integer, or a keyword ("auto", "HOST_CPUS", "HOST_RAM"), optionally followed by an operation ([-|*]<float>) eg. "auto", "HOST_CPUS*.5">
: "tự động" - Số luồng song song cần sử dụng cho giai đoạn tải/phân tích. Nhận một số nguyên hoặc từ khoá ("tự động", "HOST_CPUS", "HOST_RAM"), theo sau có thể là một phép toán ([-|*]<float>) ví dụ: "tự động", "HOST_CPUS*.5". "tự động" đặt giá trị mặc định hợp lý dựa trên tài nguyên của máy chủ lưu trữ. Phải ít nhất là 1.
Thẻ:bazel_internal_configuration
--modify_execution_info=<regex=[+-]key,regex=[+-]key,...>
nhiều lần sử dụng được tích luỹ-
Thêm hoặc xoá các khoá khỏi thông tin thực thi của một hành động dựa trên câu thần chú hành động. Chỉ áp dụng cho các hành động hỗ trợ thông tin thực thi. Nhiều hành động phổ biến hỗ trợ thông tin thực thi, ví dụ: Genrule, CppCompile, Javac, StarlarkAction, TestRunner. Khi chỉ định nhiều giá trị, thứ tự sẽ rất quan trọng vì nhiều biểu thức chính quy có thể áp dụng cho cùng một câu thần chú.
Cú pháp: "regex=[+-]key,regex=[+-]key,...".
Ví dụ: ".*=+x,.*=-y,.*=+z" sẽ thêm "x" và "z" vào, đồng thời xoá "y" khỏi thông tin thực thi cho tất cả các hành động.
"Genrule=+requires-x" sẽ thêm "requires-x" vào thông tin thực thi cho tất cả các hành động Genrule.
"(?!Genrule).*=-requires-x" xoá "requires-x" khỏi thông tin thực thi cho tất cả các hành động không phải Genrule.
Thẻ:execution
,affects_outputs
,loading_and_analysis
--persistent_android_dex_desugar
-
Bật các thao tác dex và đơn giản hoá Android liên tục bằng cách sử dụng worker.
Mở rộng thành:
--internal_persistent_android_dex_desugar
--strategy=Desugar=worker
--strategy=DexBuilder=worker
Thẻ:host_machine_resource_optimizations
,execution
--persistent_android_resource_processor
- Bật trình xử lý tài nguyên Android liên tục bằng cách sử dụng worker.
Mở rộng thành:
--internal_persistent_busybox_tools
--strategy=AaptPackage=worker
--strategy=AndroidResourceParser=worker
--strategy=AndroidResourceValidator=worker
--strategy=AndroidResourceCompiler=worker
--strategy=RClassGenerator=worker
--strategy=AndroidResourceLink=worker
--strategy=AndroidAapt2=worker
--strategy=AndroidAssetMerger=worker
--strategy=AndroidResourceMerger=worker
--strategy=AndroidCompiledResourceMerger=worker
--strategy=ManifestMerger=worker
--strategy=AndroidManifestMerger=worker
--strategy=Aapt2Optimize=worker
--strategy=AARGenerator=worker
--strategy=ProcessDatabinding=worker
--strategy=GenerateDataBindingBaseClasses=worker
Thẻ:host_machine_resource_optimizations
,execution
--persistent_multiplex_android_dex_desugar
-
Bật các thao tác dex và đơn giản hoá Android được đa kênh liên tục bằng cách sử dụng worker.
Mở rộng thành:
--persistent_android_dex_desugar
--internal_persistent_multiplex_android_dex_desugar
Thẻ:host_machine_resource_optimizations
,execution
--persistent_multiplex_android_resource_processor
-
Bật trình xử lý tài nguyên Android được đa kênh liên tục bằng cách sử dụng worker.
Mở rộng thành:
--persistent_android_resource_processor
--modify_execution_info=AaptPackage=+supports-multiplex-workers
--modify_execution_info=AndroidResourceParser=+supports-multiplex-workers
--modify_execution_info=AndroidResourceValidator=+supports-multiplex-workers
--modify_execution_info=AndroidResourceCompiler=+supports-multiplex-workers
--modify_execution_info=RClassGenerator=+supports-multiplex-workers
--modify_execution_info=AndroidResourceLink=+supports-multiplex-workers
--modify_execution_info=AndroidAapt2=+supports-multiplex-workers
--modify_execution_info=AndroidAssetMerger=+supports-multiplex-workers
--modify_execution_info=AndroidResourceMerger=+supports-multiplex-workers
--modify_execution_info=AndroidCompiledResourceMerger=+supports-multiplex-workers
--modify_execution_info=ManifestMerger=+supports-multiplex-workers
--modify_execution_info=AndroidManifestMerger=+supports-multiplex-workers
--modify_execution_info=Aapt2Optimize=+supports-multiplex-workers
--modify_execution_info=AARGenerator=+supports-multiplex-workers
Thẻ:host_machine_resource_optimizations
,execution
--persistent_multiplex_android_tools
- Bật các công cụ Android liên tục và đa kênh (dexing, desugaring, xử lý tài nguyên).
Mở rộng thành:
--internal_persistent_multiplex_busybox_tools
--persistent_multiplex_android_resource_processor
--persistent_multiplex_android_dex_desugar
Thẻ:host_machine_resource_optimizations
,execution
- Giá trị mặc định của
--[no]use_target_platform_for_tests
: "false" - Nếu đúng, Bazel sẽ sử dụng nền tảng mục tiêu để chạy kiểm thử thay vì nhóm thực thi kiểm thử.
Thẻ:execution
- Các tuỳ chọn định cấu hình chuỗi công cụ dùng để thực thi hành động:
--android_compiler=<a string>
mặc định: xem nội dung mô tả-
Trình biên dịch mục tiêu Android.
Thẻ:affects_outputs
,loading_and_analysis
,loses_incremental_state
--android_crosstool_top=<a build target label>
mặc định: "//external:android/crosstool"-
Vị trí của trình biên dịch C++ dùng cho các bản dựng Android.
Thẻ:affects_outputs
,changes_inputs
,loading_and_analysis
,loses_incremental_state
--android_grte_top=<a label>
mặc định: xem nội dung mô tả-
Mục tiêu Android grte_top.
Thẻ:changes_inputs
,loading_and_analysis
,loses_incremental_state
--android_manifest_merger=<legacy, android or force_android>
mặc định: "android"-
Chọn trình hợp nhất tệp kê khai để sử dụng cho các quy tắc android_binary. Cờ để giúp chuyển đổi sang trình hợp nhất tệp kê khai Android từ trình hợp nhất cũ.
Thẻ:affects_outputs
,loading_and_analysis
,loses_incremental_state
--android_platforms=<a build target label>
mặc định: ""-
Đặt các nền tảng mà mục tiêu android_binary sử dụng. Nếu bạn chỉ định nhiều nền tảng, thì tệp nhị phân sẽ là tệp APK lớn, chứa các tệp nhị phân gốc cho từng nền tảng mục tiêu được chỉ định.
Thẻ:changes_inputs
,loading_and_analysis
,loses_incremental_state
--android_sdk=<a build target label>
mặc định: "@bazel_tools//tools/android:sdk"- Chỉ định SDK/nền tảng Android dùng để tạo ứng dụng Android.
Thẻ:changes_inputs
,loading_and_analysis
,loses_incremental_state
--apple_crosstool_top=<a build target label>
mặc định: "@bazel_tools//tools/cpp:toolchain"-
Nhãn của gói công cụ đa nền tảng sẽ được dùng trong các quy tắc của Apple và Objc cũng như các phần phụ thuộc của các quy tắc đó.
Thẻ:loses_incremental_state
,changes_inputs
--cc_output_directory_tag=<a string>
mặc định: ""- Chỉ định hậu tố cần thêm vào thư mục cấu hình.
Thẻ:affects_outputs
--compiler=<a string>
mặc định: xem nội dung mô tả-
Trình biên dịch C++ dùng để biên dịch mục tiêu.
Thẻ:loading_and_analysis
,execution
--coverage_output_generator=<a build target label>
mặc định: "@bazel_tools//tools/test:lcov_merger"-
Vị trí của tệp nhị phân dùng để xử lý sau các báo cáo phạm vi thô. Hiện tại, đây phải là một nhóm tệp chứa một tệp duy nhất, tệp nhị phân. Giá trị mặc định là "//tools/test:lcov_merger".
Thẻ:changes_inputs
,affects_outputs
,loading_and_analysis
--coverage_report_generator=<a build target label>
mặc định: "@bazel_tools//tools/test:coverage_report_generator"-
Vị trí của tệp nhị phân dùng để tạo báo cáo mức độ sử dụng. Hiện tại, đây phải là một nhóm tệp chứa một tệp duy nhất, tệp nhị phân. Giá trị mặc định là "//tools/test:coverage_report_generator".
Thẻ:changes_inputs
,affects_outputs
,loading_and_analysis
--coverage_support=<a build target label>
mặc định: "@bazel_tools//tools/test:coverage_support"-
Vị trí của các tệp hỗ trợ bắt buộc trên dữ liệu đầu vào của mọi hành động kiểm thử thu thập mức độ sử dụng mã. Giá trị mặc định là "//tools/test:coverage_support".
Thẻ:changes_inputs
,affects_outputs
,loading_and_analysis
--crosstool_top=<a build target label>
mặc định: "@bazel_tools//tools/cpp:toolchain"-
Nhãn của gói công cụ đa nền tảng dùng để biên dịch mã C++.
Thẻ:loading_and_analysis
,changes_inputs
,affects_outputs
--custom_malloc=<a build target label>
mặc định: xem nội dung mô tả-
Chỉ định cách triển khai malloc tuỳ chỉnh. Chế độ cài đặt này sẽ ghi đè các thuộc tính malloc trong quy tắc bản dựng.
Thẻ:changes_inputs
,affects_outputs
--experimental_add_exec_constraints_to_targets=<a '<RegexFilter>=<label1>[,<label2>,...]' assignment>
nhiều lần sử dụng được tích luỹ-
Danh sách biểu thức chính quy được phân tách bằng dấu phẩy, mỗi biểu thức có thể có tiền tố là - (biểu thức phủ định), được gán (=) cho danh sách các mục tiêu giá trị quy tắc ràng buộc được phân tách bằng dấu phẩy. Nếu một mục tiêu không khớp với biểu thức âm và ít nhất một biểu thức dương, thì độ phân giải chuỗi công cụ của mục tiêu đó sẽ được thực hiện như thể mục tiêu đó đã khai báo các giá trị ràng buộc dưới dạng các ràng buộc thực thi. Ví dụ: //demo,-test=@platforms//cpus:x86_64 sẽ thêm "x86_64" vào bất kỳ mục tiêu nào trong //demo, ngoại trừ những mục tiêu có tên chứa "test".
Thẻ:loading_and_analysis
- Giá trị mặc định của
--[no]experimental_include_xcode_execution_requirements
: "false" - Nếu bạn đặt, hãy thêm yêu cầu thực thi "requires-xcode:{version}" vào mọi thao tác Xcode. Nếu phiên bản xcode có nhãn được nối bằng dấu gạch nối, hãy thêm yêu cầu thực thi "requires-xcode-label:{version_label}".
Thẻ:loses_incremental_state
,loading_and_analysis
,execution
- Giá trị mặc định của
--[no]experimental_prefer_mutual_xcode
: "true" - Nếu đúng, hãy sử dụng Xcode mới nhất có sẵn cả cục bộ và từ xa. Nếu giá trị là false hoặc nếu không có phiên bản nào có sẵn, hãy sử dụng phiên bản Xcode cục bộ được chọn thông qua xcode-select.
Thẻ:loses_incremental_state
--extra_execution_platforms=<comma-separated list of options>
mặc định: ""-
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(). Bạn chỉ có thể đặt tuỳ chọn này một lần; các thực thể sau đó sẽ ghi đè các chế độ cài đặt cờ trước đó.
Thẻ:execution
--extra_toolchains=<comma-separated list of options>
nhiều lần sử dụng được tích luỹ-
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 những chuỗi công cụ được khai báo trong tệp WORKSPACE bằng register_toolchains().
Thẻ:affects_outputs
,changes_inputs
,loading_and_analysis
--grte_top=<a label>
mặc định: xem nội dung mô tả-
Nhãn cho thư viện libc đã kiểm tra. Giá trị mặc định được chuỗi công cụ crosstool chọn và bạn hầu như không bao giờ cần ghi đè giá trị này.
Thẻ:action_command_lines
,affects_outputs
--host_compiler=<a string>
mặc định: xem nội dung mô tả-
Trình biên dịch C++ để sử dụng cho quá trình biên dịch máy chủ lưu trữ. Giá trị này sẽ bị bỏ qua nếu bạn không đặt --host_crosstool_top.
Thẻ:loading_and_analysis
,execution
--host_crosstool_top=<a build target label>
mặc định: xem nội dung mô tả- Theo mặc định, các tuỳ chọn --crosstool_top và --compiler cũng được dùng cho cấu hình exec. Nếu bạn cung cấp cờ này, Bazel sẽ sử dụng libc và trình biên dịch mặc định cho crosstool_top đã cho.
Thẻ:loading_and_analysis
,changes_inputs
,affects_outputs
--host_grte_top=<a label>
mặc định: xem nội dung mô tả- Nếu được chỉ định, chế độ cài đặt này sẽ ghi đè thư mục cấp cao nhất libc (--grte_top) cho cấu hình thực thi.
Thẻ:action_command_lines
,affects_outputs
--host_platform=<a build target label>
mặc định: "@bazel_tools//tools:host_platform"-
Nhãn của quy tắc nền tảng mô tả hệ thống lưu trữ.
Thẻ:affects_outputs
,changes_inputs
,loading_and_analysis
- Giá trị mặc định của
--[no]incompatible_dont_enable_host_nonhost_crosstool_features
: "true" - Nếu đúng, Bazel sẽ không bật các tính năng "máy chủ" và "không phải máy chủ" trong chuỗi công cụ c++ (xem https://github.com/bazelbuild/bazel/issues/7407 để biết thêm thông tin).
Thẻ:loading_and_analysis
,incompatible_change
- Giá trị mặc định của
--[no]incompatible_enable_android_toolchain_resolution
: "true" -
Sử dụng độ phân giải chuỗi công cụ để chọn SDK Android cho các quy tắc Android (Starlark và gốc)
Thẻ:loading_and_analysis
,incompatible_change
- Giá trị mặc định của
--[no]incompatible_enable_apple_toolchain_resolution
: "false" -
Sử dụng độ phân giải chuỗi công cụ để chọn SDK Apple cho các quy tắc của Apple (Starlark và gốc)
Thẻ:loading_and_analysis
,incompatible_change
- Giá trị mặc định của
--[no]incompatible_make_thinlto_command_lines_standalone
: "true" - Nếu đúng, Bazel sẽ không sử dụng lại các dòng lệnh thao tác liên kết C++ cho các dòng lệnh lập chỉ mục lto (xem https://github.com/bazelbuild/bazel/issues/6791 để biết thêm thông tin).
Thẻ:loading_and_analysis
,incompatible_change
- Giá trị mặc định của
--[no]incompatible_remove_legacy_whole_archive
: "true" - Nếu đúng, theo mặc định, Bazel sẽ không liên kết các phần phụ thuộc thư viện dưới dạng toàn bộ bản lưu trữ (xem https://github.com/bazelbuild/bazel/issues/7362 để biết hướng dẫn di chuyển).
Thẻ:loading_and_analysis
,incompatible_change
- Giá trị mặc định của
--[no]incompatible_require_ctx_in_configure_features
: "true" - Nếu đúng, Bazel sẽ yêu cầu tham số "ctx" trong cc_common.configure_features (xem https://github.com/bazelbuild/bazel/issues/7793 để biết thêm thông tin).
Thẻ:loading_and_analysis
,incompatible_change
- Sử dụng đối tượng dùng chung giao diện nếu chuỗi công cụ hỗ trợ. Tất cả chuỗi công cụ ELF hiện đều hỗ trợ chế độ cài đặt này.
Thẻ:loading_and_analysis
,affects_outputs
,affects_outputs
--ios_sdk_version=<a dotted version (for example '2.3' or '3.3alpha2.4')>
mặc định: xem nội dung mô tả-
Chỉ định phiên bản SDK iOS để sử dụng nhằm xây dựng ứng dụng iOS. Nếu không chỉ định, hãy sử dụng phiên bản SDK iOS mặc định từ "xcode_version".
Thẻ:loses_incremental_state
--macos_sdk_version=<a dotted version (for example '2.3' or '3.3alpha2.4')>
mặc định: xem nội dung mô tả-
Chỉ định phiên bản SDK macOS để sử dụng nhằm tạo ứng dụng macOS. Nếu không chỉ định, sẽ sử dụng phiên bản SDK macOS mặc định từ "xcode_version".
Thẻ:loses_incremental_state
--minimum_os_version=<a string>
mặc định: xem nội dung mô tả- Phiên bản hệ điều hành tối thiểu mà mục tiêu biên dịch của bạn nhắm đến.
Thẻ:loading_and_analysis
,affects_outputs
--platform_mappings=<a relative path>
mặc định: ""-
Vị trí của tệp ánh xạ mô tả nền tảng nào sẽ sử dụng nếu không có nền tảng nào được đặt hoặc cờ nào sẽ được đặt khi nền tảng đã tồn tại. Phải tương ứng với thư mục gốc của không gian làm việc chính. Mặc định là "platform_mappings" (một tệp nằm ngay trong thư mục gốc của không gian làm việc).
Thẻ:affects_outputs
,changes_inputs
,loading_and_analysis
--platforms=<a build target label>
mặc định: ""-
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.
Thẻ:affects_outputs
,changes_inputs
,loading_and_analysis
--python2_path=<a string>
mặc định: xem nội dung mô tả-
Không dùng nữa, không hoạt động. Tắt bằng `--incompatible_use_python_toolchains`.
Thẻ:no_op
,deprecated
--python3_path=<a string>
mặc định: xem nội dung mô tả-
Không dùng nữa, không hoạt động. Tắt bằng `--incompatible_use_python_toolchains`.
Thẻ:no_op
,deprecated
--python_path=<a string>
mặc định: xem nội dung mô tả-
Đường dẫn tuyệt đối của trình thông dịch Python được gọi để chạy các mục tiêu Python trên nền tảng mục tiêu. Không dùng nữa; bị vô hiệu hoá bằng --incompatible_use_python_toolchains.
Thẻ:loading_and_analysis
,affects_outputs
--python_top=<a build target label>
mặc định: xem nội dung mô tả-
Nhãn của py_runtime đại diện cho trình thông dịch Python được gọi để chạy các mục tiêu Python trên nền tảng mục tiêu. Không dùng nữa; bị vô hiệu hoá bằng --incompatible_use_python_toolchains.
Thẻ:loading_and_analysis
,affects_outputs
--tvos_sdk_version=<a dotted version (for example '2.3' or '3.3alpha2.4')>
mặc định: xem nội dung mô tả-
Chỉ định phiên bản SDK tvOS để sử dụng nhằm xây dựng ứng dụng tvOS. Nếu không chỉ định, hãy sử dụng phiên bản SDK tvOS mặc định từ "xcode_version".
Thẻ:loses_incremental_state
--watchos_sdk_version=<a dotted version (for example '2.3' or '3.3alpha2.4')>
mặc định: xem nội dung mô tả- Chỉ định phiên bản SDK watchOS để sử dụng nhằm xây dựng ứng dụng watchOS. Nếu không chỉ định, hãy sử dụng phiên bản SDK watchOS mặc định từ "xcode_version".
Thẻ:loses_incremental_state
--xcode_version=<a string>
mặc định: xem nội dung mô tả- Nếu được chỉ định, hãy sử dụng Xcode của phiên bản đã cho cho các thao tác bản dựng có liên quan. Nếu không chỉ định, hãy sử dụng phiên bản trình thực thi mặc định của Xcode.
Thẻ:loses_incremental_state
--xcode_version_config=<a build target label>
mặc định: "@bazel_tools//tools/cpp:host_xcodes"-
Nhãn của quy tắc xcode_config dùng để chọn phiên bản Xcode trong cấu hình bản dựng.
Thẻ:loses_incremental_state
,loading_and_analysis
- Các tuỳ chọn kiểm soát đầu ra của lệnh:
- Giá trị mặc định của
--[no]apple_generate_dsym
: "false" -
Liệu có tạo (các) tệp biểu tượng gỡ lỗi (.dSYM) hay không.
Thẻ:affects_outputs
,action_command_lines
- Giá trị mặc định của
--[no]build_runfile_links
: "true" - Nếu đúng, hãy tạo rừng đường liên kết tượng trưng cho tệp chạy cho tất cả các mục tiêu. Nếu giá trị là false, chỉ ghi các tệp này khi một hành động cục bộ, lệnh kiểm thử hoặc chạy yêu cầu.
Thẻ:affects_outputs
- Giá trị mặc định của
--[no]build_runfile_manifests
: "true" - Nếu đúng, hãy ghi tệp kê khai tệp chạy cho tất cả các mục tiêu. Nếu sai, hãy bỏ qua các giá trị này. Các kiểm thử cục bộ sẽ không chạy được khi giá trị là false.
Thẻ:affects_outputs
- Giá trị mặc định của
--[no]build_test_dwp
: "false" - Nếu được bật, khi tạo các chương trình kiểm thử C++ một cách tĩnh và có tính năng phân tách, tệp .dwp cho tệp nhị phân kiểm thử cũng sẽ được tạo tự động.
Thẻ:loading_and_analysis
,affects_outputs
--cc_proto_library_header_suffixes=<comma-separated set of options>
mặc định: ".pb.h"- Đặt hậu tố của các tệp tiêu đề mà cc_proto_library tạo.
Thẻ:affects_outputs
,loading_and_analysis
--cc_proto_library_source_suffixes=<comma-separated set of options>
mặc định: ".pb.cc"-
Đặt hậu tố của các tệp nguồn mà cc_proto_library tạo.
Thẻ:affects_outputs
,loading_and_analysis
- Giá trị mặc định của
--[no]experimental_proto_descriptor_sets_include_source_info
: "false" -
Chạy các thao tác bổ sung cho các phiên bản API Java thay thế trong proto_library.
Thẻ:affects_outputs
,loading_and_analysis
,experimental
- Giá trị mặc định của
--[no]experimental_proto_extra_actions
: "false" -
Chạy các thao tác bổ sung cho các phiên bản API Java thay thế trong proto_library.
Thẻ:affects_outputs
,loading_and_analysis
,experimental
- Giá trị mặc định của
--[no]experimental_save_feature_state
: "false" -
Lưu trạng thái của các tính năng đã bật và được yêu cầu dưới dạng kết quả biên dịch.
Thẻ:affects_outputs
,experimental
--fission=<a set of compilation modes>
mặc định: "no"- Chỉ định chế độ biên dịch nào sử dụng tính năng phân hạch cho các bản biên dịch và đường liên kết C++. Có thể là bất kỳ tổ hợp nào của {'fastbuild', 'dbg', 'opt'} hoặc các giá trị đặc biệt "yes" để bật tất cả chế độ và "no" để tắt tất cả chế độ.
Thẻ:loading_and_analysis
,action_command_lines
,affects_outputs
- Giá trị mặc định của
--[no]incompatible_always_include_files_in_data
: "true" - Nếu đúng, các quy tắc gốc sẽ thêm <code>DefaultInfo.files</code> của các phần phụ thuộc dữ liệu vào tệp chạy của chúng, khớp với hành vi được đề xuất cho các quy tắc Starlark (https://bazel.build/extending/rules#runfiles_features_to_avoid).
Thẻ:affects_outputs
,incompatible_change
- Giá trị mặc định của
--[no]legacy_external_runfiles
: "true" - Nếu đúng, hãy tạo rừng đường liên kết tượng trưng cho tệp chạy cho các kho lưu trữ bên ngoài trong .runfiles/wsname/external/repo (ngoài .runfiles/repo).
Thẻ:affects_outputs
- Giá trị mặc định của
--[no]objc_generate_linkmap
: "false" -
Chỉ định xem có tạo tệp liên kết hay không.
Thẻ:affects_outputs
- Giá trị mặc định của
--[no]save_temps
: "false" - Nếu được đặt, kết quả tạm thời từ gcc sẽ được lưu. Các tệp này bao gồm tệp .s (mã tập hợp), tệp .i (C được xử lý trước) và tệp .ii (C++ được xử lý trước).
Thẻ:affects_outputs
- Các tuỳ chọn cho phép người dùng định cấu hình đầu ra dự kiến, ảnh hưởng đến giá trị của đầu ra đó, thay vì sự tồn tại của đầu ra:
--action_env=<a 'name=value' assignment with an optional value part>
nhiều lần sử dụng được tích luỹ-
Chỉ định tập hợp các biến môi trường có sẵn cho các hành động có cấu hình mục tiêu. Bạn có thể chỉ định biến theo tên, trong trường hợp này giá trị sẽ được lấy từ môi trường gọi, hoặc theo cặp name=value để đặt giá trị độc lập với môi trường gọi. Bạn có thể sử dụng tuỳ chọn này nhiều lần; đối với các tuỳ chọn được đưa ra cho cùng một biến, tuỳ chọn mới nhất sẽ thắng, còn các tuỳ chọn cho các biến khác nhau sẽ được tích luỹ.
Thẻ:action_command_lines
--android_cpu=<a string>
mặc định: "armeabi-v7a"- CPU mục tiêu của Android.
Thẻ:affects_outputs
,loading_and_analysis
,loses_incremental_state
- Giá trị mặc định của
--[no]android_databinding_use_androidx
: "true" - Tạo các tệp liên kết dữ liệu tương thích với AndroidX. Phương thức này chỉ được dùng với databinding v2. Cờ này không có tác dụng.
Thẻ:affects_outputs
,loading_and_analysis
,loses_incremental_state
,experimental
- Giá trị mặc định của
--[no]android_databinding_use_v3_4_args
: "true" -
Sử dụng android databinding v2 với đối số 3.4.0. Cờ này không có tác dụng.
Thẻ:affects_outputs
,loading_and_analysis
,loses_incremental_state
,experimental
--android_dynamic_mode=<off, default or fully>
mặc định: "off"- xác định xem các phần phụ thuộc C++ của quy tắc Android có được liên kết động khi cc_binary không tạo thư viện dùng chung một cách rõ ràng hay không. "mặc định" có nghĩa là bazel sẽ chọn xem có liên kết động hay không. "đầy đủ" có nghĩa là tất cả thư viện sẽ được liên kết động. "tắt" có nghĩa là tất cả thư viện sẽ được liên kết chủ yếu ở chế độ tĩnh.
Thẻ:affects_outputs
,loading_and_analysis
--android_manifest_merger_order=<alphabetical, alphabetical_by_configuration or dependency>
mặc định: "alphabetical"-
Đặt thứ tự của tệp kê khai được chuyển đến trình sáp nhập tệp kê khai cho tệp nhị phân Android. ALPHABETICAL (TĂNG DẦN) nghĩa là tệp kê khai được sắp xếp theo đường dẫn tương ứng với execroot. ALPHABETICAL_BY_CONFIGURATION có nghĩa là tệp kê khai được sắp xếp theo đường dẫn tương ứng với thư mục cấu hình trong thư mục đầu ra. DEPENDENCY (PHẦN PHỤ THUỘC) có nghĩa là tệp kê khai được sắp xếp theo thứ tự tệp kê khai của mỗi thư viện đứng trước tệp kê khai của các phần phụ thuộc.
Thẻ:action_command_lines
,execution
- Giá trị mặc định của
--[no]android_resource_shrinking
: "false" - Bật tính năng rút gọn tài nguyên cho các tệp APK android_binary sử dụng ProGuard.
Thẻ:affects_outputs
,loading_and_analysis
- Giá trị mặc định của
--[no]build_python_zip
: "tự động" -
Tạo tệp zip có thể thực thi python; bật trên Windows, tắt trên các nền tảng khác
Thẻ:affects_outputs
--catalyst_cpus=<comma-separated list of options>
nhiều lần sử dụng được tích luỹ-
Danh sách các cấu trúc được phân tách bằng dấu phẩy để tạo tệp nhị phân Apple Catalyst.
Thẻ:loses_incremental_state
,loading_and_analysis
- Giá trị mặc định của
--[no]collect_code_coverage
: "false" - Nếu được chỉ định, Bazel sẽ đo lường mã (sử dụng công cụ đo lường ngoại tuyến nếu có thể) và sẽ thu thập thông tin về mức độ sử dụng trong quá trình kiểm thử. Chỉ những mục tiêu khớp với --instrumentation_filter mới bị ảnh hưởng. Thông thường, bạn không nên chỉ định trực tiếp tuỳ chọn này – thay vào đó, hãy sử dụng lệnh "bazel coverage".
Thẻ:affects_outputs
--compilation_mode=<fastbuild, dbg or opt>
[-c
] mặc định: "fastbuild"-
Chỉ định chế độ mà tệp nhị phân sẽ được tạo. Giá trị: "fastbuild", "dbg", "opt".
Thẻ:affects_outputs
,action_command_lines
--conlyopt=<a string>
nhiều lần sử dụng được tích luỹ- Tuỳ chọn bổ sung để truyền đến gcc khi biên dịch tệp nguồn C.
Thẻ:action_command_lines
,affects_outputs
--copt=<a string>
nhiều lần sử dụng được tích luỹ-
Các tuỳ chọn bổ sung để truyền đến gcc.
Thẻ:action_command_lines
,affects_outputs
--cpu=<a string>
mặc định: ""- CPU mục tiêu.
Thẻ:changes_inputs
,affects_outputs
--cs_fdo_absolute_path=<a string>
mặc định: xem nội dung mô tả-
Sử dụng thông tin hồ sơ CSFDO để tối ưu hoá quá trình biên dịch. Chỉ định tên đường dẫn tuyệt đối của tệp zip chứa tệp hồ sơ, tệp hồ sơ LLVM thô hoặc được lập chỉ mục.
Thẻ:affects_outputs
--cs_fdo_instrument=<a string>
mặc định: xem nội dung mô tả-
Tạo tệp nhị phân bằng khả năng đo lường FDO nhạy cảm với ngữ cảnh. Với trình biên dịch Clang/LLVM, trình biên dịch này cũng chấp nhận tên thư mục mà(các) tệp hồ sơ thô sẽ được kết xuất trong thời gian chạy.
Thẻ:affects_outputs
--cs_fdo_profile=<a build target label>
mặc định: xem nội dung mô tả-
cs_fdo_profile đại diện cho hồ sơ nhạy cảm theo ngữ cảnh sẽ được dùng để tối ưu hoá.
Thẻ:affects_outputs
--cxxopt=<a string>
nhiều lần sử dụng được tích luỹ- Tuỳ chọn bổ sung để truyền đến gcc khi biên dịch tệp nguồn C++.
Thẻ:action_command_lines
,affects_outputs
--define=<a 'name=value' assignment>
nhiều lần sử dụng được tích luỹ-
Mỗi tuỳ chọn --define chỉ định một giá trị gán cho một biến bản dựng.
Thẻ:changes_inputs
,affects_outputs
- Giá trị mặc định của
--dynamic_mode=<off, default or fully>
: "mặc định" - Xác định xem tệp nhị phân C++ có được liên kết động hay không. "mặc định" có nghĩa là Bazel sẽ chọn xem có liên kết động hay không. "đầy đủ" có nghĩa là tất cả thư viện sẽ được liên kết động. "tắt" có nghĩa là tất cả thư viện sẽ được liên kết chủ yếu ở chế độ tĩnh.
Thẻ:loading_and_analysis
,affects_outputs
- Giá trị mặc định của
--[no]enable_fdo_profile_absolute_path
: "true" - Nếu bạn đặt, việc sử dụng fdo_absolute_profile_path sẽ gây ra lỗi.
Thẻ:affects_outputs
- Giá trị mặc định của
--[no]enable_runfiles
: "tự động" - Bật cây đường liên kết tượng trưng của tệp chạy; Theo mặc định, tính năng này sẽ tắt trên Windows và trên các nền tảng khác.
Thẻ:affects_outputs
--experimental_action_listener=<a build target label>
nhiều lần sử dụng được tích luỹ- Ngừng sử dụng và thay bằng các khía cạnh. Sử dụng action_listener để đính kèm extra_action vào các hành động bản dựng hiện có.
Thẻ:execution
,experimental
- Giá trị mặc định của
--[no]experimental_android_compress_java_resources
: "false" -
Nén tài nguyên Java trong tệp APK
Thẻ:affects_outputs
,loading_and_analysis
,experimental
- Giá trị mặc định của
--[no]experimental_android_databinding_v2
: "true" -
Sử dụng android databinding v2. Cờ này không có tác dụng.
Thẻ:affects_outputs
,loading_and_analysis
,loses_incremental_state
,experimental
- Giá trị mặc định của
--[no]experimental_android_resource_shrinking
: "false" - Bật tính năng rút gọn tài nguyên cho các tệp APK android_binary sử dụng ProGuard.
Thẻ:affects_outputs
,loading_and_analysis
- Giá trị mặc định của
--[no]experimental_android_rewrite_dexes_with_rex
: "false" -
sử dụng công cụ rex để ghi lại các tệp dex
Thẻ:affects_outputs
,loading_and_analysis
,loses_incremental_state
,experimental
- Giá trị mặc định của
--[no]experimental_collect_code_coverage_for_generated_files
: "false" - Nếu được chỉ định, Bazel cũng sẽ tạo thông tin thu thập mức độ sử dụng cho các tệp đã tạo.
Thẻ:affects_outputs
--experimental_objc_fastbuild_options=<comma-separated list of options>
mặc định: "-O0,-DDEBUG=1"-
Sử dụng các chuỗi này làm tuỳ chọn trình biên dịch bản dựng nhanh objc.
Thẻ:action_command_lines
- Giá trị mặc định của
--[no]experimental_omitfp
: "false" - Nếu đúng, hãy sử dụng libunwind để gỡ bỏ ngăn xếp và biên dịch bằng -fomit-frame-pointer và -fasynchronous-unwind-tables.
Thẻ:action_command_lines
,affects_outputs
,experimental
--experimental_output_paths=<off, content or strip>
mặc định: "off"-
Mô hình nào sẽ được sử dụng cho vị trí trong quy tắc cây đầu ra ghi đầu ra của chúng, đặc biệt là đối với các bản dựng đa nền tảng / đa cấu hình. Đây là một tính năng thử nghiệm. Hãy xem https://github.com/bazelbuild/bazel/issues/6526 để biết thông tin chi tiết. Các hành động Starlark có thể chọn sử dụng tính năng liên kết đường dẫn bằng cách thêm khoá "supports-path-mapping" vào tập hợp "execution_requirements".
Thẻ:loses_incremental_state
,bazel_internal_configuration
,affects_outputs
,execution
--experimental_override_name_platform_in_output_dir=<a 'label=value' assignment>
nhiều lần sử dụng được tích luỹ-
Mỗi mục nhập phải có dạng label=value, trong đó label (nhãn) tham chiếu đến một nền tảng và value (giá trị) là tên ngắn mong muốn để sử dụng trong đường dẫn đầu ra. Chỉ được dùng khi --experimental_platform_in_output_dir là true. Có mức độ ưu tiên đặt tên cao nhất.
Thẻ:affects_outputs
,experimental
- Giá trị mặc định của
--[no]experimental_platform_in_output_dir
: "false" - Nếu đúng, tên ngắn cho nền tảng mục tiêu sẽ được dùng trong tên thư mục đầu ra thay vì CPU. Lược đồ chính xác là thử nghiệm và có thể thay đổi: Trước tiên, trong trường hợp hiếm hoi tuỳ chọn --platforms không có đúng một giá trị, thì một hàm băm của tuỳ chọn platforms sẽ được sử dụng. Tiếp theo, nếu bất kỳ tên ngắn nào cho nền tảng hiện tại được đăng ký bằng --experimental_override_name_platform_in_output_dir, thì tên ngắn đó sẽ được sử dụng. Sau đó, nếu bạn đặt --experimental_use_platforms_in_output_dir_legacy_heuristic, hãy sử dụng tên ngắn dựa trên Nhãn nền tảng hiện tại. Cuối cùng, hàm băm của tuỳ chọn nền tảng sẽ được dùng làm phương án cuối cùng.
Thẻ:affects_outputs
,experimental
- Giá trị mặc định của
--[no]experimental_use_llvm_covmap
: "false" - Nếu được chỉ định, Bazel sẽ tạo thông tin bản đồ mức độ sử dụng llvm-cov thay vì gcov khi bật collect_code_coverage.
Thẻ:changes_inputs
,affects_outputs
,loading_and_analysis
,experimental
- Giá trị mặc định của
--[no]experimental_use_platforms_in_output_dir_legacy_heuristic
: "true" -
Vui lòng chỉ sử dụng cờ này trong chiến lược di chuyển hoặc kiểm thử được đề xuất. Xin lưu ý rằng phương pháp phỏng đoán có những thiếu sót đã biết và bạn nên chuyển sang chỉ dựa vào --experimental_override_name_platform_in_output_dir.
Thẻ:affects_outputs
,experimental
--fat_apk_cpu=<comma-separated set of options>
mặc định: "armeabi-v7a"-
Việc đặt tuỳ chọn này sẽ bật các tệp APK lớn, chứa các tệp nhị phân gốc cho tất cả các cấu trúc mục tiêu được chỉ định, ví dụ: --fat_apk_cpu=x86,armeabi-v7a. Nếu bạn chỉ định cờ này, thì --android_cpu sẽ bị bỏ qua đối với các phần phụ thuộc của quy tắc android_binary.
Thẻ:affects_outputs
,loading_and_analysis
,loses_incremental_state
- Giá trị mặc định của
--[no]fat_apk_hwasan
: "false" -
Liệu có tạo các phần phân tách HWASAN hay không.
Thẻ:affects_outputs
,loading_and_analysis
,loses_incremental_state
--fdo_instrument=<a string>
mặc định: xem nội dung mô tả-
Tạo tệp nhị phân bằng khả năng đo lường FDO. Với trình biên dịch Clang/LLVM, trình biên dịch này cũng chấp nhận tên thư mục mà(các) tệp hồ sơ thô sẽ được kết xuất trong thời gian chạy.
Thẻ:affects_outputs
--fdo_optimize=<a string>
mặc định: xem nội dung mô tả- Sử dụng thông tin hồ sơ FDO để tối ưu hoá quá trình biên dịch. Chỉ định tên của tệp zip chứa cây tệp .gcda, tệp afdo chứa hồ sơ tự động hoặc tệp hồ sơ LLVM. Cờ này cũng chấp nhận các tệp được chỉ định làm nhãn (ví dụ: `//foo/bar:file.afdo` – bạn có thể cần thêm một lệnh `exports_files` vào gói tương ứng) và các nhãn trỏ đến mục tiêu `fdo_profile`. Cờ này sẽ được thay thế bằng quy tắc `fdo_profile`.
Thẻ:affects_outputs
--fdo_prefetch_hints=<a build target label>
mặc định: xem nội dung mô tả-
Sử dụng gợi ý tìm nạp trước bộ nhớ đệm.
Thẻ:affects_outputs
--fdo_profile=<a build target label>
mặc định: xem nội dung mô tả-
fdo_profile đại diện cho hồ sơ sẽ được dùng để tối ưu hoá.
Thẻ:affects_outputs
--features=<a string>
nhiều lần sử dụng được tích luỹ- Theo mặc định, các tính năng đã cho sẽ được bật hoặc tắt đối với các mục tiêu được tạo trong cấu hình mục tiêu. Việc chỉ định -<feature> sẽ tắt tính năng đó. Các đặc điểm tiêu cực luôn ghi đè các đặc điểm tích cực. Xem thêm --host_features
Thẻ
:changes_inputs
,affects_outputs
- Giá trị mặc định của
--[no]force_pic
: "false" - Nếu được bật, tất cả các bản biên dịch C++ sẽ tạo mã không phụ thuộc vào vị trí ("-fPIC"), các đường liên kết sẽ ưu tiên thư viện tạo sẵn PIC hơn thư viện không phải PIC và các đường liên kết sẽ tạo tệp thực thi không phụ thuộc vào vị trí ("-pie").
Thẻ:loading_and_analysis
,affects_outputs
--host_action_env=<a 'name=value' assignment with an optional value part>
nhiều lần sử dụng được tích luỹ- Chỉ định tập hợp các biến môi trường có sẵn cho các hành động có cấu hình thực thi. Bạn có thể chỉ định biến theo tên, trong trường hợp này giá trị sẽ được lấy từ môi trường gọi, hoặc theo cặp name=value để đặt giá trị độc lập với môi trường gọi. Bạn có thể sử dụng tuỳ chọn này nhiều lần; đối với các tuỳ chọn được đưa ra cho cùng một biến, tuỳ chọn mới nhất sẽ thắng, còn các tuỳ chọn cho các biến khác nhau sẽ được tích luỹ.
Thẻ:action_command_lines
--host_compilation_mode=<fastbuild, dbg or opt>
mặc định: "opt"-
Chỉ định chế độ mà các công cụ dùng trong quá trình xây dựng sẽ được tạo. Giá trị: "fastbuild", "dbg", "opt".
Thẻ:affects_outputs
,action_command_lines
--host_conlyopt=<a string>
nhiều lần sử dụng được tích luỹ- Tuỳ chọn bổ sung để truyền đến trình biên dịch C khi biên dịch tệp nguồn C (nhưng không phải C++) trong cấu hình thực thi.
Thẻ:action_command_lines
,affects_outputs
--host_copt=<a string>
nhiều lần sử dụng được tích luỹ-
Các tuỳ chọn bổ sung để chuyển đến trình biên dịch C cho các công cụ được tạo trong cấu hình thực thi.
Thẻ:action_command_lines
,affects_outputs
--host_cpu=<a string>
mặc định: ""-
CPU lưu trữ.
Thẻ:changes_inputs
,affects_outputs
--host_cxxopt=<a string>
nhiều lần sử dụng được tích luỹ-
Các tuỳ chọn bổ sung để truyền đến trình biên dịch C++ cho các công cụ được tạo trong cấu hình thực thi.
Thẻ:action_command_lines
,affects_outputs
--host_features=<a string>
nhiều lần sử dụng được tích luỹ- Theo mặc định, các tính năng đã cho sẽ được bật hoặc tắt đối với các mục tiêu được tạo trong cấu hình thực thi. Việc chỉ định -<feature> sẽ tắt tính năng đó. Các đặc điểm tiêu cực luôn ghi đè các đặc điểm tích cực.
Thẻ:changes_inputs
,affects_outputs
--host_force_python=<PY2 or PY3>
mặc định: xem nội dung mô tả- Ghi đè phiên bản Python cho cấu hình thực thi. Có thể là "PY2" hoặc "PY3".
Thẻ:loading_and_analysis
,affects_outputs
--host_linkopt=<a string>
nhiều lần sử dụng được tích luỹ-
Tuỳ chọn bổ sung để truyền đến trình liên kết khi liên kết các công cụ trong cấu hình thực thi.
Thẻ:action_command_lines
,affects_outputs
--host_macos_minimum_os=<a dotted version (for example '2.3' or '3.3alpha2.4')>
mặc định: xem nội dung mô tả-
Phiên bản macOS tương thích tối thiểu cho các mục tiêu lưu trữ. Nếu không chỉ định, hãy sử dụng "macos_sdk_version".
Thẻ:loses_incremental_state
--host_per_file_copt=<a comma-separated list of regex expressions with prefix '-' specifying excluded paths followed by an @ and a comma separated list of options>
nhiều lần sử dụng được tích luỹ-
Các tuỳ chọn bổ sung để truyền có chọn lọc đến trình biên dịch C/C++ khi biên dịch một số tệp nhất định trong cấu hình thực thi. Bạn có thể truyền tuỳ chọn này nhiều lần. Cú pháp: bộ_lọc_biểu_thức_định_liệu@tuỳ_chọn_1,tuỳ_chọn_2,...,tuỳ_chọn_n. Trong đó, regex_filter là danh sách các mẫu biểu thức chính quy bao gồm và loại trừ (Xem thêm --instrumentation_filter). option_1 đến option_n là các tuỳ chọn dòng lệnh tuỳ ý. Nếu một tuỳ chọn chứa dấu phẩy, thì bạn phải đặt tuỳ chọn đó trong dấu ngoặc kép có dấu gạch chéo ngược. Tuỳ chọn có thể chứa @. Chỉ @ đầu tiên mới được dùng để phân tách chuỗi. Ví dụ: --host_per_file_copt=//foo/.*\.cc,-//foo/bar\.cc@-O0 thêm tuỳ chọn dòng lệnh -O0 vào dòng lệnh gcc của tất cả tệp cc trong //foo/ ngoại trừ bar.cc.
Thẻ:action_command_lines
,affects_outputs
--host_swiftcopt=<a string>
nhiều lần sử dụng được tích luỹ-
Các tuỳ chọn bổ sung để truyền đến swiftc cho các công cụ thực thi.
Thẻ:action_command_lines
,affects_outputs
- Giá trị mặc định của
--[no]incompatible_auto_exec_groups
: "false" -
Khi được bật, một nhóm thực thi sẽ tự động được tạo cho mỗi chuỗi công cụ mà một quy tắc sử dụng. Để quy tắc này hoạt động, bạn cần chỉ định tham số "toolchain" (chuỗi công cụ) trên các hành động của quy tắc. Để biết thêm thông tin, hãy xem https://github.com/bazelbuild/bazel/issues/17134.
Thẻ:affects_outputs
,incompatible_change
- Giá trị mặc định của
--[no]incompatible_merge_genfiles_directory
: "true" - Nếu đúng, thư mục genfiles sẽ được gộp vào thư mục bin.
Thẻ:affects_outputs
,incompatible_change
- Giá trị mặc định của
--[no]incompatible_use_host_features
: "true" - Nếu đúng, hãy chỉ sử dụng --features cho cấu hình mục tiêu và --host_features cho cấu hình thực thi.
Thẻ:changes_inputs
,affects_outputs
,incompatible_change
- Giá trị mặc định của
--[no]instrument_test_targets
: "false" -
Khi bật mức độ sử dụng, hãy chỉ định xem có nên cân nhắc việc đo lường các quy tắc kiểm thử hay không. Khi được đặt, các quy tắc kiểm thử do --instrumentation_filter bao gồm sẽ được đo lường. Nếu không, các quy tắc kiểm thử sẽ luôn bị loại trừ khỏi hoạt động đo lường mức độ sử dụng.
Thẻ:affects_outputs
--instrumentation_filter=<a comma-separated list of regex expressions with prefix '-' specifying excluded paths>
mặc định: "-/javatests[/:],-/test/java[/:]"- Khi bạn bật tính năng mức độ sử dụng, chỉ những quy tắc có tên được bộ lọc dựa trên biểu thức chính quy chỉ định mới được đo lường. Thay vào đó, các quy tắc có tiền tố là "-" sẽ bị loại trừ. Xin lưu ý rằng chỉ các quy tắc không phải quy tắc kiểm thử mới được đo lường, trừ phi bạn bật --instrument_test_targets.
Thẻ:affects_outputs
--ios_minimum_os=<a dotted version (for example '2.3' or '3.3alpha2.4')>
mặc định: xem nội dung mô tả-
Phiên bản iOS tương thích tối thiểu cho trình mô phỏng và thiết bị mục tiêu. Nếu không chỉ định, hãy sử dụng "ios_sdk_version".
Thẻ:loses_incremental_state
--ios_multi_cpus=<comma-separated list of options>
nhiều lần sử dụng được tích luỹ-
Danh sách các cấu trúc được phân tách bằng dấu phẩy để tạo ios_application. Kết quả là một tệp nhị phân phổ quát chứa tất cả các cấu trúc đã chỉ định.
Thẻ:loses_incremental_state
,loading_and_analysis
- Giá trị mặc định của
--[no]legacy_whole_archive
: "true" -
Không dùng nữa, thay vào đó là --incompatible_remove_legacy_whole_archive (xem https://github.com/bazelbuild/bazel/issues/7362 để biết thông tin chi tiết). Khi bật, hãy sử dụng --whole-archive cho các quy tắc cc_binary có linkshared=True và linkstatic=True hoặc "-static" trong linkopts. Việc này chỉ nhằm mục đích tương thích ngược. Một cách thay thế tốt hơn là sử dụng alwayslink=1 khi cần.
Thẻ:action_command_lines
,affects_outputs
,deprecated
--linkopt=<a string>
nhiều lần sử dụng được tích luỹ- Tuỳ chọn bổ sung để truyền đến gcc khi liên kết.
Thẻ:action_command_lines
,affects_outputs
--ltobackendopt=<a string>
nhiều lần sử dụng được tích luỹ-
Tuỳ chọn bổ sung để chuyển đến bước phụ trợ LTO (trong --features=thin_lto).
Thẻ:action_command_lines
,affects_outputs
--ltoindexopt=<a string>
nhiều lần sử dụng được tích luỹ-
Tuỳ chọn bổ sung để chuyển đến bước lập chỉ mục LTO (trong --features=thin_lto).
Thẻ:action_command_lines
,affects_outputs
--macos_cpus=<comma-separated list of options>
nhiều lần sử dụng được tích luỹ-
Danh sách các cấu trúc được phân tách bằng dấu phẩy để tạo tệp nhị phân Apple macOS.
Thẻ:loses_incremental_state
,loading_and_analysis
--macos_minimum_os=<a dotted version (for example '2.3' or '3.3alpha2.4')>
mặc định: xem nội dung mô tả-
Phiên bản macOS tương thích tối thiểu cho các mục tiêu. Nếu không chỉ định, hãy sử dụng "macos_sdk_version".
Thẻ:loses_incremental_state
--memprof_profile=<a build target label>
mặc định: xem nội dung mô tả-
Sử dụng hồ sơ memprof.
Thẻ:affects_outputs
- Giá trị mặc định của
--[no]objc_debug_with_GLIBCXX
: "false" - Nếu bạn đặt và chế độ biên dịch được đặt thành "dbg", hãy xác định GLIBCXX_DEBUG, GLIBCXX_DEBUG_PEDANTIC và GLIBCPP_CONCEPT_CHECKS.
Thẻ:action_command_lines
- Giá trị mặc định của
--[no]objc_enable_binary_stripping
: "false" -
Liệu có thực hiện việc xoá ký hiệu và mã chết trên các tệp nhị phân được liên kết hay không. Thao tác loại bỏ tệp nhị phân sẽ được thực hiện nếu bạn chỉ định cả cờ này và --compilation_mode=opt.
Thẻ:action_command_lines
--objccopt=<a string>
nhiều lần sử dụng được tích luỹ-
Các tuỳ chọn bổ sung để truyền đến gcc khi biên dịch tệp nguồn Objective-C/C++.
Thẻ:action_command_lines
--per_file_copt=<a comma-separated list of regex expressions with prefix '-' specifying excluded paths followed by an @ and a comma separated list of options>
nhiều lần sử dụng được tích luỹ-
Các tuỳ chọn bổ sung để truyền có chọn lọc đến gcc khi biên dịch một số tệp nhất định. Bạn có thể truyền tuỳ chọn này nhiều lần. Cú pháp: bộ_lọc_biểu_thức_định_liệu@tuỳ_chọn_1,tuỳ_chọn_2,...,tuỳ_chọn_n. Trong đó, regex_filter là danh sách các mẫu biểu thức chính quy bao gồm và loại trừ (Xem thêm --instrumentation_filter). option_1 đến option_n là các tuỳ chọn dòng lệnh tuỳ ý. Nếu một tuỳ chọn chứa dấu phẩy, thì bạn phải đặt tuỳ chọn đó trong dấu ngoặc kép có dấu gạch chéo ngược. Tuỳ chọn có thể chứa @. Chỉ @ đầu tiên mới được dùng để phân tách chuỗi. Ví dụ: --per_file_copt=//foo/.*\.cc,-//foo/bar\.cc@-O0 thêm tuỳ chọn dòng lệnh -O0 vào dòng lệnh gcc của tất cả tệp cc trong //foo/ ngoại trừ bar.cc.
Thẻ:action_command_lines
,affects_outputs
--per_file_ltobackendopt=<a comma-separated list of regex expressions with prefix '-' specifying excluded paths followed by an @ and a comma separated list of options>
nhiều lần sử dụng được tích luỹ-
Các tuỳ chọn bổ sung để chuyển có chọn lọc đến phần phụ trợ LTO (trong --features=thin_lto) khi biên dịch một số đối tượng phụ trợ nhất định. Bạn có thể truyền tuỳ chọn này nhiều lần. Cú pháp: bộ_lọc_biểu_thức_định_liệu@tuỳ_chọn_1,tuỳ_chọn_2,...,tuỳ_chọn_n. Trong đó, regex_filter là danh sách các mẫu biểu thức chính quy bao gồm và loại trừ. option_1 đến option_n là các tuỳ chọn dòng lệnh tuỳ ý. Nếu một tuỳ chọn chứa dấu phẩy, thì bạn phải đặt tuỳ chọn đó trong dấu ngoặc kép có dấu gạch chéo ngược. Tuỳ chọn có thể chứa @. Chỉ @ đầu tiên mới được dùng để phân tách chuỗi. Ví dụ: --per_file_ltobackendopt=//foo/.*\.o,-//foo/bar\.o@-O0 sẽ thêm tuỳ chọn dòng lệnh -O0 vào dòng lệnh phụ trợ LTO của tất cả tệp o trong //foo/ ngoại trừ bar.o.
Thẻ:action_command_lines
,affects_outputs
--platform_suffix=<a string>
mặc định: xem nội dung mô tả- Chỉ định hậu tố cần thêm vào thư mục cấu hình.
Thẻ:loses_incremental_state
,affects_outputs
,loading_and_analysis
--propeller_optimize=<a build target label>
mặc định: xem nội dung mô tả-
Sử dụng thông tin hồ sơ Propeller để tối ưu hoá mục tiêu bản dựng.Hồ sơ Propeller phải bao gồm ít nhất một trong hai tệp, hồ sơ cc và hồ sơ ld. Cờ này chấp nhận nhãn bản dựng phải tham chiếu đến các tệp đầu vào của hồ sơ cánh quạt. Ví dụ: tệp BUILD xác định nhãn, trong a/b/BUILD:propeller_optimize( name = "propeller_profile", cc_profile = "propeller_cc_profile.txt", ld_profile = "propeller_ld_profile.txt",)Có thể bạn phải thêm một lệnh exports_files vào gói tương ứng để Bazel có thể thấy các tệp này. Bạn phải sử dụng tuỳ chọn này như sau: --propeller_optimize=//a/b:propeller_profile
Thẻ:action_command_lines
,affects_outputs
--propeller_optimize_absolute_cc_profile=<a string>
mặc định: xem nội dung mô tả- Tên đường dẫn tuyệt đối của tệp cc_profile cho các bản dựng được tối ưu hoá bằng Propeller.
Thẻ:affects_outputs
--propeller_optimize_absolute_ld_profile=<a string>
mặc định: xem nội dung mô tả- Tên đường dẫn tuyệt đối của tệp ld_profile cho các bản dựng được tối ưu hoá bằng Propeller.
Thẻ:affects_outputs
--run_under=<a prefix in front of command>
mặc định: xem nội dung mô tả-
Tiền tố để chèn trước các tệp thực thi cho lệnh "test" (kiểm thử) và "run" (chạy). Nếu giá trị là "foo -bar" và dòng lệnh thực thi là "test_binary -baz", thì dòng lệnh cuối cùng sẽ là "foo -bar test_binary -baz".Đây cũng có thể là nhãn cho một mục tiêu có thể thực thi. Một số ví dụ: "valgrind", "strace", "strace -c", "valgrind --quiet --num-callers=20", "//package:target", '//package:target --options'.
Thẻ:action_command_lines
- Nếu đúng, các thư viện gốc chứa chức năng giống hệt nhau sẽ được chia sẻ giữa các mục tiêu khác nhau
Thẻ
:loading_and_analysis
,affects_outputs
- Giá trị mặc định của
--[no]stamp
: "false" -
Đóng dấu tệp nhị phân bằng ngày, tên người dùng, tên máy chủ, thông tin về không gian làm việc, v.v.
Thẻ:affects_outputs
- Giá trị mặc định của
--strip=<always, sometimes or never>
: "đôi khi" - Chỉ định xem có xoá các tệp nhị phân và thư viện dùng chung hay không (sử dụng "-Wl,--strip-debug"). Giá trị mặc định là "sometimes" (đôi khi) có nghĩa là xoá nếu --compilation_mode=fastbuild.
Thẻ:affects_outputs
--stripopt=<a string>
nhiều lần sử dụng được tích luỹ-
Các tuỳ chọn bổ sung để truyền vào tính năng loại bỏ khi tạo tệp nhị phân "<name>.stripped".
Thẻ:action_command_lines
,affects_outputs
--swiftcopt=<a string>
nhiều lần sử dụng được tích luỹ-
Các tuỳ chọn bổ sung để truyền đến quá trình biên dịch Swift.
Thẻ:action_command_lines
--tvos_cpus=<comma-separated list of options>
nhiều lần sử dụng được tích luỹ-
Danh sách kiến trúc được phân tách bằng dấu phẩy để tạo tệp nhị phân Apple tvOS.
Thẻ:loses_incremental_state
,loading_and_analysis
--tvos_minimum_os=<a dotted version (for example '2.3' or '3.3alpha2.4')>
mặc định: xem nội dung mô tả-
Phiên bản tvOS tối thiểu tương thích cho trình mô phỏng và thiết bị mục tiêu. Nếu không chỉ định, hãy sử dụng "tvos_sdk_version".
Thẻ:loses_incremental_state
--visionos_cpus=<comma-separated list of options>
nhiều lần sử dụng được tích luỹ-
Danh sách kiến trúc được phân tách bằng dấu phẩy để tạo tệp nhị phân visionOS của Apple.
Thẻ:loses_incremental_state
,loading_and_analysis
--watchos_cpus=<comma-separated list of options>
nhiều lần sử dụng được tích luỹ-
Danh sách được phân tách bằng dấu phẩy gồm các cấu trúc để tạo tệp nhị phân Apple watchOS.
Thẻ:loses_incremental_state
,loading_and_analysis
--watchos_minimum_os=<a dotted version (for example '2.3' or '3.3alpha2.4')>
mặc định: xem nội dung mô tả- Phiên bản watchOS tối thiểu tương thích với trình mô phỏng và thiết bị mục tiêu. Nếu không chỉ định, hãy sử dụng "watchos_sdk_version".
Thẻ:loses_incremental_state
--xbinary_fdo=<a build target label>
mặc định: xem nội dung mô tả-
Sử dụng thông tin hồ sơ XbinaryFDO để tối ưu hoá quá trình biên dịch. Chỉ định tên của hồ sơ tệp nhị phân chéo mặc định. Khi tuỳ chọn này được sử dụng cùng với --fdo_instrument/--fdo_optimize/--fdo_profile, các tuỳ chọn đó sẽ luôn chiếm ưu thế như thể xbinary_fdo không bao giờ được chỉ định.
Thẻ:affects_outputs
- Các tuỳ chọn ảnh hưởng đến mức độ nghiêm ngặt mà Bazel thực thi các dữ liệu đầu vào bản dựng hợp lệ (xác định quy tắc, tổ hợp cờ, v.v.):
--auto_cpu_environment_group=<a build target label>
mặc định: ""- khai báo environment_group để sử dụng cho việc tự động liên kết các giá trị cpu với các giá trị target_environment.
Thẻ:changes_inputs
,loading_and_analysis
,experimental
- Giá trị mặc định của
--[no]check_licenses
: "false" -
Kiểm tra để đảm bảo các quy tắc hạn chế về giấy phép do các gói phụ thuộc áp đặt không xung đột với chế độ phân phối của các mục tiêu đang được tạo. Theo mặc định, giấy phép sẽ không được kiểm tra.
Thẻ:build_file_semantics
- Giá trị mặc định của
--[no]check_visibility
: "true" - Nếu bị tắt, các lỗi về chế độ hiển thị trong phần phụ thuộc mục tiêu sẽ bị hạ cấp thành cảnh báo.
Thẻ:build_file_semantics
- Giá trị mặc định của
--[no]desugar_for_android
: "true" -
Liệu có đơn giản hoá mã byte Java 8 trước khi tạo tệp dex hay không.
Thẻ:affects_outputs
,loading_and_analysis
,loses_incremental_state
- Giá trị mặc định của
--[no]desugar_java8_libs
: "false" -
Liệu có đưa các thư viện Java 8 được hỗ trợ vào ứng dụng cho các thiết bị cũ hay không.
Thẻ:affects_outputs
,loading_and_analysis
,loses_incremental_state
,experimental
- Giá trị mặc định của
--[no]enforce_constraints
: "true" -
Kiểm tra môi trường mà mỗi mục tiêu tương thích và báo cáo lỗi nếu có mục tiêu nào có các phần phụ thuộc không hỗ trợ cùng một môi trường
Thẻ:build_file_semantics
- Giá trị mặc định của
--[no]experimental_check_desugar_deps
: "true" -
Liệu có nên kiểm tra kỹ việc đơn giản hoá chính xác ở cấp tệp nhị phân Android hay không.
Thẻ:eagerness_to_exit
,loading_and_analysis
,experimental
- Giá trị mặc định của
--experimental_import_deps_checking=<off, warning or error>
: "OFF" -
Khi bật, hãy kiểm tra xem các phần phụ thuộc của aar_import đã hoàn tất hay chưa. Việc thực thi này có thể làm hỏng bản dựng hoặc chỉ dẫn đến cảnh báo.
Thẻ:loading_and_analysis
- Giá trị mặc định của
--experimental_one_version_enforcement=<off, warning or error>
: "OFF" -
Khi bật, hãy thực thi quy tắc java_binary không được chứa nhiều phiên bản của cùng một tệp lớp trên đường dẫn lớp. Việc thực thi này có thể làm hỏng bản dựng hoặc chỉ dẫn đến cảnh báo.
Thẻ:loading_and_analysis
- Giá trị mặc định của
--experimental_strict_java_deps=<off, warn, error, strict or default>
: "mặc định" - Nếu đúng, hãy kiểm tra để đảm bảo rằng một mục tiêu Java khai báo rõ ràng tất cả các mục tiêu được sử dụng trực tiếp dưới dạng phần phụ thuộc.
Thẻ:build_file_semantics
,eagerness_to_exit
- Giá trị mặc định của
--[no]incompatible_check_testonly_for_output_files
: "false" - Nếu được bật, hãy kiểm tra testonly cho các mục tiêu tiên quyết là tệp đầu ra bằng cách tra cứu testonly của quy tắc tạo. Điều này khớp với việc kiểm tra chế độ hiển thị.
Thẻ:build_file_semantics
,incompatible_change
- Giá trị mặc định của
--[no]incompatible_check_visibility_for_toolchains
: "false" - Nếu được bật, tính năng kiểm tra chế độ hiển thị cũng áp dụng cho việc triển khai chuỗi công cụ.
Thẻ:build_file_semantics
,incompatible_change
- Giá trị mặc định của
--[no]incompatible_disable_native_android_rules
: "false" - Nếu được bật, tính năng sử dụng trực tiếp các quy tắc Android gốc sẽ bị tắt. Vui lòng sử dụng các quy tắc Android Starlark từ https://github.com/bazelbuild/rules_android
Thẻ:eagerness_to_exit
,incompatible_change
- Giá trị mặc định của
--[no]incompatible_disable_native_apple_binary_rule
: "false" - Không hoạt động. Được giữ lại ở đây để tương thích ngược.
Thẻ:eagerness_to_exit
,incompatible_change
- Giá trị mặc định của
--[no]incompatible_python_disable_py2
: "true" - Nếu đúng, việc sử dụng chế độ cài đặt Python 2 sẽ gây ra lỗi. Bao gồm cả python_version=PY2, srcs_version=PY2 và srcs_version=PY2ONLY. Hãy xem https://github.com/bazelbuild/bazel/issues/15684 để biết thêm thông tin.
Thẻ:loading_and_analysis
,incompatible_change
- Giá trị mặc định của
--[no]incompatible_validate_top_level_header_inclusions
: "true" - Nếu đúng, Bazel cũng sẽ xác thực việc đưa tiêu đề thư mục cấp cao nhất vào (xem https://github.com/bazelbuild/bazel/issues/10047 để biết thêm thông tin).
Thẻ:loading_and_analysis
,incompatible_change
- Giá trị mặc định của
--[no]one_version_enforcement_on_java_tests
: "true" -
Khi được bật và experimental_one_version_enforcement được đặt thành một giá trị khác NONE, hãy thực thi một phiên bản trên các mục tiêu java_test. Bạn có thể tắt cờ này để cải thiện hiệu suất kiểm thử gia tăng nhưng sẽ bỏ lỡ các lỗi vi phạm tiềm ẩn về một phiên bản.
Thẻ:loading_and_analysis
--python_native_rules_allowlist=<a build target label>
mặc định: xem nội dung mô tả-
Danh sách cho phép (mục tiêu package_group) để sử dụng khi thực thi --incompatible_python_disallow_native_rules.
Thẻ:loading_and_analysis
- Giá trị mặc định của
--[no]strict_filesets
: "false" - Nếu bạn bật tuỳ chọn này, các tệp nhóm sẽ vượt quá giới hạn gói sẽ được báo cáo là lỗi.
Thẻ:build_file_semantics
,eagerness_to_exit
--strict_proto_deps=<off, warn, error, strict or default>
mặc định: "lỗi"- Nếu không tắt, hãy kiểm tra để đảm bảo rằng mục tiêu proto_library 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.
Thẻ:build_file_semantics
,eagerness_to_exit
,incompatible_change
--strict_public_imports=<off, warn, error, strict or default>
mặc định: "off"-
Trừ khi TẮT, hãy kiểm tra để đảm bảo rằng mục tiêu proto_library khai báo rõ ràng tất cả các mục tiêu được sử dụng trong "import public" là mục tiêu đã xuất.
Thẻ:build_file_semantics
,eagerness_to_exit
,incompatible_change
- Giá trị mặc định của
--[no]strict_system_includes
: "false" - Nếu là true, bạn cũng phải khai báo các tiêu đề tìm thấy thông qua hệ thống bao gồm các đường dẫn (-isystem).
Thẻ:loading_and_analysis
,eagerness_to_exit
--target_environment=<a build target label>
nhiều lần sử dụng được tích luỹ-
Khai báo môi trường mục tiêu của bản dựng này. Phải là tham chiếu nhãn đến quy tắc "môi trường". Nếu được chỉ định, tất cả mục tiêu cấp cao nhất phải tương thích với môi trường này.
Thẻ:changes_inputs
- Các tuỳ chọn ảnh hưởng đến kết quả ký của một bản dựng:
--apk_signing_method=<v1, v2, v1_v2 or v4>
mặc định: "v1_v2"-
Cách triển khai để ký tệp APK
Thẻ:action_command_lines
,affects_outputs
,loading_and_analysis
- Giá trị mặc định của
--[no]device_debug_entitlements
: "true" - Nếu bạn đặt và chế độ biên dịch không phải là "opt", thì các ứng dụng objc sẽ bao gồm các quyền gỡ lỗi khi ký.
Thẻ:changes_inputs
--ios_signing_cert_name=<a string>
mặc định: xem nội dung mô tả- Tên chứng chỉ dùng để ký ứng dụng iOS. Nếu không được đặt, hệ thống sẽ quay lại sử dụng hồ sơ cấp phép. Có thể là lựa chọn ưu tiên về danh tính chuỗi khoá của chứng chỉ hoặc (chuỗi con) của tên chung của chứng chỉ, theo trang man của codesign (SIGNING IDENTITIES).
Thẻ:action_command_lines
- Tuỳ chọn này ảnh hưởng đến ngữ nghĩa của ngôn ngữ Starlark hoặc API bản dựng mà các tệp BUILD, tệp .bzl hoặc tệp WORKSPACE có thể truy cập.:
- Giá trị mặc định của
--[no]incompatible_config_setting_private_default_visibility
: "false" - Nếu incompatible_enforce_config_setting_visibility=false, thì đây là một thao tác không có tác dụng. Nếu không, nếu cờ này là false, mọi config_setting không có thuộc tính chế độ hiển thị rõ ràng sẽ là //visibility:public. Nếu cờ này là true, config_setting sẽ tuân theo logic hiển thị giống như tất cả các quy tắc khác. Xem https://github.com/bazelbuild/bazel/issues/12933.
Thẻ:loading_and_analysis
,incompatible_change
- Giá trị mặc định của
--[no]incompatible_disallow_legacy_py_provider
: "true" - Không hoạt động, sẽ sớm bị xoá.
Thẻ:loading_and_analysis
,incompatible_change
- Giá trị mặc định của
--[no]incompatible_disallow_sdk_frameworks_attributes
: "false" - Nếu đúng, không cho phép các thuộc tính sdk_frameworks và weak_sdk_frameworks trong objc_library và objc_import.
Thẻ:build_file_semantics
,incompatible_change
- Giá trị mặc định của
--[no]incompatible_enforce_config_setting_visibility
: "true" - Nếu đúng, hãy thực thi các quy định hạn chế về chế độ hiển thị config_setting. Nếu giá trị là false, mọi mục config_setting đều hiển thị với mọi mục tiêu. Xem https://github.com/bazelbuild/bazel/issues/12932.
Thẻ:loading_and_analysis
,incompatible_change
- Giá trị mặc định của
--[no]incompatible_objc_alwayslink_by_default
: "false" - Nếu đúng, hãy đặt giá trị mặc định thành đúng cho các thuộc tính alwayslink trong objc_library và objc_import.
Thẻ:build_file_semantics
,incompatible_change
- Giá trị mặc định của
--[no]incompatible_python_disallow_native_rules
: "false" -
Khi giá trị là true, lỗi sẽ xảy ra khi sử dụng các quy tắc py_* tích hợp; thay vào đó, bạn nên sử dụng các quy tắc rule_python. Hãy xem https://github.com/bazelbuild/bazel/issues/17773 để biết thêm thông tin và hướng dẫn di chuyển.
Thẻ:loading_and_analysis
,incompatible_change
- Các tuỳ chọn điều chỉnh hành vi của môi trường kiểm thử hoặc trình chạy kiểm thử:
- Giá trị mặc định của
--[no]allow_analysis_failures
: "false" - Nếu đúng, lỗi phân tích của một mục tiêu quy tắc sẽ dẫn đến việc mục tiêu truyền một thực thể của AnalysisFailureInfo chứa nội dung mô tả lỗi, thay vì dẫn đến lỗi bản dựng.
Thẻ:loading_and_analysis
,experimental
- Giá trị mặc định của
--analysis_testing_deps_limit=<an integer>
: "2000" -
Đặt số lượng phần phụ thuộc bắc cầu tối đa thông qua một thuộc tính quy tắc có chuyển đổi cấu hình for_analysis_testing. Nếu vượt quá giới hạn này, bạn sẽ gặp lỗi quy tắc.
Thẻ:loading_and_analysis
- Giá trị mặc định của
--[no]break_build_on_parallel_dex2oat_failure
: "false" - Nếu lỗi thao tác dex2oat là đúng thì bản dựng sẽ bị lỗi thay vì thực thi dex2oat trong thời gian chạy kiểm thử.
Thẻ:loading_and_analysis
,experimental
--default_test_resources=<a resource name followed by equal and 1 float or 4 float, e.g. memory=10,30,60,100>
nhiều lần sử dụng được tích luỹ- Ghi đè số lượng tài nguyên mặc định cho các chương trình kiểm thử. Định dạng dự kiến là <tài nguyên>=<giá trị>. Nếu một số dương duy nhất được chỉ định là <giá trị>, thì số này sẽ ghi đè các tài nguyên mặc định cho tất cả kích thước kiểm thử. Nếu bạn chỉ định 4 số được phân tách bằng dấu phẩy, thì các số này sẽ ghi đè lượng tài nguyên tương ứng cho các kích thước kiểm thử nhỏ, trung bình, lớn, rất lớn. Giá trị cũng có thể là HOST_RAM/HOST_CPU, theo sau là [-|*]<float> (ví dụ: memory=HOST_RAM*.1,HOST_RAM*.2,HOST_RAM*.3,HOST_RAM*.4). Tài nguyên kiểm thử mặc định do cờ này chỉ định sẽ bị ghi đè bởi tài nguyên rõ ràng được chỉ định trong thẻ.
- Giá trị mặc định của
--[no]experimental_android_use_parallel_dex2oat
: "false" -
Sử dụng dex2oat song song để có thể tăng tốc android_test.
Thẻ:loading_and_analysis
,host_machine_resource_optimizations
,experimental
- Giá trị mặc định của
--[no]ios_memleaks
: "false" -
Bật tính năng kiểm tra rò rỉ bộ nhớ trong các mục tiêu ios_test.
Thẻ:action_command_lines
--ios_simulator_device=<a string>
mặc định: xem nội dung mô tả-
Thiết bị để mô phỏng khi chạy ứng dụng iOS trong trình mô phỏng, ví dụ: "iPhone 6". Bạn có thể lấy danh sách thiết bị bằng cách chạy lệnh "xcrun simctl list devicetypes" trên máy mà trình mô phỏng sẽ chạy.
Thẻ:test_runner
--ios_simulator_version=<a dotted version (for example '2.3' or '3.3alpha2.4')>
mặc định: xem nội dung mô tả-
Phiên bản iOS để chạy trên trình mô phỏng khi chạy hoặc kiểm thử. Quy tắc này sẽ bị bỏ qua đối với các quy tắc ios_test nếu bạn chỉ định một thiết bị mục tiêu trong quy tắc.
Thẻ:test_runner
--runs_per_test=<a positive integer or test_regex@runs. This flag may be passed more than once>
nhiều lần sử dụng được tích luỹ- Chỉ định số lần chạy mỗi chương trình kiểm thử. Nếu bất kỳ lần thử nào trong số đó không thành công vì bất kỳ lý do gì, thì toàn bộ kiểm thử sẽ được coi là không thành công. Thông thường, giá trị được chỉ định chỉ là một số nguyên. Ví dụ: --runs_per_test=3 sẽ chạy tất cả các bài kiểm thử 3 lần. Cú pháp thay thế: bộ_lọc_biểu_thức_tìm_kiếm@số_lần_chạy_mỗi_bài_kiểm_ thử. Trong đó, runs_per_test là một giá trị số nguyên và regex_filter là danh sách các mẫu biểu thức chính quy bao gồm và loại trừ (Xem thêm --instrumentation_filter). Ví dụ: --runs_per_test=//foo/.*,-//foo/bar/.*@3 chạy tất cả các bài kiểm thử trong //foo/ ngoại trừ các bài kiểm thử trong foo/bar ba lần. Bạn có thể truyền tuỳ chọn này nhiều lần. Đối số khớp được truyền gần đây nhất sẽ được ưu tiên. Nếu không có kết quả nào khớp, thì quy trình kiểm thử sẽ chỉ chạy một lần.
--test_env=<a 'name=value' assignment with an optional value part>
nhiều lần sử dụng được tích luỹ- Chỉ định các biến môi trường bổ sung sẽ được chèn vào môi trường trình chạy kiểm thử. Bạn có thể chỉ định biến theo tên, trong trường hợp này, giá trị của biến sẽ được đọc từ môi trường ứng dụng Bazel hoặc theo cặp name=value. Bạn có thể sử dụng tuỳ chọn này nhiều lần để chỉ định một số biến. Chỉ được lệnh "bazel test" sử dụng.
Thẻ:test_runner
--test_timeout=<a single integer or comma-separated list of 4 integers>
mặc định: "-1"- Ghi đè các giá trị thời gian chờ kiểm thử mặc định cho thời gian chờ kiểm thử (tính bằng giây). Nếu bạn chỉ định một giá trị số nguyên dương, thì giá trị đó sẽ ghi đè tất cả các danh mục. Nếu bạn chỉ định 4 số nguyên được phân tách bằng dấu phẩy, thì các số này sẽ ghi đè thời gian chờ cho thời gian ngắn, trung bình, dài và vĩnh viễn (theo thứ tự đó). Trong cả hai hình thức, giá trị -1 sẽ yêu cầu blaze sử dụng thời gian chờ mặc định cho danh mục đó.
- Giá trị mặc định của
--[no]zip_undeclared_test_outputs
: "true" - Nếu đúng, các kết quả kiểm thử chưa khai báo sẽ được lưu trữ trong một tệp zip.
Thẻ:test_runner
- Các tuỳ chọn liên quan đến đầu ra và ngữ nghĩa của Bzlmod:
--repo=<a string>
nhiều lần sử dụng được tích luỹ-
Chỉ nhà cung cấp kho lưu trữ được chỉ định, có thể là `@apparent_repo_name` hoặc `@@canonical_repo_name`. Bạn có thể đặt tuỳ chọn này nhiều lần
Thẻ:changes_inputs
- Các tuỳ chọn kích hoạt tính năng tối ưu hoá thời gian xây dựng:
- Giá trị mặc định của
--[no]experimental_filter_library_jar_with_program_jar
: "false" -
Lọc ProGuard ProgramJar để xoá mọi lớp cũng có trong LibraryJar.
Thẻ:action_command_lines
- Giá trị mặc định của
--[no]experimental_inmemory_dotd_files
: "true" - Nếu được bật, các tệp .d C++ sẽ được truyền trực tiếp trong bộ nhớ từ các nút bản dựng từ xa thay vì được ghi vào ổ đĩa.
Thẻ:loading_and_analysis
,execution
,affects_outputs
,experimental
- Giá trị mặc định của
--[no]experimental_inmemory_jdeps_files
: "true" - Nếu được bật, các tệp phần phụ thuộc (.jdeps) được tạo từ các bản biên dịch Java sẽ được truyền trực tiếp trong bộ nhớ từ các nút bản dựng từ xa thay vì được ghi vào ổ đĩa.
Thẻ:loading_and_analysis
,execution
,affects_outputs
,experimental
- Giá trị mặc định của
--[no]experimental_objc_include_scanning
: "false" -
Liệu có thực hiện việc quét tìm C/C++ khách quan hay không.
Thẻ:loading_and_analysis
,execution
,changes_inputs
- Giá trị mặc định của
--[no]experimental_retain_test_configuration_across_testonly
: "false" -
Khi được bật, --trim_test_configuration sẽ không cắt bớt cấu hình kiểm thử cho các quy tắc được đánh dấu testonly=1. Điều này nhằm giảm các vấn đề xung đột hành động khi các quy tắc không phải quy tắc kiểm thử phụ thuộc vào quy tắc cc_test. Không có hiệu lực nếu --trim_test_configuration là false.
Thẻ:loading_and_analysis
,loses_incremental_state
- Giá trị mặc định của
--[no]experimental_starlark_cc_import
: "false" - Nếu được bật, bạn có thể sử dụng phiên bản Starlark của cc_import.
Thẻ:loading_and_analysis
,experimental
- Giá trị mặc định của
--[no]experimental_unsupported_and_brittle_include_scanning
: "false" -
Liệu có thu hẹp dữ liệu đầu vào cho quá trình biên dịch C/C++ bằng cách phân tích cú pháp các dòng #include từ tệp đầu vào hay không. Điều này có thể cải thiện hiệu suất và tính tăng dần bằng cách giảm kích thước của cây đầu vào biên dịch. Tuy nhiên, việc này cũng có thể làm hỏng các bản dựng vì trình quét bao gồm không triển khai đầy đủ ngữ nghĩa của trình xử lý trước C. Cụ thể, trình biên dịch này không hiểu các lệnh #include động và bỏ qua logic có điều kiện của trình xử lý trước. Bạn tự chịu rủi ro khi sử dụng. Mọi vấn đề liên quan đến cờ này đều sẽ bị đóng.
Thẻ:loading_and_analysis
,execution
,changes_inputs
- Giá trị mặc định của
--[no]incremental_dexing
: "true" -
Thực hiện hầu hết công việc tạo tệp DEX riêng cho từng tệp Jar.
Thẻ:affects_outputs
,loading_and_analysis
,loses_incremental_state
- Giá trị mặc định của
--[no]objc_use_dotd_pruning
: "true" - Nếu được đặt, các tệp .d do clang phát ra sẽ được dùng để cắt bớt tập hợp đầu vào được truyền vào các bản biên dịch objc.
Thẻ:changes_inputs
,loading_and_analysis
- Giá trị mặc định của
--[no]process_headers_in_dependencies
: "false" -
Khi tạo một mục tiêu //a:a, hãy xử lý các tiêu đề trong tất cả các mục tiêu mà //a:a phụ thuộc vào (nếu bạn bật tính năng xử lý tiêu đề cho chuỗi công cụ).
Thẻ:execution
- Giá trị mặc định của
--[no]trim_test_configuration
: "true" -
Khi được bật, các tuỳ chọn liên quan đến kiểm thử sẽ bị xoá bên dưới cấp cao nhất của bản dựng. Khi cờ này đang hoạt động, bạn không thể tạo kiểm thử dưới dạng phần phụ thuộc của các quy tắc không phải kiểm thử, nhưng các thay đổi đối với các tuỳ chọn liên quan đến kiểm thử sẽ không khiến các quy tắc không phải kiểm thử được phân tích lại.
Thẻ
:loading_and_analysis
,loses_incremental_state
- Các tuỳ chọn ảnh hưởng đến mức độ chi tiết, định dạng hoặc vị trí ghi nhật ký:
--toolchain_resolution_debug=<a comma-separated list of regex expressions with prefix '-' specifying excluded paths>
mặc định: "-.*"-
In thông tin gỡ lỗi trong quá trình phân giải chuỗi công cụ. Cờ này lấy một biểu thức chính quy, được kiểm tra dựa trên các loại chuỗi công cụ và mục tiêu cụ thể để xem cần gỡ lỗi mục nào. Bạn có thể phân tách nhiều biểu thức chính quy bằng dấu phẩy, sau đó mỗi biểu thức chính quy sẽ được kiểm tra riêng. Lưu ý: Kết quả của cờ này rất phức tạp và có thể chỉ hữu ích cho các chuyên gia về độ phân giải chuỗi công cụ.
Thẻ:terminal_output
- Các tuỳ chọn chỉ định hoặc thay đổi dữ liệu đầu vào chung cho một lệnh Bazel không thuộc các danh mục khác.:
--flag_alias=<a 'name=value' flag alias>
nhiều lần sử dụng được tích luỹ-
Đặt tên viết tắt cho cờ Starlark. Hàm này nhận một cặp khoá-giá trị duy nhất ở dạng "<khoá>=<giá trị>" làm đối số.
Thẻ:changes_inputs
- Giá trị mặc định của
--[no]incompatible_default_to_explicit_init_py
: "false" -
Cờ này thay đổi hành vi mặc định để các tệp __init__.py không còn được tạo tự động trong các tệp chạy của mục tiêu Python. Chính xác là khi mục tiêu py_binary hoặc py_test có legacy_create_init được đặt thành "tự động" (mặc định), mục tiêu đó được coi là sai nếu và chỉ khi bạn đặt cờ này. Xem https://github.com/bazelbuild/bazel/issues/10076.
Thẻ:affects_outputs
,incompatible_change
- Giá trị mặc định của
--[no]incompatible_py2_outputs_are_suffixed
: "true" - Nếu đúng, các mục tiêu được tạo trong cấu hình Python 2 sẽ xuất hiện trong thư mục gốc đầu ra có hậu tố "-py2", trong khi các mục tiêu được tạo cho Python 3 sẽ xuất hiện trong thư mục gốc không có hậu tố liên quan đến Python. Điều này có nghĩa là đường liên kết tượng trưng thuận tiện `bazel-bin` sẽ trỏ đến các mục tiêu Python 3 thay vì Python 2. Nếu bật tuỳ chọn này, bạn cũng nên bật `--incompatible_py3_is_default`.
Thẻ:affects_outputs
,incompatible_change
- Giá trị mặc định của
--[no]incompatible_py3_is_default
: "true" - Nếu đúng, các mục tiêu `py_binary` và `py_test` không đặt thuộc tính `python_version` (hoặc `default_python_version`) sẽ mặc định là PY3 thay vì PY2. Nếu đặt cờ này, bạn cũng nên đặt `--incompatible_py2_outputs_are_suffixed`.
Thẻ
:loading_and_analysis
,affects_outputs
,incompatible_change
- Giá trị mặc định của
--[no]incompatible_use_python_toolchains
: "true" - Nếu bạn đặt thành true, các quy tắc Python gốc có thể thực thi sẽ sử dụng môi trường thời gian chạy Python do chuỗi công cụ Python chỉ định, thay vì môi trường thời gian chạy do các cờ cũ như --python_top cung cấp.
Thẻ:loading_and_analysis
,incompatible_change
--python_version=<PY2 or PY3>
mặc định: xem nội dung mô tả-
Chế độ phiên bản chính của Python, "PY2" hoặc "PY3". Xin lưu ý rằng chế độ này sẽ bị ghi đè bởi các mục tiêu "py_binary" và "py_test" (ngay cả khi các mục tiêu này không chỉ định rõ ràng một phiên bản), vì vậy, thường không có lý do gì để cung cấp cờ này.
Thẻ:loading_and_analysis
,affects_outputs
- Các tuỳ chọn khác, không được phân loại.:
--[no]cache_test_results
[-t
] mặc định: "tự động"- Nếu được đặt thành "tự động", Bazel sẽ chạy lại một kiểm thử nếu và chỉ khi: (1) Bazel phát hiện thấy các thay đổi trong kiểm thử hoặc các phần phụ thuộc của kiểm thử, (2) kiểm thử được đánh dấu là bên ngoài, (3) nhiều lần chạy kiểm thử được yêu cầu bằng --runs_per_test hoặc(4) kiểm thử trước đó không thành công. Nếu được đặt thành "yes" (có), Bazel sẽ lưu tất cả kết quả kiểm thử vào bộ nhớ đệm, ngoại trừ các kiểm thử được đánh dấu là bên ngoài. Nếu bạn đặt thành "no" (không), Bazel sẽ không lưu kết quả kiểm thử vào bộ nhớ đệm.
--deleted_packages=<comma-separated list of package names>
nhiều lần sử dụng được tích luỹ- Danh sách tên gói được phân tách bằng dấu phẩy mà hệ thống xây dựng sẽ coi là không tồn tại, ngay cả khi các gói đó xuất hiện ở đâu đó trên đường dẫn gói. Sử dụng tuỳ chọn này khi xoá một gói con "x/y" của một gói hiện có "x". Ví dụ: sau khi xoá x/y/BUILD trong ứng dụng, hệ thống xây dựng có thể khiếu nại nếu gặp nhãn "//x:y/z" nếu nhãn đó vẫn được cung cấp bởi một mục package_path khác. Bạn có thể chỉ định --deleted_packages x/y để tránh vấn đề này.
- Giá trị mặc định của
--[no]experimental_cancel_concurrent_tests
: "false" - Nếu đúng, Blaze sẽ huỷ các chương trình kiểm thử đang chạy đồng thời trong lần chạy thành công đầu tiên. Điều này chỉ hữu ích khi kết hợp với --runs_per_test_detects_flakes.
Thẻ:affects_outputs
,loading_and_analysis
- Giá trị mặc định của
--[no]experimental_fetch_all_coverage_outputs
: "false" - Nếu đúng, thì Bazel sẽ tìm nạp toàn bộ thư mục dữ liệu mức độ sử dụng cho mỗi lần kiểm thử trong một lần chạy mức độ sử dụng.
Thẻ:affects_outputs
,loading_and_analysis
- Giá trị mặc định của
--[no]experimental_generate_llvm_lcov
: "false" - Nếu đúng, mức độ sử dụng cho clang sẽ tạo ra một báo cáo LCOV.
Thẻ:affects_outputs
,loading_and_analysis
- Giá trị mặc định của
--[no]experimental_j2objc_header_map
: "true" - Liệu có tạo bản đồ tiêu đề J2ObjC song song với quá trình biên dịch chuyển đổi J2ObjC hay không.
- Giá trị mặc định của
--[no]experimental_j2objc_shorter_header_path
: "false" -
Liệu có tạo bằng đường dẫn tiêu đề ngắn hơn hay không (sử dụng "_ios" thay vì "_j2objc").
Thẻ:affects_outputs
--experimental_java_classpath=<off, javabuilder or bazel>
mặc định: "javabuilder"- Bật các đường dẫn lớp rút gọn cho các bản biên dịch Java.
- Giá trị mặc định của
--[no]experimental_limit_android_lint_to_android_constrained_java
: "false" -
Giới hạn --experimental_run_android_lint_on_java_rules ở các thư viện tương thích với Android.
Thẻ:affects_outputs
- Giá trị mặc định của
--[no]experimental_run_android_lint_on_java_rules
: "false" -
Liệu có xác thực các nguồn java_* hay không.
Thẻ:affects_outputs
- Giá trị mặc định của
--[no]explicit_java_test_deps
: "false" - Chỉ định rõ ràng phần phụ thuộc cho JUnit hoặc Hamcrest trong java_test thay vì vô tình lấy từ phần phụ thuộc của TestRunner. Hiện chỉ hoạt động cho bazel.
- Giá trị mặc định của
--[no]fetch
: "true" - Cho phép lệnh tìm nạp các phần phụ thuộc bên ngoài. Nếu bạn đặt thành false, lệnh sẽ sử dụng bất kỳ phiên bản nào của phần phụ thuộc được lưu vào bộ nhớ đệm và nếu không có phiên bản nào, lệnh sẽ không thành công.
--host_java_launcher=<a build target label>
mặc định: xem nội dung mô tả- Trình chạy Java mà các công cụ thực thi trong quá trình tạo bản dựng sử dụng.
--host_javacopt=<a string>
nhiều lần sử dụng được tích luỹ- Các tuỳ chọn bổ sung để truyền vào javac khi tạo các công cụ được thực thi trong quá trình tạo bản dựng.
--host_jvmopt=<a string>
nhiều lần sử dụng được tích luỹ- Các tuỳ chọn bổ sung để truyền đến máy ảo Java khi tạo các công cụ được thực thi trong quá trình xây dựng. Các tuỳ chọn này sẽ được thêm vào tuỳ chọn khởi động máy ảo của mỗi mục tiêu java_binary.
- Giá trị mặc định của
--[no]incompatible_check_sharding_support
: "true" - Nếu giá trị là true, Bazel sẽ không kiểm thử được nếu trình chạy kiểm thử không cho biết rằng nó hỗ trợ phân đoạn bằng cách chạm vào tệp tại đường dẫn trong TEST_SHARD_STATUS_FILE. Nếu giá trị là false, trình chạy kiểm thử không hỗ trợ phân đoạn sẽ dẫn đến tất cả các kiểm thử chạy trong mỗi phân đoạn.
Thẻ:incompatible_change
- Giá trị mặc định của
--[no]incompatible_exclusive_test_sandboxed
: "true" - Nếu đúng, các thử nghiệm độc quyền sẽ chạy bằng chiến lược hộp cát. Thêm thẻ "local" để buộc chạy một kiểm thử độc quyền trên máy
Thẻ:incompatible_change
- Giá trị mặc định của
--[no]incompatible_strict_action_env
: "false" - Nếu đúng, Bazel sẽ sử dụng một môi trường có giá trị tĩnh cho PATH và không kế thừa LD_LIBRARY_PATH. Sử dụng --action_env=ENV_VARIABLE nếu bạn muốn kế thừa các biến môi trường cụ thể từ ứng dụng, nhưng lưu ý rằng việc này có thể ngăn việc lưu vào bộ nhớ đệm trên nhiều người dùng nếu bạn sử dụng bộ nhớ đệm dùng chung.
Thẻ:loading_and_analysis
,incompatible_change
--j2objc_translation_flags=<comma-separated list of options>
nhiều lần sử dụng được tích luỹ- Các tuỳ chọn bổ sung để truyền đến công cụ J2ObjC.
--java_debug
-
Khiến máy ảo Java của một kiểm thử java chờ kết nối từ trình gỡ lỗi tuân thủ JDWP (chẳng hạn như jdb) trước khi bắt đầu kiểm thử. Ngụ ý -test_output=streamed.
Mở rộng thành:
--test_arg=--wrapper_script_flag=--debug
--test_output=streamed
--test_strategy=exclusive
--test_timeout=9999
--nocache_test_results
- Giá trị mặc định của
--[no]java_deps
: "true" - Tạo thông tin phần phụ thuộc (hiện tại là đường dẫn lớp thời gian biên dịch) cho mỗi mục tiêu Java.
- Giá trị mặc định của
--[no]java_header_compilation
: "true" - Biên dịch ijar trực tiếp từ nguồn.
--java_language_version=<a string>
mặc định: ""- Phiên bản ngôn ngữ Java
--java_launcher=<a build target label>
mặc định: xem nội dung mô tả- Trình chạy Java để sử dụng khi tạo tệp nhị phân Java. Nếu bạn đặt cờ này thành chuỗi trống, trình chạy JDK sẽ được sử dụng. Thuộc tính "launcher" (trình chạy) sẽ ghi đè cờ này.
--java_runtime_version=<a string>
mặc định: "local_jdk"- Phiên bản môi trường thời gian chạy Java
--javacopt=<a string>
nhiều lần sử dụng được tích luỹ- Các tuỳ chọn bổ sung để truyền đến javac.
--jvmopt=<a string>
nhiều lần sử dụng được tích luỹ- Các tuỳ chọn bổ sung để truyền đến máy ảo Java. Các tuỳ chọn này sẽ được thêm vào tuỳ chọn khởi động máy ảo của mỗi mục tiêu java_binary.
--legacy_main_dex_list_generator=<a build target label>
mặc định: xem nội dung mô tả- Chỉ định một tệp nhị phân để sử dụng nhằm tạo danh sách các lớp phải có trong dex chính khi biên dịch multidex cũ.
--optimizing_dexer=<a build target label>
mặc định: xem nội dung mô tả- Chỉ định một tệp nhị phân để sử dụng cho việc tạo tệp dex mà không phân đoạn.
--package_path=<colon-separated list of options>
mặc định: "%workspace%"- Danh sách được phân tách bằng dấu hai chấm về nơi tìm kiếm các gói. Các phần tử bắt đầu bằng "%workspace%" có liên quan đến không gian làm việc bao quanh. Nếu bạn bỏ qua hoặc để trống, giá trị mặc định sẽ là kết quả của lệnh "bazel info default-package-path".
--plugin=<a build target label>
nhiều lần sử dụng được tích luỹ- Trình bổ trợ để sử dụng trong bản dựng. Hiện hoạt động với java_plugin.
--proguard_top=<a build target label>
mặc định: xem nội dung mô tả- Chỉ định phiên bản ProGuard sẽ dùng để xoá mã khi tạo tệp nhị phân Java.
--proto_compiler=<a build target label>
mặc định: "@bazel_tools//tools/proto:protoc"-
Nhãn của trình biên dịch proto.
Thẻ:affects_outputs
,loading_and_analysis
--proto_toolchain_for_cc=<a build target label>
mặc định: "@bazel_tools//tools/proto:cc_toolchain"-
Nhãn của proto_lang_toolchain() mô tả cách biên dịch proto C++
Thẻ:affects_outputs
,loading_and_analysis
--proto_toolchain_for_j2objc=<a build target label>
mặc định: "@bazel_tools//tools/j2objc:j2objc_proto_toolchain"-
Nhãn của proto_lang_toolchain() mô tả cách biên dịch proto j2objc
Thẻ:affects_outputs
,loading_and_analysis
--proto_toolchain_for_java=<a build target label>
mặc định: "@bazel_tools//tools/proto:java_toolchain"-
Nhãn của proto_lang_toolchain() mô tả cách biên dịch proto Java
Thẻ:affects_outputs
,loading_and_analysis
--proto_toolchain_for_javalite=<a build target label>
mặc định: "@bazel_tools//tools/proto:javalite_toolchain"-
Nhãn của proto_lang_toolchain() mô tả cách biên dịch proto JavaLite
Thẻ:affects_outputs
,loading_and_analysis
--protocopt=<a string>
nhiều lần sử dụng được tích luỹ-
Các tuỳ chọn bổ sung để truyền đến trình biên dịch protobuf.
Thẻ:affects_outputs
- Giá trị mặc định của
--[no]runs_per_test_detects_flakes
: "false" - Nếu đúng, mọi phân mảnh có ít nhất một lần chạy/thử nghiệm thành công và ít nhất một lần chạy/thử nghiệm không thành công sẽ có trạng thái FLAKY.
--shell_executable=<a path>
mặc định: xem nội dung mô tả-
Đường dẫn tuyệt đối đến tệp thực thi shell để Bazel sử dụng. Nếu bạn không đặt biến này nhưng đặt biến môi trường BAZEL_SH trong lệnh gọi Bazel đầu tiên (lệnh gọi này sẽ khởi động máy chủ Bazel), thì Bazel sẽ sử dụng biến đó. Nếu bạn không đặt cả hai, Bazel sẽ sử dụng đường dẫn mặc định được mã hoá cứng tuỳ thuộc vào hệ điều hành mà nó chạy (Windows: c:/tools/msys64/usr/bin/bash.exe, FreeBSD: /usr/local/bin/bash, tất cả các hệ điều hành khác: /bin/bash). Xin lưu ý rằng việc sử dụng một shell không tương thích với bash có thể dẫn đến lỗi bản dựng hoặc lỗi thời gian chạy của các tệp nhị phân được tạo.
Thẻ:loading_and_analysis
- Giá trị mặc định của
--[no]show_loading_progress
: "true" - Nếu được bật, sẽ khiến Bazel in thông báo "Loading package" ("Đang tải gói").
--test_arg=<a string>
nhiều lần sử dụng được tích luỹ- Chỉ định các tuỳ chọn và đối số bổ sung cần được truyền đến tệp thực thi kiểm thử. Có thể sử dụng nhiều lần để chỉ định một số đối số. Nếu nhiều chương trình kiểm thử được thực thi, thì mỗi chương trình kiểm thử sẽ nhận được các đối số giống hệt nhau. Chỉ được lệnh "bazel test" sử dụng.
--test_filter=<a string>
mặc định: xem nội dung mô tả- Chỉ định một bộ lọc để chuyển tiếp đến khung kiểm thử. Dùng để giới hạn số lượng kiểm thử được chạy. Xin lưu ý rằng điều này không ảnh hưởng đến việc xây dựng mục tiêu nào.
--test_result_expiration=<an integer>
mặc định: "-1"- Tuỳ chọn này không được dùng nữa và không có hiệu lực.
- Giá trị mặc định của
--[no]test_runner_fail_fast
: "false" - Chuyển tiếp tuỳ chọn thất bại nhanh đến trình chạy kiểm thử. Trình chạy kiểm thử sẽ dừng thực thi khi gặp lỗi đầu tiên.
--test_sharding_strategy=<explicit, disabled or forced=k where k is the number of shards to enforce>
mặc định: "explicit"- Chỉ định chiến lược phân đoạn kiểm thử: "rõ ràng" để chỉ sử dụng phân đoạn nếu có thuộc tính BUILD "shard_count". "disabled" để không bao giờ sử dụng tính năng phân đoạn kiểm thử. "forced=k" để thực thi các phân đoạn "k" cho hoạt động kiểm thử bất kể thuộc tính BUILD "shard_count".
--tool_java_language_version=<a string>
mặc định: ""- Phiên bản ngôn ngữ Java dùng để thực thi các công cụ cần thiết trong quá trình tạo bản dựng
--tool_java_runtime_version=<a string>
mặc định: "remotejdk_11"- Phiên bản thời gian chạy Java dùng để thực thi các công cụ trong quá trình tạo bản dựng
- Giá trị mặc định của
--[no]use_ijars
: "true" - Nếu được bật, tuỳ chọn này sẽ khiến quá trình biên dịch Java sử dụng các tệp jar giao diện. Điều này sẽ giúp quá trình biên dịch tăng dần diễn ra nhanh hơn, nhưng thông báo lỗi có thể khác.
Tuỳ chọn phiên bản
- Các tuỳ chọn xuất hiện trước lệnh và được máy khách phân tích cú pháp:
--distdir=<a path>
nhiều lần sử dụng được tích luỹ-
Các vị trí khác để tìm kiếm bản lưu trữ trước khi truy cập vào mạng để tải xuống.
Thẻ:bazel_internal_configuration
- Giá trị mặc định của
--[no]experimental_repository_cache_hardlinks
: "false" - Nếu được đặt, bộ nhớ đệm kho lưu trữ sẽ liên kết cứng tệp trong trường hợp có lượt truy cập vào bộ nhớ đệm, thay vì sao chép. Việc này nhằm tiết kiệm dung lượng ổ đĩa.
Thẻ:bazel_internal_configuration
--experimental_repository_downloader_retries=<an integer>
mặc định: "0"-
Số lần thử tối đa để thử lại lỗi tải xuống. Nếu bạn đặt thành 0, thì tính năng thử lại sẽ bị tắt.
Thẻ:experimental
--experimental_scale_timeouts=<a double>
mặc định: "1.0"- Điều chỉnh tất cả thời gian chờ trong quy tắc kho lưu trữ Starlark theo hệ số này. Bằng cách này, bạn có thể làm cho kho lưu trữ bên ngoài hoạt động trên các máy chạy chậm hơn dự kiến của tác giả quy tắc mà không cần thay đổi mã nguồn
Thẻ:bazel_internal_configuration
,experimental
- Giá trị mặc định của
--[no]incompatible_disable_native_repo_rules
: "false" - Nếu giá trị là false, bạn có thể sử dụng các quy tắc kho lưu trữ gốc trong WORKSPACE; nếu không, bạn phải sử dụng các quy tắc kho lưu trữ Starlark. Các quy tắc kho lưu trữ gốc bao gồm local_repository, new_local_repository, local_config_platform, android_sdk_repository và android_ndk_repository.
Thẻ:bazel_internal_configuration
--repository_cache=<a path>
mặc định: xem nội dung mô tả- Chỉ định vị trí bộ nhớ đệm của các giá trị đã tải xuống thu được trong quá trình tìm nạp kho lưu trữ bên ngoài. Chuỗi trống làm đối số yêu cầu tắt bộ nhớ đệm, nếu không, giá trị mặc định là "<output_user_root>/cache/repos/v1" sẽ được sử dụng
Thẻ:bazel_internal_configuration
- Giá trị mặc định của
--[no]repository_disable_download
: "false" - Nếu được đặt, bạn không được phép tải xuống bằng ctx.download{,_and_extract} trong quá trình tìm nạp kho lưu trữ. Xin lưu ý rằng quyền truy cập mạng không bị tắt hoàn toàn; ctx.execute vẫn có thể chạy một tệp thực thi tuỳ ý truy cập Internet.
Thẻ:bazel_internal_configuration
- Các tuỳ chọn kiểm soát việc thực thi bản dựng:
- Giá trị mặc định của
--gc_thrashing_threshold=<an integer in 0-100 range>
: "100" -
Tỷ lệ phần trăm không gian cố định bị chiếm dụng (0-100) mà tại đó GcThrashingDetector xem xét các sự kiện áp lực bộ nhớ so với giới hạn của nó (--gc_thrashing_limits). Nếu bạn đặt thành 100, GcThrashingDetector sẽ bị tắt.
Thẻ:host_machine_resource_optimizations
- Các tuỳ chọn cho phép người dùng định cấu hình đầu ra dự kiến, ảnh hưởng đến giá trị của đầu ra đó, thay vì sự tồn tại của đầu ra:
- Giá trị mặc định của
--[no]gnu_format
: "false" - Nếu được đặt, hãy ghi phiên bản vào stdout bằng các quy ước được mô tả trong các tiêu chuẩn GNU.
Thẻ:affects_outputs
,execution
- Các tuỳ chọn liên quan đến ngữ nghĩa và đầu ra của Bzlmod:
--allow_yanked_versions=<a string>
nhiều lần sử dụng được tích luỹ-
Chỉ định các phiên bản mô-đun ở dạng `<module1>@<version1>,<module2>@<version2>` sẽ được cho phép trong biểu đồ phần phụ thuộc đã phân giải ngay cả khi các phiên bản đó được khai báo là đã bị xoá trong sổ đăng ký nơi chúng đến (nếu không đến từ NonRegistryOverride). Nếu không, các phiên bản bị xoá sẽ khiến việc phân giải không thành công. Bạn cũng có thể xác định phiên bản bị xoá được phép bằng biến môi trường `BZLMOD_ALLOW_YANKED_VERSIONS`. Bạn có thể tắt tính năng kiểm tra này bằng cách sử dụng từ khoá "tất cả" (không nên dùng).
Thẻ:loading_and_analysis
--check_bazel_compatibility=<error, warning or off>
mặc định: "lỗi"-
Kiểm tra khả năng tương thích của phiên bản bazel của các mô-đun Bazel. Các giá trị hợp lệ là "error" để chuyển vấn đề này lên lỗi phân giải, "off" để tắt tính năng kiểm tra hoặc "warning" để in cảnh báo khi phát hiện thấy không khớp.
Thẻ:loading_and_analysis
--check_direct_dependencies=<off, warning or error>
mặc định: "cảnh báo"-
Kiểm tra xem các phần phụ thuộc `bazel_dep` trực tiếp được khai báo trong mô-đun gốc có phải là các phiên bản mà bạn nhận được trong biểu đồ phần phụ thuộc đã được phân giải hay không. Các giá trị hợp lệ là "off" để tắt tính năng kiểm tra, "warning" để in cảnh báo khi phát hiện thấy không khớp hoặc "error" để chuyển lên lỗi phân giải.
Thẻ:loading_and_analysis
- Giá trị mặc định của
--[no]ignore_dev_dependency
: "false" - Nếu đúng, Bazel sẽ bỏ qua "bazel_dep" và "use_extension" được khai báo là "dev_dependency" trong MODULE.bazel của mô-đun gốc. Xin lưu ý rằng các phần phụ thuộc dành cho nhà phát triển đó luôn bị bỏ qua trong MODULE.bazel nếu đó không phải là mô-đun gốc, bất kể giá trị của cờ này là gì.
Thẻ:loading_and_analysis
--lockfile_mode=<off, update, refresh or error>
mặc định: "cập nhật"-
Chỉ định cách thức và liệu có sử dụng tệp khoá hay không. Các giá trị hợp lệ là "update" để sử dụng tệp khoá và cập nhật tệp khoá nếu có thay đổi, "refresh" để thỉnh thoảng làm mới thông tin có thể thay đổi (các phiên bản bị loại bỏ và các mô-đun bị thiếu trước đó) từ các sổ đăng ký từ xa, "error" để sử dụng tệp khoá nhưng gửi lỗi nếu tệp khoá không được cập nhật hoặc "off" để không đọc hoặc ghi vào tệp khoá.
Thẻ:loading_and_analysis
--override_module=<an equals-separated mapping of module name to path>
nhiều lần sử dụng được tích luỹ- Ghi đè một mô-đun bằng đường dẫn cục bộ ở dạng <tên mô-đun>=<đường dẫn>. Nếu đường dẫn đã cho là đường dẫn tuyệt đối, thì đường dẫn đó sẽ được sử dụng nguyên trạng. Nếu đường dẫn đã cho là đường dẫn tương đối, thì đường dẫn đó sẽ tương ứng với thư mục đang hoạt động. Nếu đường dẫn đã cho bắt đầu bằng "%workspace%", thì đường dẫn đó sẽ tương ứng với thư mục gốc của không gian làm việc, là kết quả của lệnh "bazel info workspace". Nếu đường dẫn đã cho trống, hãy xoá mọi chế độ ghi đè trước đó.
--registry=<a string>
nhiều lần sử dụng được tích luỹ- Chỉ định các sổ đăng ký cần sử dụng để xác định vị trí các phần phụ thuộc mô-đun Bazel. Thứ tự rất quan trọng: các mô-đun sẽ được tra cứu trong các sổ đăng ký trước đó trước tiên và chỉ quay lại các sổ đăng ký sau này khi các mô-đun đó bị thiếu trong các sổ đăng ký trước đó.
Thẻ:changes_inputs
--vendor_dir=<a path>
mặc định: xem nội dung mô tả-
Chỉ định thư mục sẽ chứa các kho lưu trữ bên ngoài ở chế độ nhà cung cấp, cho dù mục đích là tìm nạp các kho lưu trữ đó vào thư mục hay sử dụng các kho lưu trữ đó trong khi xây dựng. Bạn có thể chỉ định đường dẫn dưới dạng đường dẫn tuyệt đối hoặc đường dẫn tương đối đến thư mục không gian làm việc.
Thẻ:loading_and_analysis
- Các tuỳ chọn kích hoạt tính năng tối ưu hoá thời gian xây dựng:
--gc_thrashing_limits=<comma separated pairs of <period>:<count>>
mặc định: "1s:2,20s:3,1m:5"-
Các giới hạn nếu đạt đến sẽ khiến GcThrashingDetector gặp sự cố Bazel với OOM. Mỗi giới hạn được chỉ định là <period>:<count>, trong đó period là thời lượng và count là số nguyên dương. Nếu hơn --gc_thrashing_threshold phần trăm không gian cố định (vùng nhớ khối xếp cũ) vẫn bị chiếm dụng sau <count> lần GC đầy đủ liên tiếp trong <period>, thì lỗi OOM sẽ được kích hoạt. Bạn có thể chỉ định nhiều giới hạn, phân tách bằng dấu phẩy.
Thẻ:host_machine_resource_optimizations
--skyframe_high_water_mark_full_gc_drops_per_invocation=<an integer, >= 0>
mặc định: "2147483647"-
Cờ cho cấu hình nâng cao của công cụ Skyframe nội bộ của Bazel. Nếu phát hiện mức sử dụng phần trăm vùng nhớ khối xếp được giữ lại vượt quá ngưỡng do --skyframe_high_water_mark_threshold đặt ra, thì khi một sự kiện GC đầy đủ xảy ra, Bazel sẽ loại bỏ trạng thái Skyframe tạm thời không cần thiết, lên đến nhiều lần như vậy cho mỗi lệnh gọi. Mặc định là Integer.MAX_VALUE; không giới hạn về mặt hiệu quả. Giá trị 0 có nghĩa là các sự kiện GC đầy đủ sẽ không bao giờ kích hoạt sự kiện thả. Nếu đạt đến giới hạn, trạng thái Skyframe sẽ không còn bị loại bỏ khi một sự kiện GC đầy đủ xảy ra và vượt quá ngưỡng phần trăm vùng nhớ khối xếp được giữ lại đó.
Thẻ:host_machine_resource_optimizations
--skyframe_high_water_mark_minor_gc_drops_per_invocation=<an integer, >= 0>
mặc định: "2147483647"-
Cờ cho cấu hình nâng cao của công cụ Skyframe nội bộ của Bazel. Nếu phát hiện mức sử dụng phần trăm vùng nhớ khối xếp được giữ lại vượt quá ngưỡng do --skyframe_high_water_mark_threshold đặt ra, thì khi một sự kiện GC nhỏ xảy ra, Bazel sẽ loại bỏ trạng thái Skyframe tạm thời không cần thiết, lên đến nhiều lần như vậy mỗi lần gọi. Mặc định là Integer.MAX_VALUE; không giới hạn về mặt hiệu quả. Giá trị 0 có nghĩa là các sự kiện GC nhỏ sẽ không bao giờ kích hoạt sự kiện thả. Nếu đạt đến giới hạn, trạng thái Skyframe sẽ không còn bị loại bỏ khi một sự kiện GC nhỏ xảy ra và vượt quá ngưỡng phần trăm vùng nhớ khối xếp được giữ lại.
Thẻ:host_machine_resource_optimizations
--skyframe_high_water_mark_threshold=<an integer>
mặc định: "85"-
Cờ cho cấu hình nâng cao của công cụ Skyframe nội bộ của Bazel. Nếu phát hiện mức sử dụng phần trăm vùng nhớ khối xếp được giữ lại ít nhất là ngưỡng này, Bazel sẽ loại bỏ trạng thái Skyframe tạm thời không cần thiết. Việc điều chỉnh điều này có thể giúp bạn giảm thiểu tác động của tình trạng GC bị lỗi khi (i) tình trạng này là do mức sử dụng bộ nhớ của trạng thái tạm thời và (ii) tốn kém hơn so với việc tạo lại trạng thái khi cần.
Thẻ:host_machine_resource_optimizations
- Các tuỳ chọn ảnh hưởng đến mức độ chi tiết, định dạng hoặc vị trí ghi nhật ký:
--experimental_command_profile=<cpu, wall, alloc or lock>
mặc định: xem nội dung mô tả- Ghi hồ sơ Trình ghi chuyến bay Java trong thời gian thực thi lệnh. Bạn phải cung cấp một trong các loại sự kiện phân tích tài nguyên được hỗ trợ (cpu, wall, alloc hoặc lock) dưới dạng đối số. Hồ sơ được ghi vào một tệp được đặt tên theo loại sự kiện trong thư mục cơ sở đầu ra. Cú pháp và ngữ nghĩa của cờ này có thể thay đổi trong tương lai để hỗ trợ thêm các loại hồ sơ hoặc định dạng đầu ra; bạn tự chịu rủi ro khi sử dụng.
- Giá trị mặc định của
--[no]experimental_record_metrics_for_all_mnemonics
: "false" - Theo mặc định, số lượng loại thao tác được giới hạn ở 20 câu thần chú có số lượng thao tác được thực thi nhiều nhất. Việc đặt tuỳ chọn này sẽ ghi số liệu thống kê cho tất cả các câu thần chú.
- Các tuỳ chọn chỉ định hoặc thay đổi dữ liệu đầu vào chung thành một lệnh Bazel không thuộc các danh mục khác.:
--experimental_resolved_file_instead_of_workspace=<a string>
mặc định: ""- Nếu không trống, hãy đọc tệp đã phân giải được chỉ định thay vì tệp WORKSPACE
Thẻ:changes_inputs
- Các tuỳ chọn thực thi và lưu vào bộ nhớ đệm từ xa:
--experimental_downloader_config=<a string>
mặc định: xem nội dung mô tả- Chỉ định một tệp để định cấu hình trình tải xuống từ xa. Tệp này bao gồm các dòng, mỗi dòng bắt đầu bằng một lệnh (`allow`, `block` hoặc `rewrite`), theo sau là tên máy chủ lưu trữ (đối với lệnh `allow` và `block`) hoặc hai mẫu, một mẫu để so khớp và một mẫu để sử dụng làm URL thay thế, với các tệp tham chiếu ngược bắt đầu từ `$1`. Bạn có thể cung cấp nhiều lệnh `rewrite` cho cùng một URL và trong trường hợp này, nhiều URL sẽ được trả về.
- Giá trị mặc định của
--experimental_worker_for_repo_fetching=<off, platform, virtual or auto>
: "tự động" - Chế độ tạo luồng để tìm nạp kho lưu trữ. Nếu bạn đặt thành "tắt", thì không có luồng worker nào được sử dụng và quá trình tìm nạp kho lưu trữ sẽ phải khởi động lại. Nếu không, hãy sử dụng luồng worker ảo.
- Các tuỳ chọn khác, không được phân loại theo cách khác.:
--override_repository=<an equals-separated mapping of repository name to path>
nhiều lần sử dụng được tích luỹ- Ghi đè kho lưu trữ bằng một đường dẫn cục bộ ở dạng <repository name>=<path>. Nếu đường dẫn đã cho là đường dẫn tuyệt đối, thì đường dẫn đó sẽ được sử dụng nguyên trạng. Nếu đường dẫn đã cho là đường dẫn tương đối, thì đường dẫn đó sẽ tương ứng với thư mục đang hoạt động. Nếu đường dẫn đã cho bắt đầu bằng "%workspace%", thì đường dẫn đó sẽ tương ứng với thư mục gốc của không gian làm việc, là kết quả của lệnh "bazel info workspace". Nếu đường dẫn đã cho trống, hãy xoá mọi chế độ ghi đè trước đó.
Thẻ hiệu ứng tuỳ chọn
unknown |
Tuỳ chọn này có hiệu ứng không xác định hoặc chưa được ghi nhận. |
no_op |
Tuỳ chọn này thực sự không có hiệu lực. |
loses_incremental_state |
Việc thay đổi giá trị của tuỳ chọn này có thể làm mất đáng kể trạng thái gia tăng, khiến các bản dựng bị chậm. Trạng thái có thể bị mất do máy chủ khởi động lại hoặc do một phần lớn biểu đồ phần phụ thuộc bị vô hiệu. |
changes_inputs |
Tuỳ chọn này chủ động thay đổi các dữ liệu đầu vào mà bazel xem xét cho bản dựng, chẳng hạn như các quy định hạn chế về hệ thống tệp, phiên bản kho lưu trữ hoặc các tuỳ chọn khác. |
affects_outputs |
Tuỳ chọn này ảnh hưởng đến đầu ra của bazel. Thẻ này được thiết kế để có phạm vi rộng, có thể bao gồm các hiệu ứng bắc cầu và không chỉ định loại đầu ra mà thẻ này ảnh hưởng đến. |
build_file_semantics |
Tuỳ chọn này ảnh hưởng đến ngữ nghĩa của tệp BUILD hoặc .bzl. |
bazel_internal_configuration |
Tuỳ chọn này ảnh hưởng đến các chế độ cài đặt của cơ chế nội bộ bazel. Thẻ này không có nghĩa là các cấu phần phần mềm bản dựng bị ảnh hưởng. |
loading_and_analysis |
Tuỳ chọn này ảnh hưởng đến việc tải và phân tích các phần phụ thuộc, cũng như việc tạo biểu đồ phần phụ thuộc. |
execution |
Tuỳ chọn này ảnh hưởng đến giai đoạn thực thi, chẳng hạn như các tuỳ chọn liên quan đến hộp cát hoặc thực thi từ xa. |
host_machine_resource_optimizations |
Tuỳ chọn này kích hoạt một quá trình tối ưu hoá có thể dành riêng cho máy và không đảm bảo hoạt động trên tất cả các máy. Quá trình tối ưu hoá có thể bao gồm việc đánh đổi với các khía cạnh hiệu suất khác, chẳng hạn như bộ nhớ hoặc chi phí CPU. |
eagerness_to_exit |
Tuỳ chọn này thay đổi mức độ nhanh chóng mà bazel sẽ thoát khỏi một lỗi, trong đó có lựa chọn giữa việc tiếp tục mặc dù có lỗi và kết thúc lệnh gọi. |
bazel_monitoring |
Tuỳ chọn này dùng để theo dõi hành vi và hiệu suất của bazel. |
terminal_output |
Tuỳ chọn này ảnh hưởng đến đầu ra của thiết bị đầu cuối bazel. |
action_command_lines |
Tuỳ chọn này thay đổi các đối số dòng lệnh của một hoặc nhiều hành động xây dựng. |
test_runner |
Tuỳ chọn này thay đổi môi trường trình chạy kiểm thử của bản dựng. |
Thẻ siêu dữ liệu về tuỳ chọn
experimental |
Tuỳ chọn này kích hoạt một tính năng thử nghiệm mà không đảm bảo chức năng. |
incompatible_change |
Tuỳ chọn này sẽ kích hoạt một thay đổi có thể gây lỗi. Sử dụng tuỳ chọn này để kiểm tra xem bạn đã sẵn sàng di chuyển hay chưa hoặc để có quyền sử dụng sớm tính năng mới |
deprecated |
Tuỳ chọn này không còn được dùng nữa. Có thể tính năng bị ảnh hưởng không còn được dùng nữa hoặc bạn nên sử dụng một phương thức cung cấp thông tin khác. |