ข้อจำกัดเวอร์ชันและไฟล์ล็อก

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

แพ็กเกจ Dart ใช้ semantic versioning: major.minor.patch การเพิ่ม major หมายถึงการเปลี่ยนแปลงที่อาจทำให้ใช้ไม่ได้ การเพิ่ม minor คือการเพิ่มฟีเจอร์ และการเพิ่ม patch คือการแก้บัก

caret ^1.2.0 ยอมรับทุกเวอร์ชันตั้งแต่ 1.2.0 จนถึงก่อน 2.0.0 นี่คือค่าเริ่มต้นที่เป็นมิตรซึ่ง pub ใช้

การเขียนตัวเลขเปล่า ๆ หมายถึง exactly เวอร์ชันนั้นเท่านั้นและไม่มีเวอร์ชันอื่น ใช้อย่างจำกัดเมื่อคุณต้องการรุ่นเดียวที่ทราบว่าใช้งานได้

คุณสามารถเขียน range ด้วยตัวดำเนินการเปรียบเทียบได้ วิธีนี้ช่วยควบคุมทั้งขอบเขตล่างและขอบเขตบนได้อย่างละเอียด

การใช้ any จะยอมรับทุกเวอร์ชัน ซึ่งมีความเสี่ยงเพราะรุ่น major ในอนาคตอาจทำให้โค้ดใช้ไม่ได้ ดังนั้นควรใช้ caret แทน

เมื่อ pub แก้ไขการพึ่งพาของคุณแล้ว จะบันทึกเวอร์ชันที่เลือกอย่างแน่นอนไว้ใน pubspec.lock ไฟล์นี้จะตรึงสิ่งที่ทุกคนติดตั้งจริง

ไฟล์ล็อกรับรองการสร้างแบบ reproducible กล่าวคือ เพื่อนร่วมทีมที่เรียกใช้ pub get จะได้เวอร์ชันเดียวกับที่คุณทดสอบ ไม่ใช่การอัปเกรดที่เกิดขึ้นโดยไม่คาดคิด

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

เรียกใช้ dart pub upgrade เพื่อปรับ pubspec.lock เป็นเวอร์ชันใหม่ที่สุดที่ข้อกำหนดของคุณอนุญาต ส่วน get แบบปกติจะคงเวอร์ชันที่ตรึงไว้เดิม

หากแพ็กเกจสองรายการต้องการเวอร์ชันที่เข้ากันไม่ได้ pub จะแจ้ง conflict จากนั้นคุณต้องผ่อนข้อกำหนดหรือเลือกเวอร์ชันแพ็กเกจที่เข้ากันได้

ตอนนี้คุณอ่าน constraints เช่น caret และช่วงเวอร์ชันได้แล้ว และทราบว่า pubspec.lock จะตรึงเวอร์ชันที่แน่นอนเพื่อให้สร้างซ้ำได้และปราศจากความขัดแย้ง 🎉