NW-Builder 使用指南：构建 NW.js 应用的完整文档

NW-Builder 是一个强大的工具，用于构建和打包基于 NW.js（原 Node-Webkit）的桌面应用程序。本文将详细介绍如何使用 NW-Builder 来构建和打包您的 NW.js 应用程序。

安装 NW-Builder

要开始使用 NW-Builder，首先需要将其安装为项目的开发依赖项。可以通过 npm 或 yarn 进行安装：

npm install nw-builder --save-dev
# 或
yarn add nw-builder -D

基本配置

NW-Builder 提供了多种配置选项，可以通过 JavaScript API 或命令行界面来使用。以下是一个基本的配置示例：

const NwBuilder = require('nw-builder');

const nw = new NwBuilder({
  files: './path/to/your/app/**/**', // 应用程序文件路径
  platforms: ['win32', 'win64', 'osx64', 'linux32', 'linux64'], // 目标平台
  version: '0.45.6', // NW.js 版本
  flavor: 'normal', // 或 'sdk' 用于开发版本
  buildDir: './build', // 输出目录
  cacheDir: './cache', // 缓存目录
  ...
});

构建选项详解

平台选择

NW-Builder 支持多种平台和架构的构建：

• win32: Windows 32位
• win64: Windows 64位
• osx64: macOS 64位
• linux32: Linux 32位
• linux64: Linux 64位

NW.js 版本控制

可以指定特定的 NW.js 版本：

version: '0.45.6' // 精确版本
// 或
version: 'latest' // 最新版本

构建类型

NW-Builder 支持两种构建类型：

• normal: 生产环境构建
• sdk: 包含开发工具的开发版本

高级选项

其他有用的配置选项包括：

• zip: 是否将输出打包为 ZIP 文件
• macIcns: macOS 应用程序图标
• winIco: Windows 应用程序图标
• appName: 应用程序名称
• appVersion: 应用程序版本

执行构建

配置完成后，可以通过调用 build() 方法来执行构建：

nw.build().then(() => {
  console.log('构建完成！');
}).catch((error) => {
  console.error('构建失败:', error);
});

命令行使用

NW-Builder 也提供了命令行界面，可以通过 package.json 中的脚本配置：

{
  "scripts": {
    "build": "nwbuild --platforms win32,win64 --version 0.45.6 ./src"
  }
}

然后运行：

npm run build

构建优化建议

1. 缓存管理：设置合理的 cacheDir 可以加速后续构建过程
2. 平台选择：只构建目标平台以减少构建时间
3. 版本锁定：生产环境应锁定 NW.js 版本以确保稳定性
4. 资源过滤：确保 files 配置只包含必要的应用程序文件

常见问题解决

• 构建失败：检查网络连接，确保能下载 NW.js 二进制文件
• 版本不兼容：确认 NW.js 版本与您的应用程序兼容
• 平台特定问题：某些功能在不同平台上可能有不同表现

通过本文的指南，您应该能够充分利用 NW-Builder 来构建和打包您的 NW.js 应用程序。根据项目需求调整配置选项，可以创建出适合各种平台的桌面应用程序包。