tian/NavisworksTransport
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
1813c9831d
NavisworksTransport/doc/migration/Navisworks_2026_API_Changes.md

3.2 KiB
Raw Blame History

Navisworks 2026 API 关键变化

🔧 DLL引用变化

❌ 旧版本 (2017-2025)

<Reference Include="Autodesk.Navisworks.Api.Plugins">
  <HintPath>...\Autodesk.Navisworks.Api.Plugins.dll</HintPath>
</Reference>

✅ 新版本 (2026)

<Reference Include="Autodesk.Navisworks.Api">
  <SpecificVersion>False</SpecificVersion>
  <HintPath>...\Autodesk.Navisworks.Api.dll</HintPath>
  <Private>False</Private>
</Reference>

📦 可用的DLL文件

在 C:\Program Files\Autodesk\Navisworks Manage 2026\ 目录下：

DLL文件 用途
Autodesk.Navisworks.Api.dll 主要API - 核心功能、插件基类
Autodesk.Navisworks.Clash.dll 碰撞检测功能
Autodesk.Navisworks.Controls.dll UI控件和界面
Autodesk.Navisworks.Timeliner.dll 时间线和动画功能
Autodesk.Navisworks.Automation.dll 自动化和COM接口
Autodesk.Navisworks.ComApi.dll COM API
Autodesk.Navisworks.Takeoff.dll 工程量统计
Autodesk.Navisworks.Resolver.dll 解析器功能

🔍 API示例位置

官方示例代码位于：

C:\Users\[用户名]\Documents\NavisworksAPI\navisworks_api_2026\NET\examples\

示例项目结构：

  • Basic Examples\CSharp\BasicPlugIn\ - 基础插件示例
  • Basic Examples\CSharp\BasicDockPanePlugin\ - 停靠面板插件
  • PlugIns\ClashDetective\ - 碰撞检测插件示例
  • PlugIns\Timeliner\ - 时间线插件示例
  • Tools\AppInfo\ - 应用信息工具
  • Tools\CodeRun\ - 代码运行工具

📋 项目配置最佳实践

1. 目标框架

<TargetFrameworkVersion>v4.8</TargetFrameworkVersion>

2. 编译常量

<DefineConstants>DEBUG;TRACE;NAVISWORKS_2026</DefineConstants>

3. 引用配置

<Reference Include="Autodesk.Navisworks.Api">
  <SpecificVersion>False</SpecificVersion>
  <HintPath>..\..\..\..\Program Files\Autodesk\Navisworks Manage 2026\Autodesk.Navisworks.Api.dll</HintPath>
  <Private>False</Private>
</Reference>

4. 构建后事件

<PostBuildEvent>
  IF NOT EXIST "C:\Program Files\Autodesk\Navisworks Manage 2026\Plugins\$(TargetName)\" mkdir "C:\Program Files\Autodesk\Navisworks Manage 2026\Plugins\$(TargetName)\"
  xcopy /Y "$(TargetDir)*.*" "C:\Program Files\Autodesk\Navisworks Manage 2026\Plugins\$(TargetName)\"
</PostBuildEvent>

⚠️ 迁移注意事项

  1. 命名空间保持不变: using Autodesk.Navisworks.Api.Plugins;
  2. 插件基类不变: AddInPlugin, DockPanePlugin, ToolPlugin 等
  3. 属性和方法: 大部分API保持向后兼容
  4. 新功能: 2026版本可能包含新的API和功能

🚀 验证安装

检查以下文件是否存在：

C:\Program Files\Autodesk\Navisworks Manage 2026\Autodesk.Navisworks.Api.dll

如果文件不存在，请确认：

  1. Navisworks 2026已正确安装
  2. 安装了开发者工具包
  3. 路径是否正确

📚 参考资源

  • 官方API文档: C:\Users\[用户名]\Documents\NavisworksAPI\navisworks_api_2026\NET\documentation\NET API\
  • 示例代码: C:\Users\[用户名]\Documents\NavisworksAPI\navisworks_api_2026\NET\examples\
  • 在线文档: Autodesk Developer Network (ADN)