Сборка и распространение для настольных платформ

electron-builder — стандартный инструмент для упаковки приложений Electron в установщики, готовые к распространению. Его конфигурация находится в package.json под ключом "build" и задаёт метаданные приложения (appId, productName), пути к значкам и целевые форматы для каждой платформы.

electron-builder поддерживает macOS (dmg и zip), Windows (установщик nsis) и Linux (AppImage и deb). Вы можете указать несколько платформ в одной команде сборки или настроить CI так, чтобы каждая платформа собиралась на своём нативном исполнителе для лучшей совместимости.

Для macOS требуется подписать код сертификатом Apple Developer, чтобы Gatekeeper разрешил пользователям открывать приложение без предупреждения системы безопасности. Во время сборки electron-builder считывает сертификат из Связки ключей macOS и автоматически подписывает все двоичные файлы.

Помимо подписания кода, современные версии 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 рядом с архивом.

Распространение приложения Electron включает настройку целевых форматов electron-builder, подписание кода для macOS (с нотариальной заверкой) и Windows (с помощью Authenticode), а также, при необходимости, настройку автоматических обновлений через electron-updater. Архив ASAR объединяет приложение для распространения, а нативные модули распаковываются отдельно. Надёжный конвейер CI/CD автоматически выполняет эти шаги для каждой платформы.