කොහොමද, ඔබේ වෙබ් යෙදුම Vercel මත Deploy කරලා Production Build එක අසාර්ථක වෙලා තියෙනවා කියලා හුඟාක් අයත් අය පණ ගැස්සෙන්නේ? මේ ලිපියෙන් අලුත්ම උදාහරණයක් බලන්න – GitHub අයිකනයක් නොමැති වීම නිසා Build එක නතර වුණා, ඒත් ඒ බග් එක කෙලින්ම කෙලින්ම හඳුනාගෙන හරි හෙළා දැමීමට හැකි වුණා.
දෙවැනි වරට KingxTech ව්යාපෘතියේ K‑XpertAI නමැති AI ඒජන්ට් එකේ UI එකට නව කේත සංස්කාරකයක්, ගිට්හබ් Import/Export බොත්තම් සහ ටර්මිනල් ටැබ් එකක් එක්කලා. GitHub වෙත Push කරලා Vercel එකට Deploy කලාම, npm run build අසාර්ථකයි කියලා එරර් එකක් එනවා. ලොග් එකේ “Missing export” කියන පණිවිඩයක් දිගුවෙන් පෙනෙන්නේ lucide-react ලයිබ්රරියෙන් Github අයිකනය අතුරුදන් වීම.
ඉදිරියට යන විට පළමුවෙන්ම lucide-react වර්ෂනය පරීක්ෂා කරලා, ස්ථානයේ Github නමින් අයිකනයක් තිබුණාද කියලා සරල Node.js script එකකින් පරීක්ෂා කළා. අනෙකුත් අයිකන සියල්ල OK වුණත් Github පමණක් MISSING කියලා පෙන්වුණා. මෙහි හේතුව, නවතම lucide-react සංස්කරණවලින් බ්රෑන්ඩ් ලොගෝ (GitHub, Twitter වැනි) අයිකන ඉවත් කරලා, වෙනම පෑකේජ් එකක් ලෙස ලබා දීමට තීරණය කරලා තියෙන එකයි.
දෙයක් වැරදිලා තියෙන්නේ, දේශීය Development පරිසරය පැරණි node_modules කෑෂ් එකක් භාවිතා කරමින් තිබුනා. Vercel එක නව Install එකක් කරන නිසා, අයිකනය නොමැති බව පළාත් කරලා. මෙය විසඳීමට, Github අයිකනය ස්වයංක්රීය SVG එකක් ලෙස ප්රජාතන්තයෙන් නිර්මාණය කරලා, ඒකම නාමය භාවිතා කරලා, සියලු import එකක් වෙනස් නොකර වැඩේ සම්පූර්ණ කළා.
ශ්රී ලංකාවට ඇති වැදගත්කම
- දැනුම් දීම: ශ්රී ලංකාවේ බොහෝ දෙනා Node.js, React වැනි තාක්ෂණ භාවිතා කරන අතර, ලයිබ්රරී අලුත් සංස්කරණ වලින් බ්රෑන්ඩ් අයිකන ඉවත් කරලා යන තත්ත්වය ගැන දැනුවත් විය යුතුයි.
- CI/CD පරීක්ෂා: දේශීය පරිසරයේ කෑෂ් හේතුවෙන් බග් පෙන්වීම අඩු වෙන්න පුළුවන්. Vercel, GitHub Actions වැනි CI පද්ධති වලින් සත්ය නව Install එකක් පරීක්ෂා කිරීම අත්යවශ්යයි.
- ව්යාපාරික සහ අධ්යාපනික ප්රතිලාභ: ස්ථාපිත පද්ධතියක් නිසා අයවැය අඩු වේ, දෝෂ හඳුනා ගැනීම වේගවත් වේ. සිසුන්, නවකයින්ට Clean Install, Dependency Management වගේ ප්රායෝගික පියවරයන් ඉගෙන ගත හැක.
අවසන් වශයෙන්, මෙම බග් එක අපට කියන්නේ “ලෝකයේ සෑම පරිසරයක්ම එකසේ නොවේ” කියලා. Local Development එකේ සාර්ථකයි කියලා හිතාගෙන, CI පරිසරයේ අසාර්ථක වීමක් හෝ අලුත් සංස්කරණයක අතුරුදන් වූ Export එකක් විය හැක. ඒ නිසා, නව Install, Dependency Audit, Brand Icon Packages භාවිතය වැනි මූලික පියවරයන් අනුගමනය කිරීම අත්යවශ්යයි.
