leeyw-lowcode-code-generator
v1.0.1
Published
Test: 出码引擎 for LowCode Engine
Downloads
2
Readme
出码
所谓出码,即将低代码编排出的 schema 进行解析并转换成最终可执行的代码的过程。本模块提供有 Icejs 和 Rax 两套框架的出码方案,并提供了强大而灵活的扩展机制。
使用方法
1) 通过命令行快速体验
欢迎使用命令行工具快速体验:npx @alilc/lowcode-code-generator -i example-schema.json -o generated -s icejs
--其中 example-schema.json 可以从这里下载
2) 通过设计器插件快速体验
- 安装依赖:
npm install --save @alilc/lowcode-plugin-code-generator
- 注册插件:
import { plugins } from '@alilc/lowcode-engine';
import CodeGenPlugin from '@alilc/lowcode-plugin-code-generator';
// 在你的初始化函数中:
await plugins.register(CodeGenPlugin);
// 如果您不希望自动加上出码按钮,则可以这样注册
await plugins.register(CodeGenPlugin, { disableCodeGenActionBtn: true });
然后运行你的低代码编辑器项目即可 -- 在设计器的右上角会出现一个“出码”按钮,点击即可在浏览器中出码并预览。
3)服务端出码接入
此代码生成器一开始就是为服务端出码设计的,你可以直接这样来在 node.js 环境中使用:
- 安装依赖:
npm install --save @alilc/lowcode-code-generator
- 引入代码生成器:
import CodeGenerator from '@alilc/lowcode-code-generator';
- 创建项目构建器:
const projectBuilder = CodeGenerator.solutions.icejs();
- 生成代码
const project = await projectBuilder.generateProject(
schema, // 编排搭建出来的 schema
);
- 将生成的代码写入到磁盘中(也可以生成一个 zip 包)
// 写入磁盘
await CodeGenerator.publishers.disk().publish({
project, // 上一步生成的 project
outputPath: '/path/to/your/output/dir', // 输出目录
projectSlug: 'your-project-slug', // 项目标识
});
// 写入到 zip 包
await CodeGenerator.publishers.zip().publish({
project, // 上一步生成的 project
outputPath: '/path/to/your/output/dir', // 输出目录
projectSlug: 'your-project-slug', // 项目标识 -- 对应生成 your-project-slug.zip 文件
});
注:一般来说在服务端出码可以跟 github/gitlab, CI 和 CD 流程等一起串起来使用,通常用于优化性能。
4)浏览器中出码接入
随着现在电脑性能和浏览器技术的发展,出码其实已经不必非得在服务端做了,借助于 Web Worker 特性,可以在浏览器中进行出码:
- 安装依赖:
npm install --save @alilc/lowcode-code-generator
- 引入代码生成器:
import * as CodeGenerator from '@alilc/lowcode-code-generator/standalone-loader';
- 【可选】提前初始化代码生成器:
// 提前初始化下,这样后面用的时候更快(这个 init 内部会提前准备好创建 worker 的一些资源)
await CodeGenerator.init();
- 出码
const result = await CodeGenerator.generateCode({
solution: 'icejs', // 出码方案 (目前内置有 icejs 和 rax )
schema, // 编排搭建出来的 schema
});
console.log(result); // 出码结果(默认是递归结构描述的,可以传 flattenResult: true 以生成扁平结构的结果)
注:一般来说在浏览器中出码适合做即时预览功能。
5)自定义出码
前端框架灵活多变,默认内置的出码方案很难满足所有人的需求,好在此代码生成器支持非常灵活的插件机制 -- 欢迎参考 ./src/plugins/xxx 来编写您自己的出码插件,然后参考 ./src/solutions/xxx 将各种插件组合成一套适合您的业务场景的出码方案。
参与共建
欢迎参与共建,如何共建请参阅:./CONTRIBUTING.md