กฎแพลตฟอร์มและเชนเครื่องมือ

กฎชุดนี้มีไว้เพื่อให้คุณใช้สร้างแบบจำลองแพลตฟอร์มฮาร์ดแวร์ที่เฉพาะเจาะจง สร้างและระบุเครื่องมือเฉพาะที่คุณอาจต้องใช้คอมไพล์โค้ดสำหรับแพลตฟอร์มเหล่านั้น ผู้ใช้ควรคุ้นเคยกับแนวคิดที่อธิบายที่นี่

กฎ

• constraint_setting
• constraint_value
• แพลตฟอร์ม
• โซ่เครื่องมือ
• toolchain_type

constraint_setting

constraint_setting(name, default_constraint_value, deprecation, distribs, features, licenses, tags, testonly, visibility)

กฎนี้ใช้เพื่อแนะนำประเภทข้อจำกัดใหม่ที่แพลตฟอร์มอาจระบุค่า เช่น คุณอาจกำหนด constraint_setting ที่ชื่อ "glibc_version" เพื่อนำเสนอ ความสามารถของแพลตฟอร์มในการติดตั้งไลบรารี glibc เวอร์ชันต่างๆ ดูรายละเอียดเพิ่มเติมได้ที่ หน้าแพลตฟอร์ม

constraint_setting แต่ละรายการมีชุดส่วนขยายที่เกี่ยวข้อง constraint_value วินาที โดยทั่วไปแล้วเงื่อนไขเหล่านี้จะกำหนดอยู่ในแพ็กเกจเดียวกัน แต่บางครั้ง แพ็กเกจอื่นจะนำค่าใหม่สำหรับการตั้งค่าที่มีอยู่ ตัวอย่างเช่น สามารถขยายการตั้งค่า @platforms//cpu:cpu ด้วยค่าที่กำหนดเองเพื่อ กำหนดแพลตฟอร์มที่กำหนดเป้าหมายสถาปัตยกรรม CPU ที่ไม่ซับซ้อน

อาร์กิวเมนต์

constraint_value

constraint_value(name, constraint_setting, deprecation, distribs, features, licenses, tags, testonly, visibility)

ตัวอย่าง

ข้อมูลต่อไปนี้จะสร้างค่าใหม่ที่เป็นไปได้สำหรับ constraint_value ที่กำหนดไว้ล่วงหน้า ที่แสดงถึงสถาปัตยกรรม CPU

constraint_value(
    name = "mips",
    constraint_setting = "@platforms//cpu:cpu",
)

อาร์กิวเมนต์

platform

platform(name, constraint_values, deprecation, distribs, exec_properties, features, flags, licenses, parents, remote_execution_properties, required_settings, tags, testonly, visibility)

กฎนี้กำหนดแพลตฟอร์มใหม่ ซึ่งเป็นคอลเล็กชันที่มีชื่อของตัวเลือกข้อจำกัด (เช่นสถาปัตยกรรม CPU หรือเวอร์ชันคอมไพเลอร์) ซึ่งอธิบายสภาพแวดล้อมใน ส่วนใดของบิลด์ที่สามารถทำงาน ดูรายละเอียดเพิ่มเติมได้ที่หน้าแพลตฟอร์ม

ตัวอย่าง

แอตทริบิวต์นี้ระบุแพลตฟอร์มที่อธิบายสภาพแวดล้อมที่ใช้งาน Linux บน ARM

platform(
    name = "linux_arm",
    constraint_values = [
        "@platforms//os:linux",
        "@platforms//cpu:arm",
    ],
)

แฟล็กแพลตฟอร์ม

แพลตฟอร์มอาจใช้แอตทริบิวต์ flags เพื่อระบุรายการ Flag ที่จะเพิ่ม ลงในการกำหนดค่าเมื่อใดก็ตามที่มีการใช้แพลตฟอร์มเป็นแพลตฟอร์มเป้าหมาย (เช่น เป็นค่า --platforms)

แฟล็กที่ตั้งค่าจากแพลตฟอร์มจะมีลำดับความสำคัญสูงสุดอย่างมีประสิทธิภาพและเขียนทับแฟล็กก่อนหน้า ค่าสำหรับแฟล็กนั้นๆ จากบรรทัดคำสั่ง ไฟล์ rc หรือการเปลี่ยน

ตัวอย่าง

platform(
    name = "foo",
    flags = [
        "--dynamic_mode=fully",
        "--//bool_flag",
        "--no//package:other_bool_flag",
    ],
)

นี่คือแพลตฟอร์มชื่อ foo เมื่อนี่คือแพลตฟอร์มเป้าหมาย (เนื่องจาก ผู้ใช้ระบุ --platforms//:foo เนื่องจากการเปลี่ยนตั้งค่า //command_line_option:platforms แจ้งว่าเป็น ["//:foo"] หรือเนื่องจาก //:foo ถูกใช้เป็นแพลตฟอร์มการดำเนินการ) ระบบจะตั้งค่าแฟล็กที่ระบุใน การกำหนดค่า

แพลตฟอร์มและแฟล็กที่ซ้ำกันได้

บางแฟล็กจะรวบรวมค่าเมื่อมีการใช้ซ้ำ เช่น --features, --copt, Flag ใดๆ ของ Starlark ที่สร้างขึ้นเป็น config.string(repeatable = True) แฟล็กเหล่านี้ใช้ไม่ได้กับการตั้งค่า Flag จากแพลตฟอร์ม: แฟล็กก่อนหน้าทั้งหมด ค่าเหล่านี้จะถูกลบออกและเขียนทับด้วยค่าจากแพลตฟอร์ม

สำหรับตัวอย่างในแพลตฟอร์มต่อไปนี้ การเรียกใช้ build --platforms=//:repeat_demo --features feature_a --features feature_b จะมีค่าของพารามิเตอร์ ธงสถานะ --feature ระบุว่า "["feature_c", "feature_d"]" กำลังนำฟีเจอร์ออก ที่ตั้งไว้ในบรรทัดคำสั่ง

platform(
    name = "repeat_demo",
    flags = [
        "--features=feature_c",
        "--features=feature_d",
    ],
)

ด้วยเหตุนี้ เราจึงไม่แนะนำให้ใช้ Flag ที่ซ้ำกันได้ในแอตทริบิวต์ flags

การรับช่วงแพลตฟอร์ม

แพลตฟอร์มอาจใช้แอตทริบิวต์ parents เพื่อระบุแพลตฟอร์มอื่นที่จะ รับค่าจำกัดมาจาก แม้ว่าแอตทริบิวต์ parents จะใช้รายการ แต่ไม่มี ปัจจุบันมีการรองรับมากกว่า 1 ค่า และการระบุระดับบนสุดหลายรายการเป็นข้อผิดพลาด

เมื่อตรวจสอบค่าของการตั้งค่าข้อจำกัดในแพลตฟอร์ม ให้ป้อนค่าที่กำหนดไว้โดยตรงก่อน (ผ่านแอตทริบิวต์ constraint_values) แล้วจึงเลือกค่าจำกัดใน ผู้ปกครอง การดำเนินการเช่นนี้ต่อเนื่องไปเรื่อยๆ ตามเชนแพลตฟอร์มหลัก ในลักษณะนี้ จึง ค่าที่กำหนดในแพลตฟอร์มโดยตรงจะลบล้างค่าที่ตั้งไว้ในแพลตฟอร์มหลัก

แพลตฟอร์มจะรับแอตทริบิวต์ exec_properties มาจากแพลตฟอร์มหลัก รายการพจนานุกรมใน exec_properties ของแพลตฟอร์มหลักและย่อย จะถูกรวมเข้าด้วยกัน หากคีย์เดียวกันปรากฏใน exec_properties ของทั้งระดับบนและย่อย ระบบจะใช้ค่าของรายการย่อย หากแพลตฟอร์มย่อยระบุสตริงว่างเป็นค่าหนึ่ง ระบบจะยกเลิกการตั้งค่าพร็อพเพอร์ตี้ที่เกี่ยวข้อง

แพลตฟอร์มยังรับค่าแอตทริบิวต์ remote_execution_properties (เลิกใช้งานแล้ว) ได้ด้วย จากแพลตฟอร์มหลัก หมายเหตุ: รหัสใหม่ควรใช้ exec_properties แทน ตรรกะที่อธิบายไว้ด้านล่างจะยังคงใช้งานได้กับลักษณะการทำงานเดิม แต่จะถูกนำออก ในอนาคต ตรรกะสำหรับการตั้งค่า remote_execution_platform มีดังนี้ คือแพลตฟอร์มหลัก

1. หากไม่ได้ตั้งค่า remote_execution_property ในแพลตฟอร์มย่อย ผู้เผยแพร่โฆษณาหลัก ระบบจะใช้ remote_execution_properties
2. หากมีการตั้งค่า remote_execution_property ในแพลตฟอร์มย่อยและมีเมธอด สตริงตรงตัว {PARENT_REMOTE_EXECUTION_PROPERTIES} มาโครดังกล่าวจะเป็น แทนที่ด้วยเนื้อหาของแอตทริบิวต์ remote_execution_property ของระดับบนสุด
3. หากมีการตั้งค่า remote_execution_property ในแพลตฟอร์มย่อยและไม่มี มาโครดังกล่าว จะใช้ remote_execution_property ของผู้เผยแพร่โฆษณาย่อยโดยไม่มีการเปลี่ยนแปลง

เนื่องจากเราเลิกใช้งาน remote_execution_properties แล้ว และจะทยอยเลิกใช้งาน remote_execution_properties และ exec_properties คนเดียวกัน ไม่อนุญาตให้ใช้เชนการรับช่วงค่า ต้องการใช้ exec_properties แทนคำสั่งที่เลิกใช้งานแล้ว remote_execution_properties

ตัวอย่าง: จำกัดค่า

platform(
    name = "parent",
    constraint_values = [
        "@platforms//os:linux",
        "@platforms//cpu:arm",
    ],
)
platform(
    name = "child_a",
    parents = [":parent"],
    constraint_values = [
        "@platforms//cpu:x86_64",
    ],
)
platform(
    name = "child_b",
    parents = [":parent"],
)

ในตัวอย่างนี้ แพลตฟอร์มย่อยจะมีพร็อพเพอร์ตี้ต่อไปนี้

• child_a มีค่าจำกัด @platforms//os:linux (รับค่ามา จากระดับบนสุด) และ @platforms//cpu:x86_64 (ตั้งค่าในแพลตฟอร์มโดยตรง)
• child_b รับค่าข้อจำกัดทั้งหมดจากค่าระดับบนสุด และไม่ได้กำหนดค่าใดๆ ของตัวเอง

ตัวอย่าง: พร็อพเพอร์ตี้การดำเนินการ

platform(
    name = "parent",
    exec_properties = {
      "k1": "v1",
      "k2": "v2",
    },
)
platform(
    name = "child_a",
    parents = [":parent"],
)
platform(
    name = "child_b",
    parents = [":parent"],
    exec_properties = {
      "k1": "child"
    }
)
platform(
    name = "child_c",
    parents = [":parent"],
    exec_properties = {
      "k1": ""
    }
)
platform(
    name = "child_d",
    parents = [":parent"],
    exec_properties = {
      "k3": "v3"
    }
)

ในตัวอย่างนี้ แพลตฟอร์มย่อยจะมีพร็อพเพอร์ตี้ต่อไปนี้

• child_a รับค่า "exec_properties" ของผู้เผยแพร่โฆษณาหลักและไม่ได้ตั้งค่าของตนเอง
• child_b จะรับค่า exec_properties ของระดับบนสุดและลบล้าง เป็น k1 exec_properties จะ { "k1": "child", "k2": "v2" }
• child_c จะรับค่า exec_properties ของระดับบนสุดและยกเลิกการตั้งค่า k1 exec_properties จะ { "k2": "v2" }
• child_d จะได้รับ exec_properties ของระดับบนสุดและเพิ่ม exec_properties จะ { "k1": "v1", "k2": "v2", "k3": "v3" }

อาร์กิวเมนต์

Toolchain

toolchain(name, deprecation, distribs, exec_compatible_with, features, licenses, tags, target_compatible_with, target_settings, testonly, toolchain, toolchain_type, visibility)

กฎนี้ประกาศประเภทและข้อจํากัดของ Toolchain ที่เจาะจงเพื่อให้เลือกได้ ระหว่างการแปลง Toolchain โปรดดู หน้า Toolchains สำหรับข้อมูลเพิ่มเติม รายละเอียด

อาร์กิวเมนต์

toolchain_type

toolchain_type(name, compatible_with, deprecation, features, restricted_to, tags, target_compatible_with, testonly, visibility)

กฎนี้จะกำหนด Toolchain ประเภทใหม่ ซึ่งเป็นเป้าหมายง่ายๆ ที่แสดงถึงคลาสของเครื่องมือ ทำหน้าที่เดียวกันในแต่ละแพลตฟอร์ม

ดูรายละเอียดเพิ่มเติมได้ที่หน้า Toolchains

ตัวอย่าง

แอตทริบิวต์นี้กำหนดประเภท Toolchain สำหรับกฎที่กำหนดเอง

toolchain_type(
    name = "bar_toolchain_type",
)

สามารถใช้ในไฟล์ bzl

bar_binary = rule(
    implementation = _bar_binary_impl,
    attrs = {
        "srcs": attr.label_list(allow_files = True),
        ...
        # No `_compiler` attribute anymore.
    },
    toolchains = ["//bar_tools:toolchain_type"]
)

อาร์กิวเมนต์