एकता पैकेज मैनेजर

एकता एक ऐसा मंच है जो लंबे समय से अस्तित्व में है और लगातार विकसित हो रहा है। हालांकि, एक ही समय में कई परियोजनाओं के साथ इसमें काम करते हुए, आप अभी भी आम स्रोतों (.cs), पुस्तकालयों (.dll) और अन्य परिसंपत्तियों (छवियों, ध्वनियों, मॉडल, प्रीफ़ैब) का उपयोग करने में कठिनाइयों का सामना कर सकते हैं। इस लेख में, हम एकता के लिए ऐसी समस्या के मूल समाधान के साथ काम करने के हमारे अनुभव के बारे में बात करेंगे।

साझा संसाधन वितरण विधियाँ

विभिन्न परियोजनाओं के लिए साझा संसाधनों का उपयोग करने का एक से अधिक तरीका है, लेकिन प्रत्येक दृष्टिकोण में इसके पेशेवरों और विपक्ष हैं।

1. दोहराव - परियोजनाओं के बीच "हाथ" डुप्लिकेट संसाधन।

पेशेवरों:

• सभी प्रकार के संसाधनों के लिए उपयुक्त है।
• कोई निर्भरता मुद्दों।
• संपत्ति GUIDs के साथ कोई समस्या नहीं है।

विपक्ष:

• विशाल रिपोजिटरी।
• कोई संस्करण संभव नहीं है।
• साझा संसाधनों पर नज़र रखने की कठिनाई।
• साझा संसाधनों को अपडेट करने में कठिनाई।

2. गेट सबमॉड्यूल्स - बाहरी सबमॉड्यूल्स के माध्यम से साझा संसाधनों का वितरण।

पेशेवरों:

• आप स्रोत कोड के साथ काम कर सकते हैं।
• परिसंपत्तियों का वितरण किया जा सकता है।
• कोई निर्भरता मुद्दों।

विपक्ष:

• गिट कौशल की जरूरत है।
• Git बाइनरी फ़ाइलों के साथ बहुत अनुकूल नहीं है - आपको LFS कनेक्ट करना होगा।
• रिपॉजिटरी के लिए अभिगम नियंत्रण।
• उन्नयन और डाउनग्रेडिंग में कठिनाइयाँ।
• GUID के टकराव संभव हैं और उन्हें हल करने के लिए एकता की ओर से कोई भी अनुचित व्यवहार नहीं है।

3. NuGet - NuGet पैकेज के माध्यम से साझा पुस्तकालयों का वितरण।

पेशेवरों:

• उन परियोजनाओं के साथ सुविधाजनक कार्य जो एकता पर निर्भर नहीं हैं।
• सुविधाजनक संस्करण और निर्भरता का संकल्प।

विपक्ष:

• एकता को पता नहीं है कि बॉक्स के बाहर नुगेट पैकेज के साथ कैसे काम करना है (गिटहब पर आप एकता के लिए नुगेट पैकेज मैनेजर पा सकते हैं, जो इसे ठीक करता है, लेकिन कुछ बारीकियां हैं)।
• अन्य प्रकार की परिसंपत्तियों को वितरित करने में कठिनाइयाँ।

4. एकता पैकेज प्रबंधक - एकता के लिए एक देशी समाधान के माध्यम से साझा संसाधनों का वितरण।

पेशेवरों:

• पैकेज के साथ काम करने के लिए मूल इंटरफ़ेस।
• GUID संघर्ष के मामले में पैकेज में ओवरराइटिंग .meta फ़ाइलों के विरुद्ध सुरक्षा।
• वर्जनिंग की संभावना।
• एकता के लिए सभी प्रकार के संसाधनों को वितरित करने की क्षमता।

विपक्ष:

• GUID संघर्ष अभी भी हो सकता है।
• लागू करने के लिए कोई दस्तावेज नहीं है।

बाद वाली विधि में नुकसान की तुलना में अधिक फायदे हैं। हालाँकि, यह अभी प्रलेखन की कमी के कारण बहुत लोकप्रिय नहीं है, और इसलिए हम इस पर विस्तार से ध्यान देंगे।

एकता पैकेज मैनेजर

यूनिटी पैकेज मैनेजर (इसके बाद UPM) एक पैकेज मैनेजमेंट टूल है। इसे एकता 2018.1 में जोड़ा गया था, और इसका उपयोग केवल एकता टेक्नोलॉजीज द्वारा विकसित पैकेजों के लिए किया गया था। हालांकि, 2018.3 संस्करण से शुरू करके, कस्टम पैकेज जोड़ना संभव हो गया।


एकता पैकेज प्रबंधक इंटरफ़ेस

पैकेज प्रोजेक्ट स्रोतों (एसेट्स डायरेक्टरी) में नहीं आते हैं। वे एक अलग निर्देशिका %projectFolder%/Library/PackageCache में स्थित हैं और किसी भी तरह से परियोजना को प्रभावित नहीं करते हैं, उनका केवल स्रोतों में उल्लेख packages/manifest.json । packages/manifest.json फ़ाइल में है।


प्रोजेक्ट फ़ाइल सिस्टम में पैकेज

पैकेज स्रोत

UPM कई पैकेज स्रोतों का उपयोग कर सकता है:

1. फाइल सिस्टम।

पेशेवरों:

• कार्यान्वयन की गति।
• किसी भी तृतीय-पक्ष उपकरण की आवश्यकता नहीं है।

विपक्ष:

• वर्जनिंग की जटिलता।
• परियोजना के साथ काम करने वाले सभी लोगों के लिए फ़ाइल साझाकरण आवश्यक है।

2. गैट भंडार।

पेशेवरों:

• केवल एक गिट रिपॉजिटरी की जरूरत है।

विपक्ष:

• आप UPM विंडो के माध्यम से संस्करणों के बीच स्विच नहीं कर सकते।
• यह सभी Git रिपॉजिटरी के साथ काम नहीं करता है।

3. एनपीएम रिपॉजिटरी।

पेशेवरों:

• पूरी तरह से UPM कार्यक्षमता का समर्थन करता है और आधिकारिक एकता पैकेज वितरित करने के लिए उपयोग किया जाता है।

विपक्ष:

• वर्तमान में, यह "-preview" को छोड़कर पैकेज के सभी स्ट्रिंग संस्करणों को अनदेखा करता है।

नीचे हम UPM + npm के कार्यान्वयन को देखते हैं। यह बंडल सुविधाजनक है क्योंकि यह आपको किसी भी प्रकार के संसाधनों के साथ काम करने और पैकेज संस्करणों को प्रबंधित करने की अनुमति देता है, और देशी UPM इंटरफ़ेस का भी पूर्ण समर्थन करता है।

आप Verdaccio को npm रिपॉजिटरी के रूप में उपयोग कर सकते हैं। इसके लिए विस्तृत दस्तावेज है, और इसे लॉन्च करने के लिए बस कुछ ही कमांड का समय लगेगा।

पर्यावरण की स्थापना

सबसे पहले आपको node.js. स्थापित करना होगा

पैकेज निर्माण

पैकेज बनाने के लिए, आपको package.json फ़ाइल को रखना होगा, जो इस पैकेज की सामग्री के साथ निर्देशिका में इसका वर्णन करेगा। आपको निम्नलिखित करने की आवश्यकता है:

1. उस प्रोजेक्ट डायरेक्टरी पर जाएं जिसे हम पैकेज बनाना चाहते हैं।
2. npm init कमांड चलाएं और संवाद के दौरान आवश्यक मान दर्ज करें। नाम के लिए, रिवर्स डोमेन के प्रारूप में नाम निर्दिष्ट करें, उदाहरण के लिए com.plarium.somepackage ।
3. पैकेज नाम को आसानी से प्रदर्शित करने के लिए, displayName गुण को package.json जोड़ें और इसे पॉप्युलेट करें।
4. चूंकि npm js-उन्मुख है, फ़ाइल में वे गुण scripts जिनके लिए हमें main और scripts आवश्यकता नहीं है जो कि यूनिटी उपयोग नहीं करती है। उन्हें हटाने के लिए बेहतर है ताकि पैकेज विवरण को अव्यवस्थित न करें। फ़ाइल कुछ इस तरह दिखनी चाहिए:
   
   

    { "name": "com.plarium.somepackage", "displayName": "Some Package", "version": "1.0.0", "description": "Some Package Description", "keywords": [ "Unity", "UPM" ], "author": "AUTHOR", "license": "UNLICENSED" } 

   
   
5. यूनिटी खोलें और Package.json के लिए एक .meta फ़ाइल बनाएं (एकता .meta फ़ाइलों के बिना संपत्ति नहीं देखती है, एकता के लिए पैकेज केवल पढ़ने के लिए खुले हैं)।

पैकेज भेज रहा है

पैकेज भेजने के लिए, आपको कमांड चलाने की जरूरत है: npm publish --registry * * ।

एकता पैकेज प्रबंधक के माध्यम से संकुल को स्थापित करना और अद्यतन करना

एक एकता परियोजना के लिए एक पैकेज जोड़ने के लिए, आपको आवश्यकता है:

1. manifest.json फ़ाइल में पैकेज स्रोत जानकारी जोड़ें। ऐसा करने के लिए, scopedRegistries गुण जोड़ें और scopedRegistries और स्रोत पते को निर्दिष्ट करें जहां विशिष्ट scopedRegistries खोज की जाएगी।
   
   

    "scopedRegistries": [ { "name": "Main", "url": "   ", "scopes": [ "com.plarium" ] } ] 

2. यूनिटी पर जाएं और पैकेज मैनेजर विंडो खोलें (कस्टम पैकेज के साथ काम करना बिल्ट-इन पैकेज के साथ काम करने से अलग नहीं है)।
3. सभी संकुल का चयन करें।
4. आपको जो पैकेज चाहिए उसे ढूंढें और उसे जोड़ें।

स्रोतों और डिबगिंग के साथ काम करें

प्रोजेक्ट से जुड़ने के स्रोतों के लिए, आपको पैकेज के लिए असेंबली डेफिनिशन बनाना होगा।

पैकेज का उपयोग डिबगिंग क्षमताओं को सीमित नहीं करता है। हालाँकि, एकता में संकुल के साथ काम करते समय, आप कंसोल में एक त्रुटि पर क्लिक करके आईडीई में नहीं जा सकते हैं यदि पैकेज में त्रुटि हुई है। यह इस तथ्य के कारण है कि एकता स्क्रिप्ट को अलग-अलग फ़ाइलों के रूप में नहीं देखती है, क्योंकि विधानसभा परिभाषा का उपयोग करते समय उन्हें एक पुस्तकालय में एकत्र किया जाता है और परियोजना से जुड़ा होता है। प्रोजेक्ट से स्रोत कोड के साथ काम करते समय, क्लिक द्वारा IDE पर स्विच करना उपलब्ध है।

जुड़े पैकेज के साथ परियोजना में स्क्रिप्ट:


वर्किंग पॉइंट के साथ पैकेज से स्क्रिप्ट:

तत्काल पैच फिक्स

परियोजना में जोड़े गए एकता पैकेज केवल-पढ़ने के लिए हैं, लेकिन उन्हें पैकेज कैश में संपादित किया जा सकता है। ऐसा करने के लिए, आपको चाहिए:

1. पैकेज कैश में पैकेज पर जाएं।
   
   
   
   
   
2. आवश्यक बदलाव करें।
3. संस्करण को package.json फ़ाइल में अद्यतन करें।
4. पैकेज भेजें npm publish --registry * * भेजें।
5. UPM इंटरफ़ेस के माध्यम से सही किए गए पैकेज संस्करण को अपडेट करें।

पैकेज आयात संघर्ष

पैकेज आयात करते समय, निम्न GUID विरोध हो सकते हैं:

1. पैकेज - पैकेज। यदि किसी पैकेज को आयात करते समय, यह पाया जाता है कि पहले से ही जोड़े गए पैकेजों में समान GUID के साथ परिसंपत्तियां हैं, तो आयातित पैकेज से GUID के मिलान वाली संपत्ति को परियोजना में नहीं जोड़ा जाएगा।
2. एक पैकेज एक परियोजना है। यदि, पैकेज आयात करते समय, यह प्रतीत होता है कि परियोजना में GUID के मिलान के साथ संपत्ति है, तो पैकेज से संपत्ति को परियोजना में नहीं जोड़ा जाएगा। हालांकि, उन पर निर्भर संपत्ति परियोजना से संपत्ति का उपयोग करना शुरू कर देगी।

एक परियोजना से एक पैकेज में संपत्ति स्थानांतरित करना

यदि आप किसी प्रोजेक्ट से यूनिटी के साथ एक पैकेज के लिए संपत्ति को स्थानांतरित करते हैं, तो इसकी कार्यक्षमता संरक्षित की जाएगी, और आश्रित परिसंपत्तियों के लिंक पैकेज से संपत्ति का उपयोग करना शुरू कर देंगे।

महत्वपूर्ण : जब आप किसी परियोजना से किसी संपत्ति को पैकेज में कॉपी करते हैं, तो संघर्ष "पैकेज - प्रोजेक्ट" होगा, जैसा कि ऊपर अनुभाग में वर्णित है।

संभव संघर्ष समाधान

1. टकराव से बचने के लिए सभी परिसंपत्तियों का आयात करते समय अपने स्वयं के एल्गोरिदम के अनुसार GUID का पुनर्मूल्यांकन।
2. पैकेज में उनके बाद के विभाजन के साथ सभी परिसंपत्तियों को एक परियोजना में जोड़ना।
3. सभी संपत्तियों के GUID युक्त डेटाबेस का निर्माण, और पैकेट भेजते समय मान्यता।

निष्कर्ष

यूपीएम एकता के लिए साझा संसाधनों को वितरित करने के लिए एक नया समाधान है, जो मौजूदा तरीकों के लिए एक योग्य विकल्प हो सकता है। आलेख में वर्णित सिफारिशें वास्तविक मामलों के आधार पर उठीं। हमें उम्मीद है कि आप उन्हें उपयोगी पाएंगे।