عن المشروع

يقوم electron-builder بتعبئة وبناء تطبيقات سطح المكتب Electron إلى ملفات قابلة للتوزيع لأنظمة macOS وWindows وLinux، ويتضمن دعم التحديث التلقائي بشكل جاهز. يتم توزيعه كحزمة npm ويُثبَّت عادةً كاعتماد تطويري. القدرات الرئيسية الموضحة في README: - إدارة حزم NPM: يجمع اعتماديات التطبيق الأصلية (مع دعم Yarn)، ولا يتضمن اعتماديات التطوير أبدًا، ويدعم بنية package.json المزدوجة دون اشتراطها. - توقيع الكود على خادم CI أو جهاز تطوير. - تعبئة التطبيق جاهزة للتحديث التلقائي. - صيغ إخراج عديدة: 7z وzip وtar.xz وtar.7z وtar.lz وtar.gz وtar.bz2 ومجلد غير مضغوط عبر المنصات؛ وdmg وpkg وmas لنظام macOS؛ وAppImage وsnap وdeb وrpm وfreebsd وpacman وp5p وapk لنظام Linux؛ ومثبت nsis ومثبت الويب nsis-web وportable وAppX وMSI وSquirrel.Windows لنظام Windows. - نشر الملفات إلى GitHub Releases وAmazon S3 وDigitalOcean Spaces وBintray. - بناء متقدم: تعبئة تطبيق مُعبأ بالفعل، وفصل خطوات البناء، والبناء والنشر بالتوازي مع الروابط الصلبة على CI لتقليل الإدخال/الإخراج واستخدام القرص. - صور Docker لبناء تطبيقات Linux أو Windows من أي منصة. - تنزيل تلقائي عند الطلب لملفات الأدوات المطلوبة (على سبيل المثال لتوقيع كود Windows أو AppX)، دون إعداد يدوي. المتطلبات والإعداد: يتطلب Node.js >= 22.12.0 للإصدار v27، وهو إصدار رئيسي مع تغييرات جذرية (ESM أصلي، رفع إصدار Node، إزالة واجهات برمجة تطبيقات مهجورة) ويوفر أمر ترحيل. يحتاج مستخدمو Yarn 3 إلى ضبط nodeLinker على node-modules. توجد الإعدادات في حقل build داخل package.json أو في ملفات منفصلة بصيغ js أو ts أو yml أو json/json5، وتتوفر واجهة برمجة تطبيقات برمجية مع أنواع TypeScript لكل من ESM وCommonJS. يتم دعم التصحيح من خلال متغيرات البيئة DEBUG وFPM_DEBUG وDEBUG_DMG. يشير المشروع إلى قوالب مجتمعية مثل electron-react-boilerplate وelectron-vue-vite وvite-electron-builder وelectronjs-with-nextjs، ويرحب بالمساهمات والتبرعات.