Thông tin chi tiết về việc triển khai giải pháp chuỗi công cụ

Báo cáo vấn đề Xem nguồn Nightly · 7.4 . 7.3 · 7,2 · 7.1 · 7 · 6,5

Lưu ý: Phần này dành cho các nhà phát triển Bazel và không cần cho tác giả quy tắc.

Một số lớp SkyFunction triển khai quy trình phân giải chuỗi công cụ:

  1. RegisteredToolchainsFunction và RegisteredExecutionPlatformsFunction tìm các chuỗi công cụ và nền tảng thực thi có sẵn, dựa trên chuỗi công cụ hiện tại và tệp WORKSPACE.

  2. SingleToolchainResolutionFunction giải quyết một loại chuỗi công cụ cho mỗi nền tảng thực thi. Tức là đối với mọi nền tảng thực thi, công cụ này sẽ tìm chuỗi công cụ đã đăng ký tốt nhất để sử dụng dựa trên các tiêu chí sau:

    1. Đảm bảo chuỗi công cụ và nền tảng mục tiêu tương thích bằng cách kiểm tra thuộc tính target_compatible_with.
    2. Đảm bảo chuỗi công cụ và nền tảng thực thi tương thích bằng cách đang kiểm tra thuộc tính exec_compatible_with.
    3. Nếu bạn còn nhiều chuỗi công cụ, hãy chọn chuỗi công cụ có mức độ ưu tiên cao nhất ( một tài khoản được đăng ký đầu tiên).

  3. ToolchainResolutionFunction gọi SingleToolchainResolutionFunction cho từng loại chuỗi công cụ được yêu cầu, sau đó xác định nền tảng thực thi tốt nhất để sử dụng.

    1. Trước tiên, hãy xoá mọi nền tảng thực thi không có nền tảng hợp lệ cho từng loại chuỗi công cụ được yêu cầu.
    2. Nếu còn nhiều nền tảng thực thi, hãy chọn nền tảng có mức độ ưu tiên cao nhất (nền tảng được đăng ký trước tiên).
      1. Trường hợp nền tảng thực thi đã được đặt bởi chuỗi công cụ hiệu ứng chuyển tiếp, đầu tiên sẽ được chọn như được mô tả dưới đây.

Như đã thảo luận trong phần Chuỗi công cụ và cấu hình, phần phụ thuộc từ một mục tiêu đến một chuỗi công cụ sử dụng một cấu hình đặc biệt buộc nền tảng thực thi phải giống nhau cho cả hai. Bất kể tên này "công cụ chuyển đổi chuỗi công cụ", điều này không được triển khai dưới dạng cấu hình chuyển đổi, mà thay vào đó là lớp con đặc biệt của ConfiguredTargetKey, đã gọi ToolchainDependencyConfiguredTargetKey. Ngoài dữ liệu khác trong ConfiguredTargetKey, lớp con này cũng chứa nhãn của nền tảng thực thi. Khi ToolchainResolutionFunction cân nhắc nền tảng thực thi nào sẽ sử dụng, nếu nền tảng thực thi bắt buộc từ ToolchainDependencyConfiguredTargetKey hợp lệ, thì nền tảng đó sẽ được sử dụng ngay cả khi không phải là nền tảng có mức độ ưu tiên cao nhất.

Lưu ý: Nếu nền tảng thực thi bắt buộc không hợp lệ (vì không có chuỗi công cụ hợp lệ hoặc do các quy tắc hoặc mục tiêu ràng buộc việc thực thi), thì nền tảng thực thi hợp lệ có mức độ ưu tiên cao nhất sẽ được sử dụng.