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

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

Для каждой версии Целевой программы в сетевом хранилище предусмотрена отдельная папка, содержащая эталонные версии плагинов, используемые Менеджером плагинов для централизованного распространения.

Базовый путь к каталогу эталонных плагинов:

Z:\BIM\7. Дополения\1. Внутренние\{ЦЕЛЕВАЯ ПРОГРАММА}

Внутри данного каталога для каждой версии Revit создаётся отдельная папка:

Z:\BIM\7. Дополения\1. Внутренние\{ЦЕЛЕВАЯ ПРОГРАММА}\{ВЕРСИЯ}

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

Каталог конкретной версии Целевой программы содержит:

• Каталоги со сборками плагинов;
• Файлы конфигурации Менеджера плагинов (.fst);
• Файлы манифесты плагинов (.addin) при необходимости.

Таким образом, типовое содержимое каталога версии Целевой программы выглядит следующим образом:

Z:\BIM\7. Дополения\1. Внутренние\2. Revit\2021\
 ├─ adm_MarksDigital.addin
 ├─ adm_MarksDigital.fst
 ├─ adm_MarksDigital\
 ├─ gen_ModelExporter.addin
 ├─ gen_ModelExporter.fst
 ├─ gen_ModelExporter\
 └─ ...

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

Файл .fst описывает правила развертывания плагина на рабочем месте пользователя и представляет из себя XML документ со следующей структурой:

<FileConfiguration>

Каждый файл описывает один плагин и содержит следующие элементы.

• <FilePath> - Полный сетевой путь к .addin файлу эталонного плагина.
• <FileDestination> - Относительный путь назначения для .addin файла на локальной машине пользователя. Путь задаётся относительно профиля пользователя (%APPDATA%).
• <DirectoryPath> - Полный сетевой путь к каталогу эталонного плагина.
• <DirectoryDestination> - Относительный путь назначения каталога плагина на локальной машине пользователя. Путь задаётся относительно профиля пользователя (%APPDATA%).

Пример файла:

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

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

• Пути в файле должны полностью соответствовать фактической структуре сетевого каталога.
• Каждый .fst файл, указанный в реестре эталонных файлов, должен физически существовать в каталоге версии Целевой программы.
• При обновлении плагина необходимо заменить содержимое каталога эталонного плагина и версию плагина в эталонном реестре плагинов.
• Перед сохранением файла необходимо проверять XML на корректность с помощью Notepad++ плагина XML Tools функцией Check XML syntax now.