NW-Builder 4.0版本CJS导入方式详解

在NW.js应用开发过程中，NW-Builder是一个非常重要的构建工具，它帮助开发者将NW.js应用打包成可执行文件。随着NW-Builder升级到4.0版本，其API和导入方式都发生了变化，这给从3.x版本迁移过来的开发者带来了一些困惑。

4.0版本的导入方式变化

在NW-Builder 4.0版本中，官方文档提供了CommonJS(CJS)和ES Module(ESM)两种导入方式。其中CJS方式需要使用动态导入语法：

let nwbuild;
import("nw-builder")
  .then((module) => {
    nwbuild = module;
  })
  .catch((error) => {
    console.error(error);
  });

这里有几个关键点需要注意：

1. 导入的模块名称应为"nw-builder"而非"nwbuild"
2. 回调函数参数名称应保持一致，避免出现文档中object/obj不一致的情况
3. 由于是动态导入，需要使用Promise或async/await处理异步逻辑

从3.x到4.0的迁移要点

对于从3.x版本迁移过来的项目，除了导入方式的变化外，配置项也有较大调整：

1. files改为srcDir
2. buildDir改为outDir
3. appName改为app
4. 平台配置从platforms数组改为platform和arch的组合
5. Windows平台下的图标和版本信息配置结构发生了变化

实际应用示例

下面是一个完整的Gulp任务示例，展示了如何在4.0版本中使用NW-Builder：

gulp.task('nwjs', async () => {
    const nwOptions = {
        srcDir: ['./app/**', './package.json'],
        outDir: './releases',
        app: 'myApp',
        version: '0.76.0',
        platform: 'win',
        arch: 'x64',
        mode: "build"
    };

    const { default: nwbuild } = await import('nw-builder');
    return nwbuild(nwOptions).on('log', console.log);
});

常见问题解决

1. 导入失败：确保项目依赖中正确安装了nw-builder@4.0.7或更高版本
2. 配置不生效：检查配置项名称是否使用了4.0版本的命名规范
3. 平台不支持：确认指定的platform和arch组合是否被NW.js支持

通过理解这些变化点，开发者可以更顺利地完成NW-Builder的版本升级，充分利用4.0版本的新特性来构建NW.js应用程序。