config

.

Ini adalah modul tingkat atas untuk membuat transisi konfigurasi dan deskripsi setelan build yang menjelaskan jenis setelan build (jika ada) yang merupakan aturan.

misalnya: aturan berikut ditandai sebagai setelan build dengan menetapkan parameter build_setting dari fungsi rule(). Secara khusus, ini adalah setelan build dari jenis int dan merupakan flag yang berarti setelan build ini dapat dipanggil di command line.

  my_rule = rule(
    implementation = _impl,
    build_setting = config.int(flag = True),
    ...
  )

Anggota

bool

BuildSetting config.bool(flag=False)

Setelan build berjenis bool

Parameter

Parameter Deskripsi
flag bool; default adalah False
Apakah setelan build ini dapat dipanggil di command line atau tidak.

exec

ExecTransitionFactory config.exec(exec_group=None)

Membuat transisi eksekusi.

Parameter

Parameter Deskripsi
exec_group string; atau None; default adalah None
Nama grup exec yang platform eksekusinya akan digunakan oleh transisi ini. Jika tidak disediakan, transisi eksekusi ini akan menggunakan platform eksekusi default target.

int

BuildSetting config.int(flag=False)

Setelan build berjenis bilangan bulat

Parameter

Parameter Deskripsi
flag bool; default adalah False
Apakah setelan build ini dapat dipanggil di command line atau tidak.

tidak ada

transition config.none()

Membuat transisi yang menghapus semua konfigurasi, yang membatalkan setelan semua tanda. Dimaksudkan untuk kasus saat dependensi hanya berisi data dan tidak berisi kode yang perlu di-build, tetapi hanya boleh dianalisis satu kali.

string

BuildSetting config.string(flag=False, allow_multiple=False)

Setelan build berjenis string

Parameter

Parameter Deskripsi
flag bool; defaultnya adalah False
Apakah setelan build ini dapat dipanggil di command line atau tidak.
allow_multiple bool; defaultnya adalah False
Tidak digunakan lagi, sebagai gantinya gunakan setelan string_list dengan repeatable = True. Jika ditetapkan, tanda ini diizinkan untuk ditetapkan beberapa kali di command line. Nilai tanda seperti yang diakses dalam transisi dan fungsi implementasi setelan build akan berupa daftar string. Perjanjian pemasangan iklan dan nilai berulang dipertahankan. Daftar ini dapat diproses kembali dalam fungsi penerapan setelan build jika menginginkan perilaku yang berbeda.

string_list

BuildSetting config.string_list(flag=False, repeatable=False)

Setelan build berjenis daftar string. Di command line, teruskan daftar menggunakan nilai yang dipisahkan koma seperti --//my/setting=foo,bar.

Parameter

Parameter Deskripsi
flag bool; defaultnya adalah False
Apakah setelan build ini dapat dipanggil di command line atau tidak.
repeatable bool; defaultnya adalah False
Jika ditetapkan, tanda ini diizinkan untuk disetel beberapa kali pada command line dengan setiap nilai diperlakukan sebagai string tunggal untuk ditambahkan ke nilai daftar, bukan mengharapkan nilai yang dipisahkan koma. Perjanjian pemasangan iklan dan nilai berulang dipertahankan. Daftar ini dapat diproses pasca-pemrosesan dalam fungsi implementasi setelan build jika perilaku yang berbeda diinginkan.

target

transition config.target()

Membuat transisi target. Ini adalah transisi tanpa operasi yang ditujukan untuk kasus saat objek transisi diperlukan, tetapi tidak ingin benar-benar mengubah apa pun. Setara dengan cfg = "target" di attr.label().