Yaygın C++ Derleme Kullanım Alanları

Sorun bildir Kaynağı görüntüleyin Nightly · 7.4 . 7.3 · 7.2 · 7.1 · 7.0 · 6.5

Bazel ile C++ projeleri oluşturmanın en yaygın kullanım alanlarından bazılarını burada bulabilirsiniz. Henüz yapmadıysanız Bazel'e Giriş: C++ Projesi Oluşturma eğitimini tamamlayarak Bazel ile C++ projeleri oluşturmaya başlayın.

cc_library ve hdrs üstbilgi dosyaları hakkında bilgi edinmek için cc_library başlıklı makaleyi inceleyin.

Bir hedefe birden fazla dosya ekleme

glob ile tek bir hedefe birden fazla dosya ekleyebilirsiniz. Örneğin:

cc_library(
    name = "build-all-the-files",
    srcs = glob(["*.cc"]),
    hdrs = glob(["*.h"]),
)

Bazel, bu hedefi içeren BUILD dosyasıyla aynı dizinde bulduğu tüm .cc ve .h dosyalarını (alt dizinler hariç) bu hedefle derleyecektir.

Geçişli dahil etme işlemlerini kullanma

Bir dosya üstbilgi içeriyorsa kaynak olarak bu dosyayı içeren tüm kurallar (yani srcs, hdrs veya textual_hdrs özelliğinde bu dosyanın bulunduğu kurallar), dahil edilen üstbilginin kitaplık kuralına bağlı olmalıdır. Öte yandan, sadece doğrudan bağımlılıklar bağımlılık olarak belirtilmelidir. Örneğin, sandwich.h'ün bread.h'ü ve bread.h'ün flour.h'yi içerdiğini varsayalım. sandwich.h flour.h (kim sandviçinde un istiyor?) içermez. Bu nedenle BUILD dosyası şu şekilde görünür:

cc_library(
    name = "sandwich",
    srcs = ["sandwich.cc"],
    hdrs = ["sandwich.h"],
    deps = [":bread"],
)

cc_library(
    name = "bread",
    srcs = ["bread.cc"],
    hdrs = ["bread.h"],
    deps = [":flour"],
)

cc_library(
    name = "flour",
    srcs = ["flour.cc"],
    hdrs = ["flour.h"],
)

Burada sandwich kitaplığı, flour kitaplığına bağlı olan bread kitaplığına bağlıdır.

Dahil etme yolları

Bazen çalışma alanı kökünde kök dahil etme yollarını kullanamazsınız (veya kullanmak istemezsiniz). Mevcut kitaplıklarda, Workspace'teki yoluyla eşleşmeyen bir dahil dizini olabilir. Örneğin, aşağıdaki dizin yapısını kullandığınızı varsayalım:

└── my-project
    ├── legacy
    │   └── some_lib
    │       ├── BUILD
    │       ├── include
    │       │   └── some_lib.h
    │       └── some_lib.cc
    └── MODULE.bazel

Bazel, some_lib.h öğesinin legacy/some_lib/include/some_lib.h olarak dahil edilmesini bekleyecek ancak some_lib.cc öğesinin "some_lib.h" içerdiğini varsayalım. Bu dahil etme yolunun geçerli olabilmesi için legacy/some_lib/BUILD'ün, some_lib/include dizininin bir dahil etme dizini olduğunu belirtmesi gerekir:

cc_library(
    name = "some_lib",
    srcs = ["some_lib.cc"],
    hdrs = ["include/some_lib.h"],
    copts = ["-Ilegacy/some_lib/include"],
)

Bu, özellikle harici bağımlılıklarda kullanışlıdır. Aksi takdirde, başlık dosyaları / ön ekiyle eklenmelidir.

Harici kitaplıklar ekleme

Google Test{: .external} kullanıyorsanız Google Test'i indirip deponuzda kullanılabilir hale getirmek için MODULE.bazel dosyasına bağımlılık ekleyebilirsiniz:

bazel_dep(name = "googletest", version = "1.15.2")

C++ testleri yazma ve çalıştırma

Örneğin, şu gibi bir test ./test/hello-test.cc oluşturabilirsiniz:

#include "gtest/gtest.h"
#include "main/hello-greet.h"

TEST(HelloTest, GetGreet) {
  EXPECT_EQ(get_greet("Bazel"), "Hello Bazel");
}

Ardından testleriniz için ./test/BUILD dosyası oluşturun:

cc_test(
    name = "hello-test",
    srcs = ["hello-test.cc"],
    copts = [
      "-Iexternal/gtest/googletest/include",
      "-Iexternal/gtest/googletest",
    ],
    deps = [
        "@googletest//:main",
        "//main:hello-greet",
    ],
)

hello-greet öğesinin hello-test tarafından görülebilmesini sağlamak için ./main/BUILD öğesindeki visibility özelliğine "//test:__pkg__", eklemeniz gerekir.

Artık testi çalıştırmak için bazel test kullanabilirsiniz.

bazel test test:hello-test

Bu işlem şu çıkışı üretir:

INFO: Found 1 test target...
Target //test:hello-test up-to-date:
  bazel-bin/test/hello-test
INFO: Elapsed time: 4.497s, Critical Path: 2.53s
//test:hello-test PASSED in 0.3s

Executed 1 out of 1 tests: 1 test passes.

Önceden derlenmiş kitaplıklara bağımlılıklar ekleme

Yalnızca derlenmiş bir sürümüne sahip olduğunuz bir kitaplığı (ör. üstbilgiler ve bir .so dosyası) kullanmak istiyorsanız bu kitaplığı bir cc_library kuralına sarın:

cc_library(
    name = "mylib",
    srcs = ["mylib.so"],
    hdrs = ["mylib.h"],
)

Bu sayede, çalışma alanınızdaki diğer C++ hedefleri bu kurala bağlı olabilir.