慕容的工作随笔

慕容的工作随笔

记录学习和工作

electron-builder打包的详细参数介绍 转

转自:https://www.php.cn/div-tutorial-411690.html

 

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

基础配置

“build”: {  // 这里是electron-builder的配置

“productName”:“xxxx”,//项目名 这也是生成的exe文件的前缀名

“appId”: “com.xxx.xxxxx”,//包名

“copyright”:“xxxx”,//版权  信息

“directories”: { // 输出文件夹

“output”: “build”

},

// windows相关的配置

“win”: {

“icon”: “xxx/icon.ico”//图标路径

}

}

在配置文件中加入以上的文件之后就可以打包出来简单的文件夹,文件夹肯定不是我们想要的东西。下一步我们来继续讲别的配置。

打包目标配置

要打包成安装程序的话我们有两种方式,

使用NSIS工具对我们的文件夹再进行一次打包,打包成exe

通过electron-builder的nsis直接打包成exe,配置如下

“win”: {  // 更改build下选项

“icon”: “build/icons/aims.ico”,

“target”: [

{

“target”: “nsis” // 我们要的目标安装包

}

]

},

其他平台配置

“dmg”: { // macOSdmg

“contents”: [

…

]

},

“mac”: {  // mac

“icon”: “build/icons/icon.icns”

},

“linux”: { // linux

“icon”: “build/icons”

}

nsis配置

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

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

“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脚本 这个对于构建需求严格得安装过程相当有用。

“script” : “build/script/installer.nsh” // NSIS脚本的路径,用于自定义安装程序。 默认为build / installer.nsi

},

关于include 和 script 到底选择哪一个 ?

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

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

这里上一些学习资源

NSIS初级篇

NSIS 打包脚本基础

示例脚本

NSIS论坛

关于操作系统的配置

主要是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”

]

}

]

}

更新配置

下面这个是给更新用的配置,主要是为了生成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支持列表

评论 (0)

还没有评论,来做第一个吧。

发表评论

提交后需管理员审核通过后显示