Initial import, synchronized with English 1.34
This commit is contained in:
Andrey Zakhvatov
parent
1bf5f7fe14
commit
1b8cbc97e6
Notes:
svn2git
2020-12-08 03:00:23 +00:00
svn path=/www/; revision=18677
1 changed files with 307 additions and 0 deletions
307
ru/gnome/docs/porting.sgml
Normal file
307
ru/gnome/docs/porting.sgml
Normal file
|
|
@ -0,0 +1,307 @@
|
|||
<!--
|
||||
The FreeBSD Russian Documentation Project
|
||||
|
||||
$FreeBSDru: frdp/www/ru/gnome/docs/porting.sgml,v 1.1 2003/11/02 10:03:55 andy Exp $
|
||||
|
||||
Original revision: 1.34
|
||||
-->
|
||||
|
||||
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN" [
|
||||
<!ENTITY base CDATA "../../..">
|
||||
<!ENTITY date "$FreeBSD: www/en/gnome/docs/porting.sgml,v 1.34 2003/10/02 22:01:04 marcus Exp $">
|
||||
<!ENTITY title "Проект FreeBSD GNOME: Как создать порт">
|
||||
<!ENTITY % gnomeincludes SYSTEM "../includes.sgml"> %gnomeincludes;
|
||||
<!ENTITY % includes SYSTEM "../../includes.sgml"> %includes;
|
||||
]>
|
||||
|
||||
<html>
|
||||
&header;
|
||||
|
||||
<p>В этом документе предполагается, что вы уже знаете, как работает система
|
||||
портов, и поэтому здесь даётся только специфичные для GNOME советы и
|
||||
замечания. Инструкции общего характера можно найти в <a
|
||||
href="http://www.freebsd.org/doc/en_US.ISO8859-1/books/porters-handbook/index.html">
|
||||
Руководстве по созданию портов FreeBSD</a>.</p>
|
||||
|
||||
<h2>Макросы GNOME для Makefile</h2>
|
||||
|
||||
<p>Приложения GNOME во FreeBSD используют инфраструктуру <b>USE_GNOME</b>.
|
||||
Для указания того, какие компоненты системы GNOME нужны вашему порту для
|
||||
построения, просто перечислите их все списком через пробел. Например:</p>
|
||||
|
||||
<pre>
|
||||
USE_X_PREFIX= yes
|
||||
USE_GNOME= gnomeprefix gnomehack libgnomeui
|
||||
</pre>
|
||||
|
||||
<p>Компоненты <b>USE_GNOME</b> делятся на две следующие категории:</p>
|
||||
|
||||
<ul>
|
||||
<li><p><a href="gnome2_porting.html">Компоненты GNOME 2</a></p></li>
|
||||
|
||||
<li><p><a href="gnome_porting.html">Компоненты GNOME 1</a></p></li>
|
||||
</ul>
|
||||
|
||||
<!-- I'm not sold on the utility of this section -->
|
||||
|
||||
<p>Если вашему порту нужны только библиотеки <b>GTK2</b>, то кратчайшим
|
||||
способом указать на это является следующий:</p>
|
||||
|
||||
<pre>
|
||||
USE_X_PREFIX= yes
|
||||
USE_GNOME= gtk20
|
||||
</pre>
|
||||
|
||||
<p>Если вашему порту требуются только библиотеки <b>GTK1</b>, то кратчайшим
|
||||
способом указать на это является следующий:</p>
|
||||
|
||||
<pre>
|
||||
USE_X_PREFIX= yes
|
||||
USE_GNOME= gtk12
|
||||
</pre>
|
||||
|
||||
<p>Даже если ваше приложение требует только библиотеки GTK, другие компоненты
|
||||
<b>USE_GNOME</b> могут оказаться полезными. Пожалуйста, просмотрите весь
|
||||
список, чтобы удостовериться в том, что ваш порт использует все нужные
|
||||
компоненты.</p>
|
||||
|
||||
<!-- end questionable section -->
|
||||
|
||||
<p>Как только вы закончите работу над своим портом, не помешает проверить,
|
||||
что он зависит от правильного списка компоннетов. Чтобы увидеть перечень
|
||||
пакаджей, от которых действительно зависит ваш порт, воспользуйтесь
|
||||
командой <tt>make package-depends</tt>, которую нужно выдать из каталога
|
||||
вашего порта.</p>
|
||||
|
||||
<p>В облегчении создания перечня необходимых компонентов может помочь анализ
|
||||
выдачи команды <tt>make configure</tt>. В конце списка
|
||||
<tt>checking for...</tt> будет находиться строка вроде следующей:</p>
|
||||
|
||||
<pre>
|
||||
checking for libgnomeui-2.0 >= 2.0.0 cspi-1.0 >= 1.1.7
|
||||
libspi-1.0 >= 1.1.7 libbonobo-2.0 >= 2.0.0 atk >= 1.0.0
|
||||
gtk+-2.0 >= 2.0.0 gail libwnck-1.0 esound... yes
|
||||
</pre>
|
||||
|
||||
<p>Это список компонентов, которые используются приложением при построении.
|
||||
Обратите особое внимание на иерархический характер системы
|
||||
<b>USE_GNOME</b>; многие компоненты включаются из дургих директив
|
||||
<b>USE_GNOME</b>. В примере выше <tt>USE_GNOME= libgnomeui</tt>
|
||||
подразумевает использование <tt>libbonoboui</tt>, что приводит к
|
||||
использованию <tt>libgnomecanvas</tt>, что приводит к использованию
|
||||
<tt>libglade2</tt>, которая использует <tt>gtk20</tt>. Таким образом, даже
|
||||
если <tt>gtk+-2.0</tt> появляется в списке необходимых компонентов,
|
||||
<tt>gtk20</tt> можно исключить из списка <b>USE_GNOME</b>. Имеется
|
||||
некоторое количество других таких случаев избыточности, которые можно
|
||||
исключить из этого списка.</p>
|
||||
|
||||
<p>Для списка выше (взятого из <tt>sysutils/gok</tt>), в <tt>Makefile</tt>
|
||||
определено следующее:
|
||||
|
||||
<pre>
|
||||
USE_GNOME= gnomehack gnomeprefix libgnomeui atspi libwnck
|
||||
</pre>
|
||||
|
||||
<h2>Оболочка GNOME 1 против Оболочки GNOME 2</h2>
|
||||
|
||||
<p>Изначально была только <tt>GNOME 1</tt>. Когда появилась оболочка
|
||||
<tt>GNOME 2</tt>, была обеспечена максимальная совместимость с предыдущей
|
||||
версией, по понятным причинам. Приложения <tt>GNOME 1</tt> могли нормально
|
||||
работать в оболочке <tt>GNOME 2</tt>, при условии, что они не используют
|
||||
специфичную для оболочки <tt>GNOME 1</tt> функциональность.</p>
|
||||
|
||||
<p>Оболочка <tt>GNOME 1</tt> и все приложения, которые не работали в оболочке
|
||||
<tt>GNOME 2</tt>, были удалены из дерева портов.</p>
|
||||
|
||||
<p>Для вас, как создателя порта приложения, это означает, что вы просто не
|
||||
должны добавлять приложения, специфичные для <tt>GNOME 1</tt>, в дерево
|
||||
портов.</p>
|
||||
|
||||
<p>Если вы хотите определить, какая версия оболочки GNOME используется на
|
||||
машине пользователя, вы можете проверить значение переменной
|
||||
<b>GNOME_DESKTOP_VERSION</b>. Значение этой переменной устанавливается в
|
||||
значение <tt>"1"</tt> или <tt>"2"</tt>, в зависимости от того, установлена
|
||||
ли версия оболочки <tt>GNOME 1</tt> или <tt>GNOME 2</tt>.</p>
|
||||
|
||||
<h2>Опциональные зависимости GNOME</h2>
|
||||
|
||||
<p>Если ваш порт может опционально использовать GNOME, вы должны задать
|
||||
<tt>WANT_GNOME= yes</tt> в вашем файле Makefile, а затем проверить, задана
|
||||
ли переменная <tt>HAVE_GNOME</tt> для каждого компонента из списка выше,
|
||||
которые может использовать ваш порт. Так как это проверка выполнения
|
||||
условия, вам нужно поместить её между <tt>bsd.port.pre.mk</tt> и
|
||||
<tt>bsd.port.post.mk</tt>. Например:</p>
|
||||
|
||||
<pre>
|
||||
WANT_GNOME= yes
|
||||
|
||||
.include <bsd.port.pre.mk>
|
||||
|
||||
.if ${HAVE_GNOME:Mgnomepanel}!=""
|
||||
USE_GNOME+= gnomeprefix gnomepanel
|
||||
CONFIGURE_ARGS+= --with-gnome
|
||||
PKGNAMESUFFIX= -gnome
|
||||
PLIST_SUB= DATADIR="share/gnome"
|
||||
.else
|
||||
CONFIGURE_ARGS+= --without-gnome
|
||||
PLIST_SUB= DATADIR="share"
|
||||
.endif
|
||||
|
||||
.include <bsd.port.post.mk>
|
||||
</pre>
|
||||
|
||||
<p>Здесь <tt>WANT_GNOME</tt> указывает системе портов на проверку
|
||||
существования различных компонент GNOME, перечисленных выше. Для каждого
|
||||
найденного компонента его имя добавляется к <tt>HAVE_GNOME</tt>. Так как
|
||||
этот порт может использовать <tt>gnomepanel</tt>, мы проверяем переменную
|
||||
<tt>HAVE_GNOME</tt> на предмет включения в неё <tt>gnomepanel</tt> (для
|
||||
выяснения более полной информации о синтаксисе make-строки
|
||||
:M<tt>pattern</tt>, пожалуйста, обратитесь к <a
|
||||
href="http://www.freebsd.org/cgi/man.cgi?query=make&apropos=0&sektion=0&manpath=FreeBSD+4.6-stable&format=html">
|
||||
страницам справочника о make(1)</a>). Если будет найден компонент
|
||||
<tt>gnomepanel</tt>, то он будет добавлен к списку зависимостей
|
||||
<tt>USE_GNOME</tt>, и будут переданы специфичные для порта
|
||||
<tt>--with-gnome</tt> <tt>CONFIGURE_ARG</tt>. В старой инфраструктуре
|
||||
GNOME переменная <tt>PKGNAMESUFFIX</tt> автоматически перенастраивалась
|
||||
на полноценный макрос <tt>USE_*</tt>. Теперь это отдано человеку,
|
||||
создающему порт. В нашем примерном порте к его имени добавляется
|
||||
<tt>-gnome</tt> для указания на то, что он строится с поддержкой GNOME.
|
||||
То же самое имеет место и для <tt>DATADIR</tt> <tt>PLIST_SUB</tt>.
|
||||
Создатель порта должен решить, когда выполнять подстановку
|
||||
<tt>DATADIR</tt>. Хорошим правилом является добавление <tt>DATADIR</tt>
|
||||
<tt>PLIST_SUB</tt> при использовании компонента <tt>gnomeprefix</tt>.</p>
|
||||
|
||||
<p><b>Замечание:</b> Вы не можете добавлять дополнительные компоненты
|
||||
<tt>USE_GNOME</tt>, используемые по умолчанию, после
|
||||
<tt>.include <bsd.port.pre.mk></tt>. Поэтому следующее использование
|
||||
будет <font color="#FF0000"><b>неправильным</b></font>:</p>
|
||||
|
||||
<pre>
|
||||
.include <bsd.port.pre.mk>
|
||||
|
||||
.if ${HAVE_GNOME:Mgnomelibs}!=""
|
||||
USE_GNOME+= libgnome
|
||||
.else
|
||||
USE_GNOME+= gtk12 # ОШИБКА!
|
||||
.endif
|
||||
</pre>
|
||||
|
||||
<p>Это заставит систему построения думать, что требуется использование GNOME,
|
||||
и тогда <tt>pkg-plist</tt> будет изменён соответствующим образом, что
|
||||
приведёт к ошибке при построении пакаджа. Если вы хотите добавить
|
||||
используемые по умолчанию компоненты <tt>USE_GNOME</tt>, сделайте это
|
||||
<b>перед</b> строкой <tt> .include <bsd.port.pre.mk></tt>.</p>
|
||||
|
||||
<p>Чтобы принудительно вызвать безусловное использование опциональных
|
||||
зависимостей GNOME, вы можете добавить <tt>WITH_GNOME= yes</tt> в файл
|
||||
<tt>/etc/make.conf</tt> или в командную строку make. При этом при проверке
|
||||
зависимости от GNOME будет всегда возвращаться возвращаться положительное
|
||||
значение. Если вы хотите, чтобы система всегда возвращала отрицательный
|
||||
результат при проверке на зависимость от GNOME, вы можете добавить
|
||||
<tt>WITHOUT_GNOME= yes</tt> в <tt>/etc/make.conf</tt> или командную строку
|
||||
make.</p>
|
||||
|
||||
<p>Дополнительную информацию об инфраструктуре USE_GNOME можно найти при
|
||||
просмотре исходных текстов и комментариев в файле
|
||||
<tt>${PORTSDIR}/Mk/bsd.gnome.mk</tt>.</p>
|
||||
|
||||
<!-- End GNOME-related Makefile macros -->
|
||||
|
||||
<!-- Begin GNOME OMF -->
|
||||
<h2>Установка OMF</h2>
|
||||
|
||||
<p>Большое количество приложений GNOME (особенно приложения GNOME 2)
|
||||
устанавливают файлы Open Source Metadata Framework (OMF), которые содержат
|
||||
информацию о файлах справки для этих приложений, Эти OMF-файлы требуют
|
||||
особой обработки через ScrollKeeper для того, чтобы такие приложения, как
|
||||
Yelp могли находить справочную документацию. Для выполнения полноценной
|
||||
регистрации этих файлов OMF при установке приложений GNOME из пакаджей
|
||||
вы должны проверить, что файл <tt>pkg-plist</tt> вашего порта имеет
|
||||
следующие описания для <em>каждого</em> перечисленного файла OMF.</p>
|
||||
|
||||
<pre>
|
||||
@exec scrollkeeper-install -q \
|
||||
%D/path/to/help_file.omf \
|
||||
2>/dev/null || /usr/bin/true
|
||||
@unexec scrollkeeper-uninstall -q \
|
||||
%D/path/to/help_file.omf \
|
||||
2>/dev/null || /usr/bin/true
|
||||
</pre>
|
||||
|
||||
<p>К примеру:</p>
|
||||
|
||||
<pre>
|
||||
@exec scrollkeeper-install -q \
|
||||
%D/share/gnome/bug-buddy/bug-buddy-C.omf \
|
||||
2>/dev/null || /usr/bin/true
|
||||
@unexec scrollkeeper-uninstall -q \
|
||||
%D/share/gnome/bug-buddy/bug-buddy-C.omf \
|
||||
2>/dev/null || /usr/bin/true
|
||||
</pre>
|
||||
|
||||
<!-- End GNOME OMF -->
|
||||
|
||||
<!-- Begin GNOME libtool -->
|
||||
<h2>Проблемы с libtool</h2>
|
||||
|
||||
<p>Большинство, если не все, приложений GNOME зависит от GNU libtool. Они
|
||||
также используют систему конфигурации GNU configure. Если ваш порт
|
||||
устанавливает совместно используемые библиотеки, вы должны добавить строку
|
||||
<tt>USE_LIBTOOL= yes</tt> к Makefile вашего порта. При этом будут учтены
|
||||
все требования при использовании libtool, но это не избавит от таких вещей,
|
||||
как установка файлов .la. Для обеспечения корректной установки совместно
|
||||
используемой библиотеки не забудьте также добавить следующую строку в
|
||||
скрипт <tt>configure</tt> вашего порта непосредственно после строки
|
||||
<tt>LIBTOOL_DEPS="$ac_aux_dir/ltmain.sh"</tt>:</p>
|
||||
|
||||
<pre>
|
||||
$ac_aux_dir/ltconfig $LIBTOOL_DEPS
|
||||
</pre>
|
||||
|
||||
<p>Это отменит установку файлов .la и обеспечит передачу параметра
|
||||
<tt>${PTHREAD_LIBS}</tt> компоновщику.</p>
|
||||
|
||||
<!-- End GNOME libtool -->
|
||||
|
||||
<!-- Begin GNOME distfiles -->
|
||||
<h2>Дистрибутивные файлы</h2>
|
||||
|
||||
<p>Для отделения дистрибутивных файлов GNOME 2 от дистрибутивных файлв GNOME
|
||||
1 и для обеспечения чистоты каталога с дистрибутивными файлами, порты GNOME
|
||||
1, которые сгружают свои дистрибутивные файлы с
|
||||
<tt>${MASTER_SITE_GNOME}</tt>, должны иметь следующую строку в своём
|
||||
Makefile:</p>
|
||||
|
||||
<pre>
|
||||
DIST_SUBDIR= gnome
|
||||
</pre>
|
||||
|
||||
<p>Порты GNOME 2, которые сгружают свои дистрибутивные файлы с
|
||||
<tt>${MASTER_SITE_GNOME}</tt>, должны иметь следующую строку в своём
|
||||
Makefile:</p>
|
||||
|
||||
<pre>
|
||||
DIST_SUBDIR= gnome2
|
||||
</pre>
|
||||
|
||||
<p>Некоторые дистрибутивные файлы GNOME распространяются как в формате
|
||||
tar gzip, так и tar bzip2. Для экономии времени при сгрузке дистрибутивных
|
||||
файлов по медленным каналам связи вы должны использовать дистрибутивные
|
||||
файлы bzip2 там, где это возможно. Для этого добавьте следующую строку
|
||||
в Makefile вашего порта:</p>
|
||||
|
||||
<pre>
|
||||
USE_BZIP2= yes
|
||||
</pre>
|
||||
|
||||
<!-- End GNOME distfiles -->
|
||||
|
||||
<p>Если вам нужна помощь при работе с портом, для примера взгляните на
|
||||
некоторые из <a href="/ports/gnome.html">существующих портов</a>. К вашим
|
||||
услугам также и <a href="mailto:&email;@FreeBSD.org">список рассылки
|
||||
freebsd-gnome</a>.</p>
|
||||
|
||||
&footer;
|
||||
|
||||
</body>
|
||||
</html>
|
||||
Loading…
Reference in a new issue