# Navisworks 2026 API 关键变化

## 🔧 DLL引用变化

### ❌ 旧版本 (2017-2025)
```xml
<Reference Include="Autodesk.Navisworks.Api.Plugins">
  <HintPath>...\Autodesk.Navisworks.Api.Plugins.dll</HintPath>
</Reference>
```

### ✅ 新版本 (2026)
```xml
<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. 目标框架
```xml
<TargetFrameworkVersion>v4.8</TargetFrameworkVersion>
```

### 2. 编译常量
```xml
<DefineConstants>DEBUG;TRACE;NAVISWORKS_2026</DefineConstants>
```

### 3. 引用配置
```xml
<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. 构建后事件
```xml
<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)