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。

相关资料：

vs code：

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