微信号

功能介绍

“ 二次开发中最常用的调试工具，有它事半功倍。”

之前我们已经介绍过SDK的内容，其中第一个内容就是简单地介绍Add-In Manager，而本文将继续深入了解Add-In Manager。

01

—

Revit加载插件机制

Revit中加载外部应用程序（ExternalApplication）或外部命令（ExternalCommand）通常需要透过addin后缀的文件进行加载。

这个文件一般放在

C:\ProgramData\Autodesk\Revit\Addins\Revit版本

或

C:\Users\<user>\AppData\Roaming\Autodesk\Revit\Addins\Revit版本

的路径下。

第一个路径下的addin文件，是任何人打开Revit的时候都会去读取的，而第二个路径下的addin文件，只有当前电脑用户是这个名的用户，打开Revit的时候才会去读取。

这也就说明我们的插件一般在打开Revit的时候才会被加载，而如果我们处于编写代码的过程，需要不断地运行刚编译好的程序，那就得不断地重新启动Revit，以便我们最新的程序被加载进Revit，这样我们的效率也随之下降。

为了解决这个问题，我们可以采用Add-In Manager来运行我们的插件。

02

—

关于Add-In Manager

这也是一个外部命令，但借助它可以直接运行我们的插件，而不需要创建或修改addin文件。

在SDK文件夹里我们可以看到Add-In Manager包含了好几个文件：

① AddInManagerHelpENU：这个文件是Add-In Manager的帮助文档。

② Autodesk.AddInManager.addin：这个就是我们刚刚说到的addin文件，它是XML的格式文件，加载dll必须用到的。

③ Autodesk.AddInManager.Command.dll：这是Add-In Manager的核心文件。

④ Autodesk.AddInManager.Command.dll.config：Add-In Manager.dll的配置文件。

⑤ SplitButton_License(BSD)：SplitButton的许可证。

一些旧版本的SDK中可能不包含上述的④、⑤号文件，但这个问题不大。

03

—

加载Add-In Manager

我们只需要把②、③号文件拷入路径

C:\ProgramData\Autodesk\Revit\Addins\Revit版本

或

C:\Users\<user>\AppData\Roaming\Autodesk\Revit\Addins\Revit版本

下即可，④号文件如果有的话也一并拷入。

这时候，我们还需要打开Autodesk.AddInManager.addin（txt文本打开即可），将Assembly中的[TARGETDIR]删除。

随后，我们打开Revit，Revit将会弹出一个附加模块确认窗口（一些旧版本的Revit会直接加载不弹窗），一般情况我们选择总是载入，这样就可以避免下次启动Revit时再次弹窗。

因为Autodesk.AddInManager包含3个命令，因此我们需要点3次总是载入。

最终在附加模块的面板下的外部工具下拉列表中，我们可以看到Add-In Manager即说明Add-In Manager已经加载成功。

03

—

命令模式

从外部工具中，我们可以看到Revit已经加载了3个Add-In Manager的命令。这三个命令分别表示：

① Manual Model：表示运行的是事物模式为手动开启的外部命令。

② Manual Model，Faceless：表示运行上一次的事物模式为手动开启的外部命令。

③ ReadOnly Model：表示运行事物模式为只读的外部命令。

一般的，我们常用①、②命令。

以上是关于Add-In Manager的一些简单介绍，后续讲到Hello Word的时候我们再具体看看如何使用Add-In Manager。

微信号

功能介绍

“ 二次开发中最常用的调试工具，有它事半功倍。”

之前我们已经介绍过SDK的内容，其中第一个内容就是简单地介绍Add-In Manager，而本文将继续深入了解Add-In Manager。

01

—

Revit加载插件机制

Revit中加载外部应用程序（ExternalApplication）或外部命令（ExternalCommand）通常需要透过addin后缀的文件进行加载。

这个文件一般放在

C:\ProgramData\Autodesk\Revit\Addins\Revit版本

或

C:\Users\<user>\AppData\Roaming\Autodesk\Revit\Addins\Revit版本

的路径下。

第一个路径下的addin文件，是任何人打开Revit的时候都会去读取的，而第二个路径下的addin文件，只有当前电脑用户是这个名的用户，打开Revit的时候才会去读取。

这也就说明我们的插件一般在打开Revit的时候才会被加载，而如果我们处于编写代码的过程，需要不断地运行刚编译好的程序，那就得不断地重新启动Revit，以便我们最新的程序被加载进Revit，这样我们的效率也随之下降。

为了解决这个问题，我们可以采用Add-In Manager来运行我们的插件。

02

—

关于Add-In Manager

这也是一个外部命令，但借助它可以直接运行我们的插件，而不需要创建或修改addin文件。

在SDK文件夹里我们可以看到Add-In Manager包含了好几个文件：

① AddInManagerHelpENU：这个文件是Add-In Manager的帮助文档。

② Autodesk.AddInManager.addin：这个就是我们刚刚说到的addin文件，它是XML的格式文件，加载dll必须用到的。

③ Autodesk.AddInManager.Command.dll：这是Add-In Manager的核心文件。

④ Autodesk.AddInManager.Command.dll.config：Add-In Manager.dll的配置文件。

⑤ SplitButton_License(BSD)：SplitButton的许可证。

一些旧版本的SDK中可能不包含上述的④、⑤号文件，但这个问题不大。

03

—

加载Add-In Manager

我们只需要把②、③号文件拷入路径

C:\ProgramData\Autodesk\Revit\Addins\Revit版本

或

C:\Users\<user>\AppData\Roaming\Autodesk\Revit\Addins\Revit版本

下即可，④号文件如果有的话也一并拷入。

这时候，我们还需要打开Autodesk.AddInManager.addin（txt文本打开即可），将Assembly中的[TARGETDIR]删除。

随后，我们打开Revit，Revit将会弹出一个附加模块确认窗口（一些旧版本的Revit会直接加载不弹窗），一般情况我们选择总是载入，这样就可以避免下次启动Revit时再次弹窗。

因为Autodesk.AddInManager包含3个命令，因此我们需要点3次总是载入。

最终在附加模块的面板下的外部工具下拉列表中，我们可以看到Add-In Manager即说明Add-In Manager已经加载成功。

03

—

命令模式

从外部工具中，我们可以看到Revit已经加载了3个Add-In Manager的命令。这三个命令分别表示：

① Manual Model：表示运行的是事物模式为手动开启的外部命令。

② Manual Model，Faceless：表示运行上一次的事物模式为手动开启的外部命令。

③ ReadOnly Model：表示运行事物模式为只读的外部命令。

一般的，我们常用①、②命令。

以上是关于Add-In Manager的一些简单介绍，后续讲到Hello Word的时候我们再具体看看如何使用Add-In Manager。