C++ e Bazel

Informar um problema Acessar a origem

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

Como trabalhar com o Bazel

Os recursos abaixo ajudarão você a trabalhar com o Bazel em projetos em C++:

• Tutorial: como criar um projeto em C++
• Casos de uso comuns do C++
• Regras de C/C++
• Bibliotecas essenciais
  • Abseil (em inglês)
  • Boost
  • Solicitações HTTPS: CPR e libcurl
• Configuração do conjunto de ferramentas C++
• Tutorial: como configurar conjuntos de ferramentas C++
• Como integrar com regras C++

Práticas recomendadas

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

Arquivos BUILD

Siga as diretrizes abaixo ao criar seus arquivos BUILD:

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

• Você precisa detalhar as bibliotecas C++ o máximo possível para maximizar a incrementabilidade e carregar o build em paralelo.

• Se houver um único arquivo de origem em srcs, nomeie a biblioteca como o nome desse arquivo C++. Essa biblioteca precisa conter arquivos C++, todos os 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 [library-name]_test de destino e o arquivo de origem [library-name]_test.cc. Por exemplo, um destino de teste para o destino da biblioteca mylib mostrado acima ficaria assim:

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

Incluir caminhos

Siga estas diretrizes para caminhos de inclusão:

• Torne todos os caminhos de inclusão 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 sejam do sistema, e 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 exija o direcionamento para fora do repositório do projeto, como repositórios externos que exigem um prefixo, use os argumentos include_prefix e strip_include_prefix no destino da regra cc_library.