एकता प्याकेज प्रबन्धक

एकता एक प्लेटफर्म हो जुन धेरै समयको लागि वरिपरि रहेको छ र निरन्तर विकसित भइरहेको छ। यद्यपि, एकै समयमा धेरै परियोजनाहरूसँग काम गर्दा, तपाइँ अझै पनि साझा स्रोतहरू (.cs), पुस्तकालयहरू (.dll) र अन्य सम्पत्तिहरू (छविहरू, ध्वनिहरू, मोडेलहरू, प्रिफ्याबहरू) प्रयोग गर्न कठिनाइहरूको सामना गर्न सक्नुहुन्छ। यस लेखमा हामी एकताको लागि यस्तो समस्याको देशी समाधानको साथ हाम्रो अनुभवको बारेमा कुरा गर्नेछौं।

साझा स्रोत वितरण विधिहरू

त्यहाँ विभिन्न परियोजनाहरूको लागि साझा स्रोतहरू प्रयोग गर्ने एक भन्दा बढी तरिकाहरू छन्, तर प्रत्येक दृष्टिकोणमा यसको फाइदा र विपक्षहरू छन्।

1. नक्कल - हामी "हातद्वारा" परियोजनाहरू बीच स्रोतहरू डुप्लिकेट गर्छौं।

प्रो:

• सबै प्रकारका स्रोतहरूको लागि उपयुक्त।
• कुनै निर्भरता समस्या छैन।
• सम्पत्ति GUID सँग कुनै समस्या छैन।

Cons:

• विशाल भण्डारहरू।
• संस्करणको कुनै सम्भावना छैन।
• साझा स्रोतहरूमा परिवर्तनहरू ट्र्याक गर्न कठिनाई।
• साझा स्रोतहरू अद्यावधिक गर्न कठिनाई।

2. Git सबमोड्युलहरू - बाह्य सबमोड्युलहरू मार्फत साझा स्रोतहरूको वितरण।

प्रो:

• तपाईं स्रोतहरु संग काम गर्न सक्नुहुन्छ।
• तपाईं सम्पत्ति वितरण गर्न सक्नुहुन्छ।
• कुनै निर्भरता समस्या छैन।

Cons:

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

3. NuGet - NuGet प्याकेजहरू मार्फत साझा पुस्तकालयहरूको वितरण।

प्रो:

• एकतामा निर्भर नगर्ने परियोजनाहरूसँग सुविधाजनक काम।
• सुविधाजनक संस्करण र निर्भरता संकल्प।

Cons:

• Unity ले NuGet प्याकेजहरू बक्स बाहिर काम गर्न सक्दैन (GitHub मा तपाईंले Unity को लागि NuGet प्याकेज प्रबन्धक फेला पार्न सक्नुहुन्छ, जसले यसलाई ठीक गर्छ, तर त्यहाँ केही सूक्ष्मताहरू छन्)।
• अन्य प्रकारका सम्पत्तिहरू वितरण गर्न कठिनाइहरू।

4. एकता प्याकेज प्रबन्धक - एकता को लागी एक नेटिभ समाधान मार्फत साझा स्रोत को वितरण।

प्रो:

• प्याकेजहरूसँग काम गर्नको लागि नेटिभ इन्टरफेस।
• GUID द्वन्द्वको कारण प्याकेजहरूमा .meta फाइलहरू अधिलेखन विरुद्ध सुरक्षा।
• संस्करणको सम्भावना।
• एकताको लागि सबै प्रकारका स्रोतहरू वितरण गर्ने क्षमता।

Cons:

• GUID द्वन्द्व अझै पनि हुन सक्छ।
• कार्यान्वयनको लागि कुनै कागजात छैन।

पछिल्लो विधिमा बेफाइदा भन्दा बढी फाइदाहरू छन्। जे होस्, यो कागजातको अभावको कारणले अहिले धेरै लोकप्रिय छैन, र त्यसैले हामी यसलाई विस्तृत रूपमा विचार गर्नेछौं।

एकता प्याकेज प्रबन्धक

एकता प्याकेज प्रबन्धक (UPM) एक प्याकेज व्यवस्थापन उपकरण हो। यसलाई Unity 2018.1 मा थपिएको थियो र Unity Technologies द्वारा विकसित गरिएका प्याकेजहरूको लागि मात्र प्रयोग गरिएको थियो। जे होस्, संस्करण 2018.3 बाट सुरु हुँदै, अनुकूलन प्याकेजहरू थप्न सम्भव भयो।

एकता प्याकेज प्रबन्धक इन्टरफेस

प्याकेजहरू परियोजना स्रोतहरू (सम्पत्ति डाइरेक्टरी) मा समाप्त हुँदैन। तिनीहरू छुट्टै निर्देशिकामा छन् %projectFolder%/Library/PackageCache र कुनै पनि तरिकाले परियोजनालाई असर नगर्नुहोस्, स्रोत कोडमा तिनीहरूको मात्र उल्लेख फाइलमा छ packages/manifest.json.

परियोजना फाइल प्रणालीमा प्याकेजहरू

प्याकेज स्रोतहरू

UPM ले धेरै प्याकेज स्रोतहरू प्रयोग गर्न सक्छ:

1. फाइल प्रणाली।

प्रो:

• कार्यान्वयनको गति।
• तेस्रो पक्ष उपकरणहरू आवश्यक पर्दैन।

Cons:

• संस्करण गर्न कठिनाई।
• परियोजनासँग काम गर्ने सबैका लागि फाइल प्रणालीमा साझा पहुँच आवश्यक छ।

2. Git भण्डार।

प्रो:

• तपाईलाई चाहिने सबै Git भण्डार हो।

Cons:

• तपाइँ UPM विन्डो मार्फत संस्करणहरू बीच स्विच गर्न सक्नुहुन्न।
• सबै Git भण्डारहरूसँग काम गर्दैन।

3. npm भण्डार।

प्रो:

• UPM कार्यक्षमतालाई पूर्ण रूपमा समर्थन गर्दछ र आधिकारिक एकता प्याकेजहरू वितरण गर्न प्रयोग गरिन्छ।

Cons:

• हाल "-पूर्वावलोकन" बाहेक प्याकेजहरूको सबै स्ट्रिङ संस्करणहरूलाई बेवास्ता गर्छ।

तल हामी UPM + npm कार्यान्वयनमा हेर्नेछौं। यो बन्डल सुविधाजनक छ किनभने यसले तपाईंलाई कुनै पनि प्रकारको स्रोतसँग काम गर्न र प्याकेज संस्करणहरू व्यवस्थापन गर्न अनुमति दिन्छ, र नेटिभ UPM इन्टरफेसलाई पूर्ण रूपमा समर्थन गर्दछ।

तपाइँ यसलाई npm भण्डारको रूपमा प्रयोग गर्न सक्नुहुन्छ Verdaccio। त्यहाँ एक विस्तृत छ कागजात, र यसलाई चलाउनका लागि केवल केही आदेशहरू आवश्यक छन्।

वातावरण स्थापना गर्दै

पहिले तपाईंले स्थापना गर्न आवश्यक छ node.js.

प्याकेज सिर्जना गर्दै

प्याकेज सिर्जना गर्न, तपाईंले फाइल राख्न आवश्यक छ package.json, जसले यसलाई वर्णन गर्नेछ, यस प्याकेजको सामग्रीसँग डाइरेक्टरीमा। तपाईंले निम्न गर्न आवश्यक छ:

हामीले प्याकेज बनाउन चाहेको प्रोजेक्ट डाइरेक्टरीमा जानुहोस्।

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

npm js-उन्मुख भएकोले, फाइलले मुख्य र स्क्रिप्ट गुणहरू समावेश गर्दछ जुन हामीलाई आवश्यक पर्दैन, जुन Unity ले प्रयोग गर्दैन। प्याकेज विवरण अव्यवस्थित नहोस् भनेर तिनीहरूलाई हटाउन राम्रो छ। फाइल यो जस्तै केहि देखिनु पर्छ:

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

   {
    "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 फाइलहरू बिना सम्पत्तिहरू देख्दैन, Unity को लागि प्याकेजहरू पढ्नका लागि मात्र खोलिन्छ)।

प्याकेज पठाउँदै

प्याकेज पठाउन तपाईंले आदेश चलाउन आवश्यक छ: npm publish --registry *адрес до хранилища пакетов*.

एकता प्याकेज प्रबन्धक मार्फत प्याकेजहरू स्थापना र अद्यावधिक गर्दै

एकता परियोजनामा ​​प्याकेज थप्न, तपाईंलाई आवश्यक छ:

1. फाइलमा थप्नुहोस् manifest.json प्याकेजको स्रोत बारे जानकारी। यो गर्नको लागि तपाईंले सम्पत्ति थप्न आवश्यक छ scopedRegistries र स्कोपहरू र स्रोत ठेगाना संकेत गर्नुहोस् जहाँ विशिष्ट स्कोपहरू खोजिनेछन्।

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

2. Unity मा जानुहोस् र प्याकेज प्रबन्धक विन्डो खोल्नुहोस् (अनुकूल प्याकेजहरूसँग काम गर्नु बिल्ट-इनहरूसँग काम गर्नु भन्दा फरक छैन)।
3. सबै प्याकेजहरू चयन गर्नुहोस्।
4. तपाईलाई चाहिने प्याकेज फेला पार्नुहोस् र थप्नुहोस्।

स्रोतहरू र डिबगिङसँग काम गर्दै

स्रोतहरू परियोजनामा ​​जडान हुनको लागि, तपाईंले सिर्जना गर्न आवश्यक छ विधानसभा परिभाषा प्याकेजको लागि।

प्याकेजहरू प्रयोग गर्नाले तपाईंको डिबगिङ विकल्पहरूलाई सीमित गर्दैन। यद्यपि, युनिटीमा प्याकेजहरूसँग काम गर्दा, यदि प्याकेजमा त्रुटि भयो भने कन्सोलमा त्रुटिमा क्लिक गरेर तपाईं IDE मा जान सक्नुहुन्न। यो यस तथ्यको कारण हो कि एकताले लिपिहरूलाई छुट्टै फाईलहरूको रूपमा देख्दैन, किनकि विधानसभा परिभाषा प्रयोग गर्दा तिनीहरू पुस्तकालयमा एकत्रित हुन्छन् र परियोजनामा ​​समावेश हुन्छन्। परियोजनाबाट स्रोतहरूसँग काम गर्दा, IDE मा क्लिक गर्न उपलब्ध छ।

जडान गरिएको प्याकेजको साथ परियोजनामा ​​लिपि:

काम गर्ने ब्रेकपोइन्टको साथ प्याकेजबाट लिपि:

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

परियोजनामा ​​थपिएका एकता प्याकेजहरू पढ्नका लागि मात्र हुन्, तर प्याकेज क्यासमा सम्पादन गर्न सकिन्छ। यो गर्न को लागी तपाईलाई आवश्यक छ:

1. प्याकेज क्यासमा प्याकेजमा जानुहोस्।

   

2. आवश्यक परिवर्तनहरू गर्नुहोस्।
3. फाइलमा संस्करण अपडेट गर्नुहोस् package.json.
4. प्याकेज पठाउनुहोस् npm publish --registry *адрес до хранилища пакетов*.
5. UPM इन्टरफेस मार्फत प्याकेज संस्करण सुधारिएकोमा अपडेट गर्नुहोस्।

प्याकेज आयात विवाद

प्याकेजहरू आयात गर्दा निम्न GUID द्वन्द्वहरू हुन सक्छ:

1. प्याकेज - प्याकेज। यदि, प्याकेज आयात गर्दा, यो पत्ता लाग्यो कि पहिले नै थपिएका प्याकेजहरूमा समान GUID सँग सम्पत्तिहरू छन्, आयातित प्याकेजबाट मिल्दो GUID सँग सम्पत्तिहरू परियोजनामा ​​थपिने छैनन्।
2. प्याकेज एक परियोजना हो। यदि, प्याकेज आयात गर्दा, यो पत्ता लाग्यो कि परियोजनामा ​​मिल्दो GUID सँग सम्पत्तिहरू छन्, त्यसपछि प्याकेजबाट सम्पत्तिहरू परियोजनामा ​​थपिने छैन। यद्यपि, तिनीहरूमा निर्भर सम्पत्तिहरूले परियोजनाबाट सम्पत्तिहरू प्रयोग गर्न सुरु गर्नेछन्।

परियोजनाबाट प्याकेजमा सम्पत्ति हस्तान्तरण गर्दै

यदि तपाईंले Unity खुला हुँदा कुनै परियोजनाबाट प्याकेजमा सम्पत्ति स्थानान्तरण गर्नुभयो भने, यसको कार्यक्षमता सुरक्षित हुनेछ, र निर्भर सम्पत्तिहरूमा लिङ्कहरूले प्याकेजबाट सम्पत्ति प्रयोग गर्न सुरु गर्नेछ।

महत्त्वपूर्ण: परियोजनाबाट प्याकेजमा सम्पत्ति प्रतिलिपि गर्दा, माथिको खण्डमा वर्णन गरिएको "प्याकेज - परियोजना" विवाद उत्पन्न हुनेछ।

विवादको सम्भावित समाधान

1. टकरावहरू हटाउन सबै सम्पत्तिहरू आयात गर्दा हाम्रो आफ्नै एल्गोरिदमहरू प्रयोग गरेर GUID हरू पुन: असाइन गर्दै।
2. एउटा परियोजनामा ​​सबै सम्पत्तिहरू थप्दै र त्यसपछि तिनीहरूलाई प्याकेजहरूमा विभाजन गर्दै।
3. सबै सम्पत्तिहरूको GUID समावेश भएको डाटाबेस सिर्जना गर्दै र प्याकेजहरू पठाउँदा प्रमाणीकरण सञ्चालन गर्ने।

निष्कर्षमा

UPM एकतामा साझा स्रोतहरू वितरणको लागि नयाँ समाधान हो, जुन अवस्थित विधिहरूको लागि उपयुक्त विकल्प हुन सक्छ। लेखमा वर्णन गरिएका सिफारिसहरू वास्तविक केसहरूमा आधारित थिए। हामी आशा गर्दछौं कि तपाईंले तिनीहरूलाई उपयोगी पाउनुभयो।

स्रोत: www.habr.com