分享:将 APP 产品打包成 pc 客户端.exe 文件

鉴于部分同事项目上需要把 app 产品打包 pc 客户端的需求,我整理了一下目前我打包成功的案例,使用的很简单暴力的办法。

环境准备

目前只验证过打包成功的环境配置如下:
1. Windows 10 系统(专业版、企业版),家庭版未验证;
2. node.js 版本 12.10.x,搭配 npm 版本 6.10.x, 高于或低于此版本均未验证;
3. git 客户端,最新版
4. 良好的网络环境(重要)

不排除其他情况也可以打包成功,此处只写了我试过的情况。不知道如何搭建环境可以查看 APP 产品的介绍文档,基本一致。

第一步:准备生产版本的 app 项目文件

正常情况下,不做任何其他修改,在 app 产品代码根目录出启动 cmd 命令行或者 powershell,执行打包生产版本命令行:

npm run build

即可得到根目录下的一个 dist 文件夹。
QQ截图20191229135929.png

第二步:git 下载 electron 的官方例子

在空白或存放项目文件夹的目录下启动命令行工具,执行 git 命令行:

git clone https://github.com/electron/electron-quick-start

下载到了一个 electron 的空项目。然后将刚刚打包 APP 生成的 dist 文件夹拷贝到 electron 的项目根目录下。紧接着打开根目录中 main.js 文件,在 20 行左右修改以下:

// main.js 原始内容 
mainWindow.loadFile('index.html') 
// 修改后的内容 
mainWindow.loadFile('./dist/index.html')

第三步:安装项目依赖,启动本地 electron 服务

由于国内某种限制,对网外代码下载有可能出现卡住、下载不全、报错等情况,建议安装 cnpm 工具。也很简单,在完成上述环境准备了之后,直接执行命令行:

npm install -g cnpm

即可全局安装 cnpm 工具。安装完成之后,检查一下版本情况,继续输入:

cnpm -v

会输出当前 cnpm 配置的版本信息,一般如下:
QQ截图20191229164257.png

安装 electron 的项目依赖,一句 npm 命令:

cnpm i
//npm的install可缩写为字母 i

等待一段时间,全部依赖下载完毕。此时,还需要将 electron 打包工具插件安装上去:

cnpm install electron-packager --save-dev

完成之后,项目目录下的 package.json 会自动添加你安装的插件信息,可其中 devDependencies 选项查看。最后,在 package.json 的 scripts 选项中修改为以下属性:

"scripts": { 
    "start": "electron .", 
    "packager": "electron-packager ./ App --platform=win32 --arch=x64 --electron-version=2.0.0 --overwrite"
}

修改好之后,全部配置如图:

image.png

image.png

启动本地 electron 应用,继续在根目录下执行命令行:

npm run start

执行以后就会出来一个桌面应用,如果一切正常的话你已经可以看到自己的项目了。

image.png

第四步:打包成为 .exe 文件

在以上各种环境和配置修改好了之后,打包就非常简单,一句命令行:

npm run packager
初次打包速度较慢,并且与网络条件和本机的管理员权限等有莫名其妙的关系,如果等待时间过长,或者出现报错情况,请检测以上步骤和本机的环境。

打包成功之后,项目目录会多出一个文件夹,就是需要的客户端文件了,其中点开 app.exe,就会出现我们的 app 产品启动界面。

image.png

–完

1 打赏
打赏 5 积分后可见