Эталонный плагин
Папка с эталонными плагинами для версии Целевой программы
Для каждой версии Целевой программы в сетевом хранилище предусмотрена отдельная папка, содержащая эталонные версии плагинов, используемые Менеджером плагинов для централизованного распространения.
Базовый путь к каталогу эталонных плагинов:
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.
