打包说明

安装打包工具

首先安装 electron-builder:

npm install --save-dev electron-builder

打包命令

1. 打包 Windows 安装包和便携版

npm run build:win

这会生成两个版本:

安装版: dist/文件搜索工具 Setup 1.0.0.exe (带安装向导)
便携版: dist/文件搜索工具-1.0.0-portable.exe (免安装,双击即用)

2. 仅生成未打包的文件夹 (用于测试)

npm run build:dir

3. 通用打包命令

npm run build

打包输出

打包完成后,文件会输出到 dist 目录:

dist/
├── 文件搜索工具 Setup 1.0.0.exe    # 安装版 (约 80-100MB)
├── 文件搜索工具-1.0.0-portable.exe  # 便携版 (约 80-100MB)
└── win-unpacked/                    # 未打包的文件夹

图标说明

当前配置使用 build/icon.ico 作为应用图标。

如果你想自定义图标:

准备一个 256x256 或 512x512 的 PNG 图片
使用在线工具转换为 .ico 格式 (推荐: https://convertio.co/zh/png-ico/)
将 icon.ico 放到 build 文件夹中

如果没有图标文件,打包时会使用默认的 Electron 图标。

发布建议

便携版 (推荐给普通用户)

优点: 无需安装,下载即用,不写注册表
适合: 快速使用、U盘携带、不想安装软件的用户

安装版

优点: 集成到系统,创建桌面快捷方式和开始菜单
适合: 长期使用、需要系统集成的用户

打包前检查清单

确认所有功能正常运行
测试搜索功能
测试文件操作(打开文件夹、浏览文件、查看属性)
测试停止和清空功能
检查关键词高亮
验证文件类型过滤
准备应用图标 (可选)
更新 package.json 中的 author 信息

首次打包

第一次打包时,electron-builder 会下载必要的依赖,可能需要几分钟时间。

# 1. 安装依赖
npm install

# 2. 安装打包工具
npm install --save-dev electron-builder

# 3. 开始打包
npm run build:win

常见问题

1. 打包速度慢

第一次打包会下载 Electron 二进制文件,后续打包会快很多。

2. 缺少图标文件

如果没有 build/icon.ico,打包会使用默认图标,不影响功能。

3. 杀毒软件误报

便携版可能被某些杀毒软件误报,这是正常现象。可以添加信任或使用安装版。

版本更新

修改 package.json 中的 version 字段,然后重新打包:

{
  "version": "1.0.1"
}

技术支持

如有问题,请检查:

Node.js 版本 >= 16
npm 版本 >= 8
网络连接正常
磁盘空间充足 (至少 500MB)

FilesExpand file tree

build-instructions.md

Latest commit

History