[Revit]Autodesk Revit 二次開發整理（資料、准備工作和環境搭建）

1 前言

Revit被Autodesk收購之后，整理和開放了一大部分API，供開發者實現自己的功能和程序，總體來說API的功能比較完善，畢竟市面上已經出現了各式各樣的插件。

本人也是初學者，在Revit分類中分享一些自己記錄的筆記內容。

---

2 准備工作

工欲善其事，必先利其器。

2.1 語言

首先，定下你自己想使用的編程語言，官方SDK中給出的語言示例包括C#、VB、C++三種，至於選擇哪一種來開發，可以根據個人喜好和語言掌握情況。不過一般來說，大家都使用C#，C#出自微軟Anders Hejlsberg團隊之手，設計優美，配合上宇宙第一IDE和 .NET Framwork，開發起來效率很高。同時對於有UI需求的開發者來說，使用Winform或者WPF也可以讓你快速完成UI界面的設計。

當然，如若你覺得人生苦短，也可以使用Python進行開發，Github上有一個開源項目叫做pyRevit，這個插件為Revit提供了一個python腳本的運行環境和一些已有功能，你可以使用各路大神們用Python封裝好的方法，實現你自己的業務。在此不多做介紹，有興趣大家可以搜索相關資料學習。

2.2 SDK

選擇好了適合你的語言，接下來需要去下載相關開發SDK，官方開發者中心有最新三年的SDK可以下載，如果你要下載再老的版本SDK，就需要你自己去網上搜索了。

我這里有一些老的SDK供大家選擇下載：

• Revit 2014 SDK
• Revit 2015 SDK
• Revit 2016 SDK
• Revit 2017 SDK
• Revit 2018 SDK
• Revit 2019 SDK

SDK很重要，在此不禁讓小學生水平的我吟詩一首，啊，SDK，你似那茫茫航洋中的燈塔，照亮我們前進的方向。個人理解，有了SDK你才知道你能做和不能做的界限，如果能做，也要根據SDK去決定該走什么路線、程序該怎么架構和設計等。

除了SDK，官方還提供了案例代碼，可以從案例代碼里面學習一些API的使用。

• Revit 2016 samples
• Revit 2017 samples
• Revit 2018 samples
• Revit 2019 samples

2.3 輔助工具

開發過程中使用一些特定工具，輔助提升你的開發效率還是很有必要的。

1. RevitLookup
   RevitLookup可以輔助開發人員在Revit中查看Revit底層數據庫中的元素對象、屬性、關系等內容，更加直觀和方便，免除你去翻SDK一個一個查了；
2. AddInManager
   AddInManager是用來在開發過程中調試你的命令和程序的，如果不使用AddInManager，那你調試起來就只能一遍一遍的重復關閉Revit，安裝插件，再打開revit，測試，修改這樣一個流程了，那么不出幾天，就會變成Revit二次開發：

graph LR 入門 --> 放棄

傳送門：

• RevitLookup 2015
• RevitLookup 2016
• RevitLookup 2017
• RevitLookup 2018
• AddinManager 2014
• AddinManager 2015
• AddinManager 2016
• AddinManager 2017
• AddinManager 2018

安裝完成，在Revit附加模塊Tab頁會出現如圖所示工具：

2.4 IDE

如果你選擇C#或者C++作為開發語言，那么宇宙第一IDE Visual Studio你值得擁有。當然，你也可以使用Visual Studio Code甚至Notepad。。。

如果你C盤空間還夠，推薦大家下載使用Visual Studio Community 2015/2017，具體使用什么版本，還要根據你開發的Revit版本來決定，在安裝VS的時候，注意勾選C#相關組件和高版本的 .Net Framwork開發工具，如果第一次沒安裝完全也可以在需要的時候運行安裝程序修改安裝配置。

如果你選擇python，可以使用VSC或者PyCharm。

2.5 資料

相關參考資料除了有SDK和官方給的參考代碼案例外，還有國內外各類論壇里面的相關帖子。

比如葉雄進老師的博客，面市的相關書籍等。

---

3 開始第一個項目搭建

這里以VS為例。

3.1 新建工作項目

1. 打開Visual Studio，點擊文件 ---> 新建 ---> 項目；
   
2. 項目類型選擇，Visual C# ---> 類庫(.NET Framwork)，根據要開發revit的插件的版本，選擇 .Net framwork版本，自己起一個名稱，選擇一個存儲位置，點擊確定；
   
   VS會默認給你創建如下模板：
   

3.2 添加項目引用

1. 添加Revit API引用，從Revit安裝目錄中找到RevitAPIUI.dll和RevitAPI.dll，這是兩個最常用的動態鏈接庫；
   在項目解決方案瀏覽器中右鍵引用一項，選擇添加引用，瀏覽找到上述兩個dll文件，確定；
   

確定之后，引用一項就會變成如圖所示：

可以選擇性的執行，將這兩個dll的復制本地屬性改為False，改為False，生成項目的時候這兩個dll文件就不會復制到生成目錄中，根據個人喜好設置~

2. 引用Revit命名空間。
   Class1.cs文件最上面添加對Revit最常用命名空間的引用：

using Autodesk.Revit.DB;
using Autodesk.Revit.UI;

至此，一個revit最簡單的插件環境已經搭建完畢。

接下來，就可以針對具體業務寫業務代碼了。

3.3 修改項目屬性

項目默認的平台目標是Any CPU，寫完代碼直接生成會彈出MSB3270警告，如下：

1>------ 已啟動全部重新生成: 項目: FirstRevitPlugin, 配置: Debug Any CPU ------
1>E:\Visual Studio 2017\MSBuild\15.0\Bin\Microsoft.Common.CurrentVersion.targets(1987,5): warning MSB3270: 所生成項目的處理器架構“MSIL”與引用“RevitAPI”的處理器架構“AMD64”不匹配。這種不匹配可能會導致運行時失敗。請考慮通過配置管理器更改您的項目的目標處理器架構，以使您的項目與引用間的處理器架構保持一致，或者為引用關聯一個與您的項目的目標處理器架構相符的處理器架構。
1>E:\Visual Studio 2017\MSBuild\15.0\Bin\Microsoft.Common.CurrentVersion.targets(1987,5): warning MSB3270: 所生成項目的處理器架構“MSIL”與引用“RevitAPIUI”的處理器架構“AMD64”不匹配。這種不匹配可能會導致運行時失敗。請考慮通過配置管理器更改您的項目的目標處理器架構，以使您的項目與引用間的處理器架構保持一致，或者為引用關聯一個與您的項目的目標處理器架構相符的處理器架構。

需要在解決方案管理器中，右鍵項目名稱--->屬性--->生成，將平台目標改為x64；
再次生成就不會彈出該警告。
生成的dll文件會在該項目文件夾下的bin--->debug目錄或者bin--->release目錄。

注：

1. 以上，除了必備的生產工具外，不必全部准備，可以從簡單業務入門，帶着任務去學習。
2. 現在好像資源分數由系統決定了，之前都是設置0分或者1分，現在自己不可以設定資源分數了~
3. 不能下載的可以找其它資源下載。

暫時就先寫這么多吧。

---

4 結語

萬事開頭難，當時剛開始學習寫插件碼代碼的時候也是會踩到各種各樣的坑，但好在網上有各種各樣的解決方案（比心 ❤️），善用互聯網上的優質資源，可以幫助大家快速熟悉整個開發過程，並解決你大部分的問題。

如有錯誤，懇請指正。

Murphy.L

---

Perhaps, we’ve just forgotten that we are still pioneers.