Dynamo Revit 2025 中包管理器显示问题的分析与解决方案

Dynamo Revit 2025 中包管理器显示问题的分析与解决方案

问题背景

在 Dynamo for Revit 2025 环境中，用户报告了一个常见问题：包管理器界面无法正常显示已安装的包内容。这个问题主要出现在 Dynamo 3.0 版本与 Revit 2025 的组合环境中，而同样的包在 Dynamo Revit 2024 中却能正常工作。

问题现象

当用户在 Dynamo Revit 2025 中打开软件时，左侧的包管理器树形结构完全空白，无法显示任何已安装的包。从日志中可以观察到大量关于包加载失败的警告信息，特别是关于"格式不正确的包节点库"的警告。

根本原因分析

经过深入调查，发现问题源于 .NET 框架版本的升级。Revit 2025 将基础框架从 .NET 4.8 升级到了 .NET 8.0，这一变化带来了对程序集名称格式的更严格验证。

具体来说，在 .NET 8.0 中，AssemblyName 类的构造函数现在会预先解析输入值，不再接受带有通配符(*)的版本号格式。而在 .NET 4.8 中，这种格式是被允许的。

技术细节

在包配置文件(pkg.json)中，常见的程序集引用格式如下：

"node_libraries": [
    "OpenMEPRevit, Version=2.0.0.*, Culture=neutral, PublicKeyToken=null"
]

这种带有通配符的版本号格式在 .NET 8.0 下会被视为无效的程序集名称，导致 Dynamo 无法正确加载这些包。

解决方案

要解决这个问题，开发者需要采取以下步骤：

1. 修改程序集版本号： 在项目文件中，将通配符版本号改为具体版本号：

   <AssemblyVersion>2.0.1.0</AssemblyVersion>
   

2. 更新包配置文件： 在 pkg.json 文件中，确保所有程序集引用都使用完整、具体的版本号：

   "node_libraries": [
       "OpenMEPRevit, Version=2.0.1.0, Culture=neutral, PublicKeyToken=null",
       "OpenMEPUI, Version=2.0.1.0, Culture=neutral, PublicKeyToken=null"
   ]
   

最佳实践建议

1. 版本管理策略：

   • 考虑使用自动化的版本号管理工具，如 MSBuild 的 Version 任务
   • 在 CI/CD 流程中加入版本号自动递增的逻辑

2. 兼容性考虑：

   • 为支持多版本 Revit，可以考虑条件编译或不同的构建配置
   • 在包说明中明确标注支持的 Revit/Dynamo 版本

3. 测试验证：

   • 在发布前，应在所有目标版本的 Revit 中测试包的功能
   • 特别注意检查包管理器的显示和节点加载情况

结论

Dynamo Revit 2025 由于底层框架升级带来的这一变化，要求包开发者更加严格地遵循程序集命名规范。虽然这增加了一些维护工作，但也提高了系统的稳定性和一致性。开发者应尽快更新自己的包配置，以确保在最新版本的 Revit 中能够正常工作。