夜雨聆风PipeMate for PDMS 0.0.2 发布：新增 PDMS 12.1 SP4 适配
PipeMate for PDMS为 PDMS 提供持续扩展的工程效率工具集
PipeMate for PDMS 迎来 0.0.2 体验版更新。
本次更新的核心内容是新增对 AVEVA PDMS 12.1 SP4 的适配。在保留 PDMS 12.0 SP6 支持的基础上，安装程序现在允许用户选择实际使用的 PDMS 版本，并自动安装与该版本对应的插件文件。
这次适配并不是简单地让同一个 DLL 同时加载到两个 PDMS 版本中，而是采用：
同一套业务源码、两套独立构建、安装时按版本准确部署。
这样既能继续维护统一的功能代码，也能降低不同版本 AVEVA 程序集带来的兼容风险。
一、本次更新解决了什么问题
由于部分用户使用的是 PDMS 12.1 SP4。虽然两个版本都属于 PDMS 12.x，但它们安装目录中的 AVEVA .NET 程序集并不应该被视为完全相同。
如果直接把基于 12.0 SP6 程序集编译的 DLL 放入 12.1 SP4 环境，可能出现问题。
二、0.0.2 支持的版本
本次更新针对的是 PDMS 12.1 SP4，不代表已经自动兼容全部 PDMS 12.1 补丁版本。
三、用户能看到哪些变化
1. 安装时增加版本选择
新版安装程序增加了 PDMS 版本选择页面。
用户可以根据自己的软件环境选择：
2. 自动查找对应版本目录
安装程序会根据用户选择的版本重新查找 PDMS 安装目录。
最终选择的目录必须直接包含：
DesignAddins.xml
四、版本适配的整体思路
本次适配遵循一个基本原则：
共享业务代码，隔离版本依赖。
综合汇料、范围出料、授权校验和 Excel 导出等业务逻辑继续使用同一套 C# 源码，不为 12.1 SP4 复制一套新项目。
真正需要区分的是：
编译时引用哪一套 AVEVA DLL； 输出到哪个构建目录； 安装时部署哪一个插件 DLL； 自动查找哪个 PDMS 安装目录； 将 Addin 和 PML 文件注册到哪个版本。
这种方式有三个好处：
不需要维护两套重复业务代码； 每个 DLL 都使用目标 PDMS 版本的程序集编译； 后续增加其他版本时，可以继续沿用相同结构扩展。
五、项目代码做了哪些调整
1. 新增两套正式构建配置
2. AVEVA 引用改为可配置目录
原项目中的 AVEVA DLL 引用直接指向 PDMS 12.0 SP6 安装目录。
0.0.2 将这些固定路径统一调整为：
<HintPath> $(AvevaReferenceRoot)\Aveva.Pdms.Database.dll</HintPath>不同构建配置分别指定自己的引用根目录：
<AvevaReferenceRoot> C:\AVEVA\Plant\PDMS12.0.SP6</AvevaReferenceRoot><AvevaReferenceRoot> D:\AVEVA\Plant\PDMS12.1.SP4</AvevaReferenceRoot>除数据库程序集外，其他AVEVA 引用也统一通过 AvevaReferenceRoot 切换。
这意味着编译 12.1 SP4 版本时，插件真正引用的是 12.1 SP4 安装目录中的程序集。
六、为什么不直接使用同一个 DLL
C# 插件运行时不仅依赖代码语法，还依赖编译时引用的 AVEVA 程序集。
即使 API 名称看起来相同，不同版本仍可能存在：
程序集版本变化； 类型或方法签名变化； 内部实现差异；
七、安装和升级步骤
1. 关闭 PDMS
PDMS 加载插件后会锁定 DLL。安装或升级前，请先完全退出 PDMS。
2. 运行 0.0.2 安装程序
右键以管理员身份运行：
PdmsComprehensiveTools_Setup_12x.exe3. 选择自己的 PDMS 版本
请根据本机实际环境选择：
PDMS 12.0 SP6； PDMS 12.1 SP4。
不要仅根据安装路径名称猜测版本。
4. 确认安装目录
确认安装程序识别的目录正确，并检查其中是否存在：
DesignAddins.xml如果自动识别失败，请手工选择正确的 PDMS 安装目录。
5. 完成安装
安装完成后重新启动 PDMS ，工具栏会出现一个蓝色管道小图标，点击图标即可打开插件功能窗口。
八、升级时需要注意
已安装 0.0.1 的用户
建议先关闭 PDMS，再运行 0.0.2 安装包完成覆盖升级。
安装时必须重新确认自己的 PDMS 版本和安装目录。
关于授权文件
授权文件仍位于：
C:\ProgramData\PdmsComprehensiveTools\license.dat正常覆盖升级不会主动删除授权文件
十一、如何获取 0.0.2 体验版
如需体验 PipeMate for PDMS 0.0.2，请通过以下方式联系：
公众号回复关键词：【PipeMate】微信：【xyboyyoo123】邮箱：【xyboyyoo123@gmail.com】
十二、免责声明
PipeMate for PDMS 是独立开发的第三方辅助工具，并非 AVEVA 官方产品，也未获得 AVEVA 官方背书。 PDMS、E3D、AVEVA 等名称及相关商标归其合法权利人所有，本文提及相关名称仅用于说明软件适用环境。 体验版主要用于功能测试、技术交流和内部评估。正式用于项目交付前，应由使用者完成环境验证和结果复核。 材料统计结果受模型质量、元件属性、项目规范、Catalogue 配置和 PDMS 版本影响，不应作为未经复核的唯一工程依据。 安装程序不会随包分发 AVEVA DLL。目标计算机必须已经合法安装对应版本的 AVEVA PDMS。 请勿将 12.0 SP6 构建用于 12.1 SP4，也不要将 12.1 SP4 构建用于未经验证的其他 PDMS 版本。 使用者应在安装前备份必要配置。安装程序会在备份后更新所选 PDMS 目录中的 DesignAddins.xml。因版本选择错误、未经验证的环境、第三方软件冲突或数据库异常造成的问题，开发者不承担相应责任。
结语
PipeMate 已经从单一 PDMS 环境迈出了多版本支持的第一步。
PipeMate for PDMS为 PDMS 提供持续扩展的工程效率工具集。