ब्लॉक किए जाने वाले डेवलपर टूल

Blockly Developer Tools वेब पर आधारित डेवलपर टूल है. यह Blockly कॉन्फ़िगरेशन की प्रोसेस के कुछ हिस्सों को ऑटोमेट करता है. इनमें कस्टम ब्लॉक बनाना, टूलबॉक्स बनाना, और आपके वेब ब्लॉकली फ़ाइल फ़ोल्डर को कॉन्फ़िगर करना शामिल है.

टूल का इस्तेमाल करने वाली ब्लॉकली डेवलपर प्रोसेस के तीन हिस्से हैं:

  • ब्लॉक फैक्ट्री और ब्लॉक एक्सपोर्टर का इस्तेमाल करके कस्टम ब्लॉक बनाएं.
  • Workspace Factory का इस्तेमाल करके, टूलबॉक्स और डिफ़ॉल्ट फ़ाइल फ़ोल्डर बनाएं.
  • Workspace फ़ैक्ट्री का इस्तेमाल करके, अपने फ़ाइल फ़ोल्डर को कॉन्फ़िगर करें. फ़िलहाल, यह सुविधा सिर्फ़ वेब पर उपलब्ध है.

फ़ैक्ट्री टैब ब्लॉक करें

ब्लॉक फ़ैक्ट्री टैब, कस्टम ब्लॉक के लिए ब्लॉक की परिभाषाएं और ब्लॉक-कोड जनरेटर बनाने में आपकी मदद करता है. इस टैब पर, कस्टम ब्लॉक आसानी से बनाए जा सकते हैं, उनमें बदलाव किया जा सकता है, और उन्हें सेव किया जा सकता है.

ब्लॉक की परिभाषा तय करना

इस वीडियो में किसी ब्लॉक की जानकारी देने का तरीका बताया गया है. यूज़र इंटरफ़ेस (यूआई) पुराना हो गया है, लेकिन इससे हाइलाइट की गई ब्लॉक सुविधाएं अब भी सटीक हैं.

लाइब्रेरी मैनेज करना

ब्लॉक का रेफ़रंस उनके नाम से दिया जाता है, इसलिए हर ब्लॉक का एक खास नाम होना चाहिए. यूज़र इंटरफ़ेस (यूआई), इसे लागू करता है और जब किसी नए ब्लॉक को 'सेव' किया जाता है या किसी मौजूदा ब्लॉक को 'अपडेट' किया जाता है, तब यह साफ़ तौर पर पता चलता है.

पहले से सेव किए गए ब्लॉक के बीच स्विच किया जा सकता है या लाइब्रेरी बटन पर क्लिक करके, नया खाली ब्लॉक बनाया जा सकता है. किसी मौजूदा ब्लॉक का नाम बदलना, एक जैसी परिभाषाओं वाले कई ब्लॉक बनाने का दूसरा तरीका है.

लाइब्रेरी एक्सपोर्ट और इंपोर्ट करना

ब्लॉक को ब्राउज़र के लोकल स्टोरेज में सेव किया जाता है. ब्राउज़र का लोकल स्टोरेज मिटाने से आपके ब्लॉक मिट जाएंगे. अपने ब्लॉक को हमेशा के लिए सेव करने के लिए, आपको अपनी लाइब्रेरी डाउनलोड करनी होगी. आपकी ब्लॉक लाइब्रेरी को एक्सएमएल फ़ाइल के तौर पर डाउनलोड किया जाता है. इसे इंपोर्ट करके, ब्लॉक लाइब्रेरी को उस स्थिति में सेट किया जा सकता है जिस स्थिति में फ़ाइल डाउनलोड करते समय थी. ध्यान दें कि ब्लॉक लाइब्रेरी को इंपोर्ट करने से, आपकी मौजूदा फ़ाइल बदल जाएगी. इसलिए, हो सकता है कि आप पहले ब्लॉक लाइब्रेरी को इंपोर्ट करना चाहें.

कस्टम ब्लॉक के अलग-अलग सेट को बनाए रखने और शेयर करने के लिए, इंपोर्ट और एक्सपोर्ट सुविधाओं का भी सुझाव दिया जाता है.

एक्सपोर्टर टैब को ब्लॉक करें

अपने ब्लॉक डिज़ाइन कर लेने के बाद, आपको ब्लॉक की परिभाषाएं और जनरेटर स्टब एक्सपोर्ट करने होंगे, ताकि उन्हें किसी ऐप्लिकेशन में इस्तेमाल किया जा सके. यह ब्लॉक एक्सपोर्टर टैब पर किया जाता है.

आपकी ब्लॉक लाइब्रेरी में सेव किया गया हर ब्लॉक, ब्लॉक सिलेक्टर में दिखाया जाएगा. एक्सपोर्ट करने के लिए, ब्लॉक पर क्लिक करके उसे चुनें या चुने हुए का निशान हटाएं. अगर आपको अपनी लाइब्रेरी में मौजूद सभी ब्लॉक को चुनना है, तो “चुनें” → “ब्लॉक की गई सभी फ़ाइलों को सेव किया गया है” विकल्प का इस्तेमाल करें. अगर आपने टूलबॉक्स बनाया है या Workspace फ़ैक्ट्री टैब का इस्तेमाल करके, फ़ाइल फ़ोल्डर को कॉन्फ़िगर किया है, तो इस्तेमाल किए गए सभी ब्लॉक चुनने के लिए, “चुनें” → “Workspace फ़ैक्ट्री में इस्तेमाल किए गए सभी डेटा” पर क्लिक करें.

एक्सपोर्ट सेटिंग से आपको यह चुनने की सुविधा मिलती है कि आपको कौनसी भाषा को टारगेट करना है. साथ ही, यह भी चुना जा सकता है कि चुने गए ब्लॉक के लिए, परिभाषाएं, जनरेटर स्टब या दोनों की ज़रूरत है या नहीं. इन्हें चुनने के बाद, 'एक्सपोर्ट करें' पर क्लिक करके अपनी फ़ाइलें डाउनलोड करें.

Workspace फ़ैक्ट्री टैब

Workspace Factory की मदद से, किसी फ़ाइल फ़ोल्डर में टूलबॉक्स और ब्लॉक के डिफ़ॉल्ट सेट को आसानी से कॉन्फ़िगर किया जा सकता है. "टूलबॉक्स" और "फ़ाइल फ़ोल्डर" बटन का इस्तेमाल करके, टूलबॉक्स और शुरुआती फ़ाइल फ़ोल्डर में बदलाव किया जा सकता है.

टूलबॉक्स बनाना

यह टैब, टूलबॉक्स के लिए एक्सएमएल बनाने में मदद करता है. इस कॉन्टेंट में टूलबॉक्स की सुविधाओं की जानकारी दी गई है. अगर आपके पास उस टूलबॉक्स का एक्सएमएल पहले से मौजूद है जिसमें आपको यहां बदलाव करना है, तो "बदलाव करने के लिए लोड करें" पर क्लिक करके उसे लोड करें.

कैटगरी के बिना टूलबॉक्स

अगर आपके पास कुछ ब्लॉक हैं और आपको उन्हें बिना किसी कैटगरी के दिखाना है, तो उन्हें फ़ाइल फ़ोल्डर में खींचें और छोड़ें. इसके बाद, आपको अपने ब्लॉक, झलक में टूलबॉक्स में दिखेंगे.

कैटगरी वाला टूलबॉक्स

अगर आपको कैटगरी में डिसप्ले ब्लॉक चाहिए, तो “+” बटन पर क्लिक करें और नई कैटगरी के लिए ड्रॉपडाउन आइटम चुनें. इससे आपकी कैटगरी की सूची में एक कैटगरी जुड़ जाएगी जिसे चुनकर उसमें बदलाव किया जा सकता है. किसी एक स्टैंडर्ड ब्लॉकली कैटगरी (तिक, लूप वगैरह) को जोड़ने के लिए “स्टैंडर्ड कैटगरी” चुनें या सभी स्टैंडर्ड ब्लॉकली कैटगरी जोड़ने के लिए “स्टैंडर्ड टूलबॉक्स” चुनें. कैटगरी का क्रम बदलने के लिए, ऐरो बटन का इस्तेमाल करें.

चुनी गई कैटगरी का नाम या रंग बदलने के लिए, “कैटगरी में बदलाव करें” ड्रॉपडाउन का इस्तेमाल करें. किसी ब्लॉक को फ़ाइल फ़ोल्डर में खींचकर छोड़ने पर, वह चुनी गई कैटगरी में जुड़ जाएगा.

बेहतर ब्लॉक

डिफ़ॉल्ट रूप से, अपनी लाइब्रेरी का कोई भी स्टैंडर्ड ब्लॉक या ब्लॉक टूलबॉक्स में जोड़ा जा सकता है. अगर आपने JSON में ऐसे ब्लॉक तय किए हैं जो आपकी लाइब्रेरी में नहीं हैं, तो "कस्टम ब्लॉक इंपोर्ट करें" बटन का इस्तेमाल करके उन्हें इंपोर्ट किया जा सकता है.

कुछ ब्लॉक एक साथ इस्तेमाल किए जाने चाहिए या उनमें डिफ़ॉल्ट वैल्यू शामिल होनी चाहिए. ऐसा ग्रुप और शैडो की मदद से किया जाता है. एडिटर में कनेक्ट किए गए किसी भी ब्लॉक को, टूलबॉक्स में एक ग्रुप के तौर पर जोड़ दिया जाएगा. किसी दूसरे ब्लॉक से जुड़े ब्लॉक को भी शैडो ब्लॉक में बदला जा सकता है. ऐसा करने के लिए, चाइल्ड ब्लॉक को चुनें और "शैडो बनाएं" बटन पर क्लिक करें. ध्यान दें: सिर्फ़ उन चाइल्ड ब्लॉक को शैडो ब्लॉक में बदला जा सकता है जिनमें कोई वैरिएबल नहीं होता.

अगर टूलबॉक्स में कोई वैरिएबल या फ़ंक्शन ब्लॉक शामिल किया जाता है, तो अपने टूलबॉक्स में “वैरिएबल” या “फ़ंक्शन” कैटगरी शामिल करें. इससे उपयोगकर्ता ब्लॉक का पूरी तरह से इस्तेमाल कर पाएंगे. “वैरिएबल” या “फ़ंक्शन" कैटगरी के बारे में ज़्यादा जानें.

फ़ाइल फ़ोल्डर को कॉन्फ़िगर करना (Web Blockly के लिए)

अपने फ़ाइल फ़ोल्डर के अलग-अलग हिस्सों को कॉन्फ़िगर करने के लिए, “फ़ाइल फ़ोल्डर फ़ैक्ट्री” टैब पर जाएं और “फ़ाइल फ़ोल्डर" चुनें.

वर्कस्पेस के लिए विकल्प चुनें

कॉन्फ़िगरेशन विकल्पों के लिए अलग-अलग वैल्यू सेट करें और झलक वाली जगह में नतीजा देखें. ग्रिड या ज़ूम चालू करने पर, कॉन्फ़िगर करने के ज़्यादा विकल्प दिखते हैं. साथ ही, कैटगरी का इस्तेमाल करने पर स्विच करने के लिए, आम तौर पर ज़्यादा मुश्किल फ़ाइल फ़ोल्डर की ज़रूरत होती है. पहली कैटगरी जोड़ने पर, ट्रैशकैन और स्क्रोलबार अपने-आप जुड़ जाते हैं.

फ़ाइल फ़ोल्डर में, पहले से लोड किए गए ब्लॉक जोड़ें

ऐसा करना ज़रूरी नहीं है, लेकिन अगर आपको वर्कस्पेस में ब्लॉक का सेट दिखाना है, तो ऐसा करना ज़रूरी हो सकता है:

  • ऐप्लिकेशन लोड होने पर.
  • जब कोई इवेंट (लेवल पर आगे बढ़ना, सहायता बटन पर क्लिक करना वगैरह) ट्रिगर होता है.

झलक में अपने फ़ाइल फ़ोल्डर में ब्लॉक देखने के लिए, उन्हें एडिटिंग स्पेस में खींचें और छोड़ें. आपके पास ब्लॉक ग्रुप बनाने, ब्लॉक को बंद करने, और कुछ ब्लॉक को चुनने पर उन्हें शैडो ब्लॉक बनाने का विकल्प होता है.

इन ब्लॉक को एक्सएमएल के रूप में एक्सपोर्ट किया जा सकता है (नीचे देखें). अपना फ़ाइल फ़ोल्डर बनाने के तुरंत बाद, Blockly.Xml.domToWorkspace की मदद से उन्हें अपने फ़ाइल फ़ोल्डर में जोड़ें:

var xmlText = '<xml xmlns="https://developers.google.com/blockly/xml">' +
    '<block type="math_number"></block></xml>';
Blockly.Xml.domToWorkspace(Blockly.utils.xml.textToDom(xmlText), workspace);

यह सैंपल कोड, फ़ाइल फ़ोल्डर में math_number का एक ब्लॉक जोड़ता है.

एक्सपोर्ट किए जा रहे हैं

Workspace Factory से आपको एक्सपोर्ट करने के ये विकल्प मिलते हैं:

  • स्टार्टर कोड: आपके पसंद के मुताबिक बनाए गए ब्लॉकली फ़ाइल फ़ोल्डर को इंजेक्ट करने के लिए, स्टार्टर html और JavaScript बनाता है.
  • टूलबॉक्स: आपके टूलबॉक्स के बारे में बताने के लिए एक्सएमएल बनाता है.
  • Workspace ब्लॉक: एक्सएमएल बनाता है, जिसे किसी फ़ाइल फ़ोल्डर में लोड किया जा सकता है.