Перейти к основному контенту

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

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

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

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

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

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

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

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

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

  • Каталоги со сборками плагинов;
  • Файлы конфигурации AddinManager (.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%).

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

  • Пути в файле должны полностью соответствовать фактической структуре сетевого каталога.
  • Каждый .fst файл, указанный в реестре эталонных файлов, должен физически существовать в каталоге версии Целевой программы.
  • При обновлении плагина необходимо заменить содержимое каталога эталонного плагина и версию плагина в эталонном реестре плагинов.