Plugins Manager

Данный инструмент решает проблему доставки обновлений и новых плагинов до пользователей.

PluginsManager - плагин для Revit, который позволяет создавать гибкое настраиваемое пространство для запуска команд из других плагинов. Данный инструмент вдохновлен проектом Revit Add-in Manager.

Плагин подгружает специально настроенные команды из всех dll файлов в выбранной папке и создает структуру из вкладок в отдельном окне. С PluginsManager становится достаточным просто обновить dll файл в папке на общем сервере, а для пользователей обновления становятся полностью бесшовными.

Установка

Плагин устанавливается с помощью Plugins Manager.msi. На данный момент поддерживаются версии Revit21-26

Запуск

Плагин рсполагается на вкладке "Надстройки" и при первом запуске предлагает выбрать папку с dll файлами.

После выбора папки и при последующих запусках будет появляться основное окно плагина

1. Кнопка пользовательских настроек: путь к папке с файлами dll и настройкой отображения вкладок (см. п. Настройки-пользователя)
2. Кнопка для синхронизации локальных файлов с файлами из выбранной папки (плагин создает локальную копию файлов в папке %appdata%/PluginsManager/temp
3. Вкладки. Гибко и быстро настраиваются (см. п. Настроить команды в папке)
4. Таблица с командами выбранной вкладки
5. Кнопки для запуска команд
6. Информация о плагине, которая указана в IS_DESCRIPTION или в <CmdDescription></CmdDescription> (см. п. "Настройка и дополнительные возможности")

Подготовка внешних dll файлов

Настройка прямо внутри кода плагина

Одним из вариантов пападания команды в окно плагина является добавление специальных полей прямо в класс с интерфейсом IExternalCommand:

public static string IS_TAB_NAME => "Название вкладки";
public static string IS_NAME => "Название команды";
public static string IS_IMAGE => "Название проекта.Resources.Название изображения.png";
public static string IS_DESCRIPTION => "Описание";

Для того, чтобы изображение считалось плагином, оно должно быть добавлено в ресурсы проекта и иметь свойство "Embedded resource"

Настройка из окна "Настроить команды в папке"

В окне "Настроить команды в папке" появляются все классы с интерфейсом IExternalCommand. Можно выбрать любой и настроить для него вкладку, название, описание и картинку. См. п. Настроить команды в папке

Настроить команды в папке

Чтобы появилась данная кнопка, нужно во время установки выбрать установку "Admin tools".

Данная надстройка позволяет изменять конфигурацию команд основного плагина - менять вкладки*, имена, описания и картинки.

Плагину доступны все dll файлы внтури указанной папки и все dll файлы в вложенных папках первого уровня.

Все настройки хранятся в рядом с исходными dll в файле commands_config.xml.

*В названии вкладки можно указать несколько вкладок через знак "|", чтобы команда попала сразу на несколько вкладок. Например, "АР|КР".

Настройки пользователя

В этом окне можно выбрать папку источника, отключить ненужные вкладки и выбрать роль.

Роль - поле для обозначения роли. По умолчанию "user". Если значение заменить на "manager", то станут доступны вкладки, у которых в названии есть решетка "#". Таким образом можно отделять команды и плагины для тестирвоания или для внутреннего использования.