परिचय
हर PicoPixel फ़ाइल की अपनी लाइब्रेरी होती है। उसमें इस्तेमाल होने वाले रंग, फ़ॉन्ट, इमेज, एनिमेटेड इमेज और कंपोनेंट Assets पैनल में मिलते हैं। सामान्य रूप से यह लाइब्रेरी उसी फ़ाइल तक सीमित रहती है। फ़ाइल प्रकाशित करने पर टीम के सदस्य उसकी लाइब्रेरी अपने प्रोजेक्ट से जोड़ सकते हैं और उसके एसेट इस्तेमाल कर सकते हैं।
इस गाइड में लाइब्रेरी का काम, उसे प्रकाशित करने का मतलब और उसे दूसरे प्रोजेक्ट से जोड़ने का तरीका समझें। सबसे ज़रूरी बात:
Publish करने से आपका काम सार्वजनिक नहीं होता। लाइब्रेरी केवल आपकी टीम के लिए उपलब्ध होती है। वह इंटरनेट पर पोस्ट नहीं होती, सार्वजनिक सूची में नहीं आती और टीम से बाहर कोई उसे नहीं देख सकता। सामग्री टीम से बाहर केवल आपके जानबूझकर साझा करने पर जाती है; गाइड के अंत में इसके तरीके बताए गए हैं।
लाइब्रेरी क्या है?
लाइब्रेरी किसी फ़ाइल के दोबारा इस्तेमाल किए जा सकने वाले एसेट का समूह है। Assets पैनल में फ़ाइल के अपने एसेट local library के नीचे दिखते हैं। यह हिस्सा हमेशा मौजूद रहता है और शुरुआत में खुला होता है।
दूसरी टीम लाइब्रेरी जोड़ने पर वह इसके नीचे अपने नाम के अलग हिस्से में दिखती है, जैसे Animation Examples। अब फ़ाइल के अपने एसेट और दूसरी लाइब्रेरी के एसेट दोनों वहीं से कैनवास पर खींच सकते हैं।
इसे एक अलमारी के दो खाने समझें: local library में इस फ़ाइल की चीज़ें हैं और जुड़ी हुई लाइब्रेरी में टीम की दूसरी फ़ाइल से ली गई चीज़ें। डिज़ाइन छोड़े बिना दोनों इस्तेमाल करें।
लाइब्रेरी में क्या रख सकते हैं?
फ़ाइल के Assets पैनल की सभी चीज़ें प्रकाशित लाइब्रेरी के साथ उपलब्ध होती हैं:
- Images: फ़ाइल में जोड़ी गई स्थिर तस्वीरें।
- Animated images: कई फ़्रेम से बने एनिमेशन।
- Components: दोबारा इस्तेमाल होने वाले LVGL विजेट।
- Colors: सहेजे गए रंग।
- Fonts: डिवाइस पर इस्तेमाल के लिए तैयार किए गए फ़ॉन्ट।
प्रकाशित करने पर टीम इन्हें अलग-अलग फ़ाइलों के बीच बार-बार कॉपी किए बिना इस्तेमाल कर सकती है।
कंपोनेंट क्या है?
कंपोनेंट एक या कई विजेट से बना ऐसा हिस्सा है जिसे फिर इस्तेमाल किया जा सकता है। अकेला बटन या लेबल एक विजेट है। कंपोनेंट में कई विजेट और लेयर साथ हो सकते हैं, जैसे शीर्षक, आइकन और वैल्यू वाला कार्ड। पूरा कार्ड एक इकाई की तरह किसी भी स्क्रीन पर रखा जा सकता है।
हर कंपोनेंट की एक मुख्य प्रति होती है। उसमें बदलाव करके उसकी दूसरी प्रतियाँ भी अपडेट कर सकते हैं, उन फ़ाइलों में भी जो यह लाइब्रेरी इस्तेमाल करती हैं। दूसरी फ़ाइलों में अपडेट कब लागू करना है, यह नीचे बताया गया है। इससे कंट्रोल एक बार बनाना, कई जगह इस्तेमाल करना और एक जगह से सँभालना संभव होता है।
बार-बार वही हेडर, मापन कार्ड या लेबल वाला स्विच बना रहे हों तो उसे कंपोनेंट बनाएँ। इससे अलग-अलग स्क्रीन पर उसका रूप एक जैसा रखना आसान होगा।
फ़ाइल को लाइब्रेरी के रूप में प्रकाशित करें
Publish करने से फ़ाइल आपकी टीम की साझा लाइब्रेरी बन जाती है।
- Assets पैनल में Add library दबाकर Libraries डायलॉग खोलें। पहले से लाइब्रेरी या कंपोनेंट जुड़े हों तो बटन Manage library कहलाता है।
- LIBRARIES टैब में LIBRARIES IN THIS FILE के नीचे File library देखें। उसके पास Publish बटन है।
- Publish दबाएँ।
अब बटन Unpublish हो जाएगा। फ़ाइल के प्रकाशित होने का छोटा लाइब्रेरी चिह्न कार्यक्षेत्र के हेडर में ऊपर दाईं ओर और Dashboard के फ़ाइल कार्ड पर भी दिखता है।
बाद में Unpublish करने पर पुष्टि माँगी जाती है। कनेक्शन हटाने से पहले PicoPixel लाइब्रेरी के एसेट इस्तेमाल करने वाली हर फ़ाइल में उनकी कॉपी रख देता है। इससे वे फ़ाइलें अपने ज़रूरी एसेट नहीं खोतीं।
टीम की लाइब्रेरी कहाँ मिलेगी?
- Dashboard खोलें।
- बाएँ साइडबार में Sources के नीचे Libraries चुनें।
यहाँ मौजूदा टीम की सभी प्रकाशित लाइब्रेरी मिलती हैं। दूसरी टीम चुनेंगे तो उसकी लाइब्रेरी दिखेंगी। सदस्य यहाँ देखकर तय कर सकते हैं कि कौन-से तैयार एसेट उपलब्ध हैं।
दूसरी फ़ाइल में लाइब्रेरी इस्तेमाल करें
- वह फ़ाइल खोलें जिसमें काम करना है।
- Assets में Add library या Manage library दबाएँ।
- SHARED LIBRARIES में लाइब्रेरी ढूँढें और उसके पास + दबाएँ। लंबी सूची में Search shared libraries से खोजें।
अब लाइब्रेरी Assets में local library के नीचे अपने नाम से दिखेगी। उसके कंपोनेंट, इमेज, रंग और फ़ॉन्ट डिज़ाइन में खींचकर इस्तेमाल करें।
जुड़ी हुई लाइब्रेरी अपडेट करें
लाइब्रेरी के मालिक के कंपोनेंट या रंग बदलने पर आपकी फ़ाइल अपने-आप नहीं बदलती। Libraries डायलॉग के UPDATES टैब में नए बदलाव दिखते हैं। तैयार होने पर Update दबाकर उन्हें लागू करें। कोई बदलाव नहीं है तो टैब वही बताएगा।
गोपनीयता: लाइब्रेरी सार्वजनिक नहीं होती
यहाँ Publish का मतलब टीम के लिए उपलब्ध कराना है।
प्रकाशित लाइब्रेरी केवल आपकी टीम के साथ साझा होती है। उसे खोलने के लिए साइन इन और टीम की पहुँच चाहिए। कोई सार्वजनिक लिंक या सूची नहीं बनती और टीम से बाहर के लोग उसे नहीं खोल सकते।
सामग्री बाहर भेजने के दो तरीके हैं, और दोनों आप चुनते हैं:
- खुद
.picopixelफ़ाइल एक्सपोर्ट करके भेजें। कार्यक्षेत्र के मेनू से Export.picopixelकरने पर फ़ाइल आपके कंप्यूटर पर आती है। फिर ईमेल या दूसरे माध्यम से उसे साझा करना आपके हाथ में है। यह PicoPixel से बाहर होता है। - PicoPixel टीम को समीक्षा के लिए भेजें। पूरे समुदाय से साझा करना चाहें तो
app.picopixel.io/#/settings/submit-templateपर भेजें। गैलरी में प्रकाशित करने से पहले टीम हर प्रोजेक्ट की समीक्षा करती है। फ़ॉर्म और अनुमतियों के लिए टेम्पलेट भेजने की गाइड पढ़ें।
इन कदमों के बिना आपकी फ़ाइलें और लाइब्रेरी टीम के भीतर रहती हैं।
समुदाय के टेम्पलेट और तैयार लाइब्रेरी
PicoPixel की टेम्पलेट गैलरी में टीम और समुदाय के बनाए टेम्पलेट, UI किट, उदाहरण, स्प्राइट, एनिमेटेड इमेज और पूरे ऐप मिलते हैं। हर एक सामान्य .picopixel फ़ाइल है, जिसे खोलकर अपने प्रोजेक्ट के अनुसार बदल सकते हैं।
खोले गए किसी भी टेम्पलेट को लाइब्रेरी बना सकते हैं। प्रकाशित करने पर टीम को उसके कंपोनेंट, फ़ॉन्ट, रंग और इमेज मिलते हैं। इससे नया प्रोजेक्ट शुरू करना या मौजूदा डिज़ाइन में तैयार हिस्से जोड़ना आसान होता है।
पूरी प्रक्रिया के लिए टेम्पलेट, UI किट और पूरे ऐप इस्तेमाल करने की गाइड देखें।
आगे क्या पढ़ें
- टेम्पलेट भेजें: पूरे समुदाय से अपना डिज़ाइन साझा करें।
- स्प्राइट क्या है?: कई स्थितियों वाले एनिमेटेड विजेट बनाएँ।
- फ़ॉन्ट का इस्तेमाल: लाइब्रेरी के लिए फ़ॉन्ट जोड़ें और तैयार करें।
- Animated Image विजेट: दोबारा इस्तेमाल होने वाली एनिमेटेड इमेज बनाएँ।
