TypeScript هي لغة برمجة مفتوحة المصدر طورتها شركة Microsoft وصُممت بناءً على لغة JavaScript. والهدف الرئيسي من TypeScript هو إضافة ميزات إلى JavaScript تساعد المطورين على إنشاء أكواد أكثر أمانًا وقابلية للقراءة وقابلية للتطوير. إحدى هذه الميزات هي إضافة الكتابة الثابتة. ترقبوا نهاية هذه المقالة لمعرفة المزيد حول هذا الموضوع.
تحتوي ملفات TypeScript على امتداد .ts ويجب تجميعها إلى JavaScript قبل تشغيلها في متصفح أو بيئة Node.js. هذه اللغة شائعة جدًا للمشاريع الكبيرة التي تحتاج إلى تنظيم أفضل وتجنب أخطاء وقت التشغيل.
مفهوم الارتباط الرمزي في مشاريع Node.js
يرمز Symlink إلى الارتباط الرمزي، أي الارتباط الرمزي. في أنظمة الملفات، تتيح لك هذه الميزة الإشارة إلى ملف أو دليل آخر دون الحاجة إلى نسخة مادية منه.
قم بشراء خادم افتراضي إيران و20 دولة أخرى في Radib، انقر فوق
في مشاريع Node.js وTypeScript، قد تحتاج أحيانًا إلى مشاريع متعددة لاستخدام وحدة أو مكتبة مشتركة. بدلاً من تثبيت هذه الوحدة يدويًا أو نسخها في كل مشروع، يمكنك الإشارة إلى الإصدار الأصلي عن طريق إنشاء Symlink. هذا له العديد من المزايا:
فوائد استخدام Symlink في مشاريع TypeScript
- توفير الذاكرة: لا حاجة إلى وجود نسخ متعددة من الوحدة النمطية.
- تحديثات أسرع: يتم تطبيق أي تغييرات تجريها على الوحدة النمطية الرئيسية على الفور على المشاريع ذات الصلة.
- تطوير أسرع: لا حاجة لإعادة تثبيت حزم Node.js لكل مشروع.
خطوات إنشاء Symlink في Node.js لـ TypeScript
افترض أن لدينا مشروعين:
library-project: مشروع يستخدم مكتبة TypeScript is.main-project: المشروع الذي يستخدم هذه المكتبة.
الخطوة 1: ربط وحدة المكتبة بـ Node.js
أولاً، انتقل إلى دليل library-project وقم بتشغيل الأمر التالي:
npm link
سيؤدي هذا الأمر إلى جعل Node.js ينشئ ارتباطًا رمزيًا لهذا المشروع في مستودع الحزم العالمي.
الخطوة 2: ربط بالمشروع الرئيسي
الآن، انتقل إلى دليل main-project وقم بتشغيل الأمر التالي:
npm link library-project
يضيف هذا الأمر الارتباط الرمزي لمشروع المكتبة إلى node_modules للمشروع الرئيسي.
قم بتسجيل نطاق في أقل من دقيقتين على Radib،انقر فوق
أمثلة عملية
المثال 1: إنشاء مكتبة TypeScript بسيطة
ملف index.ts في مشروع library-project:
export const greeting = (name: string): string => {
return `Hello, ${name}! Welcome!`;
};
بعد تشغيل الأمرين npm link وnpm link library-project في مشروع main-project، يمكنك استخدام المكتبة على النحو التالي:
روبوت Instagram الخاص بـ Radib، يساعدك على النمو أكثر، التسجيل مجاني
import {greet } from 'library-project';
console.log(greet('Reza'));
المثال 2: تغييرات فورية على المكتبة
إذا أجرينا التغيير التالي على مشروع library-project:
export const greeting = (name: string): string => {
return `مرحبًا، صديقي العزيز، ${name}! أتمنى أن يكون لديك يوم جيد!`;
};
سيتم تطبيق هذا التغيير على الفور على main-project دون الحاجة إلى إعادة التثبيت أو النسخ.
استكشاف المشكلات الشائعة وإصلاحها
1. لم يتم التعرف على الارتباط الرمزي بواسطة TypeScript
في ملف tsconfig.json للمشروع الرئيسي، تأكد من تعيين خصائص baseUrl وpaths:
{
"compilerOptions": {
"baseUrl": "./",
"paths": {
"library-project": ["node_modules/library-project"]
}
}
}
2. مشكلة الوصول إلى الوحدة النمطية في بيئات CI/CD
في بيئات الإنتاج، قد لا يتم التعرف على الارتباط الرمزي بشكل صحيح. في هذه الحالة، يوصى باستخدام dتثبيت حزمة irect بدلاً من Symlink:
npm install ./path-to-library-project
الملخص
يعد إنشاء روابط رمزية في Node.js وTypeScript طريقة فعالة لإدارة المكتبات المشتركة عبر مشاريع متعددة. تساعد هذه الطريقة المطورين على إجراء تغييرات أسرع على المشاريع ذات الصلة واستخدام ذاكرة النظام بكفاءة أكبر.
