CrownCAD基礎(chǔ)教程-二次開發(fā)2二次開發(fā)概要在線開發(fā)模式二次開發(fā)插件綜合實(shí)例目錄CONTENTS010203043二次開發(fā)概述01二次開發(fā)概述01二次開發(fā)概要4CrownCAD二次開發(fā)支持在線開發(fā)模式、插件開發(fā)模式和SDK開發(fā)包，用戶通過二次開發(fā)可以實(shí)現(xiàn)平臺未提供的功能，提高設(shè)計(jì)效率。同時(shí)，能夠與第三方系統(tǒng)進(jìn)行集成。5在線開發(fā)模式02程序管理代碼編輯器語法規(guī)則02在線開發(fā)模式-程序管理6與傳統(tǒng)CAD二次開發(fā)方式不同，通過CrownCAD在線二次開發(fā)，用戶無需費(fèi)力搭建開發(fā)環(huán)境，可以自動(dòng)化執(zhí)行任務(wù)，完成手動(dòng)交互式建模難以實(shí)現(xiàn)的復(fù)雜操作；可以引入數(shù)學(xué)函數(shù)和幾何運(yùn)算，支持更精確的線條擬合；可以參數(shù)式生成模型，將程序做成帶輸入的命令，分享給平臺其他用戶使用；可以靈活組織API，實(shí)現(xiàn)系統(tǒng)未提供的建模功能。新建程序單擊側(cè)邊欄進(jìn)入程序管理頁面，再次單擊“程序列表＋”進(jìn)入創(chuàng)建程序頁面，可選擇類型為“程序”“文件夾”“模塊”。02在線開發(fā)模式-程序管理7程序列表程序類型包括“我的程序”“發(fā)布程序”“我的發(fā)布”“與我分享”“收藏程序”?！拔业某绦颉边x項(xiàng)：查看當(dāng)前用戶創(chuàng)建的所有程序?！鞍l(fā)布程序”選項(xiàng)：查看平臺其他用戶已公開發(fā)布的程序?！拔业陌l(fā)布”選項(xiàng)：查看當(dāng)前用戶的已發(fā)布程序?！芭c我分享”選項(xiàng)：查看平臺其他用戶分享給當(dāng)前用戶的已發(fā)布程序?！笆詹爻绦颉边x項(xiàng)：查看當(dāng)前用戶的收藏程序。02在線開發(fā)模式-代碼編輯器8雙擊程序即可進(jìn)入在線二次開發(fā)代碼編輯器界面。02在線開發(fā)模式-代碼編輯器9工具欄工具欄用于展示在線二次開發(fā)編輯器支持的功能。新建

單擊“新建”進(jìn)入創(chuàng)建程序界面，可以自定義程序名稱和所屬文件夾。02在線開發(fā)模式-代碼編輯器10工具欄圖片資源

單擊“新建”下拉框顯示“圖片資源”按鈕，單擊進(jìn)入圖片管理界面，通過“上傳圖片”可將待使用的圖片上傳；單擊“已上傳圖片”可以查看已上傳圖片列表，單擊

可復(fù)制圖片ID，在程序中進(jìn)行引用。02在線開發(fā)模式-代碼編輯器11工具欄API列表

展示當(dāng)前版本支持的接口，可對接口名和參數(shù)進(jìn)行查看，支持接口名的搜索，單擊接口可將接口快速補(bǔ)全到代碼編輯區(qū)域中。02在線開發(fā)模式-代碼編輯器12工具欄執(zhí)行(覆蓋)

以覆蓋模式執(zhí)行當(dāng)前程序，程序運(yùn)行結(jié)果會(huì)將當(dāng)前文檔中的模型數(shù)據(jù)進(jìn)行覆蓋。執(zhí)行(追加)

以追加模式執(zhí)行當(dāng)前程序，程序運(yùn)行結(jié)果不會(huì)覆蓋當(dāng)前文檔的模型數(shù)據(jù)。撤銷執(zhí)行

撤銷上一步程序執(zhí)行的結(jié)果，將文檔模型回退到程序未執(zhí)行前的狀態(tài)。發(fā)布預(yù)覽

程序的發(fā)布預(yù)覽是指將程序以命令對話框的形式進(jìn)行預(yù)覽。單擊“發(fā)布預(yù)覽”可查看對話框的界面。02在線開發(fā)模式-代碼編輯器13工具欄發(fā)布

將當(dāng)前程序以命令對話框的形式進(jìn)行展示，單擊“發(fā)布”顯示發(fā)布管理界面。錄制宏

單擊“錄制宏”進(jìn)入腳本錄制狀態(tài)，會(huì)將錄制期間使用的命令轉(zhuǎn)為程序?qū)崟r(shí)補(bǔ)全到代碼編輯區(qū)域中。02在線開發(fā)模式-代碼編輯器14代碼編輯區(qū)在代碼編輯區(qū)編寫程序，支持接口的提示、代碼的自動(dòng)補(bǔ)全、代碼懸停提示、關(guān)鍵字高亮、右鍵菜單等便捷功能。

接口提示

輸入關(guān)鍵字，編輯器會(huì)顯示包含關(guān)鍵字的接口列表，藍(lán)色區(qū)域?yàn)樗x接口，單擊可切換所選接口。

代碼自動(dòng)補(bǔ)全

在接口提示列表單擊鍵盤<接口或<接口切換所選的接口，單擊<Enter>鍵可將所選接口補(bǔ)全到代碼編輯器中。

代碼懸停提示

將鼠標(biāo)移動(dòng)到接口上，編輯器會(huì)顯示接口的描述信息，可根據(jù)描述信息修改接口傳入的參數(shù)。02在線開發(fā)模式-代碼編輯器15編輯器控制臺編輯器控制臺用于程序的打印信息和報(bào)錯(cuò)信息的展示，并且支持代碼塊的執(zhí)行。信息展示

單擊執(zhí)行程序后，程序內(nèi)的打印信息和報(bào)錯(cuò)信息將顯示在控制臺中，包含展示的信息和對應(yīng)的代碼行號，單擊“行號”可快速的定位到程序?qū)?yīng)的位置，單擊可清空控制臺的內(nèi)容。代碼執(zhí)行

單擊控制臺藍(lán)色區(qū)域，輸入代碼塊，單擊<Ctrl>+<Enter>鍵執(zhí)行。02在線開發(fā)模式-語法規(guī)則16基礎(chǔ)數(shù)據(jù)類型類型標(biāo)識示例復(fù)制方式整數(shù)Integer123值復(fù)制浮點(diǎn)型Number123.456or123值復(fù)制布爾類型Booleantrueorfalse值復(fù)制字符串String“string”or‘string’值復(fù)制數(shù)組List[]or[123]引用復(fù)制字典類型KVObject{}or{temp1：123，“temp2”：456}引用復(fù)制02在線開發(fā)模式-語法規(guī)則17特殊數(shù)據(jù)類型類型標(biāo)識示例復(fù)制方式點(diǎn)PointnewPoint（x，y，z）；//三維點(diǎn)newPoint（x，y）；//二維點(diǎn)值復(fù)制方向DirectionnewDirection（lineId）；//通過直線Id創(chuàng)建newDirection（pnt1，pnt2）；//通過兩點(diǎn)創(chuàng)建值復(fù)制軸AxisnewAxis（lineId）；//通過直線Id創(chuàng)建newAxis（pnt1，pnt2）；//通過兩點(diǎn)創(chuàng)建值復(fù)制變量VariablenewVariable（100）；//通過常量創(chuàng)建newVariable（‘varRef’）；//通過變量名創(chuàng)建值復(fù)制02在線開發(fā)模式-語法規(guī)則18Enum數(shù)據(jù)類型實(shí)體類型元素類型文檔類型變量類型元素SolidSketchSurfaceCurveDatumPlaneDatumLine含義三維體草圖三維曲面三維曲線基準(zhǔn)面基準(zhǔn)線元素VertexEdgeFacePointDimensionCurveSurface含義頂點(diǎn)邊面點(diǎn)約束曲線曲面元素PartAssemblyDrawing含義零件裝配工程圖元素LengthAngleNumber含義長度角度數(shù)值02在線開發(fā)模式-語法規(guī)則19Enum數(shù)據(jù)類型變量單位拾取元素類型元素mmcmmdegreeradiannumber含義頂點(diǎn)邊面點(diǎn)約束曲線變量類型LengthLengthLengthAngleAngleNumber元素InstanceFeatureSolidShellSketchDatumPlane含義裝配實(shí)例特征實(shí)體三維曲面草圖基準(zhǔn)面元素DatumLineSurfaceFaceCurveEdgeVertex含義基準(zhǔn)線平面面曲線邊線頂點(diǎn)元素OriginPointPointOnCurvePoint含義坐標(biāo)原點(diǎn)線上一點(diǎn)草圖點(diǎn)20二次開發(fā)插件03二次開發(fā)概述插件管理我的創(chuàng)建03二次開發(fā)插件21CrownCAD平臺支持插件開發(fā)模式，支持用戶在平臺上開發(fā)擴(kuò)展功能。相對于在線二次開發(fā)模式，插件開發(fā)可提供更高的靈活度和能力范疇，支持做更復(fù)雜的應(yīng)用功能。用戶可以使用HTML、CSS、Vue.js、Javascript、Java等語言開發(fā)插件應(yīng)用，也可以有自己的服務(wù)端做數(shù)據(jù)管理。用戶開發(fā)的插件代碼自己保管，與平臺是松耦合的。開發(fā)完成后，用戶可以將插件集成到CrownCAD平臺上，通過IFrame的形式與CrownCAD主應(yīng)用共存。CrownCAD平臺向用戶提供SDK開發(fā)包，方便用戶進(jìn)行插件的開發(fā)。通過SDK開發(fā)包，用戶可以進(jìn)行CrownCAD事件的訂閱、建模接口的調(diào)用并結(jié)合用戶已有的數(shù)據(jù)開發(fā)插件，將插件應(yīng)用集成到CrownCAD平臺進(jìn)行使用，支持用戶創(chuàng)建單一插件作為命令使用，同時(shí)也支持創(chuàng)建多個(gè)插件作為模塊功能使用。03二次開發(fā)插件-插件管理22單擊側(cè)邊欄

進(jìn)入二次開發(fā)管理頁面，單擊“插件列表＋”進(jìn)入插件管理界面。單擊“下載開發(fā)包”下載插件開發(fā)包，將開發(fā)包內(nèi)的crowncad-plugin-sdk-xx.xx.xx.js文件引入到插件應(yīng)用項(xiàng)目中，即可調(diào)用插件提供的接口，開發(fā)插件應(yīng)用。03二次開發(fā)插件-我的創(chuàng)建23單擊“我的創(chuàng)建”，插件列表顯示由用戶創(chuàng)建的插件。單擊“新建插件”，進(jìn)入新建插件界面。新建插件03二次開發(fā)插件-我的創(chuàng)建24“啟動(dòng)位置”選項(xiàng)：定義插件啟動(dòng)后在CrownCAD平臺顯示的位置。勾選“工具欄”，插件將在命令工具欄顯示。勾選“側(cè)邊欄”，插件將在工作空間右側(cè)側(cè)邊欄顯示?！癠RL”輸入框：插件應(yīng)用開發(fā)完成后需要部署上線，此處填寫能夠訪問到插件的地址?！斑m用文檔”選項(xiàng)：定義插件在哪些文檔中顯示。新建插件03二次開發(fā)插件-我的創(chuàng)建25單擊“新建插件集”顯示創(chuàng)建插件集界面，插件集會(huì)作為一個(gè)模塊顯示在平臺中，模塊名為插件集名稱，插件集可以包含多個(gè)子插件，單擊“添加子插件”即可新增子插件。新建插件集03二次開發(fā)插件-我的創(chuàng)建26插件需要發(fā)布之后才能夠集成到CrownCAD平臺使用。在“我的創(chuàng)建”插件列表界面，選擇要發(fā)布的插件，單擊插件右側(cè)按鈕

顯示下拉框，單擊“發(fā)布”按鈕進(jìn)入發(fā)布界面，輸入版本名稱和版本描述信息進(jìn)行插件發(fā)布；插件發(fā)布成功后，插件會(huì)顯示已發(fā)布標(biāo)志，同時(shí)已發(fā)布的插件會(huì)展示在“已發(fā)布插件”插件列表。發(fā)布03二次開發(fā)插件-我的創(chuàng)建27插件發(fā)布成功后，可以將插件分享給平臺其他用戶