【Revit】アドイン開発 超初心者に役に立ちそうなサイトのまとめ

# 概要
Revitのアドイン開発に役に立つサイトやページをまとめました。
私はRevitアドイン開発の初心者で、プログラムを通じて図面に直接触れた経験はほとんどありません。また、アドイン開発を通じてでも直接Revitの図面の仕様に関わるようなコアな部分に触れることはあまりありません。それでも時々Revit APIの仕様の把握が必要な場面があり、その際にRevit関連の情報収集に少し苦労しています。

そこで、自分を含めこれからRevitアドイン開発を始める人や少し関わる可能性のある人にとって、抑えていて損はなさそうな有用な情報が記載されているサイトをまとめてみました。

※掲載しているURLのページには少し古い情報もありますが、初学者にとってはとても役に立つと思うので掲載しています。

# 目次
##### [Revit APIに関して解説しているページ](#revit-apiに関して解説しているページ-1)
- [Revitアドイン基礎](#revitアドイン基礎)
- [Revitアドイン応用～具体例](#revitアドイン応用具体例)
- [AutoCAD アドオン開発者のためのRevit API入門～概説](#autocad-アドオン開発者のためのrevit-api入門概説)
- [AutoCAD アドオン開発者のためのRevit API入門～アドイン](#autocad-アドオン開発者のためのrevit-api入門アドイン)
- [AutoCAD アドオン開発者のためのRevit API入門～アクセス](#autocad-アドオン開発者のためのrevit-api入門アクセス)
- [Revitアドイン入門① – 環境構築+Revit起動時にメッセージ](#revitアドイン入門--環境構築revit起動時にメッセージ)
##### [Revit APIの仕様に関するドキュメント関連](#revit-apiの仕様に関するドキュメント関連-1)
- [Revit API 開発者用ガイド](#revit-api-開発者用ガイド)
- [Revit API Docs](#revit-api-docs)
##### [アドイン開発に役立ちそうなツール](#アドイン開発に役立ちそうなツール-1)
- [Revit Lookup](#revit-lookup)
##### [押さえておいたほうが良さそうな知識](#押さえておいたほうが良さそうな知識-1)
- [.addinファイルの配置場所](#addinファイルの配置場所)
- [.addinファイルの読み込み順](#addinファイルの読み込み順)
- [Revit APIの呼出し方法](#revit-apiの呼出し方法)
- [ジャーナルファイル](#ジャーナルファイル)
- [拡張ストレージ](#拡張ストレージ)
- [Revit起動時、終了時の処理の実装](#revit起動時終了時の処理の実装)
- [ユーザーの操作に合わせて特定の処理を実行](#ユーザーの操作に合わせて特定の処理を実行)
- [ポストコマンド](#ポストコマンド)
- [外部コマンド、外部アプリケーション](#外部コマンド外部アプリケーション)
- [外部アプリケーションを実行するためのボタンの種類](#外部アプリケーションを実行するためのボタンの種類)
- [外部イベント](#外部イベント)
##### [その他](#その他-1)
- [異なるアドインのモジュールが共通のdllを使用している際に気を付けること](#異なるアドインのモジュールが共通のdllを使用している際に気を付けること)
##### [別記事にまとめたもの](#別記事にまとめたもの-1)
##### [役に立つサイト](#役に立つサイト-1)
- [The Building Coder](#the-building-coder)
- [RevitAPI屋さん コピペで使えるコード集](#revitapi屋さん-コピペで使えるコード集)
- [Technology Perspective from Japan](#technology-perspective-from-japan)
- [Revit Lab](#revit-lab)
***
## Revit APIに関して解説しているページ

### [Revitアドイン基礎](https://adndevblog.typepad.com/files/1.revit-%E3%82%A2%E3%83%89%E3%82%A4%E3%83%B3%E5%9F%BA%E7%A4%8E.pdf)

Revitの歴史や開発環境がまとめられています。
また、開発を進めるにあたって必要な「外部コマンド」「外部アプリケーション」「アドインファイル」についてもまとめられています。
***
### [Revitアドイン応用～具体例](https://adndevblog.typepad.com/files/3.revit-%E3%82%A2%E3%83%89%E3%82%A4%E3%83%B3%E5%BF%9C%E7%94%A8.pdf)

一つ前のURLの応用編です。
「スレッド」や「トランザクション」等、こちらも開発を進めるにあたって必要となる情報がまとめられています。
***
### [AutoCAD アドオン開発者のためのRevit API入門～概説](https://adndevblog.typepad.com/technology_perspective/2013/12/understanding-revit-api-for-autocad-addon-developers-part1.html)

「AutoCAD アドオン開発者のための」とありますが、AutoCAD アドオンの開発経験がなくても役に立つ情報が沢山記載されているので、こちらも目を通しておくことをオススメします。
***
### [AutoCAD アドオン開発者のためのRevit API入門～アドイン](https://adndevblog.typepad.com/technology_perspective/2014/01/understanding-revit-api-for-autocad-addon-developers-part2.html)

一つ上のページの続きです。
「外部コマンド」や「外部アプリケーション」等、アドインに関する情報が記載されています。

### [AutoCAD アドオン開発者のためのRevit API入門～アクセス](https://adndevblog.typepad.com/technology_perspective/2014/03/understanding-revit-api-for-autocad-addon-developers-part5.html)

Revit APIを使用して、Revitのデータにアクセスする方法が記載されています。

### [Revitアドイン入門① – 環境構築+Revit起動時にメッセージ](https://amdlaboratory.com/amdblog/revitapi-revit%e3%82%a2%e3%83%89%e3%82%a4%e3%83%b3%e5%85%a5%e9%96%80%e2%91%a0-%e7%92%b0%e5%a2%83%e6%a7%8b%e7%af%89revit%e8%b5%b7%e5%8b%95%e6%99%82%e3%81%ab%e3%83%a1%e3%83%83%e3%82%bb%e3%83%bc/#comment-651)

RevitAPIを利用したアドインプログラムの作成方法を公開しています。

***
## Revit APIの仕様に関するドキュメント関連
### [Revit API 開発者用ガイド](https://help.autodesk.com/view/RVT/2025/JPN/?guid=Revit_API_Revit_API_Developers_Guide_html)

Revit APIの概要や、使用方法について説明しているページです。

***
### [Revit API Docs](https://www.revitapidocs.com/)

RevitAPIのオンラインドキュメントです。
RevitAPI内のクラス名やメソッド名で検索すると、それに関する仕様が表示されます。
RevitAPIで気になるクラス名やメソッド名があった場合、このドキュメントを使用して仕様を確認することができます。
***
## アドイン開発に役立ちそうなツール
### Revit Lookup
このツールを使用すると、Revitのプロジェクトファイルやファミリ ファイルにある色々な要素の情報を確認できます。

後述する「拡張ストレージ」の構成や保存内容も、このツールを使用して確認できます。
[こちら](https://github.com/jeremytammik/RevitLookup/releases)からダウンロードできます。
 
## 押さえておいたほうが良さそうな知識
基本的に [Revit APIに関して解説しているページ](#revit-apiに関して解説しているページ-1)に記載されている知識が多いです。
***

### .addinファイルの配置場所
.addinファイルは、次のいずれかに配置するのが一般的です。

- 全てのユーザー向けのアドイン
C:\ProgramData\Autodesk\Revit\Addins\<Revitのバージョン>\

- 現在のユーザー向けのアドイン
- C:\Users\<ユーザー名>\AppData\Roaming\Autodesk\Revit\Addins\<Revitのバージョン>\

※Revitのバージョンは「2019」「2021」等が入ります

#### 参考URL
- [Revit Addin file locations for production Release and Test/Debug](https://forums.autodesk.com/t5/revit-api-forum/revit-addin-file-locations-for-production-release-and-test-debug/td-p/6733987)
- [Revit Add-In Locations and BIM360 EU](https://thebuildingcoder.typepad.com/blog/2018/10/revit-add-in-locations-and-bim360-eu.html)

### .addinファイルの読み込み順
Revitの起動時に[.addinファイルの配置場所](#addinファイルの配置場所)で記載したパスの.addinファイルが読み込まれれますが、その読み込み順はアルファベット順になります。

#### 参考URL
- [The Order of addins](https://forums.autodesk.com/t5/revit-api-forum/the-order-of-addins/td-p/5639038)

### Revit APIの呼出し方法
Revit API は、単一スレッドのアクセスのみサポートしています。
なので、Revit APIの処理を呼び出す際は、メイン スレッドで実行する必要があります。

#### 参考URL
- [Revit 開発者用ガイド 配置オプション](https://help.autodesk.com/view/RVT/2022/JPN/?guid=Revit_API_Revit_API_Developers_Guide_Introduction_Getting_Started_Using_the_Autodesk_Revit_API_Deployment_Options_html)

***
### ジャーナルファイル
Revitの起動から終了したタイミングまでのRevit上の操作を記録したファイルです。Revit自体のログファイルみたいな認識で大丈夫だと思います。
Delta VM (恐らく仮想メモリ) や、RAM (物理メモリ) やGDI (Graphic Device Interface) のことなど、PC自体の情報の推移も記載されています。
例えば`Delta VM: Avail +10 -> 123456789 MB`で、使用可能な仮想メモリが123,456,789 MBで+10MB増加した、という感じに読み取れると思います。

:::note
以下がよく記載されています。
- Avail：使用可能な容量
- Used：現在使用中の容量
- Peak：最大使用量
:::

#### 参考URL

- [Revit 開発者用ガイド ジャーナルファイルについて](https://help.autodesk.com/view/RVTLT/2025/JPN/?guid=GUID-477C6854-2724-4B5D-8B95-9657B636C48D)
- [Autodesk Support Revit ジャーナル ファイルの場所](https://www.autodesk.co.jp/support/technical/article/caas/sfdcarticles/sfdcarticles/JPN/Location-of-journal-files.html)
- [Revitのジャーナルファイルを利用する_説明編](https://amdlaboratory.com/amdblog/revit%e3%81%ae%e3%82%b8%e3%83%a3%e3%83%bc%e3%83%8a%e3%83%ab%e3%83%95%e3%82%a1%e3%82%a4%e3%83%ab%e3%82%92%e5%88%a9%e7%94%a8%e3%81%99%e3%82%8b_%e8%aa%ac%e6%98%8e%e7%b7%a8/)
- [ジャーナルファイル?](https://forums.autodesk.com/t5/revit-architecture-forum/journal-files/td-p/7516975)
- [ジャーナルファイルを説明しました!!](https://forums.augi.com/showthread.php?50860-THE-JOURNAL-FILE-EXPLAINED)

***
### 拡張ストレージ
Revitのファイルにアドイン関連のデータなどを保存したい場合に使用します。

#### 参考URL
- [Revit 開発者用ガイド 拡張ストレージ](https://help.autodesk.com/view/RVT/2025/JPN/?guid=Revit_API_Revit_API_Developers_Guide_Advanced_Topics_Storing_Data_in_the_Revit_model_Extensible_Storage_html)

***
### Revit起動時、終了時の処理の実装
インターフェース「IExternalApplication」を実装して使用します。
「IExternalApplication」には2つの抽象メソッド「OnStartup」「OnShutdown」があります。
Revit起動時にはOnStartup()が、終了時にはOnShutdown()が呼び出されます。
OnStartup()では設定ファイルの読み込みのような、最初に最初に行っておきたい初期処理を書くと便利です。
また私の所属していたプロジェクトでは、アドインを起動するためのボタンの作成処理も、このOnstartup()の中で行っていました。

#### 参考URL
- [Revit 開発者用ガイド 外部アプリケーション](https://help.autodesk.com/view/RVT/2022/JPN/?guid=Revit_API_Revit_API_Developers_Guide_Introduction_Add_In_Integration_External_Application_html)

- [RevitAPI屋さん RevitAPIのプログラムをタブ・リボン・ボタンでアドイン化](https://revitapiyasan.com/ribbontab/)

***
### ユーザーの操作に合わせて特定の処理を実行
ユーザーが特定の操作を実行しようとするときや、実行された直後に特定の処理を行いたい場合のため、Revit APIには様々なイベントが定義されています。

どのようなイベントがあるか、イベントの登録、キャンセル方法は下記の参考URLから確認できます。

##### リボンのタブアクティブ化イベントの検出
Revit上部のタブが選択状態になった際や、未選択状態になったタイミングのイベントも接続できます。

#### 参考URL
- [Revit 開発者用ガイド イベント](https://help.autodesk.com/view/RVT/2024/JPN/?guid=Revit_API_Revit_API_Developers_Guide_Advanced_Topics_Events_html)

- [Detecting Tab Activated Event in the Ribbon](https://adndevblog.typepad.com/manufacturing/2013/02/detecting-tab-activated-event-in-the-ribbon.html)

***
### ポストコマンド
PostCommand()を使用することで、ユーザーがアドインのボタンを押したのと同じように、
外部アドインをコードからも実行できます。
また、Revitのネイティブなコマンドも実行できます。
CommandIDを引数に指定してポストします。
ポストした後に実際に実行されるタイミングは、Revitの制御がAPIから戻ったときです。

#### 参考URL
- [Revit 開発者用ガイド コマンド](https://help.autodesk.com/view/RVT/2025/JPN/?guid=Revit_API_Revit_API_Developers_Guide_Advanced_Topics_Commands_html)

- [AutoCAD DevBlog Revit 2014 API の新機能](https://adndevblog.typepad.com/technology_perspective/2013/04/revit-2014-api-%E3%81%AE%E6%96%B0%E6%A9%9F%E8%83%BD.html) ※ページ真ん中あたりのPostCommand記載部分

#### 補足
ポストコマンドの終了を検出して、ポストコマンド後に後続処理を実行したい場合は、下記のURLを参考にしてください。
- [How do I continue after postcommand?](https://forums.autodesk.com/t5/revit-api-forum/how-do-i-continue-after-postcommand/td-p/10981164)

***
### 外部コマンド、外部アプリケーション
アドインを用いて作成できるコマンドのことです。
このコマンドをユーザーが実行することにより、アドインの処理を走らせることができます。

#### 参考URL
- [Revit 開発者用ガイド 配置オプション](https://help.autodesk.com/view/RVT/2022/JPN/?guid=Revit_API_Revit_API_Developers_Guide_Introduction_Getting_Started_Using_the_Autodesk_Revit_API_Deployment_Options_html)

***

### 外部アプリケーションを実行するためのボタンの種類
外部アプリケーションを実行するためのボタンには種類が色々とあります。
「Button」「PulldownButton」「SplitButton」等…

色々な種類のボタンを知っておくと、UIの幅も広がります。

#### 参考URL
- [Revit 開発者用ガイド リボン パネルとコントロール](https://help.autodesk.com/view/RVT/2022/JPN/?guid=Revit_API_Revit_API_Developers_Guide_Introduction_Add_In_Integration_Ribbon_Panels_and_Controls_html)

***
### 外部イベント
外部のスレッドとRevit APIの間の通信はすべて、アイドリングイベントもしくは外部イベントのハンドラ内で行われる必要があります。
外部イベントを使用すると、Revitが入力を受け入れる準備ができたときにRevit APIに関する処理の実行できます。
インターフェース「IExternalEventHandler」を実装したクラスを用意し、
Execute()にコールバックメソッド (Revit APIに関する処理) を渡す形になります。
ExternalEvent.Raise()を呼び出すと、その後Revitが入力を受け入れる準備ができたときに、 IExternalEventHandler.Execute()メソッドが呼び出されます。

#### 参考URL
- [Revit 開発者用ガイド 外部イベント](https://help.autodesk.com/view/RVT/2025/JPN/?guid=Revit_API_Revit_API_Developers_Guide_Advanced_Topics_External_Events_html)

***

## その他
### 異なるアドインのモジュールが共通のdllを使用している際に気を付けること
異なるアドインが共通のdllを使用している際に、読み込むdllのバージョンが異なる場合にRevitが例外をスローする場合があります。
この件については以下にまとめられています。

- [サードパーティ ライブラリ DLL の競合の処理](https://thebuildingcoder.typepad.com/blog/2017/06/handling-third-party-library-dll-conflicts.html)
- [依存関係バージョンの競合 (.DLL)](https://forums.autodesk.com/t5/revit-api-forum/dependency-version-conflict-assembly-binding-for-dlls/td-p/9485961)

プログラム自体に悪い箇所は見当たらない状態で、ジャーナルファイルなどに「メソッドが見つかりません」と出力される場合は、もしかしたら2つ以上のアドインでバージョン違いの同じdllを使っている可能性があるかもしれません。

C#の場合ですが、以下のようにして起動中のアプリが読み込んでいるアセンブリを取得できますので、アセンブリ名等で特定して、そのアセンブリバージョンを確認できます。
```C#
var assemblies = AppDomain.CurrentDomain.GetAssemblies();
```
想定しているバージョンと異なれば、読み込んでほしいアセンブリと、実際にRevitが読み込んでいるアセンブリのバージョンが異なるかもしれません。

[dll地獄](https://ja.wikipedia.org/wiki/DLL%E5%9C%B0%E7%8D%84)は参照されている一つのdllのバージョンが上がった際に旧バージョンとの互換性がなく不具合を起こしてしまうことですが、これと少し似ているかと思います。

詳しいことは分かりませんが、バージョン違いのdllが複数あっても、Revitが読み込むdllは一つだけのｙなので、バージョンごとに互換性がないと恐らくこういったエラーが発生してしまうのではないかと予想しています。

## 別記事にまとめたもの
- [アドインから外部アプリを10分ほど実行させ終了すると、Revitが強制終了してしまう件の解消](https://qiita.com/MetroOsamu/items/c490865095ce3a046a7d)
- [AdWindows.dllとは何か](https://qiita.com/MetroOsamu/items/f4a36525ed10a4c352d5)
- [アドイン開発時にRevitのバージョンをアップする際の作業について](https://qiita.com/MetroOsamu/items/4c8ac37dc3e65b150a8b)
- [Revitのメインウィンドウハンドルの取得方法](https://qiita.com/MetroOsamu/items/a913dc77bcdb3f88f39f)
- [DockablePaneとは](https://qiita.com/MetroOsamu/items/125e6168f0af3aa09d76)
- [Revit起動時、addinファイルで指定したアドインのロードが失敗してしまう際の解消方法](https://qiita.com/MetroOsamu/items/008f6575ea599d481d3b)
- [Revitの「リボンタブ」「リボンパネル」「ボタン」の作成方法](https://qiita.com/MetroOsamu/items/48f3cb4673f9aac0b7ec)
- [Revit2019、2021、2024でRevitLookupを使用して拡張ストレージの中身を確認する方法](https://qiita.com/MetroOsamu/items/1af7a7a3923523189732)
- [拡張ストレージ周辺の基本的な操作 (値の保存、復元など)](https://qiita.com/MetroOsamu/items/441bb03d9349a9cb56d0)
- [「License Managerが機能してないか、正しくインストールされていません。」というエラーが出て、Revitが起動しないときの対処法](https://qiita.com/MetroOsamu/items/023bf4cfc294e4c0e3fe)
- [Revitのダウンロード方法](https://qiita.com/MetroOsamu/items/547e4ad463b2299a8a6e)

## 役に立つサイト

### [The Building Coder](https://thebuildingcoder.typepad.com/)
Autodeskのエンジニアのブログです。
RevitAPIに関する情報の記事が多く載せられています。

### [RevitAPI屋さん コピペで使えるコード集](https://revitapiyasan.com/)
Revitアドイン開発者がRevit APIのコード集を掲載しているサイトです。

### [Technology Perspective from Japan](https://adndevblog.typepad.com/technology_perspective/)
オートデスク株式会社のブログです。
Revitに関する情報も掲載されています。

### [Revit Lab](https://www.revit-lab.com/) 
Revitに関するいろいろな知識を記載されています。
以下によく読んでいたページをピックアップしてみました。
- [BIMとは？Revitとは？何ぞや](https://www.revit-lab.com/2019/09/bimrevit.html)
- [BIMの目的](https://www.revit-lab.com/2020/11/bim.html)
- [ファイルを開く前に知っておくことで打線組んでみた](https://www.revit-lab.com/2017/08/blog-post_26.html)
- [とりあえず覚えるツールで打線組んでみた　まずはチラ見](https://www.revit-lab.com/2017/08/blog-post_10.html)

### [AUGI：Revit](https://forums.augi.com/forumdisplay.php?93-Revit)
オートデスク製品ユーザのためのコミュニティであるAUGI (Autodesk User Group International) のRevitのページです。