cc_common

Utilitas untuk kompilasi, penautan, dan pembuatan command line C++.

Anggota

action_is_enabled

bool cc_common.action_is_enabled(feature_configuration, action_name)

Menampilkan True (Benar) jika action_config tertentu diaktifkan dalam konfigurasi fitur.

Parameter

Parameter Deskripsi
feature_configuration required
Konfigurasi fitur yang akan dikueri.
action_name required
Nama action_config.

CcToolchainInfo

Provider cc_common.CcToolchainInfo

Kunci yang digunakan untuk mengambil penyedia yang berisi informasi tentang toolchain C++ yang digunakan

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)

Harus digunakan untuk kompilasi C++. Menampilkan tuple (CompilationContext, CcCompilationOutputs).

Parameter

Parameter Deskripsi
actions objek
actions yang diperlukan.
feature_configuration diperlukan
feature_configuration untuk dikueri.
cc_toolchain penyedia
CcToolchainInfo yang diperlukan untuk digunakan.
srcs default = []
Daftar file sumber yang akan dikompilasi.
public_hdrs default = []
Daftar header yang diperlukan untuk kompilasi src dan dapat disertakan secara transitif oleh aturan dependen.
private_hdrs default = []
Daftar header yang diperlukan untuk kompilasi src dan TIDAK boleh disertakan oleh aturan dependen.
includes default = []
Jalur penelusuran untuk file header yang dirujuk oleh tanda kurung sudut dan tanda petik. Biasanya diteruskan dengan -I. Ditransmisikan secara transitif ke dependen.
quote_includes default = []
Jalur penelusuran untuk file header yang dirujuk oleh tanda kutip, misalnya #include "foo/bar/header.h". Jalur tersebut dapat bersifat relatif terhadap root exec atau absolut. Biasanya diteruskan dengan -iquote. Ditransmisikan secara transitif ke dependen.
system_includes default = []
Telusuri jalur untuk file header yang dirujuk oleh tanda kurung sudut, misalnya #include <foo/bar/header.h>. Jalur ini dapat bersifat relatif terhadap root exec atau absolut. Biasanya diteruskan dengan -isystem. Ditransmisikan secara transitif ke dependen.
framework_includes default = []
Jalur penelusuran untuk file header dari framework Apple. Jalur tersebut dapat bersifat relatif terhadap root exec atau absolut. Biasanya diteruskan dengan -F. Ditransmisikan secara transitif ke dependen.
defines default = []
Kumpulan definisi yang diperlukan untuk mengompilasi target ini. Setiap definisi adalah string. Ditransmisikan secara transitif ke dependen.
local_defines default = []
Kumpulan definisi yang diperlukan untuk mengompilasi target ini. Setiap definisi adalah string. Tidak disebarkan secara transitif ke dependen.
include_prefix default = ''
Awalan yang akan ditambahkan ke jalur header aturan ini. Jika ditetapkan, header dalam atribut hdrs aturan ini dapat diakses di nilai atribut ini yang ditambahkan di awal jalur relatif repositorinya. Awalan dalam atribut strip_include_prefix dihapus sebelum awalan ini ditambahkan.
strip_include_prefix default = ''
Awalan yang akan dihapus dari jalur header aturan ini. Jika ditetapkan, header dalam atribut hdrs aturan ini dapat diakses di jalurnya dengan awalan ini dipotong. Jika merupakan jalur relatif, jalur tersebut akan dianggap sebagai jalur relatif paket. Jika bersifat absolut, jalur ini akan dipahami sebagai jalur relatif repositori. Awalan dalam atribut include_prefix ditambahkan setelah awalan ini dihapus.
user_compile_flags default = []
Daftar opsi kompilasi tambahan.
compilation_contexts default = []
Header dari dependensi yang digunakan untuk kompilasi.
name required
Ini digunakan untuk memberi nama artefak output tindakan yang dibuat oleh metode ini. Lihat juga argumen `main_output`.
disallow_pic_outputs default = False
Apakah output PIC harus dibuat.
disallow_nopic_outputs default = False
Apakah output NOPIC harus dibuat.
additional_inputs default = []
Daftar file tambahan yang diperlukan untuk kompilasi src
grep_includes File; or None; default = None

configure_features

FeatureConfiguration cc_common.configure_features(ctx=None, cc_toolchain, language=None, requested_features=[], unsupported_features=[])

Membuat instance feature_configuration. Memerlukan fragmen konfigurasi cpp.

Parameter

Parameter Deskripsi
ctx ctx; or None; default = None
Konteks aturan.
cc_toolchain cc_toolchain
yang diperlukan untuk mengonfigurasi fitur.
language string; or None; default = None
Bahasa yang akan dikonfigurasi untuk: c++ atau objc (default c++)
requested_features default = []
Daftar fitur yang akan diaktifkan.
unsupported_features default = []
Daftar fitur yang tidak didukung oleh aturan saat ini.

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)

Membuat penyedia CcToolchainConfigInfo

Parameter

Parameter Deskripsi
ctx required
Konteks aturan.
features default = []

Berisi semua spesifikasi flag untuk satu fitur.

Argumen:

name: Nama fitur. Anda dapat memperkenalkan fitur tanpa perubahan pada Bazel dengan menambahkan bagian 'feature' ke toolchain dan menambahkan string yang sesuai sebagai fitur dalam file BUILD.

enabled: Jika 'True', fitur ini diaktifkan kecuali jika jenis aturan secara eksplisit menandainya sebagai tidak didukung.

flag_sets: Daftar FlagSet - Jika fitur tertentu diaktifkan, kumpulan flag akan diterapkan untuk tindakan yang ditentukan.

env_sets: daftar EnvSet - Jika fitur tertentu diaktifkan, set env akan diterapkan untuk tindakan yang ditentukan.

requires: Daftar kumpulan fitur yang menentukan kapan fitur ini didukung oleh toolchain. Fitur ini didukung jika salah satu set fitur diterapkan sepenuhnya, yaitu saat semua fitur set fitur diaktifkan. Jika 'requires' dihilangkan, fitur akan didukung secara terpisah dari fitur lain yang diaktifkan. Gunakan ini misalnya untuk memfilter flag bergantung pada mode build yang diaktifkan (opt / fastbuild / dbg).

implies: Daftar string fitur atau konfigurasi tindakan yang otomatis diaktifkan saat fitur ini diaktifkan. Jika salah satu fitur tersirat atau konfigurasi tindakan tidak dapat diaktifkan, fitur ini juga tidak akan diaktifkan (secara otomatis).

provides: Daftar nama yang bertentangan dengan fitur ini.

Fitur tidak dapat diaktifkan jika:
- 'provides' berisi nama fitur atau konfigurasi tindakan lain yang ingin kita aktifkan.
- 'provides' berisi nilai yang sama dengan 'provides' dalam fitur atau konfigurasi tindakan lain yang ingin kita aktifkan. Gunakan ini untuk memastikan bahwa fitur yang tidak kompatibel tidak dapat diaktifkan secara tidak sengaja secara bersamaan, sehingga menyebabkan error compiler yang sulit didiagnosis.
action_configs default = []

Konfigurasi tindakan sesuai dengan tindakan Bazel, dan memungkinkan pemilihan alat berdasarkan fitur yang diaktifkan. Aktivasi konfigurasi tindakan terjadi dengan semantik yang sama seperti fitur: fitur dapat 'memerlukan' atau 'mengasumsikan' konfigurasi tindakan dengan cara yang sama seperti fitur lainnya.

Argumen:

action_name: Nama tindakan Bazel yang diterapkan konfigurasi ini, misalnya 'c-compile' atau 'c-module-compile'.

enabled: Jika 'True', tindakan ini diaktifkan kecuali jika jenis aturan secara eksplisit menandainya sebagai tidak didukung.

tools: Alat yang diterapkan ke tindakan akan menjadi Alat pertama dengan kumpulan fitur yang cocok dengan konfigurasi fitur. Error akan ditampilkan jika tidak ada alat yang cocok dengan konfigurasi fitur yang diberikan. Oleh karena itu, sebaiknya berikan alat default dengan kumpulan fitur kosong.

flag_sets: Jika konfigurasi tindakan yang diberikan diaktifkan, kumpulan flag akan diterapkan ke tindakan yang sesuai.

implies: Daftar fitur atau konfigurasi tindakan yang otomatis diaktifkan saat konfigurasi tindakan ini diaktifkan. Jika salah satu fitur tersirat atau konfigurasi tindakan tidak dapat diaktifkan, konfigurasi tindakan ini juga tidak akan diaktifkan (secara otomatis).
artifact_name_patterns default = []

Nama untuk artefak dari kategori artefak input atau output tertentu ke tindakan.

Argumen:

category_name: Kategori artefak yang menjadi sasaran pilihan ini. Kolom ini dibandingkan dengan daftar kategori yang ditentukan di Bazel. Contoh kategori mencakup "linked_output" atau artefak untuk pilihan ini. Bersama dengan ekstensi, nama ini digunakan untuk membuat nama artefak berdasarkan nama target.

ekstensi: Ekstensi untuk membuat artefak untuk pilihan ini. Bersama dengan awalan, nama ini digunakan untuk membuat nama artefak berdasarkan nama target.
cxx_builtin_include_directories default = []

Direktori include bawaan untuk kompilasi C++. Ini harus berupa jalur persis yang digunakan oleh compiler, dan umumnya relatif terhadap root exec.

Jalur yang digunakan oleh compiler dapat ditentukan dengan 'gcc -E -xc++ - -v'.

Saat ini kami juga menggunakan jalur C++ untuk kompilasi C, yang aman selama tidak ada bentrok nama antara file header C++ dan C.

Jalur relatif di-resolve secara relatif terhadap direktori file konfigurasi.

Jika compiler memiliki dukungan --sysroot, jalur ini harus menggunakan %sysroot%, bukan jalur include, dan menentukan atribut sysroot untuk memberikan informasi yang diperlukan blaze untuk membuat penggantian yang benar.
toolchain_identifier wajib diisi

ID unik toolchain dalam rilis crosstool. Nama ini harus dapat digunakan sebagai nama direktori dalam jalur.

Nama harus cocok dengan ekspresi reguler berikut: [a-zA-Z_][\.\- \w]*
host_system_name string; or None; default = None
Diabaikan.
target_system_name required
Nama Sistem GNU.
target_cpu required
String arsitektur target.
target_libc required
String versi libc (misalnya "glibc-2.2.2").
compiler wajib
String versi compiler (misalnya, "gcc-4.1.1").
abi_version string; or None; default = None
ABI yang digunakan, yang merupakan versi gcc. Mis.: "gcc-3.4"
abi_libc_version string; or None; default = None
Versi glibc yang digunakan oleh abi yang kita gunakan.
tool_paths default = []

Lokasi alat.

Argumen:

name: Nama alat.

path: Lokasi alat; Dapat berupa jalur absolut (untuk toolchain non-hermetis), atau jalur relatif terhadap paket cc_toolchain.
make_variables default = []
Variabel merek yang dapat diakses oleh aturan.
builtin_sysroot string; or None; default = None
sysroot bawaan. Jika atribut ini tidak ada, Bazel tidak mengizinkan penggunaan sysroot yang berbeda, yaitu melalui opsi --grte_top.
cc_target_os string; or None; default = None
Khusus tujuan internal, jangan gunakan.

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)

Membuat CompilationContext.

Parameter

Parameter Deskripsi
headers default = unbound
Kumpulan header yang diperlukan untuk mengompilasi target ini
system_includes default = unbound
Kumpulan jalur penelusuran untuk file header yang dirujuk oleh tanda kurung sudut, yaitu #include <foo/bar/header.h>. Jalur ini dapat bersifat relatif terhadap root exec atau absolut. Biasanya diteruskan dengan -isystem
includes default = unbound
Kumpulan jalur penelusuran untuk file header yang direferensikan oleh tanda kurung sudut dan tanda kutip.Biasanya diteruskan dengan -I
quote_includes default = unbound
Kumpulan jalur penelusuran untuk file header yang dirujuk oleh tanda kutip, yaitu #include "foo/bar/header.h". Jalur tersebut dapat bersifat relatif terhadap root exec atau absolut. Biasanya diteruskan dengan -iquote
framework_includes default = unbound
Kumpulan jalur penelusuran framework untuk file header (khusus platform Apple)
defines default = unbound
Kumpulan definisi yang diperlukan untuk mengompilasi target ini. Setiap definisi adalah string. Diperluas secara transitif ke dependen.
local_defines default = unbound
Kumpulan definisi yang diperlukan untuk mengompilasi target ini. Setiap definisi adalah string. Tidak disebarkan secara transitif ke dependen.

create_compilation_outputs

CcCompilationOutputs cc_common.create_compilation_outputs(objects=None, pic_objects=None)

Membuat objek output kompilasi.

Parameter

Parameter Deskripsi
objects depset; or None; default = None
Daftar file objek.
pic_objects depset; or None; default = None
Daftar file objek gambar.

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)

Menampilkan variabel yang digunakan untuk tindakan kompilasi.

Parameter

Parameter Deskripsi
cc_toolchain cc_toolchain
yang diperlukan untuk membuat variabel build.
feature_configuration required
Konfigurasi fitur yang akan dikueri.
source_file default = None
File sumber opsional untuk kompilasi. Sebaiknya teruskan source_file di sini, bukan menambahkannya ke akhir command line yang dihasilkan dari cc_common.get_memory_inefficient_command_line, karena penulis toolchain dapat menentukan dan memosisikan flag compiler dengan benar.
output_file default = None
File output opsional dari kompilasi. Sebaiknya teruskan output_file di sini, bukan menambahkannya ke akhir command line yang dihasilkan dari cc_common.get_memory_inefficient_command_line, karena penulis toolchain dapat menentukan dan memosisikan flag compiler dengan benar.
user_compile_flags sequence of strings; or None; default = None
Daftar flag kompilasi tambahan (copts).
include_directories depset; or None; default = None
Depset dari direktori yang disertakan.
quote_include_directories depset; or None; default = None
Depset dari direktori yang menyertakan kutipan.
system_include_directories depset; or None; default = None
Depset dari direktori yang disertakan sistem.
framework_include_directories depset; or None; default = None
Depset dari direktori penyertaan framework.
preprocessor_defines depset; or None; default = None
Depset dari definisi preprocessor.
thinlto_index string; or None; default = None
Jalur file indeks LTO.
thinlto_input_bitcode_file string; or None; default = None
File bitcode yang merupakan input ke backend LTO.
thinlto_output_object_file string; or None; default = None
File objek yang dihasilkan oleh backend LTO.
use_pic default = False
Jika benar, kompilasi akan menghasilkan kode yang tidak bergantung pada posisi.
add_legacy_cxx_options default = False
Tidak digunakan.
variables_extension dict; default = unbound
Kamus variabel tambahan yang digunakan oleh tindakan kompilasi. 

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='')

Membuat LibraryToLink

Parameter

Parameter Deskripsi
actions objek
actions yang diperlukan.
feature_configuration default = None
feature_configuration yang akan dikueri.
cc_toolchain default = None
CcToolchainInfo penyedia yang akan digunakan.
static_library File; or None; default = None
File library statis yang akan ditautkan.
pic_static_library File; or None; default = None
File dari library statis pic yang akan ditautkan.
dynamic_library File; or None; default = None
File library dinamis yang akan ditautkan. Selalu digunakan untuk runtime dan digunakan untuk penautan jika interface_library tidak diteruskan.
interface_library File; or None; default = None
File library antarmuka yang akan ditautkan.
pic_objects sequence of Files; default = unbound
Eksperimental, jangan gunakan
objects sequence of Files; default = unbound
Eksperimental, jangan gunakan
default = False
Apakah akan menautkan library/objek statis di blok --whole_archive.
string; default = ''
Ganti jalur default link library dinamis di direktori solib. String kosong untuk menggunakan setelan default.
default = ''
Ganti jalur default link library antarmuka di direktori solib. String kosong untuk menggunakan setelan default. 

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)

Menampilkan variabel link yang digunakan untuk tindakan penautan.

Parameter

Parameter Deskripsi
cc_toolchain
yang diperlukan untuk membuat variabel build.
required
Konfigurasi fitur yang akan dikueri.
None; or depset; default = None
Depset direktori tempat penaut akan mencari library pada waktu penautan.
None; or depset; default = None
Depset direktori tempat loader akan mencari library saat runtime.
None; or sequence; default = None
Daftar flag link tambahan (linkopts).
default = None
Jalur file output opsional.
default = None
Jalur file parameter opsional.
default = None
Jalur file .def opsional.
default = True
True saat menggunakan penaut, False saat pengarsip. Pemanggil bertanggung jawab untuk menjaga sinkronisasi ini dengan nama tindakan yang digunakan (is_using_linker = True untuk menautkan library dinamis atau yang dapat dieksekusi, is_using_linker = False untuk mengarsipkan library statis).
default = False
Benar saat membuat library dinamis, Salah saat library dapat dieksekusi atau statis. Pemanggil bertanggung jawab untuk menjaga sinkronisasi ini dengan nama tindakan yang digunakan. Kolom ini akan dihapus setelah b/65151735 diperbaiki.
default = True
Jika disetel ke True, bazel akan mengekspos variabel 'strip_debug_symbols', yang biasanya digunakan untuk menggunakan penaut guna menghapus simbol debug dari file output.
default = False
Jika ditetapkan ke true, variabel 'is_cc_test' akan ditetapkan.
default = True
Tidak digunakan.

create_linker_input

LinkerInput cc_common.create_linker_input(owner, libraries=None, user_link_flags=None, additional_inputs=None)

Membuat LinkerInput.

Parameter

Parameter Deskripsi
owner required
Label target yang menghasilkan semua file yang digunakan dalam input ini.
libraries None; or depset; default = None
Daftar LibraryToLink.
None; or depset of strings; or sequence of strings; default = None
Flag link pengguna yang diteruskan sebagai string. Menerima [String], [[String]], atau depset(String). Yang terakhir tidak dianjurkan karena hanya disimpan untuk tujuan kompatibilitas, depset diratakan. Jika Anda ingin menyebarkan user_link_flags melalui depset() yang tidak di-flatten, gabungkan dalam LinkerInput sehingga tidak di-flatten hingga akhir.
additional_inputs None; or depset; default = None
Untuk input tambahan ke tindakan penautan, misalnya: skrip penautan.

create_linking_context

LinkingContext cc_common.create_linking_context(linker_inputs=None, libraries_to_link=None, user_link_flags=None, additional_inputs=None)

Membuat LinkingContext.

Parameter

Parameter Deskripsi
linker_inputs None; or depset; default = None
Depset dari LinkerInput.
None; or sequence; default = None
Tidak digunakan lagi. Parameter ini tidak digunakan lagi dan akan segera dihapus. Jangan bergantung pada hal ini. Fitur ini dinonaktifkan dengan --+incompatible_require_linker_input_cc_api. Gunakan tanda ini untuk memverifikasi bahwa kode Anda kompatibel dengan penghapusannya yang akan segera dilakukan.
Daftar LibraryToLink.
None; or sequence; default = None
Tidak digunakan lagi. Parameter ini tidak digunakan lagi dan akan segera dihapus. Jangan bergantung pada hal ini. Fitur ini dinonaktifkan dengan --+incompatible_require_linker_input_cc_api. Gunakan tanda ini untuk memverifikasi bahwa kode Anda kompatibel dengan penghapusannya yang akan segera dilakukan.
Daftar flag link pengguna yang diteruskan sebagai string.
additional_inputs None; or sequence; default = None
Tidak digunakan lagi. Parameter ini tidak digunakan lagi dan akan segera dihapus. Jangan bergantung pada hal ini. Fitur ini dinonaktifkan dengan --+incompatible_require_linker_input_cc_api. Gunakan tanda ini untuk memverifikasi bahwa kode Anda kompatibel dengan penghapusannya yang akan segera dilakukan.
Untuk input tambahan ke tindakan penautan, misalnya: skrip penautan.

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)

Harus digunakan untuk membuat aturan library yang dapat menyebarkan informasi ke downstream agar dapat ditautkan nanti oleh aturan tingkat atas yang melakukan penautan transitif untuk membuat library dinamis atau yang dapat dieksekusi. Menampilkan tuple (CcLinkingContext, CcLinkingOutputs).

Parameter

Parameter Deskripsi
actions objek
actions yang diperlukan.
feature_configuration diperlukan
feature_configuration untuk dikueri.
cc_toolchain penyedia
CcToolchainInfo yang diperlukan untuk digunakan.
compilation_outputs required
Output kompilasi yang berisi file objek untuk ditautkan.
default = []
Daftar opsi penautan tambahan.
linking_contexts default = []
Library dari dependensi. Library ini akan ditautkan ke artefak output panggilan link(), baik biner maupun library.
name required
Ini digunakan untuk memberi nama artefak output tindakan yang dibuat oleh metode ini.
language default = 'c++'
Saat ini hanya C++ yang didukung. Jangan gunakan parameter ini.
default = False
Apakah library ini harus selalu ditautkan.
additional_inputs default = []
Untuk input tambahan ke tindakan penautan, misalnya: skrip penautan.
disallow_static_libraries default = False
Apakah library statis harus dibuat.
disallow_dynamic_library default = False
Apakah library dinamis harus dibuat.
grep_includes File; or None; default = None

do_not_use_tools_cpp_compiler_present

None cc_common.do_not_use_tools_cpp_compiler_present

Jangan gunakan kolom ini, satu-satunya tujuannya adalah untuk membantu migrasi dari config_setting.values{'compiler') ke config_settings.flag_values{'@bazel_tools//tools/cpp:compiler'}

get_environment_variables

dict cc_common.get_environment_variables(feature_configuration, action_name, variables)

Menampilkan variabel lingkungan yang akan ditetapkan untuk tindakan tertentu.

Parameter

Parameter Deskripsi
feature_configuration required
Konfigurasi fitur yang akan dikueri.
action_name required
Nama tindakan. Harus berupa salah satu nama di @bazel_tools//tools/build_defs/cc:action_names.bzl (https://github.com/bazelbuild/bazel/blob/master/tools/build_defs/cc/action_names.bzl)
variables required
Mem-build variabel yang akan digunakan untuk perluasan template.

get_execution_requirements

sequence cc_common.get_execution_requirements(feature_configuration, action_name)

Menampilkan persyaratan eksekusi untuk tindakan tertentu.

Parameter

Parameter Deskripsi
feature_configuration required
Konfigurasi fitur yang akan dikueri.
action_name required
Nama tindakan. Harus berupa salah satu nama di @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)

Menampilkan flag command line yang diratakan untuk tindakan tertentu, menggunakan variabel yang diberikan untuk perluasan. Meratakan set bertingkat dan sebaiknya tidak digunakan, atau setidaknya tidak boleh lebih lama dari analisis. Pekerjaan pada fungsi yang efisien memori yang menampilkan Args sedang berlangsung.

Parameter

Parameter Deskripsi
feature_configuration required
Konfigurasi fitur yang akan dikueri.
action_name required
Nama tindakan. Harus berupa salah satu nama di @bazel_tools//tools/build_defs/cc:action_names.bzl (https://github.com/bazelbuild/bazel/blob/master/tools/build_defs/cc/action_names.bzl)
variables required
Mem-build variabel yang akan digunakan untuk perluasan template.

get_tool_for_action

string cc_common.get_tool_for_action(feature_configuration, action_name)

Menampilkan jalur alat untuk tindakan tertentu.

Parameter

Parameter Deskripsi
feature_configuration required
Konfigurasi fitur yang akan dikueri.
action_name required
Nama tindakan. Harus berupa salah satu nama di @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)

Menampilkan True (Benar) jika fitur tertentu diaktifkan dalam konfigurasi fitur.

Parameter

Parameter Deskripsi
feature_configuration required
Konfigurasi fitur yang akan dikueri.
feature_name required
Nama fitur. 

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)

Harus digunakan untuk penautan transitif C++.

Parameter

Parameter Deskripsi
actions objek
actions yang diperlukan.
feature_configuration diperlukan
feature_configuration untuk dikueri.
cc_toolchain penyedia
CcToolchainInfo yang diperlukan untuk digunakan.
compilation_outputs CcCompilationOutputs; or None; default = None
Output kompilasi yang berisi file objek untuk ditautkan.
default = []
Daftar opsi penaut tambahan.
linking_contexts default = []
Menautkan konteks dari dependensi yang akan ditautkan ke konteks penautan yang dihasilkan oleh aturan ini.
name required
Ini digunakan untuk memberi nama artefak output tindakan yang dibuat oleh metode ini.
language default = 'c++'
Saat ini hanya C++ yang didukung. Jangan gunakan parameter ini.
output_type default = 'executable'
Dapat berupa 'executable' atau 'dynamic_library'.
default = True
True untuk menautkan dependensi secara statis, False secara dinamis.
stamp default = 0
Apakah akan menyertakan informasi build dalam file yang dapat dieksekusi yang ditautkan, jika output_type adalah 'executable'. Jika 1, informasi build selalu disertakan. Jika 0 (informasi build default selalu dikecualikan. Jika -1, menggunakan perilaku default, yang dapat diganti dengan flag --[no]stamp. Nilai ini tidak boleh ditetapkan (atau ditetapkan ke 0) saat membuat output yang dapat dieksekusi untuk aturan pengujian.
additional_inputs sequence; or depset; default = []
Untuk input tambahan ke tindakan penautan, misalnya: skrip penautan.
grep_includes File; or None; default = None
additional_outputs sequence; default = unbound
Untuk output tambahan ke tindakan penautan, misalnya: file peta.

merge_cc_infos

CcInfo cc_common.merge_cc_infos(direct_cc_infos=[], cc_infos=[])

Menggabungkan beberapa CcInfo menjadi satu.

Parameter

Parameter Deskripsi
direct_cc_infos default = []
Daftar CcInfo yang akan digabungkan, yang headernya akan diekspor oleh kolom langsung di penyedia yang ditampilkan.
cc_infos default = []
Daftar CcInfo yang akan digabungkan, yang headernya tidak akan diekspor oleh kolom langsung di penyedia yang ditampilkan.

merge_compilation_contexts

CompilationContext cc_common.merge_compilation_contexts(compilation_contexts=[])

Menggabungkan beberapa CompilationContexts menjadi satu.

Parameter

Parameter Deskripsi
compilation_contexts default = []
Daftar CompilationContexts yang akan digabungkan. Header setiap konteks akan diekspor oleh kolom langsung di penyedia yang ditampilkan.

merge_compilation_outputs

CcCompilationOutputs cc_common.merge_compilation_outputs(compilation_outputs=[])

Menggabungkan output kompilasi.

Parameter

Parameter Deskripsi
compilation_outputs default = []