金蝶云苍穹自定义控件脚手架

前提

金蝶云苍穹自定义控件脚手架（kdcli）是华创云联(https://hcylsoft.cn)内部使用的脚手架，主要用于创建基于 Vue 和 React 的自定义控件。

说明

• 通过命令行运行脚手架，选择生成vue或者react的自定义控件项目。
• vue默认整合了element-ui,采用webpack5进行构建项目。
• react默认整合了KDesign,采用webpack5进行构建项目。

安装

全局安装脚手架

npm install -g kingdee-cli

创建项目

kdcli create app-name

配置

在src目录里，分为web端和mobile端，isv目录下默认有hcyl目录，根据自己的开发商标识，建立目录，比如：kingdee 在kingdee下，放置各个领域的目录（moudleId），比如：cq。 在cq目录下，放置各个控件的文件夹，文件夹命名使用schemaId。

在build目录里的custom.configInfo.js中，需要根据对应的需要修改client、isv、moduleId的值

在server.js里，配置允许跨域访问的域名、监听端口、静态资源文件夹（需要对nodejs有了解）

打包

命令终端进入项目根目录后，运行npm run dev（开发模式）或者npm run build（生产模式），这个步骤需要有node 如需要打成zip包，需手动将控件目录下的css目录、lang目录、index.js文件、index.js.map文件打在一个zip包里

启动服务

命令终端进入项目根目录，运行nodemon server.js 此功能优化开发过程中出现频繁打zip包的过程

debug调试

在请求头的query部分末尾加上kdcus_cdn=http://localhost:3001，如果有hash，则在hash末尾也加上，就可以加载你本地写的自定义控件的代码，开发过程中无需打包上传，也无需修改代码后重启整个服务，方便快捷。

示例图片