Bazel, depolarda düzenlenmiş kaynak koddan yazılım oluşturur. Çalışma alanı, tanımlanmış bir dizi depodan oluşur. Depolardaki kaynak dosyalar, iç içe yerleştirilmiş bir paket hiyerarşisinde düzenlenir. Her paket, bir dizi ilgili kaynak dosyası ve bir BUILD dosyası içeren bir dizindir. BUILD dosyası, kaynaktan hangi yazılım çıkışlarının oluşturulabileceğini belirtir.
Kod depoları
Bazel derlemesinde kullanılan kaynak dosyalar depolarda (genellikle repolar olarak kısaltılır) düzenlenir. Depo, kökünde sınır işaretleyici dosyası bulunan bir dizin ağacıdır. Bu sınır işaretleyici dosyası MODULE.bazel, REPO.bazel veya eski bağlamlarda WORKSPACE ya da WORKSPACE.bazel olabilir.
Geçerli Bazel komutunun çalıştırıldığı depo, ana depo olarak adlandırılır. Diğer (harici) depolar depo kurallarıyla tanımlanır. Daha fazla bilgi için Harici bağımlılıklara genel bakış başlıklı makaleyi inceleyin.
Çalışma alanı
Çalışma alanı, aynı ana depodan çalıştırılan tüm Bazel komutlarının paylaştığı ortamdır. Ana depoyu ve tanımlanmış tüm harici depoları kapsar.
Geçmişte "depo" ve "çalışma alanı" kavramlarının birbirine karıştırıldığını unutmayın. "Çalışma alanı" terimi genellikle ana depoyu ifade etmek için, bazen de "depo" ile eş anlamlı olarak kullanılmıştır.
Paketler
Depodaki birincil kod düzenleme birimi pakettir. Paket, ilgili dosyaların bir koleksiyonu ve çıkış yapıları oluşturmak için nasıl kullanılabileceklerinin spesifikasyonudur.
Paket, BUILD veya BUILD.bazel adlı bir BUILD dosyası içeren bir dizin olarak tanımlanır. Bir paket, kendi dizinindeki tüm dosyaları ve altındaki tüm alt dizinleri (kendileri BUILD dosyası içerenler hariç) içerir. Bu tanıma göre hiçbir dosya veya dizin iki farklı paketin parçası olamaz.
Örneğin, aşağıdaki dizin ağacında iki paket vardır: my/app ve alt paket my/app/tests. my/app/data öğesinin bir paket değil, my/app paketine ait bir dizin olduğunu unutmayın.
src/my/app/BUILD
src/my/app/app.cc
src/my/app/data/input.txt
src/my/app/tests/BUILD
src/my/app/tests/test.cc
Hedefler
Paket, paketin BUILD dosyasında tanımlanan hedeflerin bulunduğu bir kapsayıcıdır. Hedeflerin çoğu iki ana türden biridir: dosyalar ve kurallar.
Dosyalar ayrıca iki türe ayrılır. Kaynak dosyalar genellikle insanların çabalarıyla yazılır ve depoya kaydedilir. Bazen türetilmiş dosyalar veya çıkış dosyaları olarak da adlandırılan oluşturulan dosyalar, kaynak dosyalardan oluşturulur ancak kaynak kontrolüne eklenmez.
İkinci hedef türü bir kural ile tanımlanır. Her kural örneği, bir giriş dosyaları grubu ile bir çıkış dosyaları grubu arasındaki ilişkiyi belirtir. Bir kuralın girişleri kaynak dosyalar olabileceği gibi diğer kuralların çıkışları da olabilir.
Bir kurala girişin kaynak dosya mı yoksa oluşturulmuş dosya mı olduğu çoğu durumda önemsizdir. Önemli olan yalnızca bu dosyanın içeriğidir. Bu durum, karmaşık bir kaynak dosyanın bir kural tarafından oluşturulan bir dosyayla değiştirilmesini kolaylaştırır. Örneğin, yüksek yapılandırılmış bir dosyayı manuel olarak koruma yükü çok yorucu hale geldiğinde ve birisi bunu türetmek için bir program yazdığında bu durum ortaya çıkar. Bu dosyanın tüketicilerinin herhangi bir değişiklik yapması gerekmez. Bunun aksine, oluşturulan bir dosya yalnızca yerel değişiklikler içeren bir kaynak dosyayla kolayca değiştirilebilir.
Bir kuralın girişleri diğer kuralları da içerebilir. Bu tür ilişkilerin tam anlamı genellikle oldukça karmaşıktır ve dile ya da kurala bağlıdır ancak sezgisel olarak basittir: Bir C++ kitaplığı kuralı A, giriş için başka bir C++ kitaplığı kuralı B'ye sahip olabilir. Bu bağımlılığın etkisi, derleme sırasında B'nin başlık dosyalarının A tarafından kullanılabilmesi, bağlama sırasında B'nin sembollerinin A tarafından kullanılabilmesi ve yürütme sırasında B'nin çalışma zamanı verilerinin A tarafından kullanılabilmesidir.
Tüm kuralların değişmez özelliği, bir kural tarafından oluşturulan dosyaların her zaman kuralın kendisiyle aynı pakete ait olmasıdır. Başka bir pakete dosya oluşturmak mümkün değildir. Ancak bir kuralın girişlerinin başka bir paketten gelmesi yaygın bir durumdur.
Paket grupları, belirli kuralların erişilebilirliğini sınırlamayı amaçlayan paket kümeleridir. Paket grupları, package_group işleviyle tanımlanır. Üç özelliği vardır: İçerdikleri paketlerin listesi, adları ve dahil ettikleri diğer paket grupları. Bunlara yalnızca kuralların visibility özelliğinden veya package işlevinin default_visibility özelliğinden başvurulabilir. Dosya oluşturmaz veya kullanmazlar. Daha fazla bilgi için package_group
belgelere bakın.