# Эталонный плагин

### Папка с эталонными плагинами для версии Целевой программы

<span class="p1 pcustom">Для каждой версии Целевой программы в сетевом хранилище предусмотрена отдельная папка, содержащая эталонные версии плагинов, используемые Менеджером плагинов для централизованного распространения.</span>

<span class="p1 pcustom">Базовый путь к каталогу эталонных плагинов:</span>

<p class="callout info"><span class="p1 pcustom">Z:\\BIM\\7. Дополения\\1. Внутренние\\**{ЦЕЛЕВАЯ ПРОГРАММА}**</span></p>

<span class="p1 pcustom">Внутри данного каталога для каждой версии Revit создаётся отдельная папка:</span>

<p class="callout info"><span class="p1 pcustom">Z:\\BIM\\7. Дополения\\1. Внутренние\\**{ЦЕЛЕВАЯ ПРОГРАММА}\\{ВЕРСИЯ}**</span></p>

### Содержимое папки версии Целевой программы

<span class="p1 pcustom">Каталог конкретной версии Целевой программы содержит:</span>

- <span class="p1 pcustom">Каталоги со сборками плагинов;</span>
- <span class="p1 pcustom">Файлы конфигурации Менеджера плагинов (.fst);</span>
- <span class="p1 pcustom">Файлы манифесты плагинов (.addin) при необходимости.</span>

<span class="p1 pcustom">Таким образом, типовое содержимое каталога версии Целевой программы выглядит следующим образом:</span>

<p class="callout info"><span class="p1 pcustom">Z:\\BIM\\7. Дополения\\1. Внутренние\\2. Revit\\2021\\  
 ├─ adm\_MarksDigital.addin  
 ├─ adm\_MarksDigital.fst  
 ├─ adm\_MarksDigital\\  
 ├─ gen\_ModelExporter.addin  
 ├─ gen\_ModelExporter.fst  
 ├─ gen\_ModelExporter\\  
 └─ ...  
</span></p>

### Файл конфигурация .fst

<span class="p1 pcustom">Файл .fst описывает правила развертывания плагина на рабочем месте пользователя и представляет из себя XML документ со следующей структурой:</span>

<p class="callout info"><span class="p1 pcustom">&lt;FileConfiguration&gt;</span></p>

<span class="p1 pcustom">Каждый файл описывает один плагин и содержит следующие элементы.</span>

- <span class="p1 pcustom">**&lt;FilePath&gt;** - Полный сетевой путь к .addin файлу эталонного плагина.</span>
- <span class="p1 pcustom">**&lt;FileDestination&gt;** - Относительный путь назначения для .addin файла на локальной машине пользователя. Путь задаётся относительно профиля пользователя (%APPDATA%).</span>
- <span class="p1 pcustom">**&lt;DirectoryPath&gt;** - Полный сетевой путь к каталогу эталонного плагина.</span>
- <span class="p1 pcustom">**&lt;DirectoryDestination&gt;** - Относительный путь назначения каталога плагина на локальной машине пользователя. Путь задаётся относительно профиля пользователя (%APPDATA%).</span>

<span class="p1 pcustom">Пример файла:</span>

<p class="callout info"><span class="p1 pcustom">&lt;?xml version="1.0" encoding="utf-8"?&gt;  
&lt;FileConfiguration xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema"&gt;  
 &lt;FilePath&gt;**{ПУТЬ ДО ЭТАЛОННОГО ADDIN ФАЙЛА}**&lt;/FilePath&gt;  
 &lt;FileDestination&gt;**{ПУТЬ ПОЛЬЗОВАТЕЛЬСКОГО ADDIN ФАЙЛА}**&lt;/FileDestination&gt;  
 &lt;DirectoryPath&gt;**{ПУТЬ ДО ЭТАЛОННОЙ ПАПКИ ПЛАГИНА}**&lt;/DirectoryPath&gt;  
 &lt;DirectoryDestination&gt;**{ПУТЬ ДО ПОЛЬЗОВАТЕЛЬСКОЙ ПАПКИ ПЛАГИНА}**&lt;/DirectoryDestination&gt;  
&lt;/FileConfiguration&gt;</span></p>

### Правила работы с файлом

- <span class="p1 pcustom">Пути в файле должны полностью соответствовать фактической структуре сетевого каталога.</span>
- <span class="p1 pcustom">Каждый .fst файл, указанный в реестре эталонных файлов, должен физически существовать в каталоге версии Целевой программы.</span>
- <span class="p1 pcustom">При обновлении плагина необходимо заменить содержимое каталога эталонного плагина и версию плагина в эталонном реестре плагинов.</span>
- <span class="p1 pcustom">Перед сохранением файла необходимо проверять XML на корректность с помощью Notepad++ плагина XML Tools функцией **Check XML syntax now**.  
    </span>[![image.png](https://wiki.marksdigital.ru/uploads/images/gallery/2026-01/scaled-1680-/kzoimage.png)](https://wiki.marksdigital.ru/uploads/images/gallery/2026-01/kzoimage.png)