คู่มือเริ่มต้นการค้นหาฉบับย่อ

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

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

โปรดดูรายละเอียดเกี่ยวกับภาษาและแฟล็ก --output ในคู่มือข้อมูลอ้างอิงคำค้นหาของ Bazel และข้อมูลอ้างอิงคำค้นหาของ Bazel รับความช่วยเหลือใน IDE โดยพิมพ์ bazel help query หรือ bazel help cquery ในบรรทัดคำสั่ง

วัตถุประสงค์

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

ข้อกำหนดเบื้องต้น

เริ่มต้นด้วยการติดตั้ง Bazel หากยังไม่ได้ติดตั้ง บทแนะนำนี้ใช้ Git สำหรับการควบคุมแหล่งที่มา ดังนั้นให้ติดตั้ง Git ด้วยเพื่อให้ได้ผลลัพธ์ที่ดีที่สุด

เครื่องมือที่เรียกว่า Graphviz ใช้ในการดาวน์โหลดเพื่อให้เห็นภาพของกราฟทรัพยากร Dependency

รับโปรเจ็กต์ตัวอย่าง

ถัดไป ให้เรียกแอปตัวอย่างจากที่เก็บตัวอย่างของ Bazel โดยเรียกใช้โค้ดต่อไปนี้ในเครื่องมือบรรทัดคำสั่งที่เลือก

git clone https://github.com/bazelbuild/examples.git

โปรเจ็กต์ตัวอย่างสำหรับบทแนะนำนี้อยู่ในไดเรกทอรี examples/query-quickstart

เริ่มต้นใช้งาน

คำค้นหาของ Bazel คืออะไร

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

หากต้องการเรียกใช้การค้นหา ให้เปิดเทอร์มินัลบรรทัดคำสั่งและป้อนดังนี้

bazel query 'query_function'

สถานการณ์

ลองนึกภาพสถานการณ์ที่เจาะลึกถึงความสัมพันธ์ระหว่าง Cafe Bazel กับเชฟของร้าน คาเฟ่นี้ขายเฉพาะพิซซ่าและแมค และ สำหรับชีส ลองดูโครงสร้างของโครงการที่ด้านล่าง

bazelqueryguide
├── BUILD
├── src
│   └── main
│       └── java
│           └── com
│               └── example
│                   ├── customers
│                   │   ├── Jenny.java
│                   │   ├── Amir.java
│                   │   └── BUILD
│                   ├── dishes
│                   │   ├── Pizza.java
│                   │   ├── MacAndCheese.java
│                   │   └── BUILD
│                   ├── ingredients
│                   │   ├── Cheese.java
│                   │   ├── Tomatoes.java
│                   │   ├── Dough.java
│                   │   ├── Macaroni.java
│                   │   └── BUILD
│                   ├── restaurant
│                   │   ├── Cafe.java
│                   │   ├── Chef.java
│                   │   └── BUILD
│                   ├── reviews
│                   │   ├── Review.java
│                   │   └── BUILD
│                   └── Runner.java
└── WORKSPACE

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

โปรเจ็กต์ประกอบด้วยแพ็กเกจต่างๆ ที่ประกอบกันเป็น Cafe โดยจะแบ่งออกเป็น restaurant, ingredients, dishes, customers และ reviews กฎภายในแพ็กเกจเหล่านี้จะกำหนดคอมโพเนนต์ต่างๆ ของ Cafe ด้วยแท็กและทรัพยากร Dependency ต่างๆ

การเรียกใช้บิลด์

โปรเจ็กต์นี้มีเมธอดหลักใน Runner.java ที่คุณเรียกใช้ได้ เพื่อพิมพ์เมนูของคาเฟ่ สร้างโปรเจ็กต์โดยใช้ Bazel ด้วยคำสั่ง bazel build และใช้ : เพื่อส่งสัญญาณแจ้งว่าเป้าหมายชื่อ runner โปรดดู ชื่อเป้าหมายเพื่อดูวิธี เป้าหมายอ้างอิง

หากต้องการสร้างโปรเจ็กต์นี้ ให้วางคำสั่งนี้ลงในเทอร์มินัล:

bazel build :runner

เอาต์พุตของคุณควรมีลักษณะดังนี้หากบิลด์เสร็จสมบูรณ์

INFO: Analyzed target //:runner (49 packages loaded, 784 targets configured).
INFO: Found 1 target...
Target //:runner up-to-date:
  bazel-bin/runner.jar
  bazel-bin/runner
INFO: Elapsed time: 16.593s, Critical Path: 4.32s
INFO: 23 processes: 4 internal, 10 darwin-sandbox, 9 worker.
INFO: Build completed successfully, 23 total actions

หลังจากสร้างสำเร็จแล้ว ให้เรียกใช้แอปพลิเคชันโดยวางคำสั่งนี้

bazel-bin/runner
--------------------- MENU -------------------------

Pizza - Cheesy Delicious Goodness
Macaroni & Cheese - Kid-approved Dinner

----------------------------------------------------

คุณจึงมีรายการในเมนูพร้อมคำอธิบายสั้นๆ

สำรวจเป้าหมาย

โปรเจ็กต์จะแสดงส่วนผสมและเมนูในบรรจุภัณฑ์ของตัวเอง หากต้องการใช้การค้นหาเพื่อดูกฎของแพ็กเกจ ให้เรียกใช้คำสั่ง bazel query package/…

ในกรณีนี้ คุณสามารถดูส่วนผสมและเมนูอาหารที่ Cafe แห่งนี้มีได้โดยเรียกใช้

bazel query //src/main/java/com/example/dishes/...
bazel query //src/main/java/com/example/ingredients/...

หากคุณค้นหาเป้าหมายของแพ็กเกจส่วนผสม ผลลัพธ์ควรมีลักษณะดังนี้

//src/main/java/com/example/ingredients:cheese
//src/main/java/com/example/ingredients:dough
//src/main/java/com/example/ingredients:macaroni
//src/main/java/com/example/ingredients:tomato

การค้นหาทรัพยากร Dependency

เป้าหมายที่นักวิ่งของคุณใช้ในการวิ่งคืออะไร

สมมติว่าคุณต้องการเจาะลึกโครงสร้างของโครงการโดยไม่ต้องใช้ระบบไฟล์ (ซึ่งอาจไม่สามารถเปิดใช้สำหรับโปรเจ็กต์ขนาดใหญ่) Cafe Bazel ใช้กฎอะไรบ้าง

หากเป้าหมายของรันเนอร์คือ runner ดังเช่นในตัวอย่างนี้ ให้ค้นหาทรัพยากร Dependency เบื้องหลังของเป้าหมายโดยเรียกใช้คำสั่ง

bazel query --noimplicit_deps "deps(target)"
bazel query --noimplicit_deps "deps(:runner)"
//:runner
//:src/main/java/com/example/Runner.java
//src/main/java/com/example/dishes:MacAndCheese.java
//src/main/java/com/example/dishes:Pizza.java
//src/main/java/com/example/dishes:macAndCheese
//src/main/java/com/example/dishes:pizza
//src/main/java/com/example/ingredients:Cheese.java
//src/main/java/com/example/ingredients:Dough.java
//src/main/java/com/example/ingredients:Macaroni.java
//src/main/java/com/example/ingredients:Tomato.java
//src/main/java/com/example/ingredients:cheese
//src/main/java/com/example/ingredients:dough
//src/main/java/com/example/ingredients:macaroni
//src/main/java/com/example/ingredients:tomato
//src/main/java/com/example/restaurant:Cafe.java
//src/main/java/com/example/restaurant:Chef.java
//src/main/java/com/example/restaurant:cafe
//src/main/java/com/example/restaurant:chef

ในกรณีส่วนใหญ่ ให้ใช้ฟังก์ชันการค้นหา deps() เพื่อดูทรัพยากร Dependency ของเอาต์พุตแต่ละรายการของเป้าหมายที่เฉพาะเจาะจง

การแสดงภาพกราฟทรัพยากร Dependency (ไม่บังคับ)

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

เริ่มด้วยการเรียกใช้การค้นหาที่ต้องการและเพิ่มแฟล็ก --noimplicit_deps เพื่อนำทรัพยากร Dependency ของเครื่องมือที่มากเกินไปออก จากนั้นทำตามการค้นหาด้วยแฟล็กเอาต์พุต และเก็บกราฟไว้ในไฟล์ชื่อ graph.in เพื่อสร้างการนำเสนอแบบข้อความของกราฟ

หากต้องการค้นหาทรัพยากร Dependency ทั้งหมดของ :runner เป้าหมายและจัดรูปแบบเอาต์พุตเป็นกราฟ ให้ทำดังนี้

bazel query --noimplicit_deps 'deps(:runner)' --output graph > graph.in

การดำเนินการนี้จะสร้างไฟล์ชื่อ graph.in ซึ่งเป็นข้อความแสดงกราฟของบิลด์ Graphviz ใช้ dot ซึ่งเป็นเครื่องมือประมวลผลข้อความเป็นภาพ เพื่อสร้าง png

dot -Tpng < graph.in > graph.png

หากคุณเปิด graph.png คุณจะเห็นลักษณะนี้ เราได้ปรับกราฟด้านล่างให้เข้าใจง่ายขึ้นเพื่อให้รายละเอียดเส้นทางที่สำคัญชัดเจนยิ่งขึ้นในคู่มือนี้

แผนภาพแสดงความสัมพันธ์ระหว่างคาเฟ่กับเชฟกับอาหารจานต่างๆ ได้แก่ พิซซ่า แมคและชีส ที่แบ่งเป็นส่วนผสมอย่างชีส มะเขือเทศ แป้งโด และมักกะโรนี

ซึ่งจะมีประโยชน์เมื่อคุณต้องการดูเอาต์พุตของฟังก์ชันการค้นหาต่างๆ ตลอดทั้งคู่มือนี้

การค้นหาทรัพยากร Dependency แบบย้อนกลับ

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

เช่น คุณต้องการแก้ไขส่วนผสม cheese คุณต้องตรวจสอบว่าอาหารใดบ้างที่ใช้ cheese เพื่อไม่ให้เกิดปัญหาสำหรับ Cafe Bazel

หากต้องการดูว่าเป้าหมายใดขึ้นอยู่กับเป้าหมาย/แพ็กเกจหนึ่งๆ ให้ใช้ rdeps(universe_scope, target) ฟังก์ชันการค้นหา rdeps() มีอาร์กิวเมนต์อย่างน้อย 2 อาร์กิวเมนต์ คือ universe_scope — ไดเรกทอรีที่เกี่ยวข้อง — และ target Bazel จะค้นหาทรัพยากร Dependency แบบย้อนกลับของเป้าหมายภายใน universe_scope ที่ระบุ โอเปอเรเตอร์ rdeps() ยอมรับอาร์กิวเมนต์ที่สามซึ่งไม่บังคับ นั่นคือลิเทอรัลจำนวนเต็มที่ระบุขอบเขตบนของความลึกของการค้นหา

หากต้องการหาทรัพยากร Dependency แบบย้อนกลับของเป้าหมาย cheese ภายในขอบเขตของโปรเจ็กต์ "//..." ทั้งหมด ให้เรียกใช้คำสั่งดังนี้

bazel query "rdeps(universe_scope, target)"
ex) bazel query "rdeps(//... , //src/main/java/com/example/ingredients:cheese)"
//:runner
//src/main/java/com/example/dishes:macAndCheese
//src/main/java/com/example/dishes:pizza
//src/main/java/com/example/ingredients:cheese
//src/main/java/com/example/restaurant:cafe
//src/main/java/com/example/restaurant:chef

ผลลัพธ์การค้นหาแสดงให้เห็นว่าชีสเป็นที่พึ่งพาทั้งพิซซ่าและ macAndCheese แปลกใจจัง

กำลังค้นหาเป้าหมายตามแท็ก

ลูกค้า 2 คนเดินเข้าร้าน Bazel Cafe คือ Amir และ Jenny เราไม่มีข้อมูลเกี่ยวกับบุคคลดังกล่าว ยกเว้นชื่อ โชคดีที่มีการติดแท็กคำสั่งซื้อไว้ใน "ลูกค้า" BUILD ไฟล์ คุณเข้าถึงแท็กนี้ได้อย่างไร

นักพัฒนาแอปจะติดแท็กเป้าหมายของ Bazel ด้วยตัวระบุต่างๆ ซึ่งมักทำเพื่อการทดสอบได้ ตัวอย่างเช่น แท็กในการทดสอบสามารถใส่คำอธิบายประกอบบทบาทของการทดสอบในกระบวนการแก้ไขข้อบกพร่องและเปิดตัว โดยเฉพาะสำหรับการทดสอบ C++ และ Python ซึ่งขาดความสามารถในการคำอธิบายประกอบรันไทม์ การใช้แท็กและองค์ประกอบขนาดจะช่วยให้รวบรวมชุดการทดสอบได้อย่างยืดหยุ่นตามนโยบายการเช็คอินของ Codebase

ในตัวอย่างนี้ แท็กจะเป็นหนึ่งใน pizza หรือ macAndCheese เพื่อแสดงรายการเมนู คำสั่งนี้จะค้นหาเป้าหมายที่มีแท็กที่ตรงกับตัวระบุของคุณภายในแพ็กเกจหนึ่ง

bazel query 'attr(tags, "pizza", //src/main/java/com/example/customers/...)'

การค้นหานี้แสดงเป้าหมายทั้งหมดใน "ลูกค้า" ที่มีแท็ก "พิซซ่า"

ทดสอบตัวเอง

ใช้คำค้นหานี้เพื่อดูสิ่งที่เจนนภาต้องการสั่งซื้อ

คำตอบ

แมคแอนด์ชีส

การเพิ่มทรัพยากร Dependency ใหม่

Cafe Bazel ขยายเมนูเพิ่ม ลูกค้าสั่งสมูทตี้ได้แล้ว สมูทตี้สูตรนี้มีส่วนผสมอย่าง Strawberry และ Banana

ก่อนอื่นให้ใส่ส่วนผสมที่สมูตตี้ใช้อย่างStrawberry.javaและBanana.java เพิ่มคลาส Java ที่ว่างเปล่า

src/main/java/com/example/ingredients/Strawberry.java

package com.example.ingredients;

public class Strawberry {

}

src/main/java/com/example/ingredients/Banana.java

package com.example.ingredients;

public class Banana {

}

จากนั้นเพิ่ม Smoothie.java ในไดเรกทอรีที่เหมาะสม: dishes

src/main/java/com/example/dishes/Smoothie.java

package com.example.dishes;

public class Smoothie {
    public static final String DISH_NAME = "Smoothie";
    public static final String DESCRIPTION = "Yummy and Refreshing";
}

สุดท้าย ให้เพิ่มไฟล์เหล่านี้เป็นกฎในไฟล์ BUILD ที่เหมาะสม สร้างไลบรารี Java ใหม่สำหรับส่วนผสมใหม่แต่ละรายการ รวมถึงชื่อ การเปิดเผยต่อสาธารณะ และ "src" ที่สร้างขึ้นใหม่ คุณควรจะจบด้วยไฟล์ BUILD ที่อัปเดตแล้วนี้:

src/main/java/com/example/ingredients/BUILD

java_library(
    name = "cheese",
    visibility = ["//visibility:public"],
    srcs = ["Cheese.java"],
)

java_library(
    name = "dough",
    visibility = ["//visibility:public"],
    srcs = ["Dough.java"],
)

java_library(
    name = "macaroni",
    visibility = ["//visibility:public"],
    srcs = ["Macaroni.java"],
)

java_library(
    name = "tomato",
    visibility = ["//visibility:public"],
    srcs = ["Tomato.java"],
)

java_library(
    name = "strawberry",
    visibility = ["//visibility:public"],
    srcs = ["Strawberry.java"],
)

java_library(
    name = "banana",
    visibility = ["//visibility:public"],
    srcs = ["Banana.java"],
)

ในไฟล์ BUILD สำหรับอาหาร คุณต้องเพิ่มกฎใหม่สำหรับSmoothie การดำเนินการนี้จะรวมไฟล์ Java ที่สร้างขึ้นสำหรับ Smoothie เป็น "src" และกฎใหม่ที่คุณได้กำหนดไว้สำหรับส่วนผสมแต่ละอย่างของสมูทตี้

src/main/java/com/example/dishes/BUILD

java_library(
    name = "macAndCheese",
    visibility = ["//visibility:public"],
    srcs = ["MacAndCheese.java"],
    deps = [
        "//src/main/java/com/example/ingredients:cheese",
        "//src/main/java/com/example/ingredients:macaroni",
    ],
)

java_library(
    name = "pizza",
    visibility = ["//visibility:public"],
    srcs = ["Pizza.java"],
    deps = [
        "//src/main/java/com/example/ingredients:cheese",
        "//src/main/java/com/example/ingredients:dough",
        "//src/main/java/com/example/ingredients:tomato",
    ],
)

java_library(
    name = "smoothie",
    visibility = ["//visibility:public"],
    srcs = ["Smoothie.java"],
    deps = [
        "//src/main/java/com/example/ingredients:strawberry",
        "//src/main/java/com/example/ingredients:banana",
    ],
)

สุดท้าย ใส่สมูทตี้เป็นทรัพยากร Dependency ในไฟล์ BUILD ของ Chef

src/main/java/com/example/restaurant/BUILD

java\_library(
    name = "chef",
    visibility = ["//visibility:public"],
    srcs = [
        "Chef.java",
    ],

    deps = [
        "//src/main/java/com/example/dishes:macAndCheese",
        "//src/main/java/com/example/dishes:pizza",
        "//src/main/java/com/example/dishes:smoothie",
    ],
)

java\_library(
    name = "cafe",
    visibility = ["//visibility:public"],
    srcs = [
        "Cafe.java",
    ],
    deps = [
        ":chef",
    ],
)

สร้าง cafe อีกครั้งเพื่อยืนยันว่าไม่มีข้อผิดพลาด ถ้าสร้างได้สำเร็จก็ขอแสดงความยินดีด้วย คุณได้เพิ่มทรัพยากร Dependency ใหม่สำหรับ "Cafe" แล้ว หากไม่ ให้ระวังข้อผิดพลาดในการสะกดคำและการตั้งชื่อแพ็กเกจ ดูข้อมูลเพิ่มเติมเกี่ยวกับการเขียนไฟล์ BUILD ได้ที่ BUILD Style Guide

จากนั้นแสดงภาพกราฟทรัพยากร Dependency ใหม่ด้วยการเพิ่ม Smoothie เพื่อเปรียบเทียบกับกราฟก่อนหน้า เพื่อความชัดเจน ให้ตั้งชื่อกราฟที่ป้อนเป็น graph2.in และ graph2.png

bazel query --noimplicit_deps 'deps(:runner)' --output graph > graph2.in
dot -Tpng < graph2.in > graph2.png

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

เมื่อดูที่ graph2.png คุณจะเห็นว่า Smoothie ไม่มีทรัพยากร Dependency ที่แชร์กับอาหารอื่นๆ แต่เป็นเพียงเป้าหมายอีกรายการหนึ่งที่ Chef ใช้

somepath() และ allpaths()

จะเกิดอะไรขึ้นหากคุณต้องการค้นหาว่าเหตุใดแพ็กเกจหนึ่งจึงพึ่งพาแพ็กเกจอื่น การแสดงเส้นทางการอ้างอิงระหว่างเส้นทางทั้งสองจะให้คำตอบ

ฟังก์ชัน 2 รายการจะช่วยคุณค้นหาเส้นทางทรัพยากร Dependency ได้ ซึ่งได้แก่ somepath() และ allpaths() เมื่อมีเป้าหมายเริ่มต้น S และจุดปลายทาง E แล้ว ให้หาเส้นทางระหว่าง S และ E โดยใช้ somepath(S,E)

สำรวจความแตกต่างระหว่าง 2 หน้าที่นี้โดยดูความสัมพันธ์ระหว่าง "เชฟ" และ "Cheese" เป้าหมาย มีเส้นทางที่เป็นไปได้หลายวิธีจากเป้าหมายหนึ่งไปยังอีกเป้าหมายหนึ่ง:

  • เชฟ → MacAndCheese → ชีส
  • เชฟ → พิซซ่า → ชีส

somepath() จะแสดงเส้นทางเดียวจาก 2 ตัวเลือก ขณะที่ "allpaths()" จะแสดงผลทุกเส้นทางที่เป็นไปได้

เมื่อใช้ Cafe Bazel ให้เรียกใช้คำสั่งต่อไปนี้

bazel query "somepath(//src/main/java/com/example/restaurant/..., //src/main/java/com/example/ingredients:cheese)"
//src/main/java/com/example/restaurant:cafe
//src/main/java/com/example/restaurant:chef
//src/main/java/com/example/dishes:macAndCheese
//src/main/java/com/example/ingredients:cheese

ผลลัพธ์ที่ได้มาจากเส้นทางแรกของ Cafe → Chef → MacAndCheese → Cheese หากใช้ allpaths() แทน คุณจะได้รับสิทธิประโยชน์ต่อไปนี้

bazel query "allpaths(//src/main/java/com/example/restaurant/..., //src/main/java/com/example/ingredients:cheese)"
//src/main/java/com/example/dishes:macAndCheese
//src/main/java/com/example/dishes:pizza
//src/main/java/com/example/ingredients:cheese
//src/main/java/com/example/restaurant:cafe
//src/main/java/com/example/restaurant:chef

เส้นทางเอาต์พุตของคาเฟ่ไปยังเชฟและพิซซ่า แมคและชีสไปจนถึงชีส

เอาต์พุตของ allpaths() จะอ่านยากขึ้นเล็กน้อยเนื่องจากเป็นรายการทรัพยากร Dependency ที่ได้รับการแก้ไขแล้ว การแสดงภาพกราฟนี้โดยใช้ Graphviz ช่วยให้เข้าใจความสัมพันธ์อย่างชัดเจนยิ่งขึ้น

ทดสอบตัวเอง

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

bazel build //src/main/java/com/example/reviews:review
bazel-bin/src/main/java/com/example/reviews/review

ไม่เพียงแค่ตอบคำถามของ Bazel เท่านั้น ให้ลองดูว่าใครเป็นคนเขียนรีวิวและเมนูที่คนเขียนอธิบาย

คำใบ้

ตรวจสอบแท็กและทรัพยากร Dependency เพื่อดูข้อมูลที่เป็นประโยชน์

คำตอบ

รีวิวนี้อธิบายถึงพิซซ่าและอาเมียร์เป็นผู้รีวิว หากคุณดูทรัพยากร Dependency ที่กฎนี้ใช้อยู่ bazel query --noimplicit\_deps 'deps(//src/main/java/com/example/reviews:review)' ผลของคำสั่งนี้ทำให้ Amir เป็นผู้ตรวจสอบ ต่อไป เนื่องจากคุณทราบว่าผู้รีวิวคืออาเมียร์ คุณจึงใช้ฟังก์ชันค้นหาเพื่อค้นหาแท็กของอาเมียร์ในไฟล์ "BUILD" เพื่อดูว่ามีอาหารอะไรอยู่ในนั้นได้ คำสั่ง bazel query 'attr(tags, "pizza", //src/main/java/com/example/customers/...)' จะแสดงข้อความว่าอัมราเป็นลูกค้าเพียงคนเดียวที่สั่งพิซซ่าและเป็นผู้รีวิวที่ให้คำตอบแก่เรา

ใกล้จะเสร็จแล้ว

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