युनिटी पॅकेज मॅनेजर

एकता हे एक व्यासपीठ आहे जे बर्याच काळापासून आहे आणि सतत विकसित होत आहे. तथापि, एकाच वेळी अनेक प्रकल्पांसह काम करताना, तरीही तुम्हाला सामान्य स्रोत (.cs), लायब्ररी (.dll) आणि इतर मालमत्ता (इमेज, ध्वनी, मॉडेल, प्रीफॅब) वापरण्यात अडचणी येऊ शकतात. या लेखात, आम्ही युनिटीसाठी अशा समस्येचे मूळ निराकरण असलेल्या आमच्या अनुभवाबद्दल बोलू.

सामायिक संसाधन वितरण पद्धती

वेगवेगळ्या प्रकल्पांसाठी सामायिक संसाधने वापरण्याचे एकापेक्षा जास्त मार्ग आहेत, परंतु प्रत्येक दृष्टिकोनाचे त्याचे फायदे आणि तोटे आहेत.

1. डुप्लिकेशन - "हाताने" आम्ही प्रकल्पांमध्ये संसाधने डुप्लिकेट करतो.

साधक:

• सर्व प्रकारच्या संसाधनांसाठी योग्य.
• अवलंबित्व समस्या नाहीत.
• मालमत्ता GUID सह कोणतीही समस्या नाही.

बाधक

• महाकाय भांडार.
• व्हर्जनिंगसाठी पर्याय नाही.
• सामायिक संसाधनांमध्ये बदल ट्रॅक करण्यात अडचण.
• सामायिक संसाधने अद्यतनित करण्यात अडचण.

2. Git submodules - बाह्य सबमॉड्यूलद्वारे सामायिक संसाधनांचे वितरण.

साधक:

• आपण स्त्रोतांसह कार्य करू शकता.
• तुम्ही मालमत्ता वितरीत करू शकता.
• अवलंबित्व समस्या नाहीत.

बाधक

• Git कौशल्य आवश्यक.
• Git बायनरी फायलींसह फार अनुकूल नाही - तुम्हाला LFS समाविष्ट करावे लागेल.
• रेपॉजिटरीजसाठी प्रवेश नियंत्रण.
• अपग्रेड आणि डाउनग्रेड करण्यात अडचण.
• GUID टक्कर शक्य आहेत आणि त्यांचे निराकरण करण्यासाठी युनिटीकडून कोणतेही अस्पष्ट वर्तन नाही.

3. NuGet - NuGet पॅकेजेसद्वारे सामायिक लायब्ररींचे वितरण.

साधक:

• युनिटीवर अवलंबून नसलेल्या प्रकल्पांसह सोयीस्कर काम.
• सोयीस्कर आवृत्ती आणि अवलंबित्व रिझोल्यूशन.

बाधक

• युनिटीला बॉक्सच्या बाहेर NuGet पॅकेजेससह कसे कार्य करावे हे माहित नाही (तुम्ही गिटहबवर युनिटीसाठी NuGet पॅकेज व्यवस्थापक शोधू शकता, जे याचे निराकरण करते, परंतु त्यात बारकावे आहेत).
• इतर प्रकारच्या मालमत्तेचे वितरण करण्यात अडचणी.

4. युनिटी पॅकेज मॅनेजर - युनिटी साठी नेटिव्ह सोल्यूशनद्वारे सामायिक संसाधनांचे वितरण.

साधक:

• पॅकेजसह कार्य करण्यासाठी मूळ इंटरफेस.
• GUID विरोधाभासांच्या बाबतीत पॅकेजेसमध्ये .meta फाइल्स ओव्हरराइट करण्यापासून संरक्षण.
• आवृत्ती करण्याची क्षमता.
• युनिटी साठी सर्व प्रकारच्या संसाधनांचे वितरण करण्याची क्षमता.

बाधक

• GUID संघर्ष अजूनही होऊ शकतात.
• अंमलबजावणीसाठी कोणतीही कागदपत्रे नाहीत.

नंतरच्या पद्धतीचे तोटे पेक्षा अधिक फायदे आहेत. तथापि, कागदपत्रांच्या कमतरतेमुळे ते आता फारसे लोकप्रिय नाही आणि म्हणूनच आम्ही त्यावर तपशीलवार विचार करू.

युनिटी पॅकेज मॅनेजर

युनिटी पॅकेज मॅनेजर (यापुढे UPM म्हणून संदर्भित) हे पॅकेज व्यवस्थापन साधन आहे. हे युनिटी 2018.1 मध्ये जोडले गेले होते आणि ते फक्त युनिटी टेक्नॉलॉजीजने विकसित केलेल्या पॅकेजसाठी वापरले होते. तथापि, आवृत्ती 2018.3 पासून प्रारंभ करून, सानुकूल पॅकेजेस जोडणे शक्य झाले.

युनिटी पॅकेज मॅनेजर इंटरफेस

पॅकेजेस प्रकल्प स्त्रोतांमध्ये (मालमत्ता निर्देशिका) संपत नाहीत. ते वेगळ्या निर्देशिकेत आहेत. %projectFolder%/Library/PackageCache आणि प्रकल्पावर कोणत्याही प्रकारे परिणाम करू नका, त्यांचा फक्त स्त्रोत कोडमध्ये उल्लेख फाइलमध्ये आहे packages/manifest.json.

प्रोजेक्ट फाइल सिस्टममधील पॅकेजेस

पॅकेज स्रोत

UPM अनेक पॅकेज स्रोत वापरू शकते:

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

साधक:

• अंमलबजावणी गती.
• कोणत्याही तृतीय पक्ष साधनांची आवश्यकता नाही.

बाधक

• आवृत्तीची जटिलता.
• प्रकल्पासोबत काम करणाऱ्या प्रत्येकासाठी फाइल सिस्टममध्ये सामायिक प्रवेश आवश्यक आहे.

2. Git भांडार.

साधक:

• तुम्हाला फक्त गिट रेपॉजिटरी हवी आहे.

बाधक

• तुम्ही UPM विंडोद्वारे आवृत्त्यांमध्ये स्विच करू शकत नाही.
• सर्व Git रेपॉजिटरीजसह कार्य करत नाही.

3. npm भांडार.

साधक:

• UPM कार्यक्षमतेला पूर्णपणे समर्थन देते आणि अधिकृत युनिटी पॅकेजचे वितरण करण्यासाठी वापरले जाते.

बाधक

• सध्या "-preview" वगळता पॅकेजेसच्या सर्व स्ट्रिंग आवृत्त्यांकडे दुर्लक्ष करते.

आम्ही खाली UPM + npm अंमलबजावणी पाहू. हे बंडल सोयीचे आहे कारण ते तुम्हाला कोणत्याही प्रकारच्या संसाधनांसह कार्य करण्यास आणि पॅकेज आवृत्त्या व्यवस्थापित करण्यास अनुमती देते आणि मूळ UPM इंटरफेसला देखील पूर्णपणे समर्थन देते.

एनपीएम रेपॉजिटरी म्हणून, तुम्ही वापरू शकता वर्डासीओ. त्यात तपशीलवार माहिती आहे दस्तऐवजीकरण, आणि ते चालवण्यासाठी अक्षरशः दोन कमांड्स लागतात.

पर्यावरण सेटअप

प्रथम आपण स्थापित करणे आवश्यक आहे नोड.जेएस.

एक पॅकेज तयार करा

पॅकेज तयार करण्यासाठी, तुम्हाला फाइल ठेवण्याची आवश्यकता आहे package.json, जे या पॅकेजच्या सामग्रीसह निर्देशिकेत वर्णन करेल. आपल्याला खालील गोष्टी करण्याची आवश्यकता आहे:

आम्हाला पॅकेज बनवायचे आहे त्या प्रोजेक्ट डिरेक्टरीवर जा.

npm init कमांड चालवा आणि संवादादरम्यान आवश्यक मूल्ये प्रविष्ट करा. नावासाठी, रिव्हर्स डोमेन फॉरमॅटमध्ये नाव निर्दिष्ट करा, उदाहरणार्थ, com.plarium.somepackage.
पॅकेज नावाच्या सोयीस्कर प्रदर्शनासाठी, package.json मध्ये displayName गुणधर्म जोडा आणि ते भरा.

npm js-ओरिएंटेड असल्याने, फाईलमध्ये मुख्य आणि स्क्रिप्ट गुणधर्म आहेत ज्याची आम्हाला आवश्यकता नाही, ज्याचा युनिटी वापर करत नाही. पॅकेजचे वर्णन अडकू नये म्हणून ते काढून टाकणे चांगले. फाइल यासारखे काहीतरी दिसली पाहिजे:

1. आम्हाला पॅकेज बनवायचे आहे त्या प्रोजेक्ट डिरेक्टरीवर जा.
2. npm init कमांड चालवा आणि संवादादरम्यान आवश्यक मूल्ये प्रविष्ट करा. नावासाठी, रिव्हर्स डोमेन फॉरमॅटमध्ये नाव निर्दिष्ट करा, उदाहरणार्थ, com.plarium.somepackage.
3. पॅकेज नावाच्या सोयीस्कर प्रदर्शनासाठी, package.json मध्ये displayName गुणधर्म जोडा आणि ते भरा.
4. npm js-ओरिएंटेड असल्याने, फाईलमध्ये मुख्य आणि स्क्रिप्ट गुणधर्म आहेत ज्याची आम्हाला आवश्यकता नाही, ज्याचा युनिटी वापर करत नाही. पॅकेजचे वर्णन अडकू नये म्हणून ते काढून टाकणे चांगले. फाइल यासारखे काहीतरी दिसली पाहिजे:

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

5. Unity उघडा आणि package.json साठी एक .meta फाइल व्युत्पन्न करा (Unity .meta फाइल्सशिवाय मालमत्ता पाहत नाही, युनिटी पॅकेजेस फक्त वाचण्यासाठी उघडतात).

पॅकेज पाठवत आहे

पॅकेज पाठवण्यासाठी, तुम्हाला कमांड चालवावी लागेल: npm publish --registry *адрес до хранилища пакетов*.

युनिटी पॅकेज मॅनेजरद्वारे पॅकेजेस स्थापित करणे आणि अद्यतनित करणे

युनिटी प्रोजेक्टमध्ये पॅकेज जोडण्यासाठी, तुम्हाला हे करणे आवश्यक आहे:

1. फाइलवर लिहा manifest.json पॅकेजच्या स्त्रोताबद्दल माहिती. हे करण्यासाठी, आपल्याला एक मालमत्ता जोडण्याची आवश्यकता आहे scopedRegistries आणि स्कोप आणि स्त्रोताचा पत्ता सूचित करा ज्याद्वारे विशिष्ट स्कोप शोधले जातील.

   
   "scopedRegistries": [
      {
        "name": "Main",
        "url": "адрес до хранилища пакетов",
        "scopes": [
          "com.plarium"
        ]
      }
    ]
   

2. युनिटी वर जा आणि पॅकेज मॅनेजर विंडो उघडा (सानुकूल पॅकेजसह कार्य करणे अंगभूत असलेल्यांसह कार्य करण्यापेक्षा वेगळे नाही).
3. सर्व पॅकेजेस निवडा.
4. आवश्यक पॅकेज शोधा आणि ते जोडा.

स्त्रोतांसह कार्य करणे आणि डीबग करणे

स्त्रोत प्रकल्पाशी जोडले जाण्यासाठी, आपल्याला तयार करणे आवश्यक आहे विधानसभा व्याख्या पॅकेजसाठी.

पॅकेजेसचा वापर डीबगिंगची व्याप्ती मर्यादित करत नाही. तथापि, युनिटीमधील पॅकेजेससह काम करताना, पॅकेजमध्ये त्रुटी आढळल्यास कन्सोलमधील त्रुटीवर क्लिक करून तुम्ही IDE वर जाऊ शकत नाही. याचे कारण युनिटी स्क्रिप्ट्स वेगळ्या फाइल्स म्हणून पाहत नाही, कारण असेंब्ली डेफिनिशन वापरताना, ते एका लायब्ररीमध्ये एकत्रित केले जातात आणि प्रोजेक्टमध्ये समाविष्ट केले जातात. प्रकल्पातील स्त्रोतांसह काम करताना, IDE वर क्लिक-थ्रू संक्रमण उपलब्ध आहे.

कनेक्ट केलेल्या पॅकेजसह प्रोजेक्टमधील स्क्रिप्ट:

कार्यरत ब्रेकपॉइंटसह पॅकेजमधून स्क्रिप्ट:

पॅकेजेसचे तातडीचे निराकरण

प्रकल्पात जोडलेली युनिटी पॅकेजेस केवळ वाचनीय आहेत, परंतु पॅकेज कॅशेमध्ये संपादित केली जाऊ शकतात. यासाठी आपल्याला आवश्यक आहे:

1. पॅकेज कॅशेमधील पॅकेजवर जा.

   

2. आवश्यक बदल करा.
3. फाइलमध्ये आवृत्ती अद्यतनित करा package.json.
4. पॅकेज पाठवा npm publish --registry *адрес до хранилища пакетов*.
5. UPM इंटरफेसद्वारे पॅकेज आवृत्ती दुरुस्त केलेल्या आवृत्तीवर अद्यतनित करा.

पॅकेज आयात विरोध

पॅकेजेस आयात करताना, खालील GUID विरोधाभास उद्भवू शकतात:

1. पॅकेज हे पॅकेज आहे. जर, पॅकेज आयात करताना, असे आढळून आले की आधीच जोडलेल्या पॅकेजमध्ये समान GUID असलेली मालमत्ता आहे, तर आयात केलेल्या पॅकेजमधून जुळणारे GUID असलेली मालमत्ता प्रकल्पात जोडली जाणार नाही.
2. पॅकेज हा एक प्रकल्प आहे. जर, एखादे पॅकेज आयात करताना, असे आढळून आले की प्रकल्पामध्ये जुळणारे GUID असलेली मालमत्ता आहे, तर पॅकेजमधील मालमत्ता प्रकल्पात जोडल्या जाणार नाहीत. मात्र, त्यांच्यावर अवलंबून असलेल्या मालमत्ता प्रकल्पातील मालमत्ता वापरण्यास सुरुवात करतील.

प्रकल्पातून पॅकेजमध्ये मालमत्ता हस्तांतरित करणे

युनिटी खुली असताना तुम्ही एखाद्या प्रोजेक्टमधून पॅकेजमध्ये मालमत्ता हस्तांतरित केल्यास, त्याची कार्यक्षमता जतन केली जाईल आणि अवलंबून असलेल्या मालमत्तेतील लिंक्स पॅकेजमधील मालमत्ता वापरण्यास प्रारंभ करतील.

महत्वाचे: प्रकल्पामधून पॅकेजमध्ये मालमत्ता कॉपी करताना, वरील विभागात वर्णन केलेले पॅकेज-प्रोजेक्ट संघर्ष होईल.

विवादांवर संभाव्य उपाय

1. टक्कर टाळण्यासाठी सर्व मालमत्ता आयात करताना स्वतःच्या अल्गोरिदमनुसार GUID पुन्हा नियुक्त करणे.
2. सर्व मालमत्ता एका प्रकल्पात जोडणे आणि त्यानंतरच्या पॅकेजमध्ये विभक्त करणे.
3. सर्व मालमत्तेचे GUID असलेला डेटाबेस तयार करा आणि पॅकेजेस सबमिट करताना प्रमाणित करा.

निष्कर्ष

UPM हे युनिटीमध्ये सामायिक संसाधनांचे वितरण करण्यासाठी एक नवीन उपाय आहे जे विद्यमान पद्धतींना योग्य पर्याय असू शकते. लेखात वर्णन केलेल्या शिफारसी वास्तविक प्रकरणांच्या आधारावर उद्भवल्या. आम्ही आशा करतो की तुम्हाला ते उपयुक्त वाटतील.

स्त्रोत: www.habr.com