Tham chiếu dòng lệnh

bazel [<startup options>] <command> [<args>]
hoặc
bazel [<startup options>] <command> [<args>] -- [<target patterns>]
Xem Hướng dẫn sử dụng để biết cú pháp cho mẫu mục tiêu.

Cú pháp lựa chọn

Bạn có thể chuyển các tuỳ chọn đến Bazel theo nhiều cách. Bạn có thể chuyể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>
Một số lựa chọn có dạng ngắn ký tự đơn; trong trường hợp đó, dạng ngắn phải được chuyển với một dấu gạch ngang duy nhất và một dấu cách.
-<short_form> <value>

Bạn có thể bật các tuỳ chọn Boolean như sau:

--<option>
--<option>=[true|yes|1]
và tắt như sau:
--no<option>
--<option>=[false|no|0]

Các tuỳ chọn tristate thường được đặt thành tự động theo mặc định và có thể được bật như sau:

--<option>=[true|yes|1]
hoặc buộc tắt như sau:
--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 Chuẩn hoá danh sách các tuỳ chọn bazel.
clean Xoá các tệp đầu ra và dừng máy chủ nếu muốn.
coverage Tạo báo cáo mức độ sử dụng mã cho các mục tiêu kiểm thử được chỉ định.
cquery Tải, phân tích và truy vấn các mục tiêu đã chỉ định với các 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 mục tiêu.
help In trợ giúp cho các lệnh hoặc chỉ mục.
info Hiển thị thông tin thời gian chạy về máy chủ bazel.
license In giấy phép của phần mềm này.
mobile-install Lượt cài đặt nhắm đến thiết bị di động.
mod Truy vấn biểu đồ phần phụ thuộc bên ngoài Bzlmod
print_action In đối số dòng lệnh để biên dịch tệp.
query Thực thi một truy vấn trong 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ử được chỉ định.
version In thông tin phiên bản của bazel.

Tuỳ chọn khởi động

Các tuỳ chọn xuất hiện trước lệnh và được ứng dụng phân tích cú pháp:
Mặc định của --[no]autodetect_server_javabase: "đúng"
Khi chuyển --noautodetect_server_javabase, Bazel không quay lại JDK cục bộ để chạy máy chủ bazel mà thay vào đó sẽ thoát.
Thẻ: affects_outputs, loses_incremental_state
Mặc định của --[no]batch: "false"
Nếu bạn đặt chính sách này, Bazel sẽ chạy dưới dạng một quy trình ứng dụng không có máy chủ, thay vì ở chế độ máy khách/máy chủ tiêu chuẩn. Tính năng này không được dùng nữa và sẽ bị loại bỏ, 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ủ ở lại.
Thẻ: loses_incremental_state, bazel_internal_configuration, deprecated
Mặc định của --[no]batch_cpu_scheduling: "false"
Chỉ có trên Linux; sử dụng tính năng lập lịch CPU "theo lô" cho Blaze. Chính sách này hữu ích đối với những tải công việc không mang tính tương tác, nhưng không muốn làm giảm giá trị cần thiế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
Mặc định của --bazelrc=<path>: 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 tuỳ chọn Bazel. /dev/null cho biết rằng tất cả các `--bazelrc`khác sẽ bị bỏ qua. Điều này rất hữu ích khi tắt tính năng tìm kiếm tệp rc 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 sẽ đượ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
Mặc định của --[no]block_for_lock: "đúng"
Khi truyền --noblock_for_lock, Bazel không đợi lệnh đang chạy hoàn tất mà sẽ thoát ngay lập tức.
Thẻ: eagerness_to_exit
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
Mặc định của --connect_timeout_secs=<an integer>: "30"
Thời gian ứng dụng chờ mỗi lần kết nối với máy chủ
Thẻ: bazel_internal_configuration
Mặc định của --[no]expand_configs_in_place: "đúng"
Thay đổi việc mở rộng cờ --config được thực hiện tại chỗ, thay vì mở rộng đ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 trong dòng lệnh.
Thẻ: no_op, deprecated
Mặc định của --failure_detail_out=<path>: xem nội dung mô tả
Nếu được đặt, hãy chỉ định một vị trí để ghi thông báo protobuffail_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
Mặc định của --[no]home_rc: "đúng"
Có cần tìm tệp bazelrc tại nhà tại $HOME/.bazelrc
Thẻ: changes_inputs
Mặc định của --[no]idle_server_tasks: "đúng"
Chạy System.gc() khi máy chủ ở trạng thái rảnh
Các thẻ: loses_incremental_state, host_machine_resource_optimizations
Mặc định của --[no]ignore_all_rc_files: "false"
Tắt tất cả các tệp rc, bất kể giá trị của các cờ sửa đổi rc khác, ngay cả khi những cờ này xuất hiện sau trong danh sách các tuỳ chọn khởi động.
Thẻ: changes_inputs
Mặc định của --io_nice_level={-1,0,1,2,3,4,5,6,7}: "-1"
Chỉ có trên Linux; đặt một mức từ 0 đến 7 để lên lịch IO hiệu quả nhất bằng cách sử dụ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ể thực hiện lên mức ưu tiên 4. Nếu bạn đặt thành mộ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
Mặc định của --local_startup_timeout_secs=<an integer>: "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
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ẻ tệp rc giữa các nền tảng đó mà không cần thay đổi. Các giá trị có thể có là: do người dùng tương tác, do người dùng khởi tạo, mặc định, tiện ích và nền.
Thẻ: host_machine_resource_optimizations
Giá trị mặc định của --max_idle_secs=<integer>: "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. 0 có nghĩa là máy chủ sẽ không bao giờ tắt. Thông tin 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
Mặc định của --output_base=<path>: 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 bạn chỉ định một tuỳ chọn khác từ một sang lệnh gọi Bazel tiếp theo cho giá trị này, thì bạn có thể sẽ khởi động một máy chủ Bazel mới, bổ sung. Bazel khởi động chính xác một máy chủ trên mỗi cơ sở đầu ra được chỉ định. Thông thường, mỗi không gian làm việc thường có một cơ sở đầu ra. Tuy nhiên, khi dùng 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 đó có thể 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 nội dung "giúp bazel tắt nguồn" để biết cách tắt máy chủ Bazel.
Thẻ: affects_outputs, loses_incremental_state
Mặc định của --output_user_root=<path>: xem nội dung mô tả
Thư mục dành riêng cho người dùng bên dưới thư mục dùng để viết tất cả các kết quả của bản dựng; 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ố, kết quả của bản dựng có thể được chia sẻ giữa những người dùng đang cộng tác.
Thẻ: affects_outputs, loses_incremental_state
Mặc định của --[no]preemptible: "false"
Nếu đúng, lệnh này có thể bị giành quyền nếu một lệnh khác được khởi động.
Thẻ: eagerness_to_exit
Mặc định của --server_jvm_out=<path>: xem nội dung mô tả
Vị trí để ghi đầu ra của JVM của máy chủ. Nếu bạn không đặt thì chế độ mặc định sẽ là một vị trí trong output_base.
Thẻ: affects_outputs, loses_incremental_state
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 đã không hoạt động trong một thời gian, hãy tắt máy chủ khi hệ thống sắp hết dung lượng RAM trống. Chỉ dành cho Linux.
Thẻ: eagerness_to_exit, loses_incremental_state
Mặc định của --[no]system_rc: "đúng"
Có nên tìm bazelrc trên toàn hệ thống hay không.
Thẻ: changes_inputs
Mặc định của --[no]unlimit_coredumps: "false"
Tăng giới hạn kết xuất lõi mềm lên giới hạn cứng để có thể thực hiện việc kết xuất lõi của máy chủ (bao gồm cả JVM) và máy khách trong các điều kiện chung. Gắn cờ này vào bazelrc của bạn một lần và quên đi để bạn nhận được các lõi khi thực sự gặp phải một điều kiện kích hoạt chúng.
Thẻ: bazel_internal_configuration
Mặc định của --[no]watchfs: "false"
Nếu đúng, bazel sẽ cố gắng sử dụng dịch vụ xem tệp của hệ điều hành để kiểm tra các thay đổi cục bộ thay vì quét từng tệp để xem có thay đổi nào không.
Thẻ: deprecated
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
Mặc định của --[no]workspace_rc: "đúng"
Có nên tìm tệp bazelrc của Workspace tại $workspace/.bazelrc
Thẻ: changes_inputs
Các tuỳ chọn khác, không được phân loại theo cách khác::
Đã tích luỹ --host_jvm_args=<jvm_arg> lần sử dụng
Cờ để truyền đến Máy ảo Java thực thi Blaze.
--host_jvm_debug
Lựa chọn thuận tiện để thêm một số cờ khởi động JVM bổ sung, khiến JVM phải đợi 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 (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
Mặc định của --host_jvm_profile=<profiler_name>: ""
Tuỳ chọn thuận tiện để thêm một số cờ khởi động máy ảo Java 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à công cụ này ánh xạ đến các 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.
Mặc định của --server_javabase=<jvm path>: ""
Đường dẫn đến JVM dùng để thực thi chính Bazel.

Các tuỳ chọn chung cho mọi lệnh

Các tuỳ chọn kiểm soát quá trình thực thi bản dựng:
Mặc định của --experimental_ui_max_stdouterr_bytes=<an integer in (-1)-1073741819 range>: "1048576"
Kích thước tối đa của các tệp stdout / stderr sẽ được in ra bảng điều khiển. -1 nghĩa là không có giới hạn.
Thẻ: execution
Nếu bạn đặt chính sách này thành true và --incompatible_remote_symlinks cũng đúng thì các đường liên kết tượng trưng trong thao tác đầu ra sẽ được phép kết hợp với nhau.
Thẻ: execution, incompatible_change
Nếu bạn đặt chính sách này thành true, Bazel sẽ biểu thị các đường liên kết tượng trưng trong kết quả hoạt động trong giao thức lưu/thực thi từ xa vào bộ nhớ đệm/giao thức thực thi từ xa. Nếu không, các đường liên kết tượng trưng sẽ được theo dõi và biểu thị dưới dạng tệp hoặc thư mục. Xem #6631 để biết chi tiết.
Thẻ: execution, incompatible_change
Các tuỳ chọn giúp định cấu hình chuỗi công cụ dùng để thực thi hành động:
Mặc định của --[no]incompatible_enable_proto_toolchain_resolution: "false"
Nếu đúng, các quy tắc lang proto sẽ xác định các 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ự định, ảnh hưởng đến giá trị của kết quả đó thay vì giá trị tồn tại của kết quả đó:
Mặc định của --bep_maximum_open_remote_upload_files=<an integer>: "-1"
Số 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ả kết quả đầu ra từ xa xuống máy cục bộ. Cờ này là bí danh của --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
Mặc định của --remote_download_outputs=<all, minimal or toplevel>: "cấp cao nhất"
Nếu bạn đặt chính sách này thành "tối thiểu", hệ thống sẽ không tải bất kỳ kết quả bản dựng từ xa nào xuống máy cục bộ, ngoại trừ những kết quả do hành động cục bộ yêu cầu. Nếu được đặt thành 'toplevel' hoạt động giống như'tối thiểu', ngoại trừ việc nó cũng tải đầu ra 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 đều có thể làm giảm đáng kể thời gian xây dựng nếu băng thông mạng là điểm tắc nghẽn.
Thẻ: affects_outputs
Thay vì tải kết quả của 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ưới dạng một chuỗi mẫu. Chuỗi mẫu này có thể chứa {hash} và {size_bytes} mở rộng thành hàm băm của đối tượng và kích thước tính bằng byte tương ứng. Chẳng hạn, các đường liên kết tượng trưng này có thể trỏ đến 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 kết quả đầu ra từ xa của các 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
Đã tích luỹ --repo_env=<a 'name=value' assignment with an optional value part> lần sử dụng
Chỉ định các biến môi trường bổ sung chỉ dành cho các quy tắc lưu trữ. Lưu ý rằng các quy tắc kho lưu trữ vẫn sẽ thấy môi trường đầy đủ, nhưng theo cách này, thông tin cấu hình có thể được chuyể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 của Bazel thực thi các đầu vào hợp lệ của bản dựng (định nghĩa quy tắc, tổ hợp cờ, v.v.):
Mặc định của --[no]check_bzl_visibility: "đúng"
Nếu bạn tắt chính sách này, các lỗi về chế độ hiển thị tải .bzl sẽ bị giảm hạng xuống 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 tệp BUILD, tệp .bzl hoặc tệp WORKSPACE.:
Mặc định của --[no]enable_bzlmod: "đúng"
Nếu đúng, hệ thống sẽ bật hệ thống quản lý phần phụ thuộc Bzlmod, sẽ được ưu tiên hơn WORKSPACE. Hãy truy cập https://bazel.build/docs/bzlmod để biết thêm thông tin.
Thẻ: loading_and_analysis
Mặc định của --[no]experimental_action_resource_set: "đúng"
Nếu bạn đặt chính sách này thành true, thì 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, nó sẽ mặc định là 250 MB cho bộ nhớ và 1 cpu.
Thẻ: execution, build_file_semantics, experimental
Mặc định của --[no]experimental_bzl_visibility: "đúng"
Nếu được bật, hãy thêm hàm "visible()" 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
Mặc định của --[no]experimental_cc_shared_library: "false"
Nếu bạn đặt chính sách này thành true, thì 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ẽ hiển thị
Các thẻ: build_file_semantics, loading_and_analysis, experimental
Mặc định của --[no]experimental_disable_external_package: "false"
Nếu bạn đặt chính sách này thành true, thì gói //external được tạo tự động sẽ không còn hoạt động nữa. Bazel sẽ vẫn không thể phân tích cú pháp tệp 'external/BUILD', nhưng các khối cầu đến bên ngoài/ từ gói chưa đặt tên sẽ hoạt động.
Thẻ: loading_and_analysis, loses_incremental_state, experimental
Mặc định của --[no]experimental_enable_android_migration_apis: "false"
Nếu bạn đặt chính sách này thành true, thì các API cần thiết sẽ bật để hỗ trợ quá trình di chuyển Android Starlark.
Thẻ: build_file_semantics
Mặc định của --[no]experimental_enable_scl_dialect: "false"
Nếu bạn đặt chính sách này thành true, thì các tệp .scl có thể được sử dụng trong các câu lệnh load().
Thẻ: build_file_semantics
Mặc định của --[no]experimental_google_legacy_api: "false"
Nếu bạn đặt chính sách này thành true (đúng), hãy 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
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
Mặc định của --[no]experimental_java_library_export: "false"
Nếu được bật, mô-đun thử nghiệm_java_library_export_do_not_use sẽ có sẵn.
Thẻ: loading_and_analysis, incompatible_change
Mặc định của --[no]experimental_platforms_api: "false"
Nếu bạn đặt chính sách này thành true, thì một số API Starlark liên quan đến nền tảng sẽ hữu ích cho việc gỡ lỗi.
Thẻ: loading_and_analysis, experimental
Mặc định của --[no]experimental_repo_remote_exec: "false"
Nếu bạn đặt thành true, store_quy tắc sẽ có một số khả năng thực thi từ xa.
Thẻ: build_file_semantics, loading_and_analysis, experimental
Mặc định của --[no]experimental_sibling_repository_layout: "false"
Nếu bạn đặt chính sách này thành true, thì các kho lưu trữ không phải chính sẽ được liên kết dưới dạng các liên kết tượng trưng đến kho lưu trữ chính trong gốc thực thi. Tức là tất cả các kho lưu trữ đều là thư mục 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
Mặc định của --[no]incompatible_allow_tags_propagation: "đúng"
Nếu bạn đặt chính sách này thành true (đúng), thì 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. Truy cập https://github.com/bazelbuild/bazel/issues/8830 để biết chi tiết.
Thẻ: build_file_semantics, experimental
Mặc định của --[no]incompatible_always_check_depset_elements: "đúng"
Kiểm tra tính hợp lệ của các phần tử được thêm vào các phần phụ thuộc trong mọi hàm khởi tạo. Các phần tử phải là không thể thay đổi, nhưng trước đây hàm khởi tạo depset(direct=...) đã quên kiểm tra. Dùng bộ dữ liệu thay vì danh sách trong các phần tử phụ thuộc. Truy cập https://github.com/bazelbuild/bazel/issues/10313 để biết chi tiết.
Thẻ: build_file_semantics, incompatible_change
Mặc định của --[no]incompatible_depset_for_java_output_source_jars: "đúng"
Khi giá trị true (đúng), Bazel không còn trả về danh sách từ java_info.java_output[0].source_jars mà thay vào đó sẽ trả về một phần phụ thuộc.
Thẻ: loading_and_analysis, incompatible_change
Khi đúng, Bazel không còn trả về danh sách từ linking_context.Libraries_to_link nữa mà thay vào đó, trả về một giá trị phụ thuộc.
Thẻ: loading_and_analysis, incompatible_change
Mặc định của --[no]incompatible_disable_objc_library_transition: "đúng"
Tắt tính nă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
Các thẻ: build_file_semantics, incompatible_change
Mặc định của --[no]incompatible_disable_starlark_host_transitions: "false"
Nếu bạn đặt chính sách này thành true, thì các thuộc tính của quy tắc sẽ không thể đặt "cfg = "host"". Thay vào đó, quy tắc nên đặt "cfg = "exec".
Thẻ: loading_and_analysis, incompatible_change
Mặc định của --[no]incompatible_disable_target_provider_fields: "false"
Nếu bạn đặt chính sách này thành true, hãy tắt tính năng truy cập vào trình cung cấp trên các đối tượng "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" trong một hàm triển khai quy tắc, hãy sử dụng "ctx.attr.dep[MyInfo]". Hãy tham khảo tại https://github.com/bazelbuild/bazel/issues/9014 để biết thông tin chi tiết.
Thẻ: build_file_semantics, incompatible_change
Mặc định của --[no]incompatible_disallow_empty_glob: "false"
Nếu bạn đặt thành true (đúng), thì giá trị mặc định của đối số "allow_ empty" của glob() sẽ là False.
Thẻ: build_file_semantics, incompatible_change
Mặc định của --[no]incompatible_disallow_struct_provider_syntax: "false"
Nếu bạn đặt chính sách này thành true, thì các hàm triển khai quy tắc có thể sẽ không trả về một cấu trúc. Thay vào đó, các trình cung cấp này phải trả về danh sách các thực thể của nhà cung cấp.
Thẻ: build_file_semantics, incompatible_change
Mặc định của --[no]incompatible_existing_rules_immutable_view: "đúng"
Nếu bạn đặt chính sách này thành true, thì native.hiện_quy tắc và native.existing_rules sẽ trả về đối tượng khung hiển thị không thể thay đổi với kích thước nhẹ thay vì các lệnh có thể thay đổi.
Thẻ: build_file_semantics, loading_and_analysis, incompatible_change
Mặc định của --[no]incompatible_fail_on_unknown_attributes: "đúng"
Nếu được bật, các mục tiêu có thuộc tính không xác định được đặt thành Không có sẽ không thành công.
Thẻ: loading_and_analysis, incompatible_change
Mặc định của --[no]incompatible_fix_package_group_reporoot_syntax: "đúng"
Trong thuộc tính "packages" của package_group, 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 cho "//..." để 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
Mặc định của --[no]incompatible_java_common_parameters: "đúng"
Nếu bạn đặt chính sách này thành true, thì các tham số output_jar và host_javabase trong package_sources và host_javabase trong quá trình biên dịch sẽ bị xoá.
Thẻ: build_file_semantics, incompatible_change
Mặc định của --[no]incompatible_merge_fixed_and_default_shell_env: "đúng"
Nếu được bật, các thao tác đăng ký bằng ctx.actions.run và ctx.actions.run_shell được chỉ định với cả "env" và "use_default_shell_env = True" sẽ sử dụng môi trường lấy từ môi trường shell mặc định bằng cách ghi đè bằng các giá trị được chuyển vào "env". Nếu bạn tắt tuỳ chọn này, thì giá trị "env" sẽ hoàn toàn bị bỏ qua trong trường hợp này.
Thẻ: loading_and_analysis, incompatible_change
Mặc định của --[no]incompatible_new_actions_api: "đúng"
Nếu bạn đặt chính sách này thành true, thì API dùng để tạo hành động chỉ có trên "ctx.actions", chứ không có trên "ctx".
Thẻ: build_file_semantics, incompatible_change
Mặc định của --[no]incompatible_no_attr_license: "đúng"
Nếu bạn đặt chính sách này thành true, thì hãy tắt hàm "attr.License".
Các thẻ: build_file_semantics, incompatible_change
Mặc định của --[no]incompatible_no_implicit_file_export: "false"
Nếu bạn đặt, các tệp nguồn (đã sử dụng) sẽ là các gói riêng tư, trừ phi được xuất một cách rõ ràng. Hãy tham khảo tại https://github.com/bazelbuild/suggesteds/blob/master/designs/2019-10-24-file-visible.md
Các thẻ: build_file_semantics, incompatible_change
Mặc định của --[no]incompatible_no_rule_outputs_param: "false"
Nếu bạn đặt chính sách này thành true, hãy tắt tham số "outputs" của hàm Starlark "quy tắc()".
Thẻ: build_file_semantics, incompatible_change
Mặc định của --[no]incompatible_objc_provider_remove_linking_info: "false"
Nếu bạn đặt chính sách này thành true, thì các API của ObjcProvider dùng để liên kết thông tin sẽ bị loại bỏ.
Thẻ: build_file_semantics, incompatible_change
Mặc định của --[no]incompatible_package_group_has_public_syntax: "đúng"
Trong thuộc tính "packages" (gói) của package_group, cho phép ghi "công khai" hoặc "riêng tư" để 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
Mặc định của --[no]incompatible_require_linker_input_cc_api: "đúng"
Nếu bạn đặt chính sách này thành true (đúng), thì quy tắc create_linking_context sẽ yêu cầu thẻ linker_inputs thay vì "library_to_link". Các phương thức getter cũ của linking_context cũng sẽ bị tắt và chỉ nhìn thấy mối liên kết_inputs.
Thẻ: build_file_semantics, loading_and_analysis, incompatible_change
Mặc định của --[no]incompatible_run_shell_command_string: "đúng"
Nếu bạn đặt chính sách này thành true, tham số lệnh của actions.run_shell sẽ chỉ chấp nhận chuỗi
Các thẻ: build_file_semantics, incompatible_change
Mặc định của --[no]incompatible_stop_exporting_language_modules: "false"
Nếu được bật, một số mô-đun theo ngôn ngữ cụ thể (chẳng hạn như "cc_common") sẽ không dùng được trong tệp .bzl của người dùng và chỉ có thể được gọi qua kho lưu trữ quy tắc tương ứng.
Thẻ: loading_and_analysis, incompatible_change
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. Các phương thức này sẽ gây ô nhiễm không gian tên của 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
Mặc định của --[no]incompatible_top_level_aspects_require_providers: "false"
Nếu bạn đặt chính sách này thành đúng, thì khía cạnh cấp cao nhất sẽ tôn trọng 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 có 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 khía cạnh này.
Thẻ: loading_and_analysis, incompatible_change
Mặc định của --[no]incompatible_unambiguous_label_stringification: "đúng"
Khi đúng, Bazel sẽ biến 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. Truy cập https://github.com/bazelbuild/bazel/issues/15916 để biết thêm thông tin.
Thẻ: loading_and_analysis, incompatible_change
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 của @bazel_tools nữa. Vui lòng truy cập 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
Mặc định của --[no]incompatible_visibility_private_attributes_at_definition: "đúng"
Nếu bạn đặt chính sách này thành true, thì 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, và sẽ quay lại sử dụng quy tắc nếu không hiển thị.
Thẻ: build_file_semantics, incompatible_change
Mặc định của --max_computation_steps=<a long integer>: "0"
Số bước tính toán Starlark tối đa có thể được thực thi bằng tệp BUILD (0 có nghĩa là không có giới hạn).
Thẻ: build_file_semantics
Mặc định của --nested_set_depth_limit=<an integer>: "3500"
Độ sâu tối đa của biểu đồ bên trong một phần phụ thuộc (còn gọi là NestedSet), trên đó hàm khởi tạo depset() sẽ không thành công.
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:
Mặc định của --[no]heuristically_drop_nodes: "false"
Nếu giá trị là true, Blaze sẽ xoá các nút FileState và DirectoryListingState sau khi hoàn tất các nút File và DirectoryListing liên quan để tiết kiệm bộ nhớ. Chúng tôi cho rằng khả năng nhu cầu sử dụng lại các nút này sẽ giảm xuống. Nếu có, chương trình sẽ đánh giá lại.
Thẻ: loses_incremental_state
Mặc định của --[no]incompatible_do_not_split_linking_cmdline: "đúng"
Khi giá trị trả về là true, Bazel không còn sửa đổi các cờ dòng lệnh dùng để liên kết, đồng thời cũng không quyết định cờ nào sẽ chuyển vào tệp tham số và cờ nào không. Truy cập https://github.com/bazelbuild/bazel/issues/7670 để biết chi tiết.
Thẻ: loading_and_analysis, incompatible_change
Mặc định của --[no]keep_state_after_build: "đúng"
Nếu giá trị là false, Blaze sẽ loại bỏ trạng thái trong bộ nhớ 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ó mức độ gia tăng nào liên quan đến bản dựng này.
Thẻ: loses_incremental_state
Mặc định của --[no]track_incremental_state: "đúng"
Nếu giá trị là false, Blaze sẽ không lưu trữ dữ liệu cho phép vô hiệu hoá và đánh giá lại đối với các bản dựng tăng dần nhằm 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ó mức độ gia tăng nào liên quan đến 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 độ chi tiết, định dạng hoặc vị trí ghi nhật ký:
Mặc định của --[no]announce_rc: "false"
Có công bố các tuỳ chọn rc hay không.
Thẻ: affects_outputs
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 đến 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
Mặc định của --bes_backend=<a string>: ""
Chỉ định điểm cuối phụ trợ dịch vụ sự kiện bản dựng (BES) có dạng [SCHEME://]HOST[:Port]. Tuỳ chọn 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 có bật TLS). Nếu không có lược đồ nào được cung cấp, Bazel sẽ giả định là grpcs.
Thẻ: affects_outputs
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 đây đã nhận được sự kiện InvocationTryStarted và BuildEnqueued khớp với sự kiện của công cụ hiện tại hay không.
Thẻ: affects_outputs
Đã tích luỹ --bes_header=<a 'name=value' assignment> lần sử dụng
Chỉ định tiêu đề ở biểu mẫu NAME=VALUE sẽ được đưa vào các yêu cầu BES. Có thể chuyển nhiều tiêu đề bằng cách chỉ định cờ nhiều lần. Nhiều giá trị cho cùng 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
Mặc định của --bes_instance_name=<a string>: xem nội dung mô tả
Chỉ định tên thực thể mà theo đó BES sẽ duy trì BEP được tải lên. Giá trị mặc định là rỗng.
Thẻ: affects_outputs
Đã tích luỹ --bes_keywords=<comma-separated list of options> lần sử dụng
Chỉ định danh sách từ khoá thông báo để thêm bộ từ khoá mặc định đã phát hành trên BES ("command_name=<command_name> ", "protocol_name=BEP"). Giá trị mặc định là không có.
Thẻ: affects_outputs
Mặc định của --[no]bes_lifecycle_events: "đúng"
Chỉ định xem có phát hành các sự kiện trong vòng đời của BES hay không. (mặc định là 'true').
Thẻ: affects_outputs
Mặc định của --bes_oom_finish_upload_timeout=<An immutable length of time.>: "10p"
Chỉ định khoảng thời gian bazel cần chờ tải lên BES/BEP hoàn tất trong khi OOM. Cờ này đảm bảo việc chấm dứt khi JVM bị tấn công 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
Giá trị mặc định của --bes_outerr_buffer_size=<an integer>: "10240"
Chỉ định kích thước tối đa của stdout hoặc stderr để 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 giá trị lớn hơn giá trị được chỉ định lên tới --bes_outerr_chunk_size.
Thẻ: affects_outputs
Mặc định của --bes_outerr_chunk_size=<an integer>: "1048576"
Chỉ định kích thước tối đa của stdout hoặc stderr mà hệ thống sẽ gửi đến BEP trong một tin nhắn duy nhất.
Thẻ: affects_outputs
Mặc định của --bes_proxy=<a string>: xem nội dung mô tả
Kết nối với Dịch vụ sự kiện tạo bản dựng thông qua proxy. Hiện tại, bạn chỉ có thể sử dụng cờ này để định cấu hình ổ cắm miền Unix (unix:/path/to/socket).
Mặc định của --bes_results_url=<a string>: ""
Chỉ định URL cơ sở mà người dùng có thể xem thông tin được truyền đến phần phụ trợ BES. Bazel sẽ xuất URL được thêm vào bằng mã lệnh gọi đến thiết bị đầu cuối.
Thẻ: terminal_output
Đã tích luỹ --bes_system_keywords=<comma-separated list of options> lần sử dụng
Chỉ định danh sách các từ khoá thông báo để trực tiếp đưa vào, không kèm theo tiền tố "user_keyword=" cho các từ khoá được cung cấp thông qua --bes_keywords. Dành cho các toán tử dịch vụ Xây dựng đặt --bes_lifecycle_events=false và bao gồm từ khoá khi gọi PublishLifecycleEvent. Các toán tử dịch vụ xây dựng bằng cờ này sẽ ngăn người dùng ghi đè giá trị cờ này.
Thẻ: affects_outputs
Mặc định của --bes_timeout=<An immutable length of time.>: "0 giây"
Chỉ định khoảng thời gian bazel cần đợi quá trình tải lên BES/BEP hoàn tất sau khi quá trình tạo 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à đơ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' có nghĩa là không có thời gian chờ.
Thẻ: affects_outputs
Giá trị mặc định của --bes_upload_mode=<wait_for_upload_complete, nowait_for_upload_complete or fully_async>: "wait_for_upload_complete"
Chỉ định xem liệu quá trình tải lên Dịch vụ sự kiện bản dựng có chặn quá trình hoàn thành bản dựng hay không, hay 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. "wait_for_upload_complete" (mặc định), "nowait_for_upload_complete" hoặc "ful_async".
Thẻ: eagerness_to_exit
Mặc định của --build_event_binary_file=<a string>: ""
Nếu không trống, hãy ghi một giá trị biểu diễn nhị phân được phân tách bằng varint để thể hiện giao thức sự kiện xây dựng vào tệp đó. Tuỳ chọn này ngụ ý rằng --bes_upload_mode=wait_for_upload_complete.
Thẻ: affects_outputs
Mặc định của --[no]build_event_binary_file_path_conversion: "đúng"
Chuyển đổi đường dẫn trong 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ị vô hiệu hoá, lược đồ file:// uri sẽ luôn được sử dụng
Thẻ: affects_outputs
Giá trị mặc định của --build_event_binary_file_upload_mode=<wait_for_upload_complete, nowait_for_upload_complete or fully_async>: "wait_for_upload_complete"
Chỉ định xem liệu tệp 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 thành bản dựng hay không, hay 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. "wait_for_upload_complete" (mặc định), "nowait_for_upload_complete" hoặc "ful_async".
Thẻ: eagerness_to_exit
Mặc định của --build_event_json_file=<a string>: ""
Nếu giá trị không trống, hãy ghi chuỗi tuần tự JSON của giao thức sự kiện bản dựng vào tệp đó. Tuỳ chọn này ngụ ý rằng --bes_upload_mode=wait_for_upload_complete.
Thẻ: affects_outputs
Mặc định của --[no]build_event_json_file_path_conversion: "đúng"
Chuyển đổi đường dẫn trong tệp json biểu thị 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 hơn bất cứ khi nào có thể; nếu tắt giao thức file:// uri, lược đồ file:// sẽ luôn được sử dụng
Thẻ: affects_outputs
Giá trị mặc định của --build_event_json_file_upload_mode=<wait_for_upload_complete, nowait_for_upload_complete or fully_async>: "wait_for_upload_complete"
Chỉ định xem liệu tệp tải lên Dịch vụ sự kiện bản dựng cho --build_event_json_file có nên chặn quá trình hoàn thành bản dựng hay không hoặ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. "wait_for_upload_complete" (mặc định), "nowait_for_upload_complete" hoặc "ful_async".
Thẻ: eagerness_to_exit
Mặc định của --build_event_max_named_set_of_file_entries=<an integer>: "-1"
Số mục tối đa cho một sự kiện có tên_set_of_files; các giá trị nhỏ hơn 2 sẽ bị bỏ qua và không có hoạt động phân tách sự kiện nào được thực hiện. Tính năng này dùng để giới hạn kích thước sự kiện tối đa trong giao thức sự kiện của 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 dựa trên cấu trúc của tập hợp cũng như độ dài tệp và độ dài URI, do đó có thể phụ thuộc vào hàm băm.
Thẻ: affects_outputs
Mặc định của --[no]build_event_publish_all_actions: "false"
Liệu có nên phát hành tất cả hành động hay không.
Thẻ: affects_outputs
Mặc định của --build_event_text_file=<a string>: ""
Nếu nội dung không trống, hãy ghi nội dung trình bày bằng văn bản của giao thức sự kiện bản dựng vào tệp đó
Thẻ: affects_outputs
Mặc định của --[no]build_event_text_file_path_conversion: "đúng"
Chuyển đổi đường dẫn trong tệp văn bản mô tả 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ị vô hiệu hoá, lược đồ file:// uri sẽ luôn được sử dụng
Thẻ: affects_outputs
Giá trị mặc định của --build_event_text_file_upload_mode=<wait_for_upload_complete, nowait_for_upload_complete or fully_async>: "wait_for_upload_complete"
Chỉ định xem liệu tệp tải lên Dịch vụ sự kiện bản dựng cho --build_event_text_file nên chặn quá trình hoàn thành bản dựng hay 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. "wait_for_upload_complete" (mặc định), "nowait_for_upload_complete" hoặc "ful_async".
Thẻ: eagerness_to_exit
Mặc định của --[no]experimental_announce_profile_path: "false"
Nếu được bật, hãy thêm đường dẫn cấu hình JSON vào nhật ký.
Thẻ: bazel_monitoring
Mặc định của --[no]experimental_bep_target_summary: "false"
Liệu có nên xuất bản các sự kiện Targetsummary hay không.
Mặc định của --[no]experimental_build_event_expand_filesets: "false"
Nếu đúng, hãy mở rộng các tệp trong BEP khi trình bày các tệp đầu ra.
Thẻ: affects_outputs
Nếu đúng, hãy phân giải hoàn toàn các đường liên kết tượng trưng của Fileset tương đối trong BEP khi trình bày tệp đầu ra. Yêu cầu --experimental_build_event_expand_filesets.
Thẻ: affects_outputs
Mặc định của --experimental_build_event_upload_max_retries=<an integer>: "4"
Số lần tối đa Bazel nên thử tải lại một sự kiện bản dựng lên.
Thẻ: bazel_internal_configuration
Mặc định của --experimental_build_event_upload_retry_minimum_delay=<An immutable length of time.>: "1 giây"
Độ trễ tối thiểu ban đầu cho các lần thử lại luỹ thừa luỹ thừa khi không tải BEP lên được. (số mũ: 1,6)
Thẻ: bazel_internal_configuration
Mặc định của --experimental_build_event_upload_strategy=<a string>: xem nội dung mô tả
Chọn cách tải cấu phần phần mềm được tham chiếu lên trong giao thức sự kiện xây dựng.
Thẻ: affects_outputs
Mặc định của --[no]experimental_collect_load_average_in_profiler: "đúng"
Nếu được bật, trình phân tích tài nguyên sẽ thu thập giá trị tải trung bình tổng thể của hệ thống.
Thẻ: bazel_monitoring
Mặc định của --[no]experimental_collect_pressure_stall_indicators: "false"
Nếu bạn bật chế độ này, trình phân tích tài nguyên sẽ thu thập dữ liệu PSI của Linux.
Thẻ: bazel_monitoring
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 hành động cục bộ.
Thẻ: bazel_monitoring
Mặc định của --[no]experimental_collect_system_network_usage: "false"
Nếu bạn bật chế độ này, 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
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 trình thực thi.
Thẻ: bazel_monitoring
Đã tích luỹ --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 or unknown> lần sử dụng
Chỉ định các tác vụ hồ sơ bổ sung để đưa vào hồ sơ.
Thẻ: bazel_monitoring
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
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
Mặc định của --[no]experimental_run_bep_event_include_residue: "false"
Liệu có nên đưa dư lượng dòng lệnh vào các sự kiện chạy bản dựng có thể chứa dư lượng đó hay không. Theo mặc định, phần dư không được đưa vào các sự kiện tạo bản dựng lệnh chạy có thể chứa phần dư.
Thẻ: affects_outputs
Mặc định của --[no]experimental_stream_log_file_uploads: "false"
Truy cập trực tiếp tệp nhật ký truyền trực tuyến lên bộ nhớ từ xa thay vì ghi vào ổ đĩa.
Thẻ: affects_outputs
Mặc định của --experimental_workspace_rules_log_file=<a path>: xem nội dung mô tả
Ghi lại một số sự kiện của Quy tắc Workspace vào tệp này dưới dạng giao thức WorkspaceEvent được phân tách.
Mặc định của --[no]generate_json_trace_profile: "tự động"
Nếu bật, Bazel sẽ lập hồ sơ cho 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 ghi hồ sơ cho tất cả các lệnh và truy vấn tương tự như bản dựng.
Thẻ: bazel_monitoring
Mặc định của --[no]heap_dump_on_oom: "false"
Liệu có cần xuất tệp báo lỗi theo cách thủ công hay không nếu một OOM được gửi (bao gồm cả OOM thủ công do đạt đến --gc_thrashing_limits). Tệp kết xuất sẽ được ghi vào <output_base>/<invocation_id>.heapedump.hprof. Tuỳ chọn này thay thế một cách hiệu quả -XX:+HeapDumpOnOutOfMemoryError, vốn không có hiệu lực đối với OOM thủ công.
Thẻ: bazel_monitoring
Mặc định của --[no]legacy_important_outputs: "đúng"
Sử dụng trường này để loại bỏ việc tạo trườngimportant_outputs cũ trong sự kiện TargetComplete. Quan trọng_outputs là bắt buộc để tích hợp Bazel với ResultStore.
Thẻ: affects_outputs
Mặc định của --logging=<0 <= an integer <= 6>: "3"
Cấp độ ghi nhật ký.
Thẻ: affects_outputs
Mặc định của --memory_profile=<a path>: xem nội dung mô tả
Nếu được thiết lập, hãy ghi dữ liệu sử dụng bộ nhớ vào tệp được 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
Mặc định của --memory_profile_stable_heap_parameters=<integers, separated by a comma expected in pairs>: "1,0"
Điều chỉnh cách tính toán vùng nhớ khối xếp ổn định của hồ sơ bộ nhớ ở cuối bản dựng. Phải là và số lượng 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ố 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 có thời điểm tạm dừng 4 giây, sau đó là 4 GC có thời gian tạm dừng 0 giây
Thẻ: bazel_monitoring
Mặc định của --profile=<a path>: xem nội dung mô tả
Nếu bạn đặt chính sách này, hãy lập hồ sơ cho Bazel và ghi dữ liệu vào tệp được chỉ định. Sử dụng hồ sơ phân tích bazel để phân tích hồ sơ.
Thẻ: bazel_monitoring
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 nhiều sự kiện (chẳng hạn như thông bá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 lập hồ sơ chính xác hơn nhưng hiệu suất sẽ tăng LARGE. Tuỳ chọn chỉ có hiệu lực nếu cũng sử dụng hồ sơ.
Thẻ: bazel_monitoring
Giá trị mặc định của --remote_print_execution_messages=<failure, success or all>: "thất bại"
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" (thất bại) để chỉ in khi không thành công, "thành công" để chỉ in khi thành công và "all" để luôn in.
Thẻ: terminal_output
Mặc định của --[no]slim_profile: "đúng"
Giảm kích thước 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
Mặc định của --starlark_cpu_profile=<a string>: ""
Ghi vào tệp được chỉ định hồ sơ pprof về mức sử dụng CPU của tất cả các luồng Starlark.
Thẻ: bazel_monitoring
Mặc định của --tool_tag=<a string>: ""
Tên công cụ để gán lệnh gọi Bazel này.
Thẻ: affects_outputs, bazel_monitoring
Đã tích luỹ --ui_event_filters=<Convert list of comma separated event kind to list of filters> lần sử dụng
Chỉ định những sự kiện 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 khỏi 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 bộ mặc định bằng cách gán trực tiếp. Tập hợp các loại sự kiện được hỗ trợ bao gồm THÔNG TIN, GỠ LỖI, LỖI, v.v.
Thẻ: terminal_output
Tuỳ chọn thực thi và lưu vào bộ nhớ đệm từ xa:
Mặc định của --experimental_circuit_breaker_strategy=<failure>: xem nội dung mô tả
Chỉ định chiến lược cho cầu dao sẽ sử dụng. Các chiến lược có thể sử dụng được gọi là "thất bại". Khi có giá trị không hợp lệ cho lựa chọn, hành vi giống như lựa chọn không được đặt.
Thẻ: execution
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 thời gian xử lý tệp đầu vào của một thao tác trước khi tải thao tác lên bộ nhớ đệm từ xa. Có thể có những trường hợp nhân Linux trì hoãn việc ghi tệp, điều này có thể dẫn đến kết quả dương tính giả.
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ì trong quá trình tái tạo.
Mặc định của --[no]experimental_remote_cache_lease_extension: "false"
Nếu bạn đặt chính sách này thành true, Bazel sẽ gia hạn thời gian thuê đối với kết quả của các hành động từ xa trong quá trình tạo bản dựng bằng cách định kỳ gửi các lệnh gọi "Find MissingBlobs" đến bộ nhớ đệm từ xa. Tần suất dựa trên giá trị "--experimental_remote_cache_ttl".
Mặc định của --experimental_remote_cache_ttl=<An immutable length of time.>: "3 giờ"
Thời gian TTL tối thiểu được đảm bảo của các blob trong bộ nhớ đệm từ xa sau khi chuỗi đại diện của chúng được tham chiếu gần đây, chẳng hạn như ActionResult hoặc Find MissingBlobs. Bazel thực hiện một số hoạt động tối ưu hoá dựa trên TTL của các giọt nước, ví dụ: không liên tục gọi GetActionResult trong một bản dựng tăng dần. Bạn nên đặt giá trị này nhỏ hơn một chút so với TTL thực tế, vì có khoảng trống giữa thời điểm máy chủ trả về thông báo tổng hợp và thời điểm Bazel nhận được thông báo đó.
Thẻ: execution
Mặc định của --experimental_remote_capture_corrupted_outputs=<a path>: xem nội dung mô tả
Một đường dẫn đến thư mục chứa các dữ liệu đầu ra bị lỗi.
Mặc định của --[no]experimental_remote_discard_merkle_trees: "false"
Nếu bạn đặt chính sách này thành true (đúng), hãy loại bỏ các bản sao trong bộ nhớ của cây Mermble của gốc đầu vào và các ánh xạ đầu vào được liên kết trong lệnh gọi đến GetActionResult() và Execute(). Điều này giúp giảm đáng kể mức sử dụng bộ nhớ, nhưng Bazel phải tính toán lại khi bộ nhớ đệm từ xa bị bỏ lỡ và thử lại.
Mặc định của --experimental_remote_downloader=<a string>: xem nội dung mô tả
URI điểm cuối của Remote Asset API để dùng làm proxy tải xuống từ xa. Các giản đồ được hỗ trợ là grpc, grpcs (grpc có bật TLS) và unix (các ổ cắm UNIX cục bộ). Nếu 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
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ộ hay không nếu trình tải xuống từ xa không thành công.
Mặc định của --[no]experimental_remote_execution_keepalive: "false"
Liệu có nên sử dụng keepalive cho các lệnh gọi thực thi từ xa hay không.
Mặc định của --experimental_remote_failure_rate_threshold=<an integer in 0-100 range>: "10"
Đặt tỷ lệ lỗi được cho phép theo tỷ lệ phần trăm trong một khoảng thời gian cụ thể, sau thời điểm đó sẽ ngừng gọi đến bộ nhớ đệm/trình thực thi từ xa. Theo mặc định, giá trị là 10. Đặt giá trị này thành 0 có nghĩa là không có giới hạn.
Thẻ: execution
Mặc định của --experimental_remote_failure_window_interval=<An immutable length of time.>: "60 giây"
Khoảng thời gian tính toán tỷ lệ lỗi của các yêu cầu từ xa. Khi có giá trị âm hoặc giá trị 0, thời lượng lỗi được tính trong toàn bộ thời gian 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ị thì giá trị sẽ được thể hiện dưới dạng giây.
Thẻ: execution
Mặc định của --[no]experimental_remote_mark_tool_inputs: "false"
Nếu bạn đặt chính sách này thành true, Bazel sẽ đánh dấu dữ liệu đầu vào là đầu vào công cụ cho bộ thực thi từ xa. Phương thức này có thể dùng để triển khai trình thực thi liên tục từ xa.
Mặc định của --[no]experimental_remote_merkle_tree_cache: "false"
Nếu bạn đặt chính sách này thành true, thì các phép tính trong cây Mermming sẽ được ghi nhớ để cải thiện tốc độ kiểm tra lượt truy cập của bộ nhớ đệm từ xa. Bản in chân bộ nhớ của bộ nhớ đệm được kiểm soát bởi --experimental_remote_mermble_tree_cache_size.
Giá trị mặc định của --experimental_remote_merkle_tree_cache_size=<a long integer>: "1000"
Số lượng cây Mermble cần ghi nhớ để cải thiện tốc độ kiểm tra lượt truy cập của bộ nhớ đệm từ xa. Mặc dù bộ nhớ đệm được tự động giảm bớt theo cách xử lý các tệp tham chiếu mềm của Java, nhưng lỗi hết bộ nhớ vẫn có thể xảy ra nếu bạn đặt mức bộ nhớ quá cao. Nếu bạn đặt chính sách này thành 0, thì dung lượng bộ nhớ đệm sẽ không giới hạn. Giá trị tối ưu sẽ khác nhau tuỳ thuộc vào quy mô của dự án. Giá trị mặc định là 1000.
Mặc định của --[no]experimental_remote_require_cached: "false"
Nếu bạn đặt chính sách này thành true (đúng), hãy thực thi rằng tất cả các hành động có thể chạy từ xa đều được lưu vào bộ nhớ đệm, nếu không, quá trình tạo sẽ không thành công. Điều này hữu ích trong việc khắc phục các vấn đề không xác định vì tính năng này 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.
Mặc định của --experimental_remote_scrubbing_config=<Converts to a Scrubber>: 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 cấu hình này phải là vùng đệm giao thức ScrubbingConfig ở định dạng văn bản. Tính năng này giúp hỗ trợ việc chia sẻ bộ nhớ đệm từ xa/ổ đĩ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 ứng dụng này thật cẩn thận vì chế độ cài đặt không đúng có thể vô tình chia sẻ các mục trong bộ nhớ đệm và dẫn đến bản dựng không chính xác. Việc rà soát 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 cho mục đích truy xuất hoặc lưu trữ kết quả của hành động. Bạn không thể sử dụng tính năng này cùng với quá trình thực thi từ xa. Việc sửa đổi cấu hình xoá sạch sẽ không vô hiệu hoá các kết quả có trong hệ thống tệp cục bộ hoặc bộ nhớ đệm nội bộ; 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 có thể cần đặt mộ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).
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.
Mặc định của --[no]incompatible_remote_downloader_send_all_headers: "đúng"
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ỉ gửi giá trị đầu tiên hay không.
Thẻ: incompatible_change
Mặc định của --[no]incompatible_remote_output_paths_relative_to_input_root: "false"
Nếu bạn đặt chính sách này thành true, thì đườ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
Mặc định của --[no]incompatible_remote_results_ignore_disk: "đúng"
Không hoạt động
Thẻ: incompatible_change
Mặc định của --[no]remote_accept_cached: "đúng"
Liệu có chấp nhận kết quả hành động được lưu từ xa vào bộ nhớ đệm hay không.
Mặc định của --remote_build_event_upload=<all or minimal>: "tối thiểu"
Nếu bạn đặt chính sách này thành "all", thì mọi kết quả đầu ra cục bộ mà BEP tham chiếu sẽ được tải lên bộ nhớ đệm từ xa. Nếu đặt ở mức "tối thiểu", dữ liệu đầu ra cục bộ được 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 tra và hồ sơ thời gian). Lược đồ bytestream:// luôn được dùng cho URI của tệp ngay cả khi thiếu bộ nhớ đệm từ xa. Giá trị mặc định là "tối thiểu".
Mặc định của --remote_bytestream_uri_prefix=<a string>: xem nội dung mô tả
Tên máy chủ và tên thực thể sẽ được dùng trong các URI bytestream:// được ghi vào các luồng sự kiện của 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 một proxy. Điều này 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. Khi bạn không đặt chính sách này, giá trị này sẽ mặc định là "${hostname}/${instance_name}".
Mặc định của --remote_cache=<a string>: 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 có bật TLS) và unix (các ổ cắm UNIX cục bộ). Nếu không cung cấp giản đồ, Bazel sẽ mặc định sử dụng grpcs. Hãy chỉ định giản đồ grpc://, http:// hoặc unix: để tắt TLS. Hãy truy cập vào https://bazel.build/remote/caching
Mặc định của --[no]remote_cache_compression: "false"
Nếu bật, hãy nén/giải nén các blob bộ nhớ đệm bằng zstd.
Đã tích luỹ --remote_cache_header=<a 'name=value' assignment> lần sử dụng
Chỉ định tiêu đề sẽ được đưa vào các yêu cầu về bộ nhớ đệm: --remote_cache_header=Name=Value. Có thể chuyển nhiều tiêu đề bằng cách chỉ định cờ nhiều lần. Nhiều giá trị cho cùng tên sẽ được chuyển đổi thành danh sách được phân tách bằng dấu phẩy.
Đã tích luỹ --remote_default_exec_properties=<a 'name=value' assignment> lần sử dụng
Đặt thuộc tính exec mặc định được 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
Mặc định của --remote_default_platform_properties=<a string>: ""
Đặt thuộc tính mặc định của nền tảng là thuộc tính cho API thực thi từ xa, trong trường hợp 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.
Đã tích luỹ --remote_download_regex=<a string> lần sử dụng
Buộc Bazel tải các cấu phần phần mềm khớp với biểu thức chính quy đã cho xuống. Được dùng cùng với Bản dựng không có Bytes (hoặc giá trị tương đương nội bộ) để cho phép ứng dụng yêu cầu một số cấu phần phần mềm nhất định có thể cần thiết cục bộ (ví dụ: hỗ trợ IDE). Bạn có thể chỉ định nhiều biểu thức chính quy bằng cách lặp lại cờ này.
Thẻ: affects_outputs
Đã tích luỹ --remote_downloader_header=<a 'name=value' assignment> lần sử dụng
Chỉ định tiêu đề sẽ được đưa vào yêu cầu của trình tải xuống từ xa: --remote_downloader_header=Name=Value. Có thể chuyển nhiều tiêu đề bằng cách chỉ định cờ nhiều lần. Nhiều giá trị cho cùng tên sẽ được chuyển đổi thành danh sách được phân tách bằng dấu phẩy.
Đã tích luỹ --remote_exec_header=<a 'name=value' assignment> lần sử dụng
Hãy chỉ định tiêu đề sẽ được đưa vào các yêu cầu thực thi: --remote_exec_header=Name=Value. Có thể chuyển nhiều tiêu đề bằng cách chỉ định cờ nhiều lần. Nhiều giá trị cho cùng tên sẽ được chuyển đổi thành danh sách được phân tách bằng dấu phẩy.
Mặc định của --remote_execution_priority=<an integer>: "0"
Mức độ ưu tiên tương đối của các hành động cần 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ủ.
Mặc định của --remote_executor=<a string>: xem nội dung mô tả
máy chủ hoặc máy chủ:KH của điểm cuối thực thi từ xa. Các giản đồ được hỗ trợ là grpc, grpcs (grpc có bật TLS) và unix (các ổ cắm UNIX cục bộ). Nếu không cung cấp giản đồ, Bazel sẽ mặc định sử dụng grpcs. Hãy chỉ định grpc:// hoặc unix: giản đồ để tắt TLS.
Mặc định của --remote_grpc_log=<a path>: xem nội dung mô tả
Nếu được chỉ định, đường dẫn đến một tệp để ghi nhật ký 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 com.google.devtools.build.lib.remote.logging.RemoteExecutionLog.LogEntry protobufs với mỗi thông báo có tiền tố một varint cho biết kích thước của thông báo protobuf nối tiếp sau đây, như được thực hiện bằng phương thức LogEntry.writeDelimitedTo(OutputStream).
Đã tích luỹ --remote_header=<a 'name=value' assignment> lần sử dụng
Chỉ định tiêu đề sẽ được đưa vào yêu cầu: --remote_header=Name=Value. Có thể chuyển nhiều tiêu đề bằng cách chỉ định cờ nhiều lần. Nhiều giá trị cho cùng tên sẽ được chuyển đổi thành danh sách được phân tách bằng dấu phẩy.
Mặc định của --remote_instance_name=<a string>: ""
Giá trị cần truyền dưới dạng instance_name trong API thực thi từ xa.
Mặc định của --[no]remote_local_fallback: "false"
Liệu có nên quay lại chiến lược thực thi cục bộ độc lập hay không nếu quá trình thực thi từ xa không thành công.
Mặc định của --remote_local_fallback_strategy=<a string>: "local"
Không hoạt động, không dùng nữa. Truy cập https://github.com/bazelbuild/bazel/issues/7480 để biết chi tiết.
Giá trị mặc định của --remote_max_connections=<an integer>: "100"
Giới hạn số lượng đường kết nối đồng thời tối đa cho bộ nhớ đệm/trình thực thi từ xa. Theo mặc định, giá trị là 100. Đặ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ể thực hiện 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, do đó Bazel có thể đưa ra các yêu cầu đồng thời "--remote_max_connections * 100".
Thẻ: host_machine_resource_optimizations
Mặc định của --remote_proxy=<a string>: xem nội dung mô tả
Kết nối với bộ nhớ đệm từ xa thông qua một proxy. Hiện tại, bạn chỉ có thể sử dụng cờ này để định cấu hình ổ cắm miền Unix (unix:/path/to/socket).
Mặc định của --remote_result_cache_priority=<an integer>: "0"
Mức độ ưu tiên tương đối của các thao tác từ xa cần 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ủ.
Mặc định của --remote_retries=<an integer>: "5"
Số lần thử tối đa để thử lại một lỗi tạm thời. Nếu bạn đặt chính sách này thành 0, thì tính năng thử lại sẽ tắt.
Mặc định của --remote_retry_max_delay=<An immutable length of time.>: "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ị thì giá trị sẽ được thể hiện dưới dạng giây.
Mặc định của --remote_timeout=<An immutable length of time.>: "60 giây"
Khoảng thời gian tối đa để chờ thực thi từ xa và lệnh gọi bộ nhớ đệm. Đối với bộ nhớ đệm REST, đây là 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ị thì giá trị sẽ được thể hiện dưới dạng giây.
Mặc định của --[no]remote_upload_local_results: "đúng"
Liệu có nên 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 làm vậy.
Mặc định của --[no]remote_verify_downloads: "đúng"
Nếu bạn đặt chính sách này thành true, Bazel sẽ tính toán tổng giá trị băm của tất cả lượt tải xuống từ xa và loại bỏ các giá trị đã lưu từ xa vào bộ nhớ đệm nếu chúng không khớp với giá trị dự kiến.
Các lựa chọn khác, không được phân loại.:
Đã tích luỹ --build_metadata=<a 'name=value' assignment> lần sử dụng
Tuỳ chỉnh các cặp chuỗi khoá-giá trị để cung cấp trong sự kiện tạo bản dựng.
Thẻ: terminal_output
Mặc định của --color=<yes, no or auto>: "tự động"
Sử dụng các nút điều khiển thiết bị đầu cuối để tô màu kết quả đầu ra.
Đã tích luỹ --config=<a string> lần sử dụng
Chọn các phần cấu hình bổ sung từ các tệp rc; đối với mỗi <command>, lệnh này cũng lấy các tuỳ chọn trong <command>:<config> nếu có một phần như vậy; nếu phần này không tồn tại trong bất kỳ tệp .rc nào, thì Blaze sẽ gặp lỗi. Các phần cấu hình và tổ hợp cờ tương đương nằm trong các tệp cấu hình tools/*.blazerc.
Đã tích luỹ --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.> lần sử dụng
Định cấu hình trình trợ giúp thông tin xác thực để sử dụng nhằm truy xuất thông tin xác thực uỷ quyền cho hoạt động tìm nạp kho lưu trữ, lưu và thực thi từ xa, cũng như dịch vụ sự kiện xây dựng. Thông tin xác thực do trình trợ giúp cung cấp sẽ được ưu tiên so với thông tin xác thực do --google_default_credentials, --google_credentials, tệp .netrc hoặc thông số xác thực cung cấp choRepository_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. Truy cập https://github.com/bazelbuild/Requests/blob/main/designs/2022-06-07-bazel-credential-helpers.md để biết chi tiết.
Mặc định của --credential_helper_cache_duration=<An immutable length of time.>: "30p"
Thời lượng 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. Việc gọi một giá trị khác sẽ điều chỉnh thời gian tồn tại của các mục nhập hiện có trước đó; chuyển 0 để xóa bộ nhớ đệm. Lệnh sạch sẽ luôn xoá bộ nhớ đệm, bất kể cờ này là gì.
Mặc định của --credential_helper_timeout=<An immutable length of time.>: "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. Lệnh gọi không thành công nếu trình trợ giúp thông tin xác thực không phản hồi trong thời gian chờ này.
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ỏ cuối cùng để giảm thiểu kết quả cuộn.
Mặc định của --disk_cache=<a path>: xem nội dung mô tả
Một đường dẫn đến thư mục nơi Bazel có thể đọc và ghi các thao tác cũng như đầu ra của thao tác. Nếu thư mục không tồn tại, nó sẽ được tạo.
Mặc định của --[no]enable_platform_specific_config: "false"
Nếu đúng, Bazel sẽ chọn các dòng cấu hình dành riêng cho hệ điều hành máy chủ từ các tệp bazelrc. Ví dụ: nếu hệ điều hành máy chủ 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.
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
Mặc định của --[no]experimental_windows_watchfs: "false"
Nếu đúng, chế độ hỗ trợ Windows thử nghiệm cho --watchfs sẽ được bật. Nếu không, đồng hồ sẽ là một ứng dụng không hoạt động trên Windows. Hãy nhớ bật cả --watchfs.
Mặc định của --google_auth_scopes=<comma-separated list of options>: "https://www.googleapis.com/auth/cloud-platform"
Danh sách các phạm vi xác thực của Google Cloud được phân tách bằng dấu phẩy.
Mặc định của --google_credentials=<a string>: xem nội dung mô tả
Chỉ định tệp để lấy thông tin xác thực. Hãy truy cập vào https://cloud.google.com/docs/validate để biết thông tin chi tiết.
Mặc định của --[no]google_default_credentials: "false"
Liệu có nên sử dụng 'Thông tin xác thực mặc định của ứng dụng Google' để xác thực hay không. Hãy truy cập vào https://cloud.google.com/docs/validate để biết thông tin chi tiết. Tắt theo mặc định.
Mặc định của --grpc_keepalive_time=<An immutable length of time.>: xem nội dung mô tả
Định cấu hình ping duy trì hoạt động cho các kết nối gRPC đi. Nếu bạn đặt chính sách này, Bazel sẽ gửi ping sau khoảng thời gian không có hoạt động đọ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 thứ hai. Nếu đặt giá trị nhỏ hơn 1 giây thì đó là lỗi. Theo mặc định, ping duy trì hoạt động bị tắt. Bạn cầ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 phải thực hiện như sau --grpc_keepalive_time=30s
Mặc định của --grpc_keepalive_timeout=<An immutable length of time.>: "20 giây"
Định cấu hình thời gian chờ duy trì hoạt động cho các kết nối gRPC đi. Nếu ping duy trì hoạt động được bật bằng --grpc_keepalive_time, thì Bazel sẽ hết thời gian kết nối nếu không nhận được tin nhắn trả lời ping sau khoảng thời gian này. Thời gian được coi là độ chi tiết thứ hai. Nếu đặt giá trị nhỏ hơn 1 giây thì đó là lỗi. Nếu ping duy trì hoạt động bị tắt thì chế độ cài đặt này sẽ bị bỏ qua.
Mặc định của --[no]incompatible_disable_non_executable_java_binary: "false"
Nếu đúng, java_binary sẽ luôn thực thi. Thuộc tính create_executable sẽ bị xoá.
Thẻ: loading_and_analysis, incompatible_change
Không hoạt động.
Thẻ: loading_and_analysis, incompatible_change
Mặc định của --[no]progress_in_terminal_title: "false"
Hiển thị tiến trình lệnh trong tiêu đề của thiết bị đầu cuối. Hữu ích để xem bazel đang làm gì khi có nhiều thẻ thiết bị đầu cuối.
Mặc định của --[no]show_progress: "đúng"
Hiển thị thông báo tiến trình trong một bản dựng.
Mặc định của --show_progress_rate_limit=<a double>: "0,2"
Số giây tối thiểu giữa các thông báo tiến trình trong đầu ra.
Mặc định của --[no]show_timestamps: "false"
Thêm dấu thời gian vào thông báo
Mặc định của --tls_certificate=<a string>: xem nội dung mô tả
Chỉ định đường dẫn đến một chứng chỉ TLS được tin cậy để ký chứng chỉ máy chủ.
Mặc định của --tls_client_certificate=<a string>: xem nội dung mô tả
Chỉ định chứng chỉ máy khách TLS để sử dụng; bạn cũng cần cung cấp khoá máy khách để bật tính năng xác thực máy khách.
Mặc định của --tls_client_key=<a string>: xem nội dung mô tả
Chỉ định khoá máy khách TLS để sử dụng; bạn cũng cần cung cấp chứng chỉ máy khách để bật tính năng xác thực máy khách.
Mặc định của --ui_actions_shown=<an integer>: "8"
Số lượng hành động đồng thời được hiển thị trong thanh tiến trình chi tiết; mỗi hành động được 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, tất cả các số nhỏ hơn 1 được ánh xạ thành 1.
Thẻ: terminal_output
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ụ xem tệp của hệ điều hành để xem các thay đổi cục bộ thay vì quét mọi tệp để xem thay đổi. Trên Windows: cờ này hiện không hoạt động nhưng có thể bật cùng với --experimental_windows_watchfs. Trên bất kỳ hệ điều hành nào: Hành vi này không được xác định nếu không gian làm việc của bạn nằm trong 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 ứng dụng phân tích cú pháp:
Đã tích luỹ --distdir=<a path> lần sử dụng
Các nơi khác để tìm kiếm các tệp lưu trữ trước khi truy cập mạng để tải các tệp lưu trữ đó xuống.
Thẻ: bazel_internal_configuration
Nếu bạn đặt chính sách này, bộ nhớ đệm của kho lưu trữ sẽ liên kết cứng tệp đó trong trường hợp tệp bị tấn công vào bộ nhớ đệm, thay vì sao chép. Mục đích của tính năng này là tiết kiệm dung lượng ổ đĩa.
Thẻ: bazel_internal_configuration
Mặc định của --experimental_repository_downloader_retries=<an integer>: "0"
Số lần thử lại một lỗi tải xuống tối đa. Nếu bạn đặt chính sách này thành 0, thì tính năng thử lại sẽ tắt.
Thẻ: experimental
Mặc định của --experimental_scale_timeouts=<a double>: "1.0"
Điều chỉnh tỷ lệ tất cả thời gian chờ trong quy tắc lưu trữ Starlark theo hệ số này. Bằng cách này, kho lưu trữ bên ngoài có thể được tạo ra hoạt động trên các máy chậm hơn tác giả quy tắc dự kiến mà không cần thay đổi mã nguồn
Thẻ: bazel_internal_configuration, experimental
Mặc định của --http_connector_attempts=<an integer>: "8"
Số lần thử tải xuống http tối đa.
Thẻ: bazel_internal_configuration
Mặc định của --http_connector_retry_max_timeout=<An immutable length of time.>: "0 giây"
Thời gian chờ tối đa cho các lần thử tải xuống lại http. Với giá trị 0, không có thời gian chờ tối đa nào được xác định.
Thẻ: bazel_internal_configuration
Mặc định của --http_timeout_scaling=<a double>: "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ố cụ thể
Thẻ: bazel_internal_configuration
Mặc định của --repository_cache=<a path>: 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. Một chuỗi trống làm đối số yêu cầu tắt bộ nhớ đệm, nếu không, hệ thống sẽ sử dụng giá trị mặc định của '<output_user_root>/cache/repos/v1'
Thẻ: bazel_internal_configuration
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ị vô hiệu hoá hoàn toàn; ctx.exe vẫn có thể chạy một tệp thực thi tuỳ ý truy cập vào Internet.
Thẻ: bazel_internal_configuration
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 --gc_thrashing_threshold=<an integer in 0-100 range>: "100"
Tỷ lệ phần trăm không gian đã sử dụng đã sử dụng (0 – 100) trên đó 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 giá trị này thành 100, thì GcThrashingDetector sẽ tắt.
Thẻ: host_machine_resource_optimizations
Các tuỳ chọn liên quan đến đầu ra và ngữ nghĩa Bzlmod:
Đã tích luỹ --allow_yanked_versions=<a string> lần sử dụng
Đã chỉ định các phiên bản mô-đun dưới dạng `<module1>@<version1>,<module2>@<version2>`. Những phiên bản này sẽ được 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 trong sổ đăng ký nơi chúng xuất phát (nếu các phiên bản đó không đến từ một NonRegistryOverride). Nếu không, các phiên bản bị giật sẽ khiến quá trình phân giải không thành công. Bạn cũng có thể xác định phiên bản được kéo mạnh được phép bằng biến môi trường "BZLMOD_ALLOW_YANKED_VERSIONS". Bạn có thể vô hiệu hoá việc kiểm tra này bằng cách sử dụng từ khoá 'all' (không được khuyến nghị).
Thẻ: loading_and_analysis
Mặc định của --check_bazel_compatibility=<error, warning or off>: "lỗi"
Kiểm tra khả năng tương thích với 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 đề lên trạng thái lỗi giải quyết, "tắt" để tắt chế độ kiểm tra, hoặc "cảnh báo" để in cảnh báo khi phát hiện thấy thông tin không khớp.
Thẻ: loading_and_analysis
Mặc định của --check_direct_dependencies=<off, warning or error>: "cảnh báo"
Kiểm tra xem các phần phụ thuộc trực tiếp "bazel_dep" được khai báo trong mô-đun gốc có giống với phiên bản bạn nhận được trong biểu đồ phần phụ thuộc đã được giải quyết hay không. Các giá trị hợp lệ là "off" ("tắt") để tắt chế độ kiểm tra, "cảnh báo" để in cảnh báo khi phát hiện thấy thông tin không khớp hoặc "error" để chuyển vấn đề lên thành lỗi giải quyết.
Thẻ: loading_and_analysis
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_secondary` trong MODULE.bazel của mô-đun gốc. Lưu ý rằng các phần phụ thuộc của 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
Mặc định của --lockfile_mode=<off, update or error>: "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 nếu có thay đổi, "error" khi dùng tệp khoá nhưng báo lỗi nếu tệp không được cập nhật, hoặc "tắt" để không đọc hoặc ghi vào tệp khoá.
Thẻ: loading_and_analysis
Đã tích luỹ --override_module=<an equals-separated mapping of module name to path> lần sử dụng
Ghi đè một mô-đun có đường dẫn cục bộ ở dạng <module name>=<path>. Nếu đường dẫn đã cho là một đường dẫn tuyệt đối, thì đường dẫn đó sẽ được sử dụng như nguyên trạng. Nếu đường dẫn đã cho là một đường dẫn tương đối, thì đường dẫn đó sẽ tương ứng với thư mục đang hoạt động hiện tại. Nếu đường dẫn đã cho bắt đầu bằng "%workspace%", thì đường dẫn đó 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 "không gian làm việc thông tin bazel")
Đã tích luỹ --registry=<a string> lần sử dụng
Chỉ định sổ đăng ký cần dùng để xác định vị trí các phần phụ thuộc của mô-đun Bazel. Thứ tự rất quan trọng: các mô-đun sẽ được tra cứu trước trong sổ đăng ký trước, và chỉ quay lại các sổ đăng ký sau khi còn thiếu trong các sổ đăng ký trước đó.
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:
Mặc định của --gc_thrashing_limits=<comma separated pairs of <period>:<count>>: "1s:2,20s:3,1m:5"
Các giới hạn mà nếu đạt đến mức này sẽ khiến GcThrashingDetector gây sự cố cho Bazel bằng OOM. Mỗi giới hạn được chỉ định dưới dạng <period>:<count>, trong đó khoảng thời gian là một khoảng thời gian và số lượng là một số nguyên dương. Nếu có hơn --gc_thrashing_threshold phần trăm không gian cần sử dụng (vùng nhớ khối xếp thế hệ cũ) vẫn chiếm sau <count> các GC đầy đủ liên tiếp trong khoảng <period>, thì OOM sẽ được kích hoạt. Bạn có thể chỉ định nhiều hạn mức và phân tách bằng dấu phẩy.
Thẻ: host_machine_resource_optimizations
Mặc định của --skyframe_high_water_mark_full_gc_drops_per_invocation=<an integer, >= 0>: "2147483647"
Gắn cờ cho cấu hình nâng cao của công cụ Skyframe nội bộ của Bazel. Nếu Bazel phát hiện thấy 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 đặt ra bằng --skyframe_high_water_mark_threshold, thì khi một sự kiện GC xảy ra đầy đủ, trạng thái Skyframe tạm thời không cần thiết sẽ bị bỏ qua, tối đa nhiều lần cho mỗi lệnh gọi. Mặc định là Integer.MAX_VALUE; không giới hạn hiệu quả. 0 có nghĩa là các sự kiện thu gom rác (GC) toàn bộ sẽ không bao giờ kích hoạt hiện tượng giảm. Nếu đạt đến giới hạn, trạng thái Skyframe sẽ không còn bị bỏ qua khi một sự kiện GC đầy đủ xảy ra và vượt quá ngưỡng tỷ lệ phần trăm vùng nhớ khối xếp được giữ lại đó.
Thẻ: host_machine_resource_optimizations
Mặc định của --skyframe_high_water_mark_minor_gc_drops_per_invocation=<an integer, >= 0>: "2147483647"
Gắn cờ cho cấu hình nâng cao của công cụ Skyframe nội bộ của Bazel. Nếu Bazel phát hiện thấy mức sử dụng tỷ lệ phần trăm vùng nhớ khối xếp được giữ lại vượt quá ngưỡng đặt ra bằng --skyframe_high_water_mark_threshold, thì khi một sự kiện GC nhỏ xảy ra, trạng thái Skyframe tạm thời không cần thiết sẽ bị bỏ qua, tối đa là nhiều lần cho mỗi lệnh gọi. Mặc định là Integer.MAX_VALUE; không giới hạn hiệu quả. 0 có nghĩa là các sự kiện GC nhỏ sẽ không bao giờ kích hoạt hiện tượng giảm. Nếu đạt đến giới hạn, trạng thái Skyframe sẽ không còn bị bỏ qua khi xảy ra một sự kiện GC nhỏ và ngưỡng tỷ lệ phần trăm vùng nhớ khối xếp được giữ lại đó đã vượt quá.
Thẻ: host_machine_resource_optimizations
Mặc định của --skyframe_high_water_mark_threshold=<an integer>: "85"
Gắn cờ cho cấu hình nâng cao của công cụ Skyframe nội bộ của Bazel. Nếu Bazel 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 ở ngưỡng này, thì Bazel sẽ bỏ trạng thái Skyframe tạm thời không cần thiết. Việc chỉnh sửa tính năng này có thể cho phép bạn giảm thiểu tác động của tình trạng này đến thời gian sử dụng GC, khi tình trạng giật GC là do việc sử dụng bộ nhớ ở trạng thái tạm thời này gây ra và (ii) tốn kém hơn so với việc khôi phục trạng thái khi cần.
Thẻ: host_machine_resource_optimizations
Các tuỳ chọn ảnh hưởng đến độ 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 tệp kế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ô" dễ đọc.
Thẻ: affects_outputs
Mặc định của --[no]experimental_command_profile: "false"
Ghi lại hồ sơ CPU của Trình ghi chuyến bay Java vào tệp profile.jfr trong thư mục cơ sở đầu ra. Trong tương lai, cú pháp và ngữ nghĩa của cờ này có thể thay đổi để hỗ trợ nhiều loại hồ sơ hoặc định dạng đầu ra; bạn tự chịu rủi ro khi sử dụng.
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 thao tác ghi nhớ 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ả chức năng ghi nhớ.
Các tuỳ chọn chỉ định hoặc thay đổi dữ liệu đầu vào chung thành lệnh Bazel mà không thuộc các danh mục khác.:
Mặc định của --experimental_resolved_file_instead_of_workspace=<a string>: ""
Nếu nội dung không trống, hãy đọc tệp đã được phân giải được chỉ định thay vì tệp WORKSPACE
Các thẻ: changes_inputs
Các tuỳ chọn thực thi và lưu vào bộ nhớ đệm từ xa:
Mặc định của --experimental_downloader_config=<a string>: 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ủ (cho `allow` và `block`) hoặc hai mẫu, một mẫu để so khớp và một mẫu dùng làm URL thay thế, có tham chiếu ngược bắt đầu từ "$1". Có thể có nhiều lệnh "rewrite" cho cùng một URL và trong trường hợp này sẽ có nhiều URL được trả về.
Mặc định của --experimental_worker_for_repo_fetching=<off, platform or virtual>: "tắt"
Chế độ phân luồng dùng để tìm nạp kho lưu trữ. Nếu bạn đặt chính sách này thành "tắt", thì sẽ không có luồng worker nào được sử dụng và quá trình tìm nạp kho lưu trữ có thể khởi động lại. Ngược lại, hãy sử dụng luồng nền tảng (tức là luồng hệ điều hành) nếu được đặt thành "platform" hoặc luồng ảo nếu được đặt thành "virtual".
Các lựa chọn khác, không được phân loại.:
Đã tích luỹ --override_repository=<an equals-separated mapping of repository name to path> lần sử dụng
Ghi đè một 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à một đường dẫn tuyệt đối, thì đường dẫn đó sẽ được sử dụng nguyên vẹn. Nếu đường dẫn đã cho là một đườ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 này 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 "không gian làm việc thông tin bazel")

Tuỳ chọn truy vấn

Kế thừa tất cả các tuỳ chọn của bản dựng.

Các tuỳ chọn xuất hiện trước lệnh và được ứng dụng phân tích cú pháp:
Đã tích luỹ --distdir=<a path> lần sử dụng
Các nơi khác để tìm kiếm các tệp lưu trữ trước khi truy cập mạng để tải các tệp lưu trữ đó xuống.
Thẻ: bazel_internal_configuration
Nếu bạn đặt chính sách này, bộ nhớ đệm của kho lưu trữ sẽ liên kết cứng tệp đó trong trường hợp tệp bị tấn công vào bộ nhớ đệm, thay vì sao chép. Mục đích của tính năng này là tiết kiệm dung lượng ổ đĩa.
Thẻ: bazel_internal_configuration
Mặc định của --experimental_repository_downloader_retries=<an integer>: "0"
Số lần thử lại một lỗi tải xuống tối đa. Nếu bạn đặt chính sách này thành 0, thì tính năng thử lại sẽ tắt.
Thẻ: experimental
Mặc định của --experimental_scale_timeouts=<a double>: "1.0"
Điều chỉnh tỷ lệ tất cả thời gian chờ trong quy tắc lưu trữ Starlark theo hệ số này. Bằng cách này, kho lưu trữ bên ngoài có thể được tạo ra hoạt động trên các máy chậm hơn tác giả quy tắc dự kiến mà không cần thay đổi mã nguồn
Thẻ: bazel_internal_configuration, experimental
Mặc định của --http_connector_attempts=<an integer>: "8"
Số lần thử tải xuống http tối đa.
Thẻ: bazel_internal_configuration
Mặc định của --http_connector_retry_max_timeout=<An immutable length of time.>: "0 giây"
Thời gian chờ tối đa cho các lần thử tải xuống lại http. Với giá trị 0, không có thời gian chờ tối đa nào được xác định.
Thẻ: bazel_internal_configuration
Mặc định của --http_timeout_scaling=<a double>: "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ố cụ thể
Thẻ: bazel_internal_configuration
Mặc định của --repository_cache=<a path>: 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. Một chuỗi trống làm đối số yêu cầu tắt bộ nhớ đệm, nếu không, hệ thống sẽ sử dụng giá trị mặc định của '<output_user_root>/cache/repos/v1'
Thẻ: bazel_internal_configuration
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ị vô hiệu hoá hoàn toàn; ctx.exe vẫn có thể chạy một tệp thực thi tuỳ ý truy cập vào Internet.
Thẻ: bazel_internal_configuration
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 --gc_thrashing_threshold=<an integer in 0-100 range>: "100"
Tỷ lệ phần trăm không gian đã sử dụng đã sử dụng (0 – 100) trên đó 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 giá trị này thành 100, thì GcThrashingDetector sẽ tắt.
Thẻ: host_machine_resource_optimizations
Các tuỳ chọn liên quan đến đầu ra truy vấn và ngữ nghĩa:
Giá trị mặc định của --aspect_deps=<off, conservative or precise>: "thận trọng"
Cách giải quyết các phần phụ thuộc khung hình khi định dạng đầu ra là {xml,proto,record}. "tắt" có nghĩa là không có phần phụ thuộc khung hình nào được phân giải, "bảo toàn" (mặc định) có nghĩa là tất cả các phần phụ thuộc khung hình đã khai báo đều được thêm vào bất kể các phần phụ thuộc đó 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ỉ các khía cạnh có thể đang hoạt động dựa trên lớp quy tắc của phần phụ thuộc trực tiếp. 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 đó khiến nó chậm hơn so với các chế độ khác. Cũng 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 được chạy trong "truy vấn bazel".
Thẻ: build_file_semantics
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ể là do hàm <code>str</code> Starlark áp dụng cho thực thể <code>Label</code>. Điều này rất hữu ích cho các công cụ cần khớp với kết quả của nhiều lệnh truy vấn và/hoặc nhãn do quy tắc đưa ra. Nếu không được bật, các trình định dạng đầu ra sẽ tự do phát ra tên kho lưu trữ rõ ràng (tương ứng với kho lưu trữ chính) để giúp kết quả dễ đọc hơn.
Thẻ: terminal_output
Mặc định của --[no]graph:factored: "đúng"
Nếu đúng, thì biểu đồ sẽ được phát ra "đã được tính thành phần", tức là các nút tương đương về mặt cấu trúc liên kết sẽ được hợp nhất với nhau và các nhãn của chúng được nối với nhau. Tuỳ chọn này chỉ áp dụng cho --output=map.
Thẻ: terminal_output
Mặc định của --graph:node_limit=<an integer>: "512"
Độ dài tối đa của chuỗi nhãn cho một nút biểu đồ trong đầu ra. Các nhãn dài hơn sẽ bị cắt bớt; -1 có nghĩa là không bị cắt bớt. Tuỳ chọn này chỉ áp dụng cho --output=map.
Thẻ: terminal_output
Mặc định của --[no]implicit_deps: "đúng"
Nếu được bật, các phần phụ thuộc ngầm ẩn 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 thêm bởi bazel. Đối với cquery, tuỳ chọn này kiểm soát việc lọc các chuỗi công cụ đã được phân giải.
Thẻ: build_file_semantics
Mặc định của --[no]include_artifacts: "đúng"
Bao gồm tên của các đầu vào và đầu ra của hành động trong dữ liệu đầu ra (có thể lớn).
Thẻ: terminal_output
Mặc định của --[no]include_aspects: "đúng"
aquery, cquery: liệu có bao gồm các hành động do khía cạnh tạo ra trong kết quả không. query: no-op (các khía cạnh luôn được tuân theo).
Thẻ: terminal_output
Mặc định của --[no]include_commandline: "đúng"
Bao gồm nội dung của các dòng lệnh hành động trong dữ liệu đầu ra (có thể lớn).
Thẻ: terminal_output
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
Mặc định của --[no]include_param_files: "false"
Bao gồ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
Mặc định của --[no]incompatible_package_group_includes_double_slash: "đúng"
Nếu bạn bật chế độ này, khi xuất thuộc tính "packages" của package_group, thuộc tính "//" ở đầu sẽ không bị bỏ qua.
Thẻ: terminal_output, incompatible_change
Mặc định của --[no]infer_universe_scope: "false"
Nếu bạn không đặt và --universe_scope, thì giá trị của --universe_scope sẽ được suy luận dưới dạng danh sách các mẫu mục tiêu duy nhất trong biểu thức truy vấn. Lưu ý rằng giá trị --universe_scope được suy luận cho biểu thức truy vấn sử dụng các hàm trong phạm vi toàn bộ (ví dụ:`allrdeps`) có thể không phải là điều bạn muốn, vì vậy, bạn chỉ nên sử dụng tùy chọn này nếu biết mình đang làm gì. Hãy tham khảo tại 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 tùy chọn này sẽ bị bỏ qua. Lưu ý: lựa chọn này chỉ áp dụng cho "truy vấn" (tức là không áp dụng cho "cquery").
Thẻ: loading_and_analysis
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
Mặc định của --[no]nodep_deps: "đúng"
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 nơi truy vấn hoạt động. Một ví dụ phổ biến về thuộc tính "nodep" là "khả năng hiển thị". Chạy và phân tích cú pháp kết quả của "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
Mặc định của --output=<a string>: "văn bản"
Định dạng in kết quả truy vấn. Các giá trị được phép đối với truy vấn là: text, textproto, proto, Streaming_proto, jsonproto.
Thẻ: terminal_output
Mặc định của --[no]proto:default_values: "đúng"
Nếu đúng thì các thuộc tính có giá trị không được chỉ định rõ trong tệp BUILD sẽ được bao gồm; nếu không thì các thuộc tính này sẽ bị bỏ qua. Tuỳ chọn này áp dụng cho --output=proto
Thẻ: terminal_output
Mặc định của --[no]proto:definition_stack: "false"
Điền trường proto manifest_stack. Trường này ghi lại từng thực thể quy tắc cho 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
Mặc định của --[no]proto:flatten_selects: "đúng"
Nếu bạn bật chính sách này, các thuộc tính có thể định cấu hình do Select() tạo ra sẽ được làm phẳng. Đối với loại danh sách, cách biểu diễn đã làm phẳng là danh sách chứa từng giá trị của bản đồ chọn đúng một lần. Các loại vô hướng được làm phẳng thành giá trị rỗng.
Thẻ: build_file_semantics
Mặc định của --[no]proto:include_attribute_source_aspects: "false"
Điền trường proto source_aspect_name của mỗi Thuộc tính bằng khía cạnh nguồn của thuộc tính (chuỗi trống nếu không phải là chuỗi).
Thẻ: terminal_output
Mặc định của --[no]proto:include_synthetic_attribute_hash: "false"
Liệu có nên tính toán và điền thuộc tính $internal_attr_hash hay không.
Thẻ: terminal_output
Mặc định của --[no]proto:instantiation_stack: "false"
Điền ngăn xếp lệnh gọi tạo thực thể của từng quy tắc. Lưu ý rằng điều này yêu cầu ngăn xếp phải hiển thị
Thẻ: terminal_output
Mặc định của --[no]proto:locations: "đúng"
Liệu có xuất thông tin vị trí ở đầu ra proto hay không.
Thẻ: terminal_output
Mặc định của --proto:output_rule_attrs=<comma-separated list of options>: "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 kết quả. Giá trị mặc định là tất cả thuộc tính. Đặt thành chuỗi trống để không xuất bất kỳ thuộc tính nào. Tuỳ chọn này có thể áp dụng cho --output=proto.
Thẻ: terminal_output
Mặc định của --[no]proto:rule_inputs_and_outputs: "đúng"
Liệu có nên điền các trường Rule_input và Rule_output hay không.
Thẻ: terminal_output
Mặc định của --query_file=<a string>: ""
Nếu bạn đặt chính sách này, truy vấn sẽ đọc truy vấn từ tệp có tên ở đây, thay vì trên dòng lệnh. Sẽ xảy ra lỗi khi chỉ định tệp tại đây cũng như truy vấn dòng lệnh.
Thẻ: changes_inputs
Mặc định của --[no]relative_locations: "false"
Nếu đúng, vị trí của các tệp BUILD trong xml và kết quả proto sẽ là tương đối. Theo mặc định, dữ liệu vị trí đầu ra 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 true để có kết quả nhất quán trên các máy.
Thẻ: terminal_output
Mặc định của --[no]skyframe_state: "false"
Nếu không phân tích thêm, hãy kết xuất Biểu đồ hành động hiện tại từ Skyframe. Lưu ý: Việc chỉ định mục tiêu bằng --skyframe_state hiện không được hỗ trợ. Cờ này chỉ áp dụng với --output=proto hoặc --output=textproto.
Thẻ: terminal_output
Mặc định của --[no]tool_deps: "đúng"
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 qua đó. Cạnh phụ thuộc "exec configuration" (Cấu hình thực thi) (chẳng hạn như cạnh từ quy tắc "proto_library" bất kỳ đến Protocol Compiler (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 tạo bản dựng thay vì một phần của cùng một chương trình "target" (mục tiêu). Cquery: Nếu bị tắt, hãy 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 được đị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ó 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, chỉ các mục tiêu đã định cấu hình thực thi mới được trả về. Tuỳ chọn này sẽ KHÔNG loại trừ các chuỗi công cụ đã được phân giải.
Thẻ: build_file_semantics
Mặc định của --universe_scope=<comma-separated list of options>: ""
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 (cộng và trừ). Truy vấn có thể được thực hiện trong vũ trụ được xác định bằng việc đóng bắc cầu 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à mục tiêu mà tất cả câu trả lời đều được tạo và do đó, tuỳ chọn này có thể ảnh hưởng đến cấu hình và chuyển đổi. Nếu bạn không chỉ định tuỳ chọn này, thì mục tiêu cấp cao nhất được giả định là 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ị hỏng nếu không thể tạo mục tiêu được phân tích cú pháp từ biểu thức truy vấn với 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 Bzlmod:
Đã tích luỹ --allow_yanked_versions=<a string> lần sử dụng
Đã chỉ định các phiên bản mô-đun dưới dạng `<module1>@<version1>,<module2>@<version2>`. Những phiên bản này sẽ được 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 trong sổ đăng ký nơi chúng xuất phát (nếu các phiên bản đó không đến từ một NonRegistryOverride). Nếu không, các phiên bản bị giật sẽ khiến quá trình phân giải không thành công. Bạn cũng có thể xác định phiên bản được kéo mạnh được phép bằng biến môi trường "BZLMOD_ALLOW_YANKED_VERSIONS". Bạn có thể vô hiệu hoá việc kiểm tra này bằng cách sử dụng từ khoá 'all' (không được khuyến nghị).
Thẻ: loading_and_analysis
Mặc định của --check_bazel_compatibility=<error, warning or off>: "lỗi"
Kiểm tra khả năng tương thích với 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 đề lên trạng thái lỗi giải quyết, "tắt" để tắt chế độ kiểm tra, hoặc "cảnh báo" để in cảnh báo khi phát hiện thấy thông tin không khớp.
Thẻ: loading_and_analysis
Mặc định của --check_direct_dependencies=<off, warning or error>: "cảnh báo"
Kiểm tra xem các phần phụ thuộc trực tiếp "bazel_dep" được khai báo trong mô-đun gốc có giống với phiên bản bạn nhận được trong biểu đồ phần phụ thuộc đã được giải quyết hay không. Các giá trị hợp lệ là "off" ("tắt") để tắt chế độ kiểm tra, "cảnh báo" để in cảnh báo khi phát hiện thấy thông tin không khớp hoặc "error" để chuyển vấn đề lên thành lỗi giải quyết.
Thẻ: loading_and_analysis
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_secondary` trong MODULE.bazel của mô-đun gốc. Lưu ý rằng các phần phụ thuộc của 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
Mặc định của --lockfile_mode=<off, update or error>: "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 nếu có thay đổi, "error" khi dùng tệp khoá nhưng báo lỗi nếu tệp không được cập nhật, hoặc "tắt" để không đọc hoặc ghi vào tệp khoá.
Thẻ: loading_and_analysis
Đã tích luỹ --override_module=<an equals-separated mapping of module name to path> lần sử dụng
Ghi đè một mô-đun có đường dẫn cục bộ ở dạng <module name>=<path>. Nếu đường dẫn đã cho là một đường dẫn tuyệt đối, thì đường dẫn đó sẽ được sử dụng như nguyên trạng. Nếu đường dẫn đã cho là một đường dẫn tương đối, thì đường dẫn đó sẽ tương ứng với thư mục đang hoạt động hiện tại. Nếu đường dẫn đã cho bắt đầu bằng "%workspace%", thì đường dẫn đó 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 "không gian làm việc thông tin bazel")
Đã tích luỹ --registry=<a string> lần sử dụng
Chỉ định sổ đăng ký cần dùng để xác định vị trí các phần phụ thuộc của mô-đun Bazel. Thứ tự rất quan trọng: các mô-đun sẽ được tra cứu trước trong sổ đăng ký trước, và chỉ quay lại các sổ đăng ký sau khi còn thiếu trong các sổ đăng ký trước đó.
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:
Mặc định của --gc_thrashing_limits=<comma separated pairs of <period>:<count>>: "1s:2,20s:3,1m:5"
Các giới hạn mà nếu đạt đến mức này sẽ khiến GcThrashingDetector gây sự cố cho Bazel bằng OOM. Mỗi giới hạn được chỉ định dưới dạng <period>:<count>, trong đó khoảng thời gian là một khoảng thời gian và số lượng là một số nguyên dương. Nếu có hơn --gc_thrashing_threshold phần trăm không gian cần sử dụng (vùng nhớ khối xếp thế hệ cũ) vẫn chiếm sau <count> các GC đầy đủ liên tiếp trong khoảng <period>, thì OOM sẽ được kích hoạt. Bạn có thể chỉ định nhiều hạn mức và phân tách bằng dấu phẩy.
Thẻ: host_machine_resource_optimizations
Mặc định của --skyframe_high_water_mark_full_gc_drops_per_invocation=<an integer, >= 0>: "2147483647"
Gắn cờ cho cấu hình nâng cao của công cụ Skyframe nội bộ của Bazel. Nếu Bazel phát hiện thấy 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 đặt ra bằng --skyframe_high_water_mark_threshold, thì khi một sự kiện GC xảy ra đầy đủ, trạng thái Skyframe tạm thời không cần thiết sẽ bị bỏ qua, tối đa nhiều lần cho mỗi lệnh gọi. Mặc định là Integer.MAX_VALUE; không giới hạn hiệu quả. 0 có nghĩa là các sự kiện thu gom rác (GC) toàn bộ sẽ không bao giờ kích hoạt hiện tượng giảm. Nếu đạt đến giới hạn, trạng thái Skyframe sẽ không còn bị bỏ qua khi một sự kiện GC đầy đủ xảy ra và vượt quá ngưỡng tỷ lệ phần trăm vùng nhớ khối xếp được giữ lại đó.
Thẻ: host_machine_resource_optimizations
Mặc định của --skyframe_high_water_mark_minor_gc_drops_per_invocation=<an integer, >= 0>: "2147483647"
Gắn cờ cho cấu hình nâng cao của công cụ Skyframe nội bộ của Bazel. Nếu Bazel phát hiện thấy mức sử dụng tỷ lệ phần trăm vùng nhớ khối xếp được giữ lại vượt quá ngưỡng đặt ra bằng --skyframe_high_water_mark_threshold, thì khi một sự kiện GC nhỏ xảy ra, trạng thái Skyframe tạm thời không cần thiết sẽ bị bỏ qua, tối đa là nhiều lần cho mỗi lệnh gọi. Mặc định là Integer.MAX_VALUE; không giới hạn hiệu quả. 0 có nghĩa là các sự kiện GC nhỏ sẽ không bao giờ kích hoạt hiện tượng giảm. Nếu đạt đến giới hạn, trạng thái Skyframe sẽ không còn bị bỏ qua khi xảy ra một sự kiện GC nhỏ và ngưỡng tỷ lệ phần trăm vùng nhớ khối xếp được giữ lại đó đã vượt quá.
Thẻ: host_machine_resource_optimizations
Mặc định của --skyframe_high_water_mark_threshold=<an integer>: "85"
Gắn cờ cho cấu hình nâng cao của công cụ Skyframe nội bộ của Bazel. Nếu Bazel 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 ở ngưỡng này, thì Bazel sẽ bỏ trạng thái Skyframe tạm thời không cần thiết. Việc chỉnh sửa tính năng này có thể cho phép bạn giảm thiểu tác động của tình trạng này đến thời gian sử dụng GC, khi tình trạng giật GC là do việc sử dụng bộ nhớ ở trạng thái tạm thời này gây ra và (ii) tốn kém hơn so với việc khôi phục trạng thái khi cần.
Thẻ: host_machine_resource_optimizations
Các tuỳ chọn ảnh hưởng đến độ chi tiết, định dạng hoặc vị trí ghi nhật ký:
Mặc định của --[no]experimental_command_profile: "false"
Ghi lại hồ sơ CPU của Trình ghi chuyến bay Java vào tệp profile.jfr trong thư mục cơ sở đầu ra. Trong tương lai, cú pháp và ngữ nghĩa của cờ này có thể thay đổi để hỗ trợ nhiều loại hồ sơ hoặc định dạng đầu ra; bạn tự chịu rủi ro khi sử dụng.
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 thao tác ghi nhớ 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ả chức năng ghi nhớ.
Các tuỳ chọn chỉ định hoặc thay đổi dữ liệu đầu vào chung thành lệnh Bazel mà không thuộc các danh mục khác.:
Mặc định của --experimental_resolved_file_instead_of_workspace=<a string>: ""
Nếu nội dung không trống, hãy đọc tệp đã được phân giải được chỉ định thay vì tệp WORKSPACE
Các thẻ: changes_inputs
Các tuỳ chọn thực thi và lưu vào bộ nhớ đệm từ xa:
Mặc định của --experimental_downloader_config=<a string>: 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ủ (cho `allow` và `block`) hoặc hai mẫu, một mẫu để so khớp và một mẫu dùng làm URL thay thế, có tham chiếu ngược bắt đầu từ "$1". Có thể có nhiều lệnh "rewrite" cho cùng một URL và trong trường hợp này sẽ có nhiều URL được trả về.
Mặc định của --experimental_worker_for_repo_fetching=<off, platform or virtual>: "tắt"
Chế độ phân luồng dùng để tìm nạp kho lưu trữ. Nếu bạn đặt chính sách này thành "tắt", thì sẽ không có luồng worker nào được sử dụng và quá trình tìm nạp kho lưu trữ có thể khởi động lại. Ngược lại, hãy sử dụng luồng nền tảng (tức là luồng hệ điều hành) nếu được đặt thành "platform" hoặc luồng ảo nếu được đặt thành "virtual".
Các lựa chọn khác, không được phân loại.:
Đã tích luỹ --override_repository=<an equals-separated mapping of repository name to path> lần sử dụng
Ghi đè một 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à một đường dẫn tuyệt đối, thì đường dẫn đó sẽ được sử dụng nguyên vẹn. Nếu đường dẫn đã cho là một đườ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 này 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 "bazel thông tin không gian làm việc"
Các tuỳ chọn kiểm soát quá trình thực thi bản dựng:
Liệu có nên thực hiện lệnh gọi hệ thống tệp trực tiếp để tạo cây liên kết tượng trưng hay không
Các thẻ: loading_and_analysis, execution, experimental
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
Mặc định của --[no]experimental_remotable_source_manifests: "false"
Liệu có nên làm cho hành động trong tệp kê khai nguồn có thể điều khiển từ xa hay không
Các thẻ: loading_and_analysis, execution, experimental
Mặc định của --[no]experimental_split_coverage_postprocessing: "false"
Nếu đúng, Bazel sẽ chạy quá trình xử lý hậu kỳ về mức độ phù hợp để kiểm thử trong một quy trình tái tạo mới.
Thẻ: execution
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 mọi cấu phần phần mềm đầu ra là tệp thông thường. Chúng sẽ không truyền tải 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
Mặc định của --modify_execution_info=<regex=[+-]key,regex=[+-]key,...>: ""
Thêm hoặc xoá khoá khỏi thông tin thực thi của một hành động dựa trên tính năng ghi nhớ 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ự 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ách ghi nhớ. Cú pháp: "regex=[+-]key,regex=[+-]key,...". Ví dụ: ".*=+x,.*=-y,.*=+z" thêm "x" và "z" vào, đồng thời xoá "y" khỏi thông tin thực thi cho mọi hành động. 'Genquy=+requirements-x' sẽ thêm 'requirements-x' vào thông tin thực thi cho tất cả các hành động theo Quy tắc tạo sinh. '(?!GenRules).*=-requirements-x' sẽ xoá 'requires-x' khỏi thông tin thực thi cho mọi hành động không phải là Quy tắc.
Thẻ: execution, affects_outputs, loading_and_analysis
--persistent_android_dex_desugar
Kích hoạt các hành động tạo tệp 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
Hỗ trợ bộ xử lý tài nguyên Android ổn định bằng cách sử dụng trình thực thi (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=workerhost_machine_resource_optimizationsexecution
--persistent_multiplex_android_dex_desugar
Hỗ trợ các thao tác Android dex và đơn giản hoá ở chế độ ghép kênh liên tục bằng cách sử dụng trình thực thi (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
Cho phép bộ xử lý tài nguyên Android ghép kênh ổn định bằng cách sử dụng trình thực thi (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-workershost_machine_resource_optimizationsexecution
--persistent_multiplex_android_tools
Bật các công cụ Android đa năng và ổn định (tạo tệp dex, đơn giản hoá, 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
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:
Mặc định của --android_compiler=<a string>: xem nội dung mô tả
Trình biên dịch mục tiêu của Android.
Thẻ: affects_outputs, loading_and_analysis, loses_incremental_state
Mặc định của --android_crosstool_top=<a build target label>: "//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
Mặc định của --android_grte_top=<a label>: xem nội dung mô tả
Mục tiêu grte_top trên Android.
Thẻ: changes_inputs, loading_and_analysis, loses_incremental_state
Mặc định của --android_manifest_merger=<legacy, android or force_android>: "android"
Chọn trình hợp nhất tệp kê khai để sử dụng cho các quy tắc android_binary. Gắn 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
Mặc định của --android_platforms=<a build target label>: ""
Đặt 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à một APK lớn, chứa các tệp nhị phân gốc cho từng nền tảng đích được chỉ định.
Thẻ: changes_inputs, loading_and_analysis, loses_incremental_state
Giá trị mặc định của --android_sdk=<a build target label>: "@bazel_tools//tools/android:sdk"
Chỉ định SDK/nền tảng Android dùng để xây dựng ứng dụng Android.
Thẻ: changes_inputs, loading_and_analysis, loses_incremental_state
Giá trị mặc định của --apple_crosstool_top=<a build target label>: "@bazel_tools//tools/cpp:toolchain"
Nhãn của gói công cụ chéo sẽ được dùng trong các quy tắc Apple và Objc và phần phụ thuộc của các quy tắc này.
Thẻ: loses_incremental_state, changes_inputs
Mặc định của --cc_output_directory_tag=<a string>: ""
Chỉ định một hậu tố để thêm vào thư mục cấu hình.
Thẻ: affects_outputs
Mặc định của --compiler=<a string>: 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
Giá trị mặc định của --coverage_output_generator=<a build target label>: "@bazel_tools//tools/test:lcov_merger"
Vị trí của tệp nhị phân được dùng để báo cáo mức độ phù hợp thô sau khi xử lý. Đây phải là một nhóm tệp có chứa một tệp duy nhất, đó là tệp nhị phân. Giá trị mặc định là '//tools/test:lcov_merger'.
Thẻ: changes_inputs, affects_outputs, loading_and_analysis
Giá trị mặc định của --coverage_report_generator=<a build target label>: "@bazel_tools//tools/test:Coverage_report_generator"
Vị trí của tệp nhị phân được dùng để tạo báo cáo mức độ phù hợp. Đây phải là một nhóm tệp có chứa một tệp duy nhất, đó là tệp nhị phân. Giá trị mặc định là '//tools/test:Coverage_report_generator'.
Thẻ: changes_inputs, affects_outputs, loading_and_analysis
Giá trị mặc định của --coverage_support=<a build target label>: "@bazel_tools//tools/test:Coverage_support"
Vị trí của các tệp hỗ trợ bắt buộc đối với 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
Giá trị mặc định của --crosstool_top=<a build target label>: "@bazel_tools//tools/cpp:toolchain"
Nhãn của gói công cụ chéo dùng để biên dịch mã C++.
Thẻ: loading_and_analysis, changes_inputs, affects_outputs
Mặc định của --custom_malloc=<a build target label>: xem nội dung mô tả
Chỉ định phương thức triển khai Malloc tuỳ chỉnh. Chế độ cài đặt này ghi đè các thuộc tính Malloc trong quy tắc tạo bản dựng.
Thẻ: changes_inputs, affects_outputs
Đã tích luỹ --experimental_add_exec_constraints_to_targets=<a '<RegexFilter>=<label1>[,<label2>,...]' assignment> lần sử dụng
Danh sách các biểu thức chính quy được phân tách bằng dấu phẩy, mỗi biểu thức chính quy có tiền tố (không bắt buộc) là dấu - (biểu thức âm), được gán (=) cho một danh sách các mục tiêu giá trị ràng buộc được phân tách bằng dấu phẩy. Nếu một mục tiêu khớp với không có biểu thức âm nào và có ít nhất một biểu thức dương, thì quá trình phân giải chuỗi công cụ của mục tiêu sẽ được thực hiện như thể đã khai báo các giá trị ràng buộc dưới dạng các quy tắ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
Mặc định của --[no]experimental_include_xcode_execution_requirements: "false"
Nếu được đặt, hãy thêm yêu cầu thực thi "requires-xcode:{version}" vào mọi hành động trên Xcode. Nếu phiên bản xcode có nhãn có dấu gạch nối, hãy thêm cả yêu cầu thực thi "requires-xcode-label:{version_label}".
Thẻ: loses_incremental_state, loading_and_analysis, execution
Mặc định của --[no]experimental_prefer_mutual_xcode: "đúng"
Nếu đúng, hãy sử dụng Xcode mới nhất có sẵn cả trên máy và từ xa. Nếu giá trị là false hoặc nếu không có phiên bản nào cho nhau, hãy sử dụng phiên bản Xcode cục bộ đã chọn thông qua xcode-select.
Thẻ: loses_incremental_state
Mặc định của --extra_execution_platforms=<comma-separated list of options>: ""
Các nền tảng có thể sử dụng dưới dạng nền tảng thực thi để chạy các hành động. Các nền tảng có thể được chỉ định theo mục tiêu chính xác hoặc làm mẫu mục tiêu. Các nền tảng này sẽ được xem xét trước các 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 phiên bản sau này sẽ ghi đè chế độ cài đặt cờ trước đó.
Thẻ: execution
Đã tích luỹ --extra_toolchains=<comma-separated list of options> lần sử dụng
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ụ. Chuỗi công cụ có thể được chỉ định 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().
Các thẻ: affects_outputs, changes_inputs, loading_and_analysis
Mặc định của --grte_top=<a label>: xem nội dung mô tả
Nhãn cho thư viện libc đã xác nhận có mặt. Giá trị mặc định được chọn bởi chuỗi công cụ crosstool và bạn hầu như không bao giờ cần ghi đè giá trị đó.
Thẻ: action_command_lines, affects_outputs
Mặc định của --host_compiler=<a string>: xem nội dung mô tả
Trình biên dịch C++ dùng để biên dịch máy chủ. Thuộc tính này sẽ bị bỏ qua nếu bạn không đặt --host_crosstool_top.
Thẻ: loading_and_analysis, execution
Mặc định của --host_crosstool_top=<a build target label>: 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 executor. Nếu cờ này được cung cấp, Bazel sẽ sử dụng libc và trình biên dịch mặc định cho crosstool_top nhất định.
Thẻ: loading_and_analysis, changes_inputs, affects_outputs
Mặc định của --host_grte_top=<a label>: 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 exec.
Thẻ: action_command_lines, affects_outputs
Giá trị mặc định của --host_platform=<a build target label>: "@local_config_platform//:host"
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
Mặc định của --[no]incompatible_dont_enable_host_nonhost_crosstool_features: "đúng"
Nếu đúng, Bazel sẽ không bật các tính năng "host" (máy chủ) và "nonhost" (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
Mặc định của --[no]incompatible_enable_android_toolchain_resolution: "đúng"
Sử dụng độ phân giải của chuỗi công cụ để chọn SDK Android cho quy tắc Android (Starlark và gốc)
Thẻ: loading_and_analysis, incompatible_change
Mặc định của --[no]incompatible_enable_apple_toolchain_resolution: "false"
Sử dụng độ phân giải của chuỗi công cụ để chọn SDK Apple cho quy tắc Apple (Starlark và gốc)
Thẻ: loading_and_analysis, incompatible_change
Mặc định của --[no]incompatible_make_thinlto_command_lines_standalone: "đúng"
Nếu đúng, Bazel sẽ không sử dụng lại các dòng lệnh của thao tác liên kết C++ để lập chỉ mục 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
Mặc định của --[no]incompatible_remove_legacy_whole_archive: "đúng"
Nếu đúng, Bazel sẽ không liên kết các phần phụ thuộc của thư viện dưới dạng toàn bộ kho lưu trữ theo mặc định (xem https://github.com/bazelbuild/bazel/issues/7362 để biết hướng dẫn di chuyển).
Thẻ: loading_and_analysis, incompatible_change
Mặc định của --[no]incompatible_require_ctx_in_configure_features: "đúng"
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
Mặc định của --[no]interface_shared_objects: "đúng"
Sử dụng các đố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
Mặc định của --ios_sdk_version=<a dotted version (for example '2.3' or '3.3alpha2.4')>: xem nội dung mô tả
Chỉ định phiên bản của SDK iOS cần dùng để 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 qua "xcode_version".
Thẻ: loses_incremental_state
Mặc định của --macos_sdk_version=<a dotted version (for example '2.3' or '3.3alpha2.4')>: xem nội dung mô tả
Chỉ định phiên bản của SDK macOS sẽ dùng để xây dựng ứng dụng macOS. Nếu bạn không chỉ định, hãy sử dụng phiên bản SDK macOS mặc định qua "xcode_version".
Thẻ: loses_incremental_state
Mặc định của --minimum_os_version=<a string>: xem nội dung mô tả
Phiên bản hệ điều hành tối thiểu mà quá trình biên dịch nhắm đến.
Thẻ: loading_and_analysis, affects_outputs
Mặc định của --platform_mappings=<a relative path>: ""
Vị trí của tệp ánh xạ cho biết nền tảng nào sẽ được sử dụng nếu không có nền tảng nào được đặt hoặc cờ nào cần đặt khi đã có nền tảng. Phải tương ứng với thư mục gốc của không gian làm việc chính. Giá trị 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
Mặc định của --platforms=<a build target label>: ""
Nhãn của các quy tắc nền tảng mô tả nền tảng đích cho lệnh hiện tại.
Thẻ: affects_outputs, changes_inputs, loading_and_analysis
Mặc định của --python2_path=<a string>: xem nội dung mô tả
Ngừng sử dụng, không hoạt động. Bị vô hiệu hoá bởi "--incompatible_use_python_toolchains".
Các thẻ: no_op, deprecated
Mặc định của --python3_path=<a string>: xem nội dung mô tả
Ngừng sử dụng, không hoạt động. Bị vô hiệu hoá bởi "--incompatible_use_python_toolchains".
Các thẻ: no_op, deprecated
Mặc định của --python_path=<a string>: 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ởi --incompatible_use_python_toolchains.
Thẻ: loading_and_analysis, affects_outputs
Mặc định của --python_top=<a build target label>: 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ởi --incompatible_use_python_toolchains.
Thẻ: loading_and_analysis, affects_outputs
Mặc định của --tvos_sdk_version=<a dotted version (for example '2.3' or '3.3alpha2.4')>: xem nội dung mô tả
Chỉ định phiên bản của SDK tvOS dùng để tạo ứ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
Mặc định của --watchos_sdk_version=<a dotted version (for example '2.3' or '3.3alpha2.4')>: xem nội dung mô tả
Chỉ định phiên bản của SDK watchOS dùng để tạo các ứng dụng watchOS. Nếu bạn chưa chỉ định, hãy sử dụng phiên bản SDK watchOS mặc định từ "xcode_version".
Thẻ: loses_incremental_state
Mặc định của --xcode_version=<a string>: 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 hành động tạo liên quan. Nếu bạn không chỉ định, hãy sử dụng phiên bản Xcode mặc định cho trình thực thi của mình.
Thẻ: loses_incremental_state
Giá trị mặc định của --xcode_version_config=<a build target label>: "@bazel_tools//tools/cpp:host_xcodes"
Nhãn của quy tắc xcode_config được 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 kết quả của lệnh:
Mặc định của --[no]apple_generate_dsym: "false"
Liệu có nên tạo (các) tệp biểu tượng gỡ lỗi (.dSYM) hay không.
Thẻ: affects_outputs, action_command_lines
Nếu đúng, hãy tạo các khu rừng liên kết tượng trưng runfiles cho tất cả mục tiêu. Nếu giá trị là sai, chỉ ghi khi được yêu cầu bởi một thao tác cục bộ, lệnh kiểm tra hoặc chạy.
Thẻ: affects_outputs
Mặc định của --[no]build_runfile_manifests: "đúng"
Nếu đúng, hãy ghi tệp kê khai runfile cho tất cả mục tiêu. Nếu giá trị là false, hãy bỏ qua chúng. Các kiểm thử cục bộ sẽ không chạy được khi giá trị false.
Thẻ: affects_outputs
Mặc định của --[no]build_test_dwp: "false"
Nếu được bật, khi tạo kiểm thử C++ theo cách tĩnh và 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
Mặc định của --cc_proto_library_header_suffixes=<comma-separated set of options>: ".pb.h"
Đặt hậu tố cho các tệp tiêu đề mà cc_proto_library tạo.
Thẻ: affects_outputs, loading_and_analysis
Mặc định của --cc_proto_library_source_suffixes=<comma-separated set of options>: ".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
Mặc định của --[no]experimental_proto_descriptor_sets_include_source_info: "false"
Chạy thêm các thao tác cho các phiên bản API Java thay thế trong một proto_library.
Thẻ: affects_outputs, loading_and_analysis, experimental
Mặc định của --[no]experimental_proto_extra_actions: "false"
Chạy thêm các thao tác cho các phiên bản API Java thay thế trong một proto_library.
Thẻ: affects_outputs, loading_and_analysis, experimental
Mặc định của --[no]experimental_save_feature_state: "false"
Lưu trạng thái của các chức 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
Mặc định của --fission=<a set of compilation modes>: "không"
Chỉ định những chế độ biên dịch sử dụng quá trình phân tách cho các đường liên kết và nội dung biên dịch C++. Có thể là bất kỳ tổ hợp nào của {'fastbuild', 'dbg', 'opt'} hoặc giá trị đặc biệt "yes" để bật tất cả chế độ và "no" để tắt mọi chế độ.
Thẻ: loading_and_analysis, action_command_lines, affects_outputs
Mặc định của --[no]incompatible_always_include_files_in_data: "đúng"
Nếu đúng, các quy tắc gốc sẽ thêm <code>DefaultInfo.files</code> các phần phụ thuộc dữ liệu vào các tệp runfile của chúng, khớp với hành vi được đề xuất cho các quy tắc Starlark (https://bazel.build/ext hóa/rules#runfiles_features_to_avoid).
Thẻ: affects_outputs, incompatible_change
Mặc định của --[no]legacy_external_runfiles: "đúng"
Nếu đúng, hãy tạo các khu rừng liên kết tượng trưng runfiles cho các kho lưu trữ bên ngoài trong miền .runfiles/wsname/external/repo (ngoài .runfiles/repo).
Thẻ: affects_outputs
Mặc định của --[no]objc_generate_linkmap: "false"
Chỉ định xem có tạo tệp bản đồ liên kết hay không.
Thẻ: affects_outputs
Mặc định của --[no]save_temps: "false"
Nếu bạn đặt chính sách này, các kết quả tạm thời từ gcc sẽ được lưu. Những tệp này bao gồm tệp .s (mã tập hợp), tệp .i (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ự định, ảnh hưởng đến giá trị của kết quả đó, trái ngược với sự tồn tại của kết quả đó:
Đã tích luỹ --action_env=<a 'name=value' assignment with an optional value part> lần sử dụng
Chỉ định tập hợp 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 cặp tên=giá trị để đặt giá trị độc lập với môi trường gọi. Bạn có thể sử dụng lựa chọn này nhiều lần; đối với các lựa chọn được cung cấp cho cùng một biến, các chiến thắng gần đây nhất, các lựa chọn cho các biến khác nhau sẽ tích luỹ.
Thẻ: action_command_lines
Giá trị mặc định của --android_cpu=<a string>: "armeabi-v7a"
CPU mục tiêu của Android.
Thẻ: affects_outputs, loading_and_analysis, loses_incremental_state
Mặc định của --[no]android_databinding_use_androidx: "đúng"
Tạo các tệp liên kết dữ liệu tương thích với AndroidX. Tính năng này chỉ được sử dụng với tính năng liên kết dữ liệu phiên bản 2. Cờ này không hoạt động.
Các thẻ: affects_outputs, loading_and_analysis, loses_incremental_state, experimental
Mặc định của --[no]android_databinding_use_v3_4_args: "đúng"
Sử dụng tính năng liên kết dữ liệu của Android phiên bản 2 với đối số 3.4.0. Cờ này không hoạt động.
Các thẻ: affects_outputs, loading_and_analysis, loses_incremental_state, experimental
Mặc định của --android_dynamic_mode=<off, default or fully>: "tắt"
Xác định xem phần phụ thuộc C++ của các quy tắc Android có được liên kết động hay không khi cc_binary không tạo thư viện dùng chung một cách rõ ràng. "default" 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ế độ chủ yếu là tĩnh.
Thẻ: affects_outputs, loading_and_analysis
Giá trị mặc định của --android_manifest_merger_order=<alphabetical, alphabetical_by_configuration or dependency>: "theo thứ tự bảng chữ cái"
Đặt thứ tự các tệp kê khai được chuyển đến trình hợp nhất tệp kê khai cho tệp nhị phân Android. ALPHABETICAL có nghĩa là các tệp kê khai được sắp xếp theo đường dẫn tương ứng với tệp thực thi. ALPHABETICAL_BY_CONFIGURATION 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 có nghĩa là các tệp kê khai được sắp xếp theo thứ tự với tệp kê khai của từng thư viện xuất hiện trước tệp kê khai của các phần phụ thuộc.
Thẻ: action_command_lines, execution
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 APK android_binary sử dụng ProGuard.
Thẻ: affects_outputs, loading_and_analysis
Mặc định của --[no]build_python_zip: "tự động"
Tạo tệp zip có thể thực thi cho python; trên Windows, tắt trên các nền tảng khác
Thẻ: affects_outputs
Đã tích luỹ --catalyst_cpus=<comma-separated list of options> lần sử dụng
Danh sách 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
Mặc định của --[no]collect_code_coverage: "false"
Nếu được chỉ định, Bazel sẽ đo lường mã (sử dụng khả năng đo lường ngoại tuyến nếu có thể) và sẽ thu thập thông tin về mức độ phù hợp trong quá trình kiểm thử. Chỉ những mục tiêu khớp với --Instrumentation_filter sẽ 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 mà nên sử dụng lệnh 'bazel Coverage' để thay thế.
Thẻ: affects_outputs
--compilation_mode=<fastbuild, dbg or opt> [-c] mặc định: "fastbuild"
Chỉ định chế độ mà bạn sẽ tạo tệp nhị phân. Giá trị: "fastbuild", "dbg", "opt".
Thẻ: affects_outputs, action_command_lines
Đã tích luỹ --conlyopt=<a string> lần sử dụng
Tuỳ chọn bổ sung để chuyển đến gcc khi biên dịch tệp nguồn C.
Thẻ: action_command_lines, affects_outputs
Đã tích luỹ --copt=<a string> lần sử dụng
Các tuỳ chọn bổ sung để chuyển đến gcc.
Thẻ: action_command_lines, affects_outputs
Mặc định của --cpu=<a string>: ""
CPU mục tiêu.
Thẻ: changes_inputs, affects_outputs
Mặc định của --cs_fdo_absolute_path=<a string>: 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 cấu hình, tệp cấu hình LLVM thô hoặc đã được lập chỉ mục.
Thẻ: affects_outputs
Mặc định của --cs_fdo_instrument=<a string>: xem nội dung mô tả
Tạo tệp nhị phân có khả năng đo lường FDO theo bối 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à theo đó(các) tệp cấu hình thô sẽ được kết xuất trong thời gian chạy.
Thẻ: affects_outputs
Mặc định của --cs_fdo_profile=<a build target label>: xem nội dung mô tả
cs_fdo_profile đại diện cho hồ sơ có phân biệt ngữ cảnh dùng để tối ưu hoá.
Thẻ: affects_outputs
Đã tích luỹ --cxxopt=<a string> lần sử dụng
Tuỳ chọn bổ sung để chuyển đến gcc khi biên dịch tệp nguồn C++.
Thẻ: action_command_lines, affects_outputs
Đã tích luỹ --define=<a 'name=value' assignment> lần sử dụng
Mỗi tuỳ chọn --define chỉ định việc gán cho một biến bản dựng.
Thẻ: changes_inputs, affects_outputs
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. "default" có nghĩa là Bazel sẽ chọn có liên kết linh hoạt 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ế độ chủ yếu là tĩnh.
Thẻ: loading_and_analysis, affects_outputs
Mặc định của --[no]enable_fdo_profile_absolute_path: "đúng"
Nếu bạn đặt chính sách này, việc sử dụng fdo_absolute_profile_path sẽ gây ra lỗi.
Thẻ: affects_outputs
Mặc định của --[no]enable_runfiles: "tự động"
Bật cây liên kết tượng trưng runfile. Theo mặc định, cây này sẽ bị tắt trên Windows và trên các nền tảng khác.
Thẻ: affects_outputs
Đã tích luỹ --experimental_action_listener=<a build target label> lần sử dụng
Ngừng sử dụng và thay vào đó là một số khía cạnh. Sử dụng action_listener để đính kèm thêm một hành động phụ vào các hành động tạo bản dựng hiện có.
Thẻ: execution, experimental
Mặc định của --[no]experimental_android_compress_java_resources: "false"
Nén tài nguyên Java trong tệp APK
Các thẻ: affects_outputs, loading_and_analysis, experimental
Mặc định của --[no]experimental_android_databinding_v2: "đúng"
Sử dụng tính năng liên kết dữ liệu của Android phiên bản 2. Cờ này không hoạt động.
Các thẻ: affects_outputs, loading_and_analysis, loses_incremental_state, experimental
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 APK android_binary sử dụng ProGuard.
Thẻ: affects_outputs, loading_and_analysis
Mặc định của --[no]experimental_android_rewrite_dexes_with_rex: "false"
dùng công cụ rex để ghi lại tệp dex
Các thẻ: affects_outputs, loading_and_analysis, loses_incremental_state, experimental
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 về phạm vi thu thập cho các tệp được tạo.
Thẻ: affects_outputs
Mặc định của --experimental_objc_fastbuild_options=<comma-separated list of options>: "-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
Mặc định của --[no]experimental_omitfp: "false"
Nếu đúng, hãy sử dụng libunwind để tháo dỡ ngăn xếp (stack) và biên dịch bằng -fomit-frame-pointer và -faasync-unwind-tables.
Thẻ: action_command_lines, affects_outputs, experimental
Mặc định của --experimental_output_paths=<off, content or strip>: "tắt"
Mô hình cần sử dụng để ghi kết quả đầu ra trong quy tắc cây đầu ra, đặc biệt là cho các bản dựng đa nền tảng / nhiều cấu hình. Đây là tính năng mang tính thử nghiệm cao. Truy cập https://github.com/bazelbuild/bazel/issues/6526 để biết chi tiết. Các hành động Starlark có thể chọn ánh xạ đường dẫn bằng cách thêm khoá "supports-path-mapping" vào lệnh "execution_requirements".
Thẻ: loses_incremental_state, bazel_internal_configuration, affects_outputs, execution
Đã tích luỹ --experimental_override_name_platform_in_output_dir=<a 'label=value' assignment> lần sử dụng
Mỗi mục nhập phải có dạng label=value, trong đó nhãn chỉ một nền tảng và giá trị là tên viết tắt mong muốn để sử dụng trong đường dẫn đầu ra. Chỉ được sử dụng khi --experimental_platform_in_output_dir là giá trị true. Có mức độ ưu tiên đặt tên cao nhất.
Thẻ: affects_outputs, experimental
Mặc định của --[no]experimental_platform_in_output_dir: "false"
Nếu đúng, tên viết tắt của nền tảng mục tiêu sẽ được sử dụng trong tên thư mục đầu ra thay vì CPU. Lược đồ chính xác đang thử nghiệm và có thể thay đổi: Trước tiên, trong trường hợp hiếm gặp, tuỳ chọn --platforms không có chính xác một giá trị, hàm băm của tuỳ chọn nền tảng sẽ được sử dụng. Tiếp theo, nếu bất kỳ tên viết tắt nào cho nền tảng hiện tại đã được đăng ký --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_heuristics đã đặt, 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 được dùng làm phương án cuối cùng.
Thẻ: affects_outputs, experimental
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 đồ phủ sóng llvm-cov thay vì gcov khi collection_code_Coverage được bật.
Thẻ: changes_inputs, affects_outputs, loading_and_analysis, experimental
Mặc định của --[no]experimental_use_platforms_in_output_dir_legacy_heuristic: "đúng"
Vui lòng chỉ sử dụng cờ này cho chiến lược di chuyển hoặc thử nghiệm đượ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
Giá trị mặc định của --fat_apk_cpu=<comma-separated set of options>: "armeabi-v7a"
Việc đặt tuỳ chọn này sẽ bật các APK lớn, chứa các tệp nhị phân gốc cho tất cả cấu trúc mục tiêu đã chỉ định, ví dụ: --fat_apk_cpu=x86,armeabi-v7a. Nếu cờ này được chỉ định, 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
Mặc định của --[no]fat_apk_hwasan: "false"
Liệu có tạo phần phân tách HWASAN hay không.
Thẻ: affects_outputs, loading_and_analysis, loses_incremental_state
Mặc định của --fdo_instrument=<a string>: 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à theo đó(các) tệp cấu hình thô sẽ được kết xuất trong thời gian chạy.
Thẻ: affects_outputs
Mặc định của --fdo_optimize=<a string>: 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 cấu hình LLVM. Cờ này cũng chấp nhận các tệp được chỉ định dưới dạng nhãn (ví dụ: "//foo/bar:file.afdo" – bạn có thể cần phải 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
Mặc định của --fdo_prefetch_hints=<a build target label>: xem nội dung mô tả
Sử dụng gợi ý tìm nạp trước bộ nhớ đệm.
Thẻ: affects_outputs
Mặc định của --fdo_profile=<a build target label>: xem nội dung mô tả
Fdo_profile đại diện cho hồ sơ dùng để tối ưu hoá.
Thẻ: affects_outputs
Đã tích luỹ --features=<a string> lần sử dụng
Theo mặc định, các tính năng cụ thể sẽ được bật hoặc tắt cho các mục tiêu được tạo trong cấu hình mục tiêu. Khi bạn chỉ định -<feature>, tính năng này sẽ tắt. Các tính năng tiêu cực luôn được ưu tiên hơn các tính năng khẳng định. Xem thêm --host_features
Các thẻ: changes_inputs, affects_outputs
Mặc định của --[no]force_pic: "false"
Nếu được bật, tất cả nội dung biên dịch C++ đều tạo mã độc lập về vị trí ("-fPIC"), các đường liên kết sẽ ưu tiên thư viện tạo sẵn PIC hơn so với thư viện không phải PIC và đường liên kết tạo ra các tệp thực thi độc lập về vị trí ("-pie").
Thẻ: loading_and_analysis, affects_outputs
Đã tích luỹ --host_action_env=<a 'name=value' assignment with an optional value part> lần sử dụng
Chỉ định tập hợp 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 cặp tên=giá trị để đặt giá trị độc lập với môi trường gọi. Bạn có thể sử dụng lựa chọn này nhiều lần; đối với các lựa chọn được cung cấp cho cùng một biến, các chiến thắng gần đây nhất, các lựa chọn cho các biến khác nhau sẽ tích luỹ.
Thẻ: action_command_lines
Mặc định của --host_compilation_mode=<fastbuild, dbg or opt>: "opt"
Chỉ định chế độ mà các công cụ dùng trong quá trình tạo bản dựng sẽ được tích hợp. Giá trị: "fastbuild", "dbg", "opt".
Thẻ: affects_outputs, action_command_lines
Đã tích luỹ --host_conlyopt=<a string> lần sử dụng
Tuỳ chọn bổ sung để chuyể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 executor.
Thẻ: action_command_lines, affects_outputs
Đã tích luỹ --host_copt=<a string> lần sử dụng
Các tuỳ chọn bổ sung để truyền đến trình biên dịch C đối với các công cụ được tạo trong cấu hình executor.
Thẻ: action_command_lines, affects_outputs
Mặc định của --host_cpu=<a string>: ""
CPU của máy chủ.
Thẻ: changes_inputs, affects_outputs
Đã tích luỹ --host_cxxopt=<a string> lần sử dụng
Các tuỳ chọn bổ sung để chuyển đến trình biên dịch C++ đối với các công cụ được tạo trong cấu hình executor.
Thẻ: action_command_lines, affects_outputs
Đã tích luỹ --host_features=<a string> lần sử dụng
Theo mặc định, các tính năng cụ thể sẽ được bật hoặc tắt đối với các mục tiêu được xây dựng trong cấu hình thực thi. Khi bạn chỉ định -<feature>, tính năng này sẽ tắt. Các tính năng tiêu cực luôn được ưu tiên hơn các tính năng khẳng định.
Thẻ: changes_inputs, affects_outputs
Mặc định của --host_force_python=<PY2 or PY3>: xem nội dung mô tả
Ghi đè phiên bản Python cho cấu hình executor. Có thể là "PY2" hoặc "PY3".
Thẻ: loading_and_analysis, affects_outputs
Đã tích luỹ --host_linkopt=<a string> lần sử dụng
Tuỳ chọn bổ sung để chuyển tới trình liên kết khi liên kết các công cụ trong cấu hình tệp thực thi.
Thẻ: action_command_lines, affects_outputs
Mặc định của --host_macos_minimum_os=<a dotted version (for example '2.3' or '3.3alpha2.4')>: xem nội dung mô tả
Phiên bản macOS tương thích tối thiểu cho mục tiêu máy chủ lưu trữ. Nếu không chỉ định, hãy sử dụng "macos_sdk_version".
Thẻ: loses_incremental_state
Đã tích luỹ --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> lần sử dụng
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 tệp thực thi. Bạn có thể chuyển tuỳ chọn này nhiều lần. Cú pháp: regex_filter@uỳ chọn 1,tuỳ chọn 2,...,tuỳ chọn n. Trong đó regex_filter là viết tắt của 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). options_1 thành options_n là viết tắt của các tuỳ chọn dòng lệnh tuỳ ý. Nếu một tuỳ chọn có chứa dấu phẩy, thì nó phải được đặt cùng với dấu gạch chéo ngược. Các tuỳ chọn có thể chứa @. Chỉ dùng @ đầu tiên để 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 mọi tệp cc trong //foo/ ngoại trừ bar.cc.
Thẻ: action_command_lines, affects_outputs
Đã tích luỹ --host_swiftcopt=<a string> lần sử dụng
Các tuỳ chọn bổ sung để chuyển đến swiaccounts để dùng cho các công cụ thực thi.
Thẻ: action_command_lines, affects_outputs
Mặc định của --[no]incompatible_auto_exec_groups: "false"
Khi được bật, hệ thống sẽ tự động tạo một nhóm thực thi cho mỗi chuỗi công cụ mà quy tắc sử dụng. Để làm được điều này, quy tắc cần chỉ định tham số "toolchain" (chuỗi công cụ) trên các thao tác của quy tắc. Để biết thêm thông tin, hãy tham khảo tại https://github.com/bazelbuild/bazel/issues/17134.
Thẻ: affects_outputs, incompatible_change
Mặc định của --[no]incompatible_merge_genfiles_directory: "đúng"
Nếu đúng, thư mục genfiles sẽ được gấp vào thư mục bin.
Thẻ: affects_outputs, incompatible_change
Mặc định của --[no]incompatible_use_host_features: "đúng"
Nếu đúng, hãy sử dụng --features chỉ cho cấu hình mục tiêu và --host_features cho cấu hình exec.
Thẻ: changes_inputs, affects_outputs, incompatible_change
Mặc định của --[no]instrument_test_targets: "false"
Khi bật mức độ sử dụng, hãy chỉ định xem có cần xem xét các quy tắc kiểm thử đo lường hay không. Khi được đặt, các quy tắc kiểm thử có trong --Instrumentation_filter 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 khả năng đo lường mức độ sử dụng.
Thẻ: affects_outputs
Mặc định của --instrumentation_filter=<a comma-separated list of regex expressions with prefix '-' specifying excluded paths>: "-/javatests[/:],-/test/java[/:]"
Khi bạn bật mức độ phù hợp, chỉ những quy tắc có tên có trong bộ lọc dựa trên biểu thức chính quy được chỉ định mới được đo lường. Thay vào đó, các quy tắc có tiền tố '-' 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ật --Instrument_test_targets.
Thẻ: affects_outputs
Mặc định của --ios_minimum_os=<a dotted version (for example '2.3' or '3.3alpha2.4')>: 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
Đã tích luỹ --ios_multi_cpus=<comma-separated list of options> lần sử dụng
Danh sách kiến trúc được phân tách bằng dấu phẩy để tạo ứng dụng ios. Kết quả là một tệp nhị phân chung chứa tất cả cấu trúc được chỉ định.
Thẻ: loses_incremental_state, loading_and_analysis
Mặc định của --[no]legacy_whole_archive: "đúng"
Không dùng nữa, thay thế bằng --incompatible_remove_legacy_wiling_ lưu (xem https://github.com/bazelbuild/bazel/issues/7362 để biết thông tin chi tiết). Khi bật, hãy sử dụng --w Nhà lưu trữ cho các quy tắc cc_binary có linkshared=True và linkstatic=True hoặc '-static' trong linkopts. Thao tác này chỉ dành cho khả năng tương thích ngược. Một cách khác hay hơn là sử dụng Alwayslink=1 nếu cần.
Thẻ: action_command_lines, affects_outputs, deprecated
Đã tích luỹ --linkopt=<a string> lần sử dụng
Tuỳ chọn bổ sung để chuyển đến gcc khi liên kết.
Thẻ: action_command_lines, affects_outputs
Đã tích luỹ --ltobackendopt=<a string> lần sử dụng
Tuỳ chọn bổ sung để chuyển đến bước phụ trợ LTO (trong phần --features=thin_lto).
Thẻ: action_command_lines, affects_outputs
Đã tích luỹ --ltoindexopt=<a string> lần sử dụng
Tuỳ chọn bổ sung để chuyển đến bước lập chỉ mục LTO (trong phần --features=thin_lto).
Thẻ: action_command_lines, affects_outputs
Đã tích luỹ --macos_cpus=<comma-separated list of options> lần sử dụng
Danh sách 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
Mặc định của --macos_minimum_os=<a dotted version (for example '2.3' or '3.3alpha2.4')>: xem nội dung mô tả
Phiên bản macOS tương thích tối thiểu cho mục tiêu. Nếu không chỉ định, hãy sử dụng "macos_sdk_version".
Thẻ: loses_incremental_state
Mặc định của --memprof_profile=<a build target label>: xem nội dung mô tả
Sử dụng hồ sơ memprof.
Thẻ: affects_outputs
Mặc định của --[no]objc_debug_with_GLIBCXX: "false"
Nếu bạn đặt chế độ này và chế độ biên dịch được đặt thành "dbg", hãy xác định GLIBCXX_DEBUG, GLIBCXX_DEBUG_PEDANTIC và GLIBCPP_Segment_ nỗ lực.
Thẻ: action_command_lines
Mặc định của --[no]objc_enable_binary_stripping: "false"
Liệu có nên thực hiện việc loại bỏ biểu tượng và mã cụ thể trên các tệp nhị phân được liên kết hay không. Quá trình xoá 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
Đã tích luỹ --objccopt=<a string> lần sử dụng
Các tuỳ chọn bổ sung để chuyển đến gcc khi biên dịch tệp nguồn Objective-C/C++.
Thẻ: action_command_lines
Đã tích luỹ --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> lần sử dụng
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ể chuyển tuỳ chọn này nhiều lần. Cú pháp: regex_filter@uỳ chọn 1,tuỳ chọn 2,...,tuỳ chọn n. Trong đó regex_filter là viết tắt của 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). options_1 thành options_n là viết tắt của các tuỳ chọn dòng lệnh tuỳ ý. Nếu một tuỳ chọn có chứa dấu phẩy, thì nó phải được đặt cùng với dấu gạch chéo ngược. Các tuỳ chọn có thể chứa @. Chỉ dùng @ đầu tiên để 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 mọi tệp cc trong //foo/ ngoại trừ bar.cc.
Thẻ: action_command_lines, affects_outputs
Đã tích luỹ --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> lần sử dụng
Các tuỳ chọn bổ sung để truyền có chọn lọc đến phần phụ trợ LTO (trong phần --features=thin_lto) khi biên dịch một số đối tượng phụ trợ nhất định. Bạn có thể chuyển tuỳ chọn này nhiều lần. Cú pháp: regex_filter@uỳ chọn 1,tuỳ chọn 2,...,tuỳ chọn n. Trong đó regex_filter là viết tắt của danh sách các mẫu biểu thức chính quy bao gồm và loại trừ. options_1 thành options_n là viết tắt của các tùy chọn dòng lệnh tùy ý. Nếu một tuỳ chọn có chứa dấu phẩy, thì nó phải được đặt cùng với dấu gạch chéo ngược. Các tuỳ chọn có thể chứa @. Chỉ dùng @ đầu tiên để phân tách chuỗi. Ví dụ: --per_file_ltobackendopt=//foo/.*\.o,-//foo/bar\.o@-O0 thêm tuỳ chọn dòng lệnh -O0 vào dòng lệnh phụ trợ LTO của mọi tệp trong //foo/ ngoại trừ bar.o.
Thẻ: action_command_lines, affects_outputs
Mặc định của --platform_suffix=<a string>: xem nội dung mô tả
Chỉ định một hậu tố để thêm vào thư mục cấu hình.
Thẻ: loses_incremental_state, affects_outputs, loading_and_analysis
Mặc định của --propeller_optimize=<a build target label>: xem nội dung mô tả
Sử dụng thông tin hồ sơ cánh quạt để tối ưu hoá mục tiêu bản dựng.Mỗi hồ sơ cánh quạt 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 một nhãn bản dựng phải tham chiếu đến các tệp nhập 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",) Bạn có thể phải thêm lệnh export_files vào gói tương ứng để hiển thị các tệp này cho Bazel. Bạn phải sử dụng tuỳ chọn này dưới dạng: --propeller_optimize=//a/b:propeller_profile
Thẻ: action_command_lines, affects_outputs
Mặc định của --propeller_optimize_absolute_cc_profile=<a string>: 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á cho cánh quạt.
Thẻ: affects_outputs
Mặc định của --propeller_optimize_absolute_ld_profile=<a string>: 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á cho cánh quạt.
Thẻ: affects_outputs
Mặc định của --run_under=<a prefix in front of command>: xem nội dung mô tả
Tiền tố để chèn vào trước tệp thực thi cho lệnh "test" và "run". 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ụ là: 'valgrind', 'strace', 'strace -c', 'valgrind --quiet --num-callers=20', '//package:target', '//package:target --options'.
Thẻ: action_command_lines
Mặc định của --[no]share_native_deps: "đúng"
Nếu đúng, các thư viện gốc chứa chức năng giống nhau sẽ được chia sẻ giữa các mục tiêu khác nhau
Thẻ: loading_and_analysis, affects_outputs
Mặc định của --[no]stamp: "false"
Đánh dấu tệp nhị phân kèm theo ngày, tên người dùng, tên máy chủ, thông tin không gian làm việc, v.v.
Thẻ: affects_outputs
Mặc định của --strip=<always, sometimes or never>: "thỉnh thoảng"
Chỉ định xem có loại bỏ các tệp nhị phân và thư viện dùng chung hay không (bằng cách sử dụng "-Wl,--strip-debug"). Giá trị mặc định của "đôi khi" có nghĩa là loại bỏ iff --compilation_mode=fastbuild.
Thẻ: affects_outputs
Đã tích luỹ --stripopt=<a string> lần sử dụng
Các tuỳ chọn bổ sung cần truyền để xoá khi tạo tệp nhị phân "<name>.stripped".
Thẻ: action_command_lines, affects_outputs
Đã tích luỹ --swiftcopt=<a string> lần sử dụng
Các tuỳ chọn bổ sung để chuyển đến quá trình biên dịch Swift.
Thẻ: action_command_lines
Đã tích luỹ --tvos_cpus=<comma-separated list of options> lần sử dụng
Danh sách kiến trúc được phân tách bằng dấu phẩy cần tạo tệp nhị phân tvOS của Apple.
Thẻ: loses_incremental_state, loading_and_analysis
Mặc định của --tvos_minimum_os=<a dotted version (for example '2.3' or '3.3alpha2.4')>: xem nội dung mô tả
Phiên bản tvOS 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 "tvos_sdk_version".
Thẻ: loses_incremental_state
Đã tích luỹ --visionos_cpus=<comma-separated list of options> lần sử dụng
Danh sách được phân tách bằng dấu phẩy gồm các kiến trúc để tạo tệp nhị phân ApplevisionOS.
Thẻ: loses_incremental_state, loading_and_analysis
Đã tích luỹ --watchos_cpus=<comma-separated list of options> lần sử dụng
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
Mặc định của --watchos_minimum_os=<a dotted version (for example '2.3' or '3.3alpha2.4')>: xem nội dung mô tả
Phiên bản watchOS 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 "watchos_sdk_version".
Thẻ: loses_incremental_state
Mặc định của --xbinary_fdo=<a build target label>: 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ơ 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, thì các tuỳ chọn đó sẽ luôn được ưu tiên như thể xbinary_fdo không được chỉ định.
Thẻ: affects_outputs
Các tuỳ chọn ảnh hưởng đến mức độ nghiêm ngặt của Bazel thực thi các đầu vào hợp lệ của bản dựng (định nghĩa quy tắc, tổ hợp cờ, v.v.):
Mặc định của --auto_cpu_environment_group=<a build target label>: ""
Khai báo Environmental_group để tự động ánh xạ các giá trị cpu đến giá trị target_environment.
Thẻ: changes_inputs, loading_and_analysis, experimental
Mặc định của --[no]check_licenses: "false"
Kiểm tra để đảm bảo rằng những quy tắc ràng buộc về việc cấp 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 xây dựng. Theo mặc định, giấy phép sẽ không được chọn.
Thẻ: build_file_semantics
Mặc định của --[no]check_visibility: "đúng"
Nếu bạn tắt chính sách này, các lỗi về chế độ hiển thị trong các phần phụ thuộc mục tiêu sẽ bị giảm hạng xuống cảnh báo.
Thẻ: build_file_semantics
Mặc định của --[no]desugar_for_android: "đúng"
Liệu có nên đơ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
Mặc định của --[no]desugar_java8_libs: "false"
Liệu có nên đưa thư viện Java 8 được hỗ trợ vào ứng dụng dành cho thiết bị cũ hay không.
Thẻ: affects_outputs, loading_and_analysis, loses_incremental_state, experimental
Mặc định của --[no]enforce_constraints: "đúng"
Kiểm tra các môi trường tương thích với từng mục tiêu và báo cáo lỗi nếu có mục tiêu có các phần phụ thuộc không hỗ trợ cùng một môi trường
Thẻ: build_file_semantics
Mặc định của --[no]experimental_check_desugar_deps: "đúng"
Xem có nên kiểm tra kỹ quá trình đơn giản hoá chính xác ở cấp độ tệp nhị phân của Android hay không.
Thẻ: eagerness_to_exit, loading_and_analysis, experimental
Mặc định của --experimental_import_deps_checking=<off, warning or error>: "TẮT"
Khi được bật, hãy kiểm tra xem các phần phụ thuộc của một aar_import đã hoàn tất hay chưa. Thao tác thực thi này có thể phá vỡ bản dựng hoặc có thể chỉ dẫn đến cảnh báo.
Thẻ: loading_and_analysis
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 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
Mặc định của --[no]incompatible_check_testonly_for_output_files: "false"
Nếu được bật, hãy chỉ kiểm tra các mục tiêu tiên quyết là tệp đầu ra bằng cách chỉ tra cứu kiểm thử của quy tắc tạo. Điều này phù hợp với việc kiểm tra chế độ hiển thị.
Thẻ: build_file_semantics, incompatible_change
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 sẽ áp dụng cho các hoạt động triển khai chuỗi công cụ.
Thẻ: build_file_semantics, incompatible_change
Mặc định của --[no]incompatible_disable_native_android_rules: "false"
Nếu bạn bật chính sách này, thì chế độ sử dụng trực tiếp các quy tắc gốc của Android sẽ bị tắt. Vui lòng sử dụng quy tắc Android Starlark từ https://github.com/bazelbuild/rules_android
Các thẻ: eagerness_to_exit, incompatible_change
Mặc định của --[no]incompatible_disable_native_apple_binary_rule: "false"
Không hoạt động. Hãy giữ lại ở đây để có khả năng tương thích ngược.
Thẻ: eagerness_to_exit, incompatible_change
Mặc định của --[no]incompatible_python_disable_py2: "đúng"
Nếu đúng, việc sử dụng chế độ cài đặt Python 2 sẽ gây ra lỗi. Điều này bao gồm python_version=PY2, srcs_version=PY2 và srcs_version=PY2ONLY. Hãy tham khảo tại https://github.com/bazelbuild/bazel/issues/15684 để biết thêm thông tin.
Thẻ: loading_and_analysis, incompatible_change
Mặc định của --[no]incompatible_validate_top_level_header_inclusions: "đúng"
Nếu đúng, Bazel cũng sẽ xác thực việc đưa vào tiêu đề thư mục cấp cao nhất (xem https://github.com/bazelbuild/bazel/issues/10047 để biết thêm thông tin).
Thẻ: loading_and_analysis, incompatible_change
Mặc định của --python_native_rules_allowlist=<a build target label>: 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
Mặc định của --[no]strict_filesets: "false"
Nếu bạn bật tuỳ chọn này, thì các tập hợp tệp vượt qua ranh giới gói sẽ được báo cáo là lỗi.
Thẻ: build_file_semantics, eagerness_to_exit
Mặc định của --strict_proto_deps=<off, warn, error, strict or default>: "lỗi"
Trừ phi TẮT, hãy kiểm tra để đảm bảo 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 trực tiếp dưới dạng phần phụ thuộc.
Thẻ: build_file_semantics, eagerness_to_exit, incompatible_change
Mặc định của --strict_public_imports=<off, warn, error, strict or default>: "tắt"
Trừ phi TẮT, hãy kiểm tra để đảm bảo mục tiêu proto_library khai báo rõ ràng tất cả các mục tiêu được dùng trong phần "nhập công khai" là đã xuất.
Thẻ: build_file_semantics, eagerness_to_exit, incompatible_change
Mặc định của --[no]strict_system_includes: "false"
Nếu đúng, các tiêu đề tìm thấy qua hệ thống bao gồm các đường dẫn (-isystem) cũng phải khai báo.
Thẻ: loading_and_analysis, eagerness_to_exit
Đã tích luỹ --target_environment=<a build target label> lần sử dụng
Khai báo môi trường mục tiêu của bản dựng này. Phải là giá trị tham chiếu nhãn đến quy tắc "môi trường". Nếu được chỉ định, tất cả cá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 bản dựng:
Mặc định của --apk_signing_method=<v1, v2, v1_v2 or v4>: "v1_v2"
Cách triển khai để dùng để ký tệp APK
Các thẻ: action_command_lines, affects_outputs, loading_and_analysis
Mặc định của --[no]device_debug_entitlements: "đúng"
Nếu bạn đặt chính sách này và chế độ biên dịch không phải là "chọn", thì các ứng dụng objc sẽ bao gồm các quyền gỡ lỗi khi ký.
Thẻ: changes_inputs
Mặc định của --ios_signing_cert_name=<a string>: xem nội dung mô tả
Tên chứng chỉ dùng cho hoạt động ký iOS. Nếu bạn không đặt chính sách này, 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 mã ký mã (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 có thể truy cập vào tệp BUILD, tệp .bzl hoặc tệp WORKSPACE.:
Mặc định của --[no]incompatible_disallow_legacy_py_provider: "đúng"
Không hoạt động, sẽ sớm bị xoá.
Thẻ: loading_and_analysis, incompatible_change
Mặc định của --[no]incompatible_disallow_sdk_frameworks_attributes: "false"
Nếu đúng, hãy không cho phép các thuộc tính sdk_frameworks và weak_sdk_frameworks trong objc_library andobjc_import.
Thẻ: build_file_semantics, incompatible_change
Nếu đúng, đặt giá trị mặc định là true cho các thuộc tính luôn liên kết trong objc_library và objc_import.
Thẻ: build_file_semantics, incompatible_change
Mặc định của --[no]incompatible_python_disallow_native_rules: "false"
Khi đúng, lỗi sẽ xảy ra khi sử dụng quy tắc py_* tích hợp; thay vào đó, bạn nên sử dụng quy tắc Rule_python. Hãy truy cập 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 chi phối hành vi của môi trường kiểm thử hoặc trình chạy kiểm thử:
Mặc định của --[no]allow_analysis_failures: "false"
Nếu đúng, lỗi phân tích của mục tiêu quy tắc sẽ dẫn đến việc mục tiêu truyền tải một thực thể của AnalysisFailureInfo có chứa nội dung mô tả lỗi, thay vì 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ó lượt 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 liên quan đến quy tắc.
Thẻ: loading_and_analysis
Mặc định của --[no]break_build_on_parallel_dex2oat_failure: "false"
Nếu các thao tác dex2oat thực sự không thành công sẽ khiến bản dựng bị hỏng thay vì thực thi dex2oat trong thời gian chạy kiểm thử.
Thẻ: loading_and_analysis, experimental
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
Mặc định của --[no]ios_memleaks: "false"
Bật tính năng kiểm tra rò rỉ bộ nhớ trong mục tiêu ios_test.
Thẻ: action_command_lines
Mặc định của --ios_simulator_device=<a string>: xem nội dung mô tả
Thiết bị để mô phỏng khi chạy một ứng dụng iOS trong trình mô phỏng, ví dụ như "iPhone 6". Bạn có thể lấy danh sách thiết bị bằng cách chạy "xcrun simctl list devicetypes" trên máy mà trình mô phỏng sẽ chạy.
Thẻ: test_runner
Mặc định của --ios_simulator_version=<a dotted version (for example '2.3' or '3.3alpha2.4')>: 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ử. Hành động này sẽ bị bỏ qua đối với quy tắc ios_test nếu thiết bị mục tiêu được chỉ định trong quy tắc.
Thẻ: test_runner
Đã tích luỹ --runs_per_test=<a positive integer or test_regex@runs. This flag may be passed more than once> lần sử dụng
Chỉ định số lần chạy mỗi lượt kiểm thử. Nếu có 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ộ quy trình kiểm thử sẽ bị 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ả bài kiểm thử 3 lần. Cú pháp thay thế: regex_filter@runs_per_test. Trong đó run_per_test là viết tắt của một giá trị số nguyên còn regex_filter là viết tắt của 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 lượt kiểm thử trong //foo/ ngoại trừ những chương trình kiểm thử trong foo/bar ba lần. Bạn có thể chuyển tuỳ chọn này nhiều lần. Đối số được truyền gần đây nhất mà các kết quả trùng khớp sẽ được ưu tiên. Nếu không có kết quả nào phù hợp, kiểm thử sẽ chỉ chạy một lần.
Đã tích luỹ --test_env=<a 'name=value' assignment with an optional value part> lần sử dụng
Chỉ định các biến môi trường bổ sung để đưa vào môi trường chạy kiểm thử. Bạn có thể chỉ định biến theo tên, trong trường hợp đó, giá trị của biến sẽ được đọc từ môi trường máy khách Bazel hoặc bằng cặp tên=giá trị. Bạn có thể sử dụng lựa chọn này nhiều lần để chỉ định nhiều biến. Chỉ được sử dụng bằng lệnh "bazel test" (kiểm thử bazel).
Thẻ: test_runner
Mặc định của --test_timeout=<a single integer or comma-separated list of 4 integers>: "-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 duy nhất, giá trị này 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 ngắn, trung bình, dài và vĩnh viễn (theo thứ tự đó). Dù ở dạng nào, giá trị -1 sẽ yêu cầu blaze sử dụng thời gian chờ mặc định cho danh mục đó.
Mặc định của --[no]zip_undeclared_test_outputs: "đúng"
Nếu đúng, các kết quả kiểm thử không được khai báo sẽ được lưu trữ trong tệp zip.
Thẻ: test_runner
Các tuỳ chọn liên quan đến dữ liệu đầu ra của truy vấn và ngữ nghĩa:
Giá trị mặc định của --aspect_deps=<off, conservative or precise>: "thận trọng"
Cách giải quyết các phần phụ thuộc khung hình khi định dạng đầu ra là {xml,proto,record}. "tắt" có nghĩa là không có phần phụ thuộc khung hình nào được phân giải, "bảo toàn" (mặc định) có nghĩa là tất cả các phần phụ thuộc khung hình đã khai báo đều được thêm vào bất kể các phần phụ thuộc đó 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ỉ các khía cạnh có thể đang hoạt động dựa trên lớp quy tắc của phần phụ thuộc trực tiếp. 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 đó khiến nó chậm hơn so với các chế độ khác. Cũng 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 được chạy trong "truy vấn bazel".
Thẻ: build_file_semantics
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ể là do hàm <code>str</code> Starlark áp dụng cho thực thể <code>Label</code>. Điều này rất hữu ích cho các công cụ cần khớp với kết quả của nhiều lệnh truy vấn và/hoặc nhãn do quy tắc đưa ra. Nếu không được bật, các trình định dạng đầu ra sẽ tự do phát ra tên kho lưu trữ rõ ràng (tương ứng với kho lưu trữ chính) để giúp kết quả dễ đọc hơn.
Thẻ: terminal_output
Mặc định của --[no]graph:factored: "đúng"
Nếu đúng, thì biểu đồ sẽ được phát ra "đã được tính thành phần", tức là các nút tương đương về mặt cấu trúc liên kết sẽ được hợp nhất với nhau và các nhãn của chúng được nối với nhau. Tuỳ chọn này chỉ áp dụng cho --output=map.
Thẻ: terminal_output
Mặc định của --graph:node_limit=<an integer>: "512"
Độ dài tối đa của chuỗi nhãn cho một nút biểu đồ trong đầu ra. Các nhãn dài hơn sẽ bị cắt bớt; -1 có nghĩa là không bị cắt bớt. Tuỳ chọn này chỉ áp dụng cho --output=map.
Thẻ: terminal_output
Mặc định của --[no]implicit_deps: "đúng"
Nếu được bật, các phần phụ thuộc ngầm ẩn 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 thêm bởi bazel. Đối với cquery, tuỳ chọn này kiểm soát việc lọc các chuỗi công cụ đã được phân giải.
Thẻ: build_file_semantics
Mặc định của --[no]include_artifacts: "đúng"
Bao gồm tên của các đầu vào và đầu ra của hành động trong dữ liệu đầu ra (có thể lớn).
Thẻ: terminal_output
Mặc định của --[no]include_aspects: "đúng"
aquery, cquery: liệu có bao gồm các hành động do khía cạnh tạo ra trong kết quả không. query: no-op (các khía cạnh luôn được tuân theo).
Thẻ: terminal_output
Mặc định của --[no]include_commandline: "đúng"
Bao gồm nội dung của các dòng lệnh hành động trong dữ liệu đầu ra (có thể lớn).
Thẻ: terminal_output
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
Mặc định của --[no]include_param_files: "false"
Bao gồ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
Mặc định của --[no]incompatible_package_group_includes_double_slash: "đúng"
Nếu bạn bật chế độ này, khi xuất thuộc tính "packages" của package_group, thuộc tính "//" ở đầu sẽ không bị bỏ qua.
Thẻ: terminal_output, incompatible_change
Mặc định của --[no]infer_universe_scope: "false"
Nếu bạn không đặt và --universe_scope, thì giá trị của --universe_scope sẽ được suy luận dưới dạng danh sách các mẫu mục tiêu duy nhất trong biểu thức truy vấn. Lưu ý rằng giá trị --universe_scope được suy luận cho biểu thức truy vấn sử dụng các hàm trong phạm vi toàn bộ (ví dụ:`allrdeps`) có thể không phải là điều bạn muốn, vì vậy, bạn chỉ nên sử dụng tùy chọn này nếu biết mình đang làm gì. Hãy tham khảo tại 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 tùy chọn này sẽ bị bỏ qua. Lưu ý: lựa chọn này chỉ áp dụng cho "truy vấn" (tức là không áp dụng cho "cquery").
Thẻ: loading_and_analysis
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
Mặc định của --[no]nodep_deps: "đúng"
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 nơi truy vấn hoạt động. Một ví dụ phổ biến về thuộc tính "nodep" là "khả năng hiển thị". Chạy và phân tích cú pháp kết quả của "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
Mặc định của --output=<a string>: "văn bản"
Định dạng in kết quả truy vấn. Các giá trị được phép đối với truy vấn là: text, textproto, proto, Streaming_proto, jsonproto.
Thẻ: terminal_output
Mặc định của --[no]proto:default_values: "đúng"
Nếu đúng thì các thuộc tính có giá trị không được chỉ định rõ trong tệp BUILD sẽ được bao gồm; nếu không thì các thuộc tính này sẽ bị bỏ qua. Tuỳ chọn này áp dụng cho --output=proto
Thẻ: terminal_output
Mặc định của --[no]proto:definition_stack: "false"
Điền trường proto manifest_stack. Trường này ghi lại từng thực thể quy tắc cho 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
Mặc định của --[no]proto:flatten_selects: "đúng"
Nếu bạn bật chính sách này, các thuộc tính có thể định cấu hình do Select() tạo ra sẽ được làm phẳng. Đối với loại danh sách, cách biểu diễn đã làm phẳng là danh sách chứa từng giá trị của bản đồ chọn đúng một lần. Các loại vô hướng được làm phẳng thành giá trị rỗng.
Thẻ: build_file_semantics
Mặc định của --[no]proto:include_attribute_source_aspects: "false"
Điền trường proto source_aspect_name của mỗi Thuộc tính bằng khía cạnh nguồn của thuộc tính (chuỗi trống nếu không phải là chuỗi).
Thẻ: terminal_output
Mặc định của --[no]proto:include_synthetic_attribute_hash: "false"
Liệu có nên tính toán và điền thuộc tính $internal_attr_hash hay không.
Thẻ: terminal_output
Mặc định của --[no]proto:instantiation_stack: "false"
Điền ngăn xếp lệnh gọi tạo thực thể của từng quy tắc. Lưu ý rằng điều này yêu cầu ngăn xếp phải hiển thị
Thẻ: terminal_output
Mặc định của --[no]proto:locations: "đúng"
Liệu có xuất thông tin vị trí ở đầu ra proto hay không.
Thẻ: terminal_output
Mặc định của --proto:output_rule_attrs=<comma-separated list of options>: "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 kết quả. Giá trị mặc định là tất cả thuộc tính. Đặt thành chuỗi trống để không xuất bất kỳ thuộc tính nào. Tuỳ chọn này có thể áp dụng cho --output=proto.
Thẻ: terminal_output
Mặc định của --[no]proto:rule_inputs_and_outputs: "đúng"
Liệu có nên điền các trường Rule_input và Rule_output hay không.
Thẻ: terminal_output
Mặc định của --query_file=<a string>: ""
Nếu bạn đặt chính sách này, truy vấn sẽ đọc truy vấn từ tệp có tên ở đây, thay vì trên dòng lệnh. Sẽ xảy ra lỗi khi chỉ định tệp tại đây cũng như truy vấn dòng lệnh.
Thẻ: changes_inputs
Mặc định của --[no]relative_locations: "false"
Nếu đúng, vị trí của các tệp BUILD trong xml và kết quả proto sẽ là tương đối. Theo mặc định, dữ liệu vị trí đầu ra 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 true để có kết quả nhất quán trên các máy.
Thẻ: terminal_output
Mặc định của --[no]skyframe_state: "false"
Nếu không phân tích thêm, hãy kết xuất Biểu đồ hành động hiện tại từ Skyframe. Lưu ý: Việc chỉ định mục tiêu bằng --skyframe_state hiện không được hỗ trợ. Cờ này chỉ áp dụng với --output=proto hoặc --output=textproto.
Thẻ: terminal_output
Mặc định của --[no]tool_deps: "đúng"
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 qua đó. Cạnh phụ thuộc "exec configuration" (Cấu hình thực thi) (chẳng hạn như cạnh từ quy tắc "proto_library" bất kỳ đến Protocol Compiler (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 tạo bản dựng thay vì một phần của cùng một chương trình "target" (mục tiêu). Cquery: Nếu bị tắt, hãy 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 được đị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ó 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, chỉ các mục tiêu đã định cấu hình thực thi mới được trả về. Tuỳ chọn này sẽ KHÔNG loại trừ các chuỗi công cụ đã được phân giải.
Thẻ: build_file_semantics
Mặc định của --universe_scope=<comma-separated list of options>: ""
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 (cộng và trừ). Truy vấn có thể được thực hiện trong vũ trụ được xác định bằng việc đóng bắc cầu 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à mục tiêu mà tất cả câu trả lời đều được tạo và do đó, tuỳ chọn này có thể ảnh hưởng đến cấu hình và chuyển đổi. Nếu bạn không chỉ định tuỳ chọn này, thì mục tiêu cấp cao nhất được giả định là 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ị hỏng nếu không thể tạo mục tiêu được phân tích cú pháp từ biểu thức truy vấn với 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:
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
Mặc định của --[no]experimental_inmemory_dotd_files: "đúng"
Nếu được bật, các tệp C++ .d sẽ được chuyển trực tiếp từ các nút bản dựng từ xa vào bộ nhớ thay vì được ghi vào ổ đĩa.
Thẻ: loading_and_analysis, execution, affects_outputs, experimental
Mặc định của --[no]experimental_inmemory_jdeps_files: "đúng"
Nếu bạn bật tuỳ chọn này, các tệp phần phụ thuộc (.jdeps) được tạo qua quá trình biên dịch Java sẽ được chuyển trực tiếp từ các nút bản dựng từ xa vào bộ nhớ thay vì được ghi vào ổ đĩa.
Thẻ: loading_and_analysis, execution, affects_outputs, experimental
Mặc định của --[no]experimental_objc_include_scanning: "false"
Liệu có nên thực hiện quét để tìm C/C++ mục tiêu hay không.
Thẻ: loading_and_analysis, execution, changes_inputs
Mặc định của --[no]experimental_retain_test_configuration_across_testonly: "false"
Khi được bật, --trim_test_configure sẽ không cắt bỏ cấu hình kiểm thử cho các quy tắc được đánh dấu là testonly=1. Việc này nhằm giảm các vấn đề xung đột hành động khi các quy tắc không kiểm thử phụ thuộc vào quy tắc cc_test. Không có ảnh hưởng gì nếu --trim_test_Configuration sai.
Thẻ: loading_and_analysis, loses_incremental_state
Mặc định của --[no]experimental_starlark_cc_import: "false"
Nếu bật, bạn có thể sử dụng phiên bản cc_import của Starlark.
Thẻ: loading_and_analysis, experimental
Mặc định của --[no]experimental_unsupported_and_brittle_include_scanning: "false"
Liệu có nên thu hẹp đầu vào trong quá trình biên dịch C/C++ hay không bằng cách phân tích cú pháp các dòng #include từ tệp đầu vào. Điều này có thể cải thiện hiệu suất và mức độ gia tăng bằng cách giảm kích thước của các cây đầu vào biên dịch. Tuy nhiên, nó 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 tiền xử lý C. Cụ thể, thuộc tính này không hiểu các lệnh động #include và bỏ qua logic có điều kiện của bộ tiền xử lý. Bạn tự chịu rủi ro khi sử dụng. Mọi vấn đề liên quan đến cờ này đã gửi đều sẽ bị đóng.
Thẻ: loading_and_analysis, execution, changes_inputs
Mặc định của --[no]incremental_dexing: "đúng"
Phần lớn công việc tạo tệp dex là riêng biệt cho từng tệp Jar.
Thẻ: affects_outputs, loading_and_analysis, loses_incremental_state
Mặc định của --[no]objc_use_dotd_pruning: "đúng"
Nếu được đặt, tệp .d do clang tạo ra sẽ được dùng để cắt giảm tập hợp dữ liệu đầu vào được chuyển vào các quá trình biên dịch objc.
Thẻ: changes_inputs, loading_and_analysis
Mặc định của --[no]process_headers_in_dependencies: "false"
Khi tạo //a:a mục tiêu, hãy xử lý tiêu đề ở mọi mục tiêu mà //a:a phụ thuộc (nếu chuỗi công cụ có bật tính năng xử lý tiêu đề).
Thẻ: execution
Mặc định của --[no]trim_test_configuration: "đúng"
Khi được bật, các tuỳ chọn liên quan đến kiểm thử sẽ bị xoá dưới cấp cao nhất của bản dựng. Khi cờ này hoạt động, bạn không thể tạo thử nghiệm dưới dạng phần phụ thuộc của quy tắc không kiểm thử. Tuy nhiên, các thay đổi đối với lựa chọn liên quan đến thử nghiệm sẽ không khiến các quy tắc không 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 độ chi tiết, định dạng hoặc vị trí ghi nhật ký:
Mặc định của --toolchain_resolution_debug=<a comma-separated list of regex expressions with prefix '-' specifying excluded paths>: "-.*"
In thông tin gỡ lỗi trong quá trình phân giải chuỗi công cụ. Cờ này sẽ lấy một biểu thức chính quy để 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 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 chọn 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ề giải pháp chuỗi công cụ.
Thẻ: terminal_output
Tuỳ chọn chỉ định hoặc thay đổi dữ liệu đầu vào chung thành lệnh Bazel không thuộc các danh mục khác.:
Đã tích luỹ --flag_alias=<a 'name=value' flag alias> lần sử dụng
Đặt tên viết tắt cho cờ Starlark. Hàm này sẽ lấy một cặp khoá-giá trị duy nhất có dạng "<key>=<value>" làm đối số.
Thẻ: changes_inputs
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 nữa. Chính xác, khi một mục tiêu py_binary hoặc py_test đã được đặt giá trị cũ là "auto" (giá trị mặc định), thì mục tiêu đó sẽ được coi là sai khi và chỉ khi bạn đặt cờ này. Xem https://github.com/bazelbuild/bazel/issues/10076.
Thẻ: affects_outputs, incompatible_change
Mặc định của --[no]incompatible_py2_outputs_are_suffixed: "đúng"
Nếu đúng, các mục tiêu được tạo trong cấu hình Python 2 sẽ xuất hiện bên dưới một gốc đầu ra có chứa hậu tố "-py2", trong khi các mục tiêu được tạo cho Python 3 sẽ xuất hiện trong một 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".
Các thẻ: affects_outputs, incompatible_change
Mặc định của --[no]incompatible_py3_is_default: "đúng"
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".
Các thẻ: loading_and_analysis, affects_outputs, incompatible_change
Mặc định của --[no]incompatible_use_python_toolchains: "đúng"
Nếu bạn đặt chính sách này thành true, các quy tắc Python gốc có thể thực thi sẽ sử dụng thời gian chạy Python do chuỗi công cụ Python chỉ định, thay vì thời gian chạy do các cờ cũ như --python_top cung cấp.
Thẻ: loading_and_analysis, incompatible_change
Mặc định của --python_version=<PY2 or PY3>: xem nội dung mô tả
Chế độ phiên bản lớn của Python, "PY2" hoặc "PY3". Xin lưu ý rằng giá trị này sẽ bị các mục tiêu "py_binary" và "py_test" ghi đè (ngay cả khi chúng không chỉ định rõ phiên bản) vì vậy, thường không có nhiều lý do để cung cấp cờ này.
Thẻ: loading_and_analysis, affects_outputs
Các lựa 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 "auto", Bazel sẽ chạy lại kiểm thử khi 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ử không thành công trước đó. Nếu bạn đặt chính sách này thành "có", Bazel sẽ lưu mọi kết quả kiểm tra vào bộ nhớ đệm, ngoại trừ các thử nghiệm được đánh dấu là bên ngoài. Nếu bạn đặt chính sách này thành "no", Bazel sẽ không lưu kết quả thử nghiệm vào bộ nhớ đệm.
Mặc định của --[no]experimental_cancel_concurrent_tests: "false"
Nếu đúng, thì Blaze sẽ huỷ đồng thời chạy kiểm thử trong lần chạy thành công đầu tiên. Tính năng này chỉ hữu ích khi kết hợp với --runs_per_test_detects_flakes.
Thẻ: affects_outputs, loading_and_analysis
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 về mức độ sử dụng cho mỗi kiểm thử trong một lần chạy mức độ sử dụng.
Thẻ: affects_outputs, loading_and_analysis
Mặc định của --[no]experimental_generate_llvm_lcov: "false"
Nếu đúng, mức độ phù hợp của tiếng lóng sẽ tạo báo cáo LCOV.
Thẻ: affects_outputs, loading_and_analysis
Mặc định của --[no]experimental_j2objc_header_map: "đúng"
Liệu có tạo bản đồ tiêu đề J2ObjC song song với quá trình dịch nội dung J2ObjC hay không.
Mặc định của --[no]experimental_j2objc_shorter_header_path: "false"
Liệu có nên 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
Giá trị mặc định của --experimental_java_classpath=<off, javabuilder or bazel>: "javabuilder"
Bật đường dẫn lớp rút gọn cho quá trình biên dịch Java.
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 cho các thư viện tương thích với Android.
Thẻ: affects_outputs
Mặc định của --[no]experimental_run_android_lint_on_java_rules: "false"
Liệu có cần xác thực các nguồn java_* hay không.
Thẻ: affects_outputs
Mặc định của --[no]explicit_java_test_deps: "false"
Chỉ định rõ ràng phần phụ thuộc vào JUnit hoặc Hamcrest trong java_test thay vì vô tình lấy từ các phần phụ thuộc của TestRunner. Hiện chỉ dùng được cho bazel.
Mặc định của --host_java_launcher=<a build target label>: xem nội dung mô tả
Trình chạy Java mà các công cụ được thực thi trong một bản dựng sử dụng.
Đã tích luỹ --host_javacopt=<a string> lần sử dụng
Các tuỳ chọn bổ sung để chuyển sang javac khi tạo các công cụ được thực thi trong một bản dựng.
Đã tích luỹ --host_jvmopt=<a string> lần sử dụng
Các tuỳ chọn bổ sung được truyền đến máy ảo Java khi tạo các công cụ được thực thi trong quá trình tạo bản dựng. Những tuỳ chọn này sẽ được thêm vào các tuỳ chọn khởi động máy ảo của từng mục tiêu java_binary.
Mặc định của --[no]incompatible_check_sharding_support: "đúng"
Nếu đúng, Bazel sẽ không vượt qua kiểm thử phân đoạn nếu trình chạy kiểm thử không cho biết có 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ợ tính năng phân đoạn sẽ dẫn đến tất cả chương trình kiểm thử chạy trong từng phân đoạn.
Thẻ: incompatible_change
Mặc định của --[no]incompatible_exclusive_test_sandboxed: "đúng"
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 thử nghiệm độc quyền trên máy
Thẻ: incompatible_change
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_BOOKS_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 làm như vậy có thể ngăn việc lưu vào bộ nhớ đệm giữa nhiều người dùng nếu sử dụng bộ nhớ đệm dùng chung.
Thẻ: loading_and_analysis, incompatible_change
Đã tích luỹ --j2objc_translation_flags=<comma-separated list of options> lần sử dụng
Các tuỳ chọn bổ sung để truyền đến công cụ J2ObjC.
--java_debug
Làm cho máy ảo Java của kiểm thử java phải đợi 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
Mặc định của --[no]java_deps: "đúng"
Tạo thông tin phần phụ thuộc (hiện tại là classpath thời gian biên dịch) cho mỗi mục tiêu Java.
Mặc định của --[no]java_header_compilation: "đúng"
Biên dịch ijar trực tiếp từ nguồn.
Mặc định của --java_language_version=<a string>: ""
Phiên bản ngôn ngữ Java
Mặc định của --java_launcher=<a build target label>: 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 cờ này được đặt thành chuỗi trống, thì trình chạy JDK sẽ được sử dụng. Thuộc tính "trình chạy" sẽ ghi đè cờ này.
Mặc định của --java_runtime_version=<a string>: "local_jdk"
Phiên bản thời gian chạy Java
Đã tích luỹ --javacopt=<a string> lần sử dụng
Các tuỳ chọn bổ sung để chuyển sang javac.
Đã tích luỹ --jvmopt=<a string> lần sử dụng
Các tuỳ chọn bổ sung để truyền đến máy ảo Java. Những tuỳ chọn này sẽ được thêm vào các tuỳ chọn khởi động máy ảo của từng mục tiêu java_binary.
Mặc định của --legacy_main_dex_list_generator=<a build target label>: xem nội dung mô tả
Chỉ định một tệp nhị phân cần dùng để tạo danh sách các lớp phải có trong dex chính khi biên dịch multidex cũ.
Mặc định của --optimizing_dexer=<a build target label>: xem nội dung mô tả
Chỉ định một tệp nhị phân cần dùng để tạo tệp dex mà không cần phân đoạn.
Đã tích luỹ --plugin=<a build target label> lần sử dụng
Trình bổ trợ sử dụng trong bản dựng. Hiện hoạt động với java_plugin.
Mặc định của --proguard_top=<a build target label>: xem nội dung mô tả
Chỉ định phiên bản ProGuard cần dùng để xoá mã khi tạo một tệp nhị phân Java.
Giá trị mặc định của --proto_compiler=<a build target label>: "@bazel_tools//tools/proto:protoc"
Nhãn của trình biên dịch proto.
Thẻ: affects_outputs, loading_and_analysis
Giá trị mặc định của --proto_toolchain_for_cc=<a build target label>: "@bazel_tools//tools/proto:cc_toolchain"
Nhãn của proto_lang_toolchain() mô tả cách biên dịch giao thức C++
Thẻ: affects_outputs, loading_and_analysis
Giá trị mặc định của --proto_toolchain_for_j2objc=<a build target label>: "@bazel_tools//tools/j2objc:j2objc_proto_toolchain"
Nhãn của proto_lang_toolchain() mô tả cách biên dịch j2objc protos
Các thẻ: affects_outputs, loading_and_analysis
Giá trị mặc định của --proto_toolchain_for_java=<a build target label>: "@bazel_tools//tools/proto:java_toolchain"
Nhãn của proto_lang_toolchain() mô tả cách biên dịch giao thức Java
Các thẻ: affects_outputs, loading_and_analysis
Giá trị mặc định của --proto_toolchain_for_javalite=<a build target label>: "@bazel_tools//tools/proto:javalite_toolchain"
Nhãn của proto_lang_toolchain() mô tả cách biên dịch giao thức JavaLite
Các thẻ: affects_outputs, loading_and_analysis
Đã tích luỹ --protocopt=<a string> lần sử dụng
Các tuỳ chọn bổ sung để truyền đến trình biên dịch protobuf.
Thẻ: affects_outputs
Mặc định của --[no]runs_per_test_detects_flakes: "false"
Nếu đúng, hệ thống sẽ xác định trạng thái FLAKY cho bất kỳ phân đoạn nào có ít nhất một lần chạy/lần vượt qua và có ít nhất một lần chạy/lần thử không thành công.
Mặc định của --shell_executable=<a path>: xem nội dung mô tả
Đường dẫn tuyệt đối đến shell có thể thực thi để Bazel sử dụng. Nếu bạn không đặt chính sách này nhưng biến môi trường BAZEL_SH được đặt trong lệnh gọi Bazel đầu tiên (khởi động máy chủ Bazel), thì Bazel sẽ sử dụng biến môi trường đó. Nếu bạn không đặt biểu tượng nào, 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 chạy trên đó (Windows: c:/tools/msys64/usr/bin/bash.exe, FreeBSD: /usr/local/bin/bash, tất cả các đường dẫn khác: /bin/bash). 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 cho các tệp nhị phân được tạo.
Thẻ: loading_and_analysis
Đã tích luỹ --test_arg=<a string> lần sử dụng
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ể dùng nhiều lần để chỉ định nhiều đối số. Nếu nhiều kiểm thử được thực thi, mỗi kiểm thử sẽ nhận được các đối số giống nhau. Chỉ được sử dụng bằng lệnh "bazel test" (kiểm thử bazel).
Mặc định của --test_filter=<a string>: 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 các bài kiểm thử chạy. Xin lưu ý rằng điều này không ảnh hưởng đến các mục tiêu được tạo.
Mặc định của --test_result_expiration=<an integer>: "-1"
Tuỳ chọn này không được dùng nữa và không có hiệu lực.
Mặc định của --[no]test_runner_fail_fast: "false"
Tuỳ chọn Chuyển tiếp không thành công nhanh đến trình chạy kiểm thử. Trình chạy kiểm thử phải ngừng thực thi khi không thành công đầu tiên.
Giá trị mặc định của --test_sharding_strategy=<explicit, disabled or forced=k where k is the number of shards to enforce>: "phản cảm"
Chỉ định chiến lược cho phân đoạn kiểm thử: "explicit" để chỉ sử dụng phân đoạn nếu có thuộc tính BUILD "shard_count". "disabled" (tắt) để không bao giờ sử dụng tính năng phân đoạn kiểm thử. "forced=k" thực thi phân đoạn "k" cho mục đích kiểm thử bất kể thuộc tính BUILD "shard_count".
Mặc định của --tool_java_language_version=<a string>: ""
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 xây dựng
Mặc định của --tool_java_runtime_version=<a string>: "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 xây dựng
Mặc định của --[no]use_ijars: "đúng"
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 gia tăng nhanh hơn, nhưng thông báo lỗi có thể khác.

Tuỳ chọn bản dựng

Các tuỳ chọn xuất hiện trước lệnh và được ứng dụng phân tích cú pháp:
Đã tích luỹ --distdir=<a path> lần sử dụng
Các nơi khác để tìm kiếm các tệp lưu trữ trước khi truy cập mạng để tải các tệp lưu trữ đó xuống.
Thẻ: bazel_internal_configuration
Nếu bạn đặt chính sách này, bộ nhớ đệm của kho lưu trữ sẽ liên kết cứng tệp đó trong trường hợp tệp bị tấn công vào bộ nhớ đệm, thay vì sao chép. Mục đích của tính năng này là tiết kiệm dung lượng ổ đĩa.
Thẻ: bazel_internal_configuration
Mặc định của --experimental_repository_downloader_retries=<an integer>: "0"
Số lần thử lại một lỗi tải xuống tối đa. Nếu bạn đặt chính sách này thành 0, thì tính năng thử lại sẽ tắt.
Thẻ: experimental
Mặc định của --experimental_scale_timeouts=<a double>: "1.0"
Điều chỉnh tỷ lệ tất cả thời gian chờ trong quy tắc lưu trữ Starlark theo hệ số này. Bằng cách này, kho lưu trữ bên ngoài có thể được tạo ra hoạt động trên các máy chậm hơn tác giả quy tắc dự kiến mà không cần thay đổi mã nguồn
Thẻ: bazel_internal_configuration, experimental
Mặc định của --http_connector_attempts=<an integer>: "8"
Số lần thử tải xuống http tối đa.
Thẻ: bazel_internal_configuration
Mặc định của --http_connector_retry_max_timeout=<An immutable length of time.>: "0 giây"
Thời gian chờ tối đa cho các lần thử tải xuống lại http. Với giá trị 0, không có thời gian chờ tối đa nào được xác định.
Thẻ: bazel_internal_configuration
Mặc định của --http_timeout_scaling=<a double>: "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ố cụ thể
Thẻ: bazel_internal_configuration
Mặc định của --repository_cache=<a path>: 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. Một chuỗi trống làm đối số yêu cầu tắt bộ nhớ đệm, nếu không, hệ thống sẽ sử dụng giá trị mặc định của '<output_user_root>/cache/repos/v1'
Thẻ: bazel_internal_configuration
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ị vô hiệu hoá hoàn toàn; ctx.exe vẫn có thể chạy một tệp thực thi tuỳ ý truy cập vào Internet.
Thẻ: bazel_internal_configuration
Các tuỳ chọn kiểm soát quá trình thực thi bản dựng:
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ập nhật chưa. Nếu tất cả các mục tiêu đều được cập nhật, bản dựng sẽ hoàn tất thành công. Nếu bất kỳ bước nào cần được thực thi, hệ thống sẽ báo cáo lỗi và bản dựng sẽ không hoạt động.
Thẻ: execution
Giá trị mặc định của --dynamic_local_execution_delay=<an integer>: "1000"
Quá trình thực thi cục bộ sẽ bị trì hoãn là bao nhiêu mili giây, nếu quá trình thực thi từ xa nhanh hơn ít nhất một lần trong một bản dựng?
Thẻ: execution, host_machine_resource_optimizations
Đã tích luỹ --dynamic_local_strategy=<a '[name=]value1[,..,valueN]' assignment> lần sử dụng
Các chiến lược tại địa phương được áp dụng theo thứ tự như sau: chiến lược phù hợp đầu tiên sẽ được sử dụng. Ví dụ: "worker,sandboxed" (trình thực thi, hộp cát) chạy các thao tác hỗ trợ worker liên tục bằng chiến lược worker và tất cả những thao tác khác sử dụng chiến lược hộp cát. Nếu không có ghi nhớ nào được cung cấp, danh sách các chiến lược sẽ được dùng làm phương án dự phòng cho tất cả các phương pháp ghi nhớ. Danh sách dự phòng mặc định là `worker,sandboxed` hoặc`worker,sandboxed, độc lập` nếu `experimental_local_lockfree_output` được đặt. Lấy [mnemonic=]local_strategy[,local_strategy,...]
Thẻ: execution, host_machine_resource_optimizations
Đã tích luỹ --dynamic_remote_strategy=<a '[name=]value1[,..,valueN]' assignment> lần sử dụng
Các chiến lược từ xa (theo thứ tự) được áp dụng cho các ký tự đã cho – chiến lược có thể áp dụng đầu tiên sẽ được sử dụng. Nếu không có ghi nhớ nào được cung cấp, danh sách các chiến lược sẽ được dùng làm phương án dự phòng cho tất cả các phương pháp ghi nhớ. Danh sách dự phòng mặc định là "remote", vì vậy, bạn thường không cần đặt cờ này một cách rõ ràng. Lấy [mnemonic=]remote_strategy[,remote_strategy,...]
Thẻ: execution, host_machine_resource_optimizations
Mặc định của --experimental_docker_image=<a string>: ""
Chỉ định tên hình ảnh Docker (ví dụ: "ubuntu:latest") sẽ được dùng để thực thi thao tác trong hộp cát khi sử dụng chiến lược docker và bản thân thao tác đó 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 chuyển nguyên văn đến "docker chạy", vì vậy, cờ này hỗ trợ cú pháp và cơ chế tương tự như chính Docker.
Thẻ: execution
Mặc định của --[no]experimental_docker_use_customized_images: "đúng"
Nếu được bật, hãy 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. Đây là yêu cầu bắt buộc nếu bản dựng / thử nghiệm 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. Tính năng này được bật theo mặc định nhưng bạn có thể tắt 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 đến.
Thẻ: execution
Mặc định của --[no]experimental_dynamic_exclude_tools: "đúng"
Khi được đặt, các mục tiêu là bản dựng "dành cho công cụ" sẽ không áp dụng chế độ thực thi động. Các mục tiêu như vậy khó có khả năng được xây dựng từ từ và do đó không đáng chi tiêu theo chu kỳ địa phương.
Thẻ: execution, host_machine_resource_optimizations
Mặc định của --experimental_dynamic_local_load_factor=<a double>: "0"
Kiểm soát mức tải từ quá trình thực thi động để đưa vào 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 và có thể kiểm soát số lượng này bằng cờ --local_cpu_resources. Nếu cờ này là 0, thì tất cả các hành động sẽ được lên lịch cục bộ ngay lập tức. Nếu > 0, số tác vụ đượ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 ở mức cao. Điều này giúp giảm tải trên máy cục bộ trong trường hợp bản dựng sạch mà máy cục bộ không đóng góp nhiều.
Thẻ: execution, host_machine_resource_optimizations
Mặc định của --experimental_dynamic_slow_remote_time=<An immutable length of time.>: "0"
Nếu >0, thời gian một thao tác chạy tự động chỉ được thực hiện từ xa trước khi chúng tôi ưu tiên thực thi cục bộ để tránh hết thời gian chờ từ xa. Thao tác này có thể ẩn một số sự cố trên hệ thống thực thi từ xa. Đừng bật tính năng này khi chưa theo dõi các vấn đề về thực thi từ xa.
Thẻ: execution, host_machine_resource_optimizations
Mặc định của --[no]experimental_enable_docker_sandbox: "false"
Bật 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 không cài đặt Docker.
Thẻ: execution
Mặc định của --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">: "4"
Nếu giá trị là 0, hãy xoá cây hộp cát ngay sau khi một hành động hoàn tất (khiến quá trình hoàn tất hành động bị trì hoãn). Nếu lớn hơn 0, hãy thực thi xoá 3 giá trị đó trên 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
Mặc định của --experimental_sandbox_memory_limit_mb=<an integer number of MBs, or "HOST_RAM", optionally followed by [-|*]<float>.>: "0"
Nếu > 0, mỗi hộp cát Linux sẽ bị giới hạn trong dung lượng bộ nhớ đã cho (tính bằng MB). Yêu cầu cgroups v1 hoặc v2 và cấp cho người dùng quyền truy cập vào thư mục cgroups.
Thẻ: execution
Mặc định của --[no]experimental_shrink_worker_pool: "false"
Nếu được bật, tính năng này có thể thu nhỏ nhóm trình chạy nếu áp lực bộ nhớ của trình chạy ở mức cao. Cờ này chỉ hoạt động khi bật cờ thử nghiệm_total_worker_memory_limit_mb.
Thẻ: execution, host_machine_resource_optimizations
Mặc định của --[no]experimental_split_xml_generation: "đúng"
Nếu bạn đặt cờ này và thao tác kiểm thử không tạo ra 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 quá trình kiểm thử.
Thẻ: execution
Mặc định của --experimental_total_worker_memory_limit_mb=<an integer number of MBs, or "HOST_RAM", optionally followed by [-|*]<float>.>: "0"
Nếu giới hạn này lớn hơn 0 trình thực thi không hoạt động có thể bị dừng nếu tổng mức sử dụng bộ nhớ của tất cả trình thực thi vượt quá giới hạn.
Thẻ: execution, host_machine_resource_optimizations
Mặc định của --[no]experimental_use_hermetic_linux_sandbox: "false"
Nếu bạn đặt chính sách này thành true, thì không gắn kết thư mục gốc, mà chỉ gắn kết những nội dung được cung cấp trong hộp cát_add_gắn_cặp. Tệp đầu vào sẽ được liên kết cứng với hộp cát thay vì được liên kết tượng trưng từ hộp cát. Nếu tệp nhập hành động nằm trên một hệ thống tệp khác với hộp cát, thì tệp đầu vào sẽ được sao chép.
Thẻ: execution
Mặc định của --[no]experimental_use_semaphore_for_jobs: "false"
Nếu bạn đặt chính sách này thành true (đúng), 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
Mặc định của --[no]experimental_use_windows_sandbox: "false"
Sử dụng hộp cát của 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 phiên bản hộp cát đượ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
Giá trị mặc định của --experimental_windows_sandbox_path=<a string>: "BazelSandbox.exe"
Đường dẫn đến tệp nhị phân của hộp cát Windows để sử dụng khi --experimental_use_windows_sandbox là true (đúng). Nếu tên không có nội dung, hãy sử dụng tệp nhị phân đầu tiên của tên đó trong PATH.
Thẻ: execution
Mặc định của --experimental_worker_allowlist=<comma-separated set of options>: xem nội dung mô tả
Nếu giá trị không trống, chỉ cho phép sử dụng trình thực thi liên tục bằng cách ghi nhớ khoá trình thực thi đã cho.
Thẻ: execution, host_machine_resource_optimizations
Mặc định của --[no]experimental_worker_as_resource: "đúng"
Không hoạt động, sẽ sớm bị xoá.
Thẻ: no_op
Mặc định của --[no]experimental_worker_cancellation: "false"
Nếu bạn bật chế độ này, Bazel có thể gửi yêu cầu huỷ cho những nhân viên hỗ trợ họ.
Thẻ: execution
Mặc định của --experimental_worker_memory_limit_mb=<an integer number of MBs, or "HOST_RAM", optionally followed by [-|*]<float>.>: "0"
Nếu giới hạn này lớn hơn 0, worker có thể bị dừng nếu mức sử dụng bộ nhớ của worker vượt quá giới hạn. Nếu bạn không sử dụng cùng với tính năng thực thi động và "--experimental_dynamic_ignore_local_signals=9", thì bản dựng của bạn có thể gặp sự cố.
Thẻ: execution, host_machine_resource_optimizations
Mặc định của --experimental_worker_metrics_poll_interval=<An immutable length of time.>: "5 giây"
Khoảng thời gian giữa thời điểm thu thập chỉ số trình thực thi và thời điểm có thể cố gắng loại bỏ. Không thể nhỏ hơn 1 giây vì lý do hiệu suất.
Thẻ: execution, host_machine_resource_optimizations
Mặc định của --[no]experimental_worker_multiplex_sandboxing: "false"
Nếu bạn bật, Multiplex worker sẽ được tạ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 tạo hộp cát.
Thẻ: execution
Mặc định của --[no]experimental_worker_sandbox_hardening: "false"
Nếu được bật, trình thực thi sẽ chạy trong một hộp cát được tăng cường (nếu có) nếu quá trình triển khai cho phép.
Thẻ: execution
Mặc định của --[no]experimental_worker_strict_flagfiles: "false"
Nếu được bật, các đối số hành động cho trình thực thi không tuân theo thông số kỹ thuật của trình thực thi sẽ gây ra lỗi. Đối số trình chạy phải có đúng một đối số @flagfile làm đố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 đã sử dụng đã sử dụng (0 – 100) trên đó 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 giá trị này thành 100, thì GcThrashingDetector sẽ tắt.
Thẻ: host_machine_resource_optimizations
Mặc định của --genrule_strategy=<comma-separated list of options>: ""
Chỉ định cách thực thi quy tắc genrules. Cờ này sẽ bị loại bỏ. 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 quy tắc genrules.
Thẻ: execution
Đã tích luỹ --high_priority_workers=<a string> lần sử dụng
Không hoạt động, sẽ sớm bị xoá.
Thẻ: execution
Nếu bạn đặt chính sách này thành true và --incompatible_remote_symlinks cũng đúng thì các đường liên kết tượng trưng trong thao tác đầu ra sẽ được phép kết hợp với nhau.
Thẻ: execution, incompatible_change
Nếu bạn đặt chính sách này thành true, Bazel sẽ biểu thị các đường liên kết tượng trưng trong kết quả hoạt động trong giao thức lưu/thực thi từ xa vào bộ nhớ đệm/giao thức thực thi từ xa. Nếu không, các đường liên kết tượng trưng sẽ được theo dõi và biểu thị dưới dạng tệp hoặc thư mục. Xem #6631 để biết chi tiết.
Thẻ: execution, incompatible_change
Mặc định của --[no]incompatible_sandbox_hermetic_tmp: "đúng"
Nếu bạn đặt chính sách này thành đúng, thì mỗi hộp cát Linux sẽ có một thư mục trống chuyên dụng được gắn dưới dạng /tmp thay vì dùng chung /tmp với hệ thống tệp của máy chủ. Sử dụng --sandbox_add_gắn_pair=/tmp để tiếp tục xem /tmp của máy chủ trong mọi hộp cát.
Thẻ: execution
Mặc định của --[no]internal_spawn_scheduler: "false"
Tuỳ chọn phần giữ chỗ để chúng ta có thể cho Blaze biết liệu trình lập lịch biểu spawn có được bật hay không.
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. Chọn một số nguyên hoặc từ khoá ("auto", "HOST_CPUS", "HOST_RAM"), theo sau (không bắt buộc) là một toán tử ([-|*]<float>), ví dụ: "auto", "HOST_CPUS*.5". Giá trị phải nằm trong khoảng từ 1 đến 5000. Giá trị trên 2500 có thể gây ra vấn đề về bộ nhớ. "auto" tính toán giá trị mặc định hợp lý dựa trên tài nguyên máy chủ lưu trữ.
Thẻ: host_machine_resource_optimizations, execution
Giá trị mặc định của --[no]keep_going [-k]: "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 đạt và những mục tiêu phụ thuộc vào mục tiêu đó, nhưng bạn có thể phải đáp ứng 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
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ố lượng luồng song song cần dùng cho giai đoạn tải/phân tích. Lấy một số nguyên hoặc từ khoá ("auto", "HOST_CPUS", "HOST_RAM"), theo sau (không bắt buộc) là một thao tác ([-|*]<float>), ví dụ: "auto", "HOST_CPUS*.5". "auto" đặt giá trị mặc định hợp lý dựa trên tài nguyên máy chủ. Giá trị phải lớn hơn hoặc bằng 1.
Thẻ: bazel_internal_configuration
Mặc định của --[no]reuse_sandbox_directories: "đúng"
Nếu bạn đặt chính sách này thành true, thì các thư mục được sử dụng bởi quá trình thực thi không phải worker có dạng hộp cát có thể được sử dụng lại để tránh chi phí thiết lập không cần thiết.
Thẻ: host_machine_resource_optimizations, execution
Mặc định của --sandbox_base=<a string>: ""
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 (như /run/shm) để có thể cải thiện hiệu suất rất nhiều khi bản dựng / thử nghiệm 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 giữ 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
Mặc định của --[no]sandbox_explicit_pseudoterminal: "false"
Bật tính năng tạo các điểm cuối giả cho các hành động trong hộp cát một cách rõ ràng. Một số bản phân phối linux yêu cầu đặt mã nhóm của quy trình thành "tty" bên trong hộp cát để các pseudoterminal 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
Đã tích luỹ --sandbox_tmpfs_path=<an absolute path> lần sử dụng
Đối với các hành động 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 được phương thức triển khai hộp cát hỗ trợ, sẽ bị bỏ qua nếu không được hỗ trợ).
Thẻ: host_machine_resource_optimizations, execution
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ẽ tự động bị bỏ qua khi bạn bật tuỳ chọn này. Hãy xem bài viết: https://bazel.build/ext hóa/platforms#skipping-incompatible-targets
Thẻ: loading_and_analysis
Mặc định của --spawn_strategy=<comma-separated list of options>: ""
Chỉ định cách thực thi các hành động sinh sản theo mặc định. Chấp nhận danh sách các chiến lược được phân tách bằng dấu phẩy từ mức độ ưu tiên cao nhất đến thấp nhất. Đối với mỗi hành động, Bazel chọn chiến lược có mức độ ưu tiên cao nhất có thể thực hiện hành động đó. Giá trị mặc định là "remote,worker,sandboxed,local". Tham khảo tại https://blog.bazel.build/2019/06/19/list-strategy.html để biết chi tiết.
Thẻ: execution
Đã tích luỹ --strategy=<a '[name=]value1[,..,valueN]' assignment> lần sử dụng
Chỉ định cách phân phối nội dung biên dịch của các hành động sinh sản khác. Chấp nhận danh sách các chiến lược được phân tách bằng dấu phẩy từ mức độ ưu tiên cao nhất đến thấp nhất. Đối với mỗi hành động, Bazel chọn chiến lược có mức độ ưu tiên cao nhất có thể thực hiện hành động đó. Giá trị mặc định là "remote,worker,sandboxed,local". Cờ này ghi đè các giá trị được đặt bởi --spawn_strategy (và --genRule_strategy nếu được sử dụng với quy tắc ghi nhớ). Tham khảo tại https://blog.bazel.build/2019/06/19/list-strategy.html để biết chi tiết.
Thẻ: execution
Đã tích luỹ --strategy_regexp=<a '<RegexFilter>=value[,value]' assignment> lần sử dụng
Ghi đè chiến lược tạo (spawn) cần sử dụng để thực thi các hành động tạo sinh có nội dung mô tả khớp với một regex_filter nhất định. Xem --per_file_copt để biết chi tiết về so khớp regex_filter. Hệ thống sẽ sử dụng regex_filter gần đây nhất khớp với nội dung mô tả. Tuỳ chọn này sẽ ghi đè các cờ khác để chỉ định chiến lược. Ví dụ: --strategy_regexp=//foo.*\.cc,-//foo/bar=local có nghĩa là chạy các hành động bằng chiến lược cục bộ nếu nội dung mô tả của chú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 đảo ngược thứ tự sẽ chạy chiến lược đó bằng "sandboxed".
Thẻ: execution
Đã tích luỹ --worker_extra_flag=<a 'name=value' assignment> lần sử dụng
Cờ lệnh bổ sung sẽ được chuyển đến các quy trình của worker cùng với --persistent_worker, được khoá bằng chức năng ghi nhớ (ví dụ: --worker_extra_flag=Javac=--debug.
Thẻ: execution, host_machine_resource_optimizations
Đã tích luỹ --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"> lần sử dụng
Số lượng thực thể của mỗi loại trình thực thi liên tục 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 giá trị khác nhau cho mỗi kỷ niệm. Giới hạn này dựa trên các khoá trình chạy (worker key) được phân biệt dựa trên khả năng ghi nhớ, cũng như cờ khởi động và môi trường, do đó, trong một số trường hợp, có thể có nhiều worker hơn trên mỗi ký tự so với cờ này chỉ định. Chọn một số nguyên hoặc từ khoá ("auto", "HOST_CPUS", "HOST_RAM"), theo sau (không bắt buộc) là một toán tử ([-|*]<float>), ví dụ: "auto", "HOST_CPUS*.5". "auto" tính toán giá trị mặc định hợp lý dựa trên công suất máy. "=value" đặt giá trị mặc định cho thao tác ghi nhớ không xác định.
Thẻ: execution, host_machine_resource_optimizations
Đã tích luỹ --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"> lần sử dụng
Số lượng WorkRequest mà một quy trình multiplex 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 giá trị khác nhau cho mỗi kỷ niệm. Giới hạn này dựa trên các khoá trình chạy (worker key) được phân biệt dựa trên khả năng ghi nhớ, cũng như cờ khởi động và môi trường, do đó, trong một số trường hợp, có thể có nhiều worker hơn trên mỗi ký tự so với cờ này chỉ định. Chọn một số nguyên hoặc từ khoá ("auto", "HOST_CPUS", "HOST_RAM"), theo sau (không bắt buộc) là một toán tử ([-|*]<float>), ví dụ: "auto", "HOST_CPUS*.5". "auto" tính toán giá trị mặc định hợp lý dựa trên công suất máy. "=value" đặt giá trị mặc định cho thao tác ghi nhớ không xác định.
Thẻ: execution, host_machine_resource_optimizations
Mặc định của --[no]worker_multiplex: "đúng"
Nếu bạn bật, trình thực thi sẽ sử dụng tính năng ghép kênh nếu có hỗ trợ tính năng này.
Thẻ: execution, host_machine_resource_optimizations
Mặc định của --[no]worker_quit_after_build: "false"
Nếu bạn bật tuỳ chọn này, tất cả trình thực thi sẽ thoát sau khi hoàn tất quá trình tạo bản dựng.
Thẻ: execution, host_machine_resource_optimizations
Mặc định của --[no]worker_sandboxing: "false"
Nếu bạn bật chế độ này, worker sẽ được thực thi trong một môi trường hộp cát.
Thẻ: execution
Mặc định của --[no]worker_verbose: "false"
Nếu được bật, sẽ in thông báo chi tiết khi trình thực thi 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:
Mặc định của --target_platform_fallback=<a string>: ""
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 kết quả của lệnh:
Mặc định của --[no]build: "đúng"
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 hành động tạo bản dựng, trả về 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 cho việc kiểm thử các giai đoạn đó.
Thẻ: execution, affects_outputs
Mặc định của --[no]experimental_use_validation_aspect: "false"
Liệu có nên chạy các hành động xác thực bằng cách sử dụng khung hiển thị (để chạy song song với các hoạt động kiểm thử) hay không.
Thẻ: execution, affects_outputs
Đã tích luỹ --output_groups=<comma-separated list of options> lần sử dụng
Danh sách tên các nhóm đầu ra được phân tách bằng dấu phẩy, mỗi tên có tiền tố là dấu + hoặc dấu - (không bắt buộc) có tiền tố là dấu + sẽ được thêm vào tập hợp các nhóm đầu ra mặc định, còn nhóm có tiền tố - sẽ bị xoá khỏi tập hợp mặc định. Nếu có ít nhất một nhóm không có tiền tố, thì tập hợp nhóm đầu ra mặc định sẽ bị bỏ qua. Ví dụ: --output_groups=+foo,+bar tạo sự hợp nhất của tập hợp mặc định, foo và bar, trong khi --output_groups=foo,bar ghi đè tập hợp mặc định để chỉ foo và bar được tạo.
Thẻ: execution, affects_outputs
Mặc định của --[no]run_validations: "đúng"
Liệu có nên chạy các hành động xác thực trong bản dựng hay không. Hãy xem https://bazel.build/ext hóa/rules#validate_actions
Thẻ: execution, affects_outputs
Các tuỳ chọn cho phép người dùng định cấu hình kết quả dự định, ảnh hưởng đến giá trị của kết quả đó thay vì giá trị tồn tại của dữ liệu đó:
Đã tích luỹ --aspects=<comma-separated list of options> lần sử dụng
Danh sách được phân tách bằng dấu phẩy về các khía cạnh sẽ được áp dụng cho mục tiêu cấp cao nhất. Trong danh sách, nếu khía cạnh some_aspect chỉ định nhà cung cấp khía cạnh bắt buộc thông qua required_aspect_providers, some_aspect sẽ chạy theo mọi khía cạnh đã được đề cập trước đó trong danh sách khía cạnh có nhà cung cấp được quảng cáo đáp ứng some_aspect nhà cung cấp khía cạnh bắt buộc. 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ởi thuộc tính yêu cầu. some_aspect sau đó sẽ có quyền truy cập vào giá trị của các nhà cung cấp các 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ừ một file tools/my_def.bzl
Mặc định của --bep_maximum_open_remote_upload_files=<an integer>: "-1"
Số 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
Cờ này kiểm soát cách quản lý các đường liên kết tượng trưng tiện lợi (các đườ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). Các giá trị có thể có: bình thường (mặc định): Mỗi loại đường liên kết tượng trưng tiện lợi sẽ được tạo hoặc bị xoá, do bản dựng xác định. sạch: Tất cả các đường liên kết tượng trưng sẽ bị xóa vô điều kiện. bỏ qua: Các đường liên kết biểu tượng sẽ được để nguyên. log_only: Tạo thông điệp nhật ký như thể giá trị "normal" đã được truyền, nhưng không thực sự thực hiện bất kỳ hoạt động nào của 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 ra 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, bất kỳ liên kết tượng trưng nào có sẵn sẽ vẫn bị giữ lại.
Thẻ: affects_outputs
Cờ này kiểm soát việc chúng tôi có đăng sự kiện bản dựng tắt Tiện lợiSymlinksIdentified lên BuildEventProtocol hay không. Nếu giá trị là true thì BuildEventProtocol sẽ có một mục nhập để thuận tiệnSymlinksIdentified, liệt kê tất cả các 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 tiện lợiSymlinksIdentified trong BuildEventProtocol sẽ trống.
Thẻ: affects_outputs
--remote_download_all
Tải tất cả kết quả đầu ra từ xa xuống máy cục bộ. Cờ này là bí danh của --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
Mặc định của --remote_download_outputs=<all, minimal or toplevel>: "cấp cao nhất"
Nếu bạn đặt chính sách này thành "tối thiểu", hệ thống sẽ không tải bất kỳ kết quả bản dựng từ xa nào xuống máy cục bộ, ngoại trừ những kết quả do hành động cục bộ yêu cầu. Nếu được đặt thành 'toplevel' hoạt động giống như'tối thiểu', ngoại trừ việc nó cũng tải đầu ra 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 đều có thể làm giảm đáng kể thời gian xây dựng nếu băng thông mạng là điểm tắc nghẽn.
Thẻ: affects_outputs
Thay vì tải kết quả của 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ưới dạng một chuỗi mẫu. Chuỗi mẫu này có thể chứa {hash} và {size_bytes} mở rộng thành hàm băm của đối tượng và kích thước tính bằng byte tương ứng. Chẳng hạn, các đường liên kết tượng trưng này có thể trỏ đến 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 kết quả đầu ra từ xa của các 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
Tiền tố được thêm vào trước bất kỳ đường liên kết tượng trưng tiện lợi nào được tạo sau khi tạo bản dựng. Nếu bị bỏ qua, giá trị mặc định sẽ là tên của công cụ tạo bản dựng, theo sau là dấu gạch nối. Nếu "/" được truyền, thì sẽ không có đường liên kết tượng trưng nào được tạo và không phát ra cảnh báo. Cảnh báo: chức năng đặc biệt cho '/' sắp không được dùng nữa; thay vào đó, 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 của Bazel thực thi các đầu vào hợp lệ của bản dựng (định nghĩa quy tắc, tổ hợp cờ, v.v.):
Mặc định của --[no]experimental_docker_privileged: "false"
Nếu được bật, Bazel sẽ chuyển cờ --đặc quyền cho "docker run" khi chạy các hành động. Điều này có thể được yêu cầu bởi bản dựng của bạn, nhưng cũng có thể làm giảm độ cứng.
Thẻ: execution
Không hoạt động
Thẻ: host_machine_resource_optimizations, execution
Mặc định của --[no]incompatible_legacy_local_fallback: "false"
Nếu bạn đặt chính sách này thành true, thì hệ thống sẽ bật chế độ dự phòng ngầm ẩn cũ từ hộp cát sang chiến lược cục bộ. Cờ này cuối cùng sẽ mặc định thành 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
Đã tích luỹ --sandbox_add_mount_pair=<a single path or a 'source:target' pair> lần sử dụng
Thêm cặp đường dẫn khác để gắn trong hộp cát.
Thẻ: execution
Đã tích luỹ --sandbox_block_path=<a string> lần sử dụng
Đối với các thao tác trong hộp cát, hãy không cho phép truy cập vào đường dẫn này.
Thẻ: execution
Mặc định của --[no]sandbox_default_allow_network: "đúng"
Cho phép truy cập mạng theo mặc định cho các thao tác; tuỳ chọn này có thể không hoạt động với một số phương pháp triển khai hộp cát.
Thẻ: execution
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
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) đối với các hành động trong hộp cát.
Thẻ: execution
Đã tích luỹ --sandbox_writable_path=<a string> lần sử dụng
Đối với các hành động trong hộp cát, hãy đặt thư mục hiện có ở chế độ có thể ghi trong hộp cát (nếu được triển khai hộp cát hỗ trợ, sẽ bị bỏ qua nếu không).
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 tệp BUILD, tệp .bzl hoặc tệp WORKSPACE.:
Mặc định của --[no]incompatible_config_setting_private_default_visibility: "false"
Nếu không tương thích_enforce_config_setting_visible=false, thì đây là lỗi không phù hợp. Ngoài ra, nếu cờ này sai, thì mọi config_setting không có thuộc tính chế độ hiển thị rõ ràng sẽ là //visible:public. Nếu cờ này là true, config_setting sẽ tuân theo cùng logic hiển thị 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
Mặc định của --[no]incompatible_enforce_config_setting_visibility: "đúng"
Nếu đúng, hãy thực thi các hạn chế về chế độ hiển thị config_setting. Nếu giá trị là false, mọi config_setting sẽ 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 chi phối hành vi của môi trường kiểm thử hoặc trình chạy kiểm thử:
Mặc định của --[no]check_tests_up_to_date: "false"
Đừng chạy thử nghiệm, chỉ cần kiểm tra xem các thử nghiệm này đã được cập nhật hay chưa. Nếu tất cả kết quả kiểm thử đều là mới nhất, thì 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ỳ kiểm thử nào, thì hệ thống sẽ báo cáo lỗi và kiểm thử không thành công. Tuỳ chọn này ngụ ý hành vi --check_up_to_date.
Thẻ: execution
Đã tích luỹ --flaky_test_attempts=<a positive integer, the string "default", or test_regex@attempts. This flag may be passed more than once> lần sử dụng
Trong trường hợp kiểm thử không thành công, mỗi lượt kiểm thử sẽ được thử lại theo số lần đã chỉ định. Các kiểm thử yêu cầu nhiều lần thử để vượt qua sẽ được đánh dấu là "FLAKY" trong phần tóm tắt thử nghiệm. Thông thường, giá trị được chỉ định chỉ là một số nguyên hoặc chuỗi "default". Nếu là số nguyên thì tất cả thử nghiệm sẽ chạy tối đa N lần. Nếu giá trị "default", thì chỉ một lần kiểm thử sẽ được thực hiện cho các chương trình kiểm thử thông thường và 3 lần cho các chương trình 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 không ổn định=1). Cú pháp thay thế: regex_filter@flaky_test_Trys. Trong đó flaky_test_ings là như trên và regex_filter là viết tắt của danh sách các mẫu bao gồm và loại trừ biểu thức chính quy (Xem thêm --runs_per_test). Ví dụ: --flaky_test_Trys=//foo/.*,-//foo/bar/.*@3 gỡ bỏ tất cả các lượt kiểm thử trong //foo/ ngoại trừ những bài kiểm thử dưới foo/bar ba lần. Bạn có thể chuyển tuỳ chọn này nhiều lần. Đối số được truyền gần đây nhất mà các kết quả trùng khớp sẽ được ưu tiên. Nếu không có gì phù hợp, hành vi sẽ như "mặc định" ở trên.
Thẻ: execution
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 có thể chạy đồng thời. Chọn một số nguyên hoặc từ khoá ("auto", "HOST_CPUS", "HOST_RAM"), theo sau (không bắt buộc) là một toán tử ([-|*]<float>), ví dụ: "auto", "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
Mặc định của --[no]test_keep_going: "đúng"
Khi 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 kiểm thử đều được chạy, ngay cả khi một số kiểm thử không đạt.
Thẻ: execution
Mặc định của --test_strategy=<a string>: ""
Chỉ định chiến lược cần sử dụng khi chạy kiểm thử.
Thẻ: execution
Mặc định của --test_tmpdir=<a path>: xem nội dung mô tả
Chỉ định thư mục tạm thời cơ sở cho "kiểm thử bazel" cần sử dụng.
Các tuỳ chọn liên quan đến dữ liệu đầu ra của truy vấn và ngữ nghĩa:
Mặc định của --[no]experimental_parallel_aquery_output: "đúng"
Không hoạt động.
Các tuỳ chọn liên quan đến đầu ra và ngữ nghĩa Bzlmod:
Đã tích luỹ --allow_yanked_versions=<a string> lần sử dụng
Đã chỉ định các phiên bản mô-đun dưới dạng `<module1>@<version1>,<module2>@<version2>`. Những phiên bản này sẽ được 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 trong sổ đăng ký nơi chúng xuất phát (nếu các phiên bản đó không đến từ một NonRegistryOverride). Nếu không, các phiên bản bị giật sẽ khiến quá trình phân giải không thành công. Bạn cũng có thể xác định phiên bản được kéo mạnh được phép bằng biến môi trường "BZLMOD_ALLOW_YANKED_VERSIONS". Bạn có thể vô hiệu hoá việc kiểm tra này bằng cách sử dụng từ khoá 'all' (không được khuyến nghị).
Thẻ: loading_and_analysis
Mặc định của --check_bazel_compatibility=<error, warning or off>: "lỗi"
Kiểm tra khả năng tương thích với 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 đề lên trạng thái lỗi giải quyết, "tắt" để tắt chế độ kiểm tra, hoặc "cảnh báo" để in cảnh báo khi phát hiện thấy thông tin không khớp.
Thẻ: loading_and_analysis
Mặc định của --check_direct_dependencies=<off, warning or error>: "cảnh báo"
Kiểm tra xem các phần phụ thuộc trực tiếp "bazel_dep" được khai báo trong mô-đun gốc có giống với phiên bản bạn nhận được trong biểu đồ phần phụ thuộc đã được giải quyết hay không. Các giá trị hợp lệ là "off" ("tắt") để tắt chế độ kiểm tra, "cảnh báo" để in cảnh báo khi phát hiện thấy thông tin không khớp hoặc "error" để chuyển vấn đề lên thành lỗi giải quyết.
Thẻ: loading_and_analysis
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_secondary` trong MODULE.bazel của mô-đun gốc. Lưu ý rằng các phần phụ thuộc của 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
Mặc định của --lockfile_mode=<off, update or error>: "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 nếu có thay đổi, "error" khi dùng tệp khoá nhưng báo lỗi nếu tệp không được cập nhật, hoặc "tắt" để không đọc hoặc ghi vào tệp khoá.
Thẻ: loading_and_analysis
Đã tích luỹ --override_module=<an equals-separated mapping of module name to path> lần sử dụng
Ghi đè một mô-đun có đường dẫn cục bộ ở dạng <module name>=<path>. Nếu đường dẫn đã cho là một đường dẫn tuyệt đối, thì đường dẫn đó sẽ được sử dụng như nguyên trạng. Nếu đường dẫn đã cho là một đường dẫn tương đối, thì đường dẫn đó sẽ tương ứng với thư mục đang hoạt động hiện tại. Nếu đường dẫn đã cho bắt đầu bằng "%workspace%", thì đường dẫn đó 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 "không gian làm việc thông tin bazel")
Đã tích luỹ --registry=<a string> lần sử dụng
Chỉ định sổ đăng ký cần dùng để xác định vị trí các phần phụ thuộc của mô-đun Bazel. Thứ tự rất quan trọng: các mô-đun sẽ được tra cứu trước trong sổ đăng ký trước, và chỉ quay lại các sổ đăng ký sau khi còn thiếu trong các sổ đăng ký trước đó.
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:
Mặc định của --experimental_dynamic_ignore_local_signals=<a comma-separated list of signal numbers>: xem nội dung mô tả
Lấy danh sách số tín hiệu hệ điều hành. Nếu nhánh cục bộ của quá trình thực thi linh động bị tắt với 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 các worker liên tục, điều này chỉ ảnh hưởng đến các tín hiệu dừng quy trình của worker.
Thẻ: execution
Mặc định của --gc_thrashing_limits=<comma separated pairs of <period>:<count>>: "1s:2,20s:3,1m:5"
Các giới hạn mà nếu đạt đến mức này sẽ khiến GcThrashingDetector gây sự cố cho Bazel bằng OOM. Mỗi giới hạn được chỉ định dưới dạng <period>:<count>, trong đó khoảng thời gian là một khoảng thời gian và số lượng là một số nguyên dương. Nếu có hơn --gc_thrashing_threshold phần trăm không gian cần sử dụng (vùng nhớ khối xếp thế hệ cũ) vẫn chiếm sau <count> các GC đầy đủ liên tiếp trong khoảng <period>, thì OOM sẽ được kích hoạt. Bạn có thể chỉ định nhiều hạn mức và phân tách bằng dấu phẩy.
Thẻ: host_machine_resource_optimizations
Mặc định của --local_cpu_resources=<an integer, or "HOST_CPUS", optionally followed by [-|*]<float>.>: "HOST_CPUS"
Thiết lập rõ ràng tổng số lõi CPU cục bộ mà Bazel có thể sử dụng để chi tiêu cho các hành động xây dựng được thực thi cục bộ. Lấy một số nguyên hoặc "HOST_CPUS", tuỳ ý theo sau 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ượng lõi CPU có sẵn.
Thẻ: host_machine_resource_optimizations
Đã tích luỹ --local_extra_resources=<a named float, 'name=value'> lần sử dụng
Đặt số lượng tài nguyên bổ sung có thể sử dụng cho Bazel. Lấy trong một cặp string-float. Có thể được sử dụng nhiều lần để chỉ định nhiều loại tài nguyên bổ sung. Bazel sẽ hạn chế các hành động đồ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. Quy 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>". Không thể đặt CPU, RAM và tài nguyên sẵn có bằng cờ này.
Thẻ: host_machine_resource_optimizations
Giá trị mặc định của --local_ram_resources=<an integer number of MBs, or "HOST_RAM", optionally followed by [-|*]<float>.>: "HOST_RAM*,67"
Thiết lập rõ ràng tổng dung lượng RAM máy chủ cục bộ (tính bằng MB) mà Bazel có thể dùng để chi tiêu cho các hành động tạo bản dựng được thực thi trên máy. Lấy một số nguyên hoặc "HOST_RAM", tuỳ ý theo sau là [-|*]<float> (ví dụ: HOST_RAM*0,5 để sử dụng một nửa dung lượng 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òn trống và sẽ sử dụng 67% dung lượng RAM đó.
Thẻ: host_machine_resource_optimizations
Mặc định của --skyframe_high_water_mark_full_gc_drops_per_invocation=<an integer, >= 0>: "2147483647"
Gắn cờ cho cấu hình nâng cao của công cụ Skyframe nội bộ của Bazel. Nếu Bazel phát hiện thấy 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 đặt ra bằng --skyframe_high_water_mark_threshold, thì khi một sự kiện GC xảy ra đầy đủ, trạng thái Skyframe tạm thời không cần thiết sẽ bị bỏ qua, tối đa nhiều lần cho mỗi lệnh gọi. Mặc định là Integer.MAX_VALUE; không giới hạn hiệu quả. 0 có nghĩa là các sự kiện thu gom rác (GC) toàn bộ sẽ không bao giờ kích hoạt hiện tượng giảm. Nếu đạt đến giới hạn, trạng thái Skyframe sẽ không còn bị bỏ qua khi một sự kiện GC đầy đủ xảy ra và vượt quá ngưỡng tỷ lệ phần trăm vùng nhớ khối xếp được giữ lại đó.
Thẻ: host_machine_resource_optimizations
Mặc định của --skyframe_high_water_mark_minor_gc_drops_per_invocation=<an integer, >= 0>: "2147483647"
Gắn cờ cho cấu hình nâng cao của công cụ Skyframe nội bộ của Bazel. Nếu Bazel phát hiện thấy mức sử dụng tỷ lệ phần trăm vùng nhớ khối xếp được giữ lại vượt quá ngưỡng đặt ra bằng --skyframe_high_water_mark_threshold, thì khi một sự kiện GC nhỏ xảy ra, trạng thái Skyframe tạm thời không cần thiết sẽ bị bỏ qua, tối đa là nhiều lần cho mỗi lệnh gọi. Mặc định là Integer.MAX_VALUE; không giới hạn hiệu quả. 0 có nghĩa là các sự kiện GC nhỏ sẽ không bao giờ kích hoạt hiện tượng giảm. Nếu đạt đến giới hạn, trạng thái Skyframe sẽ không còn bị bỏ qua khi xảy ra một sự kiện GC nhỏ và ngưỡng tỷ lệ phần trăm vùng nhớ khối xếp được giữ lại đó đã vượt quá.
Thẻ: host_machine_resource_optimizations
Mặc định của --skyframe_high_water_mark_threshold=<an integer>: "85"
Gắn cờ cho cấu hình nâng cao của công cụ Skyframe nội bộ của Bazel. Nếu Bazel 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 ở ngưỡng này, thì Bazel sẽ bỏ trạng thái Skyframe tạm thời không cần thiết. Việc chỉnh sửa tính năng này có thể cho phép bạn giảm thiểu tác động của tình trạng này đến thời gian sử dụng GC, khi tình trạng giật GC là do việc sử dụng bộ nhớ ở trạng thái tạm thời này gây ra và (ii) tốn kém hơn so với việc khôi phục trạng thái khi cần.
Thẻ: host_machine_resource_optimizations
Các tuỳ chọn ảnh hưởng đến độ chi tiết, định dạng hoặc vị trí ghi nhật ký:
Mặc định của --[no]debug_spawn_scheduler: "false"
Mặc định của --[no]experimental_bep_target_summary: "false"
Liệu có nên xuất bản các sự kiện Targetsummary hay không.
Mặc định của --[no]experimental_build_event_expand_filesets: "false"
Nếu đúng, hãy mở rộng các tệp trong BEP khi trình bày các tệp đầu ra.
Thẻ: affects_outputs
Nếu đúng, hãy phân giải hoàn toàn các đường liên kết tượng trưng của Fileset tương đối trong BEP khi trình bày tệp đầu ra. Yêu cầu --experimental_build_event_expand_filesets.
Thẻ: affects_outputs
Mặc định của --experimental_build_event_upload_max_retries=<an integer>: "4"
Số lần tối đa Bazel nên thử tải lại một sự kiện bản dựng lên.
Thẻ: bazel_internal_configuration
Mặc định của --experimental_build_event_upload_retry_minimum_delay=<An immutable length of time.>: "1 giây"
Độ trễ tối thiểu ban đầu cho các lần thử lại luỹ thừa luỹ thừa khi không tải BEP lên được. (số mũ: 1,6)
Thẻ: bazel_internal_configuration
Mặc định của --experimental_build_event_upload_strategy=<a string>: xem nội dung mô tả
Chọn cách tải cấu phần phần mềm được tham chiếu lên trong giao thức sự kiện xây dựng.
Thẻ: affects_outputs
Mặc định của --[no]experimental_collect_local_sandbox_action_metrics: "đúng"
Không hoạt động nữa.
Thẻ: execution
Mặc định của --[no]experimental_command_profile: "false"
Ghi lại hồ sơ CPU của Trình ghi chuyến bay Java vào tệp profile.jfr trong thư mục cơ sở đầu ra. Trong tương lai, cú pháp và ngữ nghĩa của cờ này có thể thay đổi để hỗ trợ nhiều loại hồ sơ hoặc định dạng đầu ra; bạn tự chịu rủi ro khi sử dụng.
Mặc định của --[no]experimental_docker_verbose: "false"
Nếu bạn bật chế độ này, Bazel sẽ in thêm các thông báo chi tiết về chiến lược hộp cát Docker.
Thẻ: execution
Mặc định của --[no]experimental_materialize_param_files_directly: "false"
Nếu cụ thể hoá các tệp tham số, hãy thực hiện bằng cách ghi trực tiếp vào ổ đĩa.
Thẻ: execution
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 thao tác ghi nhớ 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ả chức năng ghi nhớ.
Mặc định của --experimental_repository_resolved_file=<a string>: ""
Nếu không trống, hãy ghi một giá trị Starlark kèm theo 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
Mặc định của --[no]experimental_run_bep_event_include_residue: "false"
Liệu có nên đưa dư lượng dòng lệnh vào các sự kiện chạy bản dựng có thể chứa dư lượng đó hay không. Theo mặc định, phần dư không được đưa vào các sự kiện tạo bản dựng lệnh chạy có thể chứa phần dư.
Thẻ: affects_outputs
Mặc định của --[no]experimental_stream_log_file_uploads: "false"
Truy cập trực tiếp tệp nhật ký truyền trực tuyến lên bộ nhớ từ xa thay vì ghi vào ổ đĩa.
Thẻ: affects_outputs
Mặc định của --explain=<a path>: xem nội dung mô tả
Làm cho hệ thống xây dựng giải thích từng bước đượ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
Mặc định của --[no]ignore_unsupported_sandboxing: "false"
Không in cảnh báo khi thực thi hộp cát không được hỗ trợ trên hệ thống này.
Thẻ: terminal_output
Mặc định của --[no]legacy_important_outputs: "đúng"
Sử dụng trường này để loại bỏ việc tạo trườngimportant_outputs cũ trong sự kiện TargetComplete. Quan trọng_outputs là bắt buộc để tích hợp Bazel với ResultStore.
Thẻ: affects_outputs
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 thực thi hành động từ xa. Hữu ích khi gỡ lỗi các thao tác. Điều này được ngụ ý bằng lệnh --subcommands và --verbose_failures.
Thẻ: execution
Mặc định của --max_config_changes_to_show=<an integer>: "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, sẽ hiện tối đa số tên tuỳ chọn đã thay đổi nhất định. Nếu số đã cho là -1, tất cả các tuỳ chọn đã thay đổi sẽ hiển thị.
Thẻ: terminal_output
Mặc định của --max_test_output_bytes=<an integer>: "-1"
Chỉ định kích thước tối đa cho mỗi nhật ký kiểm thử có thể được phát khi --test_output là ' lỗi' hoặc "all". Được dùng để tránh làm cho đầu ra quá tải với đầu ra kiểm thử quá ồn. Tiêu đề kiểm thử được bao gồm trong kích thước nhật ký. Giá trị âm ngụ ý không có giới hạn. Đầu ra là tất cả hoặc không có gì.
Thẻ: test_runner, terminal_output, execution
Mặc định của --output_filter=<a valid Java regular expression>: xem nội dung mô tả
Chỉ cho thấy các cảnh báo và kết quả của hành động đối với những quy tắc có tên khớp với biểu thức chính quy đã cho.
Thẻ: affects_outputs
Mặc định của --progress_report_interval=<an integer in 0-3600 range>: "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 đó được báo cáo mỗi phút một lần. Khi 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>: "thất bại"
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" (thất bại) để chỉ in khi không thành công, "thành công" để chỉ in khi thành công và "all" để luôn in.
Thẻ: terminal_output
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 2 điều: thứ nhất, nội dung gốc của hộp cát sẽ không bị ảnh hưởng sau khi tạo bản dựng; và thứ hai, in thêm thông tin gỡ lỗi khi thực thi. Việc này có thể giúp nhà phát triển các quy tắc Bazel hoặc Starlark gặp lỗi gỡ lỗi do thiếu tệp đầu vào, v.v.
Thẻ: terminal_output
Mặc định của --show_result=<an integer>: "1"
Hiện kết quả của bản dựng. Đối với mỗi mục tiêu, hãy nêu rõ mục tiêu đó có được cập nhật hay không và nếu có, hãy nêu 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 cho việc sao chép+dán vào shell để thực thi chúng. 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à trên đó thông tin kết quả không được in. Do đó, không có gây ra tình trạng chặn thông báo và MAX_INT khiến việc in kết quả luôn xảy ra. Giá trị mặc định là 1. Nếu không có mục tiêu nào được xây dựng cho một mục tiêu, thì kết quả có thể bị bỏ qua để giữ đầu ra dưới ngưỡng.
Thẻ: affects_outputs
Giá trị mặc định của --[no]subcommands [-s]: "false"
Hiển thị các lệnh con được thực thi trong một 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
Mặc định --test_output=<summary, errors, all or streamed>: "tóm tắt"
Chỉ định chế độ đầu ra mong muốn. Các giá trị hợp lệ là "summary" (tóm tắt) để chỉ xuất bản tóm tắt trạng thái kiểm thử, " errors" để in cả nhật ký kiểm thử cho các chương trình kiểm thử không thành công, "all" để in nhật ký cho tất cả chương trình kiểm thử và "stream" ("phát trực tuyến") đến nhật ký đầu ra cho tất cả chương trình kiểm thử theo thời gian thực (điều này sẽ buộc các bài kiểm thử phải được thực thi cục bộ mỗi lần bất kể giá trị --test_Strategy).
Thẻ: test_runner, terminal_output, execution
Mặc định của --test_summary=<short, terse, detailed, none or testcase>: "ngắn"
Chỉ định định dạng mong muốn của thông tin tóm tắt kiểm thử. Giá trị hợp lệ là "ngắn" để chỉ in thông tin về các lượt kiểm thử được thực thi, "ngắn gọn", để chỉ in thông tin về các lượt kiểm thử đã chạy không thành công, "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, "trường hợp kiểm thử" để in thông tin tóm tắt trong quá trình 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à "không" để bỏ qua phần tóm tắt.
Thẻ: terminal_output
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 tính năng giải thích. Không có ảnh hưởng gì nếu không bật giải thích.
Thẻ: affects_outputs
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
Tuỳ chọn chỉ định hoặc thay đổi dữ liệu đầu vào chung thành lệnh Bazel không thuộc các danh mục khác.:
Đã tích luỹ --aspects_parameters=<a 'name=value' assignment> lần sử dụng
Chỉ định giá trị của các tham số khía cạnh dòng lệnh. Mỗi giá trị thông số được chỉ định thông qua <param_name>=<param_value>, ví dụ như 'my_param=my_val' trong đó 'my_param' là một thông số của một số khía cạnh trong danh sách --aspect hoặc được một khía cạnh trong danh sách yêu cầu. Bạn có thể sử dụng tuỳ chọn này nhiều lần. Tuy nhiên, bạn không được phép chỉ định giá trị cho cùng một thông số nhiều lần.
Thẻ: loading_and_analysis
Mặc định của --experimental_resolved_file_instead_of_workspace=<a string>: ""
Nếu nội dung không trống, hãy đọc tệp đã được phân giải được chỉ định thay vì tệp WORKSPACE
Thẻ: changes_inputs
Mặc định của --target_pattern_file=<a string>: ""
Nếu bạn đặt chính sách này, bản dựng sẽ đọc các mẫu của tệp có tên ở đây, thay vì trên dòng lệnh. Sẽ xảy ra lỗi khi chỉ định tệp tại đây cũng như mẫu dòng lệnh.
Thẻ: changes_inputs
Tuỳ chọn thực thi và lưu vào bộ nhớ đệm từ xa:
Mặc định của --experimental_circuit_breaker_strategy=<failure>: xem nội dung mô tả
Chỉ định chiến lược cho cầu dao sẽ sử dụng. Các chiến lược có thể sử dụng được gọi là "thất bại". Khi có giá trị không hợp lệ cho lựa chọn, hành vi giống như lựa chọn không được đặt.
Thẻ: execution
Mặc định của --experimental_downloader_config=<a string>: 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ủ (cho `allow` và `block`) hoặc hai mẫu, một mẫu để so khớp và một mẫu dùng làm URL thay thế, có tham chiếu ngược bắt đầu từ "$1". Có thể có nhiều lệnh "rewrite" cho cùng một URL và trong trường hợp này sẽ có nhiều URL được trả về.
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 thời gian xử lý tệp đầu vào của một thao tác trước khi tải thao tác lên bộ nhớ đệm từ xa. Có thể có những trường hợp nhân Linux trì hoãn việc ghi tệp, điều này có thể dẫn đến kết quả dương tính giả.
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ì trong quá trình tái tạo.
Mặc định của --experimental_remote_cache_eviction_retries=<an integer>: "0"
Số lần thử lại tối đa nếu bản dựng gặp lỗi khi loại bỏ bộ nhớ đệm từ xa. Giá trị khác 0 sẽ ngầm đặt --incompatible_remote_use_new_exit_code_for_lost_inputs thành true. Mã lệnh gọi mới sẽ được tạo cho mỗi lần thử. Nếu tạo mã gọi và cung cấp mã đó cho Bazel kèm theo --invocation_id, thì 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 rồi kiểm tra mã thoát 39.
Thẻ: execution
Mặc định của --[no]experimental_remote_cache_lease_extension: "false"
Nếu bạn đặt chính sách này thành true, Bazel sẽ gia hạn thời gian thuê đối với kết quả của các hành động từ xa trong quá trình tạo bản dựng bằng cách định kỳ gửi các lệnh gọi "Find MissingBlobs" đến bộ nhớ đệm từ xa. Tần suất dựa trên giá trị "--experimental_remote_cache_ttl".
Mặc định của --experimental_remote_cache_ttl=<An immutable length of time.>: "3 giờ"
Thời gian TTL tối thiểu được đảm bảo của các blob trong bộ nhớ đệm từ xa sau khi chuỗi đại diện của chúng được tham chiếu gần đây, chẳng hạn như ActionResult hoặc Find MissingBlobs. Bazel thực hiện một số hoạt động tối ưu hoá dựa trên TTL của các giọt nước, ví dụ: không liên tục gọi GetActionResult trong một bản dựng tăng dần. Bạn nên đặt giá trị này nhỏ hơn một chút so với TTL thực tế, vì có khoảng trống giữa thời điểm máy chủ trả về thông báo tổng hợp và thời điểm Bazel nhận được thông báo đó.
Thẻ: execution
Mặc định của --experimental_remote_capture_corrupted_outputs=<a path>: xem nội dung mô tả
Một đường dẫn đến thư mục chứa các dữ liệu đầu ra bị lỗi.
Mặc định của --[no]experimental_remote_discard_merkle_trees: "false"
Nếu bạn đặt chính sách này thành true (đúng), hãy loại bỏ các bản sao trong bộ nhớ của cây Mermble của gốc đầu vào và các ánh xạ đầu vào được liên kết trong lệnh gọi đến GetActionResult() và Execute(). Điều này giúp giảm đáng kể mức sử dụng bộ nhớ, nhưng Bazel phải tính toán lại khi bộ nhớ đệm từ xa bị bỏ lỡ và thử lại.
Mặc định của --experimental_remote_downloader=<a string>: xem nội dung mô tả
URI điểm cuối của Remote Asset API để dùng làm proxy tải xuống từ xa. Các giản đồ được hỗ trợ là grpc, grpcs (grpc có bật TLS) và unix (các ổ cắm UNIX cục bộ). Nếu 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
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ộ hay không nếu trình tải xuống từ xa không thành công.
Mặc định của --[no]experimental_remote_execution_keepalive: "false"
Liệu có nên sử dụng keepalive cho các lệnh gọi thực thi từ xa hay không.
Mặc định của --experimental_remote_failure_rate_threshold=<an integer in 0-100 range>: "10"
Đặt tỷ lệ lỗi được cho phép theo tỷ lệ phần trăm trong một khoảng thời gian cụ thể, sau thời điểm đó sẽ ngừng gọi đến bộ nhớ đệm/trình thực thi từ xa. Theo mặc định, giá trị là 10. Đặt giá trị này thành 0 có nghĩa là không có giới hạn.
Thẻ: execution
Mặc định của --experimental_remote_failure_window_interval=<An immutable length of time.>: "60 giây"
Khoảng thời gian tính toán tỷ lệ lỗi của các yêu cầu từ xa. Khi có giá trị âm hoặc giá trị 0, thời lượng lỗi được tính trong toàn bộ thời gian 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ị thì giá trị sẽ được thể hiện dưới dạng giây.
Thẻ: execution
Mặc định của --[no]experimental_remote_mark_tool_inputs: "false"
Nếu bạn đặt chính sách này thành true, Bazel sẽ đánh dấu dữ liệu đầu vào là đầu vào công cụ cho bộ thực thi từ xa. Phương thức này có thể dùng để triển khai trình thực thi liên tục từ xa.
Mặc định của --[no]experimental_remote_merkle_tree_cache: "false"
Nếu bạn đặt chính sách này thành true, thì các phép tính trong cây Mermming sẽ được ghi nhớ để cải thiện tốc độ kiểm tra lượt truy cập của bộ nhớ đệm từ xa. Bản in chân bộ nhớ của bộ nhớ đệm được kiểm soát bởi --experimental_remote_mermble_tree_cache_size.
Giá trị mặc định của --experimental_remote_merkle_tree_cache_size=<a long integer>: "1000"
Số lượng cây Mermble cần ghi nhớ để cải thiện tốc độ kiểm tra lượt truy cập của bộ nhớ đệm từ xa. Mặc dù bộ nhớ đệm được tự động giảm bớt theo cách xử lý các tệp tham chiếu mềm của Java, nhưng lỗi hết bộ nhớ vẫn có thể xảy ra nếu bạn đặt mức bộ nhớ quá cao. Nếu bạn đặt chính sách này thành 0, thì dung lượng bộ nhớ đệm sẽ không giới hạn. Giá trị tối ưu sẽ khác nhau tuỳ thuộc vào quy mô của dự án. Giá trị mặc định là 1000.
Mặc định của --[no]experimental_remote_require_cached: "false"
Nếu bạn đặt chính sách này thành true (đúng), hãy thực thi rằng tất cả các hành động có thể chạy từ xa đều được lưu vào bộ nhớ đệm, nếu không, quá trình tạo sẽ không thành công. Điều này hữu ích trong việc khắc phục các vấn đề không xác định vì tính năng này 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.
Mặc định của --experimental_remote_scrubbing_config=<Converts to a Scrubber>: 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 cấu hình này phải là vùng đệm giao thức ScrubbingConfig ở định dạng văn bản. Tính năng này giúp hỗ trợ việc chia sẻ bộ nhớ đệm từ xa/ổ đĩ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 ứng dụng này thật cẩn thận vì chế độ cài đặt không đúng có thể vô tình chia sẻ các mục trong bộ nhớ đệm và dẫn đến bản dựng không chính xác. Việc rà soát 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 cho mục đích truy xuất hoặc lưu trữ kết quả của hành động. Bạn không thể sử dụng tính năng này cùng với quá trình thực thi từ xa. Việc sửa đổi cấu hình xoá sạch sẽ không vô hiệu hoá các kết quả có trong hệ thống tệp cục bộ hoặc bộ nhớ đệm nội bộ; 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 có thể cần đặt mộ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).
Mặc định của --experimental_worker_for_repo_fetching=<off, platform or virtual>: "tắt"
Chế độ phân luồng dùng để tìm nạp kho lưu trữ. Nếu bạn đặt chính sách này thành "tắt", thì sẽ không có luồng worker nào được sử dụng và quá trình tìm nạp kho lưu trữ có thể khởi động lại. Ngược lại, hãy sử dụng luồng nền tảng (tức là luồng hệ điều hành) nếu được đặt thành "platform" hoặc luồng ảo nếu được đặt thành "virtual".
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.
Mặc định của --[no]incompatible_remote_downloader_send_all_headers: "đúng"
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ỉ gửi giá trị đầu tiên hay không.
Thẻ: incompatible_change
Mặc định của --[no]incompatible_remote_output_paths_relative_to_input_root: "false"
Nếu bạn đặt chính sách này thành true, thì đườ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
Mặc định của --[no]incompatible_remote_results_ignore_disk: "đúng"
Không hoạt động
Thẻ: incompatible_change
Mặc định của --[no]incompatible_remote_use_new_exit_code_for_lost_inputs: "đúng"
Nếu bạn đặt chính sách này thành true, Bazel sẽ sử dụng mã thoát mới 39 thay vì 34 nếu bộ nhớ đệm từ xa xoá các blob trong quá trình xây dựng.
Thẻ: incompatible_change
Mặc định của --[no]remote_accept_cached: "đúng"
Liệu có chấp nhận kết quả hành động được lưu từ xa vào bộ nhớ đệm hay không.
Mặc định của --remote_build_event_upload=<all or minimal>: "tối thiểu"
Nếu bạn đặt chính sách này thành "all", thì mọi kết quả đầu ra cục bộ mà BEP tham chiếu sẽ được tải lên bộ nhớ đệm từ xa. Nếu đặt ở mức "tối thiểu", dữ liệu đầu ra cục bộ được 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 tra và hồ sơ thời gian). Lược đồ bytestream:// luôn được dùng cho URI của tệp ngay cả khi thiếu bộ nhớ đệm từ xa. Giá trị mặc định là "tối thiểu".
Mặc định của --remote_bytestream_uri_prefix=<a string>: xem nội dung mô tả
Tên máy chủ và tên thực thể sẽ được dùng trong các URI bytestream:// được ghi vào các luồng sự kiện của 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 một proxy. Điều này 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. Khi bạn không đặt chính sách này, giá trị này sẽ mặc định là "${hostname}/${instance_name}".
Mặc định của --remote_cache=<a string>: 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 có bật TLS) và unix (các ổ cắm UNIX cục bộ). Nếu không cung cấp giản đồ, Bazel sẽ mặc định sử dụng grpcs. Hãy chỉ định giản đồ grpc://, http:// hoặc unix: để tắt TLS. Hãy truy cập vào https://bazel.build/remote/caching
Mặc định của --[no]remote_cache_compression: "false"
Nếu bật, hãy nén/giải nén các blob bộ nhớ đệm bằng zstd.
Đã tích luỹ --remote_cache_header=<a 'name=value' assignment> lần sử dụng
Chỉ định tiêu đề sẽ được đưa vào các yêu cầu về bộ nhớ đệm: --remote_cache_header=Name=Value. Có thể chuyển nhiều tiêu đề bằng cách chỉ định cờ nhiều lần. Nhiều giá trị cho cùng tên sẽ được chuyển đổi thành danh sách được phân tách bằng dấu phẩy.
Đã tích luỹ --remote_default_exec_properties=<a 'name=value' assignment> lần sử dụng
Đặt thuộc tính exec mặc định được 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
Mặc định của --remote_default_platform_properties=<a string>: ""
Đặt thuộc tính mặc định của nền tảng là thuộc tính cho API thực thi từ xa, trong trường hợp 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.
Đã tích luỹ --remote_download_regex=<a string> lần sử dụng
Buộc Bazel tải các cấu phần phần mềm khớp với biểu thức chính quy đã cho xuống. Được dùng cùng với Bản dựng không có Bytes (hoặc giá trị tương đương nội bộ) để cho phép ứng dụng yêu cầu một số cấu phần phần mềm nhất định có thể cần thiết cục bộ (ví dụ: hỗ trợ IDE). Bạn có thể chỉ định nhiều biểu thức chính quy bằng cách lặp lại cờ này.
Thẻ: affects_outputs
Đã tích luỹ --remote_downloader_header=<a 'name=value' assignment> lần sử dụng
Chỉ định tiêu đề sẽ được đưa vào yêu cầu của trình tải xuống từ xa: --remote_downloader_header=Name=Value. Có thể chuyển nhiều tiêu đề bằng cách chỉ định cờ nhiều lần. Nhiều giá trị cho cùng tên sẽ được chuyển đổi thành danh sách được phân tách bằng dấu phẩy.
Đã tích luỹ --remote_exec_header=<a 'name=value' assignment> lần sử dụng
Hãy chỉ định tiêu đề sẽ được đưa vào các yêu cầu thực thi: --remote_exec_header=Name=Value. Có thể chuyển nhiều tiêu đề bằng cách chỉ định cờ nhiều lần. Nhiều giá trị cho cùng tên sẽ được chuyển đổi thành danh sách được phân tách bằng dấu phẩy.
Mặc định của --remote_execution_priority=<an integer>: "0"
Mức độ ưu tiên tương đối của các hành động cần 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ủ.
Mặc định của --remote_executor=<a string>: xem nội dung mô tả
máy chủ hoặc máy chủ:KH của điểm cuối thực thi từ xa. Các giản đồ được hỗ trợ là grpc, grpcs (grpc có bật TLS) và unix (các ổ cắm UNIX cục bộ). Nếu không cung cấp giản đồ, Bazel sẽ mặc định sử dụng grpcs. Hãy chỉ định grpc:// hoặc unix: giản đồ để tắt TLS.
Mặc định của --remote_grpc_log=<a path>: xem nội dung mô tả
Nếu được chỉ định, đường dẫn đến một tệp để ghi nhật ký 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 com.google.devtools.build.lib.remote.logging.RemoteExecutionLog.LogEntry protobufs với mỗi thông báo có tiền tố một varint cho biết kích thước của thông báo protobuf nối tiếp sau đây, như được thực hiện bằng phương thức LogEntry.writeDelimitedTo(OutputStream).
Đã tích luỹ --remote_header=<a 'name=value' assignment> lần sử dụng
Chỉ định tiêu đề sẽ được đưa vào yêu cầu: --remote_header=Name=Value. Có thể chuyển nhiều tiêu đề bằng cách chỉ định cờ nhiều lần. Nhiều giá trị cho cùng tên sẽ được chuyển đổi thành danh sách được phân tách bằng dấu phẩy.
Mặc định của --remote_instance_name=<a string>: ""
Giá trị cần truyền dưới dạng instance_name trong API thực thi từ xa.
Mặc định của --[no]remote_local_fallback: "false"
Liệu có nên quay lại chiến lược thực thi cục bộ độc lập hay không nếu quá trình thực thi từ xa không thành công.
Mặc định của --remote_local_fallback_strategy=<a string>: "local"
Không hoạt động, không dùng nữa. Truy cập https://github.com/bazelbuild/bazel/issues/7480 để biết chi tiết.
Giá trị mặc định của --remote_max_connections=<an integer>: "100"
Giới hạn số lượng đường kết nối đồng thời tối đa cho bộ nhớ đệm/trình thực thi từ xa. Theo mặc định, giá trị là 100. Đặ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ể thực hiện 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, do đó Bazel có thể đưa ra các yêu cầu đồng thời "--remote_max_connections * 100".
Thẻ: host_machine_resource_optimizations
Mặc định của --remote_proxy=<a string>: xem nội dung mô tả
Kết nối với bộ nhớ đệm từ xa thông qua một proxy. Hiện tại, bạn chỉ có thể sử dụng cờ này để định cấu hình ổ cắm miền Unix (unix:/path/to/socket).
Mặc định của --remote_result_cache_priority=<an integer>: "0"
Mức độ ưu tiên tương đối của các thao tác từ xa cần 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ủ.
Mặc định của --remote_retries=<an integer>: "5"
Số lần thử tối đa để thử lại một lỗi tạm thời. Nếu bạn đặt chính sách này thành 0, thì tính năng thử lại sẽ tắt.
Mặc định của --remote_retry_max_delay=<An immutable length of time.>: "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ị thì giá trị sẽ được thể hiện dưới dạng giây.
Mặc định của --remote_timeout=<An immutable length of time.>: "60 giây"
Khoảng thời gian tối đa để chờ thực thi từ xa và lệnh gọi bộ nhớ đệm. Đối với bộ nhớ đệm REST, đây là 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ị thì giá trị sẽ được thể hiện dưới dạng giây.
Mặc định của --[no]remote_upload_local_results: "đúng"
Liệu có nên 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 làm vậy.
Mặc định của --[no]remote_verify_downloads: "đúng"
Nếu bạn đặt chính sách này thành true, Bazel sẽ tính toán tổng giá trị băm của tất cả lượt tải xuống từ xa và loại bỏ các giá trị đã lưu từ xa vào bộ nhớ đệm nếu chúng không khớp với giá trị dự kiến.
Các lựa chọn khác, không được phân loại.:
Mặc định của --[no]allow_analysis_cache_discard: "đúng"
Nếu loại bỏ bộ nhớ đệm phân tích do có sự thay đổi trong hệ thống xây dựng, việc đặt tuỳ chọn này thành false sẽ khiến bazel thoát thay vì tiếp tục quá trình tạo 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
Mặc định của --auto_output_filter=<none, all, packages or subpackages>: "không có"
Nếu bạn không chỉ định --output_filter thì bộ lọc sẽ tự động tạo giá trị cho tuỳ chọn này. Giá trị được phép là 'none' (không lọc gì / hiển thị mọi thứ), 'all' (lọc tất cả / không hiển thị gì), 'packages' (bao gồm kết quả đầu ra từ các quy tắc trong các gói được đề cập trên dòng lệnh Blaze) và 'subpackages' (như 'packages', nhưng cũng bao gồm các gói con). Đối với các giá trị 'packages' và 'subpackages', //java/foo và //javatests/foo được coi là một gói).
Mặc định của --[no]build_manual_tests: "false"
Buộc tạo các mục tiêu thử nghiệm được gắn thẻ "thủ công". Không bao gồm các thử nghiệm "thủ công". Tuỳ chọn này buộc bạn phải tạo mẫu quảng cáo (nhưng không được thực thi).
Mặc định của --build_tag_filters=<comma-separated list of options>: ""
Chỉ định một danh sách thẻ được phân tách bằng dấu phẩy. Mỗi thẻ có thể được bắt đầu bằng dấu ":" để chỉ định các thẻ bị loại trừ. Chỉ những mục tiêu đó sẽ được tạo có chứa ít nhất một thẻ được bao gồm và không chứa bất kỳ thẻ bị loại trừ nà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" (kiểm thử); các kiểm thử đó chịu sự điều chỉnh của các tuỳ chọn lọc kiểm thử, chẳng hạn như "--test_tag_filter"
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 đượ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 thứ được yêu cầu sẽ được tạo.
Mặc định của --combined_report=<none or lcov>: "không có"
Chỉ định loại báo cáo mức độ sử dụng tích luỹ mong muốn. Tại thời điểm này, chúng tôi chỉ hỗ trợ LCOV.
Mặc định của --[no]compile_one_dependency: "false"
Biên dịch một phần phụ thuộc duy nhất của các tệp đối số. Điều này rất hữu ích cho các tệp nguồn kiểm tra cú pháp trong IDE, chẳng hạn như bằng cách tạo lại một mục tiêu duy nhất phụ thuộc vào tệp nguồn để phát hiện lỗi càng sớm càng tốt 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ả các đối số không phải cờ; thay vì là mục tiêu để tạo, chúng lại là tên tệp nguồn. Một mục tiêu tuỳ ý phụ thuộc vào tên tệp nguồn sẽ được tạo.
Đã tích luỹ --deleted_packages=<comma-separated list of package names> lần sử dụng
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 những gói này xuất hiện ở vị trí nào đó trên đường dẫn gói. Sử dụng tuỳ chọn này khi xoá gói con "x/y" của 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ể báo cáo 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. Chỉ định --delete_packages x/y sẽ tránh được sự cố này.
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 cho các bản dựng gia tăng thêm chậm hơn.
Mặc định của --disk_cache=<a path>: xem nội dung mô tả
Một đường dẫn đến thư mục nơi Bazel có thể đọc và ghi các thao tác cũng như đầu ra của thao tác. Nếu thư mục không tồn tại, nó sẽ được tạo.
Mặc định của --embed_label=<a one-line string>: ""
Nhúng bản sửa đổi hoặc nhãn phát hành kiểm soát nguồn trong tệp nhị phân
Mặc định của --execution_log_binary_file=<a path>: xem nội dung mô tả
Ghi nhật ký các sinh sản được thực thi vào tệp này dưới dạng các protos spawn được phân tách, theo src/main/protobuf/spawn.proto. Cờ liên quan: --execution_log_json_file (định dạng văn bản JSON; loại trừ lẫn nhau), --execution_log_sort (cho dù 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).
Mặc định của --execution_log_json_file=<a path>: xem nội dung mô tả
Ghi lại các sinh nhật đã thực thi vào tệp này dưới dạng tệp đại diện JSON của các protos Spawn được phân tách, theo src/main/protobuf/spawn.proto. Cờ liên quan: --execution_log_binary_file (định dạng protobuf nhị phân; loại trừ lẫn nhau), --execution_log_sort (cho dù là để sắp xếp nhật ký thực thi), --subcommands (để hiển thị các lệnh con trong đầu ra của thiết bị đầu cuối).
Mặc định của --[no]execution_log_sort: "đúng"
Liệu có nên sắp xếp nhật ký thực thi hay không, giúp bạn dễ dàng so sánh nhật ký giữa các lệnh gọi. Đặt thành false để tránh mức sử dụng CPU và bộ nhớ có thể đáng kể ở cuối lệnh gọi, với chi phí tạo nhật ký trong lệnh thực thi không xác định.
Mặc định của --[no]expand_test_suites: "đúng"
Mở rộng các mục tiêu test_suite thành các kiểm thử cấu thành của chúng 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 phủ định sẽ áp dụng cho các kiểm thử thuộc bộ kiểm thử, nếu không thì các mẫu mục tiêu phủ định 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 đó, chúng có thể phân tích các mục tiêu test_suite.
Thẻ: loading_and_analysis
Mặc định của --experimental_extra_action_filter=<a comma-separated list of regex expressions with prefix '-' specifying excluded paths>: ""
Ngừng sử dụng và thay vào đó là một số khía cạnh. Bộ lọc tập hợp các mục tiêu để lên lịch hành động bổ sung.
Mặc định của --[no]experimental_extra_action_top_level_only: "false"
Ngừng sử dụng và thay vào đó là một số khía cạnh. Chỉ lên lịch các hành động phụ cho các mục tiêu cấp cao nhất.
--experimental_spawn_scheduler
Cho phép thực thi linh hoạt bằng cách chạy song song các thao tác trên máy và từ xa. Bazel tạo từng hành động trên thiết bị và từ xa, sau đó chọn hành động hoàn thành trước. Nếu một thao tác hỗ trợ trình thực thi, thì thao tác trên máy sẽ chạy ở chế độ trình thực thi liên tục. Để bật tính năng thực thi động cho từng thao tác ghi nhớ hành động riêng lẻ, hãy sử dụng các cờ "--internal_spawn_scheduler" và "--strategy=<mnemonic>=dynamic".
Mở rộng thành:
  --internal_spawn_scheduler
  --spawn_strategy=dynamic
Mặc định của --[no]incompatible_dont_use_javasourceinfoprovider: "false"
Không hoạt động
Thẻ: incompatible_change
Mặc định của --local_termination_grace_seconds=<an integer>: "15"
Thời gian chờ giữa thời điểm 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 đó.
Đã tích luỹ --override_repository=<an equals-separated mapping of repository name to path> lần sử dụng
Ghi đè một 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à một đường dẫn tuyệt đối, thì đường dẫn đó sẽ được sử dụng nguyên vẹn. Nếu đường dẫn đã cho là một đườ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 đó 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 "không gian làm việc thông tin bazel")
Giá trị mặc định của --package_path=<colon-separated list of options>: "%workspace%"
Danh sách được phân tách bằng dấu hai chấm nơi bạn sẽ tìm thấy 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 xung quanh. Nếu bị bỏ qua hoặc để trống, giá trị mặc định sẽ là dữ liệu đầu ra của "bazel info default-package-path".
Mặc định của --[no]show_loading_progress: "đúng"
Nếu bạn bật tuỳ chọn này, Bazel sẽ in thông báo "Đang tải gói:".
Mặc định của --test_lang_filters=<comma-separated list of options>: ""
Chỉ định danh sách ngôn ngữ kiểm thử được phân tách bằng dấu phẩy. Mỗi ngôn ngữ có thể bắt đầu bằng dấu ":" để chỉ định các ngôn ngữ bị loại trừ. Chúng tôi sẽ chỉ tìm thấy những mục tiêu thử nghiệm được viết bằng ngôn ngữ được chỉ định. Tên được sử 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 giá trị '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ử.
Mặc định của --test_size_filters=<comma-separated list of values: small, medium, large or enormous>: ""
Chỉ định danh sách kích thước kiểm thử được phân tách bằng dấu phẩy. Mỗi kích thước có thể được bắt đầu bằng dấu ":" để chỉ định các kích thước bị loại trừ. Bạn sẽ chỉ tìm thấy những mục tiêu thử nghiệm đó có chứa ít nhất một kích thước đã được đưa vào và không chứa bất kỳ kích thước bị loại trừ nào. Tuỳ chọn này ảnh hưởng đến hành vi --build_tests_only và lệnh kiểm thử.
Mặc định của --test_tag_filters=<comma-separated list of options>: ""
Chỉ định danh sách thẻ kiểm thử được phân tách bằng dấu phẩy. Mỗi thẻ có thể được bắt đầu bằng dấu ":" để chỉ định các thẻ bị loại trừ. Bạn sẽ chỉ tìm thấy những mục tiêu thử nghiệm đó có chứa ít nhất một thẻ được bao gồm và không chứa bất kỳ thẻ bị loại trừ nào. Tuỳ chọn này ảnh hưởng đến hành vi --build_tests_only và lệnh kiểm thử.
Mặc định của --test_timeout_filters=<comma-separated list of values: short, moderate, long or eternal>: ""
Chỉ định danh sách các thời gian chờ kiểm thử được phân tách bằng dấu phẩy. Mỗi thời gian chờ có thể đứng sau dấu ":" để chỉ định thời gian chờ bị loại trừ. Hệ thống sẽ chỉ tìm thấy các mục tiêu thử nghiệm đó có 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ừ. Tuỳ chọn này ảnh hưởng đến hành vi --build_tests_only và lệnh kiểm thử.
Mặc định của --workspace_status_command=<path>: ""
Một lệnh được gọi khi bắt đầu bản dựng để cung cấp thông tin trạng thái của không gian làm việc dưới dạng các cặp khoá/giá trị. Hãy xem Hướng dẫn sử dụng để biết toàn bộ thông số kỹ thuật. Ngoài ra, hãy truy cập vào tools/buildstamp/get_workspace_status để xem ví dụ.
Các tuỳ chọn kiểm soát quá trình thực thi bản dựng:
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ập nhật chưa. Nếu tất cả các mục tiêu đều được cập nhật, bản dựng sẽ hoàn tất thành công. Nếu bất kỳ bước nào cần được thực thi, hệ thống sẽ báo cáo lỗi và bản dựng sẽ không hoạt động.
Thẻ: execution
Liệu có nên thực hiện lệnh gọi hệ thống tệp trực tiếp để tạo cây liên kết tượng trưng hay không
Các thẻ: loading_and_analysis, execution, experimental
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
Mặc định của --[no]experimental_remotable_source_manifests: "false"
Liệu có nên làm cho hành động trong tệp kê khai nguồn có thể điều khiển từ xa hay không
Các thẻ: loading_and_analysis, execution, experimental
Mặc định của --[no]experimental_split_coverage_postprocessing: "false"
Nếu đúng, Bazel sẽ chạy quá trình xử lý hậu kỳ về mức độ phù hợp để kiểm thử trong một quy trình tái tạo mới.
Thẻ: execution
Mặc định của --[no]experimental_split_xml_generation: "đúng"
Nếu bạn đặt cờ này và thao tác kiểm thử không tạo ra 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 quá trình kiểm thử.
Thẻ: execution
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 mọi cấu phần phần mềm đầu ra là tệp thông thường. Chúng sẽ không truyền tải 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
Mặc định của --[no]experimental_use_semaphore_for_jobs: "false"
Nếu bạn đặt chính sách này thành true (đúng), 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
Mặc định của --genrule_strategy=<comma-separated list of options>: ""
Chỉ định cách thực thi quy tắc genrules. Cờ này sẽ bị loại bỏ. 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 quy tắc genrules.
Thẻ: execution
--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. Chọn một số nguyên hoặc từ khoá ("auto", "HOST_CPUS", "HOST_RAM"), theo sau (không bắt buộc) là một toán tử ([-|*]<float>), ví dụ: "auto", "HOST_CPUS*.5". Giá trị phải nằm trong khoảng từ 1 đến 5000. Giá trị trên 2500 có thể gây ra vấn đề về bộ nhớ. "auto" tính toán giá trị mặc định hợp lý dựa trên tài nguyên máy chủ lưu trữ.
Thẻ: host_machine_resource_optimizations, execution
Giá trị mặc định của --[no]keep_going [-k]: "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 đạt và những mục tiêu phụ thuộc vào mục tiêu đó, nhưng bạn có thể phải đáp ứng 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
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ố lượng luồng song song cần dùng cho giai đoạn tải/phân tích. Lấy một số nguyên hoặc từ khoá ("auto", "HOST_CPUS", "HOST_RAM"), theo sau (không bắt buộc) là một thao tác ([-|*]<float>), ví dụ: "auto", "HOST_CPUS*.5". "auto" đặt giá trị mặc định hợp lý dựa trên tài nguyên máy chủ. Giá trị phải lớn hơn hoặc bằng 1.
Thẻ: bazel_internal_configuration
Mặc định của --modify_execution_info=<regex=[+-]key,regex=[+-]key,...>: ""
Thêm hoặc xoá khoá khỏi thông tin thực thi của một hành động dựa trên tính năng ghi nhớ 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ự 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ách ghi nhớ. Cú pháp: "regex=[+-]key,regex=[+-]key,...". Ví dụ: ".*=+x,.*=-y,.*=+z" thêm "x" và "z" vào, đồng thời xoá "y" khỏi thông tin thực thi cho mọi hành động. 'Genquy=+requirements-x' sẽ thêm 'requirements-x' vào thông tin thực thi cho tất cả các hành động theo Quy tắc tạo sinh. '(?!GenRules).*=-requirements-x' sẽ xoá 'requires-x' khỏi thông tin thực thi cho mọi hành động không phải là Quy tắc.
Thẻ: execution, affects_outputs, loading_and_analysis
--persistent_android_dex_desugar
Kích hoạt các hành động tạo tệp 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
Hỗ trợ bộ xử lý tài nguyên Android ổn định bằng cách sử dụng trình thực thi (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=workerhost_machine_resource_optimizationsexecution
--persistent_multiplex_android_dex_desugar
Hỗ trợ các thao tác Android dex và đơn giản hoá ở chế độ ghép kênh liên tục bằng cách sử dụng trình thực thi (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
Cho phép bộ xử lý tài nguyên Android ghép kênh ổn định bằng cách sử dụng trình thực thi (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-workershost_machine_resource_optimizationsexecution
--persistent_multiplex_android_tools
Bật các công cụ Android đa năng và ổn định (tạo tệp dex, đơn giản hoá, 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
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ẽ tự động bị bỏ qua khi bạn bật tuỳ chọn này. Hãy xem bài viết: https://bazel.build/ext hóa/platforms#skipping-incompatible-targets
Thẻ: loading_and_analysis
Mặc định của --spawn_strategy=<comma-separated list of options>: ""
Chỉ định cách thực thi các hành động sinh sản theo mặc định. Chấp nhận danh sách các chiến lược được phân tách bằng dấu phẩy từ mức độ ưu tiên cao nhất đến thấp nhất. Đối với mỗi hành động, Bazel chọn chiến lược có mức độ ưu tiên cao nhất có thể thực hiện hành động đó. Giá trị mặc định là "remote,worker,sandboxed,local". Tham khảo tại https://blog.bazel.build/2019/06/19/list-strategy.html để biết chi tiết.
Thẻ: execution
Đã tích luỹ --strategy=<a '[name=]value1[,..,valueN]' assignment> lần sử dụng
Chỉ định cách phân phối nội dung biên dịch của các hành động sinh sản khác. Chấp nhận danh sách các chiến lược được phân tách bằng dấu phẩy từ mức độ ưu tiên cao nhất đến thấp nhất. Đối với mỗi hành động, Bazel chọn chiến lược có mức độ ưu tiên cao nhất có thể thực hiện hành động đó. Giá trị mặc định là "remote,worker,sandboxed,local". Cờ này ghi đè các giá trị được đặt bởi --spawn_strategy (và --genRule_strategy nếu được sử dụng với quy tắc ghi nhớ). Tham khảo tại https://blog.bazel.build/2019/06/19/list-strategy.html để biết chi tiết.
Thẻ: execution
Đã tích luỹ --strategy_regexp=<a '<RegexFilter>=value[,value]' assignment> lần sử dụng
Ghi đè chiến lược tạo (spawn) cần sử dụng để thực thi các hành động tạo sinh có nội dung mô tả khớp với một regex_filter nhất định. Xem --per_file_copt để biết chi tiết về so khớp regex_filter. Hệ thống sẽ sử dụng regex_filter gần đây nhất khớp với nội dung mô tả. Tuỳ chọn này sẽ ghi đè các cờ khác để chỉ định chiến lược. Ví dụ: --strategy_regexp=//foo.*\.cc,-//foo/bar=local có nghĩa là chạy các hành động bằng chiến lược cục bộ nếu nội dung mô tả của chú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 đảo ngược thứ tự sẽ chạy chiến lược đó bằng "sandboxed".
Thẻ: execution
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:
Mặc định của --android_compiler=<a string>: xem nội dung mô tả
Trình biên dịch mục tiêu của Android.
Thẻ: affects_outputs, loading_and_analysis, loses_incremental_state
Mặc định của --android_crosstool_top=<a build target label>: "//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
Mặc định của --android_grte_top=<a label>: xem nội dung mô tả
Mục tiêu grte_top trên Android.
Thẻ: changes_inputs, loading_and_analysis, loses_incremental_state
Mặc định của --android_manifest_merger=<legacy, android or force_android>: "android"
Chọn trình hợp nhất tệp kê khai để sử dụng cho các quy tắc android_binary. Gắn 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
Mặc định của --android_platforms=<a build target label>: ""
Đặt 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à một APK lớn, chứa các tệp nhị phân gốc cho từng nền tảng đích được chỉ định.
Thẻ: changes_inputs, loading_and_analysis, loses_incremental_state
Giá trị mặc định của --android_sdk=<a build target label>: "@bazel_tools//tools/android:sdk"
Chỉ định SDK/nền tảng Android dùng để xây dựng ứng dụng Android.
Thẻ: changes_inputs, loading_and_analysis, loses_incremental_state
Giá trị mặc định của --apple_crosstool_top=<a build target label>: "@bazel_tools//tools/cpp:toolchain"
Nhãn của gói công cụ chéo sẽ được dùng trong các quy tắc Apple và Objc và phần phụ thuộc của các quy tắc này.
Thẻ: loses_incremental_state, changes_inputs
Mặc định của --cc_output_directory_tag=<a string>: ""
Chỉ định một hậu tố để thêm vào thư mục cấu hình.
Thẻ: affects_outputs
Mặc định của --compiler=<a string>: 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
Giá trị mặc định của --coverage_output_generator=<a build target label>: "@bazel_tools//tools/test:lcov_merger"
Vị trí của tệp nhị phân được dùng để báo cáo mức độ phù hợp thô sau khi xử lý. Đây phải là một nhóm tệp có chứa một tệp duy nhất, đó là tệp nhị phân. Giá trị mặc định là '//tools/test:lcov_merger'.
Thẻ: changes_inputs, affects_outputs, loading_and_analysis
Giá trị mặc định của --coverage_report_generator=<a build target label>: "@bazel_tools//tools/test:Coverage_report_generator"
Vị trí của tệp nhị phân được dùng để tạo báo cáo mức độ phù hợp. Đây phải là một nhóm tệp có chứa một tệp duy nhất, đó là tệp nhị phân. Giá trị mặc định là '//tools/test:Coverage_report_generator'.
Thẻ: changes_inputs, affects_outputs, loading_and_analysis
Giá trị mặc định của --coverage_support=<a build target label>: "@bazel_tools//tools/test:Coverage_support"
Vị trí của các tệp hỗ trợ bắt buộc đối với 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
Giá trị mặc định của --crosstool_top=<a build target label>: "@bazel_tools//tools/cpp:toolchain"
Nhãn của gói công cụ chéo dùng để biên dịch mã C++.
Thẻ: loading_and_analysis, changes_inputs, affects_outputs
Mặc định của --custom_malloc=<a build target label>: xem nội dung mô tả
Chỉ định phương thức triển khai Malloc tuỳ chỉnh. Chế độ cài đặt này ghi đè các thuộc tính Malloc trong quy tắc tạo bản dựng.
Thẻ: changes_inputs, affects_outputs
Đã tích luỹ --experimental_add_exec_constraints_to_targets=<a '<RegexFilter>=<label1>[,<label2>,...]' assignment> lần sử dụng
Danh sách các biểu thức chính quy được phân tách bằng dấu phẩy, mỗi biểu thức chính quy có tiền tố (không bắt buộc) là dấu - (biểu thức âm), được gán (=) cho một danh sách các mục tiêu giá trị ràng buộc được phân tách bằng dấu phẩy. Nếu một mục tiêu khớp với không có biểu thức âm nào và có ít nhất một biểu thức dương, thì quá trình phân giải chuỗi công cụ của mục tiêu sẽ được thực hiện như thể đã khai báo các giá trị ràng buộc dưới dạng các quy tắ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
Mặc định của --[no]experimental_include_xcode_execution_requirements: "false"
Nếu được đặt, hãy thêm yêu cầu thực thi "requires-xcode:{version}" vào mọi hành động trên Xcode. Nếu phiên bản xcode có nhãn có dấu gạch nối, hãy thêm cả yêu cầu thực thi "requires-xcode-label:{version_label}".
Thẻ: loses_incremental_state, loading_and_analysis, execution
Mặc định của --[no]experimental_prefer_mutual_xcode: "đúng"
Nếu đúng, hãy sử dụng Xcode mới nhất có sẵn cả trên máy và từ xa. Nếu giá trị là false hoặc nếu không có phiên bản nào cho nhau, hãy sử dụng phiên bản Xcode cục bộ đã chọn thông qua xcode-select.
Thẻ: loses_incremental_state
Mặc định của --extra_execution_platforms=<comma-separated list of options>: ""
Các nền tảng có thể sử dụng dưới dạng nền tảng thực thi để chạy các hành động. Các nền tảng có thể được chỉ định theo mục tiêu chính xác hoặc làm mẫu mục tiêu. Các nền tảng này sẽ được xem xét trước các 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 phiên bản sau này sẽ ghi đè chế độ cài đặt cờ trước đó.
Thẻ: execution
Đã tích luỹ --extra_toolchains=<comma-separated list of options> lần sử dụng
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ụ. Chuỗi công cụ có thể được chỉ định 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().
Các thẻ: affects_outputs, changes_inputs, loading_and_analysis
Mặc định của --grte_top=<a label>: xem nội dung mô tả
Nhãn cho thư viện libc đã xác nhận có mặt. Giá trị mặc định được chọn bởi chuỗi công cụ crosstool và bạn hầu như không bao giờ cần ghi đè giá trị đó.
Thẻ: action_command_lines, affects_outputs
Mặc định của --host_compiler=<a string>: xem nội dung mô tả
Trình biên dịch C++ dùng để biên dịch máy chủ. Thuộc tính này sẽ bị bỏ qua nếu bạn không đặt --host_crosstool_top.
Thẻ: loading_and_analysis, execution
Mặc định của --host_crosstool_top=<a build target label>: 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 executor. Nếu cờ này được cung cấp, Bazel sẽ sử dụng libc và trình biên dịch mặc định cho crosstool_top nhất định.
Thẻ: loading_and_analysis, changes_inputs, affects_outputs
Mặc định của --host_grte_top=<a label>: 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 exec.
Thẻ: action_command_lines, affects_outputs
Giá trị mặc định của --host_platform=<a build target label>: "@local_config_platform//:host"
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
Mặc định của --[no]incompatible_dont_enable_host_nonhost_crosstool_features: "đúng"
Nếu đúng, Bazel sẽ không bật các tính năng "host" (máy chủ) và "nonhost" (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
Mặc định của --[no]incompatible_enable_android_toolchain_resolution: "đúng"
Sử dụng độ phân giải của chuỗi công cụ để chọn SDK Android cho quy tắc Android (Starlark và gốc)
Thẻ: loading_and_analysis, incompatible_change
Mặc định của --[no]incompatible_enable_apple_toolchain_resolution: "false"
Sử dụng độ phân giải của chuỗi công cụ để chọn SDK Apple cho quy tắc Apple (Starlark và gốc)
Thẻ: loading_and_analysis, incompatible_change
Mặc định của --[no]incompatible_make_thinlto_command_lines_standalone: "đúng"
Nếu đúng, Bazel sẽ không sử dụng lại các dòng lệnh của thao tác liên kết C++ để lập chỉ mục 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
Mặc định của --[no]incompatible_remove_legacy_whole_archive: "đúng"
Nếu đúng, Bazel sẽ không liên kết các phần phụ thuộc của thư viện dưới dạng toàn bộ kho lưu trữ theo mặc định (xem https://github.com/bazelbuild/bazel/issues/7362 để biết hướng dẫn di chuyển).
Thẻ: loading_and_analysis, incompatible_change
Mặc định của --[no]incompatible_require_ctx_in_configure_features: "đúng"
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
Mặc định của --[no]interface_shared_objects: "đúng"
Sử dụng các đố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
Mặc định của --ios_sdk_version=<a dotted version (for example '2.3' or '3.3alpha2.4')>: xem nội dung mô tả
Chỉ định phiên bản của SDK iOS cần dùng để 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 qua "xcode_version".
Thẻ: loses_incremental_state
Mặc định của --macos_sdk_version=<a dotted version (for example '2.3' or '3.3alpha2.4')>: xem nội dung mô tả
Chỉ định phiên bản của SDK macOS sẽ dùng để xây dựng ứng dụng macOS. Nếu bạn không chỉ định, hãy sử dụng phiên bản SDK macOS mặc định qua "xcode_version".
Thẻ: loses_incremental_state
Mặc định của --minimum_os_version=<a string>: xem nội dung mô tả
Phiên bản hệ điều hành tối thiểu mà quá trình biên dịch nhắm đến.
Thẻ: loading_and_analysis, affects_outputs
Mặc định của --platform_mappings=<a relative path>: ""
Vị trí của tệp ánh xạ cho biết nền tảng nào sẽ được sử dụng nếu không có nền tảng nào được đặt hoặc cờ nào cần đặt khi đã có nền tảng. Phải tương ứng với thư mục gốc của không gian làm việc chính. Giá trị 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
Mặc định của --platforms=<a build target label>: ""
Nhãn của các quy tắc nền tảng mô tả nền tảng đích cho lệnh hiện tại.
Thẻ: affects_outputs, changes_inputs, loading_and_analysis
Mặc định của --python2_path=<a string>: xem nội dung mô tả
Ngừng sử dụng, không hoạt động. Bị vô hiệu hoá bởi "--incompatible_use_python_toolchains".
Các thẻ: no_op, deprecated
Mặc định của --python3_path=<a string>: xem nội dung mô tả
Ngừng sử dụng, không hoạt động. Bị vô hiệu hoá bởi "--incompatible_use_python_toolchains".
Các thẻ: no_op, deprecated
Mặc định của --python_path=<a string>: 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ởi --incompatible_use_python_toolchains.
Thẻ: loading_and_analysis, affects_outputs
Mặc định của --python_top=<a build target label>: 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ởi --incompatible_use_python_toolchains.
Thẻ: loading_and_analysis, affects_outputs
Mặc định của --tvos_sdk_version=<a dotted version (for example '2.3' or '3.3alpha2.4')>: xem nội dung mô tả
Chỉ định phiên bản của SDK tvOS dùng để tạo ứ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
Mặc định của --watchos_sdk_version=<a dotted version (for example '2.3' or '3.3alpha2.4')>: xem nội dung mô tả
Chỉ định phiên bản của SDK watchOS dùng để tạo các ứng dụng watchOS. Nếu bạn chưa chỉ định, hãy sử dụng phiên bản SDK watchOS mặc định từ "xcode_version".
Thẻ: loses_incremental_state
Mặc định của --xcode_version=<a string>: 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 hành động tạo liên quan. Nếu bạn không chỉ định, hãy sử dụng phiên bản Xcode mặc định cho trình thực thi của mình.
Thẻ: loses_incremental_state
Giá trị mặc định của --xcode_version_config=<a build target label>: "@bazel_tools//tools/cpp:host_xcodes"
Nhãn của quy tắc xcode_config được 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 kết quả của lệnh:
Mặc định của --[no]apple_generate_dsym: "false"
Liệu có nên tạo (các) tệp biểu tượng gỡ lỗi (.dSYM) hay không.
Thẻ: affects_outputs, action_command_lines
Mặc định của --[no]build: "đúng"
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 hành động tạo bản dựng, trả về 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 cho việc kiểm thử các giai đoạn đó.
Thẻ: execution, affects_outputs
Nếu đúng, hãy tạo các khu rừng liên kết tượng trưng runfiles cho tất cả mục tiêu. Nếu giá trị là sai, chỉ ghi khi được yêu cầu bởi một thao tác cục bộ, lệnh kiểm tra hoặc chạy.
Thẻ: affects_outputs
Mặc định của --[no]build_runfile_manifests: "đúng"
Nếu đúng, hãy ghi tệp kê khai runfile cho tất cả mục tiêu. Nếu giá trị là false, hãy bỏ qua chúng. Các kiểm thử cục bộ sẽ không chạy được khi giá trị false.
Thẻ: affects_outputs
Mặc định của --[no]build_test_dwp: "false"
Nếu được bật, khi tạo kiểm thử C++ theo cách tĩnh và 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
Mặc định của --cc_proto_library_header_suffixes=<comma-separated set of options>: ".pb.h"
Đặt hậu tố cho các tệp tiêu đề mà cc_proto_library tạo.
Thẻ: affects_outputs, loading_and_analysis
Mặc định của --cc_proto_library_source_suffixes=<comma-separated set of options>: ".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
Mặc định của --[no]experimental_proto_descriptor_sets_include_source_info: "false"
Chạy thêm các thao tác cho các phiên bản API Java thay thế trong một proto_library.
Thẻ: affects_outputs, loading_and_analysis, experimental
Mặc định của --[no]experimental_proto_extra_actions: "false"
Chạy thêm các thao tác cho các phiên bản API Java thay thế trong một proto_library.
Thẻ: affects_outputs, loading_and_analysis, experimental
Mặc định của --[no]experimental_save_feature_state: "false"
Lưu trạng thái của các chức 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
Mặc định của --[no]experimental_use_validation_aspect: "false"
Liệu có nên chạy các hành động xác thực bằng cách sử dụng khung hiển thị (để chạy song song với các hoạt động kiểm thử) hay không.
Thẻ: execution, affects_outputs
Mặc định của --fission=<a set of compilation modes>: "không"
Chỉ định những chế độ biên dịch sử dụng quá trình phân tách cho các đường liên kết và nội dung biên dịch C++. Có thể là bất kỳ tổ hợp nào của {'fastbuild', 'dbg', 'opt'} hoặc giá trị đặc biệt "yes" để bật tất cả chế độ và "no" để tắt mọi chế độ.
Thẻ: loading_and_analysis, action_command_lines, affects_outputs
Mặc định của --[no]incompatible_always_include_files_in_data: "đúng"
Nếu đúng, các quy tắc gốc sẽ thêm <code>DefaultInfo.files</code> các phần phụ thuộc dữ liệu vào các tệp runfile của chúng, khớp với hành vi được đề xuất cho các quy tắc Starlark (https://bazel.build/ext hóa/rules#runfiles_features_to_avoid).
Thẻ: affects_outputs, incompatible_change
Mặc định của --[no]legacy_external_runfiles: "đúng"
Nếu đúng, hãy tạo các khu rừng liên kết tượng trưng runfiles cho các kho lưu trữ bên ngoài trong miền .runfiles/wsname/external/repo (ngoài .runfiles/repo).
Thẻ: affects_outputs
Mặc định của --[no]objc_generate_linkmap: "false"
Chỉ định xem có tạo tệp bản đồ liên kết hay không.
Thẻ: affects_outputs
Đã tích luỹ --output_groups=<comma-separated list of options> lần sử dụng
Danh sách tên các nhóm đầu ra được phân tách bằng dấu phẩy, mỗi tên có tiền tố là dấu + hoặc dấu - (không bắt buộc) có tiền tố là dấu + sẽ được thêm vào tập hợp các nhóm đầu ra mặc định, còn nhóm có tiền tố - sẽ bị xoá khỏi tập hợp mặc định. Nếu có ít nhất một nhóm không có tiền tố, thì tập hợp nhóm đầu ra mặc định sẽ bị bỏ qua. Ví dụ: --output_groups=+foo,+bar tạo sự hợp nhất của tập hợp mặc định, foo và bar, trong khi --output_groups=foo,bar ghi đè tập hợp mặc định để chỉ foo và bar được tạo.
Thẻ: execution, affects_outputs
Mặc định của --[no]run_validations: "đúng"
Liệu có nên chạy các hành động xác thực trong bản dựng hay không. Xem tại https://bazel.build/ext hóa/rules#validate_actions
Thẻ: execution, affects_outputs
Mặc định của --[no]save_temps: "false"
Nếu bạn đặt chính sách này, các kết quả tạm thời từ gcc sẽ được lưu. Những tệp này bao gồm tệp .s (mã tập hợp), tệp .i (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ự định, ảnh hưởng đến giá trị của kết quả đó, trái ngược với sự tồn tại của kết quả đó:
Đã tích luỹ --action_env=<a 'name=value' assignment with an optional value part> lần sử dụng
Chỉ định tập hợp 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 cặp tên=giá trị để đặt giá trị độc lập với môi trường gọi. Bạn có thể sử dụng lựa chọn này nhiều lần; đối với các lựa chọn được cung cấp cho cùng một biến, các chiến thắng gần đây nhất, các lựa chọn cho các biến khác nhau sẽ tích luỹ.
Thẻ: action_command_lines
Giá trị mặc định của --android_cpu=<a string>: "armeabi-v7a"
CPU mục tiêu của Android.
Thẻ: affects_outputs, loading_and_analysis, loses_incremental_state
Mặc định của --[no]android_databinding_use_androidx: "đúng"
Tạo các tệp liên kết dữ liệu tương thích với AndroidX. Tính năng này chỉ được sử dụng với tính năng liên kết dữ liệu phiên bản 2. Cờ này không hoạt động.
Các thẻ: affects_outputs, loading_and_analysis, loses_incremental_state, experimental
Mặc định của --[no]android_databinding_use_v3_4_args: "đúng"
Sử dụng tính năng liên kết dữ liệu của Android phiên bản 2 với đối số 3.4.0. Cờ này không hoạt động.
Các thẻ: affects_outputs, loading_and_analysis, loses_incremental_state, experimental
Mặc định của --android_dynamic_mode=<off, default or fully>: "tắt"
Xác định xem phần phụ thuộc C++ của các quy tắc Android có được liên kết động hay không khi cc_binary không tạo thư viện dùng chung một cách rõ ràng. "default" 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ế độ chủ yếu là tĩnh.
Thẻ: affects_outputs, loading_and_analysis
Giá trị mặc định của --android_manifest_merger_order=<alphabetical, alphabetical_by_configuration or dependency>: "theo thứ tự bảng chữ cái"
Đặt thứ tự các tệp kê khai được chuyển đến trình hợp nhất tệp kê khai cho tệp nhị phân Android. ALPHABETICAL có nghĩa là các tệp kê khai được sắp xếp theo đường dẫn tương ứng với tệp thực thi. ALPHABETICAL_BY_CONFIGURATION 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 có nghĩa là các tệp kê khai được sắp xếp theo thứ tự với tệp kê khai của từng thư viện xuất hiện trước tệp kê khai của các phần phụ thuộc.
Thẻ: action_command_lines, execution
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 APK android_binary sử dụng ProGuard.
Thẻ: affects_outputs, loading_and_analysis
Đã tích luỹ --aspects=<comma-separated list of options> lần sử dụng
Danh sách được phân tách bằng dấu phẩy về các khía cạnh sẽ được áp dụng cho mục tiêu cấp cao nhất. Trong danh sách, nếu khía cạnh some_aspect chỉ định nhà cung cấp khía cạnh bắt buộc thông qua required_aspect_providers, some_aspect sẽ chạy theo mọi khía cạnh đã được đề cập trước đó trong danh sách khía cạnh có nhà cung cấp được quảng cáo đáp ứng some_aspect nhà cung cấp khía cạnh bắt buộc. 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ởi thuộc tính yêu cầu. some_aspect sau đó sẽ có quyền truy cập vào giá trị của các nhà cung cấp các 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ừ một file tools/my_def.bzl
Mặc định của --[no]build_python_zip: "tự động"
Tạo tệp zip có thể thực thi cho python; trên Windows, tắt trên các nền tảng khác
Thẻ: affects_outputs
Đã tích luỹ --catalyst_cpus=<comma-separated list of options> lần sử dụng
Danh sách 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
Mặc định của --[no]collect_code_coverage: "false"
Nếu được chỉ định, Bazel sẽ đo lường mã (sử dụng khả năng đo lường ngoại tuyến nếu có thể) và sẽ thu thập thông tin về mức độ phù hợp trong quá trình kiểm thử. Chỉ những mục tiêu khớp với --Instrumentation_filter sẽ 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 mà nên sử dụng lệnh 'bazel Coverage' để thay thế.
Thẻ: affects_outputs
--compilation_mode=<fastbuild, dbg or opt> [-c] mặc định: "fastbuild"
Chỉ định chế độ mà bạn sẽ tạo tệp nhị phân. Giá trị: "fastbuild", "dbg", "opt".
Thẻ: affects_outputs, action_command_lines
Đã tích luỹ --conlyopt=<a string> lần sử dụng
Tuỳ chọn bổ sung để chuyển đến gcc khi biên dịch tệp nguồn C.
Thẻ: action_command_lines, affects_outputs
Đã tích luỹ --copt=<a string> lần sử dụng
Các tuỳ chọn bổ sung để chuyển đến gcc.
Thẻ: action_command_lines, affects_outputs
Mặc định của --cpu=<a string>: ""
CPU mục tiêu.
Thẻ: changes_inputs, affects_outputs
Mặc định của --cs_fdo_absolute_path=<a string>: 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 cấu hình, tệp cấu hình LLVM thô hoặc đã được lập chỉ mục.
Thẻ: affects_outputs
Mặc định của --cs_fdo_instrument=<a string>: xem nội dung mô tả
Tạo tệp nhị phân có khả năng đo lường FDO theo bối 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à theo đó(các) tệp cấu hình thô sẽ được kết xuất trong thời gian chạy.
Thẻ: affects_outputs
Mặc định của --cs_fdo_profile=<a build target label>: xem nội dung mô tả
cs_fdo_profile đại diện cho hồ sơ có phân biệt ngữ cảnh dùng để tối ưu hoá.
Thẻ: affects_outputs
Đã tích luỹ --cxxopt=<a string> lần sử dụng
Tuỳ chọn bổ sung để chuyển đến gcc khi biên dịch tệp nguồn C++.
Thẻ: action_command_lines, affects_outputs
Đã tích luỹ --define=<a 'name=value' assignment> lần sử dụng
Mỗi tuỳ chọn --define chỉ định việc gán cho một biến bản dựng.
Thẻ: changes_inputs, affects_outputs
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. "default" có nghĩa là Bazel sẽ chọn có liên kết linh hoạt 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ế độ chủ yếu là tĩnh.
Thẻ: loading_and_analysis, affects_outputs
Mặc định của --[no]enable_fdo_profile_absolute_path: "đúng"
Nếu bạn đặt chính sách này, việc sử dụng fdo_absolute_profile_path sẽ gây ra lỗi.
Thẻ: affects_outputs
Mặc định của --[no]enable_runfiles: "tự động"
Bật cây liên kết tượng trưng runfile. Theo mặc định, cây này sẽ bị tắt trên Windows và trên các nền tảng khác.
Thẻ: affects_outputs
Đã tích luỹ --experimental_action_listener=<a build target label> lần sử dụng
Ngừng sử dụng và thay vào đó là một số khía cạnh. Sử dụng action_listener để đính kèm thêm một hành động phụ vào các hành động tạo bản dựng hiện có.
Thẻ: execution, experimental
Mặc định của --[no]experimental_android_compress_java_resources: "false"
Nén tài nguyên Java trong tệp APK
Các thẻ: affects_outputs, loading_and_analysis, experimental
Mặc định của --[no]experimental_android_databinding_v2: "đúng"
Sử dụng tính năng liên kết dữ liệu của Android phiên bản 2. Cờ này không hoạt động.
Các thẻ: affects_outputs, loading_and_analysis, loses_incremental_state, experimental
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 APK android_binary sử dụng ProGuard.
Thẻ: affects_outputs, loading_and_analysis
Mặc định của --[no]experimental_android_rewrite_dexes_with_rex: "false"
dùng công cụ rex để ghi lại tệp dex
Các thẻ: affects_outputs, loading_and_analysis, loses_incremental_state, experimental
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 về phạm vi thu thập cho các tệp được tạo.
Thẻ: affects_outputs
Cờ này kiểm soát cách quản lý các đường liên kết tượng trưng tiện lợi (các đườ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). Các giá trị có thể có: bình thường (mặc định): Mỗi loại đường liên kết tượng trưng tiện lợi sẽ được tạo hoặc bị xoá, do bản dựng xác định. sạch: Tất cả các đường liên kết tượng trưng sẽ bị xóa vô điều kiện. bỏ qua: Các đường liên kết biểu tượng sẽ được để nguyên. log_only: Tạo thông điệp nhật ký như thể giá trị "normal" đã được truyền, nhưng không thực sự thực hiện bất kỳ hoạt động nào của 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 ra 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, bất kỳ liên kết tượng trưng nào có sẵn sẽ vẫn bị giữ lại.
Thẻ: affects_outputs
Cờ này kiểm soát việc chúng tôi có đăng sự kiện bản dựng tắt Tiện lợiSymlinksIdentified lên BuildEventProtocol hay không. Nếu giá trị là true thì BuildEventProtocol sẽ có một mục nhập để thuận tiệnSymlinksIdentified, liệt kê tất cả các 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 tiện lợiSymlinksIdentified trong BuildEventProtocol sẽ trống.
Thẻ: affects_outputs
Mặc định của --experimental_objc_fastbuild_options=<comma-separated list of options>: "-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
Mặc định của --[no]experimental_omitfp: "false"
Nếu đúng, hãy sử dụng libunwind để tháo dỡ ngăn xếp (stack) và biên dịch bằng -fomit-frame-pointer và -faasync-unwind-tables.
Thẻ: action_command_lines, affects_outputs, experimental
Mặc định của --experimental_output_paths=<off, content or strip>: "tắt"
Mô hình cần sử dụng để ghi kết quả đầu ra trong quy tắc cây đầu ra, đặc biệt là cho các bản dựng đa nền tảng / nhiều cấu hình. Đây là tính năng mang tính thử nghiệm cao. Truy cập https://github.com/bazelbuild/bazel/issues/6526 để biết chi tiết. Các hành động Starlark có thể chọn ánh xạ đường dẫn bằng cách thêm khoá "supports-path-mapping" vào lệnh "execution_requirements".
Thẻ: loses_incremental_state, bazel_internal_configuration, affects_outputs, execution
Đã tích luỹ --experimental_override_name_platform_in_output_dir=<a 'label=value' assignment> lần sử dụng
Mỗi mục nhập phải có dạng label=value, trong đó nhãn chỉ một nền tảng và giá trị là tên viết tắt mong muốn để sử dụng trong đường dẫn đầu ra. Chỉ được sử dụng khi --experimental_platform_in_output_dir là giá trị true. Có mức độ ưu tiên đặt tên cao nhất.
Thẻ: affects_outputs, experimental
Mặc định của --[no]experimental_platform_in_output_dir: "false"
Nếu đúng, tên viết tắt của nền tảng mục tiêu sẽ được sử dụng trong tên thư mục đầu ra thay vì CPU. Lược đồ chính xác đang thử nghiệm và có thể thay đổi: Trước tiên, trong trường hợp hiếm gặp, tuỳ chọn --platforms không có chính xác một giá trị, hàm băm của tuỳ chọn nền tảng sẽ được sử dụng. Tiếp theo, nếu bất kỳ tên viết tắt nào cho nền tảng hiện tại đã được đăng ký --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_heuristics đã đặt, 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 được dùng làm phương án cuối cùng.
Thẻ: affects_outputs, experimental
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 đồ phủ sóng llvm-cov thay vì gcov khi collection_code_Coverage được bật.
Thẻ: changes_inputs, affects_outputs, loading_and_analysis, experimental
Mặc định của --[no]experimental_use_platforms_in_output_dir_legacy_heuristic: "đúng"
Vui lòng chỉ sử dụng cờ này cho chiến lược di chuyển hoặc thử nghiệm đượ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
Giá trị mặc định của --fat_apk_cpu=<comma-separated set of options>: "armeabi-v7a"
Việc đặt tuỳ chọn này sẽ bật các APK lớn, chứa các tệp nhị phân gốc cho tất cả cấu trúc mục tiêu đã chỉ định, ví dụ: --fat_apk_cpu=x86,armeabi-v7a. Nếu cờ này được chỉ định, 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
Mặc định của --[no]fat_apk_hwasan: "false"
Liệu có tạo phần phân tách HWASAN hay không.
Thẻ: affects_outputs, loading_and_analysis, loses_incremental_state
Mặc định của --fdo_instrument=<a string>: 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à theo đó(các) tệp cấu hình thô sẽ được kết xuất trong thời gian chạy.
Thẻ: affects_outputs
Mặc định của --fdo_optimize=<a string>: 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 cấu hình LLVM. Cờ này cũng chấp nhận các tệp được chỉ định dưới dạng nhãn (ví dụ: "//foo/bar:file.afdo" – bạn có thể cần phải 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
Mặc định của --fdo_prefetch_hints=<a build target label>: xem nội dung mô tả
Sử dụng gợi ý tìm nạp trước bộ nhớ đệm.
Thẻ: affects_outputs
Mặc định của --fdo_profile=<a build target label>: xem nội dung mô tả
Fdo_profile đại diện cho hồ sơ dùng để tối ưu hoá.
Thẻ: affects_outputs
Đã tích luỹ --features=<a string> lần sử dụng
Theo mặc định, các tính năng cụ thể sẽ được bật hoặc tắt cho các mục tiêu được tạo trong cấu hình mục tiêu. Khi bạn chỉ định -<feature>, tính năng này sẽ tắt. Các tính năng tiêu cực luôn được ưu tiên hơn các tính năng khẳng định. Xem thêm --host_features
Các thẻ: changes_inputs, affects_outputs
Mặc định của --[no]force_pic: "false"
Nếu được bật, tất cả nội dung biên dịch C++ đều tạo mã độc lập về vị trí ("-fPIC"), các đường liên kết sẽ ưu tiên thư viện tạo sẵn PIC hơn so với thư viện không phải PIC và đường liên kết tạo ra các tệp thực thi độc lập về vị trí ("-pie").
Thẻ: loading_and_analysis, affects_outputs
Đã tích luỹ --host_action_env=<a 'name=value' assignment with an optional value part> lần sử dụng
Chỉ định tập hợp 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 cặp tên=giá trị để đặt giá trị độc lập với môi trường gọi. Bạn có thể sử dụng lựa chọn này nhiều lần; đối với các lựa chọn được cung cấp cho cùng một biến, các chiến thắng gần đây nhất, các lựa chọn cho các biến khác nhau sẽ tích luỹ.
Thẻ: action_command_lines
Mặc định của --host_compilation_mode=<fastbuild, dbg or opt>: "opt"
Chỉ định chế độ mà các công cụ dùng trong quá trình tạo bản dựng sẽ được tích hợp. Giá trị: "fastbuild", "dbg", "opt".
Thẻ: affects_outputs, action_command_lines
Đã tích luỹ --host_conlyopt=<a string> lần sử dụng
Tuỳ chọn bổ sung để chuyể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 executor.
Thẻ: action_command_lines, affects_outputs
Đã tích luỹ --host_copt=<a string> lần sử dụng
Các tuỳ chọn bổ sung để truyền đến trình biên dịch C đối với các công cụ được tạo trong cấu hình executor.
Thẻ: action_command_lines, affects_outputs
Mặc định của --host_cpu=<a string>: ""
CPU của máy chủ.
Thẻ: changes_inputs, affects_outputs
Đã tích luỹ --host_cxxopt=<a string> lần sử dụng
Các tuỳ chọn bổ sung để chuyển đến trình biên dịch C++ đối với các công cụ được tạo trong cấu hình executor.
Thẻ: action_command_lines, affects_outputs
Đã tích luỹ --host_features=<a string> lần sử dụng
Theo mặc định, các tính năng cụ thể sẽ được bật hoặc tắt đối với các mục tiêu được xây dựng trong cấu hình thực thi. Khi bạn chỉ định -<feature>, tính năng này sẽ tắt. Các tính năng tiêu cực luôn được ưu tiên hơn các tính năng khẳng định.
Thẻ: changes_inputs, affects_outputs
Mặc định của --host_force_python=<PY2 or PY3>: xem nội dung mô tả
Ghi đè phiên bản Python cho cấu hình executor. Có thể là "PY2" hoặc "PY3".
Thẻ: loading_and_analysis, affects_outputs
Đã tích luỹ --host_linkopt=<a string> lần sử dụng
Tuỳ chọn bổ sung để chuyển tới trình liên kết khi liên kết các công cụ trong cấu hình tệp thực thi.
Thẻ: action_command_lines, affects_outputs
Mặc định của --host_macos_minimum_os=<a dotted version (for example '2.3' or '3.3alpha2.4')>: xem nội dung mô tả
Phiên bản macOS tương thích tối thiểu cho mục tiêu máy chủ lưu trữ. Nếu không chỉ định, hãy sử dụng "macos_sdk_version".
Thẻ: loses_incremental_state
Đã tích luỹ --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> lần sử dụng
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 tệp thực thi. Bạn có thể chuyển tuỳ chọn này nhiều lần. Cú pháp: regex_filter@uỳ chọn 1,tuỳ chọn 2,...,tuỳ chọn n. Trong đó regex_filter là viết tắt của 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). options_1 thành options_n là viết tắt của các tuỳ chọn dòng lệnh tuỳ ý. Nếu một tuỳ chọn có chứa dấu phẩy, thì nó phải được đặt cùng với dấu gạch chéo ngược. Các tuỳ chọn có thể chứa @. Chỉ dùng @ đầu tiên để 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 mọi tệp cc trong //foo/ ngoại trừ bar.cc.
Thẻ: action_command_lines, affects_outputs
Đã tích luỹ --host_swiftcopt=<a string> lần sử dụng
Các tuỳ chọn bổ sung để chuyển đến swiaccounts để dùng cho các công cụ thực thi.
Thẻ: action_command_lines, affects_outputs
Mặc định của --[no]incompatible_auto_exec_groups: "false"
Khi được bật, hệ thống sẽ tự động tạo một nhóm thực thi cho mỗi chuỗi công cụ mà quy tắc sử dụng. Để làm được điều này, quy tắc cần chỉ định tham số "toolchain" (chuỗi công cụ) trên các thao tác của quy tắc. Để biết thêm thông tin, hãy tham khảo tại https://github.com/bazelbuild/bazel/issues/17134.
Thẻ: affects_outputs, incompatible_change
Mặc định của --[no]incompatible_merge_genfiles_directory: "đúng"
Nếu đúng, thư mục genfiles sẽ được gấp vào thư mục bin.
Thẻ: affects_outputs, incompatible_change
Mặc định của --[no]incompatible_use_host_features: "đúng"
Nếu đúng, hãy sử dụng --features chỉ cho cấu hình mục tiêu và --host_features cho cấu hình exec.
Thẻ: changes_inputs, affects_outputs, incompatible_change
Mặc định của --[no]instrument_test_targets: "false"
Khi bật mức độ sử dụng, hãy chỉ định xem có cần xem xét các quy tắc kiểm thử đo lường hay không. Khi được đặt, các quy tắc kiểm thử có trong --Instrumentation_filter 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 khả năng đo lường mức độ sử dụng.
Thẻ: affects_outputs
Mặc định của --instrumentation_filter=<a comma-separated list of regex expressions with prefix '-' specifying excluded paths>: "-/javatests[/:],-/test/java[/:]"
Khi bạn bật mức độ phù hợp, chỉ những quy tắc có tên có trong bộ lọc dựa trên biểu thức chính quy được chỉ định mới được đo lường. Thay vào đó, các quy tắc có tiền tố '-' 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ật --Instrument_test_targets.
Thẻ: affects_outputs
Mặc định của --ios_minimum_os=<a dotted version (for example '2.3' or '3.3alpha2.4')>: 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
Đã tích luỹ --ios_multi_cpus=<comma-separated list of options> lần sử dụng
Danh sách kiến trúc được phân tách bằng dấu phẩy để tạo ứng dụng ios. Kết quả là một tệp nhị phân chung chứa tất cả cấu trúc được chỉ định.
Thẻ: loses_incremental_state, loading_and_analysis
Mặc định của --[no]legacy_whole_archive: "đúng"
Không dùng nữa, thay thế bằng --incompatible_remove_legacy_wiling_ lưu (xem https://github.com/bazelbuild/bazel/issues/7362 để biết thông tin chi tiết). Khi bật, hãy sử dụng --w Nhà lưu trữ cho các quy tắc cc_binary có linkshared=True và linkstatic=True hoặc '-static' trong linkopts. Thao tác này chỉ dành cho khả năng tương thích ngược. Một cách khác hay hơn là sử dụng Alwayslink=1 nếu cần.
Thẻ: action_command_lines, affects_outputs, deprecated
Đã tích luỹ --linkopt=<a string> lần sử dụng
Tuỳ chọn bổ sung để chuyển đến gcc khi liên kết.
Thẻ: action_command_lines, affects_outputs
Đã tích luỹ --ltobackendopt=<a string> lần sử dụng
Tuỳ chọn bổ sung để chuyển đến bước phụ trợ LTO (trong phần --features=thin_lto).
Thẻ: action_command_lines, affects_outputs
Đã tích luỹ --ltoindexopt=<a string> lần sử dụng
Tuỳ chọn bổ sung để chuyển đến bước lập chỉ mục LTO (trong phần --features=thin_lto).
Thẻ: action_command_lines, affects_outputs
Đã tích luỹ --macos_cpus=<comma-separated list of options> lần sử dụng
Danh sách 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
Mặc định của --macos_minimum_os=<a dotted version (for example '2.3' or '3.3alpha2.4')>: xem nội dung mô tả
Phiên bản macOS tương thích tối thiểu cho mục tiêu. Nếu không chỉ định, hãy sử dụng "macos_sdk_version".
Thẻ: loses_incremental_state
Mặc định của --memprof_profile=<a build target label>: xem nội dung mô tả
Sử dụng hồ sơ memprof.
Thẻ: affects_outputs
Mặc định của --[no]objc_debug_with_GLIBCXX: "false"
Nếu bạn đặt chế độ này và chế độ biên dịch được đặt thành "dbg", hãy xác định GLIBCXX_DEBUG, GLIBCXX_DEBUG_PEDANTIC và GLIBCPP_Segment_ nỗ lực.
Thẻ: action_command_lines
Mặc định của --[no]objc_enable_binary_stripping: "false"
Liệu có nên thực hiện việc loại bỏ biểu tượng và mã cụ thể trên các tệp nhị phân được liên kết hay không. Quá trình xoá 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
Đã tích luỹ --objccopt=<a string> lần sử dụng
Các tuỳ chọn bổ sung để chuyển đến gcc khi biên dịch tệp nguồn Objective-C/C++.
Thẻ: action_command_lines
Đã tích luỹ --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> lần sử dụng
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ể chuyển tuỳ chọn này nhiều lần. Cú pháp: regex_filter@uỳ chọn 1,tuỳ chọn 2,...,tuỳ chọn n. Trong đó regex_filter là viết tắt của 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). options_1 thành options_n là viết tắt của các tuỳ chọn dòng lệnh tuỳ ý. Nếu một tuỳ chọn có chứa dấu phẩy, thì nó phải được đặt cùng với dấu gạch chéo ngược. Các tuỳ chọn có thể chứa @. Chỉ dùng @ đầu tiên để 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 mọi tệp cc trong //foo/ ngoại trừ bar.cc.
Thẻ: action_command_lines, affects_outputs
Đã tích luỹ --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> lần sử dụng
Các tuỳ chọn bổ sung để truyền có chọn lọc đến phần phụ trợ LTO (trong phần --features=thin_lto) khi biên dịch một số đối tượng phụ trợ nhất định. Bạn có thể chuyển tuỳ chọn này nhiều lần. Cú pháp: regex_filter@uỳ chọn 1,tuỳ chọn 2,...,tuỳ chọn n. Trong đó regex_filter là viết tắt của danh sách các mẫu biểu thức chính quy bao gồm và loại trừ. options_1 thành options_n là viết tắt của các tùy chọn dòng lệnh tùy ý. Nếu một tuỳ chọn có chứa dấu phẩy, thì nó phải được đặt cùng với dấu gạch chéo ngược. Các tuỳ chọn có thể chứa @. Chỉ dùng @ đầu tiên để phân tách chuỗi. Ví dụ: --per_file_ltobackendopt=//foo/.*\.o,-//foo/bar\.o@-O0 thêm tuỳ chọn dòng lệnh -O0 vào dòng lệnh phụ trợ LTO của mọi tệp trong //foo/ ngoại trừ bar.o.
Thẻ: action_command_lines, affects_outputs
Mặc định của --platform_suffix=<a string>: xem nội dung mô tả
Chỉ định một hậu tố để thêm vào thư mục cấu hình.
Thẻ: loses_incremental_state, affects_outputs, loading_and_analysis
Mặc định của --propeller_optimize=<a build target label>: xem nội dung mô tả
Sử dụng thông tin hồ sơ cánh quạt để tối ưu hoá mục tiêu bản dựng.Mỗi hồ sơ cánh quạt 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 một nhãn bản dựng phải tham chiếu đến các tệp nhập 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",) Bạn có thể phải thêm lệnh export_files vào gói tương ứng để hiển thị các tệp này cho Bazel. Bạn phải sử dụng tuỳ chọn này dưới dạng: --propeller_optimize=//a/b:propeller_profile
Thẻ: action_command_lines, affects_outputs
Mặc định của --propeller_optimize_absolute_cc_profile=<a string>: 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á cho cánh quạt.
Thẻ: affects_outputs
Mặc định của --propeller_optimize_absolute_ld_profile=<a string>: 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á cho cánh quạt.
Thẻ: affects_outputs
Mặc định của --run_under=<a prefix in front of command>: xem nội dung mô tả
Tiền tố để chèn vào trước tệp thực thi cho lệnh "test" và "run". 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ụ là: 'valgrind', 'strace', 'strace -c', 'valgrind --quiet --num-callers=20', '//package:target', '//package:target --options'.
Thẻ: action_command_lines
Mặc định của --[no]share_native_deps: "đúng"
Nếu đúng, các thư viện gốc chứa chức năng giống nhau sẽ được chia sẻ giữa các mục tiêu khác nhau
Thẻ: loading_and_analysis, affects_outputs
Mặc định của --[no]stamp: "false"
Đánh dấu tệp nhị phân kèm theo ngày, tên người dùng, tên máy chủ, thông tin không gian làm việc, v.v.
Thẻ: affects_outputs
Mặc định của --strip=<always, sometimes or never>: "thỉnh thoảng"
Chỉ định xem có loại bỏ các tệp nhị phân và thư viện dùng chung hay không (bằng cách sử dụng "-Wl,--strip-debug"). Giá trị mặc định của "đôi khi" có nghĩa là loại bỏ iff --compilation_mode=fastbuild.
Thẻ: affects_outputs
Đã tích luỹ --stripopt=<a string> lần sử dụng
Các tuỳ chọn bổ sung cần truyền để xoá khi tạo tệp nhị phân "<name>.stripped".
Thẻ: action_command_lines, affects_outputs
Đã tích luỹ --swiftcopt=<a string> lần sử dụng
Các tuỳ chọn bổ sung để chuyển đến quá trình biên dịch Swift.
Thẻ: action_command_lines
Tiền tố được thêm vào trước bất kỳ đường liên kết tượng trưng tiện lợi nào được tạo sau khi tạo bản dựng. Nếu bị bỏ qua, giá trị mặc định sẽ là tên của công cụ tạo bản dựng, theo sau là dấu gạch nối. Nếu "/" được truyền, thì sẽ không có đường liên kết tượng trưng nào được tạo và không phát ra cảnh báo. Cảnh báo: chức năng đặc biệt cho '/' sắp không được dùng nữa; thay vào đó, hãy sử dụng --experimental_convenience_symlinks=ignore.
Thẻ: affects_outputs
Đã tích luỹ --tvos_cpus=<comma-separated list of options> lần sử dụng
Danh sách kiến trúc được phân tách bằng dấu phẩy cần tạo tệp nhị phân tvOS của Apple.
Thẻ: loses_incremental_state, loading_and_analysis
Mặc định của --tvos_minimum_os=<a dotted version (for example '2.3' or '3.3alpha2.4')>: xem nội dung mô tả
Phiên bản tvOS 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 "tvos_sdk_version".
Thẻ: loses_incremental_state
Đã tích luỹ --visionos_cpus=<comma-separated list of options> lần sử dụng
Danh sách được phân tách bằng dấu phẩy gồm các kiến trúc để tạo tệp nhị phân ApplevisionOS.
Thẻ: loses_incremental_state, loading_and_analysis
Đã tích luỹ --watchos_cpus=<comma-separated list of options> lần sử dụng
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
Mặc định của --watchos_minimum_os=<a dotted version (for example '2.3' or '3.3alpha2.4')>: xem nội dung mô tả
Phiên bản watchOS 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 "watchos_sdk_version".
Thẻ: loses_incremental_state
Mặc định của --xbinary_fdo=<a build target label>: 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ơ 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, thì các tuỳ chọn đó sẽ luôn được ưu tiên như thể xbinary_fdo không được chỉ định.
Thẻ: affects_outputs
Các tuỳ chọn ảnh hưởng đến mức độ nghiêm ngặt của Bazel thực thi các đầu vào hợp lệ của bản dựng (định nghĩa quy tắc, tổ hợp cờ, v.v.):
Mặc định của --auto_cpu_environment_group=<a build target label>: ""
Khai báo Environmental_group để tự động ánh xạ các giá trị cpu đến giá trị target_environment.
Thẻ: changes_inputs, loading_and_analysis, experimental
Mặc định của --[no]check_licenses: "false"
Kiểm tra để đảm bảo rằng những quy tắc ràng buộc về việc cấp 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 xây dựng. Theo mặc định, giấy phép sẽ không được chọn.
Thẻ: build_file_semantics
Mặc định của --[no]check_visibility: "đúng"
Nếu bạn tắt chính sách này, các lỗi về chế độ hiển thị trong các phần phụ thuộc mục tiêu sẽ bị giảm hạng xuống cảnh báo.
Thẻ: build_file_semantics
Mặc định của --[no]desugar_for_android: "đúng"
Liệu có nên đơ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
Mặc định của --[no]desugar_java8_libs: "false"
Liệu có nên đưa thư viện Java 8 được hỗ trợ vào ứng dụng dành cho thiết bị cũ hay không.
Thẻ: affects_outputs, loading_and_analysis, loses_incremental_state, experimental
Mặc định của --[no]enforce_constraints: "đúng"
Kiểm tra các môi trường tương thích với từng mục tiêu và báo cáo lỗi nếu có mục tiêu có các phần phụ thuộc không hỗ trợ cùng một môi trường
Thẻ: build_file_semantics
Mặc định của --[no]experimental_check_desugar_deps: "đúng"
Xem có nên kiểm tra kỹ quá trình đơn giản hoá chính xác ở cấp độ tệp nhị phân của Android hay không.
Thẻ: eagerness_to_exit, loading_and_analysis, experimental
Mặc định của --experimental_import_deps_checking=<off, warning or error>: "TẮT"
Khi được bật, hãy kiểm tra xem các phần phụ thuộc của một aar_import đã hoàn tất hay chưa. Thao tác thực thi này có thể phá vỡ bản dựng hoặc có thể chỉ dẫn đến cảnh báo.
Thẻ: loading_and_analysis
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 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
Mặc định của --[no]incompatible_check_testonly_for_output_files: "false"
Nếu được bật, hãy chỉ kiểm tra các mục tiêu tiên quyết là tệp đầu ra bằng cách chỉ tra cứu kiểm thử của quy tắc tạo. Điều này phù hợp với việc kiểm tra chế độ hiển thị.
Thẻ: build_file_semantics, incompatible_change
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 sẽ áp dụng cho các hoạt động triển khai chuỗi công cụ.
Thẻ: build_file_semantics, incompatible_change
Mặc định của --[no]incompatible_disable_native_android_rules: "false"
Nếu bạn bật chính sách này, thì chế độ sử dụng trực tiếp các quy tắc gốc của Android sẽ bị tắt. Vui lòng sử dụng quy tắc Android Starlark từ https://github.com/bazelbuild/rules_android
Các thẻ: eagerness_to_exit, incompatible_change
Mặc định của --[no]incompatible_disable_native_apple_binary_rule: "false"
Không hoạt động. Hãy giữ lại ở đây để có khả năng tương thích ngược.
Thẻ: eagerness_to_exit, incompatible_change
Mặc định của --[no]incompatible_python_disable_py2: "đúng"
Nếu đúng, việc sử dụng chế độ cài đặt Python 2 sẽ gây ra lỗi. Điều này bao gồm python_version=PY2, srcs_version=PY2 và srcs_version=PY2ONLY. Hãy tham khảo tại https://github.com/bazelbuild/bazel/issues/15684 để biết thêm thông tin.
Thẻ: loading_and_analysis, incompatible_change
Mặc định của --[no]incompatible_validate_top_level_header_inclusions: "đúng"
Nếu đúng, Bazel cũng sẽ xác thực việc đưa vào tiêu đề thư mục cấp cao nhất (xem https://github.com/bazelbuild/bazel/issues/10047 để biết thêm thông tin).
Thẻ: loading_and_analysis, incompatible_change
Mặc định của --python_native_rules_allowlist=<a build target label>: 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
Mặc định của --[no]strict_filesets: "false"
Nếu bạn bật tuỳ chọn này, thì các tập hợp tệp vượt qua ranh giới gói sẽ được báo cáo là lỗi.
Thẻ: build_file_semantics, eagerness_to_exit
Mặc định của --strict_proto_deps=<off, warn, error, strict or default>: "lỗi"
Trừ phi TẮT, hãy kiểm tra để đảm bảo 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 trực tiếp dưới dạng phần phụ thuộc.
Thẻ: build_file_semantics, eagerness_to_exit, incompatible_change
Mặc định của --strict_public_imports=<off, warn, error, strict or default>: "tắt"
Trừ phi TẮT, hãy kiểm tra để đảm bảo mục tiêu proto_library khai báo rõ ràng tất cả các mục tiêu được dùng trong phần "nhập công khai" là đã xuất.
Thẻ: build_file_semantics, eagerness_to_exit, incompatible_change
Mặc định của --[no]strict_system_includes: "false"
Nếu đúng, các tiêu đề tìm thấy qua hệ thống bao gồm các đường dẫn (-isystem) cũng phải khai báo.
Thẻ: loading_and_analysis, eagerness_to_exit
Đã tích luỹ --target_environment=<a build target label> lần sử dụng
Khai báo môi trường mục tiêu của bản dựng này. Phải là giá trị tham chiếu nhãn đến quy tắc "môi trường". Nếu được chỉ định, tất cả cá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 bản dựng:
Mặc định của --apk_signing_method=<v1, v2, v1_v2 or v4>: "v1_v2"
Cách triển khai để dùng để ký tệp APK
Các thẻ: action_command_lines, affects_outputs, loading_and_analysis
Mặc định của --[no]device_debug_entitlements: "đúng"
Nếu bạn đặt chính sách này và chế độ biên dịch không phải là "chọn", thì các ứng dụng objc sẽ bao gồm các quyền gỡ lỗi khi ký.
Thẻ: changes_inputs
Mặc định của --ios_signing_cert_name=<a string>: xem nội dung mô tả
Tên chứng chỉ dùng cho hoạt động ký iOS. Nếu bạn không đặt chính sách này, 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 mã ký mã (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 có thể truy cập vào tệp BUILD, tệp .bzl hoặc tệp WORKSPACE.:
Mặc định của --[no]incompatible_config_setting_private_default_visibility: "false"
Nếu không tương thích_enforce_config_setting_visible=false, thì đây là lỗi không phù hợp. Ngoài ra, nếu cờ này sai, thì mọi config_setting không có thuộc tính chế độ hiển thị rõ ràng sẽ là //visible:public. Nếu cờ này là true, config_setting sẽ tuân theo cùng logic hiển thị 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
Mặc định của --[no]incompatible_disallow_legacy_py_provider: "đúng"
Không hoạt động, sẽ sớm bị xoá.
Thẻ: loading_and_analysis, incompatible_change
Mặc định của --[no]incompatible_disallow_sdk_frameworks_attributes: "false"
Nếu đúng, hãy không cho phép các thuộc tính sdk_frameworks và weak_sdk_frameworks trong objc_library andobjc_import.
Thẻ: build_file_semantics, incompatible_change
Mặc định của --[no]incompatible_enforce_config_setting_visibility: "đúng"
Nếu đúng, hãy thực thi các hạn chế về chế độ hiển thị config_setting. Nếu giá trị là false, mọi config_setting sẽ 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
Nếu đúng, đặt giá trị mặc định là true cho các thuộc tính luôn liên kết trong objc_library và objc_import.
Thẻ: build_file_semantics, incompatible_change
Mặc định của --[no]incompatible_python_disallow_native_rules: "false"
Khi đúng, lỗi sẽ xảy ra khi sử dụng quy tắc py_* tích hợp; thay vào đó, bạn nên sử dụng quy tắc Rule_python. Hãy truy cập 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 chi phối hành vi của môi trường kiểm thử hoặc trình chạy kiểm thử:
Mặc định của --[no]allow_analysis_failures: "false"
Nếu đúng, lỗi phân tích của mục tiêu quy tắc sẽ dẫn đến việc mục tiêu truyền tải một thực thể của AnalysisFailureInfo có chứa nội dung mô tả lỗi, thay vì 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ó lượt 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 liên quan đến quy tắc.
Thẻ: loading_and_analysis
Mặc định của --[no]break_build_on_parallel_dex2oat_failure: "false"
Nếu các thao tác dex2oat thực sự không thành công sẽ khiến bản dựng bị hỏng thay vì thực thi dex2oat trong thời gian chạy kiểm thử.
Thẻ: loading_and_analysis, experimental
Mặc định của --[no]check_tests_up_to_date: "false"
Đừng chạy thử nghiệm, chỉ cần kiểm tra xem các thử nghiệm này đã được cập nhật hay chưa. Nếu tất cả kết quả kiểm thử đều là mới nhất, thì 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ỳ kiểm thử nào, thì hệ thống sẽ báo cáo lỗi và kiểm thử không thành công. Tuỳ chọn này ngụ ý hành vi --check_up_to_date.
Thẻ: execution
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
Đã tích luỹ --flaky_test_attempts=<a positive integer, the string "default", or test_regex@attempts. This flag may be passed more than once> lần sử dụng
Trong trường hợp kiểm thử không thành công, mỗi lượt kiểm thử sẽ được thử lại theo số lần đã chỉ định. Các kiểm thử yêu cầu nhiều lần thử để vượt qua sẽ được đánh dấu là "FLAKY" trong phần tóm tắt thử nghiệm. Thông thường, giá trị được chỉ định chỉ là một số nguyên hoặc chuỗi "default". Nếu là số nguyên thì tất cả thử nghiệm sẽ chạy tối đa N lần. Nếu giá trị "default", thì chỉ một lần kiểm thử sẽ được thực hiện cho các chương trình kiểm thử thông thường và 3 lần cho các chương trình 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 không ổn định=1). Cú pháp thay thế: regex_filter@flaky_test_Trys. Trong đó flaky_test_ings là như trên và regex_filter là viết tắt của danh sách các mẫu bao gồm và loại trừ biểu thức chính quy (Xem thêm --runs_per_test). Ví dụ: --flaky_test_Trys=//foo/.*,-//foo/bar/.*@3 gỡ bỏ tất cả các lượt kiểm thử trong //foo/ ngoại trừ những bài kiểm thử dưới foo/bar ba lần. Bạn có thể chuyển tuỳ chọn này nhiều lần. Đối số được truyền gần đây nhất mà các kết quả trùng khớp sẽ được ưu tiên. Nếu không có gì phù hợp, hành vi sẽ như "mặc định" ở trên.
Thẻ: execution
Mặc định của --[no]ios_memleaks: "false"
Bật tính năng kiểm tra rò rỉ bộ nhớ trong mục tiêu ios_test.
Thẻ: action_command_lines
Mặc định của --ios_simulator_device=<a string>: xem nội dung mô tả
Thiết bị để mô phỏng khi chạy một ứng dụng iOS trong trình mô phỏng, ví dụ như "iPhone 6". Bạn có thể lấy danh sách thiết bị bằng cách chạy "xcrun simctl list devicetypes" trên máy mà trình mô phỏng sẽ chạy.
Thẻ: test_runner
Mặc định của --ios_simulator_version=<a dotted version (for example '2.3' or '3.3alpha2.4')>: 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ử. Hành động này sẽ bị bỏ qua đối với quy tắc ios_test nếu thiết bị mục tiêu được chỉ định trong quy tắc.
Thẻ: test_runner
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 có thể chạy đồng thời. Chọn một số nguyên hoặc từ khoá ("auto", "HOST_CPUS", "HOST_RAM"), theo sau (không bắt buộc) là một toán tử ([-|*]<float>), ví dụ: "auto", "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
Đã tích luỹ --runs_per_test=<a positive integer or test_regex@runs. This flag may be passed more than once> lần sử dụng
Chỉ định số lần chạy mỗi lượt kiểm thử. Nếu có 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ộ quy trình kiểm thử sẽ bị 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ả bài kiểm thử 3 lần. Cú pháp thay thế: regex_filter@runs_per_test. Trong đó run_per_test là viết tắt của một giá trị số nguyên còn regex_filter là viết tắt của 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 lượt kiểm thử trong //foo/ ngoại trừ những chương trình kiểm thử trong foo/bar ba lần. Bạn có thể chuyển tuỳ chọn này nhiều lần. Đối số được truyền gần đây nhất mà các kết quả trùng khớp sẽ được ưu tiên. Nếu không có kết quả nào phù hợp, kiểm thử sẽ chỉ chạy một lần.
Đã tích luỹ --test_env=<a 'name=value' assignment with an optional value part> lần sử dụng
Chỉ định các biến môi trường bổ sung để đưa vào môi trường chạy kiểm thử. Bạn có thể chỉ định biến theo tên, trong trường hợp đó, giá trị của biến sẽ được đọc từ môi trường máy khách Bazel hoặc bằng cặp tên=giá trị. Bạn có thể sử dụng lựa chọn này nhiều lần để chỉ định nhiều biến. Chỉ được sử dụng bằng lệnh "bazel test" (kiểm thử bazel).
Thẻ: test_runner
Mặc định của --[no]test_keep_going: "đúng"
Khi 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 kiểm thử đều được chạy, ngay cả khi một số kiểm thử không đạt.
Thẻ: execution
Mặc định của --test_strategy=<a string>: ""
Chỉ định chiến lược cần sử dụng khi chạy kiểm thử.
Thẻ: execution
Mặc định của --test_timeout=<a single integer or comma-separated list of 4 integers>: "-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 duy nhất, giá trị này 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 ngắn, trung bình, dài và vĩnh viễn (theo thứ tự đó). Dù ở dạng nào, giá trị -1 sẽ yêu cầu blaze sử dụng thời gian chờ mặc định cho danh mục đó.
Mặc định của --test_tmpdir=<a path>: xem nội dung mô tả
Chỉ định thư mục tạm thời cơ sở cho "kiểm thử bazel" cần sử dụng.
Mặc định của --[no]zip_undeclared_test_outputs: "đúng"
Nếu đúng, các kết quả kiểm thử không được khai báo sẽ được lưu trữ trong 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:
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
Mặc định của --[no]experimental_inmemory_dotd_files: "đúng"
Nếu được bật, các tệp C++ .d sẽ được chuyển trực tiếp từ các nút bản dựng từ xa vào bộ nhớ thay vì được ghi vào ổ đĩa.
Thẻ: loading_and_analysis, execution, affects_outputs, experimental
Mặc định của --[no]experimental_inmemory_jdeps_files: "đúng"
Nếu bạn bật tuỳ chọn này, các tệp phần phụ thuộc (.jdeps) được tạo qua quá trình biên dịch Java sẽ được chuyển trực tiếp từ các nút bản dựng từ xa vào bộ nhớ thay vì được ghi vào ổ đĩa.
Thẻ: loading_and_analysis, execution, affects_outputs, experimental
Mặc định của --[no]experimental_objc_include_scanning: "false"
Liệu có nên thực hiện quét để tìm C/C++ mục tiêu hay không.
Thẻ: loading_and_analysis, execution, changes_inputs
Mặc định của --[no]experimental_retain_test_configuration_across_testonly: "false"
Khi được bật, --trim_test_configure sẽ không cắt bỏ cấu hình kiểm thử cho các quy tắc được đánh dấu là testonly=1. Việc này nhằm giảm các vấn đề xung đột hành động khi các quy tắc không kiểm thử phụ thuộc vào quy tắc cc_test. Không có ảnh hưởng gì nếu --trim_test_Configuration sai.
Thẻ: loading_and_analysis, loses_incremental_state
Mặc định của --[no]experimental_starlark_cc_import: "false"
Nếu bật, bạn có thể sử dụng phiên bản cc_import của Starlark.
Thẻ: loading_and_analysis, experimental
Mặc định của --[no]experimental_unsupported_and_brittle_include_scanning: "false"
Liệu có nên thu hẹp đầu vào trong quá trình biên dịch C/C++ hay không bằng cách phân tích cú pháp các dòng #include từ tệp đầu vào. Điều này có thể cải thiện hiệu suất và mức độ gia tăng bằng cách giảm kích thước của các cây đầu vào biên dịch. Tuy nhiên, nó 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 tiền xử lý C. Cụ thể, thuộc tính này không hiểu các lệnh động #include và bỏ qua logic có điều kiện của bộ tiền xử lý. Bạn tự chịu rủi ro khi sử dụng. Mọi vấn đề liên quan đến cờ này đã gửi đều sẽ bị đóng.
Thẻ: loading_and_analysis, execution, changes_inputs
Mặc định của --[no]incremental_dexing: "đúng"
Phần lớn công việc tạo tệp dex là riêng biệt cho từng tệp Jar.
Thẻ: affects_outputs, loading_and_analysis, loses_incremental_state
Mặc định của --local_cpu_resources=<an integer, or "HOST_CPUS", optionally followed by [-|*]<float>.>: "HOST_CPUS"
Thiết lập rõ ràng tổng số lõi CPU cục bộ mà Bazel có thể sử dụng để chi tiêu cho các hành động xây dựng được thực thi cục bộ. Lấy một số nguyên hoặc "HOST_CPUS", tuỳ ý theo sau 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ượng lõi CPU có sẵn.
Thẻ: host_machine_resource_optimizations
Đã tích luỹ --local_extra_resources=<a named float, 'name=value'> lần sử dụng
Đặt số lượng tài nguyên bổ sung có thể sử dụng cho Bazel. Lấy trong một cặp string-float. Có thể được sử dụng nhiều lần để chỉ định nhiều loại tài nguyên bổ sung. Bazel sẽ hạn chế các hành động đồ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. Quy 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>". Không thể đặt CPU, RAM và tài nguyên sẵn có bằng cờ này.
Thẻ: host_machine_resource_optimizations
Giá trị mặc định của --local_ram_resources=<an integer number of MBs, or "HOST_RAM", optionally followed by [-|*]<float>.>: "HOST_RAM*,67"
Thiết lập rõ ràng tổng dung lượng RAM máy chủ cục bộ (tính bằng MB) mà Bazel có thể dùng để chi tiêu cho các hành động tạo bản dựng được thực thi trên máy. Lấy một số nguyên hoặc "HOST_RAM", tuỳ ý theo sau là [-|*]<float> (ví dụ: HOST_RAM*0,5 để sử dụng một nửa dung lượng 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òn trống và sẽ sử dụng 67% dung lượng RAM đó.
Thẻ: host_machine_resource_optimizations
Mặc định của --[no]objc_use_dotd_pruning: "đúng"
Nếu được đặt, tệp .d do clang tạo ra sẽ được dùng để cắt giảm tập hợp dữ liệu đầu vào được chuyển vào các quá trình biên dịch objc.
Thẻ: changes_inputs, loading_and_analysis
Mặc định của --[no]process_headers_in_dependencies: "false"
Khi tạo //a:a mục tiêu, hãy xử lý tiêu đề ở mọi mục tiêu mà //a:a phụ thuộc (nếu chuỗi công cụ có bật tính năng xử lý tiêu đề).
Thẻ: execution
Mặc định của --[no]trim_test_configuration: "đúng"
Khi được bật, các tuỳ chọn liên quan đến kiểm thử sẽ bị xoá dưới cấp cao nhất của bản dựng. Khi cờ này hoạt động, bạn không thể tạo thử nghiệm dưới dạng phần phụ thuộc của quy tắc không kiểm thử. Tuy nhiên, các thay đổi đối với lựa chọn liên quan đến thử nghiệm sẽ không khiến các quy tắc không 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 độ chi tiết, định dạng hoặc vị trí ghi nhật ký:
Mặc định của --[no]experimental_bep_target_summary: "false"
Liệu có nên xuất bản các sự kiện Targetsummary hay không.
Mặc định của --[no]experimental_build_event_expand_filesets: "false"
Nếu đúng, hãy mở rộng các tệp trong BEP khi trình bày các tệp đầu ra.
Thẻ: affects_outputs
Nếu đúng, hãy phân giải hoàn toàn các đường liên kết tượng trưng của Fileset tương đối trong BEP khi trình bày tệp đầu ra. Yêu cầu --experimental_build_event_expand_filesets.
Thẻ: affects_outputs
Mặc định của --experimental_build_event_upload_max_retries=<an integer>: "4"
Số lần tối đa Bazel nên thử tải lại một sự kiện bản dựng lên.
Thẻ: bazel_internal_configuration
Mặc định của --experimental_build_event_upload_retry_minimum_delay=<An immutable length of time.>: "1 giây"
Độ trễ tối thiểu ban đầu cho các lần thử lại luỹ thừa luỹ thừa khi không tải BEP lên được. (số mũ: 1,6)
Thẻ: bazel_internal_configuration
Mặc định của --experimental_build_event_upload_strategy=<a string>: xem nội dung mô tả
Chọn cách tải cấu phần phần mềm được tham chiếu lên trong giao thức sự kiện xây dựng.
Thẻ: affects_outputs
Mặc định của --[no]experimental_materialize_param_files_directly: "false"
Nếu cụ thể hoá các tệp tham số, hãy thực hiện bằng cách ghi trực tiếp vào ổ đĩa.
Thẻ: execution
Mặc định của --[no]experimental_run_bep_event_include_residue: "false"
Liệu có nên đưa dư lượng dòng lệnh vào các sự kiện chạy bản dựng có thể chứa dư lượng đó hay không. Theo mặc định, phần dư không được đưa vào các sự kiện tạo bản dựng lệnh chạy có thể chứa phần dư.
Thẻ: affects_outputs
Mặc định của --[no]experimental_stream_log_file_uploads: "false"
Truy cập trực tiếp tệp nhật ký truyền trực tuyến lên bộ nhớ từ xa thay vì ghi vào ổ đĩa.
Thẻ: affects_outputs
Mặc định của --explain=<a path>: xem nội dung mô tả
Làm cho hệ thống xây dựng giải thích từng bước đượ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
Mặc định của --[no]legacy_important_outputs: "đúng"
Sử dụng trường này để loại bỏ việc tạo trườngimportant_outputs cũ trong sự kiện TargetComplete. Quan trọng_outputs là bắt buộc để tích hợp Bazel với ResultStore.
Thẻ: affects_outputs
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 thực thi hành động từ xa. Hữu ích khi gỡ lỗi các thao tác. Điều này được ngụ ý bằng lệnh --subcommands và --verbose_failures.
Thẻ: execution
Mặc định của --max_config_changes_to_show=<an integer>: "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, sẽ hiện tối đa số tên tuỳ chọn đã thay đổi nhất định. Nếu số đã cho là -1, tất cả các tuỳ chọn đã thay đổi sẽ hiển thị.
Thẻ: terminal_output
Mặc định của --max_test_output_bytes=<an integer>: "-1"
Chỉ định kích thước tối đa cho mỗi nhật ký kiểm thử có thể được phát khi --test_output là ' lỗi' hoặc "all". Được dùng để tránh làm cho đầu ra quá tải với đầu ra kiểm thử quá ồn. Tiêu đề kiểm thử được bao gồm trong kích thước nhật ký. Giá trị âm ngụ ý không có giới hạn. Đầu ra là tất cả hoặc không có gì.
Thẻ: test_runner, terminal_output, execution
Mặc định của --output_filter=<a valid Java regular expression>: xem nội dung mô tả
Chỉ cho thấy các cảnh báo và kết quả của hành động đối với những quy tắc có tên khớp với biểu thức chính quy đã cho.
Thẻ: affects_outputs
Mặc định của --progress_report_interval=<an integer in 0-3600 range>: "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 đó được báo cáo mỗi phút một lần. Khi bật --curses, tiến trình sẽ được báo cáo mỗi giây.
Thẻ: affects_outputs
Mặc định của --show_result=<an integer>: "1"
Hiện kết quả của bản dựng. Đối với mỗi mục tiêu, hãy nêu rõ mục tiêu đó có được cập nhật hay không và nếu có, hãy nêu 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 cho việc sao chép+dán vào shell để thực thi chúng. 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à trên đó thông tin kết quả không được in. Do đó, không có gây ra tình trạng chặn thông báo và MAX_INT khiến việc in kết quả luôn xảy ra. Giá trị mặc định là 1. Nếu không có mục tiêu nào được xây dựng cho một mục tiêu, thì kết quả có thể bị bỏ qua để giữ đầu ra dưới ngưỡng.
Thẻ: affects_outputs
Giá trị mặc định của --[no]subcommands [-s]: "false"
Hiển thị các lệnh con được thực thi trong một 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
Mặc định --test_output=<summary, errors, all or streamed>: "tóm tắt"
Chỉ định chế độ đầu ra mong muốn. Các giá trị hợp lệ là "summary" (tóm tắt) để chỉ xuất bản tóm tắt trạng thái kiểm thử, " errors" để in cả nhật ký kiểm thử cho các chương trình kiểm thử không thành công, "all" để in nhật ký cho tất cả chương trình kiểm thử và "stream" ("phát trực tuyến") đến nhật ký đầu ra cho tất cả chương trình kiểm thử theo thời gian thực (điều này sẽ buộc các bài kiểm thử phải được thực thi cục bộ mỗi lần bất kể giá trị --test_Strategy).
Thẻ: test_runner, terminal_output, execution
Mặc định của --test_summary=<short, terse, detailed, none or testcase>: "ngắn"
Chỉ định định dạng mong muốn của thông tin tóm tắt kiểm thử. Giá trị hợp lệ là "ngắn" để chỉ in thông tin về các lượt kiểm thử được thực thi, "ngắn gọn", để chỉ in thông tin về các lượt kiểm thử đã chạy không thành công, "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, "trường hợp kiểm thử" để in thông tin tóm tắt trong quá trình 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à "không" để bỏ qua phần tóm tắt.
Thẻ: terminal_output
Mặc định của --toolchain_resolution_debug=<a comma-separated list of regex expressions with prefix '-' specifying excluded paths>: "-.*"
In thông tin gỡ lỗi trong quá trình phân giải chuỗi công cụ. Cờ này sẽ lấy một biểu thức chính quy để 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 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 chọn 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ề giải pháp chuỗi công cụ.
Thẻ: terminal_output
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 tính năng giải thích. Không có ảnh hưởng gì nếu không bật giải thích.
Thẻ: affects_outputs
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
Tuỳ chọn chỉ định hoặc thay đổi dữ liệu đầu vào chung thành lệnh Bazel không thuộc các danh mục khác.:
Đã tích luỹ --aspects_parameters=<a 'name=value' assignment> lần sử dụng
Chỉ định giá trị của các tham số khía cạnh dòng lệnh. Mỗi giá trị thông số được chỉ định thông qua <param_name>=<param_value>, ví dụ như 'my_param=my_val' trong đó 'my_param' là một thông số của một số khía cạnh trong danh sách --aspect hoặc được một khía cạnh trong danh sách yêu cầu. Bạn có thể sử dụng tuỳ chọn này nhiều lần. Tuy nhiên, bạn không được phép chỉ định giá trị cho cùng một thông số nhiều lần.
Thẻ: loading_and_analysis
Đã tích luỹ --flag_alias=<a 'name=value' flag alias> lần sử dụng
Đặt tên viết tắt cho cờ Starlark. Hàm này sẽ lấy một cặp khoá-giá trị duy nhất có dạng "<key>=<value>" làm đối số.
Thẻ: changes_inputs
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 nữa. Chính xác, khi một mục tiêu py_binary hoặc py_test đã được đặt giá trị cũ là "auto" (giá trị mặc định), thì mục tiêu đó sẽ được coi là sai khi và chỉ khi bạn đặt cờ này. Xem https://github.com/bazelbuild/bazel/issues/10076.
Thẻ: affects_outputs, incompatible_change
Mặc định của --[no]incompatible_py2_outputs_are_suffixed: "đúng"
Nếu đúng, các mục tiêu được tạo trong cấu hình Python 2 sẽ xuất hiện bên dưới một gốc đầu ra có chứa hậu tố "-py2", trong khi các mục tiêu được tạo cho Python 3 sẽ xuất hiện trong một 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".
Các thẻ: affects_outputs, incompatible_change
Mặc định của --[no]incompatible_py3_is_default: "đúng"
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".
Các thẻ: loading_and_analysis, affects_outputs, incompatible_change
Mặc định của --[no]incompatible_use_python_toolchains: "đúng"
Nếu bạn đặt chính sách này thành true, các quy tắc Python gốc có thể thực thi sẽ sử dụng thời gian chạy Python do chuỗi công cụ Python chỉ định, thay vì thời gian chạy do các cờ cũ như --python_top cung cấp.
Thẻ: loading_and_analysis, incompatible_change
Mặc định của --python_version=<PY2 or PY3>: xem nội dung mô tả
Chế độ phiên bản lớn của Python, "PY2" hoặc "PY3". Xin lưu ý rằng giá trị này sẽ bị các mục tiêu "py_binary" và "py_test" ghi đè (ngay cả khi chúng không chỉ định rõ phiên bản) vì vậy, thường không có nhiều lý do để cung cấp cờ này.
Thẻ: loading_and_analysis, affects_outputs
Mặc định của --target_pattern_file=<a string>: ""
Nếu bạn đặt chính sách này, bản dựng sẽ đọc các mẫu của tệp có tên ở đây, thay vì trên dòng lệnh. Sẽ xảy ra lỗi khi chỉ định tệp tại đây cũng như mẫu dòng lệnh.
Thẻ: changes_inputs
Tuỳ chọn thực thi và lưu vào bộ nhớ đệm từ xa:
Mặc định của --experimental_remote_cache_eviction_retries=<an integer>: "0"
Số lần thử lại tối đa nếu bản dựng gặp lỗi khi loại bỏ bộ nhớ đệm từ xa. Giá trị khác 0 sẽ ngầm đặt --incompatible_remote_use_new_exit_code_for_lost_inputs thành true. Mã lệnh gọi mới sẽ được tạo cho mỗi lần thử. Nếu tạo mã gọi và cung cấp mã đó cho Bazel kèm theo --invocation_id, thì 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 rồi kiểm tra mã thoát 39.
Thẻ: execution
Mặc định của --[no]incompatible_remote_use_new_exit_code_for_lost_inputs: "đúng"
Nếu bạn đặt chính sách này thành true, Bazel sẽ sử dụng mã thoát mới 39 thay vì 34 nếu bộ nhớ đệm từ xa xoá các blob trong quá trình xây dựng.
Thẻ: incompatible_change
Các lựa chọn khác, không được phân loại theo cách khác.:
Mặc định của --[no]allow_analysis_cache_discard: "đúng"
Nếu loại bỏ bộ nhớ đệm phân tích do có sự thay đổi trong hệ thống xây dựng, việc đặt tuỳ chọn này thành false sẽ khiến bazel thoát thay vì tiếp tục quá trình tạo 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
Mặc định của --[no]build_manual_tests: "false"
Buộc tạo các mục tiêu thử nghiệm được gắn thẻ "thủ công". Không bao gồm các thử nghiệm "thủ công". Tuỳ chọn này buộc bạn phải tạo mẫu quảng cáo (nhưng không được thực thi).
Mặc định của --build_tag_filters=<comma-separated list of options>: ""
Chỉ định một danh sách thẻ được phân tách bằng dấu phẩy. Mỗi thẻ có thể được bắt đầu bằng dấu ":" để chỉ định các thẻ bị loại trừ. Chỉ những mục tiêu đó sẽ được tạo có chứa ít nhất một thẻ được bao gồm và không chứa bất kỳ thẻ bị loại trừ nà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" (kiểm thử); các kiểm thử đó chịu sự điều chỉnh của các tuỳ chọn lọc kiểm thử, chẳng hạn như "--test_tag_filter"
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 đượ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 thứ đượ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 "auto", Bazel sẽ chạy lại kiểm thử khi 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ử không thành công trước đó. Nếu bạn đặt chính sách này thành "có", Bazel sẽ lưu mọi kết quả kiểm tra vào bộ nhớ đệm, ngoại trừ các thử nghiệm được đánh dấu là bên ngoài. Nếu bạn đặt chính sách này thành "no", Bazel sẽ không lưu kết quả thử nghiệm vào bộ nhớ đệm.
Mặc định của --[no]compile_one_dependency: "false"
Biên dịch một phần phụ thuộc duy nhất của các tệp đối số. Điều này rất hữu ích cho các tệp nguồn kiểm tra cú pháp trong IDE, chẳng hạn như bằng cách tạo lại một mục tiêu duy nhất phụ thuộc vào tệp nguồn để phát hiện lỗi càng sớm càng tốt 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ả các đối số không phải cờ; thay vì là mục tiêu để tạo, chúng lại là tên tệp nguồn. Một mục tiêu tuỳ ý phụ thuộc vào tên tệp nguồn sẽ được tạo.
Đã tích luỹ --deleted_packages=<comma-separated list of package names> lần sử dụng
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 những gói này xuất hiện ở vị trí nào đó trên đường dẫn gói. Sử dụng tuỳ chọn này khi xoá gói con "x/y" của 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ể báo cáo 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. Chỉ định --delete_packages x/y sẽ tránh được sự cố này.
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 cho các bản dựng gia tăng thêm chậm hơn.
Mặc định của --execution_log_binary_file=<a path>: xem nội dung mô tả
Ghi nhật ký các sinh sản được thực thi vào tệp này dưới dạng các protos spawn được phân tách, theo src/main/protobuf/spawn.proto. Cờ liên quan: --execution_log_json_file (định dạng văn bản JSON; loại trừ lẫn nhau), --execution_log_sort (cho dù 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).
Mặc định của --execution_log_json_file=<a path>: xem nội dung mô tả
Ghi lại các sinh nhật đã thực thi vào tệp này dưới dạng tệp đại diện JSON của các protos Spawn được phân tách, theo src/main/protobuf/spawn.proto. Cờ liên quan: --execution_log_binary_file (định dạng protobuf nhị phân; loại trừ lẫn nhau), --execution_log_sort (cho dù là để sắp xếp nhật ký thực thi), --subcommands (để hiển thị các lệnh con trong đầu ra của thiết bị đầu cuối).
Mặc định của --[no]execution_log_sort: "đúng"
Liệu có nên sắp xếp nhật ký thực thi hay không, giúp bạn dễ dàng so sánh nhật ký giữa các lệnh gọi. Đặt thành false để tránh mức sử dụng CPU và bộ nhớ có thể đáng kể ở cuối lệnh gọi, với chi phí tạo nhật ký trong lệnh thực thi không xác định.
Mặc định của --[no]expand_test_suites: "đúng"
Mở rộng các mục tiêu test_suite thành các kiểm thử cấu thành của chúng 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 phủ định sẽ áp dụng cho các kiểm thử thuộc bộ kiểm thử, nếu không thì các mẫu mục tiêu phủ định 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 đó, chúng có thể phân tích các mục tiêu test_suite.
Thẻ: loading_and_analysis
Mặc định của --[no]experimental_cancel_concurrent_tests: "false"
Nếu đúng, thì Blaze sẽ huỷ đồng thời chạy kiểm thử trong lần chạy thành công đầu tiên. Tính năng này chỉ hữu ích khi kết hợp với --runs_per_test_detects_flakes.
Thẻ: affects_outputs, loading_and_analysis
Mặc định của --experimental_extra_action_filter=<a comma-separated list of regex expressions with prefix '-' specifying excluded paths>: ""
Ngừng sử dụng và thay vào đó là một số khía cạnh. Bộ lọc tập hợp các mục tiêu để lên lịch hành động bổ sung.
Mặc định của --[no]experimental_extra_action_top_level_only: "false"
Ngừng sử dụng và thay vào đó là một số khía cạnh. Chỉ lên lịch các hành động phụ cho các mục tiêu cấp cao nhất.
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 về mức độ sử dụng cho mỗi kiểm thử trong một lần chạy mức độ sử dụng.
Thẻ: affects_outputs, loading_and_analysis
Mặc định của --[no]experimental_generate_llvm_lcov: "false"
Nếu đúng, mức độ phù hợp của tiếng lóng sẽ tạo báo cáo LCOV.
Thẻ: affects_outputs, loading_and_analysis
Mặc định của --[no]experimental_j2objc_header_map: "đúng"
Liệu có tạo bản đồ tiêu đề J2ObjC song song với quá trình dịch nội dung J2ObjC hay không.
Mặc định của --[no]experimental_j2objc_shorter_header_path: "false"
Liệu có nên 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
Giá trị mặc định của --experimental_java_classpath=<off, javabuilder or bazel>: "javabuilder"
Bật đường dẫn lớp rút gọn cho quá trình biên dịch Java.
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 cho các thư viện tương thích với Android.
Thẻ: affects_outputs
Mặc định của --[no]experimental_run_android_lint_on_java_rules: "false"
Liệu có cần xác thực các nguồn java_* hay không.
Thẻ: affects_outputs
Mặc định của --[no]explicit_java_test_deps: "false"
Chỉ định rõ ràng phần phụ thuộc vào JUnit hoặc Hamcrest trong java_test thay vì vô tình lấy từ các phần phụ thuộc của TestRunner. Hiện chỉ dùng được cho bazel.
Mặc định của --host_java_launcher=<a build target label>: xem nội dung mô tả
Trình chạy Java mà các công cụ được thực thi trong một bản dựng sử dụng.
Đã tích luỹ --host_javacopt=<a string> lần sử dụng
Các tuỳ chọn bổ sung để chuyển sang javac khi tạo các công cụ được thực thi trong một bản dựng.
Đã tích luỹ --host_jvmopt=<a string> lần sử dụng
Các tuỳ chọn bổ sung được truyền đến máy ảo Java khi tạo các công cụ được thực thi trong quá trình tạo bản dựng. Những tuỳ chọn này sẽ được thêm vào các tuỳ chọn khởi động máy ảo của từng mục tiêu java_binary.
Mặc định của --[no]incompatible_check_sharding_support: "đúng"
Nếu đúng, Bazel sẽ không vượt qua kiểm thử phân đoạn nếu trình chạy kiểm thử không cho biết có 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ợ tính năng phân đoạn sẽ dẫn đến tất cả chương trình kiểm thử chạy trong từng phân đoạn.
Thẻ: incompatible_change
Mặc định của --[no]incompatible_exclusive_test_sandboxed: "đúng"
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 thử nghiệm độc quyền trên máy
Thẻ: incompatible_change
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_BOOKS_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 làm như vậy có thể ngăn việc lưu vào bộ nhớ đệm giữa nhiều người dùng nếu sử dụng bộ nhớ đệm dùng chung.
Thẻ: loading_and_analysis, incompatible_change
Đã tích luỹ --j2objc_translation_flags=<comma-separated list of options> lần sử dụng
Các tuỳ chọn bổ sung để truyền đến công cụ J2ObjC.
--java_debug
Làm cho máy ảo Java của kiểm thử java phải đợi 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
Mặc định của --[no]java_deps: "đúng"
Tạo thông tin phần phụ thuộc (hiện tại là classpath thời gian biên dịch) cho mỗi mục tiêu Java.
Mặc định của --[no]java_header_compilation: "đúng"
Biên dịch ijar trực tiếp từ nguồn.
Mặc định của --java_language_version=<a string>: ""
Phiên bản ngôn ngữ Java
Mặc định của --java_launcher=<a build target label>: 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 cờ này được đặt thành chuỗi trống, thì trình chạy JDK sẽ được sử dụng. Thuộc tính "trình chạy" sẽ ghi đè cờ này.
Mặc định của --java_runtime_version=<a string>: "local_jdk"
Phiên bản thời gian chạy Java
Đã tích luỹ --javacopt=<a string> lần sử dụng
Các tuỳ chọn bổ sung để chuyển sang javac.
Đã tích luỹ --jvmopt=<a string> lần sử dụng
Các tuỳ chọn bổ sung để truyền đến máy ảo Java. Những tuỳ chọn này sẽ được thêm vào các tuỳ chọn khởi động máy ảo của từng mục tiêu java_binary.
Mặc định của --legacy_main_dex_list_generator=<a build target label>: xem nội dung mô tả
Chỉ định một tệp nhị phân cần dùng để tạo danh sách các lớp phải có trong dex chính khi biên dịch multidex cũ.
Mặc định của --local_termination_grace_seconds=<an integer>: "15"
Thời gian chờ giữa thời điểm 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 đó.
Mặc định của --optimizing_dexer=<a build target label>: xem nội dung mô tả
Chỉ định một tệp nhị phân cần dùng để tạo tệp dex mà không cần phân đoạn.
Giá trị mặc định của --package_path=<colon-separated list of options>: "%workspace%"
Danh sách được phân tách bằng dấu hai chấm nơi bạn sẽ tìm thấy 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 xung quanh. Nếu bị bỏ qua hoặc để trống, giá trị mặc định sẽ là dữ liệu đầu ra của "bazel info default-package-path".
Đã tích luỹ --plugin=<a build target label> lần sử dụng
Trình bổ trợ sử dụng trong bản dựng. Hiện hoạt động với java_plugin.
Mặc định của --proguard_top=<a build target label>: xem nội dung mô tả
Chỉ định phiên bản ProGuard cần dùng để xoá mã khi tạo một tệp nhị phân Java.
Giá trị mặc định của --proto_compiler=<a build target label>: "@bazel_tools//tools/proto:protoc"
Nhãn của trình biên dịch proto.
Thẻ: affects_outputs, loading_and_analysis
Giá trị mặc định của --proto_toolchain_for_cc=<a build target label>: "@bazel_tools//tools/proto:cc_toolchain"
Nhãn của proto_lang_toolchain() mô tả cách biên dịch giao thức C++
Thẻ: affects_outputs, loading_and_analysis
Giá trị mặc định của --proto_toolchain_for_j2objc=<a build target label>: "@bazel_tools//tools/j2objc:j2objc_proto_toolchain"
Nhãn của proto_lang_toolchain() mô tả cách biên dịch j2objc protos
Các thẻ: affects_outputs, loading_and_analysis
Giá trị mặc định của --proto_toolchain_for_java=<a build target label>: "@bazel_tools//tools/proto:java_toolchain"
Nhãn của proto_lang_toolchain() mô tả cách biên dịch giao thức Java
Các thẻ: affects_outputs, loading_and_analysis
Giá trị mặc định của --proto_toolchain_for_javalite=<a build target label>: "@bazel_tools//tools/proto:javalite_toolchain"
Nhãn của proto_lang_toolchain() mô tả cách biên dịch giao thức JavaLite
Các thẻ: affects_outputs, loading_and_analysis
Đã tích luỹ --protocopt=<a string> lần sử dụng
Các tuỳ chọn bổ sung để truyền đến trình biên dịch protobuf.
Thẻ: affects_outputs
Mặc định của --[no]runs_per_test_detects_flakes: "false"
Nếu đúng, hệ thống sẽ xác định trạng thái FLAKY cho bất kỳ phân đoạn nào có ít nhất một lần chạy/lần vượt qua và có ít nhất một lần chạy/lần thử không thành công.
Mặc định của --shell_executable=<a path>: xem nội dung mô tả
Đường dẫn tuyệt đối đến shell có thể thực thi để Bazel sử dụng. Nếu bạn không đặt chính sách này nhưng biến môi trường BAZEL_SH được đặt trong lệnh gọi Bazel đầu tiên (khởi động máy chủ Bazel), thì Bazel sẽ sử dụng biến môi trường đó. Nếu bạn không đặt biểu tượng nào, 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 chạy trên đó (Windows: c:/tools/msys64/usr/bin/bash.exe, FreeBSD: /usr/local/bin/bash, tất cả các đường dẫn khác: /bin/bash). 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 cho các tệp nhị phân được tạo.
Thẻ: loading_and_analysis
Mặc định của --[no]show_loading_progress: "đúng"
Nếu bạn bật tuỳ chọn này, Bazel sẽ in thông báo "Đang tải gói:".
Đã tích luỹ --test_arg=<a string> lần sử dụng
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ể dùng nhiều lần để chỉ định nhiều đối số. Nếu nhiều kiểm thử được thực thi, mỗi kiểm thử sẽ nhận được các đối số giống nhau. Chỉ được sử dụng bằng lệnh "bazel test" (kiểm thử bazel).
Mặc định của --test_filter=<a string>: 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 các bài kiểm thử chạy. Xin lưu ý rằng điều này không ảnh hưởng đến các mục tiêu được tạo.
Mặc định của --test_lang_filters=<comma-separated list of options>: ""
Chỉ định danh sách ngôn ngữ kiểm thử được phân tách bằng dấu phẩy. Mỗi ngôn ngữ có thể bắt đầu bằng dấu ":" để chỉ định các ngôn ngữ bị loại trừ. Chúng tôi sẽ chỉ tìm thấy những mục tiêu thử nghiệm được viết bằng ngôn ngữ được chỉ định. Tên được sử 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 giá trị '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ử.
Mặc định của --test_result_expiration=<an integer>: "-1"
Tuỳ chọn này không được dùng nữa và không có hiệu lực.
Mặc định của --[no]test_runner_fail_fast: "false"
Tuỳ chọn Chuyển tiếp không thành công nhanh đến trình chạy kiểm thử. Trình chạy kiểm thử phải ngừng thực thi khi không thành công đầu tiên.
Giá trị mặc định của --test_sharding_strategy=<explicit, disabled or forced=k where k is the number of shards to enforce>: "phản cảm"
Chỉ định chiến lược cho phân đoạn kiểm thử: "explicit" để chỉ sử dụng phân đoạn nếu có thuộc tính BUILD "shard_count". "disabled" (tắt) để không bao giờ sử dụng tính năng phân đoạn kiểm thử. "forced=k" thực thi phân đoạn "k" cho mục đích kiểm thử bất kể thuộc tính BUILD "shard_count".
Mặc định của --test_size_filters=<comma-separated list of values: small, medium, large or enormous>: ""
Chỉ định danh sách kích thước kiểm thử được phân tách bằng dấu phẩy. Mỗi kích thước có thể được bắt đầu bằng dấu ":" để chỉ định các kích thước bị loại trừ. Bạn sẽ chỉ tìm thấy những mục tiêu thử nghiệm đó có chứa ít nhất một kích thước đã được đưa vào và không chứa bất kỳ kích thước bị loại trừ nào. Tuỳ chọn này ảnh hưởng đến hành vi --build_tests_only và lệnh kiểm thử.
Mặc định của --test_tag_filters=<comma-separated list of options>: ""
Chỉ định danh sách thẻ kiểm thử được phân tách bằng dấu phẩy. Mỗi thẻ có thể được bắt đầu bằng dấu ":" để chỉ định các thẻ bị loại trừ. Bạn sẽ chỉ tìm thấy những mục tiêu thử nghiệm đó có chứa ít nhất một thẻ được bao gồm và không chứa bất kỳ thẻ bị loại trừ nào. Tuỳ chọn này ảnh hưởng đến hành vi --build_tests_only và lệnh kiểm thử.
Mặc định của --test_timeout_filters=<comma-separated list of values: short, moderate, long or eternal>: ""
Chỉ định danh sách các thời gian chờ kiểm thử được phân tách bằng dấu phẩy. Mỗi thời gian chờ có thể đứng sau dấu ":" để chỉ định thời gian chờ bị loại trừ. Hệ thống sẽ chỉ tìm thấy các mục tiêu thử nghiệm đó có 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ừ. Tuỳ chọn này ảnh hưởng đến hành vi --build_tests_only và lệnh kiểm thử.
Mặc định của --tool_java_language_version=<a string>: ""
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 xây dựng
Mặc định của --tool_java_runtime_version=<a string>: "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 xây dựng
Mặc định của --[no]use_ijars: "đúng"
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 gia tăng nhanh hơn, nhưng thông báo lỗi có thể khác.

Tuỳ chọn chuẩn hoá cờ

Kế thừa tất cả các tuỳ chọn của bản dựng.

Các tuỳ chọn xuất hiện trước lệnh và được ứng dụng phân tích cú pháp:
Đã tích luỹ --distdir=<a path> lần sử dụng
Các nơi khác để tìm kiếm các tệp lưu trữ trước khi truy cập mạng để tải các tệp lưu trữ đó xuống.
Thẻ: bazel_internal_configuration
Nếu bạn đặt chính sách này, bộ nhớ đệm của kho lưu trữ sẽ liên kết cứng tệp đó trong trường hợp tệp bị tấn công vào bộ nhớ đệm, thay vì sao chép. Mục đích của tính năng này là tiết kiệm dung lượng ổ đĩa.
Thẻ: bazel_internal_configuration
Mặc định của --experimental_repository_downloader_retries=<an integer>: "0"
Số lần thử lại một lỗi tải xuống tối đa. Nếu bạn đặt chính sách này thành 0, thì tính năng thử lại sẽ tắt.
Thẻ: experimental
Mặc định của --experimental_scale_timeouts=<a double>: "1.0"
Điều chỉnh tỷ lệ tất cả thời gian chờ trong quy tắc lưu trữ Starlark theo hệ số này. Bằng cách này, kho lưu trữ bên ngoài có thể được tạo ra hoạt động trên các máy chậm hơn tác giả quy tắc dự kiến mà không cần thay đổi mã nguồn
Thẻ: bazel_internal_configuration, experimental
Mặc định của --http_connector_attempts=<an integer>: "8"
Số lần thử tải xuống http tối đa.
Thẻ: bazel_internal_configuration
Mặc định của --http_connector_retry_max_timeout=<An immutable length of time.>: "0 giây"
Thời gian chờ tối đa cho các lần thử tải xuống lại http. Với giá trị 0, không có thời gian chờ tối đa nào được xác định.
Thẻ: bazel_internal_configuration
Mặc định của --http_timeout_scaling=<a double>: "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ố cụ thể
Thẻ: bazel_internal_configuration
Mặc định của --repository_cache=<a path>: 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. Một chuỗi trống làm đối số yêu cầu tắt bộ nhớ đệm, nếu không, hệ thống sẽ sử dụng giá trị mặc định của '<output_user_root>/cache/repos/v1'
Thẻ: bazel_internal_configuration
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ị vô hiệu hoá hoàn toàn; ctx.exe vẫn có thể chạy một tệp thực thi tuỳ ý truy cập vào Internet.
Thẻ: bazel_internal_configuration
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 --gc_thrashing_threshold=<an integer in 0-100 range>: "100"
Tỷ lệ phần trăm không gian đã sử dụng đã sử dụng (0 – 100) trên đó 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 giá trị này thành 100, thì GcThrashingDetector sẽ tắt.
Thẻ: host_machine_resource_optimizations
Các tuỳ chọn kiểm soát kết quả của lệnh:
Mặc định của --[no]canonicalize_policy: "false"
Xuất ra chính sách chính tắc sau khi mở rộng và lọc. Để giữ đầu ra không bị lỗi, các đối số lệnh được chuẩn hoá sẽ KHÔNG hiển thị khi bạn đặt tuỳ chọn này thành true. 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, lệnh mặc định sẽ là 'build'.
Thẻ: affects_outputs, terminal_output
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 tệp BUILD, tệp .bzl hoặc WORKSPACE.:
Mặc định của --[no]incompatible_config_setting_private_default_visibility: "false"
Nếu không tương thích_enforce_config_setting_visible=false, thì đây là lỗi không phù hợp. Ngoài ra, nếu cờ này sai, thì mọi config_setting không có thuộc tính chế độ hiển thị rõ ràng sẽ là //visible:public. Nếu cờ này là true, config_setting sẽ tuân theo cùng logic hiển thị 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
Mặc định của --[no]incompatible_enforce_config_setting_visibility: "đúng"
Nếu đúng, hãy thực thi các hạn chế về chế độ hiển thị config_setting. Nếu giá trị là false, mọi config_setting sẽ 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 Bzlmod:
Đã tích luỹ --allow_yanked_versions=<a string> lần sử dụng
Đã chỉ định các phiên bản mô-đun dưới dạng `<module1>@<version1>,<module2>@<version2>`. Những phiên bản này sẽ được 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 trong sổ đăng ký nơi chúng xuất phát (nếu các phiên bản đó không đến từ một NonRegistryOverride). Nếu không, các phiên bản bị giật sẽ khiến quá trình phân giải không thành công. Bạn cũng có thể xác định phiên bản được kéo mạnh được phép bằng biến môi trường "BZLMOD_ALLOW_YANKED_VERSIONS". Bạn có thể vô hiệu hoá việc kiểm tra này bằng cách sử dụng từ khoá 'all' (không được khuyến nghị).
Thẻ: loading_and_analysis
Mặc định của --check_bazel_compatibility=<error, warning or off>: "lỗi"
Kiểm tra khả năng tương thích với 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 đề lên trạng thái lỗi giải quyết, "tắt" để tắt chế độ kiểm tra, hoặc "cảnh báo" để in cảnh báo khi phát hiện thấy thông tin không khớp.
Thẻ: loading_and_analysis
Mặc định của --check_direct_dependencies=<off, warning or error>: "cảnh báo"
Kiểm tra xem các phần phụ thuộc trực tiếp "bazel_dep" được khai báo trong mô-đun gốc có giống với phiên bản bạn nhận được trong biểu đồ phần phụ thuộc đã được giải quyết hay không. Các giá trị hợp lệ là "off" ("tắt") để tắt chế độ kiểm tra, "cảnh báo" để in cảnh báo khi phát hiện thấy thông tin không khớp hoặc "error" để chuyển vấn đề lên thành lỗi giải quyết.
Thẻ: loading_and_analysis
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_secondary` trong MODULE.bazel của mô-đun gốc. Lưu ý rằng các phần phụ thuộc của 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
Mặc định của --lockfile_mode=<off, update or error>: "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 nếu có thay đổi, "error" khi dùng tệp khoá nhưng báo lỗi nếu tệp không được cập nhật, hoặc "tắt" để không đọc hoặc ghi vào tệp khoá.
Thẻ: loading_and_analysis
Đã tích luỹ --override_module=<an equals-separated mapping of module name to path> lần sử dụng
Ghi đè một mô-đun có đường dẫn cục bộ ở dạng <module name>=<path>. Nếu đường dẫn đã cho là một đường dẫn tuyệt đối, thì đường dẫn đó sẽ được sử dụng như nguyên trạng. Nếu đường dẫn đã cho là một đường dẫn tương đối, thì đường dẫn đó sẽ tương ứng với thư mục đang hoạt động hiện tại. Nếu đường dẫn đã cho bắt đầu bằng "%workspace%", thì đường dẫn đó 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 "không gian làm việc thông tin bazel")
Đã tích luỹ --registry=<a string> lần sử dụng
Chỉ định sổ đăng ký cần dùng để xác định vị trí các phần phụ thuộc của mô-đun Bazel. Thứ tự rất quan trọng: các mô-đun sẽ được tra cứu trước trong sổ đăng ký trước, và chỉ quay lại các sổ đăng ký sau khi còn thiếu trong các sổ đăng ký trước đó.
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:
Mặc định của --gc_thrashing_limits=<comma separated pairs of <period>:<count>>: "1s:2,20s:3,1m:5"
Các giới hạn mà nếu đạt đến mức này sẽ khiến GcThrashingDetector gây sự cố cho Bazel bằng OOM. Mỗi giới hạn được chỉ định dưới dạng <period>:<count>, trong đó khoảng thời gian là một khoảng thời gian và số lượng là một số nguyên dương. Nếu có hơn --gc_thrashing_threshold phần trăm không gian cần sử dụng (vùng nhớ khối xếp thế hệ cũ) vẫn chiếm sau <count> các GC đầy đủ liên tiếp trong khoảng <period>, thì OOM sẽ được kích hoạt. Bạn có thể chỉ định nhiều hạn mức và phân tách bằng dấu phẩy.
Thẻ: host_machine_resource_optimizations
Mặc định của --skyframe_high_water_mark_full_gc_drops_per_invocation=<an integer, >= 0>: "2147483647"
Gắn cờ cho cấu hình nâng cao của công cụ Skyframe nội bộ của Bazel. Nếu Bazel phát hiện thấy 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 đặt ra bằng --skyframe_high_water_mark_threshold, thì khi một sự kiện GC xảy ra đầy đủ, trạng thái Skyframe tạm thời không cần thiết sẽ bị bỏ qua, tối đa nhiều lần cho mỗi lệnh gọi. Mặc định là Integer.MAX_VALUE; không giới hạn hiệu quả. 0 có nghĩa là các sự kiện thu gom rác (GC) toàn bộ sẽ không bao giờ kích hoạt hiện tượng giảm. Nếu đạt đến giới hạn, trạng thái Skyframe sẽ không còn bị bỏ qua khi một sự kiện GC đầy đủ xảy ra và vượt quá ngưỡng tỷ lệ phần trăm vùng nhớ khối xếp được giữ lại đó.
Thẻ: host_machine_resource_optimizations
Mặc định của --skyframe_high_water_mark_minor_gc_drops_per_invocation=<an integer, >= 0>: "2147483647"
Gắn cờ cho cấu hình nâng cao của công cụ Skyframe nội bộ của Bazel. Nếu Bazel phát hiện thấy mức sử dụng tỷ lệ phần trăm vùng nhớ khối xếp được giữ lại vượt quá ngưỡng đặt ra bằng --skyframe_high_water_mark_threshold, thì khi một sự kiện GC nhỏ xảy ra, trạng thái Skyframe tạm thời không cần thiết sẽ bị bỏ qua, tối đa là nhiều lần cho mỗi lệnh gọi. Mặc định là Integer.MAX_VALUE; không giới hạn hiệu quả. 0 có nghĩa là các sự kiện GC nhỏ sẽ không bao giờ kích hoạt hiện tượng giảm. Nếu đạt đến giới hạn, trạng thái Skyframe sẽ không còn bị bỏ qua khi xảy ra một sự kiện GC nhỏ và ngưỡng tỷ lệ phần trăm vùng nhớ khối xếp được giữ lại đó đã vượt quá.
Thẻ: host_machine_resource_optimizations
Mặc định của --skyframe_high_water_mark_threshold=<an integer>: "85"
Gắn cờ cho cấu hình nâng cao của công cụ Skyframe nội bộ của Bazel. Nếu Bazel 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 ở ngưỡng này, thì Bazel sẽ bỏ trạng thái Skyframe tạm thời không cần thiết. Việc chỉnh sửa tính năng này có thể cho phép bạn giảm thiểu tác động của tình trạng này đến thời gian sử dụng GC, khi tình trạng giật GC là do việc sử dụng bộ nhớ ở trạng thái tạm thời này gây ra và (ii) tốn kém hơn so với việc khôi phục trạng thái khi cần.
Thẻ: host_machine_resource_optimizations
Các tuỳ chọn ảnh hưởng đến độ chi tiết, định dạng hoặc vị trí ghi nhật ký:
Mặc định của --[no]experimental_command_profile: "false"
Ghi lại hồ sơ CPU của Trình ghi chuyến bay Java vào tệp profile.jfr trong thư mục cơ sở đầu ra. Trong tương lai, cú pháp và ngữ nghĩa của cờ này có thể thay đổi để hỗ trợ nhiều loại hồ sơ hoặc định dạng đầu ra; bạn tự chịu rủi ro khi sử dụng.
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 thao tác ghi nhớ 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ả chức năng ghi nhớ.
Các tuỳ chọn chỉ định hoặc thay đổi dữ liệu đầu vào chung thành lệnh Bazel mà không thuộc các danh mục khác.:
Mặc định của --experimental_resolved_file_instead_of_workspace=<a string>: ""
Nếu nội dung không trống, hãy đọc tệp đã được phân giải được chỉ định thay vì tệp WORKSPACE
Thẻ: changes_inputs
Giá trị mặc định của --for_command=<a string>: "bản dựng"
Lệnh mà các tuỳ chọn nên được chuẩn hoá.
Thẻ: affects_outputs, terminal_output
Mặc định của --invocation_policy=<a string>: ""
Áp dụng chính sách gọi cho các tuỳ chọn cần chuẩn hoá.
Thẻ: affects_outputs, terminal_output
Tuỳ chọn thực thi và lưu vào bộ nhớ đệm từ xa:
Mặc định của --experimental_downloader_config=<a string>: 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ủ (cho `allow` và `block`) hoặc hai mẫu, một mẫu để so khớp và một mẫu dùng làm URL thay thế, có tham chiếu ngược bắt đầu từ "$1". Có thể có nhiều lệnh "rewrite" cho cùng một URL và trong trường hợp này sẽ có nhiều URL được trả về.
Mặc định của --experimental_worker_for_repo_fetching=<off, platform or virtual>: "tắt"
Chế độ phân luồng dùng để tìm nạp kho lưu trữ. Nếu bạn đặt chính sách này thành "tắt", thì sẽ không có luồng worker nào được sử dụng và quá trình tìm nạp kho lưu trữ có thể khởi động lại. Ngược lại, hãy sử dụng luồng nền tảng (tức là luồng hệ điều hành) nếu được đặt thành "platform" hoặc luồng ảo nếu được đặt thành "virtual".
Các lựa chọn khác, không được phân loại.:
Đã tích luỹ --deleted_packages=<comma-separated list of package names> lần sử dụng
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 những gói này xuất hiện ở vị trí nào đó trên đường dẫn gói. Sử dụng tuỳ chọn này khi xoá gói con "x/y" của 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ể báo cáo 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. Chỉ định --delete_packages x/y sẽ tránh được sự cố này.
Đã tích luỹ --override_repository=<an equals-separated mapping of repository name to path> lần sử dụng
Ghi đè một 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à một đường dẫn tuyệt đối, thì đường dẫn đó sẽ được sử dụng nguyên vẹn. Nếu đường dẫn đã cho là một đườ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 đó 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 "không gian làm việc thông tin bazel")
Giá trị mặc định của --package_path=<colon-separated list of options>: "%workspace%"
Danh sách được phân tách bằng dấu hai chấm nơi bạn sẽ tìm thấy 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 xung quanh. Nếu bị bỏ qua hoặc để trống, giá trị mặc định sẽ là dữ liệu đầu ra của "bazel info default-package-path".
Mặc định của --[no]show_loading_progress: "đúng"
Nếu bạn bật tuỳ chọn này, Bazel sẽ in thông báo "Đang tải gói:".

Lựa chọn dọn dẹp

Kế thừa tất cả các tuỳ chọn của bản dựng.

Các tuỳ chọn xuất hiện trước lệnh và được ứng dụng phân tích cú pháp:
Đã tích luỹ --distdir=<a path> lần sử dụng
Các nơi khác để tìm kiếm các tệp lưu trữ trước khi truy cập mạng để tải các tệp lưu trữ đó xuống.
Thẻ: bazel_internal_configuration
Nếu bạn đặt chính sách này, bộ nhớ đệm của kho lưu trữ sẽ liên kết cứng tệp đó trong trường hợp tệp bị tấn công vào bộ nhớ đệm, thay vì sao chép. Mục đích của tính năng này là tiết kiệm dung lượng ổ đĩa.
Thẻ: bazel_internal_configuration
Mặc định của --experimental_repository_downloader_retries=<an integer>: "0"
Số lần thử lại một lỗi tải xuống tối đa. Nếu bạn đặt chính sách này thành 0, thì tính năng thử lại sẽ tắt.
Thẻ: experimental
Mặc định của --experimental_scale_timeouts=<a double>: "1.0"
Điều chỉnh tỷ lệ tất cả thời gian chờ trong quy tắc lưu trữ Starlark theo hệ số này. Bằng cách này, kho lưu trữ bên ngoài có thể được tạo ra hoạt động trên các máy chậm hơn tác giả quy tắc dự kiến mà không cần thay đổi mã nguồn
Thẻ: bazel_internal_configuration, experimental
Mặc định của --http_connector_attempts=<an integer>: "8"
Số lần thử tải xuống http tối đa.
Thẻ: bazel_internal_configuration
Mặc định của --http_connector_retry_max_timeout=<An immutable length of time.>: "0 giây"
Thời gian chờ tối đa cho các lần thử tải xuống lại http. Với giá trị 0, không có thời gian chờ tối đa nào được xác định.
Thẻ: bazel_internal_configuration
Mặc định của --http_timeout_scaling=<a double>: "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ố cụ thể
Thẻ: bazel_internal_configuration
Mặc định của --repository_cache=<a path>: 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. Một chuỗi trống làm đối số yêu cầu tắt bộ nhớ đệm, nếu không, hệ thống sẽ sử dụng giá trị mặc định của '<output_user_root>/cache/repos/v1'
Thẻ: bazel_internal_configuration
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ị vô hiệu hoá hoàn toàn; ctx.exe vẫn có thể chạy một tệp thực thi tuỳ ý truy cập vào Internet.
Thẻ: bazel_internal_configuration
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 --gc_thrashing_threshold=<an integer in 0-100 range>: "100"
Tỷ lệ phần trăm không gian đã sử dụng đã sử dụng (0 – 100) trên đó 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 giá trị này thành 100, thì GcThrashingDetector sẽ tắt.
Thẻ: host_machine_resource_optimizations
Các tuỳ chọn kiểm soát kết quả của lệnh:
Mặc định của --[no]async: "false"
Nếu đúng, thao tác làm sạch đầu ra là không đồng bộ. Khi lệnh này hoàn tất, bạn có thể thực thi các lệnh mới trong cùng một ứng dụng sẽ an toàn, mặc dù quá trình xoá có thể tiếp tục trong nền.
Thẻ: host_machine_resource_optimizations
Mặc định của --[no]expunge: "false"
Nếu giá trị là true, dọn dẹp sẽ xoá toàn bộ cây hoạt động của thực thể bazel này, bao gồm tất cả các tệp đầu ra bản dựng và tệp tạm thời do bazel tạo, đồng thời dừng máy chủ bazel nếu nó đang chạy.
Thẻ: host_machine_resource_optimizations
--expunge_async
Nếu được chỉ định, tính năng dọn dẹp 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 bản dựng và tệp tạm thời do bazel tạo, đồng thời dừng máy chủ bazel nếu nó đang chạy. Khi lệnh này hoàn tất, bạn có thể thực thi các lệnh mới trong cùng một ứng dụng sẽ an toàn, 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
Các tuỳ chọn liên quan đến đầu ra và ngữ nghĩa của Bzlmod:
Đã tích luỹ --allow_yanked_versions=<a string> lần sử dụng
Đã chỉ định các phiên bản mô-đun dưới dạng `<module1>@<version1>,<module2>@<version2>`. Những phiên bản này sẽ được 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 trong sổ đăng ký nơi chúng xuất phát (nếu các phiên bản đó không đến từ một NonRegistryOverride). Nếu không, các phiên bản bị giật sẽ khiến quá trình phân giải không thành công. Bạn cũng có thể xác định phiên bản được kéo mạnh được phép bằng biến môi trường "BZLMOD_ALLOW_YANKED_VERSIONS". Bạn có thể vô hiệu hoá việc kiểm tra này bằng cách sử dụng từ khoá 'all' (không được khuyến nghị).
Thẻ: loading_and_analysis
Mặc định của --check_bazel_compatibility=<error, warning or off>: "lỗi"
Kiểm tra khả năng tương thích với 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 đề lên trạng thái lỗi giải quyết, "tắt" để tắt chế độ kiểm tra, hoặc "cảnh báo" để in cảnh báo khi phát hiện thấy thông tin không khớp.
Thẻ: loading_and_analysis
Mặc định của --check_direct_dependencies=<off, warning or error>: "cảnh báo"
Kiểm tra xem các phần phụ thuộc trực tiếp "bazel_dep" được khai báo trong mô-đun gốc có giống với phiên bản bạn nhận được trong biểu đồ phần phụ thuộc đã được giải quyết hay không. Các giá trị hợp lệ là "off" ("tắt") để tắt chế độ kiểm tra, "cảnh báo" để in cảnh báo khi phát hiện thấy thông tin không khớp hoặc "error" để chuyển vấn đề lên thành lỗi giải quyết.
Thẻ: loading_and_analysis
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_secondary` trong MODULE.bazel của mô-đun gốc. Lưu ý rằng các phần phụ thuộc của 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
Mặc định của --lockfile_mode=<off, update or error>: "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 nếu có thay đổi, "error" khi dùng tệp khoá nhưng báo lỗi nếu tệp không được cập nhật, hoặc "tắt" để không đọc hoặc ghi vào tệp khoá.
Thẻ: loading_and_analysis
Đã tích luỹ --override_module=<an equals-separated mapping of module name to path> lần sử dụng
Ghi đè một mô-đun có đường dẫn cục bộ ở dạng <module name>=<path>. Nếu đường dẫn đã cho là một đường dẫn tuyệt đối, thì đường dẫn đó sẽ được sử dụng như nguyên trạng. Nếu đường dẫn đã cho là một đường dẫn tương đối, thì đường dẫn đó sẽ tương ứng với thư mục đang hoạt động hiện tại. Nếu đường dẫn đã cho bắt đầu bằng "%workspace%", thì đường dẫn đó 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 "không gian làm việc thông tin bazel")
Đã tích luỹ --registry=<a string> lần sử dụng
Chỉ định sổ đăng ký cần dùng để xác định vị trí các phần phụ thuộc của mô-đun Bazel. Thứ tự rất quan trọng: các mô-đun sẽ được tra cứu trước trong sổ đăng ký trước, và chỉ quay lại các sổ đăng ký sau khi còn thiếu trong các sổ đăng ký trước đó.
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:
Mặc định của --gc_thrashing_limits=<comma separated pairs of <period>:<count>>: "1s:2,20s:3,1m:5"
Các giới hạn mà nếu đạt đến mức này sẽ khiến GcThrashingDetector gây sự cố cho Bazel bằng OOM. Mỗi giới hạn được chỉ định dưới dạng <period>:<count>, trong đó khoảng thời gian là một khoảng thời gian và số lượng là một số nguyên dương. Nếu có hơn --gc_thrashing_threshold phần trăm không gian cần sử dụng (vùng nhớ khối xếp thế hệ cũ) vẫn chiếm sau <count> các GC đầy đủ liên tiếp trong khoảng <period>, thì OOM sẽ được kích hoạt. Bạn có thể chỉ định nhiều hạn mức và phân tách bằng dấu phẩy.
Thẻ: host_machine_resource_optimizations
Mặc định của --skyframe_high_water_mark_full_gc_drops_per_invocation=<an integer, >= 0>: "2147483647"
Gắn cờ cho cấu hình nâng cao của công cụ Skyframe nội bộ của Bazel. Nếu Bazel phát hiện thấy 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 đặt ra bằng --skyframe_high_water_mark_threshold, thì khi một sự kiện GC xảy ra đầy đủ, trạng thái Skyframe tạm thời không cần thiết sẽ bị bỏ qua, tối đa nhiều lần cho mỗi lệnh gọi. Mặc định là Integer.MAX_VALUE; không giới hạn hiệu quả. 0 có nghĩa là các sự kiện thu gom rác (GC) toàn bộ sẽ không bao giờ kích hoạt hiện tượng giảm. Nếu đạt đến giới hạn, trạng thái Skyframe sẽ không còn bị bỏ qua khi một sự kiện GC đầy đủ xảy ra và vượt quá ngưỡng tỷ lệ phần trăm vùng nhớ khối xếp được giữ lại đó.
Thẻ: host_machine_resource_optimizations
Mặc định của --skyframe_high_water_mark_minor_gc_drops_per_invocation=<an integer, >= 0>: "2147483647"
Gắn cờ cho cấu hình nâng cao của công cụ Skyframe nội bộ của Bazel. Nếu Bazel phát hiện thấy mức sử dụng tỷ lệ phần trăm vùng nhớ khối xếp được giữ lại vượt quá ngưỡng đặt ra bằng --skyframe_high_water_mark_threshold, thì khi một sự kiện GC nhỏ xảy ra, trạng thái Skyframe tạm thời không cần thiết sẽ bị bỏ qua, tối đa là nhiều lần cho mỗi lệnh gọi. Mặc định là Integer.MAX_VALUE; không giới hạn hiệu quả. 0 có nghĩa là các sự kiện GC nhỏ sẽ không bao giờ kích hoạt hiện tượng giảm. Nếu đạt đến giới hạn, trạng thái Skyframe sẽ không còn bị bỏ qua khi xảy ra một sự kiện GC nhỏ và ngưỡng tỷ lệ phần trăm vùng nhớ khối xếp được giữ lại đó đã vượt quá.
Thẻ: host_machine_resource_optimizations
Mặc định của --skyframe_high_water_mark_threshold=<an integer>: "85"
Gắn cờ cho cấu hình nâng cao của công cụ Skyframe nội bộ của Bazel. Nếu Bazel 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 ở ngưỡng này, thì Bazel sẽ bỏ trạng thái Skyframe tạm thời không cần thiết. Việc chỉnh sửa tính năng này có thể cho phép bạn giảm thiểu tác động của tình trạng này đến thời gian sử dụng GC, khi tình trạng giật GC là do việc sử dụng bộ nhớ ở trạng thái tạm thời này gây ra và (ii) tốn kém hơn so với việc khôi phục trạng thái khi cần.
Thẻ: host_machine_resource_optimizations
Các tuỳ chọn ảnh hưởng đến độ chi tiết, định dạng hoặc vị trí ghi nhật ký:
Mặc định của --[no]experimental_command_profile: "false"
Ghi lại hồ sơ CPU của Trình ghi chuyến bay Java vào tệp profile.jfr trong thư mục cơ sở đầu ra. Trong tương lai, cú pháp và ngữ nghĩa của cờ này có thể thay đổi để hỗ trợ nhiều loại hồ sơ hoặc định dạng đầu ra; bạn tự chịu rủi ro khi sử dụng.
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 thao tác ghi nhớ 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ả chức năng ghi nhớ.
Các tuỳ chọn chỉ định hoặc thay đổi dữ liệu đầu vào chung thành lệnh Bazel mà không thuộc các danh mục khác.:
Mặc định của --experimental_resolved_file_instead_of_workspace=<a string>: ""
Nếu nội dung không trống, hãy đọc tệp đã được phân giải được chỉ định thay vì tệp WORKSPACE
Các thẻ: changes_inputs
Các tuỳ chọn thực thi và lưu vào bộ nhớ đệm từ xa:
Mặc định của --experimental_downloader_config=<a string>: 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ủ (cho `allow` và `block`) hoặc hai mẫu, một mẫu để so khớp và một mẫu dùng làm URL thay thế, có tham chiếu ngược bắt đầu từ "$1". Có thể có nhiều lệnh "rewrite" cho cùng một URL và trong trường hợp này sẽ có nhiều URL được trả về.
Mặc định của --experimental_worker_for_repo_fetching=<off, platform or virtual>: "tắt"
Chế độ phân luồng dùng để tìm nạp kho lưu trữ. Nếu bạn đặt chính sách này thành "tắt", thì sẽ không có luồng worker nào được sử dụng và quá trình tìm nạp kho lưu trữ có thể khởi động lại. Ngược lại, hãy sử dụng luồng nền tảng (tức là luồng hệ điều hành) nếu được đặt thành "platform" hoặc luồng ảo nếu được đặt thành "virtual".
Các lựa chọn khác, không được phân loại.:
Đã tích luỹ --override_repository=<an equals-separated mapping of repository name to path> lần sử dụng
Ghi đè một 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à một đường dẫn tuyệt đối, thì đường dẫn đó sẽ được sử dụng nguyên vẹn. Nếu đường dẫn đã cho là một đườ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 này 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 "không gian làm việc thông tin bazel")

Tuỳ chọn cấu hình

Các lựa chọn về phạm vi lập chỉ mục

Kế thừa tất cả tuỳ chọn từ quy trình kiểm thử.

Các tuỳ chọn xuất hiện trước lệnh và được ứng dụng phân tích cú pháp:
Đã tích luỹ --distdir=<a path> lần sử dụng
Các nơi khác để tìm kiếm các tệp lưu trữ trước khi truy cập mạng để tải các tệp lưu trữ đó xuống.
Thẻ: bazel_internal_configuration
Nếu bạn đặt chính sách này, bộ nhớ đệm của kho lưu trữ sẽ liên kết cứng tệp đó trong trường hợp tệp bị tấn công vào bộ nhớ đệm, thay vì sao chép. Mục đích của tính năng này là tiết kiệm dung lượng ổ đĩa.
Thẻ: bazel_internal_configuration
Mặc định của --experimental_repository_downloader_retries=<an integer>: "0"
Số lần thử lại một lỗi tải xuống tối đa. Nếu bạn đặt chính sách này thành 0, thì tính năng thử lại sẽ tắt.
Thẻ: experimental
Mặc định của --experimental_scale_timeouts=<a double>: "1.0"
Điều chỉnh tỷ lệ tất cả thời gian chờ trong quy tắc lưu trữ Starlark theo hệ số này. Bằng cách này, kho lưu trữ bên ngoài có thể được tạo ra hoạt động trên các máy chậm hơn tác giả quy tắc dự kiến mà không cần thay đổi mã nguồn
Thẻ: bazel_internal_configuration, experimental
Mặc định của --http_connector_attempts=<an integer>: "8"
Số lần thử tải xuống http tối đa.
Thẻ: bazel_internal_configuration
Mặc định của --http_connector_retry_max_timeout=<An immutable length of time.>: "0 giây"
Thời gian chờ tối đa cho các lần thử tải xuống lại http. Với giá trị 0, không có thời gian chờ tối đa nào được xác định.
Thẻ: bazel_internal_configuration
Mặc định của --http_timeout_scaling=<a double>: "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ố cụ thể
Thẻ: bazel_internal_configuration
Mặc định của --repository_cache=<a path>: 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. Một chuỗi trống làm đối số yêu cầu tắt bộ nhớ đệm, nếu không, hệ thống sẽ sử dụng giá trị mặc định của '<output_user_root>/cache/repos/v1'
Thẻ: bazel_internal_configuration
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ị vô hiệu hoá hoàn toàn; ctx.exe vẫn có thể chạy một tệp thực thi tuỳ ý truy cập vào Internet.
Thẻ: bazel_internal_configuration
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 --gc_thrashing_threshold=<an integer in 0-100 range>: "100"
Tỷ lệ phần trăm không gian đã sử dụng đã sử dụng (0 – 100) trên đó 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 giá trị này thành 100, thì GcThrashingDetector sẽ tắt.
Thẻ: host_machine_resource_optimizations
Các tuỳ chọn liên quan đến đầu ra và ngữ nghĩa Bzlmod:
Đã tích luỹ --allow_yanked_versions=<a string> lần sử dụng
Đã chỉ định các phiên bản mô-đun dưới dạng `<module1>@<version1>,<module2>@<version2>`. Những phiên bản này sẽ được 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 trong sổ đăng ký nơi chúng xuất phát (nếu các phiên bản đó không đến từ một NonRegistryOverride). Nếu không, các phiên bản bị giật sẽ khiến quá trình phân giải không thành công. Bạn cũng có thể xác định phiên bản được kéo mạnh được phép bằng biến môi trường "BZLMOD_ALLOW_YANKED_VERSIONS". Bạn có thể vô hiệu hoá việc kiểm tra này bằng cách sử dụng từ khoá 'all' (không được khuyến nghị).
Thẻ: loading_and_analysis
Mặc định của --check_bazel_compatibility=<error, warning or off>: "lỗi"
Kiểm tra khả năng tương thích với 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 đề lên trạng thái lỗi giải quyết, "tắt" để tắt chế độ kiểm tra, hoặc "cảnh báo" để in cảnh báo khi phát hiện thấy thông tin không khớp.
Thẻ: loading_and_analysis
Mặc định của --check_direct_dependencies=<off, warning or error>: "cảnh báo"
Kiểm tra xem các phần phụ thuộc trực tiếp "bazel_dep" được khai báo trong mô-đun gốc có giống với phiên bản bạn nhận được trong biểu đồ phần phụ thuộc đã được giải quyết hay không. Các giá trị hợp lệ là "off" ("tắt") để tắt chế độ kiểm tra, "cảnh báo" để in cảnh báo khi phát hiện thấy thông tin không khớp hoặc "error" để chuyển vấn đề lên thành lỗi giải quyết.
Thẻ: loading_and_analysis
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_secondary` trong MODULE.bazel của mô-đun gốc. Lưu ý rằng các phần phụ thuộc của 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
Mặc định của --lockfile_mode=<off, update or error>: "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 nếu có thay đổi, "error" khi dùng tệp khoá nhưng báo lỗi nếu tệp không được cập nhật, hoặc "tắt" để không đọc hoặc ghi vào tệp khoá.
Thẻ: loading_and_analysis
Đã tích luỹ --override_module=<an equals-separated mapping of module name to path> lần sử dụng
Ghi đè một mô-đun có đường dẫn cục bộ ở dạng <module name>=<path>. Nếu đường dẫn đã cho là một đường dẫn tuyệt đối, thì đường dẫn đó sẽ được sử dụng như nguyên trạng. Nếu đường dẫn đã cho là một đường dẫn tương đối, thì đường dẫn đó sẽ tương ứng với thư mục đang hoạt động hiện tại. Nếu đường dẫn đã cho bắt đầu bằng "%workspace%", thì đường dẫn đó 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 "không gian làm việc thông tin bazel")
Đã tích luỹ --registry=<a string> lần sử dụng
Chỉ định sổ đăng ký cần dùng để xác định vị trí các phần phụ thuộc của mô-đun Bazel. Thứ tự rất quan trọng: các mô-đun sẽ được tra cứu trước trong sổ đăng ký trước, và chỉ quay lại các sổ đăng ký sau khi còn thiếu trong các sổ đăng ký trước đó.
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:
Mặc định của --gc_thrashing_limits=<comma separated pairs of <period>:<count>>: "1s:2,20s:3,1m:5"
Các giới hạn mà nếu đạt đến mức này sẽ khiến GcThrashingDetector gây sự cố cho Bazel bằng OOM. Mỗi giới hạn được chỉ định dưới dạng <period>:<count>, trong đó khoảng thời gian là một khoảng thời gian và số lượng là một số nguyên dương. Nếu có hơn --gc_thrashing_threshold phần trăm không gian cần sử dụng (vùng nhớ khối xếp thế hệ cũ) vẫn chiếm sau <count> các GC đầy đủ liên tiếp trong khoảng <period>, thì OOM sẽ được kích hoạt. Bạn có thể chỉ định nhiều hạn mức và phân tách bằng dấu phẩy.
Thẻ: host_machine_resource_optimizations
Mặc định của --skyframe_high_water_mark_full_gc_drops_per_invocation=<an integer, >= 0>: "2147483647"
Gắn cờ cho cấu hình nâng cao của công cụ Skyframe nội bộ của Bazel. Nếu Bazel phát hiện thấy 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 đặt ra bằng --skyframe_high_water_mark_threshold, thì khi một sự kiện GC xảy ra đầy đủ, trạng thái Skyframe tạm thời không cần thiết sẽ bị bỏ qua, tối đa nhiều lần cho mỗi lệnh gọi. Mặc định là Integer.MAX_VALUE; không giới hạn hiệu quả. 0 có nghĩa là các sự kiện thu gom rác (GC) toàn bộ sẽ không bao giờ kích hoạt hiện tượng giảm. Nếu đạt đến giới hạn, trạng thái Skyframe sẽ không còn bị bỏ qua khi một sự kiện GC đầy đủ xảy ra và vượt quá ngưỡng tỷ lệ phần trăm vùng nhớ khối xếp được giữ lại đó.
Thẻ: host_machine_resource_optimizations
Mặc định của --skyframe_high_water_mark_minor_gc_drops_per_invocation=<an integer, >= 0>: "2147483647"
Gắn cờ cho cấu hình nâng cao của công cụ Skyframe nội bộ của Bazel. Nếu Bazel phát hiện thấy mức sử dụng tỷ lệ phần trăm vùng nhớ khối xếp được giữ lại vượt quá ngưỡng đặt ra bằng --skyframe_high_water_mark_threshold, thì khi một sự kiện GC nhỏ xảy ra, trạng thái Skyframe tạm thời không cần thiết sẽ bị bỏ qua, tối đa là nhiều lần cho mỗi lệnh gọi. Mặc định là Integer.MAX_VALUE; không giới hạn hiệu quả. 0 có nghĩa là các sự kiện GC nhỏ sẽ không bao giờ kích hoạt hiện tượng giảm. Nếu đạt đến giới hạn, trạng thái Skyframe sẽ không còn bị bỏ qua khi xảy ra một sự kiện GC nhỏ và ngưỡng tỷ lệ phần trăm vùng nhớ khối xếp được giữ lại đó đã vượt quá.
Thẻ: host_machine_resource_optimizations
Mặc định của --skyframe_high_water_mark_threshold=<an integer>: "85"
Gắn cờ cho cấu hình nâng cao của công cụ Skyframe nội bộ của Bazel. Nếu Bazel 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 ở ngưỡng này, thì Bazel sẽ bỏ trạng thái Skyframe tạm thời không cần thiết. Việc chỉnh sửa tính năng này có thể cho phép bạn giảm thiểu tác động của tình trạng này đến thời gian sử dụng GC, khi tình trạng giật GC là do việc sử dụng bộ nhớ ở trạng thái tạm thời này gây ra và (ii) tốn kém hơn so với việc khôi phục trạng thái khi cần.
Thẻ: host_machine_resource_optimizations
Các tuỳ chọn ảnh hưởng đến độ chi tiết, định dạng hoặc vị trí ghi nhật ký:
Mặc định của --[no]experimental_command_profile: "false"
Ghi lại hồ sơ CPU của Trình ghi chuyến bay Java vào tệp profile.jfr trong thư mục cơ sở đầu ra. Trong tương lai, cú pháp và ngữ nghĩa của cờ này có thể thay đổi để hỗ trợ nhiều loại hồ sơ hoặc định dạng đầu ra; bạn tự chịu rủi ro khi sử dụng.
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 thao tác ghi nhớ 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ả chức năng ghi nhớ.
Các tuỳ chọn chỉ định hoặc thay đổi dữ liệu đầu vào chung thành lệnh Bazel mà không thuộc các danh mục khác.:
Mặc định của --experimental_resolved_file_instead_of_workspace=<a string>: ""
Nếu nội dung không trống, hãy đọc tệp đã được phân giải được chỉ định thay vì tệp WORKSPACE
Các thẻ: changes_inputs
Các tuỳ chọn thực thi và lưu vào bộ nhớ đệm từ xa:
Mặc định của --experimental_downloader_config=<a string>: 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ủ (cho `allow` và `block`) hoặc hai mẫu, một mẫu để so khớp và một mẫu dùng làm URL thay thế, có tham chiếu ngược bắt đầu từ "$1". Có thể có nhiều lệnh "rewrite" cho cùng một URL và trong trường hợp này sẽ có nhiều URL được trả về.
Mặc định của --experimental_worker_for_repo_fetching=<off, platform or virtual>: "tắt"
Chế độ phân luồng dùng để tìm nạp kho lưu trữ. Nếu bạn đặt chính sách này thành "tắt", thì sẽ không có luồng worker nào được sử dụng và quá trình tìm nạp kho lưu trữ có thể khởi động lại. Ngược lại, hãy sử dụng luồng nền tảng (tức là luồng hệ điều hành) nếu được đặt thành "platform" hoặc luồng ảo nếu được đặt thành "virtual".
Các lựa chọn khác, không được phân loại.:
Đã tích luỹ --override_repository=<an equals-separated mapping of repository name to path> lần sử dụng
Ghi đè một 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à một đường dẫn tuyệt đối, thì đường dẫn đó sẽ được sử dụng nguyên vẹn. Nếu đường dẫn đã cho là một đườ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 này 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 "không gian làm việc thông tin bazel")

Các tuỳ chọn BigQuery

Kế thừa tất cả tuỳ chọn từ quy trình kiểm thử.

Các tuỳ chọn xuất hiện trước lệnh và được ứng dụng phân tích cú pháp:
Đã tích luỹ --distdir=<a path> lần sử dụng
Các nơi khác để tìm kiếm các tệp lưu trữ trước khi truy cập mạng để tải các tệp lưu trữ đó xuống.
Thẻ: bazel_internal_configuration
Nếu bạn đặt chính sách này, bộ nhớ đệm của kho lưu trữ sẽ liên kết cứng tệp đó trong trường hợp tệp bị tấn công vào bộ nhớ đệm, thay vì sao chép. Mục đích của tính năng này là tiết kiệm dung lượng ổ đĩa.
Thẻ: bazel_internal_configuration
Mặc định của --experimental_repository_downloader_retries=<an integer>: "0"
Số lần thử lại một lỗi tải xuống tối đa. Nếu bạn đặt chính sách này thành 0, thì tính năng thử lại sẽ tắt.
Thẻ: experimental
Mặc định của --experimental_scale_timeouts=<a double>: "1.0"
Điều chỉnh tỷ lệ tất cả thời gian chờ trong quy tắc lưu trữ Starlark theo hệ số này. Bằng cách này, kho lưu trữ bên ngoài có thể được tạo ra hoạt động trên các máy chậm hơn tác giả quy tắc dự kiến mà không cần thay đổi mã nguồn
Thẻ: bazel_internal_configuration, experimental
Mặc định của --http_connector_attempts=<an integer>: "8"
Số lần thử tải xuống http tối đa.
Thẻ: bazel_internal_configuration
Mặc định của --http_connector_retry_max_timeout=<An immutable length of time.>: "0 giây"
Thời gian chờ tối đa cho các lần thử tải xuống lại http. Với giá trị 0, không có thời gian chờ tối đa nào được xác định.
Thẻ: bazel_internal_configuration
Mặc định của --http_timeout_scaling=<a double>: "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ố cụ thể
Thẻ: bazel_internal_configuration
Mặc định của --repository_cache=<a path>: 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. Một chuỗi trống làm đối số yêu cầu tắt bộ nhớ đệm, nếu không, hệ thống sẽ sử dụng giá trị mặc định của '<output_user_root>/cache/repos/v1'
Thẻ: bazel_internal_configuration
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ị vô hiệu hoá hoàn toàn; ctx.exe vẫn có thể chạy một tệp thực thi tuỳ ý truy cập vào Internet.
Thẻ: bazel_internal_configuration
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 --gc_thrashing_threshold=<an integer in 0-100 range>: "100"
Tỷ lệ phần trăm không gian đã sử dụng đã sử dụng (0 – 100) trên đó 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 giá trị này thành 100, thì GcThrashingDetector sẽ tắt.
Thẻ: host_machine_resource_optimizations
Các tuỳ chọn liên quan đến đầu ra truy vấn và ngữ nghĩa:
Giá trị mặc định của --aspect_deps=<off, conservative or precise>: "thận trọng"
Cách giải quyết các phần phụ thuộc khung hình khi định dạng đầu ra là {xml,proto,record}. "tắt" có nghĩa là không có phần phụ thuộc khung hình nào được phân giải, "bảo toàn" (mặc định) có nghĩa là tất cả các phần phụ thuộc khung hình đã khai báo đều được thêm vào bất kể các phần phụ thuộc đó 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ỉ các khía cạnh có thể đang hoạt động dựa trên lớp quy tắc của phần phụ thuộc trực tiếp. 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 đó khiến nó chậm hơn so với các chế độ khác. Cũng 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 được chạy trong "truy vấn bazel".
Thẻ: build_file_semantics
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ể là do hàm <code>str</code> Starlark áp dụng cho thực thể <code>Label</code>. Điều này rất hữu ích cho các công cụ cần khớp với kết quả của nhiều lệnh truy vấn và/hoặc nhãn do quy tắc đưa ra. Nếu không được bật, các trình định dạng đầu ra sẽ tự do phát ra tên kho lưu trữ rõ ràng (tương ứng với kho lưu trữ chính) để giúp kết quả dễ đọc hơn.
Thẻ: terminal_output
Mặc định của --[no]graph:factored: "đúng"
Nếu đúng, thì biểu đồ sẽ được phát ra "đã được tính thành phần", tức là các nút tương đương về mặt cấu trúc liên kết sẽ được hợp nhất với nhau và các nhãn của chúng được nối với nhau. Tuỳ chọn này chỉ áp dụng cho --output=map.
Thẻ: terminal_output
Mặc định của --graph:node_limit=<an integer>: "512"
Độ dài tối đa của chuỗi nhãn cho một nút biểu đồ trong đầu ra. Các nhãn dài hơn sẽ bị cắt bớt; -1 có nghĩa là không bị cắt bớt. Tuỳ chọn này chỉ áp dụng cho --output=map.
Thẻ: terminal_output
Mặc định của --[no]implicit_deps: "đúng"
Nếu được bật, các phần phụ thuộc ngầm ẩn 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 thêm bởi bazel. Đối với cquery, tuỳ chọn này kiểm soát việc lọc các chuỗi công cụ đã được phân giải.
Thẻ: build_file_semantics
Mặc định của --[no]include_aspects: "đúng"
aquery, cquery: liệu có bao gồm các hành động do khía cạnh tạo ra trong kết quả không. query: no-op (các khía cạnh luôn được tuân theo).
Thẻ: terminal_output
Mặc định của --[no]incompatible_package_group_includes_double_slash: "đúng"
Nếu bạn bật chế độ này, khi xuất thuộc tính "packages" của package_group, thuộc tính "//" ở đầu sẽ không bị bỏ qua.
Thẻ: terminal_output, incompatible_change
Mặc định của --[no]infer_universe_scope: "false"
Nếu bạn không đặt và --universe_scope, thì giá trị của --universe_scope sẽ được suy luận dưới dạng danh sách các mẫu mục tiêu duy nhất trong biểu thức truy vấn. Lưu ý rằng giá trị --universe_scope được suy luận cho biểu thức truy vấn sử dụng các hàm trong phạm vi toàn bộ (ví dụ:`allrdeps`) có thể không phải là điều bạn muốn, vì vậy, bạn chỉ nên sử dụng tùy chọn này nếu biết mình đang làm gì. Hãy tham khảo tại 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 tùy chọn này sẽ bị bỏ qua. Lưu ý: lựa chọn này chỉ áp dụng cho "truy vấn" (tức là không áp dụng cho "cquery").
Thẻ: loading_and_analysis
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
Mặc định của --[no]nodep_deps: "đúng"
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 nơi truy vấn hoạt động. Một ví dụ phổ biến về thuộc tính "nodep" là "khả năng hiển thị". Chạy và phân tích cú pháp kết quả của "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
Mặc định của --output=<a string>: "label"
Định dạng in kết quả cquery. Các giá trị được cho phép cho cquery là: label, label_ hại, textproto, chuyển đổi, proto, stream_proto, jsonproto. Nếu chọn 'transitions', bạn cũng phải chỉ định tuỳ chọn --transitions=(lite|full).
Thẻ: terminal_output
Mặc định của --[no]proto:default_values: "đúng"
Nếu đúng thì các thuộc tính có giá trị không được chỉ định rõ trong tệp BUILD sẽ được bao gồm; nếu không thì các thuộc tính này sẽ bị bỏ qua. Tuỳ chọn này áp dụng cho --output=proto
Thẻ: terminal_output
Mặc định của --[no]proto:definition_stack: "false"
Điền trường proto manifest_stack. Trường này ghi lại từng thực thể quy tắc cho 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
Mặc định của --[no]proto:flatten_selects: "đúng"
Nếu bạn bật chính sách này, các thuộc tính có thể định cấu hình do Select() tạo ra sẽ được làm phẳng. Đối với loại danh sách, cách biểu diễn đã làm phẳng là danh sách chứa từng giá trị của bản đồ chọn đúng một lần. Các loại vô hướng được làm phẳng thành giá trị rỗng.
Thẻ: build_file_semantics
Mặc định của --[no]proto:include_attribute_source_aspects: "false"
Điền trường proto source_aspect_name của mỗi Thuộc tính bằng khía cạnh nguồn của thuộc tính (chuỗi trống nếu không phải là chuỗi).
Thẻ: terminal_output
Mặc định của --[no]proto:include_configurations: "đúng"
nếu được bật, đầu ra proto sẽ bao gồm thông tin về các cấu hình. Khi bị tắt,định dạng đầu ra proto cquery sẽ giống với định dạng đầu ra của truy vấn.
Thẻ: affects_outputs
Mặc định của --[no]proto:include_synthetic_attribute_hash: "false"
Liệu có nên tính toán và điền thuộc tính $internal_attr_hash hay không.
Thẻ: terminal_output
Mặc định của --[no]proto:instantiation_stack: "false"
Điền ngăn xếp lệnh gọi tạo thực thể của từng quy tắc. Lưu ý rằng điều này yêu cầu ngăn xếp phải hiển thị
Thẻ: terminal_output
Mặc định của --[no]proto:locations: "đúng"
Liệu có xuất thông tin vị trí ở đầu ra proto hay không.
Thẻ: terminal_output
Mặc định của --proto:output_rule_attrs=<comma-separated list of options>: "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 kết quả. Giá trị mặc định là tất cả thuộc tính. Đặt thành chuỗi trống để không xuất bất kỳ thuộc tính nào. Tuỳ chọn này có thể áp dụng cho --output=proto.
Thẻ: terminal_output
Mặc định của --[no]proto:rule_inputs_and_outputs: "đúng"
Liệu có nên điền các trường Rule_input và Rule_output hay không.
Thẻ: terminal_output
Mặc định của --query_file=<a string>: ""
Nếu bạn đặt chính sách này, truy vấn sẽ đọc truy vấn từ tệp có tên ở đây, thay vì trên dòng lệnh. Sẽ xảy ra lỗi khi chỉ định tệp tại đây cũng như truy vấn dòng lệnh.
Thẻ: changes_inputs
Mặc định của --[no]relative_locations: "false"
Nếu đúng, vị trí của các tệp BUILD trong xml và kết quả proto sẽ là tương đối. Theo mặc định, dữ liệu vị trí đầu ra 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 true để có kết quả nhất quán trên các máy.
Thẻ: terminal_output
Mặc định của --show_config_fragments=<off, direct or transitive>: "tắt"
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 quy tắc đó. Điều này có thể hữu ích cho việc đánh giá mức độ cắt giảm một biểu đồ mục tiêu đã định cấu hình.
Thẻ: affects_outputs
Mặc định của --starlark:expr=<a string>: ""
Một biểu thức Starlark để định dạng từng mục tiêu đã định cấu hình trong chế độ --output=starlark của cquery. Mục tiêu đã định cấu hình được liên kết với "mục tiêu". Nếu bạn không chỉ định --starlark:expr hoặc --starlark:file, thì tuỳ chọn này sẽ được đặt mặc định thành 'str(target.label)'. Sẽ xảy ra lỗi khi chỉ định cả --starlark:expr và --starlark:file.
Thẻ: terminal_output
Mặc định của --starlark:file=<a string>: ""
Tên của tệp xác định hàm Starlark có tên là "format" (định dạng) của một đối số. Hàm này được áp dụng cho từng mục tiêu được định cấu hình để định dạng mục tiêu đó dưới dạng chuỗi. Sẽ xảy ra lỗi khi chỉ định cả --starlark:expr và --starlark:file. Xem trợ giúp về --output=starlark để biết thêm chi tiết.
Thẻ: terminal_output
Mặc định của --[no]tool_deps: "đúng"
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 qua đó. Cạnh phụ thuộc "exec configuration" (Cấu hình thực thi) (chẳng hạn như cạnh từ quy tắc "proto_library" bất kỳ đến Protocol Compiler (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 tạo bản dựng thay vì một phần của cùng một chương trình "target" (mục tiêu). Cquery: Nếu bị tắt, hãy 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 được đị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ó 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, chỉ các mục tiêu đã định cấu hình thực thi mới được trả về. Tuỳ chọn này sẽ KHÔNG loại trừ các chuỗi công cụ đã được phân giải.
Thẻ: build_file_semantics
Mặc định của --transitions=<full, lite or none>: "không có"
Định dạng mà cquery sẽ in thông tin chuyển đổi.
Thẻ: affects_outputs
Mặc định của --universe_scope=<comma-separated list of options>: ""
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 (cộng và trừ). Truy vấn có thể được thực hiện trong vũ trụ được xác định bằng việc đóng bắc cầu 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à mục tiêu mà tất cả câu trả lời đều được tạo và do đó, tuỳ chọn này có thể ảnh hưởng đến cấu hình và chuyển đổi. Nếu bạn không chỉ định tuỳ chọn này, thì mục tiêu cấp cao nhất được giả định là 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ị hỏng nếu không thể tạo mục tiêu được phân tích cú pháp từ biểu thức truy vấn với 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 Bzlmod:
Đã tích luỹ --allow_yanked_versions=<a string> lần sử dụng
Đã chỉ định các phiên bản mô-đun dưới dạng `<module1>@<version1>,<module2>@<version2>`. Những phiên bản này sẽ được 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 trong sổ đăng ký nơi chúng xuất phát (nếu các phiên bản đó không đến từ một NonRegistryOverride). Nếu không, các phiên bản bị giật sẽ khiến quá trình phân giải không thành công. Bạn cũng có thể xác định phiên bản được kéo mạnh được phép bằng biến môi trường "BZLMOD_ALLOW_YANKED_VERSIONS". Bạn có thể vô hiệu hoá việc kiểm tra này bằng cách sử dụng từ khoá 'all' (không được khuyến nghị).
Thẻ: loading_and_analysis
Mặc định của --check_bazel_compatibility=<error, warning or off>: "lỗi"
Kiểm tra khả năng tương thích với 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 đề lên trạng thái lỗi giải quyết, "tắt" để tắt chế độ kiểm tra, hoặc "cảnh báo" để in cảnh báo khi phát hiện thấy thông tin không khớp.
Thẻ: loading_and_analysis
Mặc định của --check_direct_dependencies=<off, warning or error>: "cảnh báo"
Kiểm tra xem các phần phụ thuộc trực tiếp "bazel_dep" được khai báo trong mô-đun gốc có giống với phiên bản bạn nhận được trong biểu đồ phần phụ thuộc đã được giải quyết hay không. Các giá trị hợp lệ là "off" ("tắt") để tắt chế độ kiểm tra, "cảnh báo" để in cảnh báo khi phát hiện thấy thông tin không khớp hoặc "error" để chuyển vấn đề lên thành lỗi giải quyết.
Thẻ: loading_and_analysis
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_secondary` trong MODULE.bazel của mô-đun gốc. Lưu ý rằng các phần phụ thuộc của 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
Mặc định của --lockfile_mode=<off, update or error>: "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 nếu có thay đổi, "error" khi dùng tệp khoá nhưng báo lỗi nếu tệp không được cập nhật, hoặc "tắt" để không đọc hoặc ghi vào tệp khoá.
Thẻ: loading_and_analysis
Đã tích luỹ --override_module=<an equals-separated mapping of module name to path> lần sử dụng
Ghi đè một mô-đun có đường dẫn cục bộ ở dạng <module name>=<path>. Nếu đường dẫn đã cho là một đường dẫn tuyệt đối, thì đường dẫn đó sẽ được sử dụng như nguyên trạng. Nếu đường dẫn đã cho là một đường dẫn tương đối, thì đường dẫn đó sẽ tương ứng với thư mục đang hoạt động hiện tại. Nếu đường dẫn đã cho bắt đầu bằng "%workspace%", thì đường dẫn đó 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 "không gian làm việc thông tin bazel")
Đã tích luỹ --registry=<a string> lần sử dụng
Chỉ định sổ đăng ký cần dùng để xác định vị trí các phần phụ thuộc của mô-đun Bazel. Thứ tự rất quan trọng: các mô-đun sẽ được tra cứu trước trong sổ đăng ký trước, và chỉ quay lại các sổ đăng ký sau khi còn thiếu trong các sổ đăng ký trước đó.
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:
Mặc định của --gc_thrashing_limits=<comma separated pairs of <period>:<count>>: "1s:2,20s:3,1m:5"
Các giới hạn mà nếu đạt đến mức này sẽ khiến GcThrashingDetector gây sự cố cho Bazel bằng OOM. Mỗi giới hạn được chỉ định dưới dạng <period>:<count>, trong đó khoảng thời gian là một khoảng thời gian và số lượng là một số nguyên dương. Nếu có hơn --gc_thrashing_threshold phần trăm không gian cần sử dụng (vùng nhớ khối xếp thế hệ cũ) vẫn chiếm sau <count> các GC đầy đủ liên tiếp trong khoảng <period>, thì OOM sẽ được kích hoạt. Bạn có thể chỉ định nhiều hạn mức và phân tách bằng dấu phẩy.
Thẻ: host_machine_resource_optimizations
Mặc định của --skyframe_high_water_mark_full_gc_drops_per_invocation=<an integer, >= 0>: "2147483647"
Gắn cờ cho cấu hình nâng cao của công cụ Skyframe nội bộ của Bazel. Nếu Bazel phát hiện thấy 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 đặt ra bằng --skyframe_high_water_mark_threshold, thì khi một sự kiện GC xảy ra đầy đủ, trạng thái Skyframe tạm thời không cần thiết sẽ bị bỏ qua, tối đa nhiều lần cho mỗi lệnh gọi. Mặc định là Integer.MAX_VALUE; không giới hạn hiệu quả. 0 có nghĩa là các sự kiện thu gom rác (GC) toàn bộ sẽ không bao giờ kích hoạt hiện tượng giảm. Nếu đạt đến giới hạn, trạng thái Skyframe sẽ không còn bị bỏ qua khi một sự kiện GC đầy đủ xảy ra và vượt quá ngưỡng tỷ lệ phần trăm vùng nhớ khối xếp được giữ lại đó.
Thẻ: host_machine_resource_optimizations
Mặc định của --skyframe_high_water_mark_minor_gc_drops_per_invocation=<an integer, >= 0>: "2147483647"
Gắn cờ cho cấu hình nâng cao của công cụ Skyframe nội bộ của Bazel. Nếu Bazel phát hiện thấy mức sử dụng tỷ lệ phần trăm vùng nhớ khối xếp được giữ lại vượt quá ngưỡng đặt ra bằng --skyframe_high_water_mark_threshold, thì khi một sự kiện GC nhỏ xảy ra, trạng thái Skyframe tạm thời không cần thiết sẽ bị bỏ qua, tối đa là nhiều lần cho mỗi lệnh gọi. Mặc định là Integer.MAX_VALUE; không giới hạn hiệu quả. 0 có nghĩa là các sự kiện GC nhỏ sẽ không bao giờ kích hoạt hiện tượng giảm. Nếu đạt đến giới hạn, trạng thái Skyframe sẽ không còn bị bỏ qua khi xảy ra một sự kiện GC nhỏ và ngưỡng tỷ lệ phần trăm vùng nhớ khối xếp được giữ lại đó đã vượt quá.
Thẻ: host_machine_resource_optimizations
Mặc định của --skyframe_high_water_mark_threshold=<an integer>: "85"
Gắn cờ cho cấu hình nâng cao của công cụ Skyframe nội bộ của Bazel. Nếu Bazel 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 ở ngưỡng này, thì Bazel sẽ bỏ trạng thái Skyframe tạm thời không cần thiết. Việc chỉnh sửa tính năng này có thể cho phép bạn giảm thiểu tác động của tình trạng này đến thời gian sử dụng GC, khi tình trạng giật GC là do việc sử dụng bộ nhớ ở trạng thái tạm thời này gây ra và (ii) tốn kém hơn so với việc khôi phục trạng thái khi cần.
Thẻ: host_machine_resource_optimizations
Các tuỳ chọn ảnh hưởng đến độ chi tiết, định dạng hoặc vị trí ghi nhật ký:
Mặc định của --[no]experimental_command_profile: "false"
Ghi lại hồ sơ CPU của Trình ghi chuyến bay Java vào tệp profile.jfr trong thư mục cơ sở đầu ra. Trong tương lai, cú pháp và ngữ nghĩa của cờ này có thể thay đổi để hỗ trợ nhiều loại hồ sơ hoặc định dạng đầu ra; bạn tự chịu rủi ro khi sử dụng.
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 thao tác ghi nhớ 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ả chức năng ghi nhớ.
Các tuỳ chọn chỉ định hoặc thay đổi dữ liệu đầu vào chung thành lệnh Bazel mà không thuộc các danh mục khác.:
Mặc định của --experimental_resolved_file_instead_of_workspace=<a string>: ""
Nếu nội dung không trống, hãy đọc tệp đã được phân giải được chỉ định thay vì tệp WORKSPACE
Các thẻ: changes_inputs
Các tuỳ chọn thực thi và lưu vào bộ nhớ đệm từ xa:
Mặc định của --experimental_downloader_config=<a string>: 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ủ (cho `allow` và `block`) hoặc hai mẫu, một mẫu để so khớp và một mẫu dùng làm URL thay thế, có tham chiếu ngược bắt đầu từ "$1". Có thể có nhiều lệnh "rewrite" cho cùng một URL và trong trường hợp này sẽ có nhiều URL được trả về.
Mặc định của --experimental_worker_for_repo_fetching=<off, platform or virtual>: "tắt"
Chế độ phân luồng dùng để tìm nạp kho lưu trữ. Nếu bạn đặt chính sách này thành "tắt", thì sẽ không có luồng worker nào được sử dụng và quá trình tìm nạp kho lưu trữ có thể khởi động lại. Ngược lại, hãy sử dụng luồng nền tảng (tức là luồng hệ điều hành) nếu được đặt thành "platform" hoặc luồng ảo nếu được đặt thành "virtual".
Các lựa chọn khác, không được phân loại.:
Đã tích luỹ --override_repository=<an equals-separated mapping of repository name to path> lần sử dụng
Ghi đè một 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à một đường dẫn tuyệt đối, thì đường dẫn đó sẽ được sử dụng nguyên vẹn. Nếu đường dẫn đã cho là một đườ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 này 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 "bazel thông tin không gian làm việc"
Các tuỳ chọn kiểm soát quá trình thực thi bản dựng:
Liệu có nên thực hiện lệnh gọi hệ thống tệp trực tiếp để tạo cây liên kết tượng trưng hay không
Các thẻ: loading_and_analysis, execution, experimental
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
Mặc định của --[no]experimental_remotable_source_manifests: "false"
Liệu có nên làm cho hành động trong tệp kê khai nguồn có thể điều khiển từ xa hay không
Các thẻ: loading_and_analysis, execution, experimental
Mặc định của --[no]experimental_split_coverage_postprocessing: "false"
Nếu đúng, Bazel sẽ chạy quá trình xử lý hậu kỳ về mức độ phù hợp để kiểm thử trong một quy trình tái tạo mới.
Thẻ: execution
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 mọi cấu phần phần mềm đầu ra là tệp thông thường. Chúng sẽ không truyền tải 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
Mặc định của --modify_execution_info=<regex=[+-]key,regex=[+-]key,...>: ""
Thêm hoặc xoá khoá khỏi thông tin thực thi của một hành động dựa trên tính năng ghi nhớ 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ự 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ách ghi nhớ. Cú pháp: "regex=[+-]key,regex=[+-]key,...". Ví dụ: ".*=+x,.*=-y,.*=+z" thêm "x" và "z" vào, đồng thời xoá "y" khỏi thông tin thực thi cho mọi hành động. 'Genquy=+requirements-x' sẽ thêm 'requirements-x' vào thông tin thực thi cho tất cả các hành động theo Quy tắc tạo sinh. '(?!GenRules).*=-requirements-x' sẽ xoá 'requires-x' khỏi thông tin thực thi cho mọi hành động không phải là Quy tắc.
Thẻ: execution, affects_outputs, loading_and_analysis
--persistent_android_dex_desugar
Kích hoạt các hành động tạo tệp 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
Hỗ trợ bộ xử lý tài nguyên Android ổn định bằng cách sử dụng trình thực thi (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=workerhost_machine_resource_optimizationsexecution
--persistent_multiplex_android_dex_desugar
Hỗ trợ các thao tác Android dex và đơn giản hoá ở chế độ ghép kênh liên tục bằng cách sử dụng trình thực thi (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
Cho phép bộ xử lý tài nguyên Android ghép kênh ổn định bằng cách sử dụng trình thực thi (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-workershost_machine_resource_optimizationsexecution
--persistent_multiplex_android_tools
Bật các công cụ Android đa năng và ổn định (tạo tệp dex, đơn giản hoá, 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
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:
Mặc định của --android_compiler=<a string>: xem nội dung mô tả
Trình biên dịch mục tiêu của Android.
Thẻ: affects_outputs, loading_and_analysis, loses_incremental_state
Mặc định của --android_crosstool_top=<a build target label>: "//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
Mặc định của --android_grte_top=<a label>: xem nội dung mô tả
Mục tiêu grte_top trên Android.
Thẻ: changes_inputs, loading_and_analysis, loses_incremental_state
Mặc định của --android_manifest_merger=<legacy, android or force_android>: "android"
Chọn trình hợp nhất tệp kê khai để sử dụng cho các quy tắc android_binary. Gắn 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
Mặc định của --android_platforms=<a build target label>: ""
Đặt 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à một APK lớn, chứa các tệp nhị phân gốc cho từng nền tảng đích được chỉ định.
Thẻ: changes_inputs, loading_and_analysis, loses_incremental_state
Giá trị mặc định của --android_sdk=<a build target label>: "@bazel_tools//tools/android:sdk"
Chỉ định SDK/nền tảng Android dùng để xây dựng ứng dụng Android.
Thẻ: changes_inputs, loading_and_analysis, loses_incremental_state
Giá trị mặc định của --apple_crosstool_top=<a build target label>: "@bazel_tools//tools/cpp:toolchain"
Nhãn của gói công cụ chéo sẽ được dùng trong các quy tắc Apple và Objc và phần phụ thuộc của các quy tắc này.
Thẻ: loses_incremental_state, changes_inputs
Mặc định của --cc_output_directory_tag=<a string>: ""
Chỉ định một hậu tố để thêm vào thư mục cấu hình.
Thẻ: affects_outputs
Mặc định của --compiler=<a string>: 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
Giá trị mặc định của --coverage_output_generator=<a build target label>: "@bazel_tools//tools/test:lcov_merger"
Vị trí của tệp nhị phân được dùng để báo cáo mức độ phù hợp thô sau khi xử lý. Đây phải là một nhóm tệp có chứa một tệp duy nhất, đó là tệp nhị phân. Giá trị mặc định là '//tools/test:lcov_merger'.
Thẻ: changes_inputs, affects_outputs, loading_and_analysis
Giá trị mặc định của --coverage_report_generator=<a build target label>: "@bazel_tools//tools/test:Coverage_report_generator"
Vị trí của tệp nhị phân được dùng để tạo báo cáo mức độ phù hợp. Đây phải là một nhóm tệp có chứa một tệp duy nhất, đó là tệp nhị phân. Giá trị mặc định là '//tools/test:Coverage_report_generator'.
Thẻ: changes_inputs, affects_outputs, loading_and_analysis
Giá trị mặc định của --coverage_support=<a build target label>: "@bazel_tools//tools/test:Coverage_support"
Vị trí của các tệp hỗ trợ bắt buộc đối với 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
Giá trị mặc định của --crosstool_top=<a build target label>: "@bazel_tools//tools/cpp:toolchain"
Nhãn của gói công cụ chéo dùng để biên dịch mã C++.
Thẻ: loading_and_analysis, changes_inputs, affects_outputs
Mặc định của --custom_malloc=<a build target label>: xem nội dung mô tả
Chỉ định phương thức triển khai Malloc tuỳ chỉnh. Chế độ cài đặt này ghi đè các thuộc tính Malloc trong quy tắc tạo bản dựng.
Thẻ: changes_inputs, affects_outputs
Đã tích luỹ --experimental_add_exec_constraints_to_targets=<a '<RegexFilter>=<label1>[,<label2>,...]' assignment> lần sử dụng
Danh sách các biểu thức chính quy được phân tách bằng dấu phẩy, mỗi biểu thức chính quy có tiền tố (không bắt buộc) là dấu - (biểu thức âm), được gán (=) cho một danh sách các mục tiêu giá trị ràng buộc được phân tách bằng dấu phẩy. Nếu một mục tiêu khớp với không có biểu thức âm nào và có ít nhất một biểu thức dương, thì quá trình phân giải chuỗi công cụ của mục tiêu sẽ được thực hiện như thể đã khai báo các giá trị ràng buộc dưới dạng các quy tắ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
Mặc định của --[no]experimental_include_xcode_execution_requirements: "false"
Nếu được đặt, hãy thêm yêu cầu thực thi "requires-xcode:{version}" vào mọi hành động trên Xcode. Nếu phiên bản xcode có nhãn có dấu gạch nối, hãy thêm cả yêu cầu thực thi "requires-xcode-label:{version_label}".
Thẻ: loses_incremental_state, loading_and_analysis, execution
Mặc định của --[no]experimental_prefer_mutual_xcode: "đúng"
Nếu đúng, hãy sử dụng Xcode mới nhất có sẵn cả trên máy và từ xa. Nếu giá trị là false hoặc nếu không có phiên bản nào cho nhau, hãy sử dụng phiên bản Xcode cục bộ đã chọn thông qua xcode-select.
Thẻ: loses_incremental_state
Mặc định của --extra_execution_platforms=<comma-separated list of options>: ""
Các nền tảng có thể sử dụng dưới dạng nền tảng thực thi để chạy các hành động. Các nền tảng có thể được chỉ định theo mục tiêu chính xác hoặc làm mẫu mục tiêu. Các nền tảng này sẽ được xem xét trước các 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 phiên bản sau này sẽ ghi đè chế độ cài đặt cờ trước đó.
Thẻ: execution
Đã tích luỹ --extra_toolchains=<comma-separated list of options> lần sử dụng
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ụ. Chuỗi công cụ có thể được chỉ định 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().
Các thẻ: affects_outputs, changes_inputs, loading_and_analysis
Mặc định của --grte_top=<a label>: xem nội dung mô tả
Nhãn cho thư viện libc đã xác nhận có mặt. Giá trị mặc định được chọn bởi chuỗi công cụ crosstool và bạn hầu như không bao giờ cần ghi đè giá trị đó.
Thẻ: action_command_lines, affects_outputs
Mặc định của --host_compiler=<a string>: xem nội dung mô tả
Trình biên dịch C++ dùng để biên dịch máy chủ. Thuộc tính này sẽ bị bỏ qua nếu bạn không đặt --host_crosstool_top.
Thẻ: loading_and_analysis, execution
Mặc định của --host_crosstool_top=<a build target label>: 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 executor. Nếu cờ này được cung cấp, Bazel sẽ sử dụng libc và trình biên dịch mặc định cho crosstool_top nhất định.
Thẻ: loading_and_analysis, changes_inputs, affects_outputs
Mặc định của --host_grte_top=<a label>: 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 exec.
Thẻ: action_command_lines, affects_outputs
Giá trị mặc định của --host_platform=<a build target label>: "@local_config_platform//:host"
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
Mặc định của --[no]incompatible_dont_enable_host_nonhost_crosstool_features: "đúng"
Nếu đúng, Bazel sẽ không bật các tính năng "host" (máy chủ) và "nonhost" (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
Mặc định của --[no]incompatible_enable_android_toolchain_resolution: "đúng"
Sử dụng độ phân giải của chuỗi công cụ để chọn SDK Android cho quy tắc Android (Starlark và gốc)
Thẻ: loading_and_analysis, incompatible_change
Mặc định của --[no]incompatible_enable_apple_toolchain_resolution: "false"
Sử dụng độ phân giải của chuỗi công cụ để chọn SDK Apple cho quy tắc Apple (Starlark và gốc)
Thẻ: loading_and_analysis, incompatible_change
Mặc định của --[no]incompatible_make_thinlto_command_lines_standalone: "đúng"
Nếu đúng, Bazel sẽ không sử dụng lại các dòng lệnh của thao tác liên kết C++ để lập chỉ mục 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
Mặc định của --[no]incompatible_remove_legacy_whole_archive: "đúng"
Nếu đúng, Bazel sẽ không liên kết các phần phụ thuộc của thư viện dưới dạng toàn bộ kho lưu trữ theo mặc định (xem https://github.com/bazelbuild/bazel/issues/7362 để biết hướng dẫn di chuyển).
Thẻ: loading_and_analysis, incompatible_change
Mặc định của --[no]incompatible_require_ctx_in_configure_features: "đúng"
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
Mặc định của --[no]interface_shared_objects: "đúng"
Sử dụng các đố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
Mặc định của --ios_sdk_version=<a dotted version (for example '2.3' or '3.3alpha2.4')>: xem nội dung mô tả
Chỉ định phiên bản của SDK iOS cần dùng để 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 qua "xcode_version".
Thẻ: loses_incremental_state
Mặc định của --macos_sdk_version=<a dotted version (for example '2.3' or '3.3alpha2.4')>: xem nội dung mô tả
Chỉ định phiên bản của SDK macOS sẽ dùng để xây dựng ứng dụng macOS. Nếu bạn không chỉ định, hãy sử dụng phiên bản SDK macOS mặc định qua "xcode_version".
Thẻ: loses_incremental_state
Mặc định của --minimum_os_version=<a string>: xem nội dung mô tả
Phiên bản hệ điều hành tối thiểu mà quá trình biên dịch nhắm đến.
Thẻ: loading_and_analysis, affects_outputs
Mặc định của --platform_mappings=<a relative path>: ""
Vị trí của tệp ánh xạ cho biết nền tảng nào sẽ được sử dụng nếu không có nền tảng nào được đặt hoặc cờ nào cần đặt khi đã có nền tảng. Phải tương ứng với thư mục gốc của không gian làm việc chính. Giá trị 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
Mặc định của --platforms=<a build target label>: ""
Nhãn của các quy tắc nền tảng mô tả nền tảng đích cho lệnh hiện tại.
Thẻ: affects_outputs, changes_inputs, loading_and_analysis
Mặc định của --python2_path=<a string>: xem nội dung mô tả
Ngừng sử dụng, không hoạt động. Bị vô hiệu hoá bởi "--incompatible_use_python_toolchains".
Các thẻ: no_op, deprecated
Mặc định của --python3_path=<a string>: xem nội dung mô tả
Ngừng sử dụng, không hoạt động. Bị vô hiệu hoá bởi "--incompatible_use_python_toolchains".
Các thẻ: no_op, deprecated
Mặc định của --python_path=<a string>: 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ởi --incompatible_use_python_toolchains.
Thẻ: loading_and_analysis, affects_outputs
Mặc định của --python_top=<a build target label>: 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ởi --incompatible_use_python_toolchains.
Thẻ: loading_and_analysis, affects_outputs
Mặc định của --tvos_sdk_version=<a dotted version (for example '2.3' or '3.3alpha2.4')>: xem nội dung mô tả
Chỉ định phiên bản của SDK tvOS dùng để tạo ứ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
Mặc định của --watchos_sdk_version=<a dotted version (for example '2.3' or '3.3alpha2.4')>: xem nội dung mô tả
Chỉ định phiên bản của SDK watchOS dùng để tạo các ứng dụng watchOS. Nếu bạn chưa chỉ định, hãy sử dụng phiên bản SDK watchOS mặc định từ "xcode_version".
Thẻ: loses_incremental_state
Mặc định của --xcode_version=<a string>: 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 hành động tạo liên quan. Nếu bạn không chỉ định, hãy sử dụng phiên bản Xcode mặc định cho trình thực thi của mình.
Thẻ: loses_incremental_state
Giá trị mặc định của --xcode_version_config=<a build target label>: "@bazel_tools//tools/cpp:host_xcodes"
Nhãn của quy tắc xcode_config được 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 kết quả của lệnh:
Mặc định của --[no]apple_generate_dsym: "false"
Liệu có nên tạo (các) tệp biểu tượng gỡ lỗi (.dSYM) hay không.
Thẻ: affects_outputs, action_command_lines
Nếu đúng, hãy tạo các khu rừng liên kết tượng trưng runfiles cho tất cả mục tiêu. Nếu giá trị là sai, chỉ ghi khi được yêu cầu bởi một thao tác cục bộ, lệnh kiểm tra hoặc chạy.
Thẻ: affects_outputs
Mặc định của --[no]build_runfile_manifests: "đúng"
Nếu đúng, hãy ghi tệp kê khai runfile cho tất cả mục tiêu. Nếu giá trị là false, hãy bỏ qua chúng. Các kiểm thử cục bộ sẽ không chạy được khi giá trị false.
Thẻ: affects_outputs
Mặc định của --[no]build_test_dwp: "false"
Nếu được bật, khi tạo kiểm thử C++ theo cách tĩnh và 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
Mặc định của --cc_proto_library_header_suffixes=<comma-separated set of options>: ".pb.h"
Đặt hậu tố cho các tệp tiêu đề mà cc_proto_library tạo.
Thẻ: affects_outputs, loading_and_analysis
Mặc định của --cc_proto_library_source_suffixes=<comma-separated set of options>: ".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
Mặc định của --[no]experimental_proto_descriptor_sets_include_source_info: "false"
Chạy thêm các thao tác cho các phiên bản API Java thay thế trong một proto_library.
Thẻ: affects_outputs, loading_and_analysis, experimental
Mặc định của --[no]experimental_proto_extra_actions: "false"
Chạy thêm các thao tác cho các phiên bản API Java thay thế trong một proto_library.
Thẻ: affects_outputs, loading_and_analysis, experimental
Mặc định của --[no]experimental_save_feature_state: "false"
Lưu trạng thái của các chức 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
Mặc định của --fission=<a set of compilation modes>: "không"
Chỉ định những chế độ biên dịch sử dụng quá trình phân tách cho các đường liên kết và nội dung biên dịch C++. Có thể là bất kỳ tổ hợp nào của {'fastbuild', 'dbg', 'opt'} hoặc giá trị đặc biệt "yes" để bật tất cả chế độ và "no" để tắt mọi chế độ.
Thẻ: loading_and_analysis, action_command_lines, affects_outputs
Mặc định của --[no]incompatible_always_include_files_in_data: "đúng"
Nếu đúng, các quy tắc gốc sẽ thêm <code>DefaultInfo.files</code> các phần phụ thuộc dữ liệu vào các tệp runfile của chúng, khớp với hành vi được đề xuất cho các quy tắc Starlark (https://bazel.build/ext hóa/rules#runfiles_features_to_avoid).
Thẻ: affects_outputs, incompatible_change
Mặc định của --[no]legacy_external_runfiles: "đúng"
Nếu đúng, hãy tạo các khu rừng liên kết tượng trưng runfiles cho các kho lưu trữ bên ngoài trong miền .runfiles/wsname/external/repo (ngoài .runfiles/repo).
Thẻ: affects_outputs
Mặc định của --[no]objc_generate_linkmap: "false"
Chỉ định xem có tạo tệp bản đồ liên kết hay không.
Thẻ: affects_outputs
Mặc định của --[no]save_temps: "false"
Nếu bạn đặt chính sách này, các kết quả tạm thời từ gcc sẽ được lưu. Những tệp này bao gồm tệp .s (mã tập hợp), tệp .i (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ự định, ảnh hưởng đến giá trị của kết quả đó, trái ngược với sự tồn tại của kết quả đó:
Đã tích luỹ --action_env=<a 'name=value' assignment with an optional value part> lần sử dụng
Chỉ định tập hợp 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 cặp tên=giá trị để đặt giá trị độc lập với môi trường gọi. Bạn có thể sử dụng lựa chọn này nhiều lần; đối với các lựa chọn được cung cấp cho cùng một biến, các chiến thắng gần đây nhất, các lựa chọn cho các biến khác nhau sẽ tích luỹ.
Thẻ: action_command_lines
Giá trị mặc định của --android_cpu=<a string>: "armeabi-v7a"
CPU mục tiêu của Android.
Thẻ: affects_outputs, loading_and_analysis, loses_incremental_state
Mặc định của --[no]android_databinding_use_androidx: "đúng"
Tạo các tệp liên kết dữ liệu tương thích với AndroidX. Tính năng này chỉ được sử dụng với tính năng liên kết dữ liệu phiên bản 2. Cờ này không hoạt động.
Các thẻ: affects_outputs, loading_and_analysis, loses_incremental_state, experimental
Mặc định của --[no]android_databinding_use_v3_4_args: "đúng"
Sử dụng tính năng liên kết dữ liệu của Android phiên bản 2 với đối số 3.4.0. Cờ này không hoạt động.
Các thẻ: affects_outputs, loading_and_analysis, loses_incremental_state, experimental
Mặc định của --android_dynamic_mode=<off, default or fully>: "tắt"
Xác định xem phần phụ thuộc C++ của các quy tắc Android có được liên kết động hay không khi cc_binary không tạo thư viện dùng chung một cách rõ ràng. "default" 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ế độ chủ yếu là tĩnh.
Thẻ: affects_outputs, loading_and_analysis
Giá trị mặc định của --android_manifest_merger_order=<alphabetical, alphabetical_by_configuration or dependency>: "theo thứ tự bảng chữ cái"
Đặt thứ tự các tệp kê khai được chuyển đến trình hợp nhất tệp kê khai cho tệp nhị phân Android. ALPHABETICAL có nghĩa là các tệp kê khai được sắp xếp theo đường dẫn tương ứng với tệp thực thi. ALPHABETICAL_BY_CONFIGURATION 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 có nghĩa là các tệp kê khai được sắp xếp theo thứ tự với tệp kê khai của từng thư viện xuất hiện trước tệp kê khai của các phần phụ thuộc.
Thẻ: action_command_lines, execution
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 APK android_binary sử dụng ProGuard.
Thẻ: affects_outputs, loading_and_analysis
Mặc định của --[no]build_python_zip: "tự động"
Tạo tệp zip có thể thực thi cho python; trên Windows, tắt trên các nền tảng khác
Thẻ: affects_outputs
Đã tích luỹ --catalyst_cpus=<comma-separated list of options> lần sử dụng
Danh sách 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
Mặc định của --[no]collect_code_coverage: "false"
Nếu được chỉ định, Bazel sẽ đo lường mã (sử dụng khả năng đo lường ngoại tuyến nếu có thể) và sẽ thu thập thông tin về mức độ phù hợp trong quá trình kiểm thử. Chỉ những mục tiêu khớp với --Instrumentation_filter sẽ 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 mà nên sử dụng lệnh 'bazel Coverage' để thay thế.
Thẻ: affects_outputs
--compilation_mode=<fastbuild, dbg or opt> [-c] mặc định: "fastbuild"
Chỉ định chế độ mà bạn sẽ tạo tệp nhị phân. Giá trị: "fastbuild", "dbg", "opt".
Thẻ: affects_outputs, action_command_lines
Đã tích luỹ --conlyopt=<a string> lần sử dụng
Tuỳ chọn bổ sung để chuyển đến gcc khi biên dịch tệp nguồn C.
Thẻ: action_command_lines, affects_outputs
Đã tích luỹ --copt=<a string> lần sử dụng
Các tuỳ chọn bổ sung để chuyển đến gcc.
Thẻ: action_command_lines, affects_outputs
Mặc định của --cpu=<a string>: ""
CPU mục tiêu.
Thẻ: changes_inputs, affects_outputs
Mặc định của --cs_fdo_absolute_path=<a string>: 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 cấu hình, tệp cấu hình LLVM thô hoặc đã được lập chỉ mục.
Thẻ: affects_outputs
Mặc định của --cs_fdo_instrument=<a string>: xem nội dung mô tả
Tạo tệp nhị phân có khả năng đo lường FDO theo bối 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à theo đó(các) tệp cấu hình thô sẽ được kết xuất trong thời gian chạy.
Thẻ: affects_outputs
Mặc định của --cs_fdo_profile=<a build target label>: xem nội dung mô tả
cs_fdo_profile đại diện cho hồ sơ có phân biệt ngữ cảnh dùng để tối ưu hoá.
Thẻ: affects_outputs
Đã tích luỹ --cxxopt=<a string> lần sử dụng
Tuỳ chọn bổ sung để chuyển đến gcc khi biên dịch tệp nguồn C++.
Thẻ: action_command_lines, affects_outputs
Đã tích luỹ --define=<a 'name=value' assignment> lần sử dụng
Mỗi tuỳ chọn --define chỉ định việc gán cho một biến bản dựng.
Thẻ: changes_inputs, affects_outputs
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. "default" có nghĩa là Bazel sẽ chọn có liên kết linh hoạt 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ế độ chủ yếu là tĩnh.
Thẻ: loading_and_analysis, affects_outputs
Mặc định của --[no]enable_fdo_profile_absolute_path: "đúng"
Nếu bạn đặt chính sách này, việc sử dụng fdo_absolute_profile_path sẽ gây ra lỗi.
Thẻ: affects_outputs
Mặc định của --[no]enable_runfiles: "tự động"
Bật cây liên kết tượng trưng runfile. Theo mặc định, cây này sẽ bị tắt trên Windows và trên các nền tảng khác.
Thẻ: affects_outputs
Đã tích luỹ --experimental_action_listener=<a build target label> lần sử dụng
Ngừng sử dụng và thay vào đó là một số khía cạnh. Sử dụng action_listener để đính kèm thêm một hành động phụ vào các hành động tạo bản dựng hiện có.
Thẻ: execution, experimental
Mặc định của --[no]experimental_android_compress_java_resources: "false"
Nén tài nguyên Java trong tệp APK
Các thẻ: affects_outputs, loading_and_analysis, experimental
Mặc định của --[no]experimental_android_databinding_v2: "đúng"
Sử dụng tính năng liên kết dữ liệu của Android phiên bản 2. Cờ này không hoạt động.
Các thẻ: affects_outputs, loading_and_analysis, loses_incremental_state, experimental
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 APK android_binary sử dụng ProGuard.
Thẻ: affects_outputs, loading_and_analysis
Mặc định của --[no]experimental_android_rewrite_dexes_with_rex: "false"
dùng công cụ rex để ghi lại tệp dex
Các thẻ: affects_outputs, loading_and_analysis, loses_incremental_state, experimental
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 về phạm vi thu thập cho các tệp được tạo.
Thẻ: affects_outputs
Mặc định của --experimental_objc_fastbuild_options=<comma-separated list of options>: "-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
Mặc định của --[no]experimental_omitfp: "false"
Nếu đúng, hãy sử dụng libunwind để tháo dỡ ngăn xếp (stack) và biên dịch bằng -fomit-frame-pointer và -faasync-unwind-tables.
Thẻ: action_command_lines, affects_outputs, experimental
Mặc định của --experimental_output_paths=<off, content or strip>: "tắt"
Mô hình cần sử dụng để ghi kết quả đầu ra trong quy tắc cây đầu ra, đặc biệt là cho các bản dựng đa nền tảng / nhiều cấu hình. Đây là tính năng mang tính thử nghiệm cao. Truy cập https://github.com/bazelbuild/bazel/issues/6526 để biết chi tiết. Các hành động Starlark có thể chọn ánh xạ đường dẫn bằng cách thêm khoá "supports-path-mapping" vào lệnh "execution_requirements".
Thẻ: loses_incremental_state, bazel_internal_configuration, affects_outputs, execution
Đã tích luỹ --experimental_override_name_platform_in_output_dir=<a 'label=value' assignment> lần sử dụng
Mỗi mục nhập phải có dạng label=value, trong đó nhãn chỉ một nền tảng và giá trị là tên viết tắt mong muốn để sử dụng trong đường dẫn đầu ra. Chỉ được sử dụng khi --experimental_platform_in_output_dir là giá trị true. Có mức độ ưu tiên đặt tên cao nhất.
Thẻ: affects_outputs, experimental
Mặc định của --[no]experimental_platform_in_output_dir: "false"
Nếu đúng, tên viết tắt của nền tảng mục tiêu sẽ được sử dụng trong tên thư mục đầu ra thay vì CPU. Lược đồ chính xác đang thử nghiệm và có thể thay đổi: Trước tiên, trong trường hợp hiếm gặp, tuỳ chọn --platforms không có chính xác một giá trị, hàm băm của tuỳ chọn nền tảng sẽ được sử dụng. Tiếp theo, nếu bất kỳ tên viết tắt nào cho nền tảng hiện tại đã được đăng ký --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_heuristics đã đặt, 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 được dùng làm phương án cuối cùng.
Thẻ: affects_outputs, experimental
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 đồ phủ sóng llvm-cov thay vì gcov khi collection_code_Coverage được bật.
Thẻ: changes_inputs, affects_outputs, loading_and_analysis, experimental
Mặc định của --[no]experimental_use_platforms_in_output_dir_legacy_heuristic: "đúng"
Vui lòng chỉ sử dụng cờ này cho chiến lược di chuyển hoặc thử nghiệm đượ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
Giá trị mặc định của --fat_apk_cpu=<comma-separated set of options>: "armeabi-v7a"
Việc đặt tuỳ chọn này sẽ bật các APK lớn, chứa các tệp nhị phân gốc cho tất cả cấu trúc mục tiêu đã chỉ định, ví dụ: --fat_apk_cpu=x86,armeabi-v7a. Nếu cờ này được chỉ định, 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
Mặc định của --[no]fat_apk_hwasan: "false"
Liệu có tạo phần phân tách HWASAN hay không.
Thẻ: affects_outputs, loading_and_analysis, loses_incremental_state
Mặc định của --fdo_instrument=<a string>: 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à theo đó(các) tệp cấu hình thô sẽ được kết xuất trong thời gian chạy.
Thẻ: affects_outputs
Mặc định của --fdo_optimize=<a string>: 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 cấu hình LLVM. Cờ này cũng chấp nhận các tệp được chỉ định dưới dạng nhãn (ví dụ: "//foo/bar:file.afdo" – bạn có thể cần phải 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
Mặc định của --fdo_prefetch_hints=<a build target label>: xem nội dung mô tả
Sử dụng gợi ý tìm nạp trước bộ nhớ đệm.
Thẻ: affects_outputs
Mặc định của --fdo_profile=<a build target label>: xem nội dung mô tả
Fdo_profile đại diện cho hồ sơ dùng để tối ưu hoá.
Thẻ: affects_outputs
Đã tích luỹ --features=<a string> lần sử dụng
Theo mặc định, các tính năng cụ thể sẽ được bật hoặc tắt cho các mục tiêu được tạo trong cấu hình mục tiêu. Khi bạn chỉ định -<feature>, tính năng này sẽ tắt. Các tính năng tiêu cực luôn được ưu tiên hơn các tính năng khẳng định. Xem thêm --host_features
Các thẻ: changes_inputs, affects_outputs
Mặc định của --[no]force_pic: "false"
Nếu được bật, tất cả nội dung biên dịch C++ đều tạo mã độc lập về vị trí ("-fPIC"), các đường liên kết sẽ ưu tiên thư viện tạo sẵn PIC hơn so với thư viện không phải PIC và đường liên kết tạo ra các tệp thực thi độc lập về vị trí ("-pie").
Thẻ: loading_and_analysis, affects_outputs
Đã tích luỹ --host_action_env=<a 'name=value' assignment with an optional value part> lần sử dụng
Chỉ định tập hợp 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 cặp tên=giá trị để đặt giá trị độc lập với môi trường gọi. Bạn có thể sử dụng lựa chọn này nhiều lần; đối với các lựa chọn được cung cấp cho cùng một biến, các chiến thắng gần đây nhất, các lựa chọn cho các biến khác nhau sẽ tích luỹ.
Thẻ: action_command_lines
Mặc định của --host_compilation_mode=<fastbuild, dbg or opt>: "opt"
Chỉ định chế độ mà các công cụ dùng trong quá trình tạo bản dựng sẽ được tích hợp. Giá trị: "fastbuild", "dbg", "opt".
Thẻ: affects_outputs, action_command_lines
Đã tích luỹ --host_conlyopt=<a string> lần sử dụng
Tuỳ chọn bổ sung để chuyể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 executor.
Thẻ: action_command_lines, affects_outputs
Đã tích luỹ --host_copt=<a string> lần sử dụng
Các tuỳ chọn bổ sung để truyền đến trình biên dịch C đối với các công cụ được tạo trong cấu hình executor.
Thẻ: action_command_lines, affects_outputs
Mặc định của --host_cpu=<a string>: ""
CPU của máy chủ.
Thẻ: changes_inputs, affects_outputs
Đã tích luỹ --host_cxxopt=<a string> lần sử dụng
Các tuỳ chọn bổ sung để chuyển đến trình biên dịch C++ đối với các công cụ được tạo trong cấu hình executor.
Thẻ: action_command_lines, affects_outputs
Đã tích luỹ --host_features=<a string> lần sử dụng
Theo mặc định, các tính năng cụ thể sẽ được bật hoặc tắt đối với các mục tiêu được xây dựng trong cấu hình thực thi. Khi bạn chỉ định -<feature>, tính năng này sẽ tắt. Các tính năng tiêu cực luôn được ưu tiên hơn các tính năng khẳng định.
Thẻ: changes_inputs, affects_outputs
Mặc định của --host_force_python=<PY2 or PY3>: xem nội dung mô tả
Ghi đè phiên bản Python cho cấu hình executor. Có thể là "PY2" hoặc "PY3".
Thẻ: loading_and_analysis, affects_outputs
Đã tích luỹ --host_linkopt=<a string> lần sử dụng
Tuỳ chọn bổ sung để chuyển tới trình liên kết khi liên kết các công cụ trong cấu hình tệp thực thi.
Thẻ: action_command_lines, affects_outputs
Mặc định của --host_macos_minimum_os=<a dotted version (for example '2.3' or '3.3alpha2.4')>: xem nội dung mô tả
Phiên bản macOS tương thích tối thiểu cho mục tiêu máy chủ lưu trữ. Nếu không chỉ định, hãy sử dụng "macos_sdk_version".
Thẻ: loses_incremental_state
Đã tích luỹ --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> lần sử dụng
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 tệp thực thi. Bạn có thể chuyển tuỳ chọn này nhiều lần. Cú pháp: regex_filter@uỳ chọn 1,tuỳ chọn 2,...,tuỳ chọn n. Trong đó regex_filter là viết tắt của 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). options_1 thành options_n là viết tắt của các tuỳ chọn dòng lệnh tuỳ ý. Nếu một tuỳ chọn có chứa dấu phẩy, thì nó phải được đặt cùng với dấu gạch chéo ngược. Các tuỳ chọn có thể chứa @. Chỉ dùng @ đầu tiên để 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 mọi tệp cc trong //foo/ ngoại trừ bar.cc.
Thẻ: action_command_lines, affects_outputs
Đã tích luỹ --host_swiftcopt=<a string> lần sử dụng
Các tuỳ chọn bổ sung để chuyển đến swiaccounts để dùng cho các công cụ thực thi.
Thẻ: action_command_lines, affects_outputs
Mặc định của --[no]incompatible_auto_exec_groups: "false"
Khi được bật, hệ thống sẽ tự động tạo một nhóm thực thi cho mỗi chuỗi công cụ mà quy tắc sử dụng. Để làm được điều này, quy tắc cần chỉ định tham số "toolchain" (chuỗi công cụ) trên các thao tác của quy tắc. Để biết thêm thông tin, hãy tham khảo tại https://github.com/bazelbuild/bazel/issues/17134.
Thẻ: affects_outputs, incompatible_change
Mặc định của --[no]incompatible_merge_genfiles_directory: "đúng"
Nếu đúng, thư mục genfiles sẽ được gấp vào thư mục bin.
Thẻ: affects_outputs, incompatible_change
Mặc định của --[no]incompatible_use_host_features: "đúng"
Nếu đúng, hãy sử dụng --features chỉ cho cấu hình mục tiêu và --host_features cho cấu hình exec.
Thẻ: changes_inputs, affects_outputs, incompatible_change
Mặc định của --[no]instrument_test_targets: "false"
Khi bật mức độ sử dụng, hãy chỉ định xem có cần xem xét các quy tắc kiểm thử đo lường hay không. Khi được đặt, các quy tắc kiểm thử có trong --Instrumentation_filter 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 khả năng đo lường mức độ sử dụng.
Thẻ: affects_outputs
Mặc định của --instrumentation_filter=<a comma-separated list of regex expressions with prefix '-' specifying excluded paths>: "-/javatests[/:],-/test/java[/:]"
Khi bạn bật mức độ phù hợp, chỉ những quy tắc có tên có trong bộ lọc dựa trên biểu thức chính quy được chỉ định mới được đo lường. Thay vào đó, các quy tắc có tiền tố '-' 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ật --Instrument_test_targets.
Thẻ: affects_outputs
Mặc định của --ios_minimum_os=<a dotted version (for example '2.3' or '3.3alpha2.4')>: 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
Đã tích luỹ --ios_multi_cpus=<comma-separated list of options> lần sử dụng
Danh sách kiến trúc được phân tách bằng dấu phẩy để tạo ứng dụng ios. Kết quả là một tệp nhị phân chung chứa tất cả cấu trúc được chỉ định.
Thẻ: loses_incremental_state, loading_and_analysis
Mặc định của --[no]legacy_whole_archive: "đúng"
Không dùng nữa, thay thế bằng --incompatible_remove_legacy_wiling_ lưu (xem https://github.com/bazelbuild/bazel/issues/7362 để biết thông tin chi tiết). Khi bật, hãy sử dụng --w Nhà lưu trữ cho các quy tắc cc_binary có linkshared=True và linkstatic=True hoặc '-static' trong linkopts. Thao tác này chỉ dành cho khả năng tương thích ngược. Một cách khác hay hơn là sử dụng Alwayslink=1 nếu cần.
Thẻ: action_command_lines, affects_outputs, deprecated
Đã tích luỹ --linkopt=<a string> lần sử dụng
Tuỳ chọn bổ sung để chuyển đến gcc khi liên kết.
Thẻ: action_command_lines, affects_outputs
Đã tích luỹ --ltobackendopt=<a string> lần sử dụng
Tuỳ chọn bổ sung để chuyển đến bước phụ trợ LTO (trong phần --features=thin_lto).
Thẻ: action_command_lines, affects_outputs
Đã tích luỹ --ltoindexopt=<a string> lần sử dụng
Tuỳ chọn bổ sung để chuyển đến bước lập chỉ mục LTO (trong phần --features=thin_lto).
Thẻ: action_command_lines, affects_outputs
Đã tích luỹ --macos_cpus=<comma-separated list of options> lần sử dụng
Danh sách 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
Mặc định của --macos_minimum_os=<a dotted version (for example '2.3' or '3.3alpha2.4')>: xem nội dung mô tả
Phiên bản macOS tương thích tối thiểu cho mục tiêu. Nếu không chỉ định, hãy sử dụng "macos_sdk_version".
Thẻ: loses_incremental_state
Mặc định của --memprof_profile=<a build target label>: xem nội dung mô tả
Sử dụng hồ sơ memprof.
Thẻ: affects_outputs
Mặc định của --[no]objc_debug_with_GLIBCXX: "false"
Nếu bạn đặt chế độ này và chế độ biên dịch được đặt thành "dbg", hãy xác định GLIBCXX_DEBUG, GLIBCXX_DEBUG_PEDANTIC và GLIBCPP_Segment_ nỗ lực.
Thẻ: action_command_lines
Mặc định của --[no]objc_enable_binary_stripping: "false"
Liệu có nên thực hiện việc loại bỏ biểu tượng và mã cụ thể trên các tệp nhị phân được liên kết hay không. Quá trình xoá 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
Đã tích luỹ --objccopt=<a string> lần sử dụng
Các tuỳ chọn bổ sung để chuyển đến gcc khi biên dịch tệp nguồn Objective-C/C++.
Thẻ: action_command_lines
Đã tích luỹ --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> lần sử dụng
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ể chuyển tuỳ chọn này nhiều lần. Cú pháp: regex_filter@uỳ chọn 1,tuỳ chọn 2,...,tuỳ chọn n. Trong đó regex_filter là viết tắt của 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). options_1 thành options_n là viết tắt của các tuỳ chọn dòng lệnh tuỳ ý. Nếu một tuỳ chọn có chứa dấu phẩy, thì nó phải được đặt cùng với dấu gạch chéo ngược. Các tuỳ chọn có thể chứa @. Chỉ dùng @ đầu tiên để 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 mọi tệp cc trong //foo/ ngoại trừ bar.cc.
Thẻ: action_command_lines, affects_outputs
Đã tích luỹ --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> lần sử dụng
Các tuỳ chọn bổ sung để truyền có chọn lọc đến phần phụ trợ LTO (trong phần --features=thin_lto) khi biên dịch một số đối tượng phụ trợ nhất định. Bạn có thể chuyển tuỳ chọn này nhiều lần. Cú pháp: regex_filter@uỳ chọn 1,tuỳ chọn 2,...,tuỳ chọn n. Trong đó regex_filter là viết tắt của danh sách các mẫu biểu thức chính quy bao gồm và loại trừ. options_1 thành options_n là viết tắt của các tùy chọn dòng lệnh tùy ý. Nếu một tuỳ chọn có chứa dấu phẩy, thì nó phải được đặt cùng với dấu gạch chéo ngược. Các tuỳ chọn có thể chứa @. Chỉ dùng @ đầu tiên để phân tách chuỗi. Ví dụ: --per_file_ltobackendopt=//foo/.*\.o,-//foo/bar\.o@-O0 thêm tuỳ chọn dòng lệnh -O0 vào dòng lệnh phụ trợ LTO của mọi tệp trong //foo/ ngoại trừ bar.o.
Thẻ: action_command_lines, affects_outputs
Mặc định của --platform_suffix=<a string>: xem nội dung mô tả
Chỉ định một hậu tố để thêm vào thư mục cấu hình.
Thẻ: loses_incremental_state, affects_outputs, loading_and_analysis
Mặc định của --propeller_optimize=<a build target label>: xem nội dung mô tả
Sử dụng thông tin hồ sơ cánh quạt để tối ưu hoá mục tiêu bản dựng.Mỗi hồ sơ cánh quạt 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 một nhãn bản dựng phải tham chiếu đến các tệp nhập 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",) Bạn có thể phải thêm lệnh export_files vào gói tương ứng để hiển thị các tệp này cho Bazel. Bạn phải sử dụng tuỳ chọn này dưới dạng: --propeller_optimize=//a/b:propeller_profile
Thẻ: action_command_lines, affects_outputs
Mặc định của --propeller_optimize_absolute_cc_profile=<a string>: 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á cho cánh quạt.
Thẻ: affects_outputs
Mặc định của --propeller_optimize_absolute_ld_profile=<a string>: 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á cho cánh quạt.
Thẻ: affects_outputs
Mặc định của --run_under=<a prefix in front of command>: xem nội dung mô tả
Tiền tố để chèn vào trước tệp thực thi cho lệnh "test" và "run". 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ụ là: 'valgrind', 'strace', 'strace -c', 'valgrind --quiet --num-callers=20', '//package:target', '//package:target --options'.
Thẻ: action_command_lines
Mặc định của --[no]share_native_deps: "đúng"
Nếu đúng, các thư viện gốc chứa chức năng giống nhau sẽ được chia sẻ giữa các mục tiêu khác nhau
Thẻ: loading_and_analysis, affects_outputs
Mặc định của --[no]stamp: "false"
Đánh dấu tệp nhị phân kèm theo ngày, tên người dùng, tên máy chủ, thông tin không gian làm việc, v.v.
Thẻ: affects_outputs
Mặc định của --strip=<always, sometimes or never>: "thỉnh thoảng"
Chỉ định xem có loại bỏ các tệp nhị phân và thư viện dùng chung hay không (bằng cách sử dụng "-Wl,--strip-debug"). Giá trị mặc định của "đôi khi" có nghĩa là loại bỏ iff --compilation_mode=fastbuild.
Thẻ: affects_outputs
Đã tích luỹ --stripopt=<a string> lần sử dụng
Các tuỳ chọn bổ sung cần truyền để xoá khi tạo tệp nhị phân "<name>.stripped".
Thẻ: action_command_lines, affects_outputs
Đã tích luỹ --swiftcopt=<a string> lần sử dụng
Các tuỳ chọn bổ sung để chuyển đến quá trình biên dịch Swift.
Thẻ: action_command_lines
Đã tích luỹ --tvos_cpus=<comma-separated list of options> lần sử dụng
Danh sách kiến trúc được phân tách bằng dấu phẩy cần tạo tệp nhị phân tvOS của Apple.
Thẻ: loses_incremental_state, loading_and_analysis
Mặc định của --tvos_minimum_os=<a dotted version (for example '2.3' or '3.3alpha2.4')>: xem nội dung mô tả
Phiên bản tvOS 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 "tvos_sdk_version".
Thẻ: loses_incremental_state
Đã tích luỹ --visionos_cpus=<comma-separated list of options> lần sử dụng
Danh sách được phân tách bằng dấu phẩy gồm các kiến trúc để tạo tệp nhị phân ApplevisionOS.
Thẻ: loses_incremental_state, loading_and_analysis
Đã tích luỹ --watchos_cpus=<comma-separated list of options> lần sử dụng
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
Mặc định của --watchos_minimum_os=<a dotted version (for example '2.3' or '3.3alpha2.4')>: xem nội dung mô tả
Phiên bản watchOS 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 "watchos_sdk_version".
Thẻ: loses_incremental_state
Mặc định của --xbinary_fdo=<a build target label>: 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ơ 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, thì các tuỳ chọn đó sẽ luôn được ưu tiên như thể xbinary_fdo không được chỉ định.
Thẻ: affects_outputs
Các tuỳ chọn ảnh hưởng đến mức độ nghiêm ngặt của Bazel thực thi các đầu vào hợp lệ của bản dựng (định nghĩa quy tắc, tổ hợp cờ, v.v.):
Mặc định của --auto_cpu_environment_group=<a build target label>: ""
Khai báo Environmental_group để tự động ánh xạ các giá trị cpu đến giá trị target_environment.
Thẻ: changes_inputs, loading_and_analysis, experimental
Mặc định của --[no]check_licenses: "false"
Kiểm tra để đảm bảo rằng những quy tắc ràng buộc về việc cấp 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 xây dựng. Theo mặc định, giấy phép sẽ không được chọn.
Thẻ: build_file_semantics
Mặc định của --[no]check_visibility: "đúng"
Nếu bạn tắt chính sách này, các lỗi về chế độ hiển thị trong các phần phụ thuộc mục tiêu sẽ bị giảm hạng xuống cảnh báo.
Thẻ: build_file_semantics
Mặc định của --[no]desugar_for_android: "đúng"
Liệu có nên đơ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
Mặc định của --[no]desugar_java8_libs: "false"
Liệu có nên đưa thư viện Java 8 được hỗ trợ vào ứng dụng dành cho thiết bị cũ hay không.
Thẻ: affects_outputs, loading_and_analysis, loses_incremental_state, experimental
Mặc định của --[no]enforce_constraints: "đúng"
Kiểm tra các môi trường tương thích với từng mục tiêu và báo cáo lỗi nếu có mục tiêu có các phần phụ thuộc không hỗ trợ cùng một môi trường
Thẻ: build_file_semantics
Mặc định của --[no]experimental_check_desugar_deps: "đúng"
Xem có nên kiểm tra kỹ quá trình đơn giản hoá chính xác ở cấp độ tệp nhị phân của Android hay không.
Thẻ: eagerness_to_exit, loading_and_analysis, experimental
Mặc định của --experimental_import_deps_checking=<off, warning or error>: "TẮT"
Khi được bật, hãy kiểm tra xem các phần phụ thuộc của một aar_import đã hoàn tất hay chưa. Thao tác thực thi này có thể phá vỡ bản dựng hoặc có thể chỉ dẫn đến cảnh báo.
Thẻ: loading_and_analysis
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 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
Mặc định của --[no]incompatible_check_testonly_for_output_files: "false"
Nếu được bật, hãy chỉ kiểm tra các mục tiêu tiên quyết là tệp đầu ra bằng cách chỉ tra cứu kiểm thử của quy tắc tạo. Điều này phù hợp với việc kiểm tra chế độ hiển thị.
Thẻ: build_file_semantics, incompatible_change
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 sẽ áp dụng cho các hoạt động triển khai chuỗi công cụ.
Thẻ: build_file_semantics, incompatible_change
Mặc định của --[no]incompatible_disable_native_android_rules: "false"
Nếu bạn bật chính sách này, thì chế độ sử dụng trực tiếp các quy tắc gốc của Android sẽ bị tắt. Vui lòng sử dụng quy tắc Android Starlark từ https://github.com/bazelbuild/rules_android
Các thẻ: eagerness_to_exit, incompatible_change
Mặc định của --[no]incompatible_disable_native_apple_binary_rule: "false"
Không hoạt động. Hãy giữ lại ở đây để có khả năng tương thích ngược.
Thẻ: eagerness_to_exit, incompatible_change
Mặc định của --[no]incompatible_python_disable_py2: "đúng"
Nếu đúng, việc sử dụng chế độ cài đặt Python 2 sẽ gây ra lỗi. Điều này bao gồm python_version=PY2, srcs_version=PY2 và srcs_version=PY2ONLY. Hãy tham khảo tại https://github.com/bazelbuild/bazel/issues/15684 để biết thêm thông tin.
Thẻ: loading_and_analysis, incompatible_change
Mặc định của --[no]incompatible_validate_top_level_header_inclusions: "đúng"
Nếu đúng, Bazel cũng sẽ xác thực việc đưa vào tiêu đề thư mục cấp cao nhất (xem https://github.com/bazelbuild/bazel/issues/10047 để biết thêm thông tin).
Thẻ: loading_and_analysis, incompatible_change
Mặc định của --python_native_rules_allowlist=<a build target label>: 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
Mặc định của --[no]strict_filesets: "false"
Nếu bạn bật tuỳ chọn này, thì các tập hợp tệp vượt qua ranh giới gói sẽ được báo cáo là lỗi.
Thẻ: build_file_semantics, eagerness_to_exit
Mặc định của --strict_proto_deps=<off, warn, error, strict or default>: "lỗi"
Trừ phi TẮT, hãy kiểm tra để đảm bảo 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 trực tiếp dưới dạng phần phụ thuộc.
Thẻ: build_file_semantics, eagerness_to_exit, incompatible_change
Mặc định của --strict_public_imports=<off, warn, error, strict or default>: "tắt"
Trừ phi TẮT, hãy kiểm tra để đảm bảo mục tiêu proto_library khai báo rõ ràng tất cả các mục tiêu được dùng trong phần "nhập công khai" là đã xuất.
Thẻ: build_file_semantics, eagerness_to_exit, incompatible_change
Mặc định của --[no]strict_system_includes: "false"
Nếu đúng, các tiêu đề tìm thấy qua hệ thống bao gồm các đường dẫn (-isystem) cũng phải khai báo.
Thẻ: loading_and_analysis, eagerness_to_exit
Đã tích luỹ --target_environment=<a build target label> lần sử dụng
Khai báo môi trường mục tiêu của bản dựng này. Phải là giá trị tham chiếu nhãn đến quy tắc "môi trường". Nếu được chỉ định, tất cả cá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 bản dựng:
Mặc định của --apk_signing_method=<v1, v2, v1_v2 or v4>: "v1_v2"
Cách triển khai để dùng để ký tệp APK
Các thẻ: action_command_lines, affects_outputs, loading_and_analysis
Mặc định của --[no]device_debug_entitlements: "đúng"
Nếu bạn đặt chính sách này và chế độ biên dịch không phải là "chọn", thì các ứng dụng objc sẽ bao gồm các quyền gỡ lỗi khi ký.
Thẻ: changes_inputs
Mặc định của --ios_signing_cert_name=<a string>: xem nội dung mô tả
Tên chứng chỉ dùng cho hoạt động ký iOS. Nếu bạn không đặt chính sách này, 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 mã ký mã (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 có thể truy cập vào tệp BUILD, tệp .bzl hoặc tệp WORKSPACE.:
Mặc định của --[no]incompatible_disallow_legacy_py_provider: "đúng"
Không hoạt động, sẽ sớm bị xoá.
Thẻ: loading_and_analysis, incompatible_change
Mặc định của --[no]incompatible_disallow_sdk_frameworks_attributes: "false"
Nếu đúng, hãy không cho phép các thuộc tính sdk_frameworks và weak_sdk_frameworks trong objc_library andobjc_import.
Thẻ: build_file_semantics, incompatible_change
Nếu đúng, đặt giá trị mặc định là true cho các thuộc tính luôn liên kết trong objc_library và objc_import.
Thẻ: build_file_semantics, incompatible_change
Mặc định của --[no]incompatible_python_disallow_native_rules: "false"
Khi đúng, lỗi sẽ xảy ra khi sử dụng quy tắc py_* tích hợp; thay vào đó, bạn nên sử dụng quy tắc Rule_python. Hãy truy cập 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 chi phối hành vi của môi trường kiểm thử hoặc trình chạy kiểm thử:
Mặc định của --[no]allow_analysis_failures: "false"
Nếu đúng, lỗi phân tích của mục tiêu quy tắc sẽ dẫn đến việc mục tiêu truyền tải một thực thể của AnalysisFailureInfo có chứa nội dung mô tả lỗi, thay vì 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ó lượt 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 liên quan đến quy tắc.
Thẻ: loading_and_analysis
Mặc định của --[no]break_build_on_parallel_dex2oat_failure: "false"
Nếu các thao tác dex2oat thực sự không thành công sẽ khiến bản dựng bị hỏng thay vì thực thi dex2oat trong thời gian chạy kiểm thử.
Thẻ: loading_and_analysis, experimental
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
Mặc định của --[no]ios_memleaks: "false"
Bật tính năng kiểm tra rò rỉ bộ nhớ trong mục tiêu ios_test.
Thẻ: action_command_lines
Mặc định của --ios_simulator_device=<a string>: xem nội dung mô tả
Thiết bị để mô phỏng khi chạy một ứng dụng iOS trong trình mô phỏng, ví dụ như "iPhone 6". Bạn có thể lấy danh sách thiết bị bằng cách chạy "xcrun simctl list devicetypes" trên máy mà trình mô phỏng sẽ chạy.
Thẻ: test_runner
Mặc định của --ios_simulator_version=<a dotted version (for example '2.3' or '3.3alpha2.4')>: 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ử. Hành động này sẽ bị bỏ qua đối với quy tắc ios_test nếu thiết bị mục tiêu được chỉ định trong quy tắc.
Thẻ: test_runner
Đã tích luỹ --runs_per_test=<a positive integer or test_regex@runs. This flag may be passed more than once> lần sử dụng
Chỉ định số lần chạy mỗi lượt kiểm thử. Nếu có 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ộ quy trình kiểm thử sẽ bị 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ả bài kiểm thử 3 lần. Cú pháp thay thế: regex_filter@runs_per_test. Trong đó run_per_test là viết tắt của một giá trị số nguyên còn regex_filter là viết tắt của 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 lượt kiểm thử trong //foo/ ngoại trừ những chương trình kiểm thử trong foo/bar ba lần. Bạn có thể chuyển tuỳ chọn này nhiều lần. Đối số được truyền gần đây nhất mà các kết quả trùng khớp sẽ được ưu tiên. Nếu không có kết quả nào phù hợp, kiểm thử sẽ chỉ chạy một lần.
Đã tích luỹ --test_env=<a 'name=value' assignment with an optional value part> lần sử dụng
Chỉ định các biến môi trường bổ sung để đưa vào môi trường chạy kiểm thử. Bạn có thể chỉ định biến theo tên, trong trường hợp đó, giá trị của biến sẽ được đọc từ môi trường máy khách Bazel hoặc bằng cặp tên=giá trị. Bạn có thể sử dụng lựa chọn này nhiều lần để chỉ định nhiều biến. Chỉ được sử dụng bằng lệnh "bazel test" (kiểm thử bazel).
Thẻ: test_runner
Mặc định của --test_timeout=<a single integer or comma-separated list of 4 integers>: "-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 duy nhất, giá trị này 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 ngắn, trung bình, dài và vĩnh viễn (theo thứ tự đó). Dù ở dạng nào, giá trị -1 sẽ yêu cầu blaze sử dụng thời gian chờ mặc định cho danh mục đó.
Mặc định của --[no]zip_undeclared_test_outputs: "đúng"
Nếu đúng, các kết quả kiểm thử không được khai báo sẽ được lưu trữ trong tệp zip.
Thẻ: test_runner
Các tuỳ chọn liên quan đến dữ liệu đầu ra của truy vấn và ngữ nghĩa:
Giá trị mặc định của --aspect_deps=<off, conservative or precise>: "thận trọng"
Cách giải quyết các phần phụ thuộc khung hình khi định dạng đầu ra là {xml,proto,record}. "tắt" có nghĩa là không có phần phụ thuộc khung hình nào được phân giải, "bảo toàn" (mặc định) có nghĩa là tất cả các phần phụ thuộc khung hình đã khai báo đều được thêm vào bất kể các phần phụ thuộc đó 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ỉ các khía cạnh có thể đang hoạt động dựa trên lớp quy tắc của phần phụ thuộc trực tiếp. 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 đó khiến nó chậm hơn so với các chế độ khác. Cũng 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 được chạy trong "truy vấn bazel".
Thẻ: build_file_semantics
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ể là do hàm <code>str</code> Starlark áp dụng cho thực thể <code>Label</code>. Điều này rất hữu ích cho các công cụ cần khớp với kết quả của nhiều lệnh truy vấn và/hoặc nhãn do quy tắc đưa ra. Nếu không được bật, các trình định dạng đầu ra sẽ tự do phát ra tên kho lưu trữ rõ ràng (tương ứng với kho lưu trữ chính) để giúp kết quả dễ đọc hơn.
Thẻ: terminal_output
Mặc định của --[no]graph:factored: "đúng"
Nếu đúng, thì biểu đồ sẽ được phát ra "đã được tính thành phần", tức là các nút tương đương về mặt cấu trúc liên kết sẽ được hợp nhất với nhau và các nhãn của chúng được nối với nhau. Tuỳ chọn này chỉ áp dụng cho --output=map.
Thẻ: terminal_output
Mặc định của --graph:node_limit=<an integer>: "512"
Độ dài tối đa của chuỗi nhãn cho một nút biểu đồ trong đầu ra. Các nhãn dài hơn sẽ bị cắt bớt; -1 có nghĩa là không bị cắt bớt. Tuỳ chọn này chỉ áp dụng cho --output=map.
Thẻ: terminal_output
Mặc định của --[no]implicit_deps: "đúng"
Nếu được bật, các phần phụ thuộc ngầm ẩn 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 thêm bởi bazel. Đối với cquery, tuỳ chọn này kiểm soát việc lọc các chuỗi công cụ đã được phân giải.
Thẻ: build_file_semantics
Mặc định của --[no]include_aspects: "đúng"
aquery, cquery: liệu có bao gồm các hành động do khía cạnh tạo ra trong kết quả không. query: no-op (các khía cạnh luôn được tuân theo).
Thẻ: terminal_output
Mặc định của --[no]incompatible_package_group_includes_double_slash: "đúng"
Nếu bạn bật chế độ này, khi xuất thuộc tính "packages" của package_group, thuộc tính "//" ở đầu sẽ không bị bỏ qua.
Thẻ: terminal_output, incompatible_change
Mặc định của --[no]infer_universe_scope: "false"
Nếu bạn không đặt và --universe_scope, thì giá trị của --universe_scope sẽ được suy luận dưới dạng danh sách các mẫu mục tiêu duy nhất trong biểu thức truy vấn. Lưu ý rằng giá trị --universe_scope được suy luận cho biểu thức truy vấn sử dụng các hàm trong phạm vi toàn bộ (ví dụ:`allrdeps`) có thể không phải là điều bạn muốn, vì vậy, bạn chỉ nên sử dụng tùy chọn này nếu biết mình đang làm gì. Hãy tham khảo tại 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 tùy chọn này sẽ bị bỏ qua. Lưu ý: lựa chọn này chỉ áp dụng cho "truy vấn" (tức là không áp dụng cho "cquery").
Thẻ: loading_and_analysis
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
Mặc định của --[no]nodep_deps: "đúng"
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 nơi truy vấn hoạt động. Một ví dụ phổ biến về thuộc tính "nodep" là "khả năng hiển thị". Chạy và phân tích cú pháp kết quả của "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
Mặc định của --output=<a string>: "label"
Định dạng in kết quả cquery. Các giá trị được cho phép cho cquery là: label, label_ hại, textproto, chuyển đổi, proto, stream_proto, jsonproto. Nếu chọn 'transitions', bạn cũng phải chỉ định tuỳ chọn --transitions=(lite|full).
Thẻ: terminal_output
Mặc định của --[no]proto:default_values: "đúng"
Nếu đúng thì các thuộc tính có giá trị không được chỉ định rõ trong tệp BUILD sẽ được bao gồm; nếu không thì các thuộc tính này sẽ bị bỏ qua. Tuỳ chọn này áp dụng cho --output=proto
Thẻ: terminal_output
Mặc định của --[no]proto:definition_stack: "false"
Điền trường proto manifest_stack. Trường này ghi lại từng thực thể quy tắc cho 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
Mặc định của --[no]proto:flatten_selects: "đúng"
Nếu bạn bật chính sách này, các thuộc tính có thể định cấu hình do Select() tạo ra sẽ được làm phẳng. Đối với loại danh sách, cách biểu diễn đã làm phẳng là danh sách chứa từng giá trị của bản đồ chọn đúng một lần. Các loại vô hướng được làm phẳng thành giá trị rỗng.
Thẻ: build_file_semantics
Mặc định của --[no]proto:include_attribute_source_aspects: "false"
Điền trường proto source_aspect_name của mỗi Thuộc tính bằng khía cạnh nguồn của thuộc tính (chuỗi trống nếu không phải là chuỗi).
Thẻ: terminal_output
Mặc định của --[no]proto:include_configurations: "đúng"
nếu được bật, đầu ra proto sẽ bao gồm thông tin về các cấu hình. Khi bị tắt,định dạng đầu ra proto cquery sẽ giống với định dạng đầu ra của truy vấn.
Thẻ: affects_outputs
Mặc định của --[no]proto:include_synthetic_attribute_hash: "false"
Liệu có nên tính toán và điền thuộc tính $internal_attr_hash hay không.
Thẻ: terminal_output
Mặc định của --[no]proto:instantiation_stack: "false"
Điền ngăn xếp lệnh gọi tạo thực thể của từng quy tắc. Lưu ý rằng điều này yêu cầu ngăn xếp phải hiển thị
Thẻ: terminal_output
Mặc định của --[no]proto:locations: "đúng"
Liệu có xuất thông tin vị trí ở đầu ra proto hay không.
Thẻ: terminal_output
Mặc định của --proto:output_rule_attrs=<comma-separated list of options>: "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 kết quả. Giá trị mặc định là tất cả thuộc tính. Đặt thành chuỗi trống để không xuất bất kỳ thuộc tính nào. Tuỳ chọn này có thể áp dụng cho --output=proto.
Thẻ: terminal_output
Mặc định của --[no]proto:rule_inputs_and_outputs: "đúng"
Liệu có nên điền các trường Rule_input và Rule_output hay không.
Thẻ: terminal_output
Mặc định của --query_file=<a string>: ""
Nếu bạn đặt chính sách này, truy vấn sẽ đọc truy vấn từ tệp có tên ở đây, thay vì trên dòng lệnh. Sẽ xảy ra lỗi khi chỉ định tệp tại đây cũng như truy vấn dòng lệnh.
Thẻ: changes_inputs
Mặc định của --[no]relative_locations: "false"
Nếu đúng, vị trí của các tệp BUILD trong xml và kết quả proto sẽ là tương đối. Theo mặc định, dữ liệu vị trí đầu ra 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 true để có kết quả nhất quán trên các máy.
Thẻ: terminal_output
Mặc định của --show_config_fragments=<off, direct or transitive>: "tắt"
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 quy tắc đó. Điều này có thể hữu ích cho việc đánh giá mức độ cắt giảm một biểu đồ mục tiêu đã định cấu hình.
Thẻ: affects_outputs
Mặc định của --starlark:expr=<a string>: ""
Một biểu thức Starlark để định dạng từng mục tiêu đã định cấu hình trong chế độ --output=starlark của cquery. Mục tiêu đã định cấu hình được liên kết với "mục tiêu". Nếu bạn không chỉ định --starlark:expr hoặc --starlark:file, thì tuỳ chọn này sẽ được đặt mặc định thành 'str(target.label)'. Sẽ xảy ra lỗi khi chỉ định cả --starlark:expr và --starlark:file.
Thẻ: terminal_output
Mặc định của --starlark:file=<a string>: ""
Tên của tệp xác định hàm Starlark có tên là "format" (định dạng) của một đối số. Hàm này được áp dụng cho từng mục tiêu được định cấu hình để định dạng mục tiêu đó dưới dạng chuỗi. Sẽ xảy ra lỗi khi chỉ định cả --starlark:expr và --starlark:file. Xem trợ giúp về --output=starlark để biết thêm chi tiết.
Thẻ: terminal_output
Mặc định của --[no]tool_deps: "đúng"
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 qua đó. Cạnh phụ thuộc "exec configuration" (Cấu hình thực thi) (chẳng hạn như cạnh từ quy tắc "proto_library" bất kỳ đến Protocol Compiler (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 tạo bản dựng thay vì một phần của cùng một chương trình "target" (mục tiêu). Cquery: Nếu bị tắt, hãy 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 được đị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ó 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, chỉ các mục tiêu đã định cấu hình thực thi mới được trả về. Tuỳ chọn này sẽ KHÔNG loại trừ các chuỗi công cụ đã được phân giải.
Thẻ: build_file_semantics
Mặc định của --transitions=<full, lite or none>: "không có"
Định dạng mà cquery sẽ in thông tin chuyển đổi.
Thẻ: affects_outputs
Mặc định của --universe_scope=<comma-separated list of options>: ""
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 (cộng và trừ). Truy vấn có thể được thực hiện trong vũ trụ được xác định bằng việc đóng bắc cầu 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à mục tiêu mà tất cả câu trả lời đều được tạo và do đó, tuỳ chọn này có thể ảnh hưởng đến cấu hình và chuyển đổi. Nếu bạn không chỉ định tuỳ chọn này, thì mục tiêu cấp cao nhất được giả định là 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ị hỏng nếu không thể tạo mục tiêu được phân tích cú pháp từ biểu thức truy vấn với 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:
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
Mặc định của --[no]experimental_inmemory_dotd_files: "đúng"
Nếu được bật, các tệp C++ .d sẽ được chuyển trực tiếp từ các nút bản dựng từ xa vào bộ nhớ thay vì được ghi vào ổ đĩa.
Thẻ: loading_and_analysis, execution, affects_outputs, experimental
Mặc định của --[no]experimental_inmemory_jdeps_files: "đúng"
Nếu bạn bật tuỳ chọn này, các tệp phần phụ thuộc (.jdeps) được tạo qua quá trình biên dịch Java sẽ được chuyển trực tiếp từ các nút bản dựng từ xa vào bộ nhớ thay vì được ghi vào ổ đĩa.
Thẻ: loading_and_analysis, execution, affects_outputs, experimental
Mặc định của --[no]experimental_objc_include_scanning: "false"
Liệu có nên thực hiện quét để tìm C/C++ mục tiêu hay không.
Thẻ: loading_and_analysis, execution, changes_inputs
Mặc định của --[no]experimental_retain_test_configuration_across_testonly: "false"
Khi được bật, --trim_test_configure sẽ không cắt bỏ cấu hình kiểm thử cho các quy tắc được đánh dấu là testonly=1. Việc này nhằm giảm các vấn đề xung đột hành động khi các quy tắc không kiểm thử phụ thuộc vào quy tắc cc_test. Không có ảnh hưởng gì nếu --trim_test_Configuration sai.
Thẻ: loading_and_analysis, loses_incremental_state
Mặc định của --[no]experimental_starlark_cc_import: "false"
Nếu bật, bạn có thể sử dụng phiên bản cc_import của Starlark.
Thẻ: loading_and_analysis, experimental
Mặc định của --[no]experimental_unsupported_and_brittle_include_scanning: "false"
Liệu có nên thu hẹp đầu vào trong quá trình biên dịch C/C++ hay không bằng cách phân tích cú pháp các dòng #include từ tệp đầu vào. Điều này có thể cải thiện hiệu suất và mức độ gia tăng bằng cách giảm kích thước của các cây đầu vào biên dịch. Tuy nhiên, nó 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 tiền xử lý C. Cụ thể, thuộc tính này không hiểu các lệnh động #include và bỏ qua logic có điều kiện của bộ tiền xử lý. Bạn tự chịu rủi ro khi sử dụng. Mọi vấn đề liên quan đến cờ này đã gửi đều sẽ bị đóng.
Thẻ: loading_and_analysis, execution, changes_inputs
Mặc định của --[no]incremental_dexing: "đúng"
Phần lớn công việc tạo tệp dex là riêng biệt cho từng tệp Jar.
Thẻ: affects_outputs, loading_and_analysis, loses_incremental_state
Mặc định của --[no]objc_use_dotd_pruning: "đúng"
Nếu được đặt, tệp .d do clang tạo ra sẽ được dùng để cắt giảm tập hợp dữ liệu đầu vào được chuyển vào các quá trình biên dịch objc.
Thẻ: changes_inputs, loading_and_analysis
Mặc định của --[no]process_headers_in_dependencies: "false"
Khi tạo //a:a mục tiêu, hãy xử lý tiêu đề ở mọi mục tiêu mà //a:a phụ thuộc (nếu chuỗi công cụ có bật tính năng xử lý tiêu đề).
Thẻ: execution
Mặc định của --[no]trim_test_configuration: "đúng"
Khi được bật, các tuỳ chọn liên quan đến kiểm thử sẽ bị xoá dưới cấp cao nhất của bản dựng. Khi cờ này hoạt động, bạn không thể tạo thử nghiệm dưới dạng phần phụ thuộc của quy tắc không kiểm thử. Tuy nhiên, các thay đổi đối với lựa chọn liên quan đến thử nghiệm sẽ không khiến các quy tắc không 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 độ chi tiết, định dạng hoặc vị trí ghi nhật ký:
Mặc định của --toolchain_resolution_debug=<a comma-separated list of regex expressions with prefix '-' specifying excluded paths>: "-.*"
In thông tin gỡ lỗi trong quá trình phân giải chuỗi công cụ. Cờ này sẽ lấy một biểu thức chính quy để 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 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 chọn 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ề giải pháp chuỗi công cụ.
Thẻ: terminal_output
Tuỳ chọn chỉ định hoặc thay đổi dữ liệu đầu vào chung thành lệnh Bazel không thuộc các danh mục khác.:
Đã tích luỹ --flag_alias=<a 'name=value' flag alias> lần sử dụng
Đặt tên viết tắt cho cờ Starlark. Hàm này sẽ lấy một cặp khoá-giá trị duy nhất có dạng "<key>=<value>" làm đối số.
Thẻ: changes_inputs
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 nữa. Chính xác, khi một mục tiêu py_binary hoặc py_test đã được đặt giá trị cũ là "auto" (giá trị mặc định), thì mục tiêu đó sẽ được coi là sai khi và chỉ khi bạn đặt cờ này. Xem https://github.com/bazelbuild/bazel/issues/10076.
Thẻ: affects_outputs, incompatible_change
Mặc định của --[no]incompatible_py2_outputs_are_suffixed: "đúng"
Nếu đúng, các mục tiêu được tạo trong cấu hình Python 2 sẽ xuất hiện bên dưới một gốc đầu ra có chứa hậu tố "-py2", trong khi các mục tiêu được tạo cho Python 3 sẽ xuất hiện trong một 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".
Các thẻ: affects_outputs, incompatible_change
Mặc định của --[no]incompatible_py3_is_default: "đúng"
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".
Các thẻ: loading_and_analysis, affects_outputs, incompatible_change
Mặc định của --[no]incompatible_use_python_toolchains: "đúng"
Nếu bạn đặt chính sách này thành true, các quy tắc Python gốc có thể thực thi sẽ sử dụng thời gian chạy Python do chuỗi công cụ Python chỉ định, thay vì thời gian chạy do các cờ cũ như --python_top cung cấp.
Thẻ: loading_and_analysis, incompatible_change
Mặc định của --python_version=<PY2 or PY3>: xem nội dung mô tả
Chế độ phiên bản lớn của Python, "PY2" hoặc "PY3". Xin lưu ý rằng giá trị này sẽ bị các mục tiêu "py_binary" và "py_test" ghi đè (ngay cả khi chúng không chỉ định rõ phiên bản) vì vậy, thường không có nhiều lý do để cung cấp cờ này.
Thẻ: loading_and_analysis, affects_outputs
Các lựa 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 "auto", Bazel sẽ chạy lại kiểm thử khi 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ử không thành công trước đó. Nếu bạn đặt chính sách này thành "có", Bazel sẽ lưu mọi kết quả kiểm tra vào bộ nhớ đệm, ngoại trừ các thử nghiệm được đánh dấu là bên ngoài. Nếu bạn đặt chính sách này thành "no", Bazel sẽ không lưu kết quả thử nghiệm vào bộ nhớ đệm.
Mặc định của --[no]experimental_cancel_concurrent_tests: "false"
Nếu đúng, thì Blaze sẽ huỷ đồng thời chạy kiểm thử trong lần chạy thành công đầu tiên. Tính năng này chỉ hữu ích khi kết hợp với --runs_per_test_detects_flakes.
Thẻ: affects_outputs, loading_and_analysis
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 về mức độ sử dụng cho mỗi kiểm thử trong một lần chạy mức độ sử dụng.
Thẻ: affects_outputs, loading_and_analysis
Mặc định của --[no]experimental_generate_llvm_lcov: "false"
Nếu đúng, mức độ phù hợp của tiếng lóng sẽ tạo báo cáo LCOV.
Thẻ: affects_outputs, loading_and_analysis
Mặc định của --[no]experimental_j2objc_header_map: "đúng"
Liệu có tạo bản đồ tiêu đề J2ObjC song song với quá trình dịch nội dung J2ObjC hay không.
Mặc định của --[no]experimental_j2objc_shorter_header_path: "false"
Liệu có nên 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
Giá trị mặc định của --experimental_java_classpath=<off, javabuilder or bazel>: "javabuilder"
Bật đường dẫn lớp rút gọn cho quá trình biên dịch Java.
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 cho các thư viện tương thích với Android.
Thẻ: affects_outputs
Mặc định của --[no]experimental_run_android_lint_on_java_rules: "false"
Liệu có cần xác thực các nguồn java_* hay không.
Thẻ: affects_outputs
Mặc định của --[no]explicit_java_test_deps: "false"
Chỉ định rõ ràng phần phụ thuộc vào JUnit hoặc Hamcrest trong java_test thay vì vô tình lấy từ các phần phụ thuộc của TestRunner. Hiện chỉ dùng được cho bazel.
Mặc định của --host_java_launcher=<a build target label>: xem nội dung mô tả
Trình chạy Java mà các công cụ được thực thi trong một bản dựng sử dụng.
Đã tích luỹ --host_javacopt=<a string> lần sử dụng
Các tuỳ chọn bổ sung để chuyển sang javac khi tạo các công cụ được thực thi trong một bản dựng.
Đã tích luỹ --host_jvmopt=<a string> lần sử dụng
Các tuỳ chọn bổ sung được truyền đến máy ảo Java khi tạo các công cụ được thực thi trong quá trình tạo bản dựng. Những tuỳ chọn này sẽ được thêm vào các tuỳ chọn khởi động máy ảo của từng mục tiêu java_binary.
Mặc định của --[no]incompatible_check_sharding_support: "đúng"
Nếu đúng, Bazel sẽ không vượt qua kiểm thử phân đoạn nếu trình chạy kiểm thử không cho biết có 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ợ tính năng phân đoạn sẽ dẫn đến tất cả chương trình kiểm thử chạy trong từng phân đoạn.
Thẻ: incompatible_change
Mặc định của --[no]incompatible_exclusive_test_sandboxed: "đúng"
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 thử nghiệm độc quyền trên máy
Thẻ: incompatible_change
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_BOOKS_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 làm như vậy có thể ngăn việc lưu vào bộ nhớ đệm giữa nhiều người dùng nếu sử dụng bộ nhớ đệm dùng chung.
Thẻ: loading_and_analysis, incompatible_change
Đã tích luỹ --j2objc_translation_flags=<comma-separated list of options> lần sử dụng
Các tuỳ chọn bổ sung để truyền đến công cụ J2ObjC.
--java_debug
Làm cho máy ảo Java của kiểm thử java phải đợi 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
Mặc định của --[no]java_deps: "đúng"
Tạo thông tin phần phụ thuộc (hiện tại là classpath thời gian biên dịch) cho mỗi mục tiêu Java.
Mặc định của --[no]java_header_compilation: "đúng"
Biên dịch ijar trực tiếp từ nguồn.
Mặc định của --java_language_version=<a string>: ""
Phiên bản ngôn ngữ Java
Mặc định của --java_launcher=<a build target label>: 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 cờ này được đặt thành chuỗi trống, thì trình chạy JDK sẽ được sử dụng. Thuộc tính "trình chạy" sẽ ghi đè cờ này.
Mặc định của --java_runtime_version=<a string>: "local_jdk"
Phiên bản thời gian chạy Java
Đã tích luỹ --javacopt=<a string> lần sử dụng
Các tuỳ chọn bổ sung để chuyển sang javac.
Đã tích luỹ --jvmopt=<a string> lần sử dụng
Các tuỳ chọn bổ sung để truyền đến máy ảo Java. Những tuỳ chọn này sẽ được thêm vào các tuỳ chọn khởi động máy ảo của từng mục tiêu java_binary.
Mặc định của --legacy_main_dex_list_generator=<a build target label>: xem nội dung mô tả
Chỉ định một tệp nhị phân cần dùng để tạo danh sách các lớp phải có trong dex chính khi biên dịch multidex cũ.
Mặc định của --optimizing_dexer=<a build target label>: xem nội dung mô tả
Chỉ định một tệp nhị phân cần dùng để tạo tệp dex mà không cần phân đoạn.
Đã tích luỹ --plugin=<a build target label> lần sử dụng
Trình bổ trợ sử dụng trong bản dựng. Hiện hoạt động với java_plugin.
Mặc định của --proguard_top=<a build target label>: xem nội dung mô tả
Chỉ định phiên bản ProGuard cần dùng để xoá mã khi tạo một tệp nhị phân Java.
Giá trị mặc định của --proto_compiler=<a build target label>: "@bazel_tools//tools/proto:protoc"
Nhãn của trình biên dịch proto.
Thẻ: affects_outputs, loading_and_analysis
Giá trị mặc định của --proto_toolchain_for_cc=<a build target label>: "@bazel_tools//tools/proto:cc_toolchain"
Nhãn của proto_lang_toolchain() mô tả cách biên dịch giao thức C++
Thẻ: affects_outputs, loading_and_analysis
Giá trị mặc định của --proto_toolchain_for_j2objc=<a build target label>: "@bazel_tools//tools/j2objc:j2objc_proto_toolchain"
Nhãn của proto_lang_toolchain() mô tả cách biên dịch j2objc protos
Các thẻ: affects_outputs, loading_and_analysis
Giá trị mặc định của --proto_toolchain_for_java=<a build target label>: "@bazel_tools//tools/proto:java_toolchain"
Nhãn của proto_lang_toolchain() mô tả cách biên dịch giao thức Java
Các thẻ: affects_outputs, loading_and_analysis
Giá trị mặc định của --proto_toolchain_for_javalite=<a build target label>: "@bazel_tools//tools/proto:javalite_toolchain"
Nhãn của proto_lang_toolchain() mô tả cách biên dịch giao thức JavaLite
Các thẻ: affects_outputs, loading_and_analysis
Đã tích luỹ --protocopt=<a string> lần sử dụng
Các tuỳ chọn bổ sung để truyền đến trình biên dịch protobuf.
Thẻ: affects_outputs
Mặc định của --[no]runs_per_test_detects_flakes: "false"
Nếu đúng, hệ thống sẽ xác định trạng thái FLAKY cho bất kỳ phân đoạn nào có ít nhất một lần chạy/lần vượt qua và có ít nhất một lần chạy/lần thử không thành công.
Mặc định của --shell_executable=<a path>: xem nội dung mô tả
Đường dẫn tuyệt đối đến shell có thể thực thi để Bazel sử dụng. Nếu bạn không đặt chính sách này nhưng biến môi trường BAZEL_SH được đặt trong lệnh gọi Bazel đầu tiên (khởi động máy chủ Bazel), thì Bazel sẽ sử dụng biến môi trường đó. Nếu bạn không đặt biểu tượng nào, 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 chạy trên đó (Windows: c:/tools/msys64/usr/bin/bash.exe, FreeBSD: /usr/local/bin/bash, tất cả các đường dẫn khác: /bin/bash). 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 cho các tệp nhị phân được tạo.
Thẻ: loading_and_analysis
Đã tích luỹ --test_arg=<a string> lần sử dụng
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ể dùng nhiều lần để chỉ định nhiều đối số. Nếu nhiều kiểm thử được thực thi, mỗi kiểm thử sẽ nhận được các đối số giống nhau. Chỉ được sử dụng bằng lệnh "bazel test" (kiểm thử bazel).
Mặc định của --test_filter=<a string>: 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 các bài kiểm thử chạy. Xin lưu ý rằng điều này không ảnh hưởng đến các mục tiêu được tạo.
Mặc định của --test_result_expiration=<an integer>: "-1"
Tuỳ chọn này không được dùng nữa và không có hiệu lực.
Mặc định của --[no]test_runner_fail_fast: "false"
Tuỳ chọn Chuyển tiếp không thành công nhanh đến trình chạy kiểm thử. Trình chạy kiểm thử phải ngừng thực thi khi không thành công đầu tiên.
Giá trị mặc định của --test_sharding_strategy=<explicit, disabled or forced=k where k is the number of shards to enforce>: "phản cảm"
Chỉ định chiến lược cho phân đoạn kiểm thử: "explicit" để chỉ sử dụng phân đoạn nếu có thuộc tính BUILD "shard_count". "disabled" (tắt) để không bao giờ sử dụng tính năng phân đoạn kiểm thử. "forced=k" thực thi phân đoạn "k" cho mục đích kiểm thử bất kể thuộc tính BUILD "shard_count".
Mặc định của --tool_java_language_version=<a string>: ""
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 xây dựng
Mặc định của --tool_java_runtime_version=<a string>: "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 xây dựng
Mặc định của --[no]use_ijars: "đúng"
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 gia tăng nhanh hơn, nhưng thông báo lỗi có thể khác.

Lựa chọn kết xuất

Các tuỳ chọn xuất hiện trước lệnh và được ứng dụng phân tích cú pháp:
Đã tích luỹ --distdir=<a path> lần sử dụng
Các nơi khác để tìm kiếm các tệp lưu trữ trước khi truy cập mạng để tải các tệp lưu trữ đó xuống.
Thẻ: bazel_internal_configuration
Nếu bạn đặt chính sách này, bộ nhớ đệm của kho lưu trữ sẽ liên kết cứng tệp đó trong trường hợp tệp bị tấn công vào bộ nhớ đệm, thay vì sao chép. Mục đích của tính năng này là tiết kiệm dung lượng ổ đĩa.
Thẻ: bazel_internal_configuration
Mặc định của --experimental_repository_downloader_retries=<an integer>: "0"
Số lần thử lại một lỗi tải xuống tối đa. Nếu bạn đặt chính sách này thành 0, thì tính năng thử lại sẽ tắt.
Thẻ: experimental
Mặc định của --experimental_scale_timeouts=<a double>: "1.0"
Điều chỉnh tỷ lệ tất cả thời gian chờ trong quy tắc lưu trữ Starlark theo hệ số này. Bằng cách này, kho lưu trữ bên ngoài có thể được tạo ra hoạt động trên các máy chậm hơn tác giả quy tắc dự kiến mà không cần thay đổi mã nguồn
Thẻ: bazel_internal_configuration, experimental
Mặc định của --http_connector_attempts=<an integer>: "8"
Số lần thử tải xuống http tối đa.
Thẻ: bazel_internal_configuration
Mặc định của --http_connector_retry_max_timeout=<An immutable length of time.>: "0 giây"
Thời gian chờ tối đa cho các lần thử tải xuống lại http. Với giá trị 0, không có thời gian chờ tối đa nào được xác định.
Thẻ: bazel_internal_configuration
Mặc định của --http_timeout_scaling=<a double>: "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ố cụ thể
Thẻ: bazel_internal_configuration
Mặc định của --repository_cache=<a path>: 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. Một chuỗi trống làm đối số yêu cầu tắt bộ nhớ đệm, nếu không, hệ thống sẽ sử dụng giá trị mặc định của '<output_user_root>/cache/repos/v1'
Thẻ: bazel_internal_configuration
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ị vô hiệu hoá hoàn toàn; ctx.exe vẫn có thể chạy một tệp thực thi tuỳ ý truy cập vào Internet.
Thẻ: bazel_internal_configuration
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 --gc_thrashing_threshold=<an integer in 0-100 range>: "100"
Tỷ lệ phần trăm không gian đã sử dụng đã sử dụng (0 – 100) trên đó 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 giá trị này thành 100, thì GcThrashingDetector sẽ tắt.
Thẻ: host_machine_resource_optimizations
Các tuỳ chọn kiểm soát kết quả của lệnh:
Mặc định của --[no]action_cache: "false"
Kết xuất nội dung trong bộ nhớ đệm của thao tác.
Thẻ: bazel_monitoring
Mặc định của --[no]packages: "false"
Kết xuất nội dung bộ nhớ đệm của gói.
Thẻ: bazel_monitoring
Mặc định của --[no]rule_classes: "false"
Kết xuất các lớp quy tắc.
Thẻ: bazel_monitoring
Mặc định của --[no]rules: "false"
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
Mặc định của --skyframe=<off, summary, count, deps or rdeps>: "tắt"
Biểu đồ kết xuất Skyframe: "off", "summary", "count", "deps" hoặc "rdeps".
Thẻ: bazel_monitoring
Mặc định của --skykey_filter=<a comma-separated list of regex expressions with prefix '-' specifying excluded paths>: ".*"
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
Mặc định của --skylark_memory=<a string>: xem nội dung mô tả
Kết xuấ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 truy cập https://github.com/google/pprof.
Thẻ: bazel_monitoring
Các tuỳ chọn liên quan đến đầu ra và ngữ nghĩa của Bzlmod:
Đã tích luỹ --allow_yanked_versions=<a string> lần sử dụng
Đã chỉ định các phiên bản mô-đun dưới dạng `<module1>@<version1>,<module2>@<version2>`. Những phiên bản này sẽ được 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 trong sổ đăng ký nơi chúng xuất phát (nếu các phiên bản đó không đến từ một NonRegistryOverride). Nếu không, các phiên bản bị giật sẽ khiến quá trình phân giải không thành công. Bạn cũng có thể xác định phiên bản được kéo mạnh được phép bằng biến môi trường "BZLMOD_ALLOW_YANKED_VERSIONS". Bạn có thể vô hiệu hoá việc kiểm tra này bằng cách sử dụng từ khoá 'all' (không được khuyến nghị).
Thẻ: loading_and_analysis
Mặc định của --check_bazel_compatibility=<error, warning or off>: "lỗi"
Kiểm tra khả năng tương thích với 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 đề lên trạng thái lỗi giải quyết, "tắt" để tắt chế độ kiểm tra, hoặc "cảnh báo" để in cảnh báo khi phát hiện thấy thông tin không khớp.
Thẻ: loading_and_analysis
Mặc định của --check_direct_dependencies=<off, warning or error>: "cảnh báo"
Kiểm tra xem các phần phụ thuộc trực tiếp "bazel_dep" được khai báo trong mô-đun gốc có giống với phiên bản bạn nhận được trong biểu đồ phần phụ thuộc đã được giải quyết hay không. Các giá trị hợp lệ là "off" ("tắt") để tắt chế độ kiểm tra, "cảnh báo" để in cảnh báo khi phát hiện thấy thông tin không khớp hoặc "error" để chuyển vấn đề lên thành lỗi giải quyết.
Thẻ: loading_and_analysis
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_secondary` trong MODULE.bazel của mô-đun gốc. Lưu ý rằng các phần phụ thuộc của 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
Mặc định của --lockfile_mode=<off, update or error>: "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 nếu có thay đổi, "error" khi dùng tệp khoá nhưng báo lỗi nếu tệp không được cập nhật, hoặc "tắt" để không đọc hoặc ghi vào tệp khoá.
Thẻ: loading_and_analysis
Đã tích luỹ --override_module=<an equals-separated mapping of module name to path> lần sử dụng
Ghi đè một mô-đun có đường dẫn cục bộ ở dạng <module name>=<path>. Nếu đường dẫn đã cho là một đường dẫn tuyệt đối, thì đường dẫn đó sẽ được sử dụng như nguyên trạng. Nếu đường dẫn đã cho là một đường dẫn tương đối, thì đường dẫn đó sẽ tương ứng với thư mục đang hoạt động hiện tại. Nếu đường dẫn đã cho bắt đầu bằng "%workspace%", thì đường dẫn đó 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 "không gian làm việc thông tin bazel")
Đã tích luỹ --registry=<a string> lần sử dụng
Chỉ định sổ đăng ký cần dùng để xác định vị trí các phần phụ thuộc của mô-đun Bazel. Thứ tự rất quan trọng: các mô-đun sẽ được tra cứu trước trong sổ đăng ký trước, và chỉ quay lại các sổ đăng ký sau khi còn thiếu trong các sổ đăng ký trước đó.
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:
Mặc định của --gc_thrashing_limits=<comma separated pairs of <period>:<count>>: "1s:2,20s:3,1m:5"
Các giới hạn mà nếu đạt đến mức này sẽ khiến GcThrashingDetector gây sự cố cho Bazel bằng OOM. Mỗi giới hạn được chỉ định dưới dạng <period>:<count>, trong đó khoảng thời gian là một khoảng thời gian và số lượng là một số nguyên dương. Nếu có hơn --gc_thrashing_threshold phần trăm không gian cần sử dụng (vùng nhớ khối xếp thế hệ cũ) vẫn chiếm sau <count> các GC đầy đủ liên tiếp trong khoảng <period>, thì OOM sẽ được kích hoạt. Bạn có thể chỉ định nhiều hạn mức và phân tách bằng dấu phẩy.
Thẻ: host_machine_resource_optimizations
Mặc định của --skyframe_high_water_mark_full_gc_drops_per_invocation=<an integer, >= 0>: "2147483647"
Gắn cờ cho cấu hình nâng cao của công cụ Skyframe nội bộ của Bazel. Nếu Bazel phát hiện thấy 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 đặt ra bằng --skyframe_high_water_mark_threshold, thì khi một sự kiện GC xảy ra đầy đủ, trạng thái Skyframe tạm thời không cần thiết sẽ bị bỏ qua, tối đa nhiều lần cho mỗi lệnh gọi. Mặc định là Integer.MAX_VALUE; không giới hạn hiệu quả. 0 có nghĩa là các sự kiện thu gom rác (GC) toàn bộ sẽ không bao giờ kích hoạt hiện tượng giảm. Nếu đạt đến giới hạn, trạng thái Skyframe sẽ không còn bị bỏ qua khi một sự kiện GC đầy đủ xảy ra và vượt quá ngưỡng tỷ lệ phần trăm vùng nhớ khối xếp được giữ lại đó.
Thẻ: host_machine_resource_optimizations
Mặc định của --skyframe_high_water_mark_minor_gc_drops_per_invocation=<an integer, >= 0>: "2147483647"
Gắn cờ cho cấu hình nâng cao của công cụ Skyframe nội bộ của Bazel. Nếu Bazel phát hiện thấy mức sử dụng tỷ lệ phần trăm vùng nhớ khối xếp được giữ lại vượt quá ngưỡng đặt ra bằng --skyframe_high_water_mark_threshold, thì khi một sự kiện GC nhỏ xảy ra, trạng thái Skyframe tạm thời không cần thiết sẽ bị bỏ qua, tối đa là nhiều lần cho mỗi lệnh gọi. Mặc định là Integer.MAX_VALUE; không giới hạn hiệu quả. 0 có nghĩa là các sự kiện GC nhỏ sẽ không bao giờ kích hoạt hiện tượng giảm. Nếu đạt đến giới hạn, trạng thái Skyframe sẽ không còn bị bỏ qua khi xảy ra một sự kiện GC nhỏ và ngưỡng tỷ lệ phần trăm vùng nhớ khối xếp được giữ lại đó đã vượt quá.
Thẻ: host_machine_resource_optimizations
Mặc định của --skyframe_high_water_mark_threshold=<an integer>: "85"
Gắn cờ cho cấu hình nâng cao của công cụ Skyframe nội bộ của Bazel. Nếu Bazel 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 ở ngưỡng này, thì Bazel sẽ bỏ trạng thái Skyframe tạm thời không cần thiết. Việc chỉnh sửa tính năng này có thể cho phép bạn giảm thiểu tác động của tình trạng này đến thời gian sử dụng GC, khi tình trạng giật GC là do việc sử dụng bộ nhớ ở trạng thái tạm thời này gây ra và (ii) tốn kém hơn so với việc khôi phục trạng thái khi cần.
Thẻ: host_machine_resource_optimizations
Các tuỳ chọn ảnh hưởng đến độ chi tiết, định dạng hoặc vị trí ghi nhật ký:
Mặc định của --[no]experimental_command_profile: "false"
Ghi lại hồ sơ CPU của Trình ghi chuyến bay Java vào tệp profile.jfr trong thư mục cơ sở đầu ra. Trong tương lai, cú pháp và ngữ nghĩa của cờ này có thể thay đổi để hỗ trợ nhiều loại hồ sơ hoặc định dạng đầu ra; bạn tự chịu rủi ro khi sử dụng.
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 thao tác ghi nhớ 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ả chức năng ghi nhớ.
Các tuỳ chọn chỉ định hoặc thay đổi dữ liệu đầu vào chung thành lệnh Bazel mà không thuộc các danh mục khác.:
Mặc định của --experimental_resolved_file_instead_of_workspace=<a string>: ""
Nếu nội dung không trống, hãy đọc tệp đã được phân giải được chỉ định thay vì tệp WORKSPACE
Các thẻ: changes_inputs
Các tuỳ chọn thực thi và lưu vào bộ nhớ đệm từ xa:
Mặc định của --experimental_downloader_config=<a string>: 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ủ (cho `allow` và `block`) hoặc hai mẫu, một mẫu để so khớp và một mẫu dùng làm URL thay thế, có tham chiếu ngược bắt đầu từ "$1". Có thể có nhiều lệnh "rewrite" cho cùng một URL và trong trường hợp này sẽ có nhiều URL được trả về.
Mặc định của --experimental_worker_for_repo_fetching=<off, platform or virtual>: "tắt"
Chế độ phân luồng dùng để tìm nạp kho lưu trữ. Nếu bạn đặt chính sách này thành "tắt", thì sẽ không có luồng worker nào được sử dụng và quá trình tìm nạp kho lưu trữ có thể khởi động lại. Ngược lại, hãy sử dụng luồng nền tảng (tức là luồng hệ điều hành) nếu được đặt thành "platform" hoặc luồng ảo nếu được đặt thành "virtual".
Các lựa chọn khác, không được phân loại.:
Đã tích luỹ --override_repository=<an equals-separated mapping of repository name to path> lần sử dụng
Ghi đè một 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à một đường dẫn tuyệt đối, thì đường dẫn đó sẽ được sử dụng nguyên vẹn. Nếu đường dẫn đã cho là một đườ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 này 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 "không gian làm việc thông tin bazel")

Tùy chọn tìm nạp

Các tuỳ chọn xuất hiện trước lệnh và được ứng dụng phân tích cú pháp:
Đã tích luỹ --distdir=<a path> lần sử dụng
Các nơi khác để tìm kiếm các tệp lưu trữ trước khi truy cập mạng để tải các tệp lưu trữ đó xuống.
Thẻ: bazel_internal_configuration
Nếu bạn đặt chính sách này, bộ nhớ đệm của kho lưu trữ sẽ liên kết cứng tệp đó trong trường hợp tệp bị tấn công vào bộ nhớ đệm, thay vì sao chép. Mục đích của tính năng này là tiết kiệm dung lượng ổ đĩa.
Thẻ: bazel_internal_configuration
Mặc định của --experimental_repository_downloader_retries=<an integer>: "0"
Số lần thử lại một lỗi tải xuống tối đa. Nếu bạn đặt chính sách này thành 0, thì tính năng thử lại sẽ tắt.
Thẻ: experimental
Mặc định của --experimental_scale_timeouts=<a double>: "1.0"
Điều chỉnh tỷ lệ tất cả thời gian chờ trong quy tắc lưu trữ Starlark theo hệ số này. Bằng cách này, kho lưu trữ bên ngoài có thể được tạo ra hoạt động trên các máy chậm hơn tác giả quy tắc dự kiến mà không cần thay đổi mã nguồn
Thẻ: bazel_internal_configuration, experimental
Mặc định của --http_connector_attempts=<an integer>: "8"
Số lần thử tải xuống http tối đa.
Thẻ: bazel_internal_configuration
Mặc định của --http_connector_retry_max_timeout=<An immutable length of time.>: "0 giây"
Thời gian chờ tối đa cho các lần thử tải xuống lại http. Với giá trị 0, không có thời gian chờ tối đa nào được xác định.
Thẻ: bazel_internal_configuration
Mặc định của --http_timeout_scaling=<a double>: "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ố cụ thể
Thẻ: bazel_internal_configuration
Mặc định của --repository_cache=<a path>: 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. Một chuỗi trống làm đối số yêu cầu tắt bộ nhớ đệm, nếu không, hệ thống sẽ sử dụng giá trị mặc định của '<output_user_root>/cache/repos/v1'
Thẻ: bazel_internal_configuration
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ị vô hiệu hoá hoàn toàn; ctx.exe vẫn có thể chạy một tệp thực thi tuỳ ý truy cập vào Internet.
Thẻ: bazel_internal_configuration
Các tuỳ chọn kiểm soát quá trình thực thi bản dựng:
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 mục tiêu hoặc kho lưu trữ. Chỉ hoạt động khi bật --enable_bzlmod.
Thẻ: changes_inputs
Mặc định của --[no]configure: "false"
Chỉ tìm nạp những 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 bật --enable_bzlmod.
Thẻ: changes_inputs
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 bật --enable_bzlmod.
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 đã sử dụng đã sử dụng (0 – 100) trên đó 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 giá trị này thành 100, thì GcThrashingDetector sẽ tắt.
Thẻ: host_machine_resource_optimizations
Giá trị mặc định của --[no]keep_going [-k]: "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 đạt và những mục tiêu phụ thuộc vào mục tiêu đó, nhưng bạn có thể phải đáp ứng 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
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ố lượng luồng song song cần dùng cho giai đoạn tải/phân tích. Lấy một số nguyên hoặc từ khoá ("auto", "HOST_CPUS", "HOST_RAM"), theo sau (không bắt buộc) là một thao tác ([-|*]<float>), ví dụ: "auto", "HOST_CPUS*.5". "auto" đặt giá trị mặc định hợp lý dựa trên tài nguyên máy chủ. Giá trị phải lớn hơn hoặc bằng 1.
Thẻ: bazel_internal_configuration
Đã tích luỹ --repo=<a string> lần sử dụng
Chỉ tìm nạp kho lưu trữ đã chỉ định, có thể là {@apparent_repo_name} hoặc {@@canonical_repo_name}. Chỉ hoạt động khi bật --enable_bzlmod.
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 tệp BUILD, tệp .bzl hoặc tệp WORKSPACE.:
Mặc định của --[no]incompatible_config_setting_private_default_visibility: "false"
Nếu không tương thích_enforce_config_setting_visible=false, thì đây là lỗi không phù hợp. Ngoài ra, nếu cờ này sai, thì mọi config_setting không có thuộc tính chế độ hiển thị rõ ràng sẽ là //visible:public. Nếu cờ này là true, config_setting sẽ tuân theo cùng logic hiển thị 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
Mặc định của --[no]incompatible_enforce_config_setting_visibility: "đúng"
Nếu đúng, hãy thực thi các hạn chế về chế độ hiển thị config_setting. Nếu giá trị là false, mọi config_setting sẽ 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 Bzlmod:
Đã tích luỹ --allow_yanked_versions=<a string> lần sử dụng
Đã chỉ định các phiên bản mô-đun dưới dạng `<module1>@<version1>,<module2>@<version2>`. Những phiên bản này sẽ được 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 trong sổ đăng ký nơi chúng xuất phát (nếu các phiên bản đó không đến từ một NonRegistryOverride). Nếu không, các phiên bản bị giật sẽ khiến quá trình phân giải không thành công. Bạn cũng có thể xác định phiên bản được kéo mạnh được phép bằng biến môi trường "BZLMOD_ALLOW_YANKED_VERSIONS". Bạn có thể vô hiệu hoá việc kiểm tra này bằng cách sử dụng từ khoá 'all' (không được khuyến nghị).
Thẻ: loading_and_analysis
Mặc định của --check_bazel_compatibility=<error, warning or off>: "lỗi"
Kiểm tra khả năng tương thích với 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 đề lên trạng thái lỗi giải quyết, "tắt" để tắt chế độ kiểm tra, hoặc "cảnh báo" để in cảnh báo khi phát hiện thấy thông tin không khớp.
Thẻ: loading_and_analysis
Mặc định của --check_direct_dependencies=<off, warning or error>: "cảnh báo"
Kiểm tra xem các phần phụ thuộc trực tiếp "bazel_dep" được khai báo trong mô-đun gốc có giống với phiên bản bạn nhận được trong biểu đồ phần phụ thuộc đã được giải quyết hay không. Các giá trị hợp lệ là "off" ("tắt") để tắt chế độ kiểm tra, "cảnh báo" để in cảnh báo khi phát hiện thấy thông tin không khớp hoặc "error" để chuyển vấn đề lên thành lỗi giải quyết.
Thẻ: loading_and_analysis
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_secondary` trong MODULE.bazel của mô-đun gốc. Lưu ý rằng các phần phụ thuộc của 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
Mặc định của --lockfile_mode=<off, update or error>: "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 nếu có thay đổi, "error" khi dùng tệp khoá nhưng báo lỗi nếu tệp không được cập nhật, hoặc "tắt" để không đọc hoặc ghi vào tệp khoá.
Thẻ: loading_and_analysis
Đã tích luỹ --override_module=<an equals-separated mapping of module name to path> lần sử dụng
Ghi đè một mô-đun có đường dẫn cục bộ ở dạng <module name>=<path>. Nếu đường dẫn đã cho là một đường dẫn tuyệt đối, thì đường dẫn đó sẽ được sử dụng như nguyên trạng. Nếu đường dẫn đã cho là một đường dẫn tương đối, thì đường dẫn đó sẽ tương ứng với thư mục đang hoạt động hiện tại. Nếu đường dẫn đã cho bắt đầu bằng "%workspace%", thì đường dẫn đó 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 "không gian làm việc thông tin bazel")
Đã tích luỹ --registry=<a string> lần sử dụng
Chỉ định sổ đăng ký cần dùng để xác định vị trí các phần phụ thuộc của mô-đun Bazel. Thứ tự rất quan trọng: các mô-đun sẽ được tra cứu trước trong sổ đăng ký trước, và chỉ quay lại các sổ đăng ký sau khi còn thiếu trong các sổ đăng ký trước đó.
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:
Mặc định của --gc_thrashing_limits=<comma separated pairs of <period>:<count>>: "1s:2,20s:3,1m:5"
Các giới hạn mà nếu đạt đến mức này sẽ khiến GcThrashingDetector gây sự cố cho Bazel bằng OOM. Mỗi giới hạn được chỉ định dưới dạng <period>:<count>, trong đó khoảng thời gian là một khoảng thời gian và số lượng là một số nguyên dương. Nếu có hơn --gc_thrashing_threshold phần trăm không gian cần sử dụng (vùng nhớ khối xếp thế hệ cũ) vẫn chiếm sau <count> các GC đầy đủ liên tiếp trong khoảng <period>, thì OOM sẽ được kích hoạt. Bạn có thể chỉ định nhiều hạn mức và phân tách bằng dấu phẩy.
Thẻ: host_machine_resource_optimizations
Mặc định của --skyframe_high_water_mark_full_gc_drops_per_invocation=<an integer, >= 0>: "2147483647"
Gắn cờ cho cấu hình nâng cao của công cụ Skyframe nội bộ của Bazel. Nếu Bazel phát hiện thấy 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 đặt ra bằng --skyframe_high_water_mark_threshold, thì khi một sự kiện GC xảy ra đầy đủ, trạng thái Skyframe tạm thời không cần thiết sẽ bị bỏ qua, tối đa nhiều lần cho mỗi lệnh gọi. Mặc định là Integer.MAX_VALUE; không giới hạn hiệu quả. 0 có nghĩa là các sự kiện thu gom rác (GC) toàn bộ sẽ không bao giờ kích hoạt hiện tượng giảm. Nếu đạt đến giới hạn, trạng thái Skyframe sẽ không còn bị bỏ qua khi một sự kiện GC đầy đủ xảy ra và vượt quá ngưỡng tỷ lệ phần trăm vùng nhớ khối xếp được giữ lại đó.
Thẻ: host_machine_resource_optimizations
Mặc định của --skyframe_high_water_mark_minor_gc_drops_per_invocation=<an integer, >= 0>: "2147483647"
Gắn cờ cho cấu hình nâng cao của công cụ Skyframe nội bộ của Bazel. Nếu Bazel phát hiện thấy mức sử dụng tỷ lệ phần trăm vùng nhớ khối xếp được giữ lại vượt quá ngưỡng đặt ra bằng --skyframe_high_water_mark_threshold, thì khi một sự kiện GC nhỏ xảy ra, trạng thái Skyframe tạm thời không cần thiết sẽ bị bỏ qua, tối đa là nhiều lần cho mỗi lệnh gọi. Mặc định là Integer.MAX_VALUE; không giới hạn hiệu quả. 0 có nghĩa là các sự kiện GC nhỏ sẽ không bao giờ kích hoạt hiện tượng giảm. Nếu đạt đến giới hạn, trạng thái Skyframe sẽ không còn bị bỏ qua khi xảy ra một sự kiện GC nhỏ và ngưỡng tỷ lệ phần trăm vùng nhớ khối xếp được giữ lại đó đã vượt quá.
Thẻ: host_machine_resource_optimizations
Mặc định của --skyframe_high_water_mark_threshold=<an integer>: "85"
Gắn cờ cho cấu hình nâng cao của công cụ Skyframe nội bộ của Bazel. Nếu Bazel 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 ở ngưỡng này, thì Bazel sẽ bỏ trạng thái Skyframe tạm thời không cần thiết. Việc chỉnh sửa tính năng này có thể cho phép bạn giảm thiểu tác động của tình trạng này đến thời gian sử dụng GC, khi tình trạng giật GC là do việc sử dụng bộ nhớ ở trạng thái tạm thời này gây ra và (ii) tốn kém hơn so với việc khôi phục trạng thái khi cần.
Thẻ: host_machine_resource_optimizations
Các tuỳ chọn ảnh hưởng đến độ chi tiết, định dạng hoặc vị trí ghi nhật ký:
Mặc định của --[no]experimental_command_profile: "false"
Ghi lại hồ sơ CPU của Trình ghi chuyến bay Java vào tệp profile.jfr trong thư mục cơ sở đầu ra. Trong tương lai, cú pháp và ngữ nghĩa của cờ này có thể thay đổi để hỗ trợ nhiều loại hồ sơ hoặc định dạng đầu ra; bạn tự chịu rủi ro khi sử dụng.
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 thao tác ghi nhớ 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ả chức năng ghi nhớ.
Mặc định của --experimental_repository_resolved_file=<a string>: ""
Nếu không trống, hãy ghi một giá trị Starlark kèm theo 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
Tuỳ chọn chỉ định hoặc thay đổi dữ liệu đầu vào chung thành lệnh Bazel không thuộc các danh mục khác.:
Mặc định của --experimental_resolved_file_instead_of_workspace=<a string>: ""
Nếu nội dung không trống, hãy đọc tệp đã được phân giải được chỉ định thay vì tệp WORKSPACE
Các thẻ: changes_inputs
Các tuỳ chọn thực thi và lưu vào bộ nhớ đệm từ xa:
Mặc định của --experimental_downloader_config=<a string>: 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ủ (cho `allow` và `block`) hoặc hai mẫu, một mẫu để so khớp và một mẫu dùng làm URL thay thế, có tham chiếu ngược bắt đầu từ "$1". Có thể có nhiều lệnh "rewrite" cho cùng một URL và trong trường hợp này sẽ có nhiều URL được trả về.
Mặc định của --experimental_worker_for_repo_fetching=<off, platform or virtual>: "tắt"
Chế độ phân luồng dùng để tìm nạp kho lưu trữ. Nếu bạn đặt chính sách này thành "tắt", thì sẽ không có luồng worker nào được sử dụng và quá trình tìm nạp kho lưu trữ có thể khởi động lại. Ngược lại, hãy sử dụng luồng nền tảng (tức là luồng hệ điều hành) nếu được đặt thành "platform" hoặc luồng ảo nếu được đặt thành "virtual".
Các lựa chọn khác, không được phân loại.:
Đã tích luỹ --deleted_packages=<comma-separated list of package names> lần sử dụng
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 những gói này xuất hiện ở vị trí nào đó trên đường dẫn gói. Sử dụng tuỳ chọn này khi xoá gói con "x/y" của 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ể báo cáo 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. Chỉ định --delete_packages x/y sẽ tránh được sự cố này.
Đã tích luỹ --override_repository=<an equals-separated mapping of repository name to path> lần sử dụng
Ghi đè một 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à một đường dẫn tuyệt đối, thì đường dẫn đó sẽ được sử dụng nguyên vẹn. Nếu đường dẫn đã cho là một đườ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 đó 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 "không gian làm việc thông tin bazel")
Giá trị mặc định của --package_path=<colon-separated list of options>: "%workspace%"
Danh sách được phân tách bằng dấu hai chấm nơi bạn sẽ tìm thấy 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 xung quanh. Nếu bị bỏ qua hoặc để trống, giá trị mặc định sẽ là dữ liệu đầu ra của "bazel info default-package-path".
Mặc định của --[no]show_loading_progress: "đúng"
Nếu bạn bật tuỳ chọn này, Bazel sẽ in thông báo "Đang tải gói:".

Tuỳ chọn trợ giúp

Các tuỳ chọn xuất hiện trước lệnh và được ứng dụng phân tích cú pháp:
Đã tích luỹ --distdir=<a path> lần sử dụng
Các nơi khác để tìm kiếm các tệp lưu trữ trước khi truy cập mạng để tải các tệp lưu trữ đó xuống.
Thẻ: bazel_internal_configuration
Nếu bạn đặt chính sách này, bộ nhớ đệm của kho lưu trữ sẽ liên kết cứng tệp đó trong trường hợp tệp bị tấn công vào bộ nhớ đệm, thay vì sao chép. Mục đích của tính năng này là tiết kiệm dung lượng ổ đĩa.
Thẻ: bazel_internal_configuration
Mặc định của --experimental_repository_downloader_retries=<an integer>: "0"
Số lần thử lại một lỗi tải xuống tối đa. Nếu bạn đặt chính sách này thành 0, thì tính năng thử lại sẽ tắt.
Thẻ: experimental
Mặc định của --experimental_scale_timeouts=<a double>: "1.0"
Điều chỉnh tỷ lệ tất cả thời gian chờ trong quy tắc lưu trữ Starlark theo hệ số này. Bằng cách này, kho lưu trữ bên ngoài có thể được tạo ra hoạt động trên các máy chậm hơn tác giả quy tắc dự kiến mà không cần thay đổi mã nguồn
Thẻ: bazel_internal_configuration, experimental
Mặc định của --http_connector_attempts=<an integer>: "8"
Số lần thử tải xuống http tối đa.
Thẻ: bazel_internal_configuration
Mặc định của --http_connector_retry_max_timeout=<An immutable length of time.>: "0 giây"
Thời gian chờ tối đa cho các lần thử tải xuống lại http. Với giá trị 0, không có thời gian chờ tối đa nào được xác định.
Thẻ: bazel_internal_configuration
Mặc định của --http_timeout_scaling=<a double>: "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ố cụ thể
Thẻ: bazel_internal_configuration
Mặc định của --repository_cache=<a path>: 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. Một chuỗi trống làm đối số yêu cầu tắt bộ nhớ đệm, nếu không, hệ thống sẽ sử dụng giá trị mặc định của '<output_user_root>/cache/repos/v1'
Thẻ: bazel_internal_configuration
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ị vô hiệu hoá hoàn toàn; ctx.exe vẫn có thể chạy một tệp thực thi tuỳ ý truy cập vào Internet.
Thẻ: bazel_internal_configuration
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 --gc_thrashing_threshold=<an integer in 0-100 range>: "100"
Tỷ lệ phần trăm không gian đã sử dụng đã sử dụng (0 – 100) trên đó 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 giá trị này thành 100, thì GcThrashingDetector sẽ tắt.
Thẻ: host_machine_resource_optimizations
Các tuỳ chọn liên quan đến đầu ra và ngữ nghĩa Bzlmod:
Đã tích luỹ --allow_yanked_versions=<a string> lần sử dụng
Đã chỉ định các phiên bản mô-đun dưới dạng `<module1>@<version1>,<module2>@<version2>`. Những phiên bản này sẽ được 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 trong sổ đăng ký nơi chúng xuất phát (nếu các phiên bản đó không đến từ một NonRegistryOverride). Nếu không, các phiên bản bị giật sẽ khiến quá trình phân giải không thành công. Bạn cũng có thể xác định phiên bản được kéo mạnh được phép bằng biến môi trường "BZLMOD_ALLOW_YANKED_VERSIONS". Bạn có thể vô hiệu hoá việc kiểm tra này bằng cách sử dụng từ khoá 'all' (không được khuyến nghị).
Thẻ: loading_and_analysis
Mặc định của --check_bazel_compatibility=<error, warning or off>: "lỗi"
Kiểm tra khả năng tương thích với 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 đề lên trạng thái lỗi giải quyết, "tắt" để tắt chế độ kiểm tra, hoặc "cảnh báo" để in cảnh báo khi phát hiện thấy thông tin không khớp.
Thẻ: loading_and_analysis
Mặc định của --check_direct_dependencies=<off, warning or error>: "cảnh báo"
Kiểm tra xem các phần phụ thuộc trực tiếp "bazel_dep" được khai báo trong mô-đun gốc có giống với phiên bản bạn nhận được trong biểu đồ phần phụ thuộc đã được giải quyết hay không. Các giá trị hợp lệ là "off" ("tắt") để tắt chế độ kiểm tra, "cảnh báo" để in cảnh báo khi phát hiện thấy thông tin không khớp hoặc "error" để chuyển vấn đề lên thành lỗi giải quyết.
Thẻ: loading_and_analysis
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_secondary` trong MODULE.bazel của mô-đun gốc. Lưu ý rằng các phần phụ thuộc của 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
Mặc định của --lockfile_mode=<off, update or error>: "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 nếu có thay đổi, "error" khi dùng tệp khoá nhưng báo lỗi nếu tệp không được cập nhật, hoặc "tắt" để không đọc hoặc ghi vào tệp khoá.
Thẻ: loading_and_analysis
Đã tích luỹ --override_module=<an equals-separated mapping of module name to path> lần sử dụng
Ghi đè một mô-đun có đường dẫn cục bộ ở dạng <module name>=<path>. Nếu đường dẫn đã cho là một đường dẫn tuyệt đối, thì đường dẫn đó sẽ được sử dụng như nguyên trạng. Nếu đường dẫn đã cho là một đường dẫn tương đối, thì đường dẫn đó sẽ tương ứng với thư mục đang hoạt động hiện tại. Nếu đường dẫn đã cho bắt đầu bằng "%workspace%", thì đường dẫn đó 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 "không gian làm việc thông tin bazel")
Đã tích luỹ --registry=<a string> lần sử dụng
Chỉ định sổ đăng ký cần dùng để xác định vị trí các phần phụ thuộc của mô-đun Bazel. Thứ tự rất quan trọng: các mô-đun sẽ được tra cứu trước trong sổ đăng ký trước, và chỉ quay lại các sổ đăng ký sau khi còn thiếu trong các sổ đăng ký trước đó.
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:
Mặc định của --gc_thrashing_limits=<comma separated pairs of <period>:<count>>: "1s:2,20s:3,1m:5"
Các giới hạn mà nếu đạt đến mức này sẽ khiến GcThrashingDetector gây sự cố cho Bazel bằng OOM. Mỗi giới hạn được chỉ định dưới dạng <period>:<count>, trong đó khoảng thời gian là một khoảng thời gian và số lượng là một số nguyên dương. Nếu có hơn --gc_thrashing_threshold phần trăm không gian cần sử dụng (vùng nhớ khối xếp thế hệ cũ) vẫn chiếm sau <count> các GC đầy đủ liên tiếp trong khoảng <period>, thì OOM sẽ được kích hoạt. Bạn có thể chỉ định nhiều hạn mức và phân tách bằng dấu phẩy.
Thẻ: host_machine_resource_optimizations
Mặc định của --skyframe_high_water_mark_full_gc_drops_per_invocation=<an integer, >= 0>: "2147483647"
Gắn cờ cho cấu hình nâng cao của công cụ Skyframe nội bộ của Bazel. Nếu Bazel phát hiện thấy 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 đặt ra bằng --skyframe_high_water_mark_threshold, thì khi một sự kiện GC xảy ra đầy đủ, trạng thái Skyframe tạm thời không cần thiết sẽ bị bỏ qua, tối đa nhiều lần cho mỗi lệnh gọi. Mặc định là Integer.MAX_VALUE; không giới hạn hiệu quả. 0 có nghĩa là các sự kiện thu gom rác (GC) toàn bộ sẽ không bao giờ kích hoạt hiện tượng giảm. Nếu đạt đến giới hạn, trạng thái Skyframe sẽ không còn bị bỏ qua khi một sự kiện GC đầy đủ xảy ra và vượt quá ngưỡng tỷ lệ phần trăm vùng nhớ khối xếp được giữ lại đó.
Thẻ: host_machine_resource_optimizations
Mặc định của --skyframe_high_water_mark_minor_gc_drops_per_invocation=<an integer, >= 0>: "2147483647"
Gắn cờ cho cấu hình nâng cao của công cụ Skyframe nội bộ của Bazel. Nếu Bazel phát hiện thấy mức sử dụng tỷ lệ phần trăm vùng nhớ khối xếp được giữ lại vượt quá ngưỡng đặt ra bằng --skyframe_high_water_mark_threshold, thì khi một sự kiện GC nhỏ xảy ra, trạng thái Skyframe tạm thời không cần thiết sẽ bị bỏ qua, tối đa là nhiều lần cho mỗi lệnh gọi. Mặc định là Integer.MAX_VALUE; không giới hạn hiệu quả. 0 có nghĩa là các sự kiện GC nhỏ sẽ không bao giờ kích hoạt hiện tượng giảm. Nếu đạt đến giới hạn, trạng thái Skyframe sẽ không còn bị bỏ qua khi xảy ra một sự kiện GC nhỏ và ngưỡng tỷ lệ phần trăm vùng nhớ khối xếp được giữ lại đó đã vượt quá.
Thẻ: host_machine_resource_optimizations
Mặc định của --skyframe_high_water_mark_threshold=<an integer>: "85"
Gắn cờ cho cấu hình nâng cao của công cụ Skyframe nội bộ của Bazel. Nếu Bazel 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 ở ngưỡng này, thì Bazel sẽ bỏ trạng thái Skyframe tạm thời không cần thiết. Việc chỉnh sửa tính năng này có thể cho phép bạn giảm thiểu tác động của tình trạng này đến thời gian sử dụng GC, khi tình trạng giật GC là do việc sử dụng bộ nhớ ở trạng thái tạm thời này gây ra và (ii) tốn kém hơn so với việc khôi phục trạng thái khi cần.
Thẻ: host_machine_resource_optimizations
Các tuỳ chọn ảnh hưởng đến độ chi tiết, định dạng hoặc vị trí ghi nhật ký:
Mặc định của --[no]experimental_command_profile: "false"
Ghi lại hồ sơ CPU của Trình ghi chuyến bay Java vào tệp profile.jfr trong thư mục cơ sở đầu ra. Trong tương lai, cú pháp và ngữ nghĩa của cờ này có thể thay đổi để hỗ trợ nhiều loại hồ sơ hoặc định dạng đầu ra; bạn tự chịu rủi ro khi sử dụng.
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 thao tác ghi nhớ 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ả chức năng ghi nhớ.
Mặc định của chế độ --help_verbosity=<long, medium or short>: "trung bình"
Chọn độ chi tiết của lệnh trợ giúp.
Thẻ: affects_outputs, terminal_output
--long [-l]
Hiện nội dung mô tả đầy đủ về từng tuỳ chọn, thay vì chỉ hiện tên của 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 hiện 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.:
Mặc định của --experimental_resolved_file_instead_of_workspace=<a string>: ""
Nếu nội dung không trống, hãy đọc tệp đã được phân giải được chỉ định thay vì tệp WORKSPACE
Các thẻ: changes_inputs
Các tuỳ chọn thực thi và lưu vào bộ nhớ đệm từ xa:
Mặc định của --experimental_downloader_config=<a string>: 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ủ (cho `allow` và `block`) hoặc hai mẫu, một mẫu để so khớp và một mẫu dùng làm URL thay thế, có tham chiếu ngược bắt đầu từ "$1". Có thể có nhiều lệnh "rewrite" cho cùng một URL và trong trường hợp này sẽ có nhiều URL được trả về.
Mặc định của --experimental_worker_for_repo_fetching=<off, platform or virtual>: "tắt"
Chế độ phân luồng dùng để tìm nạp kho lưu trữ. Nếu bạn đặt chính sách này thành "tắt", thì sẽ không có luồng worker nào được sử dụng và quá trình tìm nạp kho lưu trữ có thể khởi động lại. Ngược lại, hãy sử dụng luồng nền tảng (tức là luồng hệ điều hành) nếu được đặt thành "platform" hoặc luồng ảo nếu được đặt thành "virtual".
Các lựa chọn khác, không được phân loại.:
Đã tích luỹ --override_repository=<an equals-separated mapping of repository name to path> lần sử dụng
Ghi đè một 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à một đường dẫn tuyệt đối, thì đường dẫn đó sẽ được sử dụng nguyên vẹn. Nếu đường dẫn đã cho là một đườ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 này 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 "không gian làm việc thông tin bazel")

Các lựa chọn về thông tin

Kế thừa tất cả các tuỳ chọn của bản dựng.

Các tuỳ chọn xuất hiện trước lệnh và được ứng dụng phân tích cú pháp:
Đã tích luỹ --distdir=<a path> lần sử dụng
Các nơi khác để tìm kiếm các tệp lưu trữ trước khi truy cập mạng để tải các tệp lưu trữ đó xuống.
Thẻ: bazel_internal_configuration
Nếu bạn đặt chính sách này, bộ nhớ đệm của kho lưu trữ sẽ liên kết cứng tệp đó trong trường hợp tệp bị tấn công vào bộ nhớ đệm, thay vì sao chép. Mục đích của tính năng này là tiết kiệm dung lượng ổ đĩa.
Thẻ: bazel_internal_configuration
Mặc định của --experimental_repository_downloader_retries=<an integer>: "0"
Số lần thử lại một lỗi tải xuống tối đa. Nếu bạn đặt chính sách này thành 0, thì tính năng thử lại sẽ tắt.
Thẻ: experimental
Mặc định của --experimental_scale_timeouts=<a double>: "1.0"
Điều chỉnh tỷ lệ tất cả thời gian chờ trong quy tắc lưu trữ Starlark theo hệ số này. Bằng cách này, kho lưu trữ bên ngoài có thể được tạo ra hoạt động trên các máy chậm hơn tác giả quy tắc dự kiến mà không cần thay đổi mã nguồn
Thẻ: bazel_internal_configuration, experimental
Mặc định của --http_connector_attempts=<an integer>: "8"
Số lần thử tải xuống http tối đa.
Thẻ: bazel_internal_configuration
Mặc định của --http_connector_retry_max_timeout=<An immutable length of time.>: "0 giây"
Thời gian chờ tối đa cho các lần thử tải xuống lại http. Với giá trị 0, không có thời gian chờ tối đa nào được xác định.
Thẻ: bazel_internal_configuration
Mặc định của --http_timeout_scaling=<a double>: "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ố cụ thể
Thẻ: bazel_internal_configuration
Mặc định của --repository_cache=<a path>: 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. Một chuỗi trống làm đối số yêu cầu tắt bộ nhớ đệm, nếu không, hệ thống sẽ sử dụng giá trị mặc định của '<output_user_root>/cache/repos/v1'
Thẻ: bazel_internal_configuration
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ị vô hiệu hoá hoàn toàn; ctx.exe vẫn có thể chạy một tệp thực thi tuỳ ý truy cập vào Internet.
Thẻ: bazel_internal_configuration
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 --gc_thrashing_threshold=<an integer in 0-100 range>: "100"
Tỷ lệ phần trăm không gian đã sử dụng đã sử dụng (0 – 100) trên đó 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 giá trị này thành 100, thì GcThrashingDetector sẽ tắt.
Thẻ: host_machine_resource_optimizations
Các tuỳ chọn liên quan đến đầu ra và ngữ nghĩa Bzlmod:
Đã tích luỹ --allow_yanked_versions=<a string> lần sử dụng
Đã chỉ định các phiên bản mô-đun dưới dạng `<module1>@<version1>,<module2>@<version2>`. Những phiên bản này sẽ được 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 trong sổ đăng ký nơi chúng xuất phát (nếu các phiên bản đó không đến từ một NonRegistryOverride). Nếu không, các phiên bản bị giật sẽ khiến quá trình phân giải không thành công. Bạn cũng có thể xác định phiên bản được kéo mạnh được phép bằng biến môi trường "BZLMOD_ALLOW_YANKED_VERSIONS". Bạn có thể vô hiệu hoá việc kiểm tra này bằng cách sử dụng từ khoá 'all' (không được khuyến nghị).
Thẻ: loading_and_analysis
Mặc định của --check_bazel_compatibility=<error, warning or off>: "lỗi"
Kiểm tra khả năng tương thích với 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 đề lên trạng thái lỗi giải quyết, "tắt" để tắt chế độ kiểm tra, hoặc "cảnh báo" để in cảnh báo khi phát hiện thấy thông tin không khớp.
Thẻ: loading_and_analysis
Mặc định của --check_direct_dependencies=<off, warning or error>: "cảnh báo"
Kiểm tra xem các phần phụ thuộc trực tiếp "bazel_dep" được khai báo trong mô-đun gốc có giống với phiên bản bạn nhận được trong biểu đồ phần phụ thuộc đã được giải quyết hay không. Các giá trị hợp lệ là "off" ("tắt") để tắt chế độ kiểm tra, "cảnh báo" để in cảnh báo khi phát hiện thấy thông tin không khớp hoặc "error" để chuyển vấn đề lên thành lỗi giải quyết.
Thẻ: loading_and_analysis
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_secondary` trong MODULE.bazel của mô-đun gốc. Lưu ý rằng các phần phụ thuộc của 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
Mặc định của --lockfile_mode=<off, update or error>: "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 nếu có thay đổi, "error" khi dùng tệp khoá nhưng báo lỗi nếu tệp không được cập nhật, hoặc "tắt" để không đọc hoặc ghi vào tệp khoá.
Thẻ: loading_and_analysis
Đã tích luỹ --override_module=<an equals-separated mapping of module name to path> lần sử dụng
Ghi đè một mô-đun có đường dẫn cục bộ ở dạng <module name>=<path>. Nếu đường dẫn đã cho là một đường dẫn tuyệt đối, thì đường dẫn đó sẽ được sử dụng như nguyên trạng. Nếu đường dẫn đã cho là một đường dẫn tương đối, thì đường dẫn đó sẽ tương ứng với thư mục đang hoạt động hiện tại. Nếu đường dẫn đã cho bắt đầu bằng "%workspace%", thì đường dẫn đó 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 "không gian làm việc thông tin bazel")
Đã tích luỹ --registry=<a string> lần sử dụng
Chỉ định sổ đăng ký cần dùng để xác định vị trí các phần phụ thuộc của mô-đun Bazel. Thứ tự rất quan trọng: các mô-đun sẽ được tra cứu trước trong sổ đăng ký trước, và chỉ quay lại các sổ đăng ký sau khi còn thiếu trong các sổ đăng ký trước đó.
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:
Mặc định của --gc_thrashing_limits=<comma separated pairs of <period>:<count>>: "1s:2,20s:3,1m:5"
Các giới hạn mà nếu đạt đến mức này sẽ khiến GcThrashingDetector gây sự cố cho Bazel bằng OOM. Mỗi giới hạn được chỉ định dưới dạng <period>:<count>, trong đó khoảng thời gian là một khoảng thời gian và số lượng là một số nguyên dương. Nếu có hơn --gc_thrashing_threshold phần trăm không gian cần sử dụng (vùng nhớ khối xếp thế hệ cũ) vẫn chiếm sau <count> các GC đầy đủ liên tiếp trong khoảng <period>, thì OOM sẽ được kích hoạt. Bạn có thể chỉ định nhiều hạn mức và phân tách bằng dấu phẩy.
Thẻ: host_machine_resource_optimizations
Mặc định của --skyframe_high_water_mark_full_gc_drops_per_invocation=<an integer, >= 0>: "2147483647"
Gắn cờ cho cấu hình nâng cao của công cụ Skyframe nội bộ của Bazel. Nếu Bazel phát hiện thấy 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 đặt ra bằng --skyframe_high_water_mark_threshold, thì khi một sự kiện GC xảy ra đầy đủ, trạng thái Skyframe tạm thời không cần thiết sẽ bị bỏ qua, tối đa nhiều lần cho mỗi lệnh gọi. Mặc định là Integer.MAX_VALUE; không giới hạn hiệu quả. 0 có nghĩa là các sự kiện thu gom rác (GC) toàn bộ sẽ không bao giờ kích hoạt hiện tượng giảm. Nếu đạt đến giới hạn, trạng thái Skyframe sẽ không còn bị bỏ qua khi một sự kiện GC đầy đủ xảy ra và vượt quá ngưỡng tỷ lệ phần trăm vùng nhớ khối xếp được giữ lại đó.
Thẻ: host_machine_resource_optimizations
Mặc định của --skyframe_high_water_mark_minor_gc_drops_per_invocation=<an integer, >= 0>: "2147483647"
Gắn cờ cho cấu hình nâng cao của công cụ Skyframe nội bộ của Bazel. Nếu Bazel phát hiện thấy mức sử dụng tỷ lệ phần trăm vùng nhớ khối xếp được giữ lại vượt quá ngưỡng đặt ra bằng --skyframe_high_water_mark_threshold, thì khi một sự kiện GC nhỏ xảy ra, trạng thái Skyframe tạm thời không cần thiết sẽ bị bỏ qua, tối đa là nhiều lần cho mỗi lệnh gọi. Mặc định là Integer.MAX_VALUE; không giới hạn hiệu quả. 0 có nghĩa là các sự kiện GC nhỏ sẽ không bao giờ kích hoạt hiện tượng giảm. Nếu đạt đến giới hạn, trạng thái Skyframe sẽ không còn bị bỏ qua khi xảy ra một sự kiện GC nhỏ và ngưỡng tỷ lệ phần trăm vùng nhớ khối xếp được giữ lại đó đã vượt quá.
Thẻ: host_machine_resource_optimizations
Mặc định của --skyframe_high_water_mark_threshold=<an integer>: "85"
Gắn cờ cho cấu hình nâng cao của công cụ Skyframe nội bộ của Bazel. Nếu Bazel 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 ở ngưỡng này, thì Bazel sẽ bỏ trạng thái Skyframe tạm thời không cần thiết. Việc chỉnh sửa tính năng này có thể cho phép bạn giảm thiểu tác động của tình trạng này đến thời gian sử dụng GC, khi tình trạng giật GC là do việc sử dụng bộ nhớ ở trạng thái tạm thời này gây ra và (ii) tốn kém hơn so với việc khôi phục trạng thái khi cần.
Thẻ: host_machine_resource_optimizations
Các tuỳ chọn ảnh hưởng đến độ chi tiết, định dạng hoặc vị trí ghi nhật ký:
Mặc định của --[no]experimental_command_profile: "false"
Ghi lại hồ sơ CPU của Trình ghi chuyến bay Java vào tệp profile.jfr trong thư mục cơ sở đầu ra. Trong tương lai, cú pháp và ngữ nghĩa của cờ này có thể thay đổi để hỗ trợ nhiều loại hồ sơ hoặc định dạng đầu ra; bạn tự chịu rủi ro khi sử dụng.
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 thao tác ghi nhớ 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ả chức năng ghi nhớ.
Mặc định của --[no]show_make_env: "false"
Đưa môi trường "Make" (Tạo) vào đầu ra.
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 lệnh Bazel không thuộc các danh mục khác.:
Mặc định của --experimental_resolved_file_instead_of_workspace=<a string>: ""
Nếu nội dung không trống, hãy đọc tệp đã được phân giải được chỉ định thay vì tệp WORKSPACE
Các thẻ: changes_inputs
Các tuỳ chọn thực thi và lưu vào bộ nhớ đệm từ xa:
Mặc định của --experimental_downloader_config=<a string>: 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ủ (cho `allow` và `block`) hoặc hai mẫu, một mẫu để so khớp và một mẫu dùng làm URL thay thế, có tham chiếu ngược bắt đầu từ "$1". Có thể có nhiều lệnh "rewrite" cho cùng một URL và trong trường hợp này sẽ có nhiều URL được trả về.
Mặc định của --experimental_worker_for_repo_fetching=<off, platform or virtual>: "tắt"
Chế độ phân luồng dùng để tìm nạp kho lưu trữ. Nếu bạn đặt chính sách này thành "tắt", thì sẽ không có luồng worker nào được sử dụng và quá trình tìm nạp kho lưu trữ có thể khởi động lại. Ngược lại, hãy sử dụng luồng nền tảng (tức là luồng hệ điều hành) nếu được đặt thành "platform" hoặc luồng ảo nếu được đặt thành "virtual".
Các lựa chọn khác, không được phân loại.:
Đã tích luỹ --override_repository=<an equals-separated mapping of repository name to path> lần sử dụng
Ghi đè một 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à một đường dẫn tuyệt đối, thì đường dẫn đó sẽ được sử dụng nguyên vẹn. Nếu đường dẫn đã cho là một đườ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 này 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 "không gian làm việc thông tin bazel")

Lựa chọn về giấy phép

Các tuỳ chọn xuất hiện trước lệnh và được ứng dụng phân tích cú pháp:
Đã tích luỹ --distdir=<a path> lần sử dụng
Các nơi khác để tìm kiếm các tệp lưu trữ trước khi truy cập mạng để tải các tệp lưu trữ đó xuống.
Thẻ: bazel_internal_configuration
Nếu bạn đặt chính sách này, bộ nhớ đệm của kho lưu trữ sẽ liên kết cứng tệp đó trong trường hợp tệp bị tấn công vào bộ nhớ đệm, thay vì sao chép. Mục đích của tính năng này là tiết kiệm dung lượng ổ đĩa.
Thẻ: bazel_internal_configuration
Mặc định của --experimental_repository_downloader_retries=<an integer>: "0"
Số lần thử lại một lỗi tải xuống tối đa. Nếu bạn đặt chính sách này thành 0, thì tính năng thử lại sẽ tắt.
Thẻ: experimental
Mặc định của --experimental_scale_timeouts=<a double>: "1.0"
Điều chỉnh tỷ lệ tất cả thời gian chờ trong quy tắc lưu trữ Starlark theo hệ số này. Bằng cách này, kho lưu trữ bên ngoài có thể được tạo ra hoạt động trên các máy chậm hơn tác giả quy tắc dự kiến mà không cần thay đổi mã nguồn
Thẻ: bazel_internal_configuration, experimental
Mặc định của --http_connector_attempts=<an integer>: "8"
Số lần thử tải xuống http tối đa.
Thẻ: bazel_internal_configuration
Mặc định của --http_connector_retry_max_timeout=<An immutable length of time.>: "0 giây"
Thời gian chờ tối đa cho các lần thử tải xuống lại http. Với giá trị 0, không có thời gian chờ tối đa nào được xác định.
Thẻ: bazel_internal_configuration
Mặc định của --http_timeout_scaling=<a double>: "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ố cụ thể
Thẻ: bazel_internal_configuration
Mặc định của --repository_cache=<a path>: 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. Một chuỗi trống làm đối số yêu cầu tắt bộ nhớ đệm, nếu không, hệ thống sẽ sử dụng giá trị mặc định của '<output_user_root>/cache/repos/v1'
Thẻ: bazel_internal_configuration
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ị vô hiệu hoá hoàn toàn; ctx.exe vẫn có thể chạy một tệp thực thi tuỳ ý truy cập vào Internet.
Thẻ: bazel_internal_configuration
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 --gc_thrashing_threshold=<an integer in 0-100 range>: "100"
Tỷ lệ phần trăm không gian đã sử dụng đã sử dụng (0 – 100) trên đó 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 giá trị này thành 100, thì GcThrashingDetector sẽ tắt.
Thẻ: host_machine_resource_optimizations
Các tuỳ chọn liên quan đến đầu ra và ngữ nghĩa Bzlmod:
Đã tích luỹ --allow_yanked_versions=<a string> lần sử dụng
Đã chỉ định các phiên bản mô-đun dưới dạng `<module1>@<version1>,<module2>@<version2>`. Những phiên bản này sẽ được 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 trong sổ đăng ký nơi chúng xuất phát (nếu các phiên bản đó không đến từ một NonRegistryOverride). Nếu không, các phiên bản bị giật sẽ khiến quá trình phân giải không thành công. Bạn cũng có thể xác định phiên bản được kéo mạnh được phép bằng biến môi trường "BZLMOD_ALLOW_YANKED_VERSIONS". Bạn có thể vô hiệu hoá việc kiểm tra này bằng cách sử dụng từ khoá 'all' (không được khuyến nghị).
Thẻ: loading_and_analysis
Mặc định của --check_bazel_compatibility=<error, warning or off>: "lỗi"
Kiểm tra khả năng tương thích với 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 đề lên trạng thái lỗi giải quyết, "tắt" để tắt chế độ kiểm tra, hoặc "cảnh báo" để in cảnh báo khi phát hiện thấy thông tin không khớp.
Thẻ: loading_and_analysis
Mặc định của --check_direct_dependencies=<off, warning or error>: "cảnh báo"
Kiểm tra xem các phần phụ thuộc trực tiếp "bazel_dep" được khai báo trong mô-đun gốc có giống với phiên bản bạn nhận được trong biểu đồ phần phụ thuộc đã được giải quyết hay không. Các giá trị hợp lệ là "off" ("tắt") để tắt chế độ kiểm tra, "cảnh báo" để in cảnh báo khi phát hiện thấy thông tin không khớp hoặc "error" để chuyển vấn đề lên thành lỗi giải quyết.
Thẻ: loading_and_analysis
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_secondary` trong MODULE.bazel của mô-đun gốc. Lưu ý rằng các phần phụ thuộc của 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
Mặc định của --lockfile_mode=<off, update or error>: "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 nếu có thay đổi, "error" khi dùng tệp khoá nhưng báo lỗi nếu tệp không được cập nhật, hoặc "tắt" để không đọc hoặc ghi vào tệp khoá.
Thẻ: loading_and_analysis
Đã tích luỹ --override_module=<an equals-separated mapping of module name to path> lần sử dụng
Ghi đè một mô-đun có đường dẫn cục bộ ở dạng <module name>=<path>. Nếu đường dẫn đã cho là một đường dẫn tuyệt đối, thì đường dẫn đó sẽ được sử dụng như nguyên trạng. Nếu đường dẫn đã cho là một đường dẫn tương đối, thì đường dẫn đó sẽ tương ứng với thư mục đang hoạt động hiện tại. Nếu đường dẫn đã cho bắt đầu bằng "%workspace%", thì đường dẫn đó 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 "không gian làm việc thông tin bazel")
Đã tích luỹ --registry=<a string> lần sử dụng
Chỉ định sổ đăng ký cần dùng để xác định vị trí các phần phụ thuộc của mô-đun Bazel. Thứ tự rất quan trọng: các mô-đun sẽ được tra cứu trước trong sổ đăng ký trước, và chỉ quay lại các sổ đăng ký sau khi còn thiếu trong các sổ đăng ký trước đó.
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:
Mặc định của --gc_thrashing_limits=<comma separated pairs of <period>:<count>>: "1s:2,20s:3,1m:5"
Các giới hạn mà nếu đạt đến mức này sẽ khiến GcThrashingDetector gây sự cố cho Bazel bằng OOM. Mỗi giới hạn được chỉ định dưới dạng <period>:<count>, trong đó khoảng thời gian là một khoảng thời gian và số lượng là một số nguyên dương. Nếu có hơn --gc_thrashing_threshold phần trăm không gian cần sử dụng (vùng nhớ khối xếp thế hệ cũ) vẫn chiếm sau <count> các GC đầy đủ liên tiếp trong khoảng <period>, thì OOM sẽ được kích hoạt. Bạn có thể chỉ định nhiều hạn mức và phân tách bằng dấu phẩy.
Thẻ: host_machine_resource_optimizations
Mặc định của --skyframe_high_water_mark_full_gc_drops_per_invocation=<an integer, >= 0>: "2147483647"
Gắn cờ cho cấu hình nâng cao của công cụ Skyframe nội bộ của Bazel. Nếu Bazel phát hiện thấy 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 đặt ra bằng --skyframe_high_water_mark_threshold, thì khi một sự kiện GC xảy ra đầy đủ, trạng thái Skyframe tạm thời không cần thiết sẽ bị bỏ qua, tối đa nhiều lần cho mỗi lệnh gọi. Mặc định là Integer.MAX_VALUE; không giới hạn hiệu quả. 0 có nghĩa là các sự kiện thu gom rác (GC) toàn bộ sẽ không bao giờ kích hoạt hiện tượng giảm. Nếu đạt đến giới hạn, trạng thái Skyframe sẽ không còn bị bỏ qua khi một sự kiện GC đầy đủ xảy ra và vượt quá ngưỡng tỷ lệ phần trăm vùng nhớ khối xếp được giữ lại đó.
Thẻ: host_machine_resource_optimizations
Mặc định của --skyframe_high_water_mark_minor_gc_drops_per_invocation=<an integer, >= 0>: "2147483647"
Gắn cờ cho cấu hình nâng cao của công cụ Skyframe nội bộ của Bazel. Nếu Bazel phát hiện thấy mức sử dụng tỷ lệ phần trăm vùng nhớ khối xếp được giữ lại vượt quá ngưỡng đặt ra bằng --skyframe_high_water_mark_threshold, thì khi một sự kiện GC nhỏ xảy ra, trạng thái Skyframe tạm thời không cần thiết sẽ bị bỏ qua, tối đa là nhiều lần cho mỗi lệnh gọi. Mặc định là Integer.MAX_VALUE; không giới hạn hiệu quả. 0 có nghĩa là các sự kiện GC nhỏ sẽ không bao giờ kích hoạt hiện tượng giảm. Nếu đạt đến giới hạn, trạng thái Skyframe sẽ không còn bị bỏ qua khi xảy ra một sự kiện GC nhỏ và ngưỡng tỷ lệ phần trăm vùng nhớ khối xếp được giữ lại đó đã vượt quá.
Thẻ: host_machine_resource_optimizations
Mặc định của --skyframe_high_water_mark_threshold=<an integer>: "85"
Gắn cờ cho cấu hình nâng cao của công cụ Skyframe nội bộ của Bazel. Nếu Bazel 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 ở ngưỡng này, thì Bazel sẽ bỏ trạng thái Skyframe tạm thời không cần thiết. Việc chỉnh sửa tính năng này có thể cho phép bạn giảm thiểu tác động của tình trạng này đến thời gian sử dụng GC, khi tình trạng giật GC là do việc sử dụng bộ nhớ ở trạng thái tạm thời này gây ra và (ii) tốn kém hơn so với việc khôi phục trạng thái khi cần.
Thẻ: host_machine_resource_optimizations
Các tuỳ chọn ảnh hưởng đến độ chi tiết, định dạng hoặc vị trí ghi nhật ký:
Mặc định của --[no]experimental_command_profile: "false"
Ghi lại hồ sơ CPU của Trình ghi chuyến bay Java vào tệp profile.jfr trong thư mục cơ sở đầu ra. Trong tương lai, cú pháp và ngữ nghĩa của cờ này có thể thay đổi để hỗ trợ nhiều loại hồ sơ hoặc định dạng đầu ra; bạn tự chịu rủi ro khi sử dụng.
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 thao tác ghi nhớ 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ả chức năng ghi nhớ.
Các tuỳ chọn chỉ định hoặc thay đổi dữ liệu đầu vào chung thành lệnh Bazel mà không thuộc các danh mục khác.:
Mặc định của --experimental_resolved_file_instead_of_workspace=<a string>: ""
Nếu nội dung không trống, hãy đọc tệp đã được phân giải được chỉ định thay vì tệp WORKSPACE
Các thẻ: changes_inputs
Các tuỳ chọn thực thi và lưu vào bộ nhớ đệm từ xa:
Mặc định của --experimental_downloader_config=<a string>: 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ủ (cho `allow` và `block`) hoặc hai mẫu, một mẫu để so khớp và một mẫu dùng làm URL thay thế, có tham chiếu ngược bắt đầu từ "$1". Có thể có nhiều lệnh "rewrite" cho cùng một URL và trong trường hợp này sẽ có nhiều URL được trả về.
Mặc định của --experimental_worker_for_repo_fetching=<off, platform or virtual>: "tắt"
Chế độ phân luồng dùng để tìm nạp kho lưu trữ. Nếu bạn đặt chính sách này thành "tắt", thì sẽ không có luồng worker nào được sử dụng và quá trình tìm nạp kho lưu trữ có thể khởi động lại. Ngược lại, hãy sử dụng luồng nền tảng (tức là luồng hệ điều hành) nếu được đặt thành "platform" hoặc luồng ảo nếu được đặt thành "virtual".
Các lựa chọn khác, không được phân loại.:
Đã tích luỹ --override_repository=<an equals-separated mapping of repository name to path> lần sử dụng
Ghi đè một 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à một đường dẫn tuyệt đối, thì đường dẫn đó sẽ được sử dụng nguyên vẹn. Nếu đường dẫn đã cho là một đườ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 này 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 "không gian làm việc thông tin bazel")

Tuỳ chọn cài đặt trên thiết bị di động

Kế thừa tất cả các tuỳ chọn của bản dựng.

Các tuỳ chọn xuất hiện trước lệnh và được ứng dụng phân tích cú pháp:
Đã tích luỹ --distdir=<a path> lần sử dụng
Các nơi khác để tìm kiếm các tệp lưu trữ trước khi truy cập mạng để tải các tệp lưu trữ đó xuống.
Thẻ: bazel_internal_configuration
Nếu bạn đặt chính sách này, bộ nhớ đệm của kho lưu trữ sẽ liên kết cứng tệp đó trong trường hợp tệp bị tấn công vào bộ nhớ đệm, thay vì sao chép. Mục đích của tính năng này là tiết kiệm dung lượng ổ đĩa.
Thẻ: bazel_internal_configuration
Mặc định của --experimental_repository_downloader_retries=<an integer>: "0"
Số lần thử lại một lỗi tải xuống tối đa. Nếu bạn đặt chính sách này thành 0, thì tính năng thử lại sẽ tắt.
Thẻ: experimental
Mặc định của --experimental_scale_timeouts=<a double>: "1.0"
Điều chỉnh tỷ lệ tất cả thời gian chờ trong quy tắc lưu trữ Starlark theo hệ số này. Bằng cách này, kho lưu trữ bên ngoài có thể được tạo ra hoạt động trên các máy chậm hơn tác giả quy tắc dự kiến mà không cần thay đổi mã nguồn
Thẻ: bazel_internal_configuration, experimental
Mặc định của --http_connector_attempts=<an integer>: "8"
Số lần thử tải xuống http tối đa.
Thẻ: bazel_internal_configuration
Mặc định của --http_connector_retry_max_timeout=<An immutable length of time.>: "0 giây"
Thời gian chờ tối đa cho các lần thử tải xuống lại http. Với giá trị 0, không có thời gian chờ tối đa nào được xác định.
Thẻ: bazel_internal_configuration
Mặc định của --http_timeout_scaling=<a double>: "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ố cụ thể
Thẻ: bazel_internal_configuration
Mặc định của --repository_cache=<a path>: 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. Một chuỗi trống làm đối số yêu cầu tắt bộ nhớ đệm, nếu không, hệ thống sẽ sử dụng giá trị mặc định của '<output_user_root>/cache/repos/v1'
Thẻ: bazel_internal_configuration
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ị vô hiệu hoá hoàn toàn; ctx.exe vẫn có thể chạy một tệp thực thi tuỳ ý truy cập vào Internet.
Thẻ: bazel_internal_configuration
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 --gc_thrashing_threshold=<an integer in 0-100 range>: "100"
Tỷ lệ phần trăm không gian đã sử dụng đã sử dụng (0 – 100) trên đó 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 giá trị này thành 100, thì GcThrashingDetector sẽ tắt.
Thẻ: host_machine_resource_optimizations
Mặc định của --mode=<classic, classic_internal_test_do_not_use or skylark>: "cổ điển"
Chọn cách chạy chế độ cài đặt trên thiết bị di động. "cổ điển" chạy phiên bản cài đặt trên thiết bị di động hiện tại. "skylark" sử dụng phiên bản Starlark mới có hỗ trợ 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:
Mặc định của --adb=<a string>: ""
tệp nhị phân adb để sử dụng cho lệnh "mobile-install". Nếu không chỉ định, SDK sẽ được sử dụng trong SDK Android được chỉ định bởi tuỳ chọn dòng lệnh --android_sdk (hoặc SDK mặc định nếu --android_sdk không được chỉ định).
Thẻ: changes_inputs
Các tuỳ chọn kiểm soát kết quả của lệnh:
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 thực hiện thêm tác vụ không cần thiết bằng cách đọc trạng thái của thiết bị sẽ cài đặt mã và sử dụng thông tin đó để tránh các tác vụ 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
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 kết quả dự định, ảnh hưởng đến giá trị của kết quả đó thay vì kết quả tồn tại:
Đã tích luỹ --adb_arg=<a string> lần sử dụng
Đối số bổ sung để truyền đến adb. Thường được dùng để chỉ định một thiết bị sẽ cài đặt.
Thẻ: action_command_lines
--debug_app
Liệu có nên đợi 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
Mặc định của --device=<a string>: ""
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
Mặc định của --start=<no, cold, warm or debug>: "NO"
Cách khởi động ứng dụng sau khi cài đặt. Đặt thành WARM để duy trì và khôi phục trạng thái của ứng dụng khi có số lượt cài đặt gia tăng.
Thẻ: execution
--start_app
Liệu có nên 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 đầu ra và ngữ nghĩa Bzlmod:
Đã tích luỹ --allow_yanked_versions=<a string> lần sử dụng
Đã chỉ định các phiên bản mô-đun dưới dạng `<module1>@<version1>,<module2>@<version2>`. Những phiên bản này sẽ được 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 trong sổ đăng ký nơi chúng xuất phát (nếu các phiên bản đó không đến từ một NonRegistryOverride). Nếu không, các phiên bản bị giật sẽ khiến quá trình phân giải không thành công. Bạn cũng có thể xác định phiên bản được kéo mạnh được phép bằng biến môi trường "BZLMOD_ALLOW_YANKED_VERSIONS". Bạn có thể vô hiệu hoá việc kiểm tra này bằng cách sử dụng từ khoá 'all' (không được khuyến nghị).
Thẻ: loading_and_analysis
Mặc định của --check_bazel_compatibility=<error, warning or off>: "lỗi"
Kiểm tra khả năng tương thích với 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 đề lên trạng thái lỗi giải quyết, "tắt" để tắt chế độ kiểm tra, hoặc "cảnh báo" để in cảnh báo khi phát hiện thấy thông tin không khớp.
Thẻ: loading_and_analysis
Mặc định của --check_direct_dependencies=<off, warning or error>: "cảnh báo"
Kiểm tra xem các phần phụ thuộc trực tiếp "bazel_dep" được khai báo trong mô-đun gốc có giống với phiên bản bạn nhận được trong biểu đồ phần phụ thuộc đã được giải quyết hay không. Các giá trị hợp lệ là "off" ("tắt") để tắt chế độ kiểm tra, "cảnh báo" để in cảnh báo khi phát hiện thấy thông tin không khớp hoặc "error" để chuyển vấn đề lên thành lỗi giải quyết.
Thẻ: loading_and_analysis
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_secondary` trong MODULE.bazel của mô-đun gốc. Lưu ý rằng các phần phụ thuộc của 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
Mặc định của --lockfile_mode=<off, update or error>: "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 nếu có thay đổi, "error" khi dùng tệp khoá nhưng báo lỗi nếu tệp không được cập nhật, hoặc "tắt" để không đọc hoặc ghi vào tệp khoá.
Thẻ: loading_and_analysis
Đã tích luỹ --override_module=<an equals-separated mapping of module name to path> lần sử dụng
Ghi đè một mô-đun có đường dẫn cục bộ ở dạng <module name>=<path>. Nếu đường dẫn đã cho là một đường dẫn tuyệt đối, thì đường dẫn đó sẽ được sử dụng như nguyên trạng. Nếu đường dẫn đã cho là một đường dẫn tương đối, thì đường dẫn đó sẽ tương ứng với thư mục đang hoạt động hiện tại. Nếu đường dẫn đã cho bắt đầu bằng "%workspace%", thì đường dẫn đó 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 "không gian làm việc thông tin bazel")
Đã tích luỹ --registry=<a string> lần sử dụng
Chỉ định sổ đăng ký cần dùng để xác định vị trí các phần phụ thuộc của mô-đun Bazel. Thứ tự rất quan trọng: các mô-đun sẽ được tra cứu trước trong sổ đăng ký trước, và chỉ quay lại các sổ đăng ký sau khi còn thiếu trong các sổ đăng ký trước đó.
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:
Mặc định của --gc_thrashing_limits=<comma separated pairs of <period>:<count>>: "1s:2,20s:3,1m:5"
Các giới hạn mà nếu đạt đến mức này sẽ khiến GcThrashingDetector gây sự cố cho Bazel bằng OOM. Mỗi giới hạn được chỉ định dưới dạng <period>:<count>, trong đó khoảng thời gian là một khoảng thời gian và số lượng là một số nguyên dương. Nếu có hơn --gc_thrashing_threshold phần trăm không gian cần sử dụng (vùng nhớ khối xếp thế hệ cũ) vẫn chiếm sau <count> các GC đầy đủ liên tiếp trong khoảng <period>, thì OOM sẽ được kích hoạt. Bạn có thể chỉ định nhiều hạn mức và phân tách bằng dấu phẩy.
Thẻ: host_machine_resource_optimizations
Mặc định của --skyframe_high_water_mark_full_gc_drops_per_invocation=<an integer, >= 0>: "2147483647"
Gắn cờ cho cấu hình nâng cao của công cụ Skyframe nội bộ của Bazel. Nếu Bazel phát hiện thấy 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 đặt ra bằng --skyframe_high_water_mark_threshold, thì khi một sự kiện GC xảy ra đầy đủ, trạng thái Skyframe tạm thời không cần thiết sẽ bị bỏ qua, tối đa nhiều lần cho mỗi lệnh gọi. Mặc định là Integer.MAX_VALUE; không giới hạn hiệu quả. 0 có nghĩa là các sự kiện thu gom rác (GC) toàn bộ sẽ không bao giờ kích hoạt hiện tượng giảm. Nếu đạt đến giới hạn, trạng thái Skyframe sẽ không còn bị bỏ qua khi một sự kiện GC đầy đủ xảy ra và vượt quá ngưỡng tỷ lệ phần trăm vùng nhớ khối xếp được giữ lại đó.
Thẻ: host_machine_resource_optimizations
Mặc định của --skyframe_high_water_mark_minor_gc_drops_per_invocation=<an integer, >= 0>: "2147483647"
Gắn cờ cho cấu hình nâng cao của công cụ Skyframe nội bộ của Bazel. Nếu Bazel phát hiện thấy mức sử dụng tỷ lệ phần trăm vùng nhớ khối xếp được giữ lại vượt quá ngưỡng đặt ra bằng --skyframe_high_water_mark_threshold, thì khi một sự kiện GC nhỏ xảy ra, trạng thái Skyframe tạm thời không cần thiết sẽ bị bỏ qua, tối đa là nhiều lần cho mỗi lệnh gọi. Mặc định là Integer.MAX_VALUE; không giới hạn hiệu quả. 0 có nghĩa là các sự kiện GC nhỏ sẽ không bao giờ kích hoạt hiện tượng giảm. Nếu đạt đến giới hạn, trạng thái Skyframe sẽ không còn bị bỏ qua khi xảy ra một sự kiện GC nhỏ và ngưỡng tỷ lệ phần trăm vùng nhớ khối xếp được giữ lại đó đã vượt quá.
Thẻ: host_machine_resource_optimizations
Mặc định của --skyframe_high_water_mark_threshold=<an integer>: "85"
Gắn cờ cho cấu hình nâng cao của công cụ Skyframe nội bộ của Bazel. Nếu Bazel 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 ở ngưỡng này, thì Bazel sẽ bỏ trạng thái Skyframe tạm thời không cần thiết. Việc chỉnh sửa tính năng này có thể cho phép bạn giảm thiểu tác động của tình trạng này đến thời gian sử dụng GC, khi tình trạng giật GC là do việc sử dụng bộ nhớ ở trạng thái tạm thời này gây ra và (ii) tốn kém hơn so với việc khôi phục trạng thái khi cần.
Thẻ: host_machine_resource_optimizations
Các tuỳ chọn ảnh hưởng đến độ chi tiết, định dạng hoặc vị trí ghi nhật ký:
Mặc định của --[no]experimental_command_profile: "false"
Ghi lại hồ sơ CPU của Trình ghi chuyến bay Java vào tệp profile.jfr trong thư mục cơ sở đầu ra. Trong tương lai, cú pháp và ngữ nghĩa của cờ này có thể thay đổi để hỗ trợ nhiều loại hồ sơ hoặc định dạng đầu ra; bạn tự chịu rủi ro khi sử dụng.
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 thao tác ghi nhớ 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ả chức năng ghi nhớ.
Mặc định của --incremental_install_verbosity=<a string>: ""
Độ chi tiết của lượt cài đặt gia tăng. Đặt là 1 để ghi nhật ký gỡ lỗi.
Thẻ: bazel_monitoring
Tuỳ chọn chỉ định hoặc thay đổi dữ liệu đầu vào chung thành lệnh Bazel không thuộc các danh mục khác.:
Mặc định của --experimental_resolved_file_instead_of_workspace=<a string>: ""
Nếu nội dung không trống, hãy đọc tệp đã được phân giải được chỉ định thay vì tệp WORKSPACE
Các thẻ: changes_inputs
Các tuỳ chọn thực thi và lưu vào bộ nhớ đệm từ xa:
Mặc định của --experimental_downloader_config=<a string>: 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ủ (cho `allow` và `block`) hoặc hai mẫu, một mẫu để so khớp và một mẫu dùng làm URL thay thế, có tham chiếu ngược bắt đầu từ "$1". Có thể có nhiều lệnh "rewrite" cho cùng một URL và trong trường hợp này sẽ có nhiều URL được trả về.
Mặc định của --experimental_worker_for_repo_fetching=<off, platform or virtual>: "tắt"
Chế độ phân luồng dùng để tìm nạp kho lưu trữ. Nếu bạn đặt chính sách này thành "tắt", thì sẽ không có luồng worker nào được sử dụng và quá trình tìm nạp kho lưu trữ có thể khởi động lại. Ngược lại, hãy sử dụng luồng nền tảng (tức là luồng hệ điều hành) nếu được đặt thành "platform" hoặc luồng ảo nếu được đặt thành "virtual".
Các lựa chọn khác, không được phân loại.:
Đã tích luỹ --override_repository=<an equals-separated mapping of repository name to path> lần sử dụng
Ghi đè một 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à một đường dẫn tuyệt đối, thì đường dẫn đó sẽ được sử dụng nguyên vẹn. Nếu đường dẫn đã cho là một đườ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 này 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 "không gian làm việc thông tin bazel")

Tuỳ chọn Mod

Các tuỳ chọn xuất hiện trước lệnh và được ứng dụng phân tích cú pháp:
Đã tích luỹ --distdir=<a path> lần sử dụng
Các nơi khác để tìm kiếm các tệp lưu trữ trước khi truy cập mạng để tải các tệp lưu trữ đó xuống.
Thẻ: bazel_internal_configuration
Nếu bạn đặt chính sách này, bộ nhớ đệm của kho lưu trữ sẽ liên kết cứng tệp đó trong trường hợp tệp bị tấn công vào bộ nhớ đệm, thay vì sao chép. Mục đích của tính năng này là tiết kiệm dung lượng ổ đĩa.
Thẻ: bazel_internal_configuration
Mặc định của --experimental_repository_downloader_retries=<an integer>: "0"
Số lần thử lại một lỗi tải xuống tối đa. Nếu bạn đặt chính sách này thành 0, thì tính năng thử lại sẽ tắt.
Thẻ: experimental
Mặc định của --experimental_scale_timeouts=<a double>: "1.0"
Điều chỉnh tỷ lệ tất cả thời gian chờ trong quy tắc lưu trữ Starlark theo hệ số này. Bằng cách này, kho lưu trữ bên ngoài có thể được tạo ra hoạt động trên các máy chậm hơn tác giả quy tắc dự kiến mà không cần thay đổi mã nguồn
Thẻ: bazel_internal_configuration, experimental
Mặc định của --http_connector_attempts=<an integer>: "8"
Số lần thử tải xuống http tối đa.
Thẻ: bazel_internal_configuration
Mặc định của --http_connector_retry_max_timeout=<An immutable length of time.>: "0 giây"
Thời gian chờ tối đa cho các lần thử tải xuống lại http. Với giá trị 0, không có thời gian chờ tối đa nào được xác định.
Thẻ: bazel_internal_configuration
Mặc định của --http_timeout_scaling=<a double>: "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ố cụ thể
Thẻ: bazel_internal_configuration
Mặc định của --repository_cache=<a path>: 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. Một chuỗi trống làm đối số yêu cầu tắt bộ nhớ đệm, nếu không, hệ thống sẽ sử dụng giá trị mặc định của '<output_user_root>/cache/repos/v1'
Thẻ: bazel_internal_configuration
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ị vô hiệu hoá hoàn toàn; ctx.exe vẫn có thể chạy một tệp thực thi tuỳ ý truy cập vào Internet.
Thẻ: bazel_internal_configuration
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 --gc_thrashing_threshold=<an integer in 0-100 range>: "100"
Tỷ lệ phần trăm không gian đã sử dụng đã sử dụng (0 – 100) trên đó 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 giá trị này thành 100, thì GcThrashingDetector sẽ tắt.
Thẻ: host_machine_resource_optimizations
Giá trị mặc định của --[no]keep_going [-k]: "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 đạt và những mục tiêu phụ thuộc vào mục tiêu đó, nhưng bạn có thể phải đáp ứng 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
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ố lượng luồng song song cần dùng cho giai đoạn tải/phân tích. Lấy một số nguyên hoặc từ khoá ("auto", "HOST_CPUS", "HOST_RAM"), theo sau (không bắt buộc) là một thao tác ([-|*]<float>), ví dụ: "auto", "HOST_CPUS*.5". "auto" đặt giá trị mặc định hợp lý dựa trên tài nguyên máy chủ. Giá trị phải lớn hơn hoặc bằng 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 tệp BUILD, tệp .bzl hoặc tệp WORKSPACE.:
Mặc định của --[no]incompatible_config_setting_private_default_visibility: "false"
Nếu không tương thích_enforce_config_setting_visible=false, thì đây là lỗi không phù hợp. Ngoài ra, nếu cờ này sai, thì mọi config_setting không có thuộc tính chế độ hiển thị rõ ràng sẽ là //visible:public. Nếu cờ này là true, config_setting sẽ tuân theo cùng logic hiển thị 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
Mặc định của --[no]incompatible_enforce_config_setting_visibility: "đúng"
Nếu đúng, hãy thực thi các hạn chế về chế độ hiển thị config_setting. Nếu giá trị là false, mọi config_setting sẽ 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":
Giá trị mặc định của --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>: "<root>"
Chỉ định một mô-đun tương ứng với kho lưu trữ mục tiêu đã chỉ định sẽ được diễn giải.
Thẻ: terminal_output
Mặc định của --charset=<utf8 or ascii>: "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
Mặc định của --[no]cycles: "false"
Chỉ ra các chu kỳ phần phụ thuộc bên trong cây hiển thị mà thường bị bỏ qua theo mặc định.
Thẻ: terminal_output
Mặc định của --depth=<an integer>: "-1"
Độ sâu hiển thị tối đa của cây phần phụ thuộc. Độ sâu 1 sẽ hiển thị các phần phụ thuộc trực tiếp, chẳng hạn như vậy. Đối với Tree, path và all_paths, giá trị mặc định là Integer.MAX_VALUE, trong khi đối với phần phụ thuộc và giải thích, giá trị mặc định là 1 (chỉ hiển thị các phần phụ thuộc trực tiếp của gốc bên cạnh các lá đích và mẹ của chúng).
Thẻ: terminal_output
Mặc định của --extension_filter=<a comma-separated list of <extension>s>: xem nội dung mô tả
Chỉ cho thấy cách sử dụng các tiện ích mô-đun này và repos do các tiện ích đó tạo nếu bạn đã đặt các 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 mô-đun sử dụng phần mở rộng được chỉ định. Danh sách trống sẽ vô hiệu hoá bộ lọc, chỉ định tất cả các phần mở rộng có thể có một cách hiệu quả.
Thẻ: terminal_output
Mặc định của --extension_info=<hidden, usages, repos or all>: "ẩn"
Chỉ định mức độ chi tiết về việc sử dụng tiện ích cần đưa vào kết quả truy vấn. "Sử dụng" sẽ chỉ hiển thị tên tiện ích, "repos" cũng sẽ bao gồm các kho lưu trữ được nhập bằng use_repo và "all" cũng sẽ hiển thị các kho lưu trữ khác do tiện ích tạo ra.
Thẻ: terminal_output
Mặc định của --extension_usages=<a comma-separated list of <module>s>: ""
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
Giá trị mặc định của --from=<a comma-separated list of <module>s>: "<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 phần 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
Mặc định của --[no]include_builtin: "false"
Đưa các mô-đun tích hợp vào biểu đồ phần phụ thuộc. Tắt theo mặc định vì chế độ này khá ồn.
Thẻ: terminal_output
Mặc định của --[no]include_unused: "false"
Các truy vấn cũng sẽ xem xét 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 các quy tắc ghi đè hoặc Lựa chọn phiên bản tối thiểu). Điều này có thể có các hiệu ứng khác nhau cho từng loại truy vấn, tức là bao gồm đường dẫn mới trong lệnh all_paths hoặc các phần phụ thuộc phụ trong lệnh giải thích.
Thẻ: terminal_output
Mặc định của --output=<text, json or graph>: "văn bản"
Định dạng in kết quả truy vấn. Các giá trị truy vấn được phép là: văn bản, json, biểu đồ
Thẻ: terminal_output
Mặc định của --[no]verbose: "false"
Truy vấn cũng sẽ hiển thị lý do tại sao 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à chỉ true (đúng) 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 Bzlmod:
Đã tích luỹ --allow_yanked_versions=<a string> lần sử dụng
Đã chỉ định các phiên bản mô-đun dưới dạng `<module1>@<version1>,<module2>@<version2>`. Những phiên bản này sẽ được 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 trong sổ đăng ký nơi chúng xuất phát (nếu các phiên bản đó không đến từ một NonRegistryOverride). Nếu không, các phiên bản bị giật sẽ khiến quá trình phân giải không thành công. Bạn cũng có thể xác định phiên bản được kéo mạnh được phép bằng biến môi trường "BZLMOD_ALLOW_YANKED_VERSIONS". Bạn có thể vô hiệu hoá việc kiểm tra này bằng cách sử dụng từ khoá 'all' (không được khuyến nghị).
Thẻ: loading_and_analysis
Mặc định của --check_bazel_compatibility=<error, warning or off>: "lỗi"
Kiểm tra khả năng tương thích với 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 đề lên trạng thái lỗi giải quyết, "tắt" để tắt chế độ kiểm tra, hoặc "cảnh báo" để in cảnh báo khi phát hiện thấy thông tin không khớp.
Thẻ: loading_and_analysis
Mặc định của --check_direct_dependencies=<off, warning or error>: "cảnh báo"
Kiểm tra xem các phần phụ thuộc trực tiếp "bazel_dep" được khai báo trong mô-đun gốc có giống với phiên bản bạn nhận được trong biểu đồ phần phụ thuộc đã được giải quyết hay không. Các giá trị hợp lệ là "off" ("tắt") để tắt chế độ kiểm tra, "cảnh báo" để in cảnh báo khi phát hiện thấy thông tin không khớp hoặc "error" để chuyển vấn đề lên thành lỗi giải quyết.
Thẻ: loading_and_analysis
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_secondary` trong MODULE.bazel của mô-đun gốc. Lưu ý rằng các phần phụ thuộc của 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
Mặc định của --lockfile_mode=<off, update or error>: "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 nếu có thay đổi, "error" khi dùng tệp khoá nhưng báo lỗi nếu tệp không được cập nhật, hoặc "tắt" để không đọc hoặc ghi vào tệp khoá.
Thẻ: loading_and_analysis
Đã tích luỹ --override_module=<an equals-separated mapping of module name to path> lần sử dụng
Ghi đè một mô-đun có đường dẫn cục bộ ở dạng <module name>=<path>. Nếu đường dẫn đã cho là một đường dẫn tuyệt đối, thì đường dẫn đó sẽ được sử dụng như nguyên trạng. Nếu đường dẫn đã cho là một đường dẫn tương đối, thì đường dẫn đó sẽ tương ứng với thư mục đang hoạt động hiện tại. Nếu đường dẫn đã cho bắt đầu bằng "%workspace%", thì đường dẫn đó 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 "không gian làm việc thông tin bazel")
Đã tích luỹ --registry=<a string> lần sử dụng
Chỉ định sổ đăng ký cần dùng để xác định vị trí các phần phụ thuộc của mô-đun Bazel. Thứ tự rất quan trọng: các mô-đun sẽ được tra cứu trước trong sổ đăng ký trước, và chỉ quay lại các sổ đăng ký sau khi còn thiếu trong các sổ đăng ký trước đó.
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:
Mặc định của --gc_thrashing_limits=<comma separated pairs of <period>:<count>>: "1s:2,20s:3,1m:5"
Các giới hạn mà nếu đạt đến mức này sẽ khiến GcThrashingDetector gây sự cố cho Bazel bằng OOM. Mỗi giới hạn được chỉ định dưới dạng <period>:<count>, trong đó khoảng thời gian là một khoảng thời gian và số lượng là một số nguyên dương. Nếu có hơn --gc_thrashing_threshold phần trăm không gian cần sử dụng (vùng nhớ khối xếp thế hệ cũ) vẫn chiếm sau <count> các GC đầy đủ liên tiếp trong khoảng <period>, thì OOM sẽ được kích hoạt. Bạn có thể chỉ định nhiều hạn mức và phân tách bằng dấu phẩy.
Thẻ: host_machine_resource_optimizations
Mặc định của --skyframe_high_water_mark_full_gc_drops_per_invocation=<an integer, >= 0>: "2147483647"
Gắn cờ cho cấu hình nâng cao của công cụ Skyframe nội bộ của Bazel. Nếu Bazel phát hiện thấy 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 đặt ra bằng --skyframe_high_water_mark_threshold, thì khi một sự kiện GC xảy ra đầy đủ, trạng thái Skyframe tạm thời không cần thiết sẽ bị bỏ qua, tối đa nhiều lần cho mỗi lệnh gọi. Mặc định là Integer.MAX_VALUE; không giới hạn hiệu quả. 0 có nghĩa là các sự kiện thu gom rác (GC) toàn bộ sẽ không bao giờ kích hoạt hiện tượng giảm. Nếu đạt đến giới hạn, trạng thái Skyframe sẽ không còn bị bỏ qua khi một sự kiện GC đầy đủ xảy ra và vượt quá ngưỡng tỷ lệ phần trăm vùng nhớ khối xếp được giữ lại đó.
Thẻ: host_machine_resource_optimizations
Mặc định của --skyframe_high_water_mark_minor_gc_drops_per_invocation=<an integer, >= 0>: "2147483647"
Gắn cờ cho cấu hình nâng cao của công cụ Skyframe nội bộ của Bazel. Nếu Bazel phát hiện thấy mức sử dụng tỷ lệ phần trăm vùng nhớ khối xếp được giữ lại vượt quá ngưỡng đặt ra bằng --skyframe_high_water_mark_threshold, thì khi một sự kiện GC nhỏ xảy ra, trạng thái Skyframe tạm thời không cần thiết sẽ bị bỏ qua, tối đa là nhiều lần cho mỗi lệnh gọi. Mặc định là Integer.MAX_VALUE; không giới hạn hiệu quả. 0 có nghĩa là các sự kiện GC nhỏ sẽ không bao giờ kích hoạt hiện tượng giảm. Nếu đạt đến giới hạn, trạng thái Skyframe sẽ không còn bị bỏ qua khi xảy ra một sự kiện GC nhỏ và ngưỡng tỷ lệ phần trăm vùng nhớ khối xếp được giữ lại đó đã vượt quá.
Thẻ: host_machine_resource_optimizations
Mặc định của --skyframe_high_water_mark_threshold=<an integer>: "85"
Gắn cờ cho cấu hình nâng cao của công cụ Skyframe nội bộ của Bazel. Nếu Bazel 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 ở ngưỡng này, thì Bazel sẽ bỏ trạng thái Skyframe tạm thời không cần thiết. Việc chỉnh sửa tính năng này có thể cho phép bạn giảm thiểu tác động của tình trạng này đến thời gian sử dụng GC, khi tình trạng giật GC là do việc sử dụng bộ nhớ ở trạng thái tạm thời này gây ra và (ii) tốn kém hơn so với việc khôi phục trạng thái khi cần.
Thẻ: host_machine_resource_optimizations
Các tuỳ chọn ảnh hưởng đến độ chi tiết, định dạng hoặc vị trí ghi nhật ký:
Mặc định của --[no]experimental_command_profile: "false"
Ghi lại hồ sơ CPU của Trình ghi chuyến bay Java vào tệp profile.jfr trong thư mục cơ sở đầu ra. Trong tương lai, cú pháp và ngữ nghĩa của cờ này có thể thay đổi để hỗ trợ nhiều loại hồ sơ hoặc định dạng đầu ra; bạn tự chịu rủi ro khi sử dụng.
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 thao tác ghi nhớ 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ả chức năng ghi nhớ.
Các tuỳ chọn chỉ định hoặc thay đổi dữ liệu đầu vào chung thành lệnh Bazel mà không thuộc các danh mục khác.:
Mặc định của --experimental_resolved_file_instead_of_workspace=<a string>: ""
Nếu nội dung không trống, hãy đọc tệp đã được phân giải được chỉ định thay vì tệp WORKSPACE
Các thẻ: changes_inputs
Các tuỳ chọn thực thi và lưu vào bộ nhớ đệm từ xa:
Mặc định của --experimental_downloader_config=<a string>: 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ủ (cho `allow` và `block`) hoặc hai mẫu, một mẫu để so khớp và một mẫu dùng làm URL thay thế, có tham chiếu ngược bắt đầu từ "$1". Có thể có nhiều lệnh "rewrite" cho cùng một URL và trong trường hợp này sẽ có nhiều URL được trả về.
Mặc định của --experimental_worker_for_repo_fetching=<off, platform or virtual>: "tắt"
Chế độ phân luồng dùng để tìm nạp kho lưu trữ. Nếu bạn đặt chính sách này thành "tắt", thì sẽ không có luồng worker nào được sử dụng và quá trình tìm nạp kho lưu trữ có thể khởi động lại. Ngược lại, hãy sử dụng luồng nền tảng (tức là luồng hệ điều hành) nếu được đặt thành "platform" hoặc luồng ảo nếu được đặt thành "virtual".
Các lựa chọn khác, không được phân loại.:
Đã tích luỹ --deleted_packages=<comma-separated list of package names> lần sử dụng
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 những gói này xuất hiện ở vị trí nào đó trên đường dẫn gói. Sử dụng tuỳ chọn này khi xoá gói con "x/y" của 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ể báo cáo 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. Chỉ định --delete_packages x/y sẽ tránh được sự cố này.
Đã tích luỹ --override_repository=<an equals-separated mapping of repository name to path> lần sử dụng
Ghi đè một 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à một đường dẫn tuyệt đối, thì đường dẫn đó sẽ được sử dụng nguyên vẹn. Nếu đường dẫn đã cho là một đườ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 đó 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 "không gian làm việc thông tin bazel")
Giá trị mặc định của --package_path=<colon-separated list of options>: "%workspace%"
Danh sách được phân tách bằng dấu hai chấm nơi bạn sẽ tìm thấy 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 xung quanh. Nếu bị bỏ qua hoặc để trống, giá trị mặc định sẽ là dữ liệu đầu ra của "bazel info default-package-path".
Mặc định của --[no]show_loading_progress: "đúng"
Nếu bạn bật tuỳ chọn này, Bazel sẽ in thông báo "Đang tải gói:".

Kế thừa tất cả các tuỳ chọn của bản dựng.

Các tuỳ chọn xuất hiện trước lệnh và được ứng dụng phân tích cú pháp:
Đã tích luỹ --distdir=<a path> lần sử dụng
Các nơi khác để tìm kiếm các tệp lưu trữ trước khi truy cập mạng để tải các tệp lưu trữ đó xuống.
Thẻ: bazel_internal_configuration
Nếu bạn đặt chính sách này, bộ nhớ đệm của kho lưu trữ sẽ liên kết cứng tệp đó trong trường hợp tệp bị tấn công vào bộ nhớ đệm, thay vì sao chép. Mục đích của tính năng này là tiết kiệm dung lượng ổ đĩa.
Thẻ: bazel_internal_configuration
Mặc định của --experimental_repository_downloader_retries=<an integer>: "0"
Số lần thử lại một lỗi tải xuống tối đa. Nếu bạn đặt chính sách này thành 0, thì tính năng thử lại sẽ tắt.
Thẻ: experimental
Mặc định của --experimental_scale_timeouts=<a double>: "1.0"
Điều chỉnh tỷ lệ tất cả thời gian chờ trong quy tắc lưu trữ Starlark theo hệ số này. Bằng cách này, kho lưu trữ bên ngoài có thể được tạo ra hoạt động trên các máy chậm hơn tác giả quy tắc dự kiến mà không cần thay đổi mã nguồn
Thẻ: bazel_internal_configuration, experimental
Mặc định của --http_connector_attempts=<an integer>: "8"
Số lần thử tải xuống http tối đa.
Thẻ: bazel_internal_configuration
Mặc định của --http_connector_retry_max_timeout=<An immutable length of time.>: "0 giây"
Thời gian chờ tối đa cho các lần thử tải xuống lại http. Với giá trị 0, không có thời gian chờ tối đa nào được xác định.
Thẻ: bazel_internal_configuration
Mặc định của --http_timeout_scaling=<a double>: "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ố cụ thể
Thẻ: bazel_internal_configuration
Mặc định của --repository_cache=<a path>: 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. Một chuỗi trống làm đối số yêu cầu tắt bộ nhớ đệm, nếu không, hệ thống sẽ sử dụng giá trị mặc định của '<output_user_root>/cache/repos/v1'
Thẻ: bazel_internal_configuration
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ị vô hiệu hoá hoàn toàn; ctx.exe vẫn có thể chạy một tệp thực thi tuỳ ý truy cập vào Internet.
Thẻ: bazel_internal_configuration
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 --gc_thrashing_threshold=<an integer in 0-100 range>: "100"
Tỷ lệ phần trăm không gian đã sử dụng đã sử dụng (0 – 100) trên đó 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 giá trị này thành 100, thì GcThrashingDetector sẽ tắt.
Thẻ: host_machine_resource_optimizations
Các tuỳ chọn liên quan đến đầu ra và ngữ nghĩa Bzlmod:
Đã tích luỹ --allow_yanked_versions=<a string> lần sử dụng
Đã chỉ định các phiên bản mô-đun dưới dạng `<module1>@<version1>,<module2>@<version2>`. Những phiên bản này sẽ được 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 trong sổ đăng ký nơi chúng xuất phát (nếu các phiên bản đó không đến từ một NonRegistryOverride). Nếu không, các phiên bản bị giật sẽ khiến quá trình phân giải không thành công. Bạn cũng có thể xác định phiên bản được kéo mạnh được phép bằng biến môi trường "BZLMOD_ALLOW_YANKED_VERSIONS". Bạn có thể vô hiệu hoá việc kiểm tra này bằng cách sử dụng từ khoá 'all' (không được khuyến nghị).
Thẻ: loading_and_analysis
Mặc định của --check_bazel_compatibility=<error, warning or off>: "lỗi"
Kiểm tra khả năng tương thích với 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 đề lên trạng thái lỗi giải quyết, "tắt" để tắt chế độ kiểm tra, hoặc "cảnh báo" để in cảnh báo khi phát hiện thấy thông tin không khớp.
Thẻ: loading_and_analysis
Mặc định của --check_direct_dependencies=<off, warning or error>: "cảnh báo"
Kiểm tra xem các phần phụ thuộc trực tiếp "bazel_dep" được khai báo trong mô-đun gốc có giống với phiên bản bạn nhận được trong biểu đồ phần phụ thuộc đã được giải quyết hay không. Các giá trị hợp lệ là "off" ("tắt") để tắt chế độ kiểm tra, "cảnh báo" để in cảnh báo khi phát hiện thấy thông tin không khớp hoặc "error" để chuyển vấn đề lên thành lỗi giải quyết.
Thẻ: loading_and_analysis
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_secondary` trong MODULE.bazel của mô-đun gốc. Lưu ý rằng các phần phụ thuộc của 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
Mặc định của --lockfile_mode=<off, update or error>: "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 nếu có thay đổi, "error" khi dùng tệp khoá nhưng báo lỗi nếu tệp không được cập nhật, hoặc "tắt" để không đọc hoặc ghi vào tệp khoá.
Thẻ: loading_and_analysis
Đã tích luỹ --override_module=<an equals-separated mapping of module name to path> lần sử dụng
Ghi đè một mô-đun có đường dẫn cục bộ ở dạng <module name>=<path>. Nếu đường dẫn đã cho là một đường dẫn tuyệt đối, thì đường dẫn đó sẽ được sử dụng như nguyên trạng. Nếu đường dẫn đã cho là một đường dẫn tương đối, thì đường dẫn đó sẽ tương ứng với thư mục đang hoạt động hiện tại. Nếu đường dẫn đã cho bắt đầu bằng "%workspace%", thì đường dẫn đó 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 "không gian làm việc thông tin bazel")
Đã tích luỹ --registry=<a string> lần sử dụng
Chỉ định sổ đăng ký cần dùng để xác định vị trí các phần phụ thuộc của mô-đun Bazel. Thứ tự rất quan trọng: các mô-đun sẽ được tra cứu trước trong sổ đăng ký trước, và chỉ quay lại các sổ đăng ký sau khi còn thiếu trong các sổ đăng ký trước đó.
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:
Mặc định của --gc_thrashing_limits=<comma separated pairs of <period>:<count>>: "1s:2,20s:3,1m:5"
Các giới hạn mà nếu đạt đến mức này sẽ khiến GcThrashingDetector gây sự cố cho Bazel bằng OOM. Mỗi giới hạn được chỉ định dưới dạng <period>:<count>, trong đó khoảng thời gian là một khoảng thời gian và số lượng là một số nguyên dương. Nếu có hơn --gc_thrashing_threshold phần trăm không gian cần sử dụng (vùng nhớ khối xếp thế hệ cũ) vẫn chiếm sau <count> các GC đầy đủ liên tiếp trong khoảng <period>, thì OOM sẽ được kích hoạt. Bạn có thể chỉ định nhiều hạn mức và phân tách bằng dấu phẩy.
Thẻ: host_machine_resource_optimizations
Mặc định của --skyframe_high_water_mark_full_gc_drops_per_invocation=<an integer, >= 0>: "2147483647"
Gắn cờ cho cấu hình nâng cao của công cụ Skyframe nội bộ của Bazel. Nếu Bazel phát hiện thấy 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 đặt ra bằng --skyframe_high_water_mark_threshold, thì khi một sự kiện GC xảy ra đầy đủ, trạng thái Skyframe tạm thời không cần thiết sẽ bị bỏ qua, tối đa nhiều lần cho mỗi lệnh gọi. Mặc định là Integer.MAX_VALUE; không giới hạn hiệu quả. 0 có nghĩa là các sự kiện thu gom rác (GC) toàn bộ sẽ không bao giờ kích hoạt hiện tượng giảm. Nếu đạt đến giới hạn, trạng thái Skyframe sẽ không còn bị bỏ qua khi một sự kiện GC đầy đủ xảy ra và vượt quá ngưỡng tỷ lệ phần trăm vùng nhớ khối xếp được giữ lại đó.
Thẻ: host_machine_resource_optimizations
Mặc định của --skyframe_high_water_mark_minor_gc_drops_per_invocation=<an integer, >= 0>: "2147483647"
Gắn cờ cho cấu hình nâng cao của công cụ Skyframe nội bộ của Bazel. Nếu Bazel phát hiện thấy mức sử dụng tỷ lệ phần trăm vùng nhớ khối xếp được giữ lại vượt quá ngưỡng đặt ra bằng --skyframe_high_water_mark_threshold, thì khi một sự kiện GC nhỏ xảy ra, trạng thái Skyframe tạm thời không cần thiết sẽ bị bỏ qua, tối đa là nhiều lần cho mỗi lệnh gọi. Mặc định là Integer.MAX_VALUE; không giới hạn hiệu quả. 0 có nghĩa là các sự kiện GC nhỏ sẽ không bao giờ kích hoạt hiện tượng giảm. Nếu đạt đến giới hạn, trạng thái Skyframe sẽ không còn bị bỏ qua khi xảy ra một sự kiện GC nhỏ và ngưỡng tỷ lệ phần trăm vùng nhớ khối xếp được giữ lại đó đã vượt quá.
Thẻ: host_machine_resource_optimizations
Mặc định của --skyframe_high_water_mark_threshold=<an integer>: "85"
Gắn cờ cho cấu hình nâng cao của công cụ Skyframe nội bộ của Bazel. Nếu Bazel 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 ở ngưỡng này, thì Bazel sẽ bỏ trạng thái Skyframe tạm thời không cần thiết. Việc chỉnh sửa tính năng này có thể cho phép bạn giảm thiểu tác động của tình trạng này đến thời gian sử dụng GC, khi tình trạng giật GC là do việc sử dụng bộ nhớ ở trạng thái tạm thời này gây ra và (ii) tốn kém hơn so với việc khôi phục trạng thái khi cần.
Thẻ: host_machine_resource_optimizations
Các tuỳ chọn ảnh hưởng đến độ chi tiết, định dạng hoặc vị trí ghi nhật ký:
Mặc định của --[no]experimental_command_profile: "false"
Ghi lại hồ sơ CPU của Trình ghi chuyến bay Java vào tệp profile.jfr trong thư mục cơ sở đầu ra. Trong tương lai, cú pháp và ngữ nghĩa của cờ này có thể thay đổi để hỗ trợ nhiều loại hồ sơ hoặc định dạng đầu ra; bạn tự chịu rủi ro khi sử dụng.
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 thao tác ghi nhớ 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ả chức năng ghi nhớ.
Các tuỳ chọn chỉ định hoặc thay đổi dữ liệu đầu vào chung thành lệnh Bazel mà không thuộc các danh mục khác.:
Mặc định của --experimental_resolved_file_instead_of_workspace=<a string>: ""
Nếu nội dung không trống, hãy đọc tệp đã được phân giải được chỉ định thay vì tệp WORKSPACE
Các thẻ: changes_inputs
Các tuỳ chọn thực thi và lưu vào bộ nhớ đệm từ xa:
Mặc định của --experimental_downloader_config=<a string>: 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ủ (cho `allow` và `block`) hoặc hai mẫu, một mẫu để so khớp và một mẫu dùng làm URL thay thế, có tham chiếu ngược bắt đầu từ "$1". Có thể có nhiều lệnh "rewrite" cho cùng một URL và trong trường hợp này sẽ có nhiều URL được trả về.
Mặc định của --experimental_worker_for_repo_fetching=<off, platform or virtual>: "tắt"
Chế độ phân luồng dùng để tìm nạp kho lưu trữ. Nếu bạn đặt chính sách này thành "tắt", thì sẽ không có luồng worker nào được sử dụng và quá trình tìm nạp kho lưu trữ có thể khởi động lại. Ngược lại, hãy sử dụng luồng nền tảng (tức là luồng hệ điều hành) nếu được đặt thành "platform" hoặc luồng ảo nếu được đặt thành "virtual".
Các lựa chọn khác, không được phân loại.:
Đã tích luỹ --override_repository=<an equals-separated mapping of repository name to path> lần sử dụng
Ghi đè một 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à một đường dẫn tuyệt đối, thì đường dẫn đó sẽ được sử dụng nguyên vẹn. Nếu đường dẫn đã cho là một đườ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 đó 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 "không gian làm việc thông tin bazel")
Đã tích luỹ --print_action_mnemonics=<a string> lần sử dụng
Liệt kê những hoạt động ghi nhớ để lọc dữ liệu print_action, không có quá trình 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 ứng dụng phân tích cú pháp:
Đã tích luỹ --distdir=<a path> lần sử dụng
Các nơi khác để tìm kiếm các tệp lưu trữ trước khi truy cập mạng để tải các tệp lưu trữ đó xuống.
Thẻ: bazel_internal_configuration
Nếu bạn đặt chính sách này, bộ nhớ đệm của kho lưu trữ sẽ liên kết cứng tệp đó trong trường hợp tệp bị tấn công vào bộ nhớ đệm, thay vì sao chép. Mục đích của tính năng này là tiết kiệm dung lượng ổ đĩa.
Thẻ: bazel_internal_configuration
Mặc định của --experimental_repository_downloader_retries=<an integer>: "0"
Số lần thử lại một lỗi tải xuống tối đa. Nếu bạn đặt chính sách này thành 0, thì tính năng thử lại sẽ tắt.
Thẻ: experimental
Mặc định của --experimental_scale_timeouts=<a double>: "1.0"
Điều chỉnh tỷ lệ tất cả thời gian chờ trong quy tắc lưu trữ Starlark theo hệ số này. Bằng cách này, kho lưu trữ bên ngoài có thể được tạo ra hoạt động trên các máy chậm hơn tác giả quy tắc dự kiến mà không cần thay đổi mã nguồn
Thẻ: bazel_internal_configuration, experimental
Mặc định của --http_connector_attempts=<an integer>: "8"
Số lần thử tải xuống http tối đa.
Thẻ: bazel_internal_configuration
Mặc định của --http_connector_retry_max_timeout=<An immutable length of time.>: "0 giây"
Thời gian chờ tối đa cho các lần thử tải xuống lại http. Với giá trị 0, không có thời gian chờ tối đa nào được xác định.
Thẻ: bazel_internal_configuration
Mặc định của --http_timeout_scaling=<a double>: "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ố cụ thể
Thẻ: bazel_internal_configuration
Mặc định của --repository_cache=<a path>: 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. Một chuỗi trống làm đối số yêu cầu tắt bộ nhớ đệm, nếu không, hệ thống sẽ sử dụng giá trị mặc định của '<output_user_root>/cache/repos/v1'
Thẻ: bazel_internal_configuration
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ị vô hiệu hoá hoàn toàn; ctx.exe vẫn có thể chạy một tệp thực thi tuỳ ý truy cập vào Internet.
Thẻ: bazel_internal_configuration
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 --gc_thrashing_threshold=<an integer in 0-100 range>: "100"
Tỷ lệ phần trăm không gian đã sử dụng đã sử dụng (0 – 100) trên đó 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 giá trị này thành 100, thì GcThrashingDetector sẽ tắt.
Thẻ: host_machine_resource_optimizations
Giá trị mặc định của --[no]keep_going [-k]: "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 đạt và những mục tiêu phụ thuộc vào mục tiêu đó, nhưng bạn có thể phải đáp ứng 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
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ố lượng luồng song song cần dùng cho giai đoạn tải/phân tích. Lấy một số nguyên hoặc từ khoá ("auto", "HOST_CPUS", "HOST_RAM"), theo sau (không bắt buộc) là một thao tác ([-|*]<float>), ví dụ: "auto", "HOST_CPUS*.5". "auto" đặt giá trị mặc định hợp lý dựa trên tài nguyên máy chủ. Giá trị phải lớn hơn hoặc bằng 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 tệp BUILD, tệp .bzl hoặc tệp WORKSPACE.:
Mặc định của --[no]incompatible_config_setting_private_default_visibility: "false"
Nếu không tương thích_enforce_config_setting_visible=false, thì đây là lỗi không phù hợp. Ngoài ra, nếu cờ này sai, thì mọi config_setting không có thuộc tính chế độ hiển thị rõ ràng sẽ là //visible:public. Nếu cờ này là true, config_setting sẽ tuân theo cùng logic hiển thị 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
Mặc định của --[no]incompatible_enforce_config_setting_visibility: "đúng"
Nếu đúng, hãy thực thi các hạn chế về chế độ hiển thị config_setting. Nếu giá trị là false, mọi config_setting sẽ 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 dữ liệu đầu ra của truy vấn và ngữ nghĩa:
Giá trị mặc định của --aspect_deps=<off, conservative or precise>: "thận trọng"
Cách giải quyết các phần phụ thuộc khung hình khi định dạng đầu ra là {xml,proto,record}. "tắt" có nghĩa là không có phần phụ thuộc khung hình nào được phân giải, "bảo toàn" (mặc định) có nghĩa là tất cả các phần phụ thuộc khung hình đã khai báo đều được thêm vào bất kể các phần phụ thuộc đó 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ỉ các khía cạnh có thể đang hoạt động dựa trên lớp quy tắc của phần phụ thuộc trực tiếp. 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 đó khiến nó chậm hơn so với các chế độ khác. Cũng 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 được chạy trong "truy vấn bazel".
Thẻ: build_file_semantics
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ể là do hàm <code>str</code> Starlark áp dụng cho thực thể <code>Label</code>. Điều này rất hữu ích cho các công cụ cần khớp với kết quả của nhiều lệnh truy vấn và/hoặc nhãn do quy tắc đưa ra. Nếu không được bật, các trình định dạng đầu ra sẽ tự do phát ra tên kho lưu trữ rõ ràng (tương ứng với kho lưu trữ chính) để giúp kết quả dễ đọc hơn.
Thẻ: terminal_output
Mặc định của --[no]experimental_graphless_query: "tự động"
Nếu đúng, sử dụng phương thức triển khai Truy vấn không tạo bản sao của biểu đồ. Việc triển khai mới chỉ hỗ trợ --order_output=no, cũng như chỉ một tập hợp con các trình định dạng đầu ra.
Thẻ: build_file_semantics, eagerness_to_exit
Mặc định của --graph:conditional_edges_limit=<an integer>: "4"
Số lượng nhãn điều kiện tối đa được hiển thị. -1 có nghĩa là không cắt bớt và 0 có nghĩa là không có chú thích. Tuỳ chọn này chỉ áp dụng cho --output=map.
Thẻ: terminal_output
Mặc định của --[no]graph:factored: "đúng"
Nếu đúng, thì biểu đồ sẽ được phát ra "đã được tính thành phần", tức là các nút tương đương về mặt cấu trúc liên kết sẽ được hợp nhất với nhau và các nhãn của chúng được nối với nhau. Tuỳ chọn này chỉ áp dụng cho --output=map.
Thẻ: terminal_output
Mặc định của --graph:node_limit=<an integer>: "512"
Độ dài tối đa của chuỗi nhãn cho một nút biểu đồ trong đầu ra. Các nhãn dài hơn sẽ bị cắt bớt; -1 có nghĩa là không bị cắt bớt. Tuỳ chọn này chỉ áp dụng cho --output=map.
Thẻ: terminal_output
Mặc định của --[no]implicit_deps: "đúng"
Nếu được bật, các phần phụ thuộc ngầm ẩn 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 thêm bởi bazel. Đối với cquery, tuỳ chọn này kiểm soát việc lọc các chuỗi công cụ đã được phân giải.
Thẻ: build_file_semantics
Mặc định của --[no]include_aspects: "đúng"
aquery, cquery: liệu có bao gồm các hành động do khía cạnh tạo ra trong kết quả không. query: no-op (các khía cạnh luôn được tuân theo).
Thẻ: terminal_output
Mặc định của --[no]incompatible_lexicographical_output: "đúng"
Nếu bạn đặt tuỳ chọn này, hãy sắp xếp --order_output=tự động đầu ra theo thứ tự từ điển.
Thẻ: terminal_output, incompatible_change
Mặc định của --[no]incompatible_package_group_includes_double_slash: "đúng"
Nếu bạn bật chế độ này, khi xuất thuộc tính "packages" của package_group, thuộc tính "//" ở đầu sẽ không bị bỏ qua.
Thẻ: terminal_output, incompatible_change
Mặc định của --[no]infer_universe_scope: "false"
Nếu bạn không đặt và --universe_scope, thì giá trị của --universe_scope sẽ được suy luận dưới dạng danh sách các mẫu mục tiêu duy nhất trong biểu thức truy vấn. Lưu ý rằng giá trị --universe_scope được suy luận cho biểu thức truy vấn sử dụng các hàm trong phạm vi toàn bộ (ví dụ:`allrdeps`) có thể không phải là điều bạn muốn, vì vậy, bạn chỉ nên sử dụng tùy chọn này nếu biết mình đang làm gì. Hãy tham khảo tại 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 tùy chọn này sẽ bị bỏ qua. Lưu ý: lựa chọn này chỉ áp dụng cho "truy vấn" (tức là không áp dụng cho "cquery").
Thẻ: loading_and_analysis
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
Mặc định của --[no]nodep_deps: "đúng"
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 nơi truy vấn hoạt động. Một ví dụ phổ biến về thuộc tính "nodep" là "khả năng hiển thị". Chạy và phân tích cú pháp kết quả của "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ự. Đầu ra không theo thứ tự nhanh hơn nhưng chỉ được hỗ trợ khi --đầu ra không phải là minrank, maxrank hoặc đồ thị.
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
Mặc định của --order_output=<no, deps, auto or full>: "tự động"
Cho kết quả theo thứ tự không theo thứ tự (no), phần phụ thuộc theo thứ tự (phần phụ thuộc) hoặc thứ tự đầy đủ (đầy đủ). Giá trị mặc định là 'auto', nghĩa là kết quả được sắp xếp theo thứ tự phụ thuộc hoặc đầy đủ, tuỳ thuộc vào trình định dạng đầu ra (được sắp xếp theo thứ tự phụ thuộc cho proto, minrank, maxrank và biểu đồ, được sắp xếp theo thứ tự đầy đủ cho tất cả các yếu tố khác). Khi kết quả đượ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 lượt tìm kiếm ưu tiên theo chiều sâu sau, trong đó các cạnh đi tới các nút chưa truy cập sẽ được di chuyển theo thứ tự bảng chữ cái của các nút kế thừa. Cuối cùng, các nút được in theo thứ tự đảo ngược với thứ tự mà chúng đượ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ự. Đầu ra không theo thứ tự nhanh hơn nhưng chỉ được hỗ trợ khi --đầu ra không phải là minrank, maxrank hoặc đồ thị.
Mở rộng thành:
  --order_output=auto

Thẻ: terminal_output
Mặc định của --output=<a string>: "label"
Định dạng in kết quả truy vấn. Các giá trị được cho phép đối với truy vấn là: build, graph, stream_jsonproto, label, label_ kind, location, maxrank, minrank, package, proto, stream_proto, textproto, xml.
Thẻ: terminal_output
Mặc định của --[no]proto:default_values: "đúng"
Nếu đúng thì các thuộc tính có giá trị không được chỉ định rõ trong tệp BUILD sẽ được bao gồm; nếu không thì các thuộc tính này sẽ bị bỏ qua. Tuỳ chọn này áp dụng cho --output=proto
Thẻ: terminal_output
Mặc định của --[no]proto:definition_stack: "false"
Điền trường proto manifest_stack. Trường này ghi lại từng thực thể quy tắc cho 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
Mặc định của --[no]proto:flatten_selects: "đúng"
Nếu bạn bật chính sách này, các thuộc tính có thể định cấu hình do Select() tạo ra sẽ được làm phẳng. Đối với loại danh sách, cách biểu diễn đã làm phẳng là danh sách chứa từng giá trị của bản đồ chọn đúng một lần. Các loại vô hướng được làm phẳng thành giá trị rỗng.
Thẻ: build_file_semantics
Mặc định của --[no]proto:include_attribute_source_aspects: "false"
Điền trường proto source_aspect_name của mỗi Thuộc tính bằng khía cạnh nguồn của thuộc tính (chuỗi trống nếu không phải là chuỗi).
Thẻ: terminal_output
Mặc định của --[no]proto:include_synthetic_attribute_hash: "false"
Liệu có nên tính toán và điền thuộc tính $internal_attr_hash hay không.
Thẻ: terminal_output
Mặc định của --[no]proto:instantiation_stack: "false"
Điền ngăn xếp lệnh gọi tạo thực thể của từng quy tắc. Lưu ý rằng điều này yêu cầu ngăn xếp phải hiển thị
Thẻ: terminal_output
Mặc định của --[no]proto:locations: "đúng"
Liệu có xuất thông tin vị trí ở đầu ra proto hay không.
Thẻ: terminal_output
Mặc định của --proto:output_rule_attrs=<comma-separated list of options>: "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 kết quả. Giá trị mặc định là tất cả thuộc tính. Đặt thành chuỗi trống để không xuất bất kỳ thuộc tính nào. Tuỳ chọn này có thể áp dụng cho --output=proto.
Thẻ: terminal_output
Mặc định của --[no]proto:rule_inputs_and_outputs: "đúng"
Liệu có nên điền các trường Rule_input và Rule_output hay không.
Thẻ: terminal_output
Mặc định của --query_file=<a string>: ""
Nếu bạn đặt chính sách này, truy vấn sẽ đọc truy vấn từ tệp có tên ở đây, thay vì trên dòng lệnh. Sẽ xảy ra lỗi khi chỉ định tệp tại đây cũng như truy vấn dòng lệnh.
Thẻ: changes_inputs
Mặc định của --[no]relative_locations: "false"
Nếu đúng, vị trí của các tệp BUILD trong xml và kết quả proto sẽ là tương đối. Theo mặc định, dữ liệu vị trí đầu ra 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 true để có kết quả nhất quán trên các máy.
Thẻ: terminal_output
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 một test_suite chứa các mục tiêu không phải mục tiêu kiểm thử.
Thẻ: build_file_semantics, eagerness_to_exit
Mặc định của --[no]tool_deps: "đúng"
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 qua đó. Cạnh phụ thuộc "exec configuration" (Cấu hình thực thi) (chẳng hạn như cạnh từ quy tắc "proto_library" bất kỳ đến Protocol Compiler (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 tạo bản dựng thay vì một phần của cùng một chương trình "target" (mục tiêu). Cquery: Nếu bị tắt, hãy 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 được đị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ó 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, chỉ các mục tiêu đã định cấu hình thực thi mới được trả về. Tuỳ chọn này sẽ KHÔNG loại trừ các chuỗi công cụ đã được phân giải.
Thẻ: build_file_semantics
Mặc định của --universe_scope=<comma-separated list of options>: ""
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 (cộng và trừ). Truy vấn có thể được thực hiện trong vũ trụ được xác định bằng việc đóng bắc cầu 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à mục tiêu mà tất cả câu trả lời đều được tạo và do đó, tuỳ chọn này có thể ảnh hưởng đến cấu hình và chuyển đổi. Nếu bạn không chỉ định tuỳ chọn này, thì mục tiêu cấp cao nhất được giả định là 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ị hỏng nếu không thể tạo mục tiêu được phân tích cú pháp từ biểu thức truy vấn với các tuỳ chọn cấp cao nhất.
Thẻ: loading_and_analysis
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õ trong tệp BUILD sẽ được in; nếu không thì các thuộc tính đó sẽ bị bỏ qua.
Thẻ: terminal_output
Mặc định của --[no]xml:line_numbers: "đúng"
Nếu đúng, kết quả XML sẽ chứa số dòng. Việc tắt tuỳ chọn này có thể giúp các điểm khác biệt dễ đọc 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 Bzlmod:
Đã tích luỹ --allow_yanked_versions=<a string> lần sử dụng
Đã chỉ định các phiên bản mô-đun dưới dạng `<module1>@<version1>,<module2>@<version2>`. Những phiên bản này sẽ được 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 trong sổ đăng ký nơi chúng xuất phát (nếu các phiên bản đó không đến từ một NonRegistryOverride). Nếu không, các phiên bản bị giật sẽ khiến quá trình phân giải không thành công. Bạn cũng có thể xác định phiên bản được kéo mạnh được phép bằng biến môi trường "BZLMOD_ALLOW_YANKED_VERSIONS". Bạn có thể vô hiệu hoá việc kiểm tra này bằng cách sử dụng từ khoá 'all' (không được khuyến nghị).
Thẻ: loading_and_analysis
Mặc định của --check_bazel_compatibility=<error, warning or off>: "lỗi"
Kiểm tra khả năng tương thích với 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 đề lên trạng thái lỗi giải quyết, "tắt" để tắt chế độ kiểm tra, hoặc "cảnh báo" để in cảnh báo khi phát hiện thấy thông tin không khớp.
Thẻ: loading_and_analysis
Mặc định của --check_direct_dependencies=<off, warning or error>: "cảnh báo"
Kiểm tra xem các phần phụ thuộc trực tiếp "bazel_dep" được khai báo trong mô-đun gốc có giống với phiên bản bạn nhận được trong biểu đồ phần phụ thuộc đã được giải quyết hay không. Các giá trị hợp lệ là "off" ("tắt") để tắt chế độ kiểm tra, "cảnh báo" để in cảnh báo khi phát hiện thấy thông tin không khớp hoặc "error" để chuyển vấn đề lên thành lỗi giải quyết.
Thẻ: loading_and_analysis
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_secondary` trong MODULE.bazel của mô-đun gốc. Lưu ý rằng các phần phụ thuộc của 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
Mặc định của --lockfile_mode=<off, update or error>: "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 nếu có thay đổi, "error" khi dùng tệp khoá nhưng báo lỗi nếu tệp không được cập nhật, hoặc "tắt" để không đọc hoặc ghi vào tệp khoá.
Thẻ: loading_and_analysis
Đã tích luỹ --override_module=<an equals-separated mapping of module name to path> lần sử dụng
Ghi đè một mô-đun có đường dẫn cục bộ ở dạng <module name>=<path>. Nếu đường dẫn đã cho là một đường dẫn tuyệt đối, thì đường dẫn đó sẽ được sử dụng như nguyên trạng. Nếu đường dẫn đã cho là một đường dẫn tương đối, thì đường dẫn đó sẽ tương ứng với thư mục đang hoạt động hiện tại. Nếu đường dẫn đã cho bắt đầu bằng "%workspace%", thì đường dẫn đó 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 "không gian làm việc thông tin bazel")
Đã tích luỹ --registry=<a string> lần sử dụng
Chỉ định sổ đăng ký cần dùng để xác định vị trí các phần phụ thuộc của mô-đun Bazel. Thứ tự rất quan trọng: các mô-đun sẽ được tra cứu trước trong sổ đăng ký trước, và chỉ quay lại các sổ đăng ký sau khi còn thiếu trong các sổ đăng ký trước đó.
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:
Mặc định của --gc_thrashing_limits=<comma separated pairs of <period>:<count>>: "1s:2,20s:3,1m:5"
Các giới hạn mà nếu đạt đến mức này sẽ khiến GcThrashingDetector gây sự cố cho Bazel bằng OOM. Mỗi giới hạn được chỉ định dưới dạng <period>:<count>, trong đó khoảng thời gian là một khoảng thời gian và số lượng là một số nguyên dương. Nếu có hơn --gc_thrashing_threshold phần trăm không gian cần sử dụng (vùng nhớ khối xếp thế hệ cũ) vẫn chiếm sau <count> các GC đầy đủ liên tiếp trong khoảng <period>, thì OOM sẽ được kích hoạt. Bạn có thể chỉ định nhiều hạn mức và phân tách bằng dấu phẩy.
Thẻ: host_machine_resource_optimizations
Mặc định của --skyframe_high_water_mark_full_gc_drops_per_invocation=<an integer, >= 0>: "2147483647"
Gắn cờ cho cấu hình nâng cao của công cụ Skyframe nội bộ của Bazel. Nếu Bazel phát hiện thấy 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 đặt ra bằng --skyframe_high_water_mark_threshold, thì khi một sự kiện GC xảy ra đầy đủ, trạng thái Skyframe tạm thời không cần thiết sẽ bị bỏ qua, tối đa nhiều lần cho mỗi lệnh gọi. Mặc định là Integer.MAX_VALUE; không giới hạn hiệu quả. 0 có nghĩa là các sự kiện thu gom rác (GC) toàn bộ sẽ không bao giờ kích hoạt hiện tượng giảm. Nếu đạt đến giới hạn, trạng thái Skyframe sẽ không còn bị bỏ qua khi một sự kiện GC đầy đủ xảy ra và vượt quá ngưỡng tỷ lệ phần trăm vùng nhớ khối xếp được giữ lại đó.
Thẻ: host_machine_resource_optimizations
Mặc định của --skyframe_high_water_mark_minor_gc_drops_per_invocation=<an integer, >= 0>: "2147483647"
Gắn cờ cho cấu hình nâng cao của công cụ Skyframe nội bộ của Bazel. Nếu Bazel phát hiện thấy mức sử dụng tỷ lệ phần trăm vùng nhớ khối xếp được giữ lại vượt quá ngưỡng đặt ra bằng --skyframe_high_water_mark_threshold, thì khi một sự kiện GC nhỏ xảy ra, trạng thái Skyframe tạm thời không cần thiết sẽ bị bỏ qua, tối đa là nhiều lần cho mỗi lệnh gọi. Mặc định là Integer.MAX_VALUE; không giới hạn hiệu quả. 0 có nghĩa là các sự kiện GC nhỏ sẽ không bao giờ kích hoạt hiện tượng giảm. Nếu đạt đến giới hạn, trạng thái Skyframe sẽ không còn bị bỏ qua khi xảy ra một sự kiện GC nhỏ và ngưỡng tỷ lệ phần trăm vùng nhớ khối xếp được giữ lại đó đã vượt quá.
Thẻ: host_machine_resource_optimizations
Mặc định của --skyframe_high_water_mark_threshold=<an integer>: "85"
Gắn cờ cho cấu hình nâng cao của công cụ Skyframe nội bộ của Bazel. Nếu Bazel 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 ở ngưỡng này, thì Bazel sẽ bỏ trạng thái Skyframe tạm thời không cần thiết. Việc chỉnh sửa tính năng này có thể cho phép bạn giảm thiểu tác động của tình trạng này đến thời gian sử dụng GC, khi tình trạng giật GC là do việc sử dụng bộ nhớ ở trạng thái tạm thời này gây ra và (ii) tốn kém hơn so với việc khôi phục trạng thái khi cần.
Thẻ: host_machine_resource_optimizations
Các tuỳ chọn ảnh hưởng đến độ chi tiết, định dạng hoặc vị trí ghi nhật ký:
Mặc định của --[no]experimental_command_profile: "false"
Ghi lại hồ sơ CPU của Trình ghi chuyến bay Java vào tệp profile.jfr trong thư mục cơ sở đầu ra. Trong tương lai, cú pháp và ngữ nghĩa của cờ này có thể thay đổi để hỗ trợ nhiều loại hồ sơ hoặc định dạng đầu ra; bạn tự chịu rủi ro khi sử dụng.
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 thao tác ghi nhớ 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ả chức năng ghi nhớ.
Mặc định của --experimental_repository_resolved_file=<a string>: ""
Nếu không trống, hãy ghi một giá trị Starlark kèm theo 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
Tuỳ chọn chỉ định hoặc thay đổi dữ liệu đầu vào chung thành lệnh Bazel không thuộc các danh mục khác.:
Mặc định của --experimental_resolved_file_instead_of_workspace=<a string>: ""
Nếu nội dung không trống, hãy đọc tệp đã được phân giải được chỉ định thay vì tệp WORKSPACE
Các thẻ: changes_inputs
Các tuỳ chọn thực thi và lưu vào bộ nhớ đệm từ xa:
Mặc định của --experimental_downloader_config=<a string>: 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ủ (cho `allow` và `block`) hoặc hai mẫu, một mẫu để so khớp và một mẫu dùng làm URL thay thế, có tham chiếu ngược bắt đầu từ "$1". Có thể có nhiều lệnh "rewrite" cho cùng một URL và trong trường hợp này sẽ có nhiều URL được trả về.
Mặc định của --experimental_worker_for_repo_fetching=<off, platform or virtual>: "tắt"
Chế độ phân luồng dùng để tìm nạp kho lưu trữ. Nếu bạn đặt chính sách này thành "tắt", thì sẽ không có luồng worker nào được sử dụng và quá trình tìm nạp kho lưu trữ có thể khởi động lại. Ngược lại, hãy sử dụng luồng nền tảng (tức là luồng hệ điều hành) nếu được đặt thành "platform" hoặc luồng ảo nếu được đặt thành "virtual".
Các lựa chọn khác, không được phân loại.:
Đã tích luỹ --deleted_packages=<comma-separated list of package names> lần sử dụng
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 những gói này xuất hiện ở vị trí nào đó trên đường dẫn gói. Sử dụng tuỳ chọn này khi xoá gói con "x/y" của 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ể báo cáo 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. Chỉ định --delete_packages x/y sẽ tránh được sự cố này.
Đã tích luỹ --override_repository=<an equals-separated mapping of repository name to path> lần sử dụng
Ghi đè một 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à một đường dẫn tuyệt đối, thì đường dẫn đó sẽ được sử dụng nguyên vẹn. Nếu đường dẫn đã cho là một đườ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 đó 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 "không gian làm việc thông tin bazel")
Giá trị mặc định của --package_path=<colon-separated list of options>: "%workspace%"
Danh sách được phân tách bằng dấu hai chấm nơi bạn sẽ tìm thấy 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 xung quanh. Nếu bị bỏ qua hoặc để trống, giá trị mặc định sẽ là dữ liệu đầu ra của "bazel info default-package-path".
Mặc định của --[no]show_loading_progress: "đúng"
Nếu bạn bật tuỳ chọn này, Bazel sẽ in thông báo "Đang tải gói:".

Các tuỳ chọn chạy

Kế thừa tất cả các tuỳ chọn của bản dựng.

Các tuỳ chọn xuất hiện trước lệnh và được ứng dụng phân tích cú pháp:
Đã tích luỹ --distdir=<a path> lần sử dụng
Các nơi khác để tìm kiếm các tệp lưu trữ trước khi truy cập mạng để tải các tệp lưu trữ đó xuống.
Thẻ: bazel_internal_configuration
Nếu bạn đặt chính sách này, bộ nhớ đệm của kho lưu trữ sẽ liên kết cứng tệp đó trong trường hợp tệp bị tấn công vào bộ nhớ đệm, thay vì sao chép. Mục đích của tính năng này là tiết kiệm dung lượng ổ đĩa.
Thẻ: bazel_internal_configuration
Mặc định của --experimental_repository_downloader_retries=<an integer>: "0"
Số lần thử lại một lỗi tải xuống tối đa. Nếu bạn đặt chính sách này thành 0, thì tính năng thử lại sẽ tắt.
Thẻ: experimental
Mặc định của --experimental_scale_timeouts=<a double>: "1.0"
Điều chỉnh tỷ lệ tất cả thời gian chờ trong quy tắc lưu trữ Starlark theo hệ số này. Bằng cách này, kho lưu trữ bên ngoài có thể được tạo ra hoạt động trên các máy chậm hơn tác giả quy tắc dự kiến mà không cần thay đổi mã nguồn
Thẻ: bazel_internal_configuration, experimental
Mặc định của --http_connector_attempts=<an integer>: "8"
Số lần thử tải xuống http tối đa.
Thẻ: bazel_internal_configuration
Mặc định của --http_connector_retry_max_timeout=<An immutable length of time.>: "0 giây"
Thời gian chờ tối đa cho các lần thử tải xuống lại http. Với giá trị 0, không có thời gian chờ tối đa nào được xác định.
Thẻ: bazel_internal_configuration
Mặc định của --http_timeout_scaling=<a double>: "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ố cụ thể
Thẻ: bazel_internal_configuration
Mặc định của --repository_cache=<a path>: 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. Một chuỗi trống làm đối số yêu cầu tắt bộ nhớ đệm, nếu không, hệ thống sẽ sử dụng giá trị mặc định của '<output_user_root>/cache/repos/v1'
Thẻ: bazel_internal_configuration
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ị vô hiệu hoá hoàn toàn; ctx.exe vẫn có thể chạy một tệp thực thi tuỳ ý truy cập vào Internet.
Thẻ: bazel_internal_configuration
Mặc định của --[no]run: "đúng"
Nếu giá trị là false, hãy bỏ qua bướ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 quá trình 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 đã sử dụng đã sử dụng (0 – 100) trên đó 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 giá trị này thành 100, thì GcThrashingDetector sẽ 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ự định, ảnh hưởng đến giá trị của đầu ra đó thay vì sự tồn tại của đầu ra đó:
Mặc định của --script_path=<a path>: xem nội dung mô tả
Nếu được đặt, hãy ghi một tập lệnh shell vào tệp cho trước để 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 'bazel run --script_path=foo //foo && ./foo' để gọi mục tiêu '//foo'. Điều này khác với "bazel run //foo" ở chỗ khoá bazel được giải phóng 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 đầu ra và ngữ nghĩa Bzlmod:
Đã tích luỹ --allow_yanked_versions=<a string> lần sử dụng
Đã chỉ định các phiên bản mô-đun dưới dạng `<module1>@<version1>,<module2>@<version2>`. Những phiên bản này sẽ được 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 trong sổ đăng ký nơi chúng xuất phát (nếu các phiên bản đó không đến từ một NonRegistryOverride). Nếu không, các phiên bản bị giật sẽ khiến quá trình phân giải không thành công. Bạn cũng có thể xác định phiên bản được kéo mạnh được phép bằng biến môi trường "BZLMOD_ALLOW_YANKED_VERSIONS". Bạn có thể vô hiệu hoá việc kiểm tra này bằng cách sử dụng từ khoá 'all' (không được khuyến nghị).
Thẻ: loading_and_analysis
Mặc định của --check_bazel_compatibility=<error, warning or off>: "lỗi"
Kiểm tra khả năng tương thích với 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 đề lên trạng thái lỗi giải quyết, "tắt" để tắt chế độ kiểm tra, hoặc "cảnh báo" để in cảnh báo khi phát hiện thấy thông tin không khớp.
Thẻ: loading_and_analysis
Mặc định của --check_direct_dependencies=<off, warning or error>: "cảnh báo"
Kiểm tra xem các phần phụ thuộc trực tiếp "bazel_dep" được khai báo trong mô-đun gốc có giống với phiên bản bạn nhận được trong biểu đồ phần phụ thuộc đã được giải quyết hay không. Các giá trị hợp lệ là "off" ("tắt") để tắt chế độ kiểm tra, "cảnh báo" để in cảnh báo khi phát hiện thấy thông tin không khớp hoặc "error" để chuyển vấn đề lên thành lỗi giải quyết.
Thẻ: loading_and_analysis
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_secondary` trong MODULE.bazel của mô-đun gốc. Lưu ý rằng các phần phụ thuộc của 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
Mặc định của --lockfile_mode=<off, update or error>: "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 nếu có thay đổi, "error" khi dùng tệp khoá nhưng báo lỗi nếu tệp không được cập nhật, hoặc "tắt" để không đọc hoặc ghi vào tệp khoá.
Thẻ: loading_and_analysis
Đã tích luỹ --override_module=<an equals-separated mapping of module name to path> lần sử dụng
Ghi đè một mô-đun có đường dẫn cục bộ ở dạng <module name>=<path>. Nếu đường dẫn đã cho là một đường dẫn tuyệt đối, thì đường dẫn đó sẽ được sử dụng như nguyên trạng. Nếu đường dẫn đã cho là một đường dẫn tương đối, thì đường dẫn đó sẽ tương ứng với thư mục đang hoạt động hiện tại. Nếu đường dẫn đã cho bắt đầu bằng "%workspace%", thì đường dẫn đó 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 "không gian làm việc thông tin bazel")
Đã tích luỹ --registry=<a string> lần sử dụng
Chỉ định sổ đăng ký cần dùng để xác định vị trí các phần phụ thuộc của mô-đun Bazel. Thứ tự rất quan trọng: các mô-đun sẽ được tra cứu trước trong sổ đăng ký trước, và chỉ quay lại các sổ đăng ký sau khi còn thiếu trong các sổ đăng ký trước đó.
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:
Mặc định của --gc_thrashing_limits=<comma separated pairs of <period>:<count>>: "1s:2,20s:3,1m:5"
Các giới hạn mà nếu đạt đến mức này sẽ khiến GcThrashingDetector gây sự cố cho Bazel bằng OOM. Mỗi giới hạn được chỉ định dưới dạng <period>:<count>, trong đó khoảng thời gian là một khoảng thời gian và số lượng là một số nguyên dương. Nếu có hơn --gc_thrashing_threshold phần trăm không gian cần sử dụng (vùng nhớ khối xếp thế hệ cũ) vẫn chiếm sau <count> các GC đầy đủ liên tiếp trong khoảng <period>, thì OOM sẽ được kích hoạt. Bạn có thể chỉ định nhiều hạn mức và phân tách bằng dấu phẩy.
Thẻ: host_machine_resource_optimizations
Mặc định của --skyframe_high_water_mark_full_gc_drops_per_invocation=<an integer, >= 0>: "2147483647"
Gắn cờ cho cấu hình nâng cao của công cụ Skyframe nội bộ của Bazel. Nếu Bazel phát hiện thấy 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 đặt ra bằng --skyframe_high_water_mark_threshold, thì khi một sự kiện GC xảy ra đầy đủ, trạng thái Skyframe tạm thời không cần thiết sẽ bị bỏ qua, tối đa nhiều lần cho mỗi lệnh gọi. Mặc định là Integer.MAX_VALUE; không giới hạn hiệu quả. 0 có nghĩa là các sự kiện thu gom rác (GC) toàn bộ sẽ không bao giờ kích hoạt hiện tượng giảm. Nếu đạt đến giới hạn, trạng thái Skyframe sẽ không còn bị bỏ qua khi một sự kiện GC đầy đủ xảy ra và vượt quá ngưỡng tỷ lệ phần trăm vùng nhớ khối xếp được giữ lại đó.
Thẻ: host_machine_resource_optimizations
Mặc định của --skyframe_high_water_mark_minor_gc_drops_per_invocation=<an integer, >= 0>: "2147483647"
Gắn cờ cho cấu hình nâng cao của công cụ Skyframe nội bộ của Bazel. Nếu Bazel phát hiện thấy mức sử dụng tỷ lệ phần trăm vùng nhớ khối xếp được giữ lại vượt quá ngưỡng đặt ra bằng --skyframe_high_water_mark_threshold, thì khi một sự kiện GC nhỏ xảy ra, trạng thái Skyframe tạm thời không cần thiết sẽ bị bỏ qua, tối đa là nhiều lần cho mỗi lệnh gọi. Mặc định là Integer.MAX_VALUE; không giới hạn hiệu quả. 0 có nghĩa là các sự kiện GC nhỏ sẽ không bao giờ kích hoạt hiện tượng giảm. Nếu đạt đến giới hạn, trạng thái Skyframe sẽ không còn bị bỏ qua khi xảy ra một sự kiện GC nhỏ và ngưỡng tỷ lệ phần trăm vùng nhớ khối xếp được giữ lại đó đã vượt quá.
Thẻ: host_machine_resource_optimizations
Mặc định của --skyframe_high_water_mark_threshold=<an integer>: "85"
Gắn cờ cho cấu hình nâng cao của công cụ Skyframe nội bộ của Bazel. Nếu Bazel 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 ở ngưỡng này, thì Bazel sẽ bỏ trạng thái Skyframe tạm thời không cần thiết. Việc chỉnh sửa tính năng này có thể cho phép bạn giảm thiểu tác động của tình trạng này đến thời gian sử dụng GC, khi tình trạng giật GC là do việc sử dụng bộ nhớ ở trạng thái tạm thời này gây ra và (ii) tốn kém hơn so với việc khôi phục trạng thái khi cần.
Thẻ: host_machine_resource_optimizations
Các tuỳ chọn ảnh hưởng đến độ chi tiết, định dạng hoặc vị trí ghi nhật ký:
Mặc định của --[no]experimental_command_profile: "false"
Ghi lại hồ sơ CPU của Trình ghi chuyến bay Java vào tệp profile.jfr trong thư mục cơ sở đầu ra. Trong tương lai, cú pháp và ngữ nghĩa của cờ này có thể thay đổi để hỗ trợ nhiều loại hồ sơ hoặc định dạng đầu ra; bạn tự chịu rủi ro khi sử dụng.
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 thao tác ghi nhớ 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ả chức năng ghi nhớ.
Các tuỳ chọn chỉ định hoặc thay đổi dữ liệu đầu vào chung thành lệnh Bazel mà không thuộc các danh mục khác.:
Mặc định của --experimental_resolved_file_instead_of_workspace=<a string>: ""
Nếu nội dung không trống, hãy đọc tệp đã được phân giải được chỉ định thay vì tệp WORKSPACE
Các thẻ: changes_inputs
Các tuỳ chọn thực thi và lưu vào bộ nhớ đệm từ xa:
Mặc định của --experimental_downloader_config=<a string>: 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ủ (cho `allow` và `block`) hoặc hai mẫu, một mẫu để so khớp và một mẫu dùng làm URL thay thế, có tham chiếu ngược bắt đầu từ "$1". Có thể có nhiều lệnh "rewrite" cho cùng một URL và trong trường hợp này sẽ có nhiều URL được trả về.
Mặc định của --experimental_worker_for_repo_fetching=<off, platform or virtual>: "tắt"
Chế độ phân luồng dùng để tìm nạp kho lưu trữ. Nếu bạn đặt chính sách này thành "tắt", thì sẽ không có luồng worker nào được sử dụng và quá trình tìm nạp kho lưu trữ có thể khởi động lại. Ngược lại, hãy sử dụng luồng nền tảng (tức là luồng hệ điều hành) nếu được đặt thành "platform" hoặc luồng ảo nếu được đặt thành "virtual".
Các lựa chọn khác, không được phân loại.:
Đã tích luỹ --override_repository=<an equals-separated mapping of repository name to path> lần sử dụng
Ghi đè một 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à một đường dẫn tuyệt đối, thì đường dẫn đó sẽ được sử dụng nguyên vẹn. Nếu đường dẫn đã cho là một đườ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 này 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 "không gian làm việc thông tin bazel")

Các tuỳ chọn tắt

Các tuỳ chọn xuất hiện trước lệnh và được ứng dụng phân tích cú pháp:
Đã tích luỹ --distdir=<a path> lần sử dụng
Các nơi khác để tìm kiếm các tệp lưu trữ trước khi truy cập mạng để tải các tệp lưu trữ đó xuống.
Thẻ: bazel_internal_configuration
Nếu bạn đặt chính sách này, bộ nhớ đệm của kho lưu trữ sẽ liên kết cứng tệp đó trong trường hợp tệp bị tấn công vào bộ nhớ đệm, thay vì sao chép. Mục đích của tính năng này là tiết kiệm dung lượng ổ đĩa.
Thẻ: bazel_internal_configuration
Mặc định của --experimental_repository_downloader_retries=<an integer>: "0"
Số lần thử lại một lỗi tải xuống tối đa. Nếu bạn đặt chính sách này thành 0, thì tính năng thử lại sẽ tắt.
Thẻ: experimental
Mặc định của --experimental_scale_timeouts=<a double>: "1.0"
Điều chỉnh tỷ lệ tất cả thời gian chờ trong quy tắc lưu trữ Starlark theo hệ số này. Bằng cách này, kho lưu trữ bên ngoài có thể được tạo ra hoạt động trên các máy chậm hơn tác giả quy tắc dự kiến mà không cần thay đổi mã nguồn
Thẻ: bazel_internal_configuration, experimental
Mặc định của --http_connector_attempts=<an integer>: "8"
Số lần thử tải xuống http tối đa.
Thẻ: bazel_internal_configuration
Mặc định của --http_connector_retry_max_timeout=<An immutable length of time.>: "0 giây"
Thời gian chờ tối đa cho các lần thử tải xuống lại http. Với giá trị 0, không có thời gian chờ tối đa nào được xác định.
Thẻ: bazel_internal_configuration
Mặc định của --http_timeout_scaling=<a double>: "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ố cụ thể
Thẻ: bazel_internal_configuration
Mặc định của --repository_cache=<a path>: 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. Một chuỗi trống làm đối số yêu cầu tắt bộ nhớ đệm, nếu không, hệ thống sẽ sử dụng giá trị mặc định của '<output_user_root>/cache/repos/v1'
Thẻ: bazel_internal_configuration
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ị vô hiệu hoá hoàn toàn; ctx.exe vẫn có thể chạy một tệp thực thi tuỳ ý truy cập vào Internet.
Thẻ: bazel_internal_configuration
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 --gc_thrashing_threshold=<an integer in 0-100 range>: "100"
Tỷ lệ phần trăm không gian đã sử dụng đã sử dụng (0 – 100) trên đó 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 giá trị này thành 100, thì GcThrashingDetector sẽ tắt.
Thẻ: host_machine_resource_optimizations
Các tuỳ chọn kiểm soát kết quả của lệnh:
Mặc định của --iff_heap_size_greater_than=<an integer>: "0"
Nếu khác 0, thì thao tác tắt sẽ chỉ tắt máy chủ nếu tổ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 đầu ra và ngữ nghĩa Bzlmod:
Đã tích luỹ --allow_yanked_versions=<a string> lần sử dụng
Đã chỉ định các phiên bản mô-đun dưới dạng `<module1>@<version1>,<module2>@<version2>`. Những phiên bản này sẽ được 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 trong sổ đăng ký nơi chúng xuất phát (nếu các phiên bản đó không đến từ một NonRegistryOverride). Nếu không, các phiên bản bị giật sẽ khiến quá trình phân giải không thành công. Bạn cũng có thể xác định phiên bản được kéo mạnh được phép bằng biến môi trường "BZLMOD_ALLOW_YANKED_VERSIONS". Bạn có thể vô hiệu hoá việc kiểm tra này bằng cách sử dụng từ khoá 'all' (không được khuyến nghị).
Thẻ: loading_and_analysis
Mặc định của --check_bazel_compatibility=<error, warning or off>: "lỗi"
Kiểm tra khả năng tương thích với 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 đề lên trạng thái lỗi giải quyết, "tắt" để tắt chế độ kiểm tra, hoặc "cảnh báo" để in cảnh báo khi phát hiện thấy thông tin không khớp.
Thẻ: loading_and_analysis
Mặc định của --check_direct_dependencies=<off, warning or error>: "cảnh báo"
Kiểm tra xem các phần phụ thuộc trực tiếp "bazel_dep" được khai báo trong mô-đun gốc có giống với phiên bản bạn nhận được trong biểu đồ phần phụ thuộc đã được giải quyết hay không. Các giá trị hợp lệ là "off" ("tắt") để tắt chế độ kiểm tra, "cảnh báo" để in cảnh báo khi phát hiện thấy thông tin không khớp hoặc "error" để chuyển vấn đề lên thành lỗi giải quyết.
Thẻ: loading_and_analysis
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_secondary` trong MODULE.bazel của mô-đun gốc. Lưu ý rằng các phần phụ thuộc của 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
Mặc định của --lockfile_mode=<off, update or error>: "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 nếu có thay đổi, "error" khi dùng tệp khoá nhưng báo lỗi nếu tệp không được cập nhật, hoặc "tắt" để không đọc hoặc ghi vào tệp khoá.
Thẻ: loading_and_analysis
Đã tích luỹ --override_module=<an equals-separated mapping of module name to path> lần sử dụng
Ghi đè một mô-đun có đường dẫn cục bộ ở dạng <module name>=<path>. Nếu đường dẫn đã cho là một đường dẫn tuyệt đối, thì đường dẫn đó sẽ được sử dụng như nguyên trạng. Nếu đường dẫn đã cho là một đường dẫn tương đối, thì đường dẫn đó sẽ tương ứng với thư mục đang hoạt động hiện tại. Nếu đường dẫn đã cho bắt đầu bằng "%workspace%", thì đường dẫn đó 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 "không gian làm việc thông tin bazel")
Đã tích luỹ --registry=<a string> lần sử dụng
Chỉ định sổ đăng ký cần dùng để xác định vị trí các phần phụ thuộc của mô-đun Bazel. Thứ tự rất quan trọng: các mô-đun sẽ được tra cứu trước trong sổ đăng ký trước, và chỉ quay lại các sổ đăng ký sau khi còn thiếu trong các sổ đăng ký trước đó.
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:
Mặc định của --gc_thrashing_limits=<comma separated pairs of <period>:<count>>: "1s:2,20s:3,1m:5"
Các giới hạn mà nếu đạt đến mức này sẽ khiến GcThrashingDetector gây sự cố cho Bazel bằng OOM. Mỗi giới hạn được chỉ định dưới dạng <period>:<count>, trong đó khoảng thời gian là một khoảng thời gian và số lượng là một số nguyên dương. Nếu có hơn --gc_thrashing_threshold phần trăm không gian cần sử dụng (vùng nhớ khối xếp thế hệ cũ) vẫn chiếm sau <count> các GC đầy đủ liên tiếp trong khoảng <period>, thì OOM sẽ được kích hoạt. Bạn có thể chỉ định nhiều hạn mức và phân tách bằng dấu phẩy.
Thẻ: host_machine_resource_optimizations
Mặc định của --skyframe_high_water_mark_full_gc_drops_per_invocation=<an integer, >= 0>: "2147483647"
Gắn cờ cho cấu hình nâng cao của công cụ Skyframe nội bộ của Bazel. Nếu Bazel phát hiện thấy 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 đặt ra bằng --skyframe_high_water_mark_threshold, thì khi một sự kiện GC xảy ra đầy đủ, trạng thái Skyframe tạm thời không cần thiết sẽ bị bỏ qua, tối đa nhiều lần cho mỗi lệnh gọi. Mặc định là Integer.MAX_VALUE; không giới hạn hiệu quả. 0 có nghĩa là các sự kiện thu gom rác (GC) toàn bộ sẽ không bao giờ kích hoạt hiện tượng giảm. Nếu đạt đến giới hạn, trạng thái Skyframe sẽ không còn bị bỏ qua khi một sự kiện GC đầy đủ xảy ra và vượt quá ngưỡng tỷ lệ phần trăm vùng nhớ khối xếp được giữ lại đó.
Thẻ: host_machine_resource_optimizations
Mặc định của --skyframe_high_water_mark_minor_gc_drops_per_invocation=<an integer, >= 0>: "2147483647"
Gắn cờ cho cấu hình nâng cao của công cụ Skyframe nội bộ của Bazel. Nếu Bazel phát hiện thấy mức sử dụng tỷ lệ phần trăm vùng nhớ khối xếp được giữ lại vượt quá ngưỡng đặt ra bằng --skyframe_high_water_mark_threshold, thì khi một sự kiện GC nhỏ xảy ra, trạng thái Skyframe tạm thời không cần thiết sẽ bị bỏ qua, tối đa là nhiều lần cho mỗi lệnh gọi. Mặc định là Integer.MAX_VALUE; không giới hạn hiệu quả. 0 có nghĩa là các sự kiện GC nhỏ sẽ không bao giờ kích hoạt hiện tượng giảm. Nếu đạt đến giới hạn, trạng thái Skyframe sẽ không còn bị bỏ qua khi xảy ra một sự kiện GC nhỏ và ngưỡng tỷ lệ phần trăm vùng nhớ khối xếp được giữ lại đó đã vượt quá.
Thẻ: host_machine_resource_optimizations
Mặc định của --skyframe_high_water_mark_threshold=<an integer>: "85"
Gắn cờ cho cấu hình nâng cao của công cụ Skyframe nội bộ của Bazel. Nếu Bazel 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 ở ngưỡng này, thì Bazel sẽ bỏ trạng thái Skyframe tạm thời không cần thiết. Việc chỉnh sửa tính năng này có thể cho phép bạn giảm thiểu tác động của tình trạng này đến thời gian sử dụng GC, khi tình trạng giật GC là do việc sử dụng bộ nhớ ở trạng thái tạm thời này gây ra và (ii) tốn kém hơn so với việc khôi phục trạng thái khi cần.
Thẻ: host_machine_resource_optimizations
Các tuỳ chọn ảnh hưởng đến độ chi tiết, định dạng hoặc vị trí ghi nhật ký:
Mặc định của --[no]experimental_command_profile: "false"
Ghi lại hồ sơ CPU của Trình ghi chuyến bay Java vào tệp profile.jfr trong thư mục cơ sở đầu ra. Trong tương lai, cú pháp và ngữ nghĩa của cờ này có thể thay đổi để hỗ trợ nhiều loại hồ sơ hoặc định dạng đầu ra; bạn tự chịu rủi ro khi sử dụng.
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 thao tác ghi nhớ 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ả chức năng ghi nhớ.
Các tuỳ chọn chỉ định hoặc thay đổi dữ liệu đầu vào chung thành lệnh Bazel mà không thuộc các danh mục khác.:
Mặc định của --experimental_resolved_file_instead_of_workspace=<a string>: ""
Nếu nội dung không trống, hãy đọc tệp đã được phân giải được chỉ định thay vì tệp WORKSPACE
Các thẻ: changes_inputs
Các tuỳ chọn thực thi và lưu vào bộ nhớ đệm từ xa:
Mặc định của --experimental_downloader_config=<a string>: 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ủ (cho `allow` và `block`) hoặc hai mẫu, một mẫu để so khớp và một mẫu dùng làm URL thay thế, có tham chiếu ngược bắt đầu từ "$1". Có thể có nhiều lệnh "rewrite" cho cùng một URL và trong trường hợp này sẽ có nhiều URL được trả về.
Mặc định của --experimental_worker_for_repo_fetching=<off, platform or virtual>: "tắt"
Chế độ phân luồng dùng để tìm nạp kho lưu trữ. Nếu bạn đặt chính sách này thành "tắt", thì sẽ không có luồng worker nào được sử dụng và quá trình tìm nạp kho lưu trữ có thể khởi động lại. Ngược lại, hãy sử dụng luồng nền tảng (tức là luồng hệ điều hành) nếu được đặt thành "platform" hoặc luồng ảo nếu được đặt thành "virtual".
Các lựa chọn khác, không được phân loại.:
Đã tích luỹ --override_repository=<an equals-separated mapping of repository name to path> lần sử dụng
Ghi đè một 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à một đường dẫn tuyệt đối, thì đường dẫn đó sẽ được sử dụng nguyên vẹn. Nếu đường dẫn đã cho là một đườ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 này 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 "không gian làm việc thông tin bazel")

Các cách đồng bộ hoá

Các tuỳ chọn xuất hiện trước lệnh và được ứng dụng phân tích cú pháp:
Đã tích luỹ --distdir=<a path> lần sử dụng
Các nơi khác để tìm kiếm các tệp lưu trữ trước khi truy cập mạng để tải các tệp lưu trữ đó xuống.
Thẻ: bazel_internal_configuration
Nếu bạn đặt chính sách này, bộ nhớ đệm của kho lưu trữ sẽ liên kết cứng tệp đó trong trường hợp tệp bị tấn công vào bộ nhớ đệm, thay vì sao chép. Mục đích của tính năng này là tiết kiệm dung lượng ổ đĩa.
Thẻ: bazel_internal_configuration
Mặc định của --experimental_repository_downloader_retries=<an integer>: "0"
Số lần thử lại một lỗi tải xuống tối đa. Nếu bạn đặt chính sách này thành 0, thì tính năng thử lại sẽ tắt.
Thẻ: experimental
Mặc định của --experimental_scale_timeouts=<a double>: "1.0"
Điều chỉnh tỷ lệ tất cả thời gian chờ trong quy tắc lưu trữ Starlark theo hệ số này. Bằng cách này, kho lưu trữ bên ngoài có thể được tạo ra hoạt động trên các máy chậm hơn tác giả quy tắc dự kiến mà không cần thay đổi mã nguồn
Thẻ: bazel_internal_configuration, experimental
Mặc định của --http_connector_attempts=<an integer>: "8"
Số lần thử tải xuống http tối đa.
Thẻ: bazel_internal_configuration
Mặc định của --http_connector_retry_max_timeout=<An immutable length of time.>: "0 giây"
Thời gian chờ tối đa cho các lần thử tải xuống lại http. Với giá trị 0, không có thời gian chờ tối đa nào được xác định.
Thẻ: bazel_internal_configuration
Mặc định của --http_timeout_scaling=<a double>: "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ố cụ thể
Thẻ: bazel_internal_configuration
Mặc định của --repository_cache=<a path>: 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. Một chuỗi trống làm đối số yêu cầu tắt bộ nhớ đệm, nếu không, hệ thống sẽ sử dụng giá trị mặc định của '<output_user_root>/cache/repos/v1'
Thẻ: bazel_internal_configuration
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ị vô hiệu hoá hoàn toàn; ctx.exe vẫn có thể chạy một tệp thực thi tuỳ ý truy cập vào Internet.
Thẻ: bazel_internal_configuration
Các tuỳ chọn kiểm soát quá trình thực thi bản dựng:
Mặc định của --[no]configure: "False"
Chỉ đồng bộ hoá những 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 đã sử dụng đã sử dụng (0 – 100) trên đó 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 giá trị này thành 100, thì GcThrashingDetector sẽ tắt.
Thẻ: host_machine_resource_optimizations
Giá trị mặc định của --[no]keep_going [-k]: "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 đạt và những mục tiêu phụ thuộc vào mục tiêu đó, nhưng bạn có thể phải đáp ứng 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
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ố lượng luồng song song cần dùng cho giai đoạn tải/phân tích. Lấy một số nguyên hoặc từ khoá ("auto", "HOST_CPUS", "HOST_RAM"), theo sau (không bắt buộc) là một thao tác ([-|*]<float>), ví dụ: "auto", "HOST_CPUS*.5". "auto" đặt giá trị mặc định hợp lý dựa trên tài nguyên máy chủ. Giá trị phải lớn hơn hoặc bằng 1.
Thẻ: bazel_internal_configuration
Đã tích luỹ --only=<a string> lần sử dụng
Nếu có tuỳ chọn này, thì 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ấu hình giống như – cấu hình đã được cung cấp) đã 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 tệp BUILD, tệp .bzl hoặc tệp WORKSPACE.:
Mặc định của --[no]incompatible_config_setting_private_default_visibility: "false"
Nếu không tương thích_enforce_config_setting_visible=false, thì đây là lỗi không phù hợp. Ngoài ra, nếu cờ này sai, thì mọi config_setting không có thuộc tính chế độ hiển thị rõ ràng sẽ là //visible:public. Nếu cờ này là true, config_setting sẽ tuân theo cùng logic hiển thị 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
Mặc định của --[no]incompatible_enforce_config_setting_visibility: "đúng"
Nếu đúng, hãy thực thi các hạn chế về chế độ hiển thị config_setting. Nếu giá trị là false, mọi config_setting sẽ 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 Bzlmod:
Đã tích luỹ --allow_yanked_versions=<a string> lần sử dụng
Đã chỉ định các phiên bản mô-đun dưới dạng `<module1>@<version1>,<module2>@<version2>`. Những phiên bản này sẽ được 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 trong sổ đăng ký nơi chúng xuất phát (nếu các phiên bản đó không đến từ một NonRegistryOverride). Nếu không, các phiên bản bị giật sẽ khiến quá trình phân giải không thành công. Bạn cũng có thể xác định phiên bản được kéo mạnh được phép bằng biến môi trường "BZLMOD_ALLOW_YANKED_VERSIONS". Bạn có thể vô hiệu hoá việc kiểm tra này bằng cách sử dụng từ khoá 'all' (không được khuyến nghị).
Thẻ: loading_and_analysis
Mặc định của --check_bazel_compatibility=<error, warning or off>: "lỗi"
Kiểm tra khả năng tương thích với 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 đề lên trạng thái lỗi giải quyết, "tắt" để tắt chế độ kiểm tra, hoặc "cảnh báo" để in cảnh báo khi phát hiện thấy thông tin không khớp.
Thẻ: loading_and_analysis
Mặc định của --check_direct_dependencies=<off, warning or error>: "cảnh báo"
Kiểm tra xem các phần phụ thuộc trực tiếp "bazel_dep" được khai báo trong mô-đun gốc có giống với phiên bản bạn nhận được trong biểu đồ phần phụ thuộc đã được giải quyết hay không. Các giá trị hợp lệ là "off" ("tắt") để tắt chế độ kiểm tra, "cảnh báo" để in cảnh báo khi phát hiện thấy thông tin không khớp hoặc "error" để chuyển vấn đề lên thành lỗi giải quyết.
Thẻ: loading_and_analysis
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_secondary` trong MODULE.bazel của mô-đun gốc. Lưu ý rằng các phần phụ thuộc của 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
Mặc định của --lockfile_mode=<off, update or error>: "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 nếu có thay đổi, "error" khi dùng tệp khoá nhưng báo lỗi nếu tệp không được cập nhật, hoặc "tắt" để không đọc hoặc ghi vào tệp khoá.
Thẻ: loading_and_analysis
Đã tích luỹ --override_module=<an equals-separated mapping of module name to path> lần sử dụng
Ghi đè một mô-đun có đường dẫn cục bộ ở dạng <module name>=<path>. Nếu đường dẫn đã cho là một đường dẫn tuyệt đối, thì đường dẫn đó sẽ được sử dụng như nguyên trạng. Nếu đường dẫn đã cho là một đường dẫn tương đối, thì đường dẫn đó sẽ tương ứng với thư mục đang hoạt động hiện tại. Nếu đường dẫn đã cho bắt đầu bằng "%workspace%", thì đường dẫn đó 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 "không gian làm việc thông tin bazel")
Đã tích luỹ --registry=<a string> lần sử dụng
Chỉ định sổ đăng ký cần dùng để xác định vị trí các phần phụ thuộc của mô-đun Bazel. Thứ tự rất quan trọng: các mô-đun sẽ được tra cứu trước trong sổ đăng ký trước, và chỉ quay lại các sổ đăng ký sau khi còn thiếu trong các sổ đăng ký trước đó.
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:
Mặc định của --gc_thrashing_limits=<comma separated pairs of <period>:<count>>: "1s:2,20s:3,1m:5"
Các giới hạn mà nếu đạt đến mức này sẽ khiến GcThrashingDetector gây sự cố cho Bazel bằng OOM. Mỗi giới hạn được chỉ định dưới dạng <period>:<count>, trong đó khoảng thời gian là một khoảng thời gian và số lượng là một số nguyên dương. Nếu có hơn --gc_thrashing_threshold phần trăm không gian cần sử dụng (vùng nhớ khối xếp thế hệ cũ) vẫn chiếm sau <count> các GC đầy đủ liên tiếp trong khoảng <period>, thì OOM sẽ được kích hoạt. Bạn có thể chỉ định nhiều hạn mức và phân tách bằng dấu phẩy.
Thẻ: host_machine_resource_optimizations
Mặc định của --skyframe_high_water_mark_full_gc_drops_per_invocation=<an integer, >= 0>: "2147483647"
Gắn cờ cho cấu hình nâng cao của công cụ Skyframe nội bộ của Bazel. Nếu Bazel phát hiện thấy 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 đặt ra bằng --skyframe_high_water_mark_threshold, thì khi một sự kiện GC xảy ra đầy đủ, trạng thái Skyframe tạm thời không cần thiết sẽ bị bỏ qua, tối đa nhiều lần cho mỗi lệnh gọi. Mặc định là Integer.MAX_VALUE; không giới hạn hiệu quả. 0 có nghĩa là các sự kiện thu gom rác (GC) toàn bộ sẽ không bao giờ kích hoạt hiện tượng giảm. Nếu đạt đến giới hạn, trạng thái Skyframe sẽ không còn bị bỏ qua khi một sự kiện GC đầy đủ xảy ra và vượt quá ngưỡng tỷ lệ phần trăm vùng nhớ khối xếp được giữ lại đó.
Thẻ: host_machine_resource_optimizations
Mặc định của --skyframe_high_water_mark_minor_gc_drops_per_invocation=<an integer, >= 0>: "2147483647"
Gắn cờ cho cấu hình nâng cao của công cụ Skyframe nội bộ của Bazel. Nếu Bazel phát hiện thấy mức sử dụng tỷ lệ phần trăm vùng nhớ khối xếp được giữ lại vượt quá ngưỡng đặt ra bằng --skyframe_high_water_mark_threshold, thì khi một sự kiện GC nhỏ xảy ra, trạng thái Skyframe tạm thời không cần thiết sẽ bị bỏ qua, tối đa là nhiều lần cho mỗi lệnh gọi. Mặc định là Integer.MAX_VALUE; không giới hạn hiệu quả. 0 có nghĩa là các sự kiện GC nhỏ sẽ không bao giờ kích hoạt hiện tượng giảm. Nếu đạt đến giới hạn, trạng thái Skyframe sẽ không còn bị bỏ qua khi xảy ra một sự kiện GC nhỏ và ngưỡng tỷ lệ phần trăm vùng nhớ khối xếp được giữ lại đó đã vượt quá.
Thẻ: host_machine_resource_optimizations
Mặc định của --skyframe_high_water_mark_threshold=<an integer>: "85"
Gắn cờ cho cấu hình nâng cao của công cụ Skyframe nội bộ của Bazel. Nếu Bazel 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 ở ngưỡng này, thì Bazel sẽ bỏ trạng thái Skyframe tạm thời không cần thiết. Việc chỉnh sửa tính năng này có thể cho phép bạn giảm thiểu tác động của tình trạng này đến thời gian sử dụng GC, khi tình trạng giật GC là do việc sử dụng bộ nhớ ở trạng thái tạm thời này gây ra và (ii) tốn kém hơn so với việc khôi phục trạng thái khi cần.
Thẻ: host_machine_resource_optimizations
Các tuỳ chọn ảnh hưởng đến độ chi tiết, định dạng hoặc vị trí ghi nhật ký:
Mặc định của --[no]experimental_command_profile: "false"
Ghi lại hồ sơ CPU của Trình ghi chuyến bay Java vào tệp profile.jfr trong thư mục cơ sở đầu ra. Trong tương lai, cú pháp và ngữ nghĩa của cờ này có thể thay đổi để hỗ trợ nhiều loại hồ sơ hoặc định dạng đầu ra; bạn tự chịu rủi ro khi sử dụng.
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 thao tác ghi nhớ 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ả chức năng ghi nhớ.
Mặc định của --experimental_repository_resolved_file=<a string>: ""
Nếu không trống, hãy ghi một giá trị Starlark kèm theo 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
Tuỳ chọn chỉ định hoặc thay đổi dữ liệu đầu vào chung thành lệnh Bazel không thuộc các danh mục khác.:
Mặc định của --experimental_resolved_file_instead_of_workspace=<a string>: ""
Nếu nội dung không trống, hãy đọc tệp đã được phân giải được chỉ định thay vì tệp WORKSPACE
Các thẻ: changes_inputs
Các tuỳ chọn thực thi và lưu vào bộ nhớ đệm từ xa:
Mặc định của --experimental_downloader_config=<a string>: 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ủ (cho `allow` và `block`) hoặc hai mẫu, một mẫu để so khớp và một mẫu dùng làm URL thay thế, có tham chiếu ngược bắt đầu từ "$1". Có thể có nhiều lệnh "rewrite" cho cùng một URL và trong trường hợp này sẽ có nhiều URL được trả về.
Mặc định của --experimental_worker_for_repo_fetching=<off, platform or virtual>: "tắt"
Chế độ phân luồng dùng để tìm nạp kho lưu trữ. Nếu bạn đặt chính sách này thành "tắt", thì sẽ không có luồng worker nào được sử dụng và quá trình tìm nạp kho lưu trữ có thể khởi động lại. Ngược lại, hãy sử dụng luồng nền tảng (tức là luồng hệ điều hành) nếu được đặt thành "platform" hoặc luồng ảo nếu được đặt thành "virtual".
Các lựa chọn khác, không được phân loại.:
Đã tích luỹ --deleted_packages=<comma-separated list of package names> lần sử dụng
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 những gói này xuất hiện ở vị trí nào đó trên đường dẫn gói. Sử dụng tuỳ chọn này khi xoá gói con "x/y" của 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ể báo cáo 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. Chỉ định --delete_packages x/y sẽ tránh được sự cố này.
Đã tích luỹ --override_repository=<an equals-separated mapping of repository name to path> lần sử dụng
Ghi đè một 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à một đường dẫn tuyệt đối, thì đường dẫn đó sẽ được sử dụng nguyên vẹn. Nếu đường dẫn đã cho là một đườ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 đó 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 "không gian làm việc thông tin bazel")
Giá trị mặc định của --package_path=<colon-separated list of options>: "%workspace%"
Danh sách được phân tách bằng dấu hai chấm nơi bạn sẽ tìm thấy 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 xung quanh. Nếu bị bỏ qua hoặc để trống, giá trị mặc định sẽ là dữ liệu đầu ra của "bazel info default-package-path".
Mặc định của --[no]show_loading_progress: "đúng"
Nếu bạn bật tuỳ chọn này, Bazel sẽ in thông báo "Đang tải gói:".

Các lựa chọn kiểm thử

Kế thừa tất cả các tuỳ chọn của bản dựng.

Các tuỳ chọn xuất hiện trước lệnh và được ứng dụng phân tích cú pháp:
Đã tích luỹ --distdir=<a path> lần sử dụng
Các nơi khác để tìm kiếm các tệp lưu trữ trước khi truy cập mạng để tải các tệp lưu trữ đó xuống.
Thẻ: bazel_internal_configuration
Nếu bạn đặt chính sách này, bộ nhớ đệm của kho lưu trữ sẽ liên kết cứng tệp đó trong trường hợp tệp bị tấn công vào bộ nhớ đệm, thay vì sao chép. Mục đích của tính năng này là tiết kiệm dung lượng ổ đĩa.
Thẻ: bazel_internal_configuration
Mặc định của --experimental_repository_downloader_retries=<an integer>: "0"
Số lần thử lại một lỗi tải xuống tối đa. Nếu bạn đặt chính sách này thành 0, thì tính năng thử lại sẽ tắt.
Thẻ: experimental
Mặc định của --experimental_scale_timeouts=<a double>: "1.0"
Điều chỉnh tỷ lệ tất cả thời gian chờ trong quy tắc lưu trữ Starlark theo hệ số này. Bằng cách này, kho lưu trữ bên ngoài có thể được tạo ra hoạt động trên các máy chậm hơn tác giả quy tắc dự kiến mà không cần thay đổi mã nguồn
Thẻ: bazel_internal_configuration, experimental
Mặc định của --http_connector_attempts=<an integer>: "8"
Số lần thử tải xuống http tối đa.
Thẻ: bazel_internal_configuration
Mặc định của --http_connector_retry_max_timeout=<An immutable length of time.>: "0 giây"
Thời gian chờ tối đa cho các lần thử tải xuống lại http. Với giá trị 0, không có thời gian chờ tối đa nào được xác định.
Thẻ: bazel_internal_configuration
Mặc định của --http_timeout_scaling=<a double>: "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ố cụ thể
Thẻ: bazel_internal_configuration
Mặc định của --repository_cache=<a path>: 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. Một chuỗi trống làm đối số yêu cầu tắt bộ nhớ đệm, nếu không, hệ thống sẽ sử dụng giá trị mặc định của '<output_user_root>/cache/repos/v1'
Thẻ: bazel_internal_configuration
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ị vô hiệu hoá hoàn toàn; ctx.exe vẫn có thể chạy một tệp thực thi tuỳ ý truy cập vào Internet.
Thẻ: bazel_internal_configuration
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 --gc_thrashing_threshold=<an integer in 0-100 range>: "100"
Tỷ lệ phần trăm không gian đã sử dụng đã sử dụng (0 – 100) trên đó 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 giá trị này thành 100, thì GcThrashingDetector sẽ tắt.
Thẻ: host_machine_resource_optimizations
Các tuỳ chọn liên quan đến đầu ra và ngữ nghĩa Bzlmod:
Đã tích luỹ --allow_yanked_versions=<a string> lần sử dụng
Đã chỉ định các phiên bản mô-đun dưới dạng `<module1>@<version1>,<module2>@<version2>`. Những phiên bản này sẽ được 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 trong sổ đăng ký nơi chúng xuất phát (nếu các phiên bản đó không đến từ một NonRegistryOverride). Nếu không, các phiên bản bị giật sẽ khiến quá trình phân giải không thành công. Bạn cũng có thể xác định phiên bản được kéo mạnh được phép bằng biến môi trường "BZLMOD_ALLOW_YANKED_VERSIONS". Bạn có thể vô hiệu hoá việc kiểm tra này bằng cách sử dụng từ khoá 'all' (không được khuyến nghị).
Thẻ: loading_and_analysis
Mặc định của --check_bazel_compatibility=<error, warning or off>: "lỗi"
Kiểm tra khả năng tương thích với 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 đề lên trạng thái lỗi giải quyết, "tắt" để tắt chế độ kiểm tra, hoặc "cảnh báo" để in cảnh báo khi phát hiện thấy thông tin không khớp.
Thẻ: loading_and_analysis
Mặc định của --check_direct_dependencies=<off, warning or error>: "cảnh báo"
Kiểm tra xem các phần phụ thuộc trực tiếp "bazel_dep" được khai báo trong mô-đun gốc có giống với phiên bản bạn nhận được trong biểu đồ phần phụ thuộc đã được giải quyết hay không. Các giá trị hợp lệ là "off" ("tắt") để tắt chế độ kiểm tra, "cảnh báo" để in cảnh báo khi phát hiện thấy thông tin không khớp hoặc "error" để chuyển vấn đề lên thành lỗi giải quyết.
Thẻ: loading_and_analysis
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_secondary` trong MODULE.bazel của mô-đun gốc. Lưu ý rằng các phần phụ thuộc của 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
Mặc định của --lockfile_mode=<off, update or error>: "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 nếu có thay đổi, "error" khi dùng tệp khoá nhưng báo lỗi nếu tệp không được cập nhật, hoặc "tắt" để không đọc hoặc ghi vào tệp khoá.
Thẻ: loading_and_analysis
Đã tích luỹ --override_module=<an equals-separated mapping of module name to path> lần sử dụng
Ghi đè một mô-đun có đường dẫn cục bộ ở dạng <module name>=<path>. Nếu đường dẫn đã cho là một đường dẫn tuyệt đối, thì đường dẫn đó sẽ được sử dụng như nguyên trạng. Nếu đường dẫn đã cho là một đường dẫn tương đối, thì đường dẫn đó sẽ tương ứng với thư mục đang hoạt động hiện tại. Nếu đường dẫn đã cho bắt đầu bằng "%workspace%", thì đường dẫn đó 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 "không gian làm việc thông tin bazel")
Đã tích luỹ --registry=<a string> lần sử dụng
Chỉ định sổ đăng ký cần dùng để xác định vị trí các phần phụ thuộc của mô-đun Bazel. Thứ tự rất quan trọng: các mô-đun sẽ được tra cứu trước trong sổ đăng ký trước, và chỉ quay lại các sổ đăng ký sau khi còn thiếu trong các sổ đăng ký trước đó.
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:
Mặc định của --gc_thrashing_limits=<comma separated pairs of <period>:<count>>: "1s:2,20s:3,1m:5"
Các giới hạn mà nếu đạt đến mức này sẽ khiến GcThrashingDetector gây sự cố cho Bazel bằng OOM. Mỗi giới hạn được chỉ định dưới dạng <period>:<count>, trong đó khoảng thời gian là một khoảng thời gian và số lượng là một số nguyên dương. Nếu có hơn --gc_thrashing_threshold phần trăm không gian cần sử dụng (vùng nhớ khối xếp thế hệ cũ) vẫn chiếm sau <count> các GC đầy đủ liên tiếp trong khoảng <period>, thì OOM sẽ được kích hoạt. Bạn có thể chỉ định nhiều hạn mức và phân tách bằng dấu phẩy.
Thẻ: host_machine_resource_optimizations
Mặc định của --skyframe_high_water_mark_full_gc_drops_per_invocation=<an integer, >= 0>: "2147483647"
Gắn cờ cho cấu hình nâng cao của công cụ Skyframe nội bộ của Bazel. Nếu Bazel phát hiện thấy 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 đặt ra bằng --skyframe_high_water_mark_threshold, thì khi một sự kiện GC xảy ra đầy đủ, trạng thái Skyframe tạm thời không cần thiết sẽ bị bỏ qua, tối đa nhiều lần cho mỗi lệnh gọi. Mặc định là Integer.MAX_VALUE; không giới hạn hiệu quả. 0 có nghĩa là các sự kiện thu gom rác (GC) toàn bộ sẽ không bao giờ kích hoạt hiện tượng giảm. Nếu đạt đến giới hạn, trạng thái Skyframe sẽ không còn bị bỏ qua khi một sự kiện GC đầy đủ xảy ra và vượt quá ngưỡng tỷ lệ phần trăm vùng nhớ khối xếp được giữ lại đó.
Thẻ: host_machine_resource_optimizations
Mặc định của --skyframe_high_water_mark_minor_gc_drops_per_invocation=<an integer, >= 0>: "2147483647"
Gắn cờ cho cấu hình nâng cao của công cụ Skyframe nội bộ của Bazel. Nếu Bazel phát hiện thấy mức sử dụng tỷ lệ phần trăm vùng nhớ khối xếp được giữ lại vượt quá ngưỡng đặt ra bằng --skyframe_high_water_mark_threshold, thì khi một sự kiện GC nhỏ xảy ra, trạng thái Skyframe tạm thời không cần thiết sẽ bị bỏ qua, tối đa là nhiều lần cho mỗi lệnh gọi. Mặc định là Integer.MAX_VALUE; không giới hạn hiệu quả. 0 có nghĩa là các sự kiện GC nhỏ sẽ không bao giờ kích hoạt hiện tượng giảm. Nếu đạt đến giới hạn, trạng thái Skyframe sẽ không còn bị bỏ qua khi xảy ra một sự kiện GC nhỏ và ngưỡng tỷ lệ phần trăm vùng nhớ khối xếp được giữ lại đó đã vượt quá.
Thẻ: host_machine_resource_optimizations
Mặc định của --skyframe_high_water_mark_threshold=<an integer>: "85"
Gắn cờ cho cấu hình nâng cao của công cụ Skyframe nội bộ của Bazel. Nếu Bazel 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 ở ngưỡng này, thì Bazel sẽ bỏ trạng thái Skyframe tạm thời không cần thiết. Việc chỉnh sửa tính năng này có thể cho phép bạn giảm thiểu tác động của tình trạng này đến thời gian sử dụng GC, khi tình trạng giật GC là do việc sử dụng bộ nhớ ở trạng thái tạm thời này gây ra và (ii) tốn kém hơn so với việc khôi phục trạng thái khi cần.
Thẻ: host_machine_resource_optimizations
Các tuỳ chọn ảnh hưởng đến độ chi tiết, định dạng hoặc vị trí ghi nhật ký:
Mặc định của --[no]experimental_command_profile: "false"
Ghi lại hồ sơ CPU của Trình ghi chuyến bay Java vào tệp profile.jfr trong thư mục cơ sở đầu ra. Trong tương lai, cú pháp và ngữ nghĩa của cờ này có thể thay đổi để hỗ trợ nhiều loại hồ sơ hoặc định dạng đầu ra; bạn tự chịu rủi ro khi sử dụng.
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 thao tác ghi nhớ 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ả chức năng ghi nhớ.
Mặc định của --[no]print_relative_test_log_paths: "false"
Nếu giá trị là true, khi in đường dẫn đến nhật ký kiểm thử, hãy sử dụng đường dẫn tương đối có sử dụng đường liên kết tiện lợi "testlogs" (nhật ký kiểm thử). N.B. - Lệnh gọi 'build'/'test'/v.v tiếp theo với cấu hình khác có thể làm cho mục tiêu của liên kết tượng trưng này thay đổi, làm cho đường dẫn được in trước đó không còn hữu ích nữa.
Thẻ: affects_outputs
Mặc định của --[no]test_verbose_timeout_warnings: "false"
Nếu đúng, hãy in thêm cảnh báo khi thời gian chạy kiểm thử thực tế không khớp với thời gian chờ do kiểm thử xác định (dù ngụ ý hay tục tĩu).
Thẻ: affects_outputs
Mặc định của --[no]verbose_test_summary: "đúng"
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 phần tóm tắt quy trình kiểm thử.
Thẻ: affects_outputs
Tuỳ chọn chỉ định hoặc thay đổi dữ liệu đầu vào chung thành lệnh Bazel không thuộc các danh mục khác.:
Mặc định của --experimental_resolved_file_instead_of_workspace=<a string>: ""
Nếu nội dung không trống, hãy đọc tệp đã được phân giải được chỉ định thay vì tệp WORKSPACE
Các thẻ: changes_inputs
Các tuỳ chọn thực thi và lưu vào bộ nhớ đệm từ xa:
Mặc định của --experimental_downloader_config=<a string>: 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ủ (cho `allow` và `block`) hoặc hai mẫu, một mẫu để so khớp và một mẫu dùng làm URL thay thế, có tham chiếu ngược bắt đầu từ "$1". Có thể có nhiều lệnh "rewrite" cho cùng một URL và trong trường hợp này sẽ có nhiều URL được trả về.
Mặc định của --experimental_worker_for_repo_fetching=<off, platform or virtual>: "tắt"
Chế độ phân luồng dùng để tìm nạp kho lưu trữ. Nếu bạn đặt chính sách này thành "tắt", thì sẽ không có luồng worker nào được sử dụng và quá trình tìm nạp kho lưu trữ có thể khởi động lại. Ngược lại, hãy sử dụng luồng nền tảng (tức là luồng hệ điều hành) nếu được đặt thành "platform" hoặc luồng ảo nếu được đặt thành "virtual".
Các lựa chọn khác, không được phân loại.:
Đã tích luỹ --override_repository=<an equals-separated mapping of repository name to path> lần sử dụng
Ghi đè một 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à một đường dẫn tuyệt đối, thì đường dẫn đó sẽ được sử dụng nguyên vẹn. Nếu đường dẫn đã cho là một đườ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 này 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 "không gian làm việc thông tin bazel")

Tuỳ chọn phiên bản

Các tuỳ chọn xuất hiện trước lệnh và được ứng dụng phân tích cú pháp:
Đã tích luỹ --distdir=<a path> lần sử dụng
Các nơi khác để tìm kiếm các tệp lưu trữ trước khi truy cập mạng để tải các tệp lưu trữ đó xuống.
Thẻ: bazel_internal_configuration
Nếu bạn đặt chính sách này, bộ nhớ đệm của kho lưu trữ sẽ liên kết cứng tệp đó trong trường hợp tệp bị tấn công vào bộ nhớ đệm, thay vì sao chép. Mục đích của tính năng này là tiết kiệm dung lượng ổ đĩa.
Thẻ: bazel_internal_configuration
Mặc định của --experimental_repository_downloader_retries=<an integer>: "0"
Số lần thử lại một lỗi tải xuống tối đa. Nếu bạn đặt chính sách này thành 0, thì tính năng thử lại sẽ tắt.
Thẻ: experimental
Mặc định của --experimental_scale_timeouts=<a double>: "1.0"
Điều chỉnh tỷ lệ tất cả thời gian chờ trong quy tắc lưu trữ Starlark theo hệ số này. Bằng cách này, kho lưu trữ bên ngoài có thể được tạo ra hoạt động trên các máy chậm hơn tác giả quy tắc dự kiến mà không cần thay đổi mã nguồn
Thẻ: bazel_internal_configuration, experimental
Mặc định của --http_connector_attempts=<an integer>: "8"
Số lần thử tải xuống http tối đa.
Thẻ: bazel_internal_configuration
Mặc định của --http_connector_retry_max_timeout=<An immutable length of time.>: "0 giây"
Thời gian chờ tối đa cho các lần thử tải xuống lại http. Với giá trị 0, không có thời gian chờ tối đa nào được xác định.
Thẻ: bazel_internal_configuration
Mặc định của --http_timeout_scaling=<a double>: "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ố cụ thể
Thẻ: bazel_internal_configuration
Mặc định của --repository_cache=<a path>: 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. Một chuỗi trống làm đối số yêu cầu tắt bộ nhớ đệm, nếu không, hệ thống sẽ sử dụng giá trị mặc định của '<output_user_root>/cache/repos/v1'
Thẻ: bazel_internal_configuration
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ị vô hiệu hoá hoàn toàn; ctx.exe vẫn có thể chạy một tệp thực thi tuỳ ý truy cập vào Internet.
Thẻ: bazel_internal_configuration
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 --gc_thrashing_threshold=<an integer in 0-100 range>: "100"
Tỷ lệ phần trăm không gian đã sử dụng đã sử dụng (0 – 100) trên đó 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 giá trị này thành 100, thì GcThrashingDetector sẽ 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ự định, ảnh hưởng đến giá trị của đầu ra đó thay vì sự tồn tại của đầu ra đó:
Mặc định của --[no]gnu_format: "false"
Nếu được đặt, hãy viết phiên bản vào stdout bằng cách sử dụ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 đầu ra và ngữ nghĩa Bzlmod:
Đã tích luỹ --allow_yanked_versions=<a string> lần sử dụng
Đã chỉ định các phiên bản mô-đun dưới dạng `<module1>@<version1>,<module2>@<version2>`. Những phiên bản này sẽ được 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 trong sổ đăng ký nơi chúng xuất phát (nếu các phiên bản đó không đến từ một NonRegistryOverride). Nếu không, các phiên bản bị giật sẽ khiến quá trình phân giải không thành công. Bạn cũng có thể xác định phiên bản được kéo mạnh được phép bằng biến môi trường "BZLMOD_ALLOW_YANKED_VERSIONS". Bạn có thể vô hiệu hoá việc kiểm tra này bằng cách sử dụng từ khoá 'all' (không được khuyến nghị).
Thẻ: loading_and_analysis
Mặc định của --check_bazel_compatibility=<error, warning or off>: "lỗi"
Kiểm tra khả năng tương thích với 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 đề lên trạng thái lỗi giải quyết, "tắt" để tắt chế độ kiểm tra, hoặc "cảnh báo" để in cảnh báo khi phát hiện thấy thông tin không khớp.
Thẻ: loading_and_analysis
Mặc định của --check_direct_dependencies=<off, warning or error>: "cảnh báo"
Kiểm tra xem các phần phụ thuộc trực tiếp "bazel_dep" được khai báo trong mô-đun gốc có giống với phiên bản bạn nhận được trong biểu đồ phần phụ thuộc đã được giải quyết hay không. Các giá trị hợp lệ là "off" ("tắt") để tắt chế độ kiểm tra, "cảnh báo" để in cảnh báo khi phát hiện thấy thông tin không khớp hoặc "error" để chuyển vấn đề lên thành lỗi giải quyết.
Thẻ: loading_and_analysis
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_secondary` trong MODULE.bazel của mô-đun gốc. Lưu ý rằng các phần phụ thuộc của 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
Mặc định của --lockfile_mode=<off, update or error>: "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 nếu có thay đổi, "error" khi dùng tệp khoá nhưng báo lỗi nếu tệp không được cập nhật, hoặc "tắt" để không đọc hoặc ghi vào tệp khoá.
Thẻ: loading_and_analysis
Đã tích luỹ --override_module=<an equals-separated mapping of module name to path> lần sử dụng
Ghi đè một mô-đun có đường dẫn cục bộ ở dạng <module name>=<path>. Nếu đường dẫn đã cho là một đường dẫn tuyệt đối, thì đường dẫn đó sẽ được sử dụng như nguyên trạng. Nếu đường dẫn đã cho là một đường dẫn tương đối, thì đường dẫn đó sẽ tương ứng với thư mục đang hoạt động hiện tại. Nếu đường dẫn đã cho bắt đầu bằng "%workspace%", thì đường dẫn đó 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 "không gian làm việc thông tin bazel")
Đã tích luỹ --registry=<a string> lần sử dụng
Chỉ định sổ đăng ký cần dùng để xác định vị trí các phần phụ thuộc của mô-đun Bazel. Thứ tự rất quan trọng: các mô-đun sẽ được tra cứu trước trong sổ đăng ký trước, và chỉ quay lại các sổ đăng ký sau khi còn thiếu trong các sổ đăng ký trước đó.
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:
Mặc định của --gc_thrashing_limits=<comma separated pairs of <period>:<count>>: "1s:2,20s:3,1m:5"
Các giới hạn mà nếu đạt đến mức này sẽ khiến GcThrashingDetector gây sự cố cho Bazel bằng OOM. Mỗi giới hạn được chỉ định dưới dạng <period>:<count>, trong đó khoảng thời gian là một khoảng thời gian và số lượng là một số nguyên dương. Nếu có hơn --gc_thrashing_threshold phần trăm không gian cần sử dụng (vùng nhớ khối xếp thế hệ cũ) vẫn chiếm sau <count> các GC đầy đủ liên tiếp trong khoảng <period>, thì OOM sẽ được kích hoạt. Bạn có thể chỉ định nhiều hạn mức và phân tách bằng dấu phẩy.
Thẻ: host_machine_resource_optimizations
Mặc định của --skyframe_high_water_mark_full_gc_drops_per_invocation=<an integer, >= 0>: "2147483647"
Gắn cờ cho cấu hình nâng cao của công cụ Skyframe nội bộ của Bazel. Nếu Bazel phát hiện thấy 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 đặt ra bằng --skyframe_high_water_mark_threshold, thì khi một sự kiện GC xảy ra đầy đủ, trạng thái Skyframe tạm thời không cần thiết sẽ bị bỏ qua, tối đa nhiều lần cho mỗi lệnh gọi. Mặc định là Integer.MAX_VALUE; không giới hạn hiệu quả. 0 có nghĩa là các sự kiện thu gom rác (GC) toàn bộ sẽ không bao giờ kích hoạt hiện tượng giảm. Nếu đạt đến giới hạn, trạng thái Skyframe sẽ không còn bị bỏ qua khi một sự kiện GC đầy đủ xảy ra và vượt quá ngưỡng tỷ lệ phần trăm vùng nhớ khối xếp được giữ lại đó.
Thẻ: host_machine_resource_optimizations
Mặc định của --skyframe_high_water_mark_minor_gc_drops_per_invocation=<an integer, >= 0>: "2147483647"
Gắn cờ cho cấu hình nâng cao của công cụ Skyframe nội bộ của Bazel. Nếu Bazel phát hiện thấy mức sử dụng tỷ lệ phần trăm vùng nhớ khối xếp được giữ lại vượt quá ngưỡng đặt ra bằng --skyframe_high_water_mark_threshold, thì khi một sự kiện GC nhỏ xảy ra, trạng thái Skyframe tạm thời không cần thiết sẽ bị bỏ qua, tối đa là nhiều lần cho mỗi lệnh gọi. Mặc định là Integer.MAX_VALUE; không giới hạn hiệu quả. 0 có nghĩa là các sự kiện GC nhỏ sẽ không bao giờ kích hoạt hiện tượng giảm. Nếu đạt đến giới hạn, trạng thái Skyframe sẽ không còn bị bỏ qua khi xảy ra một sự kiện GC nhỏ và ngưỡng tỷ lệ phần trăm vùng nhớ khối xếp được giữ lại đó đã vượt quá.
Thẻ: host_machine_resource_optimizations
Mặc định của --skyframe_high_water_mark_threshold=<an integer>: "85"
Gắn cờ cho cấu hình nâng cao của công cụ Skyframe nội bộ của Bazel. Nếu Bazel 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 ở ngưỡng này, thì Bazel sẽ bỏ trạng thái Skyframe tạm thời không cần thiết. Việc chỉnh sửa tính năng này có thể cho phép bạn giảm thiểu tác động của tình trạng này đến thời gian sử dụng GC, khi tình trạng giật GC là do việc sử dụng bộ nhớ ở trạng thái tạm thời này gây ra và (ii) tốn kém hơn so với việc khôi phục trạng thái khi cần.
Thẻ: host_machine_resource_optimizations
Các tuỳ chọn ảnh hưởng đến độ chi tiết, định dạng hoặc vị trí ghi nhật ký:
Mặc định của --[no]experimental_command_profile: "false"
Ghi lại hồ sơ CPU của Trình ghi chuyến bay Java vào tệp profile.jfr trong thư mục cơ sở đầu ra. Trong tương lai, cú pháp và ngữ nghĩa của cờ này có thể thay đổi để hỗ trợ nhiều loại hồ sơ hoặc định dạng đầu ra; bạn tự chịu rủi ro khi sử dụng.
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 thao tác ghi nhớ 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ả chức năng ghi nhớ.
Các tuỳ chọn chỉ định hoặc thay đổi dữ liệu đầu vào chung thành lệnh Bazel mà không thuộc các danh mục khác.:
Mặc định của --experimental_resolved_file_instead_of_workspace=<a string>: ""
Nếu nội dung không trống, hãy đọc tệp đã được phân giải được chỉ định thay vì tệp WORKSPACE
Các thẻ: changes_inputs
Các tuỳ chọn thực thi và lưu vào bộ nhớ đệm từ xa:
Mặc định của --experimental_downloader_config=<a string>: 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ủ (cho `allow` và `block`) hoặc hai mẫu, một mẫu để so khớp và một mẫu dùng làm URL thay thế, có tham chiếu ngược bắt đầu từ "$1". Có thể có nhiều lệnh "rewrite" cho cùng một URL và trong trường hợp này sẽ có nhiều URL được trả về.
Mặc định của --experimental_worker_for_repo_fetching=<off, platform or virtual>: "tắt"
Chế độ phân luồng dùng để tìm nạp kho lưu trữ. Nếu bạn đặt chính sách này thành "tắt", thì sẽ không có luồng worker nào được sử dụng và quá trình tìm nạp kho lưu trữ có thể khởi động lại. Ngược lại, hãy sử dụng luồng nền tảng (tức là luồng hệ điều hành) nếu được đặt thành "platform" hoặc luồng ảo nếu được đặt thành "virtual".
Các lựa chọn khác, không được phân loại.:
Đã tích luỹ --override_repository=<an equals-separated mapping of repository name to path> lần sử dụng
Ghi đè một 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à một đường dẫn tuyệt đối, thì đường dẫn đó sẽ được sử dụng nguyên vẹn. Nếu đường dẫn đã cho là một đườ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 này 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 "không gian làm việc thông tin bazel")

Thẻ hiệu ứng lựa chọn

unknown Tuỳ chọn này có hiệu lực không xác định hoặc không được ghi nhận.
no_op Tuỳ chọn này hoàn toàn không có tác dụng.
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, từ đó làm chậm quá trình tạo bản dựng. Trạng thái có thể bị mất do việc máy chủ khởi động lại hoặc phần lớn biểu đồ phần phụ thuộc bị vô hiệu hoá.
changes_inputs Tuỳ chọn này sẽ chủ động thay đổi các dữ liệu đầu vào mà bazel xem xét để tạo bản dựng, chẳng hạn như các hạn chế đối với 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 mở rộng một cách có chủ ý, có thể bao gồm ảnh hưởng bắc cầu và không chỉ định loại đầu ra có ảnh hưởng.
build_file_semantics Tuỳ chọn này ảnh hưởng đến ngữ nghĩa của các 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 thiết bị nội bộ bazel. Bản thân thẻ này không ảnh hưởng đến cấu phần phần mềm bản dự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 Lựa chọn này kích hoạt một quá trình tối ưu hoá có thể dành riêng cho từng máy và không đảm bảo sẽ hoạt động trên mọi máy. Quá trình tối ưu hoá có thể bao gồm cả việc đánh đổi các khía cạnh khác về hiệu suất, chẳng hạn như chi phí bộ nhớ hoặc cpu.
eagerness_to_exit Tuỳ chọn này thay đổi mức độ sẵn sàng thoát của bazel khi gặp lỗi, trong đó bạn phải lựa chọn tiếp tục bất chấp 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 đầu cuối của 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 tạo bản dựng.
test_runner Tuỳ chọn này thay đổi môi trường chạy kiểm thử của bản dựng.

Thẻ siêu dữ liệu 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 về chức năng.
incompatible_change Tuỳ chọn này kích hoạt một thay đổi có thể gây lỗi. Hãy sử dụng lựa chọn này để kiểm tra mức độ sẵn sàng di chuyển hoặc nhận quyền tiếp cận sớm vào tính năng mới này
deprecated Tuỳ chọn này không được dùng nữa. Có thể tính năng mà ảnh hưởng đến đã ngừng hoạt động hoặc một phương thức cung cấp thông tin khác được ưu tiên.