การลงทะเบียน BazelCon 2024 เปิดให้ลงทะเบียนแล้วในตอนนี้

หน้านี้ได้รับการแปลโดย Cloud Translation API

ฟังก์ชัน

รายงานปัญหา ดูแหล่งที่มา ตอนกลางคืน · 7.4 ที่ใช้เวลาเพียง 2 นาที 7.3 · 7.2 · 7.1 · 7.0 · 6.5

เนื้อหา

แพ็กเกจ
package_group
exports_files
โลก
select
subpackages

พัสดุ

package(default_deprecation, default_package_metadata, default_testonly, default_visibility, features)

ฟังก์ชันนี้จะประกาศข้อมูลเมตาที่ใช้กับกฎทุกข้อในแพ็กเกจ โดยใช้มากที่สุดเพียงครั้งเดียวในแพ็กเกจ (ไฟล์ BUILD)

สำหรับคู่ที่ประกาศว่ามีการใช้ข้อมูลเมตากับกฎทุกกฎทั้งหมด repository ให้ใช้ฟังก์ชัน repo() ใน REPO.bazel ไฟล์ที่รูทของที่เก็บ ฟังก์ชัน repo() จะรับอาร์กิวเมนต์เหมือนกับ package() ทุกประการ

ควรเรียกใช้ฟังก์ชัน package() หลังคำสั่ง load() ทั้งหมดที่ด้านบนของไฟล์ ก่อนกฎใดๆ

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

แอตทริบิวต์	คำอธิบาย
`default_applicable_licenses`	ชื่อแทนของ `default_package_metadata`
`default_visibility`	รายการป้ายกํากับ ค่าเริ่มต้นคือ `[]` ระดับการเข้าถึงเริ่มต้นของกฎในแพ็กเกจนี้ กฎทุกข้อในแพ็กเกจนี้มีระดับการเข้าถึงที่ระบุในแอตทริบิวต์นี้ เว้นแต่จะระบุไว้เป็นอย่างอื่นในแอตทริบิวต์ `visibility` ของกฎ หากต้องการข้อมูลโดยละเอียดเกี่ยวกับไวยากรณ์ โปรดดูเอกสารประกอบ visibility ระดับการเข้าถึงเริ่มต้นของแพ็กเกจจะไม่มีผลกับ exports_files ซึ่งเป็นแบบสาธารณะโดยค่าเริ่มต้น
`default_deprecation`	String; ค่าเริ่มต้นคือ `""` ตั้งค่าเริ่มต้น `deprecation` ข้อความสำหรับกฎทั้งหมดในแพ็กเกจนี้
`default_package_metadata`	รายการป้ายกํากับ ค่าเริ่มต้นคือ `[]` ตั้งค่ารายการเป้าหมายข้อมูลเมตาเริ่มต้นที่ใช้กับเป้าหมายอื่นๆ ทั้งหมดในแพ็กเกจ โดยทั่วไปเป้าหมายเหล่านี้จะเกี่ยวข้องกับการประกาศแพ็กเกจและใบอนุญาต OSS ดูตัวอย่างได้ที่ rules_license
`default_testonly`	บูลีน ค่าเริ่มต้นคือ `False` ยกเว้นตามที่ระบุไว้ ตั้งค่าพร็อพเพอร์ตี้ `testonly` เริ่มต้นสำหรับกฎทั้งหมดในแพ็กเกจนี้ ในแพ็กเกจที่ต่ำกว่า `javatests` ค่าเริ่มต้นคือ `True`
`features`	แสดงรายการสตริง ค่าเริ่มต้นคือ `[]` ตั้งค่าแฟล็กต่างๆ ที่ส่งผลต่อความหมายของไฟล์ BUILD นี้ ผู้ที่ทำงานเกี่ยวกับระบบบิลด์จะใช้ฟีเจอร์นี้เป็นหลัก ติดแท็กแพ็กเกจที่ต้องมีการจัดการพิเศษ อย่าใช้รายการนี้เว้นแต่ ขออย่างชัดแจ้งจากผู้ที่ทำงานเกี่ยวกับระบบบิลด์

ตัวอย่าง

การประกาศด้านล่างจะประกาศว่ากฎในแพ็กเกจนี้จะแสดงต่อสมาชิกของกลุ่ม //foo:target ของแพ็กเกจเท่านั้น ประกาศระดับการเข้าถึงแต่ละรายการ ในกฎ (หากมี) จะลบล้างข้อกำหนดนี้

package(default_visibility = ["//foo:target"])

package_group

package_group(name, packages, includes)

ฟังก์ชันนี้จะกำหนดชุด packages และเชื่อมโยงป้ายกำกับกับชุด สามารถอ้างอิงป้ายกำกับได้ใน visibility

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

ระบบจะถือว่าแพ็กเกจหนึ่งๆ อยู่ในกลุ่มหากตรงกับแอตทริบิวต์ packages หรืออยู่ในกลุ่มแพ็กเกจอื่นที่กล่าวถึงในแอตทริบิวต์ includes

ในทางเทคนิคกลุ่มแพ็กเกจเป็นเป้าหมาย แต่ไม่ได้สร้างขึ้นโดยกฎ และ ไม่มีการป้องกันใดๆ

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

แอตทริบิวต์ คำอธิบาย

แอตทริบิวต์	คำอธิบาย
`name`	ชื่อ ต้องระบุ ชื่อที่ไม่ซ้ำกันสำหรับเป้าหมายนี้
`packages`	รายการสตริง ค่าเริ่มต้นคือ `[]` รายการข้อมูลจำเพาะของแพ็กเกจอย่างน้อย 1 รายการ สตริงข้อกำหนดแพ็กเกจแต่ละรายการอาจมีค่าใดค่าหนึ่งต่อไปนี้ แบบฟอร์ม: ชื่อเต็มของแพ็กเกจโดยไม่มีที่เก็บ โดยขึ้นต้นด้วยเครื่องหมายทับคู่ เช่น `//foo/bar` จะระบุแพ็กเกจที่มีชื่อนั้นและอยู่ในที่เก็บเดียวกันกับกลุ่มแพ็กเกจ เหมือนกับด้านบน แต่มี `/...` ต่อท้าย เช่น `//foo/...` จะระบุชุด `//foo` และแพ็กเกจย่อยทั้งหมด `//...` ระบุแพ็กเกจทั้งหมดในแพ็กเกจปัจจุบัน ที่เก็บได้ สตริง `public` หรือ `private` ซึ่งจะระบุแพ็กเกจทั้งหมดหรือไม่มีแพ็กเกจตามลำดับ (แบบฟอร์มนี้ต้องใช้ ธง `--incompatible_package_group_has_public_syntax` เพื่อ ไว้) นอกจากนี้ ข้อกำหนดของแพ็กเกจ 2 ประเภทแรกยังอาจนำหน้าด้วย `-` เพื่อระบุว่าเป็นค่าลบได้ด้วย กลุ่มแพ็กเกจประกอบด้วยแพ็กเกจที่ตรงกับข้อกำหนดเชิงบวกอย่างน้อย 1 ข้อและไม่มีข้อกำหนดเชิงลบเลย ตัวอย่างเช่น ค่า `[//foo/..., -//foo/tests/...]` จะรวมแพ็กเกจย่อยทั้งหมดของ `//foo` ที่ไม่ได้เป็นแพ็กเกจย่อยของ `//foo/tests` ด้วย (`//foo` เองก็เป็น รวม แต่ //foo/tests ด้วยตนเองจะไม่อยู่) นอกเหนือจากระดับการมองเห็นแบบสาธารณะแล้ว คุณไม่สามารถระบุแพ็กเกจที่อยู่นอกที่เก็บปัจจุบันได้โดยตรง หากแอตทริบิวต์นี้ขาดหายไป จะเหมือนกับการตั้งค่าเป็น รายการที่ว่างเปล่า ซึ่งเหมือนกับการตั้งค่าไปยังรายการที่มี เฉพาะ `private` หมายเหตุ: ก่อน Bazel 6.0 ข้อกำหนด `//...` มีลักษณะการทำงานเดิมเหมือนกับ `public` ช่วงเวลานี้ พฤติกรรมนี้จะได้รับการแก้ไขเมื่อ `--incompatible_fix_package_group_reporoot_syntax` คือ ซึ่งเป็นค่าเริ่มต้นหลัง Bazel 6.0 หมายเหตุ: ก่อนที่จะเป็น Bazel 6.0 เมื่อแอตทริบิวต์นี้ได้รับการจัดรูปแบบเป็นส่วนหนึ่ง`bazel query --output=proto` (หรือ `--output=xml`) ระบบจะไม่ใส่เครื่องหมายทับนำหน้า เช่น `//pkg/foo/...` จะแสดงผลเป็น `\"pkg/foo/...\"` ลักษณะการทำงานนี้จะได้รับการแก้ไขเมื่อ `--incompatible_package_group_includes_double_slash` คือ ซึ่งเป็นค่าเริ่มต้นหลัง Bazel 6.0
`includes`	รายการป้ายกํากับ ค่าเริ่มต้นคือ `[]` กลุ่มแพ็กเกจอื่นๆ ที่รวมอยู่ในแพ็กเกจนี้ ป้ายกำกับในแอตทริบิวต์นี้ต้องอ้างอิงกลุ่มแพ็กเกจอื่นๆ ระบบจะนำแพ็กเกจในกลุ่มแพ็กเกจที่อ้างอิงไปใช้เป็นส่วนหนึ่งของแพ็กเกจ กลุ่มแพ็กเกจ ความสัมพันธ์นี้เป็นแบบทรานซิทีฟ กล่าวคือ หากกลุ่มแพ็กเกจ `a` รวมกลุ่มแพ็กเกจ `b` และ `b` รวมกลุ่มแพ็กเกจ `c` ไว้ด้วย แพ็กเกจทุกรายการใน `c` ก็จะเป็นสมาชิกของ `a` ด้วย เมื่อใช้ร่วมกับข้อกำหนดของแพ็กเกจที่ถูกปฏิเสธ โปรดทราบว่า ชุดแพ็กเกจของแต่ละกลุ่มจะได้รับการคำนวณแยกกันก่อนและ ผลลัพธ์จะรวมกัน ซึ่งหมายความว่าข้อกำหนดที่ลบล้างในกลุ่มหนึ่งจะไม่มีผลกับข้อกำหนดในกลุ่มอื่น

name

ชื่อ ต้องระบุ

ชื่อที่ไม่ซ้ำกันสำหรับเป้าหมายนี้

packages

รายการสตริง ค่าเริ่มต้นคือ []

รายการข้อมูลจำเพาะของแพ็กเกจอย่างน้อย 1 รายการ

สตริงข้อกำหนดแพ็กเกจแต่ละรายการอาจมีค่าใดค่าหนึ่งต่อไปนี้ แบบฟอร์ม:

ชื่อเต็มของแพ็กเกจโดยไม่มีที่เก็บ โดยขึ้นต้นด้วยเครื่องหมายทับคู่ เช่น //foo/bar จะระบุแพ็กเกจที่มีชื่อนั้นและอยู่ในที่เก็บเดียวกันกับกลุ่มแพ็กเกจ
เหมือนกับด้านบน แต่มี /... ต่อท้าย เช่น //foo/... จะระบุชุด //foo และแพ็กเกจย่อยทั้งหมด //... ระบุแพ็กเกจทั้งหมดในแพ็กเกจปัจจุบัน ที่เก็บได้
สตริง public หรือ private ซึ่งจะระบุแพ็กเกจทั้งหมดหรือไม่มีแพ็กเกจตามลำดับ (แบบฟอร์มนี้ต้องใช้ ธง --incompatible_package_group_has_public_syntax เพื่อ ไว้)

นอกจากนี้ ข้อกำหนดของแพ็กเกจ 2 ประเภทแรกยังอาจนำหน้าด้วย - เพื่อระบุว่าเป็นค่าลบได้ด้วย

กลุ่มแพ็กเกจประกอบด้วยแพ็กเกจที่ตรงกับข้อกำหนดเชิงบวกอย่างน้อย 1 ข้อและไม่มีข้อกำหนดเชิงลบเลย ตัวอย่างเช่น ค่า [//foo/..., -//foo/tests/...] จะรวมแพ็กเกจย่อยทั้งหมดของ //foo ที่ไม่ได้เป็นแพ็กเกจย่อยของ //foo/tests ด้วย (//foo เองก็เป็น รวม แต่ //foo/tests ด้วยตนเองจะไม่อยู่)

นอกเหนือจากระดับการมองเห็นแบบสาธารณะแล้ว คุณไม่สามารถระบุแพ็กเกจที่อยู่นอกที่เก็บปัจจุบันได้โดยตรง

หากแอตทริบิวต์นี้ขาดหายไป จะเหมือนกับการตั้งค่าเป็น รายการที่ว่างเปล่า ซึ่งเหมือนกับการตั้งค่าไปยังรายการที่มี เฉพาะ private

หมายเหตุ: ก่อน Bazel 6.0 ข้อกำหนด //... มีลักษณะการทำงานเดิมเหมือนกับ public ช่วงเวลานี้ พฤติกรรมนี้จะได้รับการแก้ไขเมื่อ --incompatible_fix_package_group_reporoot_syntax คือ ซึ่งเป็นค่าเริ่มต้นหลัง Bazel 6.0

หมายเหตุ: ก่อนที่จะเป็น Bazel 6.0 เมื่อแอตทริบิวต์นี้ได้รับการจัดรูปแบบเป็นส่วนหนึ่งbazel query --output=proto (หรือ --output=xml) ระบบจะไม่ใส่เครื่องหมายทับนำหน้า เช่น //pkg/foo/... จะแสดงผลเป็น \"pkg/foo/...\" ลักษณะการทำงานนี้จะได้รับการแก้ไขเมื่อ --incompatible_package_group_includes_double_slash คือ ซึ่งเป็นค่าเริ่มต้นหลัง Bazel 6.0

includes

รายการป้ายกํากับ ค่าเริ่มต้นคือ []

กลุ่มแพ็กเกจอื่นๆ ที่รวมอยู่ในแพ็กเกจนี้

ป้ายกำกับในแอตทริบิวต์นี้ต้องอ้างอิงกลุ่มแพ็กเกจอื่นๆ ระบบจะนำแพ็กเกจในกลุ่มแพ็กเกจที่อ้างอิงไปใช้เป็นส่วนหนึ่งของแพ็กเกจ กลุ่มแพ็กเกจ ความสัมพันธ์นี้เป็นแบบทรานซิทีฟ กล่าวคือ หากกลุ่มแพ็กเกจ a รวมกลุ่มแพ็กเกจ b และ b รวมกลุ่มแพ็กเกจ c ไว้ด้วย แพ็กเกจทุกรายการใน c ก็จะเป็นสมาชิกของ a ด้วย

เมื่อใช้ร่วมกับข้อกำหนดของแพ็กเกจที่ถูกปฏิเสธ โปรดทราบว่า ชุดแพ็กเกจของแต่ละกลุ่มจะได้รับการคำนวณแยกกันก่อนและ ผลลัพธ์จะรวมกัน ซึ่งหมายความว่าข้อกำหนดที่ลบล้างในกลุ่มหนึ่งจะไม่มีผลกับข้อกำหนดในกลุ่มอื่น

ตัวอย่าง

การประกาศ package_group ต่อไปนี้ระบุ กลุ่มแพ็กเกจชื่อ "เขตร้อน" ที่มีผลไม้เมืองร้อน

package_group(
    name = "tropical",
    packages = [
        "//fruits/mango",
        "//fruits/orange",
        "//fruits/papaya/...",
    ],
)

การประกาศต่อไปนี้ระบุกลุ่มแพ็กเกจของแอปพลิเคชันสมมติ

package_group(
    name = "fooapp",
    includes = [
        ":controller",
        ":model",
        ":view",
    ],
)

package_group(
    name = "model",
    packages = ["//fooapp/database"],
)

package_group(
    name = "view",
    packages = [
        "//fooapp/swingui",
        "//fooapp/webui",
    ],
)

package_group(
    name = "controller",
    packages = ["//fooapp/algorithm"],
)

exports_files

exports_files([label, ...], visibility, licenses)

exports_files() ระบุรายการไฟล์ที่เป็นของ แพ็กเกจนี้ที่ส่งออกไปยังแพ็กเกจอื่นๆ

ไฟล์ BUILD สำหรับแพ็กเกจอาจอ้างถึงไฟล์ต้นฉบับโดยตรงเท่านั้น ไปยังแพ็กเกจอื่น หากมีการส่งออกอย่างชัดเจนด้วย คำสั่ง exports_files() อ่านเพิ่มเติมเกี่ยวกับระดับการมองเห็นไฟล์

ตามลักษณะการทำงานเดิม ระบบจะส่งออกไฟล์ที่ระบุว่าเป็นอินพุตของกฎด้วย ด้วยระดับการมองเห็นเริ่มต้นจนถึงธง --incompatible_no_implicit_file_export กลับด้าน อย่างไรก็ตาม คุณไม่ควรใช้ลักษณะการทํางานนี้และควรย้ายข้อมูลออก

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

อาร์กิวเมนต์คือรายการชื่อไฟล์ภายในแพ็กเกจปัจจุบัน นอกจากนี้ คุณยังระบุประกาศระดับการเข้าถึงได้ด้วย ในกรณีนี้ ไฟล์จะแสดงต่อเป้าหมายที่ระบุ หากไม่ได้ระบุการเปิดเผยไว้ ไฟล์ จะแสดงต่อทุกแพ็กเกจ แม้ว่าระดับการเข้าถึงเริ่มต้นของแพ็กเกจจะเป็น ที่ระบุไว้ใน package นอกจากนี้ คุณยังระบุใบอนุญาตได้ด้วย

ตัวอย่าง

ตัวอย่างต่อไปนี้จะส่งออก golden.txt, จากแพ็กเกจ test_data เพื่อให้ แพ็กเกจอาจใช้งานผลิตภัณฑ์ดังกล่าวได้ ตัวอย่างเช่น ในแอตทริบิวต์ data ของการทดสอบ

# from //test_data/BUILD

exports_files(["golden.txt"])

โลก

glob(include, exclude=[], exclude_directories=1, allow_empty=True)

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

ป้ายกำกับของไฟล์แหล่งที่มาจะรวมอยู่ในผลลัพธ์หากไฟล์เกี่ยวข้องกับแพ็กเกจ เส้นทางตรงกับรูปแบบ include ใดๆ และไม่มี exclude รูปแบบ

รายการ include และ exclude มีรูปแบบเส้นทางที่เกี่ยวข้องกับแพ็กเกจปัจจุบัน รูปแบบทุกรูปแบบอาจมีกลุ่มเส้นทางอย่างน้อย 1 กลุ่ม เช่นเคยเมื่อใช้เส้นทาง Unix กลุ่มเหล่านี้จะคั่นด้วย / กลุ่มอาจมีไวลด์การ์ด * ซึ่งตรงกันดังนี้ สตริงย่อยทั้งหมดในส่วนของเส้นทาง (รวมถึงสตริงย่อยที่ว่างเปล่า) ยกเว้น ตัวคั่นไดเรกทอรี / ไวลด์การ์ดนี้ใช้ได้หลายครั้ง ภายในกลุ่มเส้นทางเดียว นอกจากนี้ ไวลด์การ์ด ** ยังจับคู่ได้ กลุ่มเส้นทางที่สมบูรณ์ตั้งแต่ 0 รายการขึ้นไป แต่ต้องได้รับการประกาศเป็นแบบสแตนด์อโลน ส่วนเส้นทาง

ตัวอย่าง:

foo/bar.txt ตรงกับไฟล์ foo/bar.txt ในแพ็กเกจนี้ทุกประการ
foo/*.txt จะจับคู่กับไฟล์ทุกไฟล์ในไดเรกทอรี foo/ หากไฟล์ลงท้ายด้วย .txt (เว้นแต่ foo/ จะเป็นแพ็กเกจย่อย)
foo/a*.htm* ตรงกับทุกไฟล์ใน foo/ ที่ขึ้นต้นด้วย a และมีสตริงที่กำหนดเอง ( ว่างเปล่า) ตามด้วย .htm และลงท้ายด้วยสตริงที่กำหนดเองอีกสตริงหนึ่ง เช่น foo/axx.htm และ foo/a.html หรือ foo/axxx.html
**/a.txt ตรงกับทุก a.txt ไฟล์ในทุก ไดเรกทอรีย่อยของแพ็กเกจนี้
**/bar/**/*.txt จะจับคู่กับไฟล์ .txt ทุกไฟล์ในไดเรกทอรีย่อยทุกไดเรกทอรีของแพ็กเกจนี้ หากไดเรกทอรีอย่างน้อย 1 รายการในเส้นทางที่แสดงผลมีชื่อว่า bar เช่น xxx/bar/yyy/zzz/a.txt หรือ bar/a.txt (โปรดทราบว่า ** จะจับคู่กับกลุ่มที่ไม่มีค่าด้วย) หรือ bar/zzz/a.txt
** ตรงกับทุกไฟล์ในทุกโฟลเดอร์ย่อยของแพ็กเกจนี้
foo**/a.txt เป็นรูปแบบที่ไม่ถูกต้อง เนื่องจาก ** ต้อง ยืนหยัดอยู่ได้ในตัวเองเป็นกลุ่ม

หากเปิดใช้อาร์กิวเมนต์ exclude_directories (ตั้งค่าเป็น 1) ไฟล์ของ type ไดเรกทอรีจะไม่ปรากฏในผลลัพธ์ (ค่าเริ่มต้น 1)

หากตั้งค่าอาร์กิวเมนต์ allow_empty เป็น False ฟังก์ชัน glob จะแสดงข้อผิดพลาดหากผลลัพธ์เป็นลิสต์ว่าง

มีข้อจำกัดและคำเตือนที่สำคัญหลายประการดังนี้

เนื่องจาก glob() ทำงานระหว่างการประเมินไฟล์ BUILD glob() จึงจับคู่ไฟล์เฉพาะในลําดับชั้นซอร์สโค้ดเท่านั้น จะไม่จับคู่กับไฟล์ที่สร้างขึ้น ถ้าคุณสร้างเป้าหมายที่ต้องใช้ทั้ง 2 อย่าง ไฟล์ต้นฉบับและไฟล์ที่สร้างขึ้น คุณต้องต่อท้ายรายการที่ชัดเจนของไฟล์ที่สร้าง ไฟล์เหล่านั้นไปยัง glob ดูตัวอย่าง ด้านล่างกับ :mylib และ :gen_java_srcs
หากกฎมีชื่อเหมือนกับไฟล์แหล่งที่มาที่ตรงกัน กฎจะ "เงา" ไฟล์

โปรดทราบว่า glob() จะแสดงรายการเส้นทาง ดังนั้นการใช้ glob() ในแอตทริบิวต์ของกฎอื่นๆ (เช่น srcs = glob(["*.cc"])) จะมีผลเหมือนกับการระบุเส้นทางที่ตรงกันอย่างชัดเจน ตัวอย่างเช่น glob() ให้ผลตอบแทน ["Foo.java", "bar/Baz.java"] แต่ก็มีกฎในส่วน แพ็กเกจชื่อ "Foo.java" (ซึ่งได้รับอนุญาต แม้ว่า Bazel จะเตือนเรื่องนี้แล้วก็ตาม) ผู้ใช้ glob() จะใช้ "Foo.java" กฎ (เอาต์พุต) แทน "Foo.java" โปรดดู GitHub ปัญหา #10395 สำหรับรายละเอียดเพิ่มเติม
รูปแบบทั่วไปอาจจับคู่กับไฟล์ในไดเรกทอรีย่อย และชื่อไดเรกทอรีย่อยจะใช้ไวลด์การ์ดได้ อย่างไรก็ตาม...
ไม่อนุญาตให้ใช้ป้ายกำกับข้ามพรมแดนพัสดุและ glob ไม่ตรงกับไฟล์ในแพ็กเกจย่อย

เช่น นิพจน์ glob **/*.cc ในแพ็กเกจ x ไม่รวม x/y/z.cc หาก x/y มีลักษณะเป็นแพ็กเกจ (อาจเป็น x/y/BUILD หรือที่อื่นในเส้นทางแพ็กเกจ) ซึ่งหมายความว่าผลลัพธ์ของนิพจน์ทั่วไปจะขึ้นอยู่กับไฟล์ BUILD ที่มีอยู่ กล่าวคือ นิพจน์ทั่วไปเดียวกันจะรวม x/y/z.cc ไว้ด้วยหากไม่มีแพ็กเกจที่ชื่อ x/y หรือมีการทําเครื่องหมายว่าลบไปแล้วโดยใช้แฟล็ก --deleted_packages
ข้อจำกัดข้างต้นมีผลกับนิพจน์ของ glob ทั้งหมด ไม่ว่าจะใช้ไวลด์การ์ดใด
ไฟล์ที่ซ่อนซึ่งมีชื่อไฟล์ขึ้นต้นด้วย . จะตรงกันทั้งหมดกับทั้งไวลด์การ์ด ** และ * หากต้องการจับคู่ไฟล์ที่ซ่อนอยู่ ที่มีรูปแบบแบบผสม รูปแบบของคุณจะต้องขึ้นต้นด้วย . ตัวอย่างเช่น * และ .*.txt จะตรงกับ .foo.txt แต่เป็น *.txt จะไม่ได้ผล ระบบจะจับคู่ไดเรกทอรีที่ซ่อนอยู่ด้วยในลักษณะเดียวกัน ไดเรกทอรีที่ซ่อนอยู่อาจรวมไฟล์ที่ไม่จําเป็นต้องใช้เป็นอินพุต และอาจเพิ่มจํานวนไฟล์ที่รวมแบบ Glob โดยไม่จําเป็นและการใช้หน่วยความจํา หากต้องการยกเว้นไดเรกทอรีที่ซ่อนอยู่ ให้เพิ่มไดเรกทอรีนั้นลงในอาร์กิวเมนต์รายการ "exclude"
"**" ไวลด์การ์ดมีตัวพิมพ์แบบมุมเดียว: ลาย "**" ไม่ตรงกับเส้นทางไดเรกทอรีของแพ็กเกจ กล่าวคือ glob(["**"], exclude_directories = 0) จะจับคู่กับไฟล์และไดเรกทอรีทั้งหมดในไดเรกทอรีของแพ็กเกจปัจจุบันอย่างเคร่งครัด (แต่จะไม่เข้าไปในไดเรกทอรีของแพ็กเกจย่อย โปรดดูหมายเหตุก่อนหน้าเกี่ยวกับเรื่องนี้)

โดยทั่วไปคุณควรพยายามแสดงนามสกุลที่เหมาะสม (เช่น *.html) แทนที่จะใช้ "*" เปล่าสำหรับรูปแบบลูกโลก ชื่อที่ชัดเจนยิ่งขึ้นจะทําให้ทราบรายละเอียดของไฟล์เองและช่วยให้คุณไม่จับคู่ไฟล์สํารองหรือไฟล์ที่ emacs/vi/... บันทึกโดยอัตโนมัติโดยไม่ตั้งใจ

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

ตัวอย่างของ Glob

สร้างไลบรารี Java ที่สร้างขึ้นจากไฟล์ Java ทั้งหมดในไดเรกทอรีนี้ และไฟล์ทั้งหมดที่สร้างโดยกฎ :gen_java_srcs

java_library(
    name = "mylib",
    srcs = glob(["*.java"]) + [":gen_java_srcs"],
    deps = "...",
)

genrule(
    name = "gen_java_srcs",
    outs = [
        "Foo.java",
        "Bar.java",
    ],
    ...
)

รวมไฟล์ txt ทั้งหมดไว้ในไดเรกทอรี testdata ยกเว้น experimental.txt โปรดทราบว่าระบบจะไม่รวมไฟล์ในไดเรกทอรีย่อยของ testdata หากต้องการให้รวมไฟล์เหล่านั้นด้วย ให้ใช้ Glob แบบเรียกซ้ำ (**)

sh_test(
    name = "mytest",
    srcs = ["mytest.sh"],
    data = glob(
        ["testdata/*.txt"],
        exclude = ["testdata/experimental.txt"],
    ),
)

ตัวอย่าง Glob แบบวนซ้ำ

ทำให้การทดสอบขึ้นอยู่กับไฟล์ txt ทั้งหมดในไดเรกทอรี testdata และ ไดเรกทอรีย่อย (และไดเรกทอรีย่อย เป็นต้น) ระบบจะละเว้นไดเรกทอรีย่อยที่มีไฟล์ BUILD (ดูข้อจํากัดและข้อควรระวังด้านบน)

sh_test(
    name = "mytest",
    srcs = ["mytest.sh"],
    data = glob(["testdata/**/*.txt"]),
)

สร้างไลบรารีที่สร้างจากไฟล์ Java ทั้งหมดในไดเรกทอรีนี้และไดเรกทอรีย่อยทั้งหมด ยกเว้นไฟล์ที่มีเส้นทางซึ่งมีไดเรกทอรีชื่อ testing ควรหลีกเลี่ยงรูปแบบนี้หากเป็นไปได้ เนื่องจากอาจลดการสร้างแบบเพิ่มทีละน้อยและทำให้เวลาในการสร้างนานขึ้น

java_library(
    name = "mylib",
    srcs = glob(
        ["**/*.java"],
        exclude = ["**/testing/**"],
    ),
)

ตัวอย่างของ Glob แบบขยาย

สร้าง genrule แต่ละรายการสําหรับ *_test.cc ในไดเรกทอรีปัจจุบันซึ่งจะนับจํานวนบรรทัดในไฟล์

# Conveniently, the build language supports list comprehensions.
[genrule(
    name = "count_lines_" + f[:-3],  # strip ".cc"
    srcs = [f],
    outs = ["%s-linecount.txt" % f[:-3]],
    cmd = "wc -l $< >$@",
 ) for f in glob(["*_test.cc"])]

หากไฟล์ BUILD ด้านบนอยู่ในแพ็กเกจ //foo และแพ็กเกจมี ไฟล์ที่ตรงกัน, a_test.cc, b_test.cc และ c_test.cc จากนั้นกำลังทำงาน bazel query '//foo:all' จะแสดงรายการกฎทั้งหมดที่สร้างขึ้น:

$ bazel query '//foo:all' | sort
//foo:count_lines_a_test
//foo:count_lines_b_test
//foo:count_lines_c_test

เลือก

select(
    {conditionA: valuesA, conditionB: valuesB, ...},
    no_match_error = "custom message"
)

select() คือฟังก์ชันตัวช่วยที่สร้างแอตทริบิวต์กฎ configurable สามารถใช้แทนที่ด้านขวามือของ เกือบ การกำหนดแอตทริบิวต์ทั้งหมด ดังนั้นค่าจะขึ้นอยู่กับแฟล็ก Bazel ในบรรทัดคำสั่ง คุณสามารถใช้เงื่อนไขนี้เพื่อกำหนดการอ้างอิงเฉพาะแพลตฟอร์ม หรือเพื่อฝังทรัพยากรต่างๆ ทั้งนี้ขึ้นอยู่กับว่ากฎสร้างขึ้นในโหมด "นักพัฒนาซอฟต์แวร์" หรือ "รุ่น"

การใช้งานขั้นพื้นฐานมีดังนี้

sh_binary(
    name = "mytarget",
    srcs = select({
        ":conditionA": ["mytarget_a.sh"],
        ":conditionB": ["mytarget_b.sh"],
        "//conditions:default": ["mytarget_default.sh"]
    })
)

ซึ่งทำให้แอตทริบิวต์ srcs ของ sh_binary ที่กำหนดค่าได้โดยแทนที่ป้ายกำกับปกติ การกำหนดรายการด้วยการเรียก select ที่แมป เงื่อนไขการกำหนดค่าให้เป็นค่าที่ตรงกัน แต่ละเงื่อนไขจะเป็นป้ายกำกับ การอ้างอิงถึง config_setting หรือ constraint_value, ซึ่ง "ตรงกับ" หากการกำหนดค่าของเป้าหมายตรงกับชุดของ ค่าของ mytarget#srcs จะกลายเป็นค่าใดก็ได้ รายการป้ายกำกับตรงกับการเรียกใช้ปัจจุบัน

หมายเหตุ:

เลือกเงื่อนไขเพียง 1 รายการในการเรียกใช้
หากเงื่อนไขหลายข้อตรงกัน และข้อหนึ่งเป็นความเชี่ยวชาญพิเศษของอีกฝ่าย ความเชี่ยวชาญพิเศษจะมีความสำคัญเหนือกว่า เงื่อนไข B ถือว่าเป็นเงื่อนไข ความเชี่ยวชาญพิเศษของเงื่อนไข A หาก B มีแฟล็กและข้อจำกัดเดียวกันทั้งหมด เป็นค่า A บวกค่า Flag หรือค่าจำกัดเพิ่มเติมบางส่วน ซึ่งหมายความว่าการแก้ไขความเชี่ยวชาญไม่ได้ออกแบบมาเพื่อสร้างลําดับดังที่แสดงในตัวอย่าง 2 ด้านล่าง
หากเงื่อนไขหลายรายการตรงกันและเงื่อนไขหนึ่งไม่ใช่การเฉพาะเจาะจงของเงื่อนไขอื่นๆ ทั้งหมด Bazel จะดำเนินการไม่สำเร็จและแสดงข้อผิดพลาด เว้นแต่ว่าเงื่อนไขทั้งหมดจะแก้ไขเป็นค่าเดียวกัน
ระบบจะถือว่าป้ายกํากับจำลองพิเศษ //conditions:default ตรงกันหากไม่มีเงื่อนไขอื่นตรงกัน หากเงื่อนไขนี้ ไม่แสดง ต้องจับคู่กฎอื่นๆ เพื่อหลีกเลี่ยงข้อผิดพลาด
select สามารถฝังภายในการกําหนดแอตทริบิวต์ที่ใหญ่ขึ้นได้ ดังนั้น srcs = ["common.sh"] + select({ ":conditionA": ["myrule_a.sh"], ...}) และ srcs = select({ ":conditionA": ["a.sh"]}) + select({ ":conditionB": ["b.sh"]}) เป็นนิพจน์ที่ถูกต้อง
select ใช้ได้กับแอตทริบิวต์ส่วนใหญ่ แต่ไม่ใช่ทั้งหมด ใช้ร่วมกันไม่ได้ มีการทำเครื่องหมาย nonconfigurable ในเอกสารประกอบ
แพ็กเกจย่อย
```
subpackages(include, exclude=[], allow_empty=True)
```
subpackages() เป็นฟังก์ชันตัวช่วยที่คล้ายกับ glob() ซึ่งแสดงรายการแพ็กเกจย่อยแทนไฟล์และไดเรกทอรี โดยใช้ รูปแบบเส้นทางเป็น glob() และสามารถจับคู่แพ็กเกจย่อยที่เป็น องค์ประกอบสืบทอดโดยตรงของไฟล์ BUILD ที่กำลังโหลด ดู glob สำหรับคำอธิบายโดยละเอียดและตัวอย่างการรวมและ ยกเว้นรูปแบบ

ผลลัพธ์ของแพ็กเกจย่อยที่แสดงผลจะเรียงตามลำดับและมี เส้นทางที่สัมพันธ์กับแพ็กเกจการโหลดปัจจุบันที่ตรงกับรูปแบบที่ระบุใน include ไม่ใช่ใน exclude
ตัวอย่าง

ตัวอย่างต่อไปนี้แสดงแพ็กเกจย่อยโดยตรงทั้งหมดของแพ็กเกจ foo/BUILD
```
# The following BUILD files exist:
# foo/BUILD
# foo/bar/baz/BUILD
# foo/sub/BUILD
# foo/sub/deeper/BUILD
#
# In foo/BUILD a call to
subs = subpackages(include = ["**"])

# results in subs == ["sub", "bar/baz"]
#
# 'sub/deeper' is not included because it is a subpackage of 'foo/sub' not of
# 'foo'
```
โดยทั่วไปแล้ว เราขอแนะนำให้ผู้ใช้ใช้โมดูล "subpackages" ของ skylib แทนการเรียกใช้ฟังก์ชันนี้โดยตรง