C++ e Bazel

Nightly · 8.4 · 8.3 · 8.2 · 8.1 · 8.0 · 7.6

Esta página contém recursos que ajudam você a usar o Bazel com projetos em C++. Ele tem um link para um tutorial, regras de build e outras informações específicas sobre a criação de projetos em C++ com o Bazel.

Como trabalhar com o Bazel

Os recursos a seguir ajudam você a trabalhar com o Bazel em projetos C++:

Práticas recomendadas

Além das práticas recomendadas gerais do Bazel, confira abaixo as práticas recomendadas específicas para projetos em C++.

Arquivos BUILD

Siga as diretrizes abaixo ao criar seus arquivos BUILD:

  • Cada arquivo BUILD precisa conter uma cc_library de regra por unidade de compilação no diretório.

  • Granularize suas bibliotecas C++ o máximo possível para maximizar a incrementalidade e paralelizar o build.

  • Se houver um único arquivo de origem em srcs, nomeie a biblioteca da mesma forma que o nome do arquivo C++. Essa biblioteca precisa conter arquivos C++, arquivos de cabeçalho correspondentes e as dependências diretas da biblioteca. Exemplo:

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

  • Use um destino de regra cc_test por destino cc_library no arquivo. Nomeie o destino [library-name]_test e o arquivo de origem [library-name]_test.cc. Por exemplo, um destino de teste para o destino da biblioteca mylib mostrado acima seria assim:

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

Incluir caminhos

Siga estas diretrizes para caminhos de inclusão:

  • Faça com que todos os caminhos de inclusão sejam relativos ao diretório do espaço de trabalho.

  • Use inclusões entre aspas (#include "foo/bar/baz.h") para cabeçalhos que não são do sistema, não colchetes angulares (#include <foo/bar/baz.h>).

  • Evite usar atalhos de diretório do UNIX, como . (diretório atual) ou .. (diretório pai).

  • Para código legado ou third_party que exige inclusões apontando para fora do repositório do projeto, como inclusões de repositório externo que exigem um prefixo, use os argumentos include_prefix e strip_include_prefix no destino da regra cc_library.