SuperAPI AI 工具集

addin-operations

编程与开发

查看项目

更新于 10-15 20:30

技能介绍

用途:在 Visual Studio Code 中用 C# 与 dotnet Add-In SDK 开发 TIA Portal 外接程序,不涉及 Python 包装调用。

主要能力: 新建项目:以管理员身份打开命令提示符,运行 dotnet new addin-project,可用 -o 指定输出目录、-n 指定项目名、-N 指定命名空间、-TI 设置 ReadWrite(默认)或 ReadOnly。Author、Description、AddInVersion、ProductName、ProductId、ProductVersion、UnrestrictedAccess、JustificationComment 可在创建时设置,也可之后在项目目录的 Config.xml 中修改。

添加模板:dotnet new <Add-In-Type>,可选模板包括项目树右键菜单、项目库树菜单、全局库树菜单、设备与网络菜单、VCI 编辑器、VCI 导入工作流、VCI 导出工作流、CAX 导出导入工作流。可添加图标并检测 TIA Portal 当前语言以显示多语言文本。

编译与调试:在 VS Code 中运行 Terminal → Run build task 编译,成功后生成 .addin 文件于项目 bin 目录;设断点后按 F5 启动调试,TIA Portal 会自动启动,确认 Debug Add-In 提示即可单步调试,调试无需复制 .addin 文件。

迁移:旧版本 Add-In 无法自动转换,需手动更新程序集引用(移除 Siemens.Engineering.AddIn.dll,改用新分段程序集),并更新 Feedback、Progress、MessageBox API 实现。

使用方式:按需加载相关参考文件,不要一次性全部加载。涉及 PLC/SW/HW 访问时查阅 assembly-references.md,UI 相关查阅 threading-and-callbacks.md,打包分发查阅 package-and-publisher.md。实现 BuildContextMenuItems 时状态回调返回 MenuStatus.Enabled,保护逻辑放在动作回调中。

限制:CAX 导出操作始终写保护;VCI 导入/导出模板需在 Add-In 配置中选为对应工作流的 Add-In 才能使用;无源代码时需反编译 .addin。分发前应充分测试,可通过 TIA Portal 批量部署机制分发。