【Revit API】03-Revit API-AddInManager安裝

372

在進行Revit API二次開發時，重複地載入dll檔測試撰寫的程式碼是必須的，在開始教學之前，先提供 Add-In Manager安裝檔給各位，讓大家節省繁雜的安裝動作，下載下來後，一直點選下一步到結束即可，我做的這個安裝檔會一次安裝好Revit 2015-2020版的RevitLookup與Add-In Manager，安裝檔連結請點選這裡。
這裡也提供Add-In Manager的dll與addin檔案，教學的部分會透過這兩個檔案說明，如何讓Revit新增外掛，請點選這裡。

下載下來的addin檔案，主要會放置在兩個位置，當Revit啟動時，會自動偵測是否有要啟動的外掛。

• C:\ProgramData\Autodesk\Revit\Addins\Revit版本 –> 所有使用者
• C:\Users\使用者名稱\AppData\Roaming\Autodesk\Revit\Addins\Revit版本 –> 特定使用者

下方addin檔案中，紅字的部分需特別留意，<Assembly> 表示的是要驅動的dll檔案位置，<ClientId> 是GUID(全域唯一識別碼)，主要目的是產生完全唯一的數字，不得重複，可於以下網址生成複製貼上，https://www.guidgenerator.com/

<?xml version="1.0" encoding="utf-8"?>
<RevitAddIns>
   <AddIn Type="Command">
      <Assembly>C:\ProgramData\Autodesk\Revit\Addins\2020\AddInManager.dll</Assembly>
      <ClientId>9411ad7a-754d-4c83-94b6-f552d1e8b176</ClientId>
      <FullClassName>AddInManager.CAddInManager</FullClassName>
      <Text>Add-In Manager (Manual Mode)</Text>
      <VisibilityMode>AlwaysVisible</VisibilityMode>
      <LanguageType>Unknown</LanguageType>
      <VendorId>ADSK</VendorId>
      <VendorDescription>Autodesk, www.autodesk.com</VendorDescription>
  </AddIn>
  <AddIn Type="Command">
      <Assembly>C:\ProgramData\Autodesk\Revit\Addins\2020\AddInManager.dll</Assembly>
      <ClientId>95cda59a-8d90-40c6-930b-d7be8544bac1</ClientId>
      <FullClassName>AddInManager.CAddInManagerFaceless</FullClassName>
      <Text>Add-In Manager (Manual Mode, Faceless)</Text>
      <VisibilityMode>AlwaysVisible</VisibilityMode>
      <LanguageType>Unknown</LanguageType>
      <VendorId>ADSK</VendorId>
      <VendorDescription>Autodesk, www.autodesk.com</VendorDescription>
  </AddIn>
  <AddIn Type="Command">
      <Assembly>C:\ProgramData\Autodesk\Revit\Addins\2020\AddInManager.dll</Assembly>
      <ClientId>83b1ba22-4e3c-4403-8fa5-4dd74ff7544a</ClientId>
      <FullClassName>AddInManager.CAddInManagerReadOnly</FullClassName>
      <Text>Add-In Manager (ReadOnly Mode)</Text>
      <VisibilityMode>AlwaysVisible</VisibilityMode>
      <LanguageType>Unknown</LanguageType>
      <VendorId>ADSK</VendorId>
      <VendorDescription>Autodesk, www.autodesk.com</VendorDescription>
  </AddIn>  
</RevitAddIns>

修改好addin檔案內文，將檔案放置如下位置即可新增Revit外掛。

放置完成開啟Revit後，即可在增益集 –> 外部工具中，看到新增的Add-In Manager外掛了。

上方提供連結的addin、dll檔案，是預設為Revit 2020、給本機所有使用者使用，可練習修改addin內文給Revit其他版本，或者特定使用者才能使用。

Add-In Manager的使用方式，我會在之後講解，主要功能是當撰寫好了dll檔，如何透過Add-In Manager來運作(點選這裡看最末段落說明)，另一是透過 Add-In Manager 生成addin檔案(點選這裡看最末段落說明)。