跳到主要内容

README

目录结构

tree -L 3 -d -I 'node_modules|coverage'

.
├── lowcode-comps # 低码组件
│   ├── dist
│   └── comps # 线上官方低码组件库描述
│   ├── scripts # 低码相关命令行脚本
│   │   ├── api-calls
│   │   ├── bin
│   │   ├── cmds
│   │   └── dist
│   └── weda_standard
│   │   └── comps # 组件json描述目录

29 directories

本地开发

主开发流程

完整流程图见mermaid 预发流程图 流程图

  1. 将 weda 源码组件库推送到开发账号, 在 weda-ui 仓库根目录执行
tcb lowcode publish

在控制台上发布新版本,确保组件库生效。

  1. 将 weda_standard 推送到开发账号
  • 在控制台创建名为weda_standard组件库,点进该组件库详情页可以在 url 上获得该组件库的 id, 例如https://console.cloud.tencent.com/lowcode/element/detail/cg-zqkkk2u90lo7 则 id 为cg-zqkkk2u90lo7
  • .env.example复制一份成为.env。根据自己的需求配置 HOST,目标组件库 ID,COOKIE 等环境变量。脚本通过lcap.cloud.tencent.com接口的登录态 cookie 区分账号。 可以通过修改 Host 切换环境,修改 cookie 切换账号。(cookie 可以通过 Chrome 的 Devtool 抓包,进入组件库页面查看 lcap.cloud.tencent.com 的 API 接口的 cookie)
  • 首先应该进入lowcode-comps/scripts 目录下安装依赖npm i 并且执行npm run build构建脚本
  • 构建并且通过.env配置好环境变量后使用 push 命令推送到上面配置的账号上
node bin push
  1. 在开发账号上对组件库进行开发,开发完成完成后使用 pull 命令将更新拉到 weda-ui 仓库
node bin pull

自测体验完成后,提交 mr 合并到 master 分支

命令

下列命令的示例假设$PWD 为lowcode-comps/scripts目录。 options 可以通过WEDA_COMP开头的环境变量配置, 例子可见.env.example

push 命令 将 json 描述推送到开发环境

开发环境一般指自己的账号。 创建 weda 同名源码库,推送上传并发布 weda和 weda_standard 同名组件库。 然后通过

node bin push --src [保存组件 json 的目录] [comGroupId]

例如

node bin push --src ../weda_standard/comps/  cg-z6gz0dc00qew

pull 命令 从开发环境拉取 json 描述

在环境中通过编辑器开发低码组件

node bin pull [comGroupId] -o [保存组件 json 的目录]

例如

node bin pull cg-z6gz0dc00qew -o ../weda_standard/comps

convert 将开发库 weda_standard json 描述与生产库 cloudbase_standard json 描述 互转

node bin convert --destName [compGroupName] --destId [comGroupId] [path 来源] [output 目标目录]

例如 将 cloudbase_standard 中的 json 描述转换到 weda_standard 中

node bin convert --destName weda_standard --destId cg-z6gz0dc00qew ../cloudbase_standard/comps ../weda_standard/comps