Halaman ini diterjemahkan oleh Cloud Translation API.

Aturan C / C++

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

cc_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): Versi biner yang dihapus. strip -g dijalankan pada biner untuk menghapus simbol debug. Opsi strip tambahan dapat diberikan pada command line menggunakan --stripopt=-foo. Output ini hanya dibuat jika diminta secara eksplisit.
name.dwp (hanya dibuat jika diminta secara eksplisit): Jika Fission diaktifkan: file paket informasi debug yang cocok untuk men-debug biner yang di-deploy dari jarak jauh. Else: file kosong.

Argumen

Atribut
`name`	Nama; wajib diisi Nama unik untuk target ini.
`deps`	Daftar label; defaultnya adalah `[]` Daftar library lain yang akan ditautkan ke target biner. Tujuan ini dapat berupa target `cc_library` atau `objc_library`.
`srcs`	Daftar label; defaultnya adalah `[]` Daftar file C dan C++ yang diproses untuk membuat target. File tersebut adalah file sumber dan header C/C++, baik yang tidak dihasilkan (kode sumber normal) atau yang dihasilkan. Semua file `.cc`, `.c`, dan `.cpp` akan dikompilasi. File ini mungkin merupakan file yang dihasilkan: jika file bernama berada di `outs` dari beberapa aturan lain, aturan ini akan otomatis bergantung pada aturan lain tersebut. File `.h` tidak akan dikompilasi, tetapi akan tersedia untuk disertakan oleh sumber dalam aturan ini. File `.cc` dan `.h` dapat langsung menyertakan header yang tercantum dalam `srcs` ini atau dalam `hdrs` aturan apa pun yang tercantum dalam argumen `deps`. Semua file `#include` harus disebutkan dalam atribut `srcs` aturan ini, atau dalam atribut `hdrs` dari `cc_library()` yang direferensikan. Gaya yang direkomendasikan adalah agar header yang terkait dengan library dicantumkan dalam atribut `hdrs` library tersebut, dan header tersisa apa pun yang terkait dengan sumber aturan ini agar dicantumkan di `srcs`. Lihat "Pemeriksaan penyertaan header" untuk mengetahui deskripsi yang lebih mendetail. Jika nama aturan ada dalam `srcs`, aturan ini akan otomatis bergantung pada nama aturan tersebut. Jika `outs` aturan bernama adalah file sumber C atau C++, file tersebut akan dikompilasi ke dalam aturan ini. Jika merupakan file library, file tersebut akan ditautkan. `srcs` jenis file yang diizinkan: File sumber C dan C++: `.c`, `.cc`, `.cpp`, `.cxx`, `.c++`, `.C` File header C dan C++: `.h`, `.hh`, `.hpp`, `.hxx`, `.inc`, `.inl`, `.H` Assembler dengan preprocessor C: `.S` Arsipkan: `.a`, `.pic.a` Library "Always link": `.lo`, `.pic.lo` Library bersama, berversi atau tanpa versi: `.so`, `.so.version` File objek: `.o`, `.pic.o` ...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; defaultnya adalah `[]` Teruskan file-file ini ke perintah linker C++. Misalnya, file .res Windows yang dikompilasi dapat disediakan di sini untuk disematkan dalam target biner.
`copts`	Daftar string; defaultnya adalah `[]` Tambahkan opsi ini ke perintah kompilasi C++. Tunduk pada substitusi "Buat variabel" dan tokenisasi shell Bourne. Setiap string dalam atribut ini ditambahkan dalam urutan yang ditentukan ke `COPTS` sebelum mengompilasi target biner. Tanda ini hanya berlaku untuk mengompilasi target ini, bukan dependensinya, jadi berhati-hatilah dengan file header yang disertakan di tempat lain. Semua jalur harus relatif terhadap ruang kerja, bukan dengan paket saat ini. Jika paket mendeklarasikan fitur `no_copts_tokenization`, tokenisasi shell Bourne hanya berlaku untuk string yang terdiri dari satu variabel "Make".
`defines`	Daftar string; defaultnya adalah `[]` Daftar definisi yang akan ditambahkan ke baris kompilasi. Tunduk pada substitusi variabel"Buat" dan tokenisasi shell Bourne. Setiap string, yang harus terdiri dari satu token shell Bourne, diawali dengan `-D` dan ditambahkan ke command line kompilasi ke target ini, serta setiap aturan yang bergantung padanya. Hati-hati, karena hal ini mungkin memiliki jangkauan yang luas. Jika ragu, tambahkan nilai definisi ke `local_defines`.
`includes`	Daftar string; defaultnya adalah `[]` Daftar include dir yang akan ditambahkan ke baris kompilasi. Tunduk pada substitusi "Buat variabel". Setiap string diawali dengan `-isystem` dan ditambahkan ke `COPTS`. Tidak seperti COPTS, flag ini ditambahkan untuk aturan ini dan setiap aturan yang bergantung padanya. (Catatan: bukan aturan yang menjadi dependensinya.) Hati-hati, karena efeknya mungkin sangat luas. Jika ragu, tambahkan tanda "-I" ke COPTS. Header harus ditambahkan ke src atau hdr. Jika tidak, header tidak akan tersedia untuk aturan dependen saat kompilasi di-sandbox (default).
`link_extra_lib`	Label; defaultnya adalah `"@bazel_tools//tools/cpp:link_extra_lib"` Mengontrol penautan library tambahan. Secara default, biner C++ ditautkan dengan `//tools/cpp:link_extra_lib`, yang secara default bergantung pada tanda label `//tools/cpp:link_extra_libs`. Tanpa menyetel tanda, library ini akan kosong secara default. Menyetel tanda label memungkinkan penautan dependensi opsional, seperti penggantian untuk simbol yang lemah, interseptor untuk fungsi library bersama, atau library runtime khusus (untuk penggantian malloc, pilih `malloc` atau `--custom_malloc`). Menyetel atribut ini ke `None` akan menonaktifkan perilaku ini.
`linkopts`	Daftar string; defaultnya adalah `[]` Tambahkan flag ini ke perintah linker C++. Tunduk pada substitusi variabel"Buat", Tokenisasi shell Bourne, dan perluasan label. Setiap string dalam atribut ini ditambahkan ke `LINKOPTS` sebelum menautkan target biner. Setiap elemen daftar ini yang tidak diawali dengan `$` atau `-` dianggap sebagai label target di `deps`. Daftar file yang dihasilkan oleh target tersebut ditambahkan ke opsi penaut. Error akan dilaporkan jika label tidak valid, atau tidak dideklarasikan dalam `deps`.
`linkshared`	Boolean; tidak dapat dikonfigurasi; defaultnya adalah `False` Membuat galeri foto bersama. Untuk mengaktifkan atribut ini, sertakan `linkshared=True` dalam aturan Anda. Secara default, opsi ini nonaktif. Keberadaan tanda ini berarti penautan terjadi dengan tanda `-shared` ke `gcc`, dan library bersama yang dihasilkan akan cocok untuk dimuat, misalnya, ke program Java. Namun, untuk tujuan build, library ini tidak akan pernah ditautkan ke biner dependen, karena dianggap bahwa library bersama yang dibuat dengan aturan cc_binary hanya dimuat secara manual oleh program lain, sehingga library ini tidak boleh dianggap sebagai pengganti aturan cc_library. Demi skalabilitas, sebaiknya hindari pendekatan ini sepenuhnya dan cukup biarkan `java_library` bergantung pada aturan `cc_library`. Jika menentukan `linkopts=['-static']` dan `linkshared=True`, Anda akan mendapatkan satu unit yang sepenuhnya mandiri. Jika menentukan `linkstatic=True` dan `linkshared=True`, Anda akan mendapatkan satu unit yang sebagian besar bersifat mandiri.
`linkstatic`	Boolean; defaultnya adalah `True` Untuk `cc_binary` dan `cc_test`: tautkan biner dalam mode statis. Untuk `cc_library.linkstatic`: lihat di bawah. Secara default, opsi ini aktif untuk `cc_binary` dan nonaktif untuk lainnya. Jika diaktifkan dan ini adalah biner atau pengujian, opsi ini memberi tahu alat build untuk menautkan di `.a`, bukan `.so`, untuk library pengguna jika memungkinkan. Beberapa library sistem mungkin masih ditautkan secara dinamis, seperti halnya library yang tidak memiliki library statis. Jadi, file yang dapat dieksekusi yang dihasilkan akan tetap ditautkan secara dinamis, sehingga hanya sebagian besar statis. Sebenarnya ada tiga cara untuk menautkan {i>executable<i}: STATIC dengan fitur full_static_link, yang semuanya ditautkan secara statis; misalnya, "`gcc -static foo.o libbar.a libbaz.a -lm`". Mode ini diaktifkan dengan menentukan `fully_static_link` dalam atribut `features`. STATIC, tempat semua library pengguna ditautkan secara statis (jika versi statis tersedia), tetapi jika library sistem (tidak termasuk library runtime C/C++) ditautkan secara dinamis, misalnya "`gcc foo.o libfoo.a libbaz.a -lm`". Mode ini diaktifkan dengan menentukan `linkstatic=True`. DYNAMIC, tempat semua library ditautkan secara dinamis (jika versi dinamis tersedia), misalnya, "`gcc foo.o libfoo.so libbaz.so -lm`". Mode ini diaktifkan dengan menentukan `linkstatic=False`. Atribut `linkstatic` memiliki arti yang berbeda jika digunakan pada aturan `cc_library()`. Untuk library C++, `linkstatic=True` menunjukkan bahwa hanya penautan statis yang diizinkan, sehingga tidak ada `.so` yang akan dihasilkan. linkstatic=False tidak mencegah pembuatan library statis. Atribut ini dimaksudkan untuk mengontrol pembuatan library dinamis. Jika `linkstatic=False`, alat build akan membuat symlink ke library bersama yang bergantung pada library bersama di area `*.runfiles`.
`local_defines`	Daftar string; defaultnya adalah `[]` Daftar definisi yang akan ditambahkan ke baris kompilasi. Tunduk pada substitusi variabel"Buat" dan tokenisasi shell Bourne. Setiap string, yang harus terdiri dari satu token shell Bourne, diawali dengan `-D` dan ditambahkan ke command line kompilasi untuk target ini, tetapi tidak ke dependensinya.
`malloc`	Label; defaultnya adalah `"@bazel_tools//tools/cpp:malloc"` Mengganti dependensi default pada malloc. Secara default, biner C++ ditautkan ke `//tools/cpp:malloc`, yang merupakan library kosong sehingga biner akhirnya menggunakan malloc libc. Label ini harus merujuk pada `cc_library`. Jika kompilasi ditujukan untuk aturan non-C++, opsi ini tidak akan berpengaruh. Nilai atribut ini akan diabaikan jika `linkshared=True` ditentukan.
`nocopts`	String; defaultnya adalah `""` Menghapus opsi yang cocok dari perintah kompilasi C++. Tunduk pada substitusi variabel"Buat". Nilai atribut ini ditafsirkan sebagai ekspresi reguler. Semua `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`	Bilangan bulat; defaultnya adalah `-1` Apakah ingin mengenkode informasi build ke dalam biner. Nilai yang mungkin: `stamp = 1`: Selalu tambahkan informasi build ke dalam biner, bahkan dalam build `--nostamp`. Setelan ini harus dihindari, karena berpotensi menghentikan caching jarak jauh untuk biner dan tindakan downstream apa pun yang bergantung padanya. `stamp = 0`: Selalu ganti informasi build dengan nilai konstanta. Cara ini memberikan cache hasil build yang baik. `stamp = -1`: Penyematan informasi build dikontrol oleh tanda `--[no]stamp`. Biner yang distempel tidak dibangun ulang kecuali jika dependensinya berubah.
`win_def_file`	Label; defaultnya adalah `None` File DEF Windows yang akan diteruskan ke penaut. Atribut ini hanya boleh digunakan jika Windows adalah platform target. Library ini dapat digunakan untuk mengekspor simbol selama menautkan library bersama.

cc_import

Lihat sumber aturan

cc_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:
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,
)

2. Menautkan library bersama (Unix)

cc_import(
  name = "mylib",
  hdrs = ["mylib.h"],
  shared_library = "libmylib.so",
)

3. Menautkan library bersama dengan library antarmuka (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 will be available for runtime
  shared_library = "mylib.dll",
)

4. Menautkan library bersama dengan 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,
)

5. Penautan ke library bersama atau statis
Di 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,
)

Di Windows:

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 penyertaan. 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; defaultnya adalah `[]` Daftar library lain yang diandalkan target. Lihat komentar umum tentang `deps` di Atribut umum yang ditentukan oleh sebagian besar aturan build.
`hdrs`	Daftar label; defaultnya adalah `[]` Daftar file header yang dipublikasikan oleh library yang telah dikompilasi sebelumnya ini agar disertakan langsung oleh sumber dalam aturan dependen.
`alwayslink`	Boolean; defaultnya adalah `False` Jika 1, semua biner yang bergantung (langsung atau tidak langsung) pada library C++ yang telah dikompilasi sebelumnya akan tertaut ke semua file objek yang diarsipkan dalam library statis, meskipun beberapa biner tidak berisi simbol yang dirujuk oleh biner. Hal ini berguna jika kode Anda tidak secara eksplisit dipanggil oleh kode dalam biner, misalnya, jika kode Anda didaftarkan untuk menerima beberapa callback yang disediakan oleh beberapa layanan. Jika alwayslink tidak berfungsi dengan VS 2017 di Windows, itu karena masalah umum, upgrade VS 2017 Anda ke versi terbaru.
`interface_library`	Label; defaultnya adalah `None` Satu library antarmuka untuk menautkan library bersama. Jenis file yang diizinkan: `.ifso`, `.tbd`, `.lib`, `.so` atau `.dylib`
`shared_library`	Label; defaultnya adalah `None` Satu library bersama yang telah dikompilasi sebelumnya. Bazel memastikannya tersedia untuk biner yang bergantung padanya selama runtime. Jenis file yang diizinkan: `.so`, `.dll` atau `.dylib`
`static_library`	Label; defaultnya adalah `None` Satu library statis yang telah dikompilasi sebelumnya. Jenis file yang diizinkan: `.a`, `.pic.a` atau `.lib`
`system_provided`	Boolean; defaultnya adalah `False` Jika 1, artinya library bersama yang diperlukan saat runtime disediakan oleh sistem. Dalam hal ini, `interface_library` harus ditentukan dan `shared_library` harus kosong.

cc_library

Lihat sumber aturan

cc_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 aturan cc_*. Hal ini diberlakukan.

Untuk aturan cc_library, header di hdrs membentuk antarmuka publik library dan dapat disertakan langsung dari file dalam hdrs dan srcs library itu sendiri, serta dari file dalam hdrs dan srcs dari aturan cc_* yang mencantumkan library dalam deps. Header di srcs hanya boleh disertakan langsung dari file dalam hdrs dan srcs library itu sendiri. Saat memutuskan apakah akan menempatkan header ke hdrs atau srcs, Anda harus menanyakan apakah Anda ingin konsumen library ini 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 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 tidak 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 penyertaan langsung. Dalam contoh di atas, foo.cc diizinkan untuk menyertakan bar.h, yang dapat menyertakan baz.h, yang nantinya diizinkan untuk menyertakan baz-impl.h. Secara teknis, kompilasi file .cc dapat menyertakan file header apa pun di hdrs atau srcs secara transitif dalam setiap cc_library dalam penutupan deps transitif. Dalam hal ini, compiler dapat membaca baz.h dan baz-impl.h saat mengompilasi foo.cc, tetapi foo.cc tidak boleh berisi #include "baz.h". Agar 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 parameter features dari fungsi package. Toolchain yang disediakan oleh Bazel hanya mendukung fitur ini dengan clang di Unix dan macOS.

Argumen

Atribut
`name`	Nama; wajib diisi Nama unik untuk target ini.
`deps`	Daftar label; defaultnya adalah `[]` Daftar library lain yang akan ditautkan ke target biner. Tujuan ini dapat berupa target `cc_library` atau `objc_library`.
`srcs`	Daftar label; defaultnya adalah `[]` Daftar file C dan C++ yang diproses untuk membuat target. File tersebut adalah file sumber dan header C/C++, baik yang tidak dihasilkan (kode sumber normal) atau yang dihasilkan. Semua file `.cc`, `.c`, dan `.cpp` akan dikompilasi. File ini mungkin merupakan file yang dihasilkan: jika file bernama berada di `outs` dari beberapa aturan lain, aturan ini akan otomatis bergantung pada aturan lain tersebut. File `.h` tidak akan dikompilasi, tetapi akan tersedia untuk disertakan oleh sumber dalam aturan ini. File `.cc` dan `.h` dapat langsung menyertakan header yang tercantum dalam `srcs` ini atau dalam `hdrs` aturan apa pun yang tercantum dalam argumen `deps`. Semua file `#include` harus disebutkan dalam atribut `srcs` aturan ini, atau dalam atribut `hdrs` dari `cc_library()` yang direferensikan. Gaya yang direkomendasikan adalah agar header yang terkait dengan library dicantumkan dalam atribut `hdrs` library tersebut, dan header tersisa apa pun yang terkait dengan sumber aturan ini agar dicantumkan di `srcs`. Lihat "Pemeriksaan penyertaan header" untuk mengetahui deskripsi yang lebih mendetail. Jika nama aturan ada dalam `srcs`, aturan ini akan otomatis bergantung pada nama aturan tersebut. Jika `outs` aturan bernama adalah file sumber C atau C++, file tersebut akan dikompilasi ke dalam aturan ini. Jika merupakan file library, file tersebut akan ditautkan. `srcs` jenis file yang diizinkan: File sumber C dan C++: `.c`, `.cc`, `.cpp`, `.cxx`, `.c++`, `.C` File header C dan C++: `.h`, `.hh`, `.hpp`, `.hxx`, `.inc`, `.inl`, `.H` Assembler dengan preprocessor C: `.S` Arsipkan: `.a`, `.pic.a` Library "Always link": `.lo`, `.pic.lo` Library bersama, berversi atau tanpa versi: `.so`, `.so.version` File objek: `.o`, `.pic.o` ...dan aturan apa pun yang membuat file tersebut. Ekstensi yang berbeda menunjukkan bahasa pemrograman yang berbeda sesuai dengan konvensi gcc.
`hdrs`	Daftar label; defaultnya adalah `[]` Daftar file header yang dipublikasikan oleh library ini untuk disertakan langsung oleh sumber dalam aturan dependen. Ini adalah lokasi yang sangat disarankan untuk mendeklarasikan file header yang mendeskripsikan antarmuka untuk library. Header ini akan disediakan untuk disertakan oleh sumber dalam aturan ini atau aturan dependen. Header yang tidak dimaksudkan untuk disertakan oleh klien library ini harus dicantumkan dalam atribut `srcs`, meskipun disertakan oleh header yang dipublikasikan. Lihat "Pemeriksaan penyertaan header" untuk deskripsi yang lebih mendetail.
`additional_compiler_inputs`	Daftar label; defaultnya adalah `[]` File tambahan apa pun yang mungkin ingin Anda teruskan ke command line compiler, misalnya daftar diabaikan sanitizer. File yang ditentukan di sini kemudian dapat digunakan di copt dengan fungsi $(location).
`additional_linker_inputs`	Daftar label; defaultnya adalah `[]` Teruskan file-file ini ke perintah linker C++. Misalnya, file .res Windows yang dikompilasi dapat disediakan di sini untuk disematkan dalam target biner.
`alwayslink`	Boolean; defaultnya adalah `False` Jika 1, semua biner yang bergantung (langsung atau tidak langsung) pada library C++ ini akan tertaut di semua file objek untuk file yang tercantum dalam `srcs`, meskipun beberapa biner tidak berisi simbol yang dirujuk oleh biner. Hal ini berguna jika kode Anda tidak secara eksplisit dipanggil oleh kode dalam biner, misalnya, jika kode Anda didaftarkan untuk menerima beberapa callback yang disediakan oleh beberapa layanan. Jika alwayslink tidak berfungsi dengan VS 2017 di Windows, itu karena masalah umum, upgrade VS 2017 Anda ke versi terbaru.
`copts`	Daftar string; defaultnya adalah `[]` Tambahkan opsi ini ke perintah kompilasi C++. Tunduk pada substitusi "Buat variabel" dan tokenisasi shell Bourne. Setiap string dalam atribut ini ditambahkan dalam urutan yang ditentukan ke `COPTS` sebelum mengompilasi target biner. Tanda ini hanya berlaku untuk mengompilasi target ini, bukan dependensinya, jadi berhati-hatilah dengan file header yang disertakan di tempat lain. Semua jalur harus relatif terhadap ruang kerja, bukan dengan paket saat ini. Jika paket mendeklarasikan fitur `no_copts_tokenization`, tokenisasi shell Bourne hanya berlaku untuk string yang terdiri dari satu variabel "Make".
`defines`	Daftar string; defaultnya adalah `[]` Daftar definisi yang akan ditambahkan ke baris kompilasi. Tunduk pada substitusi variabel"Buat" dan tokenisasi shell Bourne. Setiap string, yang harus terdiri dari satu token shell Bourne, diawali dengan `-D` dan ditambahkan ke command line kompilasi ke target ini, serta setiap aturan yang bergantung padanya. Hati-hati, karena hal ini mungkin memiliki jangkauan yang luas. Jika ragu, tambahkan nilai definisi ke `local_defines`.
`implementation_deps`	Daftar label; defaultnya adalah `[]` Daftar library lain yang menjadi target library. Tidak seperti `deps`, header dan jalur include library ini (beserta semua dependensi transitifnya) hanya digunakan untuk kompilasi library ini, bukan library yang bergantung padanya. Library yang ditentukan dengan `implementation_deps` masih tertaut dalam target biner yang bergantung pada library ini. Untuk saat ini, penggunaan dibatasi pada cc_libraries dan dilindungi oleh tanda `--experimental_cc_implementation_deps`.
`include_prefix`	String; defaultnya adalah `""` Awalan yang akan ditambahkan ke jalur header aturan ini. Jika ditetapkan, header dalam atribut `hdrs` dari aturan ini dapat diakses adalah nilai atribut ini yang ditambahkan ke jalur relatif repositorinya. Awalan dalam atribut `strip_include_prefix` dihapus sebelum awalan ini ditambahkan.
`includes`	Daftar string; defaultnya adalah `[]` Daftar include dir yang akan ditambahkan ke baris kompilasi. Tunduk pada substitusi "Buat variabel". Setiap string diawali dengan `-isystem` dan ditambahkan ke `COPTS`. Tidak seperti COPTS, flag ini ditambahkan untuk aturan ini dan setiap aturan yang bergantung padanya. (Catatan: bukan aturan yang menjadi dependensinya.) Hati-hati, karena efeknya mungkin sangat luas. Jika ragu, tambahkan tanda "-I" ke COPTS. Header harus ditambahkan ke src atau hdr. Jika tidak, header tidak akan tersedia untuk aturan dependen saat kompilasi di-sandbox (default).
`linkopts`	Daftar string; defaultnya adalah `[]` Tambahkan flag ini ke perintah linker C++. Tunduk pada substitusi variabel"Buat", Tokenisasi shell Bourne, dan perluasan label. Setiap string dalam atribut ini ditambahkan ke `LINKOPTS` sebelum menautkan target biner. Setiap elemen daftar ini yang tidak diawali dengan `$` atau `-` dianggap sebagai label target di `deps`. Daftar file yang dihasilkan oleh target tersebut ditambahkan ke opsi penaut. Error akan dilaporkan jika label tidak valid, atau tidak dideklarasikan dalam `deps`.
`linkstamp`	Label; defaultnya adalah `None` Secara bersamaan mengompilasi dan menautkan file sumber C++ yang ditentukan ke dalam biner akhir. Trik ini diperlukan untuk memperkenalkan informasi stempel waktu ke dalam biner; jika kita mengompilasi file sumber ke file objek dengan cara biasa, stempel waktu akan menjadi salah. Kompilasi linkstamp mungkin tidak menyertakan kumpulan tanda compiler tertentu, sehingga tidak boleh bergantung pada header, opsi compiler, atau variabel build tertentu lainnya. Opsi ini hanya diperlukan dalam paket `base`.
`linkstatic`	Boolean; defaultnya adalah `False` Untuk `cc_binary` dan `cc_test`: tautkan biner dalam mode statis. Untuk `cc_library.linkstatic`: lihat di bawah. Secara default, opsi ini aktif untuk `cc_binary` dan nonaktif untuk lainnya. Jika diaktifkan dan ini adalah biner atau pengujian, opsi ini memberi tahu alat build untuk menautkan di `.a`, bukan `.so`, untuk library pengguna jika memungkinkan. Beberapa library sistem mungkin masih ditautkan secara dinamis, seperti halnya library yang tidak memiliki library statis. Jadi, file yang dapat dieksekusi yang dihasilkan akan tetap ditautkan secara dinamis, sehingga hanya sebagian besar statis. Sebenarnya ada tiga cara untuk menautkan {i>executable<i}: STATIC dengan fitur full_static_link, yang semuanya ditautkan secara statis; misalnya, "`gcc -static foo.o libbar.a libbaz.a -lm`". Mode ini diaktifkan dengan menentukan `fully_static_link` dalam atribut `features`. STATIC, tempat semua library pengguna ditautkan secara statis (jika versi statis tersedia), tetapi jika library sistem (tidak termasuk library runtime C/C++) ditautkan secara dinamis, misalnya "`gcc foo.o libfoo.a libbaz.a -lm`". Mode ini diaktifkan dengan menentukan `linkstatic=True`. DYNAMIC, tempat semua library ditautkan secara dinamis (jika versi dinamis tersedia), misalnya, "`gcc foo.o libfoo.so libbaz.so -lm`". Mode ini diaktifkan dengan menentukan `linkstatic=False`. Atribut `linkstatic` memiliki arti yang berbeda jika digunakan pada aturan `cc_library()`. Untuk library C++, `linkstatic=True` menunjukkan bahwa hanya penautan statis yang diizinkan, sehingga tidak ada `.so` yang akan dihasilkan. linkstatic=False tidak mencegah pembuatan library statis. Atribut ini dimaksudkan untuk mengontrol pembuatan library dinamis. Jika `linkstatic=False`, alat build akan membuat symlink ke library bersama yang bergantung pada library bersama di area `*.runfiles`.
`local_defines`	Daftar string; defaultnya adalah `[]` Daftar definisi yang akan ditambahkan ke baris kompilasi. Tunduk pada substitusi variabel"Buat" dan tokenisasi shell Bourne. Setiap string, yang harus terdiri dari satu token shell Bourne, diawali dengan `-D` dan ditambahkan ke command line kompilasi untuk target ini, tetapi tidak ke dependensinya.
`nocopts`	String; defaultnya adalah `""` Menghapus opsi yang cocok dari perintah kompilasi C++. Tunduk pada substitusi variabel"Buat". Nilai atribut ini ditafsirkan sebagai ekspresi reguler. Semua `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; defaultnya adalah `""` Awalan yang akan dihapus dari jalur header aturan ini. Jika ditetapkan, header dalam atribut `hdrs` dari aturan ini dapat diakses di jalurnya dengan potongan awalan ini. Jika jalur relatif, maka akan diambil sebagai jalur yang relatif terhadap paket. Jika nilainya absolut, nilainya akan dipahami sebagai jalur relatif repositori. Awalan dalam atribut `include_prefix` ditambahkan setelah awalan ini dihapus.
`textual_hdrs`	Daftar label; defaultnya adalah `[]` Daftar file header yang dipublikasikan oleh library ini untuk disertakan secara tekstual oleh sumber dalam aturan dependen. Ini adalah lokasi untuk mendeklarasikan file header yang tidak dapat dikompilasi sendiri sehingga harus selalu disertakan secara tekstual oleh file sumber lain agar dapat membuat kode yang valid.
`win_def_file`	Label; defaultnya adalah `None` File DEF Windows yang akan diteruskan ke penaut. Atribut ini hanya boleh digunakan jika Windows adalah platform target. Library ini dapat digunakan untuk mengekspor simbol selama menautkan library bersama.

cc_proto_library

Lihat sumber aturan

cc_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; defaultnya adalah []

Daftar aturan proto_library yang akan digunakan untuk membuat kode C++.

cc_shared_library

Lihat sumber aturan

cc_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 secara statis menautkan foo dan baz, yang kedua adalah dependensi transitif. Metode ini tidak menautkan bar karena sudah disediakan secara dinamis oleh dynamic_dep bar_shared.

foo_shared menggunakan file skrip penaut *.lds untuk mengontrol simbol mana yang harus diekspor. Logika aturan cc_shared_library tidak mengontrol simbol mana yang akan diekspor. Logika aturan tersebut hanya menggunakan simbol yang diasumsikan untuk diekspor untuk memberikan error selama fase analisis jika dua library bersama mengekspor target yang sama.

Setiap dependensi langsung cc_shared_library dianggap telah diekspor. Oleh karena itu, selama analisis berlangsung, Bazel mengasumsikan bahwa foo diekspor oleh foo_shared. baz tidak dianggap diekspor oleh foo_shared. Setiap target yang cocok dengan exports_filter juga diasumsikan sebagai ekspor.

Setiap cc_library dalam contoh akan muncul paling banyak dalam satu cc_shared_library. Jika ingin menautkan baz juga ke bar_shared, kita perlu menambahkan tags = ["LINKABLE_MORE_THAN_ONCE"] ke baz.

Karena atribut shared_lib_name, file yang dihasilkan oleh bar_shared akan memiliki nama bar.so, bukan 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 dependensi cc_shared_library berbeda 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 berbeda yang menautkan target yang sama secara statis. Mirip dengan error pada ekspor.

Salah satu cara untuk memperbaikinya adalah dengan berhenti menautkan library ke salah satu dependensi cc_shared_library. Pada saat yang sama, pengguna yang masih menautkannya harus mengekspor library agar yang tidak menautkannya tetap menjaga visibilitas ke simbol-simbolnya. Cara lain adalah dengan menarik library ketiga yang mengekspor target. Cara ketiga adalah memberi tag penyebab cc_library dengan LINKABLE_MORE_THAN_ONCE, tetapi perbaikan ini jarang terjadi dan Anda harus benar-benar memastikan bahwa cc_library benar-benar 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 mengambil cc_shared_library ketiga yang mengekspornya.

`Do not place libraries which only contain a precompiled dynamic library in deps.`

Jika Anda memiliki library dinamis yang telah dikompilasi sebelumnya, library ini tidak perlu dan tidak dapat ditautkan secara statis ke target cc_shared_library saat ini yang sedang Anda buat. Oleh karena itu, varian tersebut tidak termasuk dalam deps dari cc_shared_library. Jika library dinamis yang telah dikompilasi sebelumnya ini merupakan dependensi dari salah satu cc_libraries, 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 memperbaiki masalah ini, hapus target dari deps dan cukup andalkan dari dependensi dinamis atau pastikan exports_filter tidak menangkap target ini.

Argumen

Atribut
`name`	Nama; wajib diisi Nama unik untuk target ini.
`deps`	Daftar label; defaultnya adalah `[]` Library tingkat teratas yang akan ditautkan secara statis ke library bersama tanpa syarat ke library bersama setelah diarsipkan sepenuhnya. Setiap dependensi library transitif dari dependensi langsung ini akan ditautkan ke library bersama ini selama dependensi tersebut belum ditautkan oleh `cc_shared_library` dalam `dynamic_deps`. Selama analisis, penerapan aturan akan menganggap semua target yang tercantum di `deps` sebagai target yang diekspor oleh library bersama, sehingga terjadi error saat beberapa `cc_shared_libraries` mengekspor target yang sama. Penerapan aturan tidak bertanggung jawab untuk memberi tahu linker tentang simbol mana yang harus diekspor oleh objek bersama. Pengguna harus menangani hal ini melalui skrip penaut atau deklarasi visibilitas dalam kode sumber. Implementasi ini juga akan memicu error setiap kali library yang sama ditautkan secara statis ke lebih dari satu `cc_shared_library`. Hal ini dapat dihindari dengan menambahkan `"LINKABLE_MORE_THAN_ONCE"` ke `cc_library.tags` atau dengan mencantumkan `cc_library` sebagai ekspor dari salah satu library bersama sehingga salah satu library dapat dibuat `dynamic_dep` library lainnya.
`additional_linker_inputs`	Daftar label; defaultnya adalah `[]` File tambahan apa pun yang mungkin ingin Anda teruskan ke penaut, misalnya, skrip penaut. Anda harus meneruskan tanda penaut secara terpisah yang diperlukan penaut untuk mengetahui file ini. Anda dapat melakukannya melalui atribut `user_link_flags`.
`dynamic_deps`	Daftar label; defaultnya adalah `[]` Ini adalah dependensi `cc_shared_library` lain yang menjadi dependensi target saat ini. Implementasi `cc_shared_library` akan menggunakan daftar `dynamic_deps` (secara transitif, yaitu juga `dynamic_deps` dari `dynamic_deps` target saat ini) untuk menentukan `cc_libraries` mana dalam `deps` transitif yang tidak boleh ditautkan karena telah disediakan oleh `cc_shared_library` yang berbeda.
`exports_filter`	Daftar string; defaultnya adalah `[]` Atribut ini berisi daftar target yang diklaim untuk diekspor oleh library bersama saat ini. Setiap target `deps` sudah dipahami untuk diekspor oleh library bersama. Atribut ini harus digunakan untuk mencantumkan target apa pun yang diekspor oleh library bersama, tetapi merupakan dependensi transitif `deps`. Perlu diperhatikan bahwa atribut ini tidak benar-benar menambahkan edge dependensi ke target tersebut, edge dependensi seharusnya dibuat oleh `deps`.Entri dalam atribut ini hanyalah string. Perlu diingat bahwa saat menempatkan target dalam atribut ini, hal ini dianggap sebagai klaim bahwa library bersama mengekspor simbol dari target tersebut. Logika `cc_shared_library` sebenarnya tidak menangani pemberian tahu simbol mana yang harus diekspor. Sintaksis berikut diizinkan: `//foo:__package__` untuk memperhitungkan target apa pun di foo/BUILD `//foo:__subpackages__` untuk memperhitungkan target apa pun di foo/BUILD atau paket lainnya di bawah foo/ seperti foo/bar/BUILD
`shared_lib_name`	String; defaultnya adalah `""` Secara default, cc_shared_library akan menggunakan nama untuk file output library bersama berdasarkan nama target dan platform. Hal ini mencakup ekstensi dan terkadang awalan. Terkadang, Anda mungkin tidak menginginkan nama default, misalnya, saat memuat library bersama C++ untuk Python, awalan lib* default sering kali tidak diinginkan. Dalam hal ini, Anda dapat menggunakan atribut ini untuk memilih nama kustom.
`user_link_flags`	Daftar string; defaultnya adalah `[]` Tanda tambahan apa pun yang mungkin ingin Anda teruskan ke penaut. Misalnya, untuk membuat penaut mengenali skrip penaut yang diteruskan melalui additional_linker_inputs, Anda dapat menggunakan kode berikut: 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; defaultnya adalah `None` File DEF Windows yang akan diteruskan ke penaut. Atribut ini hanya boleh digunakan jika Windows adalah platform target. Library ini dapat digunakan untuk mengekspor simbol selama menautkan library bersama.

fdo_prefetch_hints

Lihat sumber aturan

fdo_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 jalur absolut yang ditentukan. 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; defaultnya adalah None

Label profil petunjuk. File petunjuk memiliki ekstensi .afdo. Label juga dapat mengarah ke aturan fdo_absolute_path_profile.

fdo_profile

Lihat sumber aturan

fdo_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; defaultnya adalah `""` Jalur absolut ke profil FDO. File FDO mungkin hanya memiliki ekstensi .afdo.
`profile`	Label; defaultnya adalah `None` Label profil FDO atau aturan yang membuatnya. File FDO dapat memiliki salah satu ekstensi berikut: .profraw untuk profil LLVM yang tidak diindeks, .profdata untuk profil LLVM terindeks, .zip yang menyimpan profil profraw LLVM, .afdo untuk profil AutoFDO, dan .xfdo untuk profil XBinary. Label juga dapat mengarah ke aturan fdo_absolute_path_profile.
`proto_profile`	Label; defaultnya adalah `None` Label profil protobuf.

memprof_profile

Lihat sumber aturan

memprof_profile(name, absolute_path_profile, compatible_with, deprecation, distribs, features, licenses, profile, restricted_to, tags, target_compatible_with, testonly, visibility)

Merepresentasikan profil MEMPROF yang ada di ruang kerja atau di jalur absolut yang ditentukan. 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; defaultnya adalah ""

Jalur absolut ke profil MEMPROF. File tersebut hanya boleh memiliki ekstensi .profdata atau .zip (dengan zipfile harus berisi file memprof.profdata).

profile

Label; defaultnya adalah None

Label profil MEMPROF. Profil tersebut diharapkan memiliki ekstensi .profdata (untuk profil memprof yang diindeks/disimbolkan), atau ekstensi .zip untuk file zip yang berisi file memprof.profdata. Label juga dapat mengarah ke aturan fdo_absolute_path_profile.

propeller_optimize

Lihat sumber aturan

propeller_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; defaultnya adalah None

Label profil yang diteruskan ke tindakan penautan. File ini memiliki ekstensi .txt.

cc_test

Lihat sumber aturan

cc_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; defaultnya adalah `[]` Daftar library lain yang akan ditautkan ke target biner. Tujuan ini dapat berupa target `cc_library` atau `objc_library`.
`srcs`	Daftar label; defaultnya adalah `[]` Daftar file C dan C++ yang diproses untuk membuat target. File tersebut adalah file sumber dan header C/C++, baik yang tidak dihasilkan (kode sumber normal) atau yang dihasilkan. Semua file `.cc`, `.c`, dan `.cpp` akan dikompilasi. File ini mungkin merupakan file yang dihasilkan: jika file bernama berada di `outs` dari beberapa aturan lain, aturan ini akan otomatis bergantung pada aturan lain tersebut. File `.h` tidak akan dikompilasi, tetapi akan tersedia untuk disertakan oleh sumber dalam aturan ini. File `.cc` dan `.h` dapat langsung menyertakan header yang tercantum dalam `srcs` ini atau dalam `hdrs` aturan apa pun yang tercantum dalam argumen `deps`. Semua file `#include` harus disebutkan dalam atribut `srcs` aturan ini, atau dalam atribut `hdrs` dari `cc_library()` yang direferensikan. Gaya yang direkomendasikan adalah agar header yang terkait dengan library dicantumkan dalam atribut `hdrs` library tersebut, dan header tersisa apa pun yang terkait dengan sumber aturan ini agar dicantumkan di `srcs`. Lihat "Pemeriksaan penyertaan header" untuk mengetahui deskripsi yang lebih mendetail. Jika nama aturan ada dalam `srcs`, aturan ini akan otomatis bergantung pada nama aturan tersebut. Jika `outs` aturan bernama adalah file sumber C atau C++, file tersebut akan dikompilasi ke dalam aturan ini. Jika merupakan file library, file tersebut akan ditautkan. `srcs` jenis file yang diizinkan: File sumber C dan C++: `.c`, `.cc`, `.cpp`, `.cxx`, `.c++`, `.C` File header C dan C++: `.h`, `.hh`, `.hpp`, `.hxx`, `.inc`, `.inl`, `.H` Assembler dengan preprocessor C: `.S` Arsipkan: `.a`, `.pic.a` Library "Always link": `.lo`, `.pic.lo` Library bersama, berversi atau tanpa versi: `.so`, `.so.version` File objek: `.o`, `.pic.o` ...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; defaultnya adalah `[]` Teruskan file-file ini ke perintah linker C++. Misalnya, file .res Windows yang dikompilasi dapat disediakan di sini untuk disematkan dalam target biner.
`copts`	Daftar string; defaultnya adalah `[]` Tambahkan opsi ini ke perintah kompilasi C++. Tunduk pada substitusi "Buat variabel" dan tokenisasi shell Bourne. Setiap string dalam atribut ini ditambahkan dalam urutan yang ditentukan ke `COPTS` sebelum mengompilasi target biner. Tanda ini hanya berlaku untuk mengompilasi target ini, bukan dependensinya, jadi berhati-hatilah dengan file header yang disertakan di tempat lain. Semua jalur harus relatif terhadap ruang kerja, bukan dengan paket saat ini. Jika paket mendeklarasikan fitur `no_copts_tokenization`, tokenisasi shell Bourne hanya berlaku untuk string yang terdiri dari satu variabel "Make".
`defines`	Daftar string; defaultnya adalah `[]` Daftar definisi yang akan ditambahkan ke baris kompilasi. Tunduk pada substitusi variabel"Buat" dan tokenisasi shell Bourne. Setiap string, yang harus terdiri dari satu token shell Bourne, diawali dengan `-D` dan ditambahkan ke command line kompilasi ke target ini, serta setiap aturan yang bergantung padanya. Hati-hati, karena hal ini mungkin memiliki jangkauan yang luas. Jika ragu, tambahkan nilai definisi ke `local_defines`.
`includes`	Daftar string; defaultnya adalah `[]` Daftar include dir yang akan ditambahkan ke baris kompilasi. Tunduk pada substitusi "Buat variabel". Setiap string diawali dengan `-isystem` dan ditambahkan ke `COPTS`. Tidak seperti COPTS, flag ini ditambahkan untuk aturan ini dan setiap aturan yang bergantung padanya. (Catatan: bukan aturan yang menjadi dependensinya.) Hati-hati, karena efeknya mungkin sangat luas. Jika ragu, tambahkan tanda "-I" ke COPTS. Header harus ditambahkan ke src atau hdr. Jika tidak, header tidak akan tersedia untuk aturan dependen saat kompilasi di-sandbox (default).
`link_extra_lib`	Label; defaultnya adalah `"@bazel_tools//tools/cpp:link_extra_lib"` Mengontrol penautan library tambahan. Secara default, biner C++ ditautkan dengan `//tools/cpp:link_extra_lib`, yang secara default bergantung pada tanda label `//tools/cpp:link_extra_libs`. Tanpa menyetel tanda, library ini akan kosong secara default. Menyetel tanda label memungkinkan penautan dependensi opsional, seperti penggantian untuk simbol yang lemah, interseptor untuk fungsi library bersama, atau library runtime khusus (untuk penggantian malloc, pilih `malloc` atau `--custom_malloc`). Menyetel atribut ini ke `None` akan menonaktifkan perilaku ini.
`linkopts`	Daftar string; defaultnya adalah `[]` Tambahkan flag ini ke perintah linker C++. Tunduk pada substitusi variabel"Buat", Tokenisasi shell Bourne, dan perluasan label. Setiap string dalam atribut ini ditambahkan ke `LINKOPTS` sebelum menautkan target biner. Setiap elemen daftar ini yang tidak diawali dengan `$` atau `-` dianggap sebagai label target di `deps`. Daftar file yang dihasilkan oleh target tersebut ditambahkan ke opsi penaut. Error akan dilaporkan jika label tidak valid, atau tidak dideklarasikan dalam `deps`.
`linkstatic`	Boolean; defaultnya adalah `False` Untuk `cc_binary` dan `cc_test`: tautkan biner dalam mode statis. Untuk `cc_library.linkstatic`: lihat di bawah. Secara default, opsi ini aktif untuk `cc_binary` dan nonaktif untuk lainnya. Jika diaktifkan dan ini adalah biner atau pengujian, opsi ini memberi tahu alat build untuk menautkan di `.a`, bukan `.so`, untuk library pengguna jika memungkinkan. Beberapa library sistem mungkin masih ditautkan secara dinamis, seperti halnya library yang tidak memiliki library statis. Jadi, file yang dapat dieksekusi yang dihasilkan akan tetap ditautkan secara dinamis, sehingga hanya sebagian besar statis. Sebenarnya ada tiga cara untuk menautkan {i>executable<i}: STATIC dengan fitur full_static_link, yang semuanya ditautkan secara statis; misalnya, "`gcc -static foo.o libbar.a libbaz.a -lm`". Mode ini diaktifkan dengan menentukan `fully_static_link` dalam atribut `features`. STATIC, tempat semua library pengguna ditautkan secara statis (jika versi statis tersedia), tetapi jika library sistem (tidak termasuk library runtime C/C++) ditautkan secara dinamis, misalnya "`gcc foo.o libfoo.a libbaz.a -lm`". Mode ini diaktifkan dengan menentukan `linkstatic=True`. DYNAMIC, tempat semua library ditautkan secara dinamis (jika versi dinamis tersedia), misalnya, "`gcc foo.o libfoo.so libbaz.so -lm`". Mode ini diaktifkan dengan menentukan `linkstatic=False`. Atribut `linkstatic` memiliki arti yang berbeda jika digunakan pada aturan `cc_library()`. Untuk library C++, `linkstatic=True` menunjukkan bahwa hanya penautan statis yang diizinkan, sehingga tidak ada `.so` yang akan dihasilkan. linkstatic=False tidak mencegah pembuatan library statis. Atribut ini dimaksudkan untuk mengontrol pembuatan library dinamis. Jika `linkstatic=False`, alat build akan membuat symlink ke library bersama yang bergantung pada library bersama di area `*.runfiles`.
`local_defines`	Daftar string; defaultnya adalah `[]` Daftar definisi yang akan ditambahkan ke baris kompilasi. Tunduk pada substitusi variabel"Buat" dan tokenisasi shell Bourne. Setiap string, yang harus terdiri dari satu token shell Bourne, diawali dengan `-D` dan ditambahkan ke command line kompilasi untuk target ini, tetapi tidak ke dependensinya.
`malloc`	Label; defaultnya adalah `"@bazel_tools//tools/cpp:malloc"` Mengganti dependensi default pada malloc. Secara default, biner C++ ditautkan ke `//tools/cpp:malloc`, yang merupakan library kosong sehingga biner akhirnya menggunakan malloc libc. Label ini harus merujuk pada `cc_library`. Jika kompilasi ditujukan untuk aturan non-C++, opsi ini tidak akan berpengaruh. Nilai atribut ini akan diabaikan jika `linkshared=True` ditentukan.
`nocopts`	String; defaultnya adalah `""` Menghapus opsi yang cocok dari perintah kompilasi C++. Tunduk pada substitusi variabel"Buat". Nilai atribut ini ditafsirkan sebagai ekspresi reguler. Semua `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`	Bilangan bulat; defaultnya adalah `0` Apakah ingin mengenkode informasi build ke dalam biner. Nilai yang mungkin: `stamp = 1`: Selalu tambahkan informasi build ke dalam biner, bahkan dalam build `--nostamp`. Setelan ini harus dihindari, karena berpotensi menghentikan caching jarak jauh untuk biner dan tindakan downstream apa pun yang bergantung padanya. `stamp = 0`: Selalu ganti informasi build dengan nilai konstanta. Cara ini memberikan cache hasil build yang baik. `stamp = -1`: Penyematan informasi build dikontrol oleh tanda `--[no]stamp`. Biner yang distempel tidak dibangun ulang kecuali jika dependensinya berubah.
`win_def_file`	Label; defaultnya adalah `None` File DEF Windows yang akan diteruskan ke penaut. Atribut ini hanya boleh digunakan jika Windows adalah platform target. Library ini dapat digunakan untuk mengekspor simbol selama menautkan library bersama.

cc_toolchain

Lihat sumber aturan

cc_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 atribut seperti all_files, compiler_files, linker_files, atau atribut lain yang diakhiri dengan _files). Ini adalah grup file yang paling sering menggabungkan semua file yang diperlukan.
Membuat command line yang benar untuk tindakan C++. Hal ini dilakukan menggunakan penyedia CcToolchainConfigInfo (detail di bawah).

Gunakan atribut toolchain_config untuk mengonfigurasi toolchain C++. Lihat juga halaman ini untuk konfigurasi toolchain C++ yang rumit dan dokumentasi pemilihan toolchain.

Gunakan tags = ["manual"] untuk mencegah toolchain dibangun dan dikonfigurasi jika 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 yang lebih presisi dari atribut di bawah). Bazel menganggap `all_files` adalah superset dari semua atribut penyedia artefak lainnya (misalnya, kompilasi linkstamp memerlukan file kompilasi dan link, sehingga memerlukan `all_files`). `cc_toolchain.files` berisi, dan digunakan oleh semua aturan Starlark menggunakan toolchain C++.
`ar_files`	Label; defaultnya adalah `None` Koleksi semua artefak cc_toolchain yang diperlukan untuk tindakan pengarsipan.
`as_files`	Label; defaultnya adalah `None` 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; defaultnya adalah `None` Koleksi semua artefak cc_toolchain yang diperlukan untuk tindakan kompilasi jika penemuan input didukung (saat ini khusus Google).
`coverage_files`	Label; defaultnya adalah `None` Koleksi semua artefak cc_toolchain yang diperlukan untuk tindakan cakupan. Jika tidak ditentukan, all_file akan digunakan.
`dwp_files`	Label; wajib diisi Koleksi semua artefak cc_toolchain yang diperlukan untuk tindakan dwp.
`dynamic_runtime_lib`	Label; defaultnya adalah `None` Artefak library dinamis untuk library runtime C++ (misalnya mdpi++.so). Ini akan digunakan saat fitur 'static_link_cpp_runtimes' diaktifkan, dan kita akan menautkan dependensi secara dinamis.
`exec_transition_for_inputs`	Boolean; defaultnya adalah `True` Setel ke Benar (True) untuk membangun semua input file ke cc_ toolchain untuk platform exec, bukan tidak memiliki transisi (yaitu platform target secara default).
`libc_top`	Label; defaultnya adalah `None` Kumpulan artefak untuk libc yang diteruskan sebagai input untuk mengompilasi/menautkan tindakan.
`linker_files`	Label; wajib diisi Koleksi semua artefak cc_ toolchain yang diperlukan untuk menautkan tindakan.
`module_map`	Label; defaultnya adalah `None` Artefak peta modul yang akan digunakan untuk build modular.
`objcopy_files`	Label; wajib diisi Koleksi semua artefak cc_toolchain yang diperlukan untuk tindakan objcopy.
`static_runtime_lib`	Label; defaultnya adalah `None` Artefak library statis untuk library runtime C++ (misalnya mdpi++.a). Ini akan digunakan saat fitur 'static_link_cpp_runtimes' diaktifkan, dan kita menautkan dependensi secara statis.
`strip_files`	Label; wajib diisi Koleksi semua artefak cc_toolchain yang diperlukan untuk tindakan strip.
`supports_header_parsing`	Boolean; defaultnya adalah `False` Tetapkan ke Benar jika cc_toolchain mendukung tindakan penguraian header.
`supports_param_files`	Boolean; defaultnya adalah `True` Setel ke Benar (True) jika cc_ toolchain mendukung penggunaan file param untuk menautkan tindakan.
`toolchain_config`	Label; wajib diisi Label aturan yang menyediakan `cc_toolchain_config_info`.
`toolchain_identifier`	String; tidak dapat dikonfigurasi; defaultnya adalah `""` ID yang digunakan untuk mencocokkan cc_ toolchain ini dengan crosstool_config.toolchain yang sesuai. Hingga masalah #5380 diperbaiki, ini adalah cara yang direkomendasikan untuk mengaitkan `cc_toolchain` dengan `CROSSTOOL.toolchain`. Atribut ini akan diganti dengan atribut `toolchain_config` (#5380).

cc_toolchain_suite

Lihat sumber aturan

cc_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 yang diteruskan ke Bazel.

Lihat juga halaman ini untuk konfigurasi toolchain C++ yang rumit dan dokumentasi pemilihan toolchain.

Argumen

Atribut

name

Nama; wajib diisi

Nama unik untuk target ini.

toolchains

Kamus yang memetakan string ke label; tidak dapat dikonfigurasi; wajib

Peta dari string "<cpu>" atau "<cpu>|<compiler>" ke label cc_toolchain. "<cpu>" akan digunakan saat hanya --cpu yang 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",
            },
          )