BIM软件：Autodesk Revit二次开发_（19）.Revit二次开发的发布与部署.docx

PAGE1

PAGE1

Revit二次开发的发布与部署

在完成AutodeskRevit的二次开发后，将开发的插件或工具发布和部署到实际生产环境中是一项重要的工作。本节将详细介绍如何将Revit二次开发的成果发布和部署，包括打包、签名、安装和配置等步骤。

1.打包

1.1打包前的准备工作

在打包之前，确保你的开发环境已经配置好，所有依赖项都已经正确引用，并且你的代码已经通过了所有必要的测试。以下是一些打包前需要检查的事项：

代码清理：删除所有不必要的注释和调试代码。

依赖项检查：确保所有引用的库都已经正确添加到项目中。

版本控制：使用版本控制系统（如Git）管理你的代码，确保每次打包的版本都是经过测试的稳定版本。

配置文件：检查配置文件中的路径和参数是否正确。

1.2使用VisualStudio进行打包

VisualStudio是开发Revit插件的常用工具，它提供了一系列方便的打包功能。以下是如何使用VisualStudio进行打包的步骤：

构建项目：

打开你的Revit插件项目。

选择“生成”菜单，然后选择“生成解决方案”（BuildSolution）。

生成部署包：

右键点击项目文件，选择“生成部署包”（BuildDeploymentPackage）。

选择输出路径，点击“生成”。

生成输出文件：

生成的输出文件通常包括一个主DLL文件、一个配置文件（.config）和其他依赖项。

确保所有文件都在指定的输出目录中。

1.3打包注意事项

文件命名：确保生成的文件命名符合规范，避免使用特殊字符和空格。

文件结构：保持文件结构清晰，方便后续的部署和维护。

版本号：在文件名中包含版本号，以便于区分不同的版本。

2.签名

2.1为什么要签名

签名是为了确保插件在加载到Revit时的安全性和完整性。签名可以防止未经授权的修改和恶意代码的注入。Revit在加载插件时会检查签名，确保插件的来源是可信的。

2.2使用StrongName进行签名

StrongName是.NET框架中的一种签名机制，可以为你的DLL文件生成一个唯一的标识。以下是使用StrongName进行签名的步骤：

生成StrongName密钥：

打开命令提示符。

输入以下命令生成密钥文件（例如mykey.snk）：

sn-kmykey.snk

配置项目签名：

打开你的Revit插件项目。

右键点击项目文件，选择“属性”（Properties）。

在“签名”（Signing）选项卡中，选择“为程序集签名”（Signtheassembly）。

选择或浏览生成的密钥文件（例如mykey.snk）。

重新生成项目：

选择“生成”菜单，然后选择“生成解决方案”（BuildSolution）。

生成的DLL文件将会带有签名。

2.3使用DigitalSignature进行签名

DigitalSignature是一种更高级的签名机制，通常用于商业插件。以下是使用DigitalSignature进行签名的步骤：

获取数字证书：

从证书颁发机构（如VeriSign、Comodo等）购买数字证书。

安装数字证书到你的开发环境中。

使用signtool工具进行签名：

打开命令提示符。

输入以下命令对DLL文件进行签名：

signtoolsign/fC:\path\to\your\certificate.pfx/ppassword/tC:\path\to\your\plugin.dll

其中/f参数指定数字证书文件的路径，/p参数指定证书的密码，/t参数指定时间戳服务器的URL。

验证签名：

使用以下命令验证签名是否成功：

signtoolverify/v/paC:\path\to\your\plugin.dll

3.安装

3.1安装到Revit

将打包好的插件安装到Revit中通常有以下几种方法：

手动安装：

将生成的DLL文件和其他依赖项复制到Revit的插件目录中。

通常路径为C:\ProgramData\Autodesk\Revit\Addins\2023。

使用Revit插件管理器：

打开Revit。

点击“管理”（Manage）菜单，然后选择“外部工具”（ExternalTools）。

点击“添加”（Add），选择你的DLL文件，点击“确定”（OK）。

使用ADSKAdd-InManager：

安装ADSKAdd-InManager。

打开ADSKAdd-InManager，点击“添加”（Add）。

选择你的DLL文件，点击“确定”（OK）。

3.2安装注意事项

文件路径：确保文件路径正确，不要使用过长的路径。

权限：确保你有权限将文件复制到目标目录。

日志记录