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 medianteextraResourcesoextraFilesagregar

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
  • UsarnotarizeAPI 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ónelectron-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