هاد الدليل يوضح كيفاش تجهز مشروع الإضافة ديالك للمتصفح باستخدام Webpack، مع التركيز على تكوين يدعم نقاط دخول متعددة لجافاسكريبت وإدارة الأصول الثابتة.Documentation Index
Fetch the complete documentation index at: https://docs.mellowtel.com/llms.txt
Use this file to discover all available pages before exploring further.
الخطوة 1: إعداد المشروع الأولي
بدا بتنظيم المشروع ديالك باش يستوعب ملفات المصدر، الأصول الثابتة، والإخراج النهائي المجمع. لازم يكون هيكل المشروع ديالك كيما هكا:الخطوة 2: إعداد Node.js و NPM
تأكد بلي Node.js و NPM متثبتين في النظام ديالك. Node.js ضروري باش تشغل نظام الحزم، و NPM تستعمل باش تدير تبعيات المشروع ديالك.الخطوة 3: تثبيت Webpack والتبعيات الأخرى
روح للمجلد الرئيسي للمشروع ديالك في التيرمينال وابدأ مشروع NPM جديد إذا ما درتش هاد الشي من قبل:- Webpack يجمع جافاسكريبت والأصول ديالك.
- Babel يسمح لك تستعمل ميزات جافاسكريبت الحديثة.
- CopyPlugin ينسخ الملفات والمجلدات إلى مجلد البناء ديالك.
- File Loader يحل import/require() على ملف إلى رابط ويب ويصدر الملف إلى مجلد الإخراج.
الخطوة 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ديالك.