アドインの登録

Revit 内部で表示するには、外部コマンドや外部アプリケーションを登録する必要があります。.addin マニフェスト ファイルに追加することで登録できます。

外部コマンドやアプリケーションが Revit に一覧表示される順番は、Revit の起動時に読み込まれる順序によって決まります。

マニフェスト ファイル

Revit API アプリケーションは .addin マニフェスト ファイルを介して Revit に登録されます。ユーザのシステム上の次の 2 つの場所のいずれかにマニフェスト ファイルが配置されていると、Revit によって自動的に読み込まれます。

「アプリケーション データ」内のユーザ固有ではない場所:

• C:\ProgramData\Autodesk\Revit\Addins\Revit 2018\

「アプリケーション データ」内のユーザ固有の場所:

• C:\Users<ユーザ>\AppData\Roaming\Autodesk\Revit\Addins\Revit 2018\

これらの場所にある .addin という名前のすべてのファイルが Revit の起動時に読み込まれ、処理されます。ユーザ固有の場所やすべてのユーザの場所の両方にあるすべてのファイルがまとめて処理され、アルファベット順でロードされます。すべてのユーザのマニフェスト ファイルがユーザ固有のマニフェスト ファイルと同じ名前を持っている場合は、すべてのユーザのマニフェスト ファイルが無視されます。各マニフェスト ファイル内の外部コマンドや外部アプリケーションが、リストされている順番にロードされます。

1 つの ExternalCommand を追加する基本ファイルは次のようになります。

<?xml version="1.0" encoding="utf-8" standalone="no"?>
<RevitAddIns>
        <AddIn Type="Command">
                <Assembly>c:\MyProgram\MyProgram.dll</Assembly>
                <AddInId>76eb700a-2c85-4888-a78d-31429ecae9ed</AddInId>
                <FullClassName>Revit.Samples.SampleCommand</FullClassName>
                <Text>Sample command</Text>
                <VendorId>ADSK</VendorId>
                <VendorDescription>Autodesk, www.autodesk.com</VendorDescription> 
                <VisibilityMode>NotVisibleInFamily</VisibilityMode>
                <Discipline>Structure</Discipline>
                <Discipline>Architecture</Discipline>
                <AvailabilityClassName>Revit.Samples.SampleAccessibilityCheck</AvailabilityClassName>
                <LongDescription>
                        This is the long description for my command.
                        This is another descriptive paragraph, with notes about how to use the command properly.
                </LongDescription>
                <TooltipImage>c:\MyProgram\Autodesk.png</TooltipImage>
                <LargeImage>c:\MyProgram\MyProgramIcon.png</LargeImage>
        </AddIn>
</RevitAddIns>

1 つの ExternalApplication を追加する基本ファイルは次のようになります。

<?xml version="1.0" encoding="utf-8" standalone="no"?>
<RevitAddIns>
<AddIn Type="Application">
                <Name>SampleApplication</Name>
                <Assembly>c:\MyProgram\MyProgram.dll</Assembly>
                <AddInId>604B1052-F742-4951-8576-C261D1993107</AddInId>
                <FullClassName>Revit.Samples.SampleApplication</FullClassName>
                <VendorId>ADSK</VendorId>
                <VendorDescription>Autodesk, www.autodesk.com</VendorDescription>
</AddIn>
</RevitAddIns>

1 つの DB レベルの外部アプリケーションを追加する基本ファイルは次のようになります。

<?xml version="1.0" encoding="utf-8" standalone="no"?>
<RevitAddIns>
<AddIn Type="DBApplication">
                <Assembly>c:\MyDBLevelApplication\MyDBLevelApplication.dll</Assembly>
                <AddInId>DA3D570A-1AB3-4a4b-B09F-8C15DFEC6BF0</AddInId>

                <FullClassName>MyCompany.MyDBLevelAddIn</FullClassName>

                <Name>My DB-Level AddIn</Name>                    
                <VendorId>ADSK</VendorId>
                <VendorDescription>Autodesk, www.autodesk.com</VendorDescription>
</AddIn>
</RevitAddIns>

1 つのマニフェスト ファイルで複数のアドインを提供できます。

次の表では、使用可能な XML タグについて説明します。

マニフェスト ファイル用の .NET アドイン ユーティリティ

.NET ユーティリティ DLL である RevitAddInUtility.dll には、Revit アドイン マニフェスト ファイルの読み込み、書き込み、修正が可能な専用の API が備わっています。これは、製品インストーラやスクリプトでの使用を目的としています。SDK インストール フォルダ内の RevitAddInUtility.chm ヘルプ ファイルの API ドキュメントを参照してください。

public void ManifestFile()
{
        //create a new addin manifest
        RevitAddInManifest Manifest = new RevitAddInManifest();

        //create an external command
        RevitAddInCommand command1 = new RevitAddInCommand("full path\\assemblyName.dll", 
        Guid.NewGuid(), "namespace.className", "ADSK");
        command1.Description = "description";
        command1.Text = "display text";

        // this command only visible in Revit MEP, Structure, and only visible 
        // in Project document or when no document at all
        command1.Discipline = Discipline.Mechanical | Discipline.Electrical |
                                Discipline.Piping | Discipline.Structure;
        command1.VisibilityMode = VisibilityMode.NotVisibleInFamily;

        //create an external application
        RevitAddInApplication application1 = new RevitAddInApplication("appName",
        "full path\\assemblyName.dll", Guid.NewGuid(), "namespace.className", "ADSK");

        //add both command(s) and application(s) into manifest
        Manifest.AddInCommands.Add(command1);
        Manifest.AddInApplications.Add(application1);

        //save manifest to a file
        RevitProduct revitProduct1 = RevitProductUtility.GetAllInstalledRevitProducts()[0];
        Manifest.SaveAs(revitProduct1.AllUsersAddInFolder + "\\RevitAddInUtilitySample.addin");
        }

public void ReadManifest()
{
        RevitProduct revitProduct1 = RevitProductUtility.GetAllInstalledRevitProducts()[0];

        RevitAddInManifest revitAddInManifest = 
     Autodesk.RevitAddIns.AddInManifestUtility.GetRevitAddInManifest(
          revitProduct1.AllUsersAddInFolder + "\\RevitAddInUtilitySample.addin");
}

アドイン データ パスにアクセスする

Autodesk.Revit.ApplicationServices.Application.CurrentUsersAddinsDataFolderPath では、現在の Revit バージョンおよび現在のユーザのアドイン データ フォルダ(%appdata%\Autodesk\Revit\Autodesk Revit 2025\AddinsData など)にアクセスすることができます。