概要

Revitのアドイン開発時に、Revitのバージョンを上げたいということになった場合の作業についてまとめてみました。
Revitのバージョンを上げたいというのは、例えばRevit2019 → Revit2024に変更する、というような形です。

RevitAPIについて

RevitAPIは、Revitのバージョンそれぞれにdllがあります。例えばRevit2021だったらRevit2021用のRevitAPI、Revit2024だったらRevit2024用のRevitAPIのdllがあります。

RevitAPIのdllは、Revitがインストールされているフォルダの同階層にあります。

C:\Program Files\Autodesk\Revit (バージョン)\RevitAPI.dll
C:\Program Files\Autodesk\Revit (バージョン)\RevitAPIUI.dll
C:\Program Files\Autodesk\Revit (バージョン)\AdWindows.dll
※(バージョン)には2019や2021等のバージョンが入ります。
※AdWindows.dllについてはこちらも参照ください。

作業

STEP1

まずはアドインで使用しているAPIのdllを古いものから新しいものへ変更します。
例えばIDEにVisual Studioを使用している場合は、RevitAPIを参照設定しているプロジェクトについて、参照設定の変更を行います。
例)
今までの参照設定：C:\Program Files\Autodesk\Revit 2019\RevitAPI.dll
新しい参照設定　：C:\Program Files\Autodesk\Revit 2024\RevitAPI.dll

STEP2

アドインのdllについて、.NET Frameworkのバージョンを必要に応じ変更します。例えばIDEにVisual Studioを使用している場合は、各プロジェクトのプロパティ > アプリケーション > 対象のフレームワークから変更します。

どのフレームワークに変更が必要かは、以下のようなサイトが参考になります。

STEP3

STEP2で示したサイトに、Revitのバージョンアップに伴うAPIの仕様変更の記載があるので、参考にしながらAPIの仕様が変わったクラスやメソッドの部分を適宜修正していきます。

ビルドを通してみて、ビルドエラーを確認しながら行うもの良さそうです。

STEP4

当たり前ですがアドインの処理でRevitのバージョンに関わるような処理がある部分 (例えば、Revitのバージョンによってアドインの挙動が変わるような分岐を行っている場合) や、ビルド後コマンドライン等の設定でRevitのバージョンに関わる処理の部分は、そのような箇所も対応が必要です。そのようなアドインの仕様に関わる箇所を修正していきます。また、.addinファイル内の記載の変更も行っていきます。

STEP5

Revitを起動しアドインの動作確認・テストを行い、問題なさそうなら対応完了になります。