C++ y Bazel

Informar un problema Ver fuente

En esta página, se incluyen recursos que te ayudarán a usar Bazel con proyectos de C++. Se vincula a un instructivo, reglas de compilación y otra información específica para compilar proyectos de C++ con Bazel.

Trabaja con Bazel

Los siguientes recursos te ayudarán a trabajar con Bazel en proyectos de C++:

Prácticas recomendadas

Además de las prácticas recomendadas generales de Bazel, a continuación se incluyen las prácticas recomendadas específicas para proyectos de C++.

Archivos BUILD

Sigue los lineamientos que se indican a continuación cuando crees tus archivos BUILD:

  • Cada archivo BUILD debe contener un objetivo de la regla cc_library por unidad de compilación en el directorio.

  • Debes granular tus bibliotecas de C++ tanto como sea posible para maximizar la incrementalidad y paralelizar la compilación.

  • Si hay un solo archivo de origen en srcs, asigna a la biblioteca el mismo nombre que el de ese archivo C++. Esta biblioteca debe contener archivos C++, cualquier archivo de encabezado que coincida y las dependencias directas de la biblioteca. Por ejemplo:

    cc_library(
    name = "mylib",
    srcs = ["mylib.cc"],
    hdrs = ["mylib.h"],
    deps = [":lower-level-lib"]
)

  • Usa un objetivo de regla cc_test por cada objetivo de cc_library en el archivo. Asigna un nombre al [library-name]_test de destino y al archivo de origen [library-name]_test.cc. Por ejemplo, un objetivo de prueba para el objetivo de la biblioteca mylib que se mostró anteriormente se vería de la siguiente manera:

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

Incluir rutas

Sigue estos lineamientos para incluir rutas:

  • Haz que todas las rutas de inclusión estén relacionadas con el directorio del lugar de trabajo.

  • Usa inclusiones entre comillas (#include "foo/bar/baz.h") para encabezados que no sean del sistema, no corchetes angulares (#include <foo/bar/baz.h>).

  • Evita usar combinaciones de teclas del directorio de UNIX, como . (directorio actual) o .. (directorio superior).

  • En el caso del código heredado o third_party que requiere incluir puntos fuera del repositorio del proyecto, como cuando el repositorio externo requiere un prefijo, usa los argumentos include_prefix y strip_include_prefix en el destino de la regla cc_library.

Funciones de la cadena de herramientas

Las siguientes funciones opcionales pueden mejorar el estado de un proyecto de C++. Se pueden habilitar con la marca de línea de comandos --features o el atributo features de las reglas repo, package o cc_*:

  • La función parse_headers permite que el compilador de C++ se use para analizar (pero no para compilar) todos los archivos de encabezado en los destinos compilados y sus dependencias cuando se usa la marca --process_headers_in_dependencies. Esto puede ayudar a detectar problemas en las bibliotecas de solo encabezado y garantizar que los encabezados sean independientes y independientes del orden en el que se incluyen.
  • La función layering_check exige que los objetivos solo incluyan encabezados proporcionados por sus dependencias directas. La cadena de herramientas predeterminada admite esta función en Linux con clang como compilador.