跳到主要内容

常见问题

1. 打包后出现黑屏问题​

问题: 打包后，打开出现黑屏，并有提示"无法加载插件"

解决方案: 该问题是由于网页中使用了Flash导致的，可以在打包时，勾选支持Flash的选项，增加对Flash的支持。

2. 如何全屏显示​

打开exe后，有以下几种方式可以进入全屏：

  • 点击F11键即可进入全屏
  • 在全屏状态下，按F11/ESC可退出全屏
  • 在打包时勾选"全屏"选项，则启动时会自动全屏

3. 项目文件加载失败问题​

问题: 打包后项目有些文件随机出现无法加载的问题

解决方案: 这个问题一般是由于打包的项目过大，exe启动后解压耗时过多，导致浏览器载入文件超时造成的。建议：

  • 打包的文件不要超过1GB
  • 使用安装包的形式进行打包
  • 在高级设置中勾选"提升稳定性"选项

4. 图标制作相关​

推荐方案:

  • 推荐使用png, jpg图片作为图标，软件会自动处理图片, 确保图标可以适配不同的大小
  • 如果需要使用ico格式，建议图标分辨率为256256, 并且包含多个层级(128128, 6464, 3232, 16*16)

5. XP系统兼容性问题​

问题: 在XP上打开exe时会出现"无效的32位应用"的提示

解决方案: 这是由于打包后的exe不支持XP系统。如果需要支持XP可以加群577639123联系群主定制。

6. 内核选择建议​

根据不同场景选择合适的内核：

Chrome内核适用场景:

  • 网站使用了较新的H5/WebGL等技术
  • 需要在不同系统上保持一致的展现效果
  • 对兼容性要求较高的项目

IE内核适用场景:

  • 对打包体积大小敏感的项目
  • 简单的静态页面展示
  • 对新特性要求不高的传统网页

7. 打包大文件注意事项​

当需要打包较大的项目时：

  • 建议使用安装包形式而不是绿色版
  • 可以勾选安装包分包选项
  • 建议在高级设置中勾选"提升稳定性"选项
  • 建议使用Chrome内核以提高稳定性

8. 如何保护打包内容​

为了更好地保护打包内容，建议：

  • 勾选"禁用调试"选项，防止F12调试工具的使用
  • 使用加密设置中的激活码功能
  • 可以设置使用次数或天数限制
  • 建议使用网络验证功能

9. 性能优化建议​

如何提升打包后EXE的运行性能：

  • 不要勾选不必要的功能选项
  • 如果不需要Flash支持，请不要勾选
  • 压缩选项会影响启动速度，请根据需求选择
  • 可以使用缓存机制来提升加载速度

10. 打包后的程序点击关闭按钮无法正常关闭？​

典型现象​

  • 点击右上角关闭按钮无响应 / 需要多次点击才退出
  • 窗口关闭但进程仍残留（任务管理器可见）
  • 托盘或资源占用仍存在，日志未完整落盘

根本原因​

最常见原因是页面中注册了 beforeunload 事件，并通过以下阻塞语句拦截了正常卸载流程：

window.addEventListener('beforeunload', function (e) {
    /*业务逻辑*/
    e.preventDefault();
    e.returnValue = '';
    return '';
});

这些语句会告诉内置浏览器“页面需要阻止退出”，导致外层 EXE 关闭流程被延迟或被阻塞。

  1. 若无需强制提示/确认：删除阻塞卸载的三行代码（preventDefault / returnValue / return）
  2. 若需要退出前执行清理（保存、上报、释放资源）：
    • 保留监听但移除阻塞语句；仅做极短同步操作
    • 或迁移到打包工具提供的 onQuit API
  3. 避免在 beforeunload 中执行长耗时异步任务（可能被强制终止）

使用 onQuit API（推荐）​

window.HTMLPackHelper.onQuit = () => {
    // 你的业务逻辑
    // return false: 处理完成后不关闭程序
    // return true: 处理完成后关闭程序
    return true;
};