组件开发指南

面向结构工程师的二次开发入门指南。从安装软件到发布组件，一步步带你走通全流程。

---

前言：你能用 LoongCAD 组件做什么？

LoongCAD（也称 LoongSTC）是一款钢结构深化设计软件。它的"组件"机制允许你用 C# 编写自定义节点——比如一个"主次梁铰接连接"，用户在模型里选中两根梁，你的代码自动生成连接板、螺栓、焊缝，并且参数可调、可复用。

本指南假设你：

• 具备基本的 C# 编程能力（了解类、继承、方法重写即可）
• 了解钢结构基本概念（梁、柱、螺栓、焊缝等）
• 想要从零开始，系统性地学习 LoongCAD 组件开发

学完本指南你将能够：

• 搭建完整的组件开发环境
• 写出三种类型的组件（自定义、节点、细部）
• 使用调试技巧快速定位问题
• 将组件打包发布给团队成员使用

---

第一章：准备工作

1.1 LoongCAD 是什么？

LoongCAD（LoongSTC）是一款国产钢结构深化设计软件，覆盖建模、出图、数控加工全流程。它的二次开发体系允许工程师通过 C# 编写自定义节点、自定义细部和实用工具插件，并以 DLL 形式加载到软件中运行。

官方网址：www.loongCAD.com

1.2 获取软件

版本	适用人群	获取方式
社区版	个人开发者、学习用途	官网免费下载
专业版	商业项目、团队协作	联系官方购买

开发与调试只需要社区版即可，功能完全够用。安装后默认路径为 C:\Program Files\loongstc_community\。

1.3 选择 IDE

LoongCAD 组件基于 .NET Framework 4.8，强烈推荐使用 Visual Studio 2022。

安装时需要勾选以下工作负载：

• .NET 桌面开发（包含 WinForms 设计器、C# 编译器）
• .NET Framework 4.8 目标包（安装时默认包含）

为什么不用 VS Code？因为组件开发涉及 WinForms 窗体可视化设计，VS Code 不支持 WinForms 设计器。VS Community 2022 完全免费使用。

1.4 认识 SDK 的核心 DLL

LoongCAD 开放了一套称为 Friendly API 的接口层。你的组件项目需要引用以下三个核心 DLL（位于 LoongCAD 安装目录下）：

DLL	作用
LoongSDKCore.dll	底层核心：几何运算、数学工具（Point, Vector, Matrix 等）
LoongCAD.STC.Friendly.dll	场景操作：创建 Beam, Plate, Bolt, Weld, Fitting 等
LoongCAD.STC.Friendly.DataType.dll	数据类型定义（PartReportProperties 等枚举）

1.5 理解组件运行方式

你的组件是一个 类库项目（Class Library），编译产出 .dll 文件。LoongCAD 启动时自动扫描并加载你的 DLL，通过 [Plugin] 等 Attribute 注册到组件管理器。用户选中零件后，LoongCAD 实例化你的类并调用 Run() 方法。

扫描的是模型目录 config\comps\<Plugin 名>\plugin.dll，或 工具 → 模型设置 → 用户目录 → 组件节点 下的同名结构，不是项目的 bin\Debug\。部署步骤见 2.5。

1.6 认识界面入口

DLL 加载后，用户（以及你自己按 F5 调试时）都是通过 LoongSTC 主界面调用组件的。先认清两个入口，后面第一次调试时就不会找不到自己的组件。

工具栏 / 菜单栏

主窗口上方工具栏有一组「组件」相关按钮；菜单栏 组件 下也有对应命令。

调试时常用的入口：

• 组件管理器：打开组件目录，浏览、搜索、创建已注册组件（含你的 DLL）。

菜单/工具栏里的 自定义组件...、编辑组件... 属于参数化组件可视化编辑（无需写 C#），与本指南的 SDK 开发不是同一条路径。建模侧说明见 组件。

组件管理器

组件管理器列出当前模型已加载的全部组件（内置 + 你的 DLL）。你的组件会出现在 [PluginGroup] 指定的分组下；未指定时落在默认位置。[Plugin] 名称就是列表里显示的组件名。

与 Run() 对应的操作：

• 选中 → 创建：按提示拾取零件或点，框架随后调用你的 Run()。
• 选中 → 应用：设为当前组件，之后可用工具栏 创建当前组件 反复创建。
• 双击 组件：打开 [PluginUserInterface] 指定的参数窗体。

这就是上一节流程图里「用户操作 → 组件管理器 → 加载 DLL → Run()」在界面上的对应关系。