Detail Implementasi Resolusi Toolchain

Laporkan masalah Lihat sumber Nightly · 7.4 . 7,3 · 7,2 · 7,1 · 7,0 · 6,5

Catatan: Bagian ini ditujukan untuk developer Bazel, dan tidak diperlukan oleh penulis aturan.

Beberapa class SkyFunction menerapkan proses resolusi toolchain:

  1. RegisteredToolchainsFunction dan RegisteredExecutionPlatformsFunction menemukan toolchain dan platform eksekusi yang tersedia, berdasarkan konfigurasi saat ini dan file WORKSPACE.

  2. SingleToolchainResolutionFunction me-resolve satu jenis toolchain untuk setiap platform eksekusi. Artinya, untuk setiap platform eksekusi, toolchain terdaftar terbaik akan ditemukan untuk digunakan berdasarkan kriteria berikut:

    1. Pastikan toolchain dan platform target kompatibel, dengan memeriksa atribut target_compatible_with.
    2. Pastikan toolchain dan platform eksekusi kompatibel, dengan memeriksa atribut exec_compatible_with.
    3. Jika ada beberapa toolchain yang tersisa, pilih toolchain dengan prioritas tertinggi (yang didaftarkan terlebih dahulu).

  3. ToolchainResolutionFunction panggilan SingleToolchainResolutionFunction untuk setiap jenis toolchain yang diminta, dan kemudian menentukan platform eksekusi terbaik yang akan digunakan.

    1. Pertama, hapus semua platform eksekusi yang tidak memiliki untuk setiap jenis toolchain yang diminta.
    2. Jika ada beberapa platform eksekusi yang tersisa, pilih prioritas tertinggi satu (yang didaftarkan pertama kali).
      1. Jika platform eksekusi sudah ditetapkan oleh transisi toolchain, platform tersebut akan dipilih terlebih dahulu seperti yang dijelaskan di bawah.

Seperti yang dibahas dalam Toolchain dan Konfigurasi, dependensi dari target ke toolchain menggunakan konfigurasi khusus yang memaksa platform eksekusi menjadi sama untuk keduanya. Meskipun namanya "transisi toolchain", ini tidak diterapkan sebagai konfigurasi transisi, namun alih-alih sebagai subclass khusus dari ConfiguredTargetKey, dipanggil ToolchainDependencyConfiguredTargetKey Selain data lain di ConfiguredTargetKey, subclass ini juga memiliki label platform eksekusi. Jika ToolchainResolutionFunction adalah mempertimbangkan platform eksekusi mana yang akan digunakan, jika platform {i>forced execution<i} dari ToolchainDependencyConfiguredTargetKey adalah valid, ini akan digunakan bahkan jika itu bukan prioritas tertinggi.

Catatan: Jika platform eksekusi paksa tidak valid (karena tidak ada toolchain yang valid, atau karena batasan eksekusi dari aturan atau target), platform eksekusi valid dengan prioritas tertinggi akan digunakan sebagai gantinya.