VS Code + NWJS(Node-Webkit)0.14.7 + SQLite3 + Angular6 构建跨平台桌面应用
一、项目需求
最近公司有终端桌面系统需求,需要支持本地离线运行(本地数据为主,云端数据同步),同时支持window xp,最好跨平台。要求安装配置简单(一次性打包安装),安装包要小,安装时间短,可离线安装。技术要求使用主流技术,有利于扩展,升级,便于迁移到其它各种终端和平台应用。
二、需求分析和选择技术方案
通过需求分析,采用web终端混合架构开发桌面应用系统。首先就是要找一个web混合架构开发框架。通过google百度查找资料,最后主要在选择nwjs和electron框架上,两款框架都是基于chromium和node.js的非常优秀的框架,两个框架的对比请自行google百度,这里不多做累赘,最终选择nwjs,主要是它对window xp的支持,在中国还约15%的window xp用户,不容忽视,不然要求客户的升级成本太高。本地数据库选择可嵌入式轻量级数据库sqlite3集成,web框架采用单页面有更好体验,采用mvvm web框架angular6,通过vs code前端工具开发,由于需要考虑支持window xp,我们选择nwjs金典版v0.14.7。整体技术架构方案为vs code + nwjs(node-webkit)0.14.7 + sqlite3 + angular6。
相关资料:
nwjs:https://nwjs.org.cn/ (中) (英)
sqlite:
angular:
三、开发集成环境搭建
1. nwjs环境集成
详细请参考官方文档,打包发布采用官方推荐nwjs-builder-phoenix自动完成,nw-builder在打包时下载对应的版本包有些慢,有时会不成功。
npm install --save-dev nw@0.14.7
npm install --save-dev nwjs-builder-phoenix
angular package.json包构建命令:
"scripts": { "dev": "ng build --prod --build-optimizer && run -x86 --mirror https://npm.taobao.org/mirrors/nwjs/ .", "prod": "ng build --prod --build-optimizer && build --tasks win-x86 --mirror https://npm.taobao.org/mirrors/nwjs/ ." }
运行命令:
npm run dev npm run prod
2. sqlite3环境集成
对应sqlite3是node第三方扩展模块加载,对于采用不同的nwjs版本需要进行编译,在集成编译过程中主要参考了官方npm和github上资料,其它参考资料有限,由于版本的差异性和依赖编译环境,这个过程较为复杂,采了不少坑,我采用的nwjs的版本是0.14.7,完全通过官方介绍的方式并没有编译成功,最终结合这篇资料 完成编译并测试通过,主要步骤如下:
1) 确定你node+npm版本已安装好(注:安装lts版本 )
2) node-gyp、nw-gyp、node-pre-gyp 全局安装
npm install -g node-gyp npm install nw-gyp -g npm install node-pre-gyp -g
3) 升级visual studio 2017或2015安装c++桌面环境(重要,主要用于编译sqlite3 node模块)
4) 安装windows-build-tools,会自行检查安装python 2.7.x
参考资料:
安装使用微软的所有必要的工具和配置windows的构建工具使用
npm install --global --production windows-build-tool
从提升的powershell或cmd.exe,(注:以管理员身份运行)。
5) 在nw.js中安装node原生模块lts版需替换win_delay_load_hook.cc
参考资料:https://nwjs.org.cn/doc/user/advanced/use-native-node-modules.html
6)下载node-sqlite3源码解压到sqlite3目录
下载地址:
7) git-bash或cmd中进入sqlite3根目录进行编译,我采用的是nwjs v0.14.7版本需要编译两份分别是x64开发环境(开发环境是64位window 10),和ia32(针对window xp系统)发布环境,解压出两份源码分别编译。
npm install --build-from-source --runtime=node-webkit --target_arch=x64 --target=0.14.7 npm install --build-from-source --runtime=node-webkit --target_arch=ia32 --target=0.14.7
四、测试运行
1. 将编译完成的目录复制sqlite3整个目录copy到nwjs目录中的node_modules里面(注:调试环境请复制x64的编译完成的模块)
2. 添加angular 代码界面运行测试
getdate(){ return new promise<any>((resolve, reject) => { var sqlite3 = (<any>window).require('sqlite3').verbose(); var db = new sqlite3.database(':memory:'); var arrdata: any[] = []; db.serialize(function () { db.run("create table lorem (info text)"); var stmt = db.prepare("insert into lorem values (?)"); for (var i = 0; i < 10; i++) { stmt.run("ipsum " + i); } stmt.finalize(); db.each("select rowid as id, info from lorem", function (err, row) { arrdata.push(row); console.log(row.id + ": " + row.info); }, function (){ console.log('end'); resolve(arrdata); }); }); db.close(); }); } getsqlitdate() { this.getdate().then((res) =>{ console.table(res); this.data = res; }); }
nwjs运行dev通过点击一个button调用getsqlitdate(),显示结果如下:
npm run dev