यह दस्तावेज़ उन डेवलपर के लिए है जिन्होंने पहले Blockly को फ़ॉर्क किया है और जिन्हें लाइब्रेरी में पैच किए बिना, Blockly के हाल ही में रिलीज़ किए गए वर्शन पर अपडेट करना है. हालांकि, यह काम मुश्किल लग सकता है, लेकिन इस प्रोसेस को आसान बनाने के लिए कुछ कार्रवाइयां की जा सकती हैं.
अनफ़ॉर्क करने की सुविधा के बारे में जानकारी
मुख्य Blockly का इस्तेमाल करने का मतलब है कि आपने Blockly के हाल ही में रिलीज़ किए गए वर्शन का इस्तेमाल किया है. साथ ही, आपके सभी कस्टमाइज़ेशन, बिना मॉन्कीपैच किए सार्वजनिक Blockly एपीआई का इस्तेमाल करते हैं. फ़ॉर्क किए गए ऐप्लिकेशन को मुख्य एपीआई के साथ इस्तेमाल करने के लिए, आपको अनफ़ॉर्क करना होगा.
अनफ़ॉर्क करने के आसान मामले
फ़ॉर्क करने की दो आम वजहें यहां दी गई हैं. साथ ही, मुख्य शाखा पर वापस जाने का तरीका भी बताया गया है:
- आपने Blockly के कोड में बदलाव किए बिना, अपने ब्लॉक और जनरेटर बनाए हैं: इस स्थिति में, अपने कस्टम ब्लॉक और जनरेटर को Blockly के डेटा स्टोर से हटाकर, अपने ऐप्लिकेशन के कोड में जोड़ा जा सकता है. इसके बाद, आपको Blockly का वर्शन अपडेट करने का विकल्प दिखेगा.
- आपने Blockly के किसी भी कोड में बदलाव किए बिना, Blockly नेमस्पेस में कस्टम फ़ंक्शन जोड़ा है: उदाहरण के लिए, आपने कस्टम फ़ील्ड या हेल्पर तरीके जोड़े हैं, जिनका इस्तेमाल सिर्फ़ आपके ऐप्लिकेशन में किया जाता है. इस स्थिति में, फ़ॉर्क को हटाने के लिए, इस पसंद के मुताबिक कोड को Blockly रिपॉज़िटरी से बाहर अपने ऐप्लिकेशन में ले जाएं. इसके बाद, आपके पास Blockly का वर्शन अपडेट करने का विकल्प होगा.
ज़्यादा संख्या में अनफ़ॉर्क करने का उदाहरण
फ़ॉर्क की गई सुविधाओं का पता लगाना
उपयोगकर्ताओं के फ़ॉर्क करने की एक और वजह यह है कि वे Blockly को पैच करके, अपनी पसंद के मुताबिक ऐसी सुविधाएं बनाना चाहते हैं जो उनके हिसाब से, अपस्ट्रीम में शामिल नहीं हैं. अगर आपका फ़ॉर्क काफ़ी पुराना है, तो हो सकता है कि हमने प्लग इन या कोर के तौर पर, आपके लिए ज़रूरी सुविधा पहले ही जोड़ दी हो. यह जानने से कि आपने फ़ॉर्क में कौनसी सुविधाएं जोड़ी हैं, आपको यह तय करने में मदद मिल सकती है कि किन सुविधाओं को अपडेट करना होगा.
आर्किटेक्चर को समझना
फ़ॉर्क के हिसाब से एपीआई का इस्तेमाल करने वाली सुविधाओं को समझने के बाद, इन बातों का ध्यान रखें:
- क्या फ़ॉर्क का इस्तेमाल करने वाली हर सुविधा को, Blockly एपीआई का इस्तेमाल करके दोहराया जा सकता है?
- अगर आपको लगता है कि Blockly API का इस्तेमाल करके, इस सुविधा को दोहराया नहीं जा सकता, तो कृपया फ़ोरम के ज़रिए हमसे संपर्क करें या GitHub पर समस्या दर्ज करें. इसके बाद, हमारी टीम आपके हिसाब से बदलाव करने की सुविधा चालू करने के लिए, एपीआई जोड़ने की जांच करेगी.
अनफ़ॉर्क करने का पाथ तय करना
अगला चरण, फ़ॉर्क का इस्तेमाल करके, Blockly के आधार पर बनाए गए नए आर्किटेक्चर को लागू करने की प्रोसेस शुरू करना है. इसके लिए, आपके पास दो मुख्य तरीके हैं:
- Blockly को अपग्रेड करें और देखें कि क्या काम नहीं कर रहा है: आपको अपने कोड में तुरंत वे हिस्से दिखेंगे जिन्हें अपडेट करना ज़रूरी है. इस डेटा का इस्तेमाल, डेवलपमेंट के लिए दिशा-निर्देश पाने के लिए, कस्टम व्यवहार के साथ किया जा सकता है.
- Blockly से अपनी सुविधाओं को अलग करने के लिए, कोड को फिर से लिखना: इसके लिए, आपको यह अच्छी तरह समझना होगा कि कौनसी सुविधाएं आपके फ़ॉर्क के लिए कस्टम हैं और कौनसी Blockly से मिली हैं. कोड पूरी तरह से अलग हो जाने के बाद, Blockly के पुराने वर्शन को सबसे नए वर्शन से बदलें. इसके बाद, इंटिग्रेशन से जुड़ी बाकी समस्याएं ठीक करें.
आगे बढ़ते हुए
Blockly डेवलपर के तौर पर, आपको आने वाले समय में इन नियमों का पालन करना चाहिए:
- आम तौर पर, आपको Blockly नेमस्पेस में नई क्लास नहीं जोड़नी चाहिए. कस्टम फ़ील्ड या रजिस्टर की जा सकने वाली अन्य क्लास को, Blockly रिपॉज़िटरी या Blockly नेमस्पेस में एलान किए बिना रजिस्टर किया जा सकता है.
- आपको अपना ऐप्लिकेशन कंपाइल करने के लिए, Blockly के बिल्ड टूल पर भरोसा नहीं करना चाहिए. हम अपने बिल्ड टूल को सार्वजनिक एपीआई का हिस्सा नहीं मानते. इसलिए, हो सकता है कि हम उनमें ऐसे बदलाव करें जिनसे आपका ऐप्लिकेशन काम न करे. अगर आपको अपने ऐप्लिकेशन को कंपाइल करना है, तो इसकी ज़िम्मेदारी आपकी होगी.
हमसे संपर्क करें
Blockly टीम से Blockly फ़ोरम पर संपर्क किया जा सकता है! अगर आपको अनफ़ॉर्क करने की प्रोसेस के दौरान कोई समस्या आती है, तो बेझिझक वहां पोस्ट करें. हम आपकी मदद करेंगे.