cấu hình

Đây là một mô-đun cấp cao nhất để tạo quá trình chuyển đổi cấu hình và mô tả cài đặt bản dựng. Mô-đun này mô tả loại cài đặt bản dựng (nếu có) mà một quy tắc là.

ví dụ: quy tắc sau được đánh dấu là 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à cài đặt bản dựng thuộc loại int và là một flag, có nghĩa là 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
• exec
• int
• none
• string
• string_list
• mục tiêu

bool

BuildSetting config.bool(flag=False)

Cài đặt bản dựng thuộc loại bool

Thông số

Tham số	Mô tả
flag	bool; giá trị mặc định là False 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.

Thông số

Tham số	Mô tả
exec_group	string; hoặc None; giá trị mặc định là None Tên của nhóm thực thi mà quá trình chuyển đổi này sẽ sử dụng nền tảng thực thi. 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)

Cài đặt bản dựng thuộc loại số nguyên

Thông số

Tham số	Mô tả
flag	bool; giá trị mặc định là False Cài đặt bản dựng này có thể gọi được trên dòng lệnh hay không.

none

transition config.none()

Tạo quá trình chuyển đổi giúp xoá tất cả cấu hình, huỷ đặt tất cả cờ. Dành cho trường hợp phần phụ thuộc chỉ có dữ liệu và không chứa mã cần xây dựng, nhưng chỉ nên phân tích một lần.

chuỗi

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

Cài đặt bản dựng thuộc loại chuỗi

Thông số

Tham số	Mô tả
flag	bool; giá trị mặc định là False 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	bool; giá trị mặc định là False Không dùng nữa, hãy sử dụng chế độ cài đặt string_list với repeatable = True thay thế. Nếu được đặt, cờ này có thể được đặ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 chuỗi. Cả thứ tự chèn và giá trị lặp lại đều được duy trì. Bạn có thể xử lý danh sách này sau trong hàm triển khai 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)

Cài đặt bản dựng thuộc loại danh sách chuỗi. Trên dòng lệnh, hãy truyền một danh sách bằng cách sử dụng giá trị được phân tách bằng dấu phẩy như --//my/setting=foo,bar.

Thông số

Tham số	Mô tả
flag	bool; giá trị mặc định là False Cài đặt bản dựng này có thể gọi được trên dòng lệnh hay không.
repeatable	bool; giá trị mặc định là False Nếu được đặt, thay vì mong đợi một giá trị được phân tách bằng dấu phẩy, cờ này có thể được đặ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ả thứ tự chèn và giá trị lặp lại đều được duy trì. Bạn có thể xử lý danh sách này sau trong hàm triển khai cài đặt bản dựng nếu muốn có hành vi khác.

mục tiêu

transition config.target()

Tạo quá trình chuyển đổi mục tiêu. Đây là quá trình chuyển đổi không hoạt động, dành cho trường hợp cần có đối tượng chuyển đổi nhưng không muốn thực sự thay đổi bất cứ điều gì. Tương đương với cfg = "target" trong attr.label().