Проект FreeBSD GNOME: Как создать порт

Приложения GNOME во FreeBSD используют инфраструктуру USE_GNOME. Для указания того, какие компоненты системы GNOME нужны вашему порту для построения, просто перечислите их все списком через пробел. Например:

Компоненты USE_GNOME делятся на две следующие категории:

Если вашему порту нужны только библиотеки GTK2, то кратчайшим способом указать на это является следующий:

Если вашему порту требуются только библиотеки GTK1, то кратчайшим способом указать на это является следующий:

Даже если ваше приложение требует только библиотеки GTK, другие компоненты USE_GNOME могут оказаться полезными. Пожалуйста, просмотрите весь список, чтобы удостовериться в том, что ваш порт использует все нужные компоненты.

Как только вы закончите работу над своим портом, не помешает проверить, что он зависит от правильного списка компонентов. Чтобы увидеть перечень пакаджей, от которых действительно зависит ваш порт, воспользуйтесь командой make package-depends, которую нужно выдать из каталога вашего порта.

В облегчении создания перечня необходимых компонентов может помочь анализ выдачи команды make configure. В конце списка checking for…​ будет находиться строка вроде следующей:

Это список компонентов, которые используются приложением при построении. Обратите особое внимание на иерархический характер системы USE_GNOME; многие компоненты включаются из других директив USE_GNOME. В примере выше USE_GNOME= libgnomeui подразумевает использование libbonoboui, что приводит к использованию libgnomecanvas, что приводит к использованию libglade2, которая использует gtk20. Таким образом, даже если gtk+-2.0 появляется в списке необходимых компонентов, gtk20 можно исключить из списка USE_GNOME. Имеется некоторое количество других таких случаев избыточности, которые можно исключить из этого списка.

Для списка выше (взятого из sysutils/gok), в Makefile определено следующее:

Изначально была только GNOME 1. Когда появилась оболочка GNOME 2, была обеспечена максимальная совместимость с предыдущей версией, по понятным причинам. Приложения GNOME 1 могли нормально работать в оболочке GNOME 2, при условии, что они не используют специфичную для оболочки GNOME 1 функциональность.

Оболочка GNOME 1 и все приложения, которые не работали в оболочке GNOME 2, были удалены из дерева портов.

Для вас, как создателя порта приложения, это означает, что вы просто не должны добавлять приложения, специфичные для GNOME 1, в дерево портов.

Если вы хотите определить, какая версия оболочки GNOME используется на машине пользователя, вы можете проверить значение переменной GNOME_DESKTOP_VERSION. Значение этой переменной устанавливается в значение "1" или "2", в зависимости от того, установлена ли версия оболочки GNOME 1 или GNOME 2.

Если ваш порт может опционально использовать GNOME, вы должны задать WANT_GNOME= yes в вашем файле Makefile, а затем проверить, задана ли переменная HAVE_GNOME для каждого компонента из списка выше, которые может использовать ваш порт. Так как это проверка выполнения условия, вам нужно поместить её между bsd.port.pre.mk и bsd.port.post.mk. Например:

Здесь WANT_GNOME указывает системе портов на проверку существования различных компонент GNOME, перечисленных выше. Для каждого найденного компонента его имя добавляется к HAVE_GNOME. Так как этот порт может использовать gnomepanel, мы проверяем переменную HAVE_GNOME на предмет включения в неё gnomepanel (для выяснения более полной информации о синтаксисе make-строки :M`pattern`, пожалуйста, обратитесь к страницам справочника о make(1)). Если будет найден компонент gnomepanel, то он будет добавлен к списку зависимостей USE_GNOME, и будут переданы специфичные для порта --with-gnome CONFIGURE_ARG. В старой инфраструктуре GNOME переменная PKGNAMESUFFIX автоматически перенастраивалась на полноценный макрос USE_*. Теперь это отдано человеку, создающему порт. В нашем примерном порте к его имени добавляется -gnome для указания на то, что он строится с поддержкой GNOME. То же самое имеет место и для DATADIR PLIST_SUB. Создатель порта должен решить, когда выполнять подстановку DATADIR. Хорошим правилом является добавление DATADIR PLIST_SUB при использовании компонента gnomeprefix.

Замечание: Вы не можете добавлять дополнительные компоненты USE_GNOME, используемые по умолчанию, после .include <bsd.port.pre.mk>. Поэтому следующее использование будет неправильным:

Это заставит систему построения думать, что требуется использование GNOME, и тогда pkg-plist будет изменён соответствующим образом, что приведёт к ошибке при построении пакаджа. Если вы хотите добавить используемые по умолчанию компоненты USE_GNOME, сделайте это перед строкой ` .include <bsd.port.pre.mk>`.

Чтобы принудительно вызвать безусловное использование опциональных зависимостей GNOME, вы можете добавить WITH_GNOME= yes в файл /etc/make.conf или в командную строку make. При этом при проверке зависимости от GNOME будет всегда возвращаться возвращаться положительное значение. Если вы хотите, чтобы система всегда возвращала отрицательный результат при проверке на зависимость от GNOME, вы можете добавить WITHOUT_GNOME= yes в /etc/make.conf или командную строку make.

Дополнительную информацию об инфраструктуре USE_GNOME можно найти при просмотре исходных текстов и комментариев в файле ${PORTSDIR}/Mk/bsd.gnome.mk.

Большое количество приложений GNOME (особенно приложения GNOME 2) устанавливают файлы Open Source Metadata Framework (OMF), которые содержат информацию о файлах справки для этих приложений, Эти OMF-файлы требуют особой обработки через ScrollKeeper для того, чтобы такие приложения, как Yelp могли находить справочную документацию. Для выполнения полноценной регистрации этих файлов OMF при установке приложений GNOME из пакаджей вы должны проверить, что файл pkg-plist вашего порта имеет следующие описания для каждого перечисленного файла OMF.

К примеру:

Большинство, если не все, приложений GNOME зависит от GNU libtool. Они также используют систему конфигурации GNU configure. Если ваш порт устанавливает совместно используемые библиотеки, вы должны добавить строку USE_LIBTOOL= yes к Makefile вашего порта. При этом будут учтены все требования при использовании libtool, но это не избавит от таких вещей, как установка файлов .la. Для обеспечения корректной установки совместно используемой библиотеки не забудьте также добавить следующую строку в скрипт configure вашего порта непосредственно после строки LIBTOOL_DEPS="$ac_aux_dir/ltmain.sh":

Это отменит установку файлов .la и обеспечит передачу параметра ${PTHREAD_LIBS} компоновщику.

Для отделения дистрибутивных файлов GNOME 2 от дистрибутивных файлов GNOME 1 и для обеспечения чистоты каталога с дистрибутивными файлами, порты GNOME 1, которые сгружают свои дистрибутивные файлы с ${MASTER_SITE_GNOME}, должны иметь следующую строку в своём Makefile:

Порты GNOME 2, которые сгружают свои дистрибутивные файлы с ${MASTER_SITE_GNOME}, должны иметь следующую строку в своём Makefile:

Некоторые дистрибутивные файлы GNOME распространяются как в формате tar gzip, так и tar bzip2. Для экономии времени при сгрузке дистрибутивных файлов по медленным каналам связи вы должны использовать дистрибутивные файлы bzip2 там, где это возможно. Для этого добавьте следующую строку в Makefile вашего порта:

Если вам нужна помощь при работе с портом, для примера взгляните на некоторые из существующих портов. К вашим услугам также и список рассылки freebsd-gnome.