ป้ายกำกับ

รายงานปัญหา ดูแหล่งที่มา รุ่น Nightly · 8.0 7.4 7.3 · 7.2 · 7.1 · 7.0 · 6.5

ตัวระบุเป้าหมาย 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("//pkg/foo:abc").name == "abc"

พัสดุ

string Label.package

ส่วนแพ็กเกจของป้ายกำกับนี้ เช่น
Label("//pkg/foo:abc").package == "pkg/foo"

ที่เกี่ยวข้อง

Label Label.relative(relName)

แก้ปัญหาป้ายกำกับแบบสัมบูรณ์ (ขึ้นต้นด้วย //) หรือแบบสัมพัทธ์กับแพ็กเกจปัจจุบัน หากป้ายกำกับนี้อยู่ในที่เก็บระยะไกล ระบบจะแก้ไขอาร์กิวเมนต์โดยสัมพันธ์กับที่เก็บนั้น หากอาร์กิวเมนต์มีชื่อที่เก็บ ระบบจะละเว้นป้ายกำกับปัจจุบันและแสดงผลอาร์กิวเมนต์ตามที่เป็นอยู่ ยกเว้นว่าระบบจะเขียนชื่อที่เก็บใหม่หากอยู่ในการแมปที่เก็บปัจจุบัน ระบบจะแสดงป้ายกำกับที่สงวนไว้ตามเดิมด้วย
ตัวอย่างเช่น
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
ป้ายกำกับที่จะได้รับการแก้ไขโดยสัมพันธ์กับป้ายกำกับนี้

workspace_name

string Label.workspace_name

ส่วนพื้นที่เก็บข้อมูลของป้ายกำกับนี้ ตัวอย่างเช่น
Label("@foo//bar:baz").workspace_name == "foo"

workspace_root

string Label.workspace_root

แสดงรูทการดําเนินการสําหรับพื้นที่ทํางานของป้ายกํากับนี้ โดยสัมพันธ์กับ execroot เช่น
Label("@repo//pkg/foo:abc").workspace_root == "external/repo"