pol

polea

laya cmd 命令行编译工具;提高 Laya项目的编译速度;解决Layaair cmd和 Layaair-cmd2无法兼容 node 高低版本的问题。

Showing:

Popularity

Downloads/wk

6

GitHub Stars

7

Maintenance

Last Commit

25d ago

Contributors

4

Package

Dependencies

25

License

ISC

Type Definitions

Tree-Shakeable

No?

Categories

Readme

polea laya cmd编译工具

介绍

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

  • 由于 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 目录下面

Rate & Review

Great Documentation0
Easy to Use0
Performant0
Highly Customizable0
Bleeding Edge0
Responsive Maintainers0
Poor Documentation0
Hard to Use0
Slow0
Buggy0
Abandoned0
Unwelcoming Community0
100