Упаковка приложения Electron
Узнайте, как подготовить приложение Electron к распространению в разных операционных системах (Windows, macOS, Linux) с помощью инструментов вроде `electron-builder`.
«Упаковка приложения Electron» — бесплатный урок Electron Desktop App Development на CoddyKit. Это урок 3 из 4. Ты можешь прочитать весь урок бесплатно ниже — а потом практиковать его прямо в браузере с встроенным редактором кода и ИИ-репетитором 24/7. Это часть пути обучения Electron Desktop App Development, и твой прогресс синхронизируется между веб-версией и приложением CoddyKit. Курс Electron Desktop App Development содержит 4 уроков всего.
Части этого урока еще не переведены и отображаются на английском.
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!
Часто задаваемые вопросы
Урок «Упаковка приложения Electron» бесплатный?
Да — полный текст урока «Упаковка приложения Electron» бесплатно доступен здесь в веб-версии. Чтобы практиковать его интерактивно (встроенный редактор кода и ИИ-репетитор 24/7) и разблокировать остальной курс Electron Desktop App Development, подпишись на CoddyKit PRO. Курс Electron Desktop App Development содержит 4 уроков всего.
Чему я научусь в уроке «Упаковка приложения Electron»?
Узнайте, как подготовить приложение Electron к распространению в разных операционных системах (Windows, macOS, Linux) с помощью инструментов вроде `electron-builder`. Ты практикуешь Electron Desktop App Development с помощью реального кода, который запускаешь прямо в браузере, и ИИ-репетитор 24/7 отвечает на твои вопросы во время урока.
Нужен ли мне опыт, чтобы начать Electron Desktop App Development?
Предыдущий опыт не требуется. Electron Desktop App Development на CoddyKit структурирован для всех уровней — от новичков до продвинутых, поэтому ты можешь начать отсюда или с самого начала и учиться в своем темпе. Это урок 3 из 4.
Сколько времени занимает урок «Упаковка приложения Electron»?
Большинство уроков CoddyKit занимают около 5–10 минут. Каждый из них компактный и интерактивный, поэтому ты постоянно делаешь прогресс и продолжаешь с того же места в веб-версии и приложении.
Можно ли писать и запускать код в этом уроке Electron Desktop App Development?
Да. Каждый урок Electron Desktop App Development включает встроенный редактор кода, поэтому ты пишешь и запускаешь реальный код прямо в браузере и получаешь моментальную обратную связь от AI — локальная установка не требуется.
Все уроки этого курса
- Главный и отрисовывающий процессы
- Межпроцессное взаимодействие (IPC)
- Упаковка приложения Electron
- Управление несколькими окнами