Berikut adalah beberapa masalah dan pertanyaan umum terkait ekstensi penulisan.
Mengapa file saya tidak dibuat / tindakan saya tidak pernah dijalankan?
Bazel hanya mengeksekusi tindakan yang diperlukan untuk menghasilkan file output yang diminta.
Jika file yang Anda inginkan memiliki label, Anda dapat memintanya secara langsung:
bazel build //pkg:myfile.txtJika file berada dalam grup output target, Anda mungkin perlu menentukan grup output tersebut di command line:
bazel build //pkg:mytarget --output_groups=fooJika Anda ingin file dibuat secara otomatis setiap kali target Anda disebutkan di command line, tambahkan file tersebut ke output default aturan dengan menampilkan penyedia
DefaultInfo.
Lihat halaman Aturan untuk mengetahui informasi selengkapnya.
Mengapa fungsi penerapan saya tidak dieksekusi?
Bazel hanya menganalisis target yang diminta untuk build. Anda harus memberi nama target di command line, atau sesuatu yang bergantung pada target.
File tidak ada saat tindakan atau biner saya dieksekusi
Pastikan bahwa 1) file telah terdaftar sebagai input ke tindakan atau biner, dan 2) skrip atau alat yang dijalankan mengakses file menggunakan jalur yang benar.
Untuk tindakan, Anda mendeklarasikan input dengan meneruskannya ke fungsi ctx.actions.*
yang membuat tindakan. Jalur yang tepat untuk file dapat diperoleh menggunakan
File.path.
Untuk biner (output yang dapat dieksekusi yang dijalankan oleh perintah bazel run atau bazel test), Anda mendeklarasikan input dengan menyertakannya dalam
runfiles. Daripada menggunakan kolom path, gunakan
File.short_path, yang merupakan jalur file relatif terhadap
direktori runfile tempat biner dieksekusi.
Bagaimana cara mengontrol file yang di-build oleh bazel build //pkg:mytarget?
Gunakan penyedia DefaultInfo untuk
menetapkan output default.
Bagaimana cara menjalankan program atau melakukan I/O file sebagai bagian dari build saya?
Alat dapat dideklarasikan sebagai target, seperti bagian build lainnya, dan
berjalan selama fase eksekusi untuk membantu mem-build target lainnya. Untuk membuat tindakan
yang menjalankan alat, gunakan ctx.actions.run dan teruskan
alat sebagai parameter executable.
Selama fase pemuatan dan analisis, alat tidak dapat berjalan, dan Anda juga tidak dapat melakukan I/O file. Artinya, alat dan konten file (kecuali konten file BUILD dan .bzl) tidak dapat memengaruhi cara pembuatan grafik target dan tindakan.
Bagaimana jika saya perlu mengakses data terstruktur yang sama sebelum dan selama fase eksekusi?
Anda dapat memformat data terstruktur sebagai file .bzl. Anda dapat load() file untuk
mengaksesnya selama fase pemuatan dan analisis. Anda dapat meneruskannya sebagai input atau
runfile ke tindakan dan file yang dapat dieksekusi yang memerlukannya selama fase eksekusi.
Bagaimana cara mendokumentasikan kode Starlark?
Untuk aturan dan atribut aturan, Anda dapat meneruskan literal docstring (mungkin
dengan tanda petik tiga) ke parameter doc dari rule atau attr.*(). Untuk fungsi dan makro
helper, gunakan literal docstring dengan tanda petik tiga mengikuti format
yang diberikan di sini.
Fungsi penerapan aturan umumnya tidak memerlukan docstring sendiri.
Menggunakan literal string di tempat yang diharapkan akan mempermudah alat otomatis untuk mengekstrak dokumentasi. Jangan ragu untuk menggunakan komentar non-string standar di mana pun yang dapat membantu pembaca kode Anda.