C++ dan Bazel

Halaman ini berisi referensi yang membantu Anda menggunakan Bazel dengan project C++. Halaman ini juga berisi link ke tutorial, aturan build, dan informasi lain yang khusus untuk membangun project C++ dengan Bazel.

Menggunakan Bazel

Referensi berikut akan membantu Anda menggunakan Bazel di project C++:

• Tutorial: Membangun project C++
• Kasus penggunaan umum C++
• Aturan C/C++
• Library Penting
  • Abseil
  • Boost
  • Permintaan HTTPS: CPR dan libcurl
• Konfigurasi toolchain C++
• Tutorial: Mengonfigurasi toolchain C++
• Mengintegrasikan dengan aturan C++

Praktik terbaik

Selain praktik terbaik Bazel umum, berikut adalah praktik terbaik khusus untuk project C++.

File BUILD

Ikuti panduan di bawah saat membuat file BUILD:

• Setiap BUILD file harus berisi satu cc_library target aturan per unit kompilasi dalam direktori.

• Anda harus membuat library C++ Anda lebih terperinci sebanyak mungkin untuk memaksimalkan inkrementalitas dan memparalelkan build.

• Jika ada satu file sumber di srcs, beri nama library yang sama 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 target cc_library dalam file. Beri nama target [library-name]_test dan file sumber [library-name]_test.cc. Misalnya, target pengujian untuk target library mylib yang ditampilkan di atas akan terlihat seperti ini:

  cc_test(
      name = "mylib_test",
      srcs = ["mylib_test.cc"],
      deps = [":mylib"]
  )
  

Sertakan jalur

Ikuti panduan berikut untuk jalur sertakan:

• Buat semua jalur sertakan relatif terhadap direktori ruang kerja.

• Gunakan sertakan yang dikutip (#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 memerlukan sertakan yang mengarah ke luar repositori project, seperti sertakan repositori eksternal yang memerlukan awalan, gunakan argumen include_prefix dan strip_include_prefix pada target aturan cc_library.

Fitur toolchain

Fitur opsional berikut dapat meningkatkan kebersihan project C++. Fitur ini dapat diaktifkan menggunakan tanda command line --features atau atribut features dari aturan repo, package atau cc_* rules:

• Fitur parse_headers membuat compiler C++ digunakan untuk mengurai (tetapi tidak mengompilasi) semua file header dalam target yang dibuat dan dependensinya saat menggunakan --process_headers_in_dependencies tanda. Hal ini dapat membantu menangkap masalah di library khusus header dan memastikan bahwa header bersifat mandiri dan independen dari urutan penyertaan.
• Fitur layering_check memastikan bahwa target hanya menyertakan header yang disediakan oleh dependensi langsungnya. Toolchain default mendukung fitur ini di Linux dengan clang sebagai compiler.