حزم تطبيقات منصات سطح المكتب وتوزيعها

يُعد electron-builder الأداة القياسية لتغليف تطبيقات Electron في برامج تثبيت قابلة للتوزيع. يوجد إعداده في package.json ضمن المفتاح "build"، حيث تحدد البيانات الوصفية للتطبيق (appId وproductName)، ومسارات الأيقونات، وتنسيقات الإخراج المستهدفة لكل منصة.

يدعم electron-builder نظام macOS (بتنسيقي dmg وzip)، ونظام Windows (مثبّت nsis)، ونظام Linux (بتنسيقي AppImage وdeb). يمكنك استهداف عدة منصات في أمر بناء واحد، أو إعداد CI للبناء على كل منصة باستخدام منفّذها الأصلي لتحقيق أفضل توافق.

يتطلب macOS توقيع التعليمات البرمجية باستخدام شهادة مطوّر من Apple حتى يسمح Gatekeeper للمستخدمين بفتح التطبيق دون تحذير أمني. يقرأ electron-builder شهادتك من macOS Keychain أثناء عملية البناء، ويوقّع جميع الملفات الثنائية تلقائيًا.

إلى جانب توقيع التعليمات البرمجية، يتطلب macOS الحديث أيضًا التوثيق — أي إرسال التطبيق إلى خدمة التوثيق لدى Apple، التي تفحصه بحثًا عن البرمجيات الخبيثة وتصدر تذكرة. يستطيع electron-builder أتمتة التوثيق عبر electron-notarize، وسيُمنع المستخدمون الذين يشغّلون macOS 10.15 أو أحدث من تشغيل التطبيق دون ذلك.

يتطلب Windows شهادة Authenticode من جهة إصدار شهادات موثوقة (CA) حتى يثق SmartScreen بمثبّت التطبيق. من دون التوقيع، سيرى المستخدمون تحذير "حَمَى Windows جهاز الكمبيوتر الخاص بك". تزيل شهادات التحقق الممتد (EV) التحذير فورًا، بينما تبني شهادات التحقق المؤسسي (OV) الثقة بمرور الوقت.

بعد نجاح عملية البناء، يكتب electron-builder برامج التثبيت الخاصة بكل منصة في المجلد dist/. ستجد ملف DMG أو zip لنظام macOS، وملف NSIS‏ .exe لنظام Windows، وملف AppImage أو ‎.deb لنظام Linux، إلى جانب بيان التحديث التلقائي latest.yml (أو latest-mac.yml).

تحتاج تطبيقات Electron إلى أيقونات بتنسيقات خاصة بكل منصة: ملف PNG بحجم 512x512 لنظام Linux، وملف ICNS متعدد الدقات لنظام macOS، وملف ICO متعدد الدقات لنظام Windows. يستطيع electron-builder إنشاء جميع التنسيقات من ملف PNG واحد بحجم 1024x1024 باستخدام الخيار --icon.

تتكامل الحزمة electron-updater مع electron-builder لتوفير التحديثات التلقائية. انشر إصداراتك في GitHub Releases أو S3، وسيتمكن electron-updater من التحقق من وجود تحديثات عند بدء التشغيل، وتنزيل التحديث التفاضلي في الخلفية، ومطالبة المستخدم بإعادة التشغيل.

استدعِ autoUpdater.checkForUpdatesAndNotify() في main.js بعد أن يصبح التطبيق جاهزًا. يجلب electron-updater بيان latest.yml من وجهة النشر، ويقارن الإصدارات، وإذا توفر تحديث، ينزّله ويعرض إشعارًا أصليًا عند جاهزيته للتثبيت.

يجمع electron-builder ملفات JavaScript الخاصة بتطبيقك في أرشيف ASAR واحد (يشبه ملف tar) لتوزيعه. يؤدي ذلك إلى تحسين أداء بدء التشغيل من خلال تقليل عمليات البحث في نظام الملفات، ويجعل فحص شيفرتك المصدرية مباشرةً أصعب، وإن لم يكن مستحيلًا.

لا يمكن تحميل وحدات Node.js الأصلية (ملفات .node) من داخل أرشيف ASAR، بل يجب فك حزمها إلى نظام الملفات. اضبط asarUnpack في electron-builder لإدراج أنماط الوحدات الأصلية، ما يضعها في المجلد app.asar.unpacked بجوار الأرشيف.

لماذا يُعد التوثيق مطلوبًا لتوزيع تطبيقات macOS، إضافةً إلى توقيع التعليمات البرمجية؟

يتضمن توزيع تطبيق Electron إعداد أهداف electron-builder، وتوقيع التعليمات البرمجية لكل من macOS (مع التوثيق) وWindows (باستخدام Authenticode)، وإعداد التحديثات التلقائية اختياريًا باستخدام electron-updater. يجمع أرشيف ASAR تطبيقك للتوزيع، مع فك حزم الوحدات الأصلية بشكل منفصل. ويتولى خط أنابيب CI/CD متين هذه الخطوات تلقائيًا لكل منصة.