Hội viên
- action_is_enabled
- CcToolchainInfo
- compile
- configure_features
- create_cc_toolchain_config_info
- create_compilation_context
- create_compilation_outputs
- create_compile_variables
- create_library_to_link
- create_link_variables
- create_linker_input
- create_linking_context
- create_linking_context_from_compilation_outputs
- do_not_use_tools_cpp_compiler_present
- get_environment_variables
- get_execution_requirements
- get_memory_inefficient_command_line
- get_tool_for_action
- is_enabled
- link
- merge_cc_infos
- merge_compilation_contexts
- merge_compilation_outputs
action_is_enabled
bool cc_common.action_is_enabled(feature_configuration, action_name)Trả về True nếu action_config được bật trong cấu hình tính năng.
Thông số
Thông số | Nội dung mô tả |
---|---|
feature_configuration
|
bắt buộc Cấu hình tính năng cần truy vấn. |
action_name
|
bắt buộc Tên của action_config. |
CcToolchainInfo
Provider cc_common.CcToolchainInfoKhoá dùng để truy xuất trình cung cấp chứa thông tin về chuỗi công cụ C++ đang được sử dụng
compile
tuple cc_common.compile(actions, feature_configuration, cc_toolchain, srcs=[], public_hdrs=[], private_hdrs=[], includes=[], quote_includes=[], system_includes=[], framework_includes=[], defines=[], local_defines=[], include_prefix='', strip_include_prefix='', user_compile_flags=[], compilation_contexts=[], name, disallow_pic_outputs=False, disallow_nopic_outputs=False, additional_inputs=[], grep_includes=None)Phải được sử dụng để biên dịch C++. Trả về bộ dữ liệu của (
CompilationContext
, CcCompilationOutputs
).
Thông số
Thông số | Nội dung mô tả |
---|---|
actions
|
bắt buộc đối tượng actions .
|
feature_configuration
|
bắt buộcfeature_configuration để truy vấn.
|
cc_toolchain
|
bắt buộcCcToolchainInfo .
|
srcs
|
mặc định = [] Danh sách các tệp nguồn sẽ được biên dịch. |
public_hdrs
|
default = [] Danh sách tiêu đề cần thiết để biên dịch srcs và có thể được các quy tắc phụ thuộc đưa vào theo cách bắc cầu. |
private_hdrs
|
mặc định = [] Danh sách tiêu đề cần thiết để biên dịch src và KHÔNG đưa vào các quy tắc phụ thuộc. |
includes
|
default = [] Đường dẫn tìm kiếm tệp tiêu đề được tham chiếu theo cả dấu ngoặc góc và dấu ngoặc kép. Thường được truyền bằng -I. Truyền cho người phụ thuộc một cách bắc cầu. |
quote_includes
|
default = [] Đường dẫn tìm kiếm đến các tệp tiêu đề được tham chiếu trong dấu ngoặc kép, ví dụ: #include "foo/bar/header.h". Các giá trị này có thể tương đối với căn bậc thực thi hoặc tuyệt đối. Thường được chuyển kèm với -i ngôn ngữ. Truyền cho người phụ thuộc một cách bắc cầu. |
system_includes
|
default = [] Đường dẫn tìm kiếm cho các tệp tiêu đề được tham chiếu bằng dấu ngoặc nhọn, ví dụ: #include <foo/bar/header.h>. Các đường dẫn này có thể tương ứng với gốc executor hoặc tuyệt đối. Thường được truyền bằng -isystem. Truyền cho người phụ thuộc một cách bắc cầu. |
framework_includes
|
default = [] Đường dẫn tìm kiếm cho tệp tiêu đề trong khung của Apple. Các giá trị này có thể tương đối với căn bậc thực thi hoặc tuyệt đối. Thường được truyền với -F. Truyền cho người phụ thuộc một cách bắc cầu. |
defines
|
mặc định = [] Tập hợp các định nghĩa cần thiết để biên dịch mục tiêu này. Mỗi định nghĩa là một chuỗi. Truyền cho người phụ thuộc một cách bắc cầu. |
local_defines
|
mặc định = [] Tập hợp các định nghĩa cần thiết để biên dịch mục tiêu này. Mỗi định nghĩa là một chuỗi. Không được truyền cho các phần phụ thuộc một cách bắc cầu. |
include_prefix
|
mặc định = '' Tiền tố cần thêm vào đường dẫn của tiêu đề của quy tắc này. Khi được đặt, tiêu đề trong thuộc tính hdrs của quy tắc này có thể truy cập được tại là giá trị của thuộc tính này được thêm vào trước đường dẫn tương đối về kho lưu trữ. Tiền tố trong thuộc tínhtrip_include_prefix sẽ bị xoá trước khi thêm tiền tố này. |
strip_include_prefix
|
default = '' Tiền tố cần xoá khỏi đường dẫn của tiêu đề của quy tắc này. Khi được đặt, tiêu đề trong thuộc tính hdrs của quy tắc này có thể truy cập được tại đường dẫn của chúng với tiền tố này bị cắt bỏ. Nếu đó là đường dẫn tương đối, thì tiêu đề đó được coi là đường dẫn tương đối cho gói. Nếu đó là giá trị tuyệt đối, thì URL đó được hiểu là đường dẫn tương đối với kho lưu trữ. Tiền tố trong thuộc tính include_prefix được thêm vào sau khi đã xoá tiền tố này. |
user_compile_flags
|
mặc định = [] Danh sách tuỳ chọn biên dịch bổ sung. |
compilation_contexts
|
mặc định = [] Tiêu đề từ các phần phụ thuộc dùng để biên dịch. |
name
|
bắt buộc Giá trị này dùng để đặt tên cấu phần phần mềm đầu ra của các thao tác được tạo bằng phương thức này. Hãy xem thêm đối số `main_output`. |
disallow_pic_outputs
|
mặc định = Sai Có nên tạo đầu ra PIC hay không. |
disallow_nopic_outputs
|
default = False Có nên tạo đầu ra NOPIC hay không. |
additional_inputs
|
mặc định = [] Danh sách tệp bổ sung cần thiết để biên dịch srcs |
grep_includes
|
File; or None ;
mặc định = Không có |
configure_features
FeatureConfiguration cc_common.configure_features(ctx=None, cc_toolchain, language=None, requested_features=[], unsupported_features=[])Tạo một thực thể Feature_ configuration (Cấu hình tính năng). Yêu cầu mảnh cấu hình cpp.
Thông số
Thông số | Nội dung mô tả |
---|---|
ctx
|
ctx; or None ;
mặc định = Không cóNgữ cảnh của quy tắc. |
cc_toolchain
|
bắt buộc cc_toolchain để chúng ta định cấu hình các tính năng. |
language
|
string; or None ;
mặc định = Không cóNgôn ngữ cần định cấu hình: c++ hoặc objc (c++ mặc định) |
requested_features
|
mặc định = [] Danh sách các tính năng được bật. |
unsupported_features
|
mặc định = [] Danh sách các tính năng mà quy tắc hiện tại không hỗ trợ. |
create_cc_toolchain_config_info
CcToolchainConfigInfo cc_common.create_cc_toolchain_config_info(ctx, features=[], action_configs=[], artifact_name_patterns=[], cxx_builtin_include_directories=[], toolchain_identifier, host_system_name=None, target_system_name, target_cpu, target_libc, compiler, abi_version=None, abi_libc_version=None, tool_paths=[], make_variables=[], builtin_sysroot=None, cc_target_os=None)Tạo nhà cung cấp
CcToolchainConfigInfo
Thông số
Thông số | Nội dung mô tả |
---|---|
ctx
|
bắt buộc Ngữ cảnh quy tắc. |
features
|
mặc định = [] Danh sách tính năng. |
action_configs
|
default = [] Danh sách action_configs. |
artifact_name_patterns
|
default = [] Danh sách artifact_name_patterns. |
cxx_builtin_include_directories
|
mặc định = [] Các thư mục include được tích hợp sẵn để biên dịch C++. Đây phải là các đường dẫn chính xác mà trình biên dịch sử dụng và thường tương ứng với thư mục gốc của executor. Bạn có thể xác định các đường dẫn mà trình biên dịch sử dụng bằng "gcc -E -xc++ - -v". Hiện tại, chúng tôi cũng sử dụng đường dẫn C++ để biên dịch C, cách này an toàn miễn là không có sự xung đột về tên giữa các tệp tiêu đề C++ và C. Đường dẫn tương đối được phân giải so với thư mục tệp cấu hình. Nếu trình biên dịch có hỗ trợ --sysroot, thì các đường dẫn này sẽ sử dụng %sysroot% thay vì đường dẫn bao gồm và chỉ định thuộc tính sysroot để cung cấp thông tin cần thiết nhằm thực hiện thay thế chính xác. |
toolchain_identifier
|
bắt buộc Giá trị nhận dạng duy nhất của chuỗi công cụ trong bản phát hành công cụ chéo. Bạn phải có thể dùng tên này làm tên thư mục trong đường dẫn. Thuộc tính này phải khớp với biểu thức chính quy sau: [a-zA-Z_][\.\- \w]* |
host_system_name
|
string; or None ;
mặc định = KhôngBỏ qua. |
target_system_name
|
bắt buộc Tên hệ thống GNU. |
target_cpu
|
bắt buộc Chuỗi cấu trúc mục tiêu. |
target_libc
|
bắt buộc Chuỗi phiên bản libc (ví dụ: "glibc-2.2.2"). |
compiler
|
bắt buộc Chuỗi phiên bản trình biên dịch (ví dụ: "gcc-4.1.1"). |
abi_version
|
string; or None ;
mặc định = Không cóAbi đang được sử dụng, là một phiên bản gcc. E.g.: "gcc-3.4" |
abi_libc_version
|
string; or None ;
mặc định = Không cóPhiên bản glibc mà abi mà chúng ta đang sử dụng. |
tool_paths
|
default = [] Danh sách tool_paths (đường dẫn công cụ). |
make_variables
|
mặc định = [] Danh sách make_variables. |
builtin_sysroot
|
string; or None ;
mặc định = Không cósysroot tích hợp. Nếu không có thuộc tính này, Bazel không cho phép sử dụng một sysroot khác, tức là thông qua tuỳ chọn --grte_top. |
cc_target_os
|
string; or None ;
mặc định = KhôngChỉ sử dụng nội bộ, không sử dụng. |
create_compilation_context
CompilationContext cc_common.create_compilation_context(headers=unbound, system_includes=unbound, includes=unbound, quote_includes=unbound, framework_includes=unbound, defines=unbound, local_defines=unbound)Tạo một
CompilationContext
.
Thông số
Thông số | Nội dung mô tả |
---|---|
headers
|
mặc định = không bị ràng buộc Tập hợp các tiêu đề cần thiết để biên dịch mục tiêu này |
system_includes
|
default = unbound Tập hợp đường dẫn tìm kiếm cho các tệp tiêu đề được tham chiếu bằng dấu ngoặc nhọn, tức là #include <foo/bar/header.h>. Chúng có thể là tương đối với gốc executor hoặc tuyệt đối. Thường được truyền cùng với -isystem |
includes
|
mặc định = không giới hạn Tập hợp các đường dẫn tìm kiếm cho các tệp tiêu đề được tham chiếu bằng cả dấu ngoặc góc và dấu ngoặc kép.Thường được truyền bằng -I |
quote_includes
|
default = unbound Tập hợp đường dẫn tìm kiếm cho các tệp tiêu đề được tham chiếu trong dấu ngoặc kép, tức là #include "foo/bar/header.h". Các giá trị này có thể tương đối với căn bậc thực thi hoặc tuyệt đối. Thường được bỏ qua kèm theo -i tiền |
framework_includes
|
mặc định = không liên kết Tập hợp đường dẫn tìm kiếm khung cho các tệp tiêu đề (chỉ dành cho nền tảng Apple) |
defines
|
mặc định = không bị ràng buộc Tập hợp các định nghĩa cần thiết để biên dịch mục tiêu này. Mỗi định nghĩa là một chuỗi. Được truyền bắc cầu cho người phụ thuộc. |
local_defines
|
mặc định = không bị ràng buộc Tập hợp các định nghĩa cần thiết để biên dịch mục tiêu này. Mỗi định nghĩa là một chuỗi. Không được truyền bắc cầu đến các phần phụ thuộc. |
create_compilation_outputs
CcCompilationOutputs cc_common.create_compilation_outputs(objects=None, pic_objects=None)Tạo đối tượng đầu ra biên dịch.
Thông số
Thông số | Nội dung mô tả |
---|---|
objects
|
depset; or None ;
mặc định = Không cóDanh sách các tệp đối tượng. |
pic_objects
|
depset; or None ;
mặc định = KhôngDanh sách các tệp đối tượng ảnh. |
create_compile_variables
Variables cc_common.create_compile_variables(cc_toolchain, feature_configuration, source_file=None, output_file=None, user_compile_flags=None, include_directories=None, quote_include_directories=None, system_include_directories=None, framework_include_directories=None, preprocessor_defines=None, thinlto_index=None, thinlto_input_bitcode_file=None, thinlto_output_object_file=None, use_pic=False, add_legacy_cxx_options=False, variables_extension=unbound)Trả về các biến dùng cho thao tác biên dịch.
Thông số
Thông số | Nội dung mô tả |
---|---|
cc_toolchain
|
bắt buộc cc_toolchain mà chúng tôi đang tạo biến xây dựng. |
feature_configuration
|
bắt buộc Cấu hình tính năng cần truy vấn. |
source_file
|
mặc định = Không có Tệp nguồn không bắt buộc để biên dịch. Vui lòng ưu tiên chuyển source_file ở đây thay vì thêm vào cuối dòng lệnh được tạo từ cc_common.get_memory_ineffective_command_line, vì sau đó, tuỳ chọn này thuộc quyền hạn của tác giả chuỗi công cụ để chỉ định và định vị các cờ trình biên dịch một cách chính xác. |
output_file
|
mặc định = Không có Tệp đầu ra không bắt buộc của quá trình biên dịch. Vui lòng chuyển output_file tại đây thay vì thêm output_file vào cuối dòng lệnh được tạo từ cc_common.get_memory_ineffective_command_line, vì khi đó, hàm này có quyền hạn của tác giả chuỗi công cụ để chỉ định và định vị chính xác cờ trình biên dịch. |
user_compile_flags
|
sequence of strings; or None ;
mặc định = KhôngDanh sách cờ biên dịch bổ sung (copts). |
include_directories
|
depset; or None ;
mặc định = KhôngTập hợp các thư mục include. |
quote_include_directories
|
depset; or None ;
mặc định = KhôngSố tệp trích dẫn bao gồm các thư mục. |
system_include_directories
|
depset; or None ;
mặc định = KhôngTập hợp hệ thống bao gồm các thư mục. |
framework_include_directories
|
depset; or None ;
mặc định = Không cóPhần khởi động của khung bao gồm các thư mục. |
preprocessor_defines
|
depset; or None ;
mặc định = KhôngGiá trị khởi động của bộ tiền xử lý xác định. |
thinlto_index
|
string; or None ;
mặc định = KhôngĐường dẫn tệp chỉ mục LTO. |
thinlto_input_bitcode_file
|
string; or None ;
mặc định = KhôngTệp mã bit được đưa vào phần phụ trợ LTO. |
thinlto_output_object_file
|
string; or None ;
mặc định = KhôngTệp đối tượng do phần phụ trợ LTO xuất ra. |
use_pic
|
mặc định = Sai Khi là true, quá trình biên dịch sẽ tạo mã độc lập với vị trí. |
add_legacy_cxx_options
|
mặc định = Sai Không sử dụng. |
variables_extension
|
dict ;
mặc định = không liên kếtTừ điển gồm các biến bổ sung mà các thao tác biên dịch sử dụng. |
create_library_to_link
LibraryToLink cc_common.create_library_to_link(actions, feature_configuration=None, cc_toolchain=None, static_library=None, pic_static_library=None, dynamic_library=None, interface_library=None, pic_objects=unbound, objects=unbound, alwayslink=False, dynamic_library_symlink_path='', interface_library_symlink_path='')Tạo
LibraryToLink
Thông số
Thông số | Nội dung mô tả |
---|---|
actions
|
bắt buộc đối tượng actions .
|
feature_configuration
|
mặc định = Không cófeature_configuration nào được truy vấn.
|
cc_toolchain
|
mặc định = Không có nhà cung cấpCcToolchainInfo nào được sử dụng.
|
static_library
|
File; or None ;
mặc định = Không cóFile của thư viện tĩnh cần liên kết.
|
pic_static_library
|
File; or None ;
mặc định = KhôngFile của thư viện tĩnh về ảnh cần liên kết.
|
dynamic_library
|
File; or None ;
mặc định = Không cóFile thư viện động cần liên kết. Luôn được dùng cho thời gian chạy và được dùng để liên kết nếu không truyền interface_library .
|
interface_library
|
File; or None ;
mặc định = Không cóFile thư viện giao diện cần liên kết.
|
pic_objects
|
sequence of Files ;
mặc định = không liên kếtThử nghiệm, không sử dụng |
objects
|
sequence of Files ;
mặc định = không liên kếtThử nghiệm, không sử dụng |
alwayslink
|
mặc định = Sai Liệu có liên kết thư viện/đối tượng tĩnh trong khối --wiling_lưu hay không. |
dynamic_library_symlink_path
|
string ;
default = ''Ghi đè đường dẫn mặc định của đường liên kết đến thư viện động trong thư mục solib. Hãy để trống chuỗi để sử dụng giá trị mặc định. |
interface_library_symlink_path
|
default = '' Ghi đè đường dẫn mặc định của đường liên kết đến thư viện giao diện trong thư mục solib. Hãy để trống chuỗi để sử dụng giá trị mặc định. |
create_link_variables
Variables cc_common.create_link_variables(cc_toolchain, feature_configuration, library_search_directories=None, runtime_library_search_directories=None, user_link_flags=None, output_file=None, param_file=None, def_file=None, is_using_linker=True, is_linking_dynamic_library=False, must_keep_debug=True, use_test_only_flags=False, is_static_linking_mode=True)Trả về các biến liên kết được dùng cho các hành động liên kết.
Thông số
Thông số | Nội dung mô tả |
---|---|
cc_toolchain
|
bắt buộc cc_toolchain mà chúng tôi đang tạo biến xây dựng. |
feature_configuration
|
bắt buộc Cấu hình tính năng cần truy vấn. |
library_search_directories
|
None; or depset ;
mặc định = KhôngTập hợp các thư mục mà trình liên kết sẽ tìm thư viện tại thời điểm liên kết. |
runtime_library_search_directories
|
None; or depset ;
mặc định = KhôngTập hợp các thư mục mà trình tải sẽ tìm thư viện trong thời gian chạy. |
user_link_flags
|
None; or sequence ;
mặc định = Không cóDanh sách cờ liên kết bổ sung (linkopts). |
output_file
|
mặc định = Không có Đường dẫn tệp đầu ra không bắt buộc. |
param_file
|
mặc định = Không có Đường dẫn tệp tham số không bắt buộc. |
def_file
|
mặc định = Không có Đường dẫn tệp .def không bắt buộc. |
is_using_linker
|
default = True True khi sử dụng trình liên kết, False khi dùng trình lưu trữ. Phương thức gọi có trách nhiệm đồng bộ hoá tên này với tên hành động được sử dụng (is_using_linker = True để liên kết thư viện thực thi hoặc thư viện động, is_using_linker = False để lưu trữ thư viện tĩnh). |
is_linking_dynamic_library
|
default = False True khi tạo thư viện động, False khi thực thi hoặc thư viện tĩnh. Phương thức gọi có trách nhiệm đồng bộ hoá tên này với tên thao tác được sử dụng. Trường này sẽ bị xoá sau khi b/65151735 được sửa. |
must_keep_debug
|
default = True Khi đặt thành True, bazel sẽ hiển thị biến 'strip_debug_symbols', biến này thường dùng để sử dụng trình liên kết nhằm loại bỏ các biểu tượng gỡ lỗi khỏi tệp đầu ra. |
use_test_only_flags
|
mặc định = Sai Khi được đặt thành true, biến "is_cc_test" sẽ được đặt. |
is_static_linking_mode
|
mặc định = Đúng Không sử dụng. |
create_linker_input
LinkerInput cc_common.create_linker_input(owner, libraries=None, user_link_flags=None, additional_inputs=None)Tạo một
LinkerInput
.
Thông số
Thông số | Nội dung mô tả |
---|---|
owner
|
bắt buộc Nhãn của mục tiêu đã tạo ra tất cả các tệp được sử dụng trong dữ liệu nhập này. |
libraries
|
None; or depset ;
mặc định = KhôngDanh sách LibraryToLink .
|
user_link_flags
|
None; or depset of strings; or sequence of strings ;
mặc định = KhôngCờ liên kết người dùng được chuyển dưới dạng chuỗi. Chấp nhận [String], [[String]] hoặc depset(String). Bạn không nên sử dụng tuỳ chọn thứ hai vì nó chỉ được giữ lại cho mục đích tương thích, phần phụ thuộc sẽ được làm phẳng. Nếu bạn muốn truyền user_link_flags thông qua depsets() không bị phẳng, hãy gói chúng trong LinksInput để chúng không được làm phẳng cho đến cuối. |
additional_inputs
|
None; or depset ;
mặc định = Không cóĐối với dữ liệu đầu vào bổ sung cho hành động liên kết, ví dụ: tập lệnh liên kết. |
create_linking_context
LinkingContext cc_common.create_linking_context(linker_inputs=None, libraries_to_link=None, user_link_flags=None, additional_inputs=None)Tạo một
LinkingContext
.
Thông số
Thông số | Nội dung mô tả |
---|---|
linker_inputs
|
None; or depset ;
mặc định = KhôngGiá trị đặt trước của LinkerInput .
|
libraries_to_link
|
None; or sequence ;
mặc định = KhôngKhông dùng nữa. Tham số này không được dùng nữa và sẽ sớm bị xoá. Vui lòng không phụ thuộc vào công cụ này. Tính năng này bị tắt bằng --+incompatible_require_linker_input_cc_api . Sử dụng cờ này để xác minh rằng mã của bạn tương thích với việc mã sắp bị xoá. Danh sách LibraryToLink .
|
user_link_flags
|
None; or sequence ;
mặc định = KhôngKhông dùng nữa. Tham số này không được dùng nữa và sẽ sớm bị xoá. Vui lòng không phụ thuộc vào công cụ này. Tính năng này bị tắt bằng --+incompatible_require_linker_input_cc_api . Sử dụng cờ này để xác minh rằng mã của bạn tương thích với việc mã sắp bị xoá. Danh sách cờ liên kết của người dùng được truyền dưới dạng chuỗi. |
additional_inputs
|
None; or sequence ;
mặc định = KhôngKhông dùng nữa. Tham số này không được dùng nữa và sẽ sớm bị xoá. Vui lòng không phụ thuộc vào công cụ này. Tính năng này bị tắt bằng --+incompatible_require_linker_input_cc_api . Sử dụng cờ này để xác minh rằng mã của bạn tương thích với việc mã sắp bị xoá. Đối với các dữ liệu đầu vào bổ sung cho hành động liên kết, ví dụ: liên kết tập lệnh. |
create_linking_context_from_compilation_outputs
tuple cc_common.create_linking_context_from_compilation_outputs(actions, feature_configuration, cc_toolchain, compilation_outputs, user_link_flags=[], linking_contexts=[], name, language='c++', alwayslink=False, additional_inputs=[], disallow_static_libraries=False, disallow_dynamic_library=False, grep_includes=None)Nên dùng để tạo các quy tắc của thư viện có thể truyền thông tin xuống dưới để được liên kết sau này bằng một quy tắc cấp cao nhất có chức năng liên kết bắc cầu để tạo một thư viện động hoặc thực thi. Trả về bộ dữ liệu của (
CcLinkingContext
, CcLinkingOutputs
).
Thông số
Thông số | Nội dung mô tả |
---|---|
actions
|
bắt buộc đối tượng actions .
|
feature_configuration
|
bắt buộcfeature_configuration để truy vấn.
|
cc_toolchain
|
bắt buộcCcToolchainInfo .
|
compilation_outputs
|
bắt buộc Kết quả biên dịch chứa các tệp đối tượng cần liên kết. |
user_link_flags
|
mặc định = [] Danh sách các lựa chọn liên kết bổ sung. |
linking_contexts
|
mặc định = [] Thư viện từ phần phụ thuộc. Các thư viện này sẽ được liên kết với cấu phần phần mềm đầu ra của lệnh gọi link(), cho dù đó là tệp nhị phân hoặc thư viện. |
name
|
bắt buộc Giá trị này dùng để đặt tên cấu phần phần mềm đầu ra của các thao tác được tạo bằng phương thức này. |
language
|
default = 'c++' Hiện chỉ hỗ trợ C++. Đừng sử dụng tham số này. |
alwayslink
|
mặc định = Sai Có phải luôn liên kết thư viện này hay không. |
additional_inputs
|
mặc định = [] Đối với dữ liệu đầu vào bổ sung cho hành động liên kết, ví dụ: tập lệnh liên kết. |
disallow_static_libraries
|
mặc định = Sai Có nên tạo thư viện tĩnh hay không. |
disallow_dynamic_library
|
mặc định = Sai Có nên tạo thư viện động hay không. |
grep_includes
|
File; or None ;
mặc định = Không có |
do_not_use_tools_cpp_compiler_present
None cc_common.do_not_use_tools_cpp_compiler_presentKhông sử dụng trường này, mục đích duy nhất của trường này là giúp di chuyển từ config_setting.values{'compiler') sang config_settings.flag_values{'@bazel_tools//tools/cpp:compiler'}
get_environment_variables
dict cc_common.get_environment_variables(feature_configuration, action_name, variables)Trả về các biến môi trường cần đặt cho hành động cụ thể.
Thông số
Thông số | Nội dung mô tả |
---|---|
feature_configuration
|
bắt buộc Cấu hình tính năng cần truy vấn. |
action_name
|
bắt buộc Tên hành động. Phải là một trong những tên trong @bazel_tools//tools/build_defs/cc:action_names.bzl (https://github.com/bazelbuild/bazel/blob/master/tools/build_defs/cc/action_names.bzl) |
variables
|
bắt buộc Biến bản dựng dùng để mở rộng mẫu. |
get_execution_requirements
sequence cc_common.get_execution_requirements(feature_configuration, action_name)Trả về yêu cầu thực thi của một hành động cụ thể.
Thông số
Thông số | Nội dung mô tả |
---|---|
feature_configuration
|
bắt buộc Cấu hình tính năng cần truy vấn. |
action_name
|
bắt buộc Tên hành động. Phải là một trong những tên trong @bazel_tools//tools/build_defs/cc:action_names.bzl (https://github.com/bazelbuild/bazel/blob/master/tools/build_defs/cc/action_names.bzl) |
get_memory_inefficient_command_line
sequence cc_common.get_memory_inefficient_command_line(feature_configuration, action_name, variables)Trả về cờ hiệu dòng lệnh đã làm phẳng cho hành động cụ thể, sử dụng các biến đã cho để mở rộng. Làm phẳng các tập hợp lồng ghép và tốt nhất là không nên sử dụng hoặc ít nhất là không nên phân tích lâu hơn. Đang xử lý hàm hiệu quả về bộ nhớ trả về Args.
Thông số
Thông số | Nội dung mô tả |
---|---|
feature_configuration
|
bắt buộc Cấu hình tính năng cần truy vấn. |
action_name
|
bắt buộc Tên hành động. Phải là một trong những tên trong @bazel_tools//tools/build_defs/cc:action_names.bzl (https://github.com/bazelbuild/bazel/blob/master/tools/build_defs/cc/action_names.bzl) |
variables
|
bắt buộc Biến bản dựng dùng để mở rộng mẫu. |
get_tool_for_action
string cc_common.get_tool_for_action(feature_configuration, action_name)Trả về đường dẫn công cụ cho thao tác cụ thể.
Thông số
Thông số | Nội dung mô tả |
---|---|
feature_configuration
|
bắt buộc Cấu hình tính năng cần truy vấn. |
action_name
|
bắt buộc Tên hành động. Phải là một trong những tên trong @bazel_tools//tools/build_defs/cc:action_names.bzl (https://github.com/bazelbuild/bazel/blob/master/tools/build_defs/cc/action_names.bzl) |
is_enabled
bool cc_common.is_enabled(feature_configuration, feature_name)Trả về True nếu tính năng đã cho được bật trong cấu hình tính năng.
Thông số
Thông số | Nội dung mô tả |
---|---|
feature_configuration
|
bắt buộc Cấu hình tính năng cần truy vấn. |
feature_name
|
bắt buộc Tên tính năng. |
đường liên kết
CcLinkingOutputs cc_common.link(actions, feature_configuration, cc_toolchain, compilation_outputs=None, user_link_flags=[], linking_contexts=[], name, language='c++', output_type='executable', link_deps_statically=True, stamp=0, additional_inputs=[], grep_includes=None, additional_outputs=unbound)Phải được sử dụng cho liên kết bắc cầu C++.
Thông số
Thông số | Nội dung mô tả |
---|---|
actions
|
bắt buộc đối tượng actions .
|
feature_configuration
|
bắt buộcfeature_configuration để truy vấn.
|
cc_toolchain
|
bắt buộcCcToolchainInfo .
|
compilation_outputs
|
CcCompilationOutputs; or None ;
mặc định = KhôngKết quả biên dịch chứa các tệp đối tượng cần liên kết. |
user_link_flags
|
default = [] Danh sách bổ sung về trình liên kết. |
linking_contexts
|
mặc định = [] Liên kết ngữ cảnh từ các phần phụ thuộc cần liên kết với ngữ cảnh liên kết do quy tắc này tạo ra. |
name
|
bắt buộc Giá trị này dùng để đặt tên cấu phần phần mềm đầu ra của các thao tác được tạo bằng phương thức này. |
language
|
default = 'c++' Hiện chỉ hỗ trợ C++. Đừng sử dụng tham số này. |
output_type
|
default = 'executable' Có thể là "executable" hoặc "dynamic_library". |
link_deps_statically
|
default = True True để liên kết các phần phụ thuộc theo cách tĩnh, False một cách linh động. |
stamp
|
default = 0 Liệu có đưa thông tin bản dựng vào tệp thực thi được liên kết hay không, trong trường hợp output_type là "executable" (có thể thực thi). Nếu là 1, thông tin bản dựng sẽ luôn được đưa vào. Nếu là 0 (thông tin bản dựng mặc định luôn bị loại trừ. Nếu là -1, sẽ sử dụng hành vi mặc định và có thể bị cờ --[no]tem ghi đè. Bạn không nên đặt (hoặc đặt thành 0) khi tạo đầu ra có thể thực thi cho các quy tắc kiểm thử. |
additional_inputs
|
sequence; or depset ;
mặc định = []Đối với dữ liệu đầu vào bổ sung cho hành động liên kết, ví dụ: liên kết tập lệnh. |
grep_includes
|
File; or None ;
mặc định = Không có |
additional_outputs
|
sequence ;
default = unboundĐối với đầu ra bổ sung cho hành động liên kết, ví dụ: tệp bản đồ. |
merge_cc_infos
CcInfo cc_common.merge_cc_infos(direct_cc_infos=[], cc_infos=[])Hợp nhất nhiều
CcInfo
thành một.
Thông số
Thông số | Nội dung mô tả |
---|---|
direct_cc_infos
|
default = [] Danh sách CcInfo cần hợp nhất, trong đó tiêu đề sẽ được xuất bằng các trường trực tiếp trong nhà cung cấp được trả về.
|
cc_infos
|
default = [] Danh sách CcInfo cần hợp nhất, trong đó tiêu đề sẽ không được xuất bởi các trường trực tiếp trong nhà cung cấp được trả về.
|
merge_compilation_contexts
CompilationContext cc_common.merge_compilation_contexts(compilation_contexts=[])Hợp nhất nhiều
CompilationContexts
thành một.
Thông số
Thông số | Nội dung mô tả |
---|---|
compilation_contexts
|
mặc định = [] Danh sách CompilationContexts cần hợp nhất. Tiêu đề của mỗi ngữ cảnh sẽ được các trường trực tiếp xuất trong trình cung cấp được trả về.
|
merge_compilation_outputs
CcCompilationOutputs cc_common.merge_compilation_outputs(compilation_outputs=[])Hợp nhất các kết quả biên dịch.
Thông số
Thông số | Nội dung mô tả |
---|---|
compilation_outputs
|
mặc định = [] |