TinyEngine 开源低代码引擎首次直播答疑Q&A合集

前言

10月27日晚8点，OpenTiny 社区开启了 TinyEngine 开源低代码引擎首次答疑直播，本次直播我们通过收集开发者诉求，精心策划和组织了内容，希望提供给大家最明确和清晰的答疑方式。这是 TinyEngine 低代码引擎直播计划的开端，也是打开了 TinyEngine 低代码引擎与开发者沟通交流的新途径。

在本次直播活动中，我们为大家介绍了 TinyEngine 低代码引擎——使能开发者定制低代码平台。并就其基础功能类、代码原理解读类、功能增强类等问题都进入了深入的探讨和答疑。现在，我们梳理了本次直播的关键内容。

TinyEngine 简介

低代码引擎使能开发者定制低代码平台。它是低代码平台的底座，提供可视化搭建页面等基础能力，既可以通过线上搭配组合，也可以通过下载源码进行二次开发，实时定制出自己的低代码平台。适用于多场景的低代码平台开发，如：资源编排、服务端渲染、模型驱动、移动端、大屏端、页面编排等。

核心亮点：

• 可以定制开发低代码平台: 支持在线实时构建,支持二次开发或被集成
• 支持生成源码部署: 直接生成可部署的源码,运行时无需引擎支撑
• 开放协议接口：允许接入第三方组件，允许定制扩展插件
• 支持高低混合开发：支持高代码与低代码，混合开发部署应用
• 支持 AI 辅助开发：平台接入AI 大模型能力，辅助开发者构建应用

Q&A合集

基础功能使用类：

问题1：如何使用第三方组件库？

答：详情可以查看官网使用手册

问题2：如何使用插槽？

答：详情可以查看官网使用手册

问题3：通过 TinyEngine 低代码引擎生成代码到本地时，如何将生成的源码页面独立放置在自己的项目中，提供example?

当前我们的出码结果依赖官方出码模板，暂时无法放置在自己项目中独立运行

第一步：下载 https://github.com/opentiny/tiny-engine-generate-preview 工程，解压

第二步：将代码下载到解压好的文件夹中（提示选择文件夹的时候，选择我们解压出来的文件夹）

第三步：用代码编辑器打开文件夹，确认出码结果，安装依赖并运行 npm run dev 启动服务，查看效果

后续相关的规划：

• 支持开发插件，自定义出码结果
• 支持自定义工程模板，结合自定义出码结果，可以无缝在自身项目中运行

问题4：怎样在 TinyEngine 低代码引擎中扩展左侧组件，比如创建用户、单位选择。在 form 表单里面使用，拖入这2个控件，可以弹出 dialog 框选择用户和单位，点击确定后回填到表单上 input 框上？

答：如果是想从零搭建业务组件，可以查看官方的文档教程尝试一步一步搭建（目前使用手册已更新）

如果是已有的业务组件，可以尝试通过导入第三方组件库的方式导入到左侧物料中。

问题5：分析下 TinyEngine 低代码引擎中左侧组件、中间区域渲染和右侧组件属性的代码在整体上协调一致的思路？

答：先简要介绍一下我们工程中主要的 package：

packages
  |_ canvas  负责中间画布渲染
  |_ common  公共的组件以及 metaComponent 
  |_ controller  公共逻辑控制层
  |_ design-core 总入口
  |_ http  负责 http 相关请求
  |_ i18n lowcode-i18n 包裹层
  |_ plugins  左侧面板相关插件
  |_ settings 右侧设置面板相关组件
  |_ svgs svg 封装组件
  |_ theme  主题相关样式
  |_ toolbars 顶部工具栏相关 package
  |_ utils 公共utils
  |_ vue-generator 出码package
  |_ webcomponent webcomponent 封装

区域大致职责划分：

• 左侧面板相关的范围：负责设置一些应用状态、页面状态、以及逻辑的控制、编写
• 中间画布：负责视图层的编排
• 右侧属性面板：负责视图层的属性控制、样式精细编排、事件绑定等属性相关

主要的功能入口：

1、资源请求

// packages/design-core/src/App.vue
// 这里发起请求物料、请求数据源、请求页面等相关资源请求，很关键
useResource().fetchResource()

2、画布渲染相关入口

packages
  |_ canvas
    |_ src
      |_ components
        |_ render
          |_ runner.js # 用于画布相关的资源请求，预设
          |_ RenderMain.js # 画布渲染的入口，同时也暴露了许多 api 供修改 schema
          |_ render.js # RenderMain.js 会调用该文件的 renderer 方法，递归渲染 schema

3、画布选中后，如何关联渲染右侧属性面板？

// DesignCanvas.vue

// 画布中节点选中后，会触发该方法
const nodeSelected = (node, parent, type) => {
  const { toolbars } = useLayout().layoutState
  if (type !== 'clickTree') {
    useLayout().closePlugin()
  }
  // 动态计算该方法需要渲染的 属性面板
  useProperties().getProps(node, parent)
  // 设置当前 schema
  useCanvas().setCurrentSchema(node)
  footData.value = getNodePath(node?.id)
  toolbars.visiblePopover = false
}

// settings/props/src/Main.vue
<template>
<!-- 在属性面板渲染设置属性的入口 -->>
<config-render :data="properties">
  <template #prefix="{ data }">
    <block-link-field v-if="isBlock" :data="data"></block-link-field>
  </template>
</config-render>
</template>

<script>
// 选中之后，经过 getProps 的计算，我们会得到 properties，渲染在属性面板
const { properties } = useProperty({ pageState })
</script>

上面就是一些简单的入口简介，后续，我们会增加更多详细的架构原理、功能设计相关的文档，敬请期待

问题6：TinyEngine 低代码引擎是否提供排版组件，怎么实现灵活排版？

答：我们目前有内置的排版组件——行列容器，可以通过简单的剪切方式实现轻松的 flex 布局。

问题7：在使用 TinyEngine 低代码引擎时，组件内的静态资源（图片或者音频）如何引用？

答：这个问题要分多种情况讨论，

设计器开发： 可以拉下来源代码，按照原来静态资源图片等分类，放置进去要用的图片，在开发设计器的时候可以直接使用。

页面运行态： 可以通过 标签选中你要的静态资源，这部分的逻辑完全取决于用户

页面设计态： 低代码引擎在开源之前是有这样的功能的，但是为了开源的合规，屏蔽了该功能。因为在设计态想用到静态资源的话，要选中静态资源，并上传到公司的文件管理系统，然后文件系统返回静态资源地址，然后再展示在画布中。如果用户想要这样的功能，只需要开发一个文件上传按钮，并把上传的内容放置用户的文件管理系统。

问题8：修改 TinyEngine 低代码引擎的物料描述文件 bundle.json 之后，无变化是什么原因？

答：可以关注一下以下 bundle.json 这个文件的设置是否正确，尤其是 widget.component 这个字段

以下为 bundle.json 这个文件的节选：

{ "property": "text",
    "label": {
      "text": {
        "zh_CN": "按钮名称",
        "en_US": "Button Name"
       }
    },
    "required": true,
     "readOnly": false,
     "disabled": false,
     "cols": 12,
     "widget": {
       "component": "MetaBindI18n",
       "props": {}
      },
     "description": {
         "zh_CN": "按钮名称",
         "en_US": "Name of the button."
       }
   }

问题9：在使用 TinyEngine 低代码引擎后，组件之间应该如何联动？

答：实现的方式是多种的，

方式一：假如 A（输入框）与 B（显示框）联动，那么可以给 A 绑定一个 change 事件，直接影响 B的显示

方式二：给 B 绑定一个值，通过影响 B 的值，从而影响 B 的显示。

方式三：通过 watch 监听

---

除了以上基础功能及代码原理分析的解答，部分开发者对于功能增强拓展这部分的内容也是十分关注

问题1：如何将 TinyEngine 低代码引擎项目集成到 .net 项目中？

答：原来的.net 系统可以继续独立运行，当需要跳转到低代码系统时候。从原来的.net系统带出关键参数。如 projectId, itemId, processId 等，通过URL的传参形式：https://xxxxxxxxxxx?projectId=1111&itemId=2222222&processId=33333333。 跳转到低代码系统后，在代码系统初始化时候获取URL的参数，通过服务端API接口获取到相应的流程、页面、物料等等信息。通过低代码系统搭建页面会产生schema或者源代码，在点击保存按钮的时候可以把想要的产物保存回来原来的.net系统中。

问题2：Java 后端开源的规划？

答：目前服务端有两套源代码，一套技术栈是 node.js ，一套技术栈是 Java。因为要从公司流程流程审批、技术评估还有后面的迭代演进等维度考虑，目前还不知最终会开源哪种技术栈的服务端。大家敬请期待12月30号左右的公告

问题3：TinyEngine 低代码引擎是否会增加 typescript 支持？

答：目前暂不支持，后续有在规划增加 typescript 的支持，大家敬请期待

问题4：TinyEngine 低代码引擎是否提供商业版本或者商业上的技术支持？

答：目前只有一个开源版本的代码，没有商业版本。至于商业技术上的支持，可以找到 OpenTiny 的小助手沟通，详细沟通一下贵司具体需要的商业支持。

问题5：后续是否会继续迭代 AI 能力？

答：AI 能力目前已经在 TinyEngine 官网部署，当前采用的大模型是文心一言，通过 AI生成代码->生成 AST->页面 schema->展示在页面->下载源代码 ，后续会切回华为的盘古大模型。现在 AI 能力的取决于文心一言生成的代码。同时我们也通过数据和资源的不断投入在持续训练我们的 AI 能力，大家敬请期待 AI 能力的持续迭代。

问题6：TinyEngine 低代码引擎是否支持 nuxt.js 作为后端的开发？

答：后端的开发与技术栈无关，是可以采用任意的技术栈的。我们提供了所有后端接口的文档，只需要按照设计器的文档来，给出对应接口的出入参即可。

问题7：目前 TinyEngine 低代码引擎的物料平台是否会开源？

答：TinyEngine 目前是用到的物料是已开源的 TinyVue 组件库，欢迎大家使用~

关于 OpenTiny

OpenTiny 是一套企业级 Web 前端开发解决方案，提供跨端、跨框架的UI组件库，适配 PC 端 / 移动端等多端，支持 Vue2 / Vue3 / Angular 多技术栈，拥有灵活扩展的低代码引擎，包含主题配置系统 / 中后台模板 / CLI 命令行等丰富的效率提升工具，可帮助开发者高效开发 Web 应用。

---

欢迎加入 OpenTiny 开源社区。添加微信小助手：opentiny-official 一起参与交流前端技术～

OpenTiny 官网：https://opentiny.design/

OpenTiny 代码仓库：https://github.com/opentiny/

TinyVue 源码：https://github.com/opentiny/tiny-vue

TinyEngine 源码： https://github.com/opentiny/tiny-engine

欢迎进入代码仓库 StarTinyEngine、TinyVue、TinyNG、TinyCLI~

如果你也想要共建，可以进入代码仓库，找到 good first issue标签，一起参与开源贡献~