Electron Empaquetado y Distribución
Una vez completado el desarrollo de la aplicación Electron, es necesario empaquetarla como un archivo ejecutable de escritorio y publicarla para los usuarios.
El proceso de empaquetado y distribución implica múltiples aspectos, como la selección de herramientas, la configuración, la firma y la estrategia de actualización.
Introducción a las herramientas de empaquetado
electron-builder
- Altamente automatizado, compatible con Windows, macOS y Linux
- Compatible con actualización automática
- Configuración sencilla, adecuado para entornos de producción
- Puede generar
.exe、.dmg、.AppImagey otros formatos
electron-packager
- Herramienta de empaquetado recomendada oficialmente, ligera
- Solo se encarga de generar el ejecutable, sin actualización automática
- Configuración sencilla, pero requiere combinarse con otras herramientas para manejar el instalador y la firma
electron-forge
- Integra empaquetado, plantillas, actualización automática y proceso de publicación
- Listo para usar, adecuado para que los principiantes inicien proyectos rápidamente
- Soporte integrado de construcción Webpack / ESBuild
Comparación y selección de herramientas
| Herramienta | Características | Ventajas | Escenarios aplicables |
|---|---|---|---|
| electron-builder | Alta automatización, multiplataforma, soporte de actualización | Configuración sencilla, adecuado para producción | Publicación de aplicaciones complejas |
| electron-packager | Ligero, soporte oficial | Combinación flexible con otras herramientas | Empaquetado de aplicaciones simples |
| electron-forge | Herramientas de desarrollo integradas, inicio rápido | Listo para usar, construcción integrada | Principiantes o prototipos rápidos |
Configuración de parámetros de empaquetado
Configuración de 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"
}
}
Configuración específica de plataforma
- Windows: tipo de instalador (NSIS, Squirrel), icono
.ico - macOS: categoría de la aplicación, firma,
.icnsicono - Linux: formato objetivo (AppImage, deb, rpm), icono PNG
Iconos y archivos de recursos
- El tamaño y formato de los iconos deben cumplir con los requisitos de la plataforma
- Los recursos adicionales se pueden agregar mediante
extraResourcesoextraFilesagregar
Empaquetado multiplataforma
Empaquetado para Windows
electron-builder --win
- Puede generar
.exeo.msiarchivos de instalación - Compatible con el asistente de instalación NSIS e instalación silenciosa
Empaquetado para macOS
electron-builder --mac
- Puede generar
.dmgo.pkg - Combinado con la notarización, puede pasar el Gatekeeper de macOS
Empaquetado para Linux
electron-builder --linux
- Formatos comunes: AppImage, deb, rpm
- Adecuado para la distribución de escritorio en diferentes distribuciones
Compilación cruzada
- Electron-builder admite compilación multiplataforma, pero las aplicaciones de macOS deben firmarse en macOS
- Windows / Linux pueden lograr empaquetado cruzado mediante máquinas virtuales de compilación Linux o Windows
Firma de código
Firma de código para Windows
- Firmar con certificado digital (.pfx)
.exeo.msi - Ejemplo:
electron-builder --win --csc-link path/to/certificate.pfx --csc-key-password yourpassword
- Aumenta la confianza del usuario y evita el bloqueo de SmartScreen
Notarización de macOS (Notarization)
- Apple exige oficialmente que las aplicaciones se notaricen para pasar Gatekeeper
- Se requiere una cuenta de Apple Developer
- Ejemplo de compilación:
electron-builder --mac --publish never
- Usar
notarizeAPI para subir la aplicación y realizar la notarización automática
Solicitud y gestión de certificados
- Windows: comprar certificado de firma de código EV o estándar
- macOS: solicitar certificado de desarrollador con cuenta de Apple Developer
- Los certificados deben almacenarse de forma segura para evitar filtraciones
Actualización automática
Uso de electron-updater
- Se combina con electron-builder y admite actualización diferencial
- Instalación
electron-updater:npm install electron-updater
Ejemplo de proceso principal:
const { autoUpdater } = require('electron-updater')
autoUpdater.on('update-available', () => console.log('发现新版本'))
autoUpdater.on('update-downloaded', () => autoUpdater.quitAndInstall())
autoUpdater.checkForUpdates()
Configuración del servidor de actualizaciones
- Se pueden usar GitHub Releases, servidores privados o CDN
- Proporcionar un archivo JSON que describa la información de la última versión
Actualización diferencial
- Solo descarga los archivos modificados, reduciendo el consumo de ancho de banda
- electron-updater tiene soporte integrado para actualización diferencial de NSIS / Squirrel / AppImage
Estrategia de actualización
- Verificación automática de actualizaciones (al inicio o programada)
- Activación manual de la actualización
- Ventana emergente que pregunta al usuario si desea actualizar inmediatamente o retrasar la actualización
Resumen
Flujo principal de empaquetado y distribución de Electron:
- Seleccionar herramienta:electron-builder、electron-packager、electron-forge
- Configurar parámetros: definir plataforma, iconos y recursos en package.json
- Empaquetado multiplataforma:Windows、macOS、Linux
- Firma de código: garantizar que la aplicación sea confiable y evitar advertencias de seguridad
- Actualización automática: mejorar la experiencia del usuario, compatible con actualización diferencial
Seguir las mejores prácticas permite distribuir aplicaciones Electron a los usuarios de forma rápida y segura, facilitando además iteraciones y actualizaciones posteriores.
Otras extensiones