ตัวระบุเป้าหมาย BUILD
สําหรับอินสแตนซ์ Label
l
แต่ละรายการ การนําเสนอสตริง str(l)
จะมีพร็อพเพอร์ตี้ที่ Label(str(l)) == l
โดยไม่คํานึงถึงตําแหน่งการเรียกใช้ Label()
สมาชิก
ป้ายกำกับ
Label Label(input)แปลงสตริงป้ายกำกับเป็นออบเจ็กต์
Label
ในบริบทของแพ็กเกจที่มีไฟล์ต้นฉบับ .bzl
ที่เรียกใช้อยู่ หากค่าที่ระบุเป็น Label
อยู่แล้ว ระบบจะแสดงผลค่าดังกล่าวโดยไม่มีการแก้ไขสําหรับมาโคร ฟังก์ชันที่เกี่ยวข้อง native.package_relative_label()
จะแปลงอินพุตเป็น Label
ในบริบทของแพ็กเกจที่กําลังสร้าง ใช้ฟังก์ชันดังกล่าวเพื่อจําลองการเปลี่ยนสตริงเป็นป้ายกำกับซึ่งดำเนินการโดยอัตโนมัติโดยแอตทริบิวต์กฎที่มีค่าป้ายกำกับ
พารามิเตอร์
พารามิเตอร์ | คำอธิบาย |
---|---|
input
|
สตริง หรือ ป้ายกำกับ
ต้องระบุ สตริงป้ายกำกับหรือออบเจ็กต์ป้ายกำกับที่ป้อน หากมีการส่งออบเจ็กต์ Label ระบบจะแสดงผลออบเจ็กต์ดังกล่าวตามที่เป็นอยู่ |
ชื่อ
string Label.nameชื่อของเป้าหมายที่ป้ายกำกับนี้อ้างอิงถึง เช่น
Label("@@foo//pkg/foo:abc").name == "abc"
พัสดุ
string Label.packageชื่อของแพ็กเกจที่มีเป้าหมายซึ่งป้ายกำกับนี้อ้างอิงถึง โดยไม่ระบุชื่อที่เก็บ เช่น
Label("@@repo//pkg/foo:abc").package == "pkg/foo"
ที่เกี่ยวข้อง
Label Label.relative(relName)ทดลอง API นี้ยังอยู่ในขั้นทดลองและอาจมีการเปลี่ยนแปลงได้ทุกเมื่อ โปรดอย่าใช้ข้อมูลนี้ คุณอาจเปิดใช้เป็นการทดลองได้โดยการตั้งค่า
--+incompatible_enable_deprecated_label_apis
เลิกใช้งานแล้ว เมธอดนี้จะทำงานอย่างน่าประหลาดใจเมื่อใช้กับอาร์กิวเมนต์ที่มีชื่อรีโปที่ชัดเจน โปรดใช้
Label.same_package_label()
, native.package_relative_label()
หรือ Label()
แทนแก้ป้ายกำกับที่เป็นค่าสัมบูรณ์ (ขึ้นต้นด้วย //
) หรือสัมพันธ์กับแพ็กเกจปัจจุบัน หากป้ายกำกับนี้อยู่ในที่เก็บระยะไกล ระบบจะแก้ไขอาร์กิวเมนต์โดยสัมพันธ์กับที่เก็บนั้น หากอาร์กิวเมนต์มีชื่อที่เก็บ ระบบจะไม่สนใจป้ายกำกับปัจจุบันและระบบจะแสดงผลอาร์กิวเมนต์ตามที่เป็นอยู่ ยกเว้นว่าชื่อที่เก็บจะถูกเขียนใหม่หากอยู่ในการแมปที่เก็บปัจจุบัน ระบบจะแสดงป้ายกำกับที่สงวนไว้ตามเดิมด้วย
ตัวอย่างเช่น
Label("//foo/bar:baz").relative(":quux") == Label("//foo/bar:quux") Label("//foo/bar:baz").relative("//wiz:quux") == Label("//wiz:quux") Label("@repo//foo/bar:baz").relative("//wiz:quux") == Label("@repo//wiz:quux") Label("@repo//foo/bar:baz").relative("//visibility:public") == Label("//visibility:public") Label("@repo//foo/bar:baz").relative("@other//wiz:quux") == Label("@other//wiz:quux")
หากการแมปที่เก็บที่ส่งผ่านคือ {'@other' : '@remapped'}
ระบบจะทำการแมปใหม่ดังต่อไปนี้
Label("@repo//foo/bar:baz").relative("@other//wiz:quux") == Label("@remapped//wiz:quux")
พารามิเตอร์
พารามิเตอร์ | คำอธิบาย |
---|---|
relName
|
required ป้ายกำกับที่จะได้รับการแก้ไขโดยสัมพันธ์กับป้ายกำกับนี้ |
repo_name
string Label.repo_nameชื่อ Canonical ของที่เก็บซึ่งมีเป้าหมายที่ป้ายกำกับนี้อ้างถึง โดยไม่มีเครื่องหมาย @ นำหน้า (
@
) ตัวอย่างเช่น Label("@@foo//bar:baz").repo_name == "foo"
same_package_label
Label Label.same_package_label(target_name)สร้างป้ายกำกับในแพ็กเกจเดียวกับป้ายกำกับนี้โดยใช้ชื่อเป้าหมายที่ระบุ
พารามิเตอร์
พารามิเตอร์ | คำอธิบาย |
---|---|
target_name
|
ต้องระบุ ชื่อเป้าหมายของป้ายกำกับใหม่ |
workspace_name
string Label.workspace_nameทดลอง API นี้ยังอยู่ในขั้นทดลองและอาจมีการเปลี่ยนแปลงได้ทุกเมื่อ โปรดอย่าใช้ข้อมูลนี้ คุณอาจเปิดใช้เป็นการทดลองได้โดยการตั้งค่า
--+incompatible_enable_deprecated_label_apis
เลิกใช้งานแล้ว ชื่อช่อง "ชื่อพื้นที่ทํางาน" นั้นไม่ถูกต้อง ให้ใช้
Label.repo_name
แทนชื่อตามแบบฉบับของที่เก็บซึ่งมีเป้าหมายที่อ้างอิงโดยป้ายกำกับนี้ โดยไม่มีเครื่องหมาย @ (@
) นำหน้า เช่น
Label("@@foo//bar:baz").workspace_name == "foo"
workspace_root
string Label.workspace_rootแสดงผลรูทการดําเนินการสําหรับที่เก็บซึ่งมีเป้าหมายที่อ้างอิงโดยป้ายกำกับนี้ โดยสัมพันธ์กับ execroot เช่น
Label("@repo//pkg/foo:abc").workspace_root == "external/repo"