Bazel Sözlüğü

Sorun bildirme Kaynağı görüntüleme Nightly · 8.0 7.4 . 7.3 · 7.2 · 7.1 · 7.0 · 6.5

İşlem

Derleme sırasında çalıştırılacak bir komuttur. Örneğin, giriş olarak öğeleri alan ve çıkış olarak başka öğeler üreten bir derleyiciye yapılan çağrı. Komut satırı bağımsız değişkenleri, işlem anahtarı, ortam değişkenleri ve tanımlanmış giriş/çıkış yapıları gibi meta verileri içerir.

Bkz. Kural dokümanları

İşlem önbelleği

Yürütülen işlemlerin oluşturduğu çıkışlarla eşlemesini depolayan disk üzerinde bir önbellek. Önbellek anahtarı, işlem anahtarı olarak bilinir. Bazel'in artımlı modelinin temel bileşenidir. Önbellek, çıkış ana dizininde depolanır ve bu nedenle Bazel sunucusunun yeniden başlatılmasından etkilenmez.

İşlem grafiği

İşlemlerin ve bu işlemlerin okuduğu ve oluşturduğu yapıların bellek içi grafiği. Grafik, kaynak dosya olarak (ör. dosya sisteminde) bulunan yapay nesnelerin yanı sıra BUILD dosyalarında bahsedilmeyen oluşturulmuş ara/nihai yapay nesneleri içerebilir. Analiz aşamasında oluşturulur ve yürütme aşamasında kullanılır.

İşlem grafiği sorgusu (aquery)

Derleme işlemleri üzerinde sorgu yapabilen bir sorgu aracı. Bu sayede, derleme kurallarının gerçek çalışma derlemelerinde nasıl uygulandığını analiz edebilirsiniz.

Eylem tuşu

Bir işlemin önbelleği anahtarı. İşleme bağlı olarak işlemde yürütülecek komutu, derleyici işaretlerini, kitaplık konumlarını veya sistem üstbilgilerini içerebilen işlem meta verilerine göre hesaplanır. Bazel'in tek tek işlemleri kararlı bir şekilde önbelleğe almasını veya geçersiz kılmasını sağlar.

Analiz aşaması

Derlemenin ikinci aşaması. BUILD dosyalarında belirtilen hedef grafiği işlenir. Böylece, yürütme aşamasında çalıştırılacak işlemlerin sırasını belirleyen bellek içi bir işlem grafiği oluşturulur. Bu, kural uygulamalarının değerlendirildiği aşamadır.

Yapı

Kaynak dosya veya oluşturulmuş dosya. Ağaç yapıları olarak bilinen bir dosya dizini de olabilir.

Bir yapı, birden fazla işleme giriş olabilir ancak yalnızca en fazla bir işlem tarafından oluşturulmalıdır.

Dosya hedefine karşılık gelen bir yapı, etiketle adreslenebilir.

En Boy Oranı

Kuralların, bağımlılıkları içinde ek işlemler oluşturması için bir mekanizma. Örneğin, A hedefi B'ye bağlıysa A'ya, B'ye giden bir bağımlılık kenarını yukarı doğru izleyen ve ek çıkış dosyaları oluşturmak ve toplamak için B'de ek işlemler çalıştıran bir görünüm uygulanabilir. Bu ek işlemler önbelleğe alınır ve aynı yönü gerektiren hedefler arasında yeniden kullanılır. aspect() Starlark Build API işleviyle oluşturulur. Örneğin, IDE'ler için meta veriler oluşturmak ve linting işlemleri oluşturmak için kullanılabilir.

Bkz. Aspects belgeleri

En boy oranı üzerinde en boy oranı

Yönlerin diğer yönlerin sonuçlarına uygulanabileceği bir kompozisyon mekanizması. Örneğin, IDE'ler tarafından kullanılmak üzere bilgi oluşturan bir özellik, protodan .java dosyaları oluşturan bir özelliğin üzerine uygulanabilir.

A özelliğinin B özelliğinin üzerine uygulanması için B'un provides özelliğinde reklamını yaptığı sağlayıcılar, A'ün required_aspect_providers özelliğinde istediğiyle eşleşmelidir.

Özellik

Hedef başına derleme bilgilerini ifade etmek için kullanılan bir kural parametresi. Örneğin, srcs, deps ve copts, sırasıyla hedefin kaynak dosyalarını, bağımlılıklarını ve özel derleyici seçeneklerini tanımlar. Belirli bir hedef için kullanılabilen özellikler, kural türüne bağlıdır.

.bazelrc

Bazel'in yapılandırma dosyası, başlangıç işaretleri ve komut işaretleri için varsayılan değerleri değiştirmek ve daha sonra --config işareti kullanılarak Bazel komut satırında birlikte ayarlanabilecek ortak seçenek gruplarını tanımlamak için kullanılır. Bazel, birden fazla bazelrc dosyasının (sistem genelinde, çalışma alanı başına, kullanıcı başına veya özel bir konumdan) ayarlarını birleştirebilir. Ayrıca, bir bazelrc dosyası diğer bazelrc dosyalarından da ayar içe aktarabilir.

Blaze

Bazel'in Google'a özel sürümü. Google'ın tek kod deposu için ana derleme sistemi.

BUILD Dosyası

BUILD dosyası, Bazel'e hangi yazılım çıktılarının derleneceğini, bu çıktıların bağımlılıkları ve nasıl derleneceğini bildiren ana yapılandırma dosyasıdır. Bazel, giriş olarak bir BUILD dosyası alır ve bu dosyayı bağımlılıklar grafiği oluşturmak ve ara ve nihai yazılım çıkışlarını oluşturmak için yapılması gereken işlemleri türetmek amacıyla kullanır. BUILD dosyası, bir dizini ve BUILD dosyası içermeyen tüm alt dizinleri paket olarak işaretler ve kurallar tarafından oluşturulan hedefler içerebilir. Dosya BUILD.bazel olarak da adlandırılabilir.

BUILD.bazel Dosyası

BUILD Dosyası başlıklı makaleyi inceleyin. Aynı dizindeki BUILD dosyasına göre önceliklidir.

.bzl Dosyası

Kuralları, makroları ve sabitleri tanımlayan, Starlark ile yazılmış bir dosya. Ardından, load() işlevi kullanılarak BUILDdosyalarına aktarılabilir.

Grafik oluşturma

Bazel'in derleme yapmak için oluşturduğu ve gezdiği bağımlılık grafiği. Hedefler, yapılandırılmış hedefler, işlemler ve öğeler gibi düğümleri içerir. İstekte bulunulan bir hedef grubunun bağlı olduğu tüm yapılar güncel olduğunda derleme tamamlanmış kabul edilir.

Derleme ayarı

Starlark tarafından tanımlanan bir yapılandırma parçası. Geçişler, bir alt grafiğin yapılandırmasını değiştirmek için derleme ayarlarını belirleyebilir. Kullanıcıya yapı işareti olarak da bilinen bir komut satırı işareti olarak gösteriliyorsa.

Temiz derleme

Önceki derlemelerin sonuçlarını kullanmayan bir derleme. Bu işlem genellikle artımlı derlemeden daha yavaştır ancak genellikle daha doğru olarak kabul edilir. Bazel, hem temiz hem de artımlı derlemelerin her zaman doğru olmasını sağlar.

İstemci-sunucu modeli

bazel komut satırı istemcisi, Bazel komutlarını yürütmek için yerel makinede otomatik olarak bir arka plan sunucusu başlatır. Sunucu, komutlar arasında devam eder ancak bir süre işlem yapılmadığında otomatik olarak durur (veya açıkça baz kapatma yoluyla). Bazel'i sunucu ve istemci olarak bölme, JVM'nin başlatma süresini amorti etmeye yardımcı olur ve işlem grafiği komutlar arasında bellekte kaldığı için daha hızlı artımlı derlemeleri destekler.

Komut

bazel build, bazel test, bazel run ve bazel query gibi farklı Bazel işlevlerini çağırmak için komut satırında kullanılır.

Komut işaretleri

Bir komuta özgü işaretler grubu. Komut işaretleri, komutun ardından belirtilir (bazel build <command flags>). İşaretler bir veya daha fazla komut için geçerli olabilir. Örneğin, --configure yalnızca bazel sync komutu için geçerli bir işarettir ancak --keep_going, sync, build, test ve daha fazlası için geçerlidir. İşaretler genellikle yapılandırma amacıyla kullanılır. Bu nedenle, işaret değerlerinde yapılan değişiklikler Bazel'in bellekteki grafikleri geçersiz kılmasına ve analiz aşamasını yeniden başlatmasına neden olabilir.

Yapılandırma

Kuralların işlem oluşturma şeklini etkileyen, kural tanımlarının dışındaki bilgiler. Her derlemede hedef platformu, işlem ortam değişkenlerini ve komut satırı derleme işaretlerini belirten en az bir yapılandırma bulunur. Geçişler, barındırma araçları veya çapraz derleme gibi ek yapılandırmalar oluşturabilir.

Bkz. Yapılandırmalar

Yapılandırmayı kısaltma

Hedefin gerçekten ihtiyaç duyduğu yapılandırma parçalarını dahil etme işlemi. Örneğin, Java ikili dosyası //:j'ü C++ bağımlılığı //:c ile derliyorsanız --javacopt değerini //:c yapılandırmasına dahil etmek israftır. Çünkü --javacopt'nin değiştirilmesi, C++ derleme önbelleğe alınabilirliğini gereksiz yere bozar.

Yapılandırılmış sorgu (cquery)

Analizler aşaması tamamlandıktan sonra yapılandırılmış hedefler üzerinde sorgu yapan bir sorgu aracı. Bu, select() ve derleme işaretlerinin (--platforms gibi) sonuçlara doğru şekilde yansıtıldığı anlamına gelir.

Bkz. cquery dokümanları

Yapılandırılmış hedef

Bir hedefin yapılandırmayla değerlendirilmesinin sonucu. Analiz aşaması, derlemenin seçeneklerini oluşturulması gereken hedeflerle birleştirerek bu dosyayı oluşturur. Örneğin, //:foo aynı derlemede iki farklı mimari için derleniyorsa iki yapılandırılmış hedefi vardır: <//:foo, x86> ve <//:foo, arm>.

Doğruluk

Bir derleme, çıkışı geçişli girişlerinin durumunu doğru yansıttığında doğrudur. Bazel, doğru derlemeler elde etmek için hermetik, yeniden üretilebilir ve derleme analizini ve işlem yürütmeyi deterministik hale getirmeye çalışır.

Bağımlı seçim

İki hedef arasındaki yönlendirilmiş kenar. //:foo özelliğinin değerlerinden biri //:bar'a referans içeriyorsa //:foo hedefi, //:bar hedefine hedef bağımlılık içerir. //:foo'teki bir işlem, //:bar'teki bir işlem tarafından oluşturulan bir giriş öğesine bağlıysa //:foo, //:bar'e işlem bağımlılığı sahiptir.

Depset

Geçişli bağımlılıklarla ilgili veri toplamak için kullanılan bir veri yapısı. Çok büyük depo kümelerinin (yüz binlerce dosya) olması yaygın olduğundan, depo kümelerini birleştirmenin zaman ve alan açısından verimli olması için optimize edilmiştir. Alan verimliliği nedeniyle diğer depsetlere yinelenen şekilde referans vermek için uygulanır. Kural uygulamalarında, kural derleme grafiğinin en üst düzeyinde olmadığı sürece depsetler listelere dönüştürülerek "düzleştirilmemelidir". Büyük depolama alanlarını düzleştirmek çok fazla bellek tüketimine neden olur. Bazel'in dahili uygulamasında iç içe yerleştirilmiş kümeler olarak da bilinir.

Bkz. Depset belgeleri

Disk önbelleği

Uzak önbelleğe alma özelliği için yerel bir disk üzerinde blob depolama alanı. Gerçek bir uzak blob deposuyla birlikte kullanılabilir.

Distdir

Bazel'in kod deposu kurallarını kullanarak internetten getireceği dosyaları içeren salt okunur bir dizin. Derlemelerin tamamen çevrimdışı çalışmasını sağlar.

Dinamik yürütme

Çeşitli sezgisel kurallara göre yerel ve uzak yürütme arasında seçim yapan ve daha hızlı başarılı yöntemin yürütme sonuçlarını kullanan bir yürütme stratejisi. Bazı işlemler yerel olarak daha hızlı (ör. bağlama), bazıları ise uzaktan daha hızlı (ör. yüksek paralellik sağlanabilen derleme) yürütülür. Dinamik bir yürütme stratejisi, mümkün olan en iyi artımlı ve temiz derleme sürelerini sağlayabilir.

Yürütme aşamasında

Derlemenin üçüncü aşaması. Analizler aşamasında oluşturulan işlem grafiğindeki işlemleri yürütür. Bu işlemler, öğeleri okumak ve yazmak için yürütülebilir dosyaları (derleyiciler, komut dosyaları) çağırır. Oluşturma stratejileri, bu işlemlerin nasıl yürütüleceğini kontrol eder: yerel, uzak, dinamik, korumalı alan, docker vb.

Yürütme kökü

Çalışma alanının çıktı tabanı dizininde, korumalı alan dışındaki derlemelerde yerel işlemlerin yürütüldüğü bir dizin. Dizin içeriği çoğunlukla, iş alanındaki giriş öğelerinin sembolik bağlantılarıdır. Yürütme kökü, diğer girişler olarak harici depolara yönelik sembolik bağlantılar ve çıkışları depolamak için bazel-out dizini de içerir. Bir derlemenin bağlı olduğu paketlerin geçişli kapatılmasını temsil eden dizinlerin sembolik bağlantı ormanı oluşturularak yükleme aşamasında hazırlanır. Komut satırında bazel info execution_root ile erişilebilir.

Dosya

Artifact konusuna bakın.

Hermeticity

Derleme ve test işlemleri üzerinde harici etkiler yoksa derleme hermetiktir. Bu, sonuçların deterministik ve doğru olmasını sağlar. Örneğin, hermetik derlemeler genellikle işlemlere ağ erişimine izin vermez, beyan edilen girişlere erişimi kısıtlar, sabit zaman damgaları ve saat dilimlerini kullanır, ortam değişkenlerine erişimi kısıtlar ve rastgele sayı üreteçleri için sabit tohumlar kullanır.

Artımlı derleme

Artımlı derleme, derleme süresini ve kaynak kullanımını azaltmak için önceki derlemelerin sonuçlarını yeniden kullanır. Bağımlılık kontrolü ve önbelleğe alma, bu tür derlemeler için doğru sonuçlar elde etmeyi amaçlar. Artımlı derleme, temiz derlemenin tersidir.

Şirket

Hedef için bir tanımlayıcı. //path/to/package:target gibi tam nitelikli bir etiket, Workspace kök dizinini işaretlemek için //, hedefi açıklayan BUILD dosyasını içeren dizin olarak path/to/package ve yukarıda belirtilen BUILD dosyasında tanımlanan hedefin adı olarak :target öğelerinden oluşur. Hedefin my_repository adlı bir ]harici depoda] tanımlandığını belirtmek için @my_repository//<..> ön ekiyle de kullanılabilir.

Yükleme aşaması

Bazel'in paket oluşturmak için WORKSPACE, BUILD ve .bzl dosyalarını ayrıştırdığı derlemenin ilk aşaması. Makrolar ve glob() gibi belirli işlevler bu aşamada değerlendirilir. Hedef grafik oluşturmak için derlemenin ikinci aşaması olan analiz aşamasıyla birlikte kullanılır.

Makro

Tek bir Starlark işlevi altında birden fazla kural hedef beyanını bir araya getiren bir mekanizma. BUILD dosyalarında ortak kural beyanı kalıplarının yeniden kullanılmasını sağlar. Yükleme aşamasında temel kural hedefi beyanlarına genişletilir.

Bkz. Makro dokümanları

Mnemonic

Kuraldaki bir işlemin ne yaptığını hızlıca anlamak için kural yazarı tarafından seçilen kısa, okunabilir bir dize. Hatırlatıcılar, oluşturma stratejisi seçimleri için tanımlayıcı olarak kullanılabilir. İşlem anımsatıcılarına örnek olarak Java kurallarındaki Javac, C++ kurallarındaki CppCompile ve Android kurallarındaki AndroidManifestMerger verilebilir.

Yerel kurallar

Bazel'e yerleştirilmiş ve Java'da uygulanmış kurallar. Bu tür kurallar, yerel modüldeki işlevler olarak .bzl dosyalarında görünür (ör. native.cc_library veya native.java_library). Kullanıcı tanımlı kurallar (yerel olmayan), Starlark kullanılarak oluşturulur.

Çıkış tabanı

Bazel çıkış dosyalarını depolamak için çalışma alanına özel bir dizin. Çıkışları çalışma alanının kaynak ağacından ayırmak için kullanılır. Çıkış kullanıcı kökü bölümünde bulunur.

Çıkış grupları

Bazel bir hedefi oluşturmayı tamamladığında oluşturulması beklenen bir dosya grubu. Kurallar, normal çıkışlarını "varsayılan çıkış grubuna" yerleştirir (ör.java_library için .jar dosyası, cc_library hedefleri için .a ve .so). Varsayılan çıkış grubu, komut satırında bir hedef istendiğinde yapılarının oluşturulduğu çıkış grubudur. Kurallar, BUILD dosyalarında (filegroup kuralı) veya komut satırında (--output_groups işareti) açıkça belirtilebilecek daha fazla adlandırılmış çıkış grubu tanımlayabilir.

Çıkış kullanıcı kökü

Bazel'in çıktılarını depolamak için kullanıcıya özel bir dizin. Dizin adı, kullanıcının sistem kullanıcı adından türetilir. Sistemde aynı projeyi aynı anda birden fazla kullanıcı derliyorsa çıkış dosyası çakışmalarını önler. Ayrı çalışma alanlarının derleme çıkışlarına karşılık gelen alt dizinleri içerir. Bu dizinler çıktı tabanları olarak da bilinir.

Paket

BUILD dosyası tarafından tanımlanan hedefler grubu. Paketin adı, BUILD dosyasının çalışma alanı köküne göreli yoludur. Bir paket, alt paketler veya BUILD dosyaları içeren alt dizinler içerebilir. Böylece paket hiyerarşisi oluşturulur.

Paket grubu

Bir paket grubunu temsil eden hedef. Genellikle visibility özellik değerlerinde kullanılır.

Platform

Derlemede yer alan bir "makine türü". Buna, Bazel'in çalıştığı makine ("ana makine" platformu), makine derleme araçlarının çalıştığı ("yürütme" platformları) ve makine hedeflerinin oluşturulduğu ("hedef platformlar") makineler dahildir.

Sağlayıcı

Bağımlılık ilişkileri boyunca kural hedefleri arasında aktarılacak bir bilgi birimini açıklayan bir şema. Bu genellikle derleyici seçenekleri, geçişli kaynak veya çıkış dosyaları ve derleme meta verileri gibi bilgileri içerir. Toplanan geçişli verileri verimli bir şekilde depolamak için genellikle depsets ile birlikte kullanılır. Yerleşik sağlayıcı örneği DefaultInfo'tür.

Bkz. Sağlayıcı dokümanları

Sorgu (kavram)

Hedef mülkleri ve bağımlılık yapılarını anlamak için bir derleme grafiğini analiz etme işlemi. Bazel üç sorgu varyantını destekler: query, cquery ve aquery.

query (komut)

Derlemenin yükleme sonrası hedef grafiği üzerinde çalışan bir sorgu aracı. Bu yöntem nispeten hızlıdır ancak select(), derleme işaretleri, yapılar veya işlemler'in etkilerini analiz edemez.

Bkz. Sorgu oluşturma, Sorgu referansı

Depo önbelleği

Derlemeler için Bazel tarafından indirilen dosyaların paylaşılan, içerik adreslenebilir bir önbelleğidir ve çalışma alanlarında paylaşılabilir. İlk indirme işleminden sonra çevrimdışı derlemeleri etkinleştirir. Genellikle http_archive gibi depo kuralları ve repository_ctx.download gibi depo kuralı API'leri aracılığıyla indirilen dosyaları önbelleğe almak için kullanılır. Dosyalar yalnızca indirme işlemi için SHA-256 sağlama toplama değerleri belirtilmişse önbelleğe alınır.

Yeniden üretilebilirlik

Bir derleme veya testin, zaman, yöntem veya ortamdan bağımsız olarak her zaman aynı giriş grubunu her zaman aynı çıkış grubunu üreteceği özelliği. Bunun, çıkışların doğru veya istenen çıkışlar anlamına gelmediğini unutmayın.

Kural

cc_library gibi bir BUILD dosyasında kural hedeflerini tanımlamak için kullanılan bir şema. BUILD dosyası yazarı açısından bir kural, bir dizi özellikten ve kara kutu mantığından oluşur. Mantık, kural hedefine çıkış yapılarını nasıl üreteceğini ve diğer kural hedeflerine nasıl bilgi aktaracağını söyler. .bzl yazarları açısından kurallar, Bazel'i yeni programlama dillerini ve ortamlarını desteklemek için genişletmenin birincil yoludur.

Kurallar, yükleme aşamasında kural hedefleri oluşturmak için örneklenir. Analiz aşamasında kural hedefleri, sağlayıcılar biçiminde bilgileri alt akıştaki bağımlılıklarına iletir ve çıkış yapılarını nasıl oluşturacaklarını açıklayan işlemleri kaydeder. Bu işlemler yürütme aşamasında çalıştırılır.

Bkz. Kural dokümanları

Kural hedefi

Kural örneği olan bir hedef. Dosya hedefleri ve paket gruplarıyla zıttır. Kural ile karıştırılmamalıdır.

Çalışma dosyaları

Bir yürütülebilir hedefin çalışma zamanı bağımlılıkları. Yürütülebilir dosya genellikle bir test kuralının yürütülebilir çıkışı, çalıştırma dosyaları ise testin çalışma zamanındaki veri bağımlılıklarıdır. Bazel, yürütülebilir dosyanın çağrılmasından önce (bazel test sırasında), test yürütülebilir dosyasının yanı sıra kaynak dizin yapılarına göre çalıştırma dosyası ağacını hazırlar.

Bkz. Çalışma dosyası dokümanları

Korumalı alana alma

Çalışan bir işlemi kısıtlanmış ve geçici bir yürütme kökü içinde izole ederek, bildirilmemiş girişleri okumamasını veya bildirilmemiş çıkışları yazmamasını sağlamaya yardımcı olan bir teknik. Korumalı alan, hermetikliği büyük ölçüde iyileştirir ancak genellikle performans maliyeti vardır ve işletim sisteminden destek gerektirir. Performans maliyeti platforma bağlıdır. Linux'da bu durum önemli değildir ancak macOS'te korumalı alanı kullanılamaz hale getirebilir.

Skyframe

Skyframe, Bazel'in temel paralel, işlevsel ve artımlı değerlendirme çerçevesidir.

Istampalama

Bazel tarafından oluşturulan yapılara ek bilgi yerleştiren bir özellik. Örneğin, bu özellik; kaynak denetimi, derleme süresi ve sürüm derlemeleri için çalışma alanı veya ortamla ilgili diğer bilgiler için kullanılabilir. Damga özelliğini destekleyen --workspace_status_command işareti ve kuralları aracılığıyla etkinleştirin.

Starlark

Kural ve makro yazmak için kullanılan uzantı dili. Yapılandırma ve daha iyi performans için tasarlanmış, kısıtlanmış bir Python alt kümesidir (söz dizimi ve dil bilgisi açısından). .bzl dosya uzantısını kullanır. BUILD dosyaları, daha önce Skylark olarak bilinen Starlark'ın daha da kısıtlanmış bir sürümünü (ör. def işlev tanımları yok) kullanır.

Bkz. Starlark dili belgeleri

Başlangıç işaretleri

bazel ile komut arasında belirtilen işaretler grubu (ör. bazel --host_jvm_debug build). Bu işaretler, Bazel sunucusunun yapılandırmasını değiştirir. Bu nedenle, başlangıç işaretlerinde yapılan herhangi bir değişiklik sunucunun yeniden başlatılmasına neden olur. Başlangıç bayrakları herhangi bir komuta özel değildir.

Hedef

BUILD dosyasında tanımlanan ve etiket ile tanımlanan bir nesne. Hedefler, bir çalışma alanının son kullanıcı açısından oluşturulabilir birimlerini temsil eder.

Bir kural örneği oluşturularak tanımlanan hedefe kural hedefi denir. Kuralla ilgili olarak bunlar çalıştırılabilir (cc_binary gibi) veya test edilebilir (cc_test gibi) olabilir. Kural hedefleri genellikle özellikleri aracılığıyla diğer hedeflere bağlıdır (deps gibi); bu bağımlılıklar hedef grafiğinin temelini oluşturur.

Kural hedeflerinin yanı sıra dosya hedefleri ve paket grubu hedefleri de vardır. Dosya hedefleri, BUILD dosyası içinde referans verilen yapılara karşılık gelir. Özel bir durum olarak, herhangi bir paketin BUILD dosyası her zaman söz konusu pakette bir kaynak dosya hedefi olarak kabul edilir.

Hedefler yükleme aşamasında bulunur. Analiz aşamasında hedefler, yapılandırılmış hedefler oluşturmak için derleme yapılandırmalarıyla ilişkilendirilir.

Hedef grafik

Hedeflerin ve bunların bağımlılıklarının bellek içi grafiği. Yükleme aşamasında üretilir ve analiz aşamasında giriş olarak kullanılır.

Hedef desen

Komut satırında bir hedef grubu belirtmenin bir yolu. Sık kullanılan kalıplar :all (tüm kural hedefleri), :* (tüm kural + dosya hedefleri), ... (geçerli paket ve tüm alt paketler yinelemeli olarak) şeklindedir. Birlikte kullanılabilir. Örneğin, //...:*, çalışma alanının kökünden itibaren tüm paketlerdeki tüm kural ve dosya hedeflerini yinelemeli olarak ifade eder.

Testler

Kural, test kurallarından oluşturulan hedefleri içerir ve bu nedenle test çalıştırılabilir dosyasını içerir. Yürütülebilir dosyanın tamamlanmasından sonra döndürülen sıfır değeri, testin başarılı olduğunu gösterir. Bazel ile testler arasındaki tam sözleşme (ör. test ortamı değişkenleri, test sonucu toplama yöntemleri) Test Ansiklopedisi'nde belirtilmiştir.

Araç zinciri

Bir dil için çıkış oluşturmaya yönelik bir araç seti. Bir araç zinciri genellikle derleyiciler, bağlayıcılar, yorumlayıcılar ve/veya linterler içerir. Bir araç zinciri platforma göre de değişebilir. Yani, aynı dile ait olsa bile Unix derleyici araç zincirinin bileşenleri Windows varyantında farklı olabilir. Platform için doğru araç zincirini seçme işlemine araç zinciri çözme adı verilir.

Üst düzey hedef

Bazel komut satırında istenen bir derleme hedefi üst düzeydir. Örneğin, //:foo, //:bar'a bağlıysa ve bazel build //:foo çağrılırsa bu derleme için //:foo üst düzeydir ve //:bar üst düzey değildir. Ancak her iki hedefin de derlenmesi gerekir. Üst düzey hedefler ile üst düzey olmayan hedefler arasındaki önemli bir fark, Bazel komut satırında (veya .bazelrc aracılığıyla) ayarlanan komut işaretlerinin üst düzey hedefler için yapılandırmayı ayarlamasıdır ancak üst düzey olmayan hedefler için geçiş tarafından değiştirilebilir.

Geçiş

Bir değerden diğerine yapılandırma durumunun eşlenmesi. Oluşturma grafiğindeki hedeflerin aynı kuraldan oluşturulmuş olsalar bile farklı yapılandırmalara sahip olmasını sağlar. Geçişlerin yaygın bir kullanımı, hedef grafiğin belirli bölümlerinin her çatal için farklı yapılandırmalarla çatallandığı ayrılmış geçişlerdir. Örneğin, tek bir derlemede ARM ve x86 için derlenmiş yerel ikili dosyalar içeren bir Android APK oluşturabilirsiniz.

Bkz. Kullanıcı tanımlı geçişler

Ağaç yapıları

Dosya koleksiyonunu temsil eden bir yapı. Bu dosyalar yapı ürünü olmadığından, bunlar üzerinde çalışan bir işlem, ağaç yapı ürününü giriş veya çıkış olarak kaydetmelidir.

Görünürlük

Derleme sisteminde istenmeyen bağımlılıkları önlemek için kullanılan iki mekanizmadan biri: Bir hedefin diğer hedefler tarafından bağımlı olup olmadığını kontrol etmek için hedef görünürlüğü ve bir BUILD veya .bzl dosyasının belirli bir .bzl dosyasını yükleyip yükleyemeyeceğini kontrol etmek için yükleme görünürlüğü. Bağlam olmadan "görünürlük" genellikle hedef görünürlüğü ifade eder.

Bkz. Görünürlük dokümanları

Çalışma alanı

Derlemek istediğiniz yazılımın WORKSPACE dosyasını ve kaynak kodunu içeren bir dizin. // ile başlayan etiketler, çalışma alanı dizinine göredir.

WORKSPACE dosyası

Bir dizini çalışma alanı olarak tanımlar. Dosya boş olabilir ancak genellikle ağdan veya yerel dosya sisteminden ek bağımlılık getirmek için harici depolama alanı beyanları içerir.