Skip to main content
هاد الدليل يشرح كيفاش تهيأ مشروع بلاجن المتصفح ديالك مع Webpack، مركز على إعداد يدعم نقاط دخول متعددة لجافاسكريبت وتسيير الأصول الثابتة.

الخطوة 1: إعداد المشروع الأولي

بدا بتنظيم المشروع ديالك باش يستوعب ملفات المصدر، الأصول الثابتة، والنتيجة النهائية اللي غادي تتجمع. الدليل ديال المشروع ديالك خاصو يكون بحال هكا:

الخطوة 2: إعداد Node.js و NPM

تأكد بلي Node.js و NPM متبثين في النظام ديالك. Node.js ضروري باش تشغل نظام الحزم، و NPM كيتستخدم باش تدير إدارة التبعيات ديال المشروع ديالك.

الخطوة 3: تثبيت Webpack وتبعيات أخرى

تنقل لدليل الجذر ديال المشروع ديالك في التيرمينال وبدى مشروع NPM جديد إلا ما كانش عندك من قبل:
من بعد، ثبت Webpack واللودرز والبلوجينز الضرورية:
  • 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: اختبار وبناء البلاجن

باش تبني البلاجن ديالك للإنتاج، استخدم:
هاد الأمر كيشغل Webpack مع العلمة --mode production، كيحسن المشروع ديالك للنشر. للتطوير، تقدر تخلي Webpack يراقب الملفات ديالك ويعاود يجمع ملي يكتشف تغييرات:
هادشي كيخلي عملية التطوير أسهل، حيث ما خاصكش تعاود تبني المشروع يدويا بعد كل تغيير.

الخطوة 7: اختبار البلاجن

باش تختبر البلاجن ديالك في Chrome:
  1. سير لـ chrome://extensions/ في متصفح Chrome.
  2. فعل “وضع المطور” في الأعلى على اليمين.
  3. كليك على “تحميل غير معبأ” واختار دليل dist ديالك.
هادشي غادي يثبت البلاجن محليا للاختبار وأغراض التطوير.