您好,欢迎访问一九零五行业门户网

脚手架也有插件形式!vscode实现脚手架插件

脚手架也有插件形式!下面本篇文章给大家介绍一下 vscode 插件可视化制作和管理脚手架及原理解析,希望对大家有所帮助!
提到脚手架,大家想到的可能就是各种 xxx-cli,本文介绍的是另一种方式:以 vscode 插件的形式实现,提供 web 可视化操作,如下图:
下面介绍如何安装使用,以及实现原理。
安装使用vscode 安装 lowcode 插件,此插件是一个效率工具,脚手架只是其中一个功能,更多功能可以查看文档,这集只讲脚手架相关的。【推荐学习:《vscode入门教程》】
插件安装之后,打开脚手架界面,步骤如下图:
可以直接使用分享的脚手架,勾选选项后直接创建即可:
制作脚手架在模板项目根目录下创建 lowcode.scaffold.config.json 文件,将需要做内容动态替换的文件加上 .ejs 后缀。
ejs 语法:
https://ejs.bootcss.com/
配置
一个完整 lowcode.scaffold.config.json 配置:
{ "formschema": { "schema": { "type": "object", "ui:displaytype": "row", "ui:showdescicon": true, "properties": { "port": { "title": "监听端口", "type": "string", "props": {}, "default": "3000" }, "https": { "title": "https", "type": "boolean", "ui:widget": "switch" }, "lint": { "title": "eslint + prettier", "type": "boolean", "ui:widget": "switch", "default": true }, "noreadme": { "title": "移除readme文件", "type": "boolean", "ui:widget": "switch", "ui:width": "100%", "ui:labelwidth": 0, "ui:hidden": "{{rootvalue.emptyreadme === true}}", "default": false }, "emptyreadme": { "title": "空readme文件", "type": "boolean", "ui:widget": "switch", "ui:hidden": "{{rootvalue.noreadme === true}}" } }, "labelwidth": 120, "displaytype": "row" }, "formdata": { "port": 3000, "https": false, "lint": true, "noreadme": false, "emptyreadme": false } }, "excludecompile": ["codetemplate/", "materials/"], "conditionfiles": { "noreadme": { "value": true, "exclude": ["readme.md.ejs"] }, "lint": { "value": false, "exclude": [".eslintrc.js", ".prettierrc.js"] } }}
formschema:
formschema.schema 为 x-render 表单设计器 导出的的 schema,会根据 schema 构建出表单界面,formschema.formdata 为表单默认数据
创建项目的时候会将表单数据传入 ejs 模板中进行编译。
excludecompile:配置不需要经过 ejs 编译的文件夹或文件。
conditionfiles:根据表单项的值,在创建项目的时候将某些文件夹或文件删除,比如:
"conditionfiles": { "noreadme": { "value": true, "exclude": ["readme.md.ejs"] }, "lint": { "value": false, "exclude": [".eslintrc.js", ".prettierrc.js"] }}
当 lint 这个表单项的值为 false 的时候,配置的文件夹或文件 ".eslintrc.js",".prettierrc.js",将会在创建的项目中排除掉。
本地调试脚手架
参考项目
https://github.com/lowcode-scaffold/lowcode-mock
发布脚手架将脚手架提交到 git 仓库,注意开放项目的公开访问权限。
使用脚手架直接使用 git 仓库地址
注意使用 clone 地址,支持指定分支,比如 -b master https://github.com/lowcode-scaffold/lowcode-mock.git,内部私有仓库也可以使用
分享到模板列表中快速创建
修改 仓库 中 index.json 内容,提交 pr。
实现原理打开 webview 的时候从 cdn 拉取记录了脚手架列表的 json 文件,渲染列表视图。
点击某个脚手架,将脚手架的 git 仓库地址传到插件后台,插件后台根据 git 地址下载模版到临时工作目录,并且读取 lowcode.scaffold.config.json 文件中的 formschema 返回给 webview。
export const downloadscaffoldfromgit = (remote: string) => { fs.removesync(tempdir.scaffold); execa.sync('git', ['clone', ...remote.split(' '), tempdir.scaffold]); fs.removesync(path.join(tempdir.scaffold, '.git')); if ( fs.existssync(path.join(tempdir.scaffold, 'lowcode.scaffold.config.json')) ) { return fs.readjsonsync( path.join(tempdir.scaffold, 'lowcode.scaffold.config.json'), ); } return {};};
webview 拿到 formschema 后弹框渲染动态表单,点提交后将动态表单数据以及生成目录等信息传给插件后台。
插件后台拿到表单数据后,到临时目录中根据 conditionfiles 配置删除掉不需要的文件。然后根据表单数据编译所有 ejs 文件,最后将所有文件拷贝到生成目录。
export const compilescaffold = async (model: any, createdir: string) => { if ( fs.existssync(path.join(tempdir.scaffold, 'lowcode.scaffold.config.json')) ) { const config = fs.readjsonsync( path.join(tempdir.scaffold, 'lowcode.scaffold.config.json'), ); const excludecompile: string[] = config.excludecompile || []; if (config.conditionfiles) { object.keys(model).map((key) => { if ( config.conditionfiles[key] && config.conditionfiles[key].value === model[key] && array.isarray(config.conditionfiles[key].exclude) ) { config.conditionfiles[key].exclude.map((exclude: string) => { fs.removesync(path.join(tempdir.scaffold, exclude)); }); } }); } await renderejstemplates(model, tempdir.scaffold, excludecompile); fs.removesync(path.join(tempdir.scaffold, 'lowcode.scaffold.config.json')); } fs.copysync(tempdir.scaffold, createdir);};
本地调试时,就是在步骤 2 中将选择的文件夹内容或者当前 vscode 打开的项目内容拷贝到临时工作目录。
下集再说插件其他功能,插件源码:https://github.com/lowcoding/lowcode-vscode
原文地址:https://juejin.cn/post/7080787567192309797
作者:若邪
更多关于vscode的相关知识,请访问:vscode教程!!
以上就是脚手架也有插件形式!vscode实现脚手架插件的详细内容。
其它类似信息

推荐信息