ข้อมูลอ้างอิง CLI ของ Lightbuild

Lightbuild CLI เป็นเครื่องมือบรรทัดคำสั่งอย่างเป็นทางการสำหรับ Lightbuild หน้านี้จะอธิบายคำสั่งและตัวเลือกของเครื่องมือดังกล่าว หากต้องการติดตั้ง Lightbuild CLI โปรดดูหัวข้อติดตั้ง Lightbuild CLI สำหรับงานทั่วไป เช่น การสร้างและทดสอบโปรเจ็กต์ โปรดดูหัวข้อสร้างโปรเจ็กต์ Lightbuild จากบรรทัดคำสั่ง

ไวยากรณ์

Lightbuild CLI ใช้ไวยากรณ์ต่อไปนี้

lightbuild [-V] [--project=path] [COMMAND]

โดยรองรับตัวเลือกส่วนกลางต่อไปนี้

ตัวเลือก คำอธิบาย
-V, --version พิมพ์ข้อมูลเวอร์ชันและออก
-p, --project=path Absolute Path ไปยังโปรเจ็กต์ ค่าเริ่มต้นคือไดเรกทอรีปัจจุบัน ซึ่งต้องมีโปรเจ็กต์

หากต้องการแสดงรายการคำสั่งที่ใช้ได้ ให้เรียกใช้ lightbuild help หากต้องการความช่วยเหลือเกี่ยวกับคำสั่งที่เฉพาะเจาะจง ให้เรียกใช้ lightbuild help [command]

lightbuild build

สร้างเป้าหมายในโปรเจ็กต์

lightbuild build [target]
อาร์กิวเมนต์ คำอธิบาย
target เป้าหมายที่จะสร้าง ค่าเริ่มต้นคือเป้าหมายทั้งหมดที่อยู่ใต้ไดเรกทอรีปัจจุบัน

เช่น หากต้องการสร้างโมดูล app ให้เรียกใช้คำสั่งต่อไปนี้

lightbuild build app

หากต้องการสร้างเป้าหมายทั้งหมดในโปรเจ็กต์ ให้เรียกใช้คำสั่งต่อไปนี้

lightbuild build

lightbuild clean

นำเอาต์พุตบิลด์และแคชของโปรเจ็กต์ออก

lightbuild clean [target]
อาร์กิวเมนต์ คำอธิบาย
target เป้าหมายที่จะล้าง ค่าเริ่มต้นคือเป้าหมายทั้งหมดที่อยู่ใต้ไดเรกทอรีปัจจุบัน

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

lightbuild clean

lightbuild help

แสดงรายการคำสั่งที่ใช้ได้ หรือแสดงความช่วยเหลือสำหรับคำสั่งที่เฉพาะเจาะจง

lightbuild help [COMMAND]
อาร์กิวเมนต์ คำอธิบาย
COMMAND คำสั่งที่จะแสดงความช่วยเหลือ ค่าเริ่มต้นคือคำสั่งทั้งหมด

หากต้องการแสดงรายการคำสั่งที่ใช้ได้สำหรับโปรเจ็กต์ ให้เรียกใช้คำสั่งต่อไปนี้

lightbuild help

หากต้องการแสดงความช่วยเหลือสำหรับคำสั่งที่เฉพาะเจาะจง เช่น query ให้เรียกใช้คำสั่งต่อไปนี้

lightbuild help query

lightbuild query

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

lightbuild query [target-pattern] [--format=format] [--output=type]
ตัวเลือกหรืออาร์กิวเมนต์ คำอธิบาย
target-pattern รูปแบบเส้นทางเป้าหมาย เช่น ... หรือ app
--format=format รูปแบบเอาต์พุต เช่น json ค่าเริ่มต้นคือตาราง
--output=type รูปแบบของเอาต์พุต: files สำหรับตำแหน่งของไฟล์ที่เป้าหมายที่ตรงกันสร้างขึ้น sourcesets สำหรับชุดซอร์ส หรือ sourceset_types สำหรับประเภทของชุดซอร์ส

หากต้องการแสดงรายการเป้าหมายทั้งหมดในโปรเจ็กต์ ให้เรียกใช้คำสั่งต่อไปนี้

lightbuild query ...

หากต้องการพิมพ์ตำแหน่งของไฟล์ที่เป้าหมาย app สร้างขึ้น ให้เรียกใช้คำสั่งต่อไปนี้

lightbuild query app --output=files

lightbuild resolve

แก้ไขทรัพยากร Dependency ภายนอกของโปรเจ็กต์และสร้างไฟล์ล็อกทรัพยากร Dependency ออฟไลน์ (resolved.deps) สำหรับโมดูล

lightbuild resolve [--cache=path] [--locked-dependencies] [target]
ตัวเลือกหรืออาร์กิวเมนต์ คำอธิบาย
target โมดูลที่จะแก้ไขทรัพยากร Dependency เช่น app ค่าเริ่มต้นคือเป้าหมายทั้งหมดที่อยู่ใต้ไดเรกทอรีปัจจุบัน
--locked-dependencies ออกพร้อมข้อผิดพลาดหากไฟล์ล็อกทรัพยากร Dependency ในเครื่อง (resolved.deps) ไม่ซิงค์กัน
--cache=path ไดเรกทอรีสำหรับจัดเก็บแคชทรัพยากร Dependency

เช่น หากต้องการสร้างไฟล์ resolved.deps สำหรับโมดูลทั้งหมดในโปรเจ็กต์ ให้เรียกใช้คำสั่งต่อไปนี้

lightbuild resolve

ดูข้อมูลเพิ่มเติมเกี่ยวกับไฟล์ resolved.deps ได้ที่ทรัพยากร Dependency ที่แก้ไขแล้ว

lightbuild test

เรียกใช้การทดสอบในโปรเจ็กต์ ซึ่งได้แก่ การทดสอบในเครื่องที่ทำงานในคอมพิวเตอร์สำหรับการพัฒนาซอฟต์แวร์ และการทดสอบการวัดคุมที่ทำงานในอุปกรณ์ที่เชื่อมต่อหรือโปรแกรมจำลองที่ทำงานอยู่ หากต้องการทดสอบโมดูลเดียว ให้ระบุเป้าหมาย เช่น app-core หากต้องการเรียกใช้การทดสอบเพียงประเภทเดียว ให้เพิ่ม :hostTest สำหรับการทดสอบในเครื่องหรือ :deviceTest สำหรับการทดสอบการวัดคุมไปยังเป้าหมาย

lightbuild test [target] [--locked-dependencies]
ตัวเลือกหรืออาร์กิวเมนต์ คำอธิบาย
target เป้าหมายที่จะทดสอบ ค่าเริ่มต้นคือการทดสอบทั้งหมดในโปรเจ็กต์
--locked-dependencies บิลด์จะล้มเหลวหากไฟล์ล็อกทรัพยากร Dependency ในเครื่อง (resolved.deps) ไม่ซิงค์กัน

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

lightbuild test

หากต้องการเรียกใช้การทดสอบในเครื่องในโมดูล app-core ให้เรียกใช้คำสั่งต่อไปนี้

lightbuild test app-core:hostTest

หากต้องการเรียกใช้การทดสอบการวัดคุมในโมดูล app-core บนอุปกรณ์หรือโปรแกรมจำลอง ให้เรียกใช้คำสั่งต่อไปนี้

lightbuild test app-core:deviceTest