说明

运行前准备工作

• 安装 node 环境版本 v10.x 以上

• 安装 python

• 安装 yarn

从版本库中拉下源码然后进入项目所在目录，使用 yarn 进行安装：

cd [你的项目目录]
yarn install

运行步骤

首次运行 在终端依次执行如下命令：

1. 编译 dll： yarn run build:dll
2. 编译项目：yarn run build
3. 运行：yarn run app

之后再次启动项目只需执行yarn run app即可。开发进程中有新图片等静态资源引入时，要再次执行yarn run build命令。

注意：在项目中若需要其它第三方包请使用 yarn 来安装，不要使用 npm！

发布

发布前若 ui.yaml 配置文件有变动，则使用命令行进行加密。

使用 npm 安装命令行工具：

npm install -g azjm

然后进入项目的src/config目录，使用命令进行加密，加密算法使用默认rc4：

azjm

成功后会在src/config目录中生成conf文件。将新conf文件拷贝到发布应用的resources\config下即可。

ui.yaml 无变化不需要上述操作

采集路数在ui.yaml中的max属性中设置；采集路数建议配置在2 ~ 20路之间

在命令行使用 yarn 命令来发布：

yarn run dist

打包成功后即可在 dist 目录找到 zip 包及 Windows 安装包。

后续升级中，如果只改动了主进程源码main.js以及主窗口的源代码（除src/renderer目录），那么打包发布不需要全量更新，只需发布app.asar.unpacked下的相关文件即可。

运行命令说明

yarn 命令	说明
yarn run build:dll	编译公共库 dll
yarn run build:prod	以生产方式编译
yarn run build	编译项目
yarn run app	运行项目
yarn run pack	打包项目（以目录形式发布，用于测试）
yarn run dist	发布项目（发布最终安装包和 zip 包）

可能出现的错误

如果在使用 yarn 命令打包中报找不到 electron，是因为在墙国无法下载可翻墙解决，也可使用淘宝镜像，方法如下：

在淘宝镜像页面中找到对应的 electron 版本，下载对应平台的 electron 包，解压到项目node_modules/electron/dist目录下。

之后在node_modules/electron目录中新建一个文本文件path.txt，写入：

electron.exe

之后即可打包运行应用

第一次在使用yarn run dist发布时也有可能报找不到 electron.x.x.zip 包，方法也是先手动下载对应的版本，然后拷到：

C:\Users\[你的用户名]\AppData\Local\electron\Cache

再次执行yarn run dist命令，即可成功发布应用

如果还有其他问题，Google大法好 ^_^