polea laya cmd编译工具

介绍

 使用 esbuild 来增量构建 layabox 项目 修改代码后立即就能看到效果 提高开发速度，优化开发体验。

基于一下原因开发了这款工具

• 由于 Laya 官方提供的命里行工具不兼容 node 版本
• 无法忍受 LayaAir 编译一次项目需要等待到50-70s 左右的时间

特性

• 使用 esBuild 加快编译速度
• 高度可定制化（可以用于非 Laya 项目中）
• 开箱即用

---

关于 esBuild

• esbuild 是一个用 Go 语言编写的用于打包，压缩 Javascript 代码的工具库。它最突出的特点就是速度极快，下图是 esbuild 跟 webpack, rollup, Parcel 等打包工具打包效率的一个比较:

  图片取自 esbuild Github 仓库。

  为什么它能做到那么快？

  它是用 Go 语言编写的。 该语言可以编译为本地代码解析，生成最终打包文件和生成 source maps 的操作全部完全并行化，无需昂贵的数据转换，只需很少的几步即可完成所有操作。 该库以提高编译速度为编写代码时的第一原则，并尽量避免不必要的内存分配。 更多详细介绍，详见 Breword 翻译的 esbuild 官方文档;

对比其它工具

工具类型	简介	修改代码后需要等多久才能刷新浏览器并看到修改后的效果	是否支持断点调试	推荐度
layaAir	手动点击编译	一年，很慢	不支持	强烈不推荐
layaair2-cmd	跟第一步差不多，就是加了个自动编译	半年，慢	支持	不推荐
webpack	自动编译，功能强大，但是项目比较大的话还是会很慢	一天，稍快	支持	推荐
本工具	自动构建，不编译，项目再大都没影响	0秒，飞快，切换到浏览器刷新的速度有多快它就有多快	支持	强烈推荐

安装 polea

npm i -g polea

可以使用以下命令查看

polea -h

---

使用 【初始化】

polea init 

命令执行后，会在项目目录下生成 .polea 文件夹

.polea 目录下默认会生成两个 config.*.ts/config.ts 文件

---

使用 【编译、发布】

制定自己的【编译/发布】流程请参考 config.ts和 config.polea.ts 这两个文件

注意 其中 compile编译命令 可以替换成 publish 发布命令

polea compile               //执行的config.ts中的代码 
polea compile -p polea      //执行config.polea.ts中的代码

---

使用 Watch

配置

buildConfig: (params: polea.ConfigCommand) => {
    let { command } = params;
    if (command == "compile") {//polea compile
        return {
            define: { DEBUG: true, RELEASE: false },
            watch: true,//开启监听模式
            output: "./bin",
            plugins: [new polea.ESBundlePlugin({ sourcemap: true })],
        };
    } else if (command == "publish") {//polea publish
        return {
            define: { DEBUG: true, RELEASE: false },
            watch: false,
            output: "./release/" + getversion(),
            plugins: [new polea.ESBundlePlugin({ sourcemap: false, minify: true })],
        };
    }
}

目前只有代码和资源监听两个插件支持,目前发布命令不支持监听模式

• ESBundlePlugin //编译代码插件
• UIPlugin //更新资源插件

插件

内置插件列表

如果需要自定义一个插件请参考.polea/plugins下的插件

插件名	说明
CleanPlugin	清理文件插件
CompressJSPlugin	压缩 js 代码插件
CopyPlugin	拷贝文件插件
ESBundlePlugin	编译代码插件
LayadccPlugin	生成 Layadcc 文件插件
ManifestPlugin	生成版本信息
UIPlugin	导出代码、导出ui、合成图片资源到 bin 目录下面

插件的使用

buildConfig: (params: polea.ConfigCommand) => {
    let { command } = params;
    if (command == "compile") {//polea compile
        return {
            //使用插件
            plugins: [
                new polea.UIPlugin(),//内置插件
                new polea.ESBundlePlugin({ sourcemap: true }),//内置插件
                new polea.CleanPlugin(),//内置插件
                new layadcc(`xxx`),//自定义的插件
            ],
        };
    } else if (command == "publish") {//polea publish
        return {};
    }
}