# Revit-EasyPlugin

**Repository Path**: jianit/revit-easy-plugin

## Basic Information

- **Project Name**: Revit-EasyPlugin
- **Description**: 🔥🔥Revit二次开发插件，包含自定义菜单栏、读取项目族、遍历所有族实例并导出匹配的相关信息，一键出CAD图等....希望能帮助到有需要的人      🔝 🔝 记得上边点个star 关注更新
- **Primary Language**: C#
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 11
- **Forks**: 3
- **Created**: 2024-01-10
- **Last Updated**: 2025-08-27

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Revit-EasyPlugin

####  :tw-1f4cc: 介绍
🔥🔥🔥Revit二次开发插件，此项目前身是基于公司实际需求，开发的Revit工具。接到需求实际开发过程中，发现关于Revit二开的资料很少，网上也没什么开源的项目可供借鉴，翻阅了大量官方文档资料才做完，基于此背景，特将此项目去掉敏感信息，精简代码，添加注释，进行代码开源，希望能帮助到有需要的人      🔝 🔝 记得上边点个star 关注更新

####  :tw-1f525: 软件架构
基于Revit2018 API开发, 目标框架：.Net Framework 4.7.2 输出类型：类库；
WPF/ NPOI / Revit SDK 

####  :tw-1f4d1:  项目结构
1.  **AutoCodePlugIn(核心 :star2: )** ： Revit插件项目
2.  **AutoCodePlugInSetup(核心 :star2: )** ：插件安装程序制作
3. DBDemo： C#链接数据库-ORM映射demo示例
3. ExternalEventDemo: Revit二次开发-外部事件定义与调用Demo示例
4. FamilyInstanceDemo: Revit二次开发-创建族、获取族属性Demo示例
5. FilterDemo: Revit二次开发-模型构件过滤筛选器使用Demo示例
6. HelloRevitDemo: Revit二次开发-入门HelloWord示例
7. UIButtonDemo: Revit二次开发-自定义菜单Demo示例
8. WpfAppDemo: Revit二次开发-插件结合wpf窗体使用Demo示例

####  :tw-1f4cb: 开发准备工作

1. 安装Revit2018 (此代码基于Revit2018 API开发，高版本不确定是否兼容)
2. 安装完Revit软件后，需要在项目中添加两个至关重要的DLL库(用于Revit API调用),分别是:RevitAPI.dll 、RevitAPIUI.dll,在安装目录下\Autodesk\Revit 2018\xx.dll
   如何添加引用DLL文件，自行百度。

####  :tw-1f527: 插件安装 
在安装包中找到 AutoCodePlugInSetup.msi 文件，右键管理员方式运行安装即可(安装过程中必须关闭Revit软件)，安装完毕后打开Revit软件，此时会提示如下弹窗，点击总是载入即可
![输入图片说明](1.jpg)
####  :tw-1f516: 插件工具功能介绍
Revit插件-->自定义工具
当前版本：v1.2 主要功能 :point_down: 
1. 构件排序规则设置；
2. 一键生成构件编号并排序；
3. 导出Excel编号信息；
4. 一键出图(CAD图纸)；
5. 一键导出模型构件清单；
6. 更多功能持续迭代中...

####  :foggy: 部分功能截图

1.  插件安装成功后，进入Revit主界面，会看到工具栏多了如下菜单：
![输入图片说明](2.jpg)
2.  【排序规则】功能：用于模型中各个族的排序，按自定义规则排序并生成序号，最终根据序号+其他内置规则生成编号，减少人工排序的工作量以及误差
![输入图片说明](3.jpg)
3.  【生成编号】功能：根据排序规则生成的序号，加上内置规则系统自动生成BIM编号,并且弹窗提供预览，通知支持手动微调、导出Excel功能，如下图
![输入图片说明](4.jpg)
4.  【导出当前视图/图纸】功能：自动导出当前BIM模型的CAD图纸，并标注尺寸
![输入图片说明](5.jpg)
5.  【关于】功能：用于放版本、版权等信息
![输入图片说明](6.jpg)
6. 其他功能陆续开放中...


####  :tw-1f6a9: 参与贡献

1.  Fork 本仓库
2.  新建 Feat_xxx 分支
3.  提交代码
4.  新建 Pull Request


####   :tw-1f234: 合作
 **此Revit插件工具功能核心逻辑基于原有公司业务设计,已屏蔽关键敏感信息，整体工具框架是可用的, 比如如何自定义菜单、导出、窗口操作、读取模型构建列表等都可参考借鉴，也可联系我本人深度合作：18611637522(微信同号)**