กฎที่เก็บในเครื่อง

ฟังก์ชันต่อไปนี้สามารถโหลดได้จาก @bazel_tools//tools/build_defs/repo:local.bzl

กฎสำหรับทำให้ไดเรกทอรีในระบบไฟล์ในเครื่องพร้อมใช้งานเป็นรีพอสิทรี

ตั้งค่า

หากต้องการใช้กฎเหล่านี้ในส่วนขยายโมดูล ให้โหลดกฎในไฟล์ .bzl แล้วเรียกใช้กฎจาก ฟังก์ชันการใช้งานของส่วนขยาย ตัวอย่างเช่น หากต้องการใช้ local_repository:

load("@bazel_tools//tools/build_defs/repo:local.bzl", "local_repository")

def _my_extension_impl(mctx):
  local_repository(name = "foo", path = "foo")

my_extension = module_extension(implementation = _my_extension_impl)

หรือคุณอาจเรียกใช้กฎที่เก็บเหล่านี้โดยตรงในไฟล์ MODULE.bazel ด้วย use_repo_rule:

local_repository = use_repo_rule("@bazel_tools//tools/build_defs/repo:local.bzl", "local_repository")
local_repository(name = "foo", path = "foo")

local_repository

load("@bazel//tools/build_defs/repo:local.bzl", "local_repository")

local_repository(name, path, repo_mapping)

ทำให้ไดเรกทอรีในเครื่องที่มีไฟล์ Bazel อยู่แล้วพร้อมใช้งานเป็นรีโป ไดเรกทอรีนี้ควรมีไฟล์ BUILD ของ Bazel และไฟล์ขอบเขตของ repo อยู่แล้ว หากไม่มีไฟล์เหล่านี้ ให้ลองใช้ new_local_repository แทน

แอตทริบิวต์

name	ชื่อ ต้องระบุ ชื่อที่ไม่ซ้ำกันสำหรับที่เก็บนี้
path	สตริง; ต้องระบุ เส้นทางไปยังไดเรกทอรีที่จะใช้เป็นที่เก็บ เส้นทางอาจเป็นเส้นทางแบบสัมบูรณ์หรือแบบสัมพัทธ์กับรูทของพื้นที่ทำงานก็ได้
repo_mapping	Dictionary: String -> String ไม่บังคับ ในบริบท "WORKSPACE" เท่านั้น: เป็นพจนานุกรมจากชื่อที่เก็บในเครื่องไปจนถึงชื่อที่เก็บส่วนกลาง ซึ่งช่วยให้ควบคุมการแก้ไขข้อกำหนดของพื้นที่ทำงานสำหรับข้อกำหนดของที่เก็บข้อมูลนี้ได้ ตัวอย่างเช่น รายการ `"@foo": "@bar"` ประกาศว่าเมื่อใดก็ตามที่ที่เก็บข้อมูลนี้ใช้ "@foo" (เช่น ใช้ "@foo//some:target") ระบบควรแก้ไขการพึ่งพาดังกล่าวภายใน "@bar" ที่ประกาศไว้ทั่วโลก ("@bar//some:target") ระบบไม่รองรับแอตทริบิวต์นี้ในบริบท `MODULE.bazel` (เมื่อเรียกใช้กฎที่เก็บข้อมูลภายในฟังก์ชันการใช้งานของส่วนขยายโมดูล)

new_local_repository

load("@bazel//tools/build_defs/repo:local.bzl", "new_local_repository")

new_local_repository(name, build_file, build_file_content, path, repo_mapping)

ทำให้ไดเรกทอรีในเครื่องที่ไม่มีไฟล์ Bazel พร้อมใช้งานเป็นพื้นที่เก็บข้อมูล ไดเรกทอรีนี้ไม่จำเป็นต้องมีไฟล์ Bazel BUILD หรือไฟล์ขอบเขตของที่เก็บ ที่สร้างโดยกฎที่เก็บนี้ หากไดเรกทอรีมีไฟล์ Bazel อยู่แล้ว ให้ลองใช้ local_repository แทน

แอตทริบิวต์

name	ชื่อ ต้องระบุ ชื่อที่ไม่ซ้ำกันสำหรับที่เก็บนี้
build_file	ป้ายกํากับ (ไม่บังคับ) ไฟล์ที่จะใช้เป็นไฟล์ BUILD สําหรับที่เก็บข้อมูลนี้ ต้องระบุ "build_file" และ "build_file_content" อย่างใดอย่างหนึ่งเท่านั้น ไฟล์ที่ติดป้ายกำกับนี้ไม่จำเป็นต้องมีชื่อว่า BUILD แต่สามารถเป็นได้ ชื่ออย่าง `BUILD.new-repo-name` อาจเหมาะที่จะใช้แยกความแตกต่างจากไฟล์ BUILD จริง
build_file_content	String; ไม่บังคับ เนื้อหาของไฟล์ BUILD ที่จะสร้างสำหรับที่เก็บนี้ ต้องระบุค่า "build_file" หรือ "build_file_content" อย่างใดอย่างหนึ่งเท่านั้น
path	สตริง; ต้องระบุ เส้นทางไปยังไดเรกทอรีที่จะใช้เป็นที่เก็บ เส้นทางอาจเป็นแบบสัมบูรณ์หรือสัมพัทธ์กับรูทของพื้นที่ทำงานก็ได้
repo_mapping	Dictionary: String -> String ไม่บังคับ ในบริบท "WORKSPACE" เท่านั้น: เป็นพจนานุกรมจากชื่อที่เก็บในเครื่องไปจนถึงชื่อที่เก็บส่วนกลาง ซึ่งช่วยให้ควบคุมการแก้ไขข้อกำหนดของพื้นที่ทำงานสำหรับข้อกำหนดของที่เก็บข้อมูลนี้ได้ เช่น รายการ `"@foo": "@bar"` จะประกาศว่า ไม่ว่าเมื่อใดที่เก็บนี้จะขึ้นอยู่กับ "@foo" (เช่น การพึ่งพา "@foo//some:target" ควรแก้ไขการขึ้นต่อกันภายใน "@bar" ที่ประกาศทั่วโลก (`@bar//some:target`) แอตทริบิวต์นี้รองรับ _not_ ในบริบท "MODULE.bazel" (เมื่อเรียกใช้กฎที่เก็บภายในฟังก์ชันการใช้งานของส่วนขยายโมดูล)