Сообщество программистов Autodesk в СНГ

ADN Club => Revit API => Тема начата: Алексей Статных от 24-02-2014, 19:50:32

Название: Назначение типов AddIn в файле манифейста
Отправлено: Алексей Статных от 24-02-2014, 19:50:32
Доброго время суток. Вопрос у меня есть. Создаю  расширение для Revit 2014. Подскажите чем отличается тип манифеста команда и приложение и в какой момент времени выполняется у приложения OnStartup. Вопрос такой возник в результате того что я подключаю dll к ревит и выполняется только код который в  файле команды
Название: Re: Назначение типов AddIn в файле манифейста
Отправлено: Виктор Чекалин от 25-02-2014, 09:39:07
Алексей, добрый день.
Все очень просто.

Файл манифеста предназначен для описания вашего расширения. Именно из файла манифеста Revit узнает о вашей надстройке.

При старте Revit происходит поиск файла c расширением addin в соответствующих папках, читает из них информацию и загружает вашу надстройку.

В надстройке вы можете создать два типа класса:

Таких классов в одной надстройке может быть несколько. Но чтобы Revit знал об их существовании, их нужно описать в файле манифеста.

Типичный файл манифеста выглядит примерно так:
Код - XML [Выбрать]
  1. <?xml version="1.0" encoding="utf-8"?>
  2. <RevitAddIns>
  3.   <AddIn Type="Command">
  4.     <Text>Command RevitTemp</Text>
  5.     <Description>Some description for RevitTemp</Description>
  6.     <Assembly>RevitTemp.dll</Assembly>
  7.     <FullClassName>RevitTemp.Command</FullClassName>
  8.     <ClientId>69529763-1ebd-4139-938b-bc0318a656b0</ClientId>
  9.     <VendorId>TBC_</VendorId>
  10.     <VendorDescription>The Building Coder, http://thebuildingcoder.typepad.com</VendorDescription>
  11.   </AddIn>
  12.   <AddIn Type="Application">
  13.     <Name>Application RevitTemp</Name>
  14.     <Assembly>RevitTemp.dll</Assembly>
  15.     <FullClassName>RevitTemp.App</FullClassName>
  16.     <ClientId>0b1c0fcb-e87e-4ce4-9355-c6187223ad41</ClientId>
  17.     <VendorId>TBC_</VendorId>
  18.     <VendorDescription>The Building Coder, http://thebuildingcoder.typepad.com</VendorDescription>
  19.   </AddIn>
  20. </RevitAddIns>

В типе Application, необходимо указать название класса, реализующего интерфейс IExternalApplication. Этот интерфейс содержит 2 метода: OnStartup и OnShutdown.
Метод OnStartup выполняется при запуске Revit. Или если быть точнее, после того как Revit прочитал информацию из файла манифеста и создал экземпляр класса, описанного в манифесте.

В типе Command описываются ваши команды. Т.е. классы, реализующие интерфейс IExternalCommand. Описанные в манифесте команды Revit добавляет на вкладку Надстройки - Внешние команды в интерфейсе. Метод Execute будет выполнен, когда вы выберите соответсвующую команду в интерфейсе.

Важно помнить, что экземпляр класса IExternalApplication будет создан при загрузке Revit. И если по каким то причинам не удалось создать экземпляр этого класса (чаще всего по причине неверного описания в манифесте), то Revit предупредит об этом сразу при загрузке. Экземпляр класса команды создается только непосредественно в момент вызова команды. И если команда описана неверно, то вы увидите предупреждение при попытке вызова команды.

Надстройка не обязательно должна содержать оба типа. Более того, если вам не нужно проделывать каких-либо действий при загрузке Revit, то лучше убрать описание Application из манифеста, так как это ускорит загрузку Revit.
Команду же можно запустить не только из вкладки Надстройки - Внешние команды, но и при помощи кнопки на ленте. В этом случае создаете описываете только Applciation и создаете кнопку для вызова команды в методе OnStartup.