在线CAD的SDK如何集成到网页系统-关于MxCad项目二次开发插件集成

前言

1.很多单位拥有着数量庞大的DWG图纸，部门之间传统的图纸管理和沟通，效率较为低下，而将CAD图纸的浏览，编辑，审图，签章等工作集成到自己的网页系统，将会显著提高工作效率和企业的竞争力。

集成到网页系统需要我们在后台服务器部署web cad sdk，部署后的操作界面效果如下:

2.在线CAD功能测试demo：https://demo.mxdraw3d.com:3000/mxcad/

前端项目二次开发插件集成

第一步: 下载MxDraw云图开发包https://www.mxdraw.com/download.html

第二步: 解压打开目录找到MxDrawCloudServer\SRC\TsWeb\public\mxcad 目录所在位置，这里就是该项目的打包后的项目位置。

第三步: 修改配置mxUiConfig.json文件和mxServerConfig.json，如下图：

文件可根据自己的需求去修改一些固定配置。

第四步: 再到plugins目录下创建一个testPlugin.js文件,然后我们可用在对应的config.json文件中配置plugins属性, 新增一个testPlugin字符串。

第五步: 在testPlugin.js 写任意的js代码, 项目都会运行,这个时候你可用访问window属性中的Mx、mxcad、Vue 它们分别是mxdraw、mxcad、vue的默认导出。

具体如何使用mxdraw和mxcad库参考文档:

https://mxcadx.gitee.io/mxdraw_docs/start/abstract.html

https://mxcadx.gitee.io/mxcad_docs/zh/

如果开发的插件比较复杂，需要用到ts

我们专门提供了一个可用调试和打包的完整集成了项目插件的demo。你可用下载它来二次集成开发。

下载地址：https://gitee.com/mxcadx/mxdraw-article/blob/master/MxCad项目二次开发插件集成/MxCADAppVuetify3.zip

下载好后先解压, 有一个dist目录和createPlugin目录， dist表示项目打包后的资源， createPlugin表示二次开发集成的插件项目。

我们命令行先执行cd createPlugin 进入该目录然后运行npm i或者yarn 安装依赖，然后我们就可与直接运行npm run dev 进行调试,如下图：

npm run build 进行打包， 打包后的文件在最开始解压的dist目录下的plugins目录下。

我们可以进入src目录下查看源码, 这个示例是用Vue组件写的一个弹框，然后通过命令调用, 可以在页面中显示的命令输入框中输入MyTestDraw就会弹出对应的弹框，而vue组件是基于dist打包后资源中的vue3, 我们可以通过示例代码了解如何在插件中定义和使用vue组件，如下图：

该项目的electron桌面版本

对应electron版本，前端二次开发的插件项目不变，唯一的区别就算electron版本在window上新增了MxElectronAPI对象, 提供了和主线程通信的能力。

electron 打包后的项目下载:

https://gitee.com/mxcadx/mxdraw-article/blob/master/MxCad项目二次开发插件集成/MxCADAppElectron.zip

同样的下载解压安装依赖electron项目的插件基于vite 打包对应的vite 配置: vite.plugins.config.ts，步骤如下:

1.创建src/plugins 目录， 如果存在则无需创建

2.创建一个插件目录 如testPlugin, 然后在该目录下创建一个index.ts作为该插件入口文件

3.vite.plugins.config.ts 新增插件入口配置pluginEntryFileName: ["plugins/testPlugin/index.ts"]

4.运行命令调试: dev:plugins

5.运行命令打包: build:plugins

6.如果在testPlugin创建preload.ts 并默认导出一个对象，这个对象存放是用来与页面通信的API，这里如果比较难理解可以参考预加载脚本：https://www.electronjs.org/zh/docs/latest/tutorial/tutorial-preload

默认导出的对象就是在通过contextBridge.exposeInMainWorld定义的前端 window.MxElectronAPi.插件目录名称(命名空间)对象，同理preload2d.ts导出的对象会覆盖preload.ts导出对象中属性相同的值,但是preload2d.ts只在显示2d图纸的页面中有效，preload3d.ts与preload2d.ts不同的是它只作用于3d显示页面，而preload.ts则是公共的。

7.plugins可以存在很多插件，它下面的每一个目录都是一个插件，这个插件的目录名就是命名空间名称，前端页面访问的对象也是window.MxElectronAPI.命名空间名称，以下是electron项目中对应目录的描述：

 DEMO源码：

https://gitee.com/mxcadx/mxdraw-article/tree/master/MxCad%E9%A1%B9%E7%9B%AE%E4%BA%8C%E6%AC%A1%E5%BC%80%E5%8F%91%E6%8F%92%E4%BB%B6%E9%9B%86%E6%88%90