Esta página contém recursos que ajudam você a usar o Bazel com projetos em C++. Ele vincula a um tutorial, regras de build e outras informações específicas para criar C++ projetos com o Bazel.
Como trabalhar com o Bazel
Os seguintes recursos ajudam a trabalhar com o Bazel em projetos C++:
- Tutorial: como criar um projeto C++
- Casos de uso comuns do C++
- Regras de C/C++
- Configuração do conjunto de ferramentas C++
- Tutorial: como configurar conjuntos de ferramentas C++
- Como fazer a integração com regras C++
Práticas recomendadas
Além das práticas recomendadas gerais do Bazel, abaixo estão práticas recomendadas específicas para projetos C++.
Arquivos BUILD
Siga as diretrizes abaixo ao criar seus arquivos BUILD:
Cada arquivo
BUILD
precisa conter umcc_library
. destino de regra por unidade de compilação no diretório.Você precisa granular as bibliotecas C++ o máximo maximizar a incrementabilidade e carregar o build em paralelo.
Se houver um único arquivo de origem em
srcs
, nomeie a biblioteca com o mesmo nome de o nome desse arquivo C++. Essa biblioteca deve conter arquivo(s) C++, qualquer correspondência arquivos de cabeçalho e as dependências diretas da biblioteca. Exemplo:cc_library( name = "mylib", srcs = ["mylib.cc"], hdrs = ["mylib.h"], deps = [":lower-level-lib"] )
Use uma meta de regra
cc_test
para cada destino decc_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 bibliotecamylib
mostrado acima fica 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, e não sinais de maior e menor (#include <foo/bar/baz.h>
).Evite usar atalhos de diretório UNIX, como
.
(diretório atual) ou..
. (diretório pai).Para código legado ou
third_party
que exige apontar para fora do repositório de projeto, como repositório externo, inclui a exigência de um prefixo, use oinclude_prefix
estrip_include_prefix
argumentos no destino da regracc_library
.