Рабочая среда К

14.4. Установка инсталляционных свойств файлов

Выше было объяснено, где приложение KDE должно располагать свои файлы и как получить к ним доступ при выполнении. Теперь объясним, как правильно установить свойства файлов, чтобы они записались в нужные места при инсталляции. Файлы Makefiles поддерживают набор макросов для инсталляции ваших файлов в файловую систему KDE, которые должны быть использованы при установке значений инсталляционных свойств файлов.

Для установки свойств откройте проект и выберите "Project"-"File Properties", что откроет диалог свойств файла. Свойства файла отображаются, если вы выберите файл, включенный в проект. Во-первых, файл имеет свойство "тип" ("type"), которое может принимать такие значения:

Далее, файл включен в проект, если выбрана опция "Include in Distribution". Ее установка приведет к включению файла в дистрибутив приложения.

Если файл должен быть инсталлирован, вы должны разрешить опцию "Install". Это сделает доступным свойство Installation path (путь инсталляции) для выбранного файла, куда уже вставлено имя файла.

Как уже говорилось, Makefile содержит набор макросов для путей файловой системы KDE. Они используются для установки путей инсталляции, и дают гарантию, что файл будет действительно записан в соответствующее место файловой системы, а не куда-нибудь еще. Используемые макросы должны быть взяты в круглые скобки и отмечены символом доллара перед макросом. Когда configure создает файлы Makefile на машине конечного пользователя, то определяются значения этих макросов, соответствующие реальному каталогу, и в файлы Makefile.am заносится действительная информация о путях.

Если посмотреть на стандартный проект KDE, то можно увидеть, что свойство файла index.html уже использует макрос для определения пути:

$(kde&_;htmldir)/en/kscribble/index.html

Это значит, что make запишет файл index.html в kde-html каталог, подкаталог en для английского языка, подкаталог приложения в файл с именем index.html. Вы можете использовать другое имя файла, если вы хотите переименовать файл при инсталляции.

Для определения положения файлов приложения в структуре kpanel вы должны отредактировать файл проекта Makefile.am, если место назначения отличается от секции "Приложения" ("Applications") kpanel:

APPSDIR = $(kde&_;appsdir)/Applications

Возможные значения (как говорит стандарт файловой системы KDE):

Установка пустого пути добавит линк вашего приложения непосредственно в корень kpanel.

Следующий список содержит макросы, которые могут использоваться для указания путей файлов:

 kde_htmldir       - для документации (содержит подкаталоги для языков),
 kde_appsdir       - для файла (.kdelnk), 
 kde_icondir       - для иконок,
 kde_minidir       - для мини-иконок,
 kde_datadir       - для данных приложения (используйте подкаталог),
 kde_locale        - для файлов перевода (содержит подкаталоги для языков),
 kde_cgidir        - для cgi-bin исполнимых файлов,
 kde_confdir       - для конфигурационных файлов,
 kde_mimedir       - для mime-типов,
 kde_toolbardir    - для общих иконок панелей инструментов,
 kde_wallpaperdir  - для общих обоев.

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