الخطوة 1: إعداد المشروع الأولي
بدا بتنظيم المشروع ديالك باش يستوعب ملفات المصدر، الأصول الثابتة، والنتيجة النهائية اللي غادي تتجمع. الدليل ديال المشروع ديالك خاصو يكون بحال هكا:الخطوة 2: إعداد Node.js و NPM
تأكد بلي Node.js و NPM متبثين في النظام ديالك. Node.js ضروري باش تشغل نظام الحزم، و NPM كيتستخدم باش تدير إدارة التبعيات ديال المشروع ديالك.الخطوة 3: تثبيت Webpack وتبعيات أخرى
تنقل لدليل الجذر ديال المشروع ديالك في التيرمينال وبدى مشروع NPM جديد إلا ما كانش عندك من قبل:- Webpack كيجمع جافاسكريبت والأصول ديالك.
- Babel كيخليك تستخدم ميزات جافاسكريبت الحديثة.
- CopyPlugin كينسخ الملفات والدلائل لدليل البناء ديالك.
- File Loader كيتعامل مع import/require() على ملف ويحولها لـ url وكيصدر الملف لدليل الخرج.
الخطوة 4: إعداد Webpack
صايب ملفwebpack.config.js في جذر المشروع ديالك. هاد الملف خاصو يحدد نقاط الدخول ديالك، إعداد الخرج، قواعد الموديل لتحميل أنواع الملفات المختلفة، وبلوجينز لوظائف إضافية. ها كيفاش خاص webpack.config.js يبان مع الإعداد المعطى:
الخطوة 5: تعديل ملفات الـManifest و HTML
تأكد بليmanifest.json وأي ملفات HTML كيشيروا للسكريبتات والأصول بشكل صحيح. مثلا، السكريبتات غادي تخرج لـ dist، فحدث المسارات على هاد الأساس.
الخطوة 6: دمج سكريبتات البناء في package.json
من بعد ما تهيأ المشروع ديالك مع Webpack وتعده بحال ما شرحنا في الخطوات السابقة، غادي تبغي تأتمت عملية البناء والمراقبة باستخدام سكريبتات npm. فتح ملف package.json ديالك وزيد السكريبتات التالية داخل كائن scripts:
"build": كيجمع البلاجن ديالك في وضع الإنتاج، كيحسن الخرج للنشر. هاد الوضع كيمكن من تحسينات بحال التصغير وإزالة الكود الميت."watch": كيشغل Webpack في وضع التطوير وكيراقب الملفات ديالك للتغييرات، كيعاود يجمع المشروع تلقائيا ملي يتبدل شي ملف. هادشي مفيد خلال التطوير باش تاخد ردود فعل فورية على التغييرات.
الخطوة 7: اختبار وبناء البلاجن
باش تبني البلاجن ديالك للإنتاج، استخدم:--mode production، كيحسن المشروع ديالك للنشر.
للتطوير، تقدر تخلي Webpack يراقب الملفات ديالك ويعاود يجمع ملي يكتشف تغييرات:
الخطوة 7: اختبار البلاجن
باش تختبر البلاجن ديالك في Chrome:- سير لـ
chrome://extensions/في متصفح Chrome. - فعل “وضع المطور” في الأعلى على اليمين.
- كليك على “تحميل غير معبأ” واختار دليل
distديالك.