Empaquetado de su aplicación Electron
Descubra cómo empaquetar su aplicación Electron para distribuirla en distintos sistemas operativos (Windows, macOS y Linux) con herramientas como `electron-builder`.
Empaquetado de su aplicación Electron es una lección gratuita de Electron Desktop App Development en CoddyKit. Esta es la lección 3 de 4. Puedes leer la lección completa abajo gratuitamente — luego la practicas en el navegador con un editor de código integrado y un tutor de IA 24/7. Forma parte de la ruta de aprendizaje de Electron Desktop App Development, y tu progreso se sincroniza en la web y la app de CoddyKit. El curso de Electron Desktop App Development incluye 4 lecciones en total.
Partes de esta lección aún no han sido traducidas y se muestran en inglés.
Why Package Your App?
When you develop an Electron app, it runs using Node.js and Chromium. However, your users won't have Node.js installed or know how to run your development files.
Packaging your application means bundling all its necessary files—your code, Electron runtime, and any assets—into a single, easy-to-distribute executable file or installer, like a .exe for Windows or a .dmg for macOS.
Meet Electron Builder
electron-builder is the most popular and robust solution for packaging and distributing Electron applications. It simplifies the complex process of preparing your app for various operating systems.
- Cross-Platform: Build for Windows, macOS, and Linux from a single codebase.
- Installers: Generate platform-specific installers (e.g., NSIS for Windows, DMG for macOS).
- Auto-Updates: Integrates seamlessly with auto-update mechanisms.
- Customization: Offers extensive options for icons, product names, and more.
Installing Electron Builder
First, you need to add electron-builder as a development dependency to your project. Open your terminal in your project's root directory and run:
npm install --save-dev electron-builderBasic Project Setup
Before packaging, ensure your package.json is correctly set up. It defines your application's basic information and entry point. Here's a minimal example:
name: Your app's unique identifier.version: Current version.main: Path to your main Electron script.scripts.start: Command to run your app in development.
{
"name": "my-electron-app",
"version": "1.0.0",
"main": "main.js",
"scripts": {
"start": "electron ."
}
}Configure package.json for Build
Now, let's add the build configuration to your package.json. This block tells electron-builder how to package your app.
appId: A unique identifier for your app (e.g.,com.yourcompany.yourapp).productName: The name users will see for your app.directories.output: Where the packaged files will be saved (commonlydist).scripts.build: The command to trigger the build.
{
"name": "my-electron-app",
"version": "1.0.0",
"main": "main.js",
"scripts": {
"start": "electron .",
"build": "electron-builder"
},
"build": {
"appId": "com.yourcompany.yourapp",
"productName": "My Awesome App",
"directories": {
"output": "dist"
}
}
}Building for Windows
For Windows, electron-builder can create various targets. The most common are nsis (Nullsoft Scriptable Install System) for a standard installer, or portable for a single executable that doesn't require installation.
You can specify the target when running the build command:
npm run build -- --win nsisBuilding for macOS
On macOS, typical distribution formats include dmg (Disk Image) for a guided installation, or zip for a direct archive of the .app bundle.
It's also good practice to specify a category for macOS apps.
npm run build -- --mac dmgBuilding for Linux
Linux offers several packaging formats to cater to different distributions:
deb: For Debian-based systems (like Ubuntu).rpm: For Red Hat-based systems (like Fedora).AppImage: A universal format that runs on most Linux distributions.
Here's how to build an AppImage:
npm run build -- --linux AppImageCustomizing with Icons
A custom application icon is essential for brand recognition. You can specify a single icon path in your package.json's build section. electron-builder will automatically generate different sizes for various platforms.
It's recommended to place your main icon (e.g., a .png) in a build directory in your project root.
{
"build": {
"appId": "com.yourcompany.yourapp",
"productName": "My Awesome App",
"directories": {
"output": "dist"
},
"icon": "build/icon.png"
}
}Run Your Build!
With your package.json configured, executing the build command is straightforward. This command will start the packaging process, which might take a few minutes depending on your project size and internet speed (to download Electron binaries).
Once complete, you'll find your packaged application files in the dist directory.
npm run buildPackaging Features Quiz
Which of these are valid reasons to use electron-builder for packaging your Electron app?
Recap: Ready for Distribution
You've learned the essentials of packaging your Electron application!
- Packaging bundles your app into a distributable format.
electron-builderis the go-to tool for cross-platform packaging.- Configuration happens in
package.json, defining app metadata and build targets. - You can create installers for Windows (
nsis), macOS (dmg), and various Linux formats (AppImage,deb,rpm).
Now your app is ready to be shared with the world!
Preguntas frecuentes
¿La lección «Empaquetado de su aplicación Electron» es gratis?
Sí — el texto completo de «Empaquetado de su aplicación Electron» es gratis para leer aquí en la web. Para practicarla de forma interactiva (editor de código integrado y tutor de IA 24/7) y desbloquear el resto del curso de Electron Desktop App Development, actualiza a CoddyKit PRO. El curso de Electron Desktop App Development incluye 4 lecciones en total.
¿Qué aprenderé en «Empaquetado de su aplicación Electron»?
Descubra cómo empaquetar su aplicación Electron para distribuirla en distintos sistemas operativos (Windows, macOS y Linux) con herramientas como `electron-builder`. Practicas Electron Desktop App Development con código real que ejecutas directamente en el navegador, y un tutor de IA 24/7 responde tus preguntas mientras trabajas en la lección.
¿Necesito experiencia previa para empezar Electron Desktop App Development?
No se requiere experiencia previa. Electron Desktop App Development en CoddyKit está estructurado para principiantes hasta estudiantes avanzados, así que puedes empezar aquí o desde el inicio y avanzar a tu ritmo. Esta es la lección 3 de 4.
¿Cuánto tiempo toma la lección «Empaquetado de su aplicación Electron»?
La mayoría de las lecciones de CoddyKit toman alrededor de 5–10 minutos. Cada una es compacta e interactiva, así que avanzas constantemente y retomas exactamente por donde dejaste en la web y la app.
¿Puedo escribir y ejecutar código en esta lección de Electron Desktop App Development?
Sí. Cada lección de Electron Desktop App Development incluye un editor de código integrado, así que escribes y ejecutas código real directamente en tu navegador y obtienes retroalimentación instantánea de IA — sin configuración local necesaria.
Todas las lecciones de este curso
- Proceso principal frente a proceso de renderizado
- Comunicación entre procesos (IPC)
- Empaquetado de su aplicación Electron
- Gestión de varias ventanas