Эталонный реестр плагинов

Общая информация

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

Файл располагается по следующему пути:

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

Данный файл является единственным источником истины для AddinManager при определении:

• какие плагины должны быть установлены пользователю;

• какие версии плагинов являются актуальными;

• откуда загружать .addin и конфигурационные файлы;

• для каких ролей пользователей доступны конкретные плагины.
  

Структура файла

Корневым элементом является коллекция:

<ArrayOfAddinInfo>

Каждый отдельный плагин описывается элементом:

<AddinInfo>

Каждый элемент <AddinInfo> описывает один плагин и содержит в себе следующие поля:

• <Name> - Уникальный идентификатор плагина, который соответствует наименованию Проекта плагина.
• <Version> - Версия плагина, которая используется для определения необходимости обновления. Формат версии — ВЕРСИЯ ЦЕЛЕВОЙ ПРОГРАММЫ.МАЖОР.МИНОР.ПАТЧ, например, 2019.10.2.43.
• <Path> - Полный сетевой путь к .addin файлу плагина. Данное поле может отсутствовать для пакетов Dynamo и других компонентов, которые не используют .addin файлы.
• <ConfigurationFilePath> - Путь к конфигурационному файлу плагина (.fst).
• <ValidUserType> - Тип пользователя (роль), для которого доступен плагин.

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

• Любое обновление плагина требует обновления версии.
• Изменение сетевой структуры без обновления файла приведёт к неработоспособности AddinManager.
• Для исключения плагина из распространения достаточно удалить соответствующий <AddinInfo> из файла.
• Файл должен оставаться корректным XML-документом. Любая ошибка структуры приводит к невозможности загрузки списка плагинов.