build.zig.zon และตัวจัดการแพ็กเกจ

ถัดจาก build.zig จะมี build.zig.zon ซึ่งเป็นไฟล์รายการที่ระบุชื่อแพ็กเกจและรายการสิ่งที่แพ็กเกจพึ่งพา 📜

ไฟล์นี้เขียนด้วย ZON ซึ่งมีลักษณะเหมือนลิเทอรัลโครงสร้างข้อมูลนิรนามของ Zig ชื่อฟิลด์ที่มีจุดคั่นจะจับคู่กับค่าของ Zig ทั่วไป

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

ฟิลด์ dependencies เป็นโครงสร้างข้อมูลของรายการต่าง ๆ โดยมีหนึ่งรายการต่อหนึ่งแพ็กเกจภายนอกที่คุณต้องการนำเข้าสู่การสร้าง

สิ่งที่พึ่งพาแต่ละรายการระบุ url ไปยังไฟล์ tarball ซึ่งโดยทั่วไปเป็นคลังเก็บที่ติดแท็กไว้บนบริการโฮสต์โค้ด จากนั้น Zig จะดาวน์โหลดและแตกไฟล์ให้คุณ

ฟิลด์ hash จะระบุไบต์ที่แน่นอนของไฟล์ดาวน์โหลดนั้น หากเนื้อหาเปลี่ยนแปลง แฮชจะไม่ตรงกันและการสร้างจะปฏิเสธไฟล์ดังกล่าว

โดยทั่วไปคุณไม่ต้องพิมพ์แฮชด้วยตนเอง เรียกใช้ zig fetch พร้อม url แล้วคำสั่งจะดาวน์โหลด คำนวณแฮช และเขียนรายการให้คุณ

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

ฟิลด์ paths จะแสดงรายการไฟล์ที่รวมอยู่เมื่อแพ็กเกจของคุณถูกใช้เป็นสิ่งที่พึ่งพาเอง ใช้ .{""} เพื่อจัดส่งทุกอย่างในโฟลเดอร์

เนื่องจากมีแฮชที่แน่นอน build.zig.zon จึงทำให้การสร้างทำซ้ำได้เหมือนเดิม ส่งไฟล์นี้เข้าคลังเพื่อให้สมาชิกทีมทุกคนดาวน์โหลดโค้ดเดียวกันทุกประการ

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

ทบทวนว่าอะไรรับประกันว่าไฟล์ดาวน์โหลดของสิ่งที่พึ่งพาไม่ถูกแก้ไข

คุณได้รู้จัก build.zig.zon ซึ่งเป็นไฟล์รายการ ZON ที่มีชื่อ เวอร์ชัน และสิ่งที่พึ่งพา โดยแต่ละรายการมี url และ hash ที่ zig fetch สามารถเติมให้ได้ 🎯