ví dụ: quy tắc sau đây được đánh dấu là chế độ cài đặt bản dựng bằng cách đặt tham số build_setting
của hàm rule()
. Cụ thể, đây là một chế độ cài đặt bản dựng thuộc loại int
và là một flag
, nghĩa là chế độ cài đặt bản dựng này có thể gọi được trên dòng lệnh.
my_rule = rule( implementation = _impl, build_setting = config.int(flag = True), ... )
Hội viên
bool
BuildSetting config.bool(flag=False)Chế độ cài đặt bản dựng được nhập kiểu bool
Các tham số
Thông số | Nội dung mô tả |
---|---|
flag
|
mặc định = Sai Liệu chế độ cài đặt bản dựng này có thể gọi được trên dòng lệnh hay không. |
exec
ExecTransitionFactory config.exec(exec_group=None)Tạo quá trình chuyển đổi thực thi.
Các tham số
Thông số | Nội dung mô tả |
---|---|
exec_group
|
string; or None ;
mặc định = KhôngTên của nhóm thực thi có nền tảng thực thi mà quá trình chuyển đổi này sẽ sử dụng. Nếu không được cung cấp, quá trình chuyển đổi thực thi này sẽ sử dụng nền tảng thực thi mặc định của mục tiêu. |
int
BuildSetting config.int(flag=False)Chế độ cài đặt bản dựng nhập số nguyên
Các tham số
Thông số | Nội dung mô tả |
---|---|
flag
|
mặc định = Sai Liệu chế độ cài đặt bản dựng này có thể gọi được trên dòng lệnh hay không. |
string
BuildSetting config.string(flag=False, allow_multiple=False)Chế độ cài đặt bản dựng dạng chuỗi
Các tham số
Thông số | Nội dung mô tả |
---|---|
flag
|
mặc định = Sai Liệu chế độ cài đặt bản dựng này có thể gọi được trên dòng lệnh hay không. |
allow_multiple
|
mặc định = Sai Không dùng nữa, hãy sử dụng chế độ cài đặt string_list với repeatable = True . Nếu được đặt, cờ này sẽ được phép đặt nhiều lần trên dòng lệnh. Giá trị của cờ khi được truy cập trong quá trình chuyển đổi và hàm triển khai cài đặt bản dựng sẽ là một danh sách các chuỗi. Các giá trị lặp lại và thứ tự chèn đều được duy trì. Danh sách này có thể được xử lý hậu trong hàm triển khai chế độ cài đặt bản dựng nếu muốn có hành vi khác.
|
string_list
BuildSetting config.string_list(flag=False, repeatable=False)Chế độ cài đặt bản dựng dạng danh sách chuỗi. Trên dòng lệnh, hãy chuyển một danh sách sử dụng giá trị được phân tách bằng dấu phẩy như "--//my/setting=foo,bar".
Các tham số
Thông số | Nội dung mô tả |
---|---|
flag
|
mặc định = Sai Liệu chế độ cài đặt bản dựng này có thể gọi được trên dòng lệnh hay không. |
repeatable
|
mặc định = Sai Nếu bạn đặt, thay vì mong đợi giá trị được phân tách bằng dấu phẩy, cờ này được phép đặt nhiều lần trên dòng lệnh với mỗi giá trị riêng lẻ được coi là một chuỗi duy nhất để thêm vào giá trị danh sách. Các giá trị lặp lại và thứ tự chèn đều được duy trì. Danh sách này có thể được xử lý hậu trong hàm triển khai chế độ cài đặt bản dựng nếu muốn có hành vi khác. |