Halaman ini berisi referensi yang akan membantu Anda menggunakan Bazel dengan project C++. Link ini menyediakan link ke tutorial, aturan build, dan informasi lain yang khusus untuk membangun project C++ dengan Bazel.
Bekerja dengan Bazel
Referensi berikut akan membantu Anda bekerja dengan Bazel pada project C++:
- Tutorial: Membuat project C++
- Kasus penggunaan umum C++
- Aturan C/C++
- Library Penting
- Konfigurasi toolchain C++
- Tutorial: Mengonfigurasi toolchain C++
- Mengintegrasikan dengan aturan C++
Praktik terbaik
Selain praktik terbaik umum Bazel, di bawah ini adalah praktik terbaik khusus untuk project C++.
BUILD file
Ikuti panduan di bawah ini saat membuat file BUILD:
Setiap file
BUILD
harus berisi satu target aturancc_library
per unit kompilasi di direktori.Anda harus membuat terperinci library C++ sebanyak mungkin untuk memaksimalkan inkrementalitas dan memparalelkan build.
Jika ada satu file sumber dalam
srcs
, beri nama library ini dengan nama file C++ tersebut. Library ini harus berisi file C++, file header yang cocok, dan dependensi langsung library. Contoh:cc_library( name = "mylib", srcs = ["mylib.cc"], hdrs = ["mylib.h"], deps = [":lower-level-lib"] )
Gunakan satu target aturan
cc_test
per targetcc_library
dalam file. Beri nama[library-name]_test
target dan file sumber[library-name]_test.cc
. Misalnya, target pengujian untuk target librarymylib
yang ditunjukkan di atas akan terlihat seperti ini:cc_test( name = "mylib_test", srcs = ["mylib_test.cc"], deps = [":mylib"] )
Sertakan jalur
Ikuti panduan berikut untuk jalur penyertaan:
Buat semua jalur penyertaan relatif terhadap direktori ruang kerja.
Penggunaan tanda kutip mencakup (
#include "foo/bar/baz.h"
) untuk header non-sistem, bukan tanda kurung sudut (#include <foo/bar/baz.h>
).Hindari penggunaan pintasan direktori UNIX, seperti
.
(direktori saat ini) atau..
(direktori induk).Untuk kode lama atau
third_party
yang mengharuskan penyertaan kursor ke luar repositori project, seperti repositori eksternal yang menyertakan awalan, gunakan argumeninclude_prefix
danstrip_include_prefix
pada target aturancc_library
.
Fitur toolchain
Fitur opsional berikut
dapat meningkatkan kebersihan project C++. Peran tersebut dapat diaktifkan menggunakan
tanda command line --features
atau atribut features
dari
aturan repo
,
package
atau cc_*
:
- Fitur
parse_headers
membuat compiler C++ digunakan untuk mengurai (tetapi tidak mengompilasi) semua file header dalam target yang di-build dan dependensinya saat menggunakan tanda--process_headers_in_dependencies
. Hal ini dapat membantu menemukan masalah di library khusus header dan memastikan bahwa header bersifat mandiri dan tidak bergantung pada urutan penyertaannya. - Fitur
layering_check
memberlakukan bahwa target hanya menyertakan header yang disediakan oleh dependensi langsungnya. Toolchain default mendukung fitur ini di Linux denganclang
sebagai compiler.