В этой статье будет подробно описано назначение каждого файла и папки в среднестатистическом пакете HiAsm. В основном статья в большей степени ориентированна на разработчиков новых пакетов, но может в неменьшей степени оказаться полезной и простым пользователям, желающим увеличить уровень своих знаний среды и ее составляющих.

   Речь пойдет о файлах, расположенных в корневой директории пакета по адресу <HiAsm>\Elements\<Пакет>:

CodeGen.dpr - исходник кодогенератора пакета. Для его сборки в исполняемую библиотеку CodeGen.dll как правило достаточно запустить там же расположенный скрипт с именем Make.bat. Кодогенератор является основным сборщиком всех приложений пакета из исходных кодов элементов и без него не будет работать вообще ничего.

<Пакет>.ico - иконка с именем пакета используется для отображения в редакторе схем на вкладке проекта.

Elements.sql - дамп базы данных палитры элементов пакета существующий только ради удобства работы нескольких разработчиков над одним пакетом. Среда не использует дамп на прямую, и работает только с его "бинарной" версией Elements.db, которую можно получить после выполнения сприпта sql_to_db.bat - выполняет одну единствунную команду по созданию и экспорту данных в Elements.db

tabs.ini - содержит информацию о всех открытых вкладках палитры элементов текущего пакета. Данный файл используется для сохранения и загрузки состояния палитры при переключении между пакетами или при переоткрытии среды.

Panels.ini - содержит информацию о панелях быстрого доступа для текущего пакета
   Следует помнить о том, что если вы обновляете пакет через SVN, то в случае появления новых версий CodeGen.dpr или Elements.sql нужно обязательно запускать make.bat или sql_to_db.bat соответсветственно иначе изменения не вступят в силу.

   Папка code содержит исходные файлы всех элементов пакета. Имена элементов строятся в соответствии с шаблоном

где <Имя элемента> - название, которое можно увидеть в тексте подсказки в скобках при удержании мышки над иконкой элемента в палитре, а <Расширение элемента пакета> - расширение из одноименного поля диалога "Настройка компиляторов". Префикс "hi" служит для того, чтобы отличать исходники элементов от простых модулей, которые ими используются. Если пакет построен на базе FTCG, то в качестве расширений для его элементов используется hws.

   Именно эти файлы среда ищет и открывает для редактирования при выполнении команды "Исходник компонента" на выделенном элементе схемы.

   Папка conf содержит файлы конфигурации элементов пакета. Имена элементов строятся в соответствии с шаблоном

   Именно с этими файлами работает встроенный в среду ECreator. Так же важно помнить о том, что если исходники элемента читаются всякий раз в процессе компиляции схемы, то файл конфигурации читается только один раз при первом обращении к элементу и в дальнейшем использует информацию, сохраненную в оперативной памяти без обращения к диску. Это значит, что для вступления в силу изменений, внесенных в ini файл (вручную или через ECreator) ранее загруженного элемента необходимо перезапустить среду.

   Папка icon содержит иконки для всех элементов пакета в формате

формат иконок 24х24 пикселя. В том случае, если у элемента иконка определяется одним из его свойств, то данный набор так же размещается в этой папке с именами в формате

где № - индекс значения свойства начиная с 0.

   Папка draw содержит динамические библиотеки, отвечающие за отрисовку пользовательских элементов в редакторе форм. Подробнее о данных библиотеках можно прочесть в статье Пакеты->Структура пакета HiAsm->Разработка элемента->Класс Custom. При обновлении с SVN исходников в данной папки так же нужно запускать расположенный там скрипт make.bat.

   Папка Example содержит структурированные примеры использования элементов в данном пакете. Содержимое этой папки отображается в ветке Example для каждого пакета в панели "Каталог проектов".

   Папка make содержит библиотеки для сборки полученных от кодогенератора исходных файлов в конечное приложение. Если во время сборки вы получаете одно единственное сообщение вида

то проблема с вероятностью в 99% заключается в отсутствующем, устаревшем или битом make_xxx.dll, где ххх - соответствует типу собираемого проекта. При обновлении с SVN исходники в данной папке так же скорей всего потребуют пересборки скриптом make.bat.

   Папка new содержит шиблоны новых проектов пакета. Используются данные шаблоны всякий раз при создании нового проекта в среде. Поэтому если вы хотите изменить содержимое нового проекта в вашей среде, то необходимо открыть соответствующий шаблон (он представляет из себя обычную схему), внести необходимые правки и сохранить изменения в файле. Данная возможность полезна, например, в том случае, если вы в каждом проекте используете один и тот же элемент(или их наборы).

   Папка tabs содержит иконки в формате 16х16, которые выводятся слева от названия вкладки в палитре элементов пакета. В качестве имен иконок необходимо использовать английские названия вкладок (можно посмотреть в базе Elements.db в таблице Groups или в палитре элементов при переключении интерфейса на английский язык). Если иконка с именем вкладки не найдена, то вместо нее выводится стандартная иконка из файла Int\icons\el_right.ico.

   Папка prof содержит ранее сохраненные профили элемента из палитры свойств. Стандартный профиль, отображаемый в списке сохраняется с названием:

где <Имя профиля> - имя, которое вы указали в поле ввода при создании профиля для выделенного элемента.

   Профиль по умолчанию (который для элемента может быть только один) сохраняется с названием:

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

   При переходе на новую версию среды для сохранения всех профилей достаточно просто скопировать содержимое данной папки в новое место.

   Папка tpl содержит структуру библиотеки шаблонов пакета, доступ к которой осуществляется из среды командами Правка->Добавить шаблон и Контекстное меню рабочего стола->Вставить шаблон. Так же для удобства редактирования шаблонов и их удаления из библиотеки данная папка линкуется к узлу пакета в Каталоге проектов с именем tpl (там же, где и папка с примерами пакета).