C / C++ Kuralları

Nightly · 8.4 · 8.3 · 8.2 · 8.1 · 8.0 · 7.7

Kurallar

cc_binary

Kural kaynağını görüntüleme 
cc_binary(name, deps, srcs, data, additional_linker_inputs, args, compatible_with, copts, defines, deprecation, distribs, env, exec_compatible_with, exec_properties, features, includes, licenses, link_extra_lib, linkopts, linkshared, linkstatic, local_defines, malloc, nocopts, output_licenses, restricted_to, stamp, tags, target_compatible_with, testonly, toolchains, visibility, win_def_file)

Örtülü çıkış hedefleri

  • name.stripped (yalnızca açıkça istendiğinde oluşturulur): İkili programın çıkarılmış bir sürümü. Hata ayıklama sembollerini kaldırmak için ikili programda strip -g çalıştırılır. --stripopt=-foo kullanılarak komut satırında ek şerit seçenekleri sağlanabilir. Bu çıkış yalnızca açıkça istendiğinde oluşturulur.
  • name.dwp (yalnızca açıkça istenirse oluşturulur): Fission etkinse: Uzaktan dağıtılan ikili dosyaların hata ayıklaması için uygun bir hata ayıklama bilgileri paketi dosyası. Aksi takdirde: boş bir dosya.

Bağımsız değişkenler

Özellikler
name

Ad; zorunlu

Bu hedef için benzersiz bir ad.
deps

Etiket listesi; varsayılan değer []'dir.

İkili hedefte bağlanacak diğer kitaplıkların listesi.

Bunlar cc_library veya objc_library hedef olabilir.
srcs

Etiket listesi; varsayılan değer []'dir.

Hedefi oluşturmak için işlenen C ve C++ dosyalarının listesi. Bunlar, oluşturulmamış (normal kaynak kodu) veya oluşturulmuş C/C++ kaynak ve başlık dosyalarıdır.

Tüm .cc, .c ve .cpp dosyaları derlenir. Bunlar oluşturulmuş dosyalar olabilir: Adlandırılmış bir dosya başka bir kuralın outs bölümündeyse bu kural otomatik olarak söz konusu diğer kurala bağlı olur.

.h dosyası derlenmez ancak bu kuraldaki kaynaklar tarafından dahil edilebilir. Hem .cc hem de .h dosyaları, bu srcs veya deps bağımsız değişkeninde listelenen herhangi bir kuralın hdrs bölümünde listelenen üstbilgileri doğrudan içerebilir.

Tüm #include dosyaları, bu kuralın srcs özelliğinde veya referans verilen cc_library()'lerin hdrs özelliğinde belirtilmelidir. Önerilen stil, bir kitaplıkla ilişkili başlıkların o kitaplığın hdrs özelliğinde, bu kuralın kaynaklarıyla ilişkili kalan başlıkların ise srcs özelliğinde listelenmesidir. Daha ayrıntılı açıklama için "Başlık dahil etme kontrolü" bölümüne bakın.

Bir kuralın adı srcs içinde yer alıyorsa bu kural otomatik olarak söz konusu kurala bağlıdır. Adlandırılmış kuralın outs C veya C++ kaynak dosyalarıysa bu kurala derlenir. Kitaplık dosyalarıysa bağlanır.

İzin verilen srcs dosya türleri:

  • C ve C++ kaynak dosyaları: .c, .cc, .cpp, .cxx, .c++, .C
  • C ve C++ başlık dosyaları: .h, .hh, .hpp, .hxx, .inc, .inl, .H
  • C ön işlemcili derleyici: .S
  • Arşiv: .a, .pic.a
  • "Her zaman bağla" kitaplığı: .lo, .pic.lo
  • Sürümlü veya sürümsüz paylaşılan kitaplık: .so, .so.version
  • Nesne dosyası: .o, .pic.o

...ve bu dosyaları oluşturan tüm kurallar. Farklı uzantılar, gcc kuralına uygun olarak farklı programlama dillerini gösterir.

additional_linker_inputs

Etiket listesi; varsayılan değer []'dir.

Bu dosyaları C++ bağlayıcı komutuna iletin.

Örneğin, derlenmiş Windows .res dosyaları, ikili hedefe yerleştirilmek üzere burada sağlanabilir.

copts

Dize listesi; varsayılan değer []'dır.

Bu seçenekleri C++ derleme komutuna ekleyin. "Değişken yap" yerine koyma ve Bourne kabuğu belirteçleştirme işlemine tabidir.

Bu özellikteki her dize, ikili hedef derlenmeden önce COPTS'ya belirtilen sırayla eklenir. İşaretler yalnızca bu hedefi derlerken geçerli olur, bağımlılıkları için geçerli olmaz. Bu nedenle, başka yerlerde bulunan başlık dosyaları konusunda dikkatli olun. Tüm yollar, mevcut pakete değil, çalışma alanına göre olmalıdır.

Paket, özelliği bildiriyorsa no_copts_tokenization, Bourne kabuğu belirteçleştirme yalnızca tek bir "Marka" değişkeninden oluşan dizeler için geçerlidir.

defines

Dize listesi; varsayılan değer []'dır.

Derleme satırına eklenecek tanımlar listesi. "Make" değişkeni değiştirme ve Bourne kabuğu belirteçleştirme işlemine tabidir. Tek bir Bourne kabuğu jetonundan oluşması gereken her dize, -D ile öneklenir ve bu hedefin derleme komut satırına ve buna bağlı olan her kurala eklenir. Bu işlem, geniş kapsamlı etkilere neden olabileceğinden çok dikkatli olun. Şüpheye düştüğünüzde, değerleri local_defines öğesine ekleyin.
includes

Dize listesi; varsayılan değer []'dır.

Derleme satırına eklenecek include dizinlerinin listesi.

"Değişken yap" yerine koyma işlemine tabidir. Her dizenin başına -isystem eklenir ve COPTS'ye eklenir. COPTS'tan farklı olarak, bu işaretler bu kural ve ona bağlı olan her kural için eklenir. (Not: bağlı olduğu kurallar değil!) Bu işlem, geniş kapsamlı etkilere neden olabileceğinden çok dikkatli olun. Şüpheye düştüğünüzde bunun yerine COPTS'a "-I" işaretleri ekleyin.

Üstbilgiler srcs veya hdrs'ye eklenmelidir. Aksi takdirde, derleme korumalı alanda yapıldığında (varsayılan) bağımlı kurallar tarafından kullanılamazlar.

Etiket; varsayılan değer "@bazel_tools//tools/cpp:link_extra_lib"'dir.

Ek kitaplıkların bağlanmasını kontrol edin.

Varsayılan olarak, C++ ikili dosyaları //tools/cpp:link_extra_lib ile bağlantılıdır ve bu da varsayılan olarak //tools/cpp:link_extra_libs etiket işaretine bağlıdır. Bu kitaplık, işaret ayarlanmadığı sürece varsayılan olarak boştur. Etiket işaretini ayarlamak, zayıf semboller için geçersiz kılmalar, paylaşılan kitaplık işlevleri için kesiciler veya özel çalışma zamanı kitaplıkları (malloc değiştirmeleri için malloc veya --custom_malloc tercih edilir) gibi isteğe bağlı bağımlılıkların bağlanmasına olanak tanır. Bu özelliği None olarak ayarlamak bu davranışı devre dışı bırakır.

linkopts

Dize listesi; varsayılan değer []'dır.

Bu işaretleri C++ bağlayıcı komutuna ekleyin. "Marka" değişkeni yerine koyma, Bourne shell belirteçleştirme ve etiket genişletme işlemlerine tabidir. Bu özellikteki her dize, ikili hedef bağlanmadan önce LINKOPTS öğesine eklenir.

Bu listede $ veya - ile başlamayan her öğenin deps içindeki bir hedefin etiketi olduğu varsayılır. Bu hedef tarafından oluşturulan dosyaların listesi bağlayıcı seçeneklerine eklenir. Etiket geçersizse veya deps içinde beyan edilmemişse hata bildirilir.

linkshared

Boole; yapılandırılamaz; varsayılan değer False

Paylaşılan kitaplık oluşturma Bu özelliği etkinleştirmek için kuralınıza linkshared=True özelliğini ekleyin. Bu seçenek varsayılan olarak devre dışıdır.

Bu işaretin varlığı, bağlantının -shared işaretinden gcc işaretine yapıldığını ve ortaya çıkan paylaşılan kitaplığın örneğin bir Java programına yüklenmeye uygun olduğunu gösterir. Ancak, derleme amacıyla hiçbir zaman bağımlı ikiliye bağlanmaz. Çünkü cc_binary kuralıyla oluşturulan paylaşılan kitaplıkların yalnızca diğer programlar tarafından manuel olarak yüklendiği varsayılır. Bu nedenle, cc_library kuralının yerine kullanılamaz. Ölçeklenebilirlik açısından bu yaklaşımdan tamamen kaçınmanızı ve bunun yerine java_library'nın cc_library kurallarına bağlı olmasına izin vermenizi öneririz.

Hem linkopts=['-static'] hem de linkshared=True öğesini belirtirseniz tamamen bağımsız tek bir birim elde edersiniz. Hem linkstatic=True hem de linkshared=True öğesini belirtirseniz tek bir birim elde edersiniz. Bu birim çoğunlukla bağımsızdır.

linkstatic

Boole değeri; varsayılan değer True'dır.

cc_binary ve cc_test için: İkiliyi statik modda bağlayın. cc_library.linkstatic için: Aşağıya bakın.

Bu seçenek varsayılan olarak cc_binary için etkin, diğerleri için devre dışıdır.

Etkinleştirilirse ve bu bir ikili veya test ise bu seçenek, mümkün olduğunda kullanıcı kitaplıkları için .so yerine .a'nın bağlanması gerektiğini derleme aracına bildirir. Bazı sistem kitaplıkları ve statik kitaplığı olmayan kitaplıklar dinamik olarak bağlanmaya devam edebilir. Bu nedenle, ortaya çıkan yürütülebilir dosya yine dinamik olarak bağlanır ve bu nedenle yalnızca çoğunlukla statiktir.

Bir yürütülebilir dosyayı bağlamanın üç farklı yolu vardır:

  • Her şeyin statik olarak bağlandığı fully_static_link özelliğiyle STATIC; ör. "gcc -static foo.o libbar.a libbaz.a -lm".
    Bu mod, features özelliğinde fully_static_link belirtilerek etkinleştirilir.
  • STATIC: Tüm kullanıcı kitaplıklarının statik olarak bağlandığı (statik sürüm varsa) ancak sistem kitaplıklarının (C/C++ çalışma zamanı kitaplıkları hariç) dinamik olarak bağlandığı moddur. Örneğin, "gcc foo.o libfoo.a libbaz.a -lm".
    Bu mod, linkstatic=True belirtilerek etkinleştirilir.
  • DYNAMIC: Tüm kitaplıkların dinamik olarak bağlandığı (dinamik bir sürüm varsa) moddur. Örneğin, "gcc foo.o libfoo.so libbaz.so -lm".
    Bu mod, linkstatic=False belirtilerek etkinleştirilir.

linkstatic özelliği, cc_library() kuralında kullanıldığında farklı bir anlam taşır. Bir C++ kitaplığı için linkstatic=True, yalnızca statik bağlantıya izin verildiğini gösterir. Bu nedenle .so oluşturulmaz. linkstatic=False, statik kitaplıkların oluşturulmasını engellemez. Bu özellik, dinamik kitaplıkların oluşturulmasını kontrol etmek için tasarlanmıştır.

linkstatic=False ise derleme aracı, *.runfiles alanındaki bağımlı paylaşılan kitaplıklar için sembolik bağlantılar oluşturur.

local_defines

Dize listesi; varsayılan değer []'dır.

Derleme satırına eklenecek tanımlar listesi. "Make" değişkeni değiştirme ve Bourne kabuğu belirteçleştirme işlemine tabidir. Tek bir Bourne kabuğu jetonundan oluşması gereken her dizeye -D öneki eklenir ve bu hedef için derleme komut satırına eklenir ancak bağımlılarına eklenmez.
malloc

Etiket; varsayılan değer "@bazel_tools//tools/cpp:malloc"'dir.

malloc'a yönelik varsayılan bağımlılığı geçersiz kılın.

Varsayılan olarak C++ ikilileri //tools/cpp:malloc ile bağlantılıdır. Bu, boş bir kitaplık olduğundan ikili, libc malloc'u kullanır. Bu etiket, cc_library ile ilgili olmalıdır. Derleme, C++ dışındaki bir kural içinse bu seçeneğin etkisi olmaz. linkshared=True belirtilirse bu özelliğin değeri yoksayılır.

nocopts

Dize; varsayılan değer ""

Eşleşen seçenekleri C++ derleme komutundan kaldırın. "Marka" değişkeni yerine koyma işlemine tabidir. Bu özelliğin değeri normal ifade olarak yorumlanır. Bu normal ifadeyle eşleşen tüm mevcut COPTS (kuralın copts özelliğinde açıkça belirtilen değerler dahil) bu kuralın derlenmesi amacıyla COPTS'dan kaldırılır. Bu özelliğe nadiren ihtiyaç duyulur.
stamp

Tam sayı; varsayılan değer -1

Derleme bilgilerinin ikili dosyaya kodlanıp kodlanmayacağı. Olası değerler:
  • stamp = 1: Derleme bilgileri, --nostamp derlemelerinde bile her zaman ikiliye damgalanır. Bu ayardan kaçınılmalıdır. Çünkü bu ayar, ikili dosya ve buna bağlı tüm aşağı akış işlemleri için uzaktan önbelleğe almayı devre dışı bırakabilir.
  • stamp = 0: Derleme bilgilerini her zaman sabit değerlerle değiştirin. Bu, iyi bir derleme sonucu önbelleğe alma sağlar.
  • stamp = -1: Derleme bilgilerinin yerleştirilmesi, --[no]stamp işaretiyle kontrol edilir.

Damgalı ikili dosyalar, bağımlılıkları değişmediği sürece yeniden oluşturulmaz.
win_def_file

Etiket; varsayılan değer None'dir.

Bağlayıcıya iletilecek Windows DEF dosyası.

Bu özellik yalnızca hedef platform Windows olduğunda kullanılmalıdır. Paylaşılan bir kitaplık bağlanırken sembolleri dışa aktarmak için kullanılabilir.

cc_import

Kural kaynağını görüntüleme 
cc_import(name, deps, data, hdrs, alwayslink, compatible_with, deprecation, distribs, features, interface_library, licenses, restricted_to, shared_library, static_library, system_provided, tags, target_compatible_with, testonly, visibility)

cc_import kuralları, kullanıcıların önceden derlenmiş C/C++ kitaplıklarını içe aktarmasına olanak tanır.

Tipik kullanım alanları şunlardır:
1. Statik kitaplık bağlama 

cc_import(
  name = "mylib",
  hdrs = ["mylib.h"],
  static_library = "libmylib.a",
  # If alwayslink is turned on,
  # libmylib.a will be forcely linked into any binary that depends on it.
  # alwayslink = 1,
)
2. Paylaşılan kitaplık bağlama (Unix) 
cc_import(
  name = "mylib",
  hdrs = ["mylib.h"],
  shared_library = "libmylib.so",
)
3. Paylaşılan kitaplığı arayüz kitaplığına bağlama (Windows) 
cc_import(
  name = "mylib",
  hdrs = ["mylib.h"],
  # mylib.lib is an import library for mylib.dll which will be passed to linker
  interface_library = "mylib.lib",
  # mylib.dll will be available for runtime
  shared_library = "mylib.dll",
)
4. Paylaşılan kitaplığı system_provided=True ile bağlama (Windows) 
cc_import(
  name = "mylib",
  hdrs = ["mylib.h"],
  # mylib.lib is an import library for mylib.dll which will be passed to linker
  interface_library = "mylib.lib",
  # mylib.dll is provided by system environment, for example it can be found in PATH.
  # This indicates that Bazel is not responsible for making mylib.dll available.
  system_provided = 1,
)
5. Statik veya paylaşılan kitaplığa bağlama
Unix'te: 
cc_import(
  name = "mylib",
  hdrs = ["mylib.h"],
  static_library = "libmylib.a",
  shared_library = "libmylib.so",
)

# first will link to libmylib.a
cc_binary(
  name = "first",
  srcs = ["first.cc"],
  deps = [":mylib"],
  linkstatic = 1, # default value
)

# second will link to libmylib.so
cc_binary(
  name = "second",
  srcs = ["second.cc"],
  deps = [":mylib"],
  linkstatic = 0,
)
Windows'da: 
cc_import(
  name = "mylib",
  hdrs = ["mylib.h"],
  static_library = "libmylib.lib", # A normal static library
  interface_library = "mylib.lib", # An import library for mylib.dll
  shared_library = "mylib.dll",
)

# first will link to libmylib.lib
cc_binary(
  name = "first",
  srcs = ["first.cc"],
  deps = [":mylib"],
  linkstatic = 1, # default value
)

# second will link to mylib.dll through mylib.lib
cc_binary(
  name = "second",
  srcs = ["second.cc"],
  deps = [":mylib"],
  linkstatic = 0,
)
cc_import, include özelliğini destekler. Örneğin: 
  cc_import(
  name = "curl_lib",
  hdrs = glob(["vendor/curl/include/curl/*.h"]),
  includes = [ "vendor/curl/include" ],
  shared_library = "vendor/curl/lib/.libs/libcurl.dylib",
)

Bağımsız değişkenler

Özellikler
name

Ad; zorunlu

Bu hedef için benzersiz bir ad.
deps

Etiket listesi; varsayılan değer []'dir.

Hedefin bağlı olduğu diğer kitaplıkların listesi. deps hakkındaki genel yorumları Çoğu derleme kuralı tarafından tanımlanan tipik özellikler bölümünde bulabilirsiniz.
hdrs

Etiket listesi; varsayılan değer []'dir.

Bu önceden derlenmiş kitaplık tarafından yayınlanan ve bağımlı kurallardaki kaynaklar tarafından doğrudan dahil edilecek başlık dosyalarının listesi.

Boole değeri; varsayılan değer False'dır.

1 ise bu C++ önceden derlenmiş kitaplığına (doğrudan veya dolaylı olarak) bağlı olan tüm ikili dosyalar, bazıları ikili dosya tarafından referans verilen semboller içermese bile statik kitaplıkta arşivlenen tüm nesne dosyalarına bağlanır. Bu, kodunuz ikilideki kod tarafından açıkça çağrılmıyorsa (ör. kodunuz, bir hizmet tarafından sağlanan geri çağırma işlemini almak için kaydediliyorsa) kullanışlıdır.

Alwayslink, Windows'da VS 2017 ile çalışmıyorsa bu durum bilinen bir sorundan kaynaklanmaktadır. Lütfen VS 2017'nizi en son sürüme yükseltin.
interface_library

Etiket; varsayılan değer None'dir.

Paylaşılan kitaplığı bağlamak için tek bir arayüz kitaplığı.

İzin verilen dosya türleri: .ifso, .tbd, .lib, .so veya .dylib

shared_library

Etiket; varsayılan değer None'dir.

Tek bir önceden derlenmiş paylaşılan kitaplık. Bazel, çalışma zamanında kendisine bağlı olan ikili dosyanın bu dosyaya erişebilmesini sağlar.

İzin verilen dosya türleri: .so, .dll veya .dylib

static_library

Etiket; varsayılan değer None'dir.

Tek bir önceden derlenmiş statik kitaplık.

İzin verilen dosya türleri: .a, .pic.a veya .lib

system_provided

Boole değeri; varsayılan değer False'dır.

1 ise çalışma zamanında gerekli olan paylaşılan kitaplığın sistem tarafından sağlandığını gösterir. Bu durumda interface_library belirtilmeli ve shared_library boş olmalıdır.

cc_library

Kural kaynağını görüntüleme 
cc_library(name, deps, srcs, data, hdrs, additional_compiler_inputs, additional_linker_inputs, alwayslink, compatible_with, copts, defines, deprecation, distribs, exec_compatible_with, exec_properties, features, implementation_deps, include_prefix, includes, licenses, linkopts, linkstamp, linkstatic, local_defines, nocopts, restricted_to, strip_include_prefix, tags, target_compatible_with, testonly, textual_hdrs, toolchains, visibility, win_def_file)

Üstbilgi ekleme kontrolü

Derlemede kullanılan tüm başlık dosyaları hdrs veya cc_* kurallarının srcs bölümünde bildirilmelidir. Bu ayar zorunlu kılındı.

cc_library kuralları için hdrs içindeki başlıklar, kitaplığın herkese açık arayüzünü oluşturur ve hem hdrs içindeki dosyalardan hem de kitaplığın kendisinin srcs'sinden doğrudan dahil edilebilir. Ayrıca, kitaplığı deps'lerinde listeleyen cc_* kurallarının hdrs ve srcs'sindeki dosyalardan da dahil edilebilir. srcs içindeki başlıklar yalnızca hdrs ve kitaplığın srcs içindeki dosyalardan doğrudan eklenmelidir. Bir başlığı hdrs veya srcs içine yerleştirip yerleştirmeyeceğinize karar verirken bu kitaplığın tüketicilerinin başlığı doğrudan ekleyebilmesini isteyip istemediğinizi göz önünde bulundurmalısınız. Bu, programlama dillerinde public ve private görünürlüğü arasındaki karara benzer.

cc_binary ve cc_test kurallarının dışa aktarılmış bir arayüzü yoktur. Bu nedenle, hdrs özelliği de yoktur. Doğrudan ikiliye veya teste ait tüm başlıklar srcs içinde listelenmelidir.

Bu kuralları göstermek için aşağıdaki örneğe bakın. 

cc_binary(
    name = "foo",
    srcs = [
        "foo.cc",
        "foo.h",
    ],
    deps = [":bar"],
)

cc_library(
    name = "bar",
    srcs = [
        "bar.cc",
        "bar-impl.h",
    ],
    hdrs = ["bar.h"],
    deps = [":baz"],
)

cc_library(
    name = "baz",
    srcs = [
        "baz.cc",
        "baz-impl.h",
    ],
    hdrs = ["baz.h"],
)

Bu örnekte izin verilen doğrudan eklemeler aşağıdaki tabloda listelenmiştir. Örneğin, foo.cc, foo.h ve bar.h değerlerini doğrudan içerebilir ancak baz.h değerini içeremez.

Dosya dahilİzin verilen eklemeler
foo.hbar.h
foo.ccfoo.h bar.h
bar.hbar-impl.h baz.h
bar-impl.hbar.h baz.h
bar.ccbar.h bar-impl.h baz.h
baz.hbaz-impl.h
baz-impl.hbaz.h
baz.ccbaz.h baz-impl.h

Dahil etme kontrolü kuralları yalnızca doğrudan dahil etmeler için geçerlidir. Yukarıdaki örnekte foo.cc, bar.h'u içerebilir. bar.h, baz.h'yi içerebilir. baz.h ise baz-impl.h'ü içerebilir. Teknik olarak, bir .cc dosyasının derlenmesi, geçişli deps kapanışındaki herhangi bir cc_library içinde hdrs veya srcs'deki herhangi bir başlık dosyasını geçişli olarak içerebilir. Bu durumda derleyici, foo.cc derlenirken baz.h ve baz-impl.h değerlerini okuyabilir ancak foo.cc, #include "baz.h" değerini içermemelidir. Buna izin verilebilmesi için baz, foo adlı deps'ye eklenmelidir.

Bazel, dahil etme kontrolü kurallarını uygulamak için araç zinciri desteğine bağlıdır. layering_check özelliği, araç zinciri tarafından desteklenmeli ve açıkça istenmelidir. Örneğin, --features=layering_check komut satırı işareti veya package işlevinin features parametresi aracılığıyla istenebilir. Bazel tarafından sağlanan araç zincirleri, bu özelliği yalnızca Unix ve macOS'te clang ile destekler.

Bağımsız değişkenler

Özellikler
name

Ad; zorunlu

Bu hedef için benzersiz bir ad.
deps

Etiket listesi; varsayılan değer []'dir.

İkili hedefte bağlanacak diğer kitaplıkların listesi.

Bunlar cc_library veya objc_library hedef olabilir.
srcs

Etiket listesi; varsayılan değer []'dir.

Hedefi oluşturmak için işlenen C ve C++ dosyalarının listesi. Bunlar, oluşturulmamış (normal kaynak kodu) veya oluşturulmuş C/C++ kaynak ve başlık dosyalarıdır.

Tüm .cc, .c ve .cpp dosyaları derlenir. Bunlar oluşturulmuş dosyalar olabilir: Adlandırılmış bir dosya başka bir kuralın outs bölümündeyse bu kural otomatik olarak söz konusu diğer kurala bağlı olur.

.h dosyası derlenmez ancak bu kuraldaki kaynaklar tarafından dahil edilebilir. Hem .cc hem de .h dosyaları, bu srcs veya deps bağımsız değişkeninde listelenen herhangi bir kuralın hdrs bölümünde listelenen üstbilgileri doğrudan içerebilir.

Tüm #include dosyaları, bu kuralın srcs özelliğinde veya referans verilen cc_library()'lerin hdrs özelliğinde belirtilmelidir. Önerilen stil, bir kitaplıkla ilişkili başlıkların o kitaplığın hdrs özelliğinde, bu kuralın kaynaklarıyla ilişkili kalan başlıkların ise srcs özelliğinde listelenmesidir. Daha ayrıntılı açıklama için "Başlık dahil etme kontrolü" bölümüne bakın.

Bir kuralın adı srcs içinde yer alıyorsa bu kural otomatik olarak söz konusu kurala bağlıdır. Adlandırılmış kuralın outs C veya C++ kaynak dosyalarıysa bu kurala derlenir. Kitaplık dosyalarıysa bağlanır.

İzin verilen srcs dosya türleri:

  • C ve C++ kaynak dosyaları: .c, .cc, .cpp, .cxx, .c++, .C
  • C ve C++ başlık dosyaları: .h, .hh, .hpp, .hxx, .inc, .inl, .H
  • C ön işlemcili derleyici: .S
  • Arşiv: .a, .pic.a
  • "Her zaman bağla" kitaplığı: .lo, .pic.lo
  • Sürümlü veya sürümsüz paylaşılan kitaplık: .so, .so.version
  • Nesne dosyası: .o, .pic.o

...ve bu dosyaları oluşturan tüm kurallar. Farklı uzantılar, gcc kuralına uygun olarak farklı programlama dillerini gösterir.

hdrs

Etiket listesi; varsayılan değer []'dir.

Bu kitaplık tarafından yayınlanan ve bağımlı kurallardaki kaynaklar tarafından doğrudan dahil edilecek başlık dosyalarının listesi.

Bu, kitaplığın arayüzünü açıklayan başlık dosyalarını bildirmek için kesinlikle tercih edilen konumdur. Bu üstbilgiler, bu kuraldaki veya bağımlı kurallardaki kaynaklar tarafından dahil edilmek üzere kullanılabilir. Bu kitaplığın bir istemcisi tarafından dahil edilmesi amaçlanmayan üstbilgiler, yayınlanmış bir üstbilgi tarafından dahil edilmiş olsalar bile bunun yerine srcs özelliğinde listelenmelidir. Daha ayrıntılı açıklama için "Başlık ekleme kontrolü" bölümüne bakın.

additional_compiler_inputs

Etiket listesi; varsayılan değer []'dir.

Derleyici komut satırına iletmek isteyebileceğiniz ek dosyalar (ör. temizleyici yoksayma listeleri). Burada belirtilen dosyalar daha sonra $(location) işleviyle copts'ta kullanılabilir.
additional_linker_inputs

Etiket listesi; varsayılan değer []'dir.

Bu dosyaları C++ bağlayıcı komutuna iletin.

Örneğin, derlenmiş Windows .res dosyaları, ikili hedefe yerleştirilmek üzere burada sağlanabilir.

Boole değeri; varsayılan değer False'dır.

1 ise bu C++ kitaplığına (doğrudan veya dolaylı olarak) bağlı olan tüm ikili programlar, bazıları ikili program tarafından referans verilen semboller içermese bile srcs içinde listelenen dosyaların tüm nesne dosyalarında bağlantı oluşturur. Bu, kodunuz ikilideki kod tarafından açıkça çağrılmıyorsa (ör. kodunuz, bir hizmet tarafından sağlanan geri çağırma işlemini almak için kaydediliyorsa) kullanışlıdır.

Alwayslink, Windows'da VS 2017 ile çalışmıyorsa bu durum bilinen bir sorundan kaynaklanmaktadır. Lütfen VS 2017'nizi en son sürüme yükseltin.
copts

Dize listesi; varsayılan değer []'dır.

Bu seçenekleri C++ derleme komutuna ekleyin. "Değişken yap" yerine koyma ve Bourne kabuğu belirteçleştirme işlemine tabidir.

Bu özellikteki her dize, ikili hedef derlenmeden önce COPTS'ya belirtilen sırayla eklenir. İşaretler yalnızca bu hedefi derlerken geçerli olur, bağımlılıkları için geçerli olmaz. Bu nedenle, başka yerlerde bulunan başlık dosyaları konusunda dikkatli olun. Tüm yollar, mevcut pakete değil, çalışma alanına göre olmalıdır.

Paket, özelliği bildiriyorsa no_copts_tokenization, Bourne kabuğu belirteçleştirme yalnızca tek bir "Marka" değişkeninden oluşan dizeler için geçerlidir.

defines

Dize listesi; varsayılan değer []'dır.

Derleme satırına eklenecek tanımlar listesi. "Make" değişkeni değiştirme ve Bourne kabuğu belirteçleştirme işlemine tabidir. Tek bir Bourne kabuğu jetonundan oluşması gereken her dize, -D ile öneklenir ve bu hedefin derleme komut satırına ve buna bağlı olan her kurala eklenir. Bu işlem, geniş kapsamlı etkilere neden olabileceğinden çok dikkatli olun. Şüpheye düştüğünüzde, değerleri local_defines öğesine ekleyin.
implementation_deps

Etiket listesi; varsayılan değer []'dir.

Kitaplık hedefinin bağlı olduğu diğer kitaplıkların listesi. deps'dan farklı olarak, bu kitaplıkların (ve tüm geçişli bağımlılıklarının) başlıkları ve dahil etme yolları yalnızca bu kitaplığın derlenmesi için kullanılır ve kendisine bağlı olan kitaplıklar için kullanılmaz. implementation_deps ile belirtilen kitaplıklar, bu kitaplığa bağlı ikili hedeflerde hâlâ bağlantılıdır.

Şu an için kullanım, cc_libraries ile sınırlıdır ve --experimental_cc_implementation_deps işaretiyle korunur.
include_prefix

Dize; varsayılan değer ""

Bu kuralın üstbilgilerinin yollarına eklenecek önek.

Ayarlanmışsa bu kuralın hdrs özelliğindeki başlıklar, kendi depoyla ilgili yollarına eklenen bu özelliğin değeriyle erişilebilir.

Bu ön ek eklenmeden önce strip_include_prefix özelliğindeki ön ek kaldırılır.

includes

Dize listesi; varsayılan değer []'dır.

Derleme satırına eklenecek include dizinlerinin listesi.

"Değişken yap" yerine koyma işlemine tabidir. Her dizenin başına -isystem eklenir ve COPTS'ye eklenir. COPTS'tan farklı olarak, bu işaretler bu kural ve ona bağlı olan her kural için eklenir. (Not: bağlı olduğu kurallar değil!) Bu işlem, geniş kapsamlı etkilere neden olabileceğinden çok dikkatli olun. Şüpheye düştüğünüzde bunun yerine COPTS'a "-I" işaretleri ekleyin.

Üstbilgiler srcs veya hdrs'ye eklenmelidir. Aksi takdirde, derleme korumalı alanda yapıldığında (varsayılan) bağımlı kurallar tarafından kullanılamazlar.

linkopts

Dize listesi; varsayılan değer []'dır.

Bu işaretleri C++ bağlayıcı komutuna ekleyin. "Marka" değişkeni yerine koyma, Bourne shell belirteçleştirme ve etiket genişletme işlemlerine tabidir. Bu özellikteki her dize, ikili hedef bağlanmadan önce LINKOPTS öğesine eklenir.

Bu listede $ veya - ile başlamayan her öğenin deps içindeki bir hedefin etiketi olduğu varsayılır. Bu hedef tarafından oluşturulan dosyaların listesi bağlayıcı seçeneklerine eklenir. Etiket geçersizse veya deps içinde beyan edilmemişse hata bildirilir.

linkstamp

Etiket; varsayılan değer None'dir.

Belirtilen C++ kaynak dosyasını aynı anda derleyip son ikili dosyaya bağlar. Bu hile, ikili dosyalara zaman damgası bilgilerini eklemek için gereklidir. Kaynak dosya normal şekilde bir nesne dosyasına derlenirse zaman damgası yanlış olur. Bağlantı zaman damgası derlemesi, belirli bir derleyici işaretleri kümesini içermeyebilir ve bu nedenle belirli bir başlığa, derleyici seçeneğine veya başka bir derleme değişkenine bağlı olmamalıdır. Bu seçeneğin yalnızca base paketinde kullanılması gerekir.
linkstatic

Boole değeri; varsayılan değer False'dır.

cc_binary ve cc_test için: İkiliyi statik modda bağlayın. cc_library.linkstatic için: Aşağıya bakın.

Bu seçenek varsayılan olarak cc_binary için etkin, diğerleri için devre dışıdır.

Etkinleştirilirse ve bu bir ikili veya test ise bu seçenek, mümkün olduğunda kullanıcı kitaplıkları için .so yerine .a'nın bağlanması gerektiğini derleme aracına bildirir. Bazı sistem kitaplıkları ve statik kitaplığı olmayan kitaplıklar dinamik olarak bağlanmaya devam edebilir. Bu nedenle, ortaya çıkan yürütülebilir dosya yine dinamik olarak bağlanır ve bu nedenle yalnızca çoğunlukla statiktir.

Bir yürütülebilir dosyayı bağlamanın üç farklı yolu vardır:

  • Her şeyin statik olarak bağlandığı fully_static_link özelliğiyle STATIC; ör. "gcc -static foo.o libbar.a libbaz.a -lm".
    Bu mod, features özelliğinde fully_static_link belirtilerek etkinleştirilir.
  • STATIC: Tüm kullanıcı kitaplıklarının statik olarak bağlandığı (statik sürüm varsa) ancak sistem kitaplıklarının (C/C++ çalışma zamanı kitaplıkları hariç) dinamik olarak bağlandığı moddur. Örneğin, "gcc foo.o libfoo.a libbaz.a -lm".
    Bu mod, linkstatic=True belirtilerek etkinleştirilir.
  • DYNAMIC: Tüm kitaplıkların dinamik olarak bağlandığı (dinamik bir sürüm varsa) moddur. Örneğin, "gcc foo.o libfoo.so libbaz.so -lm".
    Bu mod, linkstatic=False belirtilerek etkinleştirilir.

linkstatic özelliği, cc_library() kuralında kullanıldığında farklı bir anlam taşır. Bir C++ kitaplığı için linkstatic=True, yalnızca statik bağlantıya izin verildiğini gösterir. Bu nedenle .so oluşturulmaz. linkstatic=False, statik kitaplıkların oluşturulmasını engellemez. Bu özellik, dinamik kitaplıkların oluşturulmasını kontrol etmek için tasarlanmıştır.

linkstatic=False ise derleme aracı, *.runfiles alanındaki bağımlı paylaşılan kitaplıklar için sembolik bağlantılar oluşturur.

local_defines

Dize listesi; varsayılan değer []'dır.

Derleme satırına eklenecek tanımlar listesi. "Make" değişkeni değiştirme ve Bourne kabuğu belirteçleştirme işlemine tabidir. Tek bir Bourne kabuğu jetonundan oluşması gereken her dizeye -D öneki eklenir ve bu hedef için derleme komut satırına eklenir ancak bağımlılarına eklenmez.
nocopts

Dize; varsayılan değer ""

Eşleşen seçenekleri C++ derleme komutundan kaldırın. "Marka" değişkeni yerine koyma işlemine tabidir. Bu özelliğin değeri normal ifade olarak yorumlanır. Bu normal ifadeyle eşleşen tüm mevcut COPTS (kuralın copts özelliğinde açıkça belirtilen değerler dahil) bu kuralın derlenmesi amacıyla COPTS'dan kaldırılır. Bu özelliğe nadiren ihtiyaç duyulur.
strip_include_prefix

Dize; varsayılan değer ""

Bu kuralın başlıklarının yollarından kaldırılacak önek.

Ayarlandığında, bu kuralın hdrs özelliğindeki başlıklar, bu ön ek kesilmiş olarak kendi yollarında erişilebilir.

Göreli yol ise paketle ilgili bir yol olarak kabul edilir. Mutlak bir yol ise depoya göreli yol olarak anlaşılır.

include_prefix özelliğindeki ön ek, bu ön ek kaldırıldıktan sonra eklenir.

textual_hdrs

Etiket listesi; varsayılan değer []'dir.

Bu kitaplık tarafından yayınlanan ve bağımlı kurallardaki kaynaklar tarafından metin olarak dahil edilecek başlık dosyalarının listesi.

Bu konum, kendi başlarına derlenemeyen başlık dosyalarını bildirmek için kullanılır. Bu dosyalar, geçerli kod oluşturmak için her zaman diğer kaynak dosyalar tarafından metin olarak dahil edilmelidir.
win_def_file

Etiket; varsayılan değer None'dir.

Bağlayıcıya iletilecek Windows DEF dosyası.

Bu özellik yalnızca hedef platform Windows olduğunda kullanılmalıdır. Paylaşılan bir kitaplık bağlanırken sembolleri dışa aktarmak için kullanılabilir.

cc_proto_library

Kural kaynağını görüntüleme 
cc_proto_library(name, deps, data, compatible_with, deprecation, distribs, exec_compatible_with, exec_properties, features, licenses, restricted_to, tags, target_compatible_with, testonly, visibility)

cc_proto_library, .proto dosyalarından C++ kodu oluşturur.

deps, proto_library kurallarını işaret etmelidir.

Örnek: 

cc_library(
    name = "lib",
    deps = [":foo_cc_proto"],
)

cc_proto_library(
    name = "foo_cc_proto",
    deps = [":foo_proto"],
)

proto_library(
    name = "foo_proto",
)

Bağımsız değişkenler

Özellikler
name

Ad; zorunlu

Bu hedef için benzersiz bir ad.
deps

Etiket listesi; varsayılan değer []'dir.

C++ kodu oluşturmak için proto_library kurallarının listesi.

cc_shared_library

Kural kaynağını görüntüleme 
cc_shared_library(name, deps, additional_linker_inputs, dynamic_deps, exports_filter, shared_lib_name, tags, user_link_flags, win_def_file)

Paylaşılan bir kitaplık oluşturur.

Örnek

cc_shared_library(
    name = "foo_shared",
    deps = [
        ":foo",
    ],
    dynamic_deps = [
        ":bar_shared",
    ],
    additional_linker_inputs = [
        ":foo.lds",
    ],
    user_link_flags = [
        "-Wl,--version-script=$(location :foo.lds)",
    ],
)
cc_library(
    name = "foo",
    srcs = ["foo.cc"],
    hdrs = ["foo.h"],
    deps = [
        ":bar",
        ":baz",
    ],
)
cc_shared_library(
    name = "bar_shared",
    shared_lib_name = "bar.so",
    deps = [":bar"],
)
cc_library(
    name = "bar",
    srcs = ["bar.cc"],
    hdrs = ["bar.h"],
)
cc_library(
    name = "baz",
    srcs = ["baz.cc"],
    hdrs = ["baz.h"],
)

Örnekte foo_shared, foo ve baz'yi statik olarak bağlar. baz, geçişli bir bağımlılıktır. bar, dynamic_dep bar_shared tarafından dinamik olarak sağlandığı için bağlantı oluşturulmuyor.

foo_shared, hangi sembollerin dışa aktarılacağını kontrol etmek için bir bağlayıcı komut dosyası *.lds dosyası kullanır. cc_shared_library Kural mantığı, hangi sembollerin dışa aktarılacağını kontrol etmez. Yalnızca, iki paylaşılan kitaplık aynı hedefleri dışa aktarıyorsa analiz aşamasında hatalar vermek için dışa aktarıldığı varsayılanı kullanır.

cc_shared_library öğesinin her doğrudan bağımlılığının dışa aktarıldığı varsayılır. Bu nedenle Bazel, analiz sırasında foo öğesinin foo_shared tarafından dışa aktarıldığını varsayar. baz öğesinin foo_shared tarafından dışa aktarıldığı varsayılmaz. exports_filter ile eşleşen her hedef de dışa aktarılmış olarak kabul edilir.

Örnekteki her bir cc_library en fazla bir cc_shared_library içinde görünmelidir. baz öğesini de bar_shared öğesine bağlamak istersek baz öğesine tags = ["LINKABLE_MORE_THAN_ONCE"] eklememiz gerekir.

shared_lib_name özelliği nedeniyle, bar_shared tarafından oluşturulan dosya, Linux'ta varsayılan olarak sahip olacağı libbar.so adı yerine bar.so adını alır.

Hatalar

Two shared libraries in dependencies export the same symbols.

Bu durum, aynı hedefi dışa aktaran iki farklı cc_shared_library bağımlılıkla hedef oluşturduğunuzda meydana gelir. Bu sorunu düzeltmek için cc_shared_library bağımlılıklarından birinde kitaplıkların dışa aktarılmasını durdurmanız gerekir.

Bu durum, aynı hedefi statik olarak bağlayan iki farklı cc_shared_library bağımlılığına sahip yeni bir cc_shared_library oluşturduğunuzda ortaya çıkar. Dışa aktarma hatalarına benzer.

Bu sorunu düzeltmenin bir yolu, kitaplığın cc_shared_library bağımlılıklarından birine bağlanmasını durdurmaktır. Aynı zamanda, kitaplığı bağlamaya devam eden kullanıcının, kitaplığı dışa aktarması gerekir. Böylece, kitaplığı bağlamayan kullanıcı sembolleri görmeye devam edebilir. Bir diğer yöntem ise hedefi dışa aktaran üçüncü bir kitaplığı kullanmaktır. Üçüncü bir yöntem ise cc_library öğesini LINKABLE_MORE_THAN_ONCE ile etiketlemektir. Ancak bu düzeltme nadiren kullanılmalı ve cc_library öğesinin birden fazla kez bağlanmanın güvenli olduğundan kesinlikle emin olmalısınız.

'//foo:foo' is already linked statically in '//bar:bar' but not exported`

Bu, deps öğenizin geçişli kapanımındaki bir kitaplığa cc_shared_library bağımlılıklarından birinden geçmeden ulaşılabildiği ancak bu kitaplığın dynamic_deps içinde farklı bir cc_shared_library öğesine zaten bağlandığı ve dışa aktarılmadığı anlamına gelir.

Çözüm, bağımlılıktan dışa aktarmak veya dışa aktaran üçüncü bir cc_shared_library çekmektir.cc_shared_library

Do not place libraries which only contain a precompiled dynamic library in deps.

Önceden derlenmiş bir dinamik kitaplığınız varsa bu kitaplığın, şu anda oluşturduğunuz mevcut cc_shared_library hedefiyle statik olarak bağlanması gerekmez ve bağlanamaz. Bu nedenle, deps cc_shared_library'e ait değildir. Bu önceden derlenmiş dinamik kitaplık, cc_libraries öğelerinizden birinin bağımlılığıysa cc_library öğesinin doğrudan bu kitaplığa bağımlı olması gerekir.

Trying to export a library already exported by a different shared library

Mevcut kuralda, dinamik bağımlılıklarınızdan biri tarafından zaten dışa aktarılan bir hedefi dışa aktardığınızı iddia ediyorsanız bu hatayı görürsünüz.

Bu sorunu düzeltmek için hedefi deps öğesinden kaldırın ve yalnızca dinamik bağımlılıktan yararlanın veya exports_filter öğesinin bu hedefi yakalamadığından emin olun.

Bağımsız değişkenler

Özellikler
name

Ad; zorunlu

Bu hedef için benzersiz bir ad.
deps

Etiket listesi; varsayılan değer []'dir.

Tam arşivlendikten sonra koşulsuz olarak paylaşılan kitaplığa statik olarak bağlanacak üst düzey kitaplıklar.

Bu doğrudan bağımlılıkların geçişli kitaplık bağımlılıkları, dynamic_deps içinde cc_shared_library tarafından daha önce bağlanmadıkları sürece bu paylaşılan kitaplığa bağlanır.

Analiz sırasında, kural uygulaması, aynı hedefleri birden fazla cc_shared_libraries dışa aktardığında hata vermesi için deps içinde listelenen tüm hedeflerin paylaşılan kitaplık tarafından dışa aktarıldığını varsayar. Kural uygulaması, bağlayıcıya paylaşılan nesne tarafından hangi sembollerin dışa aktarılması gerektiği konusunda bilgi vermez. Kullanıcı, bu durumu bağlayıcı komut dosyaları veya kaynak kodundaki görünürlük bildirimleri aracılığıyla düzeltmelidir.

Aynı kitaplık birden fazla cc_shared_library'ya statik olarak bağlandığında da uygulama hataları tetiklenir. Bu durum, "LINKABLE_MORE_THAN_ONCE" öğesinin cc_library.tags öğesine eklenmesiyle veya `cc_library` öğesinin paylaşılan kitaplıklardan birinin dışa aktarımı olarak listelenmesiyle önlenebilir. Böylece, biri diğerinin dynamic_dep öğesi haline getirilebilir.

additional_linker_inputs

Etiket listesi; varsayılan değer []'dir.

Bağlayıcıya iletmek isteyebileceğiniz ek dosyalar (ör. bağlayıcı komut dosyaları). Bağlayıcının bu dosyanın farkında olması için gereken bağlayıcı işaretlerini ayrı ayrı iletmeniz gerekir. Bu işlemi user_link_flags özelliği aracılığıyla yapabilirsiniz.
dynamic_deps

Etiket listesi; varsayılan değer []'dir.

Bunlar, mevcut hedefin bağlı olduğu diğer cc_shared_library bağımlılıklarıdır.

cc_shared_library uygulaması, geçişli deps içindeki hangi cc_libraries'nin farklı bir cc_shared_library tarafından sağlandığı için bağlanmaması gerektiğine karar vermek için dynamic_deps listesini (geçişli olarak, yani mevcut hedefin dynamic_deps'si de) kullanır.dynamic_deps

exports_filter

Dize listesi; varsayılan değer []'dır.

Bu özellik, mevcut paylaşılan kitaplık tarafından dışa aktarıldığı iddia edilen hedeflerin listesini içerir.

Herhangi bir hedef deps, paylaşılan kitaplık tarafından dışa aktarılmış olarak kabul edilir. Bu özellik, paylaşılan kitaplık tarafından dışa aktarılan ancak deps öğesinin geçişli bağımlılıkları olan tüm hedefleri listelemek için kullanılmalıdır.

Bu özniteliğin, bu hedeflere aslında bir bağımlılık kenarı eklemediğini unutmayın. Bağımlılık kenarı bunun yerine deps tarafından oluşturulmalıdır. Bu öznitelikteki girişler yalnızca dizelerdir. Bu özelliğe hedef yerleştirirken, paylaşılan kitaplığın bu hedeften sembolleri dışa aktardığı iddiasında bulunduğunuzu unutmayın. cc_shared_library mantığı, bağlayıcıya hangi sembollerin dışa aktarılması gerektiğini söyleme işini aslında yapmaz.

Aşağıdaki söz dizimine izin verilir:

foo/BUILD'deki herhangi bir hedefi hesaba katmak için //foo:__package__

//foo:__subpackages__ foo/BUILD'deki veya foo/ bar/BUILD gibi foo/altındaki diğer paketlerdeki hedefleri hesaba katmak için
shared_lib_name

Dize; varsayılan değer ""

Varsayılan olarak cc_shared_library, paylaşılan kitaplık çıkış dosyası için hedef adını ve platformu temel alan bir ad kullanır. Buna uzantı ve bazen de önek dahildir. Bazen varsayılan adı kullanmak istemeyebilirsiniz. Örneğin, Python için C++ paylaşılan kitaplıklarını yüklerken varsayılan lib* ön eki genellikle istenmez. Bu durumda, özel bir ad seçmek için bu özelliği kullanabilirsiniz.

Dize listesi; varsayılan değer []'dır.

Bağlayıcıya iletmek isteyebileceğiniz ek işaretler. Örneğin, bağlayıcının additional_linker_inputs aracılığıyla iletilen bir bağlayıcı komut dosyasının farkında olmasını sağlamak için aşağıdakileri kullanabilirsiniz: 
         cc_shared_library(
            name = "foo_shared",
            additional_linker_inputs = select({
              "//src/conditions:linux": [
                ":foo.lds",
                ":additional_script.txt",
              ],
              "//conditions:default": []}),
            user_link_flags = select({
              "//src/conditions:linux": [
                "-Wl,-rpath,kittens",
                "-Wl,--version-script=$(location :foo.lds)",
                "-Wl,--script=$(location :additional_script.txt)",
              ],
              "//conditions:default": []}),
              ...
         )
win_def_file

Etiket; varsayılan değer None'dir.

Bağlayıcıya iletilecek Windows DEF dosyası.

Bu özellik yalnızca hedef platform Windows olduğunda kullanılmalıdır. Paylaşılan bir kitaplık bağlanırken sembolleri dışa aktarmak için kullanılabilir.

cc_static_library

Kural kaynağını görüntüleme 
cc_static_library(name, deps, tags)
 Hedeflerin ve geçişli bağımlılıklarının listesinden statik bir kitaplık oluşturur.

Elde edilen statik kitaplık, deps içinde listelenen hedeflerin nesne dosyalarını ve geçişli bağımlılıklarını içerir. PIC nesnelerine öncelik verilir.

Çıkış grupları

linkdeps

deps içinde listelenen hedeflerin, statik kitaplığa herhangi bir nesne dosyası katkısında bulunmayan ancak en az bir statik, dinamik veya arayüz kitaplığı sağlayan geçişli bağımlılıklarının etiketlerini içeren bir metin dosyası. Elde edilen statik kitaplığın, bağlantı zamanında bu kitaplıkların kullanılabilir olmasını gerektirebilir.

linkopts

linkopts içinde listelenen hedeflerin tüm geçişli bağımlılıklarının kullanıcı tarafından sağlanan linkopts değerini içeren bir metin dosyası.deps

Yinelenen semboller

Varsayılan olarak, cc_static_library kuralı, ortaya çıkan statik kitaplığın yinelenen simge içermediğini kontrol eder. Bu durumda, derleme başarısız olur ve yinelenen sembolleri ve bunları içeren nesne dosyalarını listeleyen bir hata mesajı gösterilir.

Bu kontrol, features = ["-symbol_check"] ayarlanarak hedef veya paket başına ya da --features=-symbol_check aracılığıyla genel olarak devre dışı bırakılabilir.

symbol_check için araç zinciri desteği

Bazel ile birlikte gönderilen otomatik olarak yapılandırılmış C++ araç zincirleri, tüm platformlarda symbol_check özelliğini destekler. Özel araç zincirleri, iki yöntemden birini kullanarak destek ekleyebilir:

  • ACTION_NAMES.validate_static_library işlemini uygulama ve symbol_check özelliğiyle etkinleştirme. İşlemde ayarlanan araç, iki bağımsız değişkenle çağrılır: yinelenen sembollerin kontrol edileceği statik kitaplık ve kontrol başarılı olursa oluşturulması gereken bir dosyanın yolu.
  • symbol_check özelliğinin, statik kitaplık oluşturma işleminin yinelenen sembollerde başarısız olmasına neden olan arşivleyici işaretleri eklemesi.

Bağımsız değişkenler

Özellikler
name

Ad; zorunlu

Bu hedef için benzersiz bir ad.
deps

Etiket listesi; varsayılan değer []'dir.

Tüm geçişli bağımlılıkları dahil olmak üzere statik bir kitaplıkta birleştirilecek hedeflerin listesi.

Herhangi bir nesne dosyası sağlamayan bağımlılıklar statik kitaplığa dahil edilmez ancak etiketleri linkdeps çıkış grubu tarafından sağlanan dosyada toplanır.

fdo_prefetch_hints

Kural kaynağını görüntüleme 
fdo_prefetch_hints(name, compatible_with, deprecation, distribs, features, licenses, profile, restricted_to, tags, target_compatible_with, testonly, visibility)

Çalışma alanında veya belirtilen mutlak yolda bulunan bir FDO önceden getirme ipuçları profilini temsil eder. Örnekler:

fdo_prefetch_hints(
    name = "hints",
    profile = "//path/to/hints:profile.afdo",
)

fdo_profile(
  name = "hints_abs",
  absolute_path_profile = "/absolute/path/profile.afdo",
)

Bağımsız değişkenler

Özellikler
name

Ad; zorunlu

Bu hedef için benzersiz bir ad.
profile

Etiket; varsayılan değer None'dir.

İpuçları profilinin etiketi. İpuçları dosyası .afdo uzantısına sahiptir. Etiket, fdo_absolute_path_profile kuralına da işaret edebilir.

fdo_profile

Kural kaynağını görüntüleme 
fdo_profile(name, absolute_path_profile, compatible_with, deprecation, distribs, features, licenses, profile, proto_profile, restricted_to, tags, target_compatible_with, testonly, visibility)

Çalışma alanında veya belirtilen mutlak yolda bulunan bir FDO profilini temsil eder. Örnekler:

fdo_profile(
    name = "fdo",
    profile = "//path/to/fdo:profile.zip",
)

fdo_profile(
  name = "fdo_abs",
  absolute_path_profile = "/absolute/path/profile.zip",
)

Bağımsız değişkenler

Özellikler
name

Ad; zorunlu

Bu hedef için benzersiz bir ad.
absolute_path_profile

Dize; varsayılan değer ""

FDO profilinin mutlak yolu. FDO dosyasının aşağıdaki uzantılardan biri olabilir: Dizinlenmemiş LLVM profili için .profraw, dizinlenmiş LLVM profili için .profdata, LLVM profraw profili içeren .zip veya AutoFDO profili için .afdo.
profile

Etiket; varsayılan değer None'dir.

FDO profilinin etiketi veya bu profili oluşturan bir kural. FDO dosyasının şu uzantılardan biri olabilir: dizine eklenmemiş LLVM profili için .profraw, dizine eklenmiş LLVM profili için .profdata, LLVM profraw profili içeren .zip, AutoFDO profili için .afdo, XBinary profili için .xfdo. Etiket, fdo_absolute_path_profile kuralını da işaret edebilir.
proto_profile

Etiket; varsayılan değer None'dir.

Protobuf profilinin etiketi.

memprof_profile

Kural kaynağını görüntüleme 
memprof_profile(name, absolute_path_profile, compatible_with, deprecation, distribs, features, licenses, profile, restricted_to, tags, target_compatible_with, testonly, visibility)

Çalışma alanında veya belirtilen mutlak yolda bulunan bir MEMPROF profilini temsil eder. Örnekler:

memprof_profile(
    name = "memprof",
    profile = "//path/to/memprof:profile.afdo",
)

memprof_profile(
  name = "memprof_abs",
  absolute_path_profile = "/absolute/path/profile.afdo",
)

Bağımsız değişkenler

Özellikler
name

Ad; zorunlu

Bu hedef için benzersiz bir ad.
absolute_path_profile

Dize; varsayılan değer ""

MEMPROF profilinin mutlak yolu. Dosya yalnızca .profdata veya .zip uzantılı olabilir (zip dosyası bir memprof.profdata dosyası içermelidir).
profile

Etiket; varsayılan değer None'dir.

MEMPROF profilinin etiketi. Profilin, .profdata uzantısına (dizinlenmiş/sembolize edilmiş bir memprof profili için) veya memprof .profdata dosyası içeren bir zip dosyası için.zip uzantısına sahip olması gerekir. Etiket, fdo_absolute_path_profile kuralını da işaret edebilir.

propeller_optimize

Kural kaynağını görüntüleme 
propeller_optimize(name, compatible_with, deprecation, distribs, features, ld_profile, licenses, restricted_to, tags, target_compatible_with, testonly, visibility)

Çalışma alanındaki bir Propeller optimizasyon profilini temsil eder. Örnek:

propeller_optimize(
    name = "layout",
    cc_profile = "//path:cc_profile.txt",
    ld_profile = "//path:ld_profile.txt"
)

propeller_optimize(
    name = "layout_absolute",
    absolute_cc_profile = "/absolute/cc_profile.txt",
    absolute_ld_profile = "/absolute/ld_profile.txt"
)

Bağımsız değişkenler

Özellikler
name

Ad; zorunlu

Bu hedef için benzersiz bir ad.
ld_profile

Etiket; varsayılan değer None'dir.

Bağlantı işlemine iletilen profilin etiketi. Bu dosyanın .txt uzantısı olmalıdır.

cc_test

Kural kaynağını görüntüleme 
cc_test(name, deps, srcs, data, additional_linker_inputs, args, compatible_with, copts, defines, deprecation, distribs, env, env_inherit, exec_compatible_with, exec_properties, features, flaky, includes, licenses, link_extra_lib, linkopts, linkstatic, local, local_defines, malloc, nocopts, restricted_to, shard_count, size, stamp, tags, target_compatible_with, testonly, timeout, toolchains, visibility, win_def_file)

Bağımsız değişkenler

Özellikler
name

Ad; zorunlu

Bu hedef için benzersiz bir ad.
deps

Etiket listesi; varsayılan değer []'dir.

İkili hedefte bağlanacak diğer kitaplıkların listesi.

Bunlar cc_library veya objc_library hedef olabilir.
srcs

Etiket listesi; varsayılan değer []'dir.

Hedefi oluşturmak için işlenen C ve C++ dosyalarının listesi. Bunlar, oluşturulmamış (normal kaynak kodu) veya oluşturulmuş C/C++ kaynak ve başlık dosyalarıdır.

Tüm .cc, .c ve .cpp dosyaları derlenir. Bunlar oluşturulmuş dosyalar olabilir: Adlandırılmış bir dosya başka bir kuralın outs bölümündeyse bu kural otomatik olarak söz konusu diğer kurala bağlı olur.

.h dosyası derlenmez ancak bu kuraldaki kaynaklar tarafından dahil edilebilir. Hem .cc hem de .h dosyaları, bu srcs veya deps bağımsız değişkeninde listelenen herhangi bir kuralın hdrs bölümünde listelenen üstbilgileri doğrudan içerebilir.

Tüm #include dosyaları, bu kuralın srcs özelliğinde veya referans verilen cc_library()'lerin hdrs özelliğinde belirtilmelidir. Önerilen stil, bir kitaplıkla ilişkili başlıkların o kitaplığın hdrs özelliğinde, bu kuralın kaynaklarıyla ilişkili kalan başlıkların ise srcs özelliğinde listelenmesidir. Daha ayrıntılı açıklama için "Başlık dahil etme kontrolü" bölümüne bakın.

Bir kuralın adı srcs içinde yer alıyorsa bu kural otomatik olarak söz konusu kurala bağlıdır. Adlandırılmış kuralın outs C veya C++ kaynak dosyalarıysa bu kurala derlenir. Kitaplık dosyalarıysa bağlanır.

İzin verilen srcs dosya türleri:

  • C ve C++ kaynak dosyaları: .c, .cc, .cpp, .cxx, .c++, .C
  • C ve C++ başlık dosyaları: .h, .hh, .hpp, .hxx, .inc, .inl, .H
  • C ön işlemcili derleyici: .S
  • Arşiv: .a, .pic.a
  • "Her zaman bağla" kitaplığı: .lo, .pic.lo
  • Sürümlü veya sürümsüz paylaşılan kitaplık: .so, .so.version
  • Nesne dosyası: .o, .pic.o

...ve bu dosyaları oluşturan tüm kurallar. Farklı uzantılar, gcc kuralına uygun olarak farklı programlama dillerini gösterir.

additional_linker_inputs

Etiket listesi; varsayılan değer []'dir.

Bu dosyaları C++ bağlayıcı komutuna iletin.

Örneğin, derlenmiş Windows .res dosyaları, ikili hedefe yerleştirilmek üzere burada sağlanabilir.

copts

Dize listesi; varsayılan değer []'dır.

Bu seçenekleri C++ derleme komutuna ekleyin. "Değişken yap" yerine koyma ve Bourne kabuğu belirteçleştirme işlemine tabidir.

Bu özellikteki her dize, ikili hedef derlenmeden önce COPTS'ya belirtilen sırayla eklenir. İşaretler yalnızca bu hedefi derlerken geçerli olur, bağımlılıkları için geçerli olmaz. Bu nedenle, başka yerlerde bulunan başlık dosyaları konusunda dikkatli olun. Tüm yollar, mevcut pakete değil, çalışma alanına göre olmalıdır.

Paket, özelliği bildiriyorsa no_copts_tokenization, Bourne kabuğu belirteçleştirme yalnızca tek bir "Marka" değişkeninden oluşan dizeler için geçerlidir.

defines

Dize listesi; varsayılan değer []'dır.

Derleme satırına eklenecek tanımlar listesi. "Make" değişkeni değiştirme ve Bourne kabuğu belirteçleştirme işlemine tabidir. Tek bir Bourne kabuğu jetonundan oluşması gereken her dize, -D ile öneklenir ve bu hedefin derleme komut satırına ve buna bağlı olan her kurala eklenir. Bu işlem, geniş kapsamlı etkilere neden olabileceğinden çok dikkatli olun. Şüpheye düştüğünüzde, değerleri local_defines öğesine ekleyin.
includes

Dize listesi; varsayılan değer []'dır.

Derleme satırına eklenecek include dizinlerinin listesi.

"Değişken yap" yerine koyma işlemine tabidir. Her dizenin başına -isystem eklenir ve COPTS'ye eklenir. COPTS'tan farklı olarak, bu işaretler bu kural ve ona bağlı olan her kural için eklenir. (Not: bağlı olduğu kurallar değil!) Bu işlem, geniş kapsamlı etkilere neden olabileceğinden çok dikkatli olun. Şüpheye düştüğünüzde bunun yerine COPTS'a "-I" işaretleri ekleyin.

Üstbilgiler srcs veya hdrs'ye eklenmelidir. Aksi takdirde, derleme korumalı alanda yapıldığında (varsayılan) bağımlı kurallar tarafından kullanılamazlar.

Etiket; varsayılan değer "@bazel_tools//tools/cpp:link_extra_lib"'dir.

Ek kitaplıkların bağlanmasını kontrol edin.

Varsayılan olarak, C++ ikili dosyaları //tools/cpp:link_extra_lib ile bağlantılıdır ve bu da varsayılan olarak //tools/cpp:link_extra_libs etiket işaretine bağlıdır. Bu kitaplık, işaret ayarlanmadığı sürece varsayılan olarak boştur. Etiket işaretini ayarlamak, zayıf semboller için geçersiz kılmalar, paylaşılan kitaplık işlevleri için kesiciler veya özel çalışma zamanı kitaplıkları (malloc değiştirmeleri için malloc veya --custom_malloc tercih edilir) gibi isteğe bağlı bağımlılıkların bağlanmasına olanak tanır. Bu özelliği None olarak ayarlamak bu davranışı devre dışı bırakır.

linkopts

Dize listesi; varsayılan değer []'dır.

Bu işaretleri C++ bağlayıcı komutuna ekleyin. "Marka" değişkeni yerine koyma, Bourne shell belirteçleştirme ve etiket genişletme işlemlerine tabidir. Bu özellikteki her dize, ikili hedef bağlanmadan önce LINKOPTS öğesine eklenir.

Bu listede $ veya - ile başlamayan her öğenin deps içindeki bir hedefin etiketi olduğu varsayılır. Bu hedef tarafından oluşturulan dosyaların listesi bağlayıcı seçeneklerine eklenir. Etiket geçersizse veya deps içinde beyan edilmemişse hata bildirilir.

linkstatic

Boole değeri; varsayılan değer False'dır.

cc_binary ve cc_test için: İkiliyi statik modda bağlayın. cc_library.linkstatic için: Aşağıya bakın.

Bu seçenek varsayılan olarak cc_binary için etkin, diğerleri için devre dışıdır.

Etkinleştirilirse ve bu bir ikili veya test ise bu seçenek, mümkün olduğunda kullanıcı kitaplıkları için .so yerine .a'nın bağlanması gerektiğini derleme aracına bildirir. Bazı sistem kitaplıkları ve statik kitaplığı olmayan kitaplıklar dinamik olarak bağlanmaya devam edebilir. Bu nedenle, ortaya çıkan yürütülebilir dosya yine dinamik olarak bağlanır ve bu nedenle yalnızca çoğunlukla statiktir.

Bir yürütülebilir dosyayı bağlamanın üç farklı yolu vardır:

  • Her şeyin statik olarak bağlandığı fully_static_link özelliğiyle STATIC; ör. "gcc -static foo.o libbar.a libbaz.a -lm".
    Bu mod, features özelliğinde fully_static_link belirtilerek etkinleştirilir.
  • STATIC: Tüm kullanıcı kitaplıklarının statik olarak bağlandığı (statik sürüm varsa) ancak sistem kitaplıklarının (C/C++ çalışma zamanı kitaplıkları hariç) dinamik olarak bağlandığı moddur. Örneğin, "gcc foo.o libfoo.a libbaz.a -lm".
    Bu mod, linkstatic=True belirtilerek etkinleştirilir.
  • DYNAMIC: Tüm kitaplıkların dinamik olarak bağlandığı (dinamik bir sürüm varsa) moddur. Örneğin, "gcc foo.o libfoo.so libbaz.so -lm".
    Bu mod, linkstatic=False belirtilerek etkinleştirilir.

linkstatic özelliği, cc_library() kuralında kullanıldığında farklı bir anlam taşır. Bir C++ kitaplığı için linkstatic=True, yalnızca statik bağlantıya izin verildiğini gösterir. Bu nedenle .so oluşturulmaz. linkstatic=False, statik kitaplıkların oluşturulmasını engellemez. Bu özellik, dinamik kitaplıkların oluşturulmasını kontrol etmek için tasarlanmıştır.

linkstatic=False ise derleme aracı, *.runfiles alanındaki bağımlı paylaşılan kitaplıklar için sembolik bağlantılar oluşturur.

local_defines

Dize listesi; varsayılan değer []'dır.

Derleme satırına eklenecek tanımlar listesi. "Make" değişkeni değiştirme ve Bourne kabuğu belirteçleştirme işlemine tabidir. Tek bir Bourne kabuğu jetonundan oluşması gereken her dizeye -D öneki eklenir ve bu hedef için derleme komut satırına eklenir ancak bağımlılarına eklenmez.
malloc

Etiket; varsayılan değer "@bazel_tools//tools/cpp:malloc"'dir.

malloc'a yönelik varsayılan bağımlılığı geçersiz kılın.

Varsayılan olarak C++ ikilileri //tools/cpp:malloc ile bağlantılıdır. Bu, boş bir kitaplık olduğundan ikili, libc malloc'u kullanır. Bu etiket, cc_library ile ilgili olmalıdır. Derleme, C++ dışındaki bir kural içinse bu seçeneğin etkisi olmaz. linkshared=True belirtilirse bu özelliğin değeri yoksayılır.

nocopts

Dize; varsayılan değer ""

Eşleşen seçenekleri C++ derleme komutundan kaldırın. "Marka" değişkeni yerine koyma işlemine tabidir. Bu özelliğin değeri normal ifade olarak yorumlanır. Bu normal ifadeyle eşleşen tüm mevcut COPTS (kuralın copts özelliğinde açıkça belirtilen değerler dahil) bu kuralın derlenmesi amacıyla COPTS'dan kaldırılır. Bu özelliğe nadiren ihtiyaç duyulur.
stamp

Tam sayı; varsayılan değer 0

Derleme bilgilerinin ikili dosyaya kodlanıp kodlanmayacağı. Olası değerler:
  • stamp = 1: Derleme bilgileri, --nostamp derlemelerinde bile her zaman ikiliye damgalanır. Bu ayardan kaçınılmalıdır. Çünkü bu ayar, ikili dosya ve buna bağlı tüm aşağı akış işlemleri için uzaktan önbelleğe almayı devre dışı bırakabilir.
  • stamp = 0: Derleme bilgilerini her zaman sabit değerlerle değiştirin. Bu, iyi bir derleme sonucu önbelleğe alma sağlar.
  • stamp = -1: Derleme bilgilerinin yerleştirilmesi, --[no]stamp işaretiyle kontrol edilir.

Damgalı ikili dosyalar, bağımlılıkları değişmediği sürece yeniden oluşturulmaz.
win_def_file

Etiket; varsayılan değer None'dir.

Bağlayıcıya iletilecek Windows DEF dosyası.

Bu özellik yalnızca hedef platform Windows olduğunda kullanılmalıdır. Paylaşılan bir kitaplık bağlanırken sembolleri dışa aktarmak için kullanılabilir.

cc_toolchain

Kural kaynağını görüntüleme 
cc_toolchain(name, all_files, ar_files, as_files, compatible_with, compiler_files, compiler_files_without_includes, coverage_files, deprecation, distribs, dwp_files, dynamic_runtime_lib, exec_transition_for_inputs, features, libc_top, licenses, linker_files, module_map, objcopy_files, restricted_to, static_runtime_lib, strip_files, supports_header_parsing, supports_param_files, tags, target_compatible_with, testonly, toolchain_config, toolchain_identifier, visibility)

Bir C++ araç zincirini temsil eder.

Bu kural şunlardan sorumludur:

  • C++ işlemlerinin çalışması için gereken tüm yapıları toplar. Bu işlem, all_files, compiler_files, linker_files veya _files ile biten diğer özellikler gibi özellikler kullanılarak yapılır. Bunlar, genellikle gerekli tüm dosyaları içeren dosya grubu glob'larıdır.
  • C++ işlemleri için doğru komut satırları oluşturma. Bu işlem, CcToolchainConfigInfo sağlayıcısı kullanılarak yapılır (ayrıntılar aşağıda verilmiştir).

C++ araç zincirini yapılandırmak için toolchain_config özelliğini kullanın. Ayrıntılı C++ araç zinciri yapılandırması ve araç zinciri seçimi dokümanları için bu sayfaya da göz atın.

bazel build //... çağrıldığında araç zincirlerinin gereksiz yere oluşturulup yapılandırılmasını önlemek için tags = ["manual"] kullanın.

Bağımsız değişkenler

Özellikler
name

Ad; zorunlu

Bu hedef için benzersiz bir ad.
all_files

Etiket: zorunlu

Tüm cc_toolchain yapıları koleksiyonu. Bu yapılar, tüm rules_cc ile ilgili işlemlere giriş olarak eklenir (aşağıdaki özelliklerden daha kesin yapılar kümeleri kullanan işlemler hariç). Bazel, all_files'nın diğer tüm yapı sağlayan özelliklerin üst kümesi olduğunu varsayar (ör. linkstamp derlemesi hem derleme hem de bağlantı dosyaları gerektirir, bu nedenle all_files alır).

cc_toolchain.files, C++ araç zincirini kullanan tüm Starlark kuralları tarafından kullanılan bu öğeleri içerir.
ar_files

Etiket; varsayılan değer None'dir.

Arşivleme işlemleri için gereken tüm cc_toolchain yapıtlarının toplanması.
as_files

Etiket; varsayılan değer None'dir.

Derleme işlemleri için gereken tüm cc_toolchain yapılarının toplanması.
compiler_files

Etiket: zorunlu

Derleme işlemleri için gereken tüm cc_toolchain yapılarının toplanması.
compiler_files_without_includes

Etiket; varsayılan değer None'dir.

Giriş keşfinin desteklendiği durumlarda (şu anda yalnızca Google) derleme işlemleri için gereken tüm cc_toolchain yapılarının toplanması.
coverage_files

Etiket; varsayılan değer None'dir.

Kapsam işlemleri için gereken tüm cc_toolchain yapılarının toplanması. Belirtilmezse all_files kullanılır.
dwp_files

Etiket: zorunlu

dwp işlemleri için gereken tüm cc_toolchain yapılarının koleksiyonu.
dynamic_runtime_lib

Etiket; varsayılan değer None'dir.

C++ çalışma zamanı kitaplığı için dinamik kitaplık yapısı (ör. libstdc++.so).

Bu, "static_link_cpp_runtimes" özelliği etkinleştirildiğinde ve bağımlılıkları dinamik olarak bağladığımızda kullanılır.
exec_transition_for_inputs

Boole değeri; varsayılan değer True'dır.

Yürütme platformu için cc_toolchain'e tüm dosya girişlerini oluşturmak üzere Doğru olarak ayarlayın. Bu durumda geçişsiz (yani varsayılan olarak hedef platform) olmaz.
libc_top

Etiket; varsayılan değer None'dir.

libc için derleme/bağlama işlemlerine giriş olarak iletilen bir eser koleksiyonu.
linker_files

Etiket: zorunlu

Bağlantı işlemleri için gereken tüm cc_toolchain yapılarının toplanması.
module_map

Etiket; varsayılan değer None'dir.

Modüler derlemelerde kullanılacak modül haritası yapısı.
objcopy_files

Etiket: zorunlu

objcopy işlemleri için gereken tüm cc_toolchain yapılarının toplanması.
static_runtime_lib

Etiket; varsayılan değer None'dir.

C++ çalışma zamanı kitaplığı için statik kitaplık yapısı (ör. libstdc++.a).

Bu, "static_link_cpp_runtimes" özelliği etkinleştirildiğinde ve bağımlılıkları statik olarak bağladığımızda kullanılır.
strip_files

Etiket: zorunlu

Şerit işlemleri için gereken tüm cc_toolchain yapılarının toplanması.
supports_header_parsing

Boole değeri; varsayılan değer False'dır.

cc_toolchain, üstbilgi ayrıştırma işlemlerini desteklediğinde True olarak ayarlanır.
supports_param_files

Boole değeri; varsayılan değer True'dır.

cc_toolchain, bağlama işlemleri için param dosyalarının kullanılmasını desteklediğinde True olarak ayarlanır.
toolchain_config

Etiket: zorunlu

cc_toolchain_config_info sağlayan kuralın etiketi.
toolchain_identifier

Dize; yapılandırılamaz; varsayılan değer ""

Bu cc_toolchain'i ilgili crosstool_config.toolchain ile eşleştirmek için kullanılan tanımlayıcı.

#5380 numaralı sorun düzeltilene kadar cc_toolchain ile CROSSTOOL.toolchain'ü ilişkilendirmenin önerilen yolu budur. Bu özellik, toolchain_config özelliğiyle (#5380) değiştirilecek.

cc_toolchain_suite

Kural kaynağını görüntüleme 
cc_toolchain_suite(name, compatible_with, deprecation, distribs, features, licenses, restricted_to, tags, target_compatible_with, testonly, toolchains, visibility)

C++ araç zincirleri koleksiyonunu temsil eder.

Bu kural şunlardan sorumludur:

  • İlgili tüm C++ araç zincirlerini toplama
  • --cpu ve --compiler seçeneklerine bağlı olarak bir araç zinciri seçme Bazel'e iletildi.

Ayrıntılı C++ araç zinciri yapılandırması ve araç zinciri seçimi dokümanları için bu sayfaya da göz atın.

Bağımsız değişkenler

Özellikler
name

Ad; zorunlu

Bu hedef için benzersiz bir ad.
toolchains

Dizeleri etiketlerle eşleyen sözlük; yapılandırılamaz; zorunlu

"<cpu>" veya "<cpu>|<compiler>" dizelerinden cc_toolchain etiketine giden bir harita. Yalnızca --cpu Bazel'e iletildiğinde "<cpu>", hem --cpu hem de --compiler Bazel'e iletildiğinde ise "<cpu>|<compiler>" kullanılır. Örnek: 

          cc_toolchain_suite(
            name = "toolchain",
            toolchains = {
              "piii|gcc": ":my_cc_toolchain_for_piii_using_gcc",
              "piii": ":my_cc_toolchain_for_piii_using_default_compiler",
            },
          )