Dart Academy · पाठ

Publish करने योग्य Library की संरचना

lib, src और public API को व्यवस्थित करें

पाठ 1, कुल 4 में से13 चरण

Publish करने योग्य Library की संरचना, CoddyKit पर Dart Academy का एक निःशुल्क पाठ है। यह 4 में से 1वाँ पाठ है। आप नीचे पूरा पाठ निःशुल्क पढ़ सकते हैं—फिर अंतर्निहित कोड संपादक और 24/7 एआई ट्यूटर के साथ ब्राउज़र में इसका व्यावहारिक अभ्यास कर सकते हैं। यह Dart Academy सीखने के मार्ग का हिस्सा है और आपकी प्रगति वेब तथा CoddyKit ऐप पर सिंक होती रहती है। Dart Academy पाठ्यक्रम में कुल 4 पाठ शामिल हैं।

पैकेज बस एक फ़ोल्डर है

प्रकाशित किए जा सकने वाला Dart पैकेज मूल फ़ोल्डर में pubspec.yaml वाली एक साधारण फ़ोल्डर संरचना है। यही एक फ़ाइल सामान्य कोड को ऐसी चीज़ में बदलती है जिसे pub.dev होस्ट कर सकता है। 📦

lib फ़ोल्डर सार्वजनिक घर है

जिस भी चीज़ को आप चाहते हैं कि उपयोगकर्ता इम्पोर्ट करें, वह lib के अंतर्गत रहती है। lib में सीधे रखी गई फ़ाइलें आपके पैकेज के सार्वजनिक हिस्से का भाग होती हैं, इसलिए उन्हें सावधानी से रखें।

आंतरिक कोड lib/src में छिपाएँ

जिस कोड को आप उजागर नहीं करना चाहते, उसे lib/src में रखें। परंपरा के अनुसार ये फ़ाइलें निजी कार्यान्वयन विवरण होती हैं और उपयोगकर्ताओं द्वारा सीधे इम्पोर्ट करने के लिए नहीं होतीं।

lib/
  my_package.dart
  src/
    helper.dart

प्रवेश-बिंदु फ़ाइल

अधिकांश पैकेज lib में पैकेज के नाम वाली एक मुख्य फ़ाइल भेजते हैं। यह प्रवेश-बिंदु वह फ़ाइल है जिसे उपयोगकर्ता पूरी लाइब्रेरी एक साथ पाने के लिए इम्पोर्ट करते हैं।

import 'package:my_package/my_package.dart';

export कीवर्ड से फिर से एक्सपोर्ट करें

आपका प्रवेश-बिंदु lib/src के उन हिस्सों को सामने लाने के लिए export का उपयोग करता है जिनकी उपयोगकर्ताओं को वास्तव में आवश्यकता है। इस तरह आप एक साफ़ और उद्देश्यपूर्ण सार्वजनिक API तैयार करते हैं।

export 'src/calculator.dart';
export 'src/parser.dart';

अपना सार्वजनिक API सोच-समझकर तय करें

आप जिन नामों को एक्सपोर्ट करते हैं, उनका समूह आपका सार्वजनिक API है। इसे छोटा और स्थिर रखें, क्योंकि एक्सपोर्ट किया गया हर प्रतीक आपके उपयोगकर्ताओं से किया गया वादा है।

अंडरस्कोर का अर्थ निजी है

अंडरस्कोर से शुरू होने वाले नाम Dart में लाइब्रेरी-निजी होते हैं। lib/src के अंदर भी, जिन सहायक नामों को आप बाहर नहीं आने देना चाहते, उनके आगे एक अंडरस्कोर लगाएँ।

int _internalCount = 0;

example फ़ोल्डर

एक छोटा चलने योग्य प्रोग्राम रखने वाली example फ़ोल्डर जोड़ें। यह उपयोगकर्ताओं को दिखाती है कि आपका पैकेज कैसे काम करता है और pub.dev पर आपको अंक दिलाती है। ✨

परीक्षण test में रखें

स्वचालित परीक्षण lib के बाहर test फ़ोल्डर में रहते हैं। वे उपयोगकर्ताओं को भेजे नहीं जाते, लेकिन यह प्रमाणित करते हैं कि आपका पैकेज किए गए वादे के अनुसार काम करता है।

शीर्ष-स्तरीय फ़ाइलें महत्वपूर्ण हैं

एक अच्छे पैकेज के मूल फ़ोल्डर में README, एक CHANGELOG और एक LICENSE भी होते हैं। pub.dev पर आने वाले आगंतुकों को सबसे पहले यही तीन फ़ाइलें दिखाई देती हैं।

एक नज़र में साफ़ संरचना

सब कुछ मिलाने पर संरचना एक नक्शे जैसी दिखती है: API के लिए lib, आंतरिक कोड के लिए src, और साथ में example, test तथा मेटाडेटा फ़ाइलें।

my_package/
  lib/
  example/
  test/
  pubspec.yaml

त्वरित जाँच

जिस कोड को आंतरिक कार्यान्वयन विवरण बनाए रखना है, उसे आप कहाँ रखते हैं?

इंटरैक्टिव पाठ में इसका उत्तर दें

पुनरावलोकन: व्यवस्थित लाइब्रेरी

आपने संरचना सीखी: lib में सार्वजनिक API रहता है, lib/src आंतरिक कोड छिपाता है और export यह तय करता है कि उपयोगकर्ता क्या देखते हैं। पहले संरचना बनाएँ, फिर प्रकाशित करें। 🚀

शुरुआत निःशुल्क

एआई शिक्षक के साथ Dart सीखें — निःशुल्क

अपने ब्राउज़र में वास्तविक कोड लिखें और चलाएँ, चौबीसों घंटे एआई शिक्षक से तुरंत सहायता पाएँ, और वेब या ऐप पर वहीं से शुरू करें जहाँ आपने छोड़ा था।

पाठ्यक्रम: 30
पाठ: 120

निःशुल्क सीखना शुरू करें पूरा पाठ्यक्रम देखें

अक्सर पूछे जाने वाले प्रश्न

क्या “Publish करने योग्य Library की संरचना” पाठ निःशुल्क है?

हाँ—“Publish करने योग्य Library की संरचना” का पूरा पाठ यहाँ वेब पर निःशुल्क पढ़ा जा सकता है। इंटरैक्टिव अभ्यास (अंतर्निहित कोड संपादक और 24/7 एआई ट्यूटर) करने और Dart Academy पाठ्यक्रम का बाकी हिस्सा अनलॉक करने के लिए CoddyKit PRO लें। Dart Academy पाठ्यक्रम में कुल 4 पाठ शामिल हैं।

“Publish करने योग्य Library की संरचना” में मैं क्या सीखूँगा?

lib, src और public API को व्यवस्थित करें आप ब्राउज़र में सीधे चलाए जाने वाले व्यावहारिक कोड के साथ Dart Academy का अभ्यास करते हैं, और पाठ पूरा करते समय 24/7 एआई ट्यूटर आपके प्रश्नों के उत्तर देता है।

क्या Dart Academy शुरू करने के लिए मुझे किसी अनुभव की आवश्यकता है?

पहले के अनुभव की आवश्यकता नहीं है। CoddyKit पर Dart Academy शुरुआती से लेकर उन्नत शिक्षार्थियों तक सभी के लिए व्यवस्थित किया गया है, इसलिए आप यहीं से या शुरुआत से सीखना शुरू कर सकते हैं और अपनी गति से आगे बढ़ सकते हैं। यह 4 में से 1वाँ पाठ है।

“Publish करने योग्य Library की संरचना” पाठ पूरा करने में कितना समय लगता है?

CoddyKit का अधिकांश पाठ लगभग 5–10 मिनट में पूरा हो जाता है। हर पाठ छोटा और संवादात्मक है, इसलिए आप लगातार प्रगति करते हैं और वेब या ऐप पर वहीं से सीखना जारी रख सकते हैं जहाँ आपने छोड़ा था।

क्या मैं इस Dart Academy पाठ में कोड लिख और चला सकता हूँ?

हाँ। हर Dart Academy पाठ में एक अंतर्निर्मित कोड संपादक शामिल है, जिससे आप सीधे अपने ब्राउज़र में वास्तविक कोड लिख और चला सकते हैं और तुरंत एआई प्रतिक्रिया पा सकते हैं—स्थानीय सेटअप की आवश्यकता नहीं है।

इस पाठ्यक्रम के सभी पाठ

← Dart Academy पर वापस जाएँ