pubspec.yaml की संरचना

हर Dart project के root में pubspec.yaml होता है। यह manifest है, जो आपके project का विवरण देता है और उसकी सभी dependencies सूचीबद्ध करता है। 📄

Dart यहाँ YAML का उपयोग करता है क्योंकि इसे मनुष्य आसानी से पढ़ सकते हैं: indentation से structure दिखता है और keys के बाद colon तथा value लिखी जाती है। Braces की आवश्यकता नहीं होती।

name फ़ील्ड आवश्यक है। इसमें lowercase अक्षरों और underscores का उपयोग होना चाहिए। यही वह identifier बनता है, जिसका उपयोग दूसरा code आपके package को import करने के लिए करता है।

लोगों को आपके package का काम समझाने के लिए छोटा description जोड़ें। साथ ही version दें, जो major.minor.patch format का पालन करे, जैसे 1.2.0।

environment key बताती है कि आपका project Dart SDK के किन versions का समर्थन करता है। यदि आपका SDK इस range से बाहर हो, तो tools चलने से मना कर देते हैं।

dependencies section उन packages की सूची देती है, जिनकी आपके code को runtime पर आवश्यकता होती है। हर entry में package name को version constraint से जोड़ा जाता है।

उन tools के लिए dev_dependencies का उपयोग करें, जिनकी आवश्यकता केवल build करते समय होती है, जैसे test या lint packages। आपका package इस्तेमाल करने वाले लोगों को ये भेजे नहीं जाते।

caret जैसे ^1.2.0 का अर्थ है 1.2.0 से लेकर 2.0.0 से पहले तक का कोई भी version। इससे सुरक्षित और संगत updates स्वीकार किए जा सकते हैं।

YAML nesting दिखाने के लिए spaces का उपयोग करता है, tabs का नहीं। गलत alignment वाली key file को खराब कर देती है, इसलिए पूरे file में दो-space indentation समान रखें।

आप homepage, repository और publish_to fields भी जोड़ सकते हैं। ये users को links देते हैं और आवश्यकता पड़ने पर package को private रखने देते हैं।

जब आप pub commands चलाते हैं, तो tool सबसे पहले pubspec.yaml पढ़कर आपकी dependencies जानता है। फिर वह आपके लिए सब कुछ fetch और resolve करता है। 🔧

आपने सीखा कि pubspec.yaml आपके project का नाम रखता है, SDK range तय करता है और runtime तथा dev dependencies सूचीबद्ध करता है। यह हर Dart project का केंद्र है। 🎉