从nw-builder v3迁移到v4的注意事项与示例

nw-builder作为NW.js应用程序的构建工具，在版本4中引入了一些重大变更。本文将详细介绍如何正确使用动态导入方式加载nw-builder模块，并分享从v3迁移到v4时的关键修改点。

动态导入的正确方式

在nw-builder v4中，推荐使用ES模块的动态导入语法来加载包。需要注意的是，正确的包名是"nw-builder"而非"nwbuild"。以下是正确的导入方式示例：

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

配置选项的变化

从v3迁移到v4时，配置选项发生了显著变化：

1. files 改为 srcDir
2. buildDir 改为 outDir
3. appName 改为 app
4. 平台相关配置从platforms数组改为单独的platform和arch选项

Windows平台特有配置的变化

Windows平台特有的配置选项也进行了调整：

1. winIco 改为 app.icon
2. winVersionString 下的属性被扁平化到app对象中
3. 属性命名风格从驼峰式改为小写加下划线

构建流程的变化

v4版本中不再需要实例化nwBuilder类，而是直接调用导入的函数：

// v3方式
const nw = new nwBuilder(options).on('log', console.log);
return nw.build();

// v4方式
return nwbuild(options).on('log', console.log);

完整迁移示例

以下是一个完整的从v3迁移到v4的示例：

gulp.task('nwjs', async () => {
    const nwOptions = {
        srcDir: ['./app/**', './package.json', './README.md', './node_modules/**'],
        outDir: releasesDir,
        app: {
            name: pkJson.name,
            version: pkJson.version
        },
        version: nwVersion,
        zip: false,
        flavor: flavor,
        mode: "build",
        platform: "osx",
        arch: "x64",
    };

    if (currentPlatform().indexOf('win') !== -1) {
        nwOptions.app.icon = pkJson.icon;
        nwOptions.app.comments = pkJson.description;
        nwOptions.app.company = pkJson.homepage;
        nwOptions.app.file_description = pkJson.releaseName;
        nwOptions.app.file_version = pkJson.version;
        nwOptions.app.internal_name = pkJson.name;
        nwOptions.app.original_filename = pkJson.name + '.exe';
        nwOptions.app.product_name = pkJson.releaseName;
        nwOptions.app.product_version = pkJson.version;
    }

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

通过以上调整，开发者可以顺利将项目从nw-builder v3迁移到v4，享受新版本带来的改进和优化。