ระบบจะใช้กฎของพื้นที่ทํางานเพื่อดึงทรัพยากรภายนอก ซึ่งโดยทั่วไปแล้วคือซอร์สโค้ดที่อยู่นอกที่เก็บข้อมูลหลัก
หมายเหตุ: นอกจากกฎของเวิร์กสเปซแบบดั้งเดิมแล้ว Bazel ยังฝังกฎของเวิร์กสเปซ Starlark ต่างๆ ด้วย โดยเฉพาะกฎสำหรับจัดการที่เก็บ Git หรือที่เก็บถาวรที่โฮสต์บนเว็บ
กฎ
เชื่อมโยง
ดูแหล่งที่มาของกฎbind(name, actual, compatible_with, deprecation, distribs, features, licenses, restricted_to, tags, target_compatible_with, testonly, visibility)
คำเตือน: ไม่แนะนำให้ใช้ bind()
ดู "พิจารณานำการเชื่อมโยงออก" เป็นเวลานาน
การอภิปรายเกี่ยวกับปัญหาและทางเลือกต่างๆ โดยเฉพาะอย่างยิ่ง ให้พิจารณาใช้แอตทริบิวต์ของrepo_mapping
ที่เก็บข้อมูล
คำเตือน: ใช้ select()
ใน bind()
ไม่ได้ ดูคำถามที่พบบ่อยเกี่ยวกับแอตทริบิวต์ที่กำหนดค่าได้สำหรับ
รายละเอียด
ตั้งชื่อแทนเป้าหมายในแพ็กเกจ //external
แพ็กเกจ //external
ไม่ใช่แพ็กเกจ "ปกติ" เนื่องจากไม่มีไดเรกทอรีภายนอก จึงอาจกล่าวได้ว่าแพ็กเกจนี้เป็น "แพ็กเกจเสมือน" ที่มีเป้าหมายที่เชื่อมโยงทั้งหมด
ตัวอย่าง
หากต้องการตั้งชื่อแทนให้กับเป้าหมาย ให้bind
เป้าหมายนั้นในไฟล์ WORKSPACE ตัวอย่างเช่น
สมมติว่ามีเป้าหมาย java_library
ชื่อ
//third_party/javacc-v2
ซึ่งอาจเป็นชื่อแทนโดยการเพิ่มข้อมูลต่อไปนี้ลงในส่วน
ไฟล์ WORKSPACE:
bind( name = "javacc-latest", actual = "//third_party/javacc-v2", )
ตอนนี้เป้าหมายจะอิงตาม //external:javacc-latest
แทน //third_party/javacc-v2
หากมีการเผยแพร่ javacc-v3 คุณจะอัปเดตกฎ bind
ได้ และไฟล์ BUILD ทั้งหมดที่ขึ้นอยู่กับ //external:javacc-latest
ก็จะขึ้นอยู่กับ javacc-v3 โดยที่ไม่ต้องแก้ไข
นอกจากนี้ คุณยังใช้การเชื่อมโยงเพื่อทําให้เป้าหมายในที่เก็บข้อมูลภายนอกพร้อมใช้งานใน Workspace ได้ด้วย
เช่น หากมีการนำเข้าที่เก็บระยะไกลชื่อ @my-ssl
ใน
ไฟล์ WORKSPACE และมี cc_library เป้าหมาย //src:openssl-lib
คุณสามารถ
สร้างชื่อแทนสำหรับเป้าหมายนี้โดยใช้ bind
:
bind( name = "openssl", actual = "@my-ssl//src:openssl-lib", )
จากนั้นในไฟล์ BUILD ในพื้นที่ทำงาน คุณสามารถใช้เป้าหมายที่เชื่อมโยงได้ดังนี้
cc_library( name = "sign-in", srcs = ["sign_in.cc"], hdrs = ["sign_in.h"], deps = ["//external:openssl"], )
ภายใน sign_in.cc
และ sign_in.h
คุณสามารถอ้างอิงไฟล์ส่วนหัวที่ //external:openssl
แสดงได้โดยใช้เส้นทางที่สัมพันธ์กับรูทของที่เก็บ ตัวอย่างเช่น หากคำจำกัดความของกฎสำหรับ @my-ssl//src:openssl-lib
มีลักษณะดังนี้
ดังนี้
cc_library( name = "openssl-lib", srcs = ["openssl.cc"], hdrs = ["openssl.h"], )
ผลรวมของ sign_in.cc
อาจมีลักษณะดังนี้
#include "sign_in.h" #include "src/openssl.h"
อาร์กิวเมนต์
Attributes | |
---|---|
name |
ชื่อ ต้องระบุ ชื่อที่ไม่ซ้ำกันสำหรับเป้าหมายนี้ |
actual
|
ป้ายกํากับ ค่าเริ่มต้นคือ เป้าหมายนี้ต้องมีอยู่ แต่อาจเป็นกฎประเภทใดก็ได้ (รวมถึงการเชื่อมโยง) หากไม่ระบุแอตทริบิวต์นี้ กฎที่อ้างอิงเป้าหมายนี้ใน |
local_repository
ดูแหล่งที่มาของกฎlocal_repository(name, path, repo_mapping)
อนุญาตให้เชื่อมโยงเป้าหมายจากไดเรกทอรีในเครื่อง ซึ่งหมายความว่าที่เก็บปัจจุบันสามารถใช้เป้าหมายที่กําหนดไว้ในไดเรกทอรีอื่นนี้ได้ ดูรายละเอียดเพิ่มเติมได้ที่ส่วน bind
ตัวอย่าง
สมมติว่าที่เก็บปัจจุบันเป็นไคลเอ็นต์แชทที่รูทที่ไดเรกทอรี ~/chat-app ทั้งนี้
ต้องการใช้ไลบรารี SSL ซึ่งกำหนดไว้ในที่เก็บอื่น: ~/ssl ไลบรารี SSL มีเป้าหมาย //src:openssl-lib
ผู้ใช้สามารถเพิ่มการพึ่งพาในเป้าหมายนี้ได้โดยการเพิ่มบรรทัดต่อไปนี้ลงใน ~/chat-app/WORKSPACE
local_repository( name = "my-ssl", path = "/home/user/ssl", )
เป้าหมายจะระบุ @my-ssl//src:openssl-lib
เป็นทรัพยากร Dependency เพื่ออ้างอิงข้อมูลนี้
ไลบรารี
อาร์กิวเมนต์
Attributes | |
---|---|
name |
ชื่อ ต้องระบุ ชื่อที่ไม่ซ้ำกันสำหรับเป้าหมายนี้ |
path
|
สตริง ต้องระบุ เส้นทางไปยังไดเรกทอรีของที่เก็บในเครื่องต้องเป็นเส้นทางไปยังไดเรกทอรีที่มีที่เก็บของ WORKSPACE เส้นทางอาจเป็นเส้นทางแบบสัมบูรณ์หรือสัมพัทธ์กับไฟล์ WORKSPACE ของที่เก็บข้อมูลหลักก็ได้ |
repo_mapping
|
พจนานุกรม: สตริง -> สตริง ค่าเริ่มต้นคือ ตัวอย่างเช่น รายการ |
new_local_repository
ดูแหล่งที่มาของกฎnew_local_repository(name, build_file, build_file_content, path, repo_mapping, workspace_file, workspace_file_content)
อนุญาตให้เปลี่ยนไดเรกทอรีในเครื่องให้กลายเป็นที่เก็บ Bazel ซึ่งหมายความว่า สามารถกำหนดและใช้เป้าหมายได้จากทุกที่ในระบบไฟล์
กฎนี้สร้างที่เก็บ Bazel โดยการสร้างไฟล์ WORKSPACE และไดเรกทอรีย่อยที่มี
symlink ไปยังไฟล์ BUILD และเส้นทางที่กำหนด ไฟล์บิลด์ควรสร้างเป้าหมายที่สัมพันธ์กับ
path
สำหรับไดเรกทอรีที่มีไฟล์ WORKSPACE และไฟล์ BUILD อยู่แล้ว คุณจะใช้กฎ local_repository
ได้
ตัวอย่าง
สมมติว่าที่เก็บปัจจุบันคือไคลเอ็นต์แชทที่รูทอยู่ที่ไดเรกทอรี ~/chat-app ซึ่งต้องการใช้ไลบรารี SSL ที่กําหนดไว้ในไดเรกทอรีอื่น ~/ssl
ผู้ใช้จะเพิ่มทรัพยากร Dependency ได้โดยการสร้างไฟล์ BUILD สำหรับไลบรารี SSL (~/chat-app/BUILD.my-ssl) ที่มี:
java_library( name = "openssl", srcs = glob(['*.java']) visibility = ["//visibility:public"], )
จากนั้นผู้ใช้จะเพิ่มบรรทัดต่อไปนี้ลงใน ~/chat-app/WORKSPACE ได้
new_local_repository( name = "my-ssl", path = "/home/user/ssl", build_file = "BUILD.my-ssl", )
การดำเนินการนี้จะสร้างที่เก็บ @my-ssl
ที่ลิงก์กับ /home/user/ssl
เป้าหมายพึ่งพาไลบรารีนี้ได้โดยการเพิ่ม @my-ssl//:openssl
ไปยัง
ทรัพยากร Dependency
คุณยังสามารถใช้ new_local_repository
เพื่อรวมไฟล์เดี่ยวๆ นอกเหนือจาก
ไดเรกทอรี ตัวอย่างเช่น สมมติว่าคุณมีไฟล์ jar ที่ /home/username/Downloads/piano.jar คุณ
เพิ่มเฉพาะไฟล์นั้นในบิลด์โดยการเพิ่มรายการต่อไปนี้ลงในไฟล์ WORKSPACE
new_local_repository( name = "piano", path = "/home/username/Downloads/piano.jar", build_file = "BUILD.piano", )
และสร้างไฟล์ BUILD.piano ต่อไปนี้:
java_import( name = "play-music", jars = ["piano.jar"], visibility = ["//visibility:public"], )จากนั้นเป้าหมายอาจขึ้นอยู่กับ
@piano//:play-music
เพื่อใช้ piano.jar
อาร์กิวเมนต์
Attributes | |
---|---|
name |
ชื่อ ต้องระบุ ชื่อที่ไม่ซ้ำกันสำหรับเป้าหมายนี้ |
build_file
|
ชื่อ ค่าเริ่มต้นคือ ต้องระบุ create_file หรือbuild_file_content แอตทริบิวต์นี้เป็นป้ายกำกับที่เกี่ยวข้องกับพื้นที่ทํางานหลัก ไฟล์ไม่จำเป็นต้องมีชื่อว่า BUILD แต่อาจเป็นเช่นนั้นได้ (ชื่อเช่น BUILD.new-repo-name อาจเหมาะสำหรับ เพื่อแยกออกจากไฟล์ BUILD จริงของที่เก็บ) |
build_file_content
|
String; ค่าเริ่มต้นคือ ต้องระบุ build_file หรือ build_file_content |
path
|
สตริง; ต้องระบุ เส้นทางในระบบไฟล์ในเครื่องซึ่งอาจเป็นค่าสัมบูรณ์หรือสัมพัทธ์กับไฟล์ WORKSPACE ของที่เก็บข้อมูลหลักก็ได้ |
repo_mapping
|
พจนานุกรม: สตริง -> สตริง ค่าเริ่มต้นคือ ตัวอย่างเช่น รายการ |
workspace_file
|
ชื่อ ค่าเริ่มต้นคือ คุณสามารถระบุ workspace_file หรือ workspace_file_content เพียงรายการใดรายการหนึ่ง แอตทริบิวต์นี้เป็นป้ายกำกับที่เกี่ยวข้องกับพื้นที่ทํางานหลัก ไฟล์ไม่จำเป็นต้องมีชื่อว่า WORKSPACE แต่สามารถตั้งชื่อเป็นเช่นนั้นได้ (ชื่ออย่าง WORKSPACE.new-repo-name อาจใช้ได้ดีในการแยกความแตกต่างจากไฟล์ WORKSPACE จริงของที่เก็บ) |
workspace_file_content
|
สตริง ค่าเริ่มต้นคือ คุณสามารถระบุ workspace_file หรือ workspace_file_content ได้ แต่ระบุทั้ง 2 รายการไม่ได้ |