Bu sayfada, C++ kurallarıyla çeşitli düzeylerde nasıl entegrasyon yapılacağı açıklanmaktadır.
C++ araç zincirine erişme
C++ kurallarının platformlara ve araç zincirlerine devam eden taşınması nedeniyle, @bazel_tools//tools/cpp:toolchain_utils.bzl adresinde bulunan yardımcı işlevi kullanmanız gerekir. Bu işlev, hem araç zincirleri devre dışıyken hem de etkinken çalışır. Kuralınızda bir C++ araç zincirine bağlı kalmak için _cc_toolchain
adlı bir Label
özelliği ekleyin ve bunu @bazel_tools//tools/cpp:current_cc_toolchain
öğesine (şu anda seçili C++ araç zincirini işaret eden cc_toolchain_alias
kuralının bir örneği) işaret edin.
Ardından, kural uygulama işleminde CcToolchainInfo
değerini almak için find_cpp_toolchain(ctx)
değerini kullanın.
Çalışan tam bir örneği rules_cc örneklerinde bulabilirsiniz.
C++ araç zincirini kullanarak komut satırı ve ortam değişkenleri oluşturma
Tipik olarak, C++ kurallarıyla aynı komut satırı işaretlerine sahip olmak için C++ araç zinciriyle entegrasyon sağlarsınız, ancak C++ işlemlerini doğrudan kullanmadan kullanırsınız. Bunun nedeni, kendi eylemlerimizi yazarken C++ araç zinciriyle tutarlı şekilde davranmalarıdır. Örneğin, C++ komut satırı işaretlerini perde arkasında C++ derleyiciyi çağıran bir araca iletmek gibi.
C++ kuralları, özellik yapılandırmasına dayalı komut satırları oluşturmak için özel bir yöntem kullanır. Komut satırı oluşturmak için aşağıdakilere ihtiyacınız vardır:
features
veaction_configs
: BunlarCcToolchainConfigInfo
kaynağından gelir veCcToolchainInfo
içine yerleştirilir.FeatureConfiguration
: cc_common.configure_features tarafından döndürülür.- cc araç zinciri yapılandırma değişkenleri: cc_common.create_compile_variables veya cc_common.create_link_variables tarafından döndürülür.
compiler_executable gibi araca özgü alıcılara hâlâ ihtiyaç vardır.
Araca özgü alıcı yöntemleri zaman içinde kaldırılacağından bu yöntemler yerine get_tool_for_action
yöntemini tercih edin.
Çalışan tam bir örneği rules_cc örneklerinde bulabilirsiniz.
C++ kurallarına bağlı olan ve/veya C++ kurallarının bağlı olabileceği Starlark kurallarını uygulama
Çoğu C++ kuralı, CompilationContext
ve LinkingContext
içeren bir sağlayıcı olan CcInfo
sağlar.
Bu kaynaklar aracılığıyla, tüm geçişli üstbilgi veya bağlanacak kütüphaneler gibi bilgilere erişilebilir. CcInfo
ve CcToolchainInfo
özel Starlark kuralları, ihtiyaç duydukları tüm bilgileri alabilmelidir.
Özel bir Starlark kuralı CcInfo
değerini sağlarsa bu, C++ kurallarının ona da bağımlı olabileceğine dair bir sinyaldir. Ancak dikkatli olun. Yalnızca CcInfo
değerini grafik üzerinden, daha sonra bu değeri kullanan ikili kurala yaymanız gerekiyorsa CcInfo
değerini farklı bir sağlayıcıya sarın. Örneğin, java_library
kuralı, yerel bağımlılıkları java_binary
öğesine yaymak isterse doğrudan CcInfo
sağlamamalıdır (java_library
öğesine bağlı olarak cc_binary
bir anlam ifade etmez) ve sarmalamalıdır (örneğin, JavaCcInfo
).
Çalışan tam bir örneği rules_cc örneklerinde bulabilirsiniz.
C++ kurallarının mantığını ve işlemlerini yeniden kullanma
Henüz kararlı değil; API kararlı hale geldiğinde bu bölüm güncellenecektir. Güncel bilgiler için #4570 etiketini takip edin.