Değişken Oluşturma

mapfile SRCS <<< "$$(sed -e 's/ /\\n/g' <<'genrule_srcs_expansion'
$(SRC)
genrule_srcs_expansion
) yazın ve sonraki komut satırlarında $(SRCS) yerine "$$\{SRCS[@]}" kullanın. Daha sağlam bir seçenek ise bunun yerine bir Starlark kuralı yazmaktır.



Önceden tanımlanmış kaynak/çıkış yolu değişkenleri

  Önceden tanımlanmış execpath, execpaths, rootpath, rootpaths, location ve locations değişkenleri, etiket parametrelerini (ör. $(execpath
  //foo:bar)) alır ve bu etiketle belirtilen dosya yollarının yerine geçer.



  Kaynak dosyalar için bu, çalışma alanınızın kök dizinine göre olan yoldur.
  Kuralların çıkışları olan dosyalar için bu, dosyanın çıkış yoludur
  (aşağıdaki çıkış dosyaları açıklamasına bakın).



  Önceden tanımlanmış yol değişkenleri örneğini inceleyin.


  

    

      execpath:  Bazel'in derleme işlemlerini çalıştırdığı execroot'un altındaki yolu belirtir.
    
    

      Yukarıdaki örnekte Bazel, çalışma alanınızın kök dizininde bazel-myproject sembolik bağlantısıyla bağlanan dizindeki tüm derleme işlemlerini çalıştırır. Kaynak dosya empty.source, bazel-myproject/testapp/empty.source yoluna bağlıdır. Bu nedenle, yürütülebilir dosya yolu (kökün altındaki alt yol) testapp/empty.source olur. Bu, derleme işlemlerinin dosyayı bulmak için kullanabileceği yoldur.
    
    

      Çıkış dosyaları benzer şekilde hazırlanır ancak alt yolla da öneklenir bazel-out/cpu-compilation_mode/bin (veya araçların çıkışları için: bazel-out/cpu-opt-exec-hash/bin). Yukarıdaki örnekte, //testapp:app, show_app_output'ün tools özelliğinde göründüğü için bir araçtır.
      Bu nedenle, çıkış dosyası app, bazel-myproject/bazel-out/cpu-opt-exec-hash/bin/testapp/app konumuna yazılır.
      Bu nedenle, yürütme yolu 
      bazel-out/cpu-opt-exec-hash/bin/testapp/app olur. Bu ek önek, sonuçların birbirini ezmeden aynı derlemede örneğin iki farklı CPU için aynı hedefi oluşturmayı mümkün kılar.
    
    

      Bu değişkene iletilen etiket tam olarak bir dosyayı temsil etmelidir. Kaynak dosyaları temsil eden etiketler için bu durum otomatik olarak geçerlidir. Kuralları temsil eden etiketler için kural tam olarak bir çıkış oluşturmalıdır. Bu değer yanlışsa veya etiket hatalı biçimlendirilmişse derleme hata vererek başarısız olur.
    
  

  

    

      rootpath: Oluşturulan bir ikilinin, çalışma zamanında bir bağımlılığı bulmak için kullanabileceği yolu, ana depoya karşılık gelen runfiles dizininin alt dizinine göre belirtir.
      Not: Bu özellik yalnızca 
      --enable_runfiles etkinse çalışır. Bu özellik, Windows'da varsayılan olarak etkin değildir. Platformlar arası destek için bunun yerine rlocationpath kullanın.
    

      Bu, execpath'ya benzer ancak yukarıda açıklanan yapılandırma ön eklerini kaldırır. Yukarıdaki örnekte bu, hem empty.source hem de app özelliklerinin tamamen çalışma alanına göre yollar kullandığı anlamına gelir: testapp/empty.source ve testapp/app.
    
    

      Harici bir depodaki dosyanın rootpath
      repo, ../repo/ ile başlar ve ardından depoya göre göreceli yol gelir.
    
    

      Bu işlev, execpath ile aynı "yalnızca bir çıktı" şartlarına sahiptir.
    
  

  

    

      rlocationpath: Oluşturulan bir ikilinin, çalışma zamanında bir bağımlılığı bulmak için runfiles kitaplığının 
      Rlocation işlevine iletebileceği yol. Bu bağımlılık, runfiles dizininde (varsa) veya runfiles manifest'i kullanılarak bulunabilir.
    
    

      Bu, rootpath ile benzer şekilde yapılandırma önekleri içermez ancak her zaman depo adıyla başlaması bakımından farklıdır. Yukarıdaki örnekte bu, 
      empty.source ve app öğelerinin aşağıdaki yollarla sonuçlandığı anlamına gelir: myproject/testapp/empty.source ve 
      myproject/testapp/app.
    
    

      Harici bir depodaki dosyanın rlocationpath
      repo, repo/ ile başlar ve ardından depoya göre göreceli yol gelir.
    
    

      Bu yolu bir ikiliye iletmek ve çalışma zamanı dosyası kitaplıklarını kullanarak dosya sistemi yoluna çözümlemek, çalışma zamanında bağımlılıkları bulmak için tercih edilen yaklaşımdır. rootpath ile karşılaştırıldığında, tüm platformlarda ve runfiles dizini kullanılamıyor olsa bile çalışması avantaj sağlar.
    
    

      Bu işlev, execpath ile aynı "yalnızca bir çıktı" şartlarına sahiptir.
    
  

  

    location: Genişletilen özelliğe bağlı olarak execpath veya rootpath için eş anlamlıdır. Bu, Starlark öncesi eski bir davranıştır ve belirli bir kural için ne yaptığını gerçekten bilmiyorsanız önerilmez. Ayrıntılar için #2475 numaralı soruna bakın.
  



  execpaths, rootpaths, rlocationpaths ve locations, sırasıyla execpath, rootpath, rlocationpath ve location öğelerinin çoğul biçimleridir. Birden fazla çıktı üreten plak şirketlerini destekler. Bu durumda her çıktı, boşlukla ayrılarak listelenir. Çıkışı olmayan kurallar ve hatalı etiketler derleme hatalarına neden olur.



  Referans verilen tüm etiketler, tüketen hedefin srcs, çıkış dosyalarında veya deps içinde görünmelidir. Aksi takdirde derleme başarısız olur. C++ hedefleri, data içindeki etiketlere de referans verebilir.



  Etiketlerin standart biçimde olması gerekmez: foo, :foo ve //somepkg:foo kabul edilir.


Özelleştirilebilen değişkenler


  Özel "Marka" değişkenlerine, "Marka değişkeni değiştirme işlemine tabi" olarak işaretlenen tüm özellikler tarafından başvurulabilir ancak yalnızca bu değişkenleri tanımlayan diğer hedeflere bağlı olan hedeflerde kullanılabilir.



  En iyi uygulama olarak, tüm değişkenler özel olmalıdır. Ancak bunları temel Bazel'e dahil etmek için gerçekten iyi bir neden varsa bu kural geçerli değildir. Bu, Bazel'in, hedef tüketen değişkenlerin önemsemeyebileceği, potansiyel olarak maliyetli bağımlılıkları yüklemesini önler.


C++ toolchain değişkenleri

  Aşağıdakiler C++ araç zinciri kurallarında tanımlanır ve toolchains =
  ["@bazel_tools//tools/cpp:toolchain_type"] ayarını yapan tüm kurallar tarafından kullanılabilir.
  java_binary gibi bazı kurallar, C++ araç zincirini kural tanımlarına dolaylı olarak dahil eder. Bu değişkenleri otomatik olarak devralırlar.



  Yerleşik C++ kuralları, "derleyiciyi üzerinde çalıştır"dan çok daha karmaşıktır. *SAN, ThinLTO, modüllü/modülsüz gibi çeşitli derleme modlarının yanı sıra birden fazla platformda hızlı testler çalıştırırken dikkatlice optimize edilmiş ikili dosyaları aynı anda desteklemek için yerleşik kurallar, dahili olarak oluşturulan potansiyel olarak birden fazla işlemin her birinde doğru girişlerin, çıkışların ve komut satırı işaretlerinin ayarlanmasını sağlamak için büyük çaba gösterir.



  Bu değişkenler, nadir durumlarda dil uzmanları tarafından kullanılacak bir yedek mekanizmadır. Bunları kullanmak isterseniz lütfen önce Bazel geliştiricileriyle iletişime geçin.



  
ABI: C++ ABI sürümü. 

  
 AR: Crosstool'daki "ar" komutu. 
  
 C_COMPILER:
    C/C++ derleyici tanımlayıcısı (ör. llvm).
  
  

    
CC: C ve C++ derleyici komutu.
    

      CC_FLAGS ile CC'yi her zaman birlikte kullanmanızı önemle tavsiye ederiz. Aksi takdirde, bunun tüm riski size aittir.
    
  
  
CC_FLAGS: C/C++ derleyicisinin genrules tarafından kullanılabilmesi için gereken minimum işaret grubu. Bu özellikle, CC birden fazla mimariyi destekliyorsa doğru mimariyi seçmek için işaretler içerir.
  


  
 DUMPBIN: Microsoft Visual Studio'dan Microsoft COFF Binary File Dumper (dumpbin.exe). 

  
 NM: Crosstool'daki "nm" komutu. 
  
 OBJCOPY: C/C++ derleyicisiyle aynı paketteki objcopy komutu. 

  
 STRIP: C/C++ derleyicisiyle aynı paketteki strip komutu.


Java araç zinciri değişkenleri


  Aşağıdakiler Java araç zinciri kurallarında tanımlanır ve toolchains =
["@rules_java//toolchains:current_java_runtime"] (veya ana makine araç zinciri eşdeğeri için "@rules_java//toolchains:current_host_java_runtime") ayarlayan tüm kurallar tarafından kullanılabilir.



  JDK'daki araçların çoğu doğrudan kullanılmamalıdır. Yerleşik Java kuralları, Java derleme ve paketleme konusunda yukarı akış araçlarının ifade edebileceğinden çok daha gelişmiş yaklaşımlar kullanır. Örneğin, arayüz JAR'ları, başlık arayüzü JAR'ları ve son derece optimize edilmiş JAR paketleme ve birleştirme uygulamaları.



  Bu değişkenler, nadir durumlarda dil uzmanları tarafından kullanılacak bir yedek mekanizmadır. Bunları kullanmak isterseniz lütfen önce Bazel geliştiricileriyle iletişime geçin.



  
 JAVA: "java" komutu (bir Java sanal makinesi). Bu durumdan kaçının ve mümkün olduğunda bunun yerine java_binary kuralı kullanın. Göreli yol olabilir. java işlevini çağırmadan önce dizinleri değiştirmeniz gerekiyorsa çalışma dizinini değiştirmeden önce yakalamanız gerekir.
  

  
JAVABASE: Java yardımcı programlarını içeren temel dizin. Göreli yol olabilir. "bin" adlı bir alt dizini olur.
  


Starlark ile tanımlanan değişkenler


  Kural ve araç zinciri yazarları, TemplateVariableInfo sağlayıcısı döndürerek tamamen özel değişkenler tanımlayabilir. toolchains özelliği aracılığıyla bunlara bağlı olan tüm kurallar daha sonra değerlerini okuyabilir:



  Starlark ile tanımlanan değişkenlere ilişkin bir örneği inceleyin.