યુનિટી પેકેજ મેનેજર

એકતા એ એક પ્લેટફોર્મ છે જે લાંબા સમયથી આસપાસ છે અને સતત વિકસિત થઈ રહ્યું છે. જો કે, એક જ સમયે અનેક પ્રોજેક્ટ્સ સાથે કામ કરતી વખતે, તમે હજુ પણ સામાન્ય સ્ત્રોતો (.cs), પુસ્તકાલયો (.dll) અને અન્ય અસ્કયામતો (છબીઓ, અવાજો, મોડલ્સ, પ્રિફેબ્સ) નો ઉપયોગ કરવામાં મુશ્કેલીઓનો સામનો કરી શકો છો. આ લેખમાં, અમે યુનિટી માટે આવી સમસ્યાના મૂળ ઉકેલ સાથેના અમારા અનુભવ વિશે વાત કરીશું.

વહેંચાયેલ સંસાધન વિતરણ પદ્ધતિઓ

વિવિધ પ્રોજેક્ટ્સ માટે વહેંચાયેલ સંસાધનોનો ઉપયોગ કરવાની એક કરતાં વધુ રીતો છે, પરંતુ દરેક અભિગમના તેના ગુણદોષ છે.

1. ડુપ્લિકેશન - "હાથ દ્વારા" અમે પ્રોજેક્ટ્સ વચ્ચે સંસાધનોની નકલ કરીએ છીએ.

ગુણ:

• તમામ પ્રકારના સંસાધનો માટે યોગ્ય.
• કોઈ નિર્ભરતા સમસ્યાઓ નથી.
• એસેટ GUID સાથે કોઈ સમસ્યા નથી.

વિપક્ષ:

• વિશાળ ભંડાર.
• વર્ઝનિંગ માટે કોઈ વિકલ્પ નથી.
• વહેંચાયેલ સંસાધનોમાં ફેરફારોને ટ્રૅક કરવામાં મુશ્કેલી.
• વહેંચાયેલ સંસાધનોને અપડેટ કરવામાં મુશ્કેલી.

2. ગિટ સબમોડ્યુલ્સ - બાહ્ય સબમોડ્યુલ્સ દ્વારા વહેંચાયેલ સંસાધનોનું વિતરણ.

ગુણ:

• તમે સ્ત્રોતો સાથે કામ કરી શકો છો.
• તમે સંપત્તિનું વિતરણ કરી શકો છો.
• કોઈ નિર્ભરતા સમસ્યાઓ નથી.

વિપક્ષ:

• ગિટ કુશળતા જરૂરી છે.
• દ્વિસંગી ફાઇલો સાથે ગિટ ખૂબ અનુકૂળ નથી - તમારે LFS શામેલ કરવું પડશે.
• રીપોઝીટરીઝ માટે ઍક્સેસ નિયંત્રણ.
• અપગ્રેડ અને ડાઉનગ્રેડ કરવામાં મુશ્કેલી.
• GUID અથડામણ શક્ય છે અને તેમને ઉકેલવા માટે યુનિટી તરફથી કોઈ અસ્પષ્ટ વર્તન નથી.

3. NuGet - NuGet પેકેજો દ્વારા વહેંચાયેલ પુસ્તકાલયોનું વિતરણ.

ગુણ:

• એકતા પર નિર્ભર ન હોય તેવા પ્રોજેક્ટ્સ સાથે અનુકૂળ કાર્ય.
• અનુકૂળ સંસ્કરણ અને નિર્ભરતા રીઝોલ્યુશન.

વિપક્ષ:

• યુનિટીને ખબર નથી કે ન્યુગેટ પેકેજો સાથે કેવી રીતે કામ કરવું તે બોક્સની બહાર છે (તમે GitHub પર યુનિટી માટે NuGet પેકેજ મેનેજર શોધી શકો છો, જે આને ઠીક કરે છે, પરંતુ તેમાં ઘોંઘાટ છે).
• અન્ય પ્રકારની સંપત્તિઓનું વિતરણ કરવામાં મુશ્કેલીઓ.

4. યુનિટી પેકેજ મેનેજર - એકતા માટે મૂળ ઉકેલ દ્વારા વહેંચાયેલ સંસાધનોનું વિતરણ.

ગુણ:

• પેકેજો સાથે કામ કરવા માટે મૂળ ઈન્ટરફેસ.
• GUID વિરોધાભાસના કિસ્સામાં પેકેજોમાં .meta ફાઇલોને ઓવરરાઇટ કરવા સામે રક્ષણ.
• વર્ઝનિંગ ક્ષમતા.
• એકતા માટે તમામ પ્રકારના સંસાધનોનું વિતરણ કરવાની ક્ષમતા.

વિપક્ષ:

• GUID સંઘર્ષ હજુ પણ થઈ શકે છે.
• અમલીકરણ માટે કોઈ દસ્તાવેજો નથી.

પછીની પદ્ધતિમાં ગેરફાયદા કરતાં વધુ ફાયદા છે. જો કે, દસ્તાવેજોના અભાવને કારણે તે હવે ખૂબ લોકપ્રિય નથી, અને તેથી અમે તેના પર વિગતવાર ધ્યાન આપીશું.

યુનિટી પેકેજ મેનેજર

યુનિટી પેકેજ મેનેજર (ત્યારબાદ UPM તરીકે ઓળખવામાં આવે છે) એ પેકેજ મેનેજમેન્ટ ટૂલ છે. તે યુનિટી 2018.1 માં ઉમેરવામાં આવ્યું હતું અને તેનો ઉપયોગ ફક્ત યુનિટી ટેક્નોલોજીસ દ્વારા વિકસિત પેકેજો માટે કરવામાં આવ્યો હતો. જો કે, સંસ્કરણ 2018.3 થી શરૂ કરીને, કસ્ટમ પેકેજો ઉમેરવાનું શક્ય બન્યું.

યુનિટી પેકેજ મેનેજર ઈન્ટરફેસ

પેકેજો પ્રોજેક્ટ સ્ત્રોતો (એસેટ ડિરેક્ટરી) માં સમાપ્ત થતા નથી. તેઓ એક અલગ ડિરેક્ટરીમાં છે. %projectFolder%/Library/PackageCache અને પ્રોજેક્ટને કોઈપણ રીતે અસર કરતા નથી, તેમનો એકમાત્ર ઉલ્લેખ સ્રોત કોડમાં ફાઇલમાં છે packages/manifest.json.

પ્રોજેક્ટ ફાઇલ સિસ્ટમમાં પેકેજો

પેકેજ સ્ત્રોતો

UPM ઘણા પેકેજ સ્ત્રોતોનો ઉપયોગ કરી શકે છે:

1. ફાઇલ સિસ્ટમ.

ગુણ:

• અમલીકરણ ઝડપ.
• કોઈ તૃતીય પક્ષ સાધનોની જરૂર નથી.

વિપક્ષ:

• આવૃત્તિ જટિલતા.
• પ્રોજેક્ટ સાથે કામ કરતા દરેક માટે ફાઇલ સિસ્ટમની વહેંચાયેલ ઍક્સેસ જરૂરી છે.

2. ગિટ રીપોઝીટરી.

ગુણ:

• તમારે ફક્ત ગિટ રિપોઝીટરીની જરૂર છે.

વિપક્ષ:

• તમે UPM વિન્ડો દ્વારા આવૃત્તિઓ વચ્ચે સ્વિચ કરી શકતા નથી.
• તમામ Git રિપોઝીટરીઝ સાથે કામ કરતું નથી.

3. npm ભંડાર.

ગુણ:

• UPM કાર્યક્ષમતાને સંપૂર્ણપણે સમર્થન આપે છે અને તેનો ઉપયોગ સત્તાવાર યુનિટી પેકેજો વિતરિત કરવા માટે થાય છે.

વિપક્ષ:

• હાલમાં "-preview" સિવાયના પેકેજોની તમામ સ્ટ્રિંગ આવૃત્તિઓને અવગણે છે.

અમે નીચે UPM + npm અમલીકરણ જોઈશું. આ બંડલ અનુકૂળ છે કારણ કે તે તમને કોઈપણ પ્રકારના સંસાધનો સાથે કામ કરવા અને પેકેજ વર્ઝનનું સંચાલન કરવાની મંજૂરી આપે છે, અને મૂળ UPM ઈન્ટરફેસને સંપૂર્ણ રીતે સપોર્ટ કરે છે.

એનપીએમ રીપોઝીટરી તરીકે, તમે ઉપયોગ કરી શકો છો વર્ડાસીયો. તેમાં વિગતવાર છે દસ્તાવેજીકરણ, અને તેને ચલાવવા માટે શાબ્દિક રીતે થોડા આદેશો લે છે.

પર્યાવરણ સેટઅપ

પ્રથમ તમારે ઇન્સ્ટોલ કરવાની જરૂર છે 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. યુનિટી પર જાઓ અને પેકેજ મેનેજર વિન્ડો ખોલો (કસ્ટમ પેકેજો સાથે કામ કરવું એ બિલ્ટ-ઇન સાથે કામ કરતા અલગ નથી).
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