{"draftJsState":{"blocks":[{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"Использование Revit без плагинов представить сложно, так как плагины помогают заполнять необходимые параметры, создавать отверстия, создавать необходимые элементы ( внутренняя отделка стен). Короче, экономит уйму времени.","type":"unstyled","key":"d2v2t"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"Возможности исскусственного интелекта помогают нам быстрее писать код, поэтому в этой статье опишу, как быстро создать и добавить плагин к себе в Revit. ","type":"unstyled","key":"13oe1"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"Инструменты для написания кода плагина","type":"header-two","key":"cupe7"},{"data":{},"depth":0,"entityRanges":[{"key":0,"length":3,"offset":87},{"key":1,"length":13,"offset":146}],"inlineStyleRanges":[],"text":"Код для плагина возможно писать с помощью Visual Studio code, Visual Studio или других IDE. Каждый выбирает то, что им нравится, я остановился на Visual Studio: понятный интерфейс, встроенная нейросеть GitHub Copilot, которая помогает дописывать код. ","type":"unstyled","key":"9kib8"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"Язык для написания кода плагина","type":"header-three","key":"6bva0"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"В большинстве случаев используется язык C# для написания кода. Из плюсов выделяют следующее: ","type":"unstyled","key":"6tkai"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"Высокая производительность, так как C# является компилируемым (машиночитаемым) языком","type":"unordered-list-item","key":"929cm"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"Полный доступ к функциям .NET Framework и Revit API","type":"unordered-list-item","key":"c4fhn"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"Более строгая типизация, что может облегчить отладку и обнаружение ошибок на этапе компиляции ( сборки). ","type":"unordered-list-item","key":"18opi"},{"data":{},"depth":0,"entityRanges":[{"key":2,"length":14,"offset":17}],"inlineStyleRanges":[],"text":"Также рекомендую You-tude канал (кликабельно) для изучения языка. ","type":"unstyled","key":"2a16g"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"Шаги для написания кода","type":"header-three","key":"6ds2g"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[{"length":26,"offset":0,"style":"BOLD"}],"text":"Шаблоны для написания кода","type":"unstyled","key":"asnqm"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"Для облегчения взаимодействия кода с Revit используются преднастроенные шаблоны для Visual Studio. ","type":"unstyled","key":"9m940"},{"data":{},"depth":0,"entityRanges":[{"key":3,"length":10,"offset":0}],"inlineStyleRanges":[],"text":"Nice3point является готовой коллекцией шаблонов и инструментов для разработки плагинов к программе Revit. Для создания плагина этот шаблон хорошо себя зарекомендовал, однако данные шаблоны используют NuGet пакеты, которые у меня ( возможно не только ) не всегда корректно работают. ","type":"unstyled","key":"aksd0"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"Поэтому в данной статье покажу, как создавать код вручную. ","type":"unstyled","key":"c02k6"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"Создание плагина","type":"header-two","key":"crnif"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"1) Заходим в Visual Studio (Обязательно необходимо проверить, что у вас установлено последнее обновления в программе «Visual Studio installer») и нажимаем \"Create new project\". ","type":"unstyled","key":"4vthb"},{"data":{"image":{"id":"69650be362cebb4c988e1e48"}},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"","type":"atomic:image","key":"e0k9i"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"2) В поиске вбиваем \"Библиотека классов\" и выбираем.","type":"unstyled","key":"d0or5"},{"data":{"image":{"id":"69aee8f0c9b6991f52489a4f"}},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"","type":"atomic:image","key":"8o9sl"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"","type":"unstyled","key":"3ssc1"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"3) Называете свой проект понятно и кратко, чтобы потом самому найти. Выбирайте также расположение, которое точно найдете)","type":"unstyled","key":"3tuf0"},{"data":{"image":{"id":"69aee91c639a705f8fa7c846"}},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"","type":"atomic:image","key":"a2gs7"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"4) Доп информация: Тип приложения (Add - in type) : Application.","type":"unstyled","key":"akuc0"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"Далее как на скрине","type":"unstyled","key":"lubb"},{"data":{"image":{"id":"69aee92d2350704306be6707"}},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"","type":"atomic:image","key":"aioo"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"5) Откроется проект, пора создавать!","type":"unstyled","key":"1j8tn"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"Что находится внутри проекта","type":"header-two","key":"39a8q"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"1) Solution explorer","type":"header-three","key":"6lpq7"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"Показывает, что у вас есть в проекте ( как диспетчер проекта в Revit)","type":"unstyled","key":"dflqp"},{"data":{"image":{"id":"69a5b25cc7cdd850ac02559f"}},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"","type":"atomic:image","key":"76kti"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"2) Dependencies ( Зависимости) ","type":"header-three","key":"72qiu"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"Это внешние библиотеки проекта. Для работы с Revit API нам необходима библиотка Revit API, соответственно. ","type":"unstyled","key":"7t7lk"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"3) Подключение Revit API","type":"header-three","key":"e5a1k"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[{"length":12,"offset":94,"style":"BOLD"},{"length":14,"offset":109,"style":"BOLD"}],"text":"Чтобы Revit «понял», что мы пишем именно для него, нам нужно добавить две главные библиотеки: RevitAPI.dll и RevitAPIUI.dll.","type":"unstyled","key":"ef5c6"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[{"length":12,"offset":32,"style":"BOLD"},{"length":10,"offset":50,"style":"BOLD"},{"length":16,"offset":64,"style":"BOLD"}],"text":"Нажимаем правой кнопкой мыши на Dependencies (или References) → Add Reference...","type":"unordered-list-item","key":"2mghp"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[{"length":6,"offset":9,"style":"BOLD"}],"text":"Нажимаем Browse и идем по пути установки вашего Revit (обычно это C:\\Program Files\\Autodesk\\Revit 20xx).","type":"unordered-list-item","key":"2k6hn"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"Ищем там эти два файла и добавляем их.","type":"unordered-list-item","key":"61q15"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[{"length":13,"offset":0,"style":"BOLD"},{"length":17,"offset":79,"style":"BOLD"}],"text":"Важный нюанс: в свойствах этих библиотек в Visual Studio обязательно поставьте Copy Local: False. Revit сам загрузит эти библиотеки при запуске, нам не нужно «тащить» их с собой в плагин.","type":"unordered-list-item","key":"bdrip"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"4) Код для пакетного экспорта файлов (.rvt → .nwc)","type":"header-three","key":"dvfl2"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"Здесь мы подключим ИИ - дадим промпт, чтобы она написала код. ","type":"unstyled","key":"a4g78"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"PS. Необходимо указывать версию Revit, а также все детали, которые вас интересуют. Чем больше деталей - тем лучше. Для разных версий Revit существует множество нюансов, о которых в одной статье не рассказать. ","type":"unstyled","key":"di4o7"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"5) Сборка проекта (Создание .dll файла)","type":"header-three","key":"bvleo"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"После того как код написан, нам нужно скомпилировать его в файл библиотеки, который Revit сможет прочитать.","type":"unstyled","key":"3bqdo"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[{"length":7,"offset":53,"style":"BOLD"}],"text":"В верхней панели Visual Studio выберите конфигурацию Release (это сделает плагин быстрее и «чище», чем в режиме Debug).","type":"ordered-list-item","key":"787v8"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[{"length":17,"offset":57,"style":"BOLD"},{"length":5,"offset":86,"style":"BOLD"}],"text":"Нажмите правой кнопкой мыши на название вашего проекта в Solution Explorer и выберите Build (Собрать).","type":"ordered-list-item","key":"mpd5"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"Если всё сделано правильно, в нижней панели (Output) вы увидите заветную надпись: Build: 1 succeeded.","type":"ordered-list-item","key":"36arm"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[{"length":21,"offset":0,"style":"BOLD"}],"text":"Где искать результат?","type":"unstyled","key":"10amq"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[{"length":21,"offset":0,"style":"BOLD"},{"length":4,"offset":130,"style":"BOLD"}],"text":"Зайдите в папку вашего проекта через проводник: Ваш_проект \\ bin \\ Release. Там появится файл с расширением .dll (например, MyFirstPlugin.dll). Это и есть «тело» вашего плагина.","type":"unstyled","key":"8odrn"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"6) Создание манифеста (.addin файл)","type":"header-three","key":"6ilkk"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[{"length":6,"offset":111,"style":"BOLD"}],"text":"Revit не умеет искать .dll файлы сам по себе. Ему нужен «указатель» — специальный текстовый файл с расширением .addin, который скажет программе: «Вот плагин, он лежит тут, и его нужно запустить вот так».","type":"unstyled","key":"3kua7"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"Создайте обычный текстовый файл в Блокноте и вставьте в него этот текст:","type":"unstyled","key":"bki2"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"","type":"blockquote","key":"cml2t"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"","type":"blockquote","key":"e4d1e"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"","type":"blockquote","key":"fhpnd"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"Batch Export NWC","type":"blockquote","key":"3umbo"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"ПУТЬ_К_ВАШЕМУ_ФАЙЛУ_DLL","type":"blockquote","key":"1hn66"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"12345678-1234-1234-1234-1234567890AB","type":"blockquote","key":"51rj0"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"BatchExportFilesNWC","type":"blockquote","key":"5ip05"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"MyPlugin","type":"blockquote","key":"735ip"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"Пакетный экспорт в NWC","type":"blockquote","key":"9sfal"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"","type":"blockquote","key":"cuh5m"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"","type":"blockquote","key":"20aqd"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"","type":"unstyled","key":"8jigt"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[{"length":25,"offset":0,"style":"BOLD"}],"text":"Что здесь важно заменить:","type":"unstyled","key":"dc387"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[{"length":8,"offset":0,"style":"BOLD"}],"text":"Assembly: Полный путь к вашему .dll файлу из Шага 5.","type":"unordered-list-item","key":"1a08f"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[{"length":13,"offset":0,"style":"BOLD"}],"text":"FullClassName: Точное название класса из кода (в нашем примере это BatchExportFilesNWC).","type":"unordered-list-item","key":"adku7"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[{"length":7,"offset":0,"style":"BOLD"},{"length":20,"offset":145,"style":"ITALIC"}],"text":"AddInId: Это уникальный идентификатор (GUID). Его можно сгенерировать онлайн (просто вбейте в поиске \"GUID generator\") или в Visual Studio через Tools -> Create GUID. Он должен быть уникальным для каждого плагина.","type":"unordered-list-item","key":"e3skt"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[{"length":6,"offset":67,"style":"BOLD"}],"text":"Сохраните этот файл под любым именем, но обязательно с расширением .addin (например, ExportNWC.addin).","type":"unstyled","key":"e0ofs"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"7) Подключение к Revit","type":"header-three","key":"e62g6"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"Теперь нам нужно положить наш «указатель» в ту папку, куда Revit заглядывает при каждом запуске.","type":"unstyled","key":"3egs5"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[{"length":6,"offset":15,"style":"BOLD"},{"length":23,"offset":54,"style":"BOLD"}],"text":"Скопируйте ваш .addin файл в одну из следующих папок (зависит от версии Revit):","type":"unstyled","key":"b60e1"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"Для всех пользователей: C:\\ProgramData\\Autodesk\\Revit\\Addins\\2024","type":"unordered-list-item","key":"2sho0"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"Только для вас (рекомендуется): %AppData%\\Autodesk\\Revit\\Addins\\2024 (просто вставьте этот путь в адресную строку проводника).","type":"unordered-list-item","key":"182b7"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[{"length":94,"offset":0,"style":"ITALIC"}],"text":".dll файл может оставаться в папке проекта, так как мы указали прямой путь к нему в манифесте.","type":"unstyled","key":"ff88i"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"8) Запуск и тестирование","type":"header-three","key":"24fh"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[{"length":55,"offset":58,"style":"ITALIC"}],"text":"Запустите Revit. При загрузке появится окно безопасности: \"Разработчик этого внешнего приложения не определен...\".","type":"ordered-list-item","key":"fjouq"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[{"length":32,"offset":8,"style":"BOLD"}],"text":"Нажмите \"Всегда загружать\" (Always Load). Это стандартная процедура для самописных плагинов без цифровой подписи.","type":"ordered-list-item","key":"5tvu5"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"Откройте любой проект.","type":"ordered-list-item","key":"5mbnf"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[{"length":22,"offset":21,"style":"BOLD"},{"length":38,"offset":54,"style":"BOLD"}],"text":"Перейдите на вкладку \"Надстройки\" (Add-ins) -> панель \"Внешние инструменты\" (External Tools).","type":"ordered-list-item","key":"df14k"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"Там вы увидите вашу кнопку с названием, которое мы указали в поле манифеста.","type":"ordered-list-item","key":"4tbvj"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"","type":"marker","key":"aw8Jj07NQJAu0ejek0Qr"}],"entityMap":{"0":{"data":{"url":"https://ru.wikipedia.org/wiki/%D0%98%D0%BD%D1%82%D0%B5%D0%B3%D1%80%D0%B8%D1%80%D0%BE%D0%B2%D0%B0%D0%BD%D0%BD%D0%B0%D1%8F_%D1%81%D1%80%D0%B5%D0%B4%D0%B0_%D1%80%D0%B0%D0%B7%D1%80%D0%B0%D0%B1%D0%BE%D1%82%D0%BA%D0%B8"},"mutability":"MUTABLE","type":"LINK"},"1":{"data":{"url":"https://visualstudio.microsoft.com/"},"mutability":"MUTABLE","type":"LINK"},"2":{"data":{"url":"https://www.youtube.com/@SimpleCodeIT"},"mutability":"MUTABLE","type":"LINK"},"3":{"data":{"url":"https://github.com/Nice3point"},"mutability":"MUTABLE","type":"LINK"}}},"mentions":[]}