百科.dev
全部条目在线工具AI 编程趋势榜开源项目技术资讯提交条目
登录
< 返回工具列表
E

electron-installer-debian

> 编程语言
开源

为您的 Electron 应用程序创建一个 Debian 软件包。

389 stars0 点赞3 次浏览
访问官网GitHub

工具介绍

为您的 Electron 应用程序创建一个 Debian 软件包。

electron-installer-debian

Create a Debian package for your Electron app.


Usage | Options | Release Notes | License | Code of Conduct | Support

Requirements

This tool requires Node 22.12 or greater and dpkg 1.19.0 or newer to build the .deb package.

I'd recommend building your packages on your target platform, but if you insist on using Mac OS X, you can install these tools through Homebrew:

$ brew install dpkg

Installation

For use from command-line:

$ npm install -g electron-installer-debian

For use in npm scripts or programmatically:

$ npm install --save-dev electron-installer-debian

Usage

Say your Electron app lives in path/to/app, and has a structure like this:

.
├── LICENSE
├── README.md
├── node_modules
│   ├── electron-packager
│   └── electron
├── package.json
├── resources
│   ├── Icon.png
│   ├── IconTemplate.png
│   └── [email protected]
└── src
    ├── index.js
    ├── main
    │   └── index.js
    └── renderer
        ├── index.html
        └── index.js

You now run electron-packager to build the app for Debian:

$ electron-packager . app --platform linux --arch x64 --out dist/

And you end up with something like this in your dist folder:

.
└── dist
    └── app-linux-x64
        ├── LICENSE
        ├── LICENSES.chromium.html
        ├── content_shell.pak
        ├── app
        ├── icudtl.dat
        ├── libgcrypt.so.11
        ├── libnode.so
        ├── locales
        ├── natives_blob.bin
        ├── resources
        ├── snapshot_blob.bin
        └── version

How do you turn that into a Debian package that your users can install?

Command-Line

If you want to run electron-installer-debian straight from the command-line, install the package globally:

$ npm install -g electron-installer-debian

And point it to your built app:

$ electron-installer-debian --src dist/app-linux-x64/ --dest dist/installers/ --arch amd64

You'll end up with the package at dist/installers/app_0.0.1_amd64.deb.

Scripts

If you want to run electron-installer-debian through npm, install the package locally:

$ npm install --save-dev electron-installer-debian

Edit the scripts section of your package.json:

json
{
  "name": "app",
  "description": "An awesome app!",
  "version": "0.0.1",
  "scripts": {
    "start": "electron .",
    "build": "electron-packager . app --platform linux --arch x64 --out dist/",
    "deb64": "electron-installer-debian --src dist/app-linux-x64/ --dest dist/installers/ --arch amd64"
  },
  "devDependencies": {
    "electron-installer-debian": "^0.6.0",
    "electron-packager": "^9.0.0",
    "electron": "~1.7.0"
  }
}

Note: The versions in devDependencies are examples only, please use the latest package versions when possible.

And run the script:

$ npm run deb64

You'll end up with the package at dist/installers/app_0.0.1_amd64.deb.

Programmatically

Install the package locally:

$ npm install --save-dev electron-installer-debian

And write something like this:

javascript
import installer from 'electron-installer-debian'

const options = {
  src: 'dist/app-linux-x64/',
  dest: 'dist/installers/',
  arch: 'amd64'
}

console.log('Creating package (this may take a while)')
try {
  await installer(options)
  console.log(`Successfully created package at ${options.dest}`)
} catch (err) {
  console.error(err, err.stack)
  process.exit(1)
}

This package is an ES module. On Node.js 22.12 and newer, CommonJS code can still load it with require('electron-installer-debian').default.

You'll end up with the package at dist/installers/app_0.0.1_amd64.deb.

Note: As of 1.0.0, the Node-style callback pattern is no longer available. You can use util.callbackify if this is required for your use case.

Options

Even though you can pass most of these options through the command-line interface, it may be easier to create a configuration file:

javascript
{
  "dest": "dist/installers/",
  "icon": "resources/Icon.png",
  "compression": "gzip",
  "categories": [
    "Utility"
  ],
  "lintianOverrides": [
    "changelog-file-missing-in-native-package"
  ]
}

And pass that instead with the config option:

$ electron-installer-debian --src dist/app-linux-x64/ --arch amd64 --config config.json

Anyways, here's the full list of options:

src

Type: String Default: undefined

Path to the folder that contains your built Electron application.

dest

Type: String Default: undefined

Path to the folder that will contain your Debian installer.

rename

Type: Function Default: function (dest, src) { return path.join(dest, src); }

Function that renames all files generated by the task just before putting them in your dest folder.

options.name

Type: String Default: package.name || "electron"

Name of the package (e.g. atom), used in the Package field of the control specification.

According to the Debian Policy Manual:

Package names [...] must consist only of lower case letters (a-z), digits (0-9), plus (+) and minus (-) signs, and periods (.). They must be at least two characters long and must start with an alphanumeric character.

electron-installer-debian will try to help conform to these requirements by lowercasing the name provided and replacing any invalid characters with -s.

options.productName

Type: String Default: package.productName || package.name

Name of the application (e.g. Atom), used in the Name field of the desktop specification.

options.genericName

Type: String Default: package.genericName || package.productName || package.name

Generic name of the application (e.g. Text Editor), used in the GenericName field of the desktop specification.

options.description

Type: String Default: package.description

Short description of the application, used in the Description field of the control specification.

options.productDescription

Type: String Default: package.productDescription || package.description

Long description of the application, used in the Description field of the control specification.

options.version

Type: String Default: package.version || "0.0.0"

Version number of the package, used in the Version field of the control specification.

options.revision

Type: String Default: undefined

Revision number of the package, used in the Version field of the control specification and, by default, the filename of the generated .deb file.

options.section

Type: String Default: "utils"

Application area into which the package has been classified, used in the Section field of the control specification.

You can read more about sections, and also check out the list of existing sections in Debian unstable.

options.priority

Type: String Default: "optional"

How important it is that the user have the package installed., used in the Priority field of the control specification.

You can read more about priorities.

options.arch

Type: String Default: undefined

Machine architecture the package is targeted to, used in the Architecture field of the control specification.

For possible values see the output of dpkg-architecture -L.

options.size

Type: Integer Default: size of the folder

Estimate of the total amount of disk space required to install the named package, used in the Installed-Size field of the control specification.

options.depends, recommends, suggests, enhances, preDepends

Type: Array[String] Default: For depends, the minimum set of packages necessary for Electron to run; See src/dependencies.js for recommends, suggests, enhances, and preDepends default values

Relationships to other packages, used in the Depends, Recommends, Suggests, Enhances and Pre-Depends fields of the control specification.

All user dependencies will be appended to the Default array of dependencies and any duplicates will be removed.

options.maintainer

Type: String Default: package.author.name

Maintainer of the package, used in the Maintainer field of the control specification.

options.homepage

Type: String Default: package.homepage || package.author.url

URL of the homepage for the package, used in the Homepage field of the control specification.

options.bin

Type: String Default: package.name || "electron"

Relative path to the executable that will act as binary for the application, used in the Exec field of the desktop specification.

The generated package will contain a symlink /usr/bin/ pointing to the path provided here.

For example, providing this configuration:

javascript
{
  src: '...',
  dest: '...',
  name: 'foo',
  bin: 'resources/cli/launcher.sh'
}

Will create a package with the following symlink:

usr/bin/foo@ -> ../lib/foo/resources/cli/launcher.sh

And a desktop specification with the following Exec key:

Exec=foo %U

options.icon

Type: String or Object[String:String] Default: resources/icon.png

Path to a single image that will act as icon for the application:

javascript
{
  icon: 'resources/Icon.png'
}

Or multiple images with their corresponding resolutions:

javascript
{
  icon: {
    '48x48': 'resources/Icon48.png',
    '64x64': 'resources/Icon64.png',
    '128x128': 'resources/Icon128.png',
    '256x256': 'resources/Icon256.png',
    'scalable': 'resources/Icon.svg'
  }
}

Note that the image files must be one of the types: PNG or SVG. The support for SVG works only on scalable resolution.

options.categories

Type: Array[String] Default: ['GNOME', 'GTK', 'Utility']

Categories in which the application should be shown in a menu, used in the Categories field of the desktop specification.

For possible values che

Issues· 0 开放

查看全部 Issues在 GitHub 打开

暂无开放 Issues,或尚未同步最近议题。

> 标签

JavaScript

暂无评论,来聊聊你的看法吧

> 工具信息

发布日期2026年8月1日
最后更新2026年9月17日
分类编程语言
定价开源

> 相关工具

T
TypeScript
JavaScript 的超集,为前端与全栈提供静态类型
P
Python
通用编程语言,广泛用于 Web、数据与 AI
G
Go
Google 推出的简洁高效系统语言