使用nw.js将vue项目打包为可在xp系统运行的桌面程序

2022-10-10 14:31:45

前情提要

在nw.js入门最如丝般润滑的教程一文中，作者介绍了简单的使用nw运行html文件为桌面程序以及将html文件打包为桌面可执行文件exe。
看vuecli创建的工程打包成exe文件可直接从【在vuecli创建的项目基础上增加nw插件无缝转化为桌面程序】目录开始。

本文主题

以上文运行和打包方式将vue项目打包为桌面可执行程序
在vuecli创建的项目基础上增加nw插件无缝转化为桌面程序
可在xp系统运行
支持自动更新

将vue项目打包为桌面可执行程序

将vue项目打包生成的dist目录下的所有文件复制到app及package.nw目录下

注意：笔者尝试了下将dist文件夹放在app及package.nw目录下，然后修改package.json中的main路径，但是出现异常；而将dist目录去掉把index.html和其他文件直接放在app及package.nw目录下可以正常启动成功。可能是缓存原因
将app目录拖动至nw.exe上方运行
执行打包命令生成桌面软件
```
copy /b nw.exe+package.nw yourname.exe
```

在vuecli创建的项目基础上增加nw插件无缝转化为桌面程序

运行vue项目为桌面程序

创建vue项目

vue create yourname  // vuecli3+

or

vue init webpack yourname // vuecli2

添加nw插件依赖
```
cnpm install nw@0.14.7-sdk --save-dev  // 官方文档说要支持xp系统请使用0.14.7版本，不考虑xp则可安装最新版
```
注意：推荐使用cnpm安装，npm安装基本失败，yarn安装也难得的不稳定！因此推荐cnpm安装
运行项目
先运行vue项目，如果出现依赖错误，删除node_modules目录然后重新cnpm install即可
以桌面软件的方式运行项目

在package.json中增加一行nwjs的文件入口代码
```
"main": "http://localhost:8080/", // 因为nw入口可以是.html,.js和线上地址。因为是本地运行，将main设置为你上一步中运行起来的项目地址
```
在package.json中scripts下增加一行脚本命令
```
"serve:nw": "nw",
```
然后在编辑器终端输入 npm run serve:nw 即可启动桌面版vue项目

打包vue项目为桌面程序

使用插件打包：nw中文网推荐nwjs-builder-phoenix（虽然已封存，但是按官方推荐来吧，坑少）

cnpm install nwjs-builder-phoenix --save-dev

在package.json中scripts下增加一行脚本命令

"build:nw": "npm run build && build --tasks win-x86 --mirror https://npm.taobao.org/mirrors/nwjs/ .", // win-x86版
"build:nw:all": "npm run build && build --tasks win-x86,win-x64,linux-x86,linux-x64,mac-x64 --mirror https://npm.taobao.org/mirrors/nwjs/ .", // 打包多版本

在package.json中配置基本打包参数

"build": {
	"files": [
  		"dist/**/*"  // 文件路径，你vue打包后的文件夹
	],
	"output": "./releases", // 输出路径，打包后的软件输出位置
	"nwVersion": "0.14.7", // 跟你下载的nw版本匹配
	"nwPlatforms": [
  		"win" // 平台
	],
	"nwArchs": [
  		"x86" // 和上面打包命令后面的版本参数匹配
	],
	"overriddenProperties": {
 	    "main": "./dist/index.html" // 设置软件入口文件，其实这里可以是一个网址
	},
    "targets": [
  		"zip" // 打包成zip格式，自动更新用的到
	]
},

修改vue.config.js，将打包路径设置为相对路径,cli2版本不再赘述
```
module.exports = {
	publicPath: './',
	productionSourceMap: false,
}
```
完成这三步之后，在终端运行npm run build:nw即可生成打包后的桌面软件文件夹。找到里面的your name.exe然后双击运行即可。

如果无需支持xp，将--tasks win-x86改成--tasks win-x64，nwArchs内的x86改成x64即可

自动更新

常见问题（踩坑）

vuecli3+默认的路由模式为history，使用nw打包后会报错，将router.js中的mode: history注释即可。
如果将build/overriddenProperties/mian的值设置为一个网址打包后软件也是可运行的，在xp上也没问题，是不是理论上只要网站一直保持运行和最新内容，这个软件包就无须更新永远是最新的？