ইউনিটি প্যাকেজ ম্যানেজার

ঐক্য একটি প্ল্যাটফর্ম যা দীর্ঘকাল ধরে রয়েছে এবং ক্রমাগত বিকশিত হচ্ছে। যাইহোক, একই সময়ে একাধিক প্রকল্পের সাথে কাজ করার সময়, আপনি এখনও সাধারণ উত্স (.cs), লাইব্রেরি (.dll) এবং অন্যান্য সম্পদ (ছবি, শব্দ, মডেল, প্রিফ্যাব) ব্যবহার করতে অসুবিধার সম্মুখীন হতে পারেন৷ এই নিবন্ধে, আমরা ঐক্যের জন্য এই জাতীয় সমস্যার একটি দেশীয় সমাধান নিয়ে আমাদের অভিজ্ঞতা সম্পর্কে কথা বলব।

শেয়ার্ড রিসোর্স ডিস্ট্রিবিউশন পদ্ধতি

বিভিন্ন প্রকল্পের জন্য শেয়ার্ড রিসোর্স ব্যবহার করার একাধিক উপায় আছে, কিন্তু প্রতিটি পদ্ধতির তার সুবিধা এবং অসুবিধা রয়েছে।

1. নকল - "হাত দ্বারা" আমরা প্রকল্পগুলির মধ্যে সম্পদের নকল করি।

পেশাদাররা:

• সব ধরনের সম্পদের জন্য উপযুক্ত।
• কোনো নির্ভরতা সমস্যা নেই।
• সম্পদ GUID এর সাথে কোন সমস্যা নেই।

কনস:

• বিশাল ভান্ডার।
• সংস্করণ করার জন্য কোন বিকল্প নেই.
• শেয়ার্ড রিসোর্সে পরিবর্তন ট্র্যাক করতে অসুবিধা।
• ভাগ করা সম্পদ আপডেট করতে অসুবিধা।

2. গিট সাবমডিউল - বাহ্যিক সাবমডিউলগুলির মাধ্যমে ভাগ করা সম্পদের বিতরণ।

পেশাদাররা:

• আপনি উত্সের সাথে কাজ করতে পারেন।
• আপনি সম্পদ বিতরণ করতে পারেন.
• কোনো নির্ভরতা সমস্যা নেই।

কনস:

• গিট দক্ষতা প্রয়োজন.
• গিট বাইনারি ফাইলগুলির সাথে খুব বন্ধুত্বপূর্ণ নয় - আপনাকে LFS অন্তর্ভুক্ত করতে হবে।
• সংগ্রহস্থলের জন্য অ্যাক্সেস নিয়ন্ত্রণ।
• আপগ্রেড এবং ডাউনগ্রেড করার অসুবিধা।
• GUID সংঘর্ষ সম্ভব এবং তাদের সমাধান করার জন্য ঐক্যের পক্ষ থেকে কোন দ্ব্যর্থহীন আচরণ নেই।

3. NuGet - NuGet প্যাকেজের মাধ্যমে ভাগ করা লাইব্রেরি বিতরণ।

পেশাদাররা:

• একতার উপর নির্ভর করে না এমন প্রকল্পগুলির সাথে সুবিধাজনক কাজ।
• সুবিধাজনক সংস্করণ এবং নির্ভরতা রেজোলিউশন।

কনস:

• ইউনিটি বাক্সের বাইরে নুগেট প্যাকেজগুলির সাথে কীভাবে কাজ করতে হয় তা জানে না (আপনি গিটহাবে ইউনিটির জন্য নুগেট প্যাকেজ ম্যানেজার খুঁজে পেতে পারেন, যা এটি ঠিক করে, তবে এর সূক্ষ্মতা রয়েছে)।
• অন্যান্য ধরনের সম্পদ বণ্টনে অসুবিধা।

4. ইউনিটি প্যাকেজ ম্যানেজার - ঐক্যের জন্য একটি নেটিভ সমাধানের মাধ্যমে ভাগ করা সম্পদের বিতরণ।

পেশাদাররা:

• প্যাকেজগুলির সাথে কাজ করার জন্য নেটিভ ইন্টারফেস।
• GUID দ্বন্দ্বের ক্ষেত্রে প্যাকেজে .meta ফাইল ওভাররাইট করার বিরুদ্ধে সুরক্ষা।
• সংস্করণ করার ক্ষমতা।
• ঐক্যের জন্য সকল প্রকার সম্পদ বন্টন করার ক্ষমতা।

কনস:

• GUID দ্বন্দ্ব এখনও ঘটতে পারে।
• বাস্তবায়নের জন্য কোন ডকুমেন্টেশন নেই।

পরবর্তী পদ্ধতির অসুবিধার চেয়ে বেশি সুবিধা রয়েছে। যাইহোক, ডকুমেন্টেশনের অভাবের কারণে এটি এখন খুব জনপ্রিয় নয়, এবং সেইজন্য আমরা বিস্তারিতভাবে এটি নিয়ে আলোচনা করব।

ইউনিটি প্যাকেজ ম্যানেজার

ইউনিটি প্যাকেজ ম্যানেজার (এর পরে UPM হিসাবে উল্লেখ করা হয়েছে) হল একটি প্যাকেজ পরিচালনার টুল। এটি ইউনিটি 2018.1 এ যোগ করা হয়েছিল এবং শুধুমাত্র ইউনিটি টেকনোলজিস দ্বারা তৈরি প্যাকেজগুলির জন্য ব্যবহার করা হয়েছিল। যাইহোক, সংস্করণ 2018.3 দিয়ে শুরু করে, কাস্টম প্যাকেজ যোগ করা সম্ভব হয়েছে।

ইউনিটি প্যাকেজ ম্যানেজার ইন্টারফেস

প্যাকেজগুলি প্রকল্পের উত্সগুলিতে (সম্পদ ডিরেক্টরি) শেষ হয় না। তারা একটি পৃথক ডিরেক্টরি আছে. %projectFolder%/Library/PackageCache এবং কোনোভাবেই প্রকল্পকে প্রভাবিত করবেন না, সোর্স কোডে তাদের একমাত্র উল্লেখ ফাইলটিতে রয়েছে packages/manifest.json.

প্রকল্প ফাইল সিস্টেমে প্যাকেজ

প্যাকেজ সূত্র

UPM বিভিন্ন প্যাকেজ উত্স ব্যবহার করতে পারে:

1. ফাইল সিস্টেম।

পেশাদাররা:

• বাস্তবায়নের গতি।
• কোন তৃতীয় পক্ষের সরঞ্জাম প্রয়োজন নেই.

কনস:

• সংস্করণ জটিলতা।
• যারা প্রকল্পের সাথে কাজ করেন তাদের প্রত্যেকের জন্য ফাইল সিস্টেমে ভাগ করা অ্যাক্সেস প্রয়োজন।

2. Git সংগ্রহস্থল।

পেশাদাররা:

• আপনার যা দরকার তা হল একটি গিট সংগ্রহস্থল।

কনস:

• আপনি UPM উইন্ডোর মাধ্যমে সংস্করণগুলির মধ্যে স্যুইচ করতে পারবেন না।
• সমস্ত গিট সংগ্রহস্থলের সাথে কাজ করে না।

3. npm সংগ্রহস্থল।

পেশাদাররা:

• সম্পূর্ণরূপে UPM কার্যকারিতা সমর্থন করে এবং অফিসিয়াল ইউনিটি প্যাকেজ বিতরণ করতে ব্যবহৃত হয়।

কনস:

• বর্তমানে "-প্রিভিউ" ছাড়া প্যাকেজের সমস্ত স্ট্রিং সংস্করণ উপেক্ষা করে।

আমরা নীচে UPM + npm বাস্তবায়ন দেখব। এই বান্ডিলটি সুবিধাজনক কারণ এটি আপনাকে যেকোন ধরণের সংস্থানগুলির সাথে কাজ করতে এবং প্যাকেজ সংস্করণগুলি পরিচালনা করতে দেয় এবং নেটিভ UPM ইন্টারফেসকে সম্পূর্ণরূপে সমর্থন করে৷

একটি npm সংগ্রহস্থল হিসাবে, আপনি ব্যবহার করতে পারেন ভার্দাচিও. এটি একটি বিস্তারিত আছে ডকুমেন্টেশন, এবং এটি চালানোর জন্য আক্ষরিকভাবে কয়েকটি কমান্ড লাগে।

পরিবেশ সেটআপ

প্রথমে আপনাকে ইন্সটল করতে হবে Node.js.

একটি প্যাকেজ তৈরি করুন

একটি প্যাকেজ তৈরি করতে, আপনাকে ফাইলটি রাখতে হবে 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 সহ সম্পদ রয়েছে, তাহলে প্যাকেজ থেকে সম্পদগুলি প্রকল্পে যোগ করা হবে না। তবে যেসব সম্পদের ওপর নির্ভরশীল তারা প্রকল্প থেকে সম্পদ ব্যবহার শুরু করবে।

একটি প্রকল্প থেকে একটি প্যাকেজে সম্পদ স্থানান্তর

আপনি যদি Unity খোলার সাথে একটি প্রকল্প থেকে একটি প্যাকেজে একটি সম্পদ স্থানান্তর করেন, তাহলে এর কার্যকারিতা সংরক্ষণ করা হবে এবং নির্ভরশীল সম্পদের লিঙ্কগুলি প্যাকেজ থেকে সম্পদ ব্যবহার করা শুরু করবে।

গুরুত্বপূর্ণ: একটি প্রকল্প থেকে একটি প্যাকেজে একটি সম্পদ অনুলিপি করার সময়, উপরের বিভাগে বর্ণিত প্যাকেজ-প্রকল্প বিরোধ ঘটবে৷

দ্বন্দ্বের সম্ভাব্য সমাধান

1. সংঘর্ষ এড়াতে সমস্ত সম্পদ আমদানি করার সময় নিজস্ব অ্যালগরিদম অনুযায়ী GUID পুনরায় বরাদ্দ করা।
2. প্যাকেজে তাদের পরবর্তী বিভাজন সহ একটি প্রকল্পে সমস্ত সম্পদ যোগ করা।
3. সমস্ত সম্পদের GUID সমন্বিত একটি ডাটাবেস তৈরি করুন এবং প্যাকেজ জমা দেওয়ার সময় যাচাই করুন।

উপসংহার

ইউপিএম হল ইউনিটিতে শেয়ার্ড রিসোর্স বিতরণের জন্য একটি নতুন সমাধান যা বিদ্যমান পদ্ধতির একটি যোগ্য বিকল্প হতে পারে। নিবন্ধে বর্ণিত সুপারিশগুলি বাস্তব মামলার ভিত্তিতে উদ্ভূত হয়েছে। আমরা আপনাকে তাদের দরকারী এটি আশা করি।

উত্স: www.habr.com