Halaman ini diterjemahkan oleh Cloud Translation API.

Aturan C / C++

Aturan

cc_binary
cc_import
cc_library
cc_proto_library
fdo_prefetch_hints
fdo_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, 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 dihilangkan. strip -g dijalankan pada biner untuk menghapus simbol debug. Opsi strip tambahan dapat disediakan 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`	`Name; required` Nama unik untuk target ini.
`deps`	`List of labels; optional` Daftar library lain yang akan ditautkan ke target biner. Ini dapat berupa target `cc_library` atau `objc_library`.
`srcs`	`List of labels; optional` Daftar file C dan C++ yang diproses untuk membuat target. File ini adalah file sumber dan header C/C++, baik yang tidak dihasilkan (kode sumber normal) maupun yang dihasilkan. Semua file `.cc`, `.c`, dan `.cpp` akan dikompilasi. File ini mungkin dihasilkan: jika file bernama ada 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. Baik file `.cc` maupun `.h` dapat langsung menyertakan header yang tercantum dalam `srcs` ini atau dalam `hdrs` dari aturan yang tercantum dalam argumen `deps`. Semua file `#include`d harus disebutkan dalam atribut `srcs` aturan ini, atau dalam atribut `hdrs` dari `cc_library()` yang direferensikan. Gaya yang direkomendasikan adalah untuk header yang terkait dengan library yang dicantumkan dalam atribut `hdrs` library tersebut, dan header apa pun lainnya yang terkait dengan sumber aturan ini dicantumkan di `srcs`. Lihat "Pemeriksaan penyertaan header" untuk deskripsi yang lebih mendetail. Jika nama aturan ada di `srcs`, aturan ini otomatis bergantung pada nama tersebut. Jika `outs` aturan yang dinamai adalah file sumber C atau C++, file tersebut akan dikompilasi ke dalam aturan ini; jika merupakan file library, kedua 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` Arsip: `.a`, `.pic.a` Library "Selalu tautkan": `.lo`, `.pic.lo` Library bersama, berversi atau tanpa versi: `.so`, `.so.version` File objek: `.o`, `.pic.o` ...dan aturan apa pun yang menghasilkan file tersebut. Ekstensi yang berbeda menunjukkan bahasa pemrograman yang berbeda sesuai dengan konvensi gcc.
`additional_linker_inputs`	`List of labels; optional` Teruskan file ini ke perintah penaut C++. Misalnya, file .res Windows yang dikompilasi dapat diberikan di sini untuk disematkan dalam target biner.
`copts`	`List of strings; optional` Tambahkan opsi ini ke perintah kompilasi C++. Tunduk pada penggantian "Buat variabel" dan tokenisasi Bourne shell. Setiap string dalam atribut ini ditambahkan dalam urutan tertentu ke `COPTS` sebelum mengompilasi target biner. Flag 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`	`List of strings; optional` Daftar definisi untuk ditambahkan ke baris kompilasi. Tunduk pada penggantian variabel"Buat" dan tokenisasi Bourne shell. Setiap string, yang harus terdiri dari satu token shell Bourne, diawali dengan `-D` dan ditambahkan ke command line kompilasi ke target ini, serta ke setiap aturan yang bergantung padanya. Hati-hati, karena hal ini mungkin berdampak luas. Jika ragu, tambahkan nilai tentukan ke `local_defines`.
`includes`	`List of strings; optional` Daftar direktori penyertaan yang akan ditambahkan ke baris kompilasi. Tunduk pada penggantian "Buat variabel". Setiap string diawali dengan `-isystem` dan ditambahkan ke `COPTS`. Tidak seperti COPTS, tanda ini ditambahkan untuk aturan ini dan setiap aturan yang bergantung padanya. (Catatan: bukan aturan yang menjadi dependensinya.) Hati-hati, karena hal ini mungkin memiliki dampak yang luas. Jika ragu, tambahkan flag "-I" ke COPTS. Header harus ditambahkan ke srcs atau hdrs. Jika tidak, header tidak akan tersedia untuk aturan dependen saat kompilasi di-sandbox (default).
`linkopts`	`List of strings; optional` Tambahkan flag ini ke perintah linker C++. Tunduk pada penggantian 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 `-` diasumsikan sebagai label target dalam `deps`. Daftar file yang dihasilkan oleh target tersebut akan ditambahkan ke opsi linker. Error dilaporkan jika label tidak valid, atau tidak dideklarasikan dalam `deps`.
`linkshared`	`Boolean; optional; nonconfigurable; default is False` Membuat pustaka bersama. Untuk mengaktifkan atribut ini, sertakan `linkshared=True` dalam aturan Anda. Secara default, opsi ini nonaktif. Adanya flag ini berarti penautan terjadi dengan flag `-shared` ke `gcc`, dan library bersama yang dihasilkan cocok untuk dimuat, misalnya, program Java. Namun, untuk tujuan build, class 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 tidak boleh dianggap sebagai pengganti aturan cc_library. Demi skalabilitas, sebaiknya hindari pendekatan ini sama sekali dan cukup izinkan `java_library` bergantung pada aturan `cc_library`. Jika menentukan `linkopts=['-static']` dan `linkshared=True`, Anda akan mendapatkan satu unit yang sepenuhnya berfungsi. Jika menentukan `linkstatic=True` dan `linkshared=True`, Anda akan mendapatkan satu unit yang sebagian besar mandiri.
`linkstatic`	`Boolean; optional; default is 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 sisanya. Jika diaktifkan dan ini adalah biner atau pengujian, opsi ini akan memberi tahu alat build untuk menautkan dalam `.a`, bukan `.so` untuk library pengguna jika memungkinkan. Beberapa library sistem mungkin masih ditautkan secara dinamis, seperti library yang tidak memiliki library statis. Jadi, file yang dapat dieksekusi yang dihasilkan akan tetap ditautkan secara dinamis, sehingga sebagian besar hanya bersifat statis. Sebenarnya ada tiga cara berbeda untuk menautkan file yang dapat dieksekusi: STATIC dengan fitur full_static_link, dengan fitur ini 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, yaitu semua library pengguna ditautkan secara statis (jika versi statis tersedia), tetapi 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, ketika 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 dependen di area `*.runfiles`.
`local_defines`	`List of strings; optional` Daftar definisi untuk ditambahkan ke baris kompilasi. Tunduk pada penggantian variabel"Buat" dan tokenisasi Bourne shell. 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 turunannya.
`malloc`	`Label; optional; default is @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 libc malloc. Label ini harus merujuk ke `cc_library`. Jika kompilasi ditujukan untuk aturan non-C++, opsi ini tidak akan berpengaruh. Nilai atribut ini diabaikan jika `linkshared=True` ditentukan.
`nocopts`	`String; optional` Menghapus opsi pencocokan dari perintah kompilasi C++. Tunduk pada penggantian variabel"Make". Nilai atribut ini diinterpretasikan sebagai ekspresi reguler. Setiap `COPTS` yang sudah ada dan cocok dengan ekspresi reguler ini (termasuk nilai yang secara eksplisit ditentukan dalam atribut copts aturan) akan dihapus dari `COPTS` untuk tujuan kompilasi aturan ini. Atribut ini jarang diperlukan.
`stamp`	`Integer; optional; default is -1` Apakah akan mengenkode informasi build ke dalam biner. Nilai yang mungkin: `stamp = 1`: Selalu beri stempel pada 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. Hal ini memberikan caching hasil build yang baik. `stamp = -1`: Penyematan informasi build dikontrol oleh flag `--[no]stamp`. Biner berstempel tidak dibuat ulang kecuali dependensinya berubah.
`win_def_file`	`Label; optional` File DEF Windows yang akan diteruskan ke penaut. Atribut ini hanya boleh digunakan jika Windows adalah platform target. Fungsi ini dapat digunakan untuk mengekspor simbol selama menautkan library bersama.

cc_import

cc_import(name, 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 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 a 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. Menautkan ke library statis atau bersama
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,
)

Argumen

Atribut
`name`	`Name; required` Nama unik untuk target ini.
`hdrs`	`List of labels; optional` Daftar file header yang dipublikasikan oleh library yang telah dikompilasi sebelumnya ini untuk langsung disertakan oleh sumber dalam aturan dependen.
`alwayslink`	`Boolean; optional; default is False` Jika 1, semua biner yang bergantung (langsung atau tidak langsung) pada library prakompilasi C++ ini akan menautkan 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 mendaftar untuk menerima callback yang disediakan oleh beberapa layanan. Jika alwayslink tidak berfungsi dengan VS 2017 di Windows, hal ini karena masalah umum, upgrade VS 2017 Anda ke versi terbaru.
`interface_library`	`Label; optional` Library antarmuka tunggal untuk menautkan library bersama. Jenis file yang diizinkan: `.ifso`, `.tbd`, `.lib`, `.so` atau `.dylib`
`shared_library`	`Label; optional` Satu library bersama yang dikompilasi sebelumnya. Bazel memastikannya tersedia untuk biner yang bergantung padanya selama runtime. Jenis file yang diizinkan: `.so`, `.dll` atau `.dylib`
`static_library`	`Label; optional` Satu library statis prakompilasi. Jenis file yang diizinkan: `.a`, `.pic.a` atau `.lib`
`system_provided`	`Boolean; optional; default is False` Jika 1, berarti library bersama yang diperlukan saat runtime disediakan oleh sistem. Dalam hal ini, `interface_library` harus ditentukan dan `shared_library` harus kosong.

cc_library

cc_library(name, deps, srcs, data, hdrs, 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 menyusun antarmuka publik library dan dapat disertakan secara langsung dari file dalam hdrs dan srcs library itu sendiri, serta dari file dalam hdrs dan srcs aturan cc_* yang mencantumkan library dalam deps-nya. 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 bertanya apakah Anda ingin konsumen library ini dapat menyertakannya secara langsung. 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 aturan tersebut juga tidak memiliki atribut hdrs. Semua header yang termasuk dalam biner atau pengujian secara langsung harus tercantum dalam srcs.

Untuk mengilustrasikan 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 langsung menyertakan foo.h dan bar.h, tetapi tidak baz.h.

Termasuk file	Penyertaan yang diizinkan
foo.h	bar.h
foo.cc	{i>foo.h bar.h<i}
bar.h	bar-impl.h baz.h
batang-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. Pada contoh di atas, foo.cc diizinkan untuk menyertakan bar.h, yang dapat menyertakan baz.h, yang kemudian diizinkan untuk menyertakan baz-impl.h. Secara teknis, kompilasi file .cc dapat secara transitif menyertakan file header apa pun dalam hdrs atau srcs dalam cc_library mana pun 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.

Sayangnya, Bazel saat ini tidak dapat membedakan antara penyertaan langsung dan transitif, sehingga tidak dapat mendeteksi kasus error ketika file secara ilegal menyertakan header secara langsung yang hanya diizinkan untuk disertakan secara transitif. Misalnya, Bazel tidak akan mengeluhkan jika dalam contoh di atas foo.cc secara langsung menyertakan baz.h. Hal ini akan ilegal, karena foo tidak bergantung secara langsung pada baz. Saat ini, tidak ada error yang dihasilkan dalam kasus tersebut, tetapi pemeriksaan error tersebut mungkin ditambahkan di masa mendatang.

Argumen

Atribut
`name`	`Name; required` Nama unik untuk target ini.
`deps`	`List of labels; optional` Daftar library lain yang akan ditautkan ke target biner. Ini dapat berupa target `cc_library` atau `objc_library`.
`srcs`	`List of labels; optional` Daftar file C dan C++ yang diproses untuk membuat target. File ini adalah file sumber dan header C/C++, baik yang tidak dihasilkan (kode sumber normal) maupun yang dihasilkan. Semua file `.cc`, `.c`, dan `.cpp` akan dikompilasi. File ini mungkin dihasilkan: jika file bernama ada 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. Baik file `.cc` maupun `.h` dapat langsung menyertakan header yang tercantum dalam `srcs` ini atau dalam `hdrs` dari aturan yang tercantum dalam argumen `deps`. Semua file `#include`d harus disebutkan dalam atribut `srcs` aturan ini, atau dalam atribut `hdrs` dari `cc_library()` yang direferensikan. Gaya yang direkomendasikan adalah untuk header yang terkait dengan library yang dicantumkan dalam atribut `hdrs` library tersebut, dan header apa pun lainnya yang terkait dengan sumber aturan ini dicantumkan di `srcs`. Lihat "Pemeriksaan penyertaan header" untuk deskripsi yang lebih mendetail. Jika nama aturan ada di `srcs`, aturan ini otomatis bergantung pada nama tersebut. Jika `outs` aturan yang dinamai adalah file sumber C atau C++, file tersebut akan dikompilasi ke dalam aturan ini; jika merupakan file library, kedua 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` Arsip: `.a`, `.pic.a` Library "Selalu tautkan": `.lo`, `.pic.lo` Library bersama, berversi atau tanpa versi: `.so`, `.so.version` File objek: `.o`, `.pic.o` ...dan aturan apa pun yang menghasilkan file tersebut. Ekstensi yang berbeda menunjukkan bahasa pemrograman yang berbeda sesuai dengan konvensi gcc.
`hdrs`	`List of labels; optional` Daftar file header yang dipublikasikan oleh library ini untuk disertakan langsung oleh sumber dalam aturan dependen. Ini adalah lokasi yang sangat direkomendasikan untuk mendeklarasikan file header yang mendeskripsikan antarmuka untuk library. Header ini akan tersedia untuk disertakan oleh sumber dalam aturan ini atau dalam aturan dependen. Header yang tidak dimaksudkan untuk disertakan oleh klien library ini harus dicantumkan dalam atribut `srcs`, meskipun header tersebut disertakan oleh header yang dipublikasikan. Lihat "Pemeriksaan penyertaan header" untuk deskripsi yang lebih mendetail.
`alwayslink`	`Boolean; optional; default is False` Jika 1, biner apa pun yang bergantung (langsung atau tidak langsung) pada library C++ ini akan menautkan semua file objek untuk file yang tercantum dalam `srcs`, meskipun beberapa file 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 mendaftar untuk menerima callback yang disediakan oleh beberapa layanan. Jika alwayslink tidak berfungsi dengan VS 2017 di Windows, hal ini karena masalah umum, upgrade VS 2017 Anda ke versi terbaru.
`copts`	`List of strings; optional` Tambahkan opsi ini ke perintah kompilasi C++. Tunduk pada penggantian "Buat variabel" dan tokenisasi Bourne shell. Setiap string dalam atribut ini ditambahkan dalam urutan tertentu ke `COPTS` sebelum mengompilasi target biner. Flag 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`	`List of strings; optional` Daftar definisi untuk ditambahkan ke baris kompilasi. Tunduk pada penggantian variabel"Buat" dan tokenisasi Bourne shell. Setiap string, yang harus terdiri dari satu token shell Bourne, diawali dengan `-D` dan ditambahkan ke command line kompilasi ke target ini, serta ke setiap aturan yang bergantung padanya. Hati-hati, karena hal ini mungkin berdampak luas. Jika ragu, tambahkan nilai tentukan ke `local_defines`.
`implementation_deps`	`List of labels; optional` Daftar library lain yang dijadikan dependensi oleh target library. Tidak seperti `deps`, header dan jalur penyertaan library ini (dan semua dependensi transitifnya) hanya digunakan untuk kompilasi library ini, dan bukan library yang bergantung padanya. Library yang ditentukan dengan `implementation_deps` tetap ditautkan di target biner yang bergantung pada library ini. Untuk saat ini, penggunaannya terbatas untuk cc_libraries dan dilindungi oleh flag `--experimental_cc_implementation_deps`.
`include_prefix`	`String; optional` Awalan yang akan ditambahkan ke jalur header aturan ini. Jika ditetapkan, header dalam atribut `hdrs` aturan ini dapat diakses adalah nilai atribut ini yang ditambahkan ke jalur relatif repositori. Awalan dalam atribut `strip_include_prefix` dihapus sebelum awalan ini ditambahkan.
`includes`	`List of strings; optional` Daftar direktori penyertaan yang akan ditambahkan ke baris kompilasi. Tunduk pada penggantian "Buat variabel". Setiap string diawali dengan `-isystem` dan ditambahkan ke `COPTS`. Tidak seperti COPTS, tanda ini ditambahkan untuk aturan ini dan setiap aturan yang bergantung padanya. (Catatan: bukan aturan yang menjadi dependensinya.) Hati-hati, karena hal ini mungkin memiliki dampak yang luas. Jika ragu, tambahkan flag "-I" ke COPTS. Header harus ditambahkan ke srcs atau hdrs. Jika tidak, header tidak akan tersedia untuk aturan dependen saat kompilasi di-sandbox (default).
`linkopts`	`List of strings; optional` Tambahkan flag ini ke perintah linker C++. Tunduk pada penggantian 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 `-` diasumsikan sebagai label target dalam `deps`. Daftar file yang dihasilkan oleh target tersebut akan ditambahkan ke opsi linker. Error dilaporkan jika label tidak valid, atau tidak dideklarasikan dalam `deps`.
`linkstamp`	`Label; optional` Secara bersamaan mengompilasi dan menautkan file sumber C++ yang ditentukan ke biner akhir. Trik ini diperlukan untuk memasukkan informasi stempel waktu ke dalam biner; jika kita mengompilasi file sumber ke file objek dengan cara biasa, stempel waktu akan 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; optional; default is 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 sisanya. Jika diaktifkan dan ini adalah biner atau pengujian, opsi ini akan memberi tahu alat build untuk menautkan dalam `.a`, bukan `.so` untuk library pengguna jika memungkinkan. Beberapa library sistem mungkin masih ditautkan secara dinamis, seperti library yang tidak memiliki library statis. Jadi, file yang dapat dieksekusi yang dihasilkan akan tetap ditautkan secara dinamis, sehingga sebagian besar hanya bersifat statis. Sebenarnya ada tiga cara berbeda untuk menautkan file yang dapat dieksekusi: STATIC dengan fitur full_static_link, dengan fitur ini 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, yaitu semua library pengguna ditautkan secara statis (jika versi statis tersedia), tetapi 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, ketika 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 dependen di area `*.runfiles`.
`local_defines`	`List of strings; optional` Daftar definisi untuk ditambahkan ke baris kompilasi. Tunduk pada penggantian variabel"Buat" dan tokenisasi Bourne shell. 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 turunannya.
`nocopts`	`String; optional` Menghapus opsi pencocokan dari perintah kompilasi C++. Tunduk pada penggantian variabel"Make". Nilai atribut ini diinterpretasikan sebagai ekspresi reguler. Setiap `COPTS` yang sudah ada dan cocok dengan ekspresi reguler ini (termasuk nilai yang secara eksplisit ditentukan dalam atribut copts aturan) akan dihapus dari `COPTS` untuk tujuan kompilasi aturan ini. Atribut ini jarang diperlukan.
`strip_include_prefix`	`String; optional` Awalan yang akan dihapus dari jalur header aturan ini. Jika ditetapkan, header dalam atribut `hdrs` aturan ini dapat diakses di jalurnya dengan awalan ini terpotong. Jika jalur relatif, maka akan diambil sebagai jalur relatif paket. Jika bersifat absolut, hal tersebut dipahami sebagai jalur yang relatif terhadap repositori. Awalan dalam atribut `include_prefix` ditambahkan setelah awalan ini dihilangkan.
`textual_hdrs`	`List of labels; optional` Daftar file header yang dipublikasikan oleh library ini secara tekstual akan disertakan oleh sumber dalam aturan dependen. Ini adalah lokasi untuk mendeklarasikan file header yang tidak dapat dikompilasi sendiri; artinya, file tersebut selalu harus disertakan secara tekstual oleh file sumber lain untuk mem-build kode yang valid.
`win_def_file`	`Label; optional` File DEF Windows yang akan diteruskan ke penaut. Atribut ini hanya boleh digunakan jika Windows adalah platform target. Fungsi ini dapat digunakan untuk mengekspor simbol selama menautkan library bersama.

cc_proto_library

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

Name; required

Nama unik untuk target ini.

deps

List of labels; optional

Daftar aturan proto_library untuk menghasilkan kode C++.

fdo_prefetch_hints

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

Mewakili 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

Name; required

Nama unik untuk target ini.

profile

Label; optional

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

fdo_profile

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 ditetapkan. 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`	`Name; required` Nama unik untuk target ini.
`absolute_path_profile`	`String; optional` Jalur absolut ke profil FDO. File FDO dapat memiliki salah satu ekstensi berikut: .profraw untuk profil LLVM yang tidak diindeks, .profdata untuk profil LLVM yang diindeks, .zip yang menyimpan profil profraw LLVM, atau .afdo untuk profil AutoFDO.
`profile`	`Label; optional` Label profil FDO atau aturan yang menghasilkannya. 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, .xfdo untuk profil XBinary. Label juga dapat mengarah ke aturan fdo_absolute_path_profile.
`proto_profile`	`Label; optional` Label profil protobuf.

propeller_optimize

propeller_optimize(name, compatible_with, deprecation, distribs, features, ld_profile, licenses, restricted_to, tags, target_compatible_with, testonly, visibility)

Menampilkan profil pengoptimalan Baling-baling 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

Name; required

Nama unik untuk target ini.

ld_profile

Label; optional

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

cc_test

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, 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`	`Name; required` Nama unik untuk target ini.
`deps`	`List of labels; optional` Daftar library lain yang akan ditautkan ke target biner. Ini dapat berupa target `cc_library` atau `objc_library`.
`srcs`	`List of labels; optional` Daftar file C dan C++ yang diproses untuk membuat target. File ini adalah file sumber dan header C/C++, baik yang tidak dihasilkan (kode sumber normal) maupun yang dihasilkan. Semua file `.cc`, `.c`, dan `.cpp` akan dikompilasi. File ini mungkin dihasilkan: jika file bernama ada 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. Baik file `.cc` maupun `.h` dapat langsung menyertakan header yang tercantum dalam `srcs` ini atau dalam `hdrs` dari aturan yang tercantum dalam argumen `deps`. Semua file `#include`d harus disebutkan dalam atribut `srcs` aturan ini, atau dalam atribut `hdrs` dari `cc_library()` yang direferensikan. Gaya yang direkomendasikan adalah untuk header yang terkait dengan library yang dicantumkan dalam atribut `hdrs` library tersebut, dan header apa pun lainnya yang terkait dengan sumber aturan ini dicantumkan di `srcs`. Lihat "Pemeriksaan penyertaan header" untuk deskripsi yang lebih mendetail. Jika nama aturan ada di `srcs`, aturan ini otomatis bergantung pada nama tersebut. Jika `outs` aturan yang dinamai adalah file sumber C atau C++, file tersebut akan dikompilasi ke dalam aturan ini; jika merupakan file library, kedua 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` Arsip: `.a`, `.pic.a` Library "Selalu tautkan": `.lo`, `.pic.lo` Library bersama, berversi atau tanpa versi: `.so`, `.so.version` File objek: `.o`, `.pic.o` ...dan aturan apa pun yang menghasilkan file tersebut. Ekstensi yang berbeda menunjukkan bahasa pemrograman yang berbeda sesuai dengan konvensi gcc.
`additional_linker_inputs`	`List of labels; optional` Teruskan file ini ke perintah penaut C++. Misalnya, file .res Windows yang dikompilasi dapat diberikan di sini untuk disematkan dalam target biner.
`copts`	`List of strings; optional` Tambahkan opsi ini ke perintah kompilasi C++. Tunduk pada penggantian "Buat variabel" dan tokenisasi Bourne shell. Setiap string dalam atribut ini ditambahkan dalam urutan tertentu ke `COPTS` sebelum mengompilasi target biner. Flag 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`	`List of strings; optional` Daftar definisi untuk ditambahkan ke baris kompilasi. Tunduk pada penggantian variabel"Buat" dan tokenisasi Bourne shell. Setiap string, yang harus terdiri dari satu token shell Bourne, diawali dengan `-D` dan ditambahkan ke command line kompilasi ke target ini, serta ke setiap aturan yang bergantung padanya. Hati-hati, karena hal ini mungkin berdampak luas. Jika ragu, tambahkan nilai tentukan ke `local_defines`.
`includes`	`List of strings; optional` Daftar direktori penyertaan yang akan ditambahkan ke baris kompilasi. Tunduk pada penggantian "Buat variabel". Setiap string diawali dengan `-isystem` dan ditambahkan ke `COPTS`. Tidak seperti COPTS, tanda ini ditambahkan untuk aturan ini dan setiap aturan yang bergantung padanya. (Catatan: bukan aturan yang menjadi dependensinya.) Hati-hati, karena hal ini mungkin memiliki dampak yang luas. Jika ragu, tambahkan flag "-I" ke COPTS. Header harus ditambahkan ke srcs atau hdrs. Jika tidak, header tidak akan tersedia untuk aturan dependen saat kompilasi di-sandbox (default).
`linkopts`	`List of strings; optional` Tambahkan flag ini ke perintah linker C++. Tunduk pada penggantian 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 `-` diasumsikan sebagai label target dalam `deps`. Daftar file yang dihasilkan oleh target tersebut akan ditambahkan ke opsi linker. Error dilaporkan jika label tidak valid, atau tidak dideklarasikan dalam `deps`.
`linkstatic`	`Boolean; optional; default is 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 sisanya. Jika diaktifkan dan ini adalah biner atau pengujian, opsi ini akan memberi tahu alat build untuk menautkan dalam `.a`, bukan `.so` untuk library pengguna jika memungkinkan. Beberapa library sistem mungkin masih ditautkan secara dinamis, seperti library yang tidak memiliki library statis. Jadi, file yang dapat dieksekusi yang dihasilkan akan tetap ditautkan secara dinamis, sehingga sebagian besar hanya bersifat statis. Sebenarnya ada tiga cara berbeda untuk menautkan file yang dapat dieksekusi: STATIC dengan fitur full_static_link, dengan fitur ini 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, yaitu semua library pengguna ditautkan secara statis (jika versi statis tersedia), tetapi 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, ketika 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 dependen di area `*.runfiles`.
`local_defines`	`List of strings; optional` Daftar definisi untuk ditambahkan ke baris kompilasi. Tunduk pada penggantian variabel"Buat" dan tokenisasi Bourne shell. 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 turunannya.
`malloc`	`Label; optional; default is @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 libc malloc. Label ini harus merujuk ke `cc_library`. Jika kompilasi ditujukan untuk aturan non-C++, opsi ini tidak akan berpengaruh. Nilai atribut ini diabaikan jika `linkshared=True` ditentukan.
`nocopts`	`String; optional` Menghapus opsi pencocokan dari perintah kompilasi C++. Tunduk pada penggantian variabel"Make". Nilai atribut ini diinterpretasikan sebagai ekspresi reguler. Setiap `COPTS` yang sudah ada dan cocok dengan ekspresi reguler ini (termasuk nilai yang secara eksplisit ditentukan dalam atribut copts aturan) akan dihapus dari `COPTS` untuk tujuan kompilasi aturan ini. Atribut ini jarang diperlukan.
`stamp`	`Integer; optional; default is 0` Apakah akan mengenkode informasi build ke dalam biner. Nilai yang mungkin: `stamp = 1`: Selalu beri stempel pada 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. Hal ini memberikan caching hasil build yang baik. `stamp = -1`: Penyematan informasi build dikontrol oleh flag `--[no]stamp`. Biner berstempel tidak dibuat ulang kecuali dependensinya berubah.
`win_def_file`	`Label; optional` File DEF Windows yang akan diteruskan ke penaut. Atribut ini hanya boleh digunakan jika Windows adalah platform target. Fungsi ini dapat digunakan untuk mengekspor simbol selama menautkan library bersama.

cc_toolchain

cc_toolchain(name, all_files, ar_files, as_files, compatible_with, compiler, compiler_files, compiler_files_without_includes, coverage_files, cpu, 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 berfungsi untuk:

Mengumpulkan semua artefak yang diperlukan untuk menjalankan tindakan C++. Hal ini dilakukan oleh atribut seperti all_files, compiler_files, linker_files, atau atribut lain yang diakhiri dengan _files). Umumnya, ini adalah grup file yang membolak-balik semua file yang diperlukan.
Menghasilkan 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 mengetahui konfigurasi toolchain C++ dan dokumentasi pemilihan toolchain yang rumit.

Gunakan tags = ["manual"] untuk mencegah toolchain dibuat dan dikonfigurasi jika tidak perlu saat memanggil bazel build //...

Argumen

Atribut
`name`	`Name; required` Nama unik untuk target ini.
`all_files`	`Label; required` 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 tepat dari atribut di bawah). Bazel mengasumsikan bahwa `all_files` adalah superset dari semua atribut lain yang menyediakan artefak (misalnya, kompilasi linkstamp memerlukan file kompilasi dan link, sehingga akan menggunakan `all_files`). Ini adalah isi `cc_toolchain.files`, dan digunakan oleh semua aturan Starlark yang menggunakan toolchain C++.
`ar_files`	`Label; optional` Pengumpulan semua artefak cc_toolchain yang diperlukan untuk tindakan pengarsipan.
`as_files`	`Label; optional` Pengumpulan semua artefak cc_toolchain yang diperlukan untuk tindakan perakitan.
`compiler`	`String; optional; nonconfigurable` Tidak digunakan lagi. Sebagai gantinya, gunakan atribut `toolchain_identifier`. Peristiwa akan menjadi noop setelah migrasi CROSSTOOL ke Starlark , dan akan dihapus oleh #7075. Jika ditetapkan, parameter ini akan digunakan untuk melakukan pemilihan crosstool_config.toolchain. Opsi ini akan lebih diutamakan daripada opsi --cpu Bazel.
`compiler_files`	`Label; required` Koleksi semua artefak cc_toolchain yang diperlukan untuk tindakan kompilasi.
`compiler_files_without_includes`	`Label; optional` Pengumpulan semua artefak cc_toolchain yang diperlukan untuk tindakan kompilasi jika penemuan input didukung (saat ini khusus Google).
`coverage_files`	`Label; optional` Pengumpulan semua artefak cc_toolchain yang diperlukan untuk tindakan cakupan. Jika tidak ditentukan, all_files akan digunakan.
`cpu`	`String; optional; nonconfigurable` Tidak digunakan lagi. Sebagai gantinya, gunakan atribut toolchain_identifier. Layanan akan menjadi noop setelah migrasi CROSSTOOL ke Starlark , dan akan dihapus paling lambat #7075. Jika ditetapkan, parameter ini akan digunakan untuk melakukan pemilihan crosstool_config.toolchain. Opsi ini akan lebih diutamakan daripada opsi --cpu Bazel.
`dwp_files`	`Label; required` Pengumpulan semua artefak cc_toolchain yang diperlukan untuk tindakan dwp.
`dynamic_runtime_lib`	`Label; optional` Artefak library dinamis untuk library runtime C++ (misalnya Geocoding++.so). Ini akan digunakan saat fitur 'static_link_cpp_runtimes' diaktifkan, dan kita menautkan dependensi secara dinamis.
`exec_transition_for_inputs`	`Boolean; optional; default is True` Setel ke True untuk mem-build semua input file ke cc_toolchain untuk platform eksekutif, bukan tidak memiliki transisi (yaitu platform target secara default).
`libc_top`	`Label; optional` Kumpulan artefak untuk libc yang diteruskan sebagai input untuk mengompilasi/menautkan tindakan.
`linker_files`	`Label; required` Pengumpulan semua artefak cc_toolchain yang diperlukan untuk tindakan penautan.
`module_map`	`Label; optional` Artefak peta modul yang akan digunakan untuk build modular.
`objcopy_files`	`Label; required` Pengumpulan semua artefak cc_toolchain yang diperlukan untuk tindakan objcopy.
`static_runtime_lib`	`Label; optional` Artefak library statis untuk library runtime C++ (misalnya Geocoding++.a). Ini akan digunakan saat fitur 'static_link_cpp_runtimes' diaktifkan, dan kita menautkan dependensi secara statis.
`strip_files`	`Label; required` Pengumpulan semua artefak cc_toolchain yang diperlukan untuk tindakan strip.
`supports_header_parsing`	`Boolean; optional; default is False` Setel ke Benar jika cc_toolchain mendukung tindakan penguraian header.
`supports_param_files`	`Boolean; optional; default is True` Setel ke True jika cc_ toolchain mendukung penggunaan file param untuk menautkan tindakan.
`toolchain_config`	`Label; required` Label aturan yang menyediakan `cc_toolchain_config_info`.
`toolchain_identifier`	`String; optional; nonconfigurable` 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

cc_toolchain_suite(name, compatible_with, deprecation, distribs, features, licenses, restricted_to, tags, target_compatible_with, testonly, toolchains, visibility)

Mewakili koleksi toolchain C++.

Aturan ini berfungsi untuk:

Mengumpulkan semua toolchain C++ yang relevan.
Memilih satu toolchain bergantung pada opsi --cpu dan --compiler akan diteruskan ke Bazel.

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

Argumen

Atribut

name

Name; required

Nama unik untuk target ini.

toolchains

Dictionary mapping strings to labels; required; nonconfigurable

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