组件开发指南

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

---

前言：你能用 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() 方法。