@felce/lowcode-engine v1.4.1

前言

本工程 fork 于alibaba/lowcode-engine （2024 年 9 月 6 日 v1.3.2）。

由于原工程 V1 确定不再进行社区开源维护，V2 版没有确切计划。因此诞生了本项目，期望继续开源维护。

当然，自此开始相关设计也会完全独立，与原工程 V2 的设计不相关联，如果期望后续能继续走原工程 V2 路线，请慎重选择本项目。

思想变化

本项目将转变部分思路，舍弃部分外围的功能开发，以提供核心低码功能为主，做纯粹低代码内核。如 workspace 等模块将降低优先级。

更多的内部模块将转移到 plugins 中（未完成），作为默认插件提供，而不是封装到内部。整体向更开放的开发方向转变。

同时，针对各子模块，将通过 shell 模块开放更多的接口，以支持更多定制化需求。

最后，将酌情升级工具链，计划切换到更新的打包工具等，不过优先级会比较低。

计划

目前工程刚 fork，主要工作是进行命名空间的替换，为避免与原工程命名冲突，本仓库命名空间调整为@felce，取自 lowcode-engine 的缩写。 当前主要任务：

• 主要工程的命名空间调整
• 修复积压问题

联系方式

微信搜索 kunsile-002 添加我的微信，或者扫码加群：

一套面向扩展设计的企业级低代码技术体系

简体中文 | English

✨ 特性

• 🌈 提炼自企业级低代码平台的面向扩展设计的内核引擎，奉行最小内核，最强生态的设计理念
• 📦 开箱即用的高质量生态元素，包括 物料体系、设置器、插件 等
• ⚙️ 完善的工具链，支持 物料体系、设置器、插件 等生态元素的全链路研发周期
• 🔌 强大的扩展能力，已支撑 100+ 个各种类型低代码平台
• 🛡 使用 TypeScript 开发，提供完整的类型定义文件

🎯 兼容环境

• 现代浏览器（Chrome >= 80, Edge >= 80, last 2 safari versions, last 2 firefox versions）

📚 引擎协议

引擎完整实现了《低代码引擎搭建协议规范》和《低代码引擎物料协议规范》，协议栈是低代码领域的物料能否流通的关键部分。

🌰 使用示例

npm install @felce/lowcode-engine --save-dev

TIPS：仅支持 cdn 方式引入，npm 包用于提供 typings 等代码提示能力

import { init, skeleton } from '@felce/lowcode-engine';

skeleton.add({
  area: 'topArea',
  type: 'Widget',
  name: 'logo',
  content: YourFantasticLogo,
  contentProps: {
    logo: 'https://img.alicdn.com/tfs/TB1_SocGkT2gK0jSZFkXXcIQFXa-66-66.png',
    href: '/',
  },
  props: {
    align: 'left',
    width: 100,
  },
});

init(document.getElementById('lce'));

工程化配置：

{
  "externals": {
    "@felce/lowcode-engine": "var window.AliLowCodeEngine",
    "@felce/lowcode-engine-ext": "var window.AliLowCodeEngineExt"
  }
}

cdn 可选方式：

unpkg

https://unpkg.com/@felce/lowcode-engine@1.4.0/dist/js/engine-core.js
https://unpkg.com/@felce/lowcode-react-simulator-renderer@1.4.0/dist/js/react-simulator-renderer.js

npmmirror

https://registry.npmmirror.com/@felce/lowcode-engine/1.4.0/files/dist/js/engine-core.js
https://registry.npmmirror.com/@felce/lowcode-react-simulator-renderer/1.4.0/files/dist/js/react-simulator-renderer.js

jsdelivr

https://cdn.jsdelivr.net/npm/@felce/lowcode-engine@1.4.0/dist/js/engine-core.js
https://cdn.jsdelivr.net/npm/@felce/lowcode-react-simulator-renderer@1.4.0/dist/js/react-simulator-renderer.js

使用自有 cdn

将源码中 packages/engine/dist 和 packages/react-simulator-renderer/dist 下的文件传至你的 cdn 提供商

🔗 相关链接

• 官网首页
• Demo 马上玩 | 引擎 Demo 仓库
• 阿里物料
• 官方设置器（setter）
• 官方插件（plugin）
• 生态元素（物料、setter、插件）工具链
• 用户文档
• API

awesome-lowcode-engine 中包含了一系列围绕引擎建设的工具、解决方案等，如果你有类似的解决方案或者工具，欢迎提 PR 到该仓库，让更多人了解到

💻 本地调试

$ git clone git@github.com:fe-lce/lowcode-engine.git
$ cd lowcode-engine
$ npm install
$ npm run setup
$ npm start

📢 npm 访问速度较慢，建议使用 cnpm 或者指定镜像 registry。

📢 windows 环境必须使用 WSL，其他终端不保证能正常运行

lowcode-engine 启动后，提供了几个 umd 文件，可以结合 lowcode-demo 项目做调试，文件代理规则参考这里。

🤝 参与共建

请先阅读：

1. 如何配置引擎调试环境？
2. 关于引擎的研发协作流程
3. 引擎的工程化配置

强烈推荐阅读 《提问的智慧》、《如何向开源社区提问题》 和 《如何有效地报告 Bug》、《如何向开源项目提交无法解答的问题》，更好的问题更容易获得帮助。（此段参考 antd）

关于提交 PR： 请将目标合并分支设置为 develop，不要指定 main 分支，在发布正式版本后，develop 分支将会合入 main 分支。

❤️ 致谢

感谢所有为引擎项目贡献力量的同学们~