DERLEME dosyaları

Sorun bildirme Kaynağı görüntüleme Nightly · 7.4 .

Önceki bölümlerde paketler, hedefler, etiketler ve derleme bağımlılık grafiği soyut olarak açıklanmıştı. Bu bölümde bir paketi tanımlamak için kullanılan kesin söz dizimi açıklanmaktadır.

Tanımı gereği her paket, kısa bir program olan bir BUILD dosyası içerir. BUILD dosyaları, zorunlu bir dil olan Starlark kullanılarak değerlendirilir.

İfadelerin sıralı bir listesi olarak yorumlanır.

Genel olarak sıra önemlidir: Örneğin, değişkenler kullanılmadan önce tanımlanmalıdır. Ancak çoğu BUILD dosyası yalnızca derleme kurallarının beyanlarından oluşur ve bu beyanların göreceli sırası önemli değildir. Önemli olan, paket değerlendirmesi tamamlandığında hangi kuralların ve hangi değerlerle beyan edildiğidir.

cc_library gibi bir derleme kuralı işlevi yürütüldüğünde grafikte yeni bir hedef oluşturulur. Bu hedef daha sonra bir etiket kullanılarak referans verilebilir.

Basit BUILD dosyalarında, kural bildirimleri davranışı değiştirmeden serbestçe yeniden sıralanabilir.

Kod ile veriler arasında net bir ayrım yapılmasını teşvik etmek için BUILD dosyaları; işlev tanımları, for ifadeleri veya if ifadeleri içeremez (ancak liste anlamaları ve if ifadelerine izin verilir). İşlevler bunun yerine .bzl dosyalarında tanımlanabilir. Ayrıca, BUILD dosyalarında *args ve **kwargs bağımsız değişkenlerine izin verilmez. Bunun yerine, tüm bağımsız değişkenleri açık bir şekilde listeleyin.

En önemlisi, Starlark'taki programlar keyfi G/Ç işlemleri yapamaz. Bu değişmez durum, BUILD dosyalarının yorumlanmasını hermetik hale getirir. Bu, derlemelerin yeniden üretilebilir olmasını sağlamak için gerekli olan yalnızca bilinen bir giriş grubuna bağlıdır. Daha fazla bilgi için Hermeticity bölümünü inceleyin.

BUILD dosyaları, teknik olarak Latin-1 karakter kümesi kullanılarak yorumlansa da yalnızca ASCII karakterleri kullanılarak yazılmalıdır.

Temeldeki kod bağımlılığı her değiştiğinde BUILD dosyalarının güncellenmesi gerektiğinden, bu dosyalar genellikle bir ekipte birden fazla kişi tarafından yönetilir. BUILD dosyası yazarları, her derleme hedefini (herkese açık kullanıma yönelik olup olmadığına bakılmaksızın) ve paketin kendisinin rolünü belgelemek için bolca yorum yapmalıdır.

Uzantı yükleniyor

Bazel uzantıları .bzl ile biten dosyalardır. Bir uzantıdan simge içe aktarmak için load ifadesini kullanın.

load("//foo/bar:file.bzl", "some_library")

Bu kod, foo/bar/file.bzl dosyasını yükler ve some_library simgesini ortama ekler. Bu, yeni kurallar, işlevler veya sabit değerler (örneğin, dize veya liste) yüklemek için kullanılabilir. load çağrısı için ek bağımsız değişkenler kullanılarak birden fazla simge içe aktarılabilir. Bağımsız değişkenler dize sabit değerleri (değişken yok) olmalıdır ve load ifadeleri, bir işlev gövdesinde bulunamaz, en üst düzeyde görünmelidir.

load öğesinin ilk bağımsız değişkeni, .bzl dosyasını tanımlayan bir etikettir. Göreli bir etiketse geçerli bzl dosyasını içeren pakete (dizin değil) göre çözülür. load ifadelerindeki göreli etiketler, başında : kullanmalıdır.

load, takma adları da destekler. Bu nedenle, içe aktarılan sembollere farklı adlar atayabilirsiniz.

load("//foo/bar:file.bzl", library_alias = "some_library")

Tek bir load ifadesinde birden çok takma ad tanımlayabilirsiniz. Ayrıca, bağımsız değişken listesi hem takma adları hem de normal simge adlarını içerebilir. Aşağıdaki örnek tamamen yasaldır (tırnak işaretlerinin ne zaman kullanılacağına dikkat edin).

load(":my_rules.bzl", "some_rule", nice_alias = "some_other_rule")

.bzl dosyalarında _ ile başlayan semboller dışa aktarılmaz ve başka bir dosyadan yüklenemez.

.bzl dosyasını kimlerin yükleyebileceğini kısıtlamak için yükleme görünürlüğünü kullanabilirsiniz.

Derleme kuralı türleri

Derleme kurallarının çoğu, dile göre gruplandırılmış aileler halinde gelir. Örneğin, cc_binary, cc_library ve cc_test, sırasıyla C++ ikili programları, kitaplıklar ve testler için derleme kurallarıdır. Diğer diller aynı adlandırma şemasını farklı bir ön ek kullanarak kullanır (ör. Java için java_*). Bu işlevlerden bazıları Build Encyclopedia'da açıklanmıştır ancak herkes yeni kurallar oluşturabilir.

  • *_binary kuralları, belirli bir dilde yürütülebilir programlar oluşturur. Derleme işleminden sonra yürütülebilir dosya, derleme aracının ikili çıkış ağacında kuralın etiketine karşılık gelen adda bulunur. Bu nedenle //my:program, (örneğin) $(BINDIR)/my/program adresinde görünür.

    Bazı dillerde bu tür kurallar, kurala ait bir dataözniteliğinde veya bağımlılıklarının geçişli kapatma kapsamındaki herhangi bir kuralda belirtilen tüm dosyaları içeren bir runfiles dizini de oluşturur. Bu dosya grubu, üretime dağıtımı kolaylaştırmak için tek bir yerde toplanır.

  • *_test kuralları, otomatik test için kullanılan bir *_binary kuralının uzmanlığıdır. Testler, başarılı olduğunda sıfır döndüren programlardır.

    Testler de ikili dosyalar gibi çalıştırma dosyası ağaçlarına sahiptir ve testin çalışma zamanında meşru olarak açabileceği tek dosyalar bu ağaçların altındaki dosyalardır. Örneğin, bir cc_test(name='x', data=['//foo:bar']) programı yürütme sırasında açılıp $TEST_SRCDIR/workspace/foo/bar okuyabilir. (Her programlama dilinin, $TEST_SRCDIR değerine erişmek için kendi yardımcı işlevi vardır ancak bunların tümü, ortam değişkenini doğrudan kullanmaya eşdeğerdir.) Kurala uyulmaması, uzaktan test ana makinesinde çalıştırıldığında testin başarısız olmasına neden olur.

  • *_library kuralları, belirtilen programlama dilinde ayrı olarak derlenmiş modülleri belirtir. Kitaplıklar diğer kitaplıklara, ikili dosyalar ve testler ise kitaplıklara bağlı olabilir. Bu durumda, ayrı derleme davranışı beklenir.

Etiketler Bağımlılıklar