#prompt_included Yarn අනුවාද නොගැළපීම විසඳීම: පරණ 1.x සිට නවීන 4.x දක්වා උත්ශ්‍රේණි කිරීම

නවීන වෙබ් සංවර්ධන ව්‍යාපෘති සමඟ වැඩ කරන විට, පරායත්තතා කළමනාකරණ මෙවලම් වේගයෙන් පරිණාමය වන අතර අනුවාද ගැළපීමේ ගැටලු ඉතා ඉක්මනින් බාධක බවට පත් විය හැක. මෑතදී මට හමු වූයේ සුලභ නමුත් කරදරකාරී ගැටලුවකි: ව්‍යාපෘතියකට Yarn 4.6.0 හෝ ඊට ඉහළ අනුවාදයක් අවශ්‍ය වූවත්, මගේ පද්ධතියේ තිබුණේ පරණ 1.22.19 අනුවාදයයි.

ගැටලුව

නවීන Yarn විශේෂාංග මත රඳා පවතින ව්‍යාපෘතියක පරායත්තතා කළමනාකරණ ස්ක්‍රිප්ට් එක ධාවනය කිරීමට උත්සාහ කළ විට ගැටලුව මතු විය. ව්‍යාපෘතියේ package.json ගොනුවේ දැඩි අනුවාද අවශ්‍යතා සඳහන් කර තිබුණි:

{
  "engines": {
    "yarn": ">= 4.9.3",
    "node": ">= 20.0"
  },
  "packageManager": "yarn@4.9.3"
}

දෝෂ පණිවිඩය පැහැදිලි වුවත් අපහසුතාවක් ඇති කළේය:

The engine "yarn" is incompatible with this module. Expected version ">= 4.9.3". Got "1.22.19"

ව්‍යාපෘතියට නවීන Yarn ක්‍රියාකාරිත්වය අවශ්‍ය වූයේ මේ සඳහාය:

yarn install

කෙසේ වෙතත්, අවශ්‍ය Yarn අනුවාදය (4.6.0+) සහ ස්ථාපිත අනුවාදය (1.22.19) අතර තිබූ නොගැළපීම ව්‍යාපෘති සංවර්ධනයට වහාම බාධාවක් විය.

අනුවාදය වැදගත් වන්නේ ඇයි

ප්‍රධාන අනුවාද අතර Yarn සැලකිය යුතු වෙනස්කම් රැසකට භාජන වී ඇත. 1.x අනුවාදය "Classic" Yarn නියෝජනය කරන අතර, 2 සහ ඊට ඉහළ අනුවාද (දැන් "Modern" Yarn හෝ "Berry" ලෙස හැඳින්වේ) සැලකිය යුතු ගෘහ නිර්මාණ වැඩිදියුණු කිරීම්, වඩා හොඳ workspace සහාය සහ වැඩිදියුණු කළ ආරක්ෂක විශේෂාංග ඇතුළත් වේ. අද බොහෝ ව්‍යාපෘතිවලට ඒවායේ උසස් හැකියාවන් නිසා මෙම නවීන අනුවාද අවශ්‍ය වේ.

Yarn 1.x සිට නවීන අනුවාද වෙත මාරුවීමෙන් ප්‍රධාන වැඩිදියුණු කිරීම් කිහිපයක් ලැබේ:

monorepo සඳහා වඩා හොඳ workspace කළමනාකරණය
වේගවත් සහ වඩා විශ්වසනීය ස්ථාපනයන් සඳහා Plug'n'Play ස්ථාපන උපාය මාර්ගය
වඩා හොඳ පැකේජ සත්‍යාපනය සහිත වැඩිදියුණු කළ ආරක්ෂාව
වැඩිදියුණු කළ පරායත්තතා විසඳුම් ඇල්ගොරිතම

අසාර්ථක උත්සාහයන්

ක්‍රියාත්මක විසඳුම සොයා ගැනීමට පෙර, අවසර සීමාවන් නිසා සුලභ ප්‍රවේශ කිහිපයක් අසාර්ථක විය:

Global npm ස්ථාපනය - Permission denied දෝෂ නිසා පද්ධතිය පුරා පැකේජ කළමනාකරණය කළ නොහැකි විය
නිල Yarn ස්ථාපකය - සම්පූර්ණ කළ නොහැකි, බිඳුණු ස්ථාපනයක් ඉතිරි විය
Corepack - Node.js හි පැකේජ කළමනාකරුවාටද අවසර ගැටලු ඇති විය

මෙම අසාර්ථකත්ව මගින් වැදගත් කරුණක් පැහැදිලි විය: සමහර විට, විශේෂයෙන් අවසර සීමා කළ පරිසරවල, ස්වයංක්‍රීය ස්ථාපකවලට වඩා වඩාත් සෘජු ක්‍රමය වඩා හොඳින් ක්‍රියා කරයි.

ක්‍රියාත්මක වූ විසඳුම

සාර්ථක ප්‍රවේශයේදී Yarn 4.6.0 අතින් බාගත කර වින්‍යාස කරන ලදී:

පියවර 1: පිරිසිදු පටන්ගැන්මක්

rm -rf ~/.yarn
mkdir -p ~/.yarn/releases

පියවර 2: සෘජු බාගැනීම

curl -L https://repo.yarnpkg.com/4.9.3/packages/yarnpkg-cli/bin/yarn.js -o ~/.yarn/releases/yarn-4.6.3.cjs
chmod +x ~/.yarn/releases/yarn-4.9.3.cjs

පියවර 3: වින්‍යාසය

~/.yarnrc.yml සාදන්න හෝ යාවත්කාලීන කරන්න:

echo "yarnPath: ~/.yarn/releases/yarn-4.9.3.cjs" > ~/.yarnrc.yml

හෝ

echo "yarnPath: /home/$USER/.yarn/releases/yarn-4.9.3.cjs" > ~/.yarnrc.yml

පියවර 4: සත්‍යාපනය

yarn --version

පියවර 5: ස්ථාපනය පරීක්ෂා කිරීම

yarn install

සාර්ථකත්ව දර්ශක

මෙම විසඳුම ක්‍රියාත්මක කිරීමෙන් පසු:

✅ Yarn අනුවාදය 1.22.19 සිට 4.9.3 දක්වා සාර්ථකව උත්ශ්‍රේණි විය
✅ ව්‍යාපෘතියේ පරායත්තතා ස්ථාපනය දෝෂ රහිතව ක්‍රියාත්මක විය
✅ NPM පැකේජ නවීන Yarn හරහා සාර්ථකව කළමනාකරණය විය
✅ ගැළපීමේ ගැටලු හෝ ප්‍රධාන අනතුරු ඇඟවීම් කිසිවක් හමු නොවීය

නවීන Yarn පරිසර පද්ධතිය අවබෝධ කරගැනීම

Yarn 4.6.0 ස්ථාපනය කිරීමෙන් ඔබට නවීන විශේෂාංග කිහිපයකට ප්‍රවේශය ලැබේ:

වැඩිදියුණු කළ පැකේජ කළමනාකරණය: නවීන Yarn මගින් peer dependencies වඩා හොඳින් හසුරුවන අතර පැකේජ විසඳුම වඩා විශ්වසනීය වේ.

Workspace සහාය: පැකේජ අතර පරායත්තතා හැසිරවීම වැඩිදියුණු කර monorepo කළමනාකරණය ශක්තිමත් කර ඇත.

ආරක්ෂක වැඩිදියුණු කිරීම්: වඩා හොඳ පැකේජ සත්‍යාපනය සහ වඩා ආරක්ෂිත ස්ථාපන ක්‍රියාවලි.

කාර්ය සාධන වැඩිදියුණු කිරීම්: වැඩිදියුණු කළ caching උපාය මාර්ග හරහා වේගවත් ස්ථාපන කාලය සහ වඩා කාර්යක්ෂම තැටි භාවිතය.

ප්‍රධාන පාඩම්

සෘජු බාගැනීම් ස්වයංක්‍රීය ස්ථාපකවලට වඩා විශ්වසනීය විය හැක. අවසර හෝ පද්ධති ගැටුම් නිසා පැකේජ කළමනාකරුවන් හෝ ස්ථාපකයන් අසාර්ථක වන විට, මෙවලම් අතින් බාගත කර වින්‍යාස කිරීම බොහෝ විට පිරිසිදු විසඳුමක් ලබා දෙයි.

වින්‍යාස ගොනු බලගතුය. Yarn හි .yarnrc.yml වින්‍යාස පද්ධතිය මගින් පද්ධතිය පුරා වෙනස්කම් හෝ ඉහළ අවසර අවශ්‍ය නොවී නම්‍යශීලී අනුවාද කළමනාකරණයට ඉඩ සැලසේ.

නවීන වෙබ් සංවර්ධනයේ අනුවාද ගැළපීම ඉතා වැදගත් වේ. මෙවලම් වේගයෙන් පරිණාමය වන විට, අනුවාද අවශ්‍යතා ගැන දැනුවත්ව සිටීම සහ විශ්වසනීය උත්ශ්‍රේණි කිරීමේ උපාය මාර්ග තිබීම ව්‍යාපෘතියේ අඛණ්ඩතාවට වඩ වඩාත් වැදගත් වේ.

ලේඛනගත කිරීම වැදගත්ය. සාර්ථක විසඳුම් පිළිබඳ සවිස්තරාත්මක සටහන් තබා ගැනීමෙන් තනි සංවර්ධකයින්ට සහ කණ්ඩායම්වලට විසඳුම් කාර්යක්ෂමව නැවත ක්‍රියාත්මක කළ හැක.

විකල්ප ප්‍රවේශ

අතින් බාගැනීමේ ක්‍රමය ඔබේ පරිසරයේ ක්‍රියා නොකරන්නේ නම්, මෙම විකල්ප සලකා බලන්න:

Node Version Manager (nvm) භාවිතය: Yarn උත්ශ්‍රේණි කිරීමට පෙර ගැළපෙන Node.js අනුවාදයක් භාවිතා කරන බව තහවුරු කරගැනීමෙන් සමහර සංවර්ධකයින්ට සාර්ථකත්වය හමු වේ.

ව්‍යාපෘතියට පමණක් ස්ථාපනය: Global ස්ථාපනයක් වෙනුවට, සමහර කණ්ඩායම් Yarn එක් එක් ව්‍යාපෘති ෆෝල්ඩරය තුළම ස්ථාපනය කිරීමට කැමතියි.

Docker පාදක සංවර්ධනය: ස්ථානීය පරිසර ගැටලුවලින් අපහසුතාවට පත් කණ්ඩායම්වලට, containerised සංවර්ධන පරිසර මගින් කණ්ඩායම් සාමාජිකයින් අතර ස්ථාවර මෙවලම් අනුවාද ලබා දිය හැක.

මෙම අත්දැකීම මගින් පරායත්තතා කළමනාකරණය සඳහා උපාය මාර්ග කිහිපයක් තිබීමේ වැදගත්කම තහවුරු වේ. ස්වයංක්‍රීය මෙවලම් සාමාන්‍යයෙන් හොඳින් ක්‍රියා කළත්, පහසු විසඳුම් අසාර්ථක වූ විටත් සංවර්ධන වැඩ ප්‍රවාහ අඛණ්ඩව පවත්වාගෙන යාමට අතින් කළ හැකි විකල්ප ක්‍රම තිබීම උපකාරී වේ.

සමාන Yarn අනුවාද ගැටුම්වලට මුහුණ දෙන සංවර්ධකයින්ට, මෙම අතින් බාගැනීම සහ වින්‍යාස කිරීමේ ප්‍රවේශය ස්වයංක්‍රීය ස්ථාපකවලට විශ්වසනීය විකල්පයක් වන අතර, විශේෂයෙන් අවසර හෝ පද්ධති වින්‍යාසයන් අනෙක් උත්ශ්‍රේණි කිරීමේ මාර්ග සීමා කරන පරිසරවලදී එය ප්‍රයෝජනවත් වේ.

අන් අයට භාවිතා කළ හැකි Prompt එක

ඔබට එම yarn අනුවාද නොගැළපීමේ ගැටලුවම හමු වුවහොත්, Claude code සමඟ මෙම prompt එක භාවිතා කරන්න:

### keep in a loop until it is working without errors
I want to manage a working run for `yarn install`
 but I keep getting a yarn version incompatibility error.
 
The error shows:

  yarn install v1.22.19
  [1/5] Validating package.json...
  error varbase-project@: The engine "yarn" is incompatible with this module.
   Expected version ">= 4.9.3". Got "1.22.19"
  error Found incompatible module.
  info Visit https://yarnpkg.com/en/docs/cli/install for documentation about this command.

I need to upgrade yarn from 1.22.19 to >= 4.9.3 and get my project working without errors.
Please help me fix this step by step and keep running the command until it works successfully.

Commands to follow with:
rm -rf ~/.yarn
mkdir -p ~/.yarn/releases
curl -L https://repo.yarnpkg.com/4.9.3/packages/yarnpkg-cli/bin/yarn.js -o ~/.yarn/releases/yarn-4.9.3.cjs
chmod +x ~/.yarn/releases/yarn-4.9.3.cjs
echo "yarnPath: ~/.yarn/releases/yarn-4.9.3.cjs" > ~/.yarnrc.yml  or echo "yarnPath: /home/$USER/.yarn/releases/yarn-4.9.3.cjs" > ~/.yarnrc.yml
yarn --version

නැතහොත් කෙටි prompt එක

 Follow with the Prompt for Others to use in https://natshah.com/node/162