Electron-builder打包详解

时间  2019-11-29
标签 electron builder 打包 详解 繁體版
原文   原文链接

开发electron客户端程序，打包是绕不开的问题。下面就我在工做中的经验以及目前对electron-builder的了解来分享一些心得。html

基本概念

官网的定义node

A complete solution to package and build a ready for distribution Electron app for macOS, Windows and Linux with “auto update” support out of the box.linux

关于electron和electron-builder的基础部分这篇文章就跳过了，有兴趣的话能够看这篇文章webpack

如何使用

builder的使用和配置都是很简单的 builder配置有两种方式git

  • package.json中直接配置使用（比较经常使用，咱们下面着重来说这个）
  • 指定electron-builder.yml文件

demo地址会在文章末尾给出（demo项目中electron使用得是V2.0.7版本,目前更高得是2.0.8版本）。github

下面是一个简单的package.js中带注释的配置web

  1. 基础配置
"build": {  // 这里是electron-builder的配置
    "productName":"xxxx",//项目名 这也是生成的exe文件的前缀名
    "appId": "com.xxx.xxxxx",//包名  
    "copyright":"xxxx",//版权  信息
    "directories": { // 输出文件夹
      "output": "build"
    }, 
    // windows相关的配置
    "win": {  
      "icon": "xxx/icon.ico"//图标路径 
    }  
  }复制代码

在配置文件中加入以上的文件以后就能够打包出来简单的文件夹，文件夹确定不是咱们想要的东西。下一步咱们来继续讲别的配置。 2. 打包目标配置 要打包成安装程序的话咱们有两种方式，macos

  1. 使用NSIS工具对咱们的文件夹再进行一次打包，打包成exe
  2. 经过electron-builder的nsis直接打包成exe，配置以下
"win": {  // 更改build下选项
    "icon": "build/icons/aims.ico",
    "target": [
      {
        "target": "nsis" // 咱们要的目标安装包
      }
    ]
  },复制代码
  1. 其余平台配置
"dmg": { // macOSdmg
    "contents": [
      ...
    ]
    },
    "mac": {  // mac
      "icon": "build/icons/icon.icns"
    },
    "linux": { // linux
      "icon": "build/icons"
    }复制代码
  1. nsis配置

这个要详细的讲一下，这个nsis的配置指的是安装过程的配置，其实仍是很重要的，若是不配置nsis那么应用程序就会自动的安装在C盘。没有用户选择的余地，这样确定是不行的npm

关于nsis的配置是在build中nsis这个选项中进行配置，下面是部分nsis配置json

"nsis": {
  "oneClick": false, // 是否一键安装
  "allowElevation": true, // 容许请求提高。 若是为false，则用户必须使用提高的权限从新启动安装程序。
  "allowToChangeInstallationDirectory": true, // 容许修改安装目录
  "installerIcon": "./build/icons/aaa.ico",// 安装图标
  "uninstallerIcon": "./build/icons/bbb.ico",//卸载图标
  "installerHeaderIcon": "./build/icons/aaa.ico", // 安装时头部图标
  "createDesktopShortcut": true, // 建立桌面图标
  "createStartMenuShortcut": true,// 建立开始菜单图标
  "shortcutName": "xxxx", // 图标名称
  "include": "build/script/installer.nsh", // 包含的自定义nsis脚本 这个对于构建需求严格得安装过程至关有用。
},复制代码

关于include 和 script 到底选择哪个 ？

在对个性化安装过程需求并不复杂，只是须要修改一下安装位置，卸载提示等等的简单操做建议使用include配置,若是你须要炫酷的安装过程，建议使用script进行彻底自定义。

NSIS对于处理安装包这种东西，功能很是的强大。可是学习起来并不比一门高级语言要容易。其中的奥秘还要各位大佬自行探索

这里上一些学习资源

  1. 关于操做系统的配置

主要是windows中64和32位的配置

CLI参数

electron-builder --ia32 // 32位
electron-builder        // 64位(默认)复制代码

nsis中配置

"win": {
  "icon": "build/icons/aims.ico",
  "target": [
    {
      "target": "nsis",
      "arch": [ // 这个意思是打出来32 bit + 64 bit的包，可是要注意：这样打包出来的安装包体积比较大，因此建议直接打32的安装包。
        "x64", 
        "ia32"
      ]
    }
  ]
}复制代码
  1. 更新配置

下面这个是给更新用的配置，主要是为了生成lastest.yaml配置文件

"publish": [
  {
    "provider": "generic", // 服务器提供商 也能够是GitHub等等
    "url": "http://xxxxx/" // 服务器地址
  }
],复制代码

完整配置

基本上可用的完整的配置

"build": {
    "productName":"xxxx",//项目名 这也是生成的exe文件的前缀名
    "appId": "com.leon.xxxxx",//包名  
    "copyright":"xxxx",//版权  信息
    "directories": { // 输出文件夹
      "output": "build"
    }, 
    "nsis": {
      "oneClick": false, // 是否一键安装
      "allowElevation": true, // 容许请求提高。 若是为false，则用户必须使用提高的权限从新启动安装程序。
      "allowToChangeInstallationDirectory": true, // 容许修改安装目录
      "installerIcon": "./build/icons/aaa.ico",// 安装图标
      "uninstallerIcon": "./build/icons/bbb.ico",//卸载图标
      "installerHeaderIcon": "./build/icons/aaa.ico", // 安装时头部图标
      "createDesktopShortcut": true, // 建立桌面图标
      "createStartMenuShortcut": true,// 建立开始菜单图标
      "shortcutName": "xxxx", // 图标名称
      "include": "build/script/installer.nsh", // 包含的自定义nsis脚本
    },
    "publish": [
      {
        "provider": "generic", // 服务器提供商 也能够是GitHub等等
        "url": "http://xxxxx/" // 服务器地址
      }
    ],
    "files": [
      "dist/electron/**/*"
    ],
    "dmg": {
      "contents": [
        {
          "x": 410,
          "y": 150,
          "type": "link",
          "path": "/Applications"
        },
        {
          "x": 130,
          "y": 150,
          "type": "file"
        }
      ]
    },
    "mac": {
      "icon": "build/icons/icon.icns"
    },
    "win": {
      "icon": "build/icons/aims.ico",
      "target": [
        {
          "target": "nsis",
          "arch": [
            "ia32"
          ]
        }
      ]
    },
    "linux": {
      "icon": "build/icons"
    }
  }复制代码

命令行参数（CLI）

Commands(命令):

electron-builder build                    构建命名                      [default]
  electron-builder install-app-deps         下载app依赖
  electron-builder node-gyp-rebuild         重建本身的本机代码
  electron-builder create-self-signed-cert  为Windows应用程序建立自签名代码签名证书
  electron-builder start                    使用electronic-webpack在开发模式下运行应用程序(须臾要electron-webpack模块支持)复制代码

Building(构建参数):

--mac, -m, -o, --macos   Build for macOS,                              [array]
  --linux, -l              Build for Linux                               [array]
  --win, -w, --windows     Build for Windows                             [array]
  --x64                    Build for x64 (64位安装包)                     [boolean]
  --ia32                   Build for ia32(32位安装包)                     [boolean]
  --armv7l                 Build for armv7l                              [boolean]
  --arm64                  Build for arm64                               [boolean]
  --dir                    Build unpacked dir. Useful to test.           [boolean]
  --prepackaged, --pd      预打包应用程序的路径（以可分发的格式打包）
  --projectDir, --project  项目目录的路径。 默认为当前工做目录。
  --config, -c             配置文件路径。 默认为`electron-builder.yml`（或`js`，或`js5`)
复制代码

Publishing(发布):

--publish, -p  发布到GitHub Releases [choices: "onTag", "onTagOrDraft", "always", "never", undefined]复制代码

Deprecated(废弃):

--draft       请改成在GitHub发布选项中设置releaseType                 [boolean]
  --prerelease  请改成在GitHub发布选项中设置releaseType                 [boolean]
  --platform    目标平台 (请更改成选项 --mac, --win or --linux)
           [choices: "mac", "win", "linux", "darwin", "win32", "all", undefined]
  --arch        目标arch (请更改成选项 --x64 or --ia32)
                   [choices: "ia32", "x64", "armv7l", "arm64", "all", undefined]复制代码

Other(其余):

--help     Show help                                                 [boolean]
  --version  Show version number                                       [boolean]复制代码

Examples(例子):

electron-builder -mwl                        为macOS，Windows和Linux构建（同时构建）
  electron-builder --linux deb tar.xz          为Linux构建deb和tar.xz
  electron-builder -c.extraMetadata.foo=bar    将package.js属性`foo`设置为`bar`
  electron-builder --config.nsis.unicode=false 为NSIS配置unicode选项
    复制代码

TargetConfiguration(构建目标配置):

target:  String - 目标名称，例如snap.
arch “x64” | “ia32” | “armv7l” | “arm64”> | “x64” | “ia32” | “armv7l” | “arm64”  -arch支持列表复制代码

常见的错误

  • NPM下载的问题

    由于NPM在国内比较慢。致使electron-V.xxxx.zip下载失败。这些东西若是是第一次打包的话是须要下载对应electron版本的支持文件。解决办法有两个

    1. 设置镜像：在C盘User中找到.npmrc文件。而后加入下面这句代码,可是这个有时候也不是很好用
    ELECTRON_MIRROR=http://npm.taobao.org/mirrors/electron/
复制代码
    1. 直接去淘宝镜像文件库找到对应的文件并下载，放到指定的目录下，electron的淘宝镜像地址。下载完以后放到指定的文件。通常文件得地址在C:\Users\Administrator\AppData\Local\electron\Cache。例如我要下载1.8.4版本的electron，那么找到镜像下得文件而后放到指定文件夹中。 electronelectron

    (若是是在执行npm install时下载不下来)直接在淘宝镜像下载对应版本的zip，而后扔到C:\Users\YourUserName.electron就行

    这就解决了这个问题，简单又暴力。

  • NSIS下载问题

    若是你要打NSIS得包还须要西再下载nsis-resources-xxx等等包。通过上面得经验这下咱们知道缺什么就填什么呗，经过错误日志咱们能够获得咱们要下载得版本，通常错误中一般会展现github下载地址，直接点开链接去下载。可是位置此次不同了。由于这是electron-builder的支持环境因此咱们要放在C:\Users\Administrator\AppData\Local\electron-builder\cache\nsis\下了。 electron

通常状况下解决这些问题的思路就是，缺什么拿什么😄。

总结

electron-builder是一个简单又强大的库。解决了打包这个棘手的问题，并且能够应对大部分的打包需求。

Demo地址

相关文章
相关标签/搜索
每日一句
    每一个你不满意的现在，都有一个你没有努力的曾经。
本站公众号
   欢迎关注本站公众号,获取更多信息
联系我们 最近搜索 最新文章 沪ICP备13005482号-10 MyBatis教程 SQL 教程 MySQL教程 Java 教程 Thymeleaf 教程 Hibernate教程 Spring教程 Redis教程