bazel [<startup options>] <command> [<args>]hoặc
bazel [<startup options>] <command> [<args>] -- [<target patterns>]Hãy xem Hướng dẫn sử dụng để biết mẫu mục tiêu.
Cú pháp lựa chọn
Bạn có thể truyền các tuỳ chọn đến Bazel theo nhiều cách. Tuỳ chọn yêu cầu giá trị có thể được chuyển cùng với 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ự; trong trường hợp đó, định dạng ngắn phải được vượt qua bằng một dấu gạch ngang 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 ba trạng thái thường được đặt thành tự động theo mặc định và có thể là buộ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ủ (không bắt buộc). |
coverage |
Tạo báo cáo mức độ sử dụng mã cho các mục tiêu kiểm thử đã chỉ định. |
cquery |
Tải, phân tích và truy vấn các mục tiêu được chỉ định bằng cấu hình. |
dump |
Kết xuất trạng thái nội bộ của quy trình máy chủ bazel. |
fetch |
Tìm nạp các kho lưu trữ bên ngoài là điều kiện tiên quyết đối với mục tiêu. |
help |
In phần trợ giúp cho các lệnh hoặc chỉ mục. |
info |
Hiện 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 mục tiêu đến thiết bị di động. |
modquery |
Truy vấn biểu đồ phần phụ thuộc bên ngoài của Bzlmod |
print_action |
In đối số dòng lệnh để biên dịch tệp. |
query |
Thực thi truy vấn biểu đồ phần phụ thuộc. |
run |
Chạy mục tiêu đã chỉ định. |
shutdown |
Dừng máy chủ bazel. |
sync |
Đồng bộ hoá tất cả kho lưu trữ được chỉ định trong tệp không gian làm việc |
test |
Tạo và chạy các mục tiêu kiểm thử được chỉ định. |
version |
In thông tin phiên bản cho bazel. |
Tuỳ chọn khởi động
- Các tuỳ chọn xuất hiện trước lệnh và được ứng dụng phân tích cú pháp:
- Giá trị mặc định của
--[no]autodetect_server_javabase
: "true" -
Khi --noautodetect_server_javabase được truyền, Bazel không quay lại JDK cục bộ để chạy máy chủ bazel và thay vào đó thoát.
Thẻ:affects_outputs
,loses_incremental_state
- Giá trị mặc định của
--[no]batch
: "false" -
Nếu được đặt, Bazel sẽ chỉ chạy dưới dạng một quy trình ứng dụng mà không cần máy chủ, thay vì ở chế độ ứng dụng/máy chủ tiêu chuẩn. Tính năng này không được dùng nữa và sẽ bị loại bỏ, vui lòng nên 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ủ tồn tại.
Thẻ:loses_incremental_state
,bazel_internal_configuration
,deprecated
- Giá trị mặc định của
--[no]batch_cpu_scheduling
: "false" -
Chỉ có trên Linux; sử dụng "hàng loạt" Lên lịch cho CPU trong chế độ linh hoạt. Chính sách này hữu ích cho các khối lượng công việc không mang tính tương tác, nhưng không muốn giảm giá trị tốt của chúng. Hãy xem "man 2 sched_setscheduler". Nếu đặt 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
--bazelrc=<path>
: xem nội dung mô tả -
Vị trí của tệp .bazelrc chứa các giá trị mặc định của các lựa chọn Bazel. /dev/null cho biết rằng tất cả các `--bazelrc`nữa sẽ bị bỏ qua. Điều này rất hữu ích khi vô hiệu hoá tìm kiếm tệp rc của người dùng, ví dụ: trong bản phát hành.
Bạn cũng có thể chỉ định lựa chọn này nhiều lần.
Ví dụ: với `--bazelrc=x.rc --bazelrc=y.rc --bazelrc=/dev/null --bazelrc=z.rc`,
1) x.rc và y.rc được đọc.
2) z.rc bị bỏ qua do /dev/null trước đó.
Nếu chưa chỉ định, Bazel sẽ sử dụng tệp .bazelrc đầu tiên được tìm thấy ở hai vị trí sau: thư mục Workspace, sau đó là thư mục gốc của người dùng.
Lưu ý: các tuỳ chọn dòng lệnh sẽ luôn thay thế mọi tuỳ chọn trong bazelrc.
Thẻ:changes_inputs
- Giá trị mặc định của
--[no]block_for_lock
: "true" -
Khi --noblock_for_lock được truyền, Bazel không đợi một lệnh đang chạy hoàn tất, mà thay vào đó sẽ thoát ngay lập tức.
Thẻ:eagerness_to_exit
- Giá trị mặc định của
--[no]client_debug
: "false" -
Nếu đúng, hãy ghi thông tin gỡ lỗi từ ứng dụng vào stderr. Việc thay đổi tuỳ chọn này sẽ không khiến máy chủ khởi động lại.
Thẻ:affects_outputs
,bazel_monitoring
- Giá trị mặc định của
--connect_timeout_secs=<an integer>
: "30" -
Khoảng thời gian ứng dụng chờ mỗi lần thử kết nối với máy chủ
Thẻ:bazel_internal_configuration
- Giá trị mặc định của
--[no]expand_configs_in_place
: "true" -
Thay đổi việc mở rộng cờ --config thành đượ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à tuỳ chọn dòng lệnh được chỉ định.
Thẻ:no_op
,deprecated
- Mặc định
--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 protobuf lỗi_detail nếu máy chủ gặp lỗi và không thể báo cáo lỗi đó qua gRPC như bình thường. Nếu không, vị trí sẽ là ${OUTPUT_BASE}/failure_detail.rawproto.
Thẻ:affects_outputs
,loses_incremental_state
- Giá trị mặc định của
--[no]home_rc
: "true" -
Có tìm kiếm tệp bazelrc nhà tại $HOME/.bazelrc hay không
Thẻ:changes_inputs
- Giá trị mặc định của
--[no]idle_server_tasks
: "true" -
Chạy System.gc() khi máy chủ ở trạng thái rảnh
Thẻ:loses_incremental_state
,host_machine_resource_optimizations
- Giá trị mặc định của
--[no]ignore_all_rc_files
: "false" -
Tắt tất cả tệp rc, bất kể giá trị của các cờ sửa đổi rc khác là gì, ngay cả khi các cờ này xuất hiện sau này trong danh sách tuỳ chọn khởi động.
Thẻ:changes_inputs
- Giá trị 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ức từ 0-7 để lên lịch IO nỗ lực tốt 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à thấp nhất. Trình lập lịch biểu dự đoán chỉ có thể thực hiện tối đa mức độ ưu tiên 4. 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
- Giá trị mặc định của
--local_startup_timeout_secs=<an integer>
: "120" -
Khoảng thời gian tối đa mà máy khách 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" -
Thiết lập 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 thay đổi. Các giá trị có thể có là: tương tác với người dùng, do người dùng khởi tạo, mặc định, tiện ích và nền.
Thẻ:host_machine_resource_optimizations
- 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ờ không hoạt động trước khi tắt. Số không có nghĩa là máy chủ sẽ không bao giờ tắt. Thông báo 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
--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. 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 với 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 đúng một máy chủ cho mỗi cơ sở đầu ra được chỉ định. Thường có một cơ sở đầu ra cho mỗi không gian làm việc. Tuy nhiên, với tuỳ chọn này, bạn có thể có nhiều cơ sở đầu ra cho mỗi không gian làm việc và do đó, chạy đồng thời nhiều bản dựng cho cùng một ứng dụng khách trên cùng một máy. Xem bài viết "giúp tắt ứng dụng bazel" về cách tắt máy chủ Bazel.
Thẻ:affects_outputs
,loses_incremental_state
- Mặc định
--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 tất cả kết quả của bản dựng đều được ghi; theo mặc định, đây là một hàm của $USER, nhưng bằng cách chỉ định một hằng số, đầu ra 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
- Giá trị mặc định của
--[no]preemptible
: "false" -
Nếu là true, lệnh đó có thể bị giành quyền khi một lệnh khác được khởi động.
Thẻ:eagerness_to_exit
- Mặc định
--server_jvm_out=<path>
: xem nội dung mô tả -
Vị trí để ghi đầu ra JVM của máy chủ. Nếu bạn không đặt chính sách này, thì giá trị mặc định sẽ là một vị trí trong output_base.
Thẻ:affects_outputs
,loses_incremental_state
- Giá trị mặc định của
--[no]shutdown_on_low_sys_mem
: "false" -
Nếu bạn đặt max_idle_secs và máy chủ bản dựng đã 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ỉ Linux.
Thẻ:eagerness_to_exit
,loses_incremental_state
- Giá trị mặc định của
--[no]system_rc
: "true" -
Liệu có tìm kiếm bazelrc trên toàn hệ thống hay không.
Thẻ:changes_inputs
- Giá trị mặc định của
--[no]unlimit_coredumps
: "false" -
Tăng giới hạn coredump mềm lên giới hạn cố định để tạo ra các lõi mềm của máy chủ (bao gồm cả JVM) và ứng dụng khách trong các điều kiện chung. Hãy dán cờ này vào bazelrc của bạn một lần và quên nó để nhận được các coredumps khi bạn thực sự gặp một điều kiện kích hoạt chúng.
Thẻ:bazel_internal_configuration
- Giá trị mặc định của
--[no]watchfs
: "false" -
Nếu true, bazel cố gắng sử dụng dịch vụ theo dõi tệp của hệ điều hành để kiểm tra các thay đổi trên thiết bị thay vì quét từng tệp để tìm thay đổi.
Thẻ:deprecated
- Giá trị mặc định của
--[no]windows_enable_symlinks
: "false" -
Nếu đúng, các liên kết tượng trưng thực sẽ được tạo trên Windows thay vì sao chép tệp. Yêu cầu bật chế độ nhà phát triển Windows và Windows 10 phiên bản 1703 trở lên.
Thẻ:bazel_internal_configuration
- Giá trị mặc định của
--[no]workspace_rc
: "true" -
Có tìm kiếm tệp bazelrc Workspace tại $workspace/.bazelrc hay không
Thẻ:changes_inputs
- Các lựa chọn khác, không được phân loại theo cách khác.:
--host_jvm_args=<jvm_arg>
lần dùng được tích luỹ- Cờ để chuyển đến JVM thực thi Blaze.
--host_jvm_debug
-
Tuỳ chọn thuận tiện để thêm một số cờ khởi động JVM bổ sung, khiến JVM chờ trong khi khởi động cho đến khi bạn kết nối từ trình gỡ lỗi tuân thủ JDWP (như Eclipse) đến cổng 5005.
Mở rộng thành:
--host_jvm_args=-Xdebug
--host_jvm_args=-Xrunjdwp:transport=dt_socket,server=y,address=5005
- Giá trị 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 JVM dành riêng cho trình phân tích/trình gỡ lỗi. Bazel có một danh sách các giá trị đã biết mà nó ánh xạ tới cờ khởi động JVM được mã hoá cứng, có thể tìm kiếm một số đường dẫn được cố định giá trị trong mã cho một số tệp nhất định.
- Giá trị mặc định của
--server_javabase=<jvm path>
: "" - Đường dẫn đến JVM dùng để thực thi chính Bazel.
Các lựa chọn chung cho mọi lệnh
- Các tuỳ chọn kiểm soát việc thực thi bản dựng:
- Mặc định của
--experimental_oom_more_eagerly_threshold=<an integer>
: "100" -
Nếu cờ này được đặt thành một giá trị nhỏ hơn 100, Bazel sẽ OOM nếu sau 2 GC đầy đủ mà vẫn còn nhiều hơn tỷ lệ phần trăm này của vùng nhớ khối xếp (thế hệ cũ).
Thẻ:host_machine_resource_optimizations
- Giá trị 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
- Các tuỳ chọn cho phép người dùng định cấu hình đầu ra dự kiến, ảnh hưởng đến giá trị của đầu ra đó, trái ngược với sự tồn tại của đầu ra đó:
--repo_env=<a 'name=value' assignment with an optional value part>
lần dùng được tích luỹ-
Chỉ định các biến môi trường bổ sung chỉ dành cho quy tắc về kho lưu trữ. Xin lưu ý rằng dù sao các quy tắc kho lưu trữ cũng xem được môi trường đầy đủ, nhưng bằng cách này, thông tin cấu hình có thể được truyền đến kho lưu trữ thông qua các tuỳ chọn mà không làm mất hiệu lực của biểu đồ hành động.
Thẻ:action_command_lines
- Các lựa chọn ảnh hưởng đến mức độ nghiêm ngặt của Bazel trong việc thực thi dữ liệu đầu vào bản dựng hợp lệ (định nghĩa quy tắc, tổ hợp cờ, v.v.):
- Giá trị mặc định của
--[no]check_bzl_visibility
: "true" -
Nếu bạn tắt chính sách này, các lỗi hiển thị khi tải tệp .bzl sẽ bị giảm hạng xuống thành cảnh báo.
Thẻ:build_file_semantics
- Tuỳ chọn này ảnh hưởng đến ngữ nghĩa của ngôn ngữ Starlark hoặc API bản dựng có thể truy cập vào các tệp BUILD, tệp .bzl hoặc tệp WORKSPACE.:
- Giá trị mặc định của
--[no]enable_bzlmod
: "false" -
Nếu đúng, hãy bật hệ thống quản lý phần phụ thuộc Bzlmod và được ưu tiên hơn WORKSPACE. Hãy tham khảo tại https://bazel.build/docs/bzlmod để biết thêm thông tin.
Thẻ:loading_and_analysis
- Giá trị mặc định của
--[no]experimental_action_resource_set
: "true" -
Nếu bạn đặt chính sách này thành true, thì ctx.actions.run() và ctx.Hành động.run_shell() sẽ chấp nhận tham số resource_set để thực thi cục bộ. Nếu không, trình mô phỏng sẽ mặc định là 250 MB cho bộ nhớ và 1 CPU.
Thẻ:execution
,build_file_semantics
,experimental
-
Nếu bạn đặt chính sách này thành true, thì thẻ sẽ được truyền từ một mục tiêu đến các hành động yêu cầu thực thi; nếu không thì các thẻ sẽ không được nhân bản. Hãy truy cập https://github.com/bazelbuild/bazel/issues/8830 để biết thông tin chi tiết.
Thẻ:build_file_semantics
,experimental
- Giá trị mặc định của
--[no]experimental_analysis_test_call
: "true" -
Nếu bạn đặt chính sách này thành true, thì lệnh gọi gốc analytics_test sẽ hoạt động.
Thẻ:loading_and_analysis
,build_file_semantics
,experimental
- Giá trị mặc định của
--[no]experimental_bzl_visibility
: "true" -
Nếu được bật, hãy thêm hàm " visibility()" mà các tệp .bzl có thể gọi trong quá trình đánh giá cấp cao nhất để thiết lập chế độ hiển thị cho các câu lệnh tải().
Thẻ:loading_and_analysis
,experimental
-
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ẽ được cung cấp
Thẻ:build_file_semantics
,loading_and_analysis
,experimental
- Giá trị mặc định của
--[no]experimental_disable_external_package
: "false" -
Nếu bạn đặt chính sách này thành true, thì //gói bên ngoài được tạo tự động sẽ không 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 cầu nối tiếp cậ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
- Giá trị 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, sẽ bật các API cần thiết để hỗ trợ quá trình di chuyển sang Android Starlark.
Thẻ:build_file_semantics
- Giá trị mặc định của
--[no]experimental_get_fixed_configured_action_env
: "false" -
Nếu bạn bật tuỳ chọn này, thì action.env cũng sẽ trả về các biến môi trường cố định được chỉ định thông qua cấu hình tính năng.
Thẻ:loading_and_analysis
,experimental
- Giá trị 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, thì hệ thống sẽ hiển thị một số phần thử nghiệm của API bản dựng Starlark liên quan đến mã cũ của Google.
Thẻ:loading_and_analysis
,experimental
- Giá trị mặc định của
--[no]experimental_lazy_template_expansion
: "true" -
Nếu bạn đặt chính sách này thành true, thì ctx.actions.expand_template() chấp nhận thông số TemplateDict để trì hoãn việc đánh giá các giá trị thay thế.
Thẻ:execution
,build_file_semantics
,experimental
- Giá trị 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ẽ được bật để giúp gỡ lỗi.
Thẻ:loading_and_analysis
,experimental
- Giá trị mặc định của
--[no]experimental_repo_remote_exec
: "false" -
Nếu bạn đặt chính sách này thành đúng, kho lưu trữ sẽ nhận được một số khả năng thực thi từ xa.
Thẻ:build_file_semantics
,loading_and_analysis
,experimental
- Giá trị mặc định của
--[no]experimental_sibling_repository_layout
: "false" -
Nếu 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 đặt dưới dạng đường liên kết tượng trưng đến kho lưu trữ chính trong thư mục gốc của quá trình thực thi. Tức là mọi kho lưu trữ đều là con trực tiếp của thư mục $output_base/execution_root. Điều này có tác dụng phụ là giải phóng $output_base/execution_root/__main__/external cho "bên ngoài" cấp cao nhất thực sự thư mục.
Thẻ:action_command_lines
,bazel_internal_configuration
,loading_and_analysis
,loses_incremental_state
,experimental
- Giá trị mặc định của
--[no]incompatible_always_check_depset_elements
: "true" -
Kiểm tra tính hợp lệ của các phần tử được thêm vào phần phụ thuộc, trong tất cả 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. Sử dụng các bộ dữ liệu thay vì danh sách trong phần tử gỡ bỏ. Hãy truy cập vào https://github.com/bazelbuild/bazel/issues/10313 để biết thông tin chi tiết.
Thẻ:build_file_semantics
,incompatible_change
- Giá trị mặc định của
--[no]incompatible_depset_for_libraries_to_link_getter
: "true" -
Khi đúng, Bazel không còn trả về danh sách từ linking_context.libraries_to_link mà thay vào đó trả về một phần depset.
Thẻ:loading_and_analysis
,incompatible_change
- Giá trị 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 quy tắc sẽ không thể đặt "cfg = "host"". Quy tắc phải đặt "cfg = "exec"" thay thế.
Thẻ:loading_and_analysis
,incompatible_change
- Giá trị mặc định của
--[no]incompatible_disable_target_provider_fields
: "false" -
Nếu bạn đặt chính sách này thành true, hãy tắt khả năng truy cập vào nhà cung cấp trên "target" 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" bên trong hàm triển khai quy tắc, hãy sử dụng "ctx.attr.dep[MyInfo]". Hãy truy cập vào https://github.com/bazelbuild/bazel/issues/9014 để biết thông tin chi tiết.
Thẻ:build_file_semantics
,incompatible_change
- Giá trị mặc định của
--[no]incompatible_disallow_empty_glob
: "false" -
Nếu bạn đặt chính sách này thành đúng, thì giá trị mặc định của đối số "allow_Empty" sẽ là giá trị mặc định của glob() sẽ là False.
Thẻ:build_file_semantics
,incompatible_change
- Giá trị mặc định của
--[no]incompatible_disallow_legacy_javainfo
: "true" -
Không được dùng nữa. Không hoạt động.
Thẻ:build_file_semantics
,incompatible_change
- Giá trị 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ể không trả về cấu trúc. Thay vào đó, các lớp này phải trả về danh sách các phiên bản của nhà cung cấp.
Thẻ:build_file_semantics
,incompatible_change
- Giá trị mặc định của
--[no]incompatible_existing_rules_immutable_view
: "true" -
Nếu bạn đặt chính sách này thành true, native.existing_rules và native.existing_rules sẽ trả về các đối tượng chế độ xem không thể thay đổi gọn nhẹ thay vì các lệnh chính tả có thể thay đổi.
Thẻ:build_file_semantics
,loading_and_analysis
,incompatible_change
- Giá trị mặc định của
--[no]incompatible_fix_package_group_reporoot_syntax
: "true" -
Trong thuộc tính "packages" của nhóm_gói, hãy thay đổi ý nghĩa của giá trị "//..." tham chiếu đến tất cả các gói trong kho lưu trữ hiện tại thay vì tất cả các gói trong bất kỳ kho lưu trữ nào. Bạn có thể sử dụng giá trị đặc biệt "công khai" thay cho "//..." để lấy hành vi cũ. Cờ này yêu cầu cũng phải bật --incompatible_package_group_has_public_syntax”.
Thẻ:build_file_semantics
,incompatible_change
- Giá trị mặc định của
--[no]incompatible_java_common_parameters
: "true" -
Nếu 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 đều sẽ bị xoá.
Thẻ:build_file_semantics
,incompatible_change
- Giá trị mặc định của
--[no]incompatible_new_actions_api
: "true" -
Nếu bạn đặt chính sách này thành true, thì API để tạo thao tác sẽ chỉ hoạt động trên "ctx.action" chứ không hoạt động trên "ctx".
Thẻ:build_file_semantics
,incompatible_change
- Giá trị mặc định của
--[no]incompatible_no_attr_license
: "true" -
Nếu bạn đặt chính sách này thành true, thì hàm "attr.License" sẽ tắt.
Thẻ:build_file_semantics
,incompatible_change
- Giá trị mặc định của
--[no]incompatible_no_implicit_file_export
: "false" -
Nếu được đặt, tệp nguồn (đã qua sử dụng) sẽ ở chế độ riêng tư của gói trừ phi được xuất một cách rõ ràng. Hãy xem tại https://github.com/bazelbuild/suggesteds/blob/master/designs/2019-10-24-file- visibility.md
Thẻ:build_file_semantics
,incompatible_change
- Giá trị mặc định của
--[no]incompatible_no_rule_outputs_param
: "false" -
Nếu bạn đặt chính sách này thành true, thì hệ thống sẽ tắt tham số "Outputs" (đầu ra) của hàm "Rules()" (quy tắc) Starlark.
Thẻ:build_file_semantics
,incompatible_change
- Giá trị mặc định của
--[no]incompatible_package_group_has_public_syntax
: "true" -
Trong thuộc tính "packages" của nhóm_gói, 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
- Giá trị mặc định của
--[no]incompatible_require_linker_input_cc_api
: "true" -
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 linking_inputs thay vì libraries_to_link. Các phương thức getter cũ của linking_context cũng sẽ bị tắt và chỉ sử dụng được linking_inputs.
Thẻ:build_file_semantics
,loading_and_analysis
,incompatible_change
- Giá trị mặc định của
--[no]incompatible_run_shell_command_string
: "true" -
Nếu bạn đặt chính sách này thành true, thì thông số lệnh của actions.run_shell sẽ chỉ chấp nhận chuỗi
Thẻ:build_file_semantics
,incompatible_change
- Giá trị mặc định của
--[no]incompatible_stop_exporting_language_modules
: "false" -
Nếu bạn bật chế độ này, một số mô-đun theo ngôn ngữ cụ thể (chẳng hạn như "cc_common`) sẽ không có sẵn trong tệp .bzl của người dùng và chỉ có thể được gọi từ kho lưu trữ quy tắc tương ứng.
Thẻ:loading_and_analysis
,incompatible_change
- Giá trị mặc định của
--[no]incompatible_struct_has_no_methods
: "false" -
Vô hiệu hoá các phương thức to_json và to_proto của struct. Các phương thức này gây ô nhiễm không gian tên của trường struct. Thay vào đó, hãy sử dụng json.encode hoặc json.encode_indent cho JSON hoặc proto.encode_text cho textproto.
Thẻ:build_file_semantics
,incompatible_change
- Giá trị mặc định của
--[no]incompatible_top_level_aspects_require_providers
: "false" -
Nếu bạn đặt chính sách này thành true, thì khía cạnh cấp cao nhất sẽ tuân theo 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ó quy tắc' nhà cung cấp được quảng cáo đáp ứng các nhà cung cấp bắt buộc về khía cạnh này.
Thẻ:loading_and_analysis
,incompatible_change
- Giá trị mặc định của
--[no]incompatible_unambiguous_label_stringification
: "true" -
Khi đúng, Bazel sẽ xâu chuỗi nhãn @//foo:bar thành @//foo:bar, thay vì //foo:bar. Điều này chỉ ảnh hưởng đến hành vi của str(), toán tử %, v.v.; hành vi của repr() không thay đổi. Hãy truy cập https://github.com/bazelbuild/bazel/issues/15916 để biết thêm thông tin.
Thẻ:loading_and_analysis
,incompatible_change
- Giá trị mặc định của
--[no]incompatible_use_cc_configure_from_rules_cc
: "false" -
Khi đúng, Bazel sẽ không 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
- Giá trị mặc định của
--[no]incompatible_visibility_private_attributes_at_definition
: "false" -
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, thay vì việc sử dụng quy tắc.
Thẻ:build_file_semantics
,incompatible_change
- Giá trị 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 (không có nghĩa là không có giới hạn).
Thẻ:build_file_semantics
- Giá trị mặc định của
--nested_set_depth_limit=<an integer>
: "3500" -
Chiều sâu tối đa của biểu đồ bên trong một tập hợp phụ (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:
- Giá trị mặc định của
--[no]incompatible_do_not_split_linking_cmdline
: "true" -
Khi đúng, Bazel sẽ không còn sửa đổi cờ dòng lệnh dùng để liên kết, cũng như không quyết định chọn lọc cờ nào sẽ chuyển đến tệp thông số và cờ nào không chuyển đến tệp thông số. Hãy truy cập vào https://github.com/bazelbuild/bazel/issues/7670 để biết thông tin chi tiết.
Thẻ:loading_and_analysis
,incompatible_change
- Giá trị mặc định của
--[no]keep_state_after_build
: "true" -
Nếu giá trị là false, thì Blaze sẽ loại bỏ trạng thái bộ nhớ khỏi bản dựng này khi quá trình tạo hoàn tất. Các bản dựng tiếp theo sẽ không có mức độ gia tăng nào so với bản dựng này.
Thẻ:loses_incremental_state
- Giá trị mặc định của
--skyframe_high_water_mark_threshold=<an integer>
: "85" -
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 tỷ lệ phần trăm vùng nhớ khối xếp được giữ lại ít nhất là ở ngưỡng này, thì Bazel sẽ giảm trạng thái Skyframe tạm thời không cần thiết. Việc tinh chỉnh điều này có thể cho phép bạn giảm thiểu tác động về thời gian thực của quá trình đơ máy GC, khi tình trạng đơ máy GC là (i) do việc sử dụng bộ nhớ ở trạng thái tạm thời này 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
- Giá trị mặc định của
--[no]track_incremental_state
: "true" -
Nếu đặt là false, Blaze sẽ không lưu trữ dữ liệu cho phép vô hiệu hoá và đánh giá lại trên các bản dựng tăng dần để 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 so với bản dựng này. Thông thường, bạn sẽ muốn chỉ định --batch khi đặt giá trị này thành false.
Thẻ:loses_incremental_state
- Các lựa chọn ảnh hưởng đến độ chi tiết, định dạng hoặc vị trí ghi nhật ký:
- Giá trị mặc định của
--[no]announce_rc
: "false" -
Liệu có thông báo các lựa chọn RC hay không.
Thẻ:affects_outputs
- Giá trị mặc định của
--[no]attempt_to_print_relative_paths
: "false" -
Khi in phần vị trí của thông báo, hãy thử sử dụng đường dẫn tương ứng với thư mục không gian làm việc hoặc một trong các thư mục do --package_path chỉ định.
Thẻ:terminal_output
- Giá trị mặc định của
--bes_backend=<a string>
: "" -
Chỉ định điểm cuối phụ trợ của dịch vụ sự kiện bản dựng (BES) ở dạng [SCHEME://]HOST[:PORT]. Tuỳ chọn mặc định là tắt tính năng tải lên BES (BES). Các giao thức được hỗ trợ là grpc và grpcs (grpc có bật TLS). Nếu không có giao thức nào được cung cấp, Bazel sẽ giả định các tệp grpcs.
Thẻ:affects_outputs
- Giá trị mặc định của
--[no]bes_check_preceding_lifecycle_events
: "false" -
Đặt trường check_preceding_Lifecycle_events_present trên PublishBuildToolEventStreamRequest để cho BES kiểm tra xem trước đó trường này đã nhận được các sự kiện InvocationINTStarted và BuildEnqueued có khớp với sự kiện hiện tại của công cụ hay không.
Thẻ:affects_outputs
--bes_header=<a 'name=value' assignment>
lần dùng được tích luỹ-
Chỉ định một tiêu đề trong biểu mẫu NAME=VALUE sẽ được đưa vào các yêu cầu BES. Có thể truyền nhiều tiêu đề bằng cách chỉ định cờ nhiều lần. Nhiều giá trị cho cùng một tên sẽ được chuyển đổi thành danh sách được phân tách bằng dấu phẩy.
Thẻ:affects_outputs
- Mặc định
--bes_instance_name=<a string>
: xem nội dung mô tả -
Chỉ định tên thực thể mà BES sẽ được lưu giữ để tải lên BEP. Giá trị mặc định là rỗng.
Thẻ:affects_outputs
--bes_keywords=<comma-separated list of options>
lần dùng được tích luỹ-
Chỉ định danh sách các từ khoá thông báo để thêm vào nhóm từ khoá mặc định đã xuất bản lên BES ("command_name=<command_name> ", "protocol_name=BEP"). Giá trị mặc định là không.
Thẻ:affects_outputs
- Giá trị mặc định của
--[no]bes_lifecycle_events
: "true" -
Chỉ định xem có xuất bản các sự kiện trong vòng đời BES hay không. (mặc định là "true").
Thẻ:affects_outputs
- Giá trị mặc định của
--bes_oom_finish_upload_timeout=<An immutable length of time.>
: "10 phút" -
Chỉ định khoảng thời gian bazel đợi quá trình tải lên BES/BEP hoàn tất trong khi OOM. Cờ này đảm bảo việc kết thúc khi JVM bị đơ nghiêm trọng và không thể tiến hành trên bất kỳ chuỗi 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 được lưu vào vùng đệm trong BEP, trước khi nó được báo cáo là 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 đến --bes_outerr_chunk_size.
Thẻ:affects_outputs
- Giá trị 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 được gửi tới BEP trong một thông báo.
Thẻ:affects_outputs
- Mặc định
--bes_proxy=<a string>
: xem nội dung mô tả - Kết nối với Build Event Service (Dịch vụ sự kiện xây dựng) qua proxy. Hiện tại, bạn chỉ có thể sử dụng cờ này để định cấu hình cổng miền Unix (unix:/path/to/socket).
- Giá trị 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 ra URL được thêm bằng mã lệnh gọi vào thiết bị đầu cuối.
Thẻ:terminal_output
- Giá trị mặc định của
--bes_timeout=<An immutable length of time.>
: "0 giây" -
Chỉ định khoảng thời gian bazel đợi quá trình tải BES/BEP lên hoàn tất sau khi quá trình tạo và kiểm thử hoàn tất. Thời gian chờ hợp lệ là một số tự nhiên, theo sau là một đơn vị: Ngày (d), giờ (h), phút (m), giây (s) và mili giây (mili giây). 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
--build_event_binary_file=<a string>
: "" -
Nếu tệp không trống, hãy ghi bản trình bày nhị phân được phân tách bằng varint để biểu diễn giao thức sự kiện bản dựng vào tệp đó. Tuỳ chọn này ngụ ý --bes_upload_mode=wait_for_upload_complete.
Thẻ:affects_outputs
- Giá trị mặc định của
--[no]build_event_binary_file_path_conversion
: "true" -
Chuyển đổi các đường dẫn trong bản trình bày tệp nhị phân của giao thức sự kiện bản dựng thành các URI hợp lệ trên toàn cầu hơn bất cứ khi nào có thể; nếu bạn tắt chính sách này thì hệ thống sẽ luôn sử dụng lược đồ file:// uri
Thẻ:affects_outputs
- Giá trị mặc định của
--build_event_json_file=<a string>
: "" -
Nếu phần này không trống, hãy ghi quá trình chuyển đổi tuần tự JSON của giao thức sự kiện bản dựng vào tệp đó.
Thẻ:affects_outputs
- Giá trị mặc định của
--[no]build_event_json_file_path_conversion
: "true" -
Chuyển đổi các đường dẫn trong tệp json thể hiện giao thức sự kiện xây 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ạn tắt chính sách này thì hệ thống sẽ luôn sử dụng lược đồ file:// uri
Thẻ:affects_outputs
- Giá trị 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 thực hiện phân tách sự kiện. Chế độ này nhằm 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 quy mô sự kiện. Tổng kích thước sự kiện là một hàm cấu trúc của tập hợp cũng như độ dài tệp và URI, có thể phụ thuộc vào hàm băm.
Thẻ:affects_outputs
- Giá trị mặc định của
--[no]build_event_publish_all_actions
: "false" -
Liệu có nên xuất bản tất cả các hành động hay không.
Thẻ:affects_outputs
- Giá trị mặc định của
--build_event_text_file=<a string>
: "" -
Nếu mục này không trống, hãy ghi nội dung mô tả 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
- Giá trị mặc định của
--[no]build_event_text_file_path_conversion
: "true" -
Chuyển đổi các đường dẫn trong bản trình bày tệp văn bả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 hơn bất cứ khi nào có thể; nếu bạn tắt chính sách này thì hệ thống sẽ luôn sử dụng lược đồ file:// uri
Thẻ:affects_outputs
- Giá trị mặc định của
--[no]experimental_announce_profile_path
: "false" -
Nếu được bật, tính năng này sẽ thêm đường dẫn hồ sơ JSON vào nhật ký.
Thẻ:affects_outputs
,bazel_monitoring
- Giá trị mặc định của
--[no]experimental_bep_target_summary
: "false" - Liệu có xuất bản các sự kiện Targetsummary hay không.
- Giá trị mặc định của
--[no]experimental_build_event_expand_filesets
: "false" -
Nếu đúng, hãy mở rộng Filesets trong BEP khi trình bày các tệp đầu ra.
Thẻ:affects_outputs
- Giá trị mặc định của
--[no]experimental_build_event_fully_resolve_fileset_symlinks
: "false" -
Nếu là true, phân giải đầy đủ các đường liên kết tượng trưng tương đối trong Fileset trong BEP khi trình bày các tệp đầu ra. Cần có --experimental_build_event_expand_filesets.
Thẻ:affects_outputs
- Giá trị 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
- Giá trị mặc định của
--experimental_build_event_upload_retry_minimum_delay=<An immutable length of time.>
: "1 giây" -
Ban đầu, độ trễ tối thiểu cho các lần thử lại thời gian đợi luỹ thừa khi tải lên BEP không thành công. (số mũ: 1,6)
Thẻ:bazel_internal_configuration
- Mặc định
--experimental_build_event_upload_strategy=<a string>
: xem nội dung mô tả -
Chọn cách tải các cấu phần phần mềm lên được tham chiếu trong giao thức sự kiện bản dựng.
Thẻ:affects_outputs
--experimental_profile_additional_tasks=<phase, action, action_check, action_lock, action_release, action_update, action_complete, info, create_package, remote_execution, local_execution, scanner, local_parse, upload_time, process_time, remote_queue, remote_setup, fetch, 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, local_cpu_usage, system_cpu_usage, local_memory_usage, system_memory_usage, 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 or unknown>
lần dùng được tích luỹ-
Chỉ định các tác vụ khác của hồ sơ để đưa vào hồ sơ.
Thẻ:affects_outputs
,bazel_monitoring
- Giá trị mặc định của
--[no]experimental_profile_include_primary_output
: "false" -
Bao gồm phần "out" thừa 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ẻ:affects_outputs
,bazel_monitoring
- Giá trị mặc định của
--[no]experimental_profile_include_target_label
: "false" -
Bao gồm nhãn mục tiêu trong các sự kiện hành động Dữ liệu hồ sơ JSON.
Thẻ:affects_outputs
,bazel_monitoring
- Giá trị mặc định của
--[no]experimental_stream_log_file_uploads
: "false" -
Phát trực tuyến tệp nhật ký tải lên trực tiếp vào bộ nhớ từ xa thay vì ghi vào ổ đĩa.
Thẻ:affects_outputs
- Mặc định
--experimental_workspace_rules_log_file=<a path>
: xem nội dung mô tả - Ghi lại một số sự kiện theo Quy tắc của Workspace vào tệp này dưới dạng các giao thức WorkspaceEvent được phân tách.
- Giá trị mặc định của
--[no]generate_json_trace_profile
: "tự động" -
Nếu được bật, Bazel sẽ lập hồ sơ bản dựng và ghi một hồ sơ ở định dạng JSON vào một tệp trong cơ sở dữ liệu đầu ra. Xem hồ sơ bằng cách tải vào chrome://tracing. Theo mặc định, Bazel sẽ ghi hồ sơ cho tất cả các lệnh và truy vấn giống bản dựng.
Thẻ:affects_outputs
,bazel_monitoring
- Giá trị mặc định của
--[no]heap_dump_on_oom
: "false" -
Liệu có xuất tệp báo lỗi theo cách thủ công khi gửi OOM hay không (bao gồm cả OOM do --experimental_oom_more_eagerly_threshold). Tệp kết xuất sẽ được ghi vào <output_base>/<invocation_id>.heaPDump.hprof. Tuỳ chọn này thay thế một cách hiệu quả -XX:+HeapDumpOnOutOfMemoryError, không có hiệu lực vì các OOM bị phát hiện và chuyển hướng đến Runtime#halt.
Thẻ:bazel_monitoring
- Giá trị mặc định của
--[no]legacy_important_outputs
: "true" -
Sử dụng phương thức này để ngăn việc tạo trường quan trọng_đầu ra cũ trong sự kiện TargetComplete. Quan trọng là đầu ra quan trọng là bắt buộc để tích hợp Bazel với ResultStore.
Thẻ:affects_outputs
- Giá trị mặc định của
--logging=<0 <= an integer <= 6>
: "3" -
Cấp độ ghi nhật ký.
Thẻ:affects_outputs
- Mặc định
--memory_profile=<a path>
: xem nội dung mô tả -
Nếu được đặt, 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 ở cuối bản dựng.
Thẻ:affects_outputs
,bazel_monitoring
- Giá trị mặc định của
--memory_profile_stable_heap_parameters=<two integers, separated by a comma>
: "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 quá trình tạo bản dựng. Phải là hai số nguyên được phân tách bằng dấu phẩy. Tham số đầu tiên là số lượng GC cần thực hiện. Tham số thứ hai là số giây chờ giữa các GC.
Thẻ:bazel_monitoring
- Mặc định
--profile=<a path>
: xem nội dung mô tả -
Nếu được đặt, hãy phân tích tài nguyên Bazel và ghi dữ liệu vào tệp được chỉ định. Sử dụng bazel Analyze-profile để phân tích hồ sơ.
Thẻ:affects_outputs
,bazel_monitoring
- Giá trị mặc định của
--[no]slim_profile
: "true" -
Giảm kích thước của hồ sơ JSON bằng cách hợp nhất các sự kiện nếu hồ sơ quá lớn.
Thẻ:affects_outputs
,bazel_monitoring
- Giá trị mặc định của
--starlark_cpu_profile=<a string>
: "" -
Ghi vào tệp được chỉ định một hồ sơ pprof mức sử dụng CPU của tất cả các luồng Starlark.
Thẻ:bazel_monitoring
- Giá trị 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
--ui_event_filters=<Convert list of comma separated event kind to list of filters>
lần dùng được tích luỹ-
Chỉ định những sự kiện sẽ hiển thị trong giao diện người dùng. Bạn có thể thêm hoặc xoá các sự kiện 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 tập hợp mặc định bằng chỉ định trực tiếp. Nhóm các loại sự kiện được hỗ trợ bao gồm THÔNG TIN, GỠ LỖI, LỖI và nhiều loại sự kiện khác.
Thẻ:terminal_output
- Các lựa chọn khác, không được phân loại theo cách khác.:
--build_metadata=<a 'name=value' assignment>
lần dùng được tích luỹ-
Các cặp chuỗi khoá-giá trị tuỳ chỉnh để cung cấp trong một sự kiện tạo bản dựng.
Thẻ:terminal_output
- Giá trị mặc định của
--color=<yes, no or auto>
: "tự động" - Sử dụng các nút điều khiển thiết bị đầu cuối để tô màu đầu ra.
--config=<a string>
lần dùng được tích luỹ- Chọn các phần cấu hình bổ sung từ các tệp rc; cho mỗi <command>, nó cũng lấy các tuỳ chọn từ <command>:<config> nếu mục như vậy tồn tại; 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 sẽ nằm trong các tệp cấu hình tools/*.blazerc.
- Giá trị mặc định của
--curses=<yes, no or auto>
: "tự động" - Sử dụng các chế độ điều khiển con trỏ trong thiết bị đầu cuối để giảm thiểu đầu ra cuộn.
- Giá trị mặc định của
--[no]enable_platform_specific_config
: "false" - Nếu là true, 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, Bazel sẽ chọn các dòng bắt đầu bằng build:linux. Các giá trị nhận dạng hệ điều hành được hỗ trợ là linux, macos, windows, freebsd và openbsd. Việc bật cờ này tương đương với việc sử dụng --config=linux trên Linux, --config=windows trên Windows, v.v.
--experimental_credential_helper=<An (unresolved) path to a credential helper for a scope.>
lần dùng được tích luỹ- Định cấu hình Trình trợ giúp thông tin xác thực dùng cho việc truy xuất thông tin xác thực cho phạm vi đã cung cấp (miền). Thông tin xác thực của Trình trợ giúp thông tin xác thực được ưu tiên hơn thông tin xác thực trên <code>--google_default_credentials</code>, "--google_credentials" hoặc <code>.netrc</code>. Hãy truy cập vào https://github.com/bazelbuild/suggesteds/blob/main/designs/2022-06-07-bazel-credential-helpers.md để biết chi tiết.
- Giá trị mặc định của
--experimental_credential_helper_cache_duration=<An immutable length of time.>
: "30 phút" - Định cấu hình khoảng thời gian lưu thông tin xác thực từ Trình trợ giúp thông tin xác thực. 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 đó; truyền 0 để xoá bộ nhớ đệm. Lệnh sạch luôn xoá bộ nhớ đệm, bất kể cờ này là gì.
- Mặc định của
--experimental_credential_helper_timeout=<An immutable length of time.>
: "5 giây" - Định cấu hình thời gian chờ cho Trình trợ giúp thông tin xác thực. 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 sẽ không thực hiện được lệnh gọi.
- Giá trị mặc định của
--[no]experimental_skymeld_ui
: "false" -
Hiển thị cả tiến trình giai đoạn phân tích và thực thi khi cả hai đang chạy đồng thời.
Thẻ:terminal_output
- Giá trị mặc định của
--[no]experimental_windows_watchfs
: "false" - Nếu đúng, hỗ trợ Windows thử nghiệm cho --watchfs sẽ được bật. Nếu không thì --watchfs là hoạt động không hoạt động trên Windows. Đừng quên bật --watchfs.
- Mặc định của
--google_auth_scopes=<comma-separated list of options>
: "https://www.googleapis.com/auth/cloud-platform" - Danh sách phạm vi xác thực được phân tách bằng dấu phẩy trên Google Cloud.
- Mặc định
--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/authentication để biết thông tin chi tiết.
- Giá trị mặc định của
--[no]google_default_credentials
: "false" - Có sử dụng 'Thông tin xác thực mặc định của ứng dụng trên Google' không để xác thực. Hãy truy cập vào https://cloud.google.com/docs/authentication để biết thông tin chi tiết. Tắt theo mặc định.
- Mặc định
--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, thì Bazel sẽ gửi ping sau khoảng thời gian không đọc hoạt động 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; thì xảy ra lỗi khi đặt giá trị nhỏ hơn một giây. Theo mặc định, các ping giữ kết nối sẽ bị tắt. Bạn nên phối hợp với chủ sở hữu dịch vụ trước khi bật 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
- Giá trị 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 giữ 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 phản hồi ping sau khoảng thời gian này. Thời gian được coi là độ chi tiết thứ hai; thì xảy ra lỗi khi đặt giá trị nhỏ hơn một giây. Nếu ping duy trì hoạt động bị tắt, thì chế độ cài đặt này sẽ bị bỏ qua.
- Giá trị mặc định của
--[no]incompatible_disallow_symlink_file_to_dir
: "true" -
Nếu bạn đặt chính sách này thành true, thì thuộc tính "ctx.actions.symlink" sẽ không cho phép liên kết tượng trưng một tệp vào một thư mục.
Thẻ:loading_and_analysis
,incompatible_change
- Giá trị mặc định của
--[no]incompatible_remove_rule_name_parameter
: "true" -
Nếu bạn đặt chính sách này thành true, thì hệ thống sẽ không thể gọi "quy tắc" bằng thông số "name".
Thẻ:loading_and_analysis
,incompatible_change
- Giá trị 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 khi xem hoạt động của bazel khi có nhiều thẻ thiết bị đầu cuối.
- Giá trị mặc định của
--[no]show_progress
: "true" - Hiện thông báo tiến trình trong quá trình tạo bản dựng.
- Giá trị 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 dữ liệu đầu ra.
- Giá trị mặc định của
--[no]show_timestamps
: "false" - Thêm dấu thời gian trong tin nhắn
- Mặc định
--tls_certificate=<a string>
: xem nội dung mô tả - Chỉ định một đường dẫn đến chứng chỉ TLS được tin cậy để ký chứng chỉ máy chủ.
- Mặc định
--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á ứng dụng khách để bật tính năng xác thực ứng dụng.
- Mặc định
--tls_client_key=<a string>
: xem nội dung mô tả - Chỉ định khoá ứng dụng 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 ứng dụng khách.
- Giá trị mặc định của
--ui_actions_shown=<an integer>
: "8" -
Số 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. Thanh tiến trình luôn hiển thị ít nhất một số, tất cả các số nhỏ hơn 1 sẽ được liên kết với 1.
Thẻ:terminal_output
- Giá trị mặc định của
--[no]watchfs
: "false" - Trên Linux/macOS: Nếu true, bazel cố gắng sử dụng dịch vụ theo dõi tệp của hệ điều hành cho các thay đổi cục bộ thay vì quét từng tệp để tìm một thay đổi. Trên Windows: cờ này hiện không hoạt động nhưng có thể được bật cùng với --experimental_windows_watchfs. Trên hệ điều hành bất kỳ: Hành vi này không thể xác định nếu không gian làm việc của bạn nằm trên hệ thống tệp mạng và các tệp được chỉnh sửa trên máy từ xa.
Tuỳ chọn phân tích hồ sơ
- Các tuỳ chọn xuất hiện trước lệnh và được ứng dụng phân tích cú pháp:
--distdir=<a path>
lần dùng được tích luỹ-
Các nơi khác để tìm kiếm các bản lưu trữ trước khi truy cập vào mạng để tải các bản lưu trữ đó xuống.
Thẻ:bazel_internal_configuration
- Giá trị mặc định của
--[no]experimental_repository_cache_hardlinks
: "false" -
Nếu được thiết lập, bộ nhớ đệm của kho lưu trữ sẽ liên kết cứng tệp trong trường hợp có lượt truy cập bộ nhớ đệm, thay vì sao chép. Thao tác này nhằm tiết kiệm dung lượng ổ đĩa.
Thẻ:bazel_internal_configuration
- Giá trị mặc định của
--[no]experimental_repository_cache_urls_as_default_canonical_id
: "false" -
Nếu đúng, hãy sử dụng một chuỗi bắt nguồn từ URL của các tệp tải xuống từ kho lưu trữ dưới dạngcanonical_id nếu không được chỉ định. Điều này khiến URL thay đổi, dẫn đến việc tải xuống lại ngay cả khi bộ nhớ đệm chứa tệp tải xuống có cùng hàm băm. Bạn có thể sử dụng quy trình này để xác minh rằng các thay đổi về URL không làm hỏng các kho lưu trữ bị bộ nhớ đệm che khuất.
Thẻ:loading_and_analysis
,experimental
- Giá trị mặc định của
--[no]experimental_repository_disable_download
: "false" -
Nếu đã đặt, bạn sẽ không được phép tải các kho lưu trữ bên ngoài xuống.
Thẻ:experimental
- Giá trị mặc định của
--experimental_repository_downloader_retries=<an integer>
: "0" -
Số lần thử tải lại lỗi xuống tối đa. Nếu bạn đặt chính sách này thành 0, hoạt động thử lại sẽ bị tắt.
Thẻ:experimental
- Giá trị mặc định của
--experimental_scale_timeouts=<a double>
: "1" -
Điều chỉnh tỷ lệ tất cả thời gian chờ trong quy tắc kho lưu trữ Starlark theo hệ số này. Bằng cách này, các kho lưu trữ bên ngoài có thể hoạt động trên các máy chậm hơn dự kiến của tác giả quy tắc mà không cần thay đổi mã nguồn
Thẻ:bazel_internal_configuration
,experimental
- Giá trị mặc định của
--http_timeout_scaling=<a double>
: "1" -
Điều chỉnh tỷ lệ tất cả thời gian chờ liên quan đến lượt tải xuống http theo hệ số cho trước
Thẻ:bazel_internal_configuration
- Mặc định
--repository_cache=<a path>
: xem nội dung mô tả -
Chỉ định vị trí bộ nhớ đệm của các giá trị được tải xuống thu được trong quá trình tìm nạp kho lưu trữ bên ngoài. Chuỗi trống dưới dạng đối số yêu cầu tắt bộ nhớ đệm.
Thẻ:bazel_internal_configuration
- Các lựa chọn ảnh hưởng đến mức độ nghiêm ngặt của Bazel trong việc thực thi dữ liệu đầu vào bản dựng hợp lệ (định nghĩa quy tắc, tổ hợp cờ, v.v.):
- Giá trị mặc định của
--experimental_repository_hash_file=<a string>
: "" -
Nếu giá trị không trống, hãy chỉ định tệp có chứa giá trị đã phân giải mà cần phải xác minh giá trị băm của thư mục kho lưu trữ
Thẻ:affects_outputs
,experimental
--experimental_verify_repository_rules=<a string>
lần dùng được tích luỹ-
Nếu danh sách các quy tắc kho lưu trữ mà hàm băm của thư mục đầu ra cần được xác minh, miễn là tệp được chỉ định bởi --experimental_repository_hash_file.
Thẻ:affects_outputs
,experimental
- Tuỳ chọn này ảnh hưởng đến ngữ nghĩa của ngôn ngữ Starlark hoặc API bản dựng có thể truy cập vào các tệp BUILD, tệp .bzl hoặc tệp WORKSPACE.:
- Giá trị mặc định của
--[no]experimental_allow_top_level_aspects_parameters
: "true" -
Không hoạt động
Thẻ:no_op
,deprecated
,experimental
- Các tuỳ chọn liên quan đến đầu ra và ngữ nghĩa Bzlmod:
--allow_yanked_versions=<a string>
lần dùng được tích luỹ-
Đã chỉ định các phiên bản mô-đun dưới dạng `<module1>@<version1>,<module2>@<version2>` sẽ được phép trong biểu đồ phần phụ thuộc đã phân giải ngay cả khi chúng được khai báo được kéo trong sổ đăng ký nơi chúng đến (nếu chúng không đến từ NonRegistryOverride). Nếu không, các phiên bản được kéo sẽ khiến quá trình phân giải bị lỗi. Bạn cũng có thể xác định phiên bản được kéo được phép bằng biến môi trường "BZLMOD_ALLOW_YANKED_VERSIONS". Bạn có thể vô hiệu hoá chế độ kiểm tra này bằng cách sử dụng từ khoá 'tất cả' (không nên dùng).
Thẻ:loading_and_analysis
- Giá trị 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" để báo cáo lỗi thành không giải quyết được, "tắt" để tắt tính năng kiểm tra hoặc "cảnh báo" để in một cảnh báo khi phát hiện thấy thông tin không khớp.
Thẻ:loading_and_analysis
- Giá trị 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 "bazel_dep" trực tiếp đượ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 đã phân giải hay không. Các giá trị hợp lệ là "off" để tắt tính năng kiểm tra, "warning" để in cảnh báo khi phát hiện thấy thông tin không khớp hoặc "error" để chuyển cảnh báo thành không giải quyết được.
Thẻ:loading_and_analysis
- Giá trị mặc định của
--[no]ignore_dev_dependency
: "false" -
Nếu đúng, Bazel sẽ bỏ qua phương thức "bazel_dep" và "use_extension" được khai báo là "dev_Dependencies" trong MODULE.bazel của mô-đun gốc. Lưu ý rằng các phần phụ thuộc dev đó 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
--override_module=<an equals-separated mapping of module name to path>
lần dùng được tích luỹ- Ghi đè mô-đun bằng thư mục cục bộ.
--registry=<a string>
lần dùng được tích luỹ-
Chỉ định sổ đăng ký cần sử dụng để xác định vị trí các phần phụ thuộc của mô-đun Bazel. Thứ tự này rất quan trọng: các mô-đun sẽ được tra cứu trong các sổ đăng ký trước đó trước và chỉ quay lại các sổ đăng ký sau đó nếu không có các mô-đun trước đó.
Thẻ:changes_inputs
- Các lựa 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 ra tệp kết xuất dữ liệu hồ sơ đầy đủ ở dạng "văn bản" mà con người có thể đọc được định dạng hoặc "thô" phù hợp với tập lệnh .
Thẻ:affects_outputs
- Giá trị mặc định của
--[no]experimental_record_metrics_for_all_mnemonics
: "false" - Theo mặc định, số lượng loại hành động được giới hạn ở 20 bộ nhớ có số lượng hành động được thực thi lớn nhất. Việc đặt tuỳ chọn này sẽ ghi số liệu thống kê cho tất cả các bộ nhớ.
- Các tuỳ chọn chỉ định hoặc thay đổi dữ liệu đầu vào chung cho lệnh Bazel không thuộc các danh mục khác.:
- Giá trị mặc định của
--experimental_resolved_file_instead_of_workspace=<a string>
: "" -
Nếu không để trống, hãy đọc tệp đã giải quyết được chỉ định thay vì tệp WORKSPACE
Thẻ:changes_inputs
- Tuỳ chọn thực thi và lưu vào bộ nhớ đệm từ xa:
- Mặc định
--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ủ lưu trữ (cho `allow` và `block`) hoặc hai mẫu, một mẫu để so khớp và một mẫu để sử dụng làm URL thay thế, với các tham chiếu ngược bắt đầu từ `$1`. Bạn có thể cung cấp nhiều lệnh "ghi lại" cho cùng một URL và trong trường hợp này, hệ thống sẽ trả về nhiều URL.
- Các lựa chọn khác, không được phân loại theo cách khác.:
--override_repository=<an equals-separated mapping of repository name to path>
lần dùng được tích luỹ- Ghi đè kho lưu trữ bằng thư mục cục bộ.
Các lựa chọn cho truy vấn
Kế thừa tất cả tuỳ chọn từ 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:
--distdir=<a path>
lần dùng được tích luỹ-
Các nơi khác để tìm kiếm các bản lưu trữ trước khi truy cập vào mạng để tải các bản lưu trữ đó xuống.
Thẻ:bazel_internal_configuration
- Giá trị mặc định của
--[no]experimental_repository_cache_hardlinks
: "false" -
Nếu được thiết lập, bộ nhớ đệm của kho lưu trữ sẽ liên kết cứng tệp trong trường hợp có lượt truy cập bộ nhớ đệm, thay vì sao chép. Thao tác này nhằm tiết kiệm dung lượng ổ đĩa.
Thẻ:bazel_internal_configuration
- Giá trị mặc định của
--[no]experimental_repository_cache_urls_as_default_canonical_id
: "false" -
Nếu đúng, hãy sử dụng một chuỗi bắt nguồn từ URL của các tệp tải xuống từ kho lưu trữ dưới dạngcanonical_id nếu không được chỉ định. Điều này khiến URL thay đổi, dẫn đến việc tải xuống lại ngay cả khi bộ nhớ đệm chứa tệp tải xuống có cùng hàm băm. Bạn có thể sử dụng quy trình này để xác minh rằng các thay đổi về URL không làm hỏng các kho lưu trữ bị bộ nhớ đệm che khuất.
Thẻ:loading_and_analysis
,experimental
- Giá trị mặc định của
--[no]experimental_repository_disable_download
: "false" -
Nếu đã đặt, bạn sẽ không được phép tải các kho lưu trữ bên ngoài xuống.
Thẻ:experimental
- Giá trị mặc định của
--experimental_repository_downloader_retries=<an integer>
: "0" -
Số lần thử tải lại lỗi xuống tối đa. Nếu bạn đặt chính sách này thành 0, hoạt động thử lại sẽ bị tắt.
Thẻ:experimental
- Giá trị mặc định của
--experimental_scale_timeouts=<a double>
: "1" -
Điều chỉnh tỷ lệ tất cả thời gian chờ trong quy tắc kho lưu trữ Starlark theo hệ số này. Bằng cách này, các kho lưu trữ bên ngoài có thể hoạt động trên các máy chậm hơn dự kiến của tác giả quy tắc mà không cần thay đổi mã nguồn
Thẻ:bazel_internal_configuration
,experimental
- Giá trị mặc định của
--http_timeout_scaling=<a double>
: "1" -
Điều chỉnh tỷ lệ tất cả thời gian chờ liên quan đến lượt tải xuống http theo hệ số cho trước
Thẻ:bazel_internal_configuration
- Mặc định
--repository_cache=<a path>
: xem nội dung mô tả -
Chỉ định vị trí bộ nhớ đệm của các giá trị được tải xuống thu được trong quá trình tìm nạp kho lưu trữ bên ngoài. Chuỗi trống dưới dạng đối số yêu cầu tắt bộ nhớ đệm.
Thẻ:bazel_internal_configuration
- Các lựa chọn ảnh hưởng đến mức độ nghiêm ngặt của Bazel trong việc thực thi dữ liệu đầu vào bản dựng hợp lệ (định nghĩa quy tắc, tổ hợp cờ, v.v.):
- Giá trị mặc định của
--experimental_repository_hash_file=<a string>
: "" -
Nếu giá trị không trống, hãy chỉ định tệp có chứa giá trị đã phân giải mà cần phải xác minh giá trị băm của thư mục kho lưu trữ
Thẻ:affects_outputs
,experimental
--experimental_verify_repository_rules=<a string>
lần dùng được tích luỹ-
Nếu danh sách các quy tắc kho lưu trữ mà hàm băm của thư mục đầu ra cần được xác minh, miễn là tệp được chỉ định bởi --experimental_repository_hash_file.
Thẻ:affects_outputs
,experimental
- Tuỳ chọn này ảnh hưởng đến ngữ nghĩa của ngôn ngữ Starlark hoặc API bản dựng có thể truy cập vào các tệp BUILD, tệp .bzl hoặc tệp WORKSPACE.:
- Giá trị mặc định của
--[no]experimental_allow_top_level_aspects_parameters
: "true" -
Không hoạt động
Thẻ:no_op
,deprecated
,experimental
- Các lựa chọn liên quan đến đầu ra của truy vấn và ngữ nghĩa:
- 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à một trong {xml,proto,record}. "off" có nghĩa là không có phần phụ thuộc khung hình nào được giải quyết, "thận trọng" (mặc định) có nghĩa là tất cả phần phụ thuộc khía cạnh đã khai báo đều được thêm vào bất kể chúng có được cung cấp lớp quy tắc của phần phụ thuộc trực tiếp hay không, "chính xác" có nghĩa là chỉ những khía cạnh đó được thêm vào mà 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. Xin lưu ý rằng chế độ chính xác yêu cầu tải các gói khác để đánh giá một mục tiêu. Do đó, mục tiêu này sẽ chậm hơn so với các chế độ khác. Ngoài ra, xin lưu ý rằng ngay cả chế độ chính xác cũng không hoàn toàn chính xác: việc quyết định có tính toán một khía cạnh hay không được quyết định trong giai đoạn phân tích, giai đoạn này không chạy trong quá trình "truy vấn bazel".
Thẻ:build_file_semantics
- Giá trị mặc định của
--[no]deduplicate_depsets
: "true" -
Loại bỏ các phần tử con không có lá trùng lặp của một dep_set_of_files trong đầu ra proto/textproto/json cuối cùng. Việc này không loại bỏ các phần trùng lặp không có chung mục cha mẹ ngay lập tức. Điều này không ảnh hưởng đến danh sách cấu phần phần mềm đầu vào có hiệu lực cuối cùng của các thao tác.
Thẻ:terminal_output
- Giá trị mặc định của
--[no]graph:factored
: "true" -
Nếu đúng, thì biểu đồ sẽ được tạo ra "được tạo thành thừa số", tức là các nút tương đương về cấu trúc liên kết sẽ được hợp nhất với nhau và nhãn của chúng sẽ được nối với nhau. Tuỳ chọn này chỉ áp dụng cho --output=graph.
Thẻ:terminal_output
- Giá trị 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 dữ liệu đầu ra. 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=graph.
Thẻ:terminal_output
- Giá trị mặc định của
--[no]implicit_deps
: "true" -
Nếu được bật, các phần phụ thuộc ngầm ẩ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ằng 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ụ đã phân giải.
Thẻ:build_file_semantics
- Giá trị mặc định của
--[no]include_artifacts
: "true" -
Bao gồm tên của các đầu vào và đầu ra hành động ở đầu ra (có thể lớn).
Thẻ:terminal_output
- Giá trị mặc định của
--[no]include_aspects
: "true" -
aquery, cquery: liệu có bao gồm các hành động được tạo theo khía cạnh trong kết quả hay không. query: no-op (luôn đi theo các khía cạnh).
Thẻ:terminal_output
- Giá trị mặc định của
--[no]include_commandline
: "true" -
Bao gồm nội dung của các dòng lệnh hành động trong đầu ra (có thể lớn).
Thẻ:terminal_output
- Giá trị mặc định của
--[no]include_file_write_contents
: "false" -
Đưa nội dung tệp vào các thao tác FileWrite và SourceSymlinkManifest (có thể lớn).
Thẻ:terminal_output
- Giá trị mặc định của
--[no]include_param_files
: "false" -
Bao gồm nội dung của các tệp thông số được dùng trong lệnh (có thể lớn). Lưu ý: Việc bật cờ này sẽ tự động bật cờ --include_commandline.
Thẻ:terminal_output
- Giá trị mặc định của
--[no]incompatible_display_source_file_location
: "true" -
"True" theo mặc định sẽ hiển thị mục tiêu của tệp nguồn. Nếu đúng, hiển thị vị trí dòng 1 của tệp nguồn trong dữ liệu đầu ra vị trí. Cờ này chỉ dành cho mục đích di chuyển.
Thẻ:terminal_output
,incompatible_change
- Giá trị mặc định của
--[no]incompatible_package_group_includes_double_slash
: "true" -
Nếu được bật, khi xuất thuộc tính "packages" của package_group, phần tử "//" ở đầu sẽ không bị bỏ qua.
Thẻ:terminal_output
,incompatible_change
- Giá trị mặc định của
--[no]infer_universe_scope
: "false" -
Nếu bạn không đặt giá trị đặt và --universe_scope thì giá trị của --universe_scope sẽ được suy ra dưới dạng danh sách các mẫu mục tiêu riêng biệ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 vũ trụ (ví dụ:`allrdeps`) có thể không phải là giá trị bạn muốn. Vì vậy, bạn chỉ nên sử dụng tuỳ chọn này nếu biết mình đang làm gì. Hãy 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 ý: tuỳ chọn này chỉ áp dụng cho "query" (nghĩa là không áp dụng cho "cquery").
Thẻ:loading_and_analysis
- Giá trị mặc định của
--[no]line_terminator_null
: "false" -
Liệu mỗi định dạng có bị chấm dứt bằng \0 thay vì dòng mới hay không.
Thẻ:terminal_output
- Giá trị mặc định của
--[no]nodep_deps
: "true" -
Nếu được bật, phần phụ thuộc từ "nodep" sẽ được đưa vào biểu đồ phần phụ thuộc mà qua đó truy vấn hoạt động. Một ví dụ phổ biến về "nút" 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ả "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 mà kết quả truy vấn sẽ được in. Các giá trị được phép cho truy vấn là: text, textproto, proto, jsonproto.
Thẻ:terminal_output
- Giá trị mặc định của
--[no]proto:default_values
: "true" -
Nếu đúng, các thuộc tính có giá trị không được chỉ định rõ ràng trong tệp BUILD sẽ được đưa vào; nếu không thì chúng sẽ bị bỏ qua. Tuỳ chọn này có thể áp dụng cho --output=proto
Thẻ:terminal_output
- Giá trị mặc định của
--[no]proto:definition_stack
: "false" -
Điền vào trường proto Definition_stack sẽ ghi lại từng thực thể quy tắc của ngăn xếp lệnh gọi Starlark tại thời điểm xác định lớp của quy tắc.
Thẻ:terminal_output
- Giá trị mặc định của
--[no]proto:flatten_selects
: "true" -
Nếu bạn bật tuỳ chọn này, các thuộc tính có thể định cấu hình do Select() tạo sẽ được làm phẳng. Đối với các loại danh sách, bản trình bày đã làm phẳng là danh sách chứa chính xác mỗi giá trị của tệp ánh xạ được chọn 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
- Giá trị mặc định của
--[no]proto:include_synthetic_attribute_hash
: "false" -
Liệu có tính toán và điền thuộc tính $internal_attr_hash hay không.
Thẻ:terminal_output
- Giá trị mặc định của
--[no]proto:instantiation_stack
: "false" -
Điền ngăn xếp lệnh gọi tạo thực thể của từng quy tắc. Lưu ý rằng thao tác này đòi hỏi phải có ngăn xếp
Thẻ:terminal_output
- Giá trị mặc định của
--[no]proto:locations
: "true" -
Liệu có xuất thông tin vị trí trong đầu ra proto hay không.
Thẻ:terminal_output
- Mặc định của
--proto:output_rule_attrs=<comma-separated list of options>
: "tất cả" -
Danh sách thuộc tính được phân tách bằng dấu phẩy để đưa vào dữ liệu đầu ra. Giá trị mặc định là tất cả thuộc tính. Bạn phải đặt thành chuỗi trống để không xuất thuộc tính nào. Tuỳ chọn này có thể áp dụng cho --output=proto.
Thẻ:terminal_output
- Giá trị mặc định của
--[no]proto:rule_inputs_and_outputs
: "true" -
Liệu có điền sẵn các trường rules_input và rules_output hay không.
Thẻ:terminal_output
- Giá trị mặc định của
--[no]relative_locations
: "false" -
Nếu đúng, vị trí của các tệp BUILD trong đầu ra xml và proto sẽ là tương đối. Theo mặc định, kết quả vị trí là một đường dẫn tuyệt đối và sẽ không nhất quán giữa các máy. Bạn có thể đặt tuỳ chọn này thành true để nhận được kết quả nhất quán trên các máy.
Thẻ:terminal_output
- Giá trị mặc định của
--[no]skyframe_state
: "false" -
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ỉ có sẵn với --output=proto hoặc --output=textproto.
Thẻ:terminal_output
- Giá trị mặc định của
--[no]tool_deps
: "true" -
Truy vấn: Nếu bị tắt, các phần phụ thuộc trên "cấu hình máy chủ" hoặc "thực thi" sẽ không được đưa vào biểu đồ phụ thuộc mà qua đó truy vấn hoạt động. "Cấu hình máy chủ lưu trữ" cạnh phụ thuộc, chẳng hạn như cạnh phụ thuộc từ bất kỳ "proto_library" nào cho 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 'mục tiêu' .
Cquery: Nếu bị tắt, hãy lọc tất cả các mục tiêu đã định cấu hình vượt qua quá trình chuyển đổi lưu trữ hoặc thực thi khỏi 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ũng 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 máy chủ lưu trữ, thì chỉ các mục tiêu đã định cấu hình của máy chủ lưu trữ mới được trả về. Tuỳ chọn này sẽ KHÔNG loại trừ chuỗi công cụ đã phân giải.
Thẻ:build_file_semantics
- Giá trị 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 đóng bắc cầu của các mục tiêu được chỉ định. Tuỳ chọn này được dùng cho các lệnh truy vấn và cquery.
Đối với cquery, đầu vào cho tuỳ chọn này là mục tiêu mà tất cả các câu trả lời đều được xây dựng, do đó, tuỳ chọn này có thể ảnh hưởng đến cấu hình và hiệu ứng chuyển đổi. Nếu bạn không chỉ định tùy chọn này, thì các mục tiêu cấp cao nhất được coi 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ị lỗi nếu không thể tạo các mục tiêu được phân tích cú pháp từ biểu thức truy vấn bằng các tuỳ chọn cấp cao nhất.
Thẻ:loading_and_analysis
- Các lựa chọn liên quan đến đầu ra và ngữ nghĩa Bzlmod:
--allow_yanked_versions=<a string>
lần dùng được tích luỹ-
Đã chỉ định các phiên bản mô-đun dưới dạng `<module1>@<version1>,<module2>@<version2>` sẽ được phép trong biểu đồ phần phụ thuộc đã phân giải ngay cả khi chúng được khai báo được kéo trong sổ đăng ký nơi chúng đến (nếu chúng không đến từ NonRegistryOverride). Nếu không, các phiên bản được kéo sẽ khiến quá trình phân giải bị lỗi. Bạn cũng có thể xác định phiên bản được kéo được phép bằng biến môi trường "BZLMOD_ALLOW_YANKED_VERSIONS". Bạn có thể vô hiệu hoá chế độ kiểm tra này bằng cách sử dụng từ khoá 'tất cả' (không nên dùng).
Thẻ:loading_and_analysis
- Giá trị 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" để báo cáo lỗi thành không giải quyết được, "tắt" để tắt tính năng kiểm tra hoặc "cảnh báo" để in một cảnh báo khi phát hiện thấy thông tin không khớp.
Thẻ:loading_and_analysis
- Giá trị 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 "bazel_dep" trực tiếp đượ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 đã phân giải hay không. Các giá trị hợp lệ là "off" để tắt tính năng kiểm tra, "warning" để in cảnh báo khi phát hiện thấy thông tin không khớp hoặc "error" để chuyển cảnh báo thành không giải quyết được.
Thẻ:loading_and_analysis
- Giá trị mặc định của
--[no]ignore_dev_dependency
: "false" -
Nếu đúng, Bazel sẽ bỏ qua phương thức "bazel_dep" và "use_extension" được khai báo là "dev_Dependencies" trong MODULE.bazel của mô-đun gốc. Lưu ý rằng các phần phụ thuộc dev đó 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
--override_module=<an equals-separated mapping of module name to path>
lần dùng được tích luỹ- Ghi đè mô-đun bằng thư mục cục bộ.
--registry=<a string>
lần dùng được tích luỹ-
Chỉ định sổ đăng ký cần sử dụng để xác định vị trí các phần phụ thuộc của mô-đun Bazel. Thứ tự này rất quan trọng: các mô-đun sẽ được tra cứu trong các sổ đăng ký trước đó trước và chỉ quay lại các sổ đăng ký sau đó nếu không có các mô-đun trước đó.
Thẻ:changes_inputs
- Các lựa chọn ảnh hưởng đến độ chi tiết, định dạng hoặc vị trí ghi nhật ký:
- Giá trị mặc định của
--[no]experimental_record_metrics_for_all_mnemonics
: "false" - Theo mặc định, số lượng loại hành động được giới hạn ở 20 bộ nhớ có số lượng hành động được thực thi lớn nhất. Việc đặt tuỳ chọn này sẽ ghi số liệu thống kê cho tất cả các bộ nhớ.
- Các tuỳ chọn chỉ định hoặc thay đổi dữ liệu đầu vào chung cho lệnh Bazel không thuộc các danh mục khác.:
- Giá trị mặc định của
--experimental_resolved_file_instead_of_workspace=<a string>
: "" -
Nếu không để trống, hãy đọc tệp đã giải quyết được chỉ định thay vì tệp WORKSPACE
Thẻ:changes_inputs
- Tuỳ chọn thực thi và lưu vào bộ nhớ đệm từ xa:
- Mặc định
--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ủ lưu trữ (cho `allow` và `block`) hoặc hai mẫu, một mẫu để so khớp và một mẫu để sử dụng làm URL thay thế, với các tham chiếu ngược bắt đầu từ `$1`. Bạn có thể cung cấp nhiều lệnh "ghi lại" cho cùng một URL và trong trường hợp này, hệ thống sẽ trả về nhiều URL.
- Các lựa chọn khác, không được phân loại theo cách khác.:
--override_repository=<an equals-separated mapping of repository name to path>
lần dùng được tích luỹ- Ghi đè kho lưu trữ bằng thư mục cục bộ.
- Các tuỳ chọn kiểm soát việc thực thi bản dựng:
- Giá trị mặc định của
--[no]experimental_inprocess_symlink_creation
: "false" -
Liệu có thực hiện lệnh gọi hệ thống tệp trực tiếp để tạo cây liên kết tượng trưng hay không
Thẻ:loading_and_analysis
,execution
,experimental
- Giá trị mặc định của
--[no]experimental_remotable_source_manifests
: "false" -
Có thể cho phép từ xa các hành động trong tệp kê khai nguồn hay không
Thẻ:loading_and_analysis
,execution
,experimental
- Giá trị mặc định của
--[no]experimental_split_coverage_postprocessing
: "false" -
Nếu true, Bazel sẽ chạy xử lý hậu kỳ về mức độ sử dụng để kiểm thử trong một lượt sinh sản mới.
Thẻ:execution
- Giá trị mặc định của
--[no]experimental_strict_fileset_output
: "false" -
Nếu bật tuỳ chọn này, tập hợp tệp sẽ coi tất cả cấu phần phần mềm đầu ra là tệp thông thường. Chúng sẽ không truyền tải các thư mục hoặc nhạy cảm với đường liên kết tượng trưng.
Thẻ:execution
- Giá trị 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 ghi nhớ hành động. Chỉ áp dụng cho các thao tác hỗ trợ thông tin thực thi. Nhiều thao tác phổ biến có 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 ghi nhớ.
Cú pháp: "regex=[+-]key,regex=[+-]key,...".
Ví dụ:
'.*=+x,.*=-y,.*=+z' thêm "x" và 'z' đến và xoá 'y' từ thông tin thực thi cho tất cả các hành động.
"Genrules=+yêu cầu-x" thêm 'require-x' vào thông tin thực thi của mọi thao tác trên Quy tắc Gen.
'(?!Genrules).*=-requirements-x' xoá "request-x" trong thông tin thực thi cho tất cả các hành động không phải Quy tắc chung.
Thẻ:execution
,affects_outputs
,loading_and_analysis
--persistent_android_dex_desugar
-
Cho phép các thao tác đơn giản hoá và tạo tệp dex trên Android liên tục bằng cách sử dụng worker.
Mở rộng thành:
--strategy=Desugar=worker
--strategy=DexBuilder=worker
Thẻ:host_machine_resource_optimizations
,execution
--persistent_android_resource_processor
-
Cho phép trình xử lý tài nguyên Android ổn định bằng cách sử dụng worker.
Mở rộng thành:
--internal_persistent_busybox_tools
--strategy=AaptPackage=worker
--strategy=AndroidResourceParser=worker
--strategy=AndroidResourceValidator=worker
--strategy=AndroidResourceCompiler=worker
--strategy=RClassGenerator=worker
--strategy=AndroidResourceLink=worker
--strategy=AndroidAapt2=worker
--strategy=AndroidAssetMerger=worker
/--strategy=AndroidResourceMerger=worker
/--strategy=AndroidCompiledResourceMerger=worker
/--strategy=ManifestMerger=worker
/--strategy=AndroidManifestMerger=worker
/--strategy=Aapt2Optimize=worker
/--strategy=AARGenerator=worker
Thẻ:host_machine_resource_optimizations
,execution
--persistent_multiplex_android_dex_desugar
-
Bật các thao tác đơn giản hoá và giải mã Android được ghép liên tục bằng trình thực thi.
Mở rộng thành:
--persistent_android_dex_desugar
--modify_execution_info=Desugar=+supports-multiplex-workers
--modify_execution_info=DexBuilder=+supports-multiplex-workers
Thẻ:host_machine_resource_optimizations
,execution
--persistent_multiplex_android_resource_processor
-
Bật trình xử lý tài nguyên Android ghép nối liên tục bằng cách sử dụng worker.
Mở rộng thành:
--persistent_android_resource_processor
--modify_execution_info=AaptPackage=+supports-multiplex-workers
--modify_execution_info=AndroidResourceParser=+supports-multiplex-workers
--modify_execution_info=AndroidResourceValidator=+supports-multiplex-workers
--modify_execution_info=AndroidResourceCompiler=+supports-multiplex-workers
--modify_execution_info=RClassGenerator=+supports-multiplex-workers
--modify_execution_info=AndroidResourceLink=+supports-multiplex-workers
--modify_execution_info=AndroidAapt2=+supports-multiplex-workers
--modify_execution_info=AndroidAssetMerger=+supports-multiplex-workers
/--modify_execution_info=AndroidResourceMerger=+supports-multiplex-workers
/--modify_execution_info=AndroidCompiledResourceMerger=+supports-multiplex-workers
/--modify_execution_info=ManifestMerger=+supports-multiplex-workers
/--modify_execution_info=AndroidManifestMerger=+supports-multiplex-workers
/--modify_execution_info=Aapt2Optimize=+supports-multiplex-workers
/--modify_execution_info=AARGenerator=+supports-multiplex-workers
Thẻ:host_machine_resource_optimizations
,execution
--persistent_multiplex_android_tools
-
Bật các công cụ Android liên tục và đa kênh (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
- 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
--android_compiler=<a string>
: xem nội dung mô tả -
Trình biên dịch mục tiêu Android.
Thẻ:affects_outputs
,loading_and_analysis
,loses_incremental_state
- Giá trị 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
--android_grte_top=<a label>
: xem nội dung mô tả -
Mục tiêu Android grte_top.
Thẻ:changes_inputs
,loading_and_analysis
,loses_incremental_state
- Giá trị 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
- Giá trị mặc định của
--android_platforms=<a build target label>
: "" -
Đặt các nền tảng mà mục tiêu android_binary sử dụng. Nếu bạn chỉ định nhiều nền tảng, thì tệp nhị phân sẽ là tệp APK lớn, chứa các tệp nhị phân gốc cho từng nền tảng mục tiêu được chỉ định.
Thẻ:changes_inputs
,loading_and_analysis
,loses_incremental_state
- 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
- Mặc định
--apple_compiler=<a string>
: xem nội dung mô tả -
Trình biên dịch mục tiêu của Apple. Hữu ích khi chọn các biến thể của chuỗi công cụ (ví dụ: xcode-beta).
Thẻ:affects_outputs
,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 crosstool sẽ được dùng trong các quy tắc của Apple và Objc cũng như các phần phụ thuộc của chúng.
Thẻ:loses_incremental_state
,changes_inputs
- Mặc định
--apple_grte_top=<a build target label>
: xem nội dung mô tả -
Mục tiêu grte_top của Apple.
Thẻ:changes_inputs
,loading_and_analysis
,loses_incremental_state
- Giá trị mặc định của
--cc_output_directory_tag=<a string>
: "" -
Chỉ định một hậu tố cần thêm vào thư mục cấu hình.
Thẻ:affects_outputs
,explicit_in_output_path
- Mặc định
--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 để xử lý hậu kỳ các báo cáo về mức độ phù hợp thô. Hiện tại, đây phải là một nhóm tệp 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 về mức độ phù hợp. Hiện tại, đây phải là một nhóm tệp 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ợ cần thiết đối với dữ liệu đầu vào của mọi hành động kiểm thử giúp 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 crosstool sẽ được dùng để biên dịch mã C++.
Thẻ:loading_and_analysis
,changes_inputs
,affects_outputs
- Mặc định
--custom_malloc=<a build target label>
: xem nội dung mô tả -
Chỉ định cách 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.
Thẻ:changes_inputs
,affects_outputs
--experimental_add_exec_constraints_to_targets=<a '<RegexFilter>=<label1>[,<label2>,...]' assignment>
lần dùng được tích luỹ-
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ố là - (biểu thức âm) (không bắt buộc) được gán (=) cho 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ông khớp với biểu thức phủ định nào và có ít nhất một biểu thức dương, thì độ phân giải của chuỗi công cụ sẽ được thực hiện như thể đã khai báo các giá trị ràng buộc làm điều kiện ràng buộc thực thi. Ví dụ: //demo,-test=@platforms//cpus:x86_64 sẽ thêm 'x86_64' vào bất kỳ mục tiêu nào trong //demo ngoại trừ những mục tiêu có tên chứa 'test'.
Thẻ:loading_and_analysis
- Giá trị mặc định của
--[no]experimental_enable_objc_cc_deps
: "true" -
Cho phép các quy tắc objc_* phụ thuộc vào cc_library và khiến mọi phần phụ thuộc objc được tạo với --cpu được đặt thành "ios_<--ios_cpu>" cho bất kỳ giá trị nào trong --ios_multi_cpu.
Thẻ:loading_and_analysis
,incompatible_change
- Giá trị mặc định của
--[no]experimental_include_xcode_execution_requirements
: "false" -
Nếu đã đặt, hãy thêm "require-xcode:{version}" cho mọi hành động trên Xcode. Nếu phiên bản xcode có nhãn được gạch nối, hãy thêm cả "require-xcode-label:{version_label}" yêu cầu thực thi.
Thẻ:loses_incremental_state
,loading_and_analysis
,execution
- Giá trị mặc định của
--[no]experimental_prefer_mutual_xcode
: "true" -
Nếu đúng, hãy sử dụng Xcode mới nhất có sẵn cả tại địa phương và từ xa. Nếu sai hoặc nếu không có phiên bản nào hỗ trợ lẫn 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
--extra_execution_platforms=<comma-separated list of options>
lần dùng được tích luỹ-
Các nền tảng có sẵn dưới dạng nền tảng thực thi để chạy các hành động. Bạn có thể chỉ định nền tảng theo mục tiêu chính xác hoặc dưới dạng mẫu mục tiêu. Các nền tảng này sẽ được xem xét trước những nền tảng được khai báo trong tệp WORKSPACE bằng register_execution_platforms().
Thẻ:execution
--extra_toolchains=<comma-separated list of options>
lần dùng được tích luỹ-
Các quy tắc chuỗi công cụ cần được xem xét trong quá trình phân giải chuỗi công cụ. Bạn có thể chỉ định chuỗi công cụ theo mục tiêu chính xác hoặc dưới dạng mẫu mục tiêu. Các chuỗi công cụ này sẽ được xem xét trước các chuỗi công cụ được khai báo trong tệp WORKSPACE bằng register_toolchains().
Thẻ:affects_outputs
,changes_inputs
,loading_and_analysis
- Mặc định
--grte_top=<a label>
: xem nội dung mô tả -
Nhãn cho thư viện libc đã được đăng ký. 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 phải ghi đè giá trị này.
Thẻ:action_command_lines
,affects_outputs
- Mặc định
--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
--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 máy chủ lưu trữ. 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 đã cho.
Thẻ:loading_and_analysis
,changes_inputs
,affects_outputs
- Mặc định
--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 của libc (--grte_top) cho cấu hình máy chủ lưu trữ.
Thẻ:action_command_lines
,affects_outputs
- Giá trị mặc định của
--host_platform=<a build target label>
: "" -
Nhãn của một quy tắc nền tảng mô tả hệ thống lưu trữ.
Thẻ:affects_outputs
,changes_inputs
,loading_and_analysis
- Giá trị mặc định của
--[no]incompatible_disable_expand_if_all_available_in_flag_set
: "true" -
Nếu đúng, Bazel sẽ không cho phép chỉ định mở rộng_if_all_available trongflag_sets(xem https://github.com/bazelbuild/bazel/issues/7008 để biết hướng dẫn di chuyển).
Thẻ:loading_and_analysis
,incompatible_change
- Giá trị mặc định của
--[no]incompatible_dont_enable_host_nonhost_crosstool_features
: "true" -
Nếu đúng, Bazel sẽ không bật "máy chủ lưu trữ" và "nonhost" trong chuỗi công cụ c++ (xem https://github.com/bazelbuild/bazel/issues/7407 để biết thêm thông tin).
Thẻ:loading_and_analysis
,incompatible_change
- Giá trị mặc định của
--[no]incompatible_enable_android_toolchain_resolution
: "false" -
Sử dụng độ phân giải chuỗi công cụ để chọn SDK Android cho các quy tắc Android (Starlark và gốc)
Thẻ:loading_and_analysis
,incompatible_change
- Giá trị mặc định của
--[no]incompatible_enable_apple_toolchain_resolution
: "false" -
Sử dụng độ phân giải của chuỗi công cụ để chọn Apple SDK cho các quy tắc của apple (Starlark và gốc)
Thẻ:loading_and_analysis
,incompatible_change
- Giá trị mặc định của
--[no]incompatible_make_thinlto_command_lines_standalone
: "true" -
Nếu đúng, Bazel sẽ không sử dụng lại các dòng lệnh hành động liên kết C++ cho các dòng lệnh lập chỉ mục lto (xem https://github.com/bazelbuild/bazel/issues/6791 để biết thêm thông tin).
Thẻ:loading_and_analysis
,incompatible_change
- Giá trị mặc định của
--[no]incompatible_remove_cpu_and_compiler_attributes_from_cc_toolchain
: "true" -
Nếu đúng, Bazel sẽ khiếu nại khi các thuộc tính cc_toolchain.cpu và cc_toolchain.compiler được đặt (xem https://github.com/bazelbuild/bazel/issues/7075 để biết hướng dẫn di chuyển).
Thẻ:loading_and_analysis
,incompatible_change
- Giá trị mặc định của
--[no]incompatible_remove_legacy_whole_archive
: "true" -
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
- Giá trị mặc định của
--[no]incompatible_require_ctx_in_configure_features
: "true" -
Nếu đúng, Bazel sẽ yêu cầu 'ctx' vào cc_common.configure_features (xem https://github.com/bazelbuild/bazel/issues/7793 để biết thêm thông tin).
Thẻ:loading_and_analysis
,incompatible_change
-
Sử dụng các đối tượng dùng chung trong 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
--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 SDK iOS cần sử dụng để xây dựng ứng dụng iOS. Nếu bạn chưa chỉ định, hãy sử dụng phiên bản SDK iOS mặc định trong "xcode_version".
Thẻ:loses_incremental_state
- Mặc định
--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 SDK macOS mà bạn muốn dùng để xây dựng ứng dụng cho macOS. Nếu bạn chưa chỉ định, hãy sử dụng phiên bản SDK macOS mặc định trong "xcode_version".
Thẻ:loses_incremental_state
- Mặc định
--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à cấu hình biên dịch của bạn nhắm đến.
Thẻ:loading_and_analysis
,affects_outputs
- Giá trị mặc định của
--platform_mappings=<a relative path>
: "" -
Vị trí của tệp ánh xạ mô tả nền tảng sẽ 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 nền tảng đã tồn tại. Phải tương ứng với thư mục gốc của không gian làm việc chính. Giá trị mặc định là "platform_mappings" (một tệp ngay dưới thư mục gốc của không gian làm việc).
Thẻ:affects_outputs
,changes_inputs
,loading_and_analysis
- Giá trị 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
--python2_path=<a string>
: xem nội dung mô tả -
Không được dùng nữa, không hoạt động. Bị tắt bởi "--incompatible_use_python_toolchains".
Thẻ:no_op
,deprecated
- Mặc định
--python3_path=<a string>
: xem nội dung mô tả -
Không được dùng nữa, không hoạt động. Bị tắt bởi "--incompatible_use_python_toolchains".
Thẻ:no_op
,deprecated
- Mặc định
--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
--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
- Giá trị mặc định của
--target_platform_fallback=<a build target label>
: "@local_config_platform//:host" -
Nhãn của một quy tắc nền tảng nên được sử dụng nếu không có nền tảng mục tiêu nào được đặt và không có ánh xạ nền tảng nào khớp với bộ cờ hiện tại.
Thẻ:affects_outputs
,changes_inputs
,loading_and_analysis
- Mặc định
--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 để sử dụng cho việc tạo ứng dụng tvOS. Nếu bạn chưa 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
--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 SDK watchOS cần 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 trong "xcode_version".
Thẻ:loses_incremental_state
- Mặc định
--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 liên quan đến bản dựng. Nếu chưa chỉ định, hãy sử dụng phiên bản Xcode mặc định của trình thực thi.
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:
- Giá trị mặc định của
--[no]apple_enable_auto_dsym_dbg
: "false" -
Liệu có buộc bật (các) tệp biểu tượng gỡ lỗi (.dSYM) cho các bản dựng dbg hay không.
Thẻ:affects_outputs
,action_command_lines
- Giá trị mặc định của
--[no]apple_generate_dsym
: "false" -
Liệu có tạo (các) tệp biểu tượng gỡ lỗi (.dSYM) hay không.
Thẻ:affects_outputs
,action_command_lines
- Giá trị mặc định của
--[no]build_runfile_links
: "true" -
Nếu đúng, hãy tạo các khu vực liên kết tượng trưng cho các tệp runfile cho tất cả các mục tiêu. Nếu giá trị là false, chỉ ghi tệp kê khai khi có thể.
Thẻ:affects_outputs
- Giá trị mặc định của
--[no]build_runfile_manifests
: "true" -
Nếu đúng, hãy ghi các tệp kê khai runfile cho tất cả đích. Nếu sai, hãy bỏ qua các giá trị này. Kiểm thử cục bộ sẽ không chạy được khi giá trị là false.
Thẻ:affects_outputs
- Giá trị mặc định của
--[no]build_test_dwp
: "false" -
Nếu được bật, khi xây dựng các chương trình kiểm thử C++ theo cách tĩnh và phân phối, 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
- Giá trị mặc định của
--cc_proto_library_header_suffixes=<comma-separated list of options>
: ".pb.h" -
Đặt tiền tố của tệp tiêu đề mà cc_proto_library tạo.
Thẻ:affects_outputs
,loading_and_analysis
- Giá trị mặc định của
--cc_proto_library_source_suffixes=<comma-separated list of options>
: ".pb.cc" -
Đặt tiền tố của tệp nguồn mà cc_proto_library tạo.
Thẻ:affects_outputs
,loading_and_analysis
- Giá trị mặc định của
--[no]experimental_proto_descriptor_sets_include_source_info
: "false" -
Chạy các hành động bổ sung cho phiên bản API Java thay thế trong một proto_library.
Thẻ:affects_outputs
,loading_and_analysis
,experimental
- Giá trị mặc định của
--[no]experimental_proto_extra_actions
: "false" -
Chạy các hành động bổ sung cho phiên bản API Java thay thế trong một proto_library.
Thẻ:affects_outputs
,loading_and_analysis
,experimental
- Giá trị mặc định của
--[no]experimental_save_feature_state
: "false" -
Lưu trạng thái của các tính năng đã bật và được yêu cầu dưới dạng kết quả của quá trình biên dịch.
Thẻ:affects_outputs
,experimental
- Giá trị mặc định của
--fission=<a set of compilation modes>
: "không" -
Chỉ định chế độ biên dịch nào sử dụng phân hạch cho các đường liên kết và biên dịch C++. Có thể là bất kỳ tổ hợp nào của {'fastbuild', 'dbg', 'opt'} hoặc các giá trị đặc biệt "yes" để bật tất cả các chế độ và chọn "không" để tắt tất cả các chế độ.
Thẻ:loading_and_analysis
,action_command_lines
,affects_outputs
- Giá trị mặc định của
--[no]incompatible_always_include_files_in_data
: "true" -
Nếu đúng, các quy tắc gốc sẽ thêm <code>DefaultInfo.files</code> phần phụ thuộc dữ liệu vào các tệp chạy của chúng, khớp với hành vi được đề xuất cho quy tắc Starlark (https://bazel.build/extend/rules#runfiles_features_to_avoid).
Thẻ:affects_outputs
,incompatible_change
- Giá trị mặc định của
--[no]legacy_external_runfiles
: "true" -
Nếu đúng, hãy tạo các khu rừng symlink runfiles cho các kho lưu trữ bên ngoài trong .runfiles/wsname/external/repo (ngoài .runfiles/repo).
Thẻ:affects_outputs
- Giá trị mặc định của
--[no]objc_generate_linkmap
: "false" -
Chỉ định xem có tạo tệp sơ đồ liên kết hay không.
Thẻ:affects_outputs
- Giá trị mặc định của
--[no]save_temps
: "false" -
Nếu bạn đặt chính sách này, hệ thống sẽ lưu kết quả tạm thời từ gcc. Các tệp này bao gồm tệp .s (mã trình tập hợp), tệp .i (tệp C đã xử lý trước) và tệp .ii (mã C++ được xử lý trước).
Thẻ:affects_outputs
- Các tuỳ chọn cho phép người dùng định cấu hình đầu ra dự kiến, ảnh hưởng đến giá trị của đầu ra đó, trái ngược với sự tồn tại của đầu ra đó:
--action_env=<a 'name=value' assignment with an optional value part>
lần dùng được tích luỹ-
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. Biến có thể được chỉ định theo tên. Trong trường hợp đó, giá trị sẽ được lấy từ môi trường gọi hoặc bằng cặp name=value sẽ đặ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; cho các lựa chọn được cung cấp cho cùng một biến, các biến mới nhất sẽ chiến thắng, các tuỳ 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
- Giá trị mặc định của
--[no]android_databinding_use_androidx
: "false" -
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 dùng với tính năng liên kết dữ liệu phiên bản 2.
Thẻ:affects_outputs
,loading_and_analysis
,loses_incremental_state
,experimental
- Giá trị mặc định của
--[no]android_databinding_use_v3_4_args
: "false" -
Sử dụng liên kết dữ liệu Android phiên bản 2 với đối số 3.4.0
Thẻ:affects_outputs
,loading_and_analysis
,loses_incremental_state
,experimental
- Giá trị 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 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 đủ' nghĩa là tất cả thư viện sẽ được liên kết động. "off" 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
- Mặc định của
--android_manifest_merger_order=<alphabetical, alphabetical_by_configuration or dependency>
: "theo thứ tự bảng chữ cái" -
Thiết lập thứ tự của 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. ALPHABETICS nghĩa là tệp kê khai được sắp xếp theo đường dẫn tương ứng với tập lệnh thực thi. ALPHABETICS_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 nghĩa là các tệp kê khai được sắp xếp theo thứ tự của từng tệp kê khai của thư viện đến trước tệp kê khai của các phần phụ thuộc.
Thẻ:action_command_lines
,execution
- Giá trị mặc định của
--[no]android_resource_shrinking
: "false" -
Bật tính năng rút gọn tài nguyên cho các APK android_binary sử dụng ProGuard.
Thẻ:affects_outputs
,loading_and_analysis
--apple_bitcode=<'mode' or 'platform=mode', where 'mode' is none, embedded_markers or embedded, and 'platform' is ios, watchos, tvos, macos or catalyst>
lần dùng được tích luỹ-
Chỉ định chế độ mã bit của Apple cho các bước biên dịch nhắm đến kiến trúc thiết bị. Giá trị có dạng "[platform=]mode", trong đó nền tảng (phải là "ios", "macos", "tvos" hoặc "watchos"). Nếu được cung cấp, chế độ mã bit sẽ được áp dụng riêng cho nền tảng đó; nếu bạn bỏ qua thì chính sách này sẽ áp dụng cho mọi nền tảng. Chế độ phải là "none", "embedded_markers" hoặc "được nhúng". Bạn có thể cung cấp lựa chọn này nhiều lần.
Thẻ:loses_incremental_state
- Giá trị mặc định của
--[no]build_python_zip
: "tự động" -
Tạo tệp zip có thể thực thi python; trên Windows, tắt trên các nền tảng khác
Thẻ:affects_outputs
--catalyst_cpus=<comma-separated list of options>
lần dùng được tích luỹ-
Danh sách các cấu trúc được phân tách bằng dấu phẩy để tạo tệp nhị phân Apple Catalyst.
Thẻ:loses_incremental_state
,loading_and_analysis
- Giá trị mặc định của
--[no]collect_code_coverage
: "false" -
Nếu được chỉ định, Bazel sẽ đo lường mã (sử dụng tính năng đo lường ngoại tuyến nếu có thể) và thu thập thông tin về mức độ sử dụng trong quá trình kiểm thử. Chỉ các mục tiêu khớp với --Instrumentation_filter mới bị ảnh hưởng. Thông thường, bạn không nên chỉ định trực tiếp tuỳ chọn này – "mức độ phủ sóng bazel" thay thế bằng lệnh.
Thẻ:affects_outputs
--compilation_mode=<fastbuild, dbg or opt>
[-c
] mặc định: "fastbuild"-
Chỉ định chế độ tạo tệp nhị phân. Giá trị: "fastbuild", "dbg", "opt".
Thẻ:affects_outputs
,action_command_lines
,explicit_in_output_path
--conlyopt=<a string>
lần dùng được tích luỹ-
Tuỳ chọn bổ sung để truyền đến gcc khi biên dịch tệp nguồn C.
Thẻ:action_command_lines
,affects_outputs
--copt=<a string>
lần dùng được tích luỹ-
Các tuỳ chọn khác để chuyển sang gcc.
Thẻ:action_command_lines
,affects_outputs
- Giá trị mặc định của
--cpu=<a string>
: "" -
CPU mục tiêu.
Thẻ:changes_inputs
,affects_outputs
,explicit_in_output_path
- Mặc định
--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
--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à(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
--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 được dùng cho mục đích tối ưu hoá.
Thẻ:affects_outputs
--cxxopt=<a string>
lần dùng được tích luỹ-
Tuỳ chọn bổ sung để truyền đến gcc khi biên dịch tệp nguồn C++.
Thẻ:action_command_lines
,affects_outputs
--define=<a 'name=value' assignment>
lần dùng được tích luỹ-
Mỗi tuỳ chọn --defined chỉ định một phép 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 động hay không. 'đầy đủ' nghĩa là tất cả thư viện sẽ được liên kết động. "off" 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
- Giá trị mặc định của
--[no]enable_fdo_profile_absolute_path
: "true" -
Nếu bạn đặt chính sách này, việc sử dụng fdo_ Apps_profile_path sẽ gây ra lỗi.
Thẻ:affects_outputs
- Giá trị mặc định của
--[no]enable_runfiles
: "tự động" -
Bật cây liên kết tượng trưng của các tệp runfile; Theo mặc định, tính năng này sẽ bị tắt trên Windows và trên các nền tảng khác.
Thẻ:affects_outputs
--experimental_action_listener=<a build target label>
lần dùng được tích luỹ-
Ngừng sử dụng và ưu tiên các khía cạnh. Sử dụng action_listener để đính kèm extra_action vào các thao tác hiện có đối với bản dựng.
Thẻ:execution
,experimental
- Giá trị mặc định của
--[no]experimental_android_compress_java_resources
: "false" -
Nén tài nguyên Java trong APK
Thẻ:affects_outputs
,loading_and_analysis
,experimental
- Giá trị mặc định của
--[no]experimental_android_databinding_v2
: "false" -
Dùng tính năng liên kết dữ liệu Android phiên bản 2
Thẻ:affects_outputs
,loading_and_analysis
,loses_incremental_state
,experimental
- Giá trị mặc định của
--[no]experimental_android_resource_shrinking
: "false" -
Bật tính năng rút gọn tài nguyên cho các APK android_binary sử dụng ProGuard.
Thẻ:affects_outputs
,loading_and_analysis
- Giá trị mặc định của
--[no]experimental_android_rewrite_dexes_with_rex
: "false" -
dùng công cụ rex để viết lại các tệp dex
Thẻ:affects_outputs
,loading_and_analysis
,loses_incremental_state
,experimental
- Giá trị 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 nhanh objc.
Thẻ:action_command_lines
- Giá trị mặc định của
--[no]experimental_omitfp
: "false" -
Nếu giá trị là true, hãy sử dụng libunwind để gỡ bỏ ngăn xếp và biên dịch bằng -fomit-frame-pointer và -faĐồng bộ-unwind-tables.
Thẻ:action_command_lines
,affects_outputs
,experimental
- Giá trị mặc định của
--[no]experimental_platform_in_output_dir
: "false" -
Nếu đúng, nền tảng mục tiêu sẽ được dùng trong tên thư mục đầu ra thay vì CPU.
Thẻ:affects_outputs
,experimental
- Giá trị mặc định của
--[no]experimental_use_llvm_covmap
: "false" -
Nếu được chỉ định, Bazel sẽ tạo thông tin bản đồ về phạm vi bao phủ llvm-cov thay vì gcov khi chế độ collection_code_Coverage được bật.
Thẻ:changes_inputs
,affects_outputs
,loading_and_analysis
,experimental
- Giá trị mặc định của
--fat_apk_cpu=<comma-separated list of options>
: "armeabi-v7a" -
Việc đặt tuỳ chọn này sẽ bật các tệp APK lớn, chứa tệp nhị phân gốc cho tất cả cấu trúc mục tiêu được chỉ định, chẳng hạn như --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
- Giá trị 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
--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à(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
--fdo_optimize=<a string>
: xem nội dung mô tả -
Sử dụng thông tin cấu hình 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 thêm một lệnh "exports_files" vào gói tương ứng) và các nhãn trỏ đến các 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
--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
--fdo_profile=<a build target label>
: xem nội dung mô tả -
fdo_profile đại diện cho hồ sơ được dùng cho hoạt động tối ưu hoá.
Thẻ:affects_outputs
--features=<a string>
lần dùng được tích luỹ-
Các tính năng nhất định sẽ được bật hoặc tắt theo mặc định cho các mục tiêu được tạo trong cấu hình mục tiêu. Chỉ định -<feature> sẽ tắt tính năng này. Các đối tượng phủ định luôn được ưu tiên hơn các đối tượng khẳng định. Xem thêm --host_features
Thẻ:changes_inputs
,affects_outputs
- Giá trị mặc định của
--[no]force_pic
: "false" -
Nếu được bật, tất cả phần biên dịch C++ sẽ tạo ra mã độc lập với vị trí ("-fPIC"), các đường liên kết sẽ ưu tiên thư viện PIC dựng sẵn hơn là thư viện không phải PIC và các đường liên kết tạo ra các tệp thực thi độc lập với vị trí ("-pie").
Thẻ:loading_and_analysis
,affects_outputs
--host_action_env=<a 'name=value' assignment with an optional value part>
lần dùng được tích luỹ-
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áy chủ lưu trữ hoặc thực thi. Biến có thể được chỉ định theo tên. Trong trường hợp đó, giá trị sẽ được lấy từ môi trường gọi hoặc bằng cặp name=value sẽ đặ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; cho các lựa chọn được cung cấp cho cùng một biến, các biến mới nhất sẽ chiến thắng, các tuỳ 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
--host_compilation_mode=<fastbuild, dbg or opt>
: "tối ưu hoá" -
Chỉ định chế độ tích hợp cho các công cụ dùng trong quá trình tạo bản dựng. Giá trị: "fastbuild", "dbg", "opt".
Thẻ:affects_outputs
,action_command_lines
--host_conlyopt=<a string>
lần dùng được tích luỹ-
Tuỳ chọn bổ sung để truyền đến gcc khi biên dịch tệp nguồn C cho công cụ lưu trữ.
Thẻ:action_command_lines
,affects_outputs
--host_copt=<a string>
lần dùng được tích luỹ-
Các tuỳ chọn khác để chuyển sang gcc cho công cụ lưu trữ.
Thẻ:action_command_lines
,affects_outputs
- Giá trị mặc định của
--host_cpu=<a string>
: "" -
CPU máy chủ.
Thẻ:changes_inputs
,affects_outputs
--host_cxxopt=<a string>
lần dùng được tích luỹ-
Các tuỳ chọn khác để chuyển sang gcc cho công cụ lưu trữ.
Thẻ:action_command_lines
,affects_outputs
--host_features=<a string>
lần dùng được tích luỹ-
Các tính năng nhất định sẽ được bật hoặc tắt theo mặc định đối với các mục tiêu được tạo trong cấu hình thực thi. Chỉ định -<feature> sẽ tắt tính năng này. Các đối tượng phủ định luôn được ưu tiên hơn các đối tượng khẳng định.
Thẻ:changes_inputs
,affects_outputs
- Mặc định
--host_force_python=<PY2 or PY3>
: xem nội dung mô tả -
Ghi đè phiên bản Python cho cấu hình máy chủ lưu trữ. Có thể là "PY2" hoặc "PY3".
Thẻ:loading_and_analysis
,affects_outputs
--host_linkopt=<a string>
lần dùng được tích luỹ-
Tuỳ chọn bổ sung để chuyển sang gcc khi liên kết các công cụ lưu trữ.
Thẻ:action_command_lines
,affects_outputs
- Mặc định
--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 đích lưu trữ. Nếu bạn chưa chỉ định, hãy sử dụng "macos_sdk_version".
Thẻ:loses_incremental_state
--host_per_file_copt=<a comma-separated list of regex expressions with prefix '-' specifying excluded paths followed by an @ and a comma separated list of options>
lần dùng được tích luỹ-
Các tuỳ chọn bổ sung để truyền có chọn lọc đến trình biên dịch C/C++ khi biên dịch một số tệp nhất định trong cấu hình máy chủ lưu trữ hoặc thực thi. Bạn có thể bỏ qua lựa chọn này nhiều lần. Cú pháp: regex_filter@option_1,option_2,...,option_n. Trong đó regex_filter là danh sách các mẫu biểu thức chính quy bao gồm và loại trừ (Xem thêm --Instrumentation_filter). 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 chứa dấu phẩy, thì tuỳ chọn đó phải nằm trong dấu gạch chéo ngược. Các tuỳ chọn có thể chứa @. Chỉ có ký tự @ đầu tiên dùng để phân tách chuỗi. Ví dụ: --host_per_file_copt=//foo/.*\.cc,-//foo/bar\.cc@-O0 sẽ thêm tuỳ chọn dòng lệnh -O0 vào dòng lệnh gcc của tất cả các tệp cc trong //foo/ ngoại trừ bar.cc.
Thẻ:action_command_lines
,affects_outputs
--host_swiftcopt=<a string>
lần dùng được tích luỹ-
Các tuỳ chọn bổ sung để chuyển đến swimaker cho các công cụ lưu trữ.
Thẻ:action_command_lines
,affects_outputs
- Giá trị mặc định của
--[no]incompatible_avoid_conflict_dlls
: "true" -
Nếu được bật, tất cả các thư viện được liên kết động (DLL) C++ do cc_library trên Windows tạo sẽ được đổi tên thành name_{hash}.dll trong đó hàm băm được tính toán dựa trên RepositoryName và đường dẫn gói của DLL. Tuỳ chọn này rất hữu ích khi bạn có một gói phụ thuộc vào một số cc_library có cùng tên (ví dụ: //foo/bar1:utils và //foo/bar2:utils).
Thẻ:loading_and_analysis
,affects_outputs
,incompatible_change
- Giá trị mặc định của
--[no]incompatible_merge_genfiles_directory
: "true" -
Nếu là true, thư mục genfiles sẽ được thu gọn vào thư mục bin.
Thẻ:affects_outputs
,incompatible_change
- Giá trị mặc định của
--[no]incompatible_use_host_features
: "false" -
Nếu đúng, chỉ sử dụng --features cho cấu hình mục tiêu và --host_features cho cấu hình thực thi.
Thẻ:changes_inputs
,affects_outputs
,incompatible_change
- Giá trị mặc định của
--[no]incompatible_use_platforms_repo_for_constraints
: "true" -
Nếu là true, các chế độ cài đặt quy tắc ràng buộc trong @bazel_tools sẽ bị xoá.
Thẻ:affects_outputs
,incompatible_change
- Giá trị mặc định của
--[no]instrument_test_targets
: "false" -
Khi mức độ sử dụng được bật, hãy chỉ định xem có cân nhắc việc đo lường các quy tắc kiểm thử hay không. Khi được đặt, các quy tắc kiểm thử do --Instrumentation_filter đưa vào 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 phạm vi.
Thẻ:affects_outputs
- Giá trị 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 nằm trong bộ lọc dựa trên biểu thức chính quy được chỉ định mới được đo lường. Các quy tắc có tiền tố là "-" bị loại trừ. Lưu ý rằng chỉ các quy tắc không kiểm thử mới được đo lường trừ khi bật --Instrument_test_targets.
Thẻ:affects_outputs
- Mặc định
--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 mục tiêu và thiết bị. Nếu bạn chưa chỉ định, hãy sử dụng "ios_sdk_version".
Thẻ:loses_incremental_state
--ios_multi_cpus=<comma-separated list of options>
lần dùng được tích luỹ-
Danh sách cấu 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
- Giá trị mặc định của
--[no]legacy_whole_archive
: "true" -
Không dùng nữa và được thay thế bằng --incompatible_remove_legacy_w tuyển_lưu trữ (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 tuyển-lưu trữ cho các quy tắc cc_binary có linkshared=True và linkstatic=True hoặc '-static' trong liên kết. Điều này chỉ dành cho khả năng tương thích ngược. Một cách khác tốt hơn là sử dụng chiến lược Alwayslink=1 nếu cần.
Thẻ:action_command_lines
,affects_outputs
,deprecated
--linkopt=<a string>
lần dùng được tích luỹ-
Tuỳ chọn bổ sung để chuyển sang gcc khi liên kết.
Thẻ:action_command_lines
,affects_outputs
--ltobackendopt=<a string>
lần dùng được tích luỹ-
Tuỳ chọn bổ sung để chuyển đến bước phụ trợ LTO (trong --features=thin_lto).
Thẻ:action_command_lines
,affects_outputs
--ltoindexopt=<a string>
lần dùng được tích luỹ-
Tuỳ chọn bổ sung để chuyển đến bước lập chỉ mục LTO (trong --features=thin_lto).
Thẻ:action_command_lines
,affects_outputs
--macos_cpus=<comma-separated list of options>
lần dùng được tích luỹ-
Danh sách được phân tách bằng dấu phẩy gồm các kiến trúc dùng để tạo tệp nhị phân macOS của Apple.
Thẻ:loses_incremental_state
,loading_and_analysis
- Mặc định
--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 các mục tiêu. Nếu bạn chưa chỉ định, hãy sử dụng "macos_sdk_version".
Thẻ:loses_incremental_state
- Giá trị mặc định của
--[no]objc_debug_with_GLIBCXX
: "false" -
Nếu được đặt và chế độ biên dịch được đặt thành 'dbg', hãy xác định GLIBCXX_DEBUG, GLIBCXX_DEBUG_PEDANTIC và GLIBCPP_CONVERSION_KIỂM TRA.
Thẻ:action_command_lines
- Giá trị mặc định của
--[no]objc_enable_binary_stripping
: "false" -
Liệu có thực hiện việc xoá biểu tượng và mã chết trên các tệp nhị phân được liên kết hay không. Việc loại bỏ tệp nhị phân sẽ được thực hiện nếu cả cờ này và --compilation_mode=opt được chỉ định.
Thẻ:action_command_lines
--objccopt=<a string>
lần dùng được tích luỹ-
Các tuỳ chọn bổ sung để truyền đến gcc khi biên dịch tệp nguồn Target-C/C++.
Thẻ:action_command_lines
--per_file_copt=<a comma-separated list of regex expressions with prefix '-' specifying excluded paths followed by an @ and a comma separated list of options>
lần dùng được tích luỹ-
Các tuỳ chọn bổ sung để truyền có chọn lọc đến gcc khi biên dịch một số tệp nhất định. Bạn có thể bỏ qua lựa chọn này nhiều lần. Cú pháp: regex_filter@option_1,option_2,...,option_n. Trong đó regex_filter là danh sách các mẫu biểu thức chính quy bao gồm và loại trừ (Xem thêm --Instrumentation_filter). 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 chứa dấu phẩy, thì tuỳ chọn đó phải nằm trong dấu gạch chéo ngược. Các tuỳ chọn có thể chứa @. Chỉ có ký tự @ đầu tiên dùng để phân tách chuỗi. Ví dụ: --per_file_copt=//foo/.*\.cc,-//foo/bar\.cc@-O0 sẽ 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
--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 dùng được tích luỹ-
Các tuỳ chọn bổ sung để chuyển có chọn lọc đến phần phụ trợ LTO (trong --features=thin_lto) khi biên dịch một số đối tượng phụ trợ nhất định. Bạn có thể bỏ qua lựa chọn này nhiều lần. Cú pháp: regex_filter@option_1,option_2,...,option_n. Trong đó regex_filter là danh sách các mẫu biểu thức chính quy bao gồm và loại trừ. 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 chứa dấu phẩy, thì tuỳ chọn đó phải nằm trong dấu gạch chéo ngược. Các tuỳ chọn có thể chứa @. Chỉ có ký tự @ đầu tiên dùng để phân tách chuỗi. Ví dụ: --per_file_ltobackendopt=//foo/.*\.o,-//foo/bar\.o@-O0 sẽ thêm tuỳ chọn dòng lệnh -O0 vào dòng lệnh phụ trợ LTO của tất cả các tệp o trong //foo/ ngoại trừ bar.o.
Thẻ:action_command_lines
,affects_outputs
- Mặc định
--platform_suffix=<a string>
: xem nội dung mô tả -
Chỉ định một hậu tố cần thêm vào thư mục cấu hình.
Thẻ:loses_incremental_state
,affects_outputs
,loading_and_analysis
- Mặc định
--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.Hồ sơ cánh quạt phải bao gồm ít nhất 1 trong 2 tệp là hồ sơ cc và hồ sơ ld. Cờ này chấp nhận một nhãn bản dựng tham chiếu đến các tệp đầu vào của hồ sơ chân vị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ể thêm lệnh export_files vào gói tương ứng để hiển thị những tệp này cho Bazel. Tuỳ chọn này phải được sử dụng dưới dạng: --propeller_optimize=//a/b:propeller_profile
Thẻ:action_command_lines
,affects_outputs
- Mặc định
--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 Propeller tối ưu hoá.
Thẻ:affects_outputs
- Mặc định
--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 Propeller.
Thẻ:affects_outputs
- Mặc định
--run_under=<a prefix in front of command>
: xem nội dung mô tả -
Tiền tố để chèn trước tệp thực thi cho "test" (kiểm thử) và 'chạy' các lệnh. 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 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
-
Nếu đúng, các thư viện gốc có chức năng giống nhau sẽ được chia sẻ giữa các đích khác nhau
Thẻ:loading_and_analysis
,affects_outputs
- Giá trị mặc định của
--[no]stamp
: "false" -
Đóng dấu các tệp nhị phân có 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ó bỏ tệp nhị phân và thư viện dùng chung hay không (sử dụng "-Wl,--strip-debug"). Giá trị mặc định của 'đôi khi' có nghĩa là xoá iff --compilation_mode=fastbuild.
Thẻ:affects_outputs
--stripopt=<a string>
lần dùng được tích luỹ-
Các tuỳ chọn bổ sung để chuyển sang dải khi tạo '<name>.stripped' nhị phân.
Thẻ:action_command_lines
,affects_outputs
--swiftcopt=<a string>
lần dùng được tích luỹ-
Các tuỳ chọn bổ sung để chuyển sang quá trình biên dịch Swift.
Thẻ:action_command_lines
--tvos_cpus=<comma-separated list of options>
lần dùng được tích luỹ-
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 tvOS.
Thẻ:loses_incremental_state
,loading_and_analysis
- Mặc định
--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 mục tiêu và thiết bị. Nếu bạn chưa chỉ định, hãy sử dụng "tvos_sdk_version".
Thẻ:loses_incremental_state
--watchos_cpus=<comma-separated list of options>
lần dùng được tích luỹ-
Danh sách các cấu trúc được phân tách bằng dấu phẩy để tạo tệp nhị phân Apple watchOS.
Thẻ:loses_incremental_state
,loading_and_analysis
- Mặc định
--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 các trình mô phỏng và thiết bị mục tiêu. Nếu bạn chưa chỉ định, hãy sử dụng "watchos_sdk_version".
Thẻ:loses_incremental_state
- Mặc định
--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, các tuỳ chọn đó sẽ luôn chiếm ưu thế như thể xbinary_fdo không bao giờ được chỉ định.
Thẻ:affects_outputs
- Các lựa chọn ảnh hưởng đến mức độ nghiêm ngặt của Bazel trong việc thực thi dữ liệu đầu vào bản dựng hợp lệ (định nghĩa quy tắc, tổ hợp cờ, v.v.):
- Giá trị mặc định của
--auto_cpu_environment_group=<a build target label>
: "" -
Khai báo environment_group để tự động liên kết các giá trị cpu với các giá trị target_environment.
Thẻ:changes_inputs
,loading_and_analysis
,experimental
- Giá trị mặc định của
--[no]check_licenses
: "false" -
Kiểm tra để đảm bảo rằng những 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 mục tiêu đang được tạo. Theo mặc định, giấy phép không được chọn.
Thẻ:build_file_semantics
- Giá trị mặc định của
--[no]check_visibility
: "true" -
Nếu bạn tắt chính sách này, lỗi hiển thị trong các phần phụ thuộc mục tiêu sẽ bị giảm hạng xuống thành cảnh báo.
Thẻ:build_file_semantics
- Giá trị mặc định của
--[no]desugar_for_android
: "true" -
Liệu có đơn giản hoá mã byte Java 8 trước khi tạo tệp dex hay không.
Thẻ:affects_outputs
,loading_and_analysis
,loses_incremental_state
- Giá trị mặc định của
--[no]desugar_java8_libs
: "false" -
Liệu có đưa các thư viện Java 8 được hỗ trợ vào ứng dụng dành cho thiết bị cũ hay không.
Thẻ:affects_outputs
,loading_and_analysis
,loses_incremental_state
,experimental
- Giá trị mặc định của
--[no]enforce_constraints
: "true" -
Kiểm tra môi trường mà mỗi mục tiêu tương thích và báo cáo lỗi nếu có mục tiêu có các phần phụ thuộc không hỗ trợ cùng một môi trường
Thẻ:build_file_semantics
- Giá trị mặc định của
--[no]experimental_allow_android_library_deps_without_srcs
: "false" -
Gắn cờ để giúp chuyển đổi từ trạng thái cho phép không cho phép các quy tắc srcs-less android_library có phần phụ thuộc. Bạn cần dọn dẹp kho chứa để triển khai theo mặc định.
Thẻ:eagerness_to_exit
,loading_and_analysis
- Giá trị mặc định của
--[no]experimental_check_desugar_deps
: "true" -
Liệu có kiểm tra kỹ quá trình đơn giản hoá chính xác ở cấp độ nhị phân 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 aar_import đã hoàn tất hay chưa. Hành động thực thi này có thể làm hỏng bản dựng hoặc chỉ dẫn đến cảnh báo.
Thẻ:loading_and_analysis
- Mặc định của
--experimental_strict_java_deps=<off, warn, error, strict or default>
: "mặc định" -
Nếu giá trị là true (đúng), hãy kiểm tra để đảm bảo rằng một mục tiêu Java khai báo rõ ràng tất cả các mục tiêu được sử dụng trực tiếp dưới dạng phần phụ thuộc.
Thẻ:build_file_semantics
,eagerness_to_exit
- Giá trị mặc định của
--[no]incompatible_check_testonly_for_output_files
: "false" -
Nếu được bật, hãy kiểm tra chỉ kiểm thử cho các mục tiêu điều kiện tiên quyết là tệp đầu ra bằng cách tra cứu chỉ kiểm thử của quy tắc đang tạo. Điều này khớp với quy trình kiểm tra khả năng hiển thị.
Thẻ:build_file_semantics
,incompatible_change
- Giá trị mặc định của
--[no]incompatible_disable_native_android_rules
: "false" -
Nếu được bật, việc sử dụng trực tiếp quy tắc Android gốc sẽ bị tắt. Vui lòng sử dụng các quy tắc Starlark Android tại https://github.com/bazelbuild/rules_android
Thẻ:eagerness_to_exit
,incompatible_change
- Giá trị mặc định của
--[no]incompatible_disable_native_apple_binary_rule
: "false" -
Không hoạt động. Được giữ lại ở đây để có khả năng tương thích ngược.
Thẻ:eagerness_to_exit
,incompatible_change
- Giá trị mặc định của
--[no]incompatible_force_strict_header_check_from_starlark
: "true" -
Nếu được bật, hãy đặt kiểm tra tiêu đề nghiêm ngặt trong API Starlark
Thẻ:loading_and_analysis
,changes_inputs
,incompatible_change
- Giá trị mặc định của
--[no]incompatible_validate_top_level_header_inclusions
: "true" -
Nếu đúng, Bazel cũng sẽ xác thực việc bao gồm 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
- Giá trị 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 tệp vượt qua ranh giới gói sẽ được báo cáo là lỗi. Tính năng này không hoạt động khi bạn tắt check_fileset_Dependencies_recursively.
Thẻ:build_file_semantics
,eagerness_to_exit
- Giá trị mặc định của
--strict_proto_deps=<off, warn, error, strict or default>
: "lỗi" -
Trừ phi bị 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ả 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
- Giá trị mặc định của
--strict_public_imports=<off, warn, error, strict or default>
: "tắt" -
Trừ phi bị TẮT, các hoạt động kiểm tra để đảm bảo mục tiêu proto_library khai báo rõ ràng tất cả mục tiêu dùng trong lệnh "nhập công khai" dưới dạng được xuất.
Thẻ:build_file_semantics
,eagerness_to_exit
,incompatible_change
- Giá trị mặc định của
--[no]strict_system_includes
: "false" -
Nếu đúng thì tiêu đề được tìm thấy qua hệ thống bao gồm cả đường dẫn (-isystem) cũng bắt buộc phải được khai báo.
Thẻ:loading_and_analysis
,eagerness_to_exit
--target_environment=<a build target label>
lần dùng được tích luỹ-
Khai báo môi trường mục tiêu của bản dựng này. Phải là mục tham chiếu nhãn đến một "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 được sử dụng để ký tệp APK
Thẻ:action_command_lines
,affects_outputs
,loading_and_analysis
- Giá trị mặc định của
--[no]device_debug_entitlements
: "true" -
Nếu được đặt và chế độ biên dịch không phải là "opt", ứng dụng objc sẽ bao gồm các quyền gỡ lỗi khi ký.
Thẻ:changes_inputs
- Mặc định
--ios_signing_cert_name=<a string>
: xem nội dung mô tả -
Tên chứng chỉ sẽ dù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à tùy chọn nhận dạng chuỗi khóa của chứng chỉ hoặc (chuỗi con) trong tên chung của chứng chỉ, như theo trang người dùng của ký hiệu 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 các tệp BUILD, tệp .bzl hoặc tệp WORKSPACE.:
- Giá trị mặc định của
--[no]incompatible_disallow_legacy_py_provider
: "true" -
Không hoạt động, sẽ sớm bị xoá.
Thẻ:loading_and_analysis
,incompatible_change
- 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ử:
- Giá trị mặc định của
--[no]allow_analysis_failures
: "false" -
Nếu đúng, lỗi phân tích của một mục tiêu quy tắc sẽ dẫn đến việc mục tiêu truyền một bản sao của AnalysisFailureInfo có chứa nội dung mô tả lỗi, thay vì dẫn đến lỗi bản dựng.
Thẻ:loading_and_analysis
,experimental
- Giá trị mặc định của
--analysis_testing_deps_limit=<an integer>
: "2000" -
Đặt số lượng tối đa các phần phụ thuộc bắc cầu thông qua một thuộc tính quy tắc có chuyển đổi cấu hình for_analysis_testing. Việc vượt quá giới hạn này sẽ dẫn đến lỗi quy tắc.
Thẻ:loading_and_analysis
- Giá trị mặc định của
--[no]break_build_on_parallel_dex2oat_failure
: "false" -
Nếu lỗi hành động dex2oat thực sự không thành công sẽ khiến bản dựng bị lỗi thay vì thực thi dex2oat trong thời gian chạy kiểm thử.
Thẻ:loading_and_analysis
,experimental
- Giá trị mặc định của
--[no]experimental_android_use_parallel_dex2oat
: "false" -
Sử dụng song song dex2oat để có thể tăng tốc android_test.
Thẻ:loading_and_analysis
,host_machine_resource_optimizations
,experimental
- Giá trị mặc định của
--[no]ios_memleaks
: "false" -
Bật tính năng kiểm tra xem có rò rỉ bộ nhớ trong mục tiêu ios_test không.
Thẻ:action_command_lines
- Mặc định
--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ụ: "iPhone 6". Bạn có thể xem danh sách thiết bị bằng cách chạy "xcrun simctl list devicetypes" trên máy đó.
Thẻ:test_runner
- Mặc định
--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 thử nghiệm. Tham số này 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
--runs_per_test=<a positive integer or test_regex@runs. This flag may be passed more than once>
lần dùng được tích luỹ- Chỉ định số lần chạy mỗi lượt kiểm thử. Nếu bất kỳ lần thử nào trong số đó không thành công vì bất cứ lý do gì, toàn bộ thử nghiệm sẽ được coi là không thành công. Thông thường, giá trị được chỉ định chỉ là một số nguyên. Ví dụ: --runs_per_test=3 sẽ chạy tất cả kiểm thử 3 lần. Cú pháp thay thế: regex_filter@runs_per_test. Trong đó running_per_test là viết tắt của một giá trị số nguyên và regex_filter đại diện cho 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 kiểm thử trong //foo/, ngoại trừ các kiểm thử dưới foo/bar ba lần. Bạn có thể bỏ qua lựa chọn này nhiều lần. Đối số được truyền gần đây nhất phù hợp sẽ được ưu tiên. Nếu không có kết quả nào phù hợp, thì kiểm thử sẽ chỉ được chạy một lần.
--test_env=<a 'name=value' assignment with an optional value part>
lần dùng được tích luỹ-
Chỉ định các biến môi trường bổ sung sẽ được đưa vào môi trường chạy kiểm thử. Các biến có thể được chỉ định theo tên, trong trường hợp đó, giá trị của biến sẽ được đọc từ môi trường ứng dụng Bazel hoặc theo cặp name=value. Bạn có thể sử dụng tuỳ chọn này nhiều lần để chỉ định một số biến. Chỉ được dùng trong "thử nghiệm bazel" .
Thẻ:test_runner
- Giá trị 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ờ mặc định của kiểm thử 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, giá trị này sẽ ghi đè tất 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, chúng sẽ ghi đè thời gian chờ cho ngắn, trung bình, dài và vĩnh viễn (theo thứ tự đó). Ở cả hai dạng, giá trị -1 yêu cầu blaze sử dụng thời gian chờ mặc định cho danh mục đó.
- Mặc định
--tvos_simulator_device=<a string>
: xem nội dung mô tả -
Thiết bị để mô phỏng khi chạy ứng dụng tvOS trong trình mô phỏng, ví dụ: "Apple TV 1080p". Bạn có thể xem danh sách thiết bị bằng cách chạy "xcrun simctl list devicetypes" trên máy đó.
Thẻ:test_runner
- Mặc định
--tvos_simulator_version=<a dotted version (for example '2.3' or '3.3alpha2.4')>
: xem nội dung mô tả -
Phiên bản tvOS để chạy trên trình mô phỏng khi chạy hoặc thử nghiệm.
Thẻ:test_runner
- Mặc định
--watchos_simulator_device=<a string>
: xem nội dung mô tả -
Thiết bị để mô phỏng khi chạy ứng dụng watchOS trong trình mô phỏng, ví dụ: "Apple Watch – 38mm". Bạn có thể xem danh sách thiết bị bằng cách chạy "xcrun simctl list devicetypes" trên máy đó.
Thẻ:test_runner
- Mặc định
--watchos_simulator_version=<a dotted version (for example '2.3' or '3.3alpha2.4')>
: xem nội dung mô tả -
Phiên bản watchOS để chạy trên trình mô phỏng khi chạy hoặc kiểm thử.
Thẻ:test_runner
- Giá trị mặc định của
--[no]zip_undeclared_test_outputs
: "true" -
Nếu là true, các kết quả kiểm thử chưa được khai báo sẽ được lưu trữ trong một tệp zip.
Thẻ:test_runner
- Các lựa chọn liên quan đến đầu ra của truy vấn và ngữ nghĩa:
- 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à một trong {xml,proto,record}. "off" có nghĩa là không có phần phụ thuộc khung hình nào được giải quyết, "thận trọng" (mặc định) có nghĩa là tất cả phần phụ thuộc khía cạnh đã khai báo đều được thêm vào bất kể chúng có được cung cấp lớp quy tắc của phần phụ thuộc trực tiếp hay không, "chính xác" có nghĩa là chỉ những khía cạnh đó được thêm vào mà 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. Xin lưu ý rằng chế độ chính xác yêu cầu tải các gói khác để đánh giá một mục tiêu. Do đó, mục tiêu này sẽ chậm hơn so với các chế độ khác. Ngoài ra, xin lưu ý rằng ngay cả chế độ chính xác cũng không hoàn toàn chính xác: việc quyết định có tính toán một khía cạnh hay không được quyết định trong giai đoạn phân tích, giai đoạn này không chạy trong quá trình "truy vấn bazel".
Thẻ:build_file_semantics
- Giá trị mặc định của
--[no]deduplicate_depsets
: "true" -
Loại bỏ các phần tử con không có lá trùng lặp của một dep_set_of_files trong đầu ra proto/textproto/json cuối cùng. Việc này không loại bỏ các phần trùng lặp không có chung mục cha mẹ ngay lập tức. Điều này không ảnh hưởng đến danh sách cấu phần phần mềm đầu vào có hiệu lực cuối cùng của các thao tác.
Thẻ:terminal_output
- Giá trị mặc định của
--[no]graph:factored
: "true" -
Nếu đúng, thì biểu đồ sẽ được tạo ra "được tạo thành thừa số", tức là các nút tương đương về cấu trúc liên kết sẽ được hợp nhất với nhau và nhãn của chúng sẽ được nối với nhau. Tuỳ chọn này chỉ áp dụng cho --output=graph.
Thẻ:terminal_output
- Giá trị 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 dữ liệu đầu ra. 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=graph.
Thẻ:terminal_output
- Giá trị mặc định của
--[no]implicit_deps
: "true" -
Nếu được bật, các phần phụ thuộc ngầm ẩ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ằng 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ụ đã phân giải.
Thẻ:build_file_semantics
- Giá trị mặc định của
--[no]include_artifacts
: "true" -
Bao gồm tên của các đầu vào và đầu ra hành động ở đầu ra (có thể lớn).
Thẻ:terminal_output
- Giá trị mặc định của
--[no]include_aspects
: "true" -
aquery, cquery: liệu có bao gồm các hành động được tạo theo khía cạnh trong kết quả hay không. query: no-op (luôn đi theo các khía cạnh).
Thẻ:terminal_output
- Giá trị mặc định của
--[no]include_commandline
: "true" -
Bao gồm nội dung của các dòng lệnh hành động trong đầu ra (có thể lớn).
Thẻ:terminal_output
- Giá trị mặc định của
--[no]include_file_write_contents
: "false" -
Đưa nội dung tệp vào các thao tác FileWrite và SourceSymlinkManifest (có thể lớn).
Thẻ:terminal_output
- Giá trị mặc định của
--[no]include_param_files
: "false" -
Bao gồm nội dung của các tệp thông số được dùng trong lệnh (có thể lớn). Lưu ý: Việc bật cờ này sẽ tự động bật cờ --include_commandline.
Thẻ:terminal_output
- Giá trị mặc định của
--[no]incompatible_display_source_file_location
: "true" -
"True" theo mặc định sẽ hiển thị mục tiêu của tệp nguồn. Nếu đúng, hiển thị vị trí dòng 1 của tệp nguồn trong dữ liệu đầu ra vị trí. Cờ này chỉ dành cho mục đích di chuyển.
Thẻ:terminal_output
,incompatible_change
- Giá trị mặc định của
--[no]incompatible_package_group_includes_double_slash
: "true" -
Nếu được bật, khi xuất thuộc tính "packages" của package_group, phần tử "//" ở đầu sẽ không bị bỏ qua.
Thẻ:terminal_output
,incompatible_change
- Giá trị mặc định của
--[no]infer_universe_scope
: "false" -
Nếu bạn không đặt giá trị đặt và --universe_scope thì giá trị của --universe_scope sẽ được suy ra dưới dạng danh sách các mẫu mục tiêu riêng biệ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 vũ trụ (ví dụ:`allrdeps`) có thể không phải là giá trị bạn muốn. Vì vậy, bạn chỉ nên sử dụng tuỳ chọn này nếu biết mình đang làm gì. Hãy 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 ý: tuỳ chọn này chỉ áp dụng cho "query" (nghĩa là không áp dụng cho "cquery").
Thẻ:loading_and_analysis
- Giá trị mặc định của
--[no]line_terminator_null
: "false" -
Liệu mỗi định dạng có bị chấm dứt bằng \0 thay vì dòng mới hay không.
Thẻ:terminal_output
- Giá trị mặc định của
--[no]nodep_deps
: "true" -
Nếu được bật, phần phụ thuộc từ "nodep" sẽ được đưa vào biểu đồ phần phụ thuộc mà qua đó truy vấn hoạt động. Một ví dụ phổ biến về "nút" 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ả "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 mà kết quả truy vấn sẽ được in. Các giá trị được phép cho truy vấn là: text, textproto, proto, jsonproto.
Thẻ:terminal_output
- Giá trị mặc định của
--[no]proto:default_values
: "true" -
Nếu đúng, các thuộc tính có giá trị không được chỉ định rõ ràng trong tệp BUILD sẽ được đưa vào; nếu không thì chúng sẽ bị bỏ qua. Tuỳ chọn này có thể áp dụng cho --output=proto
Thẻ:terminal_output
- Giá trị mặc định của
--[no]proto:definition_stack
: "false" -
Điền vào trường proto Definition_stack sẽ ghi lại từng thực thể quy tắc của ngăn xếp lệnh gọi Starlark tại thời điểm xác định lớp của quy tắc.
Thẻ:terminal_output
- Giá trị mặc định của
--[no]proto:flatten_selects
: "true" -
Nếu bạn bật tuỳ chọn này, các thuộc tính có thể định cấu hình do Select() tạo sẽ được làm phẳng. Đối với các loại danh sách, bản trình bày đã làm phẳng là danh sách chứa chính xác mỗi giá trị của tệp ánh xạ được chọn 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
- Giá trị mặc định của
--[no]proto:include_synthetic_attribute_hash
: "false" -
Liệu có tính toán và điền thuộc tính $internal_attr_hash hay không.
Thẻ:terminal_output
- Giá trị mặc định của
--[no]proto:instantiation_stack
: "false" -
Điền ngăn xếp lệnh gọi tạo thực thể của từng quy tắc. Lưu ý rằng thao tác này đòi hỏi phải có ngăn xếp
Thẻ:terminal_output
- Giá trị mặc định của
--[no]proto:locations
: "true" -
Liệu có xuất thông tin vị trí trong đầu ra proto hay không.
Thẻ:terminal_output
- Mặc định của
--proto:output_rule_attrs=<comma-separated list of options>
: "tất cả" -
Danh sách thuộc tính được phân tách bằng dấu phẩy để đưa vào dữ liệu đầu ra. Giá trị mặc định là tất cả thuộc tính. Bạn phải đặt thành chuỗi trống để không xuất thuộc tính nào. Tuỳ chọn này có thể áp dụng cho --output=proto.
Thẻ:terminal_output
- Giá trị mặc định của
--[no]proto:rule_inputs_and_outputs
: "true" -
Liệu có điền sẵn các trường rules_input và rules_output hay không.
Thẻ:terminal_output
- Giá trị mặc định của
--[no]relative_locations
: "false" -
Nếu đúng, vị trí của các tệp BUILD trong đầu ra xml và proto sẽ là tương đối. Theo mặc định, kết quả vị trí là một đường dẫn tuyệt đối và sẽ không nhất quán giữa các máy. Bạn có thể đặt tuỳ chọn này thành true để nhận được kết quả nhất quán trên các máy.
Thẻ:terminal_output
- Giá trị mặc định của
--[no]skyframe_state
: "false" -
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ỉ có sẵn với --output=proto hoặc --output=textproto.
Thẻ:terminal_output
- Giá trị mặc định của
--[no]tool_deps
: "true" -
Truy vấn: Nếu bị tắt, các phần phụ thuộc trên "cấu hình máy chủ" hoặc "thực thi" sẽ không được đưa vào biểu đồ phụ thuộc mà qua đó truy vấn hoạt động. "Cấu hình máy chủ lưu trữ" cạnh phụ thuộc, chẳng hạn như cạnh phụ thuộc từ bất kỳ "proto_library" nào cho 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 'mục tiêu' .
Cquery: Nếu bị tắt, hãy lọc tất cả các mục tiêu đã định cấu hình vượt qua quá trình chuyển đổi lưu trữ hoặc thực thi khỏi 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ũng 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 máy chủ lưu trữ, thì chỉ các mục tiêu đã định cấu hình của máy chủ lưu trữ mới được trả về. Tuỳ chọn này sẽ KHÔNG loại trừ chuỗi công cụ đã phân giải.
Thẻ:build_file_semantics
- Giá trị 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 đóng bắc cầu của các mục tiêu được chỉ định. Tuỳ chọn này được dùng cho các lệnh truy vấn và cquery.
Đối với cquery, đầu vào cho tuỳ chọn này là mục tiêu mà tất cả các câu trả lời đều được xây dựng, do đó, tuỳ chọn này có thể ảnh hưởng đến cấu hình và hiệu ứng chuyển đổi. Nếu bạn không chỉ định tùy chọn này, thì các mục tiêu cấp cao nhất được coi 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ị lỗi nếu không thể tạo các mục tiêu được phân tích cú pháp từ biểu thức truy vấn bằng các tuỳ chọn cấp cao nhất.
Thẻ:loading_and_analysis
- Các tuỳ chọn kích hoạt tính năng tối ưu hoá thời gian xây dựng:
- Giá trị mặc định của
--[no]collapse_duplicate_defines
: "false" -
Khi được bật, các giá trị-xác định thừa sẽ bị xoá sớm trong bản dựng. Điều này giúp tránh làm mất bộ nhớ đệm phân tích một cách không cần thiết đối với một số loại bản dựng tương đương.
Thẻ:loading_and_analysis
,loses_incremental_state
- Giá trị mặc định của
--[no]experimental_filter_library_jar_with_program_jar
: "false" -
Lọc ProGuard ProgramJar để xoá mọi lớp cũng có trong LibraryJar.
Thẻ:action_command_lines
- Giá trị mặc định của
--[no]experimental_inmemory_dotd_files
: "true" -
Nếu được bật, các tệp C++ .d sẽ được truyền trực tiếp vào bộ nhớ từ các nút bản dựng từ xa thay vì được ghi vào ổ đĩa.
Thẻ:loading_and_analysis
,execution
,affects_outputs
,experimental
- Giá trị mặc định của
--[no]experimental_inmemory_jdeps_files
: "true" -
Nếu bạn bật chính sách này, các tệp phụ thuộc (.jdeps) được tạo qua quá trình biên dịch Java sẽ được truyền trực tiếp vào bộ nhớ qua các nút bản dựng từ xa thay vì được ghi vào ổ đĩa.
Thẻ:loading_and_analysis
,execution
,affects_outputs
,experimental
- Giá trị mặc định của
--[no]experimental_objc_include_scanning
: "false" -
Liệu có thực hiện việc quét tìm C/C++ mục tiêu hay không.
Thẻ:loading_and_analysis
,execution
,changes_inputs
- Giá trị mặc định của
--[no]experimental_parse_headers_skipped_if_corresponding_srcs_found
: "false" -
Nếu được bật, tính năng parse_headers sẽ không tạo hành động biên dịch tiêu đề riêng biệt nếu tìm thấy một nguồn có cùng tên cơ sở ở cùng một đích.
Thẻ:loading_and_analysis
,affects_outputs
- Giá trị mặc định của
--[no]experimental_retain_test_configuration_across_testonly
: "false" -
Khi được bật, --trim_test_configuration sẽ không cắt cấu hình kiểm thử cho các quy tắc được đánh dấu testonly=1. Điều này nhằm giảm các vấn đề xung đột hành động khi quy tắc không phải kiểm thử phụ thuộc vào quy tắc cc_test. Không có hiệu lực nếu --trim_test_configuration là false.
Thẻ:loading_and_analysis
,loses_incremental_state
- Giá trị mặc định của
--[no]experimental_starlark_cc_import
: "false" -
Nếu bật tuỳ chọn này, bạn có thể sử dụng phiên bản Starlark của cc_import.
Thẻ:loading_and_analysis
,experimental
- Giá trị mặc định của
--[no]experimental_unsupported_and_brittle_include_scanning
: "false" -
Liệu có thu hẹp dữ liệu đầu vào trong quá trình biên dịch C/C++ bằng cách phân tích cú pháp các dòng #include từ tệp đầu vào hay không. Điều này có thể cải thiện hiệu suất và mức độ gia tăng bằng cách giảm kích thước của cây đầu vào biên dịch. Tuy nhiên, việc này cũng có thể phá vỡ các bản dựng vì trình quét bao gồm không triển khai đầy đủ ngữ nghĩa của bộ tiền xử lý C. Cụ thể, phương thức này không hiểu các lệnh #include động 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. Chúng tôi sẽ đóng mọi vấn đề liên quan đến cờ này.
Thẻ:loading_and_analysis
,execution
,changes_inputs
- Giá trị mặc định của
--[no]incremental_dexing
: "true" -
Thực hiện hầu hết thao tác để tạo tệp dex riêng biệt cho từng tệp Jar.
Thẻ:affects_outputs
,loading_and_analysis
,loses_incremental_state
- Giá trị mặc định của
--[no]objc_use_dotd_pruning
: "true" -
Nếu được đặt, các tệp .d do clang phát ra sẽ được dùng để cắt giảm tập hợp các dữ liệu đầu vào được truyền vào mục biên dịch objc.
Thẻ:changes_inputs
,loading_and_analysis
- Giá trị mặc định của
--[no]process_headers_in_dependencies
: "false" -
Khi tạo //a:a mục tiêu, hãy xử lý tiêu đề trong tất cả các mục tiêu mà //a:a phụ thuộc (nếu bạn bật tính năng xử lý tiêu đề cho chuỗi công cụ).
Thẻ:execution
- Giá trị mặc định của
--[no]trim_test_configuration
: "true" -
Khi được bật, các tuỳ chọn liên quan đến thử nghiệm 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 các chương trình kiểm thử dưới dạng phần phụ thuộc của quy tắc không kiểm thử, nhưng việc thay đổi các tuỳ chọn liên quan đến hoạt động kiểm thử sẽ không làm cho các quy tắc không kiểm thử bị phân tích lại.
Thẻ:loading_and_analysis
,loses_incremental_state
- Giá trị mặc định của
--[no]use_singlejar_apkbuilder
: "true" -
Tuỳ chọn này không được dùng nữa. Trang này hiện không hoạt động và sẽ sớm bị xoá.
Thẻ:loading_and_analysis
- Các lựa chọn ảnh hưởng đến độ chi tiết, định dạng hoặc vị trí ghi nhật ký:
- Giá trị 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. Biểu thức này được kiểm tra theo 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 đó sẽ đánh dấu riêng từng biểu thức chính quy. Lưu ý: Kết quả của cờ này rất phức tạp và có thể sẽ chỉ hữu ích cho các chuyên gia trong việc phân giải chuỗi công cụ.
Thẻ:terminal_output
- Các tuỳ chọn chỉ định hoặc thay đổi dữ liệu đầu vào chung cho lệnh Bazel không thuộc các danh mục khác.:
--flag_alias=<a 'name=value' flag alias>
lần dùng được tích luỹ-
Đặt tên viết tắt cho cờ Starlark. Hàm này cần một cặp khoá-giá trị có dạng "<key>=<value>" làm đối số.
Thẻ:changes_inputs
- Giá trị mặc định của
--[no]incompatible_default_to_explicit_init_py
: "false" -
Cờ này thay đổi hành vi mặc định để các tệp __init__.py không còn được tạo tự động trong các tệp chạy của mục tiêu Python nữa. Chính xác là khi một mục tiêu py_binary hoặc py_test có legacy_create_init được đặt thành "auto" (mặc định), thì hàm này được coi là sai khi và chỉ khi cờ này được đặt. Hãy truy cập vào https://github.com/bazelbuild/bazel/issues/10076.
Thẻ:affects_outputs
,incompatible_change
- Giá trị mặc định của
--[no]incompatible_py2_outputs_are_suffixed
: "true" -
Nếu đúng, các mục tiêu được tạo trong cấu hình Python 2 sẽ xuất hiện dưới một gốc đầu ra bao gồm 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 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 tiện lợi "bazel-bin" sẽ trỏ đến các mục tiêu Python 3 thay vì Python 2. Nếu bật tuỳ chọn này, bạn cũng nên bật "--incompatible_py3_is_default".
Thẻ:affects_outputs
,incompatible_change
- Giá trị mặc định của
--[no]incompatible_py3_is_default
: "true" -
Nếu đúng, các mục tiêu "py_binary" và "py_test" không đặt thuộc tính "python_version" (hoặc "default_python_version") sẽ được đặt mặc định thành PY3 thay vì PY2. Nếu đặt cờ này, bạn cũng nên đặt "--incompatible_py2_outputs_are_suffixed".
Thẻ:loading_and_analysis
,affects_outputs
,incompatible_change
- Giá trị mặc định của
--[no]incompatible_use_python_toolchains
: "true" -
Nếu bạn đặt thành true, các quy tắc Python gốc có thể thực thi sẽ sử dụng 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ũ cung cấp như --python_top.
Thẻ:loading_and_analysis
,incompatible_change
- Mặc định
--python_version=<PY2 or PY3>
: xem nội dung mô tả -
Chế độ phiên bản lớn Python, có thể là "PY2" hoặc "PY3". Lưu ý rằng các mục tiêu 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) do đó, thường không có nhiều lý do để cung cấp cờ này.
Thẻ:loading_and_analysis
,affects_outputs
,explicit_in_output_path
- Các lựa chọn khác, không được phân loại theo cách khác.:
--[no]cache_test_results
[-t
] mặc định: "tự động"- Nếu được đặt thành "auto", Bazel sẽ chạy lại một kiểm thử khi: (1) Bazel phát hiện các thay đổi trong kiểm thử hoặc các phần phụ thuộc của nó, (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 "yes", thì Bazel sẽ lưu mọi kết quả kiểm thử vào bộ nhớ đệm, ngoại trừ những lượt kiểm thử được đánh dấu là bên ngoài. Nếu bạn đặt thành "no", Bazel sẽ không lưu kết quả kiểm thử vào bộ nhớ đệm.
- Giá trị mặc định của
--[no]experimental_cancel_concurrent_tests
: "false" -
Nếu đúng, thì Blaze sẽ huỷ đồng thời các kiểm thử đang chạy trong lần chạy thành công đầu tiên. Điều này chỉ hữu ích khi kết hợp với --runs_per_test_detects_flakes.
Thẻ:affects_outputs
,loading_and_analysis
- Giá trị mặc định của
--[no]experimental_fetch_all_coverage_outputs
: "false" -
Nếu đúng, 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
- Giá trị mặc định của
--[no]experimental_generate_llvm_lcov
: "false" -
Nếu đúng, mức độ phù hợp cho clang sẽ tạo báo cáo LCOV.
Thẻ:affects_outputs
,loading_and_analysis
- Giá trị mặc định của
--[no]experimental_j2objc_header_map
: "true" - Liệu có tạo bản đồ tiêu đề J2ObjC song song với quá trình chuyển đổi J2ObjC hay không.
- Giá trị mặc định của
--[no]experimental_j2objc_shorter_header_path
: "false" -
Liệu có tạo bằng đường dẫn tiêu đề ngắn hơn hay không (sử dụng "_ios" thay vì "_j2objc").
Thẻ:affects_outputs
- Giá trị mặc định của
--experimental_java_classpath=<off, javabuilder or bazel>
: "javabuilder" - Bật đường dẫn lớp giảm bớt cho quá trình biên dịch Java.
- Giá trị mặc định của
--[no]experimental_limit_android_lint_to_android_constrained_java
: "false" -
Giới hạn --experimental_run_android_lint_on_java_rules ở các thư viện tương thích với Android.
Thẻ:affects_outputs
- Giá trị mặc định của
--[no]experimental_run_android_lint_on_java_rules
: "false" -
Liệu có xác thực nguồn java_* hay không.
Thẻ:affects_outputs
- Giá trị mặc định của
--[no]explicit_java_test_deps
: "false" - Chỉ định rõ ràng phần phụ thuộc cho JUnit hoặc Hamcrest trong java_test thay vì vô tình lấy được từ phần phụ thuộc của TestRunner. Hiện chỉ áp dụng cho bazel.
- Mặc định
--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.
--host_javacopt=<a string>
lần dùng được tích luỹ- Các tuỳ chọn bổ sung để truyền sang javac khi tạo các công cụ được thực thi trong quá trình dựng.
--host_jvmopt=<a string>
lần dùng được tích luỹ- Các tuỳ chọn bổ sung để truyền sang máy ảo Java khi xây dựng các công cụ được thực thi trong quá trình dựng. Các tuỳ chọn này sẽ được thêm vào tuỳ chọn khởi động máy ảo của từng mục tiêu java_binary.
- Giá trị mặc định của
--[no]incompatible_exclusive_test_sandboxed
: "false" -
Nếu đúng, các thử nghiệm độc quyền sẽ chạy với chiến lược hộp cát. Thêm "local" để buộc chạy kiểm thử độc quyền trên máy
Thẻ:incompatible_change
- Giá trị mặc định của
--[no]incompatible_strict_action_env
: "false" -
Nếu đúng, Bazel sử dụng một môi trường có giá trị tĩnh cho PATH và không kế thừa LD_ từng_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ừ máy khách, 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
--j2objc_translation_flags=<comma-separated list of options>
lần dùng được tích luỹ- Các tuỳ chọn bổ sung để chuyển sang công cụ J2ObjC.
--java_debug
-
Khiến máy ảo Java của một chương trình kiểm thử java đợ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
- Giá trị mặc định của
--[no]java_deps
: "true" - Tạo thông tin về phần phụ thuộc (hiện tại là đường dẫn lớp thời gian biên dịch) theo mục tiêu Java.
- Giá trị mặc định của
--[no]java_header_compilation
: "true" - Biên dịch ijar trực tiếp từ nguồn.
- Giá trị mặc định của
--java_language_version=<a string>
: "8" - Phiên bản ngôn ngữ Java
- Mặc định
--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 bạn đặt cờ này thành chuỗi trống, thì trình chạy JDK sẽ được sử dụng. "Trình chạy" sẽ ghi đè cờ này.
- Giá trị mặc định của
--java_runtime_version=<a string>
: "local_jdk" - Phiên bản thời gian chạy Java
--javacopt=<a string>
lần dùng được tích luỹ- Các tuỳ chọn bổ sung để chuyển sang javac.
--jvmopt=<a string>
lần dùng được tích luỹ- Các tuỳ chọn bổ sung để chuyển sang máy ảo Java. Các tuỳ chọn này sẽ được thêm vào tuỳ chọn khởi động máy ảo của từng mục tiêu java_binary.
- Mặc định
--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ũ.
--plugin=<a build target label>
lần dùng được tích luỹ- Trình bổ trợ để sử dụng trong bản dựng. Hiện hoạt động với java_plugin.
- Mặc định
--proguard_top=<a build target label>
: xem nội dung mô tả - Chỉ định phiên bản ProGuard dùng để xoá mã khi tạo 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 các proto 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 proto j2objc
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 các proto Java
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 các proto JavaLite
Thẻ:affects_outputs
,loading_and_analysis
--protocopt=<a string>
lần dùng được tích luỹ-
Các tuỳ chọn khác để truyền đến trình biên dịch protobuf.
Thẻ:affects_outputs
- Giá trị mặc định của
--[no]runs_per_test_detects_flakes
: "false" - Nếu đúng, bất kỳ phân đoạn nào trong đó có ít nhất một lần chạy/lần chạy và ít nhất một lần chạy/thử không thành công sẽ có trạng thái FLAKY.
- Mặc định
--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 đó. Nếu bạn không đặt chính sách nào, Bazel sẽ sử dụng đường dẫn mặc định được cố định giá trị trong mã, tuỳ thuộc vào hệ điều hành mà ứng dụng chạy (Windows: c:/tools/msys64/usr/bin/bash.exe, FreeBSD: /usr/local/bin/bash, tất cả các hệ điều hành khác: /bin/bash). Lưu ý rằng việc sử dụng một shell không tương thích với tính năng bash có thể dẫn đến lỗi bản dựng hoặc lỗi thời gian chạy của tệp nhị phân đã tạo.
Thẻ:loading_and_analysis
--test_arg=<a string>
lần dùng được tích luỹ- Chỉ định các tuỳ chọn và đối số bổ sung cần được truyền đến tệp thực thi kiểm thử. Có thể sử dụng nhiều lần để chỉ định một số đối số. Nếu thực thi nhiều kiểm thử, mỗi lượt kiểm thử sẽ nhận được các đối số giống hệt nhau. Chỉ được dùng trong "thử nghiệm bazel" .
- Mặc định
--test_filter=<a string>
: xem nội dung mô tả - Chỉ định một bộ lọc để chuyển tiếp đến khung thử nghiệm. Dùng để giới hạn hoạt động kiểm thử. Xin lưu ý rằng điều này không ảnh hưởng đến việc tạo mục tiêu nào.
- Giá trị mặc định của
--test_result_expiration=<an integer>
: "-1" - Lựa chọn này không còn được dùng nữa và không có hiệu lực.
- Giá trị mặc định của
--[no]test_runner_fail_fast
: "false" - Lựa 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ử cần ngừng thực thi khi gặp lỗi đầu tiên.
- Giá trị mặc định của
--test_sharding_strategy=<explicit or disabled>
: "explicit" - Chỉ định chiến lược để phân đoạn kiểm thử: "explicit" để chỉ sử dụng phân đoạn nếu thuộc tính 'shard_count' Có thuộc tính BUILD. "đã tắt" không bao giờ sử dụng tính năng phân đoạn kiểm thử.
- Giá trị mặc định của
--tool_java_language_version=<a string>
: "8" - Phiên bản ngôn ngữ Java dùng để thực thi các công cụ cần thiết trong quá trình tạo bản dựng
- Giá trị 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 tạo bản dựng
- Giá trị mặc định của
--[no]use_ijars
: "true" - Nếu được bật, tuỳ chọn này sẽ khiến quá trình biên dịch Java sử dụng các tệp giao diện người dùng. Điều này sẽ giúp quá trình biên dịch gia tăng nhanh hơn nhưng các thông báo lỗi có thể khác nhau.
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:
--distdir=<a path>
lần dùng được tích luỹ-
Các nơi khác để tìm kiếm các bản lưu trữ trước khi truy cập vào mạng để tải các bản lưu trữ đó xuống.
Thẻ:bazel_internal_configuration
- Giá trị mặc định của
--[no]experimental_repository_cache_hardlinks
: "false" -
Nếu được thiết lập, bộ nhớ đệm của kho lưu trữ sẽ liên kết cứng tệp trong trường hợp có lượt truy cập bộ nhớ đệm, thay vì sao chép. Thao tác này nhằm tiết kiệm dung lượng ổ đĩa.
Thẻ:bazel_internal_configuration
- Giá trị mặc định của
--[no]experimental_repository_cache_urls_as_default_canonical_id
: "false" -
Nếu đúng, hãy sử dụng một chuỗi bắt nguồn từ URL của các tệp tải xuống từ kho lưu trữ dưới dạngcanonical_id nếu không được chỉ định. Điều này khiến URL thay đổi, dẫn đến việc tải xuống lại ngay cả khi bộ nhớ đệm chứa tệp tải xuống có cùng hàm băm. Bạn có thể sử dụng quy trình này để xác minh rằng các thay đổi về URL không làm hỏng các kho lưu trữ bị bộ nhớ đệm che khuất.
Thẻ:loading_and_analysis
,experimental
- Giá trị mặc định của
--[no]experimental_repository_disable_download
: "false" -
Nếu đã đặt, bạn sẽ không được phép tải các kho lưu trữ bên ngoài xuống.
Thẻ:experimental
- Giá trị mặc định của
--experimental_repository_downloader_retries=<an integer>
: "0" -
Số lần thử tải lại lỗi xuống tối đa. Nếu bạn đặt chính sách này thành 0, hoạt động thử lại sẽ bị tắt.
Thẻ:experimental
- Giá trị mặc định của
--experimental_scale_timeouts=<a double>
: "1" -
Điều chỉnh tỷ lệ tất cả thời gian chờ trong quy tắc kho lưu trữ Starlark theo hệ số này. Bằng cách này, các kho lưu trữ bên ngoài có thể hoạt động trên các máy chậm hơn dự kiến của tác giả quy tắc mà không cần thay đổi mã nguồn
Thẻ:bazel_internal_configuration
,experimental
- Giá trị mặc định của
--http_timeout_scaling=<a double>
: "1" -
Điều chỉnh tỷ lệ tất cả thời gian chờ liên quan đến lượt tải xuống http theo hệ số cho trước
Thẻ:bazel_internal_configuration
- Mặc định
--repository_cache=<a path>
: xem nội dung mô tả -
Chỉ định vị trí bộ nhớ đệm của các giá trị được tải xuống thu được trong quá trình tìm nạp kho lưu trữ bên ngoài. Chuỗi trống dưới dạng đối số yêu cầu tắt bộ nhớ đệm.
Thẻ:bazel_internal_configuration
- Các tuỳ chọn kiểm soát việc thực thi bản dựng:
- Giá trị mặc định của
--[no]check_up_to_date
: "false" -
Đừng thực hiện tạo, chỉ kiểm tra xem bản dựng đã được cập nhật hay chưa. Nếu tất cả các mục tiêu đều được cập nhật, thì bản dựng sẽ hoàn tất thành công. Nếu cần thực thi bất kỳ bước nào, thì hệ thống sẽ bá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ộ nên trì hoãn bao nhiêu mili giây, nếu quá trình thực thi từ xa nhanh hơn trong một bản dựng ít nhất một lần?
Thẻ:execution
,host_machine_resource_optimizations
--dynamic_local_strategy=<a '[name=]value1[,..,valueN]' assignment>
lần dùng được tích luỹ-
Các chiến lược cục bộ, theo thứ tự, để sử dụng cho cách ghi nhớ nhất định. Truyền "local" vì tính năng ghi nhớ đặt mặc định cho
các ghi nhớ không xác định. Dùng [mnemonic=]local_strategy[,local_strategy,...]
Thẻ:execution
,host_machine_resource_optimizations
--dynamic_remote_strategy=<a '[name=]value1[,..,valueN]' assignment>
lần dùng được tích luỹ-
Các chiến lược từ xa cần sử dụng cho những ghi nhớ nhất định. Truyền "remote" vì tính năng ghi nhớ đặt mặc định cho
các ghi nhớ không xác định. Sử dụng [mnemonic=]remote_strategy[,remote_strategy,...]
Thẻ:execution
,host_machine_resource_optimizations
- Giá trị mặc định của
--experimental_docker_image=<a string>
: "" -
Chỉ định tên hình ảnh Docker (ví dụ: "ubuntu:: mới nhất") sẽ dùng để thực thi một hành động ở dạng hộp cát khi sử dụng chiến lược Docker và hành động đó chưa có thuộc tính hình ảnh vùng chứa trong Remote_execution_properties trong phần mô tả nền tảng. Giá trị của cờ này được truyền nguyên văn vào "docker run", do đó, nó hỗ trợ cú pháp và cơ chế giống như chính Docker.
Thẻ:execution
- Giá trị mặc định của
--[no]experimental_docker_use_customized_images
: "true" -
Nếu được bật, hãy chèn uid và tốc độ 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 / kiểm thử của bạn phụ thuộc vào 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 không cần đến.
Thẻ:execution
- Giá trị mặc định của
--[no]experimental_dynamic_exclude_tools
: "true" -
Khi được thiết lập, các mục tiêu được tạo "cho công cụ" không bị thực thi động. Các mục tiêu như vậy rất khó có khả năng được tạo dần dần và do đó không đáng để chi tiêu chu kỳ cục bộ.
Thẻ:execution
,host_machine_resource_optimizations
- Giá trị mặc định của
--experimental_dynamic_local_load_factor=<a double>
: "0" -
Kiểm soát khối lượng tải từ quá trình thực thi động được đặt trên máy cục bộ. Cờ này điều chỉnh số lượng hành động trong quá trình thực thi động mà chúng tôi sẽ lên lịch đồng thời. Trạng thái này dựa trên số lượng CPU mà Blaze cho là còn trống và có thể được kiểm soát bằng cờ --local_cpu_resources.
Nếu cờ này là 0, tất cả các hành động sẽ được lên lịch cục bộ ngay lập tức. Nếu > 0, số lượng thao tác đượ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 có nhiều hành động đang chờ lên lịch. Điều này làm giảm tải trên máy cục bộ trong trường hợp bản dựng sạch, trong đó máy cục bộ không đóng góp nhiều.
Thẻ:execution
,host_machine_resource_optimizations
- Giá trị mặc định của
--experimental_dynamic_slow_remote_time=<An immutable length of time.>
: "0" -
Nếu >0, thời gian mà một hành động chạy động phải chỉ chạy từ xa trước khi chúng tôi ưu tiên thực thi cục bộ của hành động đó để tránh hết thời gian chờ từ xa. Việ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 đề thực thi từ xa.
Thẻ:execution
,host_machine_resource_optimizations
- Giá trị mặc định của
--[no]experimental_enable_docker_sandbox
: "false" -
Bật 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
--experimental_persistent_javac
-
Bật trình biên dịch Java ổn định thử nghiệm.
Mở rộng thành:
--strategy=Javac=worker
--strategy=JavaIjar=local
--strategy=JavaDeployJar=local
--strategy=JavaSourceJar=local
--strategy=Turbine=local
Thẻ:execution
thân mến!host_machine_resource_optimizations
- Giá trị 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">
: "0" -
Nếu là 0, hãy xoá cây hộp cát ngay khi tác vụ hoàn tất (khiến việc hoàn tất thao tác bị trì hoãn). Nếu giá trị lớn hơn 0, hãy thực thi việc xoá 3 phần tử như vậy trên một nhóm luồng không đồng bộ có kích thước 1 khi bản dựng đang chạy và tăng lên kích thước do cờ này chỉ định khi máy chủ ở trạng thái rảnh.
Thẻ:host_machine_resource_optimizations
,execution
- Mặc định của
--experimental_sandboxfs_path=<a string>
: "sandboxfs" -
Đường dẫn đến tệp nhị phân Sandboxfs để sử dụng khi --experimental_use_sandboxfs là true. Nếu một tên trần, hãy sử dụng tệp nhị phân đầu tiên của tên đó trong PATH.
Thẻ:host_machine_resource_optimizations
,execution
- Giá trị mặc định của
--[no]experimental_split_xml_generation
: "true" -
Nếu bạn đặt cờ này và một 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 biệt để tạo một tệp test.xml giả chứa nhật ký kiểm thử. Nếu không, Bazel sẽ tạo một test.xml trong hành động kiểm thử.
Thẻ:execution
- Giá trị mặc định của
--experimental_total_worker_memory_limit_mb=<an integer, 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ị tắt nếu tổng mức sử dụng bộ nhớ của tất cả worker vượt quá giới hạn.
Thẻ:execution
,host_machine_resource_optimizations
- Giá trị mặc định của
--[no]experimental_use_hermetic_linux_sandbox
: "false" -
Nếu bạn đặt chính sách này thành true, thì không gắn kết thư mục gốc, chỉ kết nối những gì được cung cấp cùng với Sandbox_add_label_pair. 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 với hộp cát. Nếu các tệp nhập thao tác nằm trên một hệ thống tệp khác với hộp cát, thì tệp nhập sẽ được sao chép.
Thẻ:execution
- Giá trị mặc định của
--[no]experimental_use_sandboxfs
: "false" -
Dùng hộp cát để tạo các thao tác execroot thay vì tạo cây liên kết tượng trưng. Nếu "yes", tệp nhị phân do --experimental_sandboxfs_path cung cấp phải hợp lệ và tương ứng với phiên bản Sandboxfs được hỗ trợ. Nếu giá trị là "auto", tệp nhị phân có thể bị thiếu hoặc không tương thích.
Thẻ:host_machine_resource_optimizations
,execution
- Giá trị mặc định của
--[no]experimental_use_windows_sandbox
: "false" - Dùng hộp cát của Windows để chạy các thao tác. Nếu "yes", 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 giá trị là "auto", tệp nhị phân có thể bị thiếu hoặc không tương thích.
- Mặc định của
--experimental_windows_sandbox_path=<a string>
: "BazelSandbox.exe" - Đường dẫn đến tệp nhị phân hộp cát Windows để sử dụng khi --experimental_use_windows_sandbox là giá trị true. Nếu một tên trần, hãy sử dụng tệp nhị phân đầu tiên của tên đó trong PATH.
- Giá trị mặc định của
--[no]experimental_worker_as_resource
: "false" -
Nếu được bật, worker sẽ được thu nạp dưới dạng tài nguyên từ ResourceManager.
Thẻ:execution
,host_machine_resource_optimizations
- Giá trị mặc định của
--[no]experimental_worker_cancellation
: "false" -
Nếu được bật, Bazel có thể gửi yêu cầu huỷ đến các worker hỗ trợ mình.
Thẻ:execution
- Giá trị mặc định của
--[no]experimental_worker_multiplex
: "true" -
Nếu được bật, các worker hỗ trợ tính năng ghép kênh thử nghiệm sẽ sử dụng tính năng đó.
Thẻ:execution
,host_machine_resource_optimizations
- Giá trị mặc định của
--[no]experimental_worker_multiplex_sandboxing
: "false" -
Nếu bạn bật chính sách này, 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ó quyền "supports-multiplex-sandboxing" yêu cầu thực thi sẽ được đặt trong hộp cát.
Thẻ:execution
- Giá trị mặc định của
--[no]experimental_worker_strict_flagfiles
: "false" -
Nếu được bật, các đối số hành động cho worker không tuân thủ thông số kỹ thuật của worker sẽ gây ra lỗi. Đối số Worker phải có đúng một đối số @flagfile làm đối số cuối cùng trong danh sách các đối số.
Thẻ:execution
- Giá trị mặc định của
--genrule_strategy=<comma-separated list of options>
: "" -
Chỉ định cách thực thi 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ả hành động hoặc --strategy=Gen giọng=<value> để chỉ kiểm soát genrules.
Thẻ:execution
--high_priority_workers=<a string>
lần dùng được tích luỹ-
Ghi nhớ của worker để chạy với mức độ ưu tiên cao. Khi trình thực thi có mức độ ưu tiên cao đang chạy, tất cả các trình thực thi khác sẽ bị điều tiết.
Thẻ:execution
- Giá trị mặc định của
--[no]incompatible_remote_dangling_symlinks
: "true" -
Nếu bạn đặt chính sách này thành true và đặt giá trị --incompatible_remote_symlinks cũng là true, các đường liên kết tượng trưng trong dữ liệu đầu ra của hành động sẽ được phép treo.
Thẻ:execution
,incompatible_change
- Giá trị mặc định của
--[no]incompatible_remote_symlinks
: "true" -
Nếu bạn đặt chính sách này thành true, thì Bazel sẽ biểu thị các đường liên kết tượng trưng trong dữ liệu đầu ra của hành động trong giao thức lưu vào bộ nhớ đệm/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à được thể hiện dưới dạng tệp hoặc thư mục. Xem #6631 để biết chi tiết.
Thẻ:execution
,incompatible_change
- Giá trị mặc định của
--[no]incompatible_sandbox_hermetic_tmp
: "false" -
Nếu bạn đặt chính sách này thành true, thì mỗi hộp cát của Linux sẽ có một thư mục trống riêng được gắn kết dưới dạng /tmp thay vìsharing /tmp với hệ thống tệp của máy chủ lưu trữ. Sử dụng --sandbox_add_ Mua_pair=/tmp để tiếp tục xem /tmp của máy chủ trong tất cả các hộp cát.
Thẻ:execution
- Giá trị mặc định của
--[no]internal_spawn_scheduler
: "false" -
Tuỳ chọn phần giữ chỗ để chúng ta có thể biết trong Blaze liệu trình lập lịch biểu sinh ra đã được bật hay chưa.
Thẻ:execution
,host_machine_resource_optimizations
--jobs=<an integer, or a keyword ("auto", "HOST_CPUS", "HOST_RAM"), optionally followed by an operation ([-|*]<float>) eg. "auto", "HOST_CPUS*.5">
[-j
] mặc định: "tự động"-
Số công việc đồng thời cần chạy. Lấy một số nguyên hoặc một từ khoá ("auto", "HOST_CPUS", "HOST_RAM"), theo sau không bắt buộc bởi một thao tác ([-|*]<float>), ví dụ: "tự động", "HOST_CPUS*.5". Giá trị phải nằm trong khoảng từ 1 đến 5000. Các giá trị trên 2500 có thể gây ra vấn đề về bộ nhớ. "tự động" tính toán giá trị mặc định hợp lý dựa trên tài nguyên máy chủ.
Thẻ:host_machine_resource_optimizations
,execution
--[no]keep_going
[-k
] mặc định: "false"-
Hãy tiếp tục nhiều nhất có thể sau khi gặp lỗi. Mặc dù không thể phân tích mục tiêu không thành công và những mục tiêu phụ thuộc vào nó, nhưng có thể có các điều kiện tiên quyết khác cho những mục tiêu này.
Thẻ:eagerness_to_exit
- Giá trị mặc định của
--loading_phase_threads=<an integer, or a keyword ("auto", "HOST_CPUS", "HOST_RAM"), optionally followed by an operation ([-|*]<float>) eg. "auto", "HOST_CPUS*.5">
: "tự động" -
Số lượng luồng song song để sử 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 bởi một thao tác ([-|*]<float>), ví dụ: "tự động", "HOST_CPUS*.5". "tự động" đặt giá trị mặc định hợp lý dựa trên tài nguyên máy chủ lưu trữ. Phải ít nhất là 1.
Thẻ:bazel_internal_configuration
- Giá trị mặc định của
--[no]reuse_sandbox_directories
: "false" -
Nếu bạn đặt chính sách này thành true, thì hệ thống có thể sử dụng lại các thư mục dùng trong quá trình thực thi hộp cát không có trình thực thi để tránh chi phí thiết lập không cần thiết.
Thẻ:host_machine_resource_optimizations
,execution
- Giá trị 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 nhiều khi bản dựng / kiểm thử của bạn có nhiều tệp đầu vào. Lưu ý: Bạn cần có đủ RAM và dung lượng trống trên tmpfs để lưu 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
- Giá trị mặc định của
--[no]sandbox_explicit_pseudoterminal
: "false" -
Bật tính năng tạo giả lập cho các hành động có 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 thiết bị đầu cuối giả lập hoạt động. Nếu việc này gây ra vấn đề, bạn có thể tắt cờ này để cho phép sử dụng các nhóm khác.
Thẻ:execution
--sandbox_tmpfs_path=<an absolute path>
lần dùng được tích luỹ-
Đối với các thao tác trong hộp cát, hãy gắn một thư mục trống, có thể ghi tại đường dẫn tuyệt đối này (nếu quá trình triển khai hộp cát hỗ trợ, sẽ bị bỏ qua nếu không).
Thẻ:host_machine_resource_optimizations
,execution
- Giá trị mặc định của
--spawn_strategy=<comma-separated list of options>
: "" -
Chỉ định cách thực thi các thao tác tạo ra 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 thi hành động đó. Giá trị mặc định là "remote,worker,sandboxed,local". Hãy truy cập https://blog.bazel.build/2019/06/19/list-strategy.html để biết thông tin chi tiết.
Thẻ:execution
--strategy=<a '[name=]value1[,..,valueN]' assignment>
lần dùng được tích luỹ-
Chỉ định cách phân phối dữ liệu biên dịch của các thao tác spawn 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 thi 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à --genrules_strategy nếu dùng với Gen quy tắc ghi nhớ). Hãy truy cập https://blog.bazel.build/2019/06/19/list-strategy.html để biết thông tin chi tiết.
Thẻ:execution
--strategy_regexp=<a '<RegexFilter>=value[,value]' assignment>
lần dùng được tích luỹ-
Ghi đè chiến lược sinh ra nên dùng để thực thi các hành động tạo ra có nội dung mô tả khớp với một biểu thức chính quy_bộ lọc nhất định. Hãy xem --per_file_copt để biết thông tin chi tiết về việc so khớp onregex_filter. Hệ thống sẽ sử dụng biểu thức chính quy đầu tiên 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 nghĩa là chạy các hành động bằng chiến lược cục bộ nếu nội dung mô tả của các hành động đó khớp với //foo.*.cc nhưng không khớp với //foo/bar. Ví dụ: --strategy_regexp='Comp dương.*/bar=local --strategy_regexp=Comp dương=sandboxed sẽ chạy 'Biên dịch //foo/bar/baz' với từ khoá 'local' nhưng đảo ngược thứ tự sẽ chạy lệnh với "sandboxed" (hộp cát).
Thẻ:execution
--worker_extra_flag=<a 'name=value' assignment>
lần dùng được tích luỹ-
Các cờ lệnh bổ sung sẽ được truyền đến các quy trình của worker ngoài --persistent_worker, được khoá bằng tính năng ghi nhớ (ví dụ: --worker_extra_flag=Javac=--debug.
Thẻ:execution
,host_machine_resource_optimizations
--worker_max_instances=<[name=]value, where value is an integer, or a keyword ("auto", "HOST_CPUS", "HOST_RAM"), optionally followed by an operation ([-|*]<float>) eg. "auto", "HOST_CPUS*.5">
lần dùng được tích luỹ-
Số lượng thực thể của một quy trình worker (như trình biên dịch Java cố định) có thể được khởi chạy nếu bạn sử dụng "worker" chiến lược. Có thể được chỉ định là [name=value] để cung cấp một giá trị khác cho mỗi mức ghi nhớ của worker. Lấy một số nguyên hoặc một từ khoá ("auto", "HOST_CPUS", "HOST_RAM"), theo sau không bắt buộc bởi một thao tác ([-|*]<float>), ví dụ: "tự động", "HOST_CPUS*.5". "tự động" sẽ tính toán giá trị mặc định hợp lý dựa trên công suất của máy. "=giá trị" đặt chế độ ghi nhớ mặc định.
Thẻ:execution
,host_machine_resource_optimizations
--worker_max_multiplex_instances=<[name=]value, where value is an integer, or a keyword ("auto", "HOST_CPUS", "HOST_RAM"), optionally followed by an operation ([-|*]<float>) eg. "auto", "HOST_CPUS*.5">
lần dùng được tích luỹ-
Số lượng WorkRequest mà một quy trình của worker ghép nối có thể nhận được song song nếu bạn sử dụng "worker" này với --Thử nghiệm_worker_multiplex. Có thể được chỉ định là [name=value] để cung cấp một giá trị khác cho mỗi mức ghi nhớ của worker. Lấy một số nguyên hoặc một từ khoá ("auto", "HOST_CPUS", "HOST_RAM"), theo sau không bắt buộc bởi một thao tác ([-|*]<float>), ví dụ: "tự động", "HOST_CPUS*.5". "tự động" sẽ tính toán giá trị mặc định hợp lý dựa trên công suất của máy. "=giá trị" đặt chế độ ghi nhớ mặc định.
Thẻ:execution
,host_machine_resource_optimizations
- Giá trị mặc định của
--[no]worker_quit_after_build
: "false" -
Nếu được bật, tất cả worker sẽ thoát sau khi hoàn tất một quá trình tạo bản dựng.
Thẻ:execution
,host_machine_resource_optimizations
- Giá trị mặc định của
--[no]worker_sandboxing
: "false" -
Nếu được bật, worker sẽ được thực thi trong một môi trường hộp cát.
Thẻ:execution
- Giá trị mặc định của
--[no]worker_verbose
: "false" - Nếu được bật, sẽ in các thông báo chi tiết khi worker khởi động, tắt máy, v.v.
- Các tuỳ chọn định cấu hình chuỗi công cụ dùng để thực thi hành động:
- Giá trị mặc định của
--[no]incompatible_disable_runtimes_filegroups
: "false" -
Không dùng nữa.
Thẻ:action_command_lines
,loading_and_analysis
,deprecated
,incompatible_change
- Giá trị mặc định của
--[no]incompatible_dont_emit_static_libgcc
: "true" -
Không dùng nữa.
Thẻ:action_command_lines
,loading_and_analysis
,deprecated
,incompatible_change
- Giá trị mặc định của
--[no]incompatible_linkopts_in_user_link_flags
: "true" -
Không dùng nữa.
Thẻ:action_command_lines
,loading_and_analysis
,deprecated
,incompatible_change
- Các tuỳ chọn kiểm soát kết quả của lệnh:
- Giá trị mặc định của
--[no]build
: "true" -
Thực thi bản dựng; đây là hành vi thông thường. Việc chỉ định --nobuild sẽ khiến bản dựng dừng trước khi thực thi các 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 rất hữu ích khi thử nghiệm các giai đoạn đó.
Thẻ:execution
,affects_outputs
- Giá trị mặc định của
--[no]experimental_run_validations
: "true" -
Thay vào đó, hãy sử dụng --run_verifications.
Thẻ:execution
,affects_outputs
- Giá trị mặc định của
--[no]experimental_use_validation_aspect
: "false" -
Liệu có chạy hành động xác thực bằng cách sử dụng khía cạnh (để phát triển song song với kiểm thử) hay không.
Thẻ:execution
,affects_outputs
--output_groups=<comma-separated list of options>
lần dùng được tích luỹ-
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 nhóm đầu ra có tiền tố + hoặc - (không bắt buộc). Một nhóm có tiền tố + 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ỉ tạo foo và bar.
Thẻ:execution
,affects_outputs
- Giá trị mặc định của
--[no]run_validations
: "true" -
Liệu có chạy các thao tác xác thực trong quá trình tạo bản dựng hay không. Hãy xem tại https://bazel.build/rules/rules#attributes_ actions
Thẻ:execution
,affects_outputs
- Các tuỳ chọn cho phép người dùng định cấu hình đầu ra dự kiến, trái ngược với sự tồn tại của kết quả đó:
--aspects=<comma-separated list of options>
lần dùng được tích luỹ- Danh sách các khía cạnh được phân tách bằng dấu phẩy sẽ được áp dụng cho các 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 qua required_aspect_providers, thì some_aspect sẽ chạy sau mọi khía cạnh được đề cập trước đó trong danh sách khía cạnh mà nhà cung cấp được quảng cáo đáp ứng một số nhà cung cấp khía cạnh bắt buộc. Hơn nữa, some_aspect sẽ chạy sau tất cả các khía cạnh bắt buộc do thuộc tính yêu cầu chỉ định. some_aspect sau đó sẽ có quyền truy cập vào giá trị của các khía cạnh đó Google Cloud. <bzl-file-label>%<aspect_name>, ví dụ: '//tools:my_def.bzl%my_aspect', trong đó 'my_aspect' là giá trị cấp cao nhất từ tệp tools/my_def.bzl
- Giá trị mặc định của
--bep_maximum_open_remote_upload_files=<an integer>
: "-1" -
Số lượng tệp tối đa đang mở được cho phép trong quá trình tải cấu phần phần mềm BEP lên.
Thẻ:affects_outputs
- Mặc định của
--[no]experimental_convenience_symlinks
: "bình thường" -
Cờ này kiểm soát cách quản lý các đường liên kết tượng trưng 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 bản dựng). Các giá trị có thể có:
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 liên kết tượng trưng sẽ bị xoá vô điều kiện.
bỏ qua: Đường liên kết ký hiệu sẽ được để lại.
log_only: Tạo thông điệp nhật ký như thể "normal" (bình thường) được chuyển nhưng không thực sự thực hiện bất kỳ thao tác nào đối với hệ thống tệp (hữu ích cho các công cụ).
Xin lưu ý rằng chỉ các đường liên kết tượng trưng có tên được tạo bằng giá trị hiện tại của --symlink_prefix mới có thể bị ảnh hưởng; nếu tiền tố thay đổi, mọi liên kết tượng trưng có sẵn sẽ được để nguyên.
Thẻ:affects_outputs
- Giá trị mặc định của
--[no]experimental_convenience_symlinks_bep_event
: "false" -
Cờ này kiểm soát việc chúng tôi có đăng sự kiện bản dựng tiện ích SymlinksIdentified lên BuildEventProtocol hay không. Nếu giá trị này là true, BuildEventProtocol sẽ có một mục cho tiện íchSymlinksIdentified, liệt kê tất cả các symlink 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, mục tiện íchSymlinksIdentified trong BuildEventProtocol sẽ bị trống.
Thẻ:affects_outputs
--experimental_multi_cpu=<comma-separated list of options>
lần dùng được tích luỹ-
Không được dùng nữa. Không hoạt động.
Thẻ:affects_outputs
,experimental
--remote_download_minimal
-
Không tải bất kỳ kết quả của bản dựng từ xa nào xuống máy cục bộ. Cờ này là lối tắt cho các cờ: --experimental_inmemory_jdeps_files, --experimental_inmemory_dotd_files, --experimental_action_cache_store_output_metadata và --remote_download_outputs=minimal.
Mở rộng thành:
--nobuild_runfile_links
--experimental_inmemory_jdeps_files
--experimental_inmemory_dotd_files
--experimental_action_cache_store_output_metadata
--remote_download_outputs=minimal
Thẻ:affects_outputs
- Mặc định của
--remote_download_outputs=<all, minimal or toplevel>
: "tất cả" -
Nếu được đặt thành "tối thiểu" 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 các hành động cục bộ yêu cầu. Nếu được đặt thành "cấp cao nhất" hành xử như "tối thiểu" ngoại trừ việc nó cũng tải kết quả của các mục tiêu cấp cao nhất xuống máy cục bộ. Cả hai tuỳ chọn đều có thể làm giảm đáng kể thời gian xây dựng nếu băng thông mạng gây tắc nghẽn.
Thẻ:affects_outputs
- Giá trị mặc định của
--remote_download_symlink_template=<a string>
: "" -
Thay vì tải dữ liệu đầu ra 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 đích của các đường liên kết tượng trưng dưới dạng chuỗi mẫu. Chuỗi mẫu này có thể chứa {hash} và {size_bytes} lần lượt mở rộng thành hàm băm của đối tượng và kích thước tính bằng byte. Ví dụ: những đườ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 đầ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à lối tắt cho các cờ: --experimental_inmemory_jdeps_files, --experimental_inmemory_dotd_files, --experimental_action_cache_store_output_metadata và --remote_download_outputs=toplevel.
Mở rộng thành:
--experimental_inmemory_jdeps_files
--experimental_inmemory_dotd_files
--experimental_action_cache_store_output_metadata
--remote_download_outputs=toplevel
Thẻ:affects_outputs
- Mặc định
--symlink_prefix=<a string>
: xem nội dung mô tả -
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 một bản dựng. Nếu bỏ qua, giá trị mặc định là tên của công cụ xây dựng, theo sau là dấu gạch nối. Nếu "/" thì sẽ không có liên kết tượng trưng nào được tạo và không đưa ra cảnh báo nào. Cảnh báo: chức năng đặc biệt cho '/' sẽ sớm không được dùng nữa; thay vào đó, hãy sử dụng --experimental_ Lienience_symlinks=ignore.
Thẻ:affects_outputs
- Các lựa chọn ảnh hưởng đến mức độ nghiêm ngặt của Bazel trong việc thực thi dữ liệu đầu vào bản dựng hợp lệ (định nghĩa quy tắc, tổ hợp cờ, v.v.):
- Giá trị mặc định của
--[no]experimental_docker_privileged
: "false" -
Nếu được bật, Bazel sẽ chuyển cờ --đặc quyền cho "docker run" khi thực hiện các thao tác. Bản dựng của bạn có thể yêu cầu phải thực hiện việc này, nhưng cũng có thể làm giảm tính khép kín.
Thẻ:execution
- Giá trị mặc định của
--experimental_repository_hash_file=<a string>
: "" -
Nếu giá trị không trống, hãy chỉ định tệp có chứa giá trị đã phân giải mà cần phải xác minh giá trị băm của thư mục kho lưu trữ
Thẻ:affects_outputs
,experimental
- Giá trị mặc định của
--[no]experimental_sandboxfs_map_symlink_targets
: "false" -
Nếu đúng, ánh xạ mục tiêu của các liên kết tượng trưng được chỉ định làm đầu vào hành động vào hộp cát. Tính năng này chỉ tồn tại để giải quyết các quy tắc lỗi không tự thực hiện việc này và phải được xoá sau khi tất cả các quy tắc đó được khắc phục.
Thẻ:host_machine_resource_optimizations
,execution
--experimental_verify_repository_rules=<a string>
lần dùng được tích luỹ-
Nếu danh sách các quy tắc kho lưu trữ mà hàm băm của thư mục đầu ra cần được xác minh, miễn là tệp được chỉ định bởi --experimental_repository_hash_file.
Thẻ:affects_outputs
,experimental
- Giá trị mặc định của
--[no]incompatible_legacy_local_fallback
: "true" -
Nếu bạn đặt chính sách này thành true, thì hệ thống sẽ bật tính năng 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 rồi trở thành không hoạt động. Thay vào đó, hãy sử dụng --strategy, --spawn_strategy hoặc --dynamic_local_strategy để định cấu hình dự phòng.
Thẻ:execution
,incompatible_change
--sandbox_add_mount_pair=<a single path or a 'source:target' pair>
lần dùng được tích luỹ-
Thêm cặp đường dẫn bổ sung để gắn kết trong hộp cát.
Thẻ:execution
--sandbox_block_path=<a string>
lần dùng được tích luỹ-
Đối với các thao tác trong môi trường hộp cát, hãy không cho phép truy cập vào đường dẫn này.
Thẻ:execution
- Giá trị mặc định của
--[no]sandbox_default_allow_network
: "true" - Cho phép truy cập mạng theo mặc định đối với các thao tác; điều này có thể không hoạt động với tất cả các cách triển khai hộp cát.
- Giá trị mặc định của
--[no]sandbox_fake_hostname
: "false" -
Thay đổi tên máy chủ hiện tại thành 'localhost' cho các thao tác có dạng hộp cát.
Thẻ:execution
- Giá trị mặc định của
--[no]sandbox_fake_username
: "false" -
Thay đổi tên người dùng hiện tại thành "nobody" (không có ai) cho các thao tác có dạng hộp cát.
Thẻ:execution
--sandbox_writable_path=<a string>
lần dùng được tích luỹ-
Đối với các thao tác trong hộp cát, hãy đặt một thư mục hiện có có thể ghi trong hộp cát (nếu quá trình 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 các tệp BUILD, tệp .bzl hoặc tệp WORKSPACE.:
- Giá trị mặc định của
--[no]experimental_allow_top_level_aspects_parameters
: "true" -
Không hoạt động
Thẻ:no_op
,deprecated
,experimental
- Giá trị mặc định của
--[no]incompatible_config_setting_private_default_visibility
: "false" -
Nếu không tương thích_enforce_config_setting_ visibility=false, thì đây là lỗi không hiển thị. Ngược lại, nếu cờ này là false, mọi chế độ cài đặt config_setting không có thuộc tính mức độ hiển thị rõ ràng sẽ là //visibility:public. Nếu cờ này là true, chế độ cài đặt config_setting sẽ tuân theo cùng một logic về chế độ hiển thị như mọi quy tắc khác. Truy cập https://github.com/bazelbuild/bazel/issues/12933.
Thẻ:loading_and_analysis
,incompatible_change
- Giá trị mặc định của
--[no]incompatible_enforce_config_setting_visibility
: "true" -
Nếu là true, hãy thực thi các quy định hạn chế về chế độ hiển thị bằng lệnh config_setting. Nếu đặt là false, mọi chế độ cài đặt config_ đều hiển thị với mọi mục tiêu. Truy cập 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ử:
- Giá trị 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 kết quả đó đã được cập nhật hay chưa. Nếu tất cả kết quả kiểm thử đều là thông tin mới nhất, thì quá trình kiểm thử sẽ hoàn tất thành công. Nếu cần xây dựng hoặc thực thi kiểm 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
--flaky_test_attempts=<a positive integer, the string "default", or test_regex@attempts. This flag may be passed more than once>
lần dùng được tích luỹ-
Nếu có thất bại trong kiểm thử, hệ thống sẽ thử lại mỗi lượt kiểm thử theo số lần đã chỉ định. Những bài kiểm tra yêu cầu nhiều lần vượt qua sẽ được đánh dấu là "FLAKY" trong phần tóm tắt kiểm thử. Thông thường, giá trị được chỉ định chỉ là một số nguyên hoặc chuỗi "default". Nếu là số nguyên thì tất cả chương trình kiểm thử sẽ được chạy tối đa N lần. Nếu là "default" thì sẽ chỉ có một lần kiểm thử duy nhất được thực hiện cho các kiểm thử thông thường và ba lần kiểm thử cho các kiểm thử được đánh dấu rõ ràng là không ổn định theo quy tắc của chúng (thuộc tính không ổn định=1). Cú pháp thay thế: regex_filter@flaky_test_inappropriates. Trong đó flaky_test_attempts như trên và regex_filter đại diện cho danh sách các mẫu biểu thức chính quy bao gồm và loại trừ (Xem thêm --runs_per_test). Ví dụ: --flaky_test_attempts=//foo/.*,-//foo/bar/.*@3 deflakes tất cả các lượt kiểm thử trong //foo/, ngoại trừ những lượt kiểm thử dưới foo/bar ba lần. Bạn có thể bỏ qua lựa chọn này nhiều lần. Đối số được truyền gần đây nhất phù hợp sẽ được ưu tiên. Nếu không có kết quả nào phù hợp, thì hành vi sẽ như là "mặc định" ở trên.
Thẻ:execution
- Giá trị mặc định của
--local_test_jobs=<an integer, or a keyword ("auto", "HOST_CPUS", "HOST_RAM"), optionally followed by an operation ([-|*]<float>) eg. "auto", "HOST_CPUS*.5">
: "tự động" -
Số lượng công việc kiểm thử cục bộ tối đa để chạy đồng thời. Lấy một số nguyên hoặc một từ khoá ("auto", "HOST_CPUS", "HOST_RAM"), theo sau không bắt buộc bởi một thao tác ([-|*]<float>), ví dụ: "tự động", "HOST_CPUS*.5". 0 có nghĩa là tài nguyên cục bộ sẽ giới hạn số lượng công việc kiểm thử cục bộ để chạy đồng thời. Việc đặt giá trị này lớn hơn giá trị cho --jobs là không hiệu quả.
Thẻ:execution
- Giá trị mặc định của
--[no]test_keep_going
: "true" -
Khi bạn tắt, mọi hoạt động kiểm thử không vượt qua sẽ khiến toàn bộ bản dựng dừng lại. Theo mặc định, tất cả các bài kiểm thử đều được chạy, ngay cả khi một số bài kiểm thử không đạt.
Thẻ:execution
- Giá trị mặc định của
--test_strategy=<a string>
: "" -
Chỉ định chiến lược sẽ sử dụng khi chạy kiểm thử.
Thẻ:execution
- Mặc định
--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" để sử dụng.
- Các lựa chọn liên quan đến đầu ra và ngữ nghĩa Bzlmod:
--allow_yanked_versions=<a string>
lần dùng được tích luỹ-
Đã chỉ định các phiên bản mô-đun dưới dạng `<module1>@<version1>,<module2>@<version2>` sẽ được phép trong biểu đồ phần phụ thuộc đã phân giải ngay cả khi chúng được khai báo được kéo trong sổ đăng ký nơi chúng đến (nếu chúng không đến từ NonRegistryOverride). Nếu không, các phiên bản được kéo sẽ khiến quá trình phân giải bị lỗi. Bạn cũng có thể xác định phiên bản được kéo được phép bằng biến môi trường "BZLMOD_ALLOW_YANKED_VERSIONS". Bạn có thể vô hiệu hoá chế độ kiểm tra này bằng cách sử dụng từ khoá 'tất cả' (không nên dùng).
Thẻ:loading_and_analysis
- Giá trị 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" để báo cáo lỗi thành không giải quyết được, "tắt" để tắt tính năng kiểm tra hoặc "cảnh báo" để in một cảnh báo khi phát hiện thấy thông tin không khớp.
Thẻ:loading_and_analysis
- Giá trị 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 "bazel_dep" trực tiếp đượ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 đã phân giải hay không. Các giá trị hợp lệ là "off" để tắt tính năng kiểm tra, "warning" để in cảnh báo khi phát hiện thấy thông tin không khớp hoặc "error" để chuyển cảnh báo thành không giải quyết được.
Thẻ:loading_and_analysis
- Giá trị mặc định của
--[no]ignore_dev_dependency
: "false" -
Nếu đúng, Bazel sẽ bỏ qua phương thức "bazel_dep" và "use_extension" được khai báo là "dev_Dependencies" trong MODULE.bazel của mô-đun gốc. Lưu ý rằng các phần phụ thuộc dev đó 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
--override_module=<an equals-separated mapping of module name to path>
lần dùng được tích luỹ- Ghi đè mô-đun bằng thư mục cục bộ.
--registry=<a string>
lần dùng được tích luỹ-
Chỉ định sổ đăng ký cần sử dụng để xác định vị trí các phần phụ thuộc của mô-đun Bazel. Thứ tự này rất quan trọng: các mô-đun sẽ được tra cứu trong các sổ đăng ký trước đó trước và chỉ quay lại các sổ đăng ký sau đó nếu không có các mô-đun trước đó.
Thẻ:changes_inputs
- Các lựa chọn ảnh hưởng đến độ chi tiết, định dạng hoặc vị trí ghi nhật ký:
- Giá trị mặc định của
--[no]announce
: "false" -
Không được dùng nữa. Không hoạt động.
Thẻ:affects_outputs
- Giá trị mặc định của
--[no]debug_spawn_scheduler
: "false" - Giá trị mặc định của
--[no]experimental_bep_target_summary
: "false" - Liệu có xuất bản các sự kiện Targetsummary hay không.
- Giá trị mặc định của
--[no]experimental_build_event_expand_filesets
: "false" -
Nếu đúng, hãy mở rộng Filesets trong BEP khi trình bày các tệp đầu ra.
Thẻ:affects_outputs
- Giá trị mặc định của
--[no]experimental_build_event_fully_resolve_fileset_symlinks
: "false" -
Nếu là true, phân giải đầy đủ các đường liên kết tượng trưng tương đối trong Fileset trong BEP khi trình bày các tệp đầu ra. Cần có --experimental_build_event_expand_filesets.
Thẻ:affects_outputs
- Giá trị 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
- Giá trị mặc định của
--experimental_build_event_upload_retry_minimum_delay=<An immutable length of time.>
: "1 giây" -
Ban đầu, độ trễ tối thiểu cho các lần thử lại thời gian đợi luỹ thừa khi tải lên BEP không thành công. (số mũ: 1,6)
Thẻ:bazel_internal_configuration
- Mặc định
--experimental_build_event_upload_strategy=<a string>
: xem nội dung mô tả -
Chọn cách tải các cấu phần phần mềm lên được tham chiếu trong giao thức sự kiện bản dựng.
Thẻ:affects_outputs
- Giá trị mặc định của
--[no]experimental_collect_local_sandbox_action_metrics
: "true" -
Khi được bật, số liệu thống kê thực thi (chẳng hạn như thời gian của người dùng và hệ thống) sẽ được ghi lại cho những hành động được thực thi cục bộ sử dụng hộp cát
Thẻ:execution
- Giá trị mặc định của
--[no]experimental_docker_verbose
: "false" -
Nếu được bật, Bazel sẽ in các thông báo chi tiết hơn về chiến lược hộp cát Docker.
Thẻ:execution
- Giá trị mặc định của
--[no]experimental_materialize_param_files_directly
: "false" -
Nếu cụ thể hoá các tệp thông số, hãy thực hiện bằng cách ghi trực tiếp vào ổ đĩa.
Thẻ:execution
- Giá trị mặc định của
--[no]experimental_record_metrics_for_all_mnemonics
: "false" - Theo mặc định, số lượng loại hành động được giới hạn ở 20 bộ nhớ có số lượng hành động được thực thi lớn nhất. Việc đặt tuỳ chọn này sẽ ghi số liệu thống kê cho tất cả các bộ nhớ.
- Giá trị mặc định của
--experimental_repository_resolved_file=<a string>
: "" -
Nếu giá trị không trống, hãy viết một giá trị Starlark cùng với thông tin đã phân giải của tất cả các quy tắc kho lưu trữ Starlark đã được thực thi.
Thẻ:affects_outputs
- Giá trị mặc định của
--[no]experimental_stream_log_file_uploads
: "false" -
Phát trực tuyến tệp nhật ký tải lên trực tiếp vào bộ nhớ từ xa thay vì ghi vào ổ đĩa.
Thẻ:affects_outputs
- Mặc định
--explain=<a path>
: xem nội dung mô tả -
Yêu cầu 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
- Giá trị mặc định của
--[no]legacy_important_outputs
: "true" -
Sử dụng phương thức này để ngăn việc tạo trường quan trọng_đầu ra cũ trong sự kiện TargetComplete. Quan trọng là đầu ra quan trọng là bắt buộc để tích hợp Bazel với ResultStore.
Thẻ:affects_outputs
- Giá trị mặc định của
--[no]materialize_param_files
: "false" -
Ghi các tệp thông số trung gian vào cây đầu ra ngay cả khi sử dụng tính năng thực thi hành động từ xa. Hữu ích khi gỡ lỗi. Điều này được ngụ ý bởi --subcommands và -- chi tiết_failures.
Thẻ:execution
- Giá trị 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 có thay đổi trong các tuỳ chọn bản dựng, tuỳ chọn bản dựng sẽ hiển thị tối đa số tên tuỳ chọn đã thay đổi. Nếu số đã cho là -1, tất cả các tuỳ chọn đã thay đổi sẽ hiển thị.
Thẻ:terminal_output
- Giá trị 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 "tất cả". Được dùng để tránh gây quá tải đầu ra với đầu ra kiểm thử quá nhiễu. Tiêu đề kiểm tra được bao gồm trong kích thước nhật ký. Giá trị âm 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
--output_filter=<a valid Java regular expression>
: xem nội dung mô tả -
Chỉ hiện cảnh báo cho các quy tắc có tên khớp với biểu thức chính quy đã cung cấp.
Thẻ:affects_outputs
- Giá trị mặc định của
--progress_report_interval=<an integer in 0-3600 range>
: "0" -
Số giây giữa các báo cáo về các 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 tuỳ chọn – nguyền rủa, 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>
: "không thành công" -
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", chỉ in khi không thành công, "thành công" chỉ in khi thành công và "all" sẽ luôn in.
Thẻ:terminal_output
- Giá trị mặc định của
--[no]sandbox_debug
: "false" -
Bật tính năng gỡ lỗi cho tính năng hộp cát. Điều này bao gồm hai điều: thứ nhất, nội dung gốc của hộp cát được giữ nguyên sau khi xây dựng (và nếu hộp cát đang được sử dụng, hệ thống tệp sẽ được gắn kết); và thứ hai là in thêm thông tin gỡ lỗi khi thực thi. Nhờ vậy, các nhà phát triển quy tắc Bazel hoặc Starlark có thể khắc phục lỗi gỡ lỗi do thiếu tệp đầu vào, v.v.
Thẻ:terminal_output
- Giá trị mặc định của
--show_result=<an integer>
: "1" -
Hiển thị kết quả của bản dựng. Đối với mỗi mục tiêu, hãy nêu rõ xem mục tiêu đó có được cập nhật hay không và nếu có, hãy cung cấp danh sách các tệp đầu ra đã được tạo. Tệp được in là các chuỗi thuận tiện cho việc sao chép+dán vào shell và thực thi các chuỗi này.
Tùy chọn này yêu cầu một đối số số nguyên, là số ngưỡng của mục tiêu mà trên đó thông tin kết quả không được in. Do đó, 0 thông báo bị chặn và MAX_INT khiến kết quả luôn diễn ra. Giá trị mặc định là một.
Thẻ:affects_outputs
--[no]subcommands
[-s
] mặc định: "false"-
Hiện 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 phù hợp với công cụ).
Thẻ:terminal_output
- Mặc định của
--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" để chỉ xuất thông tin tóm tắt trạng thái kiểm thử, "errors" để in nhật ký kiểm thử cho các lần kiểm thử không thành công, "all" (tất cả) để in nhật ký cho tất cả các kiểm thử và "đã phát trực tuyến" để xuất nhật ký cho tất cả chương trình kiểm thử theo thời gian thực (thao tác này sẽ buộc thực thi từng chương trình kiểm thử cục bộ 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 bản tóm tắt kiểm thử. Các giá trị hợp lệ là giá trị "ngắn" để chỉ in thông tin về các chương trình kiểm thử được thực thi, "terse", để chỉ in thông tin về các chương trình kiểm thử không thành công đã chạy, "chi tiết" để in thông tin chi tiết về các trường hợp kiểm thử không thành công, "testcase" (trường hợp kiểm thử) để in tóm tắt khi giải quyết 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 có" để bỏ qua phần tóm tắt.
Thẻ:terminal_output
- Giá trị mặc định của
--[no]verbose_explanations
: "false" -
Tăng độ chi tiết của nội dung giải thích được đưa ra nếu bạn bật chế độ giải thích. Không có hiệu lực nếu -- giải thích không được bật.
Thẻ:affects_outputs
- Giá trị mặc định của
--[no]verbose_failures
: "false" -
Nếu một lệnh không thành công, hãy xuất dòng lệnh đầy đủ.
Thẻ:terminal_output
- Các tuỳ chọn chỉ định hoặc thay đổi dữ liệu đầu vào chung cho lệnh Bazel không thuộc các danh mục khác.:
--aspects_parameters=<a 'name=value' assignment>
lần dùng được tích luỹ-
Chỉ định giá trị của tham số khía cạnh dòng lệnh. Mỗi giá trị thông số được chỉ định qua <param_name>=<param_value>, ví dụ: 'my_param=my_val' trong đó 'my_param' là tham số của một số khía cạnh trong danh sách --aspects hoặc được một khía cạnh trong danh sách yêu cầu. Bạn có thể sử dụng lựa 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
- Giá trị mặc định của
--experimental_resolved_file_instead_of_workspace=<a string>
: "" -
Nếu không để trống, hãy đọc tệp đã giải quyết được chỉ định thay vì tệp WORKSPACE
Thẻ:changes_inputs
- Giá trị mặc định của
--target_pattern_file=<a string>
: "" -
Nếu được đặt, bản dựng sẽ đọc các mẫu từ tệp có tên tại đây, thay vì trên dòng lệnh. Sẽ xảy ra lỗi khi chỉ định một tệp tại đây cũng như các 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
--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ủ lưu trữ (cho `allow` và `block`) hoặc hai mẫu, một mẫu để so khớp và một mẫu để sử dụng làm URL thay thế, với các tham chiếu ngược bắt đầu từ `$1`. Bạn có thể cung cấp nhiều lệnh "ghi lại" cho cùng một URL và trong trường hợp này, hệ thống sẽ trả về nhiều URL.
- Giá trị mặc định của
--[no]experimental_guard_against_concurrent_changes
: "false" - Tắt tuỳ chọn này để tắt tính năng kiểm tra thời gian đối với tệp nhập của một hành động trước khi tải lên bộ nhớ đệm từ xa. Trong một số trường hợp, nhân hệ điều hành Linux có thể trì hoãn việc ghi tệp, từ đó dẫn đến dương tính giả.
- Mặc định của
--experimental_remote_build_event_upload=<all or minimal>
: "tất cả" - Nếu bạn đặt chính sách này thành "all", thì mọi dữ liệu đầu ra cục bộ được tham chiếu bởi BEP sẽ được tải lên bộ nhớ đệm từ xa. Nếu bạn đặt chính sách này thành "tối thiểu", thì các dữ liệu đầu ra cục bộ được tham chiếu bởi BEP 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 sử dụng BEP (ví dụ: nhật ký kiểm thử và hồ sơ thời gian). Lược đồ bytestream:// luôn được dùng cho URI của các tệp ngay cả khi chúng bị thiếu trong bộ nhớ đệm từ xa. Giá trị mặc định là "tất cả".
- Giá trị mặc định của
--[no]experimental_remote_cache_async
: "false" - Nếu đúng, I/O bộ nhớ đệm từ xa sẽ diễn ra trong nền thay vì diễn ra như một phần của quá trình sinh sản.
- Giá trị mặc định của
--[no]experimental_remote_cache_compression
: "false" - Nếu được bật, hãy nén/giải nén các blob bộ nhớ đệm bằng zstd.
- Mặc định
--experimental_remote_capture_corrupted_outputs=<a path>
: xem nội dung mô tả - Đường dẫn đến thư mục nơi các dữ liệu đầu ra bị lỗi sẽ được ghi vào.
- Giá trị 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, thì hệ thống sẽ loại bỏ các bản sao trong bộ nhớ của cây Merkle của gốc đầu vào và các bản đồ ánh xạ đầu vào được liên kết trong các lệnh gọi đến GetActionResult() và Execute(). Điều này làm giảm đáng kể mức sử dụng bộ nhớ, nhưng Bazel phải tính toán lại các dữ liệu này khi bộ nhớ đệm từ xa bị thiếu và thử lại.
- Mặc định
--experimental_remote_downloader=<a string>
: xem nội dung mô tả - URI điểm cuối của Remote Asset API, được 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ắm UNIX cục bộ). Nếu không cung cấp giản đồ, Bazel sẽ đặt mặc định thành grpcs. Hãy tham khảo: https://github.com/bazelbuild/remote-apis/blob/master/build/bazel/remote/asset/v1/remote_asset.proto
- Giá trị mặc định của
--[no]experimental_remote_downloader_local_fallback
: "false" - Liệu có quay lại trình tải xuống cục bộ nếu trình tải xuống từ xa không thành công hay không.
- Giá trị mặc định của
--[no]experimental_remote_execution_keepalive
: "false" - Liệu có sử dụng tính năng giữ nguyên hoạt động cho các lệnh gọi thực thi từ xa hay không.
- Mặc định
--experimental_remote_grpc_log=<a path>
: xem nội dung mô tả - Nếu được chỉ định, một đườ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 các protobuf com.google.devtools.build.lib.remote.logging.RemoteExecutionLog.LogEntry được chuyển đổi tuần tự với mỗi thông điệp có tiền tố là một varint biểu thị kích thước của thông điệp protobuf được tuần tự hoá sau đây, được thực hiện bằng phương thức LogEntry.writeDelimitedTo(OutputStream).
- Giá trị 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, thì Bazel sẽ đánh dấu các dữ liệu đầu vào là đầu vào công cụ cho bộ thực thi từ xa. Bạn có thể dùng tính năng này để triển khai trình thực thi cố định từ xa.
- Giá trị 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 (đúng), các phép tính của cây Merkle sẽ được ghi nhớ để cải thiện tốc độ kiểm tra lượt truy cập trong 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_merkle_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 Merkle cần ghi nhớ để cải thiện tốc độ kiểm tra lượt truy cập vào bộ nhớ đệm từ xa. Mặc dù bộ nhớ đệm sẽ tự động bị cắt bớt theo cách xử lý tham chiếu mềm của Java, nhưng lỗi hết bộ nhớ vẫn có thể xảy ra nếu bộ nhớ được đặt quá cao. Nếu bạn đặt chính sách này thành 0, thì kích thước bộ nhớ đệm sẽ không bị 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.
- Giá trị mặc định của
--[no]incompatible_remote_build_event_upload_respect_no_cache
: "false" - Nếu bạn đặt chính sách này thành true, thì các dữ liệu đầu ra được BEP tham chiếu sẽ không được tải lên bộ nhớ đệm từ xa nếu thao tác tạo không thể lưu vào bộ nhớ đệm từ xa.
- Giá trị mặc định của
--[no]incompatible_remote_downloader_send_all_headers
: "true" -
Liệu có gửi tất cả các giá trị của một tiêu đề có nhiều giá trị tới trình tải xuống từ xa thay vì chỉ gửi giá trị đầu tiên hay không.
Thẻ:incompatible_change
- Giá trị mặc định của
--[no]incompatible_remote_output_paths_relative_to_input_root
: "false" -
Nếu bạn đặt chính sách này thành true, thì các đường dẫn đầu ra sẽ tương ứng với thư mục gốc đầu vào thay vì thư mục đang hoạt động.
Thẻ:incompatible_change
- Giá trị mặc định của
--[no]incompatible_remote_results_ignore_disk
: "true" -
Nếu bạn đặt chính sách này thành true, thì --noremote_upload_local_results và --noremote_accept_cached sẽ không áp dụng cho bộ nhớ đệm của ổ đĩa. Nếu sử dụng bộ nhớ đệm kết hợp:
--noremote_upload_local_results sẽ làm cho kết quả được ghi vào bộ nhớ đệm của ổ đĩa nhưng không được tải lên bộ nhớ đệm từ xa.
--noremote_accept_cached sẽ dẫn đến việc Bazel kiểm tra các kết quả trong bộ nhớ đệm của ổ đĩa, chứ không phải trong bộ nhớ đệm từ xa.
no-remote-exec có thể ảnh hưởng đến bộ nhớ đệm của ổ đĩa.
Xem #8216 để biết chi tiết.
Thẻ:incompatible_change
- Giá trị mặc định của
--[no]incompatible_remote_use_new_exit_code_for_lost_inputs
: "false" -
Nếu được đặt thành true, Bazel sẽ sử dụng mã thoát mới 39 thay vì 34 nếu bộ nhớ đệm từ xa loại bỏ các blob trong quá trình tạo.
Thẻ:incompatible_change
- Giá trị mặc định của
--[no]remote_accept_cached
: "true" - Liệu có chấp nhận kết quả hành động được lưu vào bộ nhớ đệm từ xa hay không.
- Mặc định
--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 luồng sự kiện tạo bản dựng. Bạn có thể đặt tuỳ chọn này khi tạo các bản dựng bằng proxy. Việc 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ị mặc định sẽ là "${hostname}/${instance_name}".
- Mặc định
--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ắm UNIX cục bộ). Nếu không cung cấp giản đồ, Bazel sẽ đặt mặc định thành grpcs. Hãy chỉ định lược đồ grpc://, http:// hoặc unix: để vô hiệu hoá TLS. Hãy truy cập vào https://bazel.build/remote/caching
--remote_cache_header=<a 'name=value' assignment>
lần dùng được tích luỹ- Chỉ định tiêu đề sẽ có trong các yêu cầu bộ nhớ đệm: --remote_cache_header=Name=Value. Có thể truyền nhiều tiêu đề bằng cách chỉ định cờ nhiều lần. Nhiều giá trị cho cùng một tên sẽ được chuyển đổi thành danh sách được phân tách bằng dấu phẩy.
--remote_default_exec_properties=<a 'name=value' assignment>
lần dùng được tích luỹ-
Đặt các 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
- Giá trị mặc định của
--remote_default_platform_properties=<a string>
: "" - Đặt các thuộc tính nền tảng mặc định thành thiết lập cho API thực thi từ xa, nếu nền tảng thực thi chưa đặt Remote_execution_properties. Giá trị này cũng sẽ được dùng nếu nền tảng lưu trữ được chọn làm nền tảng thực thi để thực thi từ xa.
--remote_downloader_header=<a 'name=value' assignment>
lần dùng được tích luỹ- Chỉ định tiêu đề sẽ được đưa vào trong các yêu cầu của trình tải xuống từ xa: --remote_downloader_header=Name=Value. Có thể truyền nhiều tiêu đề bằng cách chỉ định cờ nhiều lần. Nhiều giá trị cho cùng một tên sẽ được chuyển đổi thành danh sách được phân tách bằng dấu phẩy.
--remote_exec_header=<a 'name=value' assignment>
lần dùng được tích luỹ- Chỉ định tiêu đề sẽ được đưa vào trong các yêu cầu thực thi: --remote_exec_header=Name=Value. Có thể truyền nhiều tiêu đề bằng cách chỉ định cờ nhiều lần. Nhiều giá trị cho cùng một tên sẽ được chuyển đổi thành danh sách được phân tách bằng dấu phẩy.
- Giá trị mặc định của
--remote_execution_priority=<an integer>
: "0" - Mức độ ưu tiên tương đối của các thao tác cần được thực thi từ xa. Ngữ nghĩa của các giá trị ưu tiên cụ thể phụ thuộc vào máy chủ.
- Mặc định
--remote_executor=<a string>
: xem nội dung mô tả - HOST hoặc HOST:PORT của một điểm cuối thực thi từ xa. Các giản đồ được hỗ trợ là grpc, grpcs (grpc có bật TLS) và unix (ổ cắm UNIX cục bộ). Nếu không cung cấp giản đồ, Bazel sẽ đặt mặc định thành grpcs. Chỉ định grpc:// hoặc unix: giản đồ để vô hiệu hoá TLS.
--remote_header=<a 'name=value' assignment>
lần dùng được tích luỹ- Chỉ định tiêu đề sẽ được đưa vào trong yêu cầu: --remote_header=Name=Value. Có thể truyền nhiều tiêu đề bằng cách chỉ định cờ nhiều lần. Nhiều giá trị cho cùng một tên sẽ được chuyển đổi thành danh sách được phân tách bằng dấu phẩy.
- Giá trị mặc định của
--remote_instance_name=<a string>
: "" - Giá trị cần truyền dưới dạnginstance_name trong API thực thi từ xa.
- Giá trị mặc định của
--[no]remote_local_fallback
: "false" - Liệu có quay lại sử dụng chiến lược thực thi cục bộ độc lập trong trường hợp thực thi từ xa không thành công hay không.
- Giá trị mặc định của
--remote_local_fallback_strategy=<a string>
: "cục bộ" - Không hoạt động, không dùng nữa. Hãy truy cập vào https://github.com/bazelbuild/bazel/issues/7480 để biết thông tin chi tiết.
- Mặc định của
--remote_max_connections=<an integer>
: "100" -
Giới hạn số lượng kết nối đồng thời tối đa đối với bộ nhớ đệm/trình thực thi từ xa. Theo mặc định, giá trị là 100. Việc đặt giá trị này thành 0 có nghĩa là không bị giới hạn.
Đối với bộ nhớ đệm từ xa HTTP, một kết nối TCP có thể xử lý từng 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, vì vậy, Bazel có thể thực hiện xung quanh các yêu cầu đồng thời "--remote_max_connections * 100".
Thẻ:host_machine_resource_optimizations
- Mặc định
--remote_proxy=<a string>
: xem nội dung mô tả - Kết nối với bộ nhớ đệm từ xa thông qua proxy. Hiện tại, bạn chỉ có thể sử dụng cờ này để định cấu hình cổng miền Unix (unix:/path/to/socket).
- Giá trị 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 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ủ.
- Giá trị 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, hoạt động thử lại sẽ bị tắt.
- Giá trị 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à các lệnh gọi vào bộ nhớ đệm. Đối với bộ nhớ đệm REST, đây là cả thời gian chờ kết nối và thời gian chờ đọc. Bạn có thể sử dụng các đơn vị sau: Ngày (d), giờ (h), phút (m), giây (s) và mili giây (mili giây). Nếu bạn bỏ qua đơn vị, thì giá trị được hiểu là giây.
- Giá trị mặc định của
--[no]remote_upload_local_results
: "true" - Liệu có tải các kết quả hành động được thực thi cục bộ lên bộ nhớ đệm từ xa hay không nếu bộ nhớ đệm từ xa hỗ trợ và người dùng được phép thực hiện việc đó.
- Giá trị mặc định của
--[no]remote_verify_downloads
: "true" - Nếu bạn đặt chính sách này thành true, thì Bazel sẽ tính toán tổng băm của tất cả các tệp tải xuống từ xa và loại bỏ các giá trị được lưu vào bộ nhớ đệm từ xa nếu các giá trị đó không khớp với giá trị dự kiến.
- Các lựa chọn khác, không được phân loại theo cách khác.:
- Giá trị mặc định của
--auto_output_filter=<none, all, packages or subpackages>
: "không có" - Nếu --output_filter không được chỉ định, thì giá trị cho tuỳ chọn này sẽ được tự động tạo bộ lọc. Giá trị được phép là "none" (không lọc gì / hiển thị mọi thứ), 'tất cả' (lọc mọi thứ / không hiển thị gì), 'gói' (bao gồm đầu ra từ các quy tắc trong các gói được đề cập trên dòng lệnh Blaze) và "gói con" (như "gói", nhưng cũng bao gồm các gói con). Đối với "packages" (gói) và "subpackages" các giá trị //java/foo và //javatests/foo được coi là một gói)'.
- Giá trị mặc định của
--[no]build_manual_tests
: "false" - Buộc sử dụng các mục tiêu thử nghiệm được gắn thẻ "thủ công" xây dựng. "thủ công" thử nghiệm sẽ bị loại trừ khỏi quá trình xử lý. Tuỳ chọn này buộc phải tạo (nhưng không được thực thi)
- Giá trị 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ể bắt đầu bằng "-" theo tuỳ chọn để chỉ định thẻ bị loại trừ. Chỉ những mục tiêu đó mới đượ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 bài kiểm thử được thực thi bằng thuộc tính "test" (kiểm thử) Command; những yếu tố đó chịu sự điều chỉnh của tuỳ chọn lọc thử nghiệm, ví dụ: '--test_tag_filters'
- Giá trị mặc định của
--[no]build_tests_only
: "false" - Nếu được chỉ định, chỉ 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.
- Giá trị mặc định của
--combined_report=<none or lcov>
: "không có" - Chỉ định loại báo cáo mức độ phù hợp tích luỹ mong muốn. Hiện tại, hệ thống chỉ hỗ trợ LCOV.
- Giá trị mặc định của
--[no]compile_one_dependency
: "false" - Biên dịch một phần phụ thuộc của các tệp đối số. Điều này rất hữu ích cho việc kiểm tra cú pháp các tệp nguồn trong IDE, chẳng hạn như bằng cách tạo lại một mục tiêu phụ thuộc vào tệp nguồn nhằm phát hiện lỗi càng sớm càng tốt trong chu kỳ chỉnh sửa/xây dựng/kiểm thử. Đối số này ảnh hưởng đến cách diễn giải tất cả các đối số không gắn cờ; thay vì là mục tiêu để tạo, chúng là tên tệp nguồn. Đối với mỗi tên tệp nguồn, một mục tiêu tuỳ ý phụ thuộc vào tên tệp nguồn đó sẽ được tạo.
- Giá trị mặc định của
--deleted_packages=<comma-separated list of package names>
: "" - 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ẽ cho là không tồn tại, ngay cả khi chúng hiển thị ở đâu đó 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 'x' hiện có. Ví dụ: sau khi xoá x/y/BUILD trong ứng dụng khách của bạn, hệ thống xây dựng có thể sẽ khiếu nại nếu gặp nhãn '//x:y/z' nếu giá trị đó vẫn được cung cấp bởi một mục package_path khác. Việc chỉ định --Delete_packages x/y sẽ giúp tránh được sự cố này.
- Giá trị mặc định của
--[no]discard_analysis_cache
: "false" - Loại bỏ 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ớ xuống khoảng 10%, nhưng khiến các bản dựng tăng dần trở nên chậm hơn.
- Mặc định
--disk_cache=<a path>
: xem nội dung mô tả - Một đường dẫn đến một thư mục mà Bazel có thể đọc và ghi các thao tác cũng như kết quả đầu ra của hành động. Nếu không có, thư mục sẽ được tạo.
- Giá trị mặc định của
--embed_label=<a one-line string>
: "" - Bản sửa đổi kiểm soát nguồn được nhúng hoặc nhãn phát hành ở dạng tệp nhị phân
- Mặc định
--execution_log_binary_file=<a path>
: xem nội dung mô tả - Ghi lại các bản sinh đã thực thi vào tệp này dưới dạng các giao thức Spawn được phân tách, theo src/main/protobuf/spawn.proto. Lần đầu tiên nhật ký được ghi không theo thứ tự và sau đó được sắp xếp theo thứ tự ổn định ở cuối lệnh gọi (có thể tốn nhiều bộ nhớ và CPU). Cờ liên quan: --execution_log_json_file (định dạng văn bản json có thứ tự), --experimental_execution_log_file (định dạng protobuf nhị phân không có thứ tự), --subcommands (để hiển thị các lệnh con trong đầu ra của thiết bị đầu cuối).
- Mặc định
--execution_log_json_file=<a path>
: xem nội dung mô tả - Ghi lại các bản sao đã thực thi vào tệp này dưới dạng json thể hiện các giao thức Spawn được phân tách, theo src/main/protobuf/spawn.proto. Lần đầu tiên nhật ký được ghi không theo thứ tự và sau đó được sắp xếp theo thứ tự ổn định ở cuối lệnh gọi (có thể tốn nhiều bộ nhớ và CPU). Cờ liên quan: Cờ liên quan: --execution_log_binary_file (định dạng protobuf nhị phân có thứ tự), --experimental_execution_log_file (định dạng protobuf nhị phân không theo thứ tự), --subcommands (để hiển thị các lệnh con trong đầu ra của thiết bị đầu cuối).
- Giá trị mặc định của
--[no]execution_log_sort
: "true" - Liệu có sắp xếp nhật ký thực thi hay không. Đặt thành false để cải thiện hiệu suất của bộ nhớ, với chi phí tạo nhật ký theo thứ tự không xác định.
- Giá trị mặc định của
--[no]expand_test_suites
: "true" -
Mở rộng các mục tiêu test_suite vào 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), mẫu mục tiêu phủ định sẽ áp dụng cho các bài kiểm thử thuộc bộ kiểm thử, nếu không thì khô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 ở dòng lệnh: sau đó, họ có thể phân tích các mục tiêu test_suite.
Thẻ:loading_and_analysis
--experimental_credential_helper=<An (unresolved) path to a credential helper for a scope.>
lần dùng được tích luỹ- Định cấu hình Trình trợ giúp thông tin xác thực dùng cho việc truy xuất thông tin xác thực cho phạm vi đã cung cấp (miền). Thông tin xác thực của Trình trợ giúp thông tin xác thực được ưu tiên hơn thông tin xác thực trên <code>--google_default_credentials</code>, "--google_credentials" hoặc <code>.netrc</code>. Hãy truy cập vào https://github.com/bazelbuild/suggesteds/blob/main/designs/2022-06-07-bazel-credential-helpers.md để biết chi tiết.
- Giá trị mặc định của
--experimental_credential_helper_cache_duration=<An immutable length of time.>
: "30 phút" - Định cấu hình khoảng thời gian lưu thông tin xác thực từ Trình trợ giúp thông tin xác thực. 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 đó; truyền 0 để xoá bộ nhớ đệm. Lệnh sạch luôn xoá bộ nhớ đệm, bất kể cờ này là gì.
- Mặc định của
--experimental_credential_helper_timeout=<An immutable length of time.>
: "5 giây" - Định cấu hình thời gian chờ cho Trình trợ giúp thông tin xác thực. 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 sẽ không thực hiện được lệnh gọi.
- Mặc định
--experimental_execution_log_file=<a path>
: xem nội dung mô tả - Ghi lại các bản sinh đã thực thi vào tệp này dưới dạng các giao thức Spawn được phân tách, theo src/main/protobuf/spawn.proto. Tệp này được ghi theo thứ tự thực thi các lần sinh ra. Cờ liên quan: --execution_log_binary_file (định dạng protobuf nhị phân có thứ tự), --execution_log_json_file (định dạng văn bản json có thứ tự), --subcommands (để hiển thị các lệnh con trong đầu ra của thiết bị đầu cuối).
- Giá trị mặc định của
--[no]experimental_execution_log_spawn_metrics
: "false" - Bao gồm các chỉ số sinh ra trong nhật ký sinh sản được thực thi.
- Giá trị 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à ưu tiên các khía cạnh. Bộ lọc đặt mục tiêu để lên lịch các hành động ngoại lệ.
- Giá trị mặc định của
--[no]experimental_extra_action_top_level_only
: "false" - Ngừng sử dụng và ưu tiên các khía cạnh. Chỉ lên lịch các hành động ngoại lệ cho các mục tiêu cấp cao nhất.
- Giá trị mặc định của
--[no]experimental_prioritize_local_actions
: "true" -
Nếu được đặt, các thao tác chỉ có thể chạy cục bộ sẽ có cơ hội đầu tiên để lấy tài nguyên, các worker chạy linh động sẽ có cơ hội thứ hai và các hành động độc lập chạy linh động sẽ đến cuối cùng.
Thẻ:execution
--experimental_spawn_scheduler
-
Cho phép thực thi động bằng cách chạy song song các thao tác trên máy và từ xa. Bazel tạo từng hành động trên máy và từ xa, sau đó chọn hành động hoàn thành trước. Nếu một thao tác hỗ trợ worker, thì thao tác cục bộ đó sẽ được chạy ở chế độ worker liên tục. Thay vào đó, để bật tính năng thực thi động cho một 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
--google_auth_scopes=<comma-separated list of options>
: "https://www.googleapis.com/auth/cloud-platform" - Danh sách phạm vi xác thực được phân tách bằng dấu phẩy trên Google Cloud.
- Mặc định
--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/authentication để biết thông tin chi tiết.
- Giá trị mặc định của
--[no]google_default_credentials
: "false" - Có sử dụng 'Thông tin xác thực mặc định của ứng dụng trên Google' không để xác thực. Hãy truy cập vào https://cloud.google.com/docs/authentication để biết thông tin chi tiết. Tắt theo mặc định.
- Mặc định
--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, thì Bazel sẽ gửi ping sau khoảng thời gian không đọc hoạt động 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; thì xảy ra lỗi khi đặt giá trị nhỏ hơn một giây. Theo mặc định, các ping giữ kết nối sẽ bị tắt. Bạn nên phối hợp với chủ sở hữu dịch vụ trước khi bật 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
- Giá trị 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 giữ 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 phản hồi ping sau khoảng thời gian này. Thời gian được coi là độ chi tiết thứ hai; thì xảy ra lỗi khi đặt giá trị nhỏ hơn một giây. Nếu ping duy trì hoạt động bị tắt, thì chế độ cài đặt này sẽ bị bỏ qua.
- Giá trị mặc định của
--[no]ignore_unsupported_sandboxing
: "false" - Không in cảnh báo khi quá trình thực thi hộp cát không được hỗ trợ trên hệ thống này.
- Giá trị mặc định của
--[no]incompatible_dont_use_javasourceinfoprovider
: "false" -
Không hoạt động
Thẻ:incompatible_change
- Giá trị mặc định của
--local_cpu_resources=<an integer, or "HOST_CPUS", optionally followed by [-|*]<float>.>
: "HOST_CPUS" - Đặt rõ ràng tổng số lõi CPU cục bộ có thể sử dụng cho Bazel để chi tiêu cho các hành động tạo bản dựng được thực thi cục bộ. Lấy một số nguyên hoặc "HOST_CPUS", theo sau không bắt buộc là [-|*]<float> (ví dụ: HOST_CPUS*.5 để sử dụng một nửa số lõi CPU hiện có).Theo mặc định, ("HOST_CPUS"), Bazel sẽ truy vấn cấu hình hệ thống để ước tính số lõi CPU sẵn có.
--local_extra_resources=<a named float, 'name=value'>
lần dùng được tích luỹ- Đặt số lượng tài nguyên bổ sung hiện có cho Bazel. Lấy một cặp chuỗi-float. Có thể sử dụng nhiều lần để chỉ định nhiều loại tài nguyên bổ sung. Bazel sẽ giới hạn các hành động chạy đồng thời dựa trên tài nguyên bổ sung có sẵn và tài nguyên bổ sung cần thiết. Các chương trình kiểm thử có thể khai báo lượng tài nguyên bổ sung cần thiết bằng cách sử dụng thẻ "resources:<resoucename>:<amount>" . Không thể thiết lập CPU, RAM và các tài nguyên hiện có bằng cờ này.
- Giá trị mặc định của
--local_ram_resources=<an integer, or "HOST_RAM", optionally followed by [-|*]<float>.>
: "HOST_RAM*.67" - Đặt 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 đối với bản dựng được thực thi cục bộ. Lấy một số nguyên hoặc "HOST_RAM", theo sau không bắt buộc là [-|*]<float> (ví dụ: HOST_RAM*.5 để sử dụng một nửa RAM còn trống). 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 còn trống.
- Giá trị 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 đó.
--override_repository=<an equals-separated mapping of repository name to path>
lần dùng được tích luỹ- Ghi đè kho lưu trữ bằng thư mục cục bộ.
- 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, trong đó có nơi tìm các gói. Các phần tử bắt đầu bằng '%workspace%' đều liên quan đến không gian làm việc bao quanh. Nếu bạn bỏ qua hoặc để trống giá trị này, giá trị mặc định sẽ là "bazel info default-package-path".
- Giá trị mặc định của
--[no]show_loading_progress
: "true" - Nếu được bật, Bazel sẽ hiện thông báo "Đang tải gói:" tin nhắn.
- Giá trị mặc định của
--test_lang_filters=<comma-separated list of options>
: "" - Chỉ định danh sách ngôn ngữ thử nghiệm được phân tách bằng dấu phẩy. Mỗi ngôn ngữ có thể đứng sau "-" theo tuỳ chọn để chỉ định ngôn ngữ bị loại trừ. Chúng tôi chỉ tìm thấy những mục tiêu kiểm thử đó được viết bằng các ngôn ngữ đã chỉ định. Tên dùng cho mỗi ngôn ngữ phải giống với tiền tố ngôn ngữ trong quy tắc *_test, ví dụ: một trong các "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ử.
- Giá trị mặc định của
--test_size_filters=<comma-separated list of values: small, medium, large or enormous>
: "" - Chỉ định một danh sách kích thước thử nghiệm được phân tách bằng dấu phẩy. Mỗi kích thước có thể bắt đầu bằng "-" sau tùy chọn để chỉ định kích thước bị loại trừ. Hệ thống 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 bao gồm 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ử.
- Giá trị mặc định của
--test_tag_filters=<comma-separated list of options>
: "" - Chỉ định danh sách thẻ thử nghiệm được phân tách bằng dấu phẩy. Mỗi thẻ có thể bắt đầu bằng "-" theo tuỳ chọn để chỉ định thẻ bị loại trừ. Chỉ tìm được 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ử.
- Giá trị mặc định của
--test_timeout_filters=<comma-separated list of values: short, moderate, long or eternal>
: "" - Chỉ định danh sách thời gian chờ thử nghiệm được phân tách bằng dấu phẩy. Mỗi thời gian chờ có thể tuỳ ý đứng trước "-" để chỉ định thời gian chờ bị loại trừ. Chỉ những mục tiêu thử nghiệm đó mới được tìm thấy có chứa ít nhất một thời gian chờ được bao gồm và không chứa bất kỳ thời gian chờ 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
--tls_certificate=<a string>
: xem nội dung mô tả - Chỉ định một đường dẫn đến chứng chỉ TLS được tin cậy để ký chứng chỉ máy chủ.
- Mặc định
--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á ứng dụng khách để bật tính năng xác thực ứng dụng.
- Mặc định
--tls_client_key=<a string>
: xem nội dung mô tả - Chỉ định khoá ứng dụng 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 ứng dụng khách.
- Giá trị mặc định của
--workspace_status_command=<path>
: "" - Một lệnh được gọi ở đầu quá trình tạo để cung cấp thông tin trạng thái về không gian làm việc dưới dạng các cặp khoá/giá trị. Xem Hướng dẫn người dùng để biết thông số đầy đủ. Ngoài ra, hãy tham khảo tools/buildstamp/get_workspace_status để biết ví dụ.
- Các tuỳ chọn kiểm soát việc thực thi bản dựng:
- Giá trị mặc định của
--[no]check_up_to_date
: "false" -
Đừng thực hiện tạo, chỉ kiểm tra xem bản dựng đã được cập nhật hay chưa. Nếu tất cả các mục tiêu đều được cập nhật, thì bản dựng sẽ hoàn tất thành công. Nếu cần thực thi bất kỳ bước nào, thì hệ thống sẽ báo lỗi và bản dựng sẽ không hoạt động.
Thẻ:execution
- Giá trị mặc định của
--[no]experimental_inprocess_symlink_creation
: "false" -
Liệu có thực hiện lệnh gọi hệ thống tệp trực tiếp để tạo cây liên kết tượng trưng hay không
Thẻ:loading_and_analysis
,execution
,experimental
- Giá trị mặc định của
--[no]experimental_remotable_source_manifests
: "false" -
Có thể cho phép từ xa các hành động trong tệp kê khai nguồn hay không
Thẻ:loading_and_analysis
,execution
,experimental
- Giá trị mặc định của
--[no]experimental_split_coverage_postprocessing
: "false" -
Nếu true, Bazel sẽ chạy xử lý hậu kỳ về mức độ sử dụng để kiểm thử trong một lượt sinh sản mới.
Thẻ:execution
- Giá trị mặc định của
--[no]experimental_split_xml_generation
: "true" -
Nếu bạn đặt cờ này và một 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 biệt để tạo một tệp test.xml giả chứa nhật ký kiểm thử. Nếu không, Bazel sẽ tạo một test.xml trong hành động kiểm thử.
Thẻ:execution
- Giá trị mặc định của
--[no]experimental_strict_fileset_output
: "false" -
Nếu bật tuỳ chọn này, tập hợp tệp sẽ coi tất cả cấu phần phần mềm đầu ra là tệp thông thường. Chúng sẽ không truyền tải các thư mục hoặc nhạy cảm với đường liên kết tượng trưng.
Thẻ:execution
- Giá trị mặc định của
--genrule_strategy=<comma-separated list of options>
: "" -
Chỉ định cách thực thi 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ả hành động hoặc --strategy=Gen giọng=<value> để chỉ kiểm soát 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ố công việc đồng thời cần chạy. Lấy một số nguyên hoặc một từ khoá ("auto", "HOST_CPUS", "HOST_RAM"), theo sau không bắt buộc bởi một thao tác ([-|*]<float>), ví dụ: "tự động", "HOST_CPUS*.5". Giá trị phải nằm trong khoảng từ 1 đến 5000. Các giá trị trên 2500 có thể gây ra vấn đề về bộ nhớ. "tự động" tính toán giá trị mặc định hợp lý dựa trên tài nguyên máy chủ.
Thẻ:host_machine_resource_optimizations
,execution
--[no]keep_going
[-k
] mặc định: "false"-
Hãy tiếp tục nhiều nhất có thể sau khi gặp lỗi. Mặc dù không thể phân tích mục tiêu không thành công và những mục tiêu phụ thuộc vào nó, nhưng có thể có các điều kiện tiên quyết khác cho những mục tiêu này.
Thẻ:eagerness_to_exit
- Giá trị mặc định của
--loading_phase_threads=<an integer, or a keyword ("auto", "HOST_CPUS", "HOST_RAM"), optionally followed by an operation ([-|*]<float>) eg. "auto", "HOST_CPUS*.5">
: "tự động" -
Số lượng luồng song song để sử 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 bởi một thao tác ([-|*]<float>), ví dụ: "tự động", "HOST_CPUS*.5". "tự động" đặt giá trị mặc định hợp lý dựa trên tài nguyên máy chủ lưu trữ. Phải ít nhất là 1.
Thẻ:bazel_internal_configuration
- Giá trị 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 ghi nhớ hành động. Chỉ áp dụng cho các thao tác hỗ trợ thông tin thực thi. Nhiều thao tác phổ biến có 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 ghi nhớ.
Cú pháp: "regex=[+-]key,regex=[+-]key,...".
Ví dụ:
'.*=+x,.*=-y,.*=+z' thêm "x" và 'z' đến và xoá 'y' từ thông tin thực thi cho tất cả các hành động.
"Genrules=+yêu cầu-x" thêm 'require-x' vào thông tin thực thi của mọi thao tác trên Quy tắc Gen.
'(?!Genrules).*=-requirements-x' xoá "request-x" trong thông tin thực thi cho tất cả các hành động không phải Quy tắc chung.
Thẻ:execution
,affects_outputs
,loading_and_analysis
--persistent_android_dex_desugar
-
Cho phép các thao tác đơn giản hoá và tạo tệp dex trên Android liên tục bằng cách sử dụng worker.
Mở rộng thành:
--strategy=Desugar=worker
--strategy=DexBuilder=worker
Thẻ:host_machine_resource_optimizations
,execution
--persistent_android_resource_processor
-
Cho phép trình xử lý tài nguyên Android ổn định bằng cách sử dụng worker.
Mở rộng thành:
--internal_persistent_busybox_tools
--strategy=AaptPackage=worker
--strategy=AndroidResourceParser=worker
--strategy=AndroidResourceValidator=worker
--strategy=AndroidResourceCompiler=worker
--strategy=RClassGenerator=worker
--strategy=AndroidResourceLink=worker
--strategy=AndroidAapt2=worker
--strategy=AndroidAssetMerger=worker
/--strategy=AndroidResourceMerger=worker
/--strategy=AndroidCompiledResourceMerger=worker
/--strategy=ManifestMerger=worker
/--strategy=AndroidManifestMerger=worker
/--strategy=Aapt2Optimize=worker
/--strategy=AARGenerator=worker
Thẻ:host_machine_resource_optimizations
,execution
--persistent_multiplex_android_dex_desugar
-
Bật các thao tác đơn giản hoá và giải mã Android được ghép liên tục bằng trình thực thi.
Mở rộng thành:
--persistent_android_dex_desugar
--modify_execution_info=Desugar=+supports-multiplex-workers
--modify_execution_info=DexBuilder=+supports-multiplex-workers
Thẻ:host_machine_resource_optimizations
,execution
--persistent_multiplex_android_resource_processor
-
Bật trình xử lý tài nguyên Android ghép nối liên tục bằng cách sử dụng worker.
Mở rộng thành:
--persistent_android_resource_processor
--modify_execution_info=AaptPackage=+supports-multiplex-workers
--modify_execution_info=AndroidResourceParser=+supports-multiplex-workers
--modify_execution_info=AndroidResourceValidator=+supports-multiplex-workers
--modify_execution_info=AndroidResourceCompiler=+supports-multiplex-workers
--modify_execution_info=RClassGenerator=+supports-multiplex-workers
--modify_execution_info=AndroidResourceLink=+supports-multiplex-workers
--modify_execution_info=AndroidAapt2=+supports-multiplex-workers
--modify_execution_info=AndroidAssetMerger=+supports-multiplex-workers
/--modify_execution_info=AndroidResourceMerger=+supports-multiplex-workers
/--modify_execution_info=AndroidCompiledResourceMerger=+supports-multiplex-workers
/--modify_execution_info=ManifestMerger=+supports-multiplex-workers
/--modify_execution_info=AndroidManifestMerger=+supports-multiplex-workers
/--modify_execution_info=Aapt2Optimize=+supports-multiplex-workers
/--modify_execution_info=AARGenerator=+supports-multiplex-workers
Thẻ:host_machine_resource_optimizations
,execution
--persistent_multiplex_android_tools
-
Bật các công cụ Android liên tục và đa kênh (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
- Giá trị mặc định của
--spawn_strategy=<comma-separated list of options>
: "" -
Chỉ định cách thực thi các thao tác tạo ra 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 thi hành động đó. Giá trị mặc định là "remote,worker,sandboxed,local". Hãy truy cập https://blog.bazel.build/2019/06/19/list-strategy.html để biết thông tin chi tiết.
Thẻ:execution
--strategy=<a '[name=]value1[,..,valueN]' assignment>
lần dùng được tích luỹ-
Chỉ định cách phân phối dữ liệu biên dịch của các thao tác spawn 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 thi 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à --genrules_strategy nếu dùng với Gen quy tắc ghi nhớ). Hãy truy cập https://blog.bazel.build/2019/06/19/list-strategy.html để biết thông tin chi tiết.
Thẻ:execution
--strategy_regexp=<a '<RegexFilter>=value[,value]' assignment>
lần dùng được tích luỹ-
Ghi đè chiến lược sinh ra nên dùng để thực thi các hành động tạo ra có nội dung mô tả khớp với một biểu thức chính quy_bộ lọc nhất định. Hãy xem --per_file_copt để biết thông tin chi tiết về việc so khớp onregex_filter. Hệ thống sẽ sử dụng biểu thức chính quy đầu tiên 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 nghĩa là chạy các hành động bằng chiến lược cục bộ nếu nội dung mô tả của các hành động đó khớp với //foo.*.cc nhưng không khớp với //foo/bar. Ví dụ: --strategy_regexp='Comp dương.*/bar=local --strategy_regexp=Comp dương=sandboxed sẽ chạy 'Biên dịch //foo/bar/baz' với từ khoá 'local' nhưng đảo ngược thứ tự sẽ chạy lệnh với "sandboxed" (hộp cát).
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
--android_compiler=<a string>
: xem nội dung mô tả -
Trình biên dịch mục tiêu Android.
Thẻ:affects_outputs
,loading_and_analysis
,loses_incremental_state
- Giá trị 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
--android_grte_top=<a label>
: xem nội dung mô tả -
Mục tiêu Android grte_top.
Thẻ:changes_inputs
,loading_and_analysis
,loses_incremental_state
- Giá trị 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
- Giá trị mặc định của
--android_platforms=<a build target label>
: "" -
Đặt các nền tảng mà mục tiêu android_binary sử dụng. Nếu bạn chỉ định nhiều nền tảng, thì tệp nhị phân sẽ là tệp APK lớn, chứa các tệp nhị phân gốc cho từng nền tảng mục tiêu được chỉ định.
Thẻ:changes_inputs
,loading_and_analysis
,loses_incremental_state
- 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
- Mặc định
--apple_compiler=<a string>
: xem nội dung mô tả -
Trình biên dịch mục tiêu của Apple. Hữu ích khi chọn các biến thể của chuỗi công cụ (ví dụ: xcode-beta).
Thẻ:affects_outputs
,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 crosstool sẽ được dùng trong các quy tắc của Apple và Objc cũng như các phần phụ thuộc của chúng.
Thẻ:loses_incremental_state
,changes_inputs
- Mặc định
--apple_grte_top=<a build target label>
: xem nội dung mô tả -
Mục tiêu grte_top của Apple.
Thẻ:changes_inputs
,loading_and_analysis
,loses_incremental_state
- Giá trị mặc định của
--cc_output_directory_tag=<a string>
: "" -
Chỉ định một hậu tố cần thêm vào thư mục cấu hình.
Thẻ:affects_outputs
,explicit_in_output_path
- Mặc định
--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 để xử lý hậu kỳ các báo cáo về mức độ phù hợp thô. Hiện tại, đây phải là một nhóm tệp 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 về mức độ phù hợp. Hiện tại, đây phải là một nhóm tệp 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ợ cần thiết đối với dữ liệu đầu vào của mọi hành động kiểm thử giúp 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 crosstool sẽ được dùng để biên dịch mã C++.
Thẻ:loading_and_analysis
,changes_inputs
,affects_outputs
- Mặc định
--custom_malloc=<a build target label>
: xem nội dung mô tả -
Chỉ định cách 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.
Thẻ:changes_inputs
,affects_outputs
--experimental_add_exec_constraints_to_targets=<a '<RegexFilter>=<label1>[,<label2>,...]' assignment>
lần dùng được tích luỹ-
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ố là - (biểu thức âm) (không bắt buộc) được gán (=) cho 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ông khớp với biểu thức phủ định nào và có ít nhất một biểu thức dương, thì độ phân giải của chuỗi công cụ sẽ được thực hiện như thể đã khai báo các giá trị ràng buộc làm điều kiện ràng buộc thực thi. Ví dụ: //demo,-test=@platforms//cpus:x86_64 sẽ thêm 'x86_64' vào bất kỳ mục tiêu nào trong //demo ngoại trừ những mục tiêu có tên chứa 'test'.
Thẻ:loading_and_analysis
- Giá trị mặc định của
--[no]experimental_enable_objc_cc_deps
: "true" -
Cho phép các quy tắc objc_* phụ thuộc vào cc_library và khiến mọi phần phụ thuộc objc được tạo với --cpu được đặt thành "ios_<--ios_cpu>" cho bất kỳ giá trị nào trong --ios_multi_cpu.
Thẻ:loading_and_analysis
,incompatible_change
- Giá trị mặc định của
--[no]experimental_include_xcode_execution_requirements
: "false" -
Nếu đã đặt, hãy thêm "require-xcode:{version}" cho mọi hành động trên Xcode. Nếu phiên bản xcode có nhãn được gạch nối, hãy thêm cả "require-xcode-label:{version_label}" yêu cầu thực thi.
Thẻ:loses_incremental_state
,loading_and_analysis
,execution
- Giá trị mặc định của
--[no]experimental_prefer_mutual_xcode
: "true" -
Nếu đúng, hãy sử dụng Xcode mới nhất có sẵn cả tại địa phương và từ xa. Nếu sai hoặc nếu không có phiên bản nào hỗ trợ lẫn 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
--extra_execution_platforms=<comma-separated list of options>
lần dùng được tích luỹ-
Các nền tảng có sẵn dưới dạng nền tảng thực thi để chạy các hành động. Bạn có thể chỉ định nền tảng theo mục tiêu chính xác hoặc dưới dạng mẫu mục tiêu. Các nền tảng này sẽ được xem xét trước những nền tảng được khai báo trong tệp WORKSPACE bằng register_execution_platforms().
Thẻ:execution
--extra_toolchains=<comma-separated list of options>
lần dùng được tích luỹ-
Các quy tắc chuỗi công cụ cần được xem xét trong quá trình phân giải chuỗi công cụ. Bạn có thể chỉ định chuỗi công cụ theo mục tiêu chính xác hoặc dưới dạng mẫu mục tiêu. Các chuỗi công cụ này sẽ được xem xét trước các chuỗi công cụ được khai báo trong tệp WORKSPACE bằng register_toolchains().
Thẻ:affects_outputs
,changes_inputs
,loading_and_analysis
- Mặc định
--grte_top=<a label>
: xem nội dung mô tả -
Nhãn cho thư viện libc đã được đăng ký. 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 phải ghi đè giá trị này.
Thẻ:action_command_lines
,affects_outputs
- Mặc định
--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
--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 máy chủ lưu trữ. 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 đã cho.
Thẻ:loading_and_analysis
,changes_inputs
,affects_outputs
- Mặc định
--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 của libc (--grte_top) cho cấu hình máy chủ lưu trữ.
Thẻ:action_command_lines
,affects_outputs
- Giá trị mặc định của
--host_platform=<a build target label>
: "" -
Nhãn của một quy tắc nền tảng mô tả hệ thống lưu trữ.
Thẻ:affects_outputs
,changes_inputs
,loading_and_analysis
- Giá trị mặc định của
--[no]incompatible_disable_expand_if_all_available_in_flag_set
: "true" -
Nếu đúng, Bazel sẽ không cho phép chỉ định mở rộng_if_all_available trongflag_sets(xem https://github.com/bazelbuild/bazel/issues/7008 để biết hướng dẫn di chuyển).
Thẻ:loading_and_analysis
,incompatible_change
- Giá trị mặc định của
--[no]incompatible_dont_enable_host_nonhost_crosstool_features
: "true" -
Nếu đúng, Bazel sẽ không bật "máy chủ lưu trữ" và "nonhost" trong chuỗi công cụ c++ (xem https://github.com/bazelbuild/bazel/issues/7407 để biết thêm thông tin).
Thẻ:loading_and_analysis
,incompatible_change
- Giá trị mặc định của
--[no]incompatible_enable_android_toolchain_resolution
: "false" -
Sử dụng độ phân giải chuỗi công cụ để chọn SDK Android cho các quy tắc Android (Starlark và gốc)
Thẻ:loading_and_analysis
,incompatible_change
- Giá trị mặc định của
--[no]incompatible_enable_apple_toolchain_resolution
: "false" -
Sử dụng độ phân giải của chuỗi công cụ để chọn Apple SDK cho các quy tắc của apple (Starlark và gốc)
Thẻ:loading_and_analysis
,incompatible_change
- Giá trị mặc định của
--[no]incompatible_make_thinlto_command_lines_standalone
: "true" -
Nếu đúng, Bazel sẽ không sử dụng lại các dòng lệnh hành động liên kết C++ cho các dòng lệnh lập chỉ mục lto (xem https://github.com/bazelbuild/bazel/issues/6791 để biết thêm thông tin).
Thẻ:loading_and_analysis
,incompatible_change
- Giá trị mặc định của
--[no]incompatible_remove_cpu_and_compiler_attributes_from_cc_toolchain
: "true" -
Nếu đúng, Bazel sẽ khiếu nại khi các thuộc tính cc_toolchain.cpu và cc_toolchain.compiler được đặt (xem https://github.com/bazelbuild/bazel/issues/7075 để biết hướng dẫn di chuyển).
Thẻ:loading_and_analysis
,incompatible_change
- Giá trị mặc định của
--[no]incompatible_remove_legacy_whole_archive
: "true" -
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
- Giá trị mặc định của
--[no]incompatible_require_ctx_in_configure_features
: "true" -
Nếu đúng, Bazel sẽ yêu cầu 'ctx' vào cc_common.configure_features (xem https://github.com/bazelbuild/bazel/issues/7793 để biết thêm thông tin).
Thẻ:loading_and_analysis
,incompatible_change
-
Sử dụng các đối tượng dùng chung trong 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
--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 SDK iOS cần sử dụng để xây dựng ứng dụng iOS. Nếu bạn chưa chỉ định, hãy sử dụng phiên bản SDK iOS mặc định trong "xcode_version".
Thẻ:loses_incremental_state
- Mặc định
--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 SDK macOS mà bạn muốn dùng để xây dựng ứng dụng cho macOS. Nếu bạn chưa chỉ định, hãy sử dụng phiên bản SDK macOS mặc định trong "xcode_version".
Thẻ:loses_incremental_state
- Mặc định
--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à cấu hình biên dịch của bạn nhắm đến.
Thẻ:loading_and_analysis
,affects_outputs
- Giá trị mặc định của
--platform_mappings=<a relative path>
: "" -
Vị trí của tệp ánh xạ mô tả nền tảng sẽ 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 nền tảng đã tồn tại. Phải tương ứng với thư mục gốc của không gian làm việc chính. Giá trị mặc định là "platform_mappings" (một tệp ngay dưới thư mục gốc của không gian làm việc).
Thẻ:affects_outputs
,changes_inputs
,loading_and_analysis
- Giá trị 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
--python2_path=<a string>
: xem nội dung mô tả -
Không được dùng nữa, không hoạt động. Bị tắt bởi "--incompatible_use_python_toolchains".
Thẻ:no_op
,deprecated
- Mặc định
--python3_path=<a string>
: xem nội dung mô tả -
Không được dùng nữa, không hoạt động. Bị tắt bởi "--incompatible_use_python_toolchains".
Thẻ:no_op
,deprecated
- Mặc định
--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
--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
- Giá trị mặc định của
--target_platform_fallback=<a build target label>
: "@local_config_platform//:host" -
Nhãn của một quy tắc nền tảng nên được sử dụng nếu không có nền tảng mục tiêu nào được đặt và không có ánh xạ nền tảng nào khớp với bộ cờ hiện tại.
Thẻ:affects_outputs
,changes_inputs
,loading_and_analysis
- Mặc định
--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 để sử dụng cho việc tạo ứng dụng tvOS. Nếu bạn chưa 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
--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 SDK watchOS cần 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 trong "xcode_version".
Thẻ:loses_incremental_state
- Mặc định
--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 liên quan đến bản dựng. Nếu chưa chỉ định, hãy sử dụng phiên bản Xcode mặc định của trình thực thi.
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:
- Giá trị mặc định của
--[no]apple_enable_auto_dsym_dbg
: "false" -
Liệu có buộc bật (các) tệp biểu tượng gỡ lỗi (.dSYM) cho các bản dựng dbg hay không.
Thẻ:affects_outputs
,action_command_lines
- Giá trị mặc định của
--[no]apple_generate_dsym
: "false" -
Liệu có tạo (các) tệp biểu tượng gỡ lỗi (.dSYM) hay không.
Thẻ:affects_outputs
,action_command_lines
- Giá trị mặc định của
--[no]build
: "true" -
Thực thi bản dựng; đây là hành vi thông thường. Việc chỉ định --nobuild sẽ khiến bản dựng dừng trước khi thực thi các 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 rất hữu ích khi thử nghiệm các giai đoạn đó.
Thẻ:execution
,affects_outputs
- Giá trị mặc định của
--[no]build_runfile_links
: "true" -
Nếu đúng, hãy tạo các khu vực liên kết tượng trưng cho các tệp runfile cho tất cả các mục tiêu. Nếu giá trị là false, chỉ ghi tệp kê khai khi có thể.
Thẻ:affects_outputs
- Giá trị mặc định của
--[no]build_runfile_manifests
: "true" -
Nếu đúng, hãy ghi các tệp kê khai runfile cho tất cả đích. Nếu sai, hãy bỏ qua các giá trị này. Kiểm thử cục bộ sẽ không chạy được khi giá trị là false.
Thẻ:affects_outputs
- Giá trị mặc định của
--[no]build_test_dwp
: "false" -
Nếu được bật, khi xây dựng các chương trình kiểm thử C++ theo cách tĩnh và phân phối, 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
- Giá trị mặc định của
--cc_proto_library_header_suffixes=<comma-separated list of options>
: ".pb.h" -
Đặt tiền tố của tệp tiêu đề mà cc_proto_library tạo.
Thẻ:affects_outputs
,loading_and_analysis
- Giá trị mặc định của
--cc_proto_library_source_suffixes=<comma-separated list of options>
: ".pb.cc" -
Đặt tiền tố của tệp nguồn mà cc_proto_library tạo.
Thẻ:affects_outputs
,loading_and_analysis
- Giá trị mặc định của
--[no]experimental_proto_descriptor_sets_include_source_info
: "false" -
Chạy các hành động bổ sung cho phiên bản API Java thay thế trong một proto_library.
Thẻ:affects_outputs
,loading_and_analysis
,experimental
- Giá trị mặc định của
--[no]experimental_proto_extra_actions
: "false" -
Chạy các hành động bổ sung cho phiên bản API Java thay thế trong một proto_library.
Thẻ:affects_outputs
,loading_and_analysis
,experimental
- Giá trị mặc định của
--[no]experimental_run_validations
: "true" -
Thay vào đó, hãy sử dụng --run_verifications.
Thẻ:execution
,affects_outputs
- Giá trị mặc định của
--[no]experimental_save_feature_state
: "false" -
Lưu trạng thái của các tính năng đã bật và được yêu cầu dưới dạng kết quả của quá trình biên dịch.
Thẻ:affects_outputs
,experimental
- Giá trị mặc định của
--[no]experimental_use_validation_aspect
: "false" -
Liệu có chạy hành động xác thực bằng cách sử dụng khía cạnh (để phát triển song song với kiểm thử) hay không.
Thẻ:execution
,affects_outputs
- Giá trị mặc định của
--fission=<a set of compilation modes>
: "không" -
Chỉ định chế độ biên dịch nào sử dụng phân hạch cho các đường liên kết và biên dịch C++. Có thể là bất kỳ tổ hợp nào của {'fastbuild', 'dbg', 'opt'} hoặc các giá trị đặc biệt "yes" để bật tất cả các chế độ và chọn "không" để tắt tất cả các chế độ.
Thẻ:loading_and_analysis
,action_command_lines
,affects_outputs
- Giá trị mặc định của
--[no]incompatible_always_include_files_in_data
: "true" -
Nếu đúng, các quy tắc gốc sẽ thêm <code>DefaultInfo.files</code> phần phụ thuộc dữ liệu vào các tệp chạy của chúng, khớp với hành vi được đề xuất cho quy tắc Starlark (https://bazel.build/extend/rules#runfiles_features_to_avoid).
Thẻ:affects_outputs
,incompatible_change
- Giá trị mặc định của
--[no]legacy_external_runfiles
: "true" -
Nếu đúng, hãy tạo các khu rừng symlink runfiles cho các kho lưu trữ bên ngoài trong .runfiles/wsname/external/repo (ngoài .runfiles/repo).
Thẻ:affects_outputs
- Giá trị mặc định của
--[no]objc_generate_linkmap
: "false" -
Chỉ định xem có tạo tệp sơ đồ liên kết hay không.
Thẻ:affects_outputs
--output_groups=<comma-separated list of options>
lần dùng được tích luỹ-
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 nhóm đầu ra có tiền tố + hoặc - (không bắt buộc). Một nhóm có tiền tố + 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ỉ tạo foo và bar.
Thẻ:execution
,affects_outputs
- Giá trị mặc định của
--[no]run_validations
: "true" -
Liệu có chạy các thao tác xác thực trong quá trình tạo bản dựng hay không. Hãy xem tại https://bazel.build/rules/rules#attributes_ actions
Thẻ:execution
,affects_outputs
- Giá trị mặc định của
--[no]save_temps
: "false" -
Nếu bạn đặt chính sách này, hệ thống sẽ lưu kết quả tạm thời từ gcc. Các tệp này bao gồm tệp .s (mã trình tập hợp), tệp .i (tệp C đã xử lý trước) và tệp .ii (mã C++ được xử lý trước).
Thẻ:affects_outputs
- Các tuỳ chọn cho phép người dùng định cấu hình đầu ra dự kiến, ảnh hưởng đến giá trị của đầu ra đó, trái ngược với sự tồn tại của đầu ra đó:
--action_env=<a 'name=value' assignment with an optional value part>
lần dùng được tích luỹ-
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. Biến có thể được chỉ định theo tên. Trong trường hợp đó, giá trị sẽ được lấy từ môi trường gọi hoặc bằng cặp name=value sẽ đặ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; cho các lựa chọn được cung cấp cho cùng một biến, các biến mới nhất sẽ chiến thắng, các tuỳ 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
- Giá trị mặc định của
--[no]android_databinding_use_androidx
: "false" -
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 dùng với tính năng liên kết dữ liệu phiên bản 2.
Thẻ:affects_outputs
,loading_and_analysis
,loses_incremental_state
,experimental
- Giá trị mặc định của
--[no]android_databinding_use_v3_4_args
: "false" -
Sử dụng liên kết dữ liệu Android phiên bản 2 với đối số 3.4.0
Thẻ:affects_outputs
,loading_and_analysis
,loses_incremental_state
,experimental
- Giá trị 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 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 đủ' nghĩa là tất cả thư viện sẽ được liên kết động. "off" 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
- Mặc định của
--android_manifest_merger_order=<alphabetical, alphabetical_by_configuration or dependency>
: "theo thứ tự bảng chữ cái" -
Thiết lập thứ tự của 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. ALPHABETICS nghĩa là tệp kê khai được sắp xếp theo đường dẫn tương ứng với tập lệnh thực thi. ALPHABETICS_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 nghĩa là các tệp kê khai được sắp xếp theo thứ tự của từng tệp kê khai của thư viện đến trước tệp kê khai của các phần phụ thuộc.
Thẻ:action_command_lines
,execution
- Giá trị mặc định của
--[no]android_resource_shrinking
: "false" -
Bật tính năng rút gọn tài nguyên cho các APK android_binary sử dụng ProGuard.
Thẻ:affects_outputs
,loading_and_analysis
--apple_bitcode=<'mode' or 'platform=mode', where 'mode' is none, embedded_markers or embedded, and 'platform' is ios, watchos, tvos, macos or catalyst>
lần dùng được tích luỹ-
Chỉ định chế độ mã bit của Apple cho các bước biên dịch nhắm đến kiến trúc thiết bị. Giá trị có dạng "[platform=]mode", trong đó nền tảng (phải là "ios", "macos", "tvos" hoặc "watchos"). Nếu được cung cấp, chế độ mã bit sẽ được áp dụng riêng cho nền tảng đó; nếu bạn bỏ qua thì chính sách này sẽ áp dụng cho mọi nền tảng. Chế độ phải là "none", "embedded_markers" hoặc "được nhúng". Bạn có thể cung cấp lựa chọn này nhiều lần.
Thẻ:loses_incremental_state
--aspects=<comma-separated list of options>
lần dùng được tích luỹ- Danh sách các khía cạnh được phân tách bằng dấu phẩy sẽ được áp dụng cho các 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 qua required_aspect_providers, thì some_aspect sẽ chạy sau mọi khía cạnh được đề cập trước đó trong danh sách khía cạnh mà nhà cung cấp được quảng cáo đáp ứng một số nhà cung cấp khía cạnh bắt buộc. Hơn nữa, some_aspect sẽ chạy sau tất cả các khía cạnh bắt buộc do thuộc tính yêu cầu chỉ định. some_aspect sau đó sẽ có quyền truy cập vào giá trị của các khía cạnh đó Google Cloud. <bzl-file-label>%<aspect_name>, ví dụ: '//tools:my_def.bzl%my_aspect', trong đó 'my_aspect' là giá trị cấp cao nhất từ tệp tools/my_def.bzl
- Giá trị mặc định của
--[no]build_python_zip
: "tự động" -
Tạo tệp zip có thể thực thi python; trên Windows, tắt trên các nền tảng khác
Thẻ:affects_outputs
--catalyst_cpus=<comma-separated list of options>
lần dùng được tích luỹ-
Danh sách các cấu trúc được phân tách bằng dấu phẩy để tạo tệp nhị phân Apple Catalyst.
Thẻ:loses_incremental_state
,loading_and_analysis
- Giá trị mặc định của
--[no]collect_code_coverage
: "false" -
Nếu được chỉ định, Bazel sẽ đo lường mã (sử dụng tính năng đo lường ngoại tuyến nếu có thể) và thu thập thông tin về mức độ sử dụng trong quá trình kiểm thử. Chỉ các mục tiêu khớp với --Instrumentation_filter mới bị ảnh hưởng. Thông thường, bạn không nên chỉ định trực tiếp tuỳ chọn này – "mức độ phủ sóng bazel" thay thế bằng lệnh.
Thẻ:affects_outputs
--compilation_mode=<fastbuild, dbg or opt>
[-c
] mặc định: "fastbuild"-
Chỉ định chế độ tạo tệp nhị phân. Giá trị: "fastbuild", "dbg", "opt".
Thẻ:affects_outputs
,action_command_lines
,explicit_in_output_path
--conlyopt=<a string>
lần dùng được tích luỹ-
Tuỳ chọn bổ sung để truyền đến gcc khi biên dịch tệp nguồn C.
Thẻ:action_command_lines
,affects_outputs
--copt=<a string>
lần dùng được tích luỹ-
Các tuỳ chọn khác để chuyển sang gcc.
Thẻ:action_command_lines
,affects_outputs
- Giá trị mặc định của
--cpu=<a string>
: "" -
CPU mục tiêu.
Thẻ:changes_inputs
,affects_outputs
,explicit_in_output_path
- Mặc định
--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
--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à(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
--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 được dùng cho mục đích tối ưu hoá.
Thẻ:affects_outputs
--cxxopt=<a string>
lần dùng được tích luỹ-
Tuỳ chọn bổ sung để truyền đến gcc khi biên dịch tệp nguồn C++.
Thẻ:action_command_lines
,affects_outputs
--define=<a 'name=value' assignment>
lần dùng được tích luỹ-
Mỗi tuỳ chọn --defined chỉ định một phép 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 động hay không. 'đầy đủ' nghĩa là tất cả thư viện sẽ được liên kết động. "off" 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
- Giá trị mặc định của
--[no]enable_fdo_profile_absolute_path
: "true" -
Nếu bạn đặt chính sách này, việc sử dụng fdo_ Apps_profile_path sẽ gây ra lỗi.
Thẻ:affects_outputs
- Giá trị mặc định của
--[no]enable_runfiles
: "tự động" -
Bật cây liên kết tượng trưng của các tệp runfile; Theo mặc định, tính năng này sẽ bị tắt trên Windows và trên các nền tảng khác.
Thẻ:affects_outputs
--experimental_action_listener=<a build target label>
lần dùng được tích luỹ-
Ngừng sử dụng và ưu tiên các khía cạnh. Sử dụng action_listener để đính kèm extra_action vào các thao tác hiện có đối với bản dựng.
Thẻ:execution
,experimental
- Giá trị mặc định của
--[no]experimental_android_compress_java_resources
: "false" -
Nén tài nguyên Java trong APK
Thẻ:affects_outputs
,loading_and_analysis
,experimental
- Giá trị mặc định của
--[no]experimental_android_databinding_v2
: "false" -
Dùng tính năng liên kết dữ liệu Android phiên bản 2
Thẻ:affects_outputs
,loading_and_analysis
,loses_incremental_state
,experimental
- Giá trị mặc định của
--[no]experimental_android_resource_shrinking
: "false" -
Bật tính năng rút gọn tài nguyên cho các APK android_binary sử dụng ProGuard.
Thẻ:affects_outputs
,loading_and_analysis
- Giá trị mặc định của
--[no]experimental_android_rewrite_dexes_with_rex
: "false" -
dùng công cụ rex để viết lại các tệp dex
Thẻ:affects_outputs
,loading_and_analysis
,loses_incremental_state
,experimental
- Mặc định của
--[no]experimental_convenience_symlinks
: "bình thường" -
Cờ này kiểm soát cách quản lý các đường liên kết tượng trưng 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 bản dựng). Các giá trị có thể có:
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 liên kết tượng trưng sẽ bị xoá vô điều kiện.
bỏ qua: Đường liên kết ký hiệu sẽ được để lại.
log_only: Tạo thông điệp nhật ký như thể "normal" (bình thường) được chuyển nhưng không thực sự thực hiện bất kỳ thao tác nào đối với hệ thống tệp (hữu ích cho các công cụ).
Xin lưu ý rằng chỉ các đường liên kết tượng trưng có tên được tạo bằng giá trị hiện tại của --symlink_prefix mới có thể bị ảnh hưởng; nếu tiền tố thay đổi, mọi liên kết tượng trưng có sẵn sẽ được để nguyên.
Thẻ:affects_outputs
- Giá trị mặc định của
--[no]experimental_convenience_symlinks_bep_event
: "false" -
Cờ này kiểm soát việc chúng tôi có đăng sự kiện bản dựng tiện ích SymlinksIdentified lên BuildEventProtocol hay không. Nếu giá trị này là true, BuildEventProtocol sẽ có một mục cho tiện íchSymlinksIdentified, liệt kê tất cả các symlink 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, mục tiện íchSymlinksIdentified trong BuildEventProtocol sẽ bị trống.
Thẻ:affects_outputs
--experimental_multi_cpu=<comma-separated list of options>
lần dùng được tích luỹ-
Không được dùng nữa. Không hoạt động.
Thẻ:affects_outputs
,experimental
- Giá trị 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 nhanh objc.
Thẻ:action_command_lines
- Giá trị mặc định của
--[no]experimental_omitfp
: "false" -
Nếu giá trị là true, hãy sử dụng libunwind để gỡ bỏ ngăn xếp và biên dịch bằng -fomit-frame-pointer và -faĐồng bộ-unwind-tables.
Thẻ:action_command_lines
,affects_outputs
,experimental
- Giá trị mặc định của
--[no]experimental_platform_in_output_dir
: "false" -
Nếu đúng, nền tảng mục tiêu sẽ được dùng trong tên thư mục đầu ra thay vì CPU.
Thẻ:affects_outputs
,experimental
- Giá trị mặc định của
--[no]experimental_use_llvm_covmap
: "false" -
Nếu được chỉ định, Bazel sẽ tạo thông tin bản đồ về phạm vi bao phủ llvm-cov thay vì gcov khi chế độ collection_code_Coverage được bật.
Thẻ:changes_inputs
,affects_outputs
,loading_and_analysis
,experimental
- Giá trị mặc định của
--fat_apk_cpu=<comma-separated list of options>
: "armeabi-v7a" -
Việc đặt tuỳ chọn này sẽ bật các tệp APK lớn, chứa tệp nhị phân gốc cho tất cả cấu trúc mục tiêu được chỉ định, chẳng hạn như --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
- Giá trị 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
--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à(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
--fdo_optimize=<a string>
: xem nội dung mô tả -
Sử dụng thông tin cấu hình 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 thêm một lệnh "exports_files" vào gói tương ứng) và các nhãn trỏ đến các 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
--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
--fdo_profile=<a build target label>
: xem nội dung mô tả -
fdo_profile đại diện cho hồ sơ được dùng cho hoạt động tối ưu hoá.
Thẻ:affects_outputs
--features=<a string>
lần dùng được tích luỹ-
Các tính năng nhất định sẽ được bật hoặc tắt theo mặc định cho các mục tiêu được tạo trong cấu hình mục tiêu. Chỉ định -<feature> sẽ tắt tính năng này. Các đối tượng phủ định luôn được ưu tiên hơn các đối tượng khẳng định. Xem thêm --host_features
Thẻ:changes_inputs
,affects_outputs
- Giá trị mặc định của
--[no]force_pic
: "false" -
Nếu được bật, tất cả phần biên dịch C++ sẽ tạo ra mã độc lập với vị trí ("-fPIC"), các đường liên kết sẽ ưu tiên thư viện PIC dựng sẵn hơn là thư viện không phải PIC và các đường liên kết tạo ra các tệp thực thi độc lập với vị trí ("-pie").
Thẻ:loading_and_analysis
,affects_outputs
--host_action_env=<a 'name=value' assignment with an optional value part>
lần dùng được tích luỹ-
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áy chủ lưu trữ hoặc thực thi. Biến có thể được chỉ định theo tên. Trong trường hợp đó, giá trị sẽ được lấy từ môi trường gọi hoặc bằng cặp name=value sẽ đặ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; cho các lựa chọn được cung cấp cho cùng một biến, các biến mới nhất sẽ chiến thắng, các tuỳ 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
--host_compilation_mode=<fastbuild, dbg or opt>
: "tối ưu hoá" -
Chỉ định chế độ tích hợp cho các công cụ dùng trong quá trình tạo bản dựng. Giá trị: "fastbuild", "dbg", "opt".
Thẻ:affects_outputs
,action_command_lines
--host_conlyopt=<a string>
lần dùng được tích luỹ-
Tuỳ chọn bổ sung để truyền đến gcc khi biên dịch tệp nguồn C cho công cụ lưu trữ.
Thẻ:action_command_lines
,affects_outputs
--host_copt=<a string>
lần dùng được tích luỹ-
Các tuỳ chọn khác để chuyển sang gcc cho công cụ lưu trữ.
Thẻ:action_command_lines
,affects_outputs
- Giá trị mặc định của
--host_cpu=<a string>
: "" -
CPU máy chủ.
Thẻ:changes_inputs
,affects_outputs
--host_cxxopt=<a string>
lần dùng được tích luỹ-
Các tuỳ chọn khác để chuyển sang gcc cho công cụ lưu trữ.
Thẻ:action_command_lines
,affects_outputs
--host_features=<a string>
lần dùng được tích luỹ-
Các tính năng nhất định sẽ được bật hoặc tắt theo mặc định đối với các mục tiêu được tạo trong cấu hình thực thi. Chỉ định -<feature> sẽ tắt tính năng này. Các đối tượng phủ định luôn được ưu tiên hơn các đối tượng khẳng định.
Thẻ:changes_inputs
,affects_outputs
- Mặc định
--host_force_python=<PY2 or PY3>
: xem nội dung mô tả -
Ghi đè phiên bản Python cho cấu hình máy chủ lưu trữ. Có thể là "PY2" hoặc "PY3".
Thẻ:loading_and_analysis
,affects_outputs
--host_linkopt=<a string>
lần dùng được tích luỹ-
Tuỳ chọn bổ sung để chuyển sang gcc khi liên kết các công cụ lưu trữ.
Thẻ:action_command_lines
,affects_outputs
- Mặc định
--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 đích lưu trữ. Nếu bạn chưa chỉ định, hãy sử dụng "macos_sdk_version".
Thẻ:loses_incremental_state
--host_per_file_copt=<a comma-separated list of regex expressions with prefix '-' specifying excluded paths followed by an @ and a comma separated list of options>
lần dùng được tích luỹ-
Các tuỳ chọn bổ sung để truyền có chọn lọc đến trình biên dịch C/C++ khi biên dịch một số tệp nhất định trong cấu hình máy chủ lưu trữ hoặc thực thi. Bạn có thể bỏ qua lựa chọn này nhiều lần. Cú pháp: regex_filter@option_1,option_2,...,option_n. Trong đó regex_filter là danh sách các mẫu biểu thức chính quy bao gồm và loại trừ (Xem thêm --Instrumentation_filter). 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 chứa dấu phẩy, thì tuỳ chọn đó phải nằm trong dấu gạch chéo ngược. Các tuỳ chọn có thể chứa @. Chỉ có ký tự @ đầu tiên dùng để phân tách chuỗi. Ví dụ: --host_per_file_copt=//foo/.*\.cc,-//foo/bar\.cc@-O0 sẽ thêm tuỳ chọn dòng lệnh -O0 vào dòng lệnh gcc của tất cả các tệp cc trong //foo/ ngoại trừ bar.cc.
Thẻ:action_command_lines
,affects_outputs
--host_swiftcopt=<a string>
lần dùng được tích luỹ-
Các tuỳ chọn bổ sung để chuyển đến swimaker cho các công cụ lưu trữ.
Thẻ:action_command_lines
,affects_outputs
- Giá trị mặc định của
--[no]incompatible_avoid_conflict_dlls
: "true" -
Nếu được bật, tất cả các thư viện được liên kết động (DLL) C++ do cc_library trên Windows tạo sẽ được đổi tên thành name_{hash}.dll trong đó hàm băm được tính toán dựa trên RepositoryName và đường dẫn gói của DLL. Tuỳ chọn này rất hữu ích khi bạn có một gói phụ thuộc vào một số cc_library có cùng tên (ví dụ: //foo/bar1:utils và //foo/bar2:utils).
Thẻ:loading_and_analysis
,affects_outputs
,incompatible_change
- Giá trị mặc định của
--[no]incompatible_merge_genfiles_directory
: "true" -
Nếu là true, thư mục genfiles sẽ được thu gọn vào thư mục bin.
Thẻ:affects_outputs
,incompatible_change
- Giá trị mặc định của
--[no]incompatible_use_host_features
: "false" -
Nếu đúng, chỉ sử dụng --features cho cấu hình mục tiêu và --host_features cho cấu hình thực thi.
Thẻ:changes_inputs
,affects_outputs
,incompatible_change
- Giá trị mặc định của
--[no]incompatible_use_platforms_repo_for_constraints
: "true" -
Nếu là true, các chế độ cài đặt quy tắc ràng buộc trong @bazel_tools sẽ bị xoá.
Thẻ:affects_outputs
,incompatible_change
- Giá trị mặc định của
--[no]instrument_test_targets
: "false" -
Khi mức độ sử dụng được bật, hãy chỉ định xem có cân nhắc việc đo lường các quy tắc kiểm thử hay không. Khi được đặt, các quy tắc kiểm thử do --Instrumentation_filter đưa vào 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 phạm vi.
Thẻ:affects_outputs
- Giá trị 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 nằm trong bộ lọc dựa trên biểu thức chính quy được chỉ định mới được đo lường. Các quy tắc có tiền tố là "-" bị loại trừ. Lưu ý rằng chỉ các quy tắc không kiểm thử mới được đo lường trừ khi bật --Instrument_test_targets.
Thẻ:affects_outputs
- Mặc định
--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 mục tiêu và thiết bị. Nếu bạn chưa chỉ định, hãy sử dụng "ios_sdk_version".
Thẻ:loses_incremental_state
--ios_multi_cpus=<comma-separated list of options>
lần dùng được tích luỹ-
Danh sách cấu 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
- Giá trị mặc định của
--[no]legacy_whole_archive
: "true" -
Không dùng nữa và được thay thế bằng --incompatible_remove_legacy_w tuyển_lưu trữ (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 tuyển-lưu trữ cho các quy tắc cc_binary có linkshared=True và linkstatic=True hoặc '-static' trong liên kết. Điều này chỉ dành cho khả năng tương thích ngược. Một cách khác tốt hơn là sử dụng chiến lược Alwayslink=1 nếu cần.
Thẻ:action_command_lines
,affects_outputs
,deprecated
--linkopt=<a string>
lần dùng được tích luỹ-
Tuỳ chọn bổ sung để chuyển sang gcc khi liên kết.
Thẻ:action_command_lines
,affects_outputs
--ltobackendopt=<a string>
lần dùng được tích luỹ-
Tuỳ chọn bổ sung để chuyển đến bước phụ trợ LTO (trong --features=thin_lto).
Thẻ:action_command_lines
,affects_outputs
--ltoindexopt=<a string>
lần dùng được tích luỹ-
Tuỳ chọn bổ sung để chuyển đến bước lập chỉ mục LTO (trong --features=thin_lto).
Thẻ:action_command_lines
,affects_outputs
--macos_cpus=<comma-separated list of options>
lần dùng được tích luỹ-
Danh sách được phân tách bằng dấu phẩy gồm các kiến trúc dùng để tạo tệp nhị phân macOS của Apple.
Thẻ:loses_incremental_state
,loading_and_analysis
- Mặc định
--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 các mục tiêu. Nếu bạn chưa chỉ định, hãy sử dụng "macos_sdk_version".
Thẻ:loses_incremental_state
- Giá trị mặc định của
--[no]objc_debug_with_GLIBCXX
: "false" -
Nếu được đặt và chế độ biên dịch được đặt thành 'dbg', hãy xác định GLIBCXX_DEBUG, GLIBCXX_DEBUG_PEDANTIC và GLIBCPP_CONVERSION_KIỂM TRA.
Thẻ:action_command_lines
- Giá trị mặc định của
--[no]objc_enable_binary_stripping
: "false" -
Liệu có thực hiện việc xoá biểu tượng và mã chết trên các tệp nhị phân được liên kết hay không. Việc loại bỏ tệp nhị phân sẽ được thực hiện nếu cả cờ này và --compilation_mode=opt được chỉ định.
Thẻ:action_command_lines
--objccopt=<a string>
lần dùng được tích luỹ-
Các tuỳ chọn bổ sung để truyền đến gcc khi biên dịch tệp nguồn Target-C/C++.
Thẻ:action_command_lines
--per_file_copt=<a comma-separated list of regex expressions with prefix '-' specifying excluded paths followed by an @ and a comma separated list of options>
lần dùng được tích luỹ-
Các tuỳ chọn bổ sung để truyền có chọn lọc đến gcc khi biên dịch một số tệp nhất định. Bạn có thể bỏ qua lựa chọn này nhiều lần. Cú pháp: regex_filter@option_1,option_2,...,option_n. Trong đó regex_filter là danh sách các mẫu biểu thức chính quy bao gồm và loại trừ (Xem thêm --Instrumentation_filter). 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 chứa dấu phẩy, thì tuỳ chọn đó phải nằm trong dấu gạch chéo ngược. Các tuỳ chọn có thể chứa @. Chỉ có ký tự @ đầu tiên dùng để phân tách chuỗi. Ví dụ: --per_file_copt=//foo/.*\.cc,-//foo/bar\.cc@-O0 sẽ 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
--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 dùng được tích luỹ-
Các tuỳ chọn bổ sung để chuyển có chọn lọc đến phần phụ trợ LTO (trong --features=thin_lto) khi biên dịch một số đối tượng phụ trợ nhất định. Bạn có thể bỏ qua lựa chọn này nhiều lần. Cú pháp: regex_filter@option_1,option_2,...,option_n. Trong đó regex_filter là danh sách các mẫu biểu thức chính quy bao gồm và loại trừ. 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 chứa dấu phẩy, thì tuỳ chọn đó phải nằm trong dấu gạch chéo ngược. Các tuỳ chọn có thể chứa @. Chỉ có ký tự @ đầu tiên dùng để phân tách chuỗi. Ví dụ: --per_file_ltobackendopt=//foo/.*\.o,-//foo/bar\.o@-O0 sẽ thêm tuỳ chọn dòng lệnh -O0 vào dòng lệnh phụ trợ LTO của tất cả các tệp o trong //foo/ ngoại trừ bar.o.
Thẻ:action_command_lines
,affects_outputs
- Mặc định
--platform_suffix=<a string>
: xem nội dung mô tả -
Chỉ định một hậu tố cần thêm vào thư mục cấu hình.
Thẻ:loses_incremental_state
,affects_outputs
,loading_and_analysis
- Mặc định
--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.Hồ sơ cánh quạt phải bao gồm ít nhất 1 trong 2 tệp là hồ sơ cc và hồ sơ ld. Cờ này chấp nhận một nhãn bản dựng tham chiếu đến các tệp đầu vào của hồ sơ chân vị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ể thêm lệnh export_files vào gói tương ứng để hiển thị những tệp này cho Bazel. Tuỳ chọn này phải được sử dụng dưới dạng: --propeller_optimize=//a/b:propeller_profile
Thẻ:action_command_lines
,affects_outputs
- Mặc định
--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 Propeller tối ưu hoá.
Thẻ:affects_outputs
- Mặc định
--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 Propeller.
Thẻ:affects_outputs
- Mặc định
--run_under=<a prefix in front of command>
: xem nội dung mô tả -
Tiền tố để chèn trước tệp thực thi cho "test" (kiểm thử) và 'chạy' các lệnh. 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 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
-
Nếu đúng, các thư viện gốc có chức năng giống nhau sẽ được chia sẻ giữa các đích khác nhau
Thẻ:loading_and_analysis
,affects_outputs
- Giá trị mặc định của
--[no]stamp
: "false" -
Đóng dấu các tệp nhị phân có 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ó bỏ tệp nhị phân và thư viện dùng chung hay không (sử dụng "-Wl,--strip-debug"). Giá trị mặc định của 'đôi khi' có nghĩa là xoá iff --compilation_mode=fastbuild.
Thẻ:affects_outputs
--stripopt=<a string>
lần dùng được tích luỹ-
Các tuỳ chọn bổ sung để chuyển sang dải khi tạo '<name>.stripped' nhị phân.
Thẻ:action_command_lines
,affects_outputs
--swiftcopt=<a string>
lần dùng được tích luỹ-
Các tuỳ chọn bổ sung để chuyển sang quá trình biên dịch Swift.
Thẻ:action_command_lines
- Mặc định
--symlink_prefix=<a string>
: xem nội dung mô tả -
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 một bản dựng. Nếu bỏ qua, giá trị mặc định là tên của công cụ xây dựng, theo sau là dấu gạch nối. Nếu "/" thì sẽ không có liên kết tượng trưng nào được tạo và không đưa ra cảnh báo nào. Cảnh báo: chức năng đặc biệt cho '/' sẽ sớm không được dùng nữa; thay vào đó, hãy sử dụng --experimental_ Lienience_symlinks=ignore.
Thẻ:affects_outputs
--tvos_cpus=<comma-separated list of options>
lần dùng được tích luỹ-
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 tvOS.
Thẻ:loses_incremental_state
,loading_and_analysis
- Mặc định
--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 mục tiêu và thiết bị. Nếu bạn chưa chỉ định, hãy sử dụng "tvos_sdk_version".
Thẻ:loses_incremental_state
--watchos_cpus=<comma-separated list of options>
lần dùng được tích luỹ-
Danh sách các cấu trúc được phân tách bằng dấu phẩy để tạo tệp nhị phân Apple watchOS.
Thẻ:loses_incremental_state
,loading_and_analysis
- Mặc định
--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 các trình mô phỏng và thiết bị mục tiêu. Nếu bạn chưa chỉ định, hãy sử dụng "watchos_sdk_version".
Thẻ:loses_incremental_state
- Mặc định
--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, các tuỳ chọn đó sẽ luôn chiếm ưu thế như thể xbinary_fdo không bao giờ được chỉ định.
Thẻ:affects_outputs
- Các lựa chọn ảnh hưởng đến mức độ nghiêm ngặt của Bazel trong việc thực thi dữ liệu đầu vào bản dựng hợp lệ (định nghĩa quy tắc, tổ hợp cờ, v.v.):
- Giá trị mặc định của
--auto_cpu_environment_group=<a build target label>
: "" -
Khai báo environment_group để tự động liên kết các giá trị cpu với các giá trị target_environment.
Thẻ:changes_inputs
,loading_and_analysis
,experimental
- Giá trị mặc định của
--[no]check_licenses
: "false" -
Kiểm tra để đảm bảo rằng những 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 mục tiêu đang được tạo. Theo mặc định, giấy phép không được chọn.
Thẻ:build_file_semantics
- Giá trị mặc định của
--[no]check_visibility
: "true" -
Nếu bạn tắt chính sách này, lỗi hiển thị trong các phần phụ thuộc mục tiêu sẽ bị giảm hạng xuống thành cảnh báo.
Thẻ:build_file_semantics
- Giá trị mặc định của
--[no]desugar_for_android
: "true" -
Liệu có đơn giản hoá mã byte Java 8 trước khi tạo tệp dex hay không.
Thẻ:affects_outputs
,loading_and_analysis
,loses_incremental_state
- Giá trị mặc định của
--[no]desugar_java8_libs
: "false" -
Liệu có đưa các thư viện Java 8 được hỗ trợ vào ứng dụng dành cho thiết bị cũ hay không.
Thẻ:affects_outputs
,loading_and_analysis
,loses_incremental_state
,experimental
- Giá trị mặc định của
--[no]enforce_constraints
: "true" -
Kiểm tra môi trường mà mỗi mục tiêu tương thích và báo cáo lỗi nếu có mục tiêu có các phần phụ thuộc không hỗ trợ cùng một môi trường
Thẻ:build_file_semantics
- Giá trị mặc định của
--[no]experimental_allow_android_library_deps_without_srcs
: "false" -
Gắn cờ để giúp chuyển đổi từ trạng thái cho phép không cho phép các quy tắc srcs-less android_library có phần phụ thuộc. Bạn cần dọn dẹp kho chứa để triển khai theo mặc định.
Thẻ:eagerness_to_exit
,loading_and_analysis
- Giá trị mặc định của
--[no]experimental_check_desugar_deps
: "true" -
Liệu có kiểm tra kỹ quá trình đơn giản hoá chính xác ở cấp độ nhị phân 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 aar_import đã hoàn tất hay chưa. Hành động thực thi này có thể làm hỏng bản dựng hoặc chỉ dẫn đến cảnh báo.
Thẻ:loading_and_analysis
- Mặc định của
--experimental_strict_java_deps=<off, warn, error, strict or default>
: "mặc định" -
Nếu giá trị là true (đúng), hãy kiểm tra để đảm bảo rằng một mục tiêu Java khai báo rõ ràng tất cả các mục tiêu được sử dụng trực tiếp dưới dạng phần phụ thuộc.
Thẻ:build_file_semantics
,eagerness_to_exit
- Giá trị mặc định của
--[no]incompatible_check_testonly_for_output_files
: "false" -
Nếu được bật, hãy kiểm tra chỉ kiểm thử cho các mục tiêu điều kiện tiên quyết là tệp đầu ra bằng cách tra cứu chỉ kiểm thử của quy tắc đang tạo. Điều này khớp với quy trình kiểm tra khả năng hiển thị.
Thẻ:build_file_semantics
,incompatible_change
- Giá trị mặc định của
--[no]incompatible_disable_native_android_rules
: "false" -
Nếu được bật, việc sử dụng trực tiếp quy tắc Android gốc sẽ bị tắt. Vui lòng sử dụng các quy tắc Starlark Android tại https://github.com/bazelbuild/rules_android
Thẻ:eagerness_to_exit
,incompatible_change
- Giá trị mặc định của
--[no]incompatible_disable_native_apple_binary_rule
: "false" -
Không hoạt động. Được giữ lại ở đây để có khả năng tương thích ngược.
Thẻ:eagerness_to_exit
,incompatible_change
- Giá trị mặc định của
--[no]incompatible_force_strict_header_check_from_starlark
: "true" -
Nếu được bật, hãy đặt kiểm tra tiêu đề nghiêm ngặt trong API Starlark
Thẻ:loading_and_analysis
,changes_inputs
,incompatible_change
- Giá trị mặc định của
--[no]incompatible_validate_top_level_header_inclusions
: "true" -
Nếu đúng, Bazel cũng sẽ xác thực việc bao gồm 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
- Giá trị 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 tệp vượt qua ranh giới gói sẽ được báo cáo là lỗi. Tính năng này không hoạt động khi bạn tắt check_fileset_Dependencies_recursively.
Thẻ:build_file_semantics
,eagerness_to_exit
- Giá trị mặc định của
--strict_proto_deps=<off, warn, error, strict or default>
: "lỗi" -
Trừ phi bị 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ả 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
- Giá trị mặc định của
--strict_public_imports=<off, warn, error, strict or default>
: "tắt" -
Trừ phi bị TẮT, các hoạt động kiểm tra để đảm bảo mục tiêu proto_library khai báo rõ ràng tất cả mục tiêu dùng trong lệnh "nhập công khai" dưới dạng được xuất.
Thẻ:build_file_semantics
,eagerness_to_exit
,incompatible_change
- Giá trị mặc định của
--[no]strict_system_includes
: "false" -
Nếu đúng thì tiêu đề được tìm thấy qua hệ thống bao gồm cả đường dẫn (-isystem) cũng bắt buộc phải được khai báo.
Thẻ:loading_and_analysis
,eagerness_to_exit
--target_environment=<a build target label>
lần dùng được tích luỹ-
Khai báo môi trường mục tiêu của bản dựng này. Phải là mục tham chiếu nhãn đến một "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 được sử dụng để ký tệp APK
Thẻ:action_command_lines
,affects_outputs
,loading_and_analysis
- Giá trị mặc định của
--[no]device_debug_entitlements
: "true" -
Nếu được đặt và chế độ biên dịch không phải là "opt", ứng dụng objc sẽ bao gồm các quyền gỡ lỗi khi ký.
Thẻ:changes_inputs
- Mặc định
--ios_signing_cert_name=<a string>
: xem nội dung mô tả -
Tên chứng chỉ sẽ dù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à tùy chọn nhận dạng chuỗi khóa của chứng chỉ hoặc (chuỗi con) trong tên chung của chứng chỉ, như theo trang người dùng của ký hiệu 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 các tệp BUILD, tệp .bzl hoặc tệp WORKSPACE.:
- Giá trị mặc định của
--[no]incompatible_config_setting_private_default_visibility
: "false" -
Nếu không tương thích_enforce_config_setting_ visibility=false, thì đây là lỗi không hiển thị. Ngược lại, nếu cờ này là false, mọi chế độ cài đặt config_setting không có thuộc tính mức độ hiển thị rõ ràng sẽ là //visibility:public. Nếu cờ này là true, chế độ cài đặt config_setting sẽ tuân theo cùng một logic về chế độ hiển thị như mọi quy tắc khác. Truy cập https://github.com/bazelbuild/bazel/issues/12933.
Thẻ:loading_and_analysis
,incompatible_change
- Giá trị mặc định của
--[no]incompatible_disallow_legacy_py_provider
: "true" -
Không hoạt động, sẽ sớm bị xoá.
Thẻ:loading_and_analysis
,incompatible_change
- Giá trị mặc định của
--[no]incompatible_enforce_config_setting_visibility
: "true" -
Nếu là true, hãy thực thi các quy định hạn chế về chế độ hiển thị bằng lệnh config_setting. Nếu đặt là false, mọi chế độ cài đặt config_ đều hiển thị với mọi mục tiêu. Truy cập 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ử:
- Giá trị mặc định của
--[no]allow_analysis_failures
: "false" -
Nếu đúng, lỗi phân tích của một mục tiêu quy tắc sẽ dẫn đến việc mục tiêu truyền một bản sao của AnalysisFailureInfo có chứa nội dung mô tả lỗi, thay vì dẫn đến lỗi bản dựng.
Thẻ:loading_and_analysis
,experimental
- Giá trị mặc định của
--analysis_testing_deps_limit=<an integer>
: "2000" -
Đặt số lượng tối đa các phần phụ thuộc bắc cầu thông qua một thuộc tính quy tắc có chuyển đổi cấu hình for_analysis_testing. Việc vượt quá giới hạn này sẽ dẫn đến lỗi quy tắc.
Thẻ:loading_and_analysis
- Giá trị mặc định của
--[no]break_build_on_parallel_dex2oat_failure
: "false" -
Nếu lỗi hành động dex2oat thực sự không thành công sẽ khiến bản dựng bị lỗi thay vì thực thi dex2oat trong thời gian chạy kiểm thử.
Thẻ:loading_and_analysis
,experimental
- Giá trị mặc định của
--[no]check_tests_up_to_date
: "false" -
Đừng chạy thử nghiệm, chỉ cần kiểm tra xem các kết quả đó đã được cập nhật hay chưa. Nếu tất cả kết quả kiểm thử đều là thông tin mới nhất, thì quá trình kiểm thử sẽ hoàn tất thành công. Nếu cần xây dựng hoặc thực thi kiểm 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
- Giá trị mặc định của
--[no]experimental_android_use_parallel_dex2oat
: "false" -
Sử dụng song song dex2oat để có thể tăng tốc android_test.
Thẻ:loading_and_analysis
,host_machine_resource_optimizations
,experimental
--flaky_test_attempts=<a positive integer, the string "default", or test_regex@attempts. This flag may be passed more than once>
lần dùng được tích luỹ-
Nếu có thất bại trong kiểm thử, hệ thống sẽ thử lại mỗi lượt kiểm thử theo số lần đã chỉ định. Những bài kiểm tra yêu cầu nhiều lần vượt qua sẽ được đánh dấu là "FLAKY" trong phần tóm tắt kiểm thử. Thông thường, giá trị được chỉ định chỉ là một số nguyên hoặc chuỗi "default". Nếu là số nguyên thì tất cả chương trình kiểm thử sẽ được chạy tối đa N lần. Nếu là "default" thì sẽ chỉ có một lần kiểm thử duy nhất được thực hiện cho các kiểm thử thông thường và ba lần kiểm thử cho các kiểm thử được đánh dấu rõ ràng là không ổn định theo quy tắc của chúng (thuộc tính không ổn định=1). Cú pháp thay thế: regex_filter@flaky_test_inappropriates. Trong đó flaky_test_attempts như trên và regex_filter đại diện cho danh sách các mẫu biểu thức chính quy bao gồm và loại trừ (Xem thêm --runs_per_test). Ví dụ: --flaky_test_attempts=//foo/.*,-//foo/bar/.*@3 deflakes tất cả các lượt kiểm thử trong //foo/, ngoại trừ những lượt kiểm thử dưới foo/bar ba lần. Bạn có thể bỏ qua lựa chọn này nhiều lần. Đối số được truyền gần đây nhất phù hợp sẽ được ưu tiên. Nếu không có kết quả nào phù hợp, thì hành vi sẽ như là "mặc định" ở trên.
Thẻ:execution
- Giá trị mặc định của
--[no]ios_memleaks
: "false" -
Bật tính năng kiểm tra xem có rò rỉ bộ nhớ trong mục tiêu ios_test không.
Thẻ:action_command_lines
- Mặc định
--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ụ: "iPhone 6". Bạn có thể xem danh sách thiết bị bằng cách chạy "xcrun simctl list devicetypes" trên máy đó.
Thẻ:test_runner
- Mặc định
--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 thử nghiệm. Tham số này 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
- Giá trị mặc định của
--local_test_jobs=<an integer, or a keyword ("auto", "HOST_CPUS", "HOST_RAM"), optionally followed by an operation ([-|*]<float>) eg. "auto", "HOST_CPUS*.5">
: "tự động" -
Số lượng công việc kiểm thử cục bộ tối đa để chạy đồng thời. Lấy một số nguyên hoặc một từ khoá ("auto", "HOST_CPUS", "HOST_RAM"), theo sau không bắt buộc bởi một thao tác ([-|*]<float>), ví dụ: "tự động", "HOST_CPUS*.5". 0 có nghĩa là tài nguyên cục bộ sẽ giới hạn số lượng công việc kiểm thử cục bộ để chạy đồng thời. Việc đặt giá trị này lớn hơn giá trị cho --jobs là không hiệu quả.
Thẻ:execution
--runs_per_test=<a positive integer or test_regex@runs. This flag may be passed more than once>
lần dùng được tích luỹ- Chỉ định số lần chạy mỗi lượt kiểm thử. Nếu bất kỳ lần thử nào trong số đó không thành công vì bất cứ lý do gì, toàn bộ thử nghiệm sẽ được coi là không thành công. Thông thường, giá trị được chỉ định chỉ là một số nguyên. Ví dụ: --runs_per_test=3 sẽ chạy tất cả kiểm thử 3 lần. Cú pháp thay thế: regex_filter@runs_per_test. Trong đó running_per_test là viết tắt của một giá trị số nguyên và regex_filter đại diện cho 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 kiểm thử trong //foo/, ngoại trừ các kiểm thử dưới foo/bar ba lần. Bạn có thể bỏ qua lựa chọn này nhiều lần. Đối số được truyền gần đây nhất phù hợp sẽ được ưu tiên. Nếu không có kết quả nào phù hợp, thì kiểm thử sẽ chỉ được chạy một lần.
--test_env=<a 'name=value' assignment with an optional value part>
lần dùng được tích luỹ-
Chỉ định các biến môi trường bổ sung sẽ được đưa vào môi trường chạy kiểm thử. Các biến có thể được chỉ định theo tên, trong trường hợp đó, giá trị của biến sẽ được đọc từ môi trường ứng dụng Bazel hoặc theo cặp name=value. Bạn có thể sử dụng tuỳ chọn này nhiều lần để chỉ định một số biến. Chỉ được dùng trong "thử nghiệm bazel" .
Thẻ:test_runner
- Giá trị mặc định của
--[no]test_keep_going
: "true" -
Khi bạn tắt, mọi hoạt động kiểm thử không vượt qua sẽ khiến toàn bộ bản dựng dừng lại. Theo mặc định, tất cả các bài kiểm thử đều được chạy, ngay cả khi một số bài kiểm thử không đạt.
Thẻ:execution
- Giá trị mặc định của
--test_strategy=<a string>
: "" -
Chỉ định chiến lược sẽ sử dụng khi chạy kiểm thử.
Thẻ:execution
- Giá trị 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ờ mặc định của kiểm thử 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, giá trị này sẽ ghi đè tất 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, chúng sẽ ghi đè thời gian chờ cho ngắn, trung bình, dài và vĩnh viễn (theo thứ tự đó). Ở cả hai dạng, giá trị -1 yêu cầu blaze sử dụng thời gian chờ mặc định cho danh mục đó.
- Mặc định
--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" để sử dụng.
- Mặc định
--tvos_simulator_device=<a string>
: xem nội dung mô tả -
Thiết bị để mô phỏng khi chạy ứng dụng tvOS trong trình mô phỏng, ví dụ: "Apple TV 1080p". Bạn có thể xem danh sách thiết bị bằng cách chạy "xcrun simctl list devicetypes" trên máy đó.
Thẻ:test_runner
- Mặc định
--tvos_simulator_version=<a dotted version (for example '2.3' or '3.3alpha2.4')>
: xem nội dung mô tả -
Phiên bản tvOS để chạy trên trình mô phỏng khi chạy hoặc thử nghiệm.
Thẻ:test_runner
- Mặc định
--watchos_simulator_device=<a string>
: xem nội dung mô tả -
Thiết bị để mô phỏng khi chạy ứng dụng watchOS trong trình mô phỏng, ví dụ: "Apple Watch – 38mm". Bạn có thể xem danh sách thiết bị bằng cách chạy "xcrun simctl list devicetypes" trên máy đó.
Thẻ:test_runner
- Mặc định
--watchos_simulator_version=<a dotted version (for example '2.3' or '3.3alpha2.4')>
: xem nội dung mô tả -
Phiên bản watchOS để chạy trên trình mô phỏng khi chạy hoặc kiểm thử.
Thẻ:test_runner
- Giá trị mặc định của
--[no]zip_undeclared_test_outputs
: "true" -
Nếu là true, các kết quả kiểm thử chưa được khai báo sẽ được lưu trữ trong một tệp zip.
Thẻ:test_runner
- Các tuỳ chọn kích hoạt tính năng tối ưu hoá thời gian xây dựng:
- Giá trị mặc định của
--[no]collapse_duplicate_defines
: "false" -
Khi được bật, các giá trị-xác định thừa sẽ bị xoá sớm trong bản dựng. Điều này giúp tránh làm mất bộ nhớ đệm phân tích một cách không cần thiết đối với một số loại bản dựng tương đương.
Thẻ:loading_and_analysis
,loses_incremental_state
- Giá trị mặc định của
--[no]experimental_filter_library_jar_with_program_jar
: "false" -
Lọc ProGuard ProgramJar để xoá mọi lớp cũng có trong LibraryJar.
Thẻ:action_command_lines
- Giá trị mặc định của
--[no]experimental_inmemory_dotd_files
: "true" -
Nếu được bật, các tệp C++ .d sẽ được truyền trực tiếp vào bộ nhớ từ các nút bản dựng từ xa thay vì được ghi vào ổ đĩa.
Thẻ:loading_and_analysis
,execution
,affects_outputs
,experimental
- Giá trị mặc định của
--[no]experimental_inmemory_jdeps_files
: "true" -
Nếu bạn bật chính sách này, các tệp phụ thuộc (.jdeps) được tạo qua quá trình biên dịch Java sẽ được truyền trực tiếp vào bộ nhớ qua các nút bản dựng từ xa thay vì được ghi vào ổ đĩa.
Thẻ:loading_and_analysis
,execution
,affects_outputs
,experimental
- Giá trị mặc định của
--[no]experimental_objc_include_scanning
: "false" -
Liệu có thực hiện việc quét tìm C/C++ mục tiêu hay không.
Thẻ:loading_and_analysis
,execution
,changes_inputs
- Giá trị mặc định của
--[no]experimental_parse_headers_skipped_if_corresponding_srcs_found
: "false" -
Nếu được bật, tính năng parse_headers sẽ không tạo hành động biên dịch tiêu đề riêng biệt nếu tìm thấy một nguồn có cùng tên cơ sở ở cùng một đích.
Thẻ:loading_and_analysis
,affects_outputs
- Giá trị mặc định của
--[no]experimental_retain_test_configuration_across_testonly
: "false" -
Khi được bật, --trim_test_configuration sẽ không cắt cấu hình kiểm thử cho các quy tắc được đánh dấu testonly=1. Điều này nhằm giảm các vấn đề xung đột hành động khi quy tắc không phải kiểm thử phụ thuộc vào quy tắc cc_test. Không có hiệu lực nếu --trim_test_configuration là false.
Thẻ:loading_and_analysis
,loses_incremental_state
- Giá trị mặc định của
--[no]experimental_starlark_cc_import
: "false" -
Nếu bật tuỳ chọn này, bạn có thể sử dụng phiên bản Starlark của cc_import.
Thẻ:loading_and_analysis
,experimental
- Giá trị mặc định của
--[no]experimental_unsupported_and_brittle_include_scanning
: "false" -
Liệu có thu hẹp dữ liệu đầu vào trong quá trình biên dịch C/C++ bằng cách phân tích cú pháp các dòng #include từ tệp đầu vào hay không. Điều này có thể cải thiện hiệu suất và mức độ gia tăng bằng cách giảm kích thước của cây đầu vào biên dịch. Tuy nhiên, việc này cũng có thể phá vỡ các bản dựng vì trình quét bao gồm không triển khai đầy đủ ngữ nghĩa của bộ tiền xử lý C. Cụ thể, phương thức này không hiểu các lệnh #include động 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. Chúng tôi sẽ đóng mọi vấn đề liên quan đến cờ này.
Thẻ:loading_and_analysis
,execution
,changes_inputs
- Giá trị mặc định của
--[no]incremental_dexing
: "true" -
Thực hiện hầu hết thao tác để tạo tệp dex riêng biệt cho từng tệp Jar.
Thẻ:affects_outputs
,loading_and_analysis
,loses_incremental_state
- Giá trị mặc định của
--[no]objc_use_dotd_pruning
: "true" -
Nếu được đặt, các tệp .d do clang phát ra sẽ được dùng để cắt giảm tập hợp các dữ liệu đầu vào được truyền vào mục biên dịch objc.
Thẻ:changes_inputs
,loading_and_analysis
- Giá trị mặc định của
--[no]process_headers_in_dependencies
: "false" -
Khi tạo //a:a mục tiêu, hãy xử lý tiêu đề trong tất cả các mục tiêu mà //a:a phụ thuộc (nếu bạn bật tính năng xử lý tiêu đề cho chuỗi công cụ).
Thẻ:execution
- Giá trị mặc định của
--[no]trim_test_configuration
: "true" -
Khi được bật, các tuỳ chọn liên quan đến thử nghiệm 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 các chương trình kiểm thử dưới dạng phần phụ thuộc của quy tắc không kiểm thử, nhưng việc thay đổi các tuỳ chọn liên quan đến hoạt động kiểm thử sẽ không làm cho các quy tắc không kiểm thử bị phân tích lại.
Thẻ:loading_and_analysis
,loses_incremental_state
- Giá trị mặc định của
--[no]use_singlejar_apkbuilder
: "true" -
Tuỳ chọn này không được dùng nữa. Trang này hiện không hoạt động và sẽ sớm bị xoá.
Thẻ:loading_and_analysis
- Các lựa chọn ảnh hưởng đến độ chi tiết, định dạng hoặc vị trí ghi nhật ký:
- Giá trị mặc định của
--[no]announce
: "false" -
Không được dùng nữa. Không hoạt động.
Thẻ:affects_outputs
- Giá trị mặc định của
--[no]experimental_bep_target_summary
: "false" - Liệu có xuất bản các sự kiện Targetsummary hay không.
- Giá trị mặc định của
--[no]experimental_build_event_expand_filesets
: "false" -
Nếu đúng, hãy mở rộng Filesets trong BEP khi trình bày các tệp đầu ra.
Thẻ:affects_outputs
- Giá trị mặc định của
--[no]experimental_build_event_fully_resolve_fileset_symlinks
: "false" -
Nếu là true, phân giải đầy đủ các đường liên kết tượng trưng tương đối trong Fileset trong BEP khi trình bày các tệp đầu ra. Cần có --experimental_build_event_expand_filesets.
Thẻ:affects_outputs
- Giá trị 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
- Giá trị mặc định của
--experimental_build_event_upload_retry_minimum_delay=<An immutable length of time.>
: "1 giây" -
Ban đầu, độ trễ tối thiểu cho các lần thử lại thời gian đợi luỹ thừa khi tải lên BEP không thành công. (số mũ: 1,6)
Thẻ:bazel_internal_configuration
- Mặc định
--experimental_build_event_upload_strategy=<a string>
: xem nội dung mô tả -
Chọn cách tải các cấu phần phần mềm lên được tham chiếu trong giao thức sự kiện bản dựng.
Thẻ:affects_outputs
- Giá trị mặc định của
--[no]experimental_materialize_param_files_directly
: "false" -
Nếu cụ thể hoá các tệp thông số, hãy thực hiện bằng cách ghi trực tiếp vào ổ đĩa.
Thẻ:execution
- Giá trị mặc định của
--[no]experimental_stream_log_file_uploads
: "false" -
Phát trực tuyến tệp nhật ký tải lên trực tiếp vào bộ nhớ từ xa thay vì ghi vào ổ đĩa.
Thẻ:affects_outputs
- Mặc định
--explain=<a path>
: xem nội dung mô tả -
Yêu cầu 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
- Giá trị mặc định của
--[no]legacy_important_outputs
: "true" -
Sử dụng phương thức này để ngăn việc tạo trường quan trọng_đầu ra cũ trong sự kiện TargetComplete. Quan trọng là đầu ra quan trọng là bắt buộc để tích hợp Bazel với ResultStore.
Thẻ:affects_outputs
- Giá trị mặc định của
--[no]materialize_param_files
: "false" -
Ghi các tệp thông số trung gian vào cây đầu ra ngay cả khi sử dụng tính năng thực thi hành động từ xa. Hữu ích khi gỡ lỗi. Điều này được ngụ ý bởi --subcommands và -- chi tiết_failures.
Thẻ:execution
- Giá trị 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 có thay đổi trong các tuỳ chọn bản dựng, tuỳ chọn bản dựng sẽ hiển thị tối đa số tên tuỳ chọn đã thay đổi. Nếu số đã cho là -1, tất cả các tuỳ chọn đã thay đổi sẽ hiển thị.
Thẻ:terminal_output
- Giá trị 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 "tất cả". Được dùng để tránh gây quá tải đầu ra với đầu ra kiểm thử quá nhiễu. Tiêu đề kiểm tra được bao gồm trong kích thước nhật ký. Giá trị âm 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
--output_filter=<a valid Java regular expression>
: xem nội dung mô tả -
Chỉ hiện cảnh báo cho các quy tắc có tên khớp với biểu thức chính quy đã cung cấp.
Thẻ:affects_outputs
- Giá trị mặc định của
--progress_report_interval=<an integer in 0-3600 range>
: "0" -
Số giây giữa các báo cáo về các 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 tuỳ chọn – nguyền rủa, tiến trình sẽ được báo cáo mỗi giây.
Thẻ:affects_outputs
- Giá trị mặc định của
--show_result=<an integer>
: "1" -
Hiển thị kết quả của bản dựng. Đối với mỗi mục tiêu, hãy nêu rõ xem mục tiêu đó có được cập nhật hay không và nếu có, hãy cung cấp danh sách các tệp đầu ra đã được tạo. Tệp được in là các chuỗi thuận tiện cho việc sao chép+dán vào shell và thực thi các chuỗi này.
Tùy chọn này yêu cầu một đối số số nguyên, là số ngưỡng của mục tiêu mà trên đó thông tin kết quả không được in. Do đó, 0 thông báo bị chặn và MAX_INT khiến kết quả luôn diễn ra. Giá trị mặc định là một.
Thẻ:affects_outputs
--[no]subcommands
[-s
] mặc định: "false"-
Hiện 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 phù hợp với công cụ).
Thẻ:terminal_output
- Mặc định của
--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" để chỉ xuất thông tin tóm tắt trạng thái kiểm thử, "errors" để in nhật ký kiểm thử cho các lần kiểm thử không thành công, "all" (tất cả) để in nhật ký cho tất cả các kiểm thử và "đã phát trực tuyến" để xuất nhật ký cho tất cả chương trình kiểm thử theo thời gian thực (thao tác này sẽ buộc thực thi từng chương trình kiểm thử cục bộ 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 bản tóm tắt kiểm thử. Các giá trị hợp lệ là giá trị "ngắn" để chỉ in thông tin về các chương trình kiểm thử được thực thi, "terse", để chỉ in thông tin về các chương trình kiểm thử không thành công đã chạy, "chi tiết" để in thông tin chi tiết về các trường hợp kiểm thử không thành công, "testcase" (trường hợp kiểm thử) để in tóm tắt khi giải quyết 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 có" để bỏ qua phần tóm tắt.
Thẻ:terminal_output
- Giá trị 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. Biểu thức này được kiểm tra theo 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 đó sẽ đánh dấu riêng từng biểu thức chính quy. Lưu ý: Kết quả của cờ này rất phức tạp và có thể sẽ chỉ hữu ích cho các chuyên gia trong việc phân giải chuỗi công cụ.
Thẻ:terminal_output
- Giá trị mặc định của
--[no]verbose_explanations
: "false" -
Tăng độ chi tiết của nội dung giải thích được đưa ra nếu bạn bật chế độ giải thích. Không có hiệu lực nếu -- giải thích không được bật.
Thẻ:affects_outputs
- Giá trị mặc định của
--[no]verbose_failures
: "false" -
Nếu một lệnh không thành công, hãy xuất dòng lệnh đầy đủ.
Thẻ:terminal_output
- Các tuỳ chọn chỉ định hoặc thay đổi dữ liệu đầu vào chung cho lệnh Bazel không thuộc các danh mục khác.:
--aspects_parameters=<a 'name=value' assignment>
lần dùng được tích luỹ-
Chỉ định giá trị của tham số khía cạnh dòng lệnh. Mỗi giá trị thông số được chỉ định qua <param_name>=<param_value>, ví dụ: 'my_param=my_val' trong đó 'my_param' là tham số của một số khía cạnh trong danh sách --aspects hoặc được một khía cạnh trong danh sách yêu cầu. Bạn có thể sử dụng lựa 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
--flag_alias=<a 'name=value' flag alias>
lần dùng được tích luỹ-
Đặt tên viết tắt cho cờ Starlark. Hàm này cần một cặp khoá-giá trị có dạng "<key>=<value>" làm đối số.
Thẻ:changes_inputs
- Giá trị mặc định của
--[no]incompatible_default_to_explicit_init_py
: "false" -
Cờ này thay đổi hành vi mặc định để các tệp __init__.py không còn được tạo tự động trong các tệp chạy của mục tiêu Python nữa. Chính xác là khi một mục tiêu py_binary hoặc py_test có legacy_create_init được đặt thành "auto" (mặc định), thì hàm này được coi là sai khi và chỉ khi cờ này được đặt. Hãy truy cập vào https://github.com/bazelbuild/bazel/issues/10076.
Thẻ:affects_outputs
,incompatible_change
- Giá trị mặc định của
--[no]incompatible_py2_outputs_are_suffixed
: "true" -
Nếu đúng, các mục tiêu được tạo trong cấu hình Python 2 sẽ xuất hiện dưới một gốc đầu ra bao gồm 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 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 tiện lợi "bazel-bin" sẽ trỏ đến các mục tiêu Python 3 thay vì Python 2. Nếu bật tuỳ chọn này, bạn cũng nên bật "--incompatible_py3_is_default".
Thẻ:affects_outputs
,incompatible_change
- Giá trị mặc định của
--[no]incompatible_py3_is_default
: "true" -
Nếu đúng, các mục tiêu "py_binary" và "py_test" không đặt thuộc tính "python_version" (hoặc "default_python_version") sẽ được đặt mặc định thành PY3 thay vì PY2. Nếu đặt cờ này, bạn cũng nên đặt "--incompatible_py2_outputs_are_suffixed".
Thẻ:loading_and_analysis
,affects_outputs
,incompatible_change
- Giá trị mặc định của
--[no]incompatible_use_python_toolchains
: "true" -
Nếu bạn đặt thành true, các quy tắc Python gốc có thể thực thi sẽ sử dụng 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ũ cung cấp như --python_top.
Thẻ:loading_and_analysis
,incompatible_change
- Mặc định
--python_version=<PY2 or PY3>
: xem nội dung mô tả -
Chế độ phiên bản lớn Python, có thể là "PY2" hoặc "PY3". Lưu ý rằng các mục tiêu 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) do đó, thường không có nhiều lý do để cung cấp cờ này.
Thẻ:loading_and_analysis
,affects_outputs
,explicit_in_output_path
- Giá trị mặc định của
--target_pattern_file=<a string>
: "" -
Nếu được đặt, bản dựng sẽ đọc các mẫu từ tệp có tên tại đây, thay vì trên dòng lệnh. Sẽ xảy ra lỗi khi chỉ định một tệp tại đây cũng như các mẫu dòng lệnh.
Thẻ:changes_inputs
- Các lựa chọn khác, không được phân loại theo cách khác.:
- Giá trị mặc định của
--[no]build_manual_tests
: "false" - Buộc sử dụng các mục tiêu thử nghiệm được gắn thẻ "thủ công" xây dựng. "thủ công" thử nghiệm sẽ bị loại trừ khỏi quá trình xử lý. Tuỳ chọn này buộc phải tạo (nhưng không được thực thi)
- Giá trị 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ể bắt đầu bằng "-" theo tuỳ chọn để chỉ định thẻ bị loại trừ. Chỉ những mục tiêu đó mới đượ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 bài kiểm thử được thực thi bằng thuộc tính "test" (kiểm thử) Command; những yếu tố đó chịu sự điều chỉnh của tuỳ chọn lọc thử nghiệm, ví dụ: '--test_tag_filters'
- Giá trị mặc định của
--[no]build_tests_only
: "false" - Nếu được chỉ định, chỉ 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 một kiểm thử khi: (1) Bazel phát hiện các thay đổi trong kiểm thử hoặc các phần phụ thuộc của nó, (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 "yes", thì Bazel sẽ lưu mọi kết quả kiểm thử vào bộ nhớ đệm, ngoại trừ những lượt kiểm thử được đánh dấu là bên ngoài. Nếu bạn đặt thành "no", Bazel sẽ không lưu kết quả kiểm thử vào bộ nhớ đệm.
- Giá trị mặc định của
--[no]compile_one_dependency
: "false" - Biên dịch một phần phụ thuộc của các tệp đối số. Điều này rất hữu ích cho việc kiểm tra cú pháp các tệp nguồn trong IDE, chẳng hạn như bằng cách tạo lại một mục tiêu phụ thuộc vào tệp nguồn nhằm phát hiện lỗi càng sớm càng tốt trong chu kỳ chỉnh sửa/xây dựng/kiểm thử. Đối số này ảnh hưởng đến cách diễn giải tất cả các đối số không gắn cờ; thay vì là mục tiêu để tạo, chúng là tên tệp nguồn. Đối với mỗi tên tệp nguồn, một mục tiêu tuỳ ý phụ thuộc vào tên tệp nguồn đó sẽ được tạo.
- Giá trị mặc định của
--deleted_packages=<comma-separated list of package names>
: "" - 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ẽ cho là không tồn tại, ngay cả khi chúng hiển thị ở đâu đó 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 'x' hiện có. Ví dụ: sau khi xoá x/y/BUILD trong ứng dụng khách của bạn, hệ thống xây dựng có thể sẽ khiếu nại nếu gặp nhãn '//x:y/z' nếu giá trị đó vẫn được cung cấp bởi một mục package_path khác. Việc chỉ định --Delete_packages x/y sẽ giúp tránh được sự cố này.
- Giá trị mặc định của
--[no]discard_analysis_cache
: "false" - Loại bỏ 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ớ xuống khoảng 10%, nhưng khiến các bản dựng tăng dần trở nên chậm hơn.
- Mặc định
--execution_log_binary_file=<a path>
: xem nội dung mô tả - Ghi lại các bản sinh đã thực thi vào tệp này dưới dạng các giao thức Spawn được phân tách, theo src/main/protobuf/spawn.proto. Lần đầu tiên nhật ký được ghi không theo thứ tự và sau đó được sắp xếp theo thứ tự ổn định ở cuối lệnh gọi (có thể tốn nhiều bộ nhớ và CPU). Cờ liên quan: --execution_log_json_file (định dạng văn bản json có thứ tự), --experimental_execution_log_file (định dạng protobuf nhị phân không có thứ tự), --subcommands (để hiển thị các lệnh con trong đầu ra của thiết bị đầu cuối).
- Mặc định
--execution_log_json_file=<a path>
: xem nội dung mô tả - Ghi lại các bản sao đã thực thi vào tệp này dưới dạng json thể hiện các giao thức Spawn được phân tách, theo src/main/protobuf/spawn.proto. Lần đầu tiên nhật ký được ghi không theo thứ tự và sau đó được sắp xếp theo thứ tự ổn định ở cuối lệnh gọi (có thể tốn nhiều bộ nhớ và CPU). Cờ liên quan: Cờ liên quan: --execution_log_binary_file (định dạng protobuf nhị phân có thứ tự), --experimental_execution_log_file (định dạng protobuf nhị phân không theo thứ tự), --subcommands (để hiển thị các lệnh con trong đầu ra của thiết bị đầu cuối).
- Giá trị mặc định của
--[no]execution_log_sort
: "true" - Liệu có sắp xếp nhật ký thực thi hay không. Đặt thành false để cải thiện hiệu suất của bộ nhớ, với chi phí tạo nhật ký theo thứ tự không xác định.
- Giá trị mặc định của
--[no]expand_test_suites
: "true" -
Mở rộng các mục tiêu test_suite vào 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), mẫu mục tiêu phủ định sẽ áp dụng cho các bài kiểm thử thuộc bộ kiểm thử, nếu không thì khô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 ở dòng lệnh: sau đó, họ có thể phân tích các mục tiêu test_suite.
Thẻ:loading_and_analysis
- Giá trị mặc định của
--[no]experimental_cancel_concurrent_tests
: "false" -
Nếu đúng, thì Blaze sẽ huỷ đồng thời các kiểm thử đang chạy trong lần chạy thành công đầu tiên. Điều này chỉ hữu ích khi kết hợp với --runs_per_test_detects_flakes.
Thẻ:affects_outputs
,loading_and_analysis
- Mặc định
--experimental_execution_log_file=<a path>
: xem nội dung mô tả - Ghi lại các bản sinh đã thực thi vào tệp này dưới dạng các giao thức Spawn được phân tách, theo src/main/protobuf/spawn.proto. Tệp này được ghi theo thứ tự thực thi các lần sinh ra. Cờ liên quan: --execution_log_binary_file (định dạng protobuf nhị phân có thứ tự), --execution_log_json_file (định dạng văn bản json có thứ tự), --subcommands (để hiển thị các lệnh con trong đầu ra của thiết bị đầu cuối).
- Giá trị mặc định của
--[no]experimental_execution_log_spawn_metrics
: "false" - Bao gồm các chỉ số sinh ra trong nhật ký sinh sản được thực thi.
- Giá trị 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à ưu tiên các khía cạnh. Bộ lọc đặt mục tiêu để lên lịch các hành động ngoại lệ.
- Giá trị mặc định của
--[no]experimental_extra_action_top_level_only
: "false" - Ngừng sử dụng và ưu tiên các khía cạnh. Chỉ lên lịch các hành động ngoại lệ cho các mục tiêu cấp cao nhất.
- Giá trị mặc định của
--[no]experimental_fetch_all_coverage_outputs
: "false" -
Nếu đúng, 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
- Giá trị mặc định của
--[no]experimental_generate_llvm_lcov
: "false" -
Nếu đúng, mức độ phù hợp cho clang sẽ tạo báo cáo LCOV.
Thẻ:affects_outputs
,loading_and_analysis
- Giá trị mặc định của
--[no]experimental_j2objc_header_map
: "true" - Liệu có tạo bản đồ tiêu đề J2ObjC song song với quá trình chuyển đổi J2ObjC hay không.
- Giá trị mặc định của
--[no]experimental_j2objc_shorter_header_path
: "false" -
Liệu có tạo bằng đường dẫn tiêu đề ngắn hơn hay không (sử dụng "_ios" thay vì "_j2objc").
Thẻ:affects_outputs
- Giá trị mặc định của
--experimental_java_classpath=<off, javabuilder or bazel>
: "javabuilder" - Bật đường dẫn lớp giảm bớt cho quá trình biên dịch Java.
- Giá trị mặc định của
--[no]experimental_limit_android_lint_to_android_constrained_java
: "false" -
Giới hạn --experimental_run_android_lint_on_java_rules ở các thư viện tương thích với Android.
Thẻ:affects_outputs
- Giá trị mặc định của
--[no]experimental_prioritize_local_actions
: "true" -
Nếu được đặt, các thao tác chỉ có thể chạy cục bộ sẽ có cơ hội đầu tiên để lấy tài nguyên, các worker chạy linh động sẽ có cơ hội thứ hai và các hành động độc lập chạy linh động sẽ đến cuối cùng.
Thẻ:execution
- Giá trị mặc định của
--[no]experimental_run_android_lint_on_java_rules
: "false" -
Liệu có xác thực nguồn java_* hay không.
Thẻ:affects_outputs
- Giá trị mặc định của
--[no]explicit_java_test_deps
: "false" - Chỉ định rõ ràng phần phụ thuộc cho JUnit hoặc Hamcrest trong java_test thay vì vô tình lấy được từ phần phụ thuộc của TestRunner. Hiện chỉ áp dụng cho bazel.
- Mặc định
--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.
--host_javacopt=<a string>
lần dùng được tích luỹ- Các tuỳ chọn bổ sung để truyền sang javac khi tạo các công cụ được thực thi trong quá trình dựng.
--host_jvmopt=<a string>
lần dùng được tích luỹ- Các tuỳ chọn bổ sung để truyền sang máy ảo Java khi xây dựng các công cụ được thực thi trong quá trình dựng. Các tuỳ chọn này sẽ được thêm vào tuỳ chọn khởi động máy ảo của từng mục tiêu java_binary.
- Giá trị mặc định của
--[no]incompatible_exclusive_test_sandboxed
: "false" -
Nếu đúng, các thử nghiệm độc quyền sẽ chạy với chiến lược hộp cát. Thêm "local" để buộc chạy kiểm thử độc quyền trên máy
Thẻ:incompatible_change
- Giá trị mặc định của
--[no]incompatible_strict_action_env
: "false" -
Nếu đúng, Bazel sử dụng một môi trường có giá trị tĩnh cho PATH và không kế thừa LD_ từng_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ừ máy khách, 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
--j2objc_translation_flags=<comma-separated list of options>
lần dùng được tích luỹ- Các tuỳ chọn bổ sung để chuyển sang công cụ J2ObjC.
--java_debug
-
Khiến máy ảo Java của một chương trình kiểm thử java đợ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
- Giá trị mặc định của
--[no]java_deps
: "true" - Tạo thông tin về phần phụ thuộc (hiện tại là đường dẫn lớp thời gian biên dịch) theo mục tiêu Java.
- Giá trị mặc định của
--[no]java_header_compilation
: "true" - Biên dịch ijar trực tiếp từ nguồn.
- Giá trị mặc định của
--java_language_version=<a string>
: "8" - Phiên bản ngôn ngữ Java
- Mặc định
--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 bạn đặt cờ này thành chuỗi trống, thì trình chạy JDK sẽ được sử dụng. "Trình chạy" sẽ ghi đè cờ này.
- Giá trị mặc định của
--java_runtime_version=<a string>
: "local_jdk" - Phiên bản thời gian chạy Java
--javacopt=<a string>
lần dùng được tích luỹ- Các tuỳ chọn bổ sung để chuyển sang javac.
--jvmopt=<a string>
lần dùng được tích luỹ- Các tuỳ chọn bổ sung để chuyển sang máy ảo Java. Các tuỳ chọn này sẽ được thêm vào tuỳ chọn khởi động máy ảo của từng mục tiêu java_binary.
- Mặc định
--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ũ.
- Giá trị mặc định của
--local_cpu_resources=<an integer, or "HOST_CPUS", optionally followed by [-|*]<float>.>
: "HOST_CPUS" - Đặt rõ ràng tổng số lõi CPU cục bộ có thể sử dụng cho Bazel để chi tiêu cho các hành động tạo bản dựng được thực thi cục bộ. Lấy một số nguyên hoặc "HOST_CPUS", theo sau không bắt buộc là [-|*]<float> (ví dụ: HOST_CPUS*.5 để sử dụng một nửa số lõi CPU hiện có).Theo mặc định, ("HOST_CPUS"), Bazel sẽ truy vấn cấu hình hệ thống để ước tính số lõi CPU sẵn có.
--local_extra_resources=<a named float, 'name=value'>
lần dùng được tích luỹ- Đặt số lượng tài nguyên bổ sung hiện có cho Bazel. Lấy một cặp chuỗi-float. Có thể sử dụng nhiều lần để chỉ định nhiều loại tài nguyên bổ sung. Bazel sẽ giới hạn các hành động chạy đồng thời dựa trên tài nguyên bổ sung có sẵn và tài nguyên bổ sung cần thiết. Các chương trình kiểm thử có thể khai báo lượng tài nguyên bổ sung cần thiết bằng cách sử dụng thẻ "resources:<resoucename>:<amount>" . Không thể thiết lập CPU, RAM và các tài nguyên hiện có bằng cờ này.
- Giá trị mặc định của
--local_ram_resources=<an integer, or "HOST_RAM", optionally followed by [-|*]<float>.>
: "HOST_RAM*.67" - Đặt 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 đối với bản dựng được thực thi cục bộ. Lấy một số nguyên hoặc "HOST_RAM", theo sau không bắt buộc là [-|*]<float> (ví dụ: HOST_RAM*.5 để sử dụng một nửa RAM còn trống). 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 còn trống.
- Giá trị 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
--package_path=<colon-separated list of options>
: "%workspace%" - Danh sách được phân tách bằng dấu hai chấm, trong đó có nơi tìm các gói. Các phần tử bắt đầu bằng '%workspace%' đều liên quan đến không gian làm việc bao quanh. Nếu bạn bỏ qua hoặc để trống giá trị này, giá trị mặc định sẽ là "bazel info default-package-path".
--plugin=<a build target label>
lần dùng được tích luỹ- Trình bổ trợ để sử dụng trong bản dựng. Hiện hoạt động với java_plugin.
- Mặc định
--proguard_top=<a build target label>
: xem nội dung mô tả - Chỉ định phiên bản ProGuard dùng để xoá mã khi tạo 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 các proto 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 proto j2objc
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 các proto Java
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 các proto JavaLite
Thẻ:affects_outputs
,loading_and_analysis
--protocopt=<a string>
lần dùng được tích luỹ-
Các tuỳ chọn khác để truyền đến trình biên dịch protobuf.
Thẻ:affects_outputs
- Giá trị mặc định của
--[no]runs_per_test_detects_flakes
: "false" - Nếu đúng, bất kỳ phân đoạn nào trong đó có ít nhất một lần chạy/lần chạy và ít nhất một lần chạy/thử không thành công sẽ có trạng thái FLAKY.
- Mặc định
--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 đó. Nếu bạn không đặt chính sách nào, Bazel sẽ sử dụng đường dẫn mặc định được cố định giá trị trong mã, tuỳ thuộc vào hệ điều hành mà ứng dụng chạy (Windows: c:/tools/msys64/usr/bin/bash.exe, FreeBSD: /usr/local/bin/bash, tất cả các hệ điều hành khác: /bin/bash). Lưu ý rằng việc sử dụng một shell không tương thích với tính năng bash có thể dẫn đến lỗi bản dựng hoặc lỗi thời gian chạy của tệp nhị phân đã tạo.
Thẻ:loading_and_analysis
- Giá trị mặc định của
--[no]show_loading_progress
: "true" - Nếu được bật, Bazel sẽ hiện thông báo "Đang tải gói:" tin nhắn.
--test_arg=<a string>
lần dùng được tích luỹ- Chỉ định các tuỳ chọn và đối số bổ sung cần được truyền đến tệp thực thi kiểm thử. Có thể sử dụng nhiều lần để chỉ định một số đối số. Nếu thực thi nhiều kiểm thử, mỗi lượt kiểm thử sẽ nhận được các đối số giống hệt nhau. Chỉ được dùng trong "thử nghiệm bazel" .
- Mặc định
--test_filter=<a string>
: xem nội dung mô tả - Chỉ định một bộ lọc để chuyển tiếp đến khung thử nghiệm. Dùng để giới hạn hoạt động kiểm thử. Xin lưu ý rằng điều này không ảnh hưởng đến việc tạo mục tiêu nào.
- Giá trị mặc định của
--test_lang_filters=<comma-separated list of options>
: "" - Chỉ định danh sách ngôn ngữ thử nghiệm được phân tách bằng dấu phẩy. Mỗi ngôn ngữ có thể đứng sau "-" theo tuỳ chọn để chỉ định ngôn ngữ bị loại trừ. Chúng tôi chỉ tìm thấy những mục tiêu kiểm thử đó được viết bằng các ngôn ngữ đã chỉ định. Tên dùng cho mỗi ngôn ngữ phải giống với tiền tố ngôn ngữ trong quy tắc *_test, ví dụ: một trong các "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ử.
- Giá trị mặc định của
--test_result_expiration=<an integer>
: "-1" - Lựa chọn này không còn được dùng nữa và không có hiệu lực.
- Giá trị mặc định của
--[no]test_runner_fail_fast
: "false" - Lựa 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ử cần ngừng thực thi khi gặp lỗi đầu tiên.
- Giá trị mặc định của
--test_sharding_strategy=<explicit or disabled>
: "explicit" - Chỉ định chiến lược để phân đoạn kiểm thử: "explicit" để chỉ sử dụng phân đoạn nếu thuộc tính 'shard_count' Có thuộc tính BUILD. "đã tắt" không bao giờ sử dụng tính năng phân đoạn kiểm thử.
- Giá trị mặc định của
--test_size_filters=<comma-separated list of values: small, medium, large or enormous>
: "" - Chỉ định một danh sách kích thước thử nghiệm được phân tách bằng dấu phẩy. Mỗi kích thước có thể bắt đầu bằng "-" sau tùy chọn để chỉ định kích thước bị loại trừ. Hệ thống 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 bao gồm 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ử.
- Giá trị mặc định của
--test_tag_filters=<comma-separated list of options>
: "" - Chỉ định danh sách thẻ thử nghiệm được phân tách bằng dấu phẩy. Mỗi thẻ có thể bắt đầu bằng "-" theo tuỳ chọn để chỉ định thẻ bị loại trừ. Chỉ tìm được 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ử.
- Giá trị mặc định của
--test_timeout_filters=<comma-separated list of values: short, moderate, long or eternal>
: "" - Chỉ định danh sách thời gian chờ thử nghiệm được phân tách bằng dấu phẩy. Mỗi thời gian chờ có thể tuỳ ý đứng trước "-" để chỉ định thời gian chờ bị loại trừ. Chỉ những mục tiêu thử nghiệm đó mới được tìm thấy có chứa ít nhất một thời gian chờ được bao gồm và không chứa bất kỳ thời gian chờ 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ử.
- Giá trị mặc định của
--tool_java_language_version=<a string>
: "8" - Phiên bản ngôn ngữ Java dùng để thực thi các công cụ cần thiết trong quá trình tạo bản dựng
- Giá trị 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 tạo bản dựng
- Giá trị mặc định của
--[no]use_ijars
: "true" - Nếu được bật, tuỳ chọn này sẽ khiến quá trình biên dịch Java sử dụng các tệp giao diện người dùng. Điều này sẽ giúp quá trình biên dịch gia tăng nhanh hơn nhưng các thông báo lỗi có thể khác nhau.
Tuỳ chọn chuẩn hoá cờ
Kế thừa tất cả tuỳ chọn từ 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:
--distdir=<a path>
lần dùng được tích luỹ-
Các nơi khác để tìm kiếm các bản lưu trữ trước khi truy cập vào mạng để tải các bản lưu trữ đó xuống.
Thẻ:bazel_internal_configuration
- Giá trị mặc định của
--[no]experimental_repository_cache_hardlinks
: "false" -
Nếu được thiết lập, bộ nhớ đệm của kho lưu trữ sẽ liên kết cứng tệp trong trường hợp có lượt truy cập bộ nhớ đệm, thay vì sao chép. Thao tác này nhằm tiết kiệm dung lượng ổ đĩa.
Thẻ:bazel_internal_configuration
- Giá trị mặc định của
--[no]experimental_repository_cache_urls_as_default_canonical_id
: "false" -
Nếu đúng, hãy sử dụng một chuỗi bắt nguồn từ URL của các tệp tải xuống từ kho lưu trữ dưới dạngcanonical_id nếu không được chỉ định. Điều này khiến URL thay đổi, dẫn đến việc tải xuống lại ngay cả khi bộ nhớ đệm chứa tệp tải xuống có cùng hàm băm. Bạn có thể sử dụng quy trình này để xác minh rằng các thay đổi về URL không làm hỏng các kho lưu trữ bị bộ nhớ đệm che khuất.
Thẻ:loading_and_analysis
,experimental
- Giá trị mặc định của
--[no]experimental_repository_disable_download
: "false" -
Nếu đã đặt, bạn sẽ không được phép tải các kho lưu trữ bên ngoài xuống.
Thẻ:experimental
- Giá trị mặc định của
--experimental_repository_downloader_retries=<an integer>
: "0" -
Số lần thử tải lại lỗi xuống tối đa. Nếu bạn đặt chính sách này thành 0, hoạt động thử lại sẽ bị tắt.
Thẻ:experimental
- Giá trị mặc định của
--experimental_scale_timeouts=<a double>
: "1" -
Điều chỉnh tỷ lệ tất cả thời gian chờ trong quy tắc kho lưu trữ Starlark theo hệ số này. Bằng cách này, các kho lưu trữ bên ngoài có thể hoạt động trên các máy chậm hơn dự kiến của tác giả quy tắc mà không cần thay đổi mã nguồn
Thẻ:bazel_internal_configuration
,experimental
- Giá trị mặc định của
--http_timeout_scaling=<a double>
: "1" -
Điều chỉnh tỷ lệ tất cả thời gian chờ liên quan đến lượt tải xuống http theo hệ số cho trước
Thẻ:bazel_internal_configuration
- Mặc định
--repository_cache=<a path>
: xem nội dung mô tả -
Chỉ định vị trí bộ nhớ đệm của các giá trị được tải xuống thu được trong quá trình tìm nạp kho lưu trữ bên ngoài. Chuỗi trống dưới dạng đối số yêu cầu tắt bộ nhớ đệm.
Thẻ:bazel_internal_configuration
- Các tuỳ chọn kiểm soát kết quả của lệnh:
- Giá trị mặc định của
--[no]canonicalize_policy
: "false" -
Cho ra chính sách chuẩn sau khi mở rộng và lọc. Để giữ cho kết quả đầ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
- Giá trị mặc định của
--[no]show_warnings
: "false" -
Xuất cảnh báo của trình phân tích cú pháp thành lỗi tiêu chuẩn (ví dụ: đối với các tuỳ chọn cờ xung đột).
Thẻ:affects_outputs
,terminal_output
- Các tuỳ chọn ảnh hưởng đến mức độ nghiêm ngặt của Bazel thực thi dữ liệu đầu vào bản dựng hợp lệ (định nghĩa quy tắc, tổ hợp cờ, v.v.):
- Giá trị mặc định của
--experimental_repository_hash_file=<a string>
: "" -
Nếu giá trị không trống, hãy chỉ định tệp có chứa giá trị đã phân giải mà cần phải xác minh giá trị băm của thư mục kho lưu trữ
Thẻ:affects_outputs
,experimental
--experimental_verify_repository_rules=<a string>
lần dùng được tích luỹ-
Nếu danh sách các quy tắc kho lưu trữ mà hàm băm của thư mục đầu ra cần được xác minh, miễn là tệp được chỉ định bởi --experimental_repository_hash_file.
Thẻ:affects_outputs
,experimental
- Tuỳ chọn này ảnh hưởng đến ngữ nghĩa của ngôn ngữ Starlark hoặc API bản dựng có thể truy cập vào các tệp BUILD, tệp .bzl hoặc tệp WORKSPACE.:
- Giá trị mặc định của
--[no]experimental_allow_top_level_aspects_parameters
: "true" -
Không hoạt động
Thẻ:no_op
,deprecated
,experimental
- Giá trị mặc định của
--[no]incompatible_config_setting_private_default_visibility
: "false" -
Nếu không tương thích_enforce_config_setting_ visibility=false, thì đây là lỗi không hiển thị. Ngược lại, nếu cờ này là false, mọi chế độ cài đặt config_setting không có thuộc tính mức độ hiển thị rõ ràng sẽ là //visibility:public. Nếu cờ này là true, chế độ cài đặt config_setting sẽ tuân theo cùng một logic về chế độ hiển thị như mọi quy tắc khác. Truy cập https://github.com/bazelbuild/bazel/issues/12933.
Thẻ:loading_and_analysis
,incompatible_change
- Giá trị mặc định của
--[no]incompatible_enforce_config_setting_visibility
: "true" -
Nếu là true, hãy thực thi các quy định hạn chế về chế độ hiển thị bằng lệnh config_setting. Nếu đặt là false, mọi chế độ cài đặt config_ đều hiển thị với mọi mục tiêu. Truy cập 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:
--allow_yanked_versions=<a string>
lần dùng được tích luỹ-
Đã chỉ định các phiên bản mô-đun dưới dạng `<module1>@<version1>,<module2>@<version2>` sẽ được phép trong biểu đồ phần phụ thuộc đã phân giải ngay cả khi chúng được khai báo được kéo trong sổ đăng ký nơi chúng đến (nếu chúng không đến từ NonRegistryOverride). Nếu không, các phiên bản được kéo sẽ khiến quá trình phân giải bị lỗi. Bạn cũng có thể xác định phiên bản được kéo được phép bằng biến môi trường "BZLMOD_ALLOW_YANKED_VERSIONS". Bạn có thể vô hiệu hoá chế độ kiểm tra này bằng cách sử dụng từ khoá 'tất cả' (không nên dùng).
Thẻ:loading_and_analysis
- Giá trị 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" để báo cáo lỗi thành không giải quyết được, "tắt" để tắt tính năng kiểm tra hoặc "cảnh báo" để in một cảnh báo khi phát hiện thấy thông tin không khớp.
Thẻ:loading_and_analysis
- Giá trị 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 "bazel_dep" trực tiếp đượ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 đã phân giải hay không. Các giá trị hợp lệ là "off" để tắt tính năng kiểm tra, "warning" để in cảnh báo khi phát hiện thấy thông tin không khớp hoặc "error" để chuyển cảnh báo thành không giải quyết được.
Thẻ:loading_and_analysis
- Giá trị mặc định của
--[no]ignore_dev_dependency
: "false" -
Nếu đúng, Bazel sẽ bỏ qua phương thức "bazel_dep" và "use_extension" được khai báo là "dev_Dependencies" trong MODULE.bazel của mô-đun gốc. Lưu ý rằng các phần phụ thuộc dev đó 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
--override_module=<an equals-separated mapping of module name to path>
lần dùng được tích luỹ- Ghi đè mô-đun bằng thư mục cục bộ.
--registry=<a string>
lần dùng được tích luỹ-
Chỉ định sổ đăng ký cần sử dụng để xác định vị trí các phần phụ thuộc của mô-đun Bazel. Thứ tự này rất quan trọng: các mô-đun sẽ được tra cứu trong các sổ đăng ký trước đó trước và chỉ quay lại các sổ đăng ký sau đó nếu không có các mô-đun trước đó.
Thẻ:changes_inputs
- Các lựa chọn ảnh hưởng đến độ chi tiết, định dạng hoặc vị trí ghi nhật ký:
- Giá trị mặc định của
--[no]experimental_record_metrics_for_all_mnemonics
: "false" - Theo mặc định, số lượng loại hành động được giới hạn ở 20 bộ nhớ có số lượng hành động được thực thi lớn nhất. Việc đặt tuỳ chọn này sẽ ghi số liệu thống kê cho tất cả các bộ nhớ.
- Các tuỳ chọn chỉ định hoặc thay đổi dữ liệu đầu vào chung cho lệnh Bazel không thuộc các danh mục khác.:
- Giá trị mặc định của
--experimental_resolved_file_instead_of_workspace=<a string>
: "" -
Nếu không để trống, hãy đọc tệp đã giải quyết được chỉ định thay vì tệp WORKSPACE
Thẻ:changes_inputs
- Giá trị mặc định của
--for_command=<a string>
: "build" -
Lệnh mà các tuỳ chọn cần được chuẩn hoá.
Thẻ:affects_outputs
,terminal_output
- Giá trị 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
--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ủ lưu trữ (cho `allow` và `block`) hoặc hai mẫu, một mẫu để so khớp và một mẫu để sử dụng làm URL thay thế, với các tham chiếu ngược bắt đầu từ `$1`. Bạn có thể cung cấp nhiều lệnh "ghi lại" cho cùng một URL và trong trường hợp này, hệ thống sẽ trả về nhiều URL.
- Các lựa chọn khác, không được phân loại theo cách khác.:
- Giá trị mặc định của
--deleted_packages=<comma-separated list of package names>
: "" - 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ẽ cho là không tồn tại, ngay cả khi chúng hiển thị ở đâu đó 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 'x' hiện có. Ví dụ: sau khi xoá x/y/BUILD trong ứng dụng khách của bạn, hệ thống xây dựng có thể sẽ khiếu nại nếu gặp nhãn '//x:y/z' nếu giá trị đó vẫn được cung cấp bởi một mục package_path khác. Việc chỉ định --Delete_packages x/y sẽ giúp tránh được sự cố này.
--override_repository=<an equals-separated mapping of repository name to path>
lần dùng được tích luỹ- Ghi đè kho lưu trữ bằng thư mục cục bộ.
- 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, trong đó có nơi tìm các gói. Các phần tử bắt đầu bằng '%workspace%' đều liên quan đến không gian làm việc bao quanh. Nếu bạn bỏ qua hoặc để trống giá trị này, giá trị mặc định sẽ là "bazel info default-package-path".
- Giá trị mặc định của
--[no]show_loading_progress
: "true" - Nếu được bật, Bazel sẽ hiện thông báo "Đang tải gói:" tin nhắn.
Tuỳ chọn dọn sạch
Kế thừa tất cả tuỳ chọn từ 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:
--distdir=<a path>
lần dùng được tích luỹ-
Các nơi khác để tìm kiếm các bản lưu trữ trước khi truy cập vào mạng để tải các bản lưu trữ đó xuống.
Thẻ:bazel_internal_configuration
- Giá trị mặc định của
--[no]experimental_repository_cache_hardlinks
: "false" -
Nếu được thiết lập, bộ nhớ đệm của kho lưu trữ sẽ liên kết cứng tệp trong trường hợp có lượt truy cập bộ nhớ đệm, thay vì sao chép. Thao tác này nhằm tiết kiệm dung lượng ổ đĩa.
Thẻ:bazel_internal_configuration
- Giá trị mặc định của
--[no]experimental_repository_cache_urls_as_default_canonical_id
: "false" -
Nếu đúng, hãy sử dụng một chuỗi bắt nguồn từ URL của các tệp tải xuống từ kho lưu trữ dưới dạngcanonical_id nếu không được chỉ định. Điều này khiến URL thay đổi, dẫn đến việc tải xuống lại ngay cả khi bộ nhớ đệm chứa tệp tải xuống có cùng hàm băm. Bạn có thể sử dụng quy trình này để xác minh rằng các thay đổi về URL không làm hỏng các kho lưu trữ bị bộ nhớ đệm che khuất.
Thẻ:loading_and_analysis
,experimental
- Giá trị mặc định của
--[no]experimental_repository_disable_download
: "false" -
Nếu đã đặt, bạn sẽ không được phép tải các kho lưu trữ bên ngoài xuống.
Thẻ:experimental
- Giá trị mặc định của
--experimental_repository_downloader_retries=<an integer>
: "0" -
Số lần thử tải lại lỗi xuống tối đa. Nếu bạn đặt chính sách này thành 0, hoạt động thử lại sẽ bị tắt.
Thẻ:experimental
- Giá trị mặc định của
--experimental_scale_timeouts=<a double>
: "1" -
Điều chỉnh tỷ lệ tất cả thời gian chờ trong quy tắc kho lưu trữ Starlark theo hệ số này. Bằng cách này, các kho lưu trữ bên ngoài có thể hoạt động trên các máy chậm hơn dự kiến của tác giả quy tắc mà không cần thay đổi mã nguồn
Thẻ:bazel_internal_configuration
,experimental
- Giá trị mặc định của
--http_timeout_scaling=<a double>
: "1" -
Điều chỉnh tỷ lệ tất cả thời gian chờ liên quan đến lượt tải xuống http theo hệ số cho trước
Thẻ:bazel_internal_configuration
- Mặc định
--repository_cache=<a path>
: xem nội dung mô tả -
Chỉ định vị trí bộ nhớ đệm của các giá trị được tải xuống thu được trong quá trình tìm nạp kho lưu trữ bên ngoài. Chuỗi trống dưới dạng đối số yêu cầu tắt bộ nhớ đệm.
Thẻ:bazel_internal_configuration
- Các tuỳ chọn kiểm soát kết quả của lệnh:
- Giá trị mặc định của
--[no]async
: "false" -
Nếu đúng, thì quá trình làm sạch đầu ra sẽ không đồng bộ. Khi lệnh này hoàn tất, bạn có thể an toàn thực thi các lệnh mới trong cùng một ứng dụng, mặc dù quá trình xoá có thể tiếp tục diễn ra trong nền.
Thẻ:host_machine_resource_optimizations
- Giá trị mặc định của
--[no]expunge
: "false" -
Nếu đúng, sạch sẽ xoá toàn bộ cây hoạt động cho phiên bản 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 phiên bản này đang chạy.
Thẻ:host_machine_resource_optimizations
--expunge_async
-
Nếu được chỉ định, chế độ sạch sẽ không đồng bộ sẽ xoá toàn bộ cây hoạt động cho thực thể bazel này, bao gồm tất cả các tệp đầu ra 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ể an toàn thực thi các lệnh mới trong cùng một ứng dụng, mặc dù quá trình xoá có thể tiếp tục diễn ra trong nền.
Mở rộng thành:
--expunge
--async
Thẻ:host_machine_resource_optimizations
- Giá trị mặc định của
--[no]remove_all_convenience_symlinks
: "false" -
Nếu là true, tất cả các đường liên kết tượng trưng trong không gian làm việc có tiền tố symlink_prefix sẽ bị xoá. Nếu không có cờ này thì chỉ các đường liên kết tượng trưng có hậu tố được xác định trước mới được xoá.
Thẻ:affects_outputs
- Các lựa chọn ảnh hưởng đến mức độ nghiêm ngặt của Bazel trong việc thực thi dữ liệu đầu vào bản dựng hợp lệ (định nghĩa quy tắc, tổ hợp cờ, v.v.):
- Giá trị mặc định của
--experimental_repository_hash_file=<a string>
: "" -
Nếu giá trị không trống, hãy chỉ định tệp có chứa giá trị đã phân giải mà cần phải xác minh giá trị băm của thư mục kho lưu trữ
Thẻ:affects_outputs
,experimental
--experimental_verify_repository_rules=<a string>
lần dùng được tích luỹ-
Nếu danh sách các quy tắc kho lưu trữ mà hàm băm của thư mục đầu ra cần được xác minh, miễn là tệp được chỉ định bởi --experimental_repository_hash_file.
Thẻ:affects_outputs
,experimental
- Tuỳ chọn này ảnh hưởng đến ngữ nghĩa của ngôn ngữ Starlark hoặc API bản dựng có thể truy cập vào các tệp BUILD, tệp .bzl hoặc tệp WORKSPACE.:
- Giá trị mặc định của
--[no]experimental_allow_top_level_aspects_parameters
: "true" -
Không hoạt động
Thẻ:no_op
,deprecated
,experimental
- Các tuỳ chọn liên quan đến đầu ra và ngữ nghĩa Bzlmod:
--allow_yanked_versions=<a string>
lần dùng được tích luỹ-
Đã chỉ định các phiên bản mô-đun dưới dạng `<module1>@<version1>,<module2>@<version2>` sẽ được phép trong biểu đồ phần phụ thuộc đã phân giải ngay cả khi chúng được khai báo được kéo trong sổ đăng ký nơi chúng đến (nếu chúng không đến từ NonRegistryOverride). Nếu không, các phiên bản được kéo sẽ khiến quá trình phân giải bị lỗi. Bạn cũng có thể xác định phiên bản được kéo được phép bằng biến môi trường "BZLMOD_ALLOW_YANKED_VERSIONS". Bạn có thể vô hiệu hoá chế độ kiểm tra này bằng cách sử dụng từ khoá 'tất cả' (không nên dùng).
Thẻ:loading_and_analysis
- Giá trị 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" để báo cáo lỗi thành không giải quyết được, "tắt" để tắt tính năng kiểm tra hoặc "cảnh báo" để in một cảnh báo khi phát hiện thấy thông tin không khớp.
Thẻ:loading_and_analysis
- Giá trị 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 "bazel_dep" trực tiếp đượ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 đã phân giải hay không. Các giá trị hợp lệ là "off" để tắt tính năng kiểm tra, "warning" để in cảnh báo khi phát hiện thấy thông tin không khớp hoặc "error" để chuyển cảnh báo thành không giải quyết được.
Thẻ:loading_and_analysis
- Giá trị mặc định của
--[no]ignore_dev_dependency
: "false" -
Nếu đúng, Bazel sẽ bỏ qua phương thức "bazel_dep" và "use_extension" được khai báo là "dev_Dependencies" trong MODULE.bazel của mô-đun gốc. Lưu ý rằng các phần phụ thuộc dev đó 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
--override_module=<an equals-separated mapping of module name to path>
lần dùng được tích luỹ- Ghi đè mô-đun bằng thư mục cục bộ.
--registry=<a string>
lần dùng được tích luỹ-
Chỉ định sổ đăng ký cần sử dụng để xác định vị trí các phần phụ thuộc của mô-đun Bazel. Thứ tự này rất quan trọng: các mô-đun sẽ được tra cứu trong các sổ đăng ký trước đó trước và chỉ quay lại các sổ đăng ký sau đó nếu không có các mô-đun trước đó.
Thẻ:changes_inputs
- Các lựa chọn ảnh hưởng đến độ chi tiết, định dạng hoặc vị trí ghi nhật ký:
- Giá trị mặc định của
--[no]experimental_record_metrics_for_all_mnemonics
: "false" - Theo mặc định, số lượng loại hành động được giới hạn ở 20 bộ nhớ có số lượng hành động được thực thi lớn nhất. Việc đặt tuỳ chọn này sẽ ghi số liệu thống kê cho tất cả các bộ nhớ.
- Các tuỳ chọn chỉ định hoặc thay đổi dữ liệu đầu vào chung cho lệnh Bazel không thuộc các danh mục khác.:
- Giá trị mặc định của
--experimental_resolved_file_instead_of_workspace=<a string>
: "" -
Nếu không để trống, hãy đọc tệp đã giải quyết được chỉ định thay vì tệp WORKSPACE
Thẻ:changes_inputs
- Tuỳ chọn thực thi và lưu vào bộ nhớ đệm từ xa:
- Mặc định
--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ủ lưu trữ (cho `allow` và `block`) hoặc hai mẫu, một mẫu để so khớp và một mẫu để sử dụng làm URL thay thế, với các tham chiếu ngược bắt đầu từ `$1`. Bạn có thể cung cấp nhiều lệnh "ghi lại" cho cùng một URL và trong trường hợp này, hệ thống sẽ trả về nhiều URL.
- Các lựa chọn khác, không được phân loại theo cách khác.:
--override_repository=<an equals-separated mapping of repository name to path>
lần dùng được tích luỹ- Ghi đè kho lưu trữ bằng thư mục cục bộ.
Tuỳ chọn cấu hình
Các lựa chọn về phạm vi bao phủ
Kế thừa tất cả tuỳ chọn từ 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:
--distdir=<a path>
lần dùng được tích luỹ-
Các nơi khác để tìm kiếm các bản lưu trữ trước khi truy cập vào mạng để tải các bản lưu trữ đó xuống.
Thẻ:bazel_internal_configuration
- Giá trị mặc định của
--[no]experimental_repository_cache_hardlinks
: "false" -
Nếu được thiết lập, bộ nhớ đệm của kho lưu trữ sẽ liên kết cứng tệp trong trường hợp có lượt truy cập bộ nhớ đệm, thay vì sao chép. Thao tác này nhằm tiết kiệm dung lượng ổ đĩa.
Thẻ:bazel_internal_configuration
- Giá trị mặc định của
--[no]experimental_repository_cache_urls_as_default_canonical_id
: "false" -
Nếu đúng, hãy sử dụng một chuỗi bắt nguồn từ URL của các tệp tải xuống từ kho lưu trữ dưới dạngcanonical_id nếu không được chỉ định. Điều này khiến URL thay đổi, dẫn đến việc tải xuống lại ngay cả khi bộ nhớ đệm chứa tệp tải xuống có cùng hàm băm. Bạn có thể sử dụng quy trình này để xác minh rằng các thay đổi về URL không làm hỏng các kho lưu trữ bị bộ nhớ đệm che khuất.
Thẻ:loading_and_analysis
,experimental
- Giá trị mặc định của
--[no]experimental_repository_disable_download
: "false" -
Nếu đã đặt, bạn sẽ không được phép tải các kho lưu trữ bên ngoài xuống.
Thẻ:experimental
- Giá trị mặc định của
--experimental_repository_downloader_retries=<an integer>
: "0" -
Số lần thử tải lại lỗi xuống tối đa. Nếu bạn đặt chính sách này thành 0, hoạt động thử lại sẽ bị tắt.
Thẻ:experimental
- Giá trị mặc định của
--experimental_scale_timeouts=<a double>
: "1" -
Điều chỉnh tỷ lệ tất cả thời gian chờ trong quy tắc kho lưu trữ Starlark theo hệ số này. Bằng cách này, các kho lưu trữ bên ngoài có thể hoạt động trên các máy chậm hơn dự kiến của tác giả quy tắc mà không cần thay đổi mã nguồn
Thẻ:bazel_internal_configuration
,experimental
- Giá trị mặc định của
--http_timeout_scaling=<a double>
: "1" -
Điều chỉnh tỷ lệ tất cả thời gian chờ liên quan đến lượt tải xuống http theo hệ số cho trước
Thẻ:bazel_internal_configuration
- Mặc định
--repository_cache=<a path>
: xem nội dung mô tả -
Chỉ định vị trí bộ nhớ đệm của các giá trị được tải xuống thu được trong quá trình tìm nạp kho lưu trữ bên ngoài. Chuỗi trống dưới dạng đối số yêu cầu tắt bộ nhớ đệm.
Thẻ:bazel_internal_configuration
- Các lựa chọn ảnh hưởng đến mức độ nghiêm ngặt của Bazel trong việc thực thi dữ liệu đầu vào bản dựng hợp lệ (định nghĩa quy tắc, tổ hợp cờ, v.v.):
- Giá trị mặc định của
--experimental_repository_hash_file=<a string>
: "" -
Nếu giá trị không trống, hãy chỉ định tệp có chứa giá trị đã phân giải mà cần phải xác minh giá trị băm của thư mục kho lưu trữ
Thẻ:affects_outputs
,experimental
--experimental_verify_repository_rules=<a string>
lần dùng được tích luỹ-
Nếu danh sách các quy tắc kho lưu trữ mà hàm băm của thư mục đầu ra cần được xác minh, miễn là tệp được chỉ định bởi --experimental_repository_hash_file.
Thẻ:affects_outputs
,experimental
- Tuỳ chọn này ảnh hưởng đến ngữ nghĩa của ngôn ngữ Starlark hoặc API bản dựng có thể truy cập vào các tệp BUILD, tệp .bzl hoặc tệp WORKSPACE.:
- Giá trị mặc định của
--[no]experimental_allow_top_level_aspects_parameters
: "true" -
Không hoạt động
Thẻ:no_op
,deprecated
,experimental
- Các tuỳ chọn liên quan đến đầu ra và ngữ nghĩa Bzlmod:
--allow_yanked_versions=<a string>
lần dùng được tích luỹ-
Đã chỉ định các phiên bản mô-đun dưới dạng `<module1>@<version1>,<module2>@<version2>` sẽ được phép trong biểu đồ phần phụ thuộc đã phân giải ngay cả khi chúng được khai báo được kéo trong sổ đăng ký nơi chúng đến (nếu chúng không đến từ NonRegistryOverride). Nếu không, các phiên bản được kéo sẽ khiến quá trình phân giải bị lỗi. Bạn cũng có thể xác định phiên bản được kéo được phép bằng biến môi trường "BZLMOD_ALLOW_YANKED_VERSIONS". Bạn có thể vô hiệu hoá chế độ kiểm tra này bằng cách sử dụng từ khoá 'tất cả' (không nên dùng).
Thẻ:loading_and_analysis
- Giá trị 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" để báo cáo lỗi thành không giải quyết được, "tắt" để tắt tính năng kiểm tra hoặc "cảnh báo" để in một cảnh báo khi phát hiện thấy thông tin không khớp.
Thẻ:loading_and_analysis
- Giá trị 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 "bazel_dep" trực tiếp đượ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 đã phân giải hay không. Các giá trị hợp lệ là "off" để tắt tính năng kiểm tra, "warning" để in cảnh báo khi phát hiện thấy thông tin không khớp hoặc "error" để chuyển cảnh báo thành không giải quyết được.
Thẻ:loading_and_analysis
- Giá trị mặc định của
--[no]ignore_dev_dependency
: "false" -
Nếu đúng, Bazel sẽ bỏ qua phương thức "bazel_dep" và "use_extension" được khai báo là "dev_Dependencies" trong MODULE.bazel của mô-đun gốc. Lưu ý rằng các phần phụ thuộc dev đó 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
--override_module=<an equals-separated mapping of module name to path>
lần dùng được tích luỹ- Ghi đè mô-đun bằng thư mục cục bộ.
--registry=<a string>
lần dùng được tích luỹ-
Chỉ định sổ đăng ký cần sử dụng để xác định vị trí các phần phụ thuộc của mô-đun Bazel. Thứ tự này rất quan trọng: các mô-đun sẽ được tra cứu trong các sổ đăng ký trước đó trước và chỉ quay lại các sổ đăng ký sau đó nếu không có các mô-đun trước đó.
Thẻ:changes_inputs
- Các lựa chọn ảnh hưởng đến độ chi tiết, định dạng hoặc vị trí ghi nhật ký:
- Giá trị mặc định của
--[no]experimental_record_metrics_for_all_mnemonics
: "false" - Theo mặc định, số lượng loại hành động được giới hạn ở 20 bộ nhớ có số lượng hành động được thực thi lớn nhất. Việc đặt tuỳ chọn này sẽ ghi số liệu thống kê cho tất cả các bộ nhớ.
- Các tuỳ chọn chỉ định hoặc thay đổi dữ liệu đầu vào chung cho lệnh Bazel không thuộc các danh mục khác.:
- Giá trị mặc định của
--experimental_resolved_file_instead_of_workspace=<a string>
: "" -
Nếu không để trống, hãy đọc tệp đã giải quyết được chỉ định thay vì tệp WORKSPACE
Thẻ:changes_inputs
- Tuỳ chọn thực thi và lưu vào bộ nhớ đệm từ xa:
- Mặc định
--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ủ lưu trữ (cho `allow` và `block`) hoặc hai mẫu, một mẫu để so khớp và một mẫu để sử dụng làm URL thay thế, với các tham chiếu ngược bắt đầu từ `$1`. Bạn có thể cung cấp nhiều lệnh "ghi lại" cho cùng một URL và trong trường hợp này, hệ thống sẽ trả về nhiều URL.
- Các lựa chọn khác, không được phân loại theo cách khác.:
--override_repository=<an equals-separated mapping of repository name to path>
lần dùng được tích luỹ- Ghi đè kho lưu trữ bằng thư mục cục bộ.
Các lựa chọn cho Cquery
Kế thừa tất cả tuỳ chọn từ 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:
--distdir=<a path>
lần dùng được tích luỹ-
Các nơi khác để tìm kiếm các bản lưu trữ trước khi truy cập vào mạng để tải các bản lưu trữ đó xuống.
Thẻ:bazel_internal_configuration
- Giá trị mặc định của
--[no]experimental_repository_cache_hardlinks
: "false" -
Nếu được thiết lập, bộ nhớ đệm của kho lưu trữ sẽ liên kết cứng tệp trong trường hợp có lượt truy cập bộ nhớ đệm, thay vì sao chép. Thao tác này nhằm tiết kiệm dung lượng ổ đĩa.
Thẻ:bazel_internal_configuration
- Giá trị mặc định của
--[no]experimental_repository_cache_urls_as_default_canonical_id
: "false" -
Nếu đúng, hãy sử dụng một chuỗi bắt nguồn từ URL của các tệp tải xuống từ kho lưu trữ dưới dạngcanonical_id nếu không được chỉ định. Điều này khiến URL thay đổi, dẫn đến việc tải xuống lại ngay cả khi bộ nhớ đệm chứa tệp tải xuống có cùng hàm băm. Bạn có thể sử dụng quy trình này để xác minh rằng các thay đổi về URL không làm hỏng các kho lưu trữ bị bộ nhớ đệm che khuất.
Thẻ:loading_and_analysis
,experimental
- Giá trị mặc định của
--[no]experimental_repository_disable_download
: "false" -
Nếu đã đặt, bạn sẽ không được phép tải các kho lưu trữ bên ngoài xuống.
Thẻ:experimental
- Giá trị mặc định của
--experimental_repository_downloader_retries=<an integer>
: "0" -
Số lần thử tải lại lỗi xuống tối đa. Nếu bạn đặt chính sách này thành 0, hoạt động thử lại sẽ bị tắt.
Thẻ:experimental
- Giá trị mặc định của
--experimental_scale_timeouts=<a double>
: "1" -
Điều chỉnh tỷ lệ tất cả thời gian chờ trong quy tắc kho lưu trữ Starlark theo hệ số này. Bằng cách này, các kho lưu trữ bên ngoài có thể hoạt động trên các máy chậm hơn dự kiến của tác giả quy tắc mà không cần thay đổi mã nguồn
Thẻ:bazel_internal_configuration
,experimental
- Giá trị mặc định của
--http_timeout_scaling=<a double>
: "1" -
Điều chỉnh tỷ lệ tất cả thời gian chờ liên quan đến lượt tải xuống http theo hệ số cho trước
Thẻ:bazel_internal_configuration
- Mặc định
--repository_cache=<a path>
: xem nội dung mô tả -
Chỉ định vị trí bộ nhớ đệm của các giá trị được tải xuống thu được trong quá trình tìm nạp kho lưu trữ bên ngoài. Chuỗi trống dưới dạng đối số yêu cầu tắt bộ nhớ đệm.
Thẻ:bazel_internal_configuration
- Các lựa chọn ảnh hưởng đến mức độ nghiêm ngặt của Bazel trong việc thực thi dữ liệu đầu vào bản dựng hợp lệ (định nghĩa quy tắc, tổ hợp cờ, v.v.):
- Giá trị mặc định của
--experimental_repository_hash_file=<a string>
: "" -
Nếu giá trị không trống, hãy chỉ định tệp có chứa giá trị đã phân giải mà cần phải xác minh giá trị băm của thư mục kho lưu trữ
Thẻ:affects_outputs
,experimental
--experimental_verify_repository_rules=<a string>
lần dùng được tích luỹ-
Nếu danh sách các quy tắc kho lưu trữ mà hàm băm của thư mục đầu ra cần được xác minh, miễn là tệp được chỉ định bởi --experimental_repository_hash_file.
Thẻ:affects_outputs
,experimental
- Tuỳ chọn này ảnh hưởng đến ngữ nghĩa của ngôn ngữ Starlark hoặc API bản dựng có thể truy cập vào các tệp BUILD, tệp .bzl hoặc tệp WORKSPACE.:
- Giá trị mặc định của
--[no]experimental_allow_top_level_aspects_parameters
: "true" -
Không hoạt động
Thẻ:no_op
,deprecated
,experimental
- Các lựa chọn liên quan đến đầu ra của truy vấn và ngữ nghĩa:
- 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à một trong {xml,proto,record}. "off" có nghĩa là không có phần phụ thuộc khung hình nào được giải quyết, "thận trọng" (mặc định) có nghĩa là tất cả phần phụ thuộc khía cạnh đã khai báo đều được thêm vào bất kể chúng có được cung cấp lớp quy tắc của phần phụ thuộc trực tiếp hay không, "chính xác" có nghĩa là chỉ những khía cạnh đó được thêm vào mà 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. Xin lưu ý rằng chế độ chính xác yêu cầu tải các gói khác để đánh giá một mục tiêu. Do đó, mục tiêu này sẽ chậm hơn so với các chế độ khác. Ngoài ra, xin lưu ý rằng ngay cả chế độ chính xác cũng không hoàn toàn chính xác: việc quyết định có tính toán một khía cạnh hay không được quyết định trong giai đoạn phân tích, giai đoạn này không chạy trong quá trình "truy vấn bazel".
Thẻ:build_file_semantics
- Giá trị mặc định của
--[no]graph:factored
: "true" -
Nếu đúng, thì biểu đồ sẽ được tạo ra "được tạo thành thừa số", tức là các nút tương đương về cấu trúc liên kết sẽ được hợp nhất với nhau và nhãn của chúng sẽ được nối với nhau. Tuỳ chọn này chỉ áp dụng cho --output=graph.
Thẻ:terminal_output
- Giá trị 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 dữ liệu đầu ra. 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=graph.
Thẻ:terminal_output
- Giá trị mặc định của
--[no]implicit_deps
: "true" -
Nếu được bật, các phần phụ thuộc ngầm ẩ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ằng 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ụ đã phân giải.
Thẻ:build_file_semantics
- Giá trị mặc định của
--[no]include_aspects
: "true" -
aquery, cquery: liệu có bao gồm các hành động được tạo theo khía cạnh trong kết quả hay không. query: no-op (luôn đi theo các khía cạnh).
Thẻ:terminal_output
- Giá trị mặc định của
--[no]incompatible_display_source_file_location
: "true" -
"True" theo mặc định sẽ hiển thị mục tiêu của tệp nguồn. Nếu đúng, hiển thị vị trí dòng 1 của tệp nguồn trong dữ liệu đầu ra vị trí. Cờ này chỉ dành cho mục đích di chuyển.
Thẻ:terminal_output
,incompatible_change
- Giá trị mặc định của
--[no]incompatible_package_group_includes_double_slash
: "true" -
Nếu được bật, khi xuất thuộc tính "packages" của package_group, phần tử "//" ở đầu sẽ không bị bỏ qua.
Thẻ:terminal_output
,incompatible_change
- Giá trị mặc định của
--[no]infer_universe_scope
: "false" -
Nếu bạn không đặt giá trị đặt và --universe_scope thì giá trị của --universe_scope sẽ được suy ra dưới dạng danh sách các mẫu mục tiêu riêng biệ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 vũ trụ (ví dụ:`allrdeps`) có thể không phải là giá trị bạn muốn. Vì vậy, bạn chỉ nên sử dụng tuỳ chọn này nếu biết mình đang làm gì. Hãy 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 ý: tuỳ chọn này chỉ áp dụng cho "query" (nghĩa là không áp dụng cho "cquery").
Thẻ:loading_and_analysis
- Giá trị mặc định của
--[no]line_terminator_null
: "false" -
Liệu mỗi định dạng có bị chấm dứt bằng \0 thay vì dòng mới hay không.
Thẻ:terminal_output
- Giá trị mặc định của
--[no]nodep_deps
: "true" -
Nếu được bật, phần phụ thuộc từ "nodep" sẽ được đưa vào biểu đồ phần phụ thuộc mà qua đó truy vấn hoạt động. Một ví dụ phổ biến về "nút" 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ả "nodep" trong ngôn ngữ bản dựng.
Thẻ:build_file_semantics
- Giá trị mặc định của
--output=<a string>
: "label" -
Định dạng mà kết quả cquery sẽ được in. Các giá trị được phép cho cquery là: label, label_ kind, textproto, chuyển đổi, proto, jsonproto. Nếu chọn 'chuyển đổi', bạn cũng phải chỉ định tuỳ chọn --transitions=(lite|full).
Thẻ:terminal_output
- Giá trị mặc định của
--[no]proto:default_values
: "true" -
Nếu đúng, các thuộc tính có giá trị không được chỉ định rõ ràng trong tệp BUILD sẽ được đưa vào; nếu không thì chúng sẽ bị bỏ qua. Tuỳ chọn này có thể áp dụng cho --output=proto
Thẻ:terminal_output
- Giá trị mặc định của
--[no]proto:definition_stack
: "false" -
Điền vào trường proto Definition_stack sẽ ghi lại từng thực thể quy tắc của ngăn xếp lệnh gọi Starlark tại thời điểm xác định lớp của quy tắc.
Thẻ:terminal_output
- Giá trị mặc định của
--[no]proto:flatten_selects
: "true" -
Nếu bạn bật tuỳ chọn này, các thuộc tính có thể định cấu hình do Select() tạo sẽ được làm phẳng. Đối với các loại danh sách, bản trình bày đã làm phẳng là danh sách chứa chính xác mỗi giá trị của tệp ánh xạ được chọn 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
- Giá trị mặc định của
--[no]proto:include_configurations
: "true" -
nếu được bật, đầu ra proto sẽ bao gồm thông tin về cá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
- Giá trị mặc định của
--[no]proto:include_synthetic_attribute_hash
: "false" -
Liệu có tính toán và điền thuộc tính $internal_attr_hash hay không.
Thẻ:terminal_output
- Giá trị mặc định của
--[no]proto:instantiation_stack
: "false" -
Điền ngăn xếp lệnh gọi tạo thực thể của từng quy tắc. Lưu ý rằng thao tác này đòi hỏi phải có ngăn xếp
Thẻ:terminal_output
- Giá trị mặc định của
--[no]proto:locations
: "true" -
Liệu có xuất thông tin vị trí trong đầu ra proto hay không.
Thẻ:terminal_output
- Mặc định của
--proto:output_rule_attrs=<comma-separated list of options>
: "tất cả" -
Danh sách thuộc tính được phân tách bằng dấu phẩy để đưa vào dữ liệu đầu ra. Giá trị mặc định là tất cả thuộc tính. Bạn phải đặt thành chuỗi trống để không xuất thuộc tính nào. Tuỳ chọn này có thể áp dụng cho --output=proto.
Thẻ:terminal_output
- Giá trị mặc định của
--[no]proto:rule_inputs_and_outputs
: "true" -
Liệu có điền sẵn các trường rules_input và rules_output hay không.
Thẻ:terminal_output
- Giá trị mặc định của
--[no]relative_locations
: "false" -
Nếu đúng, vị trí của các tệp BUILD trong đầu ra xml và proto sẽ là tương đối. Theo mặc định, kết quả vị trí là một đường dẫn tuyệt đối và sẽ không nhất quán giữa các máy. Bạn có thể đặt tuỳ chọn này thành true để nhận được kết quả nhất quán trên các máy.
Thẻ:terminal_output
- Giá trị mặc định của
--show_config_fragments=<off, direct or transitive>
: "tắt" -
Cho biết các mảnh cấu hình theo yêu cầu của một quy tắc 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ó thể cắt bớt một biểu đồ mục tiêu đã định cấu hình.
Thẻ:affects_outputs
- Giá trị mặc định của
--starlark:expr=<a string>
: "" -
Biểu thức Starlark để định dạng từng mục tiêu được đị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 "target". Nếu bạn không chỉ định --starlark:expr hay --starlark:file, thì tuỳ chọn này sẽ được đặt thành 'str(target.label)' theo mặc định. Lỗi khi chỉ định cả --starlark:expr và --starlark:file.
Thẻ:terminal_output
- Giá trị mặc định của
--starlark:file=<a string>
: "" -
Tên của một tệp định nghĩa hàm Starlark có tên là "format" (định dạng) của một đối số, được áp dụng cho mỗi mục tiêu được định cấu hình để định dạng mục tiêu đó dưới dạng chuỗi. Lỗi khi chỉ định cả --starlark:expr và --starlark:file. Xem phần trợ giúp về --output=starlark để biết thêm thông tin chi tiết.
Thẻ:terminal_output
- Giá trị mặc định của
--[no]tool_deps
: "true" -
Truy vấn: Nếu bị tắt, các phần phụ thuộc trên "cấu hình máy chủ" hoặc "thực thi" sẽ không được đưa vào biểu đồ phụ thuộc mà qua đó truy vấn hoạt động. "Cấu hình máy chủ lưu trữ" cạnh phụ thuộc, chẳng hạn như cạnh phụ thuộc từ bất kỳ "proto_library" nào cho 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 'mục tiêu' .
Cquery: Nếu bị tắt, hãy lọc tất cả các mục tiêu đã định cấu hình vượt qua quá trình chuyển đổi lưu trữ hoặc thực thi khỏi 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ũng 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 máy chủ lưu trữ, thì chỉ các mục tiêu đã định cấu hình của máy chủ lưu trữ mới được trả về. Tuỳ chọn này sẽ KHÔNG loại trừ chuỗi công cụ đã phân giải.
Thẻ:build_file_semantics
- Giá trị 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
- Giá trị 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 đóng bắc cầu của các mục tiêu được chỉ định. Tuỳ chọn này được dùng cho các lệnh truy vấn và cquery.
Đối với cquery, đầu vào cho tuỳ chọn này là mục tiêu mà tất cả các câu trả lời đều được xây dựng, do đó, tuỳ chọn này có thể ảnh hưởng đến cấu hình và hiệu ứng chuyển đổi. Nếu bạn không chỉ định tùy chọn này, thì các mục tiêu cấp cao nhất được coi 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ị lỗi nếu không thể tạo các mục tiêu được phân tích cú pháp từ biểu thức truy vấn bằng các tuỳ chọn cấp cao nhất.
Thẻ:loading_and_analysis
- Các lựa chọn liên quan đến đầu ra và ngữ nghĩa Bzlmod:
--allow_yanked_versions=<a string>
lần dùng được tích luỹ-
Đã chỉ định các phiên bản mô-đun dưới dạng `<module1>@<version1>,<module2>@<version2>` sẽ được phép trong biểu đồ phần phụ thuộc đã phân giải ngay cả khi chúng được khai báo được kéo trong sổ đăng ký nơi chúng đến (nếu chúng không đến từ NonRegistryOverride). Nếu không, các phiên bản được kéo sẽ khiến quá trình phân giải bị lỗi. Bạn cũng có thể xác định phiên bản được kéo được phép bằng biến môi trường "BZLMOD_ALLOW_YANKED_VERSIONS". Bạn có thể vô hiệu hoá chế độ kiểm tra này bằng cách sử dụng từ khoá 'tất cả' (không nên dùng).
Thẻ:loading_and_analysis
- Giá trị 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" để báo cáo lỗi thành không giải quyết được, "tắt" để tắt tính năng kiểm tra hoặc "cảnh báo" để in một cảnh báo khi phát hiện thấy thông tin không khớp.
Thẻ:loading_and_analysis
- Giá trị 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 "bazel_dep" trực tiếp đượ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 đã phân giải hay không. Các giá trị hợp lệ là "off" để tắt tính năng kiểm tra, "warning" để in cảnh báo khi phát hiện thấy thông tin không khớp hoặc "error" để chuyển cảnh báo thành không giải quyết được.
Thẻ:loading_and_analysis
- Giá trị mặc định của
--[no]ignore_dev_dependency
: "false" -
Nếu đúng, Bazel sẽ bỏ qua phương thức "bazel_dep" và "use_extension" được khai báo là "dev_Dependencies" trong MODULE.bazel của mô-đun gốc. Lưu ý rằng các phần phụ thuộc dev đó 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
--override_module=<an equals-separated mapping of module name to path>
lần dùng được tích luỹ- Ghi đè mô-đun bằng thư mục cục bộ.
--registry=<a string>
lần dùng được tích luỹ-
Chỉ định sổ đăng ký cần sử dụng để xác định vị trí các phần phụ thuộc của mô-đun Bazel. Thứ tự này rất quan trọng: các mô-đun sẽ được tra cứu trong các sổ đăng ký trước đó trước và chỉ quay lại các sổ đăng ký sau đó nếu không có các mô-đun trước đó.
Thẻ:changes_inputs
- Các lựa chọn ảnh hưởng đến độ chi tiết, định dạng hoặc vị trí ghi nhật ký:
- Giá trị mặc định của
--[no]experimental_record_metrics_for_all_mnemonics
: "false" - Theo mặc định, số lượng loại hành động được giới hạn ở 20 bộ nhớ có số lượng hành động được thực thi lớn nhất. Việc đặt tuỳ chọn này sẽ ghi số liệu thống kê cho tất cả các bộ nhớ.
- Các tuỳ chọn chỉ định hoặc thay đổi dữ liệu đầu vào chung cho lệnh Bazel không thuộc các danh mục khác.:
- Giá trị mặc định của
--experimental_resolved_file_instead_of_workspace=<a string>
: "" -
Nếu không để trống, hãy đọc tệp đã giải quyết được chỉ định thay vì tệp WORKSPACE
Thẻ:changes_inputs
- Tuỳ chọn thực thi và lưu vào bộ nhớ đệm từ xa:
- Mặc định
--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ủ lưu trữ (cho `allow` và `block`) hoặc hai mẫu, một mẫu để so khớp và một mẫu để sử dụng làm URL thay thế, với các tham chiếu ngược bắt đầu từ `$1`. Bạn có thể cung cấp nhiều lệnh "ghi lại" cho cùng một URL và trong trường hợp này, hệ thống sẽ trả về nhiều URL.
- Các lựa chọn khác, không được phân loại theo cách khác.:
--override_repository=<an equals-separated mapping of repository name to path>
lần dùng được tích luỹ- Ghi đè kho lưu trữ bằng thư mục cục bộ.
- Các tuỳ chọn kiểm soát việc thực thi bản dựng:
- Giá trị mặc định của
--[no]experimental_inprocess_symlink_creation
: "false" -
Liệu có thực hiện lệnh gọi hệ thống tệp trực tiếp để tạo cây liên kết tượng trưng hay không
Thẻ:loading_and_analysis
,execution
,experimental
- Giá trị mặc định của
--[no]experimental_remotable_source_manifests
: "false" -
Có thể cho phép từ xa các hành động trong tệp kê khai nguồn hay không
Thẻ:loading_and_analysis
,execution
,experimental
- Giá trị mặc định của
--[no]experimental_split_coverage_postprocessing
: "false" -
Nếu true, Bazel sẽ chạy xử lý hậu kỳ về mức độ sử dụng để kiểm thử trong một lượt sinh sản mới.
Thẻ:execution
- Giá trị mặc định của
--[no]experimental_strict_fileset_output
: "false" -
Nếu bật tuỳ chọn này, tập hợp tệp sẽ coi tất cả cấu phần phần mềm đầu ra là tệp thông thường. Chúng sẽ không truyền tải các thư mục hoặc nhạy cảm với đường liên kết tượng trưng.
Thẻ:execution
- Giá trị 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 ghi nhớ hành động. Chỉ áp dụng cho các thao tác hỗ trợ thông tin thực thi. Nhiều thao tác phổ biến có 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 ghi nhớ.
Cú pháp: "regex=[+-]key,regex=[+-]key,...".
Ví dụ:
'.*=+x,.*=-y,.*=+z' thêm "x" và 'z' đến và xoá 'y' từ thông tin thực thi cho tất cả các hành động.
"Genrules=+yêu cầu-x" thêm 'require-x' vào thông tin thực thi của mọi thao tác trên Quy tắc Gen.
'(?!Genrules).*=-requirements-x' xoá "request-x" trong thông tin thực thi cho tất cả các hành động không phải Quy tắc chung.
Thẻ:execution
,affects_outputs
,loading_and_analysis
--persistent_android_dex_desugar
-
Cho phép các thao tác đơn giản hoá và tạo tệp dex trên Android liên tục bằng cách sử dụng worker.
Mở rộng thành:
--strategy=Desugar=worker
--strategy=DexBuilder=worker
Thẻ:host_machine_resource_optimizations
,execution
--persistent_android_resource_processor
-
Cho phép trình xử lý tài nguyên Android ổn định bằng cách sử dụng worker.
Mở rộng thành:
--internal_persistent_busybox_tools
--strategy=AaptPackage=worker
--strategy=AndroidResourceParser=worker
--strategy=AndroidResourceValidator=worker
--strategy=AndroidResourceCompiler=worker
--strategy=RClassGenerator=worker
--strategy=AndroidResourceLink=worker
--strategy=AndroidAapt2=worker
--strategy=AndroidAssetMerger=worker
/--strategy=AndroidResourceMerger=worker
/--strategy=AndroidCompiledResourceMerger=worker
/--strategy=ManifestMerger=worker
/--strategy=AndroidManifestMerger=worker
/--strategy=Aapt2Optimize=worker
/--strategy=AARGenerator=worker
Thẻ:host_machine_resource_optimizations
,execution
--persistent_multiplex_android_dex_desugar
-
Bật các thao tác đơn giản hoá và giải mã Android được ghép liên tục bằng trình thực thi.
Mở rộng thành:
--persistent_android_dex_desugar
--modify_execution_info=Desugar=+supports-multiplex-workers
--modify_execution_info=DexBuilder=+supports-multiplex-workers
Thẻ:host_machine_resource_optimizations
,execution
--persistent_multiplex_android_resource_processor
-
Bật trình xử lý tài nguyên Android ghép nối liên tục bằng cách sử dụng worker.
Mở rộng thành:
--persistent_android_resource_processor
--modify_execution_info=AaptPackage=+supports-multiplex-workers
--modify_execution_info=AndroidResourceParser=+supports-multiplex-workers
--modify_execution_info=AndroidResourceValidator=+supports-multiplex-workers
--modify_execution_info=AndroidResourceCompiler=+supports-multiplex-workers
--modify_execution_info=RClassGenerator=+supports-multiplex-workers
--modify_execution_info=AndroidResourceLink=+supports-multiplex-workers
--modify_execution_info=AndroidAapt2=+supports-multiplex-workers
--modify_execution_info=AndroidAssetMerger=+supports-multiplex-workers
/--modify_execution_info=AndroidResourceMerger=+supports-multiplex-workers
/--modify_execution_info=AndroidCompiledResourceMerger=+supports-multiplex-workers
/--modify_execution_info=ManifestMerger=+supports-multiplex-workers
/--modify_execution_info=AndroidManifestMerger=+supports-multiplex-workers
/--modify_execution_info=Aapt2Optimize=+supports-multiplex-workers
/--modify_execution_info=AARGenerator=+supports-multiplex-workers
Thẻ:host_machine_resource_optimizations
,execution
--persistent_multiplex_android_tools
-
Bật các công cụ Android liên tục và đa kênh (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
- 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
--android_compiler=<a string>
: xem nội dung mô tả -
Trình biên dịch mục tiêu Android.
Thẻ:affects_outputs
,loading_and_analysis
,loses_incremental_state
- Giá trị 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
--android_grte_top=<a label>
: xem nội dung mô tả -
Mục tiêu Android grte_top.
Thẻ:changes_inputs
,loading_and_analysis
,loses_incremental_state
- Giá trị 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
- Giá trị mặc định của
--android_platforms=<a build target label>
: "" -
Đặt các nền tảng mà mục tiêu android_binary sử dụng. Nếu bạn chỉ định nhiều nền tảng, thì tệp nhị phân sẽ là tệp APK lớn, chứa các tệp nhị phân gốc cho từng nền tảng mục tiêu được chỉ định.
Thẻ:changes_inputs
,loading_and_analysis
,loses_incremental_state
- 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
- Mặc định
--apple_compiler=<a string>
: xem nội dung mô tả -
Trình biên dịch mục tiêu của Apple. Hữu ích khi chọn các biến thể của chuỗi công cụ (ví dụ: xcode-beta).
Thẻ:affects_outputs
,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 crosstool sẽ được dùng trong các quy tắc của Apple và Objc cũng như các phần phụ thuộc của chúng.
Thẻ:loses_incremental_state
,changes_inputs
- Mặc định
--apple_grte_top=<a build target label>
: xem nội dung mô tả -
Mục tiêu grte_top của Apple.
Thẻ:changes_inputs
,loading_and_analysis
,loses_incremental_state
- Giá trị mặc định của
--cc_output_directory_tag=<a string>
: "" -
Chỉ định một hậu tố cần thêm vào thư mục cấu hình.
Thẻ:affects_outputs
,explicit_in_output_path
- Mặc định
--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 để xử lý hậu kỳ các báo cáo về mức độ phù hợp thô. Hiện tại, đây phải là một nhóm tệp 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 về mức độ phù hợp. Hiện tại, đây phải là một nhóm tệp 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ợ cần thiết đối với dữ liệu đầu vào của mọi hành động kiểm thử giúp 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 crosstool sẽ được dùng để biên dịch mã C++.
Thẻ:loading_and_analysis
,changes_inputs
,affects_outputs
- Mặc định
--custom_malloc=<a build target label>
: xem nội dung mô tả -
Chỉ định cách 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.
Thẻ:changes_inputs
,affects_outputs
--experimental_add_exec_constraints_to_targets=<a '<RegexFilter>=<label1>[,<label2>,...]' assignment>
lần dùng được tích luỹ-
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ố là - (biểu thức âm) (không bắt buộc) được gán (=) cho 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ông khớp với biểu thức phủ định nào và có ít nhất một biểu thức dương, thì độ phân giải của chuỗi công cụ sẽ được thực hiện như thể đã khai báo các giá trị ràng buộc làm điều kiện ràng buộc thực thi. Ví dụ: //demo,-test=@platforms//cpus:x86_64 sẽ thêm 'x86_64' vào bất kỳ mục tiêu nào trong //demo ngoại trừ những mục tiêu có tên chứa 'test'.
Thẻ:loading_and_analysis
- Giá trị mặc định của
--[no]experimental_enable_objc_cc_deps
: "true" -
Cho phép các quy tắc objc_* phụ thuộc vào cc_library và khiến mọi phần phụ thuộc objc được tạo với --cpu được đặt thành "ios_<--ios_cpu>" cho bất kỳ giá trị nào trong --ios_multi_cpu.
Thẻ:loading_and_analysis
,incompatible_change
- Giá trị mặc định của
--[no]experimental_include_xcode_execution_requirements
: "false" -
Nếu đã đặt, hãy thêm "require-xcode:{version}" cho mọi hành động trên Xcode. Nếu phiên bản xcode có nhãn được gạch nối, hãy thêm cả "require-xcode-label:{version_label}" yêu cầu thực thi.
Thẻ:loses_incremental_state
,loading_and_analysis
,execution
- Giá trị mặc định của
--[no]experimental_prefer_mutual_xcode
: "true" -
Nếu đúng, hãy sử dụng Xcode mới nhất có sẵn cả tại địa phương và từ xa. Nếu sai hoặc nếu không có phiên bản nào hỗ trợ lẫn 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
--extra_execution_platforms=<comma-separated list of options>
lần dùng được tích luỹ-
Các nền tảng có sẵn dưới dạng nền tảng thực thi để chạy các hành động. Bạn có thể chỉ định nền tảng theo mục tiêu chính xác hoặc dưới dạng mẫu mục tiêu. Các nền tảng này sẽ được xem xét trước những nền tảng được khai báo trong tệp WORKSPACE bằng register_execution_platforms().
Thẻ:execution
--extra_toolchains=<comma-separated list of options>
lần dùng được tích luỹ-
Các quy tắc chuỗi công cụ cần được xem xét trong quá trình phân giải chuỗi công cụ. Bạn có thể chỉ định chuỗi công cụ theo mục tiêu chính xác hoặc dưới dạng mẫu mục tiêu. Các chuỗi công cụ này sẽ được xem xét trước các chuỗi công cụ được khai báo trong tệp WORKSPACE bằng register_toolchains().
Thẻ:affects_outputs
,changes_inputs
,loading_and_analysis
- Mặc định
--grte_top=<a label>
: xem nội dung mô tả -
Nhãn cho thư viện libc đã được đăng ký. 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 phải ghi đè giá trị này.
Thẻ:action_command_lines
,affects_outputs
- Mặc định
--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
--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 máy chủ lưu trữ. 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 đã cho.
Thẻ:loading_and_analysis
,changes_inputs
,affects_outputs
- Mặc định
--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 của libc (--grte_top) cho cấu hình máy chủ lưu trữ.
Thẻ:action_command_lines
,affects_outputs
- Giá trị mặc định của
--host_platform=<a build target label>
: "" -
Nhãn của một quy tắc nền tảng mô tả hệ thống lưu trữ.
Thẻ:affects_outputs
,changes_inputs
,loading_and_analysis
- Giá trị mặc định của
--[no]incompatible_disable_expand_if_all_available_in_flag_set
: "true" -
Nếu đúng, Bazel sẽ không cho phép chỉ định mở rộng_if_all_available trongflag_sets(xem https://github.com/bazelbuild/bazel/issues/7008 để biết hướng dẫn di chuyển).
Thẻ:loading_and_analysis
,incompatible_change
- Giá trị mặc định của
--[no]incompatible_dont_enable_host_nonhost_crosstool_features
: "true" -
Nếu đúng, Bazel sẽ không bật "máy chủ lưu trữ" và "nonhost" trong chuỗi công cụ c++ (xem https://github.com/bazelbuild/bazel/issues/7407 để biết thêm thông tin).
Thẻ:loading_and_analysis
,incompatible_change
- Giá trị mặc định của
--[no]incompatible_enable_android_toolchain_resolution
: "false" -
Sử dụng độ phân giải chuỗi công cụ để chọn SDK Android cho các quy tắc Android (Starlark và gốc)
Thẻ:loading_and_analysis
,incompatible_change
- Giá trị mặc định của
--[no]incompatible_enable_apple_toolchain_resolution
: "false" -
Sử dụng độ phân giải của chuỗi công cụ để chọn Apple SDK cho các quy tắc của apple (Starlark và gốc)
Thẻ:loading_and_analysis
,incompatible_change
- Giá trị mặc định của
--[no]incompatible_make_thinlto_command_lines_standalone
: "true" -
Nếu đúng, Bazel sẽ không sử dụng lại các dòng lệnh hành động liên kết C++ cho các dòng lệnh lập chỉ mục lto (xem https://github.com/bazelbuild/bazel/issues/6791 để biết thêm thông tin).
Thẻ:loading_and_analysis
,incompatible_change
- Giá trị mặc định của
--[no]incompatible_remove_cpu_and_compiler_attributes_from_cc_toolchain
: "true" -
Nếu đúng, Bazel sẽ khiếu nại khi các thuộc tính cc_toolchain.cpu và cc_toolchain.compiler được đặt (xem https://github.com/bazelbuild/bazel/issues/7075 để biết hướng dẫn di chuyển).
Thẻ:loading_and_analysis
,incompatible_change
- Giá trị mặc định của
--[no]incompatible_remove_legacy_whole_archive
: "true" -
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
- Giá trị mặc định của
--[no]incompatible_require_ctx_in_configure_features
: "true" -
Nếu đúng, Bazel sẽ yêu cầu 'ctx' vào cc_common.configure_features (xem https://github.com/bazelbuild/bazel/issues/7793 để biết thêm thông tin).
Thẻ:loading_and_analysis
,incompatible_change
-
Sử dụng các đối tượng dùng chung trong 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
--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 SDK iOS cần sử dụng để xây dựng ứng dụng iOS. Nếu bạn chưa chỉ định, hãy sử dụng phiên bản SDK iOS mặc định trong "xcode_version".
Thẻ:loses_incremental_state
- Mặc định
--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 SDK macOS mà bạn muốn dùng để xây dựng ứng dụng cho macOS. Nếu bạn chưa chỉ định, hãy sử dụng phiên bản SDK macOS mặc định trong "xcode_version".
Thẻ:loses_incremental_state
- Mặc định
--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à cấu hình biên dịch của bạn nhắm đến.
Thẻ:loading_and_analysis
,affects_outputs
- Giá trị mặc định của
--platform_mappings=<a relative path>
: "" -
Vị trí của tệp ánh xạ mô tả nền tảng sẽ 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 nền tảng đã tồn tại. Phải tương ứng với thư mục gốc của không gian làm việc chính. Giá trị mặc định là "platform_mappings" (một tệp ngay dưới thư mục gốc của không gian làm việc).
Thẻ:affects_outputs
,changes_inputs
,loading_and_analysis
- Giá trị 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
--python2_path=<a string>
: xem nội dung mô tả -
Không được dùng nữa, không hoạt động. Bị tắt bởi "--incompatible_use_python_toolchains".
Thẻ:no_op
,deprecated
- Mặc định
--python3_path=<a string>
: xem nội dung mô tả -
Không được dùng nữa, không hoạt động. Bị tắt bởi "--incompatible_use_python_toolchains".
Thẻ:no_op
,deprecated
- Mặc định
--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
--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
- Giá trị mặc định của
--target_platform_fallback=<a build target label>
: "@local_config_platform//:host" -
Nhãn của một quy tắc nền tảng nên được sử dụng nếu không có nền tảng mục tiêu nào được đặt và không có ánh xạ nền tảng nào khớp với bộ cờ hiện tại.
Thẻ:affects_outputs
,changes_inputs
,loading_and_analysis
- Mặc định
--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 để sử dụng cho việc tạo ứng dụng tvOS. Nếu bạn chưa 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
--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 SDK watchOS cần 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 trong "xcode_version".
Thẻ:loses_incremental_state
- Mặc định
--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 liên quan đến bản dựng. Nếu chưa chỉ định, hãy sử dụng phiên bản Xcode mặc định của trình thực thi.
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:
- Giá trị mặc định của
--[no]apple_enable_auto_dsym_dbg
: "false" -
Liệu có buộc bật (các) tệp biểu tượng gỡ lỗi (.dSYM) cho các bản dựng dbg hay không.
Thẻ:affects_outputs
,action_command_lines
- Giá trị mặc định của
--[no]apple_generate_dsym
: "false" -
Liệu có tạo (các) tệp biểu tượng gỡ lỗi (.dSYM) hay không.
Thẻ:affects_outputs
,action_command_lines
- Giá trị mặc định của
--[no]build_runfile_links
: "true" -
Nếu đúng, hãy tạo các khu vực liên kết tượng trưng cho các tệp runfile cho tất cả các mục tiêu. Nếu giá trị là false, chỉ ghi tệp kê khai khi có thể.
Thẻ:affects_outputs
- Giá trị mặc định của
--[no]build_runfile_manifests
: "true" -
Nếu đúng, hãy ghi các tệp kê khai runfile cho tất cả đích. Nếu sai, hãy bỏ qua các giá trị này. Kiểm thử cục bộ sẽ không chạy được khi giá trị là false.
Thẻ:affects_outputs
- Giá trị mặc định của
--[no]build_test_dwp
: "false" -
Nếu được bật, khi xây dựng các chương trình kiểm thử C++ theo cách tĩnh và phân phối, 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
- Giá trị mặc định của
--cc_proto_library_header_suffixes=<comma-separated list of options>
: ".pb.h" -
Đặt tiền tố của tệp tiêu đề mà cc_proto_library tạo.
Thẻ:affects_outputs
,loading_and_analysis
- Giá trị mặc định của
--cc_proto_library_source_suffixes=<comma-separated list of options>
: ".pb.cc" -
Đặt tiền tố của tệp nguồn mà cc_proto_library tạo.
Thẻ:affects_outputs
,loading_and_analysis
- Giá trị mặc định của
--[no]experimental_proto_descriptor_sets_include_source_info
: "false" -
Chạy các hành động bổ sung cho phiên bản API Java thay thế trong một proto_library.
Thẻ:affects_outputs
,loading_and_analysis
,experimental
- Giá trị mặc định của
--[no]experimental_proto_extra_actions
: "false" -
Chạy các hành động bổ sung cho phiên bản API Java thay thế trong một proto_library.
Thẻ:affects_outputs
,loading_and_analysis
,experimental
- Giá trị mặc định của
--[no]experimental_save_feature_state
: "false" -
Lưu trạng thái của các tính năng đã bật và được yêu cầu dưới dạng kết quả của quá trình biên dịch.
Thẻ:affects_outputs
,experimental
- Giá trị mặc định của
--fission=<a set of compilation modes>
: "không" -
Chỉ định chế độ biên dịch nào sử dụng phân hạch cho các đường liên kết và biên dịch C++. Có thể là bất kỳ tổ hợp nào của {'fastbuild', 'dbg', 'opt'} hoặc các giá trị đặc biệt "yes" để bật tất cả các chế độ và chọn "không" để tắt tất cả các chế độ.
Thẻ:loading_and_analysis
,action_command_lines
,affects_outputs
- Giá trị mặc định của
--[no]incompatible_always_include_files_in_data
: "true" -
Nếu đúng, các quy tắc gốc sẽ thêm <code>DefaultInfo.files</code> phần phụ thuộc dữ liệu vào các tệp chạy của chúng, khớp với hành vi được đề xuất cho quy tắc Starlark (https://bazel.build/extend/rules#runfiles_features_to_avoid).
Thẻ:affects_outputs
,incompatible_change
- Giá trị mặc định của
--[no]legacy_external_runfiles
: "true" -
Nếu đúng, hãy tạo các khu rừng symlink runfiles cho các kho lưu trữ bên ngoài trong .runfiles/wsname/external/repo (ngoài .runfiles/repo).
Thẻ:affects_outputs
- Giá trị mặc định của
--[no]objc_generate_linkmap
: "false" -
Chỉ định xem có tạo tệp sơ đồ liên kết hay không.
Thẻ:affects_outputs
- Giá trị mặc định của
--[no]save_temps
: "false" -
Nếu bạn đặt chính sách này, hệ thống sẽ lưu kết quả tạm thời từ gcc. Các tệp này bao gồm tệp .s (mã trình tập hợp), tệp .i (tệp C đã xử lý trước) và tệp .ii (mã C++ được xử lý trước).
Thẻ:affects_outputs
- Các tuỳ chọn cho phép người dùng định cấu hình đầu ra dự kiến, ảnh hưởng đến giá trị của đầu ra đó, trái ngược với sự tồn tại của đầu ra đó:
--action_env=<a 'name=value' assignment with an optional value part>
lần dùng được tích luỹ-
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. Biến có thể được chỉ định theo tên. Trong trường hợp đó, giá trị sẽ được lấy từ môi trường gọi hoặc bằng cặp name=value sẽ đặ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; cho các lựa chọn được cung cấp cho cùng một biến, các biến mới nhất sẽ chiến thắng, các tuỳ 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
- Giá trị mặc định của
--[no]android_databinding_use_androidx
: "false" -
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 dùng với tính năng liên kết dữ liệu phiên bản 2.
Thẻ:affects_outputs
,loading_and_analysis
,loses_incremental_state
,experimental
- Giá trị mặc định của
--[no]android_databinding_use_v3_4_args
: "false" -
Sử dụng liên kết dữ liệu Android phiên bản 2 với đối số 3.4.0
Thẻ:affects_outputs
,loading_and_analysis
,loses_incremental_state
,experimental
- Giá trị 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 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 đủ' nghĩa là tất cả thư viện sẽ được liên kết động. "off" 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
- Mặc định của
--android_manifest_merger_order=<alphabetical, alphabetical_by_configuration or dependency>
: "theo thứ tự bảng chữ cái" -
Thiết lập thứ tự của 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. ALPHABETICS nghĩa là tệp kê khai được sắp xếp theo đường dẫn tương ứng với tập lệnh thực thi. ALPHABETICS_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 nghĩa là các tệp kê khai được sắp xếp theo thứ tự của từng tệp kê khai của thư viện đến trước tệp kê khai của các phần phụ thuộc.
Thẻ:action_command_lines
,execution
- Giá trị mặc định của
--[no]android_resource_shrinking
: "false" -
Bật tính năng rút gọn tài nguyên cho các APK android_binary sử dụng ProGuard.
Thẻ:affects_outputs
,loading_and_analysis
--apple_bitcode=<'mode' or 'platform=mode', where 'mode' is none, embedded_markers or embedded, and 'platform' is ios, watchos, tvos, macos or catalyst>
lần dùng được tích luỹ-
Chỉ định chế độ mã bit của Apple cho các bước biên dịch nhắm đến kiến trúc thiết bị. Giá trị có dạng "[platform=]mode", trong đó nền tảng (phải là "ios", "macos", "tvos" hoặc "watchos"). Nếu được cung cấp, chế độ mã bit sẽ được áp dụng riêng cho nền tảng đó; nếu bạn bỏ qua thì chính sách này sẽ áp dụng cho mọi nền tảng. Chế độ phải là "none", "embedded_markers" hoặc "được nhúng". Bạn có thể cung cấp lựa chọn này nhiều lần.
Thẻ:loses_incremental_state
- Giá trị mặc định của
--[no]build_python_zip
: "tự động" -
Tạo tệp zip có thể thực thi python; trên Windows, tắt trên các nền tảng khác
Thẻ:affects_outputs
--catalyst_cpus=<comma-separated list of options>
lần dùng được tích luỹ-
Danh sách các cấu trúc được phân tách bằng dấu phẩy để tạo tệp nhị phân Apple Catalyst.
Thẻ:loses_incremental_state
,loading_and_analysis
- Giá trị mặc định của
--[no]collect_code_coverage
: "false" -
Nếu được chỉ định, Bazel sẽ đo lường mã (sử dụng tính năng đo lường ngoại tuyến nếu có thể) và thu thập thông tin về mức độ sử dụng trong quá trình kiểm thử. Chỉ các mục tiêu khớp với --Instrumentation_filter mới bị ảnh hưởng. Thông thường, bạn không nên chỉ định trực tiếp tuỳ chọn này – "mức độ phủ sóng bazel" thay thế bằng lệnh.
Thẻ:affects_outputs
--compilation_mode=<fastbuild, dbg or opt>
[-c
] mặc định: "fastbuild"-
Chỉ định chế độ tạo tệp nhị phân. Giá trị: "fastbuild", "dbg", "opt".
Thẻ:affects_outputs
,action_command_lines
,explicit_in_output_path
--conlyopt=<a string>
lần dùng được tích luỹ-
Tuỳ chọn bổ sung để truyền đến gcc khi biên dịch tệp nguồn C.
Thẻ:action_command_lines
,affects_outputs
--copt=<a string>
lần dùng được tích luỹ-
Các tuỳ chọn khác để chuyển sang gcc.
Thẻ:action_command_lines
,affects_outputs
- Giá trị mặc định của
--cpu=<a string>
: "" -
CPU mục tiêu.
Thẻ:changes_inputs
,affects_outputs
,explicit_in_output_path
- Mặc định
--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
--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à(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
--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 được dùng cho mục đích tối ưu hoá.
Thẻ:affects_outputs
--cxxopt=<a string>
lần dùng được tích luỹ-
Tuỳ chọn bổ sung để truyền đến gcc khi biên dịch tệp nguồn C++.
Thẻ:action_command_lines
,affects_outputs
--define=<a 'name=value' assignment>
lần dùng được tích luỹ-
Mỗi tuỳ chọn --defined chỉ định một phép 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 động hay không. 'đầy đủ' nghĩa là tất cả thư viện sẽ được liên kết động. "off" 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
- Giá trị mặc định của
--[no]enable_fdo_profile_absolute_path
: "true" -
Nếu bạn đặt chính sách này, việc sử dụng fdo_ Apps_profile_path sẽ gây ra lỗi.
Thẻ:affects_outputs
- Giá trị mặc định của
--[no]enable_runfiles
: "tự động" -
Bật cây liên kết tượng trưng của các tệp runfile; Theo mặc định, tính năng này sẽ bị tắt trên Windows và trên các nền tảng khác.
Thẻ:affects_outputs
--experimental_action_listener=<a build target label>
lần dùng được tích luỹ-
Ngừng sử dụng và ưu tiên các khía cạnh. Sử dụng action_listener để đính kèm extra_action vào các thao tác hiện có đối với bản dựng.
Thẻ:execution
,experimental
- Giá trị mặc định của
--[no]experimental_android_compress_java_resources
: "false" -
Nén tài nguyên Java trong APK
Thẻ:affects_outputs
,loading_and_analysis
,experimental
- Giá trị mặc định của
--[no]experimental_android_databinding_v2
: "false" -
Dùng tính năng liên kết dữ liệu Android phiên bản 2
Thẻ:affects_outputs
,loading_and_analysis
,loses_incremental_state
,experimental
- Giá trị mặc định của
--[no]experimental_android_resource_shrinking
: "false" -
Bật tính năng rút gọn tài nguyên cho các APK android_binary sử dụng ProGuard.
Thẻ:affects_outputs
,loading_and_analysis
- Giá trị mặc định của
--[no]experimental_android_rewrite_dexes_with_rex
: "false" -
dùng công cụ rex để viết lại các tệp dex
Thẻ:affects_outputs
,loading_and_analysis
,loses_incremental_state
,experimental
- Giá trị 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 nhanh objc.
Thẻ:action_command_lines
- Giá trị mặc định của
--[no]experimental_omitfp
: "false" -
Nếu giá trị là true, hãy sử dụng libunwind để gỡ bỏ ngăn xếp và biên dịch bằng -fomit-frame-pointer và -faĐồng bộ-unwind-tables.
Thẻ:action_command_lines
,affects_outputs
,experimental
- Giá trị mặc định của
--[no]experimental_platform_in_output_dir
: "false" -
Nếu đúng, nền tảng mục tiêu sẽ được dùng trong tên thư mục đầu ra thay vì CPU.
Thẻ:affects_outputs
,experimental
- Giá trị mặc định của
--[no]experimental_use_llvm_covmap
: "false" -
Nếu được chỉ định, Bazel sẽ tạo thông tin bản đồ về phạm vi bao phủ llvm-cov thay vì gcov khi chế độ collection_code_Coverage được bật.
Thẻ:changes_inputs
,affects_outputs
,loading_and_analysis
,experimental
- Giá trị mặc định của
--fat_apk_cpu=<comma-separated list of options>
: "armeabi-v7a" -
Việc đặt tuỳ chọn này sẽ bật các tệp APK lớn, chứa tệp nhị phân gốc cho tất cả cấu trúc mục tiêu được chỉ định, chẳng hạn như --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
- Giá trị 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
--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à(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
--fdo_optimize=<a string>
: xem nội dung mô tả -
Sử dụng thông tin cấu hình 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 thêm một lệnh "exports_files" vào gói tương ứng) và các nhãn trỏ đến các 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
--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
--fdo_profile=<a build target label>
: xem nội dung mô tả -
fdo_profile đại diện cho hồ sơ được dùng cho hoạt động tối ưu hoá.
Thẻ:affects_outputs
--features=<a string>
lần dùng được tích luỹ-
Các tính năng nhất định sẽ được bật hoặc tắt theo mặc định cho các mục tiêu được tạo trong cấu hình mục tiêu. Chỉ định -<feature> sẽ tắt tính năng này. Các đối tượng phủ định luôn được ưu tiên hơn các đối tượng khẳng định. Xem thêm --host_features
Thẻ:changes_inputs
,affects_outputs
- Giá trị mặc định của
--[no]force_pic
: "false" -
Nếu được bật, tất cả phần biên dịch C++ sẽ tạo ra mã độc lập với vị trí ("-fPIC"), các đường liên kết sẽ ưu tiên thư viện PIC dựng sẵn hơn là thư viện không phải PIC và các đường liên kết tạo ra các tệp thực thi độc lập với vị trí ("-pie").
Thẻ:loading_and_analysis
,affects_outputs
--host_action_env=<a 'name=value' assignment with an optional value part>
lần dùng được tích luỹ-
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áy chủ lưu trữ hoặc thực thi. Biến có thể được chỉ định theo tên. Trong trường hợp đó, giá trị sẽ được lấy từ môi trường gọi hoặc bằng cặp name=value sẽ đặ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; cho các lựa chọn được cung cấp cho cùng một biến, các biến mới nhất sẽ chiến thắng, các tuỳ 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
--host_compilation_mode=<fastbuild, dbg or opt>
: "tối ưu hoá" -
Chỉ định chế độ tích hợp cho các công cụ dùng trong quá trình tạo bản dựng. Giá trị: "fastbuild", "dbg", "opt".
Thẻ:affects_outputs
,action_command_lines
--host_conlyopt=<a string>
lần dùng được tích luỹ-
Tuỳ chọn bổ sung để truyền đến gcc khi biên dịch tệp nguồn C cho công cụ lưu trữ.
Thẻ:action_command_lines
,affects_outputs
--host_copt=<a string>
lần dùng được tích luỹ-
Các tuỳ chọn khác để chuyển sang gcc cho công cụ lưu trữ.
Thẻ:action_command_lines
,affects_outputs
- Giá trị mặc định của
--host_cpu=<a string>
: "" -
CPU máy chủ.
Thẻ:changes_inputs
,affects_outputs
--host_cxxopt=<a string>
lần dùng được tích luỹ-
Các tuỳ chọn khác để chuyển sang gcc cho công cụ lưu trữ.
Thẻ:action_command_lines
,affects_outputs
--host_features=<a string>
lần dùng được tích luỹ-
Các tính năng nhất định sẽ được bật hoặc tắt theo mặc định đối với các mục tiêu được tạo trong cấu hình thực thi. Chỉ định -<feature> sẽ tắt tính năng này. Các đối tượng phủ định luôn được ưu tiên hơn các đối tượng khẳng định.
Thẻ:changes_inputs
,affects_outputs
- Mặc định
--host_force_python=<PY2 or PY3>
: xem nội dung mô tả -
Ghi đè phiên bản Python cho cấu hình máy chủ lưu trữ. Có thể là "PY2" hoặc "PY3".
Thẻ:loading_and_analysis
,affects_outputs
--host_linkopt=<a string>
lần dùng được tích luỹ-
Tuỳ chọn bổ sung để chuyển sang gcc khi liên kết các công cụ lưu trữ.
Thẻ:action_command_lines
,affects_outputs
- Mặc định
--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 đích lưu trữ. Nếu bạn chưa chỉ định, hãy sử dụng "macos_sdk_version".
Thẻ:loses_incremental_state
--host_per_file_copt=<a comma-separated list of regex expressions with prefix '-' specifying excluded paths followed by an @ and a comma separated list of options>
lần dùng được tích luỹ-
Các tuỳ chọn bổ sung để truyền có chọn lọc đến trình biên dịch C/C++ khi biên dịch một số tệp nhất định trong cấu hình máy chủ lưu trữ hoặc thực thi. Bạn có thể bỏ qua lựa chọn này nhiều lần. Cú pháp: regex_filter@option_1,option_2,...,option_n. Trong đó regex_filter là danh sách các mẫu biểu thức chính quy bao gồm và loại trừ (Xem thêm --Instrumentation_filter). 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 chứa dấu phẩy, thì tuỳ chọn đó phải nằm trong dấu gạch chéo ngược. Các tuỳ chọn có thể chứa @. Chỉ có ký tự @ đầu tiên dùng để phân tách chuỗi. Ví dụ: --host_per_file_copt=//foo/.*\.cc,-//foo/bar\.cc@-O0 sẽ thêm tuỳ chọn dòng lệnh -O0 vào dòng lệnh gcc của tất cả các tệp cc trong //foo/ ngoại trừ bar.cc.
Thẻ:action_command_lines
,affects_outputs
--host_swiftcopt=<a string>
lần dùng được tích luỹ-
Các tuỳ chọn bổ sung để chuyển đến swimaker cho các công cụ lưu trữ.
Thẻ:action_command_lines
,affects_outputs
- Giá trị mặc định của
--[no]incompatible_avoid_conflict_dlls
: "true" -
Nếu được bật, tất cả các thư viện được liên kết động (DLL) C++ do cc_library trên Windows tạo sẽ được đổi tên thành name_{hash}.dll trong đó hàm băm được tính toán dựa trên RepositoryName và đường dẫn gói của DLL. Tuỳ chọn này rất hữu ích khi bạn có một gói phụ thuộc vào một số cc_library có cùng tên (ví dụ: //foo/bar1:utils và //foo/bar2:utils).
Thẻ:loading_and_analysis
,affects_outputs
,incompatible_change
- Giá trị mặc định của
--[no]incompatible_merge_genfiles_directory
: "true" -
Nếu là true, thư mục genfiles sẽ được thu gọn vào thư mục bin.
Thẻ:affects_outputs
,incompatible_change
- Giá trị mặc định của
--[no]incompatible_use_host_features
: "false" -
Nếu đúng, chỉ sử dụng --features cho cấu hình mục tiêu và --host_features cho cấu hình thực thi.
Thẻ:changes_inputs
,affects_outputs
,incompatible_change
- Giá trị mặc định của
--[no]incompatible_use_platforms_repo_for_constraints
: "true" -
Nếu là true, các chế độ cài đặt quy tắc ràng buộc trong @bazel_tools sẽ bị xoá.
Thẻ:affects_outputs
,incompatible_change
- Giá trị mặc định của
--[no]instrument_test_targets
: "false" -
Khi mức độ sử dụng được bật, hãy chỉ định xem có cân nhắc việc đo lường các quy tắc kiểm thử hay không. Khi được đặt, các quy tắc kiểm thử do --Instrumentation_filter đưa vào 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 phạm vi.
Thẻ:affects_outputs
- Giá trị 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 nằm trong bộ lọc dựa trên biểu thức chính quy được chỉ định mới được đo lường. Các quy tắc có tiền tố là "-" bị loại trừ. Lưu ý rằng chỉ các quy tắc không kiểm thử mới được đo lường trừ khi bật --Instrument_test_targets.
Thẻ:affects_outputs
- Mặc định
--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 mục tiêu và thiết bị. Nếu bạn chưa chỉ định, hãy sử dụng "ios_sdk_version".
Thẻ:loses_incremental_state
--ios_multi_cpus=<comma-separated list of options>
lần dùng được tích luỹ-
Danh sách cấu 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
- Giá trị mặc định của
--[no]legacy_whole_archive
: "true" -
Không dùng nữa và được thay thế bằng --incompatible_remove_legacy_w tuyển_lưu trữ (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 tuyển-lưu trữ cho các quy tắc cc_binary có linkshared=True và linkstatic=True hoặc '-static' trong liên kết. Điều này chỉ dành cho khả năng tương thích ngược. Một cách khác tốt hơn là sử dụng chiến lược Alwayslink=1 nếu cần.
Thẻ:action_command_lines
,affects_outputs
,deprecated
--linkopt=<a string>
lần dùng được tích luỹ-
Tuỳ chọn bổ sung để chuyển sang gcc khi liên kết.
Thẻ:action_command_lines
,affects_outputs
--ltobackendopt=<a string>
lần dùng được tích luỹ-
Tuỳ chọn bổ sung để chuyển đến bước phụ trợ LTO (trong --features=thin_lto).
Thẻ:action_command_lines
,affects_outputs
--ltoindexopt=<a string>
lần dùng được tích luỹ-
Tuỳ chọn bổ sung để chuyển đến bước lập chỉ mục LTO (trong --features=thin_lto).
Thẻ:action_command_lines
,affects_outputs
--macos_cpus=<comma-separated list of options>
lần dùng được tích luỹ-
Danh sách được phân tách bằng dấu phẩy gồm các kiến trúc dùng để tạo tệp nhị phân macOS của Apple.
Thẻ:loses_incremental_state
,loading_and_analysis
- Mặc định
--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 các mục tiêu. Nếu bạn chưa chỉ định, hãy sử dụng "macos_sdk_version".
Thẻ:loses_incremental_state
- Giá trị mặc định của
--[no]objc_debug_with_GLIBCXX
: "false" -
Nếu được đặt và chế độ biên dịch được đặt thành 'dbg', hãy xác định GLIBCXX_DEBUG, GLIBCXX_DEBUG_PEDANTIC và GLIBCPP_CONVERSION_KIỂM TRA.
Thẻ:action_command_lines
- Giá trị mặc định của
--[no]objc_enable_binary_stripping
: "false" -
Liệu có thực hiện việc xoá biểu tượng và mã chết trên các tệp nhị phân được liên kết hay không. Việc loại bỏ tệp nhị phân sẽ được thực hiện nếu cả cờ này và --compilation_mode=opt được chỉ định.
Thẻ:action_command_lines
--objccopt=<a string>
lần dùng được tích luỹ-
Các tuỳ chọn bổ sung để truyền đến gcc khi biên dịch tệp nguồn Target-C/C++.
Thẻ:action_command_lines
--per_file_copt=<a comma-separated list of regex expressions with prefix '-' specifying excluded paths followed by an @ and a comma separated list of options>
lần dùng được tích luỹ-
Các tuỳ chọn bổ sung để truyền có chọn lọc đến gcc khi biên dịch một số tệp nhất định. Bạn có thể bỏ qua lựa chọn này nhiều lần. Cú pháp: regex_filter@option_1,option_2,...,option_n. Trong đó regex_filter là danh sách các mẫu biểu thức chính quy bao gồm và loại trừ (Xem thêm --Instrumentation_filter). 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 chứa dấu phẩy, thì tuỳ chọn đó phải nằm trong dấu gạch chéo ngược. Các tuỳ chọn có thể chứa @. Chỉ có ký tự @ đầu tiên dùng để phân tách chuỗi. Ví dụ: --per_file_copt=//foo/.*\.cc,-//foo/bar\.cc@-O0 sẽ 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
--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 dùng được tích luỹ-
Các tuỳ chọn bổ sung để chuyển có chọn lọc đến phần phụ trợ LTO (trong --features=thin_lto) khi biên dịch một số đối tượng phụ trợ nhất định. Bạn có thể bỏ qua lựa chọn này nhiều lần. Cú pháp: regex_filter@option_1,option_2,...,option_n. Trong đó regex_filter là danh sách các mẫu biểu thức chính quy bao gồm và loại trừ. 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 chứa dấu phẩy, thì tuỳ chọn đó phải nằm trong dấu gạch chéo ngược. Các tuỳ chọn có thể chứa @. Chỉ có ký tự @ đầu tiên dùng để phân tách chuỗi. Ví dụ: --per_file_ltobackendopt=//foo/.*\.o,-//foo/bar\.o@-O0 sẽ thêm tuỳ chọn dòng lệnh -O0 vào dòng lệnh phụ trợ LTO của tất cả các tệp o trong //foo/ ngoại trừ bar.o.
Thẻ:action_command_lines
,affects_outputs
- Mặc định
--platform_suffix=<a string>
: xem nội dung mô tả -
Chỉ định một hậu tố cần thêm vào thư mục cấu hình.
Thẻ:loses_incremental_state
,affects_outputs
,loading_and_analysis
- Mặc định
--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.Hồ sơ cánh quạt phải bao gồm ít nhất 1 trong 2 tệp là hồ sơ cc và hồ sơ ld. Cờ này chấp nhận một nhãn bản dựng tham chiếu đến các tệp đầu vào của hồ sơ chân vị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ể thêm lệnh export_files vào gói tương ứng để hiển thị những tệp này cho Bazel. Tuỳ chọn này phải được sử dụng dưới dạng: --propeller_optimize=//a/b:propeller_profile
Thẻ:action_command_lines
,affects_outputs
- Mặc định
--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 Propeller tối ưu hoá.
Thẻ:affects_outputs
- Mặc định
--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 Propeller.
Thẻ:affects_outputs
- Mặc định
--run_under=<a prefix in front of command>
: xem nội dung mô tả -
Tiền tố để chèn trước tệp thực thi cho "test" (kiểm thử) và 'chạy' các lệnh. 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 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
-
Nếu đúng, các thư viện gốc có chức năng giống nhau sẽ được chia sẻ giữa các đích khác nhau
Thẻ:loading_and_analysis
,affects_outputs
- Giá trị mặc định của
--[no]stamp
: "false" -
Đóng dấu các tệp nhị phân có 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ó bỏ tệp nhị phân và thư viện dùng chung hay không (sử dụng "-Wl,--strip-debug"). Giá trị mặc định của 'đôi khi' có nghĩa là xoá iff --compilation_mode=fastbuild.
Thẻ:affects_outputs
--stripopt=<a string>
lần dùng được tích luỹ-
Các tuỳ chọn bổ sung để chuyển sang dải khi tạo '<name>.stripped' nhị phân.
Thẻ:action_command_lines
,affects_outputs
--swiftcopt=<a string>
lần dùng được tích luỹ-
Các tuỳ chọn bổ sung để chuyển sang quá trình biên dịch Swift.
Thẻ:action_command_lines
--tvos_cpus=<comma-separated list of options>
lần dùng được tích luỹ-
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 tvOS.
Thẻ:loses_incremental_state
,loading_and_analysis
- Mặc định
--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 mục tiêu và thiết bị. Nếu bạn chưa chỉ định, hãy sử dụng "tvos_sdk_version".
Thẻ:loses_incremental_state
--watchos_cpus=<comma-separated list of options>
lần dùng được tích luỹ-
Danh sách các cấu trúc được phân tách bằng dấu phẩy để tạo tệp nhị phân Apple watchOS.
Thẻ:loses_incremental_state
,loading_and_analysis
- Mặc định
--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 các trình mô phỏng và thiết bị mục tiêu. Nếu bạn chưa chỉ định, hãy sử dụng "watchos_sdk_version".
Thẻ:loses_incremental_state
- Mặc định
--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, các tuỳ chọn đó sẽ luôn chiếm ưu thế như thể xbinary_fdo không bao giờ được chỉ định.
Thẻ:affects_outputs
- Các lựa chọn ảnh hưởng đến mức độ nghiêm ngặt của Bazel trong việc thực thi dữ liệu đầu vào bản dựng hợp lệ (định nghĩa quy tắc, tổ hợp cờ, v.v.):
- Giá trị mặc định của
--auto_cpu_environment_group=<a build target label>
: "" -
Khai báo environment_group để tự động liên kết các giá trị cpu với các giá trị target_environment.
Thẻ:changes_inputs
,loading_and_analysis
,experimental
- Giá trị mặc định của
--[no]check_licenses
: "false" -
Kiểm tra để đảm bảo rằng những 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 mục tiêu đang được tạo. Theo mặc định, giấy phép không được chọn.
Thẻ:build_file_semantics
- Giá trị mặc định của
--[no]check_visibility
: "true" -
Nếu bạn tắt chính sách này, lỗi hiển thị trong các phần phụ thuộc mục tiêu sẽ bị giảm hạng xuống thành cảnh báo.
Thẻ:build_file_semantics
- Giá trị mặc định của
--[no]desugar_for_android
: "true" -
Liệu có đơn giản hoá mã byte Java 8 trước khi tạo tệp dex hay không.
Thẻ:affects_outputs
,loading_and_analysis
,loses_incremental_state
- Giá trị mặc định của
--[no]desugar_java8_libs
: "false" -
Liệu có đưa các thư viện Java 8 được hỗ trợ vào ứng dụng dành cho thiết bị cũ hay không.
Thẻ:affects_outputs
,loading_and_analysis
,loses_incremental_state
,experimental
- Giá trị mặc định của
--[no]enforce_constraints
: "true" -
Kiểm tra môi trường mà mỗi mục tiêu tương thích và báo cáo lỗi nếu có mục tiêu có các phần phụ thuộc không hỗ trợ cùng một môi trường
Thẻ:build_file_semantics
- Giá trị mặc định của
--[no]experimental_allow_android_library_deps_without_srcs
: "false" -
Gắn cờ để giúp chuyển đổi từ trạng thái cho phép không cho phép các quy tắc srcs-less android_library có phần phụ thuộc. Bạn cần dọn dẹp kho chứa để triển khai theo mặc định.
Thẻ:eagerness_to_exit
,loading_and_analysis
- Giá trị mặc định của
--[no]experimental_check_desugar_deps
: "true" -
Liệu có kiểm tra kỹ quá trình đơn giản hoá chính xác ở cấp độ nhị phân 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 aar_import đã hoàn tất hay chưa. Hành động thực thi này có thể làm hỏng bản dựng hoặc chỉ dẫn đến cảnh báo.
Thẻ:loading_and_analysis
- Mặc định của
--experimental_strict_java_deps=<off, warn, error, strict or default>
: "mặc định" -
Nếu giá trị là true (đúng), hãy kiểm tra để đảm bảo rằng một mục tiêu Java khai báo rõ ràng tất cả các mục tiêu được sử dụng trực tiếp dưới dạng phần phụ thuộc.
Thẻ:build_file_semantics
,eagerness_to_exit
- Giá trị mặc định của
--[no]incompatible_check_testonly_for_output_files
: "false" -
Nếu được bật, hãy kiểm tra chỉ kiểm thử cho các mục tiêu điều kiện tiên quyết là tệp đầu ra bằng cách tra cứu chỉ kiểm thử của quy tắc đang tạo. Điều này khớp với quy trình kiểm tra khả năng hiển thị.
Thẻ:build_file_semantics
,incompatible_change
- Giá trị mặc định của
--[no]incompatible_disable_native_android_rules
: "false" -
Nếu được bật, việc sử dụng trực tiếp quy tắc Android gốc sẽ bị tắt. Vui lòng sử dụng các quy tắc Starlark Android tại https://github.com/bazelbuild/rules_android
Thẻ:eagerness_to_exit
,incompatible_change
- Giá trị mặc định của
--[no]incompatible_disable_native_apple_binary_rule
: "false" -
Không hoạt động. Được giữ lại ở đây để có khả năng tương thích ngược.
Thẻ:eagerness_to_exit
,incompatible_change
- Giá trị mặc định của
--[no]incompatible_force_strict_header_check_from_starlark
: "true" -
Nếu được bật, hãy đặt kiểm tra tiêu đề nghiêm ngặt trong API Starlark
Thẻ:loading_and_analysis
,changes_inputs
,incompatible_change
- Giá trị mặc định của
--[no]incompatible_validate_top_level_header_inclusions
: "true" -
Nếu đúng, Bazel cũng sẽ xác thực việc bao gồm 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
- Giá trị 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 tệp vượt qua ranh giới gói sẽ được báo cáo là lỗi. Tính năng này không hoạt động khi bạn tắt check_fileset_Dependencies_recursively.
Thẻ:build_file_semantics
,eagerness_to_exit
- Giá trị mặc định của
--strict_proto_deps=<off, warn, error, strict or default>
: "lỗi" -
Trừ phi bị 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ả 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
- Giá trị mặc định của
--strict_public_imports=<off, warn, error, strict or default>
: "tắt" -
Trừ phi bị TẮT, các hoạt động kiểm tra để đảm bảo mục tiêu proto_library khai báo rõ ràng tất cả mục tiêu dùng trong lệnh "nhập công khai" dưới dạng được xuất.
Thẻ:build_file_semantics
,eagerness_to_exit
,incompatible_change
- Giá trị mặc định của
--[no]strict_system_includes
: "false" -
Nếu đúng thì tiêu đề được tìm thấy qua hệ thống bao gồm cả đường dẫn (-isystem) cũng bắt buộc phải được khai báo.
Thẻ:loading_and_analysis
,eagerness_to_exit
--target_environment=<a build target label>
lần dùng được tích luỹ-
Khai báo môi trường mục tiêu của bản dựng này. Phải là mục tham chiếu nhãn đến một "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 được sử dụng để ký tệp APK
Thẻ:action_command_lines
,affects_outputs
,loading_and_analysis
- Giá trị mặc định của
--[no]device_debug_entitlements
: "true" -
Nếu được đặt và chế độ biên dịch không phải là "opt", ứng dụng objc sẽ bao gồm các quyền gỡ lỗi khi ký.
Thẻ:changes_inputs
- Mặc định
--ios_signing_cert_name=<a string>
: xem nội dung mô tả -
Tên chứng chỉ sẽ dù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à tùy chọn nhận dạng chuỗi khóa của chứng chỉ hoặc (chuỗi con) trong tên chung của chứng chỉ, như theo trang người dùng của ký hiệu 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 các tệp BUILD, tệp .bzl hoặc tệp WORKSPACE.:
- Giá trị mặc định của
--[no]incompatible_disallow_legacy_py_provider
: "true" -
Không hoạt động, sẽ sớm bị xoá.
Thẻ:loading_and_analysis
,incompatible_change
- 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ử:
- Giá trị mặc định của
--[no]allow_analysis_failures
: "false" -
Nếu đúng, lỗi phân tích của một mục tiêu quy tắc sẽ dẫn đến việc mục tiêu truyền một bản sao của AnalysisFailureInfo có chứa nội dung mô tả lỗi, thay vì dẫn đến lỗi bản dựng.
Thẻ:loading_and_analysis
,experimental
- Giá trị mặc định của
--analysis_testing_deps_limit=<an integer>
: "2000" -
Đặt số lượng tối đa các phần phụ thuộc bắc cầu thông qua một thuộc tính quy tắc có chuyển đổi cấu hình for_analysis_testing. Việc vượt quá giới hạn này sẽ dẫn đến lỗi quy tắc.
Thẻ:loading_and_analysis
- Giá trị mặc định của
--[no]break_build_on_parallel_dex2oat_failure
: "false" -
Nếu lỗi hành động dex2oat thực sự không thành công sẽ khiến bản dựng bị lỗi thay vì thực thi dex2oat trong thời gian chạy kiểm thử.
Thẻ:loading_and_analysis
,experimental
- Giá trị mặc định của
--[no]experimental_android_use_parallel_dex2oat
: "false" -
Sử dụng song song dex2oat để có thể tăng tốc android_test.
Thẻ:loading_and_analysis
,host_machine_resource_optimizations
,experimental
- Giá trị mặc định của
--[no]ios_memleaks
: "false" -
Bật tính năng kiểm tra xem có rò rỉ bộ nhớ trong mục tiêu ios_test không.
Thẻ:action_command_lines
- Mặc định
--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ụ: "iPhone 6". Bạn có thể xem danh sách thiết bị bằng cách chạy "xcrun simctl list devicetypes" trên máy đó.
Thẻ:test_runner
- Mặc định
--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 thử nghiệm. Tham số này 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
--runs_per_test=<a positive integer or test_regex@runs. This flag may be passed more than once>
lần dùng được tích luỹ- Chỉ định số lần chạy mỗi lượt kiểm thử. Nếu bất kỳ lần thử nào trong số đó không thành công vì bất cứ lý do gì, toàn bộ thử nghiệm sẽ được coi là không thành công. Thông thường, giá trị được chỉ định chỉ là một số nguyên. Ví dụ: --runs_per_test=3 sẽ chạy tất cả kiểm thử 3 lần. Cú pháp thay thế: regex_filter@runs_per_test. Trong đó running_per_test là viết tắt của một giá trị số nguyên và regex_filter đại diện cho 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 kiểm thử trong //foo/, ngoại trừ các kiểm thử dưới foo/bar ba lần. Bạn có thể bỏ qua lựa chọn này nhiều lần. Đối số được truyền gần đây nhất phù hợp sẽ được ưu tiên. Nếu không có kết quả nào phù hợp, thì kiểm thử sẽ chỉ được chạy một lần.
--test_env=<a 'name=value' assignment with an optional value part>
lần dùng được tích luỹ-
Chỉ định các biến môi trường bổ sung sẽ được đưa vào môi trường chạy kiểm thử. Các biến có thể được chỉ định theo tên, trong trường hợp đó, giá trị của biến sẽ được đọc từ môi trường ứng dụng Bazel hoặc theo cặp name=value. Bạn có thể sử dụng tuỳ chọn này nhiều lần để chỉ định một số biến. Chỉ được dùng trong "thử nghiệm bazel" .
Thẻ:test_runner
- Giá trị 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ờ mặc định của kiểm thử 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, giá trị này sẽ ghi đè tất 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, chúng sẽ ghi đè thời gian chờ cho ngắn, trung bình, dài và vĩnh viễn (theo thứ tự đó). Ở cả hai dạng, giá trị -1 yêu cầu blaze sử dụng thời gian chờ mặc định cho danh mục đó.
- Mặc định
--tvos_simulator_device=<a string>
: xem nội dung mô tả -
Thiết bị để mô phỏng khi chạy ứng dụng tvOS trong trình mô phỏng, ví dụ: "Apple TV 1080p". Bạn có thể xem danh sách thiết bị bằng cách chạy "xcrun simctl list devicetypes" trên máy đó.
Thẻ:test_runner
- Mặc định
--tvos_simulator_version=<a dotted version (for example '2.3' or '3.3alpha2.4')>
: xem nội dung mô tả -
Phiên bản tvOS để chạy trên trình mô phỏng khi chạy hoặc thử nghiệm.
Thẻ:test_runner
- Mặc định
--watchos_simulator_device=<a string>
: xem nội dung mô tả -
Thiết bị để mô phỏng khi chạy ứng dụng watchOS trong trình mô phỏng, ví dụ: "Apple Watch – 38mm". Bạn có thể xem danh sách thiết bị bằng cách chạy "xcrun simctl list devicetypes" trên máy đó.
Thẻ:test_runner
- Mặc định
--watchos_simulator_version=<a dotted version (for example '2.3' or '3.3alpha2.4')>
: xem nội dung mô tả -
Phiên bản watchOS để chạy trên trình mô phỏng khi chạy hoặc kiểm thử.
Thẻ:test_runner
- Giá trị mặc định của
--[no]zip_undeclared_test_outputs
: "true" -
Nếu là true, các kết quả kiểm thử chưa được khai báo sẽ được lưu trữ trong một tệp zip.
Thẻ:test_runner
- Các lựa chọn liên quan đến đầu ra của truy vấn và ngữ nghĩa:
- 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à một trong {xml,proto,record}. "off" có nghĩa là không có phần phụ thuộc khung hình nào được giải quyết, "thận trọng" (mặc định) có nghĩa là tất cả phần phụ thuộc khía cạnh đã khai báo đều được thêm vào bất kể chúng có được cung cấp lớp quy tắc của phần phụ thuộc trực tiếp hay không, "chính xác" có nghĩa là chỉ những khía cạnh đó được thêm vào mà 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. Xin lưu ý rằng chế độ chính xác yêu cầu tải các gói khác để đánh giá một mục tiêu. Do đó, mục tiêu này sẽ chậm hơn so với các chế độ khác. Ngoài ra, xin lưu ý rằng ngay cả chế độ chính xác cũng không hoàn toàn chính xác: việc quyết định có tính toán một khía cạnh hay không được quyết định trong giai đoạn phân tích, giai đoạn này không chạy trong quá trình "truy vấn bazel".
Thẻ:build_file_semantics
- Giá trị mặc định của
--[no]graph:factored
: "true" -
Nếu đúng, thì biểu đồ sẽ được tạo ra "được tạo thành thừa số", tức là các nút tương đương về cấu trúc liên kết sẽ được hợp nhất với nhau và nhãn của chúng sẽ được nối với nhau. Tuỳ chọn này chỉ áp dụng cho --output=graph.
Thẻ:terminal_output
- Giá trị 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 dữ liệu đầu ra. 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=graph.
Thẻ:terminal_output
- Giá trị mặc định của
--[no]implicit_deps
: "true" -
Nếu được bật, các phần phụ thuộc ngầm ẩ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ằng 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ụ đã phân giải.
Thẻ:build_file_semantics
- Giá trị mặc định của
--[no]include_aspects
: "true" -
aquery, cquery: liệu có bao gồm các hành động được tạo theo khía cạnh trong kết quả hay không. query: no-op (luôn đi theo các khía cạnh).
Thẻ:terminal_output
- Giá trị mặc định của
--[no]incompatible_display_source_file_location
: "true" -
"True" theo mặc định sẽ hiển thị mục tiêu của tệp nguồn. Nếu đúng, hiển thị vị trí dòng 1 của tệp nguồn trong dữ liệu đầu ra vị trí. Cờ này chỉ dành cho mục đích di chuyển.
Thẻ:terminal_output
,incompatible_change
- Giá trị mặc định của
--[no]incompatible_package_group_includes_double_slash
: "true" -
Nếu được bật, khi xuất thuộc tính "packages" của package_group, phần tử "//" ở đầu sẽ không bị bỏ qua.
Thẻ:terminal_output
,incompatible_change
- Giá trị mặc định của
--[no]infer_universe_scope
: "false" -
Nếu bạn không đặt giá trị đặt và --universe_scope thì giá trị của --universe_scope sẽ được suy ra dưới dạng danh sách các mẫu mục tiêu riêng biệ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 vũ trụ (ví dụ:`allrdeps`) có thể không phải là giá trị bạn muốn. Vì vậy, bạn chỉ nên sử dụng tuỳ chọn này nếu biết mình đang làm gì. Hãy 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 ý: tuỳ chọn này chỉ áp dụng cho "query" (nghĩa là không áp dụng cho "cquery").
Thẻ:loading_and_analysis
- Giá trị mặc định của
--[no]line_terminator_null
: "false" -
Liệu mỗi định dạng có bị chấm dứt bằng \0 thay vì dòng mới hay không.
Thẻ:terminal_output
- Giá trị mặc định của
--[no]nodep_deps
: "true" -
Nếu được bật, phần phụ thuộc từ "nodep" sẽ được đưa vào biểu đồ phần phụ thuộc mà qua đó truy vấn hoạt động. Một ví dụ phổ biến về "nút" 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ả "nodep" trong ngôn ngữ bản dựng.
Thẻ:build_file_semantics
- Giá trị mặc định của
--output=<a string>
: "label" -
Định dạng mà kết quả cquery sẽ được in. Các giá trị được phép cho cquery là: label, label_ kind, textproto, chuyển đổi, proto, jsonproto. Nếu chọn 'chuyển đổi', bạn cũng phải chỉ định tuỳ chọn --transitions=(lite|full).
Thẻ:terminal_output
- Giá trị mặc định của
--[no]proto:default_values
: "true" -
Nếu đúng, các thuộc tính có giá trị không được chỉ định rõ ràng trong tệp BUILD sẽ được đưa vào; nếu không thì chúng sẽ bị bỏ qua. Tuỳ chọn này có thể áp dụng cho --output=proto
Thẻ:terminal_output
- Giá trị mặc định của
--[no]proto:definition_stack
: "false" -
Điền vào trường proto Definition_stack sẽ ghi lại từng thực thể quy tắc của ngăn xếp lệnh gọi Starlark tại thời điểm xác định lớp của quy tắc.
Thẻ:terminal_output
- Giá trị mặc định của
--[no]proto:flatten_selects
: "true" -
Nếu bạn bật tuỳ chọn này, các thuộc tính có thể định cấu hình do Select() tạo sẽ được làm phẳng. Đối với các loại danh sách, bản trình bày đã làm phẳng là danh sách chứa chính xác mỗi giá trị của tệp ánh xạ được chọn 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
- Giá trị mặc định của
--[no]proto:include_configurations
: "true" -
nếu được bật, đầu ra proto sẽ bao gồm thông tin về cá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
- Giá trị mặc định của
--[no]proto:include_synthetic_attribute_hash
: "false" -
Liệu có tính toán và điền thuộc tính $internal_attr_hash hay không.
Thẻ:terminal_output
- Giá trị mặc định của
--[no]proto:instantiation_stack
: "false" -
Điền ngăn xếp lệnh gọi tạo thực thể của từng quy tắc. Lưu ý rằng thao tác này đòi hỏi phải có ngăn xếp
Thẻ:terminal_output
- Giá trị mặc định của
--[no]proto:locations
: "true" -
Liệu có xuất thông tin vị trí trong đầu ra proto hay không.
Thẻ:terminal_output
- Mặc định của
--proto:output_rule_attrs=<comma-separated list of options>
: "tất cả" -
Danh sách thuộc tính được phân tách bằng dấu phẩy để đưa vào dữ liệu đầu ra. Giá trị mặc định là tất cả thuộc tính. Bạn phải đặt thành chuỗi trống để không xuất thuộc tính nào. Tuỳ chọn này có thể áp dụng cho --output=proto.
Thẻ:terminal_output
- Giá trị mặc định của
--[no]proto:rule_inputs_and_outputs
: "true" -
Liệu có điền sẵn các trường rules_input và rules_output hay không.
Thẻ:terminal_output
- Giá trị mặc định của
--[no]relative_locations
: "false" -
Nếu đúng, vị trí của các tệp BUILD trong đầu ra xml và proto sẽ là tương đối. Theo mặc định, kết quả vị trí là một đường dẫn tuyệt đối và sẽ không nhất quán giữa các máy. Bạn có thể đặt tuỳ chọn này thành true để nhận được kết quả nhất quán trên các máy.
Thẻ:terminal_output
- Giá trị mặc định của
--show_config_fragments=<off, direct or transitive>
: "tắt" -
Cho biết các mảnh cấu hình theo yêu cầu của một quy tắc 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ó thể cắt bớt một biểu đồ mục tiêu đã định cấu hình.
Thẻ:affects_outputs
- Giá trị mặc định của
--starlark:expr=<a string>
: "" -
Biểu thức Starlark để định dạng từng mục tiêu được đị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 "target". Nếu bạn không chỉ định --starlark:expr hay --starlark:file, thì tuỳ chọn này sẽ được đặt thành 'str(target.label)' theo mặc định. Lỗi khi chỉ định cả --starlark:expr và --starlark:file.
Thẻ:terminal_output
- Giá trị mặc định của
--starlark:file=<a string>
: "" -
Tên của một tệp định nghĩa hàm Starlark có tên là "format" (định dạng) của một đối số, được áp dụng cho mỗi mục tiêu được định cấu hình để định dạng mục tiêu đó dưới dạng chuỗi. Lỗi khi chỉ định cả --starlark:expr và --starlark:file. Xem phần trợ giúp về --output=starlark để biết thêm thông tin chi tiết.
Thẻ:terminal_output
- Giá trị mặc định của
--[no]tool_deps
: "true" -
Truy vấn: Nếu bị tắt, các phần phụ thuộc trên "cấu hình máy chủ" hoặc "thực thi" sẽ không được đưa vào biểu đồ phụ thuộc mà qua đó truy vấn hoạt động. "Cấu hình máy chủ lưu trữ" cạnh phụ thuộc, chẳng hạn như cạnh phụ thuộc từ bất kỳ "proto_library" nào cho 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 'mục tiêu' .
Cquery: Nếu bị tắt, hãy lọc tất cả các mục tiêu đã định cấu hình vượt qua quá trình chuyển đổi lưu trữ hoặc thực thi khỏi 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ũng 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 máy chủ lưu trữ, thì chỉ các mục tiêu đã định cấu hình của máy chủ lưu trữ mới được trả về. Tuỳ chọn này sẽ KHÔNG loại trừ chuỗi công cụ đã phân giải.
Thẻ:build_file_semantics
- Giá trị 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
- Giá trị 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 đóng bắc cầu của các mục tiêu được chỉ định. Tuỳ chọn này được dùng cho các lệnh truy vấn và cquery.
Đối với cquery, đầu vào cho tuỳ chọn này là mục tiêu mà tất cả các câu trả lời đều được xây dựng, do đó, tuỳ chọn này có thể ảnh hưởng đến cấu hình và hiệu ứng chuyển đổi. Nếu bạn không chỉ định tùy chọn này, thì các mục tiêu cấp cao nhất được coi 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ị lỗi nếu không thể tạo các mục tiêu được phân tích cú pháp từ biểu thức truy vấn bằng các tuỳ chọn cấp cao nhất.
Thẻ:loading_and_analysis
- Các tuỳ chọn kích hoạt tính năng tối ưu hoá thời gian xây dựng:
- Giá trị mặc định của
--[no]collapse_duplicate_defines
: "false" -
Khi được bật, các giá trị-xác định thừa sẽ bị xoá sớm trong bản dựng. Điều này giúp tránh làm mất bộ nhớ đệm phân tích một cách không cần thiết đối với một số loại bản dựng tương đương.
Thẻ:loading_and_analysis
,loses_incremental_state
- Giá trị mặc định của
--[no]experimental_filter_library_jar_with_program_jar
: "false" -
Lọc ProGuard ProgramJar để xoá mọi lớp cũng có trong LibraryJar.
Thẻ:action_command_lines
- Giá trị mặc định của
--[no]experimental_inmemory_dotd_files
: "true" -
Nếu được bật, các tệp C++ .d sẽ được truyền trực tiếp vào bộ nhớ từ các nút bản dựng từ xa thay vì được ghi vào ổ đĩa.
Thẻ:loading_and_analysis
,execution
,affects_outputs
,experimental
- Giá trị mặc định của
--[no]experimental_inmemory_jdeps_files
: "true" -
Nếu bạn bật chính sách này, các tệp phụ thuộc (.jdeps) được tạo qua quá trình biên dịch Java sẽ được truyền trực tiếp vào bộ nhớ qua các nút bản dựng từ xa thay vì được ghi vào ổ đĩa.
Thẻ:loading_and_analysis
,execution
,affects_outputs
,experimental
- Giá trị mặc định của
--[no]experimental_objc_include_scanning
: "false" -
Liệu có thực hiện việc quét tìm C/C++ mục tiêu hay không.
Thẻ:loading_and_analysis
,execution
,changes_inputs
- Giá trị mặc định của
--[no]experimental_parse_headers_skipped_if_corresponding_srcs_found
: "false" -
Nếu được bật, tính năng parse_headers sẽ không tạo hành động biên dịch tiêu đề riêng biệt nếu tìm thấy một nguồn có cùng tên cơ sở ở cùng một đích.
Thẻ:loading_and_analysis
,affects_outputs
- Giá trị mặc định của
--[no]experimental_retain_test_configuration_across_testonly
: "false" -
Khi được bật, --trim_test_configuration sẽ không cắt cấu hình kiểm thử cho các quy tắc được đánh dấu testonly=1. Điều này nhằm giảm các vấn đề xung đột hành động khi quy tắc không phải kiểm thử phụ thuộc vào quy tắc cc_test. Không có hiệu lực nếu --trim_test_configuration là false.
Thẻ:loading_and_analysis
,loses_incremental_state
- Giá trị mặc định của
--[no]experimental_starlark_cc_import
: "false" -
Nếu bật tuỳ chọn này, bạn có thể sử dụng phiên bản Starlark của cc_import.
Thẻ:loading_and_analysis
,experimental
- Giá trị mặc định của
--[no]experimental_unsupported_and_brittle_include_scanning
: "false" -
Liệu có thu hẹp dữ liệu đầu vào trong quá trình biên dịch C/C++ bằng cách phân tích cú pháp các dòng #include từ tệp đầu vào hay không. Điều này có thể cải thiện hiệu suất và mức độ gia tăng bằng cách giảm kích thước của cây đầu vào biên dịch. Tuy nhiên, việc này cũng có thể phá vỡ các bản dựng vì trình quét bao gồm không triển khai đầy đủ ngữ nghĩa của bộ tiền xử lý C. Cụ thể, phương thức này không hiểu các lệnh #include động 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. Chúng tôi sẽ đóng mọi vấn đề liên quan đến cờ này.
Thẻ:loading_and_analysis
,execution
,changes_inputs
- Giá trị mặc định của
--[no]incremental_dexing
: "true" -
Thực hiện hầu hết thao tác để tạo tệp dex riêng biệt cho từng tệp Jar.
Thẻ:affects_outputs
,loading_and_analysis
,loses_incremental_state
- Giá trị mặc định của
--[no]objc_use_dotd_pruning
: "true" -
Nếu được đặt, các tệp .d do clang phát ra sẽ được dùng để cắt giảm tập hợp các dữ liệu đầu vào được truyền vào mục biên dịch objc.
Thẻ:changes_inputs
,loading_and_analysis
- Giá trị mặc định của
--[no]process_headers_in_dependencies
: "false" -
Khi tạo //a:a mục tiêu, hãy xử lý tiêu đề trong tất cả các mục tiêu mà //a:a phụ thuộc (nếu bạn bật tính năng xử lý tiêu đề cho chuỗi công cụ).
Thẻ:execution
- Giá trị mặc định của
--[no]trim_test_configuration
: "true" -
Khi được bật, các tuỳ chọn liên quan đến thử nghiệm 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 các chương trình kiểm thử dưới dạng phần phụ thuộc của quy tắc không kiểm thử, nhưng việc thay đổi các tuỳ chọn liên quan đến hoạt động kiểm thử sẽ không làm cho các quy tắc không kiểm thử bị phân tích lại.
Thẻ:loading_and_analysis
,loses_incremental_state
- Giá trị mặc định của
--[no]use_singlejar_apkbuilder
: "true" -
Tuỳ chọn này không được dùng nữa. Trang này hiện không hoạt động và sẽ sớm bị xoá.
Thẻ:loading_and_analysis
- Các lựa chọn ảnh hưởng đến độ chi tiết, định dạng hoặc vị trí ghi nhật ký:
- Giá trị 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. Biểu thức này được kiểm tra theo 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 đó sẽ đánh dấu riêng từng biểu thức chính quy. Lưu ý: Kết quả của cờ này rất phức tạp và có thể sẽ chỉ hữu ích cho các chuyên gia trong việc phân giải chuỗi công cụ.
Thẻ:terminal_output
- Các tuỳ chọn chỉ định hoặc thay đổi dữ liệu đầu vào chung cho lệnh Bazel không thuộc các danh mục khác.:
--flag_alias=<a 'name=value' flag alias>
lần dùng được tích luỹ-
Đặt tên viết tắt cho cờ Starlark. Hàm này cần một cặp khoá-giá trị có dạng "<key>=<value>" làm đối số.
Thẻ:changes_inputs
- Giá trị mặc định của
--[no]incompatible_default_to_explicit_init_py
: "false" -
Cờ này thay đổi hành vi mặc định để các tệp __init__.py không còn được tạo tự động trong các tệp chạy của mục tiêu Python nữa. Chính xác là khi một mục tiêu py_binary hoặc py_test có legacy_create_init được đặt thành "auto" (mặc định), thì hàm này được coi là sai khi và chỉ khi cờ này được đặt. Hãy truy cập vào https://github.com/bazelbuild/bazel/issues/10076.
Thẻ:affects_outputs
,incompatible_change
- Giá trị mặc định của
--[no]incompatible_py2_outputs_are_suffixed
: "true" -
Nếu đúng, các mục tiêu được tạo trong cấu hình Python 2 sẽ xuất hiện dưới một gốc đầu ra bao gồm 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 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 tiện lợi "bazel-bin" sẽ trỏ đến các mục tiêu Python 3 thay vì Python 2. Nếu bật tuỳ chọn này, bạn cũng nên bật "--incompatible_py3_is_default".
Thẻ:affects_outputs
,incompatible_change
- Giá trị mặc định của
--[no]incompatible_py3_is_default
: "true" -
Nếu đúng, các mục tiêu "py_binary" và "py_test" không đặt thuộc tính "python_version" (hoặc "default_python_version") sẽ được đặt mặc định thành PY3 thay vì PY2. Nếu đặt cờ này, bạn cũng nên đặt "--incompatible_py2_outputs_are_suffixed".
Thẻ:loading_and_analysis
,affects_outputs
,incompatible_change
- Giá trị mặc định của
--[no]incompatible_use_python_toolchains
: "true" -
Nếu bạn đặt thành true, các quy tắc Python gốc có thể thực thi sẽ sử dụng 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ũ cung cấp như --python_top.
Thẻ:loading_and_analysis
,incompatible_change
- Mặc định
--python_version=<PY2 or PY3>
: xem nội dung mô tả -
Chế độ phiên bản lớn Python, có thể là "PY2" hoặc "PY3". Lưu ý rằng các mục tiêu 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) do đó, thường không có nhiều lý do để cung cấp cờ này.
Thẻ:loading_and_analysis
,affects_outputs
,explicit_in_output_path
- Các lựa chọn khác, không được phân loại theo cách khác.:
--[no]cache_test_results
[-t
] mặc định: "tự động"- Nếu được đặt thành "auto", Bazel sẽ chạy lại một kiểm thử khi: (1) Bazel phát hiện các thay đổi trong kiểm thử hoặc các phần phụ thuộc của nó, (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 "yes", thì Bazel sẽ lưu mọi kết quả kiểm thử vào bộ nhớ đệm, ngoại trừ những lượt kiểm thử được đánh dấu là bên ngoài. Nếu bạn đặt thành "no", Bazel sẽ không lưu kết quả kiểm thử vào bộ nhớ đệm.
- Giá trị mặc định của
--[no]experimental_cancel_concurrent_tests
: "false" -
Nếu đúng, thì Blaze sẽ huỷ đồng thời các kiểm thử đang chạy trong lần chạy thành công đầu tiên. Điều này chỉ hữu ích khi kết hợp với --runs_per_test_detects_flakes.
Thẻ:affects_outputs
,loading_and_analysis
- Giá trị mặc định của
--[no]experimental_fetch_all_coverage_outputs
: "false" -
Nếu đúng, 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
- Giá trị mặc định của
--[no]experimental_generate_llvm_lcov
: "false" -
Nếu đúng, mức độ phù hợp cho clang sẽ tạo báo cáo LCOV.
Thẻ:affects_outputs
,loading_and_analysis
- Giá trị mặc định của
--[no]experimental_j2objc_header_map
: "true" - Liệu có tạo bản đồ tiêu đề J2ObjC song song với quá trình chuyển đổi J2ObjC hay không.
- Giá trị mặc định của
--[no]experimental_j2objc_shorter_header_path
: "false" -
Liệu có tạo bằng đường dẫn tiêu đề ngắn hơn hay không (sử dụng "_ios" thay vì "_j2objc").
Thẻ:affects_outputs
- Giá trị mặc định của
--experimental_java_classpath=<off, javabuilder or bazel>
: "javabuilder" - Bật đường dẫn lớp giảm bớt cho quá trình biên dịch Java.
- Giá trị mặc định của
--[no]experimental_limit_android_lint_to_android_constrained_java
: "false" -
Giới hạn --experimental_run_android_lint_on_java_rules ở các thư viện tương thích với Android.
Thẻ:affects_outputs
- Giá trị mặc định của
--[no]experimental_run_android_lint_on_java_rules
: "false" -
Liệu có xác thực nguồn java_* hay không.
Thẻ:affects_outputs
- Giá trị mặc định của
--[no]explicit_java_test_deps
: "false" - Chỉ định rõ ràng phần phụ thuộc cho JUnit hoặc Hamcrest trong java_test thay vì vô tình lấy được từ phần phụ thuộc của TestRunner. Hiện chỉ áp dụng cho bazel.
- Mặc định
--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.
--host_javacopt=<a string>
lần dùng được tích luỹ- Các tuỳ chọn bổ sung để truyền sang javac khi tạo các công cụ được thực thi trong quá trình dựng.
--host_jvmopt=<a string>
lần dùng được tích luỹ- Các tuỳ chọn bổ sung để truyền sang máy ảo Java khi xây dựng các công cụ được thực thi trong quá trình dựng. Các tuỳ chọn này sẽ được thêm vào tuỳ chọn khởi động máy ảo của từng mục tiêu java_binary.
- Giá trị mặc định của
--[no]incompatible_exclusive_test_sandboxed
: "false" -
Nếu đúng, các thử nghiệm độc quyền sẽ chạy với chiến lược hộp cát. Thêm "local" để buộc chạy kiểm thử độc quyền trên máy
Thẻ:incompatible_change
- Giá trị mặc định của
--[no]incompatible_strict_action_env
: "false" -
Nếu đúng, Bazel sử dụng một môi trường có giá trị tĩnh cho PATH và không kế thừa LD_ từng_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ừ máy khách, 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
--j2objc_translation_flags=<comma-separated list of options>
lần dùng được tích luỹ- Các tuỳ chọn bổ sung để chuyển sang công cụ J2ObjC.
--java_debug
-
Khiến máy ảo Java của một chương trình kiểm thử java đợ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
- Giá trị mặc định của
--[no]java_deps
: "true" - Tạo thông tin về phần phụ thuộc (hiện tại là đường dẫn lớp thời gian biên dịch) theo mục tiêu Java.
- Giá trị mặc định của
--[no]java_header_compilation
: "true" - Biên dịch ijar trực tiếp từ nguồn.
- Giá trị mặc định của
--java_language_version=<a string>
: "8" - Phiên bản ngôn ngữ Java
- Mặc định
--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 bạn đặt cờ này thành chuỗi trống, thì trình chạy JDK sẽ được sử dụng. "Trình chạy" sẽ ghi đè cờ này.
- Giá trị mặc định của
--java_runtime_version=<a string>
: "local_jdk" - Phiên bản thời gian chạy Java
--javacopt=<a string>
lần dùng được tích luỹ- Các tuỳ chọn bổ sung để chuyển sang javac.
--jvmopt=<a string>
lần dùng được tích luỹ- Các tuỳ chọn bổ sung để chuyển sang máy ảo Java. Các tuỳ chọn này sẽ được thêm vào tuỳ chọn khởi động máy ảo của từng mục tiêu java_binary.
- Mặc định
--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ũ.
--plugin=<a build target label>
lần dùng được tích luỹ- Trình bổ trợ để sử dụng trong bản dựng. Hiện hoạt động với java_plugin.
- Mặc định
--proguard_top=<a build target label>
: xem nội dung mô tả - Chỉ định phiên bản ProGuard dùng để xoá mã khi tạo 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 các proto 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 proto j2objc
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 các proto Java
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 các proto JavaLite
Thẻ:affects_outputs
,loading_and_analysis
--protocopt=<a string>
lần dùng được tích luỹ-
Các tuỳ chọn khác để truyền đến trình biên dịch protobuf.
Thẻ:affects_outputs
- Giá trị mặc định của
--[no]runs_per_test_detects_flakes
: "false" - Nếu đúng, bất kỳ phân đoạn nào trong đó có ít nhất một lần chạy/lần chạy và ít nhất một lần chạy/thử không thành công sẽ có trạng thái FLAKY.
- Mặc định
--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 đó. Nếu bạn không đặt chính sách nào, Bazel sẽ sử dụng đường dẫn mặc định được cố định giá trị trong mã, tuỳ thuộc vào hệ điều hành mà ứng dụng chạy (Windows: c:/tools/msys64/usr/bin/bash.exe, FreeBSD: /usr/local/bin/bash, tất cả các hệ điều hành khác: /bin/bash). Lưu ý rằng việc sử dụng một shell không tương thích với tính năng bash có thể dẫn đến lỗi bản dựng hoặc lỗi thời gian chạy của tệp nhị phân đã tạo.
Thẻ:loading_and_analysis
--test_arg=<a string>
lần dùng được tích luỹ- Chỉ định các tuỳ chọn và đối số bổ sung cần được truyền đến tệp thực thi kiểm thử. Có thể sử dụng nhiều lần để chỉ định một số đối số. Nếu thực thi nhiều kiểm thử, mỗi lượt kiểm thử sẽ nhận được các đối số giống hệt nhau. Chỉ được dùng trong "thử nghiệm bazel" .
- Mặc định
--test_filter=<a string>
: xem nội dung mô tả - Chỉ định một bộ lọc để chuyển tiếp đến khung thử nghiệm. Dùng để giới hạn hoạt động kiểm thử. Xin lưu ý rằng điều này không ảnh hưởng đến việc tạo mục tiêu nào.
- Giá trị mặc định của
--test_result_expiration=<an integer>
: "-1" - Lựa chọn này không còn được dùng nữa và không có hiệu lực.
- Giá trị mặc định của
--[no]test_runner_fail_fast
: "false" - Lựa 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ử cần ngừng thực thi khi gặp lỗi đầu tiên.
- Giá trị mặc định của
--test_sharding_strategy=<explicit or disabled>
: "explicit" - Chỉ định chiến lược để phân đoạn kiểm thử: "explicit" để chỉ sử dụng phân đoạn nếu thuộc tính 'shard_count' Có thuộc tính BUILD. "đã tắt" không bao giờ sử dụng tính năng phân đoạn kiểm thử.
- Giá trị mặc định của
--tool_java_language_version=<a string>
: "8" - Phiên bản ngôn ngữ Java dùng để thực thi các công cụ cần thiết trong quá trình tạo bản dựng
- Giá trị 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 tạo bản dựng
- Giá trị mặc định của
--[no]use_ijars
: "true" - Nếu được bật, tuỳ chọn này sẽ khiến quá trình biên dịch Java sử dụng các tệp giao diện người dùng. Điều này sẽ giúp quá trình biên dịch gia tăng nhanh hơn nhưng các thông báo lỗi có thể khác nhau.
Các lựa chọn cho tệp 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:
--distdir=<a path>
lần dùng được tích luỹ-
Các nơi khác để tìm kiếm các bản lưu trữ trước khi truy cập vào mạng để tải các bản lưu trữ đó xuống.
Thẻ:bazel_internal_configuration
- Giá trị mặc định của
--[no]experimental_repository_cache_hardlinks
: "false" -
Nếu được thiết lập, bộ nhớ đệm của kho lưu trữ sẽ liên kết cứng tệp trong trường hợp có lượt truy cập bộ nhớ đệm, thay vì sao chép. Thao tác này nhằm tiết kiệm dung lượng ổ đĩa.
Thẻ:bazel_internal_configuration
- Giá trị mặc định của
--[no]experimental_repository_cache_urls_as_default_canonical_id
: "false" -
Nếu đúng, hãy sử dụng một chuỗi bắt nguồn từ URL của các tệp tải xuống từ kho lưu trữ dưới dạngcanonical_id nếu không được chỉ định. Điều này khiến URL thay đổi, dẫn đến việc tải xuống lại ngay cả khi bộ nhớ đệm chứa tệp tải xuống có cùng hàm băm. Bạn có thể sử dụng quy trình này để xác minh rằng các thay đổi về URL không làm hỏng các kho lưu trữ bị bộ nhớ đệm che khuất.
Thẻ:loading_and_analysis
,experimental
- Giá trị mặc định của
--[no]experimental_repository_disable_download
: "false" -
Nếu đã đặt, bạn sẽ không được phép tải các kho lưu trữ bên ngoài xuống.
Thẻ:experimental
- Giá trị mặc định của
--experimental_repository_downloader_retries=<an integer>
: "0" -
Số lần thử tải lại lỗi xuống tối đa. Nếu bạn đặt chính sách này thành 0, hoạt động thử lại sẽ bị tắt.
Thẻ:experimental
- Giá trị mặc định của
--experimental_scale_timeouts=<a double>
: "1" -
Điều chỉnh tỷ lệ tất cả thời gian chờ trong quy tắc kho lưu trữ Starlark theo hệ số này. Bằng cách này, các kho lưu trữ bên ngoài có thể hoạt động trên các máy chậm hơn dự kiến của tác giả quy tắc mà không cần thay đổi mã nguồn
Thẻ:bazel_internal_configuration
,experimental
- Giá trị mặc định của
--http_timeout_scaling=<a double>
: "1" -
Điều chỉnh tỷ lệ tất cả thời gian chờ liên quan đến lượt tải xuống http theo hệ số cho trước
Thẻ:bazel_internal_configuration
- Mặc định
--repository_cache=<a path>
: xem nội dung mô tả -
Chỉ định vị trí bộ nhớ đệm của các giá trị được tải xuống thu được trong quá trình tìm nạp kho lưu trữ bên ngoài. Chuỗi trống dưới dạng đối số yêu cầu tắt bộ nhớ đệm.
Thẻ:bazel_internal_configuration
- Các tuỳ chọn kiểm soát kết quả của lệnh:
- Giá trị mặc định của
--[no]action_cache
: "false" -
Nội dung trong bộ nhớ đệm của thao tác kết xuất.
Thẻ:bazel_monitoring
- Giá trị 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
- Giá trị mặc định của
--[no]rule_classes
: "false" -
Các lớp quy tắc kết xuất.
Thẻ:bazel_monitoring
- Giá trị mặc định của
--[no]rules
: "false" -
Các quy tắc kết xuất, bao gồm cả số lượng và mức sử dụng bộ nhớ (nếu được theo dõi).
Thẻ:bazel_monitoring
- Giá trị mặc định của
--skyframe=<off, summary, count, deps or rdeps>
: "tắt" -
Biểu đồ kết xuất khung hình trời: "off", "tóm tắt", "count", "deps" hoặc "rdeps".
Thẻ:bazel_monitoring
- Giá trị 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 các tên SkyKey xuất ra. Chỉ dùng với --skyframe=deps, rdeps.
Thẻ:bazel_monitoring
- Mặc định
--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 được chỉ định. Để tìm hiểu thêm, vui lòng truy cập https://github.com/google/pprof.
Thẻ:bazel_monitoring
- Các lựa chọn ảnh hưởng đến mức độ nghiêm ngặt của Bazel trong việc thực thi dữ liệu đầu vào bản dựng hợp lệ (định nghĩa quy tắc, tổ hợp cờ, v.v.):
- Giá trị mặc định của
--experimental_repository_hash_file=<a string>
: "" -
Nếu giá trị không trống, hãy chỉ định tệp có chứa giá trị đã phân giải mà cần phải xác minh giá trị băm của thư mục kho lưu trữ
Thẻ:affects_outputs
,experimental
--experimental_verify_repository_rules=<a string>
lần dùng được tích luỹ-
Nếu danh sách các quy tắc kho lưu trữ mà hàm băm của thư mục đầu ra cần được xác minh, miễn là tệp được chỉ định bởi --experimental_repository_hash_file.
Thẻ:affects_outputs
,experimental
- Tuỳ chọn này ảnh hưởng đến ngữ nghĩa của ngôn ngữ Starlark hoặc API bản dựng có thể truy cập vào các tệp BUILD, tệp .bzl hoặc tệp WORKSPACE.:
- Giá trị mặc định của
--[no]experimental_allow_top_level_aspects_parameters
: "true" -
Không hoạt động
Thẻ:no_op
,deprecated
,experimental
- Các tuỳ chọn liên quan đến đầu ra và ngữ nghĩa Bzlmod:
--allow_yanked_versions=<a string>
lần dùng được tích luỹ-
Đã chỉ định các phiên bản mô-đun dưới dạng `<module1>@<version1>,<module2>@<version2>` sẽ được phép trong biểu đồ phần phụ thuộc đã phân giải ngay cả khi chúng được khai báo được kéo trong sổ đăng ký nơi chúng đến (nếu chúng không đến từ NonRegistryOverride). Nếu không, các phiên bản được kéo sẽ khiến quá trình phân giải bị lỗi. Bạn cũng có thể xác định phiên bản được kéo được phép bằng biến môi trường "BZLMOD_ALLOW_YANKED_VERSIONS". Bạn có thể vô hiệu hoá chế độ kiểm tra này bằng cách sử dụng từ khoá 'tất cả' (không nên dùng).
Thẻ:loading_and_analysis
- Giá trị 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" để báo cáo lỗi thành không giải quyết được, "tắt" để tắt tính năng kiểm tra hoặc "cảnh báo" để in một cảnh báo khi phát hiện thấy thông tin không khớp.
Thẻ:loading_and_analysis
- Giá trị 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 "bazel_dep" trực tiếp đượ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 đã phân giải hay không. Các giá trị hợp lệ là "off" để tắt tính năng kiểm tra, "warning" để in cảnh báo khi phát hiện thấy thông tin không khớp hoặc "error" để chuyển cảnh báo thành không giải quyết được.
Thẻ:loading_and_analysis
- Giá trị mặc định của
--[no]ignore_dev_dependency
: "false" -
Nếu đúng, Bazel sẽ bỏ qua phương thức "bazel_dep" và "use_extension" được khai báo là "dev_Dependencies" trong MODULE.bazel của mô-đun gốc. Lưu ý rằng các phần phụ thuộc dev đó 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
--override_module=<an equals-separated mapping of module name to path>
lần dùng được tích luỹ- Ghi đè mô-đun bằng thư mục cục bộ.
--registry=<a string>
lần dùng được tích luỹ-
Chỉ định sổ đăng ký cần sử dụng để xác định vị trí các phần phụ thuộc của mô-đun Bazel. Thứ tự này rất quan trọng: các mô-đun sẽ được tra cứu trong các sổ đăng ký trước đó trước và chỉ quay lại các sổ đăng ký sau đó nếu không có các mô-đun trước đó.
Thẻ:changes_inputs
- Các lựa chọn ảnh hưởng đến độ chi tiết, định dạng hoặc vị trí ghi nhật ký:
- Giá trị mặc định của
--[no]experimental_record_metrics_for_all_mnemonics
: "false" - Theo mặc định, số lượng loại hành động được giới hạn ở 20 bộ nhớ có số lượng hành động được thực thi lớn nhất. Việc đặt tuỳ chọn này sẽ ghi số liệu thống kê cho tất cả các bộ nhớ.
- Các tuỳ chọn chỉ định hoặc thay đổi dữ liệu đầu vào chung cho lệnh Bazel không thuộc các danh mục khác.:
- Giá trị mặc định của
--experimental_resolved_file_instead_of_workspace=<a string>
: "" -
Nếu không để trống, hãy đọc tệp đã giải quyết được chỉ định thay vì tệp WORKSPACE
Thẻ:changes_inputs
- Tuỳ chọn thực thi và lưu vào bộ nhớ đệm từ xa:
- Mặc định
--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ủ lưu trữ (cho `allow` và `block`) hoặc hai mẫu, một mẫu để so khớp và một mẫu để sử dụng làm URL thay thế, với các tham chiếu ngược bắt đầu từ `$1`. Bạn có thể cung cấp nhiều lệnh "ghi lại" cho cùng một URL và trong trường hợp này, hệ thống sẽ trả về nhiều URL.
- Các lựa chọn khác, không được phân loại theo cách khác.:
--override_repository=<an equals-separated mapping of repository name to path>
lần dùng được tích luỹ- Ghi đè kho lưu trữ bằng thư mục cục bộ.
Các lựa 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:
--distdir=<a path>
lần dùng được tích luỹ-
Các nơi khác để tìm kiếm các bản lưu trữ trước khi truy cập vào mạng để tải các bản lưu trữ đó xuống.
Thẻ:bazel_internal_configuration
- Giá trị mặc định của
--[no]experimental_repository_cache_hardlinks
: "false" -
Nếu được thiết lập, bộ nhớ đệm của kho lưu trữ sẽ liên kết cứng tệp trong trường hợp có lượt truy cập bộ nhớ đệm, thay vì sao chép. Thao tác này nhằm tiết kiệm dung lượng ổ đĩa.
Thẻ:bazel_internal_configuration
- Giá trị mặc định của
--[no]experimental_repository_cache_urls_as_default_canonical_id
: "false" -
Nếu đúng, hãy sử dụng một chuỗi bắt nguồn từ URL của các tệp tải xuống từ kho lưu trữ dưới dạngcanonical_id nếu không được chỉ định. Điều này khiến URL thay đổi, dẫn đến việc tải xuống lại ngay cả khi bộ nhớ đệm chứa tệp tải xuống có cùng hàm băm. Bạn có thể sử dụng quy trình này để xác minh rằng các thay đổi về URL không làm hỏng các kho lưu trữ bị bộ nhớ đệm che khuất.
Thẻ:loading_and_analysis
,experimental
- Giá trị mặc định của
--[no]experimental_repository_disable_download
: "false" -
Nếu đã đặt, bạn sẽ không được phép tải các kho lưu trữ bên ngoài xuống.
Thẻ:experimental
- Giá trị mặc định của
--experimental_repository_downloader_retries=<an integer>
: "0" -
Số lần thử tải lại lỗi xuống tối đa. Nếu bạn đặt chính sách này thành 0, hoạt động thử lại sẽ bị tắt.
Thẻ:experimental
- Giá trị mặc định của
--experimental_scale_timeouts=<a double>
: "1" -
Điều chỉnh tỷ lệ tất cả thời gian chờ trong quy tắc kho lưu trữ Starlark theo hệ số này. Bằng cách này, các kho lưu trữ bên ngoài có thể hoạt động trên các máy chậm hơn dự kiến của tác giả quy tắc mà không cần thay đổi mã nguồn
Thẻ:bazel_internal_configuration
,experimental
- Giá trị mặc định của
--http_timeout_scaling=<a double>
: "1" -
Điều chỉnh tỷ lệ tất cả thời gian chờ liên quan đến lượt tải xuống http theo hệ số cho trước
Thẻ:bazel_internal_configuration
- Mặc định
--repository_cache=<a path>
: xem nội dung mô tả -
Chỉ định vị trí bộ nhớ đệm của các giá trị được tải xuống thu được trong quá trình tìm nạp kho lưu trữ bên ngoài. Chuỗi trống dưới dạng đối số yêu cầu tắt bộ nhớ đệm.
Thẻ:bazel_internal_configuration
- Các tuỳ chọn kiểm soát việc thực thi bản dựng:
- Giá trị mặc định của
--[no]incompatible_remote_dangling_symlinks
: "true" -
Nếu bạn đặt chính sách này thành true và đặt giá trị --incompatible_remote_symlinks cũng là true, các đường liên kết tượng trưng trong dữ liệu đầu ra của hành động sẽ được phép treo.
Thẻ:execution
,incompatible_change
- Giá trị mặc định của
--[no]incompatible_remote_symlinks
: "true" -
Nếu bạn đặt chính sách này thành true, thì Bazel sẽ biểu thị các đường liên kết tượng trưng trong dữ liệu đầu ra của hành động trong giao thức lưu vào bộ nhớ đệm/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à được thể hiện dưới dạng tệp hoặc thư mục. Xem #6631 để biết chi tiết.
Thẻ:execution
,incompatible_change
--[no]keep_going
[-k
] mặc định: "false"-
Hãy tiếp tục nhiều nhất có thể sau khi gặp lỗi. Mặc dù không thể phân tích mục tiêu không thành công và những mục tiêu phụ thuộc vào nó, nhưng có thể có các điều kiện tiên quyết khác cho những mục tiêu này.
Thẻ:eagerness_to_exit
- Giá trị mặc định của
--loading_phase_threads=<an integer, or a keyword ("auto", "HOST_CPUS", "HOST_RAM"), optionally followed by an operation ([-|*]<float>) eg. "auto", "HOST_CPUS*.5">
: "tự động" -
Số lượng luồng song song để sử 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 bởi một thao tác ([-|*]<float>), ví dụ: "tự động", "HOST_CPUS*.5". "tự động" đặt giá trị mặc định hợp lý dựa trên tài nguyên máy chủ lưu trữ. Phải ít nhất là 1.
Thẻ:bazel_internal_configuration
- Các tuỳ chọn cho phép người dùng định cấu hình đầu ra dự kiến, ảnh hưởng đến giá trị của đầu ra đó, trái ngược với sự tồn tại của đầu ra đó:
- Giá trị mặc định của
--bep_maximum_open_remote_upload_files=<an integer>
: "-1" -
Số lượng tệp tối đa đang mở được cho phép trong quá trình tải cấu phần phần mềm BEP lên.
Thẻ:affects_outputs
--remote_download_minimal
-
Không tải bất kỳ kết quả của bản dựng từ xa nào xuống máy cục bộ. Cờ này là lối tắt cho các cờ: --experimental_inmemory_jdeps_files, --experimental_inmemory_dotd_files, --experimental_action_cache_store_output_metadata và --remote_download_outputs=minimal.
Mở rộng thành:
--nobuild_runfile_links
--experimental_inmemory_jdeps_files
--experimental_inmemory_dotd_files
--experimental_action_cache_store_output_metadata
--remote_download_outputs=minimal
Thẻ:affects_outputs
- Mặc định của
--remote_download_outputs=<all, minimal or toplevel>
: "tất cả" -
Nếu được đặt thành "tối thiểu" 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 các hành động cục bộ yêu cầu. Nếu được đặt thành "cấp cao nhất" hành xử như "tối thiểu" ngoại trừ việc nó cũng tải kết quả của các mục tiêu cấp cao nhất xuống máy cục bộ. Cả hai tuỳ chọn đều có thể làm giảm đáng kể thời gian xây dựng nếu băng thông mạng gây tắc nghẽn.
Thẻ:affects_outputs
- Giá trị mặc định của
--remote_download_symlink_template=<a string>
: "" -
Thay vì tải dữ liệu đầu ra 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 đích của các đường liên kết tượng trưng dưới dạng chuỗi mẫu. Chuỗi mẫu này có thể chứa {hash} và {size_bytes} lần lượt mở rộng thành hàm băm của đối tượng và kích thước tính bằng byte. Ví dụ: những đườ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 đầ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à lối tắt cho các cờ: --experimental_inmemory_jdeps_files, --experimental_inmemory_dotd_files, --experimental_action_cache_store_output_metadata và --remote_download_outputs=toplevel.
Mở rộng thành:
--experimental_inmemory_jdeps_files
--experimental_inmemory_dotd_files
--experimental_action_cache_store_output_metadata
--remote_download_outputs=toplevel
Thẻ:affects_outputs
- Các lựa chọn ảnh hưởng đến mức độ nghiêm ngặt của Bazel trong việc thực thi dữ liệu đầu vào bản dựng hợp lệ (định nghĩa quy tắc, tổ hợp cờ, v.v.):
- Giá trị mặc định của
--experimental_repository_hash_file=<a string>
: "" -
Nếu giá trị không trống, hãy chỉ định tệp có chứa giá trị đã phân giải mà cần phải xác minh giá trị băm của thư mục kho lưu trữ
Thẻ:affects_outputs
,experimental
--experimental_verify_repository_rules=<a string>
lần dùng được tích luỹ-
Nếu danh sách các quy tắc kho lưu trữ mà hàm băm của thư mục đầu ra cần được xác minh, miễn là tệp được chỉ định bởi --experimental_repository_hash_file.
Thẻ:affects_outputs
,experimental
- Tuỳ chọn này ảnh hưởng đến ngữ nghĩa của ngôn ngữ Starlark hoặc API bản dựng có thể truy cập vào các tệp BUILD, tệp .bzl hoặc tệp WORKSPACE.:
- Giá trị mặc định của
--[no]experimental_allow_top_level_aspects_parameters
: "true" -
Không hoạt động
Thẻ:no_op
,deprecated
,experimental
- Giá trị mặc định của
--[no]incompatible_config_setting_private_default_visibility
: "false" -
Nếu không tương thích_enforce_config_setting_ visibility=false, thì đây là lỗi không hiển thị. Ngược lại, nếu cờ này là false, mọi chế độ cài đặt config_setting không có thuộc tính mức độ hiển thị rõ ràng sẽ là //visibility:public. Nếu cờ này là true, chế độ cài đặt config_setting sẽ tuân theo cùng một logic về chế độ hiển thị như mọi quy tắc khác. Truy cập https://github.com/bazelbuild/bazel/issues/12933.
Thẻ:loading_and_analysis
,incompatible_change
- Giá trị mặc định của
--[no]incompatible_enforce_config_setting_visibility
: "true" -
Nếu là true, hãy thực thi các quy định hạn chế về chế độ hiển thị bằng lệnh config_setting. Nếu đặt là false, mọi chế độ cài đặt config_ đều hiển thị với mọi mục tiêu. Truy cập 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:
--allow_yanked_versions=<a string>
lần dùng được tích luỹ-
Đã chỉ định các phiên bản mô-đun dưới dạng `<module1>@<version1>,<module2>@<version2>` sẽ được phép trong biểu đồ phần phụ thuộc đã phân giải ngay cả khi chúng được khai báo được kéo trong sổ đăng ký nơi chúng đến (nếu chúng không đến từ NonRegistryOverride). Nếu không, các phiên bản được kéo sẽ khiến quá trình phân giải bị lỗi. Bạn cũng có thể xác định phiên bản được kéo được phép bằng biến môi trường "BZLMOD_ALLOW_YANKED_VERSIONS". Bạn có thể vô hiệu hoá chế độ kiểm tra này bằng cách sử dụng từ khoá 'tất cả' (không nên dùng).
Thẻ:loading_and_analysis
- Giá trị 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" để báo cáo lỗi thành không giải quyết được, "tắt" để tắt tính năng kiểm tra hoặc "cảnh báo" để in một cảnh báo khi phát hiện thấy thông tin không khớp.
Thẻ:loading_and_analysis
- Giá trị 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 "bazel_dep" trực tiếp đượ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 đã phân giải hay không. Các giá trị hợp lệ là "off" để tắt tính năng kiểm tra, "warning" để in cảnh báo khi phát hiện thấy thông tin không khớp hoặc "error" để chuyển cảnh báo thành không giải quyết được.
Thẻ:loading_and_analysis
- Giá trị mặc định của
--[no]ignore_dev_dependency
: "false" -
Nếu đúng, Bazel sẽ bỏ qua phương thức "bazel_dep" và "use_extension" được khai báo là "dev_Dependencies" trong MODULE.bazel của mô-đun gốc. Lưu ý rằng các phần phụ thuộc dev đó 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
--override_module=<an equals-separated mapping of module name to path>
lần dùng được tích luỹ- Ghi đè mô-đun bằng thư mục cục bộ.
--registry=<a string>
lần dùng được tích luỹ-
Chỉ định sổ đăng ký cần sử dụng để xác định vị trí các phần phụ thuộc của mô-đun Bazel. Thứ tự này rất quan trọng: các mô-đun sẽ được tra cứu trong các sổ đăng ký trước đó trước và chỉ quay lại các sổ đăng ký sau đó nếu không có các mô-đun trước đó.
Thẻ:changes_inputs
- Các lựa chọn ảnh hưởng đến độ chi tiết, định dạng hoặc vị trí ghi nhật ký:
- Giá trị mặc định của
--[no]experimental_record_metrics_for_all_mnemonics
: "false" - Theo mặc định, số lượng loại hành động được giới hạn ở 20 bộ nhớ có số lượng hành động được thực thi lớn nhất. Việc đặt tuỳ chọn này sẽ ghi số liệu thống kê cho tất cả các bộ nhớ.
- Giá trị mặc định của
--experimental_repository_resolved_file=<a string>
: "" -
Nếu giá trị không trống, hãy viết một giá trị Starlark cùng với thông tin đã phân giải của tất cả các quy tắc kho lưu trữ Starlark đã được thực thi.
Thẻ:affects_outputs
- Giá trị mặc định của
--remote_print_execution_messages=<failure, success or all>
: "không thành công" -
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", chỉ in khi không thành công, "thành công" chỉ in khi thành công và "all" sẽ luôn in.
Thẻ:terminal_output
- Các tuỳ chọn chỉ định hoặc thay đổi dữ liệu đầu vào chung cho lệnh Bazel không thuộc các danh mục khác.:
- Giá trị mặc định của
--experimental_resolved_file_instead_of_workspace=<a string>
: "" -
Nếu không để trống, hãy đọc tệp đã giải quyết được chỉ định thay vì tệp WORKSPACE
Thẻ:changes_inputs
- Tuỳ chọn thực thi và lưu vào bộ nhớ đệm từ xa:
- Mặc định
--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ủ lưu trữ (cho `allow` và `block`) hoặc hai mẫu, một mẫu để so khớp và một mẫu để sử dụng làm URL thay thế, với các tham chiếu ngược bắt đầu từ `$1`. Bạn có thể cung cấp nhiều lệnh "ghi lại" cho cùng một URL và trong trường hợp này, hệ thống sẽ trả về nhiều URL.
- Giá trị mặc định của
--[no]experimental_guard_against_concurrent_changes
: "false" - Tắt tuỳ chọn này để tắt tính năng kiểm tra thời gian đối với tệp nhập của một hành động trước khi tải lên bộ nhớ đệm từ xa. Trong một số trường hợp, nhân hệ điều hành Linux có thể trì hoãn việc ghi tệp, từ đó dẫn đến dương tính giả.
- Mặc định của
--experimental_remote_build_event_upload=<all or minimal>
: "tất cả" - Nếu bạn đặt chính sách này thành "all", thì mọi dữ liệu đầu ra cục bộ được tham chiếu bởi BEP sẽ được tải lên bộ nhớ đệm từ xa. Nếu bạn đặt chính sách này thành "tối thiểu", thì các dữ liệu đầu ra cục bộ được tham chiếu bởi BEP 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 sử dụng BEP (ví dụ: nhật ký kiểm thử và hồ sơ thời gian). Lược đồ bytestream:// luôn được dùng cho URI của các tệp ngay cả khi chúng bị thiếu trong bộ nhớ đệm từ xa. Giá trị mặc định là "tất cả".
- Giá trị mặc định của
--[no]experimental_remote_cache_async
: "false" - Nếu đúng, I/O bộ nhớ đệm từ xa sẽ diễn ra trong nền thay vì diễn ra như một phần của quá trình sinh sản.
- Giá trị mặc định của
--[no]experimental_remote_cache_compression
: "false" - Nếu được bật, hãy nén/giải nén các blob bộ nhớ đệm bằng zstd.
- Mặc định
--experimental_remote_capture_corrupted_outputs=<a path>
: xem nội dung mô tả - Đường dẫn đến thư mục nơi các dữ liệu đầu ra bị lỗi sẽ được ghi vào.
- Giá trị 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, thì hệ thống sẽ loại bỏ các bản sao trong bộ nhớ của cây Merkle của gốc đầu vào và các bản đồ ánh xạ đầu vào được liên kết trong các lệnh gọi đến GetActionResult() và Execute(). Điều này làm giảm đáng kể mức sử dụng bộ nhớ, nhưng Bazel phải tính toán lại các dữ liệu này khi bộ nhớ đệm từ xa bị thiếu và thử lại.
- Mặc định
--experimental_remote_downloader=<a string>
: xem nội dung mô tả - URI điểm cuối của Remote Asset API, được 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ắm UNIX cục bộ). Nếu không cung cấp giản đồ, Bazel sẽ đặt mặc định thành grpcs. Hãy tham khảo: https://github.com/bazelbuild/remote-apis/blob/master/build/bazel/remote/asset/v1/remote_asset.proto
- Giá trị mặc định của
--[no]experimental_remote_downloader_local_fallback
: "false" - Liệu có quay lại trình tải xuống cục bộ nếu trình tải xuống từ xa không thành công hay không.
- Giá trị mặc định của
--[no]experimental_remote_execution_keepalive
: "false" - Liệu có sử dụng tính năng giữ nguyên hoạt động cho các lệnh gọi thực thi từ xa hay không.
- Mặc định
--experimental_remote_grpc_log=<a path>
: xem nội dung mô tả - Nếu được chỉ định, một đườ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 các protobuf com.google.devtools.build.lib.remote.logging.RemoteExecutionLog.LogEntry được chuyển đổi tuần tự với mỗi thông điệp có tiền tố là một varint biểu thị kích thước của thông điệp protobuf được tuần tự hoá sau đây, được thực hiện bằng phương thức LogEntry.writeDelimitedTo(OutputStream).
- Giá trị 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, thì Bazel sẽ đánh dấu các dữ liệu đầu vào là đầu vào công cụ cho bộ thực thi từ xa. Bạn có thể dùng tính năng này để triển khai trình thực thi cố định từ xa.
- Giá trị 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 (đúng), các phép tính của cây Merkle sẽ được ghi nhớ để cải thiện tốc độ kiểm tra lượt truy cập trong 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_merkle_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 Merkle cần ghi nhớ để cải thiện tốc độ kiểm tra lượt truy cập vào bộ nhớ đệm từ xa. Mặc dù bộ nhớ đệm sẽ tự động bị cắt bớt theo cách xử lý tham chiếu mềm của Java, nhưng lỗi hết bộ nhớ vẫn có thể xảy ra nếu bộ nhớ được đặt quá cao. Nếu bạn đặt chính sách này thành 0, thì kích thước bộ nhớ đệm sẽ không bị 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.
- Giá trị mặc định của
--[no]incompatible_remote_build_event_upload_respect_no_cache
: "false" - Nếu bạn đặt chính sách này thành true, thì các dữ liệu đầu ra được BEP tham chiếu sẽ không được tải lên bộ nhớ đệm từ xa nếu thao tác tạo không thể lưu vào bộ nhớ đệm từ xa.
- Giá trị mặc định của
--[no]incompatible_remote_downloader_send_all_headers
: "true" -
Liệu có gửi tất cả các giá trị của một tiêu đề có nhiều giá trị tới trình tải xuống từ xa thay vì chỉ gửi giá trị đầu tiên hay không.
Thẻ:incompatible_change
- Giá trị mặc định của
--[no]incompatible_remote_output_paths_relative_to_input_root
: "false" -
Nếu bạn đặt chính sách này thành true, thì các đường dẫn đầu ra sẽ tương ứng với thư mục gốc đầu vào thay vì thư mục đang hoạt động.
Thẻ:incompatible_change
- Giá trị mặc định của
--[no]incompatible_remote_results_ignore_disk
: "true" -
Nếu bạn đặt chính sách này thành true, thì --noremote_upload_local_results và --noremote_accept_cached sẽ không áp dụng cho bộ nhớ đệm của ổ đĩa. Nếu sử dụng bộ nhớ đệm kết hợp:
--noremote_upload_local_results sẽ làm cho kết quả được ghi vào bộ nhớ đệm của ổ đĩa nhưng không được tải lên bộ nhớ đệm từ xa.
--noremote_accept_cached sẽ dẫn đến việc Bazel kiểm tra các kết quả trong bộ nhớ đệm của ổ đĩa, chứ không phải trong bộ nhớ đệm từ xa.
no-remote-exec có thể ảnh hưởng đến bộ nhớ đệm của ổ đĩa.
Xem #8216 để biết chi tiết.
Thẻ:incompatible_change
- Giá trị mặc định của
--[no]incompatible_remote_use_new_exit_code_for_lost_inputs
: "false" -
Nếu được đặt thành true, Bazel sẽ sử dụng mã thoát mới 39 thay vì 34 nếu bộ nhớ đệm từ xa loại bỏ các blob trong quá trình tạo.
Thẻ:incompatible_change
- Giá trị mặc định của
--[no]remote_accept_cached
: "true" - Liệu có chấp nhận kết quả hành động được lưu vào bộ nhớ đệm từ xa hay không.
- Mặc định
--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 luồng sự kiện tạo bản dựng. Bạn có thể đặt tuỳ chọn này khi tạo các bản dựng bằng proxy. Việc 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ị mặc định sẽ là "${hostname}/${instance_name}".
- Mặc định
--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ắm UNIX cục bộ). Nếu không cung cấp giản đồ, Bazel sẽ đặt mặc định thành grpcs. Hãy chỉ định lược đồ grpc://, http:// hoặc unix: để vô hiệu hoá TLS. Hãy truy cập vào https://bazel.build/remote/caching
--remote_cache_header=<a 'name=value' assignment>
lần dùng được tích luỹ- Chỉ định tiêu đề sẽ có trong các yêu cầu bộ nhớ đệm: --remote_cache_header=Name=Value. Có thể truyền nhiều tiêu đề bằng cách chỉ định cờ nhiều lần. Nhiều giá trị cho cùng một tên sẽ được chuyển đổi thành danh sách được phân tách bằng dấu phẩy.
--remote_default_exec_properties=<a 'name=value' assignment>
lần dùng được tích luỹ-
Đặt các 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
- Giá trị mặc định của
--remote_default_platform_properties=<a string>
: "" - Đặt các thuộc tính nền tảng mặc định thành thiết lập cho API thực thi từ xa, nếu nền tảng thực thi chưa đặt Remote_execution_properties. Giá trị này cũng sẽ được dùng nếu nền tảng lưu trữ được chọn làm nền tảng thực thi để thực thi từ xa.
--remote_downloader_header=<a 'name=value' assignment>
lần dùng được tích luỹ- Chỉ định tiêu đề sẽ được đưa vào trong các yêu cầu của trình tải xuống từ xa: --remote_downloader_header=Name=Value. Có thể truyền nhiều tiêu đề bằng cách chỉ định cờ nhiều lần. Nhiều giá trị cho cùng một tên sẽ được chuyển đổi thành danh sách được phân tách bằng dấu phẩy.
--remote_exec_header=<a 'name=value' assignment>
lần dùng được tích luỹ- Chỉ định tiêu đề sẽ được đưa vào trong các yêu cầu thực thi: --remote_exec_header=Name=Value. Có thể truyền nhiều tiêu đề bằng cách chỉ định cờ nhiều lần. Nhiều giá trị cho cùng một tên sẽ được chuyển đổi thành danh sách được phân tách bằng dấu phẩy.
- Giá trị mặc định của
--remote_execution_priority=<an integer>
: "0" - Mức độ ưu tiên tương đối của các thao tác cần được thực thi từ xa. Ngữ nghĩa của các giá trị ưu tiên cụ thể phụ thuộc vào máy chủ.
- Mặc định
--remote_executor=<a string>
: xem nội dung mô tả - HOST hoặc HOST:PORT của một điểm cuối thực thi từ xa. Các giản đồ được hỗ trợ là grpc, grpcs (grpc có bật TLS) và unix (ổ cắm UNIX cục bộ). Nếu không cung cấp giản đồ, Bazel sẽ đặt mặc định thành grpcs. Chỉ định grpc:// hoặc unix: giản đồ để vô hiệu hoá TLS.
--remote_header=<a 'name=value' assignment>
lần dùng được tích luỹ- Chỉ định tiêu đề sẽ được đưa vào trong yêu cầu: --remote_header=Name=Value. Có thể truyền nhiều tiêu đề bằng cách chỉ định cờ nhiều lần. Nhiều giá trị cho cùng một tên sẽ được chuyển đổi thành danh sách được phân tách bằng dấu phẩy.
- Giá trị mặc định của
--remote_instance_name=<a string>
: "" - Giá trị cần truyền dưới dạnginstance_name trong API thực thi từ xa.
- Giá trị mặc định của
--[no]remote_local_fallback
: "false" - Liệu có quay lại sử dụng chiến lược thực thi cục bộ độc lập trong trường hợp thực thi từ xa không thành công hay không.
- Giá trị mặc định của
--remote_local_fallback_strategy=<a string>
: "cục bộ" - Không hoạt động, không dùng nữa. Hãy truy cập vào https://github.com/bazelbuild/bazel/issues/7480 để biết thông tin chi tiết.
- Mặc định của
--remote_max_connections=<an integer>
: "100" -
Giới hạn số lượng kết nối đồng thời tối đa đối với bộ nhớ đệm/trình thực thi từ xa. Theo mặc định, giá trị là 100. Việc đặt giá trị này thành 0 có nghĩa là không bị giới hạn.
Đối với bộ nhớ đệm từ xa HTTP, một kết nối TCP có thể xử lý từng 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, vì vậy, Bazel có thể thực hiện xung quanh các yêu cầu đồng thời "--remote_max_connections * 100".
Thẻ:host_machine_resource_optimizations
- Mặc định
--remote_proxy=<a string>
: xem nội dung mô tả - Kết nối với bộ nhớ đệm từ xa thông qua proxy. Hiện tại, bạn chỉ có thể sử dụng cờ này để định cấu hình cổng miền Unix (unix:/path/to/socket).
- Giá trị 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 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ủ.
- Giá trị 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, hoạt động thử lại sẽ bị tắt.
- Giá trị 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à các lệnh gọi vào bộ nhớ đệm. Đối với bộ nhớ đệm REST, đây là cả thời gian chờ kết nối và thời gian chờ đọc. Bạn có thể sử dụng các đơn vị sau: Ngày (d), giờ (h), phút (m), giây (s) và mili giây (mili giây). Nếu bạn bỏ qua đơn vị, thì giá trị được hiểu là giây.
- Giá trị mặc định của
--[no]remote_upload_local_results
: "true" - Liệu có tải các kết quả hành động được thực thi cục bộ lên bộ nhớ đệm từ xa hay không nếu bộ nhớ đệm từ xa hỗ trợ và người dùng được phép thực hiện việc đó.
- Giá trị mặc định của
--[no]remote_verify_downloads
: "true" - Nếu bạn đặt chính sách này thành true, thì Bazel sẽ tính toán tổng băm của tất cả các tệp tải xuống từ xa và loại bỏ các giá trị được lưu vào bộ nhớ đệm từ xa nếu các giá trị đó không khớp với giá trị dự kiến.
- Các lựa chọn khác, không được phân loại theo cách khác.:
- Giá trị mặc định của
--deleted_packages=<comma-separated list of package names>
: "" - 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ẽ cho là không tồn tại, ngay cả khi chúng hiển thị ở đâu đó 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 'x' hiện có. Ví dụ: sau khi xoá x/y/BUILD trong ứng dụng khách của bạn, hệ thống xây dựng có thể sẽ khiếu nại nếu gặp nhãn '//x:y/z' nếu giá trị đó vẫn được cung cấp bởi một mục package_path khác. Việc chỉ định --Delete_packages x/y sẽ giúp tránh được sự cố này.
- Mặc định
--disk_cache=<a path>
: xem nội dung mô tả - Một đường dẫn đến một thư mục mà Bazel có thể đọc và ghi các thao tác cũng như kết quả đầu ra của hành động. Nếu không có, thư mục sẽ được tạo.
--experimental_credential_helper=<An (unresolved) path to a credential helper for a scope.>
lần dùng được tích luỹ- Định cấu hình Trình trợ giúp thông tin xác thực dùng cho việc truy xuất thông tin xác thực cho phạm vi đã cung cấp (miền). Thông tin xác thực của Trình trợ giúp thông tin xác thực được ưu tiên hơn thông tin xác thực trên <code>--google_default_credentials</code>, "--google_credentials" hoặc <code>.netrc</code>. Hãy truy cập vào https://github.com/bazelbuild/suggesteds/blob/main/designs/2022-06-07-bazel-credential-helpers.md để biết chi tiết.
- Giá trị mặc định của
--experimental_credential_helper_cache_duration=<An immutable length of time.>
: "30 phút" - Định cấu hình khoảng thời gian lưu thông tin xác thực từ Trình trợ giúp thông tin xác thực. 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 đó; truyền 0 để xoá bộ nhớ đệm. Lệnh sạch luôn xoá bộ nhớ đệm, bất kể cờ này là gì.
- Mặc định của
--experimental_credential_helper_timeout=<An immutable length of time.>
: "5 giây" - Định cấu hình thời gian chờ cho Trình trợ giúp thông tin xác thực. 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 sẽ không thực hiện được lệnh gọi.
- Mặc định của
--google_auth_scopes=<comma-separated list of options>
: "https://www.googleapis.com/auth/cloud-platform" - Danh sách phạm vi xác thực được phân tách bằng dấu phẩy trên Google Cloud.
- Mặc định
--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/authentication để biết thông tin chi tiết.
- Giá trị mặc định của
--[no]google_default_credentials
: "false" - Có sử dụng 'Thông tin xác thực mặc định của ứng dụng trên Google' không để xác thực. Hãy truy cập vào https://cloud.google.com/docs/authentication để biết thông tin chi tiết. Tắt theo mặc định.
- Mặc định
--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, thì Bazel sẽ gửi ping sau khoảng thời gian không đọc hoạt động 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; thì xảy ra lỗi khi đặt giá trị nhỏ hơn một giây. Theo mặc định, các ping giữ kết nối sẽ bị tắt. Bạn nên phối hợp với chủ sở hữu dịch vụ trước khi bật 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
- Giá trị 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 giữ 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 phản hồi ping sau khoảng thời gian này. Thời gian được coi là độ chi tiết thứ hai; thì xảy ra lỗi khi đặt giá trị nhỏ hơn một giây. Nếu ping duy trì hoạt động bị tắt, thì chế độ cài đặt này sẽ bị bỏ qua.
--override_repository=<an equals-separated mapping of repository name to path>
lần dùng được tích luỹ- Ghi đè kho lưu trữ bằng thư mục cục bộ.
- 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, trong đó có nơi tìm các gói. Các phần tử bắt đầu bằng '%workspace%' đều liên quan đến không gian làm việc bao quanh. Nếu bạn bỏ qua hoặc để trống giá trị này, giá trị mặc định sẽ là "bazel info default-package-path".
- Giá trị mặc định của
--[no]show_loading_progress
: "true" - Nếu được bật, Bazel sẽ hiện thông báo "Đang tải gói:" tin nhắn.
- Mặc định
--tls_certificate=<a string>
: xem nội dung mô tả - Chỉ định một đường dẫn đến chứng chỉ TLS được tin cậy để ký chứng chỉ máy chủ.
- Mặc định
--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á ứng dụng khách để bật tính năng xác thực ứng dụng.
- Mặc định
--tls_client_key=<a string>
: xem nội dung mô tả - Chỉ định khoá ứng dụng 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 ứng dụng khách.
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:
--distdir=<a path>
lần dùng được tích luỹ-
Các nơi khác để tìm kiếm các bản lưu trữ trước khi truy cập vào mạng để tải các bản lưu trữ đó xuống.
Thẻ:bazel_internal_configuration
- Giá trị mặc định của
--[no]experimental_repository_cache_hardlinks
: "false" -
Nếu được thiết lập, bộ nhớ đệm của kho lưu trữ sẽ liên kết cứng tệp trong trường hợp có lượt truy cập bộ nhớ đệm, thay vì sao chép. Thao tác này nhằm tiết kiệm dung lượng ổ đĩa.
Thẻ:bazel_internal_configuration
- Giá trị mặc định của
--[no]experimental_repository_cache_urls_as_default_canonical_id
: "false" -
Nếu đúng, hãy sử dụng một chuỗi bắt nguồn từ URL của các tệp tải xuống từ kho lưu trữ dưới dạngcanonical_id nếu không được chỉ định. Điều này khiến URL thay đổi, dẫn đến việc tải xuống lại ngay cả khi bộ nhớ đệm chứa tệp tải xuống có cùng hàm băm. Bạn có thể sử dụng quy trình này để xác minh rằng các thay đổi về URL không làm hỏng các kho lưu trữ bị bộ nhớ đệm che khuất.
Thẻ:loading_and_analysis
,experimental
- Giá trị mặc định của
--[no]experimental_repository_disable_download
: "false" -
Nếu đã đặt, bạn sẽ không được phép tải các kho lưu trữ bên ngoài xuống.
Thẻ:experimental
- Giá trị mặc định của
--experimental_repository_downloader_retries=<an integer>
: "0" -
Số lần thử tải lại lỗi xuống tối đa. Nếu bạn đặt chính sách này thành 0, hoạt động thử lại sẽ bị tắt.
Thẻ:experimental
- Giá trị mặc định của
--experimental_scale_timeouts=<a double>
: "1" -
Điều chỉnh tỷ lệ tất cả thời gian chờ trong quy tắc kho lưu trữ Starlark theo hệ số này. Bằng cách này, các kho lưu trữ bên ngoài có thể hoạt động trên các máy chậm hơn dự kiến của tác giả quy tắc mà không cần thay đổi mã nguồn
Thẻ:bazel_internal_configuration
,experimental
- Giá trị mặc định của
--http_timeout_scaling=<a double>
: "1" -
Điều chỉnh tỷ lệ tất cả thời gian chờ liên quan đến lượt tải xuống http theo hệ số cho trước
Thẻ:bazel_internal_configuration
- Mặc định
--repository_cache=<a path>
: xem nội dung mô tả -
Chỉ định vị trí bộ nhớ đệm của các giá trị được tải xuống thu được trong quá trình tìm nạp kho lưu trữ bên ngoài. Chuỗi trống dưới dạng đối số yêu cầu tắt bộ nhớ đệm.
Thẻ:bazel_internal_configuration
- Các lựa chọn ảnh hưởng đến mức độ nghiêm ngặt của Bazel trong việc thực thi dữ liệu đầu vào bản dựng hợp lệ (định nghĩa quy tắc, tổ hợp cờ, v.v.):
- Giá trị mặc định của
--experimental_repository_hash_file=<a string>
: "" -
Nếu giá trị không trống, hãy chỉ định tệp có chứa giá trị đã phân giải mà cần phải xác minh giá trị băm của thư mục kho lưu trữ
Thẻ:affects_outputs
,experimental
--experimental_verify_repository_rules=<a string>
lần dùng được tích luỹ-
Nếu danh sách các quy tắc kho lưu trữ mà hàm băm của thư mục đầu ra cần được xác minh, miễn là tệp được chỉ định bởi --experimental_repository_hash_file.
Thẻ:affects_outputs
,experimental
- Tuỳ chọn này ảnh hưởng đến ngữ nghĩa của ngôn ngữ Starlark hoặc API bản dựng có thể truy cập vào các tệp BUILD, tệp .bzl hoặc tệp WORKSPACE.:
- Giá trị mặc định của
--[no]experimental_allow_top_level_aspects_parameters
: "true" -
Không hoạt động
Thẻ:no_op
,deprecated
,experimental
- Các tuỳ chọn liên quan đến đầu ra và ngữ nghĩa Bzlmod:
--allow_yanked_versions=<a string>
lần dùng được tích luỹ-
Đã chỉ định các phiên bản mô-đun dưới dạng `<module1>@<version1>,<module2>@<version2>` sẽ được phép trong biểu đồ phần phụ thuộc đã phân giải ngay cả khi chúng được khai báo được kéo trong sổ đăng ký nơi chúng đến (nếu chúng không đến từ NonRegistryOverride). Nếu không, các phiên bản được kéo sẽ khiến quá trình phân giải bị lỗi. Bạn cũng có thể xác định phiên bản được kéo được phép bằng biến môi trường "BZLMOD_ALLOW_YANKED_VERSIONS". Bạn có thể vô hiệu hoá chế độ kiểm tra này bằng cách sử dụng từ khoá 'tất cả' (không nên dùng).
Thẻ:loading_and_analysis
- Giá trị 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" để báo cáo lỗi thành không giải quyết được, "tắt" để tắt tính năng kiểm tra hoặc "cảnh báo" để in một cảnh báo khi phát hiện thấy thông tin không khớp.
Thẻ:loading_and_analysis
- Giá trị 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 "bazel_dep" trực tiếp đượ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 đã phân giải hay không. Các giá trị hợp lệ là "off" để tắt tính năng kiểm tra, "warning" để in cảnh báo khi phát hiện thấy thông tin không khớp hoặc "error" để chuyển cảnh báo thành không giải quyết được.
Thẻ:loading_and_analysis
- Giá trị mặc định của
--[no]ignore_dev_dependency
: "false" -
Nếu đúng, Bazel sẽ bỏ qua phương thức "bazel_dep" và "use_extension" được khai báo là "dev_Dependencies" trong MODULE.bazel của mô-đun gốc. Lưu ý rằng các phần phụ thuộc dev đó 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
--override_module=<an equals-separated mapping of module name to path>
lần dùng được tích luỹ- Ghi đè mô-đun bằng thư mục cục bộ.
--registry=<a string>
lần dùng được tích luỹ-
Chỉ định sổ đăng ký cần sử dụng để xác định vị trí các phần phụ thuộc của mô-đun Bazel. Thứ tự này rất quan trọng: các mô-đun sẽ được tra cứu trong các sổ đăng ký trước đó trước và chỉ quay lại các sổ đăng ký sau đó nếu không có các mô-đun trước đó.
Thẻ:changes_inputs
- Các lựa chọn ảnh hưởng đến độ chi tiết, định dạng hoặc vị trí ghi nhật ký:
- Giá trị mặc định của
--[no]experimental_record_metrics_for_all_mnemonics
: "false" - Theo mặc định, số lượng loại hành động được giới hạn ở 20 bộ nhớ có số lượng hành động được thực thi lớn nhất. Việc đặt tuỳ chọn này sẽ ghi số liệu thống kê cho tất cả các bộ nhớ.
- Mặc định của
--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 lựa chọn, thay vì chỉ hiện tên lựa 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 lựa chọn chứ không hiển thị loại hoặc ý nghĩa của các lựa 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 cho lệnh Bazel không thuộc các danh mục khác.:
- Giá trị mặc định của
--experimental_resolved_file_instead_of_workspace=<a string>
: "" -
Nếu không để trống, hãy đọc tệp đã giải quyết được chỉ định thay vì tệp WORKSPACE
Thẻ:changes_inputs
- Tuỳ chọn thực thi và lưu vào bộ nhớ đệm từ xa:
- Mặc định
--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ủ lưu trữ (cho `allow` và `block`) hoặc hai mẫu, một mẫu để so khớp và một mẫu để sử dụng làm URL thay thế, với các tham chiếu ngược bắt đầu từ `$1`. Bạn có thể cung cấp nhiều lệnh "ghi lại" cho cùng một URL và trong trường hợp này, hệ thống sẽ trả về nhiều URL.
- Các lựa chọn khác, không được phân loại theo cách khác.:
--override_repository=<an equals-separated mapping of repository name to path>
lần dùng được tích luỹ- Ghi đè kho lưu trữ bằng thư mục cục bộ.
Các lựa chọn thông tin
Kế thừa tất cả tuỳ chọn từ 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:
--distdir=<a path>
lần dùng được tích luỹ-
Các nơi khác để tìm kiếm các bản lưu trữ trước khi truy cập vào mạng để tải các bản lưu trữ đó xuống.
Thẻ:bazel_internal_configuration
- Giá trị mặc định của
--[no]experimental_repository_cache_hardlinks
: "false" -
Nếu được thiết lập, bộ nhớ đệm của kho lưu trữ sẽ liên kết cứng tệp trong trường hợp có lượt truy cập bộ nhớ đệm, thay vì sao chép. Thao tác này nhằm tiết kiệm dung lượng ổ đĩa.
Thẻ:bazel_internal_configuration
- Giá trị mặc định của
--[no]experimental_repository_cache_urls_as_default_canonical_id
: "false" -
Nếu đúng, hãy sử dụng một chuỗi bắt nguồn từ URL của các tệp tải xuống từ kho lưu trữ dưới dạngcanonical_id nếu không được chỉ định. Điều này khiến URL thay đổi, dẫn đến việc tải xuống lại ngay cả khi bộ nhớ đệm chứa tệp tải xuống có cùng hàm băm. Bạn có thể sử dụng quy trình này để xác minh rằng các thay đổi về URL không làm hỏng các kho lưu trữ bị bộ nhớ đệm che khuất.
Thẻ:loading_and_analysis
,experimental
- Giá trị mặc định của
--[no]experimental_repository_disable_download
: "false" -
Nếu đã đặt, bạn sẽ không được phép tải các kho lưu trữ bên ngoài xuống.
Thẻ:experimental
- Giá trị mặc định của
--experimental_repository_downloader_retries=<an integer>
: "0" -
Số lần thử tải lại lỗi xuống tối đa. Nếu bạn đặt chính sách này thành 0, hoạt động thử lại sẽ bị tắt.
Thẻ:experimental
- Giá trị mặc định của
--experimental_scale_timeouts=<a double>
: "1" -
Điều chỉnh tỷ lệ tất cả thời gian chờ trong quy tắc kho lưu trữ Starlark theo hệ số này. Bằng cách này, các kho lưu trữ bên ngoài có thể hoạt động trên các máy chậm hơn dự kiến của tác giả quy tắc mà không cần thay đổi mã nguồn
Thẻ:bazel_internal_configuration
,experimental
- Giá trị mặc định của
--http_timeout_scaling=<a double>
: "1" -
Điều chỉnh tỷ lệ tất cả thời gian chờ liên quan đến lượt tải xuống http theo hệ số cho trước
Thẻ:bazel_internal_configuration
- Mặc định
--repository_cache=<a path>
: xem nội dung mô tả -
Chỉ định vị trí bộ nhớ đệm của các giá trị được tải xuống thu được trong quá trình tìm nạp kho lưu trữ bên ngoài. Chuỗi trống dưới dạng đối số yêu cầu tắt bộ nhớ đệm.
Thẻ:bazel_internal_configuration
- Các lựa chọn ảnh hưởng đến mức độ nghiêm ngặt của Bazel trong việc thực thi dữ liệu đầu vào bản dựng hợp lệ (định nghĩa quy tắc, tổ hợp cờ, v.v.):
- Giá trị mặc định của
--experimental_repository_hash_file=<a string>
: "" -
Nếu giá trị không trống, hãy chỉ định tệp có chứa giá trị đã phân giải mà cần phải xác minh giá trị băm của thư mục kho lưu trữ
Thẻ:affects_outputs
,experimental
--experimental_verify_repository_rules=<a string>
lần dùng được tích luỹ-
Nếu danh sách các quy tắc kho lưu trữ mà hàm băm của thư mục đầu ra cần được xác minh, miễn là tệp được chỉ định bởi --experimental_repository_hash_file.
Thẻ:affects_outputs
,experimental
- Tuỳ chọn này ảnh hưởng đến ngữ nghĩa của ngôn ngữ Starlark hoặc API bản dựng có thể truy cập vào các tệp BUILD, tệp .bzl hoặc tệp WORKSPACE.:
- Giá trị mặc định của
--[no]experimental_allow_top_level_aspects_parameters
: "true" -
Không hoạt động
Thẻ:no_op
,deprecated
,experimental
- Các tuỳ chọn liên quan đến đầu ra và ngữ nghĩa Bzlmod:
--allow_yanked_versions=<a string>
lần dùng được tích luỹ-
Đã chỉ định các phiên bản mô-đun dưới dạng `<module1>@<version1>,<module2>@<version2>` sẽ được phép trong biểu đồ phần phụ thuộc đã phân giải ngay cả khi chúng được khai báo được kéo trong sổ đăng ký nơi chúng đến (nếu chúng không đến từ NonRegistryOverride). Nếu không, các phiên bản được kéo sẽ khiến quá trình phân giải bị lỗi. Bạn cũng có thể xác định phiên bản được kéo được phép bằng biến môi trường "BZLMOD_ALLOW_YANKED_VERSIONS". Bạn có thể vô hiệu hoá chế độ kiểm tra này bằng cách sử dụng từ khoá 'tất cả' (không nên dùng).
Thẻ:loading_and_analysis
- Giá trị 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" để báo cáo lỗi thành không giải quyết được, "tắt" để tắt tính năng kiểm tra hoặc "cảnh báo" để in một cảnh báo khi phát hiện thấy thông tin không khớp.
Thẻ:loading_and_analysis
- Giá trị 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 "bazel_dep" trực tiếp đượ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 đã phân giải hay không. Các giá trị hợp lệ là "off" để tắt tính năng kiểm tra, "warning" để in cảnh báo khi phát hiện thấy thông tin không khớp hoặc "error" để chuyển cảnh báo thành không giải quyết được.
Thẻ:loading_and_analysis
- Giá trị mặc định của
--[no]ignore_dev_dependency
: "false" -
Nếu đúng, Bazel sẽ bỏ qua phương thức "bazel_dep" và "use_extension" được khai báo là "dev_Dependencies" trong MODULE.bazel của mô-đun gốc. Lưu ý rằng các phần phụ thuộc dev đó 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
--override_module=<an equals-separated mapping of module name to path>
lần dùng được tích luỹ- Ghi đè mô-đun bằng thư mục cục bộ.
--registry=<a string>
lần dùng được tích luỹ-
Chỉ định sổ đăng ký cần sử dụng để xác định vị trí các phần phụ thuộc của mô-đun Bazel. Thứ tự này rất quan trọng: các mô-đun sẽ được tra cứu trong các sổ đăng ký trước đó trước và chỉ quay lại các sổ đăng ký sau đó nếu không có các mô-đun trước đó.
Thẻ:changes_inputs
- Các lựa chọn ảnh hưởng đến độ chi tiết, định dạng hoặc vị trí ghi nhật ký:
- Giá trị mặc định của
--[no]experimental_record_metrics_for_all_mnemonics
: "false" - Theo mặc định, số lượng loại hành động được giới hạn ở 20 bộ nhớ có số lượng hành động được thực thi lớn nhất. Việc đặt tuỳ chọn này sẽ ghi số liệu thống kê cho tất cả các bộ nhớ.
- Giá trị mặc định của
--[no]show_make_env
: "false" -
Bao gồm nhãn "Nhãn hiệu" trong đầ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 cho một lệnh Bazel không thuộc các danh mục khác.:
- Giá trị mặc định của
--experimental_resolved_file_instead_of_workspace=<a string>
: "" -
Nếu không để trống, hãy đọc tệp đã giải quyết được chỉ định thay vì tệp WORKSPACE
Thẻ:changes_inputs
- Tuỳ chọn thực thi và lưu vào bộ nhớ đệm từ xa:
- Mặc định
--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ủ lưu trữ (cho `allow` và `block`) hoặc hai mẫu, một mẫu để so khớp và một mẫu để sử dụng làm URL thay thế, với các tham chiếu ngược bắt đầu từ `$1`. Bạn có thể cung cấp nhiều lệnh "ghi lại" cho cùng một URL và trong trường hợp này, hệ thống sẽ trả về nhiều URL.
- Các lựa chọn khác, không được phân loại theo cách khác.:
--override_repository=<an equals-separated mapping of repository name to path>
lần dùng được tích luỹ- Ghi đè kho lưu trữ bằng thư mục cục bộ.
Các lựa chọn về giấy phép
- Các tuỳ chọn xuất hiện trước lệnh và được ứng dụng phân tích cú pháp:
--distdir=<a path>
lần dùng được tích luỹ-
Các nơi khác để tìm kiếm các bản lưu trữ trước khi truy cập vào mạng để tải các bản lưu trữ đó xuống.
Thẻ:bazel_internal_configuration
- Giá trị mặc định của
--[no]experimental_repository_cache_hardlinks
: "false" -
Nếu được thiết lập, bộ nhớ đệm của kho lưu trữ sẽ liên kết cứng tệp trong trường hợp có lượt truy cập bộ nhớ đệm, thay vì sao chép. Thao tác này nhằm tiết kiệm dung lượng ổ đĩa.
Thẻ:bazel_internal_configuration
- Giá trị mặc định của
--[no]experimental_repository_cache_urls_as_default_canonical_id
: "false" -
Nếu đúng, hãy sử dụng một chuỗi bắt nguồn từ URL của các tệp tải xuống từ kho lưu trữ dưới dạngcanonical_id nếu không được chỉ định. Điều này khiến URL thay đổi, dẫn đến việc tải xuống lại ngay cả khi bộ nhớ đệm chứa tệp tải xuống có cùng hàm băm. Bạn có thể sử dụng quy trình này để xác minh rằng các thay đổi về URL không làm hỏng các kho lưu trữ bị bộ nhớ đệm che khuất.
Thẻ:loading_and_analysis
,experimental
- Giá trị mặc định của
--[no]experimental_repository_disable_download
: "false" -
Nếu đã đặt, bạn sẽ không được phép tải các kho lưu trữ bên ngoài xuống.
Thẻ:experimental
- Giá trị mặc định của
--experimental_repository_downloader_retries=<an integer>
: "0" -
Số lần thử tải lại lỗi xuống tối đa. Nếu bạn đặt chính sách này thành 0, hoạt động thử lại sẽ bị tắt.
Thẻ:experimental
- Giá trị mặc định của
--experimental_scale_timeouts=<a double>
: "1" -
Điều chỉnh tỷ lệ tất cả thời gian chờ trong quy tắc kho lưu trữ Starlark theo hệ số này. Bằng cách này, các kho lưu trữ bên ngoài có thể hoạt động trên các máy chậm hơn dự kiến của tác giả quy tắc mà không cần thay đổi mã nguồn
Thẻ:bazel_internal_configuration
,experimental
- Giá trị mặc định của
--http_timeout_scaling=<a double>
: "1" -
Điều chỉnh tỷ lệ tất cả thời gian chờ liên quan đến lượt tải xuống http theo hệ số cho trước
Thẻ:bazel_internal_configuration
- Mặc định
--repository_cache=<a path>
: xem nội dung mô tả -
Chỉ định vị trí bộ nhớ đệm của các giá trị được tải xuống thu được trong quá trình tìm nạp kho lưu trữ bên ngoài. Chuỗi trống dưới dạng đối số yêu cầu tắt bộ nhớ đệm.
Thẻ:bazel_internal_configuration
- Các lựa chọn ảnh hưởng đến mức độ nghiêm ngặt của Bazel trong việc thực thi dữ liệu đầu vào bản dựng hợp lệ (định nghĩa quy tắc, tổ hợp cờ, v.v.):
- Giá trị mặc định của
--experimental_repository_hash_file=<a string>
: "" -
Nếu giá trị không trống, hãy chỉ định tệp có chứa giá trị đã phân giải mà cần phải xác minh giá trị băm của thư mục kho lưu trữ
Thẻ:affects_outputs
,experimental
--experimental_verify_repository_rules=<a string>
lần dùng được tích luỹ-
Nếu danh sách các quy tắc kho lưu trữ mà hàm băm của thư mục đầu ra cần được xác minh, miễn là tệp được chỉ định bởi --experimental_repository_hash_file.
Thẻ:affects_outputs
,experimental
- Tuỳ chọn này ảnh hưởng đến ngữ nghĩa của ngôn ngữ Starlark hoặc API bản dựng có thể truy cập vào các tệp BUILD, tệp .bzl hoặc tệp WORKSPACE.:
- Giá trị mặc định của
--[no]experimental_allow_top_level_aspects_parameters
: "true" -
Không hoạt động
Thẻ:no_op
,deprecated
,experimental
- Các tuỳ chọn liên quan đến đầu ra và ngữ nghĩa Bzlmod:
--allow_yanked_versions=<a string>
lần dùng được tích luỹ-
Đã chỉ định các phiên bản mô-đun dưới dạng `<module1>@<version1>,<module2>@<version2>` sẽ được phép trong biểu đồ phần phụ thuộc đã phân giải ngay cả khi chúng được khai báo được kéo trong sổ đăng ký nơi chúng đến (nếu chúng không đến từ NonRegistryOverride). Nếu không, các phiên bản được kéo sẽ khiến quá trình phân giải bị lỗi. Bạn cũng có thể xác định phiên bản được kéo được phép bằng biến môi trường "BZLMOD_ALLOW_YANKED_VERSIONS". Bạn có thể vô hiệu hoá chế độ kiểm tra này bằng cách sử dụng từ khoá 'tất cả' (không nên dùng).
Thẻ:loading_and_analysis
- Giá trị 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" để báo cáo lỗi thành không giải quyết được, "tắt" để tắt tính năng kiểm tra hoặc "cảnh báo" để in một cảnh báo khi phát hiện thấy thông tin không khớp.
Thẻ:loading_and_analysis
- Giá trị 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 "bazel_dep" trực tiếp đượ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 đã phân giải hay không. Các giá trị hợp lệ là "off" để tắt tính năng kiểm tra, "warning" để in cảnh báo khi phát hiện thấy thông tin không khớp hoặc "error" để chuyển cảnh báo thành không giải quyết được.
Thẻ:loading_and_analysis
- Giá trị mặc định của
--[no]ignore_dev_dependency
: "false" -
Nếu đúng, Bazel sẽ bỏ qua phương thức "bazel_dep" và "use_extension" được khai báo là "dev_Dependencies" trong MODULE.bazel của mô-đun gốc. Lưu ý rằng các phần phụ thuộc dev đó 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
--override_module=<an equals-separated mapping of module name to path>
lần dùng được tích luỹ- Ghi đè mô-đun bằng thư mục cục bộ.
--registry=<a string>
lần dùng được tích luỹ-
Chỉ định sổ đăng ký cần sử dụng để xác định vị trí các phần phụ thuộc của mô-đun Bazel. Thứ tự này rất quan trọng: các mô-đun sẽ được tra cứu trong các sổ đăng ký trước đó trước và chỉ quay lại các sổ đăng ký sau đó nếu không có các mô-đun trước đó.
Thẻ:changes_inputs
- Các lựa chọn ảnh hưởng đến độ chi tiết, định dạng hoặc vị trí ghi nhật ký:
- Giá trị mặc định của
--[no]experimental_record_metrics_for_all_mnemonics
: "false" - Theo mặc định, số lượng loại hành động được giới hạn ở 20 bộ nhớ có số lượng hành động được thực thi lớn nhất. Việc đặt tuỳ chọn này sẽ ghi số liệu thống kê cho tất cả các bộ nhớ.
- Các tuỳ chọn chỉ định hoặc thay đổi dữ liệu đầu vào chung cho lệnh Bazel không thuộc các danh mục khác.:
- Giá trị mặc định của
--experimental_resolved_file_instead_of_workspace=<a string>
: "" -
Nếu không để trống, hãy đọc tệp đã giải quyết được chỉ định thay vì tệp WORKSPACE
Thẻ:changes_inputs
- Tuỳ chọn thực thi và lưu vào bộ nhớ đệm từ xa:
- Mặc định
--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ủ lưu trữ (cho `allow` và `block`) hoặc hai mẫu, một mẫu để so khớp và một mẫu để sử dụng làm URL thay thế, với các tham chiếu ngược bắt đầu từ `$1`. Bạn có thể cung cấp nhiều lệnh "ghi lại" cho cùng một URL và trong trường hợp này, hệ thống sẽ trả về nhiều URL.
- Các lựa chọn khác, không được phân loại theo cách khác.:
--override_repository=<an equals-separated mapping of repository name to path>
lần dùng được tích luỹ- Ghi đè kho lưu trữ bằng thư mục cục bộ.
Lựa chọn cài đặt trên thiết bị di động
Kế thừa tất cả tuỳ chọn từ 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:
--distdir=<a path>
lần dùng được tích luỹ-
Các nơi khác để tìm kiếm các bản lưu trữ trước khi truy cập vào mạng để tải các bản lưu trữ đó xuống.
Thẻ:bazel_internal_configuration
- Giá trị mặc định của
--[no]experimental_repository_cache_hardlinks
: "false" -
Nếu được thiết lập, bộ nhớ đệm của kho lưu trữ sẽ liên kết cứng tệp trong trường hợp có lượt truy cập bộ nhớ đệm, thay vì sao chép. Thao tác này nhằm tiết kiệm dung lượng ổ đĩa.
Thẻ:bazel_internal_configuration
- Giá trị mặc định của
--[no]experimental_repository_cache_urls_as_default_canonical_id
: "false" -
Nếu đúng, hãy sử dụng một chuỗi bắt nguồn từ URL của các tệp tải xuống từ kho lưu trữ dưới dạngcanonical_id nếu không được chỉ định. Điều này khiến URL thay đổi, dẫn đến việc tải xuống lại ngay cả khi bộ nhớ đệm chứa tệp tải xuống có cùng hàm băm. Bạn có thể sử dụng quy trình này để xác minh rằng các thay đổi về URL không làm hỏng các kho lưu trữ bị bộ nhớ đệm che khuất.
Thẻ:loading_and_analysis
,experimental
- Giá trị mặc định của
--[no]experimental_repository_disable_download
: "false" -
Nếu đã đặt, bạn sẽ không được phép tải các kho lưu trữ bên ngoài xuống.
Thẻ:experimental
- Giá trị mặc định của
--experimental_repository_downloader_retries=<an integer>
: "0" -
Số lần thử tải lại lỗi xuống tối đa. Nếu bạn đặt chính sách này thành 0, hoạt động thử lại sẽ bị tắt.
Thẻ:experimental
- Giá trị mặc định của
--experimental_scale_timeouts=<a double>
: "1" -
Điều chỉnh tỷ lệ tất cả thời gian chờ trong quy tắc kho lưu trữ Starlark theo hệ số này. Bằng cách này, các kho lưu trữ bên ngoài có thể hoạt động trên các máy chậm hơn dự kiến của tác giả quy tắc mà không cần thay đổi mã nguồn
Thẻ:bazel_internal_configuration
,experimental
- Giá trị mặc định của
--http_timeout_scaling=<a double>
: "1" -
Điều chỉnh tỷ lệ tất cả thời gian chờ liên quan đến lượt tải xuống http theo hệ số cho trước
Thẻ:bazel_internal_configuration
- Mặc định
--repository_cache=<a path>
: xem nội dung mô tả -
Chỉ định vị trí bộ nhớ đệm của các giá trị được tải xuống thu được trong quá trình tìm nạp kho lưu trữ bên ngoài. Chuỗi trống dưới dạng đối số yêu cầu tắt bộ nhớ đệm.
Thẻ:bazel_internal_configuration
- Các tuỳ chọn kiểm soát việc thực thi bản dựng:
- Mặc định của
--mode=<classic, classic_internal_test_do_not_use or skylark>
: "cổ điển" -
Chọn cách chạy lượt cài đặt trên thiết bị di động. "cổ điển" chạy phiên bản cài đặt hiện tại của thiết bị di động. "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:
- Giá trị mặc định của
--adb=<a string>
: "" -
Tệp nhị phân adb để dùng cho lệnh 'cài đặt trên thiết bị di động' . Nếu bạn không chỉ định, thì SDK trong SDK Android được chỉ định bằng tuỳ chọn dòng lệnh --android_sdk (hoặc SDK mặc định nếu –android_sdk không được chỉ định) sẽ được sử dụng.
Thẻ:changes_inputs
- Các tuỳ chọn kiểm soát kết quả của lệnh:
- Giá trị mặc định của
--[no]incremental
: "false" -
Liệu có thực hiện cài đặt gia tăng hay không. Nếu true, cố gắng tránh công việc bổ sung 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ông việc không cần thiết. Nếu giá trị là false (mặc định), hãy luôn cài đặt đầy đủ.
Thẻ:loading_and_analysis
- Giá trị mặc định của
--[no]split_apks
: "false" -
Liệu có 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 trên các thiết bị chạy Marshmallow trở lên
Thẻ:loading_and_analysis
,affects_outputs
- Các tuỳ chọn cho phép người dùng định cấu hình đầu ra dự kiến, trái ngược với sự tồn tại của kết quả đó:
--adb_arg=<a string>
lần dùng được tích luỹ-
Các đối số bổ sung để truyền đến adb. Thường dùng để chỉ định một thiết bị cần 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
- Giá trị mặc định của
--device=<a string>
: "" -
Số sê-ri của thiết bị adb. Nếu không được chỉ định, thiết bị đầu tiên sẽ được sử dụng.
Thẻ:action_command_lines
- Giá trị mặc định của
--start=<no, cold, warm or debug>
: "KHÔNG" -
Cách khởi động ứng dụng sau khi cài đặt. Đặt thành WARM để duy trì và khôi phục trạng thái của ứng dụng khi số lượt cài đặt gia tăng.
Thẻ:execution
--start_app
-
Liệu có khởi động ứng dụng sau khi cài đặt hay không.
Mở rộng thành:
--start=COLD
Thẻ:execution
- Các lựa chọn ảnh hưởng đến mức độ nghiêm ngặt của Bazel trong việc thực thi dữ liệu đầu vào bản dựng hợp lệ (định nghĩa quy tắc, tổ hợp cờ, v.v.):
- Giá trị mặc định của
--experimental_repository_hash_file=<a string>
: "" -
Nếu giá trị không trống, hãy chỉ định tệp có chứa giá trị đã phân giải mà cần phải xác minh giá trị băm của thư mục kho lưu trữ
Thẻ:affects_outputs
,experimental
--experimental_verify_repository_rules=<a string>
lần dùng được tích luỹ-
Nếu danh sách các quy tắc kho lưu trữ mà hàm băm của thư mục đầu ra cần được xác minh, miễn là tệp được chỉ định bởi --experimental_repository_hash_file.
Thẻ:affects_outputs
,experimental
- Tuỳ chọn này ảnh hưởng đến ngữ nghĩa của ngôn ngữ Starlark hoặc API bản dựng có thể truy cập vào các tệp BUILD, tệp .bzl hoặc tệp WORKSPACE.:
- Giá trị mặc định của
--[no]experimental_allow_top_level_aspects_parameters
: "true" -
Không hoạt động
Thẻ:no_op
,deprecated
,experimental
- Các tuỳ chọn liên quan đến đầu ra và ngữ nghĩa Bzlmod:
--allow_yanked_versions=<a string>
lần dùng được tích luỹ-
Đã chỉ định các phiên bản mô-đun dưới dạng `<module1>@<version1>,<module2>@<version2>` sẽ được phép trong biểu đồ phần phụ thuộc đã phân giải ngay cả khi chúng được khai báo được kéo trong sổ đăng ký nơi chúng đến (nếu chúng không đến từ NonRegistryOverride). Nếu không, các phiên bản được kéo sẽ khiến quá trình phân giải bị lỗi. Bạn cũng có thể xác định phiên bản được kéo được phép bằng biến môi trường "BZLMOD_ALLOW_YANKED_VERSIONS". Bạn có thể vô hiệu hoá chế độ kiểm tra này bằng cách sử dụng từ khoá 'tất cả' (không nên dùng).
Thẻ:loading_and_analysis
- Giá trị 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" để báo cáo lỗi thành không giải quyết được, "tắt" để tắt tính năng kiểm tra hoặc "cảnh báo" để in một cảnh báo khi phát hiện thấy thông tin không khớp.
Thẻ:loading_and_analysis
- Giá trị 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 "bazel_dep" trực tiếp đượ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 đã phân giải hay không. Các giá trị hợp lệ là "off" để tắt tính năng kiểm tra, "warning" để in cảnh báo khi phát hiện thấy thông tin không khớp hoặc "error" để chuyển cảnh báo thành không giải quyết được.
Thẻ:loading_and_analysis
- Giá trị mặc định của
--[no]ignore_dev_dependency
: "false" -
Nếu đúng, Bazel sẽ bỏ qua phương thức "bazel_dep" và "use_extension" được khai báo là "dev_Dependencies" trong MODULE.bazel của mô-đun gốc. Lưu ý rằng các phần phụ thuộc dev đó 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
--override_module=<an equals-separated mapping of module name to path>
lần dùng được tích luỹ- Ghi đè mô-đun bằng thư mục cục bộ.
--registry=<a string>
lần dùng được tích luỹ-
Chỉ định sổ đăng ký cần sử dụng để xác định vị trí các phần phụ thuộc của mô-đun Bazel. Thứ tự này rất quan trọng: các mô-đun sẽ được tra cứu trong các sổ đăng ký trước đó trước và chỉ quay lại các sổ đăng ký sau đó nếu không có các mô-đun trước đó.
Thẻ:changes_inputs
- Các lựa chọn ảnh hưởng đến độ chi tiết, định dạng hoặc vị trí ghi nhật ký:
- Giá trị mặc định của
--[no]experimental_record_metrics_for_all_mnemonics
: "false" - Theo mặc định, số lượng loại hành động được giới hạn ở 20 bộ nhớ có số lượng hành động được thực thi lớn nhất. Việc đặt tuỳ chọn này sẽ ghi số liệu thống kê cho tất cả các bộ nhớ.
- Giá trị mặc định của
--incremental_install_verbosity=<a string>
: "" -
Độ chi tiết khi cài đặt gia tăng. Hãy đặt thành 1 để ghi nhật ký gỡ lỗi.
Thẻ:bazel_monitoring
- Các tuỳ chọn chỉ định hoặc thay đổi dữ liệu đầu vào chung cho lệnh Bazel không thuộc các danh mục khác.:
- Giá trị mặc định của
--experimental_resolved_file_instead_of_workspace=<a string>
: "" -
Nếu không để trống, hãy đọc tệp đã giải quyết được chỉ định thay vì tệp WORKSPACE
Thẻ:changes_inputs
- Tuỳ chọn thực thi và lưu vào bộ nhớ đệm từ xa:
- Mặc định
--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ủ lưu trữ (cho `allow` và `block`) hoặc hai mẫu, một mẫu để so khớp và một mẫu để sử dụng làm URL thay thế, với các tham chiếu ngược bắt đầu từ `$1`. Bạn có thể cung cấp nhiều lệnh "ghi lại" cho cùng một URL và trong trường hợp này, hệ thống sẽ trả về nhiều URL.
- Các lựa chọn khác, không được phân loại theo cách khác.:
--override_repository=<an equals-separated mapping of repository name to path>
lần dùng được tích luỹ- Ghi đè kho lưu trữ bằng thư mục cục bộ.
Các tuỳ chọn Modquery
- 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:
--distdir=<a path>
lần dùng được tích luỹ-
Các nơi khác để tìm kiếm các bản lưu trữ trước khi truy cập vào mạng để tải các bản lưu trữ đó xuống.
Thẻ:bazel_internal_configuration
- Giá trị mặc định của
--[no]experimental_repository_cache_hardlinks
: "false" -
Nếu được thiết lập, bộ nhớ đệm của kho lưu trữ sẽ liên kết cứng tệp trong trường hợp có lượt truy cập bộ nhớ đệm, thay vì sao chép. Thao tác này nhằm tiết kiệm dung lượng ổ đĩa.
Thẻ:bazel_internal_configuration
- Giá trị mặc định của
--[no]experimental_repository_cache_urls_as_default_canonical_id
: "false" -
Nếu đúng, hãy sử dụng một chuỗi bắt nguồn từ URL của các tệp tải xuống từ kho lưu trữ dưới dạngcanonical_id nếu không được chỉ định. Điều này khiến URL thay đổi, dẫn đến việc tải xuống lại ngay cả khi bộ nhớ đệm chứa tệp tải xuống có cùng hàm băm. Bạn có thể sử dụng quy trình này để xác minh rằng các thay đổi về URL không làm hỏng các kho lưu trữ bị bộ nhớ đệm che khuất.
Thẻ:loading_and_analysis
,experimental
- Giá trị mặc định của
--[no]experimental_repository_disable_download
: "false" -
Nếu đã đặt, bạn sẽ không được phép tải các kho lưu trữ bên ngoài xuống.
Thẻ:experimental
- Giá trị mặc định của
--experimental_repository_downloader_retries=<an integer>
: "0" -
Số lần thử tải lại lỗi xuống tối đa. Nếu bạn đặt chính sách này thành 0, hoạt động thử lại sẽ bị tắt.
Thẻ:experimental
- Giá trị mặc định của
--experimental_scale_timeouts=<a double>
: "1" -
Điều chỉnh tỷ lệ tất cả thời gian chờ trong quy tắc kho lưu trữ Starlark theo hệ số này. Bằng cách này, các kho lưu trữ bên ngoài có thể hoạt động trên các máy chậm hơn dự kiến của tác giả quy tắc mà không cần thay đổi mã nguồn
Thẻ:bazel_internal_configuration
,experimental
- Giá trị mặc định của
--http_timeout_scaling=<a double>
: "1" -
Điều chỉnh tỷ lệ tất cả thời gian chờ liên quan đến lượt tải xuống http theo hệ số cho trước
Thẻ:bazel_internal_configuration
- Mặc định
--repository_cache=<a path>
: xem nội dung mô tả -
Chỉ định vị trí bộ nhớ đệm của các giá trị được tải xuống thu được trong quá trình tìm nạp kho lưu trữ bên ngoài. Chuỗi trống dưới dạng đối số yêu cầu tắt bộ nhớ đệm.
Thẻ:bazel_internal_configuration
- Các tuỳ chọn kiểm soát việc thực thi bản dựng:
--[no]keep_going
[-k
] mặc định: "false"-
Hãy tiếp tục nhiều nhất có thể sau khi gặp lỗi. Mặc dù không thể phân tích mục tiêu không thành công và những mục tiêu phụ thuộc vào nó, nhưng có thể có các điều kiện tiên quyết khác cho những mục tiêu này.
Thẻ:eagerness_to_exit
- Giá trị mặc định của
--loading_phase_threads=<an integer, or a keyword ("auto", "HOST_CPUS", "HOST_RAM"), optionally followed by an operation ([-|*]<float>) eg. "auto", "HOST_CPUS*.5">
: "tự động" -
Số lượng luồng song song để sử 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 bởi một thao tác ([-|*]<float>), ví dụ: "tự động", "HOST_CPUS*.5". "tự động" đặt giá trị mặc định hợp lý dựa trên tài nguyên máy chủ lưu trữ. Phải ít nhất là 1.
Thẻ:bazel_internal_configuration
- Các lựa chọn ảnh hưởng đến mức độ nghiêm ngặt của Bazel trong việc thực thi dữ liệu đầu vào bản dựng hợp lệ (định nghĩa quy tắc, tổ hợp cờ, v.v.):
- Giá trị mặc định của
--experimental_repository_hash_file=<a string>
: "" -
Nếu giá trị không trống, hãy chỉ định tệp có chứa giá trị đã phân giải mà cần phải xác minh giá trị băm của thư mục kho lưu trữ
Thẻ:affects_outputs
,experimental
--experimental_verify_repository_rules=<a string>
lần dùng được tích luỹ-
Nếu danh sách các quy tắc kho lưu trữ mà hàm băm của thư mục đầu ra cần được xác minh, miễn là tệp được chỉ định bởi --experimental_repository_hash_file.
Thẻ:affects_outputs
,experimental
- Tuỳ chọn này ảnh hưởng đến ngữ nghĩa của ngôn ngữ Starlark hoặc API bản dựng có thể truy cập vào các tệp BUILD, tệp .bzl hoặc tệp WORKSPACE.:
- Giá trị mặc định của
--[no]experimental_allow_top_level_aspects_parameters
: "true" -
Không hoạt động
Thẻ:no_op
,deprecated
,experimental
- Giá trị mặc định của
--[no]incompatible_config_setting_private_default_visibility
: "false" -
Nếu không tương thích_enforce_config_setting_ visibility=false, thì đây là lỗi không hiển thị. Ngược lại, nếu cờ này là false, mọi chế độ cài đặt config_setting không có thuộc tính mức độ hiển thị rõ ràng sẽ là //visibility:public. Nếu cờ này là true, chế độ cài đặt config_setting sẽ tuân theo cùng một logic về chế độ hiển thị như mọi quy tắc khác. Truy cập https://github.com/bazelbuild/bazel/issues/12933.
Thẻ:loading_and_analysis
,incompatible_change
- Giá trị mặc định của
--[no]incompatible_enforce_config_setting_visibility
: "true" -
Nếu là true, hãy thực thi các quy định hạn chế về chế độ hiển thị bằng lệnh config_setting. Nếu đặt là false, mọi chế độ cài đặt config_ đều hiển thị với mọi mục tiêu. Truy cập https://github.com/bazelbuild/bazel/issues/12932.
Thẻ:loading_and_analysis
,incompatible_change
- Các tuỳ chọn liên quan đến đầu ra của modquery và ngữ nghĩa:
- Giá trị 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
- Giá trị mặc định của
--[no]cycles
: "false" -
Chỉ ra các chu kỳ phụ thuộc bên trong cây hiển thị (thường bị bỏ qua theo mặc định).
Thẻ:execution
- Giá trị mặc định của
--depth=<an integer>
: "-1" -
Chiều sâu hiển thị tối đa của cây phụ thuộc. Ví dụ: chiều sâu bằng 1 sẽ hiển thị các phần phụ thuộc trực tiếp. Đối với cây, đường dẫn 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 nó mặc định là 1 (chỉ hiển thị phần phụ thuộc trực tiếp của gốc ngoài các lá đích và cha mẹ).
Thẻ:execution
- Giá trị mặc định của
--[no]extra
: "false" -
Các truy vấn này cũng sẽ cho thấy lý do khiến các mô-đun được phân giải về phiên bản hiện tại của chúng (nếu có thay đổi). Giá trị mặc định là chỉ true đối với truy vấn giải thích.
Thẻ:execution
- Giá trị mặc định của
--from=<a list of <module>s separated by comma>
: "gốc" -
(Các) mô-đun bắt đầu từ đó truy vấn biểu đồ phụ thuộc sẽ hiển thị. Hãy kiểm tra nội dung mô tả của mỗi truy vấn để biết ngữ nghĩa chính xác. Giá trị mặc định là thư mục gốc.
Thẻ:execution
- Giá trị 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 quy tắc ghi đè hoặc Lựa chọn phiên bản tối thiểu). Việc này có thể có tác động khác nhau đối với từng loại truy vấn, tức là bao gồm các đường dẫn mới trong lệnh all_paths hoặc các phần phụ thuộc bổ sung trong lệnh giải thích.
Thẻ:execution
- Mặc định của
--output=<text, json or graph>
: "văn bản" -
Định dạng mà kết quả truy vấn sẽ được in. Các giá trị được phép cho truy vấn là: văn bản, json, biểu đồ
Thẻ:terminal_output
- Các lựa chọn liên quan đến đầu ra và ngữ nghĩa Bzlmod:
--allow_yanked_versions=<a string>
lần dùng được tích luỹ-
Đã chỉ định các phiên bản mô-đun dưới dạng `<module1>@<version1>,<module2>@<version2>` sẽ được phép trong biểu đồ phần phụ thuộc đã phân giải ngay cả khi chúng được khai báo được kéo trong sổ đăng ký nơi chúng đến (nếu chúng không đến từ NonRegistryOverride). Nếu không, các phiên bản được kéo sẽ khiến quá trình phân giải bị lỗi. Bạn cũng có thể xác định phiên bản được kéo được phép bằng biến môi trường "BZLMOD_ALLOW_YANKED_VERSIONS". Bạn có thể vô hiệu hoá chế độ kiểm tra này bằng cách sử dụng từ khoá 'tất cả' (không nên dùng).
Thẻ:loading_and_analysis
- Giá trị 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" để báo cáo lỗi thành không giải quyết được, "tắt" để tắt tính năng kiểm tra hoặc "cảnh báo" để in một cảnh báo khi phát hiện thấy thông tin không khớp.
Thẻ:loading_and_analysis
- Giá trị 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 "bazel_dep" trực tiếp đượ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 đã phân giải hay không. Các giá trị hợp lệ là "off" để tắt tính năng kiểm tra, "warning" để in cảnh báo khi phát hiện thấy thông tin không khớp hoặc "error" để chuyển cảnh báo thành không giải quyết được.
Thẻ:loading_and_analysis
- Giá trị mặc định của
--[no]ignore_dev_dependency
: "false" -
Nếu đúng, Bazel sẽ bỏ qua phương thức "bazel_dep" và "use_extension" được khai báo là "dev_Dependencies" trong MODULE.bazel của mô-đun gốc. Lưu ý rằng các phần phụ thuộc dev đó 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
--override_module=<an equals-separated mapping of module name to path>
lần dùng được tích luỹ- Ghi đè mô-đun bằng thư mục cục bộ.
--registry=<a string>
lần dùng được tích luỹ-
Chỉ định sổ đăng ký cần sử dụng để xác định vị trí các phần phụ thuộc của mô-đun Bazel. Thứ tự này rất quan trọng: các mô-đun sẽ được tra cứu trong các sổ đăng ký trước đó trước và chỉ quay lại các sổ đăng ký sau đó nếu không có các mô-đun trước đó.
Thẻ:changes_inputs
- Các lựa chọn ảnh hưởng đến độ chi tiết, định dạng hoặc vị trí ghi nhật ký:
- Giá trị mặc định của
--[no]experimental_record_metrics_for_all_mnemonics
: "false" - Theo mặc định, số lượng loại hành động được giới hạn ở 20 bộ nhớ có số lượng hành động được thực thi lớn nhất. Việc đặt tuỳ chọn này sẽ ghi số liệu thống kê cho tất cả các bộ nhớ.
- Các tuỳ chọn chỉ định hoặc thay đổi dữ liệu đầu vào chung cho lệnh Bazel không thuộc các danh mục khác.:
- Giá trị mặc định của
--experimental_resolved_file_instead_of_workspace=<a string>
: "" -
Nếu không để trống, hãy đọc tệp đã giải quyết được chỉ định thay vì tệp WORKSPACE
Thẻ:changes_inputs
- Tuỳ chọn thực thi và lưu vào bộ nhớ đệm từ xa:
- Mặc định
--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ủ lưu trữ (cho `allow` và `block`) hoặc hai mẫu, một mẫu để so khớp và một mẫu để sử dụng làm URL thay thế, với các tham chiếu ngược bắt đầu từ `$1`. Bạn có thể cung cấp nhiều lệnh "ghi lại" cho cùng một URL và trong trường hợp này, hệ thống sẽ trả về nhiều URL.
- Các lựa chọn khác, không được phân loại theo cách khác.:
- Giá trị mặc định của
--deleted_packages=<comma-separated list of package names>
: "" - 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ẽ cho là không tồn tại, ngay cả khi chúng hiển thị ở đâu đó 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 'x' hiện có. Ví dụ: sau khi xoá x/y/BUILD trong ứng dụng khách của bạn, hệ thống xây dựng có thể sẽ khiếu nại nếu gặp nhãn '//x:y/z' nếu giá trị đó vẫn được cung cấp bởi một mục package_path khác. Việc chỉ định --Delete_packages x/y sẽ giúp tránh được sự cố này.
--override_repository=<an equals-separated mapping of repository name to path>
lần dùng được tích luỹ- Ghi đè kho lưu trữ bằng thư mục cục bộ.
- 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, trong đó có nơi tìm các gói. Các phần tử bắt đầu bằng '%workspace%' đều liên quan đến không gian làm việc bao quanh. Nếu bạn bỏ qua hoặc để trống giá trị này, giá trị mặc định sẽ là "bazel info default-package-path".
- Giá trị mặc định của
--[no]show_loading_progress
: "true" - Nếu được bật, Bazel sẽ hiện thông báo "Đang tải gói:" tin nhắn.
Tuỳ chọn Print_action
Kế thừa tất cả tuỳ chọn từ 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:
--distdir=<a path>
lần dùng được tích luỹ-
Các nơi khác để tìm kiếm các bản lưu trữ trước khi truy cập vào mạng để tải các bản lưu trữ đó xuống.
Thẻ:bazel_internal_configuration
- Giá trị mặc định của
--[no]experimental_repository_cache_hardlinks
: "false" -
Nếu được thiết lập, bộ nhớ đệm của kho lưu trữ sẽ liên kết cứng tệp trong trường hợp có lượt truy cập bộ nhớ đệm, thay vì sao chép. Thao tác này nhằm tiết kiệm dung lượng ổ đĩa.
Thẻ:bazel_internal_configuration
- Giá trị mặc định của
--[no]experimental_repository_cache_urls_as_default_canonical_id
: "false" -
Nếu đúng, hãy sử dụng một chuỗi bắt nguồn từ URL của các tệp tải xuống từ kho lưu trữ dưới dạngcanonical_id nếu không được chỉ định. Điều này khiến URL thay đổi, dẫn đến việc tải xuống lại ngay cả khi bộ nhớ đệm chứa tệp tải xuống có cùng hàm băm. Bạn có thể sử dụng quy trình này để xác minh rằng các thay đổi về URL không làm hỏng các kho lưu trữ bị bộ nhớ đệm che khuất.
Thẻ:loading_and_analysis
,experimental
- Giá trị mặc định của
--[no]experimental_repository_disable_download
: "false" -
Nếu đã đặt, bạn sẽ không được phép tải các kho lưu trữ bên ngoài xuống.
Thẻ:experimental
- Giá trị mặc định của
--experimental_repository_downloader_retries=<an integer>
: "0" -
Số lần thử tải lại lỗi xuống tối đa. Nếu bạn đặt chính sách này thành 0, hoạt động thử lại sẽ bị tắt.
Thẻ:experimental
- Giá trị mặc định của
--experimental_scale_timeouts=<a double>
: "1" -
Điều chỉnh tỷ lệ tất cả thời gian chờ trong quy tắc kho lưu trữ Starlark theo hệ số này. Bằng cách này, các kho lưu trữ bên ngoài có thể hoạt động trên các máy chậm hơn dự kiến của tác giả quy tắc mà không cần thay đổi mã nguồn
Thẻ:bazel_internal_configuration
,experimental
- Giá trị mặc định của
--http_timeout_scaling=<a double>
: "1" -
Điều chỉnh tỷ lệ tất cả thời gian chờ liên quan đến lượt tải xuống http theo hệ số cho trước
Thẻ:bazel_internal_configuration
- Mặc định
--repository_cache=<a path>
: xem nội dung mô tả -
Chỉ định vị trí bộ nhớ đệm của các giá trị được tải xuống thu được trong quá trình tìm nạp kho lưu trữ bên ngoài. Chuỗi trống dưới dạng đối số yêu cầu tắt bộ nhớ đệm.
Thẻ:bazel_internal_configuration
- Các lựa chọn ảnh hưởng đến mức độ nghiêm ngặt của Bazel trong việc thực thi dữ liệu đầu vào bản dựng hợp lệ (định nghĩa quy tắc, tổ hợp cờ, v.v.):
- Giá trị mặc định của
--experimental_repository_hash_file=<a string>
: "" -
Nếu giá trị không trống, hãy chỉ định tệp có chứa giá trị đã phân giải mà cần phải xác minh giá trị băm của thư mục kho lưu trữ
Thẻ:affects_outputs
,experimental
--experimental_verify_repository_rules=<a string>
lần dùng được tích luỹ-
Nếu danh sách các quy tắc kho lưu trữ mà hàm băm của thư mục đầu ra cần được xác minh, miễn là tệp được chỉ định bởi --experimental_repository_hash_file.
Thẻ:affects_outputs
,experimental
- Tuỳ chọn này ảnh hưởng đến ngữ nghĩa của ngôn ngữ Starlark hoặc API bản dựng có thể truy cập vào các tệp BUILD, tệp .bzl hoặc tệp WORKSPACE.:
- Giá trị mặc định của
--[no]experimental_allow_top_level_aspects_parameters
: "true" -
Không hoạt động
Thẻ:no_op
,deprecated
,experimental
- Các tuỳ chọn liên quan đến đầu ra và ngữ nghĩa Bzlmod:
--allow_yanked_versions=<a string>
lần dùng được tích luỹ-
Đã chỉ định các phiên bản mô-đun dưới dạng `<module1>@<version1>,<module2>@<version2>` sẽ được phép trong biểu đồ phần phụ thuộc đã phân giải ngay cả khi chúng được khai báo được kéo trong sổ đăng ký nơi chúng đến (nếu chúng không đến từ NonRegistryOverride). Nếu không, các phiên bản được kéo sẽ khiến quá trình phân giải bị lỗi. Bạn cũng có thể xác định phiên bản được kéo được phép bằng biến môi trường "BZLMOD_ALLOW_YANKED_VERSIONS". Bạn có thể vô hiệu hoá chế độ kiểm tra này bằng cách sử dụng từ khoá 'tất cả' (không nên dùng).
Thẻ:loading_and_analysis
- Giá trị 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" để báo cáo lỗi thành không giải quyết được, "tắt" để tắt tính năng kiểm tra hoặc "cảnh báo" để in một cảnh báo khi phát hiện thấy thông tin không khớp.
Thẻ:loading_and_analysis
- Giá trị 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 "bazel_dep" trực tiếp đượ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 đã phân giải hay không. Các giá trị hợp lệ là "off" để tắt tính năng kiểm tra, "warning" để in cảnh báo khi phát hiện thấy thông tin không khớp hoặc "error" để chuyển cảnh báo thành không giải quyết được.
Thẻ:loading_and_analysis
- Giá trị mặc định của
--[no]ignore_dev_dependency
: "false" -
Nếu đúng, Bazel sẽ bỏ qua phương thức "bazel_dep" và "use_extension" được khai báo là "dev_Dependencies" trong MODULE.bazel của mô-đun gốc. Lưu ý rằng các phần phụ thuộc dev đó 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
--override_module=<an equals-separated mapping of module name to path>
lần dùng được tích luỹ- Ghi đè mô-đun bằng thư mục cục bộ.
--registry=<a string>
lần dùng được tích luỹ-
Chỉ định sổ đăng ký cần sử dụng để xác định vị trí các phần phụ thuộc của mô-đun Bazel. Thứ tự này rất quan trọng: các mô-đun sẽ được tra cứu trong các sổ đăng ký trước đó trước và chỉ quay lại các sổ đăng ký sau đó nếu không có các mô-đun trước đó.
Thẻ:changes_inputs
- Các lựa chọn ảnh hưởng đến độ chi tiết, định dạng hoặc vị trí ghi nhật ký:
- Giá trị mặc định của
--[no]experimental_record_metrics_for_all_mnemonics
: "false" - Theo mặc định, số lượng loại hành động được giới hạn ở 20 bộ nhớ có số lượng hành động được thực thi lớn nhất. Việc đặt tuỳ chọn này sẽ ghi số liệu thống kê cho tất cả các bộ nhớ.
- Các tuỳ chọn chỉ định hoặc thay đổi dữ liệu đầu vào chung cho lệnh Bazel không thuộc các danh mục khác.:
- Giá trị mặc định của
--experimental_resolved_file_instead_of_workspace=<a string>
: "" -
Nếu không để trống, hãy đọc tệp đã giải quyết được chỉ định thay vì tệp WORKSPACE
Thẻ:changes_inputs
- Tuỳ chọn thực thi và lưu vào bộ nhớ đệm từ xa:
- Mặc định
--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ủ lưu trữ (cho `allow` và `block`) hoặc hai mẫu, một mẫu để so khớp và một mẫu để sử dụng làm URL thay thế, với các tham chiếu ngược bắt đầu từ `$1`. Bạn có thể cung cấp nhiều lệnh "ghi lại" cho cùng một URL và trong trường hợp này, hệ thống sẽ trả về nhiều URL.
- Các lựa chọn khác, không được phân loại theo cách khác.:
--override_repository=<an equals-separated mapping of repository name to path>
lần dùng được tích luỹ- Ghi đè kho lưu trữ bằng thư mục cục bộ.
--print_action_mnemonics=<a string>
lần dùng được tích luỹ- Liệt kê những bộ nhớ để lọc dữ liệu print_action theo, sẽ không có quá trình lọc nào diễn ra khi để trống.
Các lựa chọn về cụm từ tìm kiếm
- 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:
--distdir=<a path>
lần dùng được tích luỹ-
Các nơi khác để tìm kiếm các bản lưu trữ trước khi truy cập vào mạng để tải các bản lưu trữ đó xuống.
Thẻ:bazel_internal_configuration
- Giá trị mặc định của
--[no]experimental_repository_cache_hardlinks
: "false" -
Nếu được thiết lập, bộ nhớ đệm của kho lưu trữ sẽ liên kết cứng tệp trong trường hợp có lượt truy cập bộ nhớ đệm, thay vì sao chép. Thao tác này nhằm tiết kiệm dung lượng ổ đĩa.
Thẻ:bazel_internal_configuration
- Giá trị mặc định của
--[no]experimental_repository_cache_urls_as_default_canonical_id
: "false" -
Nếu đúng, hãy sử dụng một chuỗi bắt nguồn từ URL của các tệp tải xuống từ kho lưu trữ dưới dạngcanonical_id nếu không được chỉ định. Điều này khiến URL thay đổi, dẫn đến việc tải xuống lại ngay cả khi bộ nhớ đệm chứa tệp tải xuống có cùng hàm băm. Bạn có thể sử dụng quy trình này để xác minh rằng các thay đổi về URL không làm hỏng các kho lưu trữ bị bộ nhớ đệm che khuất.
Thẻ:loading_and_analysis
,experimental
- Giá trị mặc định của
--[no]experimental_repository_disable_download
: "false" -
Nếu đã đặt, bạn sẽ không được phép tải các kho lưu trữ bên ngoài xuống.
Thẻ:experimental
- Giá trị mặc định của
--experimental_repository_downloader_retries=<an integer>
: "0" -
Số lần thử tải lại lỗi xuống tối đa. Nếu bạn đặt chính sách này thành 0, hoạt động thử lại sẽ bị tắt.
Thẻ:experimental
- Giá trị mặc định của
--experimental_scale_timeouts=<a double>
: "1" -
Điều chỉnh tỷ lệ tất cả thời gian chờ trong quy tắc kho lưu trữ Starlark theo hệ số này. Bằng cách này, các kho lưu trữ bên ngoài có thể hoạt động trên các máy chậm hơn dự kiến của tác giả quy tắc mà không cần thay đổi mã nguồn
Thẻ:bazel_internal_configuration
,experimental
- Giá trị mặc định của
--http_timeout_scaling=<a double>
: "1" -
Điều chỉnh tỷ lệ tất cả thời gian chờ liên quan đến lượt tải xuống http theo hệ số cho trước
Thẻ:bazel_internal_configuration
- Mặc định
--repository_cache=<a path>
: xem nội dung mô tả -
Chỉ định vị trí bộ nhớ đệm của các giá trị được tải xuống thu được trong quá trình tìm nạp kho lưu trữ bên ngoài. Chuỗi trống dưới dạng đối số yêu cầu tắt bộ nhớ đệm.
Thẻ:bazel_internal_configuration
- Các tuỳ chọn kiểm soát việc thực thi bản dựng:
- Giá trị mặc định của
--[no]incompatible_remote_dangling_symlinks
: "true" -
Nếu bạn đặt chính sách này thành true và đặt giá trị --incompatible_remote_symlinks cũng là true, các đường liên kết tượng trưng trong dữ liệu đầu ra của hành động sẽ được phép treo.
Thẻ:execution
,incompatible_change
- Giá trị mặc định của
--[no]incompatible_remote_symlinks
: "true" -
Nếu bạn đặt chính sách này thành true, thì Bazel sẽ biểu thị các đường liên kết tượng trưng trong dữ liệu đầu ra của hành động trong giao thức lưu vào bộ nhớ đệm/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à được thể hiện dưới dạng tệp hoặc thư mục. Xem #6631 để biết chi tiết.
Thẻ:execution
,incompatible_change
--[no]keep_going
[-k
] mặc định: "false"-
Hãy tiếp tục nhiều nhất có thể sau khi gặp lỗi. Mặc dù không thể phân tích mục tiêu không thành công và những mục tiêu phụ thuộc vào nó, nhưng có thể có các điều kiện tiên quyết khác cho những mục tiêu này.
Thẻ:eagerness_to_exit
- Giá trị mặc định của
--loading_phase_threads=<an integer, or a keyword ("auto", "HOST_CPUS", "HOST_RAM"), optionally followed by an operation ([-|*]<float>) eg. "auto", "HOST_CPUS*.5">
: "tự động" -
Số lượng luồng song song để sử 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 bởi một thao tác ([-|*]<float>), ví dụ: "tự động", "HOST_CPUS*.5". "tự động" đặt giá trị mặc định hợp lý dựa trên tài nguyên máy chủ lưu trữ. Phải ít nhất là 1.
Thẻ:bazel_internal_configuration
- Các tuỳ chọn cho phép người dùng định cấu hình đầu ra dự kiến, ảnh hưởng đến giá trị của đầu ra đó, trái ngược với sự tồn tại của đầu ra đó:
- Giá trị mặc định của
--bep_maximum_open_remote_upload_files=<an integer>
: "-1" -
Số lượng tệp tối đa đang mở được cho phép trong quá trình tải cấu phần phần mềm BEP lên.
Thẻ:affects_outputs
--remote_download_minimal
-
Không tải bất kỳ kết quả của bản dựng từ xa nào xuống máy cục bộ. Cờ này là lối tắt cho các cờ: --experimental_inmemory_jdeps_files, --experimental_inmemory_dotd_files, --experimental_action_cache_store_output_metadata và --remote_download_outputs=minimal.
Mở rộng thành:
--nobuild_runfile_links
--experimental_inmemory_jdeps_files
--experimental_inmemory_dotd_files
--experimental_action_cache_store_output_metadata
--remote_download_outputs=minimal
Thẻ:affects_outputs
- Mặc định của
--remote_download_outputs=<all, minimal or toplevel>
: "tất cả" -
Nếu được đặt thành "tối thiểu" 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 các hành động cục bộ yêu cầu. Nếu được đặt thành "cấp cao nhất" hành xử như "tối thiểu" ngoại trừ việc nó cũng tải kết quả của các mục tiêu cấp cao nhất xuống máy cục bộ. Cả hai tuỳ chọn đều có thể làm giảm đáng kể thời gian xây dựng nếu băng thông mạng gây tắc nghẽn.
Thẻ:affects_outputs
- Giá trị mặc định của
--remote_download_symlink_template=<a string>
: "" -
Thay vì tải dữ liệu đầu ra 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 đích của các đường liên kết tượng trưng dưới dạng chuỗi mẫu. Chuỗi mẫu này có thể chứa {hash} và {size_bytes} lần lượt mở rộng thành hàm băm của đối tượng và kích thước tính bằng byte. Ví dụ: những đườ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 đầ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à lối tắt cho các cờ: --experimental_inmemory_jdeps_files, --experimental_inmemory_dotd_files, --experimental_action_cache_store_output_metadata và --remote_download_outputs=toplevel.
Mở rộng thành:
--experimental_inmemory_jdeps_files
--experimental_inmemory_dotd_files
--experimental_action_cache_store_output_metadata
--remote_download_outputs=toplevel
Thẻ:affects_outputs
- Các lựa chọn ảnh hưởng đến mức độ nghiêm ngặt của Bazel trong việc thực thi dữ liệu đầu vào bản dựng hợp lệ (định nghĩa quy tắc, tổ hợp cờ, v.v.):
- Giá trị mặc định của
--experimental_repository_hash_file=<a string>
: "" -
Nếu giá trị không trống, hãy chỉ định tệp có chứa giá trị đã phân giải mà cần phải xác minh giá trị băm của thư mục kho lưu trữ
Thẻ:affects_outputs
,experimental
--experimental_verify_repository_rules=<a string>
lần dùng được tích luỹ-
Nếu danh sách các quy tắc kho lưu trữ mà hàm băm của thư mục đầu ra cần được xác minh, miễn là tệp được chỉ định bởi --experimental_repository_hash_file.
Thẻ:affects_outputs
,experimental
- Tuỳ chọn này ảnh hưởng đến ngữ nghĩa của ngôn ngữ Starlark hoặc API bản dựng có thể truy cập vào các tệp BUILD, tệp .bzl hoặc tệp WORKSPACE.:
- Giá trị mặc định của
--[no]experimental_allow_top_level_aspects_parameters
: "true" -
Không hoạt động
Thẻ:no_op
,deprecated
,experimental
- Giá trị mặc định của
--[no]incompatible_config_setting_private_default_visibility
: "false" -
Nếu không tương thích_enforce_config_setting_ visibility=false, thì đây là lỗi không hiển thị. Ngược lại, nếu cờ này là false, mọi chế độ cài đặt config_setting không có thuộc tính mức độ hiển thị rõ ràng sẽ là //visibility:public. Nếu cờ này là true, chế độ cài đặt config_setting sẽ tuân theo cùng một logic về chế độ hiển thị như mọi quy tắc khác. Truy cập https://github.com/bazelbuild/bazel/issues/12933.
Thẻ:loading_and_analysis
,incompatible_change
- Giá trị mặc định của
--[no]incompatible_enforce_config_setting_visibility
: "true" -
Nếu là true, hãy thực thi các quy định hạn chế về chế độ hiển thị bằng lệnh config_setting. Nếu đặt là false, mọi chế độ cài đặt config_ đều hiển thị với mọi mục tiêu. Truy cập https://github.com/bazelbuild/bazel/issues/12932.
Thẻ:loading_and_analysis
,incompatible_change
- Các tuỳ chọn liên quan đến đầu ra của truy vấn và ngữ nghĩa:
- 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à một trong {xml,proto,record}. "off" có nghĩa là không có phần phụ thuộc khung hình nào được giải quyết, "thận trọng" (mặc định) có nghĩa là tất cả phần phụ thuộc khía cạnh đã khai báo đều được thêm vào bất kể chúng có được cung cấp lớp quy tắc của phần phụ thuộc trực tiếp hay không, "chính xác" có nghĩa là chỉ những khía cạnh đó được thêm vào mà 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. Xin lưu ý rằng chế độ chính xác yêu cầu tải các gói khác để đánh giá một mục tiêu. Do đó, mục tiêu này sẽ chậm hơn so với các chế độ khác. Ngoài ra, xin lưu ý rằng ngay cả chế độ chính xác cũng không hoàn toàn chính xác: việc quyết định có tính toán một khía cạnh hay không được quyết định trong giai đoạn phân tích, giai đoạn này không chạy trong quá trình "truy vấn bazel".
Thẻ:build_file_semantics
- Giá trị mặc định của
--[no]experimental_graphless_query
: "tự động" -
Nếu đúng, hãy sử dụng phương thức triển khai Truy vấn mà không tạo bản sao của biểu đồ. Cách triển khai mới chỉ hỗ trợ --order_output=no, cũng như chỉ một tập hợp con các bộ định dạng đầu ra.
Thẻ:build_file_semantics
,eagerness_to_exit
- Giá trị 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ần hiển thị. -1 có nghĩa là không cắt bớt và 0 có nghĩa là không có chú giải. Tuỳ chọn này chỉ áp dụng cho --output=graph.
Thẻ:terminal_output
- Giá trị mặc định của
--[no]graph:factored
: "true" -
Nếu đúng, thì biểu đồ sẽ được tạo ra "được tạo thành thừa số", tức là các nút tương đương về cấu trúc liên kết sẽ được hợp nhất với nhau và nhãn của chúng sẽ được nối với nhau. Tuỳ chọn này chỉ áp dụng cho --output=graph.
Thẻ:terminal_output
- Giá trị 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 dữ liệu đầu ra. 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=graph.
Thẻ:terminal_output
- Giá trị mặc định của
--[no]implicit_deps
: "true" -
Nếu được bật, các phần phụ thuộc ngầm ẩ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ằng 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ụ đã phân giải.
Thẻ:build_file_semantics
- Giá trị mặc định của
--[no]include_aspects
: "true" -
aquery, cquery: liệu có bao gồm các hành động được tạo theo khía cạnh trong kết quả hay không. query: no-op (luôn đi theo các khía cạnh).
Thẻ:terminal_output
- Giá trị mặc định của
--[no]incompatible_display_source_file_location
: "true" -
"True" theo mặc định sẽ hiển thị mục tiêu của tệp nguồn. Nếu đúng, hiển thị vị trí dòng 1 của tệp nguồn trong dữ liệu đầu ra vị trí. Cờ này chỉ dành cho mục đích di chuyển.
Thẻ:terminal_output
,incompatible_change
- Giá trị mặc định của
--[no]incompatible_lexicographical_output
: "true" -
Nếu bạn đặt tuỳ chọn này, sắp xếp --order_output=tự động xuất ra theo thứ tự từ điển học.
Thẻ:terminal_output
,incompatible_change
- Giá trị mặc định của
--[no]incompatible_package_group_includes_double_slash
: "true" -
Nếu được bật, khi xuất thuộc tính "packages" của package_group, phần tử "//" ở đầu sẽ không bị bỏ qua.
Thẻ:terminal_output
,incompatible_change
- Giá trị mặc định của
--[no]infer_universe_scope
: "false" -
Nếu bạn không đặt giá trị đặt và --universe_scope thì giá trị của --universe_scope sẽ được suy ra dưới dạng danh sách các mẫu mục tiêu riêng biệ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 vũ trụ (ví dụ:`allrdeps`) có thể không phải là giá trị bạn muốn. Vì vậy, bạn chỉ nên sử dụng tuỳ chọn này nếu biết mình đang làm gì. Hãy 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 ý: tuỳ chọn này chỉ áp dụng cho "query" (nghĩa là không áp dụng cho "cquery").
Thẻ:loading_and_analysis
- Giá trị mặc định của
--[no]line_terminator_null
: "false" -
Liệu mỗi định dạng có bị chấm dứt bằng \0 thay vì dòng mới hay không.
Thẻ:terminal_output
- Giá trị mặc định của
--[no]nodep_deps
: "true" -
Nếu được bật, phần phụ thuộc từ "nodep" sẽ được đưa vào biểu đồ phần phụ thuộc mà qua đó truy vấn hoạt động. Một ví dụ phổ biến về "nút" 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ả "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 kiểu không theo thứ tự. Đầu ra không theo thứ tự sẽ nhanh hơn nhưng chỉ được hỗ trợ khi --output không phải là minrank, maxrank hoặc graph.
Mở rộng thành:
--order_output=no
Thẻ:terminal_output
--null
-
Liệu mỗi định dạng có bị chấm dứt bằng \0 thay vì dòng mới hay không.
Mở rộng thành:
--line_terminator_null=true
Thẻ:terminal_output
- Giá trị mặc định của
--order_output=<no, deps, auto or full>
: "tự động" -
Cho ra kết quả theo thứ tự không theo thứ tự (không), theo thứ tự phần phụ thuộc (deps) hoặc được sắp xếp đầy đủ (đầy đủ). Giá trị mặc định là "auto", nghĩa là kết quả được sắp xếp theo thứ tự phần phụ thuộc hoặc được sắp xếp đầy đủ, tuỳ thuộc vào trình định dạng đầu ra (có thứ tự phần phụ thuộc cho proto, minrank, maxrank và đồ thị, được sắp xếp đầy đủ cho tất cả các thứ tự khác). Khi đầu ra được sắp xếp đầy đủ, các nút được in theo thứ tự (tổng số) hoàn toàn tất định. 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 theo chiều sâu theo thứ tự sau, trong đó các cạnh đi tới các nút chưa truy cập được truyền tải theo thứ tự bảng chữ cái của các nút kế tiếp. Cuối cùng, các nút được in theo thứ tự ngược với thứ tự mà các nút đó được truy cập.
Thẻ:terminal_output
--order_results
-
Xuất kết quả theo thứ tự phần phụ thuộc (mặc định) hoặc kiểu không theo thứ tự. Đầu ra không theo thứ tự sẽ nhanh hơn nhưng chỉ được hỗ trợ khi --output không phải là minrank, maxrank hoặc graph.
Mở rộng thành:
--order_output=auto
Thẻ:terminal_output
- Giá trị mặc định của
--output=<a string>
: "label" -
Định dạng mà kết quả truy vấn sẽ được in. Các giá trị được phép cho truy vấn là: build, graph, label, label_ kind, location, maxrank, minrank, package, proto, xml.
Thẻ:terminal_output
- Giá trị mặc định của
--[no]proto:default_values
: "true" -
Nếu đúng, các thuộc tính có giá trị không được chỉ định rõ ràng trong tệp BUILD sẽ được đưa vào; nếu không thì chúng sẽ bị bỏ qua. Tuỳ chọn này có thể áp dụng cho --output=proto
Thẻ:terminal_output
- Giá trị mặc định của
--[no]proto:definition_stack
: "false" -
Điền vào trường proto Definition_stack sẽ ghi lại từng thực thể quy tắc của ngăn xếp lệnh gọi Starlark tại thời điểm xác định lớp của quy tắc.
Thẻ:terminal_output
- Giá trị mặc định của
--[no]proto:flatten_selects
: "true" -
Nếu bạn bật tuỳ chọn này, các thuộc tính có thể định cấu hình do Select() tạo sẽ được làm phẳng. Đối với các loại danh sách, bản trình bày đã làm phẳng là danh sách chứa chính xác mỗi giá trị của tệp ánh xạ được chọn 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
- Giá trị mặc định của
--[no]proto:include_synthetic_attribute_hash
: "false" -
Liệu có tính toán và điền thuộc tính $internal_attr_hash hay không.
Thẻ:terminal_output
- Giá trị mặc định của
--[no]proto:instantiation_stack
: "false" -
Điền ngăn xếp lệnh gọi tạo thực thể của từng quy tắc. Lưu ý rằng thao tác này đòi hỏi phải có ngăn xếp
Thẻ:terminal_output
- Giá trị mặc định của
--[no]proto:locations
: "true" -
Liệu có xuất thông tin vị trí trong đầu ra proto hay không.
Thẻ:terminal_output
- Mặc định của
--proto:output_rule_attrs=<comma-separated list of options>
: "tất cả" -
Danh sách thuộc tính được phân tách bằng dấu phẩy để đưa vào dữ liệu đầu ra. Giá trị mặc định là tất cả thuộc tính. Bạn phải đặt thành chuỗi trống để không xuất thuộc tính nào. Tuỳ chọn này có thể áp dụng cho --output=proto.
Thẻ:terminal_output
- Giá trị mặc định của
--[no]proto:rule_inputs_and_outputs
: "true" -
Liệu có điền sẵn các trường rules_input và rules_output hay không.
Thẻ:terminal_output
- Giá trị mặc định của
--query_file=<a string>
: "" -
Nếu được đặt, truy vấn sẽ đọc truy vấn từ tệp có tên tại đây, thay vì trên dòng lệnh. Sẽ xảy ra lỗi khi chỉ định một tệp tại đây cũng như một truy vấn dòng lệnh.
Thẻ:changes_inputs
- Giá trị mặc định của
--[no]relative_locations
: "false" -
Nếu đúng, vị trí của các tệp BUILD trong đầu ra xml và proto sẽ là tương đối. Theo mặc định, kết quả vị trí là một đường dẫn tuyệt đối và sẽ không nhất quán giữa các máy. Bạn có thể đặt tuỳ chọn này thành true để nhận được kết quả nhất quán trên các máy.
Thẻ:terminal_output
- Giá trị mặc định của
--[no]strict_test_suite
: "false" -
Nếu đúng, biểu thức test() sẽ báo lỗi nếu gặp phải test_suite chứa các mục tiêu không phải là test (không phải kiểm thử).
Thẻ:build_file_semantics
,eagerness_to_exit
- Giá trị mặc định của
--[no]tool_deps
: "true" -
Truy vấn: Nếu bị tắt, các phần phụ thuộc trên "cấu hình máy chủ" hoặc "thực thi" sẽ không được đưa vào biểu đồ phụ thuộc mà qua đó truy vấn hoạt động. "Cấu hình máy chủ lưu trữ" cạnh phụ thuộc, chẳng hạn như cạnh phụ thuộc từ bất kỳ "proto_library" nào cho 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 'mục tiêu' .
Cquery: Nếu bị tắt, hãy lọc tất cả các mục tiêu đã định cấu hình vượt qua quá trình chuyển đổi lưu trữ hoặc thực thi khỏi 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ũng 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 máy chủ lưu trữ, thì chỉ các mục tiêu đã định cấu hình của máy chủ lưu trữ mới được trả về. Tuỳ chọn này sẽ KHÔNG loại trừ chuỗi công cụ đã phân giải.
Thẻ:build_file_semantics
- Giá trị 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 đóng bắc cầu của các mục tiêu được chỉ định. Tuỳ chọn này được dùng cho các lệnh truy vấn và cquery.
Đối với cquery, đầu vào cho tuỳ chọn này là mục tiêu mà tất cả các câu trả lời đều được xây dựng, do đó, tuỳ chọn này có thể ảnh hưởng đến cấu hình và hiệu ứng chuyển đổi. Nếu bạn không chỉ định tùy chọn này, thì các mục tiêu cấp cao nhất được coi 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ị lỗi nếu không thể tạo các mục tiêu được phân tích cú pháp từ biểu thức truy vấn bằng các tuỳ chọn cấp cao nhất.
Thẻ:loading_and_analysis
- Giá trị mặc định của
--[no]xml:default_values
: "false" -
Nếu đúng, các thuộc tính quy tắc có giá trị không được chỉ định rõ ràng trong tệp BUILD sẽ được in; nếu không thì chúng sẽ bị bỏ qua.
Thẻ:terminal_output
- Giá trị mặc định của
--[no]xml:line_numbers
: "true" -
Nếu đúng, dữ liệu đầu ra XML sẽ chứa số dòng. Khi bạn tắt tuỳ chọn này, các thông tin khác biệt có thể dễ đọc hơn. Tuỳ chọn này chỉ áp dụng cho --output=xml.
Thẻ:terminal_output
- Các lựa chọn liên quan đến đầu ra và ngữ nghĩa Bzlmod:
--allow_yanked_versions=<a string>
lần dùng được tích luỹ-
Đã chỉ định các phiên bản mô-đun dưới dạng `<module1>@<version1>,<module2>@<version2>` sẽ được phép trong biểu đồ phần phụ thuộc đã phân giải ngay cả khi chúng được khai báo được kéo trong sổ đăng ký nơi chúng đến (nếu chúng không đến từ NonRegistryOverride). Nếu không, các phiên bản được kéo sẽ khiến quá trình phân giải bị lỗi. Bạn cũng có thể xác định phiên bản được kéo được phép bằng biến môi trường "BZLMOD_ALLOW_YANKED_VERSIONS". Bạn có thể vô hiệu hoá chế độ kiểm tra này bằng cách sử dụng từ khoá 'tất cả' (không nên dùng).
Thẻ:loading_and_analysis
- Giá trị 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" để báo cáo lỗi thành không giải quyết được, "tắt" để tắt tính năng kiểm tra hoặc "cảnh báo" để in một cảnh báo khi phát hiện thấy thông tin không khớp.
Thẻ:loading_and_analysis
- Giá trị 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 "bazel_dep" trực tiếp đượ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 đã phân giải hay không. Các giá trị hợp lệ là "off" để tắt tính năng kiểm tra, "warning" để in cảnh báo khi phát hiện thấy thông tin không khớp hoặc "error" để chuyển cảnh báo thành không giải quyết được.
Thẻ:loading_and_analysis
- Giá trị mặc định của
--[no]ignore_dev_dependency
: "false" -
Nếu đúng, Bazel sẽ bỏ qua phương thức "bazel_dep" và "use_extension" được khai báo là "dev_Dependencies" trong MODULE.bazel của mô-đun gốc. Lưu ý rằng các phần phụ thuộc dev đó 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
--override_module=<an equals-separated mapping of module name to path>
lần dùng được tích luỹ- Ghi đè mô-đun bằng thư mục cục bộ.
--registry=<a string>
lần dùng được tích luỹ-
Chỉ định sổ đăng ký cần sử dụng để xác định vị trí các phần phụ thuộc của mô-đun Bazel. Thứ tự này rất quan trọng: các mô-đun sẽ được tra cứu trong các sổ đăng ký trước đó trước và chỉ quay lại các sổ đăng ký sau đó nếu không có các mô-đun trước đó.
Thẻ:changes_inputs
- Các lựa chọn ảnh hưởng đến độ chi tiết, định dạng hoặc vị trí ghi nhật ký:
- Giá trị mặc định của
--[no]experimental_record_metrics_for_all_mnemonics
: "false" - Theo mặc định, số lượng loại hành động được giới hạn ở 20 bộ nhớ có số lượng hành động được thực thi lớn nhất. Việc đặt tuỳ chọn này sẽ ghi số liệu thống kê cho tất cả các bộ nhớ.
- Giá trị mặc định của
--experimental_repository_resolved_file=<a string>
: "" -
Nếu giá trị không trống, hãy viết một giá trị Starlark cùng với thông tin đã phân giải của tất cả các quy tắc kho lưu trữ Starlark đã được thực thi.
Thẻ:affects_outputs
- Giá trị mặc định của
--remote_print_execution_messages=<failure, success or all>
: "không thành công" -
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", chỉ in khi không thành công, "thành công" chỉ in khi thành công và "all" sẽ luôn in.
Thẻ:terminal_output
- Các tuỳ chọn chỉ định hoặc thay đổi dữ liệu đầu vào chung cho lệnh Bazel không thuộc các danh mục khác.:
- Giá trị mặc định của
--experimental_resolved_file_instead_of_workspace=<a string>
: "" -
Nếu không để trống, hãy đọc tệp đã giải quyết được chỉ định thay vì tệp WORKSPACE
Thẻ:changes_inputs
- Tuỳ chọn thực thi và lưu vào bộ nhớ đệm từ xa:
- Mặc định
--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ủ lưu trữ (cho `allow` và `block`) hoặc hai mẫu, một mẫu để so khớp và một mẫu để sử dụng làm URL thay thế, với các tham chiếu ngược bắt đầu từ `$1`. Bạn có thể cung cấp nhiều lệnh "ghi lại" cho cùng một URL và trong trường hợp này, hệ thống sẽ trả về nhiều URL.
- Giá trị mặc định của
--[no]experimental_guard_against_concurrent_changes
: "false" - Tắt tuỳ chọn này để tắt tính năng kiểm tra thời gian đối với tệp nhập của một hành động trước khi tải lên bộ nhớ đệm từ xa. Trong một số trường hợp, nhân hệ điều hành Linux có thể trì hoãn việc ghi tệp, từ đó dẫn đến dương tính giả.
- Mặc định của
--experimental_remote_build_event_upload=<all or minimal>
: "tất cả" - Nếu bạn đặt chính sách này thành "all", thì mọi dữ liệu đầu ra cục bộ được tham chiếu bởi BEP sẽ được tải lên bộ nhớ đệm từ xa. Nếu bạn đặt chính sách này thành "tối thiểu", thì các dữ liệu đầu ra cục bộ được tham chiếu bởi BEP 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 sử dụng BEP (ví dụ: nhật ký kiểm thử và hồ sơ thời gian). Lược đồ bytestream:// luôn được dùng cho URI của các tệp ngay cả khi chúng bị thiếu trong bộ nhớ đệm từ xa. Giá trị mặc định là "tất cả".
- Giá trị mặc định của
--[no]experimental_remote_cache_async
: "false" - Nếu đúng, I/O bộ nhớ đệm từ xa sẽ diễn ra trong nền thay vì diễn ra như một phần của quá trình sinh sản.
- Giá trị mặc định của
--[no]experimental_remote_cache_compression
: "false" - Nếu được bật, hãy nén/giải nén các blob bộ nhớ đệm bằng zstd.
- Mặc định
--experimental_remote_capture_corrupted_outputs=<a path>
: xem nội dung mô tả - Đường dẫn đến thư mục nơi các dữ liệu đầu ra bị lỗi sẽ được ghi vào.
- Giá trị 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, thì hệ thống sẽ loại bỏ các bản sao trong bộ nhớ của cây Merkle của gốc đầu vào và các bản đồ ánh xạ đầu vào được liên kết trong các lệnh gọi đến GetActionResult() và Execute(). Điều này làm giảm đáng kể mức sử dụng bộ nhớ, nhưng Bazel phải tính toán lại các dữ liệu này khi bộ nhớ đệm từ xa bị thiếu và thử lại.
- Mặc định
--experimental_remote_downloader=<a string>
: xem nội dung mô tả - URI điểm cuối của Remote Asset API, được 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ắm UNIX cục bộ). Nếu không cung cấp giản đồ, Bazel sẽ đặt mặc định thành grpcs. Hãy tham khảo: https://github.com/bazelbuild/remote-apis/blob/master/build/bazel/remote/asset/v1/remote_asset.proto
- Giá trị mặc định của
--[no]experimental_remote_downloader_local_fallback
: "false" - Liệu có quay lại trình tải xuống cục bộ nếu trình tải xuống từ xa không thành công hay không.
- Giá trị mặc định của
--[no]experimental_remote_execution_keepalive
: "false" - Liệu có sử dụng tính năng giữ nguyên hoạt động cho các lệnh gọi thực thi từ xa hay không.
- Mặc định
--experimental_remote_grpc_log=<a path>
: xem nội dung mô tả - Nếu được chỉ định, một đườ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 các protobuf com.google.devtools.build.lib.remote.logging.RemoteExecutionLog.LogEntry được chuyển đổi tuần tự với mỗi thông điệp có tiền tố là một varint biểu thị kích thước của thông điệp protobuf được tuần tự hoá sau đây, được thực hiện bằng phương thức LogEntry.writeDelimitedTo(OutputStream).
- Giá trị 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, thì Bazel sẽ đánh dấu các dữ liệu đầu vào là đầu vào công cụ cho bộ thực thi từ xa. Bạn có thể dùng tính năng này để triển khai trình thực thi cố định từ xa.
- Giá trị 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 (đúng), các phép tính của cây Merkle sẽ được ghi nhớ để cải thiện tốc độ kiểm tra lượt truy cập trong 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_merkle_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 Merkle cần ghi nhớ để cải thiện tốc độ kiểm tra lượt truy cập vào bộ nhớ đệm từ xa. Mặc dù bộ nhớ đệm sẽ tự động bị cắt bớt theo cách xử lý tham chiếu mềm của Java, nhưng lỗi hết bộ nhớ vẫn có thể xảy ra nếu bộ nhớ được đặt quá cao. Nếu bạn đặt chính sách này thành 0, thì kích thước bộ nhớ đệm sẽ không bị 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.
- Giá trị mặc định của
--[no]incompatible_remote_build_event_upload_respect_no_cache
: "false" - Nếu bạn đặt chính sách này thành true, thì các dữ liệu đầu ra được BEP tham chiếu sẽ không được tải lên bộ nhớ đệm từ xa nếu thao tác tạo không thể lưu vào bộ nhớ đệm từ xa.
- Giá trị mặc định của
--[no]incompatible_remote_downloader_send_all_headers
: "true" -
Liệu có gửi tất cả các giá trị của một tiêu đề có nhiều giá trị tới trình tải xuống từ xa thay vì chỉ gửi giá trị đầu tiên hay không.
Thẻ:incompatible_change
- Giá trị mặc định của
--[no]incompatible_remote_output_paths_relative_to_input_root
: "false" -
Nếu bạn đặt chính sách này thành true, thì các đường dẫn đầu ra sẽ tương ứng với thư mục gốc đầu vào thay vì thư mục đang hoạt động.
Thẻ:incompatible_change
- Giá trị mặc định của
--[no]incompatible_remote_results_ignore_disk
: "true" -
Nếu bạn đặt chính sách này thành true, thì --noremote_upload_local_results và --noremote_accept_cached sẽ không áp dụng cho bộ nhớ đệm của ổ đĩa. Nếu sử dụng bộ nhớ đệm kết hợp:
--noremote_upload_local_results sẽ làm cho kết quả được ghi vào bộ nhớ đệm của ổ đĩa nhưng không được tải lên bộ nhớ đệm từ xa.
--noremote_accept_cached sẽ dẫn đến việc Bazel kiểm tra các kết quả trong bộ nhớ đệm của ổ đĩa, chứ không phải trong bộ nhớ đệm từ xa.
no-remote-exec có thể ảnh hưởng đến bộ nhớ đệm của ổ đĩa.
Xem #8216 để biết chi tiết.
Thẻ:incompatible_change
- Giá trị mặc định của
--[no]incompatible_remote_use_new_exit_code_for_lost_inputs
: "false" -
Nếu được đặt thành true, Bazel sẽ sử dụng mã thoát mới 39 thay vì 34 nếu bộ nhớ đệm từ xa loại bỏ các blob trong quá trình tạo.
Thẻ:incompatible_change
- Giá trị mặc định của
--[no]remote_accept_cached
: "true" - Liệu có chấp nhận kết quả hành động được lưu vào bộ nhớ đệm từ xa hay không.
- Mặc định
--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 luồng sự kiện tạo bản dựng. Bạn có thể đặt tuỳ chọn này khi tạo các bản dựng bằng proxy. Việc 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ị mặc định sẽ là "${hostname}/${instance_name}".
- Mặc định
--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ắm UNIX cục bộ). Nếu không cung cấp giản đồ, Bazel sẽ đặt mặc định thành grpcs. Hãy chỉ định lược đồ grpc://, http:// hoặc unix: để vô hiệu hoá TLS. Hãy truy cập vào https://bazel.build/remote/caching
--remote_cache_header=<a 'name=value' assignment>
lần dùng được tích luỹ- Chỉ định tiêu đề sẽ có trong các yêu cầu bộ nhớ đệm: --remote_cache_header=Name=Value. Có thể truyền nhiều tiêu đề bằng cách chỉ định cờ nhiều lần. Nhiều giá trị cho cùng một tên sẽ được chuyển đổi thành danh sách được phân tách bằng dấu phẩy.
--remote_default_exec_properties=<a 'name=value' assignment>
lần dùng được tích luỹ-
Đặt các 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
- Giá trị mặc định của
--remote_default_platform_properties=<a string>
: "" - Đặt các thuộc tính nền tảng mặc định thành thiết lập cho API thực thi từ xa, nếu nền tảng thực thi chưa đặt Remote_execution_properties. Giá trị này cũng sẽ được dùng nếu nền tảng lưu trữ được chọn làm nền tảng thực thi để thực thi từ xa.
--remote_downloader_header=<a 'name=value' assignment>
lần dùng được tích luỹ- Chỉ định tiêu đề sẽ được đưa vào trong các yêu cầu của trình tải xuống từ xa: --remote_downloader_header=Name=Value. Có thể truyền nhiều tiêu đề bằng cách chỉ định cờ nhiều lần. Nhiều giá trị cho cùng một tên sẽ được chuyển đổi thành danh sách được phân tách bằng dấu phẩy.
--remote_exec_header=<a 'name=value' assignment>
lần dùng được tích luỹ- Chỉ định tiêu đề sẽ được đưa vào trong các yêu cầu thực thi: --remote_exec_header=Name=Value. Có thể truyền nhiều tiêu đề bằng cách chỉ định cờ nhiều lần. Nhiều giá trị cho cùng một tên sẽ được chuyển đổi thành danh sách được phân tách bằng dấu phẩy.
- Giá trị mặc định của
--remote_execution_priority=<an integer>
: "0" - Mức độ ưu tiên tương đối của các thao tác cần được thực thi từ xa. Ngữ nghĩa của các giá trị ưu tiên cụ thể phụ thuộc vào máy chủ.
- Mặc định
--remote_executor=<a string>
: xem nội dung mô tả - HOST hoặc HOST:PORT của một điểm cuối thực thi từ xa. Các giản đồ được hỗ trợ là grpc, grpcs (grpc có bật TLS) và unix (ổ cắm UNIX cục bộ). Nếu không cung cấp giản đồ, Bazel sẽ đặt mặc định thành grpcs. Chỉ định grpc:// hoặc unix: giản đồ để vô hiệu hoá TLS.
--remote_header=<a 'name=value' assignment>
lần dùng được tích luỹ- Chỉ định tiêu đề sẽ được đưa vào trong yêu cầu: --remote_header=Name=Value. Có thể truyền nhiều tiêu đề bằng cách chỉ định cờ nhiều lần. Nhiều giá trị cho cùng một tên sẽ được chuyển đổi thành danh sách được phân tách bằng dấu phẩy.
- Giá trị mặc định của
--remote_instance_name=<a string>
: "" - Giá trị cần truyền dưới dạnginstance_name trong API thực thi từ xa.
- Giá trị mặc định của
--[no]remote_local_fallback
: "false" - Liệu có quay lại sử dụng chiến lược thực thi cục bộ độc lập trong trường hợp thực thi từ xa không thành công hay không.
- Giá trị mặc định của
--remote_local_fallback_strategy=<a string>
: "cục bộ" - Không hoạt động, không dùng nữa. Hãy truy cập vào https://github.com/bazelbuild/bazel/issues/7480 để biết thông tin chi tiết.
- Mặc định của
--remote_max_connections=<an integer>
: "100" -
Giới hạn số lượng kết nối đồng thời tối đa đối với bộ nhớ đệm/trình thực thi từ xa. Theo mặc định, giá trị là 100. Việc đặt giá trị này thành 0 có nghĩa là không bị giới hạn.
Đối với bộ nhớ đệm từ xa HTTP, một kết nối TCP có thể xử lý từng 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, vì vậy, Bazel có thể thực hiện xung quanh các yêu cầu đồng thời "--remote_max_connections * 100".
Thẻ:host_machine_resource_optimizations
- Mặc định
--remote_proxy=<a string>
: xem nội dung mô tả - Kết nối với bộ nhớ đệm từ xa thông qua proxy. Hiện tại, bạn chỉ có thể sử dụng cờ này để định cấu hình cổng miền Unix (unix:/path/to/socket).
- Giá trị 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 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ủ.
- Giá trị 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, hoạt động thử lại sẽ bị tắt.
- Giá trị 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à các lệnh gọi vào bộ nhớ đệm. Đối với bộ nhớ đệm REST, đây là cả thời gian chờ kết nối và thời gian chờ đọc. Bạn có thể sử dụng các đơn vị sau: Ngày (d), giờ (h), phút (m), giây (s) và mili giây (mili giây). Nếu bạn bỏ qua đơn vị, thì giá trị được hiểu là giây.
- Giá trị mặc định của
--[no]remote_upload_local_results
: "true" - Liệu có tải các kết quả hành động được thực thi cục bộ lên bộ nhớ đệm từ xa hay không nếu bộ nhớ đệm từ xa hỗ trợ và người dùng được phép thực hiện việc đó.
- Giá trị mặc định của
--[no]remote_verify_downloads
: "true" - Nếu bạn đặt chính sách này thành true, thì Bazel sẽ tính toán tổng băm của tất cả các tệp tải xuống từ xa và loại bỏ các giá trị được lưu vào bộ nhớ đệm từ xa nếu các giá trị đó không khớp với giá trị dự kiến.
- Các lựa chọn khác, không được phân loại theo cách khác.:
- Giá trị mặc định của
--deleted_packages=<comma-separated list of package names>
: "" - 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ẽ cho là không tồn tại, ngay cả khi chúng hiển thị ở đâu đó 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 'x' hiện có. Ví dụ: sau khi xoá x/y/BUILD trong ứng dụng khách của bạn, hệ thống xây dựng có thể sẽ khiếu nại nếu gặp nhãn '//x:y/z' nếu giá trị đó vẫn được cung cấp bởi một mục package_path khác. Việc chỉ định --Delete_packages x/y sẽ giúp tránh được sự cố này.
- Mặc định
--disk_cache=<a path>
: xem nội dung mô tả - Một đường dẫn đến một thư mục mà Bazel có thể đọc và ghi các thao tác cũng như kết quả đầu ra của hành động. Nếu không có, thư mục sẽ được tạo.
--experimental_credential_helper=<An (unresolved) path to a credential helper for a scope.>
lần dùng được tích luỹ- Định cấu hình Trình trợ giúp thông tin xác thực dùng cho việc truy xuất thông tin xác thực cho phạm vi đã cung cấp (miền). Thông tin xác thực của Trình trợ giúp thông tin xác thực được ưu tiên hơn thông tin xác thực trên <code>--google_default_credentials</code>, "--google_credentials" hoặc <code>.netrc</code>. Hãy truy cập vào https://github.com/bazelbuild/suggesteds/blob/main/designs/2022-06-07-bazel-credential-helpers.md để biết chi tiết.
- Giá trị mặc định của
--experimental_credential_helper_cache_duration=<An immutable length of time.>
: "30 phút" - Định cấu hình khoảng thời gian lưu thông tin xác thực từ Trình trợ giúp thông tin xác thực. 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 đó; truyền 0 để xoá bộ nhớ đệm. Lệnh sạch luôn xoá bộ nhớ đệm, bất kể cờ này là gì.
- Mặc định của
--experimental_credential_helper_timeout=<An immutable length of time.>
: "5 giây" - Định cấu hình thời gian chờ cho Trình trợ giúp thông tin xác thực. 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 sẽ không thực hiện được lệnh gọi.
- Mặc định của
--google_auth_scopes=<comma-separated list of options>
: "https://www.googleapis.com/auth/cloud-platform" - Danh sách phạm vi xác thực được phân tách bằng dấu phẩy trên Google Cloud.
- Mặc định
--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/authentication để biết thông tin chi tiết.
- Giá trị mặc định của
--[no]google_default_credentials
: "false" - Có sử dụng 'Thông tin xác thực mặc định của ứng dụng trên Google' không để xác thực. Hãy truy cập vào https://cloud.google.com/docs/authentication để biết thông tin chi tiết. Tắt theo mặc định.
- Mặc định
--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, thì Bazel sẽ gửi ping sau khoảng thời gian không đọc hoạt động 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; thì xảy ra lỗi khi đặt giá trị nhỏ hơn một giây. Theo mặc định, các ping giữ kết nối sẽ bị tắt. Bạn nên phối hợp với chủ sở hữu dịch vụ trước khi bật 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
- Giá trị 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 giữ 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 phản hồi ping sau khoảng thời gian này. Thời gian được coi là độ chi tiết thứ hai; thì xảy ra lỗi khi đặt giá trị nhỏ hơn một giây. Nếu ping duy trì hoạt động bị tắt, thì chế độ cài đặt này sẽ bị bỏ qua.
--override_repository=<an equals-separated mapping of repository name to path>
lần dùng được tích luỹ- Ghi đè kho lưu trữ bằng thư mục cục bộ.
- 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, trong đó có nơi tìm các gói. Các phần tử bắt đầu bằng '%workspace%' đều liên quan đến không gian làm việc bao quanh. Nếu bạn bỏ qua hoặc để trống giá trị này, giá trị mặc định sẽ là "bazel info default-package-path".
- Giá trị mặc định của
--[no]show_loading_progress
: "true" - Nếu được bật, Bazel sẽ hiện thông báo "Đang tải gói:" tin nhắn.
- Mặc định
--tls_certificate=<a string>
: xem nội dung mô tả - Chỉ định một đường dẫn đến chứng chỉ TLS được tin cậy để ký chứng chỉ máy chủ.
- Mặc định
--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á ứng dụng khách để bật tính năng xác thực ứng dụng.
- Mặc định
--tls_client_key=<a string>
: xem nội dung mô tả - Chỉ định khoá ứng dụng 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 ứng dụng khách.
Các tuỳ chọn chạy
Kế thừa tất cả tuỳ chọn từ 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:
--distdir=<a path>
lần dùng được tích luỹ-
Các nơi khác để tìm kiếm các bản lưu trữ trước khi truy cập vào mạng để tải các bản lưu trữ đó xuống.
Thẻ:bazel_internal_configuration
- Giá trị mặc định của
--[no]experimental_repository_cache_hardlinks
: "false" -
Nếu được thiết lập, bộ nhớ đệm của kho lưu trữ sẽ liên kết cứng tệp trong trường hợp có lượt truy cập bộ nhớ đệm, thay vì sao chép. Thao tác này nhằm tiết kiệm dung lượng ổ đĩa.
Thẻ:bazel_internal_configuration
- Giá trị mặc định của
--[no]experimental_repository_cache_urls_as_default_canonical_id
: "false" -
Nếu đúng, hãy sử dụng một chuỗi bắt nguồn từ URL của các tệp tải xuống từ kho lưu trữ dưới dạngcanonical_id nếu không được chỉ định. Điều này khiến URL thay đổi, dẫn đến việc tải xuống lại ngay cả khi bộ nhớ đệm chứa tệp tải xuống có cùng hàm băm. Bạn có thể sử dụng quy trình này để xác minh rằng các thay đổi về URL không làm hỏng các kho lưu trữ bị bộ nhớ đệm che khuất.
Thẻ:loading_and_analysis
,experimental
- Giá trị mặc định của
--[no]experimental_repository_disable_download
: "false" -
Nếu đã đặt, bạn sẽ không được phép tải các kho lưu trữ bên ngoài xuống.
Thẻ:experimental
- Giá trị mặc định của
--experimental_repository_downloader_retries=<an integer>
: "0" -
Số lần thử tải lại lỗi xuống tối đa. Nếu bạn đặt chính sách này thành 0, hoạt động thử lại sẽ bị tắt.
Thẻ:experimental
- Giá trị mặc định của
--experimental_scale_timeouts=<a double>
: "1" -
Điều chỉnh tỷ lệ tất cả thời gian chờ trong quy tắc kho lưu trữ Starlark theo hệ số này. Bằng cách này, các kho lưu trữ bên ngoài có thể hoạt động trên các máy chậm hơn dự kiến của tác giả quy tắc mà không cần thay đổi mã nguồn
Thẻ:bazel_internal_configuration
,experimental
- Giá trị mặc định của
--http_timeout_scaling=<a double>
: "1" -
Điều chỉnh tỷ lệ tất cả thời gian chờ liên quan đến lượt tải xuống http theo hệ số cho trước
Thẻ:bazel_internal_configuration
- Mặc định
--repository_cache=<a path>
: xem nội dung mô tả -
Chỉ định vị trí bộ nhớ đệm của các giá trị được tải xuống thu được trong quá trình tìm nạp kho lưu trữ bên ngoài. Chuỗi trống dưới dạng đối số yêu cầu tắt bộ nhớ đệm.
Thẻ:bazel_internal_configuration
- Các tuỳ chọn cho phép người dùng định cấu hình đầu ra dự kiến, ảnh hưởng đến giá trị của đầu ra đó, trái ngược với sự tồn tại của đầu ra đó:
- Mặc định
--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 nhất định để gọi mục tiêu. Nếu bạn đặt tuỳ chọn này, thì mục tiêu sẽ không chạy từ bazel. Sử dụng 'bazel run --script_path=foo //foo && ./foo' để gọi target '//foo' Tên này khác với 'bazel run //foo' trong đó khoá bazel được thả ra 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 ảnh hưởng đến mức độ nghiêm ngặt của Bazel thực thi dữ liệu đầu vào bản dựng hợp lệ (định nghĩa quy tắc, tổ hợp cờ, v.v.):
- Giá trị mặc định của
--experimental_repository_hash_file=<a string>
: "" -
Nếu giá trị không trống, hãy chỉ định tệp có chứa giá trị đã phân giải mà cần phải xác minh giá trị băm của thư mục kho lưu trữ
Thẻ:affects_outputs
,experimental
--experimental_verify_repository_rules=<a string>
lần dùng được tích luỹ-
Nếu danh sách các quy tắc kho lưu trữ mà hàm băm của thư mục đầu ra cần được xác minh, miễn là tệp được chỉ định bởi --experimental_repository_hash_file.
Thẻ:affects_outputs
,experimental
- Tuỳ chọn này ảnh hưởng đến ngữ nghĩa của ngôn ngữ Starlark hoặc API bản dựng có thể truy cập vào các tệp BUILD, tệp .bzl hoặc tệp WORKSPACE.:
- Giá trị mặc định của
--[no]experimental_allow_top_level_aspects_parameters
: "true" -
Không hoạt động
Thẻ:no_op
,deprecated
,experimental
- Các tuỳ chọn liên quan đến đầu ra và ngữ nghĩa Bzlmod:
--allow_yanked_versions=<a string>
lần dùng được tích luỹ-
Đã chỉ định các phiên bản mô-đun dưới dạng `<module1>@<version1>,<module2>@<version2>` sẽ được phép trong biểu đồ phần phụ thuộc đã phân giải ngay cả khi chúng được khai báo được kéo trong sổ đăng ký nơi chúng đến (nếu chúng không đến từ NonRegistryOverride). Nếu không, các phiên bản được kéo sẽ khiến quá trình phân giải bị lỗi. Bạn cũng có thể xác định phiên bản được kéo được phép bằng biến môi trường "BZLMOD_ALLOW_YANKED_VERSIONS". Bạn có thể vô hiệu hoá chế độ kiểm tra này bằng cách sử dụng từ khoá 'tất cả' (không nên dùng).
Thẻ:loading_and_analysis
- Giá trị 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" để báo cáo lỗi thành không giải quyết được, "tắt" để tắt tính năng kiểm tra hoặc "cảnh báo" để in một cảnh báo khi phát hiện thấy thông tin không khớp.
Thẻ:loading_and_analysis
- Giá trị 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 "bazel_dep" trực tiếp đượ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 đã phân giải hay không. Các giá trị hợp lệ là "off" để tắt tính năng kiểm tra, "warning" để in cảnh báo khi phát hiện thấy thông tin không khớp hoặc "error" để chuyển cảnh báo thành không giải quyết được.
Thẻ:loading_and_analysis
- Giá trị mặc định của
--[no]ignore_dev_dependency
: "false" -
Nếu đúng, Bazel sẽ bỏ qua phương thức "bazel_dep" và "use_extension" được khai báo là "dev_Dependencies" trong MODULE.bazel của mô-đun gốc. Lưu ý rằng các phần phụ thuộc dev đó 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
--override_module=<an equals-separated mapping of module name to path>
lần dùng được tích luỹ- Ghi đè mô-đun bằng thư mục cục bộ.
--registry=<a string>
lần dùng được tích luỹ-
Chỉ định sổ đăng ký cần sử dụng để xác định vị trí các phần phụ thuộc của mô-đun Bazel. Thứ tự này rất quan trọng: các mô-đun sẽ được tra cứu trong các sổ đăng ký trước đó trước và chỉ quay lại các sổ đăng ký sau đó nếu không có các mô-đun trước đó.
Thẻ:changes_inputs
- Các lựa chọn ảnh hưởng đến độ chi tiết, định dạng hoặc vị trí ghi nhật ký:
- Giá trị mặc định của
--[no]experimental_record_metrics_for_all_mnemonics
: "false" - Theo mặc định, số lượng loại hành động được giới hạn ở 20 bộ nhớ có số lượng hành động được thực thi lớn nhất. Việc đặt tuỳ chọn này sẽ ghi số liệu thống kê cho tất cả các bộ nhớ.
- Các tuỳ chọn chỉ định hoặc thay đổi dữ liệu đầu vào chung cho lệnh Bazel không thuộc các danh mục khác.:
- Giá trị mặc định của
--experimental_resolved_file_instead_of_workspace=<a string>
: "" -
Nếu không để trống, hãy đọc tệp đã giải quyết được chỉ định thay vì tệp WORKSPACE
Thẻ:changes_inputs
- Tuỳ chọn thực thi và lưu vào bộ nhớ đệm từ xa:
- Mặc định
--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ủ lưu trữ (cho `allow` và `block`) hoặc hai mẫu, một mẫu để so khớp và một mẫu để sử dụng làm URL thay thế, với các tham chiếu ngược bắt đầu từ `$1`. Bạn có thể cung cấp nhiều lệnh "ghi lại" cho cùng một URL và trong trường hợp này, hệ thống sẽ trả về nhiều URL.
- Các lựa chọn khác, không được phân loại theo cách khác.:
--override_repository=<an equals-separated mapping of repository name to path>
lần dùng được tích luỹ- Ghi đè kho lưu trữ bằng thư mục cục bộ.
Các chế độ 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:
--distdir=<a path>
lần dùng được tích luỹ-
Các nơi khác để tìm kiếm các bản lưu trữ trước khi truy cập vào mạng để tải các bản lưu trữ đó xuống.
Thẻ:bazel_internal_configuration
- Giá trị mặc định của
--[no]experimental_repository_cache_hardlinks
: "false" -
Nếu được thiết lập, bộ nhớ đệm của kho lưu trữ sẽ liên kết cứng tệp trong trường hợp có lượt truy cập bộ nhớ đệm, thay vì sao chép. Thao tác này nhằm tiết kiệm dung lượng ổ đĩa.
Thẻ:bazel_internal_configuration
- Giá trị mặc định của
--[no]experimental_repository_cache_urls_as_default_canonical_id
: "false" -
Nếu đúng, hãy sử dụng một chuỗi bắt nguồn từ URL của các tệp tải xuống từ kho lưu trữ dưới dạngcanonical_id nếu không được chỉ định. Điều này khiến URL thay đổi, dẫn đến việc tải xuống lại ngay cả khi bộ nhớ đệm chứa tệp tải xuống có cùng hàm băm. Bạn có thể sử dụng quy trình này để xác minh rằng các thay đổi về URL không làm hỏng các kho lưu trữ bị bộ nhớ đệm che khuất.
Thẻ:loading_and_analysis
,experimental
- Giá trị mặc định của
--[no]experimental_repository_disable_download
: "false" -
Nếu đã đặt, bạn sẽ không được phép tải các kho lưu trữ bên ngoài xuống.
Thẻ:experimental
- Giá trị mặc định của
--experimental_repository_downloader_retries=<an integer>
: "0" -
Số lần thử tải lại lỗi xuống tối đa. Nếu bạn đặt chính sách này thành 0, hoạt động thử lại sẽ bị tắt.
Thẻ:experimental
- Giá trị mặc định của
--experimental_scale_timeouts=<a double>
: "1" -
Điều chỉnh tỷ lệ tất cả thời gian chờ trong quy tắc kho lưu trữ Starlark theo hệ số này. Bằng cách này, các kho lưu trữ bên ngoài có thể hoạt động trên các máy chậm hơn dự kiến của tác giả quy tắc mà không cần thay đổi mã nguồn
Thẻ:bazel_internal_configuration
,experimental
- Giá trị mặc định của
--http_timeout_scaling=<a double>
: "1" -
Điều chỉnh tỷ lệ tất cả thời gian chờ liên quan đến lượt tải xuống http theo hệ số cho trước
Thẻ:bazel_internal_configuration
- Mặc định
--repository_cache=<a path>
: xem nội dung mô tả -
Chỉ định vị trí bộ nhớ đệm của các giá trị được tải xuống thu được trong quá trình tìm nạp kho lưu trữ bên ngoài. Chuỗi trống dưới dạng đối số yêu cầu tắt bộ nhớ đệm.
Thẻ:bazel_internal_configuration
- Các tuỳ chọn kiểm soát kết quả của lệnh:
- Giá trị mặc định của
--iff_heap_size_greater_than=<an integer>
: "0" -
Nếu giá trị 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 tiêu thụ vượt quá giá trị này.
Thẻ:loses_incremental_state
,eagerness_to_exit
- Các tuỳ chọn ảnh hưởng đến mức độ nghiêm ngặt của Bazel thực thi dữ liệu đầu vào bản dựng hợp lệ (định nghĩa quy tắc, tổ hợp cờ, v.v.):
- Giá trị mặc định của
--experimental_repository_hash_file=<a string>
: "" -
Nếu giá trị không trống, hãy chỉ định tệp có chứa giá trị đã phân giải mà cần phải xác minh giá trị băm của thư mục kho lưu trữ
Thẻ:affects_outputs
,experimental
--experimental_verify_repository_rules=<a string>
lần dùng được tích luỹ-
Nếu danh sách các quy tắc kho lưu trữ mà hàm băm của thư mục đầu ra cần được xác minh, miễn là tệp được chỉ định bởi --experimental_repository_hash_file.
Thẻ:affects_outputs
,experimental
- Tuỳ chọn này ảnh hưởng đến ngữ nghĩa của ngôn ngữ Starlark hoặc API bản dựng có thể truy cập vào các tệp BUILD, tệp .bzl hoặc tệp WORKSPACE.:
- Giá trị mặc định của
--[no]experimental_allow_top_level_aspects_parameters
: "true" -
Không hoạt động
Thẻ:no_op
,deprecated
,experimental
- Các tuỳ chọn liên quan đến đầu ra và ngữ nghĩa Bzlmod:
--allow_yanked_versions=<a string>
lần dùng được tích luỹ-
Đã chỉ định các phiên bản mô-đun dưới dạng `<module1>@<version1>,<module2>@<version2>` sẽ được phép trong biểu đồ phần phụ thuộc đã phân giải ngay cả khi chúng được khai báo được kéo trong sổ đăng ký nơi chúng đến (nếu chúng không đến từ NonRegistryOverride). Nếu không, các phiên bản được kéo sẽ khiến quá trình phân giải bị lỗi. Bạn cũng có thể xác định phiên bản được kéo được phép bằng biến môi trường "BZLMOD_ALLOW_YANKED_VERSIONS". Bạn có thể vô hiệu hoá chế độ kiểm tra này bằng cách sử dụng từ khoá 'tất cả' (không nên dùng).
Thẻ:loading_and_analysis
- Giá trị 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" để báo cáo lỗi thành không giải quyết được, "tắt" để tắt tính năng kiểm tra hoặc "cảnh báo" để in một cảnh báo khi phát hiện thấy thông tin không khớp.
Thẻ:loading_and_analysis
- Giá trị 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 "bazel_dep" trực tiếp đượ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 đã phân giải hay không. Các giá trị hợp lệ là "off" để tắt tính năng kiểm tra, "warning" để in cảnh báo khi phát hiện thấy thông tin không khớp hoặc "error" để chuyển cảnh báo thành không giải quyết được.
Thẻ:loading_and_analysis
- Giá trị mặc định của
--[no]ignore_dev_dependency
: "false" -
Nếu đúng, Bazel sẽ bỏ qua phương thức "bazel_dep" và "use_extension" được khai báo là "dev_Dependencies" trong MODULE.bazel của mô-đun gốc. Lưu ý rằng các phần phụ thuộc dev đó 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
--override_module=<an equals-separated mapping of module name to path>
lần dùng được tích luỹ- Ghi đè mô-đun bằng thư mục cục bộ.
--registry=<a string>
lần dùng được tích luỹ-
Chỉ định sổ đăng ký cần sử dụng để xác định vị trí các phần phụ thuộc của mô-đun Bazel. Thứ tự này rất quan trọng: các mô-đun sẽ được tra cứu trong các sổ đăng ký trước đó trước và chỉ quay lại các sổ đăng ký sau đó nếu không có các mô-đun trước đó.
Thẻ:changes_inputs
- Các lựa chọn ảnh hưởng đến độ chi tiết, định dạng hoặc vị trí ghi nhật ký:
- Giá trị mặc định của
--[no]experimental_record_metrics_for_all_mnemonics
: "false" - Theo mặc định, số lượng loại hành động được giới hạn ở 20 bộ nhớ có số lượng hành động được thực thi lớn nhất. Việc đặt tuỳ chọn này sẽ ghi số liệu thống kê cho tất cả các bộ nhớ.
- Các tuỳ chọn chỉ định hoặc thay đổi dữ liệu đầu vào chung cho lệnh Bazel không thuộc các danh mục khác.:
- Giá trị mặc định của
--experimental_resolved_file_instead_of_workspace=<a string>
: "" -
Nếu không để trống, hãy đọc tệp đã giải quyết được chỉ định thay vì tệp WORKSPACE
Thẻ:changes_inputs
- Tuỳ chọn thực thi và lưu vào bộ nhớ đệm từ xa:
- Mặc định
--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ủ lưu trữ (cho `allow` và `block`) hoặc hai mẫu, một mẫu để so khớp và một mẫu để sử dụng làm URL thay thế, với các tham chiếu ngược bắt đầu từ `$1`. Bạn có thể cung cấp nhiều lệnh "ghi lại" cho cùng một URL và trong trường hợp này, hệ thống sẽ trả về nhiều URL.
- Các lựa chọn khác, không được phân loại theo cách khác.:
--override_repository=<an equals-separated mapping of repository name to path>
lần dùng được tích luỹ- Ghi đè kho lưu trữ bằng thư mục cục bộ.
Các lựa chọn đồ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:
--distdir=<a path>
lần dùng được tích luỹ-
Các nơi khác để tìm kiếm các bản lưu trữ trước khi truy cập vào mạng để tải các bản lưu trữ đó xuống.
Thẻ:bazel_internal_configuration
- Giá trị mặc định của
--[no]experimental_repository_cache_hardlinks
: "false" -
Nếu được thiết lập, bộ nhớ đệm của kho lưu trữ sẽ liên kết cứng tệp trong trường hợp có lượt truy cập bộ nhớ đệm, thay vì sao chép. Thao tác này nhằm tiết kiệm dung lượng ổ đĩa.
Thẻ:bazel_internal_configuration
- Giá trị mặc định của
--[no]experimental_repository_cache_urls_as_default_canonical_id
: "false" -
Nếu đúng, hãy sử dụng một chuỗi bắt nguồn từ URL của các tệp tải xuống từ kho lưu trữ dưới dạngcanonical_id nếu không được chỉ định. Điều này khiến URL thay đổi, dẫn đến việc tải xuống lại ngay cả khi bộ nhớ đệm chứa tệp tải xuống có cùng hàm băm. Bạn có thể sử dụng quy trình này để xác minh rằng các thay đổi về URL không làm hỏng các kho lưu trữ bị bộ nhớ đệm che khuất.
Thẻ:loading_and_analysis
,experimental
- Giá trị mặc định của
--[no]experimental_repository_disable_download
: "false" -
Nếu đã đặt, bạn sẽ không được phép tải các kho lưu trữ bên ngoài xuống.
Thẻ:experimental
- Giá trị mặc định của
--experimental_repository_downloader_retries=<an integer>
: "0" -
Số lần thử tải lại lỗi xuống tối đa. Nếu bạn đặt chính sách này thành 0, hoạt động thử lại sẽ bị tắt.
Thẻ:experimental
- Giá trị mặc định của
--experimental_scale_timeouts=<a double>
: "1" -
Điều chỉnh tỷ lệ tất cả thời gian chờ trong quy tắc kho lưu trữ Starlark theo hệ số này. Bằng cách này, các kho lưu trữ bên ngoài có thể hoạt động trên các máy chậm hơn dự kiến của tác giả quy tắc mà không cần thay đổi mã nguồn
Thẻ:bazel_internal_configuration
,experimental
- Giá trị mặc định của
--http_timeout_scaling=<a double>
: "1" -
Điều chỉnh tỷ lệ tất cả thời gian chờ liên quan đến lượt tải xuống http theo hệ số cho trước
Thẻ:bazel_internal_configuration
- Mặc định
--repository_cache=<a path>
: xem nội dung mô tả -
Chỉ định vị trí bộ nhớ đệm của các giá trị được tải xuống thu được trong quá trình tìm nạp kho lưu trữ bên ngoài. Chuỗi trống dưới dạng đối số yêu cầu tắt bộ nhớ đệm.
Thẻ:bazel_internal_configuration
- Các tuỳ chọn kiểm soát việc thực thi bản dựng:
- Giá trị mặc định của
--[no]configure
: "False" -
Chỉ những kho lưu trữ đồng bộ hoá đượ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
--[no]incompatible_remote_dangling_symlinks
: "true" -
Nếu bạn đặt chính sách này thành true và đặt giá trị --incompatible_remote_symlinks cũng là true, các đường liên kết tượng trưng trong dữ liệu đầu ra của hành động sẽ được phép treo.
Thẻ:execution
,incompatible_change
- Giá trị mặc định của
--[no]incompatible_remote_symlinks
: "true" -
Nếu bạn đặt chính sách này thành true, thì Bazel sẽ biểu thị các đường liên kết tượng trưng trong dữ liệu đầu ra của hành động trong giao thức lưu vào bộ nhớ đệm/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à được thể hiện dưới dạng tệp hoặc thư mục. Xem #6631 để biết chi tiết.
Thẻ:execution
,incompatible_change
--[no]keep_going
[-k
] mặc định: "false"-
Hãy tiếp tục nhiều nhất có thể sau khi gặp lỗi. Mặc dù không thể phân tích mục tiêu không thành công và những mục tiêu phụ thuộc vào nó, nhưng có thể có các điều kiện tiên quyết khác cho những mục tiêu này.
Thẻ:eagerness_to_exit
- Giá trị mặc định của
--loading_phase_threads=<an integer, or a keyword ("auto", "HOST_CPUS", "HOST_RAM"), optionally followed by an operation ([-|*]<float>) eg. "auto", "HOST_CPUS*.5">
: "tự động" -
Số lượng luồng song song để sử 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 bởi một thao tác ([-|*]<float>), ví dụ: "tự động", "HOST_CPUS*.5". "tự động" đặt giá trị mặc định hợp lý dựa trên tài nguyên máy chủ lưu trữ. Phải ít nhất là 1.
Thẻ:bazel_internal_configuration
--only=<a string>
lần dùng được tích luỹ-
Nếu được cung cấp tuỳ chọn này, chỉ đồng bộ hoá những kho lưu trữ được chỉ định bằng tuỳ chọn này. Vẫn xem là tất cả (hoặc tất cả cấu hình giống như --Configure được cung cấp) đã lỗi thời.
Thẻ:changes_inputs
- Các tuỳ chọn cho phép người dùng định cấu hình đầu ra dự kiến, ảnh hưởng đến giá trị của đầu ra đó, trái ngược với sự tồn tại của đầu ra đó:
- Giá trị mặc định của
--bep_maximum_open_remote_upload_files=<an integer>
: "-1" -
Số lượng tệp tối đa đang mở được cho phép trong quá trình tải cấu phần phần mềm BEP lên.
Thẻ:affects_outputs
--remote_download_minimal
-
Không tải bất kỳ kết quả của bản dựng từ xa nào xuống máy cục bộ. Cờ này là lối tắt cho các cờ: --experimental_inmemory_jdeps_files, --experimental_inmemory_dotd_files, --experimental_action_cache_store_output_metadata và --remote_download_outputs=minimal.
Mở rộng thành:
--nobuild_runfile_links
--experimental_inmemory_jdeps_files
--experimental_inmemory_dotd_files
--experimental_action_cache_store_output_metadata
--remote_download_outputs=minimal
Thẻ:affects_outputs
- Mặc định của
--remote_download_outputs=<all, minimal or toplevel>
: "tất cả" -
Nếu được đặt thành "tối thiểu" 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 các hành động cục bộ yêu cầu. Nếu được đặt thành "cấp cao nhất" hành xử như "tối thiểu" ngoại trừ việc nó cũng tải kết quả của các mục tiêu cấp cao nhất xuống máy cục bộ. Cả hai tuỳ chọn đều có thể làm giảm đáng kể thời gian xây dựng nếu băng thông mạng gây tắc nghẽn.
Thẻ:affects_outputs
- Giá trị mặc định của
--remote_download_symlink_template=<a string>
: "" -
Thay vì tải dữ liệu đầu ra 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 đích của các đường liên kết tượng trưng dưới dạng chuỗi mẫu. Chuỗi mẫu này có thể chứa {hash} và {size_bytes} lần lượt mở rộng thành hàm băm của đối tượng và kích thước tính bằng byte. Ví dụ: những đườ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 đầ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à lối tắt cho các cờ: --experimental_inmemory_jdeps_files, --experimental_inmemory_dotd_files, --experimental_action_cache_store_output_metadata và --remote_download_outputs=toplevel.
Mở rộng thành:
--experimental_inmemory_jdeps_files
--experimental_inmemory_dotd_files
--experimental_action_cache_store_output_metadata
--remote_download_outputs=toplevel
Thẻ:affects_outputs
- Các lựa chọn ảnh hưởng đến mức độ nghiêm ngặt của Bazel trong việc thực thi dữ liệu đầu vào bản dựng hợp lệ (định nghĩa quy tắc, tổ hợp cờ, v.v.):
- Giá trị mặc định của
--experimental_repository_hash_file=<a string>
: "" -
Nếu giá trị không trống, hãy chỉ định tệp có chứa giá trị đã phân giải mà cần phải xác minh giá trị băm của thư mục kho lưu trữ
Thẻ:affects_outputs
,experimental
--experimental_verify_repository_rules=<a string>
lần dùng được tích luỹ-
Nếu danh sách các quy tắc kho lưu trữ mà hàm băm của thư mục đầu ra cần được xác minh, miễn là tệp được chỉ định bởi --experimental_repository_hash_file.
Thẻ:affects_outputs
,experimental
- Tuỳ chọn này ảnh hưởng đến ngữ nghĩa của ngôn ngữ Starlark hoặc API bản dựng có thể truy cập vào các tệp BUILD, tệp .bzl hoặc tệp WORKSPACE.:
- Giá trị mặc định của
--[no]experimental_allow_top_level_aspects_parameters
: "true" -
Không hoạt động
Thẻ:no_op
,deprecated
,experimental
- Giá trị mặc định của
--[no]incompatible_config_setting_private_default_visibility
: "false" -
Nếu không tương thích_enforce_config_setting_ visibility=false, thì đây là lỗi không hiển thị. Ngược lại, nếu cờ này là false, mọi chế độ cài đặt config_setting không có thuộc tính mức độ hiển thị rõ ràng sẽ là //visibility:public. Nếu cờ này là true, chế độ cài đặt config_setting sẽ tuân theo cùng một logic về chế độ hiển thị như mọi quy tắc khác. Truy cập https://github.com/bazelbuild/bazel/issues/12933.
Thẻ:loading_and_analysis
,incompatible_change
- Giá trị mặc định của
--[no]incompatible_enforce_config_setting_visibility
: "true" -
Nếu là true, hãy thực thi các quy định hạn chế về chế độ hiển thị bằng lệnh config_setting. Nếu đặt là false, mọi chế độ cài đặt config_ đều hiển thị với mọi mục tiêu. Truy cập 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:
--allow_yanked_versions=<a string>
lần dùng được tích luỹ-
Đã chỉ định các phiên bản mô-đun dưới dạng `<module1>@<version1>,<module2>@<version2>` sẽ được phép trong biểu đồ phần phụ thuộc đã phân giải ngay cả khi chúng được khai báo được kéo trong sổ đăng ký nơi chúng đến (nếu chúng không đến từ NonRegistryOverride). Nếu không, các phiên bản được kéo sẽ khiến quá trình phân giải bị lỗi. Bạn cũng có thể xác định phiên bản được kéo được phép bằng biến môi trường "BZLMOD_ALLOW_YANKED_VERSIONS". Bạn có thể vô hiệu hoá chế độ kiểm tra này bằng cách sử dụng từ khoá 'tất cả' (không nên dùng).
Thẻ:loading_and_analysis
- Giá trị 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" để báo cáo lỗi thành không giải quyết được, "tắt" để tắt tính năng kiểm tra hoặc "cảnh báo" để in một cảnh báo khi phát hiện thấy thông tin không khớp.
Thẻ:loading_and_analysis
- Giá trị 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 "bazel_dep" trực tiếp đượ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 đã phân giải hay không. Các giá trị hợp lệ là "off" để tắt tính năng kiểm tra, "warning" để in cảnh báo khi phát hiện thấy thông tin không khớp hoặc "error" để chuyển cảnh báo thành không giải quyết được.
Thẻ:loading_and_analysis
- Giá trị mặc định của
--[no]ignore_dev_dependency
: "false" -
Nếu đúng, Bazel sẽ bỏ qua phương thức "bazel_dep" và "use_extension" được khai báo là "dev_Dependencies" trong MODULE.bazel của mô-đun gốc. Lưu ý rằng các phần phụ thuộc dev đó 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
--override_module=<an equals-separated mapping of module name to path>
lần dùng được tích luỹ- Ghi đè mô-đun bằng thư mục cục bộ.
--registry=<a string>
lần dùng được tích luỹ-
Chỉ định sổ đăng ký cần sử dụng để xác định vị trí các phần phụ thuộc của mô-đun Bazel. Thứ tự này rất quan trọng: các mô-đun sẽ được tra cứu trong các sổ đăng ký trước đó trước và chỉ quay lại các sổ đăng ký sau đó nếu không có các mô-đun trước đó.
Thẻ:changes_inputs
- Các lựa chọn ảnh hưởng đến độ chi tiết, định dạng hoặc vị trí ghi nhật ký:
- Giá trị mặc định của
--[no]experimental_record_metrics_for_all_mnemonics
: "false" - Theo mặc định, số lượng loại hành động được giới hạn ở 20 bộ nhớ có số lượng hành động được thực thi lớn nhất. Việc đặt tuỳ chọn này sẽ ghi số liệu thống kê cho tất cả các bộ nhớ.
- Giá trị mặc định của
--experimental_repository_resolved_file=<a string>
: "" -
Nếu giá trị không trống, hãy viết một giá trị Starlark cùng với thông tin đã phân giải của tất cả các quy tắc kho lưu trữ Starlark đã được thực thi.
Thẻ:affects_outputs
- Giá trị mặc định của
--remote_print_execution_messages=<failure, success or all>
: "không thành công" -
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", chỉ in khi không thành công, "thành công" chỉ in khi thành công và "all" sẽ luôn in.
Thẻ:terminal_output
- Các tuỳ chọn chỉ định hoặc thay đổi dữ liệu đầu vào chung cho lệnh Bazel không thuộc các danh mục khác.:
- Giá trị mặc định của
--experimental_resolved_file_instead_of_workspace=<a string>
: "" -
Nếu không để trống, hãy đọc tệp đã giải quyết được chỉ định thay vì tệp WORKSPACE
Thẻ:changes_inputs
- Tuỳ chọn thực thi và lưu vào bộ nhớ đệm từ xa:
- Mặc định
--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ủ lưu trữ (cho `allow` và `block`) hoặc hai mẫu, một mẫu để so khớp và một mẫu để sử dụng làm URL thay thế, với các tham chiếu ngược bắt đầu từ `$1`. Bạn có thể cung cấp nhiều lệnh "ghi lại" cho cùng một URL và trong trường hợp này, hệ thống sẽ trả về nhiều URL.
- Giá trị mặc định của
--[no]experimental_guard_against_concurrent_changes
: "false" - Tắt tuỳ chọn này để tắt tính năng kiểm tra thời gian đối với tệp nhập của một hành động trước khi tải lên bộ nhớ đệm từ xa. Trong một số trường hợp, nhân hệ điều hành Linux có thể trì hoãn việc ghi tệp, từ đó dẫn đến dương tính giả.
- Mặc định của
--experimental_remote_build_event_upload=<all or minimal>
: "tất cả" - Nếu bạn đặt chính sách này thành "all", thì mọi dữ liệu đầu ra cục bộ được tham chiếu bởi BEP sẽ được tải lên bộ nhớ đệm từ xa. Nếu bạn đặt chính sách này thành "tối thiểu", thì các dữ liệu đầu ra cục bộ được tham chiếu bởi BEP 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 sử dụng BEP (ví dụ: nhật ký kiểm thử và hồ sơ thời gian). Lược đồ bytestream:// luôn được dùng cho URI của các tệp ngay cả khi chúng bị thiếu trong bộ nhớ đệm từ xa. Giá trị mặc định là "tất cả".
- Giá trị mặc định của
--[no]experimental_remote_cache_async
: "false" - Nếu đúng, I/O bộ nhớ đệm từ xa sẽ diễn ra trong nền thay vì diễn ra như một phần của quá trình sinh sản.
- Giá trị mặc định của
--[no]experimental_remote_cache_compression
: "false" - Nếu được bật, hãy nén/giải nén các blob bộ nhớ đệm bằng zstd.
- Mặc định
--experimental_remote_capture_corrupted_outputs=<a path>
: xem nội dung mô tả - Đường dẫn đến thư mục nơi các dữ liệu đầu ra bị lỗi sẽ được ghi vào.
- Giá trị 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, thì hệ thống sẽ loại bỏ các bản sao trong bộ nhớ của cây Merkle của gốc đầu vào và các bản đồ ánh xạ đầu vào được liên kết trong các lệnh gọi đến GetActionResult() và Execute(). Điều này làm giảm đáng kể mức sử dụng bộ nhớ, nhưng Bazel phải tính toán lại các dữ liệu này khi bộ nhớ đệm từ xa bị thiếu và thử lại.
- Mặc định
--experimental_remote_downloader=<a string>
: xem nội dung mô tả - URI điểm cuối của Remote Asset API, được 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ắm UNIX cục bộ). Nếu không cung cấp giản đồ, Bazel sẽ đặt mặc định thành grpcs. Hãy tham khảo: https://github.com/bazelbuild/remote-apis/blob/master/build/bazel/remote/asset/v1/remote_asset.proto
- Giá trị mặc định của
--[no]experimental_remote_downloader_local_fallback
: "false" - Liệu có quay lại trình tải xuống cục bộ nếu trình tải xuống từ xa không thành công hay không.
- Giá trị mặc định của
--[no]experimental_remote_execution_keepalive
: "false" - Liệu có sử dụng tính năng giữ nguyên hoạt động cho các lệnh gọi thực thi từ xa hay không.
- Mặc định
--experimental_remote_grpc_log=<a path>
: xem nội dung mô tả - Nếu được chỉ định, một đườ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 các protobuf com.google.devtools.build.lib.remote.logging.RemoteExecutionLog.LogEntry được chuyển đổi tuần tự với mỗi thông điệp có tiền tố là một varint biểu thị kích thước của thông điệp protobuf được tuần tự hoá sau đây, được thực hiện bằng phương thức LogEntry.writeDelimitedTo(OutputStream).
- Giá trị 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, thì Bazel sẽ đánh dấu các dữ liệu đầu vào là đầu vào công cụ cho bộ thực thi từ xa. Bạn có thể dùng tính năng này để triển khai trình thực thi cố định từ xa.
- Giá trị 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 (đúng), các phép tính của cây Merkle sẽ được ghi nhớ để cải thiện tốc độ kiểm tra lượt truy cập trong 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_merkle_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 Merkle cần ghi nhớ để cải thiện tốc độ kiểm tra lượt truy cập vào bộ nhớ đệm từ xa. Mặc dù bộ nhớ đệm sẽ tự động bị cắt bớt theo cách xử lý tham chiếu mềm của Java, nhưng lỗi hết bộ nhớ vẫn có thể xảy ra nếu bộ nhớ được đặt quá cao. Nếu bạn đặt chính sách này thành 0, thì kích thước bộ nhớ đệm sẽ không bị 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.
- Giá trị mặc định của
--[no]incompatible_remote_build_event_upload_respect_no_cache
: "false" - Nếu bạn đặt chính sách này thành true, thì các dữ liệu đầu ra được BEP tham chiếu sẽ không được tải lên bộ nhớ đệm từ xa nếu thao tác tạo không thể lưu vào bộ nhớ đệm từ xa.
- Giá trị mặc định của
--[no]incompatible_remote_downloader_send_all_headers
: "true" -
Liệu có gửi tất cả các giá trị của một tiêu đề có nhiều giá trị tới trình tải xuống từ xa thay vì chỉ gửi giá trị đầu tiên hay không.
Thẻ:incompatible_change
- Giá trị mặc định của
--[no]incompatible_remote_output_paths_relative_to_input_root
: "false" -
Nếu bạn đặt chính sách này thành true, thì các đường dẫn đầu ra sẽ tương ứng với thư mục gốc đầu vào thay vì thư mục đang hoạt động.
Thẻ:incompatible_change
- Giá trị mặc định của
--[no]incompatible_remote_results_ignore_disk
: "true" -
Nếu bạn đặt chính sách này thành true, thì --noremote_upload_local_results và --noremote_accept_cached sẽ không áp dụng cho bộ nhớ đệm của ổ đĩa. Nếu sử dụng bộ nhớ đệm kết hợp:
--noremote_upload_local_results sẽ làm cho kết quả được ghi vào bộ nhớ đệm của ổ đĩa nhưng không được tải lên bộ nhớ đệm từ xa.
--noremote_accept_cached sẽ dẫn đến việc Bazel kiểm tra các kết quả trong bộ nhớ đệm của ổ đĩa, chứ không phải trong bộ nhớ đệm từ xa.
no-remote-exec có thể ảnh hưởng đến bộ nhớ đệm của ổ đĩa.
Xem #8216 để biết chi tiết.
Thẻ:incompatible_change
- Giá trị mặc định của
--[no]incompatible_remote_use_new_exit_code_for_lost_inputs
: "false" -
Nếu được đặt thành true, Bazel sẽ sử dụng mã thoát mới 39 thay vì 34 nếu bộ nhớ đệm từ xa loại bỏ các blob trong quá trình tạo.
Thẻ:incompatible_change
- Giá trị mặc định của
--[no]remote_accept_cached
: "true" - Liệu có chấp nhận kết quả hành động được lưu vào bộ nhớ đệm từ xa hay không.
- Mặc định
--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 luồng sự kiện tạo bản dựng. Bạn có thể đặt tuỳ chọn này khi tạo các bản dựng bằng proxy. Việc 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ị mặc định sẽ là "${hostname}/${instance_name}".
- Mặc định
--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ắm UNIX cục bộ). Nếu không cung cấp giản đồ, Bazel sẽ đặt mặc định thành grpcs. Hãy chỉ định lược đồ grpc://, http:// hoặc unix: để vô hiệu hoá TLS. Hãy truy cập vào https://bazel.build/remote/caching
--remote_cache_header=<a 'name=value' assignment>
lần dùng được tích luỹ- Chỉ định tiêu đề sẽ có trong các yêu cầu bộ nhớ đệm: --remote_cache_header=Name=Value. Có thể truyền nhiều tiêu đề bằng cách chỉ định cờ nhiều lần. Nhiều giá trị cho cùng một tên sẽ được chuyển đổi thành danh sách được phân tách bằng dấu phẩy.
--remote_default_exec_properties=<a 'name=value' assignment>
lần dùng được tích luỹ-
Đặt các 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
- Giá trị mặc định của
--remote_default_platform_properties=<a string>
: "" - Đặt các thuộc tính nền tảng mặc định thành thiết lập cho API thực thi từ xa, nếu nền tảng thực thi chưa đặt Remote_execution_properties. Giá trị này cũng sẽ được dùng nếu nền tảng lưu trữ được chọn làm nền tảng thực thi để thực thi từ xa.
--remote_downloader_header=<a 'name=value' assignment>
lần dùng được tích luỹ- Chỉ định tiêu đề sẽ được đưa vào trong các yêu cầu của trình tải xuống từ xa: --remote_downloader_header=Name=Value. Có thể truyền nhiều tiêu đề bằng cách chỉ định cờ nhiều lần. Nhiều giá trị cho cùng một tên sẽ được chuyển đổi thành danh sách được phân tách bằng dấu phẩy.
--remote_exec_header=<a 'name=value' assignment>
lần dùng được tích luỹ- Chỉ định tiêu đề sẽ được đưa vào trong các yêu cầu thực thi: --remote_exec_header=Name=Value. Có thể truyền nhiều tiêu đề bằng cách chỉ định cờ nhiều lần. Nhiều giá trị cho cùng một tên sẽ được chuyển đổi thành danh sách được phân tách bằng dấu phẩy.
- Giá trị mặc định của
--remote_execution_priority=<an integer>
: "0" - Mức độ ưu tiên tương đối của các thao tác cần được thực thi từ xa. Ngữ nghĩa của các giá trị ưu tiên cụ thể phụ thuộc vào máy chủ.
- Mặc định
--remote_executor=<a string>
: xem nội dung mô tả - HOST hoặc HOST:PORT của một điểm cuối thực thi từ xa. Các giản đồ được hỗ trợ là grpc, grpcs (grpc có bật TLS) và unix (ổ cắm UNIX cục bộ). Nếu không cung cấp giản đồ, Bazel sẽ đặt mặc định thành grpcs. Chỉ định grpc:// hoặc unix: giản đồ để vô hiệu hoá TLS.
--remote_header=<a 'name=value' assignment>
lần dùng được tích luỹ- Chỉ định tiêu đề sẽ được đưa vào trong yêu cầu: --remote_header=Name=Value. Có thể truyền nhiều tiêu đề bằng cách chỉ định cờ nhiều lần. Nhiều giá trị cho cùng một tên sẽ được chuyển đổi thành danh sách được phân tách bằng dấu phẩy.
- Giá trị mặc định của
--remote_instance_name=<a string>
: "" - Giá trị cần truyền dưới dạnginstance_name trong API thực thi từ xa.
- Giá trị mặc định của
--[no]remote_local_fallback
: "false" - Liệu có quay lại sử dụng chiến lược thực thi cục bộ độc lập trong trường hợp thực thi từ xa không thành công hay không.
- Giá trị mặc định của
--remote_local_fallback_strategy=<a string>
: "cục bộ" - Không hoạt động, không dùng nữa. Hãy truy cập vào https://github.com/bazelbuild/bazel/issues/7480 để biết thông tin chi tiết.
- Mặc định của
--remote_max_connections=<an integer>
: "100" -
Giới hạn số lượng kết nối đồng thời tối đa đối với bộ nhớ đệm/trình thực thi từ xa. Theo mặc định, giá trị là 100. Việc đặt giá trị này thành 0 có nghĩa là không bị giới hạn.
Đối với bộ nhớ đệm từ xa HTTP, một kết nối TCP có thể xử lý từng 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, vì vậy, Bazel có thể thực hiện xung quanh các yêu cầu đồng thời "--remote_max_connections * 100".
Thẻ:host_machine_resource_optimizations
- Mặc định
--remote_proxy=<a string>
: xem nội dung mô tả - Kết nối với bộ nhớ đệm từ xa thông qua proxy. Hiện tại, bạn chỉ có thể sử dụng cờ này để định cấu hình cổng miền Unix (unix:/path/to/socket).
- Giá trị 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 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ủ.
- Giá trị 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, hoạt động thử lại sẽ bị tắt.
- Giá trị 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à các lệnh gọi vào bộ nhớ đệm. Đối với bộ nhớ đệm REST, đây là cả thời gian chờ kết nối và thời gian chờ đọc. Bạn có thể sử dụng các đơn vị sau: Ngày (d), giờ (h), phút (m), giây (s) và mili giây (mili giây). Nếu bạn bỏ qua đơn vị, thì giá trị được hiểu là giây.
- Giá trị mặc định của
--[no]remote_upload_local_results
: "true" - Liệu có tải các kết quả hành động được thực thi cục bộ lên bộ nhớ đệm từ xa hay không nếu bộ nhớ đệm từ xa hỗ trợ và người dùng được phép thực hiện việc đó.
- Giá trị mặc định của
--[no]remote_verify_downloads
: "true" - Nếu bạn đặt chính sách này thành true, thì Bazel sẽ tính toán tổng băm của tất cả các tệp tải xuống từ xa và loại bỏ các giá trị được lưu vào bộ nhớ đệm từ xa nếu các giá trị đó không khớp với giá trị dự kiến.
- Các lựa chọn khác, không được phân loại theo cách khác.:
- Giá trị mặc định của
--deleted_packages=<comma-separated list of package names>
: "" - 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ẽ cho là không tồn tại, ngay cả khi chúng hiển thị ở đâu đó 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 'x' hiện có. Ví dụ: sau khi xoá x/y/BUILD trong ứng dụng khách của bạn, hệ thống xây dựng có thể sẽ khiếu nại nếu gặp nhãn '//x:y/z' nếu giá trị đó vẫn được cung cấp bởi một mục package_path khác. Việc chỉ định --Delete_packages x/y sẽ giúp tránh được sự cố này.
- Mặc định
--disk_cache=<a path>
: xem nội dung mô tả - Một đường dẫn đến một thư mục mà Bazel có thể đọc và ghi các thao tác cũng như kết quả đầu ra của hành động. Nếu không có, thư mục sẽ được tạo.
--experimental_credential_helper=<An (unresolved) path to a credential helper for a scope.>
lần dùng được tích luỹ- Định cấu hình Trình trợ giúp thông tin xác thực dùng cho việc truy xuất thông tin xác thực cho phạm vi đã cung cấp (miền). Thông tin xác thực của Trình trợ giúp thông tin xác thực được ưu tiên hơn thông tin xác thực trên <code>--google_default_credentials</code>, "--google_credentials" hoặc <code>.netrc</code>. Hãy truy cập vào https://github.com/bazelbuild/suggesteds/blob/main/designs/2022-06-07-bazel-credential-helpers.md để biết chi tiết.
- Giá trị mặc định của
--experimental_credential_helper_cache_duration=<An immutable length of time.>
: "30 phút" - Định cấu hình khoảng thời gian lưu thông tin xác thực từ Trình trợ giúp thông tin xác thực. 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 đó; truyền 0 để xoá bộ nhớ đệm. Lệnh sạch luôn xoá bộ nhớ đệm, bất kể cờ này là gì.
- Mặc định của
--experimental_credential_helper_timeout=<An immutable length of time.>
: "5 giây" - Định cấu hình thời gian chờ cho Trình trợ giúp thông tin xác thực. 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 sẽ không thực hiện được lệnh gọi.
- Mặc định của
--google_auth_scopes=<comma-separated list of options>
: "https://www.googleapis.com/auth/cloud-platform" - Danh sách phạm vi xác thực được phân tách bằng dấu phẩy trên Google Cloud.
- Mặc định
--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/authentication để biết thông tin chi tiết.
- Giá trị mặc định của
--[no]google_default_credentials
: "false" - Có sử dụng 'Thông tin xác thực mặc định của ứng dụng trên Google' không để xác thực. Hãy truy cập vào https://cloud.google.com/docs/authentication để biết thông tin chi tiết. Tắt theo mặc định.
- Mặc định
--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, thì Bazel sẽ gửi ping sau khoảng thời gian không đọc hoạt động 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; thì xảy ra lỗi khi đặt giá trị nhỏ hơn một giây. Theo mặc định, các ping giữ kết nối sẽ bị tắt. Bạn nên phối hợp với chủ sở hữu dịch vụ trước khi bật 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
- Giá trị 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 giữ 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 phản hồi ping sau khoảng thời gian này. Thời gian được coi là độ chi tiết thứ hai; thì xảy ra lỗi khi đặt giá trị nhỏ hơn một giây. Nếu ping duy trì hoạt động bị tắt, thì chế độ cài đặt này sẽ bị bỏ qua.
--override_repository=<an equals-separated mapping of repository name to path>
lần dùng được tích luỹ- Ghi đè kho lưu trữ bằng thư mục cục bộ.
- 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, trong đó có nơi tìm các gói. Các phần tử bắt đầu bằng '%workspace%' đều liên quan đến không gian làm việc bao quanh. Nếu bạn bỏ qua hoặc để trống giá trị này, giá trị mặc định sẽ là "bazel info default-package-path".
- Giá trị mặc định của
--[no]show_loading_progress
: "true" - Nếu được bật, Bazel sẽ hiện thông báo "Đang tải gói:" tin nhắn.
- Mặc định
--tls_certificate=<a string>
: xem nội dung mô tả - Chỉ định một đường dẫn đến chứng chỉ TLS được tin cậy để ký chứng chỉ máy chủ.
- Mặc định
--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á ứng dụng khách để bật tính năng xác thực ứng dụng.
- Mặc định
--tls_client_key=<a string>
: xem nội dung mô tả - Chỉ định khoá ứng dụng 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 ứng dụng khách.
Các lựa chọn kiểm thử
Kế thừa tất cả tuỳ chọn từ 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:
--distdir=<a path>
lần dùng được tích luỹ-
Các nơi khác để tìm kiếm các bản lưu trữ trước khi truy cập vào mạng để tải các bản lưu trữ đó xuống.
Thẻ:bazel_internal_configuration
- Giá trị mặc định của
--[no]experimental_repository_cache_hardlinks
: "false" -
Nếu được thiết lập, bộ nhớ đệm của kho lưu trữ sẽ liên kết cứng tệp trong trường hợp có lượt truy cập bộ nhớ đệm, thay vì sao chép. Thao tác này nhằm tiết kiệm dung lượng ổ đĩa.
Thẻ:bazel_internal_configuration
- Giá trị mặc định của
--[no]experimental_repository_cache_urls_as_default_canonical_id
: "false" -
Nếu đúng, hãy sử dụng một chuỗi bắt nguồn từ URL của các tệp tải xuống từ kho lưu trữ dưới dạngcanonical_id nếu không được chỉ định. Điều này khiến URL thay đổi, dẫn đến việc tải xuống lại ngay cả khi bộ nhớ đệm chứa tệp tải xuống có cùng hàm băm. Bạn có thể sử dụng quy trình này để xác minh rằng các thay đổi về URL không làm hỏng các kho lưu trữ bị bộ nhớ đệm che khuất.
Thẻ:loading_and_analysis
,experimental
- Giá trị mặc định của
--[no]experimental_repository_disable_download
: "false" -
Nếu đã đặt, bạn sẽ không được phép tải các kho lưu trữ bên ngoài xuống.
Thẻ:experimental
- Giá trị mặc định của
--experimental_repository_downloader_retries=<an integer>
: "0" -
Số lần thử tải lại lỗi xuống tối đa. Nếu bạn đặt chính sách này thành 0, hoạt động thử lại sẽ bị tắt.
Thẻ:experimental
- Giá trị mặc định của
--experimental_scale_timeouts=<a double>
: "1" -
Điều chỉnh tỷ lệ tất cả thời gian chờ trong quy tắc kho lưu trữ Starlark theo hệ số này. Bằng cách này, các kho lưu trữ bên ngoài có thể hoạt động trên các máy chậm hơn dự kiến của tác giả quy tắc mà không cần thay đổi mã nguồn
Thẻ:bazel_internal_configuration
,experimental
- Giá trị mặc định của
--http_timeout_scaling=<a double>
: "1" -
Điều chỉnh tỷ lệ tất cả thời gian chờ liên quan đến lượt tải xuống http theo hệ số cho trước
Thẻ:bazel_internal_configuration
- Mặc định
--repository_cache=<a path>
: xem nội dung mô tả -
Chỉ định vị trí bộ nhớ đệm của các giá trị được tải xuống thu được trong quá trình tìm nạp kho lưu trữ bên ngoài. Chuỗi trống dưới dạng đối số yêu cầu tắt bộ nhớ đệm.
Thẻ:bazel_internal_configuration
- Các tuỳ chọn kiểm soát việc thực thi bản dựng:
- Giá trị mặc định của
--[no]incompatible_remote_dangling_symlinks
: "true" -
Nếu bạn đặt chính sách này thành true và đặt giá trị --incompatible_remote_symlinks cũng là true, các đường liên kết tượng trưng trong dữ liệu đầu ra của hành động sẽ được phép treo.
Thẻ:execution
,incompatible_change
- Giá trị mặc định của
--[no]incompatible_remote_symlinks
: "true" -
Nếu bạn đặt chính sách này thành true, thì Bazel sẽ biểu thị các đường liên kết tượng trưng trong dữ liệu đầu ra của hành động trong giao thức lưu vào bộ nhớ đệm/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à được thể hiện 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 cho phép người dùng định cấu hình đầu ra dự kiến, trái ngược với sự tồn tại của kết quả đó:
- Giá trị mặc định của
--bep_maximum_open_remote_upload_files=<an integer>
: "-1" -
Số lượng tệp tối đa đang mở được cho phép trong quá trình tải cấu phần phần mềm BEP lên.
Thẻ:affects_outputs
--remote_download_minimal
-
Không tải bất kỳ kết quả của bản dựng từ xa nào xuống máy cục bộ. Cờ này là lối tắt cho các cờ: --experimental_inmemory_jdeps_files, --experimental_inmemory_dotd_files, --experimental_action_cache_store_output_metadata và --remote_download_outputs=minimal.
Mở rộng thành:
--nobuild_runfile_links
--experimental_inmemory_jdeps_files
--experimental_inmemory_dotd_files
--experimental_action_cache_store_output_metadata
--remote_download_outputs=minimal
Thẻ:affects_outputs
- Mặc định của
--remote_download_outputs=<all, minimal or toplevel>
: "tất cả" -
Nếu được đặt thành "tối thiểu" 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 các hành động cục bộ yêu cầu. Nếu được đặt thành "cấp cao nhất" hành xử như "tối thiểu" ngoại trừ việc nó cũng tải kết quả của các mục tiêu cấp cao nhất xuống máy cục bộ. Cả hai tuỳ chọn đều có thể làm giảm đáng kể thời gian xây dựng nếu băng thông mạng gây tắc nghẽn.
Thẻ:affects_outputs
- Giá trị mặc định của
--remote_download_symlink_template=<a string>
: "" -
Thay vì tải dữ liệu đầu ra 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 đích của các đường liên kết tượng trưng dưới dạng chuỗi mẫu. Chuỗi mẫu này có thể chứa {hash} và {size_bytes} lần lượt mở rộng thành hàm băm của đối tượng và kích thước tính bằng byte. Ví dụ: những đườ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 đầ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à lối tắt cho các cờ: --experimental_inmemory_jdeps_files, --experimental_inmemory_dotd_files, --experimental_action_cache_store_output_metadata và --remote_download_outputs=toplevel.
Mở rộng thành:
--experimental_inmemory_jdeps_files
--experimental_inmemory_dotd_files
--experimental_action_cache_store_output_metadata
--remote_download_outputs=toplevel
Thẻ:affects_outputs
- Các lựa chọn ảnh hưởng đến mức độ nghiêm ngặt của Bazel trong việc thực thi dữ liệu đầu vào bản dựng hợp lệ (định nghĩa quy tắc, tổ hợp cờ, v.v.):
- Giá trị mặc định của
--experimental_repository_hash_file=<a string>
: "" -
Nếu giá trị không trống, hãy chỉ định tệp có chứa giá trị đã phân giải mà cần phải xác minh giá trị băm của thư mục kho lưu trữ
Thẻ:affects_outputs
,experimental
--experimental_verify_repository_rules=<a string>
lần dùng được tích luỹ-
Nếu danh sách các quy tắc kho lưu trữ mà hàm băm của thư mục đầu ra cần được xác minh, miễn là tệp được chỉ định bởi --experimental_repository_hash_file.
Thẻ:affects_outputs
,experimental
- Tuỳ chọn này ảnh hưởng đến ngữ nghĩa của ngôn ngữ Starlark hoặc API bản dựng có thể truy cập vào các tệp BUILD, tệp .bzl hoặc tệp WORKSPACE.:
- Giá trị mặc định của
--[no]experimental_allow_top_level_aspects_parameters
: "true" -
Không hoạt động
Thẻ:no_op
,deprecated
,experimental
- Các tuỳ chọn liên quan đến đầu ra và ngữ nghĩa Bzlmod:
--allow_yanked_versions=<a string>
lần dùng được tích luỹ-
Đã chỉ định các phiên bản mô-đun dưới dạng `<module1>@<version1>,<module2>@<version2>` sẽ được phép trong biểu đồ phần phụ thuộc đã phân giải ngay cả khi chúng được khai báo được kéo trong sổ đăng ký nơi chúng đến (nếu chúng không đến từ NonRegistryOverride). Nếu không, các phiên bản được kéo sẽ khiến quá trình phân giải bị lỗi. Bạn cũng có thể xác định phiên bản được kéo được phép bằng biến môi trường "BZLMOD_ALLOW_YANKED_VERSIONS". Bạn có thể vô hiệu hoá chế độ kiểm tra này bằng cách sử dụng từ khoá 'tất cả' (không nên dùng).
Thẻ:loading_and_analysis
- Giá trị 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" để báo cáo lỗi thành không giải quyết được, "tắt" để tắt tính năng kiểm tra hoặc "cảnh báo" để in một cảnh báo khi phát hiện thấy thông tin không khớp.
Thẻ:loading_and_analysis
- Giá trị 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 "bazel_dep" trực tiếp đượ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 đã phân giải hay không. Các giá trị hợp lệ là "off" để tắt tính năng kiểm tra, "warning" để in cảnh báo khi phát hiện thấy thông tin không khớp hoặc "error" để chuyển cảnh báo thành không giải quyết được.
Thẻ:loading_and_analysis
- Giá trị mặc định của
--[no]ignore_dev_dependency
: "false" -
Nếu đúng, Bazel sẽ bỏ qua phương thức "bazel_dep" và "use_extension" được khai báo là "dev_Dependencies" trong MODULE.bazel của mô-đun gốc. Lưu ý rằng các phần phụ thuộc dev đó 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
--override_module=<an equals-separated mapping of module name to path>
lần dùng được tích luỹ- Ghi đè mô-đun bằng thư mục cục bộ.
--registry=<a string>
lần dùng được tích luỹ-
Chỉ định sổ đăng ký cần sử dụng để xác định vị trí các phần phụ thuộc của mô-đun Bazel. Thứ tự này rất quan trọng: các mô-đun sẽ được tra cứu trong các sổ đăng ký trước đó trước và chỉ quay lại các sổ đăng ký sau đó nếu không có các mô-đun trước đó.
Thẻ:changes_inputs
- Các lựa chọn ảnh hưởng đến độ chi tiết, định dạng hoặc vị trí ghi nhật ký:
- Giá trị mặc định của
--[no]experimental_record_metrics_for_all_mnemonics
: "false" - Theo mặc định, số lượng loại hành động được giới hạn ở 20 bộ nhớ có số lượng hành động được thực thi lớn nhất. Việc đặt tuỳ chọn này sẽ ghi số liệu thống kê cho tất cả các bộ nhớ.
- Giá trị mặc định của
--[no]print_relative_test_log_paths
: "false" -
Nếu đúng, khi in đường dẫn đến nhật ký kiểm thử, hãy sử dụng đường dẫn tương đối tận dụng "testlogs" (nhật ký kiểm thử) đường liên kết tượng trưng tiện lợi. Không áp dụng – Lệnh gọi 'build'/'test'/etc tiếp theo có cấu hình khác có thể khiến mục tiêu của đường liên kết tượng trưng này thay đổi, khiến đường dẫn được in trước đó không còn hữu ích nữa.
Thẻ:affects_outputs
- Giá trị mặc định của
--remote_print_execution_messages=<failure, success or all>
: "không thành công" -
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", chỉ in khi không thành công, "thành công" chỉ in khi thành công và "all" sẽ luôn in.
Thẻ:terminal_output
- Giá trị mặc định của
--[no]test_verbose_timeout_warnings
: "false" -
Nếu là true, xuất thêm cảnh báo khi thời gian thực thi kiểm thử thực tế không khớp với thời gian chờ do phép kiểm thử xác định (dù là ngụ ý hay rõ ràng).
Thẻ:affects_outputs
- Giá trị mặc định của
--[no]verbose_test_summary
: "true" -
Nếu là true, xuất thông tin bổ sung (thời gian, số lần chạy không thành công, v.v.) trong phần tóm tắt kiểm thử.
Thẻ:affects_outputs
- Các tuỳ chọn chỉ định hoặc thay đổi dữ liệu đầu vào chung cho lệnh Bazel không thuộc các danh mục khác.:
- Giá trị mặc định của
--experimental_resolved_file_instead_of_workspace=<a string>
: "" -
Nếu không để trống, hãy đọc tệp đã giải quyết được chỉ định thay vì tệp WORKSPACE
Thẻ:changes_inputs
- Tuỳ chọn thực thi và lưu vào bộ nhớ đệm từ xa:
- Mặc định
--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ủ lưu trữ (cho `allow` và `block`) hoặc hai mẫu, một mẫu để so khớp và một mẫu để sử dụng làm URL thay thế, với các tham chiếu ngược bắt đầu từ `$1`. Bạn có thể cung cấp nhiều lệnh "ghi lại" cho cùng một URL và trong trường hợp này, hệ thống sẽ trả về nhiều URL.
- Giá trị mặc định của
--[no]experimental_guard_against_concurrent_changes
: "false" - Tắt tuỳ chọn này để tắt tính năng kiểm tra thời gian đối với tệp nhập của một hành động trước khi tải lên bộ nhớ đệm từ xa. Trong một số trường hợp, nhân hệ điều hành Linux có thể trì hoãn việc ghi tệp, từ đó dẫn đến dương tính giả.
- Mặc định của
--experimental_remote_build_event_upload=<all or minimal>
: "tất cả" - Nếu bạn đặt chính sách này thành "all", thì mọi dữ liệu đầu ra cục bộ được tham chiếu bởi BEP sẽ được tải lên bộ nhớ đệm từ xa. Nếu bạn đặt chính sách này thành "tối thiểu", thì các dữ liệu đầu ra cục bộ được tham chiếu bởi BEP 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 sử dụng BEP (ví dụ: nhật ký kiểm thử và hồ sơ thời gian). Lược đồ bytestream:// luôn được dùng cho URI của các tệp ngay cả khi chúng bị thiếu trong bộ nhớ đệm từ xa. Giá trị mặc định là "tất cả".
- Giá trị mặc định của
--[no]experimental_remote_cache_async
: "false" - Nếu đúng, I/O bộ nhớ đệm từ xa sẽ diễn ra trong nền thay vì diễn ra như một phần của quá trình sinh sản.
- Giá trị mặc định của
--[no]experimental_remote_cache_compression
: "false" - Nếu được bật, hãy nén/giải nén các blob bộ nhớ đệm bằng zstd.
- Mặc định
--experimental_remote_capture_corrupted_outputs=<a path>
: xem nội dung mô tả - Đường dẫn đến thư mục nơi các dữ liệu đầu ra bị lỗi sẽ được ghi vào.
- Giá trị 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, thì hệ thống sẽ loại bỏ các bản sao trong bộ nhớ của cây Merkle của gốc đầu vào và các bản đồ ánh xạ đầu vào được liên kết trong các lệnh gọi đến GetActionResult() và Execute(). Điều này làm giảm đáng kể mức sử dụng bộ nhớ, nhưng Bazel phải tính toán lại các dữ liệu này khi bộ nhớ đệm từ xa bị thiếu và thử lại.
- Mặc định
--experimental_remote_downloader=<a string>
: xem nội dung mô tả - URI điểm cuối của Remote Asset API, được 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ắm UNIX cục bộ). Nếu không cung cấp giản đồ, Bazel sẽ đặt mặc định thành grpcs. Hãy tham khảo: https://github.com/bazelbuild/remote-apis/blob/master/build/bazel/remote/asset/v1/remote_asset.proto
- Giá trị mặc định của
--[no]experimental_remote_downloader_local_fallback
: "false" - Liệu có quay lại trình tải xuống cục bộ nếu trình tải xuống từ xa không thành công hay không.
- Giá trị mặc định của
--[no]experimental_remote_execution_keepalive
: "false" - Liệu có sử dụng tính năng giữ nguyên hoạt động cho các lệnh gọi thực thi từ xa hay không.
- Mặc định
--experimental_remote_grpc_log=<a path>
: xem nội dung mô tả - Nếu được chỉ định, một đườ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 các protobuf com.google.devtools.build.lib.remote.logging.RemoteExecutionLog.LogEntry được chuyển đổi tuần tự với mỗi thông điệp có tiền tố là một varint biểu thị kích thước của thông điệp protobuf được tuần tự hoá sau đây, được thực hiện bằng phương thức LogEntry.writeDelimitedTo(OutputStream).
- Giá trị 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, thì Bazel sẽ đánh dấu các dữ liệu đầu vào là đầu vào công cụ cho bộ thực thi từ xa. Bạn có thể dùng tính năng này để triển khai trình thực thi cố định từ xa.
- Giá trị 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 (đúng), các phép tính của cây Merkle sẽ được ghi nhớ để cải thiện tốc độ kiểm tra lượt truy cập trong 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_merkle_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 Merkle cần ghi nhớ để cải thiện tốc độ kiểm tra lượt truy cập vào bộ nhớ đệm từ xa. Mặc dù bộ nhớ đệm sẽ tự động bị cắt bớt theo cách xử lý tham chiếu mềm của Java, nhưng lỗi hết bộ nhớ vẫn có thể xảy ra nếu bộ nhớ được đặt quá cao. Nếu bạn đặt chính sách này thành 0, thì kích thước bộ nhớ đệm sẽ không bị 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.
- Giá trị mặc định của
--[no]incompatible_remote_build_event_upload_respect_no_cache
: "false" - Nếu bạn đặt chính sách này thành true, thì các dữ liệu đầu ra được BEP tham chiếu sẽ không được tải lên bộ nhớ đệm từ xa nếu thao tác tạo không thể lưu vào bộ nhớ đệm từ xa.
- Giá trị mặc định của
--[no]incompatible_remote_downloader_send_all_headers
: "true" -
Liệu có gửi tất cả các giá trị của một tiêu đề có nhiều giá trị tới trình tải xuống từ xa thay vì chỉ gửi giá trị đầu tiên hay không.
Thẻ:incompatible_change
- Giá trị mặc định của
--[no]incompatible_remote_output_paths_relative_to_input_root
: "false" -
Nếu bạn đặt chính sách này thành true, thì các đường dẫn đầu ra sẽ tương ứng với thư mục gốc đầu vào thay vì thư mục đang hoạt động.
Thẻ:incompatible_change
- Giá trị mặc định của
--[no]incompatible_remote_results_ignore_disk
: "true" -
Nếu bạn đặt chính sách này thành true, thì --noremote_upload_local_results và --noremote_accept_cached sẽ không áp dụng cho bộ nhớ đệm của ổ đĩa. Nếu sử dụng bộ nhớ đệm kết hợp:
--noremote_upload_local_results sẽ làm cho kết quả được ghi vào bộ nhớ đệm của ổ đĩa nhưng không được tải lên bộ nhớ đệm từ xa.
--noremote_accept_cached sẽ dẫn đến việc Bazel kiểm tra các kết quả trong bộ nhớ đệm của ổ đĩa, chứ không phải trong bộ nhớ đệm từ xa.
no-remote-exec có thể ảnh hưởng đến bộ nhớ đệm của ổ đĩa.
Xem #8216 để biết chi tiết.
Thẻ:incompatible_change
- Giá trị mặc định của
--[no]incompatible_remote_use_new_exit_code_for_lost_inputs
: "false" -
Nếu được đặt thành true, Bazel sẽ sử dụng mã thoát mới 39 thay vì 34 nếu bộ nhớ đệm từ xa loại bỏ các blob trong quá trình tạo.
Thẻ:incompatible_change
- Giá trị mặc định của
--[no]remote_accept_cached
: "true" - Liệu có chấp nhận kết quả hành động được lưu vào bộ nhớ đệm từ xa hay không.
- Mặc định
--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 luồng sự kiện tạo bản dựng. Bạn có thể đặt tuỳ chọn này khi tạo các bản dựng bằng proxy. Việc 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ị mặc định sẽ là "${hostname}/${instance_name}".
- Mặc định
--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ắm UNIX cục bộ). Nếu không cung cấp giản đồ, Bazel sẽ đặt mặc định thành grpcs. Hãy chỉ định lược đồ grpc://, http:// hoặc unix: để vô hiệu hoá TLS. Hãy truy cập vào https://bazel.build/remote/caching
--remote_cache_header=<a 'name=value' assignment>
lần dùng được tích luỹ- Chỉ định tiêu đề sẽ có trong các yêu cầu bộ nhớ đệm: --remote_cache_header=Name=Value. Có thể truyền nhiều tiêu đề bằng cách chỉ định cờ nhiều lần. Nhiều giá trị cho cùng một tên sẽ được chuyển đổi thành danh sách được phân tách bằng dấu phẩy.
--remote_default_exec_properties=<a 'name=value' assignment>
lần dùng được tích luỹ-
Đặt các 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
- Giá trị mặc định của
--remote_default_platform_properties=<a string>
: "" - Đặt các thuộc tính nền tảng mặc định thành thiết lập cho API thực thi từ xa, nếu nền tảng thực thi chưa đặt Remote_execution_properties. Giá trị này cũng sẽ được dùng nếu nền tảng lưu trữ được chọn làm nền tảng thực thi để thực thi từ xa.
--remote_downloader_header=<a 'name=value' assignment>
lần dùng được tích luỹ- Chỉ định tiêu đề sẽ được đưa vào trong các yêu cầu của trình tải xuống từ xa: --remote_downloader_header=Name=Value. Có thể truyền nhiều tiêu đề bằng cách chỉ định cờ nhiều lần. Nhiều giá trị cho cùng một tên sẽ được chuyển đổi thành danh sách được phân tách bằng dấu phẩy.
--remote_exec_header=<a 'name=value' assignment>
lần dùng được tích luỹ- Chỉ định tiêu đề sẽ được đưa vào trong các yêu cầu thực thi: --remote_exec_header=Name=Value. Có thể truyền nhiều tiêu đề bằng cách chỉ định cờ nhiều lần. Nhiều giá trị cho cùng một tên sẽ được chuyển đổi thành danh sách được phân tách bằng dấu phẩy.
- Giá trị mặc định của
--remote_execution_priority=<an integer>
: "0" - Mức độ ưu tiên tương đối của các thao tác cần được thực thi từ xa. Ngữ nghĩa của các giá trị ưu tiên cụ thể phụ thuộc vào máy chủ.
- Mặc định
--remote_executor=<a string>
: xem nội dung mô tả - HOST hoặc HOST:PORT của một điểm cuối thực thi từ xa. Các giản đồ được hỗ trợ là grpc, grpcs (grpc có bật TLS) và unix (ổ cắm UNIX cục bộ). Nếu không cung cấp giản đồ, Bazel sẽ đặt mặc định thành grpcs. Chỉ định grpc:// hoặc unix: giản đồ để vô hiệu hoá TLS.
--remote_header=<a 'name=value' assignment>
lần dùng được tích luỹ- Chỉ định tiêu đề sẽ được đưa vào trong yêu cầu: --remote_header=Name=Value. Có thể truyền nhiều tiêu đề bằng cách chỉ định cờ nhiều lần. Nhiều giá trị cho cùng một tên sẽ được chuyển đổi thành danh sách được phân tách bằng dấu phẩy.
- Giá trị mặc định của
--remote_instance_name=<a string>
: "" - Giá trị cần truyền dưới dạnginstance_name trong API thực thi từ xa.
- Giá trị mặc định của
--[no]remote_local_fallback
: "false" - Liệu có quay lại sử dụng chiến lược thực thi cục bộ độc lập trong trường hợp thực thi từ xa không thành công hay không.
- Giá trị mặc định của
--remote_local_fallback_strategy=<a string>
: "cục bộ" - Không hoạt động, không dùng nữa. Hãy truy cập vào https://github.com/bazelbuild/bazel/issues/7480 để biết thông tin chi tiết.
- Mặc định của
--remote_max_connections=<an integer>
: "100" -
Giới hạn số lượng kết nối đồng thời tối đa đối với bộ nhớ đệm/trình thực thi từ xa. Theo mặc định, giá trị là 100. Việc đặt giá trị này thành 0 có nghĩa là không bị giới hạn.
Đối với bộ nhớ đệm từ xa HTTP, một kết nối TCP có thể xử lý từng 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, vì vậy, Bazel có thể thực hiện xung quanh các yêu cầu đồng thời "--remote_max_connections * 100".
Thẻ:host_machine_resource_optimizations
- Mặc định
--remote_proxy=<a string>
: xem nội dung mô tả - Kết nối với bộ nhớ đệm từ xa thông qua proxy. Hiện tại, bạn chỉ có thể sử dụng cờ này để định cấu hình cổng miền Unix (unix:/path/to/socket).
- Giá trị 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 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ủ.
- Giá trị 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, hoạt động thử lại sẽ bị tắt.
- Giá trị 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à các lệnh gọi vào bộ nhớ đệm. Đối với bộ nhớ đệm REST, đây là cả thời gian chờ kết nối và thời gian chờ đọc. Bạn có thể sử dụng các đơn vị sau: Ngày (d), giờ (h), phút (m), giây (s) và mili giây (mili giây). Nếu bạn bỏ qua đơn vị, thì giá trị được hiểu là giây.
- Giá trị mặc định của
--[no]remote_upload_local_results
: "true" - Liệu có tải các kết quả hành động được thực thi cục bộ lên bộ nhớ đệm từ xa hay không nếu bộ nhớ đệm từ xa hỗ trợ và người dùng được phép thực hiện việc đó.
- Giá trị mặc định của
--[no]remote_verify_downloads
: "true" - Nếu bạn đặt chính sách này thành true, thì Bazel sẽ tính toán tổng băm của tất cả các tệp tải xuống từ xa và loại bỏ các giá trị được lưu vào bộ nhớ đệm từ xa nếu các giá trị đó không khớp với giá trị dự kiến.
- Các lựa chọn khác, không được phân loại theo cách khác.:
- Mặc định
--disk_cache=<a path>
: xem nội dung mô tả - Một đường dẫn đến một thư mục mà Bazel có thể đọc và ghi các thao tác cũng như kết quả đầu ra của hành động. Nếu không có, thư mục sẽ được tạo.
--experimental_credential_helper=<An (unresolved) path to a credential helper for a scope.>
lần dùng được tích luỹ- Định cấu hình Trình trợ giúp thông tin xác thực dùng cho việc truy xuất thông tin xác thực cho phạm vi đã cung cấp (miền). Thông tin xác thực của Trình trợ giúp thông tin xác thực được ưu tiên hơn thông tin xác thực trên <code>--google_default_credentials</code>, "--google_credentials" hoặc <code>.netrc</code>. Hãy truy cập vào https://github.com/bazelbuild/suggesteds/blob/main/designs/2022-06-07-bazel-credential-helpers.md để biết chi tiết.
- Giá trị mặc định của
--experimental_credential_helper_cache_duration=<An immutable length of time.>
: "30 phút" - Định cấu hình khoảng thời gian lưu thông tin xác thực từ Trình trợ giúp thông tin xác thực. 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 đó; truyền 0 để xoá bộ nhớ đệm. Lệnh sạch luôn xoá bộ nhớ đệm, bất kể cờ này là gì.
- Mặc định của
--experimental_credential_helper_timeout=<An immutable length of time.>
: "5 giây" - Định cấu hình thời gian chờ cho Trình trợ giúp thông tin xác thực. 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 sẽ không thực hiện được lệnh gọi.
- Mặc định của
--google_auth_scopes=<comma-separated list of options>
: "https://www.googleapis.com/auth/cloud-platform" - Danh sách phạm vi xác thực được phân tách bằng dấu phẩy trên Google Cloud.
- Mặc định
--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/authentication để biết thông tin chi tiết.
- Giá trị mặc định của
--[no]google_default_credentials
: "false" - Có sử dụng 'Thông tin xác thực mặc định của ứng dụng trên Google' không để xác thực. Hãy truy cập vào https://cloud.google.com/docs/authentication để biết thông tin chi tiết. Tắt theo mặc định.
- Mặc định
--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, thì Bazel sẽ gửi ping sau khoảng thời gian không đọc hoạt động 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; thì xảy ra lỗi khi đặt giá trị nhỏ hơn một giây. Theo mặc định, các ping giữ kết nối sẽ bị tắt. Bạn nên phối hợp với chủ sở hữu dịch vụ trước khi bật 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
- Giá trị 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 giữ 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 phản hồi ping sau khoảng thời gian này. Thời gian được coi là độ chi tiết thứ hai; thì xảy ra lỗi khi đặt giá trị nhỏ hơn một giây. Nếu ping duy trì hoạt động bị tắt, thì chế độ cài đặt này sẽ bị bỏ qua.
--override_repository=<an equals-separated mapping of repository name to path>
lần dùng được tích luỹ- Ghi đè kho lưu trữ bằng thư mục cục bộ.
- Mặc định
--tls_certificate=<a string>
: xem nội dung mô tả - Chỉ định một đường dẫn đến chứng chỉ TLS được tin cậy để ký chứng chỉ máy chủ.
- Mặc định
--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á ứng dụng khách để bật tính năng xác thực ứng dụng.
- Mặc định
--tls_client_key=<a string>
: xem nội dung mô tả - Chỉ định khoá ứng dụng 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 ứng dụng khách.
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:
--distdir=<a path>
lần dùng được tích luỹ-
Các nơi khác để tìm kiếm các bản lưu trữ trước khi truy cập vào mạng để tải các bản lưu trữ đó xuống.
Thẻ:bazel_internal_configuration
- Giá trị mặc định của
--[no]experimental_repository_cache_hardlinks
: "false" -
Nếu được thiết lập, bộ nhớ đệm của kho lưu trữ sẽ liên kết cứng tệp trong trường hợp có lượt truy cập bộ nhớ đệm, thay vì sao chép. Thao tác này nhằm tiết kiệm dung lượng ổ đĩa.
Thẻ:bazel_internal_configuration
- Giá trị mặc định của
--[no]experimental_repository_cache_urls_as_default_canonical_id
: "false" -
Nếu đúng, hãy sử dụng một chuỗi bắt nguồn từ URL của các tệp tải xuống từ kho lưu trữ dưới dạngcanonical_id nếu không được chỉ định. Điều này khiến URL thay đổi, dẫn đến việc tải xuống lại ngay cả khi bộ nhớ đệm chứa tệp tải xuống có cùng hàm băm. Bạn có thể sử dụng quy trình này để xác minh rằng các thay đổi về URL không làm hỏng các kho lưu trữ bị bộ nhớ đệm che khuất.
Thẻ:loading_and_analysis
,experimental
- Giá trị mặc định của
--[no]experimental_repository_disable_download
: "false" -
Nếu đã đặt, bạn sẽ không được phép tải các kho lưu trữ bên ngoài xuống.
Thẻ:experimental
- Giá trị mặc định của
--experimental_repository_downloader_retries=<an integer>
: "0" -
Số lần thử tải lại lỗi xuống tối đa. Nếu bạn đặt chính sách này thành 0, hoạt động thử lại sẽ bị tắt.
Thẻ:experimental
- Giá trị mặc định của
--experimental_scale_timeouts=<a double>
: "1" -
Điều chỉnh tỷ lệ tất cả thời gian chờ trong quy tắc kho lưu trữ Starlark theo hệ số này. Bằng cách này, các kho lưu trữ bên ngoài có thể hoạt động trên các máy chậm hơn dự kiến của tác giả quy tắc mà không cần thay đổi mã nguồn
Thẻ:bazel_internal_configuration
,experimental
- Giá trị mặc định của
--http_timeout_scaling=<a double>
: "1" -
Điều chỉnh tỷ lệ tất cả thời gian chờ liên quan đến lượt tải xuống http theo hệ số cho trước
Thẻ:bazel_internal_configuration
- Mặc định
--repository_cache=<a path>
: xem nội dung mô tả -
Chỉ định vị trí bộ nhớ đệm của các giá trị được tải xuống thu được trong quá trình tìm nạp kho lưu trữ bên ngoài. Chuỗi trống dưới dạng đối số yêu cầu tắt bộ nhớ đệm.
Thẻ:bazel_internal_configuration
- Các tuỳ chọn cho phép người dùng định cấu hình đầu ra dự kiến, ảnh hưởng đến giá trị của đầu ra đó, trái ngược với sự tồn tại của đầu ra đó:
- Giá trị mặc định của
--[no]gnu_format
: "false" -
Nếu được đặt, hãy ghi phiên bản vào stdout bằng cá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 ảnh hưởng đến mức độ nghiêm ngặt của Bazel thực thi dữ liệu đầu vào bản dựng hợp lệ (định nghĩa quy tắc, tổ hợp cờ, v.v.):
- Giá trị mặc định của
--experimental_repository_hash_file=<a string>
: "" -
Nếu giá trị không trống, hãy chỉ định tệp có chứa giá trị đã phân giải mà cần phải xác minh giá trị băm của thư mục kho lưu trữ
Thẻ:affects_outputs
,experimental
--experimental_verify_repository_rules=<a string>
lần dùng được tích luỹ-
Nếu danh sách các quy tắc kho lưu trữ mà hàm băm của thư mục đầu ra cần được xác minh, miễn là tệp được chỉ định bởi --experimental_repository_hash_file.
Thẻ:affects_outputs
,experimental
- Tuỳ chọn này ảnh hưởng đến ngữ nghĩa của ngôn ngữ Starlark hoặc API bản dựng có thể truy cập vào các tệp BUILD, tệp .bzl hoặc tệp WORKSPACE.:
- Giá trị mặc định của
--[no]experimental_allow_top_level_aspects_parameters
: "true" -
Không hoạt động
Thẻ:no_op
,deprecated
,experimental
- Các tuỳ chọn liên quan đến đầu ra và ngữ nghĩa Bzlmod:
--allow_yanked_versions=<a string>
lần dùng được tích luỹ-
Đã chỉ định các phiên bản mô-đun dưới dạng `<module1>@<version1>,<module2>@<version2>` sẽ được phép trong biểu đồ phần phụ thuộc đã phân giải ngay cả khi chúng được khai báo được kéo trong sổ đăng ký nơi chúng đến (nếu chúng không đến từ NonRegistryOverride). Nếu không, các phiên bản được kéo sẽ khiến quá trình phân giải bị lỗi. Bạn cũng có thể xác định phiên bản được kéo được phép bằng biến môi trường "BZLMOD_ALLOW_YANKED_VERSIONS". Bạn có thể vô hiệu hoá chế độ kiểm tra này bằng cách sử dụng từ khoá 'tất cả' (không nên dùng).
Thẻ:loading_and_analysis
- Giá trị 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" để báo cáo lỗi thành không giải quyết được, "tắt" để tắt tính năng kiểm tra hoặc "cảnh báo" để in một cảnh báo khi phát hiện thấy thông tin không khớp.
Thẻ:loading_and_analysis
- Giá trị 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 "bazel_dep" trực tiếp đượ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 đã phân giải hay không. Các giá trị hợp lệ là "off" để tắt tính năng kiểm tra, "warning" để in cảnh báo khi phát hiện thấy thông tin không khớp hoặc "error" để chuyển cảnh báo thành không giải quyết được.
Thẻ:loading_and_analysis
- Giá trị mặc định của
--[no]ignore_dev_dependency
: "false" -
Nếu đúng, Bazel sẽ bỏ qua phương thức "bazel_dep" và "use_extension" được khai báo là "dev_Dependencies" trong MODULE.bazel của mô-đun gốc. Lưu ý rằng các phần phụ thuộc dev đó 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
--override_module=<an equals-separated mapping of module name to path>
lần dùng được tích luỹ- Ghi đè mô-đun bằng thư mục cục bộ.
--registry=<a string>
lần dùng được tích luỹ-
Chỉ định sổ đăng ký cần sử dụng để xác định vị trí các phần phụ thuộc của mô-đun Bazel. Thứ tự này rất quan trọng: các mô-đun sẽ được tra cứu trong các sổ đăng ký trước đó trước và chỉ quay lại các sổ đăng ký sau đó nếu không có các mô-đun trước đó.
Thẻ:changes_inputs
- Các lựa chọn ảnh hưởng đến độ chi tiết, định dạng hoặc vị trí ghi nhật ký:
- Giá trị mặc định của
--[no]experimental_record_metrics_for_all_mnemonics
: "false" - Theo mặc định, số lượng loại hành động được giới hạn ở 20 bộ nhớ có số lượng hành động được thực thi lớn nhất. Việc đặt tuỳ chọn này sẽ ghi số liệu thống kê cho tất cả các bộ nhớ.
- Các tuỳ chọn chỉ định hoặc thay đổi dữ liệu đầu vào chung cho lệnh Bazel không thuộc các danh mục khác.:
- Giá trị mặc định của
--experimental_resolved_file_instead_of_workspace=<a string>
: "" -
Nếu không để trống, hãy đọc tệp đã giải quyết được chỉ định thay vì tệp WORKSPACE
Thẻ:changes_inputs
- Tuỳ chọn thực thi và lưu vào bộ nhớ đệm từ xa:
- Mặc định
--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ủ lưu trữ (cho `allow` và `block`) hoặc hai mẫu, một mẫu để so khớp và một mẫu để sử dụng làm URL thay thế, với các tham chiếu ngược bắt đầu từ `$1`. Bạn có thể cung cấp nhiều lệnh "ghi lại" cho cùng một URL và trong trường hợp này, hệ thống sẽ trả về nhiều URL.
- Các lựa chọn khác, không được phân loại theo cách khác.:
--override_repository=<an equals-separated mapping of repository name to path>
lần dùng được tích luỹ- Ghi đè kho lưu trữ bằng thư mục cục bộ.
Thẻ hiệu ứng tuỳ chọn
unknown |
Lựa chọn này có hiệu lực không xác định hoặc chưa đượ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 máy chủ khởi động lại hoặc việc vô hiệu hoá phần lớn biểu đồ phần phụ thuộc. |
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 cho bản dựng, chẳng hạn như các hạn chế về hệ thống tệp, phiên bản kho lưu trữ hoặc các tuỳ chọn khác. |
affects_outputs |
Tuỳ chọn này ảnh hưởng đến dữ liệu đầu ra của bazel. Thẻ này có phạm vi rộng có chủ đích, có thể bao gồm các ảnh hưởng bắc cầu và không chỉ định loại đầu ra mà thẻ ảnh hưởng. |
build_file_semantics |
Tuỳ chọn này ảnh hưởng đến ngữ nghĩa của tệp BUILD hoặc .bzl. |
bazel_internal_configuration |
Tuỳ chọn này ảnh hưởng đến các chế độ cài đặt của máy móc nội bộ trong bazel. Bản thân thẻ này không có nghĩa là các cấu phần phần mềm của bản dựng bị ảnh hưởng. |
loading_and_analysis |
Tuỳ chọn này ảnh hưởng đến việc tải và phân tích các phần phụ thuộc, cũng như việc tạo biểu đồ phần phụ thuộc. |
execution |
Tuỳ chọn này ảnh hưởng đến giai đoạn thực thi, chẳng hạn như hộp cát hoặc các tuỳ chọn liên quan đến thực thi từ xa. |
host_machine_resource_optimizations |
Lựa chọn này kích hoạt một tối ưu hoá có thể dành riêng cho từng máy và không đảm bảo hoạt động được trên tất cả các 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 của hiệu suất, chẳng hạn như bộ nhớ hoặc chi phí CPU. |
eagerness_to_exit |
Tuỳ chọn này thay đổi mức độ ứng dụng bazel thoát khi gặp lỗi, trong đó có lựa chọn tiếp tục dù không thành công hoặc kết thúc lệnh gọi. |
bazel_monitoring |
Tuỳ chọn này dùng để theo dõi hành vi và hiệu suất của bazel. |
terminal_output |
Tuỳ chọn này ảnh hưởng đến đầu ra của thiết bị đầu cuối 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 thao tác bản dựng. |
test_runner |
Tuỳ chọn này thay đổi môi trường kiểm thử của bản dựng. |
Thẻ siêu dữ liệu về lựa chọn
experimental |
Lựa 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 dùng lựa chọn này để kiểm tra mức độ sẵn sàng di chuyển của bạn hoặc nhận quyền truy cập sớm vào tính năng mới |
deprecated |
Tuỳ chọn này không được dùng nữa. Có thể tính năng ảnh hưởng không được dùng nữa hoặc ưu tiên một phương thức cung cấp thông tin khác. |
explicit_in_output_path |
Tuỳ chọn này được đề cập rõ ràng trong thư mục đầu ra. |