{"draftJsState":{"blocks":[{"data":{},"depth":0,"entityRanges":[{"key":0,"length":23,"offset":131},{"key":1,"length":8,"offset":172}],"inlineStyleRanges":[],"text":"В сегодняшней статье разберём создание плагина для Revit с нуля. Для этого нам потребуется предустановленный Revit, Visual Studio (инструкция по установке), и, собственно, алгоритм, который будет выполнять наш плагин. Статья может быть полезна в том числе и тогда, когда вы написали плагин, но подключить к Revit его не получается.","type":"unstyled","key":"6qd97"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"Порядок действий","type":"header-three","key":"k6o4"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"Создание проекта Visual Studio","type":"ordered-list-item","key":"2cevv"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"Написание кода и его компиляция","type":"ordered-list-item","key":"26hvs"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"Создание addin-файла и подключение его к Revit","type":"ordered-list-item","key":"26ge5"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"Создание проекта для плагина","type":"header-three","key":"3f7le"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"Запустим Visual Studio и создадим новый проект на шаблоне \"Библиотека классов .NET Framework\":","type":"unstyled","key":"5p8i9"},{"data":{"image":{"id":"64cf574e2f59ab32639a162b"}},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"Создание нового проекта","type":"atomic:image","key":"3qfdl"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"Далее подгрузим ссылки на RevitAPI и RevitAPIUI. Это стандартные библиотеки, используемые во всех Revit-плагинах.","type":"unstyled","key":"2bpof"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"","type":"unstyled","key":"352jj"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"1. В правой части окна в панели \"Обозреватель решений\" кликаем правой кнопкой мыши (далее — ПКМ) на строку \"Ссылки\", жмём \"Добавить ссылку\":","type":"unstyled","key":"3mkh3"},{"data":{"image":{"id":"64cf587b803a3125bc540668"}},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"Заходим в окно добавления ссылок","type":"atomic:image","key":"duusl"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"2. В появившемся в окне жмём \"Обзор\" и переходим в папку C:\\Program Files\\Autodesk\\Revit 2023 (версия Revit может отличаться):","type":"unstyled","key":"drkeo"},{"data":{"image":{"id":"64cf58f3397e115a73593b57"}},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"Переходим в C:\\Program Files\\Autodesk\\Revit 2023 ","type":"atomic:image","key":"cj682"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"3. Находим файлы RevitAPI.dll, RevitAPIUI.dll, выделяем их и жмём \"Добавить\":","type":"unstyled","key":"42j8o"},{"data":{"image":{"id":"64cf5952bbd9a65c8d97ac4e"}},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"Добавляем ссылки","type":"atomic:image","key":"7kh55"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"4. Затем в менеджере ссылок ставим галочки рядом с этими файлами и добавляем их в проект:","type":"unstyled","key":"3d3ul"},{"data":{"image":{"id":"64cf59852b27db031832e099"}},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"","type":"atomic:image","key":"4otaq"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"Теперь в нашем проекте есть ссылки на Revit API, и мы можем использовать его в нашем коде, а Visual Studio поймёт, что мы от неё хотим. Остался небольшой штрих (лучше не забывать про него, иначе папка с итоговой dll разрастётся довольно сильно).","type":"unstyled","key":"9sk0s"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"В Обозревателе решений раскрываем список ссылок, по очереди выделяем их и в свойствах \"Копировать локально\" ставим False:","type":"unstyled","key":"9da49"},{"data":{"image":{"id":"64cf5a4470a09b240150fb32"}},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"","type":"atomic:image","key":"1aspt"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"Теперь можно начинать писать код.","type":"unstyled","key":"fqit8"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"Написание пользовательской команды","type":"header-three","key":"b2q6v"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"В этой статье мы разберём создание пользовательской команды, которая появится в меню \"Надстройки\" — \"Внешние инструменты\". Потом для этой команды можно будет создать кнопку в интерфейсе Revit или отдельную панель.","type":"unstyled","key":"eglb6"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"Чтобы Revit понял, что мы пишем именно внешнюю команду, а не вспомогательный класс или что-то ещё, нам надо реализовать интерфейс IExternalCommand. Для этого к имени класса добавим \" : IExternalCommand\", что означает, что наш класс будет наследовать этот интерфейс:","type":"unstyled","key":"27cda"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"public class FirstRevitCommand : IExternalCommand","type":"blockquote","key":"9p720"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"Visual Studio подсветит нам красным наименование интерфейса. Посмотрим, в чём дело:","type":"unstyled","key":"3u9l"},{"data":{"image":{"id":"64cf5bba80ac945fa1177e60"}},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"Не удалось найти тип или имя пространства имён","type":"atomic:image","key":"8n1ik"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"Дело в том, что в начале файла надо было добавить using Autodesk.Revit.UI;, то есть показать программе, что в этом файле мы используем всё, что есть в этом файле ссылки в данном пространстве имён. В прочем, можно и не дописывать руками: жмём Alt+Enter или Ctrl+., как и сказано во всплывающей подсказке и Visual Studio сама предложит исправить ошибку.","type":"unstyled","key":"1k00f"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"После исправления текст останется красным, вновь наведём и вновь посмотрим предложенные решения:","type":"unstyled","key":"albeg"},{"data":{"image":{"id":"64cf5c87bbd9a65c8d9d0ddf"}},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"","type":"atomic:image","key":"dvbo0"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"Дело в том, что наследуя какой либо интерфейс, мы обязаны реализовать всего его методы. В данном случае метод один: Execute, что и логично: команда должна знать, как её исполнять. Реализуем интерфейс.","type":"unstyled","key":"b61v7"},{"data":{},"depth":0,"entityRanges":[{"key":2,"length":18,"offset":52}],"inlineStyleRanges":[],"text":"Далее используем тот код, который мы уже написали в статье про макросы","type":"unstyled","key":"cc4ha"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"Скопируем его и вставим внутрь метода Execute вместо того кода, который был создан Visual Studio при реализации интерфейса:","type":"unstyled","key":"ets92"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"UIDocument uidoc = this.ActiveUIDocument;\nDocument doc = uidoc.Document;\nReference myRef = uidoc.Selection.PickObject(ObjectType.Element, \"Выберите элемент для вывода его Id\");\nElement element = doc.GetElement(myRef);\nElementId id = element.Id;\nTaskDialog.Show(\"Hello world!\", id.ToString());","type":"blockquote","key":"3t0io"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"У нас появятся 2 ошибки:","type":"unstyled","key":"cl9k3"},{"data":{"image":{"id":"64cf5d46e419222aceac1f78"}},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"","type":"atomic:image","key":"ak5ug"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"Разберёмся с ними. И так, первая — программа ругается на переменную uidoc. Дело в том, что внутри команды к текущему документу надо обращаться через переменную commandData (которую мы передаём в метод Execute):","type":"unstyled","key":"31eba"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"UIDocument uidoc = commandData.Application.ActiveUIDocument;","type":"blockquote","key":"bd5lg"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"А проблема с методом Execute в том, что тип возвращаемого значения у него Result, а наш метод пока ничего не возвращает. Допишем в конце:","type":"unstyled","key":"hns3"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"return Result.Succeeded;","type":"blockquote","key":"bjrnf"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"то есть скажем коду, что в данном случае, если он дошёл до этого места при исполнении, то результат выполнения — успешный.","type":"unstyled","key":"4rgsk"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"Добавим ещё немного кастомизации в вывод итогового сообщения и получим следующий результат:","type":"unstyled","key":"2aeg6"},{"data":{"image":{"id":"64cf5fb34a27621bc28724bb"}},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"","type":"atomic:image","key":"8622k"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"Но это ещё не всё. Все надстройки для Revit должны иметь уникальный идентификатор (Guid), совпадающий в коде и в addin-файле, а также атрибут настроек транзакции. ","type":"unstyled","key":"8h5ht"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"Чтобы добавить Guid, добавим следующую строку в начало класса:","type":"unstyled","key":"agcuu"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"static AddInId addinId = new AddInId(new Guid(\"0F296157-A2DC-4532-BB1B-6D6D3462F15A\"));","type":"blockquote","key":"2ev4h"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"Guid 0F296157-A2DC-4532-BB1B-6D6D3462F15A — это случайный Guid моего плагина. Вам нужно сделать свой, таким образом: Средства — Создать Guid:","type":"unstyled","key":"6ebmn"},{"data":{"image":{"id":"64cf62002b27db03183f65b1"}},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"Копируем Guid в буфер обмена","type":"atomic:image","key":"ais9h"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"Скопировав Guid, вставляем его в код вместо моего, не забыв убрать фигурные скобки в начале и в конце.","type":"unstyled","key":"73ek1"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"Чтобы добавить атрибут транзакции, добавим строку ","type":"unstyled","key":"e5ce3"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"[Autodesk.Revit.Attributes.TransactionAttribute(Autodesk.Revit.Attributes.TransactionMode.Manual)]","type":"blockquote","key":"7bcmh"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"перед классом.","type":"unstyled","key":"8hu71"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"Итоговый результат:","type":"unstyled","key":"ea601"},{"data":{"image":{"id":"64cf6e958b9e943477993c0b"}},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"","type":"atomic:image","key":"9sfk"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"","type":"unstyled","key":"145jd"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"Код можно скомпилировать (Сборка — Собрать решение) и получить итоговую DLL по адресу, где мы сохранили проект, в папках bin/Debug.","type":"unstyled","key":"3c286"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"Создание addin-файла ","type":"header-three","key":"2q2cs"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"Этот шаг вызывает больше всего затруднений у новичков (и не только новичков). Давайте подробно разбираться.","type":"unstyled","key":"6o8j3"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"Для начала нам нужен addin-файл. Это обычный файл блокнота с расширением addin. Обычно его сохраняют один раз и добавляют в шаблон нового проекта Visual Studio, либо создают на основе существующего.","type":"unstyled","key":"4fh9"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"Итак, создадим *.txt файл и вставим в него следующий код","type":"unstyled","key":"agoes"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"\n \n FirstRevitCommand\n FirstRevitPlugin.dll\n 0F296157-A2DC-4532-BB1B-6D6D3462F15A\n FirstRevitPlugin.FirstRevitCommand\n Моя первая команда\n MyId\n \n \n","type":"blockquote","key":"7qgcl"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"В строку AddInIn вставим наш Guid из предыдущего пункта (в точном соответствии с тем, который в коде). ","type":"unstyled","key":"alc7b"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"Переименуем файл в FirstRevitPlugin.addin и перенесём в папку с проектом Visual Studio. Добавим файл к проекту:","type":"unstyled","key":"5clb9"},{"data":{"image":{"id":"64cf6a662b27db03184bc2a4"}},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"ПКМ на имя решения — Добавить — Существующий элемент","type":"atomic:image","key":"c6u44"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"Присоединим addin-файл и откроем его в Visual Studio. Благодаря подсветки синтаксиса убедимся, что всё хорошо, все открывающие и закрывающие угловые скобки на месте.","type":"unstyled","key":"c74l4"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"Рассмотри подробнее поля файла:","type":"unstyled","key":"ak712"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"AddIn Type=\"Command\"","type":"unordered-list-item","key":"5c6n2"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"Варианты: Command, Application. В нашем случае это команда, не приложение.","type":"unstyled","key":"fu6j9"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"FirstRevitCommand","type":"unordered-list-item","key":"6r74u"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"FirstRevitPlugin.dll","type":"unordered-list-item","key":"5raqi"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"0F296157-A2DC-4532-BB1B-6D6D3462F15A","type":"unordered-list-item","key":"9mq3v"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"Имя плагина, путь к сборке и Guid. В данном случае мы скопируем dll и addin файлы в одну папку, но иногда это не так, и тогда нужно указывать полный или краткий (только по вложенным папкам) путь. Guid же должен точно соответствовать коду.","type":"unstyled","key":"1134c"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"FirstRevitPlugin.FirstRevitCommand","type":"unordered-list-item","key":"74u6d"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"Это важная строка. Тут мы указываем полное имя класса с именем его пространства имён (namespace) через точку:","type":"unstyled","key":"ale54"},{"data":{"image":{"id":"64cf6fd3803a3125bc7657bc"}},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"Формат строки: Namespace.ClassName. Должно быть точное соответствие","type":"atomic:image","key":"83k9"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"Моя первая команда","type":"unordered-list-item","key":"e09n8"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"MyId ","type":"unordered-list-item","key":"4debj"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"","type":"unordered-list-item","key":"3bevf"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"Тут мы прописываем имя команды в списке команд, а также описание разработчика, которое появится один раз в окне загрузки внешней команды.","type":"unstyled","key":"1ur8l"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"Я очень рекомендую править addin-файл в Visual Studio, чтобы избежать ошибок в связи с отсутствующими скобками. Обычно первые попытки с новым addin-файлом вызывают ошибки при подключении плагина, так что наберитесь терпения и будьте внимательны.","type":"unstyled","key":"2jda3"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"Подключение плагина к Revit","type":"header-three","key":"8nc0c"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"Скопируем addin-файл и dll с плагином в папку C:\\ProgramData\\Autodesk\\Revit\\Addins\\2023","type":"unstyled","key":"4ubul"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"Запустим Revit. При запуске появится вот такое окно:","type":"unstyled","key":"6jicd"},{"data":{"image":{"id":"64cf7219709f354828b6da90"}},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"","type":"atomic:image","key":"devl6"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"Смело жмём \"Всегда загружать\" и открываем любой файл","type":"unstyled","key":"ml56"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"На вкладке \"Надстройки\" появится кнопка \"Внешние инструменты\", а при раскрытии — наша команда:","type":"unstyled","key":"7hd6l"},{"data":{"image":{"id":"64cf726b44f4277a13745214"}},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"","type":"atomic:image","key":"eo8gt"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"Запустим её:","type":"unstyled","key":"2eon5"},{"data":{"image":{"id":"64cf728c267b6a31f44ffee2"}},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"","type":"atomic:image","key":"8efo8"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"Мы ничего не забыли, всё отлично работает!","type":"unstyled","key":"2aqeq"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"Надеюсь, у вас получится достичь того же результата и победить все возникающие по пути ошибки. А в следующей статье мы продолжим изучать основы языка C#.","type":"unstyled","key":"6bljn"},{"data":{"image":{"id":"655cad910e1c8d4a71292944"}},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"","type":"atomic:image","key":"c0c51"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"","type":"unstyled","key":"fps6p"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"","type":"unstyled","key":"dq14v"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"","type":"marker","key":"IIa8zHMXAWItBeWhlWVf"}],"entityMap":{"0":{"data":{"url":"https://dzen.ru/a/ZLzRGzjXHjE4jbMt"},"mutability":"MUTABLE","type":"LINK"},"1":{"data":{"url":"https://dzen.ru/a/ZLubnaVIDkfTXQsy"},"mutability":"MUTABLE","type":"LINK"},"2":{"data":{"url":"https://dzen.ru/a/ZLubnaVIDkfTXQsy"},"mutability":"MUTABLE","type":"LINK"}}},"mentions":[]}