Aturan
- cc_binary
- cc_import
- cc_library
- cc_proto_library
- cc_shared_library
- fdo_prefetch_hints
- fdo_profile
- memprof_profile
- propeller_optimize
- cc_test
- cc_toolchain
- cc_toolchain_suite
cc_binary
Lihat sumber aturancc_binary(name, deps, srcs, data, additional_linker_inputs, args, compatible_with, copts, defines, deprecation, distribs, env, exec_compatible_with, exec_properties, features, includes, licenses, link_extra_lib, linkopts, linkshared, linkstatic, local_defines, malloc, nocopts, output_licenses, restricted_to, stamp, tags, target_compatible_with, testonly, toolchains, visibility, win_def_file)
Target output implisit
name.stripped
(hanya dibuat jika diminta secara eksplisit): Hapus versi dari biner.strip -g
dijalankan pada biner untuk menghapus debug simbol. Opsi strip tambahan dapat diberikan pada baris perintah menggunakan--stripopt=-foo
. Output ini hanya dibuat jika diminta secara eksplisit.name.dwp
(hanya dibuat jika diminta secara eksplisit): Jika Fission diaktifkan: debug paket informasi yang cocok untuk men-debug biner yang di-deploy dari jarak jauh. Lainnya: file kosong.
Argumen
Atribut | |
---|---|
name |
Nama; wajib diisi Nama unik untuk target ini. |
deps
|
Daftar label; default adalah Dapat berupa |
srcs
|
Daftar label; default adalah Semua file File Semua file Jika nama aturan ada dalam
...dan aturan apa pun yang membuat file tersebut. Ekstensi yang berbeda menunjukkan bahasa pemrograman yang berbeda sesuai dengan konvensi gcc. |
additional_linker_inputs
|
Daftar label; default adalah Misalnya, file .res Windows yang dikompilasi dapat disediakan di sini untuk disematkan pada target biner. |
copts
|
Daftar {i>string<i}; default-nya adalah
Setiap string dalam atribut ini ditambahkan dalam urutan tertentu ke
Jika paket mendeklarasikan fitur
|
defines
|
Daftar {i>string<i}; default-nya adalah -D dan ditambahkan ke command line kompilasi ke target ini,
serta setiap aturan yang bergantung padanya. Hati-hati, karena
hal ini mungkin
berdampak luas. Jika ragu, tambahkan nilai {i>define <i}ke
local_defines saja.
|
includes
|
Daftar {i>string<i}; default-nya adalah
Tunduk pada substitusi "Buat variabel".
Setiap string diawali dengan Header harus ditambahkan ke src atau hdr. Jika tidak, header tidak akan tersedia untuk dependen aturan saat kompilasi di-sandbox (default). |
link_extra_lib
|
Label; default adalah
Secara default, biner C++ ditautkan ke |
linkopts
|
Daftar {i>string<i}; default-nya adalah LINKOPTS sebelum
menautkan target biner.
Setiap elemen daftar ini yang tidak diawali dengan |
linkshared
|
Boolean; tidak dapat dikonfigurasi; default adalah linkshared=True dalam aturan Anda. Secara default
opsi ini nonaktif.
Adanya tanda ini berarti penautan terjadi dengan tanda
Jika Anda menentukan |
linkstatic
|
Boolean; default-nya adalah cc_binary dan
cc_test : menautkan biner secara statis
mode. Untuk cc_library.linkstatic : lihat di bawah.
Secara default, opsi ini aktif untuk
Jika diaktifkan dan ini adalah biner atau pengujian, opsi ini memberi tahu alat build untuk menautkan
Sebenarnya ada tiga cara untuk menautkan {i>executable<i}:
Atribut
Jika |
local_defines
|
Daftar {i>string<i}; default-nya adalah -D dan ditambahkan ke command line kompilasi untuk target ini,
tetapi tidak kepada tanggungannya.
|
malloc
|
Label; default adalah
Secara default, biner C++ ditautkan ke |
nocopts
|
String; default-nya adalah COPTS yang sudah ada dan cocok dengan ekspresi reguler ini
(termasuk nilai yang ditentukan secara eksplisit dalam atribut copts aturan) akan dihapus dari
COPTS untuk tujuan kompilasi aturan ini.
Atribut ini jarang diperlukan.
|
stamp
|
{i>Integer<i} (Bilangan bulat): default-nya adalah
Biner yang distempel tidak dibangun ulang kecuali jika dependensinya berubah. |
win_def_file
|
Label; default adalah Atribut ini hanya boleh digunakan jika Windows adalah platform target. Template ini dapat digunakan untuk ekspor simbol selama menautkan galeri foto bersama. |
cc_import
Lihat sumber aturancc_import(name, deps, data, hdrs, alwayslink, compatible_with, deprecation, distribs, features, interface_library, licenses, restricted_to, shared_library, static_library, system_provided, tags, target_compatible_with, testonly, visibility)
Aturan cc_import
memungkinkan pengguna mengimpor library C/C++ yang telah dikompilasi sebelumnya.
Berikut ini adalah kasus penggunaan umum:
Akun Layanan 1. Menautkan library statis
cc_import( name = "mylib", hdrs = ["mylib.h"], static_library = "libmylib.a", # If alwayslink is turned on, # libmylib.a will be forcely linked into any binary that depends on it. # alwayslink = 1, )
cc_import( name = "mylib", hdrs = ["mylib.h"], shared_library = "libmylib.so", )
cc_import( name = "mylib", hdrs = ["mylib.h"], # mylib.lib is an import library for mylib.dll which will be passed to linker interface_library = "mylib.lib", # mylib.dll will be available for runtime shared_library = "mylib.dll", )
system_provided=True
(Windows)
cc_import( name = "mylib", hdrs = ["mylib.h"], # mylib.lib is an import library for mylib.dll which will be passed to linker interface_library = "mylib.lib", # mylib.dll is provided by system environment, for example it can be found in PATH. # This indicates that Bazel is not responsible for making mylib.dll available. system_provided = 1, )
Pada Unix:
cc_import( name = "mylib", hdrs = ["mylib.h"], static_library = "libmylib.a", shared_library = "libmylib.so", ) # first will link to libmylib.a cc_binary( name = "first", srcs = ["first.cc"], deps = [":mylib"], linkstatic = 1, # default value ) # second will link to libmylib.so cc_binary( name = "second", srcs = ["second.cc"], deps = [":mylib"], linkstatic = 0, )
cc_import( name = "mylib", hdrs = ["mylib.h"], static_library = "libmylib.lib", # A normal static library interface_library = "mylib.lib", # An import library for mylib.dll shared_library = "mylib.dll", ) # first will link to libmylib.lib cc_binary( name = "first", srcs = ["first.cc"], deps = [":mylib"], linkstatic = 1, # default value ) # second will link to mylib.dll through mylib.lib cc_binary( name = "second", srcs = ["second.cc"], deps = [":mylib"], linkstatic = 0, )
cc_import
mendukung atribut include. Contoh:
cc_import( name = "curl_lib", hdrs = glob(["vendor/curl/include/curl/*.h"]), includes = [ "vendor/curl/include" ], shared_library = "vendor/curl/lib/.libs/libcurl.dylib", )
Argumen
Atribut | |
---|---|
name |
Nama; wajib diisi Nama unik untuk target ini. |
deps
|
Daftar label; default adalah deps
pada Atribut umum didefinisikan oleh
sebagian besar aturan build.
|
hdrs
|
Daftar label; default adalah |
alwayslink
|
Boolean; default-nya adalah Jika alwayslink tidak berfungsi dengan VS 2017 di Windows, hal ini disebabkan oleh masalah umum, upgrade VS 2017 Anda ke versi terbaru. |
interface_library
|
Label; default adalah Jenis file yang diizinkan:
|
shared_library
|
Label; default adalah Jenis file yang diizinkan:
|
static_library
|
Label; default adalah Jenis file yang diizinkan:
|
system_provided
|
Boolean; default-nya adalah interface_library harus ditentukan dan
shared_library harus kosong.
|
cc_library
Lihat sumber aturancc_library(name, deps, srcs, data, hdrs, additional_compiler_inputs, additional_linker_inputs, alwayslink, compatible_with, copts, defines, deprecation, distribs, exec_compatible_with, exec_properties, features, implementation_deps, include_prefix, includes, licenses, linkopts, linkstamp, linkstatic, local_defines, nocopts, restricted_to, strip_include_prefix, tags, target_compatible_with, testonly, textual_hdrs, toolchains, visibility, win_def_file)
Pemeriksaan penyertaan header
Semua file header yang digunakan dalam build harus dideklarasikan dalam hdrs
atau
srcs
dari cc_*
aturan. Hal ini diberlakukan.
Untuk aturan cc_library
, header di hdrs
terdiri dari antarmuka publik
library dan dapat langsung disertakan baik dari file dalam hdrs
maupun
srcs
library itu sendiri serta dari file dalam hdrs
dan
srcs
dari cc_*
aturan yang mencantumkan library di deps
.
Header di srcs
hanya boleh disertakan langsung dari file di hdrs
dan srcs
library itu sendiri. Saat memutuskan apakah akan
menempatkan {i>header<i} ke dalam
hdrs
atau srcs
, Anda harus bertanya apakah Anda ingin menjadi konsumen library ini
untuk dapat langsung menyertakannya. Ini kurang lebih sama dengan keputusan antara
Visibilitas public
dan private
dalam bahasa pemrograman.
Aturan cc_binary
dan cc_test
tidak memiliki antarmuka yang diekspor, sehingga keduanya
juga tidak memiliki atribut hdrs
. Semua header yang termasuk dalam biner atau pengujian
secara langsung harus tercantum dalam srcs
.
Untuk menggambarkan aturan ini, lihat contoh berikut.
cc_binary( name = "foo", srcs = [ "foo.cc", "foo.h", ], deps = [":bar"], ) cc_library( name = "bar", srcs = [ "bar.cc", "bar-impl.h", ], hdrs = ["bar.h"], deps = [":baz"], ) cc_library( name = "baz", srcs = [ "baz.cc", "baz-impl.h", ], hdrs = ["baz.h"], )
Penyertaan langsung yang diizinkan dalam contoh ini tercantum dalam tabel di bawah. Misalnya
foo.cc
diizinkan untuk menyertakan foo.h
dan bar.h
secara langsung, tetapi
bukan baz.h
.
Menyertakan file | Penyertaan yang diizinkan |
---|---|
foo.h | bar.h |
foo.cc | {i>foo.h bar.h<i} |
bar.h | bar-impl.h baz.h |
baris-impl.h | bar.h baz.h |
bar.cc | bar.h bar-impl.h baz.h |
baz.h | Baz-impl.h |
Baz-impl.h | baz.h |
baz.cc | baz.h baz-impl.h |
Aturan pemeriksaan penyertaan hanya berlaku untuk langsung
penyertaan/penyertaan. Dalam contoh di atas, foo.cc
diizinkan untuk
menyertakan bar.h
, yang mungkin mencakup baz.h
, yang dalam
belokan diizinkan menyertakan baz-impl.h
. Secara teknis,
kompilasi file .cc
dapat menyertakan header apa pun secara transitif
file di hdrs
atau srcs
di
cc_library
apa pun dalam penutupan deps
transitif. Di beberapa
dalam hal ini, compiler dapat membaca baz.h
dan baz-impl.h
saat mengompilasi foo.cc
, namun foo.cc
tidak boleh
berisi #include "baz.h"
. Agar dapat
diizinkan, baz
harus ditambahkan ke deps
dari foo
.
Bazel bergantung pada dukungan toolchain untuk menerapkan aturan pemeriksaan penyertaan.
Fitur layering_check
harus didukung oleh toolchain
dan diminta secara eksplisit, misalnya melalui
flag command line --features=layering_check
atau
features
dari parameter
Fungsi package
. Toolchain
yang disediakan oleh Bazel hanya mendukung fitur ini dengan {i>clang<i} di Unix dan macOS.
Argumen
Atribut | |
---|---|
name |
Nama; wajib diisi Nama unik untuk target ini. |
deps
|
Daftar label; default adalah Dapat berupa |
srcs
|
Daftar label; default adalah Semua file File Semua file Jika nama aturan ada dalam
...dan aturan apa pun yang membuat file tersebut. Ekstensi yang berbeda menunjukkan bahasa pemrograman yang berbeda sesuai dengan konvensi gcc. |
hdrs
|
Daftar label; default adalah Ini adalah lokasi yang sangat disukai untuk mendeklarasikan file {i>header<i} yang
menjelaskan antarmuka {i>library<i}. {i>Header<i} ini akan dibuat
tersedia untuk disertakan oleh sumber dalam aturan ini atau aturan dependen.
Header yang tidak dimaksudkan untuk disertakan oleh klien library ini harus
tercantum dalam atribut |
additional_compiler_inputs
|
Daftar label; default adalah |
additional_linker_inputs
|
Daftar label; default adalah Misalnya, file .res Windows yang dikompilasi dapat disediakan di sini untuk disematkan pada target biner. |
alwayslink
|
Boolean; default-nya adalah srcs , meskipun beberapa di antaranya tidak berisi simbol yang dirujuk oleh biner.
Fungsi ini berguna jika kode Anda tidak secara eksplisit dipanggil oleh kode di
biner, misalnya, jika kode Anda mendaftar untuk menerima beberapa callback
yang disediakan oleh beberapa layanan.
Jika alwayslink tidak berfungsi dengan VS 2017 di Windows, hal ini disebabkan oleh masalah umum, upgrade VS 2017 Anda ke versi terbaru. |
copts
|
Daftar {i>string<i}; default-nya adalah
Setiap string dalam atribut ini ditambahkan dalam urutan tertentu ke
Jika paket mendeklarasikan fitur
|
defines
|
Daftar {i>string<i}; default-nya adalah -D dan ditambahkan ke command line kompilasi ke target ini,
serta setiap aturan yang bergantung padanya. Hati-hati, karena
hal ini mungkin
berdampak luas. Jika ragu, tambahkan nilai {i>define <i}ke
local_defines saja.
|
implementation_deps
|
Daftar label; default adalah deps , header dan sertakan jalur library ini (dan semua
dependensi transitif) hanya digunakan untuk kompilasi library ini, bukan library yang
yang bergantung pada {i>database.<i} Library yang ditentukan dengan implementation_deps masih ditautkan
target biner yang bergantung pada library ini.
Untuk saat ini, penggunaan dibatasi pada cc_libraries dan dilindungi oleh tanda
|
include_prefix
|
String; default-nya adalah Jika ditetapkan, header di atribut Awalan dalam atribut |
includes
|
Daftar {i>string<i}; default-nya adalah
Tunduk pada substitusi "Buat variabel".
Setiap string diawali dengan Header harus ditambahkan ke src atau hdr. Jika tidak, header tidak akan tersedia untuk dependen aturan saat kompilasi di-sandbox (default). |
linkopts
|
Daftar {i>string<i}; default-nya adalah LINKOPTS sebelum
menautkan target biner.
Setiap elemen daftar ini yang tidak diawali dengan |
linkstamp
|
Label; default adalah base .
|
linkstatic
|
Boolean; default-nya adalah cc_binary dan
cc_test : menautkan biner secara statis
mode. Untuk cc_library.linkstatic : lihat di bawah.
Secara default, opsi ini aktif untuk
Jika diaktifkan dan ini adalah biner atau pengujian, opsi ini memberi tahu alat build untuk menautkan
Sebenarnya ada tiga cara untuk menautkan {i>executable<i}:
Atribut
Jika |
local_defines
|
Daftar {i>string<i}; default-nya adalah -D dan ditambahkan ke command line kompilasi untuk target ini,
tetapi tidak kepada tanggungannya.
|
nocopts
|
String; default-nya adalah COPTS yang sudah ada dan cocok dengan ekspresi reguler ini
(termasuk nilai yang ditentukan secara eksplisit dalam atribut copts aturan) akan dihapus dari
COPTS untuk tujuan kompilasi aturan ini.
Atribut ini jarang diperlukan.
|
strip_include_prefix
|
String; default-nya adalah Jika ditetapkan, header di atribut Jika jalur relatif, maka akan diambil sebagai jalur yang relatif terhadap paket. Jika nilai itu adalah mutlak, itu dipahami sebagai jalur relatif repositori. Awalan dalam atribut |
textual_hdrs
|
Daftar label; default adalah Ini adalah lokasi untuk mendeklarasikan file {i>header<i} yang tidak dapat dikompilasi sendiri; yaitu, mereka selalu perlu disertakan secara tekstual oleh file sumber lain untuk membuat pada kode sumber. |
win_def_file
|
Label; default adalah Atribut ini hanya boleh digunakan jika Windows adalah platform target. Template ini dapat digunakan untuk ekspor simbol selama menautkan galeri foto bersama. |
cc_proto_library
Lihat sumber aturancc_proto_library(name, deps, data, compatible_with, deprecation, distribs, exec_compatible_with, exec_properties, features, licenses, restricted_to, tags, target_compatible_with, testonly, visibility)
cc_proto_library
menghasilkan kode C++ dari file .proto
.
deps
harus mengarah ke aturan proto_library
.
Contoh:
cc_library( name = "lib", deps = [":foo_cc_proto"], ) cc_proto_library( name = "foo_cc_proto", deps = [":foo_proto"], ) proto_library( name = "foo_proto", )
Argumen
Atribut | |
---|---|
name |
Nama; wajib diisi Nama unik untuk target ini. |
deps
|
Daftar label; default adalah proto_library
aturan untuk menghasilkan kode C++.
|
cc_shared_library
Lihat sumber aturancc_shared_library(name, deps, additional_linker_inputs, dynamic_deps, exports_filter, shared_lib_name, tags, user_link_flags, win_def_file)
Layanan ini menghasilkan {i>shared library<i}.
Contoh
cc_shared_library( name = "foo_shared", deps = [ ":foo", ], dynamic_deps = [ ":bar_shared", ], additional_linker_inputs = [ ":foo.lds", ], user_link_flags = [ "-Wl,--version-script=$(location :foo.lds)", ], ) cc_library( name = "foo", srcs = ["foo.cc"], hdrs = ["foo.h"], deps = [ ":bar", ":baz", ], ) cc_shared_library( name = "bar_shared", shared_lib_name = "bar.so", deps = [":bar"], ) cc_library( name = "bar", srcs = ["bar.cc"], hdrs = ["bar.h"], ) cc_library( name = "baz", srcs = ["baz.cc"], hdrs = ["baz.h"], )
Dalam contoh ini, foo_shared
menautkan foo
secara statis
dan baz
, yang kedua adalah dependensi transitif. Tidak
tautkan bar
karena sudah disediakan secara dinamis oleh
dynamic_dep
bar_shared
.
foo_shared
menggunakan file skrip penaut *.lds untuk mengontrol
semua simbol harus diekspor. Logika aturan cc_shared_library
melakukan
tidak mengontrol simbol mana yang diekspor, itu hanya menggunakan apa yang diasumsikan
diekspor untuk memberikan kesalahan selama fase analisis jika dua {i>shared library<i} mengekspor
target yang sama.
Setiap dependensi langsung dari cc_shared_library
diasumsikan
diekspor. Oleh karena itu, selama analisis berlangsung, Bazel berasumsi bahwa foo
diekspor oleh foo_shared
. baz
tidak dianggap diekspor
paling lambat foo_shared
. Setiap target yang cocok dengan exports_filter
juga diasumsikan sebagai ekspor.
Setiap cc_library
dalam contoh harus muncul paling banyak dalam satu
cc_shared_library
. Jika kita ingin menautkan baz
juga ke
bar_shared
kita perlu menambahkan
tags = ["LINKABLE_MORE_THAN_ONCE"]
sampai baz
.
Karena atribut shared_lib_name
, file yang dihasilkan oleh
bar_shared
akan memiliki nama bar.so
, bukan
dengan nama libbar.so
yang akan digunakan secara default di Linux.
Error
Two shared libraries in dependencies export the same symbols.
Hal ini akan terjadi setiap kali Anda membuat target dengan dua jenis
Dependensi cc_shared_library
yang mengekspor target yang sama. Untuk memperbaikinya
Anda harus menghentikan library agar tidak diekspor di salah satu
Dependensi cc_shared_library
.
Two shared libraries in dependencies link the same library statically
Hal ini akan terjadi setiap kali Anda membuat cc_shared_library
baru dengan dua
dependensi cc_shared_library
yang berbeda yang menautkan target yang sama secara statis.
Mirip dengan error pada ekspor.
Salah satu cara untuk memperbaikinya adalah dengan
berhenti menghubungkan {i>library<i} ke salah satu
Dependensi cc_shared_library
. Pada saat yang sama, parameter
yang masih menautkannya
perlu mengekspor library agar library yang tidak menautkannya tetap dapat dilihat
simbol-simbol tersebut. Cara lain adalah dengan menarik library ketiga yang mengekspor target.
Cara ketiga adalah memberi tag cc_library
penyebab masalah dengan LINKABLE_MORE_THAN_ONCE
tetapi perbaikan ini jarang terjadi dan
Anda harus memastikan bahwa
cc_library
memang aman untuk ditautkan lebih dari sekali.
'//foo:foo' is already linked statically in '//bar:bar' but not exported`
Artinya, library dalam penutupan transitif deps
Anda dapat dijangkau
tanpa melalui salah satu dependensi cc_shared_library
, tetapi sudah
ditautkan ke cc_shared_library
yang berbeda di dynamic_deps
dan tidak
diekspor.
Solusinya adalah dengan mengekspornya dari dependensi cc_shared_library
atau menariknya
cc_shared_library
ketiga yang mengekspornya.
Do not place libraries which only contain a precompiled dynamic library in deps.
Jika Anda memiliki pustaka dinamis yang telah dikompilasi sebelumnya, hal ini tidak perlu dan tidak boleh
ditautkan secara statis ke target cc_shared_library
saat ini yang Anda
yang sedang dibuat. Oleh karena itu, file ini tidak termasuk dalam deps
cc_shared_library
. Jika library dinamis yang dikompilasi sebelumnya ini merupakan dependensi
dari cc_libraries
, maka cc_library
harus bergantung padanya
secara langsung.
Trying to export a library already exported by a different shared library
Anda akan melihat error ini jika pada aturan saat ini Anda mengklaim untuk mengekspor target yang sudah diekspor oleh salah satu dependensi dinamis Anda.
Untuk memperbaikinya, hapus target dari deps
dan cukup andalkan dari objek
dependensi atau memastikan bahwa exports_filter
tidak menangkap target ini.
Argumen
Atribut | |
---|---|
name |
Nama; wajib diisi Nama unik untuk target ini. |
deps
|
Daftar label; default adalah
Setiap dependensi library transitif dari dependensi langsung ini akan ditautkan ke
library selama belum ditautkan oleh
Selama analisis, penerapan aturan akan mempertimbangkan target apa pun yang tercantum dalam
Implementasi ini juga akan memicu error setiap kali library yang sama ditautkan secara statis
menjadi lebih dari satu |
additional_linker_inputs
|
Daftar label; default adalah user_link_flags .
|
dynamic_deps
|
Daftar label; default adalah cc_shared_library lain yang menjadi dependensi target saat ini.
Implementasi |
exports_filter
|
Daftar {i>string<i}; default-nya adalah
Setiap target
Perhatikan, atribut ini tidak benar-benar menambahkan edge dependensi ke target tersebut,
edge dependensi seharusnya dibuat oleh Sintaksis berikut diizinkan:
|
shared_lib_name
|
String; default-nya adalah |
user_link_flags
|
Daftar {i>string<i}; default-nya adalah cc_shared_library( name = "foo_shared", additional_linker_inputs = select({ "//src/conditions:linux": [ ":foo.lds", ":additional_script.txt", ], "//conditions:default": []}), user_link_flags = select({ "//src/conditions:linux": [ "-Wl,-rpath,kittens", "-Wl,--version-script=$(location :foo.lds)", "-Wl,--script=$(location :additional_script.txt)", ], "//conditions:default": []}), ... ) |
win_def_file
|
Label; default adalah Atribut ini hanya boleh digunakan jika Windows adalah platform target. Template ini dapat digunakan untuk ekspor simbol selama menautkan galeri foto bersama. |
fdo_prefetch_hints
Lihat sumber aturanfdo_prefetch_hints(name, compatible_with, deprecation, distribs, features, licenses, profile, restricted_to, tags, target_compatible_with, testonly, visibility)
Merepresentasikan profil petunjuk pengambilan data FDO yang ada di ruang kerja atau di absolut. Contoh:
fdo_prefetch_hints( name = "hints", profile = "//path/to/hints:profile.afdo", ) fdo_profile( name = "hints_abs", absolute_path_profile = "/absolute/path/profile.afdo", )
Argumen
Atribut | |
---|---|
name |
Nama; wajib diisi Nama unik untuk target ini. |
profile
|
Label; default adalah |
fdo_profile
Lihat sumber aturanfdo_profile(name, absolute_path_profile, compatible_with, deprecation, distribs, features, licenses, profile, proto_profile, restricted_to, tags, target_compatible_with, testonly, visibility)
Mewakili profil FDO yang ada di ruang kerja atau di jalur absolut yang ditentukan. Contoh:
fdo_profile( name = "fdo", profile = "//path/to/fdo:profile.zip", ) fdo_profile( name = "fdo_abs", absolute_path_profile = "/absolute/path/profile.zip", )
Argumen
Atribut | |
---|---|
name |
Nama; wajib diisi Nama unik untuk target ini. |
absolute_path_profile
|
String; default-nya adalah |
profile
|
Label; default adalah |
proto_profile
|
Label; default adalah |
memprof_profile
Lihat sumber aturanmemprof_profile(name, absolute_path_profile, compatible_with, deprecation, distribs, features, licenses, profile, restricted_to, tags, target_compatible_with, testonly, visibility)
Mewakili profil MEMPROF yang ada di ruang kerja atau di lokasi tertentu absolut. Contoh:
memprof_profile( name = "memprof", profile = "//path/to/memprof:profile.afdo", ) memprof_profile( name = "memprof_abs", absolute_path_profile = "/absolute/path/profile.afdo", )
Argumen
Atribut | |
---|---|
name |
Nama; wajib diisi Nama unik untuk target ini. |
absolute_path_profile
|
String; default-nya adalah |
profile
|
Label; default adalah |
propeller_optimize
Lihat sumber aturanpropeller_optimize(name, compatible_with, deprecation, distribs, features, ld_profile, licenses, restricted_to, tags, target_compatible_with, testonly, visibility)
Mewakili profil pengoptimalan Propeller di ruang kerja. Contoh:
propeller_optimize( name = "layout", cc_profile = "//path:cc_profile.txt", ld_profile = "//path:ld_profile.txt" ) propeller_optimize( name = "layout_absolute", absolute_cc_profile = "/absolute/cc_profile.txt", absolute_ld_profile = "/absolute/ld_profile.txt" )
Argumen
Atribut | |
---|---|
name |
Nama; wajib diisi Nama unik untuk target ini. |
ld_profile
|
Label; default adalah |
cc_test
Lihat sumber aturancc_test(name, deps, srcs, data, additional_linker_inputs, args, compatible_with, copts, defines, deprecation, distribs, env, env_inherit, exec_compatible_with, exec_properties, features, flaky, includes, licenses, link_extra_lib, linkopts, linkstatic, local, local_defines, malloc, nocopts, restricted_to, shard_count, size, stamp, tags, target_compatible_with, testonly, timeout, toolchains, visibility, win_def_file)
Argumen
Atribut | |
---|---|
name |
Nama; wajib diisi Nama unik untuk target ini. |
deps
|
Daftar label; default adalah Dapat berupa |
srcs
|
Daftar label; default adalah Semua file File Semua file Jika nama aturan ada dalam
...dan aturan apa pun yang membuat file tersebut. Ekstensi yang berbeda menunjukkan bahasa pemrograman yang berbeda sesuai dengan konvensi gcc. |
additional_linker_inputs
|
Daftar label; default adalah Misalnya, file .res Windows yang dikompilasi dapat disediakan di sini untuk disematkan pada target biner. |
copts
|
Daftar {i>string<i}; default-nya adalah
Setiap string dalam atribut ini ditambahkan dalam urutan tertentu ke
Jika paket mendeklarasikan fitur
|
defines
|
Daftar {i>string<i}; default-nya adalah -D dan ditambahkan ke command line kompilasi ke target ini,
serta setiap aturan yang bergantung padanya. Hati-hati, karena
hal ini mungkin
berdampak luas. Jika ragu, tambahkan nilai {i>define <i}ke
local_defines saja.
|
includes
|
Daftar {i>string<i}; default-nya adalah
Tunduk pada substitusi "Buat variabel".
Setiap string diawali dengan Header harus ditambahkan ke src atau hdr. Jika tidak, header tidak akan tersedia untuk dependen aturan saat kompilasi di-sandbox (default). |
link_extra_lib
|
Label; default adalah
Secara default, biner C++ ditautkan ke |
linkopts
|
Daftar {i>string<i}; default-nya adalah LINKOPTS sebelum
menautkan target biner.
Setiap elemen daftar ini yang tidak diawali dengan |
linkstatic
|
Boolean; default-nya adalah cc_binary dan
cc_test : menautkan biner secara statis
mode. Untuk cc_library.linkstatic : lihat di bawah.
Secara default, opsi ini aktif untuk
Jika diaktifkan dan ini adalah biner atau pengujian, opsi ini memberi tahu alat build untuk menautkan
Sebenarnya ada tiga cara untuk menautkan {i>executable<i}:
Atribut
Jika |
local_defines
|
Daftar {i>string<i}; default-nya adalah -D dan ditambahkan ke command line kompilasi untuk target ini,
tetapi tidak kepada tanggungannya.
|
malloc
|
Label; default adalah
Secara default, biner C++ ditautkan ke |
nocopts
|
String; default-nya adalah COPTS yang sudah ada dan cocok dengan ekspresi reguler ini
(termasuk nilai yang ditentukan secara eksplisit dalam atribut copts aturan) akan dihapus dari
COPTS untuk tujuan kompilasi aturan ini.
Atribut ini jarang diperlukan.
|
stamp
|
{i>Integer<i} (Bilangan bulat): default-nya adalah
Biner yang distempel tidak dibangun ulang kecuali jika dependensinya berubah. |
win_def_file
|
Label; default adalah Atribut ini hanya boleh digunakan jika Windows adalah platform target. Template ini dapat digunakan untuk ekspor simbol selama menautkan galeri foto bersama. |
cc_toolchain
Lihat sumber aturancc_toolchain(name, all_files, ar_files, as_files, compatible_with, compiler_files, compiler_files_without_includes, coverage_files, deprecation, distribs, dwp_files, dynamic_runtime_lib, exec_transition_for_inputs, features, libc_top, licenses, linker_files, module_map, objcopy_files, restricted_to, static_runtime_lib, strip_files, supports_header_parsing, supports_param_files, tags, target_compatible_with, testonly, toolchain_config, toolchain_identifier, visibility)
Merepresentasikan toolchain C++.
Aturan ini bertanggung jawab untuk:
-
Mengumpulkan semua artefak yang diperlukan untuk menjalankan tindakan C++. Hal ini dilakukan dengan
seperti
all_files
,compiler_files
,linker_files
, atau atribut lainnya yang diakhiri dengan_files
). Berikut adalah paling sering {i>filegroup<i} menggabungkan semua file yang diperlukan. -
Membuat command line yang benar untuk tindakan C++. Hal ini dilakukan dengan
Penyedia
CcToolchainConfigInfo
(detail di bawah).
Gunakan atribut toolchain_config
untuk mengonfigurasi toolchain C++.
Lihat juga ini
halaman
untuk konfigurasi toolchain C++ dan dokumentasi pemilihan toolchain yang rumit.
Menggunakan tags = ["manual"]
untuk mencegah toolchain dibuat dan dikonfigurasi
tidak perlu saat memanggil bazel build //...
Argumen
Atribut | |
---|---|
name |
Nama; wajib diisi Nama unik untuk target ini. |
all_files
|
Label; wajib diisi Koleksi semua artefak cc_toolchain. Artefak ini akan ditambahkan sebagai input ke semua tindakan terkait rules_cc (kecuali tindakan yang menggunakan kumpulan artefak dari atribut di bawah). Bazel menganggapall_files adalah superset
dari semua atribut penyedia artefak lainnya (mis., kompilasi linkstamp membutuhkan kompilasi
dan menautkan file, sehingga memerlukan all_files ).
Itulah isi |
ar_files
|
Label; default adalah Koleksi semua artefak cc_toolchain yang diperlukan untuk tindakan pengarsipan. |
as_files
|
Label; default adalah Koleksi semua artefak cc_ toolchain yang diperlukan untuk tindakan assembly. |
compiler_files
|
Label; wajib diisi Koleksi semua artefak cc_toolchain yang diperlukan untuk tindakan kompilasi. |
compiler_files_without_includes
|
Label; default adalah |
coverage_files
|
Label; default adalah |
dwp_files
|
Label; wajib diisi Koleksi semua artefak cc_toolchain yang diperlukan untuk tindakan dwp. |
dynamic_runtime_lib
|
Label; default adalah Ini akan digunakan saat 'static_link_cpp_runtimes' diaktifkan, dan kami menautkan dependensi secara dinamis. |
exec_transition_for_inputs
|
Boolean; default-nya adalah |
libc_top
|
Label; default adalah |
linker_files
|
Label; wajib diisi Koleksi semua artefak cc_ toolchain yang diperlukan untuk menautkan tindakan. |
module_map
|
Label; default adalah |
objcopy_files
|
Label; wajib diisi Koleksi semua artefak cc_toolchain yang diperlukan untuk tindakan objcopy. |
static_runtime_lib
|
Label; default adalah Ini akan digunakan saat 'static_link_cpp_runtimes' diaktifkan, dan kami menautkan dependensi secara statis. |
strip_files
|
Label; wajib diisi Koleksi semua artefak cc_toolchain yang diperlukan untuk tindakan strip. |
supports_header_parsing
|
Boolean; default-nya adalah |
supports_param_files
|
Boolean; default-nya adalah |
toolchain_config
|
Label; wajib diisi Label aturan yang menyediakancc_toolchain_config_info .
|
toolchain_identifier
|
String; tidak dapat dikonfigurasi; default adalah
Hingga masalah #5380 diperbaiki
ini adalah cara yang direkomendasikan untuk mengaitkan |
cc_toolchain_suite
Lihat sumber aturancc_toolchain_suite(name, compatible_with, deprecation, distribs, features, licenses, restricted_to, tags, target_compatible_with, testonly, toolchains, visibility)
Mewakili kumpulan toolchain C++.
Aturan ini bertanggung jawab untuk:
- Mengumpulkan semua toolchain C++ yang relevan.
-
Memilih satu toolchain bergantung pada opsi
--cpu
dan--compiler
diteruskan ke Bazel.
Lihat juga ini halaman untuk konfigurasi toolchain C++ dan dokumentasi pemilihan toolchain yang rumit.
Argumen
Atribut | |
---|---|
name |
Nama; wajib diisi Nama unik untuk target ini. |
toolchains
|
Kamus yang memetakan string ke label; tidak dapat dikonfigurasi; wajib diisi Peta dari "<cpu>" atau "<cpu>|<compiler>" {i>string<i} ke labelcc_toolchain . "<cpu>" akan digunakan saat --cpu saja
diteruskan ke Bazel, dan "<cpu>|<compiler>" akan digunakan saat
--cpu dan --compiler diteruskan ke Bazel. Contoh:
cc_toolchain_suite( name = "toolchain", toolchains = { "piii|gcc": ":my_cc_toolchain_for_piii_using_gcc", "piii": ":my_cc_toolchain_for_piii_using_default_compiler", }, ) |