Упаковка и распространение 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 среди пользователей, а также упрощает будущие итерации и обновления.
Другие расширения