Buat Variabel

mapfile SRCS <<< "$$(sed -e 's/ /\\n/g' <<'genrule_srcs_expansion'
$(SRC)
genrule_srcs_expansion
),
lalu gunakan "$$\{SRCS[@]}" di baris perintah berikutnya sebagai pengganti
$(SRCS). Opsi yang lebih andal adalah menulis aturan Starlark.



Variabel jalur sumber/output yang telah ditetapkan

  Variabel standar execpath, execpaths,
  rootpath, rootpaths, location, dan
  locations menggunakan parameter label (misalnya $(execpath
  //foo:bar)) dan mengganti jalur file yang ditunjukkan oleh label tersebut.



  Untuk file sumber, ini adalah jalur yang relatif terhadap root ruang kerja Anda.
  Untuk file yang merupakan output aturan, ini adalah jalur output file
  (lihat penjelasan file output di bawah).



  Lihat contoh variabel jalur standar.


  

    

      execpath:  Menunjukkan jalur di bawah

      execroot
    tempat Bazel menjalankan tindakan build.
    
    

      Pada contoh di atas, Bazel menjalankan semua tindakan build di direktori yang ditautkan
      oleh symlink bazel-myproject di root ruang kerja Anda. File
      sumber empty.source ditautkan di jalur
      bazel-myproject/testapp/empty.source. Jadi, jalur eksekusi (yang
      merupakan subjalur di bawah root) adalah testapp/empty.source. Ini
      adalah jalur yang dapat digunakan tindakan build untuk menemukan file.
    
    

      File output di-staging dengan cara yang sama, tetapi juga diawali dengan subjalur
      bazel-out/cpu-compilation_mode/bin (atau untuk output
      alat: bazel-out/cpu-opt-exec-hash/bin). Dalam contoh di atas,
      //testapp:app adalah alat karena muncul di
      atribut tools show_app_output.
      Jadi, file outputnya app ditulis ke
      bazel-myproject/bazel-out/cpu-opt-exec-hash/bin/testapp/app.
      Dengan demikian, jalur eksekusi adalah 
      bazel-out/cpu-opt-exec-hash/bin/testapp/app. Awalan tambahan ini
      memungkinkan pembuatan target yang sama untuk, misalnya, dua CPU yang berbeda dalam
      build yang sama tanpa hasil yang saling mengganggu.
    
    

      Label yang diteruskan ke variabel ini harus mewakili tepat satu file. Untuk
      label yang mewakili file sumber, hal ini otomatis benar. Untuk label yang mewakili aturan, aturan harus menghasilkan tepat satu output. Jika nilainya
      salah (false) atau label salah format, build akan gagal dengan error.
    
  

  

    

      rootpath: Menunjukkan jalur yang dapat digunakan biner yang di-build untuk
      menemukan dependensi saat runtime relatif terhadap subdirektori direktori runfile
      yang sesuai dengan repositori utama.
      Catatan: Ini hanya berfungsi jika 
      --enable_runfiles diaktifkan, yang tidak berlaku di
      Windows secara default. Sebagai gantinya, gunakan rlocationpath untuk
      dukungan lintas platform.
    

      Ini mirip dengan execpath, tetapi menghapus awalan konfigurasi
      yang dijelaskan di atas. Dalam contoh di atas, ini berarti
      empty.source dan app menggunakan jalur
      relatif ruang kerja murni: testapp/empty.source dan testapp/app.
    
    

      rootpath file dalam repo repositori
      eksternal akan dimulai dengan ../repo/, diikuti dengan
      jalur relatif repositori.
    
    

      Ini memiliki persyaratan "hanya satu output" yang sama dengan execpath.
    
  

  

    

      rlocationpath: Jalur yang dapat diteruskan biner yang di-build ke fungsi 
      Rlocation library runfile untuk menemukan dependensi saat
      runtime, baik di direktori runfile (jika tersedia) atau menggunakan
      manifes runfile.
    
    

      Ini mirip dengan rootpath karena tidak berisi
      awalan konfigurasi, tetapi berbeda karena selalu dimulai dengan
      nama repositori. Dalam contoh di atas, ini berarti 
      empty.source dan app menghasilkan jalur
      berikut: myproject/testapp/empty.source dan 
      myproject/testapp/app.
    
    

      rlocationpath file dalam repo repositori
      eksternal akan dimulai dengan repo/, diikuti dengan
      jalur relatif repositori.
    
    

      Meneruskan jalur ini ke biner dan me-resolve-nya ke jalur sistem file menggunakan
      library runfile adalah pendekatan yang lebih disukai untuk menemukan dependensi pada
      runtime. Dibandingkan dengan rootpath, memiliki keunggulan bahwa
      dapat berfungsi di semua platform dan meskipun direktori runfile tidak
      tersedia.
    
    

      Ini memiliki persyaratan "hanya satu output" yang sama dengan execpath.
    
  

  

    location: Sinonim untuk execpath atau
    rootpath, bergantung pada atribut yang diperluas. Ini adalah
    perilaku lama pra-Starlark dan tidak direkomendasikan kecuali jika Anda benar-benar tahu
    fungsinya untuk aturan tertentu. Lihat #2475
    untuk mengetahui detailnya.
  



  execpaths, rootpaths, rlocationpaths,
  dan locations adalah variasi jamak dari execpath,
  rootpath, rlocationpath, danlocation. Fungsi ini mendukung label yang menghasilkan beberapa output, dengan setiap output dicantumkan dipisahkan spasi. Aturan output nol dan label yang salah formatnya
  akan menghasilkan error build.



  Semua label yang direferensikan harus muncul di srcs,
  file output, atau deps target yang menggunakan. Jika tidak, build akan gagal. Target C++ juga dapat
  mereferensikan label di data.



  Label tidak harus dalam bentuk kanonis: foo, :foo, dan //somepkg:foo semuanya baik.


Variabel kustom


  Variabel "Make" kustom dapat dirujuk oleh atribut apa pun yang ditandai sebagai
  "Tunduk pada penggantian 'Make variable'", tetapi hanya pada target yang
  bergantung pada target lain yang menentukan variabel ini.



  Sebagai praktik terbaik, semua variabel harus bersifat kustom, kecuali jika ada alasan yang sangat baik
  untuk memasukkannya ke dalam Bazel inti. Hal ini membuat Bazel tidak perlu memuat
  dependensi yang berpotensi mahal untuk menyediakan variabel yang mungkin tidak
  diperhatikan oleh target.


Variabel toolchain C++

  Berikut ini ditentukan dalam aturan toolchain C++ dan tersedia untuk aturan apa pun
  yang menetapkan toolchains =
  ["@bazel_tools//tools/cpp:toolchain_type"]
  Beberapa aturan, seperti java_binary, secara implisit
  menyertakan toolchain C++ dalam definisi aturannya. Class ini mewarisi variabel ini
  secara otomatis.



  Aturan C++ bawaan jauh lebih canggih daripada "menjalankan compiler di
  dalamnya". Untuk mendukung mode kompilasi yang beragam seperti *SAN, ThinLTO,
  dengan/tanpa modul, dan biner yang dioptimalkan dengan cermat sekaligus
  pengujian yang berjalan cepat di beberapa platform, aturan bawaan melakukan upaya
  maksimal untuk memastikan input, output, dan flag command line yang benar ditetapkan
  pada setiap tindakan yang berpotensi dihasilkan secara internal.



  Variabel ini adalah mekanisme penggantian yang akan digunakan oleh pakar bahasa dalam
  kasus yang jarang terjadi. Jika Anda tergoda untuk menggunakannya, hubungi developer Bazel terlebih dahulu.



  
ABI: Versi ABI C++. 

  
 AR: Perintah "ar" dari crosstool. 
  
 C_COMPILER:
    ID compiler C/C++, misalnya, llvm.
  
  

    
CC: Perintah compiler C dan C++.
    

      Sebaiknya selalu gunakan CC_FLAGS
      bersama dengan CC. Jika tidak melakukannya, Anda akan menanggung sendiri risikonya.
    
  
  
CC_FLAGS: Kumpulan flag minimum agar compiler
    C/C++ dapat digunakan oleh genrules. Secara khusus, ini berisi flag untuk
    memilih arsitektur yang benar jika CC mendukung beberapa
    arsitektur.
  


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

  
 NM: Perintah "nm" dari crosstool. 
  
 OBJCOPY: Perintah objcopy dari suite yang sama dengan compiler
    C/C++. 

  
 STRIP: Perintah strip dari suite yang sama dengan compiler
    C/C++.


Variabel toolchain Java


  Berikut ini ditentukan dalam aturan toolchain Java dan tersedia untuk aturan apa pun
  yang menetapkan toolchains =
["@rules_java//toolchains:current_java_runtime"] (atau
  "@rules_java//toolchains:current_host_java_runtime"
  untuk toolchain host yang setara).



  Sebagian besar alat di JDK tidak boleh digunakan secara langsung. Aturan Java bawaan
  menggunakan pendekatan yang jauh lebih canggih untuk kompilasi dan pengemasan Java
  daripada yang dapat diekspresikan oleh alat upstream, seperti Jar antarmuka, Jar antarmuka header, dan penerapan penggabungan serta pengemasan Jar yang sangat dioptimalkan.



  Variabel ini adalah mekanisme penggantian yang akan digunakan oleh pakar bahasa dalam
  kasus yang jarang terjadi. Jika Anda tergoda untuk menggunakannya, hubungi developer Bazel terlebih dahulu.



  
 JAVA: Perintah "java" (virtual machine
    Java). Hindari hal ini, dan gunakan aturan java_binary
    jika memungkinkan. Mungkin berupa jalur relatif. Jika harus mengubah direktori sebelum memanggil java, Anda harus mengambil direktori kerja sebelum mengubahnya.
  

  
JAVABASE: Direktori dasar yang berisi
    utilitas Java. Mungkin berupa jalur relatif. Direktori ini akan memiliki subdirektori "bin".
  


Variabel yang ditentukan Starlark


  Penulis aturan dan toolchain dapat menentukan
  variabel kustom sepenuhnya dengan menampilkan
  penyedia
  TemplateVariableInfo. Aturan apa pun yang bergantung pada atribut ini melalui
  toolchains kemudian dapat membaca nilainya:



  Lihat contoh variabel yang ditentukan Starlark.