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 sự cố Xem nguồn

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

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

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

  2. SingleToolchainResolutionFunction phân giải một loại chuỗi công cụ duy nhất 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, nền tảng này sẽ tìm chuỗi công cụ đã đăng ký phù hợp 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. Hãy kiểm tra thuộc tính exec_compatible_with để đảm bảo chuỗi công cụ và nền tảng thực thi tương thích.
    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 (chuỗi được đăng ký trước).
  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ó chuỗi công cụ hợp lệ cho mỗi 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).
      1. Nếu nền tảng thực thi đã được thiết lập qua quá trình chuyển đổi chuỗi công cụ, thì nền tảng đó sẽ được chọn trước tiên như mô tả bên dưới.

Như đã thảo luận trong Chuỗi công cụ và cấu hình, phần phụ thuộc từ một mục tiêu thành chuỗi công cụ sẽ 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. Mặc dù có tên là "chuyển đổi chuỗi công cụ", nhưng hành động này không được triển khai dưới dạng chuyển đổi cấu hình, mà thay vào đó là một lớp con đặc biệt của ConfiguredTargetKey, được gọi là ToolchainDependencyConfiguredTargetKey. Ngoài các 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 đang xem xét sử dụng nền tảng thực thi nào, nếu nền tảng thực thi bắt buộc từ ToolchainDependencyConfiguredTargetKey là 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ệ nào hoặc do các hạn chế thực thi từ quy tắc hoặc mục tiêu), 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.