Yaygın tanımlar

7.3 · 7.2 · 7.1 · 7.0 · 6.5

Bu bölümde, birçok işlev veya derleme kuralında ortak olan çeşitli terimler ve kavramlar tanımlanmaktadır.

İçindekiler

Bourne kabuk belirteçleme

Bazı kuralların belirli dize özellikleri, Bourne kabuğunun dize bölme kurallarına göre birden çok kelimeye bölünür: Tek tırnak içine alınmamış boşluklar ayrı kelimeleri sınırlandırır ve dize bölme işlemini önlemek için tek ve çift tırnak karakterleri ile ters eğik çizgiler kullanılır.

Bu tokenizasyona tabi olan özellikler, bu belgedeki tanımlarında bu şekilde açıkça belirtilmiştir.

"Make" değişkeni genişletmeye ve Bourne kabuğu dilimlemeye tabi olan özellikler genellikle derleyicilere ve diğer araçlara keyfi seçenekler iletmek için kullanılır. Bu tür özelliklere örnek olarak cc_library.copts ve java_library.javacopts verilebilir. Bu ikameler birlikte, tek bir dize değişkeninin yapılandırmaya özgü bir seçenek kelimeleri listesine genişlemesine olanak tanır.

Etiket genişletme

Çok az sayıda kuralın bazı dize özellikleri etiket genişletmesine tabidir: Bu dizeler, alt dize olarak geçerli bir etiket (ör. //mypkg:target) içeriyorsa ve bu etiket geçerli kuralın tanımlanmış bir ön koşuluysa hedef //mypkg:target ile temsil edilen dosyanın yol adı olarak genişletilir.

Örnek özellikler arasında genrule.cmd ve cc_binary.linkopts yer alır. Ayrıntılar, her durumda önemli ölçüde değişiklik gösterebilir. Örneğin, göreli etiketlerin genişletilip genişletilmeyeceği, birden fazla dosyaya genişleyen etiketlerin nasıl ele alınacağı vb. konularla ilgili ayrıntılar için kural özelliği dokümanlarına bakın.

Çoğu derleme kuralı tarafından tanımlanan tipik özellikler

Bu bölümde, birçok derleme kuralı tarafından tanımlanan (hepsi değil) özellikler açıklanmaktadır.

Özellik Açıklama
data

Etiket listesi; varsayılan []

Bu kuralın çalışma zamanında ihtiyaç duyduğu dosyalar. Dosya veya kural hedeflerini listeleyebilir. Genellikle tüm hedeflere izin verir.

data özelliğindeki hedeflerin varsayılan çıkışları ve çalıştırma dosyaları, bu hedefin çıktısı olan veya bu hedefe çalışma zamanı bağımlılığı olan yürütülebilir tüm yürütülebilir öğelerin *.runfiles alanında görünmelidir. Bu hedefin srcs yürütüldüğünde kullanılan veri dosyaları veya ikili dosyalar da buna dahildir. Veri dosyalarına bağımlı olma ve bu dosyaları kullanma hakkında daha fazla bilgi için veri bağımlılıkları bölümüne bakın.

Yeni kurallar, çalışma zamanında diğer girişleri kullanabilecek girişleri işlerse bir data özelliği tanımlamalıdır. Kuralların uygulama işlevleri, herhangi bir data özelliğinin çıkışlarından ve çalıştırma dosyalarından, ayrıca kaynak kod veya çalışma zamanı bağımlılıkları sağlayan herhangi bir bağımlılık özelliğinin çalıştırma dosyalarından hedefin çalıştırma dosyalarını doldurmalıdır.

deps

Etiket listesi; varsayılan []

Bu hedefin bağımlılıkları. Genellikle yalnızca kural hedefleri listelenir. (Bazı kurallar, dosyaların doğrudan deps'te listelenmesine izin verse de mümkün olduğunca bu işlemden kaçınılmalıdır.)

Dile özgü kurallar, listelenen hedefleri genellikle belirli sağlayıcılara sahip olanlarla sınırlar.

Bir hedefin deps kullanarak başka bir hedefe bağımlı olmasıyla ilgili tam anlam, kural türüne özeldir ve kurala özel dokümanlar daha ayrıntılı bilgi içerir. Kaynak kodu işleyen kurallar için deps, genellikle srcs içindeki kodun kullandığı kod bağımlılıklarını belirtir.

deps bağımlılığı genellikle bir modülün aynı programlama dilinde yazılmış ve ayrı olarak derlenen başka bir modülde tanımlanan sembolleri kullanabilmesi için kullanılır. Birçok durumda dil arası bağımlılıklara da izin verilir: Örneğin, bir java_library hedefi, cc_library hedefindeki C++ koduna bağlı olabilir. Bu durumda, deps özelliğinde cc_library hedefi listelenir. Daha fazla bilgi için bağımlılıkların tanımına bakın.

licenses

Dize listesi; yapılandırılamaz; varsayılan değer ["none"]

Bu hedef için kullanılacak lisans türü dizelerinin listesi. Bu, Bazel'in artık kullanmadığı, desteği sonlandırılmış bir lisanslama API'sinin bir parçasıdır. Bunu kullanmayın.

srcs

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

Bu kural tarafından işlenen veya dahil edilen dosyalar. Genellikle dosyalar doğrudan listelenir ancak varsayılan çıkışlarını dahil etmek için kural hedefleri (filegroup veya genrule gibi) listelenebilir.

Dile özgü kurallar, genellikle listelenen dosyaların belirli dosya uzantılarına sahip olmasını gerektirir.

Tüm derleme kurallarında ortak özellikler

Bu bölümde, tüm derleme kurallarına dolaylı olarak eklenen özellikler açıklanmaktadır.

Özellik Açıklama
compatible_with

Etiketler listesi; yapılandırılamaz; varsayılan değer []

Varsayılan olarak desteklenen ortamlara ek olarak bu hedefin oluşturulabileceği ortamların listesi.

Bu, kullanıcıların hangi hedeflerin birbirine bağımlı olabileceğini ve hangilerine bağlı olamayacağını beyan etmesini sağlayan Bazel'ın kısıtlama sisteminin bir parçasıdır. Örneğin, harici olarak dağıtılabilir ikili programlar şirket gizli kodu içeren kitaplıklara bağlı olmamalıdır. Ayrıntılar için ConstraintSemantics'i inceleyin.

deprecation

Dize; yapılandırılabilir değil; varsayılan değer None

Bu hedefle ilişkili açıklayıcı bir uyarı mesajı. Bu genellikle bir hedefin eskidiğini veya başka bir kural tarafından yerini aldığını, bir pakete özel olduğunu ya da herhangi bir nedenle zararlı olduğunu bildirmek için kullanılır. İletiden kaçınmak için hangi değişikliklerin yapılması gerektiğini kolayca bulabilmesi için bir referans (web sayfası, hata numarası veya örnek taşıma CL'leri gibi) eklemek iyi bir fikirdir. Bunun yerine kullanabileceğiniz yeni bir hedef varsa eski hedefin tüm kullanıcılarını taşımak iyi bir fikirdir.

Bu özelliğin, derleme şekli üzerinde bir etkisi yoktur ancak derleme aracının teşhis çıktısını etkileyebilir. Derleme aracı, deprecation özelliğine sahip bir kural başka bir paketteki bir hedefe bağlı olduğunda bir uyarı verir.

Paket içi bağımlılıklar bu uyarıdan muaftır. Böylece, örneğin, desteği sonlandırılmış bir kuralın testleri oluşturulduğunda bir uyarıyla karşılaşmazsınız.

Desteği sonlandırılan bir hedef, desteği sonlandırılan başka bir hedefe bağlıysa uyarı mesajı gönderilmez.

Kullanıcılar artık uygulamayı kullanmayı bıraktıktan sonra hedef kaldırılabilir.

distribs

Dize listesi; yapılandırılamaz; varsayılan değer []

Bu hedef için kullanılacak dağıtım yöntemi dizelerinin listesi. Bu, Bazel'in artık kullanmadığı, desteği sonlandırılmış bir lisanslama API'sinin bir parçasıdır. Bunu kullanmayın.

exec_compatible_with

Etiket listesi; yapılandırılabilir olmayan; varsayılan []

Bu hedef için yürütme platformunda mevcut olması gereken constraint_values listesi. Bu, kural türü tarafından önceden ayarlanmış kısıtlamalara ek olarak sunulur. Kısıtlamalar, mevcut yürütme platformlarının listesini kısıtlamak için kullanılır. Daha fazla bilgi için araç zinciri çözümlemesinin açıklamasına bakın.

exec_properties

Dize sözlüğü; varsayılan değer {}'tir.

Bu hedef için seçilen bir platformun exec_properties özelliğine eklenecek dize dizini. Platform kuralının exec_properties. bölümünü inceleyin.

Bir anahtar hem platform hem de hedef düzeyindeki mülklerde mevcutsa değer hedeften alınır.

features

Özellik dizelerinin listesi; varsayılan olarak []

Özellik, bir hedefte etkinleştirilebilen veya devre dışı bırakılabilen dize etiketidir. Bir özelliğin anlamı kuralın kendisine bağlıdır.

Bu features özelliği, paket düzeyindeki features özelliğiyle birleştirilir. Örneğin, ["a", "b"] özellikleri paket düzeyinde etkinse ve bir hedefin features özelliği ["-a", "c"] içeriyorsa kural için etkinleştirilen özellikler "b" ve "c" olur. Örneğe bakın.

restricted_to

Etiket listesi; yapılandırılabilir olmayan; varsayılan []

Varsayılan olarak desteklenen ortamlar yerine, bu hedefin oluşturulabileceği ortamların listesi.

Bu, Bazel'in kısıtlama sisteminin bir parçasıdır. Ayrıntılar için compatible_with sayfasını inceleyin.

tags

Dize listesi; yapılandırılabilir olmayan; varsayılan değer []

Etiketler herhangi bir kuralda kullanılabilir. Testteki etiketler ve test_suite kuralları, testleri kategorize etmek için yararlıdır. Test dışı hedeflerdeki etiketler, genrule ve Starlark eylemlerinin korumalı alana alınmış yürütülmesini kontrol etmek ve gerçek kişiler ve/veya harici araçlar tarafından ayrıştırmak için kullanılır.

Bazel, herhangi bir test veya genrule hedefinin tags özelliğinde ya da herhangi bir Starlark işlemi için execution_requirements anahtarında aşağıdaki anahtar kelimeleri bulursa korumalı alan kodunun davranışını değiştirir.

  • no-sandbox anahtar kelimesi, ilgili işlemle veya testin hiçbir zaman korumalı alana alınmamasıyla sonuçlanır; yine de önbelleğe alınabilir veya uzaktan çalıştırılabilir. Bunlardan birini veya ikisini birden önlemek için no-cache veya no-remote kullanın.
  • no-cache anahtar kelimesi, işlemin veya testin hiçbir zaman önbelleğe alınmasına (uzaktan veya yerel olarak) neden oluyor
  • no-remote-cache anahtar kelimesi, işlemin veya testin hiçbir zaman uzaktan önbelleğe alınmasına neden olmaz (ancak yerel olarak önbelleğe alınabilir veya uzaktan yürütülebilir). Not: Bu etiketin amacı doğrultusunda, disk önbelleği yerel önbellek olarak kabul edilirken http ve gRPC önbellekleri uzak önbellek olarak kabul edilir. Yerel disk önbelleği ve uzak önbelleğin bir kombinasyonu (birleştirilmiş önbellek) kullanılıyorsa bu, uzak önbellek olarak değerlendirilir ve --incompatible_remote_results_ignore_disk ayarlanmadığı sürece tamamen devre dışı bırakılır. Bu durumda yerel bileşenler kullanılır.
  • no-remote-exec anahtar kelimesi, işlemin veya testin hiçbir zaman uzaktan yürütülmemesine neden olur (ancak uzaktan önbelleğe alınabilir).
  • no-remote anahtar kelimesi, işlemin veya testin uzaktan yürütülmesini ya da uzaktan önbelleğe alınmasını engeller. Bu, hem no-remote-cache hem de no-remote-exec kullanmaya eşdeğerdir.
  • no-remote-cache-upload anahtar kelimesi, bir yumurtanın uzaktan önbelleğe alma işleminin bir kısmını yüklemenin bir kısmını devre dışı bırakır. uzaktan yürütmeyi devre dışı bırakmaz.
  • local anahtar kelimesi, işlemin veya testin uzaktan önbelleğe alınmasını, uzaktan yürütülmesini ya da korumalı alanda çalıştırılmasını engeller. Kuralların local = True özelliğiyle işaretlenmesi, kuralın genrules ve testler için aynı etkiye sahiptir.
  • requires-network anahtar kelimesi, korumalı alan içinden harici ağa erişime izin verir. Bu etiket yalnızca korumalı alan etkinleştirilmişse etkili olur.
  • block-network anahtar kelimesi, korumalı alan içinden harici ağa erişimi engeller. Bu durumda yalnızca localhost ile iletişime izin verilir. Bu etiketin etkisi yalnızca korumalı alan etkinleştirilirse etkilidir.
  • requires-fakeroot, testi veya işlemi uid ve gid 0 (yani kök kullanıcı) olarak çalıştırır. Bu özellik yalnızca Linux'ta desteklenir. Bu etiket, --sandbox_fake_username komut satırı seçeneğine göre önceliklidir.

Testlerdeki etiketler, genellikle hata ayıklama ve yayınlama sürecinizde testin rolüne ek açıklama eklemek için kullanılır. Etiketler genellikle, herhangi bir çalışma zamanı ek açıklaması özelliğinin bulunmadığı C++ ve Python testleri için yararlıdır. Etiketlerin ve boyut öğelerinin kullanılması, test paketlerinin kod tabanı kontrol politikasına göre derlenmesinde esneklik sağlar.

Bazel, test kuralının tags özelliğinde aşağıdaki anahtar kelimeleri bulursa test çalıştırma davranışını değiştirir:

  • exclusive, testi "özel" modda çalıştırılmaya zorlayarak aynı anda başka testlerin çalıştırılmamasını sağlar. Bu tür testler, tüm derleme etkinliği ve özel olmayan testler tamamlandıktan sonra seri olarak yürütülür. Bazel'in uzaktaki bir makinede çalıştırılan öğeler üzerinde kontrolü olmadığından bu tür testler için uzaktan yürütme devre dışı bırakılır.
  • exclusive-if-local, yerel olarak yürütülürse testi "özel" modda çalıştırılmaya zorlar, ancak uzaktan yürütülürse testi paralel olarak çalıştırır.
  • manual anahtar kelimesi; build, test ve coverage komutları için derlenecek/çalıştırılacak üst düzey hedef grubu hesaplanırken testi açıkça belirtmeyen hedef kalıbı joker karakterlerinin (..., :*, :all vb.) ve test_suite kurallarının genişletilmesinin önüne geçer. query komutu dahil olmak üzere diğer bağlamlarda hedef joker karakteri veya test paketi genişletmesini etkilemez. manual değerinin, bir hedefin sürekli derleme/test sistemleri tarafından otomatik olarak derlenmemesi/çalıştırılmaması gerektiği anlamına gelmediğini unutmayın. Örneğin, bir hedefin belirli Bazel işaretleri gerektirdiği ancak yine de düzgün yapılandırılmış ön gönderimlere veya sürekli test çalıştırmalarına dahil edildiğinden bazel test ... etiketinden hariç tutulması istenebilir.
  • external anahtar kelimesi, testin koşulsuz olarak (--cache_test_results değerinden bağımsız olarak) yürütülmesini zorunlu kılar.
Test hedeflerine eklenen etiketlerle ilgili daha fazla kural için Test Ansiklopedisi'ndeki Etiket Kuralları bölümünü inceleyin.
target_compatible_with

Etiket listesi; varsayılan []

Bu hedefin uyumlu olarak kabul edilmesi için hedef platformda bulunması gereken constraint_value'lerin listesi. Bu, kural türü tarafından önceden ayarlanmış tüm kısıtlamalara ek olarak geçerlidir. Hedef platform, listelenen tüm kısıtlamaları karşılamıyorsa hedef uyumsuz kabul edilir. Hedef kalıbı genişletildiğinde (ör. //..., :all) uyumsuz hedefler derleme ve test için atlanır. Komut satırında açıkça belirtildiğinde uyumsuz hedefler Bazel'in hata yazdırmasına ve derleme veya testin başarısız olmasına neden olur.

Uyumsuz hedeflere geçişli olarak bağlı olan hedeflerin kendisi de uyumsuz olarak kabul edilir. Ayrıca derleme ve test için atlanır.

Boş liste (varsayılan değerdir), hedefin tüm platformlarla uyumlu olduğunu gösterir.

Workspace Kuralları dışındaki tüm kurallar bu özelliği destekler. Bu özellik bazı kurallar için etkili değildir. Örneğin, cc_toolchain için target_compatible_with belirtmek yararlı değildir.

Uyumlu olmayan hedef atlama hakkında daha fazla bilgi için Platformlar sayfasına bakın.

testonly

Boole; yapılandırılamaz; test ve test grubu hedefleri hariç varsayılan değer False

True ise yalnızca test amaçlı hedefler (testler gibi) bu hedefe bağlı olabilir.

Benzer şekilde, testonly olmayan bir kuralın testonly olan hiçbir kurala bağlı olmasına izin verilmez.

Testler (*_test kuralları) ve test paketleri (test_suite kuralları) varsayılan olarak testonly değerine sahiptir.

Bu özelliğin amacı, hedefin üretime sunulan ikili dosyalarda bulunmaması gerektiğidir.

testonly, çalışma zamanında değil derleme zamanında uygulanır ve bağımlılık ağacında viral olarak yayılır. Bu nedenle, testonly dikkatli bir şekilde uygulanmalıdır. Örneğin, birim testleri için yararlı olan saplama ve sahte öğeler, üretime yayınlanacak aynı ikili programları içeren entegrasyon testleri için de yararlı olabilir ve bu nedenle muhtemelen yalnızca test olarak işaretlenmemelidir. Buna karşılık, normal davranışı koşulsuz olarak geçersiz kıldığı için bağlantı oluşturmak bile tehlikeli olan kurallar kesinlikle testonly olarak işaretlenmelidir.

toolchains

Etiket listesi; yapılandırılabilir olmayan; varsayılan []

Bu hedefin Değişken oluştur işlevine erişmesine izin verilen hedef grubu. Bu hedefler, TemplateVariableInfo sağlayan kural örnekleri veya Bazel'e yerleştirilmiş araç zinciri türleri için özel hedeflerdir. Bunlardan bazıları:

  • @bazel_tools//tools/cpp:current_cc_toolchain
  • @bazel_tools//tools/jdk:current_java_runtime

Bunun, platforma bağlı yapılandırma için kural uygulamaları tarafından kullanılan araç zinciri çözünürlüğü kavramından farklı olduğunu unutmayın. Bir hedefin hangi belirli cc_toolchain veya java_toolchain'ı kullanacağını belirlemek için bu özelliği kullanamazsınız.

visibility

Etiket listesi; yapılandırılmamış; belirtilmişse varsayılan olarak paket tarafından default_visibility, aksi takdirde "//visibility:private" kullanılır

Bir hedefteki visibility özelliği, hedefin diğer paketlerde kullanılıp kullanılamayacağını kontrol eder. Görünürlük ile ilgili dokümanları inceleyin.

Tüm test kurallarında ortak özellikler (*_test)

Bu bölümde, tüm test kuralları için ortak olan özellikler açıklanmaktadır.

Özellik Açıklama
args

Dize listesi; $(location) ve "Değişken oluştur" yerine koyma işlemine ve Bourne kabuğu jetonuna tabidir; varsayılan değer []'dir.

Bazel, bazel test ile çalıştırıldığında hedefe ilettiği komut satırı bağımsız değişkenleri.

Bu bağımsız değişkenler, bazel test komut satırında belirtilen herhangi bir --test_arg değerinden önce iletilir.

env

Dize dizini; değerler $(location) ve "Değişken oluştur" yerine koyma işlemine tabidir; varsayılan değer []'tır.

Test, bazel test tarafından yürütüldüğünde ayarlanacak ek ortam değişkenlerini belirtir.

Bu özellik yalnızca cc_test, py_test ve sh_test gibi yerel kurallar için geçerlidir. Starlark tarafından tanımlanan test kuralları için geçerli değildir. Kendi Starlark kurallarınız için "env" özelliği ekleyebilir ve TestEnvironment Sağlayıcısını doldurmak için kullanabilirsiniz.

env_inherit

Dize listesi; varsayılan değer: []

Test, bazel test tarafından yürütüldüğünde harici ortamdan devralınacak ek ortam değişkenlerini belirtir.

Bu özellik yalnızca cc_test, py_test ve sh_test gibi yerel kurallar için geçerlidir. Starlark tarafından tanımlanan test kuralları için geçerli değildir.

size

Dize "enormous", "large", "medium" veya "small"; yapılandırılabilir değil; varsayılan değer "medium"

Bir test hedefinin "ağırlığını" belirtir: Çalıştırılması için ne kadar süreye/kaynağa ihtiyaç duyulur?

Birim testleri "küçük", entegrasyon testleri "orta" ve uçtan uca testler "büyük" veya "devasa" olarak kabul edilir. Bazel, varsayılan zaman aşım süresini belirlemek için boyutu kullanır. Bu süre, timeout özelliği kullanılarak geçersiz kılınabilir. Zaman aşımı, her bir test için değil, BUILD hedefindeki tüm testler için geçerlidir. Test yerel olarak çalıştırıldığında, size, planlama amacıyla da kullanılır: Bazel, aynı anda çok sayıda ağır test yürüterek --local_{ram,cpu}_resources değerine uymaya ve yerel makineyi yormamaya çalışır.

Test boyutları, aşağıdaki varsayılan zaman aşımlarına ve varsayılan en yüksek yerel kaynak kullanımlarına karşılık gelir:

Boyut RAM (MB cinsinden) CPU (CPU çekirdeklerinde) Varsayılan zaman aşımı
küçük 20 1 kısa (1 dakika)
medium 100 1 orta (5 dakika)
büyük 300 1 uzun (15 dakika)
muazzam 800 1 eternal (60 dakika)

Testi üretirken TEST_SIZE ortam değişkeni, bu özelliğin değerine ayarlanır.

timeout

"short", "moderate", "long" veya "eternal" dizesi; yapılandırılamaz; varsayılan değer, testin size özelliğinden türetilir

Testin sonuç döndürmeden önce ne kadar süre çalışacağı.

Bir testin boyut özelliği, kaynak tahminini kontrol ederken testin zaman aşımı bağımsız olarak ayarlanabilir. Belirtilmemişse zaman aşımı, testin boyutuna göre belirlenir. Test zaman aşımı, --test_timeout işaretiyle geçersiz kılınabilir (ör. yavaş olduğu bilinen belirli koşullar altında çalışma). Test zaman aşımı değerleri, aşağıdaki dönemlere karşılık gelir:

Zaman Aşımı Değeri Dönem
kısa video 1 dakika
orta 5 dakika
uzun 15 dakika
sonsuz 60 dakika

Yukarıdakilerden farklı zamanlarda, test zaman aşımı --test_timeout bazel işaretiyle geçersiz kılınabilir (ör. yavaş olduğu bilinen koşullarda manuel olarak çalıştırmak için). --test_timeout değerleri saniye cinsindendir. Örneğin --test_timeout=120, test zaman aşımını iki dakika olarak ayarlar.

Testi üretirken ortam değişkeni TEST_TIMEOUT , test zaman aşımına (saniye cinsinden) ayarlanır.

flaky

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

Testi hatalı olarak işaretler.

Politika ayarlanırsa testi üç kereye kadar yürütür ve yalnızca her seferinde başarısız olduğu durumlarda testi başarısız olarak işaretler. Varsayılan olarak bu özellik False olarak ayarlanır ve test yalnızca bir kez çalıştırılır. Bu özelliğin kullanılması genellikle önerilmez. İddialar doğru olduğunda testler güvenilir bir şekilde geçmelidir.

shard_count

50'den küçük veya 50'ye eşit pozitif tam sayı; varsayılan değer -1'tür

Testi çalıştırmak için kullanılacak paralel parça sayısını belirtir.

Bu değer ayarlanırsa bu değer, testin yürütüleceği paralel parça sayısını belirlemek için kullanılan tüm buluşsal yöntemleri geçersiz kılar. Bazı test kuralları için, parçalamayı etkinleştirmek amacıyla öncelikle bu parametrenin gerekli olabileceğini unutmayın. Ayrıca bkz. --test_sharding_strategy.

Test bölme işlemi etkinse TEST_TOTAL_SHARDS ortam değişkeni, test oluşturulurken bu değere ayarlanır.

Parçalama için test çalıştırıcının test parçalama protokolünü desteklemesi gerekir. Aksi takdirde, büyük olasılıkla her testi her parçada çalıştırır. Bu da istediğiniz şey değildir.

Parçalama hakkında ayrıntılı bilgi için Test Ansiklopedisi'ndeki Test Parçalama bölümüne bakın.

local

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

Testin, korumalı alan olmadan yerel olarak çalıştırılmasını zorunlu kılar.

Bu değerin True olarak ayarlanması, etiket olarak "local" (tags=["local"]) sağlanmasına eşdeğerdir.

Tüm ikili kurallarda ortak olan özellikler (*_binary)

Bu bölümde, tüm ikili kurallarda ortak olan özellikler açıklanmaktadır.

Özellik Açıklama
args

Dize listesi; $(location) ve "Değişken oluştur" yerine koyma işlemine ve Bourne kabuğu jetonuna tabidir; yapılandırılamaz; varsayılan değer []'tır.

Bazel'in run komutuyla veya test olarak yürütüldüğünde hedefe ileteceği komut satırı bağımsız değişkenleri. Bu bağımsız değişkenler, bazel run veya bazel test komut satırında belirtilenlerden önce iletilir.

NOT: Hedefi Bazel dışında çalıştırdığınızda (örneğin, bazel-bin/ içinde ikili dosyayı manuel olarak çalıştırarak) bağımsız değişkenler iletilmez.

env

Dize sözlüğü; değerler $(location) ve "Değişken oluştur" yerine koyma işlemine tabidir; varsayılan değer {}'tır.

Hedef, bazel run tarafından yürütüldüğünde ayarlanacak ek ortam değişkenlerini belirtir.

Bu özellik yalnızca cc_binary, py_binary ve sh_binary gibi yerel kurallar için geçerlidir. Starlark tarafından tanımlanan yürütülebilir kurallar için geçerli değildir.

NOT: Hedefi Bazel dışında çalıştırdığınızda (örneğin, bazel-bin/ içinde ikili dosyayı manuel olarak çalıştırarak) ortam değişkenleri ayarlanmaz.

output_licenses

Dize listesi; varsayılan değer: []

Bu ikili programın oluşturduğu çıkış dosyalarının lisansları. Bu, Bazel'in artık kullanmadığı, desteği sonlandırılmış bir lisanslama API'sinin bir parçasıdır. Bunu kullanmayın.

Yapılandırılabilir özellikler

Çoğu özellik "yapılandırılabilir"dir. Yani hedef farklı şekillerde oluşturulduğunda değerleri değişebilir. Özellikle, yapılandırılabilir özellikler Bazel komut satırına iletilen işaretlere veya hedefin alt akıştaki bağımlılığından gelen isteğe bağlı olarak değişebilir. Örneğin bu, hedefi birden fazla platform veya derleme modu için özelleştirmek amacıyla kullanılabilir.

Aşağıdaki örnekte, farklı hedef mimarileri için farklı kaynaklar belirtilmektedir. bazel build :multiplatform_lib --cpu x86 çalıştırıldığında hedef x86_impl.cc kullanılarak derlenirken --cpu arm değiştirilirse arm_impl.cc kullanılır.

cc_library(
    name = "multiplatform_lib",
    srcs = select({
        ":x86_mode": ["x86_impl.cc"],
        ":arm_mode": ["arm_impl.cc"]
    })
)
config_setting(
    name = "x86_mode",
    values = { "cpu": "x86" }
)
config_setting(
    name = "arm_mode",
    values = { "cpu": "arm" }
)

select() işlevi, hedef yapılandırmasının config_setting veya constraint_value ölçütlerine göre yapılandırılabilir özellik için farklı alternatif değerler arasından seçim yapar.

Bazel, yapılandırılabilir özellikleri makroları işledikten sonra ve kuralları işlemeden önce (teknik olarak loading ve analysis aşamaları arasında) değerlendirir. select() değerlendirmesinden önceki işlemler, select()'nin hangi dalı seçtiğini bilmez. Örneğin, makrolar seçilen dala göre davranışlarını değiştiremez ve bazel query, hedefin yapılandırılabilir bağımlılıkları hakkında yalnızca dikkatli tahminlerde bulunabilir. select() öğesini kurallar ve makrolarla kullanma hakkında daha fazla bilgi için bu SSS bölümüne bakın.

Dokümanlarında nonconfigurable işaretli özellikler bu özelliği kullanamaz. Bazel, bir select() değerini nasıl çözeceğini belirlemeden önce değerini dahili olarak bilmesi gerektiğinden, genellikle özellikler yapılandırılamaz.

Ayrıntılı bir genel bakış için Yapılandırılabilir Derleme Özellikleri başlıklı makaleyi inceleyin.

Dolaylı çıkış hedefleri

C++'taki örtük çıkışlara verilen destek sonlandırıldı. Lütfen mümkünse başka dillerde kullanmaktan kaçının. Henüz desteği sonlandırılma planımız yok ancak bu sürümler de zaman içinde desteği sonlandırılacak.

DERLEME dosyasında bir derleme kuralı tanımladığınızda, paket içinde de açıkça yeni ve adlandırılmış bir kural hedefi beyan etmiş olursunuz. Birçok derleme kuralı işlevi, içeriği ve anlamı kurala özgü olan bir veya daha fazla çıkış dosyası hedefini dolaylı olarak da içerir. Örneğin, bir java_binary(name='foo', ...) kuralını açık bir şekilde bildirdiğinizde, çıkış dosyası hedefini foo_deploy.jar aynı paketin üyesi olarak dolaylı olarak da bildirmiş olursunuz. (Bu hedef, dağıtıma uygun, kendi kendine yeten bir Java arşividir.)

Dolaylı çıkış hedefleri, global hedef grafiğin birinci sınıf üyeleridir. Diğer hedefler gibi, bunlar da üst düzey derleme komutunda belirtildiğinde veya diğer derleme hedefleri için gerekli ön koşullar olduğunda isteğe bağlı olarak oluşturulur. BUILD dosyalarında bağımlılık olarak değerlendirilebilir ve bazel query gibi analiz araçlarının çıktısında gözlemlenebilirler.

Her derleme kuralı türü için kuralın dokümanlarında, bu tür bir kuralın bildirilmesiyle ilişkili tüm örtülü çıkışların adlarının ve içeriğinin ayrıntılı olarak açıklandığı özel bir bölüm bulunur.

Derleme sistemi tarafından kullanılan iki adlandırma alanı arasında önemli ancak biraz ince bir fark vardır: Etiketler, kural veya dosya olabilecek hedefleri tanımlar. Dosya hedefleri ise kaynak (veya giriş) dosya hedefleri ve türetilmiş (veya çıkış) dosya hedefleri olarak ikiye ayrılabilir. Bunlar BUILD dosyalarında belirtebileceğiniz, komut satırından derleyebileceğiniz veya bazel query kullanarak inceleyebileceğiniz şeylerdir. Bu, hedef ad alanıdır. Her dosya hedefi, diskteki gerçek bir dosyaya ("dosya sistemi ad alanı") karşılık gelir. Her kural hedefi, diskteki sıfır veya bir veya daha fazla gerçek dosyaya karşılık gelebilir. Diskte, karşılık gelen hedefi olmayan dosyalar olabilir. Örneğin, C++ derlemesi sırasında üretilen .o nesne dosyalarına BUILD dosyalarından veya komut satırından referans verilemez. Bu sayede derleme aracı, görevini nasıl yerine getirdiğiyle ilgili belirli uygulama ayrıntılarını gizleyebilir. Bu konu Derleme Kavram Referansı bölümünde daha kapsamlı bir şekilde açıklanmıştır.