config

Laporkan masalah Lihat sumber Nightly · 8.3 · 8.2 · 8.1 · 8.0 · 7.6

Ini adalah modul tingkat teratas untuk membuat transisi konfigurasi dan deskriptor setelan build yang menjelaskan jenis setelan build (jika ada) suatu aturan.

Contoh: aturan berikut ditandai sebagai setelan build dengan menyetel parameter build_setting dari fungsi rule(). Secara khusus, ini adalah setelan build berjenis 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 eksekusi 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, membatalkan setel semua tanda. Ditujukan untuk kasus ketika dependensi hanya berupa data dan tidak berisi kode yang perlu dibuat, tetapi hanya boleh dianalisis satu kali.

string

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

Setelan build berjenis string

Parameter

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

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; default adalah False
Apakah setelan build ini dapat dipanggil di command line atau tidak.
repeatable bool; default adalah False
Jika disetel, alih-alih mengharapkan nilai yang dipisahkan koma, tanda ini dapat disetel beberapa kali di command line dengan setiap nilai individual diperlakukan sebagai satu string untuk ditambahkan ke nilai daftar. Perjanjian pemasangan iklan dan nilai yang berulang dipertahankan. Daftar ini dapat diproses setelahnya dalam fungsi penerapan setelan build jika perilaku yang berbeda diinginkan.

target

transition config.target()

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