electron builder

بناء الإلكترون

حل كامل لتعبئة وبناء برنامج جاهز للتوزيع ، وتطبيق Proton الأصلي لـ MacOs و Windows و Linux مع دعم "تحديث Auto" خارج المربع.

تبحث دائما عن مساهمات المجتمع! ؟ من السهل القيام ببيئة ديف؟

الرعاة

ملاحظات ، المهام ، المشاريع. كل شيء في مكان واحد.
بوابةك لفهم بيانات مرض السكري	واجهة برمجة وتوزيع وتوزيع ترخيص وتوزيع وتوزيع متاحة للترخيص وتوزيع المصدر
Todesktop: منصة الكل في واحد لبناء وإصدار تطبيقات الإلكترون	DashCam: التقاط الخطوات لإعادة إنتاج أي خطأ مع تقارير تحطم الفيديو للإلكترون.

الوثائق

انظر الوثائق الكاملة على electron.build.

• إدارة حزم NPM:
  • تجميع تبعيات التطبيق الأصلي (بما في ذلك دعم الغزل).
  • لم يتم تضمين تبعيات التنمية أبدًا. لا تحتاج إلى تجاهلها بشكل صريح.
  • تم دعم بنية اثنين من package.json ، لكنك لا تضطر إلى استخدامه حتى لو كان لديك تبعيات إنتاج أصلية.
• توقيع الكود على خادم CI أو جهاز التطوير.
• تحديث تلقائي للتغليف تطبيقات جاهزة.
• العديد من التنسيقات المستهدفة:
  • جميع المنصات: 7z ، zip ، tar.xz ، tar.7z ، tar.lz ، tar.gz ، tar.bz2 ، dir (دليل غير معبأ).
  • ماكوس: dmg ، pkg ، mas .
  • Linux: Appimage ، Snap ، Debian Package ( deb ) ، rpm ، freebsd ، pacman ، p5p ، apk .
  • Windows: nsis (Installer) ، nsis-web (تثبيت الويب) ، portable (تطبيق محمول بدون تثبيت) ، APPX (متجر Windows) ، MSI ، Squirrel.windows.
• نشر القطع الأثرية لإصدارات GitHub و Amazon S3 ومساحات Digitalocean و Bintray.
• المبنى المتقدم:
  • حزمة بتنسيق قابل للتوزيع بالفعل التطبيق المعبأ.
  • منفصل خطوات بناء.
  • قم ببناء ونشر بالتوازي ، باستخدام روابط صلبة على خادم CI لتقليل استخدام مساحة القرص والقرص.
  • دعم الإلكترون المركب (ترجمة لوقت الإصدار على الذبابة على البناء).
• Docker Images لإنشاء تطبيق Electron لـ Linux أو Windows على أي منصة.
• دعم بروتون الأصلي.
• يقوم بتنزيل جميع ملفات الأدوات المطلوبة عند الطلب تلقائيًا (على سبيل المثال إلى رمز تسجيل ويندوز ، لجعل APPX) ، لا حاجة إلى الإعداد.

سؤال	إجابة
"أريد تكوين مصادر الإلكترون"	انظر الخيارات
"لقد وجدت خطأ أو لدي سؤال"	افتح مشكلة
"أريد دعم التنمية"	يتبرع

تثبيت

ينصح بشدة الغزل بدلاً من NPM.

yarn add electron-builder --dev

ملاحظة لـ PNPM

من أجل استخدامها مع pnpm ، ستحتاج إلى ضبط .npmrc لاستخدام أي منهج في الأساليب التالية من أجل تجميع تبعياتك بشكل صحيح (المرجع: #6389):

 node-linker=hoisted

 public-hoist-pattern=*

 shamefully-hoist=true

ملاحظة: يعد إعداد مخجل إلى True هو نفسه تعيين النمط العام إلى *.

ملاحظة للغزل 3

yarn 3 استخدم PNP افتراضيًا ، لكن بُعد الإلكترون لا يزال بحاجة إلى مواد عقدة (المرجع: Yarnpkg/Berry#4804). أضف التكوين في .yarnrc.yaml على النحو التالي:

 nodeLinker: "node-modules"

سوف يعلن استخدام العقدة بفيروسات بدلا من PNP.

دليل الإعداد السريع

الإلكترون webpack-Quick-Start هو وسيلة موصى بها لإنشاء تطبيق إلكترون جديد. انظر Boilerplates.

1. حدد الحقول القياسية في Application package.json - الاسم description version والمؤلف.

2. حدد تكوين الإنشاء في package.json json على النحو التالي:

    "build" : {
     "appId" : " your.id " ,
     "mac" : {
       "category" : " your.app.category.type "
     }
   }

   انظر كل الخيارات. ملفات الخيار للإشارة إلى الملفات التي يجب تعبئتها في التطبيق النهائي ، بما في ذلك ملف الإدخال ، ربما مطلوب. يمكنك أيضًا استخدام ملفات تكوين منفصلة ، مثل js و ts و yml و json / json5 . انظر ملف قراءة config للحصول على امتدادات مدعومة. مثال JS على واجهة برمجية برمجية

3. إضافة أيقونات.

4. أضف مفتاح البرامج النصية إلى package.json التطوير. json:

    "scripts" : {
     "app:dir" : " electron-builder --dir " ,
     "app:dist" : " electron-builder "
   }

   بعد ذلك ، يمكنك تشغيل yarn app:dist (إلى حزمة بتنسيق قابل للتوزيع (مثل DMG ، مثبت Windows ، حزمة DEB)) أو yarn app:dir (ينشئ فقط دليل الحزمة دون تغليفه حقًا. هذا مفيد لأغراض الاختبار).

   للتأكد من أن تبعياتك الأصلية تتطابق دائمًا مع إصدار الإلكترون ، ما عليك سوى إضافة برنامج نصي "postinstall": "electron-builder install-app-deps" إلى package.json .

5. إذا كان لديك إضافات أصلية خاصة بك والتي تعد جزءًا من التطبيق (وليس كاعتماد) ، فقم بتعيين NodegyPrebuild على true .

يرجى ملاحظة أن كل شيء يتم تعبئته في أرشيف ASAR بشكل افتراضي.

لتطبيق سيتم شحنه إلى الإنتاج ، يجب عليك التوقيع على طلبك. تعرف على مكان شراء شهادات توقيع الرمز.

استخدام البرنامج

راجع node_modules/electron-builder/out/index.d.ts . يتم توفير طبقة من أجل typeScript ويمكن العثور عليها هنا.

يظهر مقتطف الرمز الوارد أدناه أيضًا "في العمل" هنا أيضًا.

 "use strict"

const builder = require ( "electron-builder" )
const Platform = builder . Platform

// Promise is returned
builder . build ( {
  targets : Platform . MAC . createTarget ( ) ,
  config : {
   "//" : "build options, see https://goo.gl/QQXmcV"
  }
} )
  . then ( ( ) => {
    // handle result
  } )
  . catch ( ( error ) => {
    // handle error
  } ) 

غلايات

• electron-webpack-Quick-Start-وهي عبارة عن هيكل مشاريع الحد الأدنى للبدء في التطوير باستخدام webpack electron. مُستَحسَن.
• الإلكترون-التفاعل-poolerplate عبارة عن غلاية لتطبيقات سطح المكتب عبر المنصات القابلة للتطوير.
• الإلكترون----------------------------------------، ، ، ، ، لا يزال الغلاية من الغلاية للإلكترون ، ورد ، و Redux ، لا يزال بإلكترون ورد و Redux.
• electron-boilerplate تطبيق أضيق الحجم ولكن شامل.
• البرنامج المساعد Vue CLI 3 للإلكترون مكون إضافي Vue CLI 3 للإلكترون مع عدم وجود تكوين مطلوب.
• Electron-Vue-Vite إلكترون بسيط + Vue3 + Vite5 Boilerplate.
• Vite-Electron-Builder Secure Boilerplate لتطبيق الإلكترون استنادًا إلى Vite. يدعم أطر عمل متعددة.

تصحيح

قم بتعيين متغير بيئة DEBUG لتصحيح ما يفعله بناء الإلكترون:

DEBUG=electron-builder

FPM_DEBUG ENV لإضافة المزيد من التفاصيل حول بناء أهداف Linux (باستثناء SNAP و APPIMAGE).

DEBUG_DMG=true env var لإضافة المزيد من التصحيح/التصحيح من hdiutil (macOS).

!!! نصيحة "CMD" على Windows يتم تعيين متغير البيئة باستخدام الأمر set. bash set DEBUG=electron-builder

!!! نصيحة "PowerShell" PowerShell يستخدم بناء جملة مختلفة لضبط متغيرات البيئة. bash $env:DEBUG=electron-builder

يتبرع

نقوم بهذا العمل مفتوح المصدر في أوقات فراغنا. إذا كنت ترغب في استثمار المزيد من الوقت ، فيرجى التبرع.