Упаковка и распространение Electron

После завершения разработки приложения Electron приложение необходимо упаковать в исполняемый файл для настольных компьютеров и распространить среди пользователей.

Процесс упаковки и распространения включает несколько этапов, в том числе выбор инструментов, настройку, подпись и стратегию обновления.


Введение в инструменты упаковки

electron-builder

  • Высокая степень автоматизации, поддержка Windows, macOS и Linux
  • Поддерживает функцию автоматического обновления
  • Простая настройка, подходит для эксплуатационных сред
  • может создавать.exe、.dmg、.AppImageи другие форматы

electron-packager

  • Официально рекомендуемый инструмент упаковки, легковесный
  • Отвечает только за создание исполняемых файлов, без встроенного автообновления
  • Простая конфигурация, но требует комбинирования с другими инструментами для работы с установочными пакетами и подписывания

electron-forge

  • Интегрирует упаковку, шаблоны, автообновление и процессы выпуска
  • Работает из коробки, подходит новичкам для быстрого запуска проектов
  • Встроенная поддержка сборки Webpack / ESBuild

Сравнение и выбор инструментов

Инструменты Особенности Преимущества Применимые сценарии
electron-builder Высокая автоматизация, кроссплатформенность, поддержка обновлений Простая конфигурация, подходит для продакшена Выпуск сложных приложений
electron-packager Легковесный, официально поддерживаемый Гибкое комбинирование с другими инструментами Простая упаковка приложений
electron-forge Интегрированные инструменты разработки, быстрый запуск Из коробки, встроенная сборка Для начинающих или быстрого прототипирования

Настройка параметров упаковки

Конфигурация package.json

"build": {
  "appId": "com.example.myapp",
  "productName": "MyElectronApp",
  "directories": {
    "output": "dist"
  },
  "files": ["**/*"],
  "extraResources": ["assets/"],
  "mac": {
    "category": "public.app-category.utilities"
  },
  "win": {
    "target": "nsis",
    "icon": "build/icon.ico"
  },
  "linux": {
    "target": ["AppImage", "deb"],
    "icon": "build/icon.png"
  }
}

Конфигурация для конкретной платформы

  • Windows: типы установочных пакетов (NSIS, Squirrel), иконки.ico
  • macOS: категория приложения, подписывание,.icnsicon
  • Linux: целевые форматы (AppImage, deb, rpm), иконки PNG

Иконки и файлы ресурсов

  • Размер и формат значка должны соответствовать требованиям платформы
  • Доступ к дополнительным ресурсам можно получить черезextraResourcesилиextraFilesдобавьте

Мультиплатформенная упаковка

Упаковка для Windows

electron-builder --win
  • может создавать.exeили.msiУстановочный файл
  • Поддерживает мастер установки NSIS и тихую установку

Упаковка для macOS

electron-builder --mac
  • может создавать.dmgили.pkg
  • Благодаря нотаризации может пройти проверку macOS Gatekeeper

Упаковка для Linux

electron-builder --linux
  • Распространённые форматы: AppImage, deb, rpm
  • Подходит для распространения настольных приложений в разных дистрибутивах

Кросс-компиляция

  • Electron-builder поддерживает кросс-платформенные сборки, но приложения macOS должны подписываться на macOS
  • Windows/Linux могут выполнять кросс-упаковку с помощью виртуальных машин сборки Linux или Windows

Подпись кода

Подпись кода Windows

  • Подпись с помощью цифрового сертификата (.pfx).exeили.msi
  • Пример:
electron-builder --win --csc-link path/to/certificate.pfx --csc-key-password yourpassword
  • Повышает доверие пользователей и позволяет избежать блокировки SmartScreen

Нотаризация macOS

  • Apple официально требует нотаризовать приложения для прохождения Gatekeeper
  • Требуется учетная запись Apple Developer
  • Пример сборки:
electron-builder --mac --publish never
  • ИспользованиеnotarizeЗагрузите приложение через API для автоматической нотаризации

Заявка на сертификат и управление сертификатами

  • Windows: Купите EV или стандартный сертификат подписи кода
  • macOS: Подайте заявку на получение сертификата разработчика с учетной записью Apple Developer
  • Сертификаты должны храниться безопасно, чтобы избежать утечек

Автоматическое обновление

Использование electron-updater

  • Работает с electron-builder, поддерживает дифференциальные обновления
  • Установкаelectron-updater:npm install electron-updater

Пример главного процесса:

const { autoUpdater } = require('electron-updater')

autoUpdater.on('update-available', () => console.log('发现新版本'))
autoUpdater.on('update-downloaded', () => autoUpdater.quitAndInstall())
autoUpdater.checkForUpdates()

Настройка сервера обновлений

  • Можно использовать GitHub Releases, частные серверы или CDN
  • Предоставляет JSON-файл, описывающий информацию о последней версии

Дифференциальное обновление

  • Загружает только измененные файлы, сокращая потребление трафика
  • electron-updater имеет встроенную поддержку дифференциальных обновлений NSIS / Squirrel / AppImage

Стратегия обновления

  • Автоматическая проверка обновлений (при запуске или по расписанию)
  • Ручной запуск обновлений
  • Всплывающее окно предлагает пользователям обновить немедленно или отложить обновление

Итог

Основной процесс упаковки и распространения Electron:

  • Выбор инструмента: electron-builder, electron-packager, electron-forge
  • Параметры конфигурации: определение платформы, иконок и ресурсов в package.json
  • Многоплатформенная упаковка: Windows, macOS, Linux
  • Подпись кода: обеспечьте доверие к приложению и избегайте предупреждений безопасности
  • Автоматическое обновление: улучшение пользовательского опыта, поддержка дифференциальных обновлений

Следование лучшим практикам позволяет быстро и безопасно распространять приложения Electron среди пользователей, а также упрощает будущие итерации и обновления.

Другие расширения