跳到主要内容

入门:使用SOLIDWORKS API开发应用程序

使用SOLIDWORKS API入门{ width=400 }

SOLIDWORKS API可以在任何兼容COM的语言中使用(例如C++、C#、VB.NET和Visual Basic)。可以使用SOLIDWORKS API开发不同类型的应用程序。请参考下面的比较表,选择适合要求的应用程序类型。

方法VBA宏插件VSTA宏独立应用脚本备注
易于入门对于经验不丰富的用户启动解决方案所需的平均时间
易于部署否(理论上应该容易,但实际上通常会遇到很多问题)使软件在其他计算机上正常工作所需的时间
代码保护否(仅密码保护)是(二进制文件)是(二进制文件)是(二进制文件)保护代码的方法
可用的实用程序库范围否(仅过时的VB6库)用于处理数据库、文件、XML等的实用函数的可用性
可用的SolidWorks函数范围有限完整有限有限有限某些接口仅在插件内部操作,例如SWPublished库中的接口
可靠性否(通常存在缺失库等问题)解决方案在不同的SolidWorks版本和PC工作站上的可靠性程度
调试简单(进程外)复杂(进程内)。由于需要重新启动插件/SolidWorks,因此重新启动速度较慢复杂(进程内)简单(进程外)对于进程内应用程序,无法从UI中查看和更改SolidWorks的运行时
需要额外软件需要开发IDE否(SW 2018需要)需要开发IDE开发IDE通常包括代码文本编辑器和编译器(例如Visual Studio、Eclipse、CBuilder等)
对初学者友好
性能正常良好良好正常正常操作性能

.NET项目的参考资料

SOLIDWORKS是基于COM的应用程序,因此在从.NET应用程序中使用SOLIDWORKS API时,需要添加组件互操作以启用与COM的通信。

有两种常见的生成所需类型库的方法

COM类型库

通过直接将类型库(*.tlb)文件的引用添加到.NET项目中(sldworks.tlb、swconst.tlb、swpublished.tlb)。可以通过浏览相应的类型库文件或在COM选项卡中找到已注册的引用来完成此操作。这些步骤相当于使用tlbimp实用程序,因为Visual Studio会在后台将类型库转换为互操作。

从COM选项卡添加引用

结果是在项目中使用转换后的.NET互操作等效项

主互操作程序集(PIA)

通过添加随SOLIDWORKS安装提供的互操作程序集(SolidWorks.Interop.sldworks.dll、SolidWorks.Interop.swconst.dll、SolidWorks.Interop.swpublished.dll)。这些类型的互操作程序集称为主互操作程序集(PIA)。互操作库位于SOLIDWORKS安装文件夹\api\redist,用于针对Framework 4.0及更高版本的项目,以及SOLIDWORKS安装文件夹\api\redist\CLR2,用于针对Framework 2.0和3.5的项目。

对于针对Framework 4.0的项目,建议将嵌入互操作类型选项设置为False。 否则,在调用SOLIDWORKS API时可能会出现类型转换问题,导致应用程序的行为不可预测,尽管这种情况很少发生。

差异

其中一个差异是不同的名称和命名空间。从类型库生成的互操作程序的默认命名空间是SldWorksSWPublished等(可以使用tlbimp实用程序更改默认命名空间),而其他情况下使用的命名空间名称中使用SldWorks.Interop前缀。

但还有另一个主要区别。

从COM类型库生成的互操作程序不是强命名的。

从类型库生成的互操作程序没有强名称

而随SOLIDWORKS安装提供的互操作程序(PIA)是强命名的。

程序集互操作程序的强名称

如果您正在构建独立的进程外应用程序(除非您的*.exe支持插件机制并且可以加载引用SOLIDWORKS互操作程序的库),则几乎没有区别,但是对于进程内插件应用程序,如果多个插件引用不同版本的未签名(非强命名)互操作程序,可能会导致严重问题。类似的问题在此YouTube视频中有所展示。

最佳实践

  • 使用随安装提供的主互操作程序集(PIA),避免使用COM类型库
  • 不要直接从安装文件夹引用互操作程序。这将阻止在其他计算机上编译项目,因为互操作程序未放置在相同的目录中,也未添加到GAC中。特别是这将阻止实施持续集成/持续交付(CI/CD)
    • 相反,将互操作程序放置在NuGet服务器上,并将其添加为包。您可以使用内部托管服务器或使用公共服务器。
    • 如果上述选项不可行,则将库添加到与项目相同的文件夹中(例如,在解决方案.sln文件旁边创建一个名为thirdpty*的文件夹,并将互操作程序复制到其中),然后从该文件夹浏览互操作程序以添加相对路径引用。