Tindakan
Perintah untuk dijalankan selama proses build, misalnya, panggilan ke compiler yang mengambil artefak sebagai input dan menghasilkan artefak lain sebagai output. Mencakup metadata seperti argumen command line, tombol tindakan, variabel lingkungan, dan artefak input/output yang dideklarasikan.
Lihat juga: Dokumentasi aturan
Cache tindakan
Cache di disk yang menyimpan pemetaan tindakan yang dieksekusi ke output yang dibuat. Kunci cache dikenal sebagai kunci tindakan. Komponen inti untuk model inkrementalitas Bazel. Cache disimpan dalam direktori dasar output dan dengan demikian bertahan dari mulai ulang server Bazel.
Grafik tindakan
Grafik tindakan dalam memori dan artefak yang
dibaca dan dihasilkan oleh tindakan ini. Grafik dapat mencakup artefak yang ada sebagai
file sumber (misalnya, dalam sistem file) serta artefak perantara/final yang dihasilkan
yang tidak disebutkan dalam file BUILD. Diproduksi
selama fase analisis dan digunakan selama fase
eksekusi.
Kueri grafik tindakan (kueri)
Alat kueri yang dapat mengkueri melalui tindakan build. Dengan begitu, Anda dapat menganalisis pengaruh terjemahan aturan build ke dalam build pekerjaan yang sebenarnya.
Tombol tindakan
Kunci cache tindakan. Dihitung berdasarkan metadata tindakan, yang dapat mencakup perintah untuk dieksekusi dalam tindakan, tanda compiler, lokasi library, atau header sistem, bergantung pada tindakan. Memungkinkan Bazel untuk meng-cache atau membatalkan tindakan individual secara deterministik.
Fase analisis
Fase kedua build. Memproses grafik target
yang ditentukan dalam file BUILD untuk menghasilkan grafik
tindakan dalam memori yang menentukan urutan tindakan yang akan dijalankan selama
fase eksekusi. Ini adalah fase di mana implementasi aturan dievaluasi.
Artefak
File sumber atau file yang dihasilkan. Juga dapat berupa direktori file, yang dikenal sebagai artefak pohon.
Artefak dapat menjadi input untuk beberapa tindakan, tetapi hanya boleh dihasilkan oleh maksimum satu tindakan.
Artefak yang sesuai dengan target file dapat ditangani oleh label.
Aspek
Mekanisme aturan untuk membuat tindakan tambahan dalam dependensinya. Misalnya, jika target A bergantung pada B, seseorang dapat menerapkan aspek pada
A yang melintasi tepi tepi dependensi ke B, dan menjalankan tindakan tambahan di B
untuk membuat dan mengumpulkan file output tambahan. Tindakan tambahan ini disimpan dalam cache dan digunakan kembali antar-target yang memerlukan aspek yang sama. Dibuat dengan
fungsi aspect() Starlark Build API. Dapat digunakan, misalnya, untuk menghasilkan
metadata untuk IDE, dan membuat tindakan untuk analisis lint.
Lihat juga: Dokumentasi aspek
Aspek (aspek)
Mekanisme komposisi yang aspeknya dapat diterapkan pada hasil
aspek lainnya. Misalnya, aspek yang menghasilkan informasi untuk digunakan oleh
IDE dapat diterapkan di atas aspek yang menghasilkan file .java dari
proto.
Agar aspek A diterapkan di atas aspek B, penyedia yang
diiklankan B dalam atribut provides
harus cocok dengan yang dideklarasikan A dalam keinginannya di atribut
required_aspect_providers.
Atribut
Parameter ke aturan, digunakan untuk mengekspresikan informasi build per target.
Contohnya mencakup srcs, deps, dan copts, yang masing-masing mendeklarasikan file sumber, dependensi, dan opsi compiler kustom target. Atribut khusus
yang tersedia untuk target tertentu bergantung pada jenis aturannya.
.bazel
File konfigurasi Bazel digunakan untuk mengubah nilai default untuk flag
startup dan flag perintah, serta untuk menentukan grup
opsi umum yang kemudian dapat ditetapkan bersama pada command line Bazel menggunakan
flag --config. Bazel dapat menggabungkan setelan dari beberapa file bazel (seluruh sistem, per ruang kerja, per pengguna, atau dari lokasi khusus), dan file bazelrc juga dapat mengimpor setelan dari file bazelrc lainnya.
Blaze
Versi internal Bazel Google. Sistem build utama Google untuk repositori mononya.
File BUILD
File BUILD adalah file konfigurasi utama yang memberi tahu Bazel output software
apa yang harus dibuat, apa dependensinya, dan cara mem-build-nya. Bazel
mengambil file BUILD sebagai input dan menggunakan file tersebut untuk membuat grafik dependensi
dan untuk mendapatkan tindakan yang harus diselesaikan untuk mem-build output software
menengah dan final. File BUILD akan menandai direktori dan setiap subdirektori yang
tidak berisi file BUILD sebagai paket, dan dapat berisi
target yang dibuat oleh aturan. File juga dapat diberi nama
BUILD.bazel.
File BUILD.bazel
Lihat File BUILD. Diutamakan daripada file BUILD di direktori yang sama.
File .bzl
File yang menentukan aturan, makro, dan konstanta yang ditulis dalam
Starlark. File tersebut kemudian dapat diimpor ke file
BUILD menggunakan fungsi load().
Membuat grafik
Grafik dependensi yang dibuat dan dilacak oleh Bazel untuk melakukan build. Mencakup node seperti target, target yang dikonfigurasi, tindakan, dan artefak. Build dianggap selesai jika semua artefak yang memiliki kumpulan target yang diminta diverifikasi sebagai versi terbaru.
Setelan build
Sepotong konfigurasi yang ditentukan oleh Starlark. Transisi dapat menyetel setelan build untuk mengubah konfigurasi subgrafik. Jika ditampilkan kepada pengguna sebagai flag command line, juga dikenal sebagai flag build.
Bersihkan build
Build yang tidak menggunakan hasil build sebelumnya. Biasanya ini lebih lambat daripada build inkremental tetapi umumnya dianggap lebih benar. Bazel menjamin bahwa build bersih dan inkremental selalu benar.
Model klien-server
Klien command line bazel otomatis memulai server latar belakang pada komputer lokal untuk menjalankan perintah Bazel. Server tetap dipertahankan di seluruh perintah, tetapi otomatis berhenti setelah tidak aktif selama beberapa waktu (atau secara eksplisit melalui penonaktifan Bazel). Membagi Bazel ke dalam server dan klien akan membantu mengamortisasi waktu startup
JVM serta mendukung build inkremental
yang lebih cepat karena grafik tindakan tetap berada dalam memori di seluruh perintah.
Perintah
Digunakan pada command line untuk memanggil fungsi Bazel yang berbeda, seperti bazel
build, bazel test, bazel run, dan bazel query.
Flag perintah
Sekumpulan flag khusus untuk perintah. Tanda perintah ditentukan
setelah perintah (bazel build <command flags>). Tanda dapat diterapkan ke
satu atau beberapa perintah. Misalnya, --configure adalah flag khusus untuk perintah bazel sync, tetapi --keep_going berlaku untuk sync, build, test, dan lainnya. Flag sering digunakan untuk tujuan konfigurasi, sehingga perubahan nilai flag dapat menyebabkan Bazel membatalkan grafik dalam memori
dan memulai ulang fase analisis.
Konfigurasi
Informasi di luar definisi aturan yang memengaruhi cara aturan menghasilkan tindakan. Setiap build memiliki setidaknya satu konfigurasi yang menentukan platform target, variabel lingkungan tindakan, dan flag build command line. Transisi dapat membuat konfigurasi tambahan, seperti untuk alat host atau kompilasi silang.
Lihat juga: Konfigurasi
Pemangkasan konfigurasi
Proses untuk hanya menyertakan bagian konfigurasi yang benar-benar diperlukan oleh target. Misalnya, jika Anda mem-build biner Java //:j dengan dependensi C++ //:c, tidak ada gunanya menyertakan nilai --javacopt dalam konfigurasi //:c karena mengubah --javacopt secara tidak perlu akan merusak cache build C++.
Kueri yang dikonfigurasi (cquery)
Alat kueri yang membuat kueri pada target
yang dikonfigurasi (setelah fase analisis
selesai). Ini berarti select() dan flag build (seperti
--platforms) tercermin secara akurat dalam hasil.
Lihat juga: dokumentasi cquery
Target dikonfigurasi
Hasil evaluasi target dengan konfigurasi. Fase analisis menghasilkan
hal ini dengan menggabungkan opsi build dengan target yang perlu di-build.
Misalnya, jika //:foo di-build untuk dua arsitektur yang berbeda dalam build
yang sama, ia memiliki dua target yang dikonfigurasi: <//:foo, x86> dan <//:foo, arm>.
Ketepatan
Build menjadi benar jika outputnya dengan tepat mencerminkan status input transitifnya. Untuk mencapai build yang benar, Bazel berupaya untuk hermetic, dapat direproduksi, dan membuat analisis build serta eksekusi tindakan deterministik.
Dependensi
Tepi terarah di antara dua target. //:foo target memiliki dependensi
target pada //:bar target jika nilai atribut //:foo berisi
referensi ke //:bar. //:foo memiliki dependensi tindakan pada //:bar jika
tindakan dalam //:foo bergantung pada artefak input yang dibuat oleh
tindakan dalam //:bar.
Depset
Struktur data untuk mengumpulkan data tentang dependensi transitif. Dioptimalkan agar penggabungan dependensi menghemat waktu dan ruang, karena sangat umum untuk memiliki depset yang sangat besar (ratusan ribu file). Diimplementasikan untuk merujuk ke depset lainnya secara rekursif karena alasan efisiensi ruang. Implementasi aturan tidak boleh "meratakan" depset dengan mengonversinya menjadi daftar kecuali aturan tersebut berada di tingkat teratas grafik build. Meratakan depset besar menimbulkan penggunaan memori yang besar. Juga dikenal sebagai kumpulan bertingkat dalam implementasi internal Bazel.
Lihat juga: Dokumentasi depset
Cache disk
Penyimpanan blob di disk lokal untuk fitur cache jarak jauh. Dapat digunakan bersama toko blob jarak jauh yang sebenarnya.
Distdir
Direktori hanya baca yang berisi file yang akan diambil Bazel dari internet menggunakan aturan repositori. Memungkinkan build dijalankan sepenuhnya secara offline.
Eksekusi dinamis
Strategi eksekusi yang memilih antara eksekusi lokal dan jarak jauh berdasarkan berbagai heuristik, dan menggunakan hasil eksekusi dari metode yang lebih cepat berhasil. Tindakan tertentu dieksekusi lebih cepat secara lokal (misalnya, menautkan) dan yang lainnya lebih cepat dari jarak jauh (misalnya, kompilasi yang sangat paralel). Strategi eksekusi dinamis dapat memberikan waktu build inkremental dan bersih terbaik.
Fase eksekusi
Fase ketiga build. Mengeksekusi tindakan dalam grafik tindakan yang dibuat selama fase analisis. Tindakan ini memanggil file yang dapat dieksekusi (compiler, skrip) untuk membaca dan menulis artefak. Strategi spawn mengontrol cara eksekusi tindakan ini: secara lokal, jarak jauh, dinamis, sandbox, docker, dan sebagainya.
Root eksekusi
Direktori di direktori output base
workspace tempat tindakan lokal dieksekusi dalam
build non-sandbox. Konten direktori pada dasarnya adalah symlink
artefak input dari ruang kerja. Root eksekusi juga
berisi symlink ke repositori eksternal sebagai input lain dan direktori bazel-out
untuk menyimpan output. Disiapkan selama fase pemuatan
dengan membuat hutan symlink direktori yang mewakili penutupan
transitif paket yang bergantung pada build. Dapat diakses dengan bazel info
execution_root pada command line.
File
Lihat Artefak.
Hermetik
Build bersifat hermetic jika tidak ada pengaruh eksternal pada operasi build dan pengujiannya, yang membantu memastikan bahwa hasilnya bersifat deterministik dan benar. Misalnya, build hermetic biasanya melarang akses jaringan ke tindakan, membatasi akses ke input yang dideklarasikan, menggunakan stempel waktu dan zona waktu tetap, membatasi akses ke variabel lingkungan, dan menggunakan seed tetap untuk generator angka acak
Build inkremental
Build inkremental menggunakan kembali hasil build sebelumnya untuk mengurangi waktu build dan penggunaan resource. Pemeriksaan dependensi dan cache bertujuan untuk memberikan hasil yang benar bagi jenis build ini. Build inkremental adalah kebalikan dari build bersih.
Label
ID untuk target. Label yang sepenuhnya memenuhi syarat seperti
//path/to/package:target terdiri dari // untuk menandai direktori utama
ruang kerja, path/to/package sebagai direktori yang berisi file
BUILD yang mendeklarasikan target, dan :target sebagai nama target
yang dideklarasikan dalam file BUILD tersebut. Dapat juga diawali dengan
@my_repository//<..> untuk menunjukkan bahwa target dideklarasikan dalam repositori
eksternal bernama my_repository.
Fase pemuatan
Fase pertama build di mana Bazel mengurai file WORKSPACE, BUILD, dan .bzl untuk membuat paket. Makro dan fungsi
tertentu seperti glob() dievaluasi dalam fase ini. Disisipkan dengan fase kedua
build, fase analisis, untuk membuat grafik
target.
Macro
Mekanisme untuk membuat beberapa deklarasi target aturan bersama dalam satu fungsi Starlark. Mengaktifkan penggunaan kembali pola deklarasi aturan umum di seluruh file BUILD. Diperluas ke deklarasi target aturan yang mendasarinya
selama fase pemuatan.
Lihat juga: Dokumentasi makro
Mnemonik
String pendek yang dapat dibaca manusia yang dipilih oleh penulis aturan untuk memahami dengan cepat apa yang dilakukan oleh tindakan dalam aturan. Mnemonik dapat digunakan sebagai
ID untuk pilihan strategi spawn. Beberapa contoh mnemonik tindakan adalah Javac dari aturan Java, CppCompile dari aturan C++, dan AndroidManifestMerger dari aturan Android.
Aturan native
Aturan yang disertakan dalam Bazel dan diterapkan di Java. Aturan tersebut muncul di file .bzl sebagai fungsi dalam modul native (misalnya, native.cc_library atau native.java_library). Aturan yang ditentukan pengguna (non-native) dibuat menggunakan Starlark.
Basis output
Direktori khusus workspace untuk menyimpan file output Bazel. Digunakan untuk memisahkan output dari hierarki sumber workspace. Terletak di root pengguna output.
Grup output
Sekelompok file yang diperkirakan akan dibuat saat Bazel selesai mem-build target. Aturan menempatkan output biasa di "grup output default" (misalnya, file .jar dari java_library, .a, dan .so untuk target cc_library). Grup output default adalah grup output yang artefak-nya dibuat saat target diminta pada command line.
Aturan dapat menentukan lebih banyak grup output bernama yang dapat ditentukan secara eksplisit dalam file BUILD (aturan filegroup) atau command line (flag --output_groups).
Root pengguna output
Direktori khusus pengguna untuk menyimpan output Bazel. Nama direktori berasal dari nama pengguna sistem pengguna. Mencegah konflik file output jika beberapa pengguna membuat project yang sama di sistem secara bersamaan. Berisi subdirektori yang sesuai dengan output build setiap ruang kerja, juga dikenal sebagai dasar output.
Paket
Kumpulan target yang ditentukan oleh file BUILD. Nama
paket adalah jalur file BUILD yang relatif terhadap root ruang kerja. Paket
dapat berisi sub-paket, atau subdirektori yang berisi file BUILD,
yang akan membentuk hierarki paket.
Grup paket
Target yang mewakili serangkaian paket. Sering digunakan dalam nilai atribut
visibility.
Platform
"Jenis mesin" yang terlibat dalam build. Ini termasuk mesin yang dijalankan Bazel (platform "host"), mesin build mesin yang dijalankan pada platform "platform exec"), dan target mesin dibuat untuk ("platform target").
Penyedia
Skema yang menjelaskan unit informasi untuk diteruskan di antara target aturan bersama hubungan dependensi. Biasanya informasi ini
berisi informasi seperti opsi compiler, file sumber atau output transitif,
dan metadata build. Sering digunakan bersamaan dengan depset untuk
menyimpan data transitif terakumulasi secara efisien. Contoh penyedia bawaan
adalah DefaultInfo.
Lihat juga: Dokumentasi penyedia
Kueri (konsep)
Proses analisis grafik build untuk memahami properti target dan struktur dependensi. Bazel mendukung tiga varian kueri: query, cquery, dan aquery.
kueri (perintah)
Alat query yang beroperasi pada tahap build-pemuatan fase grafik target. Relatif cepat, tetapi tidak dapat menganalisis efek select(), flag build, artefak, atau tindakan build.
Lihat juga: Petunjuk kueri, Referensi kueri
Cache repositori
Cache file konten bersama yang dapat dialamatkan oleh file yang didownload oleh Bazel untuk build, dapat dibagikan di seluruh ruang kerja. Mengaktifkan build offline setelah
download awal. Biasanya digunakan untuk meng-cache file yang didownload melalui aturan repositori seperti http_archive dan API aturan repositori seperti repository_ctx.download. File hanya di-cache jika checksum SHA-256 ditentukan untuk download.
Produktivitas
Properti build atau pengujian bahwa sekumpulan input ke build atau pengujian akan selalu menghasilkan kumpulan output yang sama setiap saat, terlepas dari waktu, metode, atau lingkungannya. Perlu diketahui bahwa ini tidak selalu menyiratkan bahwa output benar atau output yang diinginkan.
Aturan
Skema untuk menentukan target aturan dalam file BUILD, seperti cc_library. Dari perspektif penulis file BUILD, aturan terdiri dari
serangkaian atribut dan logika kotak hitam. Logika tersebut memberi tahu
aturan untuk menargetkan cara menghasilkan artefak output dan meneruskan informasi ke
target aturan lainnya. Dari perspektif penulis .bzl, aturan adalah
cara utama untuk memperluas Bazel guna mendukung bahasa dan
lingkungan pemrograman baru.
Aturan dibuat untuk menghasilkan target aturan dalam fase pemuatan. Pada aturan fase analisis, target menyampaikan informasi ke dependensi downstream-nya dalam bentuk penyedia, dan mendaftarkan tindakan yang menjelaskan cara membuat artefak output. Tindakan ini dijalankan dalam fase eksekusi.
Lihat juga: Dokumentasi aturan
Target aturan
Target yang merupakan instance dari aturan. Berbeda dengan target file dan grup paket. Harap bedakan dengan aturan.
File run
Dependensi runtime dari target yang dapat dieksekusi. Biasanya, yang dapat dieksekusi adalah output aturan pengujian yang dapat dieksekusi, dan runfile adalah dependensi data runtime dari pengujian. Sebelum pemanggilan file yang dapat dieksekusi (selama pengujian Bazel), Bazel menyiapkan hierarki runfile bersama pengujian yang dapat dieksekusi sesuai dengan struktur direktori sumbernya.
Lihat juga: Dokumentasi runfiles
Sandboxing
Teknik untuk mengisolasi tindakan yang berjalan di dalam root eksekusi yang dibatasi dan sementara, membantu memastikan bahwa tindakan tersebut tidak membaca input yang tidak dideklarasikan atau menulis output yang tidak dideklarasikan. Sandbox sangat meningkatkan hermeticity, tetapi biasanya memiliki biaya performa, dan memerlukan dukungan dari sistem operasi. Biaya performa bergantung pada platform. Di Linux, ini tidak signifikan, tetapi di macOS dapat membuat sandbox tidak dapat digunakan.
Bingkai Langit
Skyframe adalah framework evaluasi inti, fungsional, dan inkremental Bazel.
Pengecapan
Fitur untuk menyematkan informasi tambahan ke dalam artefak yang dibuat oleh Bazel. Misalnya, ini dapat digunakan untuk kontrol sumber, waktu
build, dan informasi ruang kerja atau lingkungan lainnya untuk build rilis.
Aktifkan melalui flag --workspace_status_command dan aturan yang
mendukung atribut stempel.
Burung lark
Bahasa ekstensi untuk menulis aturan dan makro. Subset Python yang dibatasi (secara sintaksis dan tata bahasa) yang ditujukan untuk
tujuan konfigurasi, dan untuk performa yang lebih baik. Menggunakan ekstensi file
.bzl. File BUILD menggunakan versi Starlark yang lebih terbatas (seperti tidak ada definisi fungsi def), sebelumnya dikenal sebagai Skylark.
Lihat juga: Dokumentasi bahasa Starlark
Flag startup
Kumpulan flag yang ditentukan antara bazel dan perintah, misalnya, build --host_jvm_debug bazel. Flag ini mengubah konfigurasi server Bazel, sehingga setiap perubahan pada flag startup menyebabkan server dimulai ulang. Flag startup tidak bersifat khusus untuk perintah apa pun.
Target
Objek yang ditentukan dalam file BUILD dan diidentifikasi oleh label. Target mewakili unit ruang kerja yang dapat di-build dari
perspektif pengguna akhir.
Target yang dideklarasikan dengan membuat instance aturan disebut target aturan. Bergantung pada aturannya, target tersebut mungkin dapat dijalankan (seperti
cc_binary) atau dapat diuji (seperti cc_test). Target aturan biasanya bergantung pada
target lain melalui atributnya (seperti deps); dependensi
ini membentuk dasar grafik target.
Selain target aturan, ada juga target file dan target grup paket. Target file sesuai dengan artefak yang direferensikan
dalam file BUILD. Sebagai kasus khusus, file BUILD paket apa pun
selalu dianggap sebagai target file sumber dalam paket tersebut.
Target ditemukan selama fase pemuatan. Selama fase analisis, target dikaitkan dengan konfigurasi build untuk membentuk target yang dikonfigurasi.
Grafik target
Grafik dalam memori dari target dan dependensinya. Diproduksi selama fase pemuatan dan digunakan sebagai input untuk fase analisis.
Pola target
Cara untuk menentukan grup target pada command line. Pola yang biasa digunakan adalah :all (semua target aturan), :* (semua target aturan + file), ... (paket saat ini, dan semua sub-paket secara rekursif). Dapat digunakan
dalam kombinasi, misalnya, //...:* berarti semua target aturan dan file di semua
paket secara rekursif dari root ruang kerja.
Pengujian
Aturan target yang dibuat instance-nya dari aturan pengujian, sehingga berisi pengujian yang dapat dieksekusi. Kode pengembalian nol dari penyelesaian file yang dapat dieksekusi menunjukkan keberhasilan pengujian. Kontrak yang tepat antara Bazel dan pengujian (seperti variabel lingkungan pengujian, metode pengumpulan hasil pengujian) ditentukan dalam Encyclopedia Pengujian.
Toolchain
Sekumpulan alat untuk membuat output untuk suatu bahasa. Biasanya, toolchain menyertakan compiler, penaut, penafsir, atau/dan linter. Toolchain juga dapat bervariasi menurut platform, yaitu, komponen toolchain compiler Unix dapat berbeda untuk varian Windows, meskipun toolchain ditujukan untuk bahasa yang sama. Pemilihan toolchain yang tepat untuk platform dikenal sebagai resolusi toolchain.
Target tingkat teratas
Target build adalah level teratas jika diminta pada command line Bazel. Misalnya, jika //:foo bergantung pada //:bar, dan bazel build //:foo
dipanggil, maka untuk build ini, //:foo adalah level teratas, dan //:bar bukan
level atas, meskipun kedua target harus dibuat. Perbedaan penting
antara target level teratas dan non-tingkat atas adalah bahwa flag
perintah yang ditetapkan pada command line Bazel (atau melalui
.bazelrc) akan menetapkan konfigurasi untuk target
level atas, tetapi mungkin dimodifikasi oleh transisi untuk target
non-tingkat atas.
Transition
Pemetaan status konfigurasi dari satu nilai ke nilai lain. Mengaktifkan target dalam grafik build agar memiliki konfigurasi yang berbeda, meskipun instance-nya dibuat dari aturan yang sama. Penggunaan umum transisi adalah dengan transisi terpisah, saat bagian tertentu dari grafik target diambil dengan konfigurasi yang berbeda untuk setiap fork. Misalnya, pengguna dapat mem-build APK Android dengan biner native yang dikompilasi untuk ARM dan x86 menggunakan transisi terpisah dalam satu build.
Lihat juga: Transisi yang ditentukan pengguna
Artefak pohon
Artefak yang mewakili kumpulan file. Karena file ini sendiri bukan artefak, tindakan yang beroperasi pada file tersebut harus mendaftarkan artefak hierarki sebagai input atau outputnya.
Visibilitas
Salah satu dari dua mekanisme untuk mencegah dependensi yang tidak diinginkan dalam sistem build:
visibilitas target untuk mengontrol apakah target dapat diandalkan
oleh target lainnya; dan memuat visibilitas untuk mengontrol apakah file BUILD
atau .bzl dapat memuat file .bzl tertentu. Tanpa konteks, biasanya
"visibilitas" mengacu pada visibilitas target.
Lihat juga: Dokumentasi visibilitas
Ruang Kerja
Direktori yang berisi file WORKSPACE dan kode sumber untuk software yang
ingin Anda buat. Label yang dimulai dengan // relatif terhadap direktori
ruang kerja.
File WORKSPACE
Menentukan direktori menjadi ruang kerja. File tersebut boleh kosong, meskipun biasanya berisi deklarasi repositori eksternal untuk mengambil dependensi tambahan dari jaringan atau sistem file lokal.