載入特定版本的 clang。
必須設定 cipd_tag 或 local_archive。
如果設定 cipd_tag,則可選擇設定 sha256,以驗證下載的檔案,並允許 Bazel 快取檔案。
如未設定 cipd_tag,則必須將 local_archive 設為核心 IDK 封存檔案的路徑。
屬性
| 名稱 | 說明 | 類型 | 必要 | 預設 |
|---|---|---|---|---|
| name | 這個存放區的專屬名稱。 | 名稱 | 必要 | - |
| repo_mapping | 僅限 WORKSPACE 情境:從本機存放區名稱到全域存放區名稱的字典。能讓您控管這個存放區的依附元件在工作區中的解析方式。舉例來說, "@foo": "@bar" 項目會宣告,每當這個存放區依附於 @foo (例如依附於 @foo//some:target) 時,應在全域宣告的 @bar (@bar//some:target) 中解析該依附元件。MODULE.bazel 內容不支援這個屬性 (在模組擴充功能的實作函式中叫用存放區規則時)。 |
String Dict | 選用 | - |
| cipd_tag | 要載入版本的 CIPD 標記。 | 字串 | 選用 | "" |
| sha256 | clang 封存檔的選用 SHA-256 雜湊。有效金鑰為 linux | String Dict | 選用 | {} |
| local_archive | 本機 clang 封存檔案。 | 字串 | 選用 | "" |
| local_path | 本機 clang 安裝路徑、完整標籤,或相對於工作區目錄的路徑 | 字串 | 選用 | "" |
| from_workspace | 任何指向 Bazel 外部工作區的標籤,其中包含 clang 安裝。 | 標籤 | 選用 | None |
| local_version_file | 這個 clang 安裝作業版本檔案的工作區相對路徑 (選用)。 | 標籤 | 選用 | None |
| sysroot_paths | sysroot 路徑 (依 Bazel 架構,相對於 execroot) | String Dict | 選用 | {"aarch64": "external/rules_fuchsia++fuchsia_sdk_ext+fuchsia_sdk/arch/arm64/sysroot", "x86_64": "external/rules_fuchsia++fuchsia_sdk_ext+fuchsia_sdk/arch/x64/sysroot", "riscv64": "external/rules_fuchsia++fuchsia_sdk_ext+fuchsia_sdk/arch/riscv64/sysroot"} |
| sysroot_headers | Sysroot 標頭檔案群組 (依 Bazel 架構)。這些檔案會新增至 cc_toolchain 的編譯器檔案。值應為指向檔案群組的標籤,涵蓋必須顯示在 C++ 編譯動作沙箱中的所有標頭。請參閱預設值範例。 | String Dict | 選用 | {"aarch64": "@fuchsia_sdk//:fuchsia-sysroot-headers-aarch64", "x86_64": "@fuchsia_sdk//:fuchsia-sysroot-headers-x86_64", "riscv64": "@fuchsia_sdk//:fuchsia-sysroot-headers-riscv64"} |
| sysroot_libs | Sysroot 程式庫檔案群組 (依 Bazel 架構)。這些檔案會新增至 cc_toolchain 的連結器檔案。值應為指向檔案群組的標籤,涵蓋必須出現在 C++ 連結動作沙箱中的所有程式庫。請參閱預設值範例。 | String Dict | 選用 | {"aarch64": "@fuchsia_sdk//:fuchsia-sysroot-libraries-aarch64", "x86_64": "@fuchsia_sdk//:fuchsia-sysroot-libraries-x86_64", "riscv64": "@fuchsia_sdk//:fuchsia-sysroot-libraries-riscv64"} |
| extra_target_compatible_with | 工具鍊必須符合的額外平台限制值清單 (選用)。這項功能僅適用於 Fuchsia 樹狀結構內建構,該建構也會使用無法依賴 SDK sysroot 的其他 Fuchsia 專屬工具鍊產生 Fuchsia 二進位檔。 | 標籤清單 | 選用 | [] |
| cipd_ensure_file | 用於下載 clang 的 cipd ensure 檔案。 | 標籤 | 選用 | None |
| cipd_bin | 用於擷取 cipd_ensure_file 的 cipd 二進位檔。 |
標籤 | 選用 | None |
環境變數
這項存放區規則取決於下列環境變數:
LOCAL_FUCHSIA_PLATFORM_BUILD*LOCAL_FUCHSIA_CLANG_VERSION_FILE