#
CrownCAD二次开发


# 概述

  通过CrownCAD二次开发,用户可以自动化执行任务,完成手动交互式建模难以实现的复杂操作;引入数学函数和几何运算,支持更精确的线条拟合;参数式生成模型,将程序做成带输入的命令,分享给平台其他用户使用;灵活组织API,实现系统默认未提供的建模功能;还可以通过查询命令,了解探索内核工作机制。
  与传统CAD二次开发方式不同,CrownCAD是B/S架构的产品,基于平台的二次开发充分考虑了B/S架构的特性,具有下述特点。

  1. 用户基于平台在线开发,快速开始,无需费力搭建开发环境。
  2. 使用简单,没有很多编程技能要求。平台支持的语言形式与javascript/java很接近,尽量减少额外学习成本。在语言机制上,尽量减少对用户的干扰,使用户能专注于造型逻辑和API调用,而非纠结于语言规则和形式。平台会支持提升开发体验功能,包括指令列表供选择,代码片段自动填充等辅助开发功能。
  3. 开发过程中,系统能够同时为很多用户测试、使用。无需编译打包,无需重启服务器。
  4. 可以将程序通过发布程序的方式分享给平台上的其它用户;发布的程序的为独立版本,修改原始程序不会影响发布程序,支持发布程序历史版本回退。
  5. 执行安全。代码在系统指定环境中执行,没有暴露系统内部如何工作;没有修改系统内部组件。语言范畴是系统定义可控的,支持语法检查、语义检查、运行时检查等。
  6. 理论上可以使用所有开放的内核API。
  7. 支持对多个文档的操作,批量处理等。

# 开发流程

  CrownCAD提供便捷的开发流程:“新建程序——编辑代码——保存程序——发布程序”,整个流程全部可通过简洁交互实现。

  1. 新建: 新建程序。
  • 用户可点击文档右侧的“程序列表”,点击“+”,即可进入开发UI界面。

  • 开发UI界面中,点击“新建”,可提示是否保存当前程序,选择后可直接新建程序。下图为编辑器工具栏。

  1. 输入代码: 用户可在UI界面的“代码编辑器”区域输入代码。
  2. 保存: 将已输入的代码进行保存。
  3. 发布: 已保存的程序可发布,生成命令;可在其他文档中重复使用该发布的程序。

# 开发环境

  CrownCAD二次开发平台的UI界面如下图所示,主要包括工具栏、代码编辑器、控制台console。

# 工具栏

  CrownCAD二次开发平台的工具栏提供二次开发编写程序相关的命令。

  • 新建:新建程序。
  • API列表:用户通过选择API快速生成API对应的代码块。
  • 执行(覆盖):执行程序后,生成模型覆盖当前界面的模型。
  • 执行(追加):执行程序后,生成的模型在当前界面的模型基础上添加,原模型仍显示。
  • 保存:保存已输入代码,后续可继续在此基础上编辑。
  • 格式化:一键格式化代码,保证代码格式的规范性。
  • 发布预览:显示发布后的执行状态,测试UI的正确性。
  • 发布:发布程序,已发布程序在“发布程序”中查看,已发布的程序相当于一个命令,可直接应用。

# 代码编辑器

  代码编辑器是二次开发编写代码的核心区域,支持语法高亮,支持格式化,具有代码自动提示、代码折叠等特点。

  • 丰富的自动填充功能,自动填充指令/语句,用户定义变量和函数等。
  • 代码悬停提示。鼠标高亮函数API可以提示参数类型,输入条件等信息。

# 控制台console

  控制台console显示执行过程中产生的各种信息,支持追加输出、清空。如:Print()