chuyển đổi

Biểu thị một quá trình chuyển đổi cấu hình trên một cạnh của phần phụ thuộc. Ví dụ: nếu //package:foo phụ thuộc vào //package:bar với một quá trình chuyển đổi cấu hình, thì cấu hình của //package:bar (và các phần phụ thuộc của nó) sẽ là cấu hình của //package:foo cộng với các thay đổi do hàm chuyển đổi chỉ định.

Hội viên

chuyển cảnh

transition transition(*, implementation, inputs, outputs)

Một quá trình chuyển đổi đọc một tập hợp các chế độ cài đặt bản dựng đầu vào và ghi một tập hợp các chế độ cài đặt bản dựng đầu ra.

Ví dụ:

def _transition_impl(settings, attr):
    # This transition just reads the current CPU value as a demonstration.
    # A real transition could incorporate this into its followup logic.
    current_cpu = settings["//command_line_option:cpu"]
    return {"//command_line_option:compilation_mode": "dbg"}

build_in_debug_mode = transition(
    implementation = _transition_impl,
    inputs = ["//command_line_option:cpu"],
    outputs = ["//command_line_option:compilation_mode"],
)

Để biết thêm chi tiết, vui lòng xem tại đây.

Thông số

Tham số Mô tả
implementation callable; required
Hàm triển khai quá trình chuyển đổi này. Hàm này luôn có hai tham số: settings và attr. Tham số settings là một từ điển có tập hợp khoá được xác định bằng tham số đầu vào. Vì vậy, đối với mỗi chế độ cài đặt bản dựng --//foo=bar, nếu inputs chứa //foo, thì settings sẽ có một mục nhập settings['//foo']='bar'.

Tham số attr là một tham chiếu đến ctx.attr. Điều này cho phép hàm triển khai truy cập vào các thuộc tính của quy tắc để có thể thực hiện các quá trình chuyển đổi được tham số hoá theo thuộc tính.

Hàm này phải trả về một dict từ giá trị nhận dạng chế độ cài đặt bản dựng đến giá trị chế độ cài đặt bản dựng; điều này thể hiện quá trình chuyển đổi cấu hình: đối với mỗi mục trong dict được trả về, quá trình chuyển đổi sẽ cập nhật chế độ cài đặt đó thành giá trị mới. Tất cả các chế độ cài đặt khác đều không thay đổi. Hàm này cũng có thể trả về một list gồm các dict hoặc một dict gồm các dict trong trường hợp có hiệu ứng chuyển đổi phân chia.

inputs sequence của các string; bắt buộc
Danh sách các chế độ cài đặt bản dựng mà quá trình chuyển đổi này có thể đọc. Đây sẽ là tập hợp khoá của tham số cài đặt của tham số hàm triển khai.
outputs sequence của các strings; bắt buộc
Danh sách các chế độ cài đặt bản dựng mà quá trình chuyển đổi này có thể ghi. Đây phải là một siêu tập hợp của tập hợp khoá của từ điển do quá trình chuyển đổi này trả về.

and_then

transition transition.and_then(transition)

Trả về một hiệu ứng chuyển đổi mới áp dụng hiệu ứng chuyển đổi này, sau đó là hiệu ứng chuyển đổi đã cho. Quá trình chuyển đổi thứ hai sẽ đọc các chế độ cài đặt bản dựng do quá trình chuyển đổi đầu tiên tạo ra; các quá trình chuyển đổi ban đầu sẽ không thay đổi. Kết quả là một hiệu ứng chuyển đổi và có thể được tạo thành từ nhiều hiệu ứng khác.

Bạn có thể dùng một thành phần làm quy tắc hoặc hiệu ứng chuyển đổi thuộc tính ở bất cứ nơi nào có thể dùng hiệu ứng chuyển đổi thành phần của thành phần đó. Nhiều nhất là một trong các hiệu ứng chuyển cảnh kết hợp có thể nhắm đến cấu hình thực thi (ví dụ: config.exec). Khi hai hiệu ứng chuyển cảnh trong chuỗi phân chia cấu hình, kết quả sẽ có tích chéo của các phân chia đó; khoá cho mỗi phân chia kết hợp là chuỗi nối các khoá thành phần được phân tách bằng dấu phẩy.

Thông số

Tham số Mô tả
transition transition; bắt buộc
Quá trình chuyển đổi cần áp dụng sau quá trình này.