diff options
Diffstat (limited to 'tde-i18n-ru/docs/kdevelop/kdevelop/kdevelop-install.docbook')
| -rw-r--r-- | tde-i18n-ru/docs/kdevelop/kdevelop/kdevelop-install.docbook | 1292 |
1 files changed, 1292 insertions, 0 deletions
diff --git a/tde-i18n-ru/docs/kdevelop/kdevelop/kdevelop-install.docbook b/tde-i18n-ru/docs/kdevelop/kdevelop/kdevelop-install.docbook new file mode 100644 index 00000000000..672c9f56e65 --- /dev/null +++ b/tde-i18n-ru/docs/kdevelop/kdevelop/kdevelop-install.docbook @@ -0,0 +1,1292 @@ +<appendix id="kdevelop-install"> + +<appendixinfo> + <authorgroup> + <author +><firstname +>Bernd</firstname +><surname +>Pol</surname +></author> + <author +><firstname +>Anne-Marie</firstname +><surname +>Mahfouf</surname +></author> + <!-- ROLES_OF_TRANSLATORS --> + </authorgroup> +</appendixinfo> + +<title +>Установка &kdevelop;</title> + +<indexterm zone="kdevelop-install"> + <primary +>установка</primary +></indexterm> + +<para +>В этой главе описаны все этапы сборки и установки &kdevelop;: <itemizedlist> + <listitem +><para +>Раздел <link linkend="kdevelop-install-howto" +>Как получить &kdevelop;</link +> содержит информацию по загрузке последней версии &kdevelop; в виде исходного кода из репозитория SVN. </para +></listitem> + <listitem +><para +>Раздел <link linkend="requirements" +>Требования &kdevelop;</link +> содержит список программ и библиотек, необходимых для сборки &kdevelop;. </para +></listitem> + <listitem +><para +>Раздел <link linkend="compile-and-install" +>Сборка и установка &kdevelop;</link +> проведёт вас через все этапы сборки и установки &kdevelop;. </para +></listitem> + <listitem +><para +>Раздел <link linkend="make-api" +>Как получить документацию по &API;</link +> рассказывает что такое API и как вам получить удобный инструмент для навигации по исходникам &kdevelop;. </para +></listitem> +</itemizedlist> +</para> + +<sect1 id="kdevelop-install-howto"> +<title +>Как получить &kdevelop;</title> + +<indexterm zone="kdevelop-install-howto"> + <primary +>получение &kdevelop;</primary +></indexterm> +<indexterm zone="kdevelop-install-howto"> + <primary +>&kdevelop;</primary> + <secondary +>получение</secondary +></indexterm> + +<para +>&kdevelop; доступен в собранном виде во многих дистрибутивах &Linux;, таких, как SuSE, RedHat и других, чаще всего в виде пакета RPM, для упрощения процесса установки. Для установки из собранного пакета обратитесь к документации по вашему дистрибутиву. </para> +<para +>Также вы можете загрузить исходный код, собрать и установить &kdevelop; самостоятельно. Исходный код среды разработки доступен на <ulink url="http://www.kdevelop.org" +>http://www.kdevelop.org</ulink +> и <ulink url="http://download.kde.org" +>ftp-сервер &kde;</ulink +>. </para> + +<sect2 id="howto-svn"> +<title +>Получение ежедневных снимков &kdevelop; из SVN</title> + +<indexterm zone="howto-svn"> + <primary +>svn</primary +></indexterm> + +<para +>Если вы хотите быть в курсе последних разработок, то доступен анонимный снимок репозитория SVN.</para> +<para +>Имя модуля <emphasis +>kdevelop</emphasis +> в репозитории <filename class="directory" +>svn co svn://anonsvn.kde.org/home/kde/branches/KDE/3.5/kdevelop</filename +>. </para> + +<sect3 id="howto-svn-co"> +<title +>Скачивание рабочей копии</title> + +<indexterm zone="howto-svn-co"> + <primary +>checkout</primary +></indexterm> +<indexterm zone="howto-svn-co"> + <primary +>&kdevelop;</primary> + <secondary +>svn</secondary> + <tertiary +>checkout</tertiary +></indexterm> + +<para +>Для получения версии &kdevelop;, загрузите его с анонимного репозитория SVN. Эта операция называется скачивание рабочей копии (<emphasis +>checkout</emphasis +>). </para> + +<note +><para +>Далее подразумевается, что исходный код &kdevelop; расположен в каталоге <filename class="directory" +>~/kde3src</filename +>. </para +></note> + +<informalexample +><simplelist> + <member +># Создаём конечный каталог, если необходимо: </member> + <member +><prompt +>~> </prompt +> <userinput +>mkdir kde3src</userinput +> </member> + <member +><prompt +>~> </prompt +> <userinput +>cd kde3src</userinput +> </member> + <member +><prompt +>~/kde3src> </prompt +> <userinput +>svn co svn://anonsvn.kde.org/home/kde/branches/KDE/3.5/kdevelop</userinput +> </member> + <member +><prompt +>~/kde3src> </prompt +> <userinput +>cd kdevelop</userinput +> </member> +</simplelist +></informalexample> + +<note +><para +>После полной загрузки рабочей копии &kdevelop; вы можете постоянно иметь самую последнюю версию путём обновления, что описано в следующем разделе. </para +></note> + +<important +><para +><emphasis +>Пожалуйста, не загружайте каждый раз все файлы заново!</emphasis +> Используйте команду svn update. </para +></important> + +<para +>Теперь вы можете собрать &kdevelop;, как показано в разделе <link linkend="compile-and-install" +>Сборка и установка &kdevelop;</link +>. </para> + +</sect3 +> <!-- howto-svn-co --> + +<sect3 id="howto-svn-up"> +<title +>Поддержка локальной рабочей копии в актуальном состоянии</title> + +<indexterm zone="howto-svn-up"> + <primary +>update</primary +></indexterm> +<indexterm zone="howto-svn-up"> + <primary +>&kdevelop;</primary> + <secondary +>svn</secondary> + <tertiary +>update</tertiary +></indexterm> + +<para +>После загрузки (и сборки) &kdevelop; из SVN можно поддерживать вашу рабочую копию исходного кода в актуальном состоянии, чтобы получать все исправления. Для этого (опять же таки предполагается, что копия исходного кода &kdevelop; расположена в каталоге <filename class="directory" +>kde3src</filename +>). </para> +<para +>Обратите внимание на использование команды <command +>up</command +> (<emphasis +>update</emphasis +>, обновить) вместо <command +>co</command +> (<emphasis +>checkout</emphasis +>). </para> + +<informalexample +><simplelist> + <member +><prompt +>~> </prompt +> <userinput +>cd kde3src</userinput +> </member> + <member +><prompt +>~/kde3src> </prompt +> <userinput +>cd kdevelop</userinput +> </member> + <member +><prompt +>~/kde3src> </prompt +> <userinput +>svn up</userinput +> </member> +</simplelist +></informalexample> + +<note +><para +>Следите за сообщениями svn в процессе обновления, так как от этого зависят конкретные шаги сборки. </para +></note> + +<para +>После обновления &kdevelop;, приложение нужно собрать как описано в главе <link linkend="compile-and-install-make-svn" +>Нюансы сборки из SVN</link +>. </para> +</sect3 +> <!-- howto-svn-up --> + +</sect2 +> <!-- howto-svn --> + +</sect1 +> <!-- howto --> + +<!-- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - --> + +<sect1 id="requirements"> +<title +>Требования</title> + +<indexterm zone="requirements"> + <primary +>требования</primary +></indexterm> +<indexterm zone="requirements"> + <primary +>&kdevelop;</primary> + <secondary +>требования</secondary +></indexterm> +<indexterm zone="requirements"> + <primary +>GNU</primary> + <secondary +>требования</secondary +></indexterm> + +<para +>Для успешной сборки и последующего использования &kdevelop;, необходимо установить следующие программы и библиотеки. Обычно они поставляются с дистрибутивами, а значит установить их можно просто. </para> + +<itemizedlist> +<title +>Требуется:</title> + <listitem> + <para +><application +>gcc/g++</application +> ≥ 2.95.3 (или аналог) <indexterm> + <primary +>gcc</primary> + <secondary +>требования</secondary +></indexterm> + <indexterm> + <primary +>g++</primary> + <secondary +>требования</secondary +></indexterm> + </para> + <para +>Официальный сайт: <ulink url="gcc.gnu.org" +>gcc.gnu.org</ulink +> </para> + </listitem> + <listitem> + <para +><application +>&GNU; make</application +> (или аналог) <indexterm> + <primary +>make</primary> + <secondary +>требования</secondary +></indexterm> + </para> + <para +>Официальный сайт: <ulink url="www.gnu.org/software/make" +>www.gnu.org/software/make</ulink +> </para> + </listitem> + <listitem> + <para +>&perl; 5.004 (или выше) <indexterm> + <primary +>Perl</primary> + <secondary +>требования</secondary +></indexterm> + </para> + <para +>Официальный сайт: <ulink url="www.perl.com" +>www.perl.com</ulink +> </para> + </listitem> + <listitem> + <para +><application +>autoconf</application +> ≥ 2.52 (или выше) <indexterm> + <primary +>autoconf</primary> + <secondary +>требования</secondary +></indexterm> + </para> + <para +>Официальный сайт: <ulink url="www.gnu.org/software/autoconf" +>www.gnu.org/software/autoconf</ulink +> </para> + </listitem> + <listitem> + <para +><application +>automake</application +> ≥ 1.6 (или выше) <indexterm> + <primary +>automake</primary> + <secondary +>требования</secondary +></indexterm> + </para> + <para +>Официальный сайт: <ulink url="www.gnu.org/software/automake" +>www.gnu.org/software/automake</ulink +> </para> + </listitem> + <listitem> + <para +><application +>flex</application +> 2.5.4 (или выше) <indexterm> + <primary +>flex</primary> + <secondary +>требования</secondary +></indexterm> + </para> + <para +>Официальный сайт: <ulink url="www.gnu.org/software/flex" +>www.gnu.org/software/flex</ulink +> </para> + </listitem> + <listitem> + <para +>&Qt; ≥ 3.0.3 (или выше) <indexterm> + <primary +>Qt</primary> + <secondary +>требования</secondary +></indexterm> + </para> + <para +>Официальный сайт: <ulink url="www.trolltech.com/products/qt" +>www.trolltech.com/products/qt</ulink +> </para> + </listitem> + <listitem> + <para +><application +>KDE</application +> ≥ 3.0.2 (или выше) <indexterm> + <primary +>KDE</primary> + <secondary +>требования</secondary +></indexterm> + </para> + <para +>Официальный сайт: <ulink url="www.kde.org" +>www.kde.org</ulink +> </para> + </listitem> +</itemizedlist> + +<itemizedlist> +<title +>Необязательно:</title> + <listitem +><para +>Средство навигации по исходному коду <emphasis +><application +>ctags</application +></emphasis +>, с <ulink url="http://ctags.sourceforge.net" +>http://ctags.sourceforge.net</ulink +>, позволяющее быстрое перейти к объявлению или определению несколькими щелчками мыши на имени переменной в редакторе. <indexterm +><primary +>ctags</primary +></indexterm> + </para +></listitem> + <listitem +><para +><emphasis +><application +>dot</application +></emphasis +>, генератор изображений, с <ulink url="http://www.graphviz.org" +>http:/www.graphviz.org</ulink +>. Он нужен для &doxygen;, чтобы наглядно показать иерархию классов. <indexterm +><primary +>dot</primary +></indexterm> + </para +></listitem> + <listitem +><para +>Средство документирования <emphasis +>&doxygen;</emphasis +>, с <ulink url="http://www.doxygen.org" +>http://www.doxygen.org</ulink +>, с помощью которого вы сможете сгенерировать лаконичную и гибкую документацию API вашего проекта. <indexterm +><primary +>doxygen</primary +></indexterm> + </para +></listitem> + <listitem +><para +><emphasis +><application +>valgrind</application +></emphasis +> с <ulink url="http://developer.kde.org/~sewardj/" +>http://developer.kde.org/~sewardj/</ulink +> поможет найти утечки памяти в вашем приложении. <indexterm +><primary +>valgrind</primary +></indexterm> + </para +></listitem> + <listitem +><para +><emphasis +><application +>svn</application +></emphasis +> с <ulink url="http://subversion.tigris.org/" +>http://subversion.tigris.org/</ulink +> если вы хотите использовать систему управления версиями SVN. <indexterm> + <primary +>svn</primary> + <secondary +>требования</secondary +></indexterm> + </para +></listitem> + <listitem +><para +>Любой другой компилятор и/или инструмент, если вы разрабатываете программное обеспечение на языке или платформе, отличных от C++/&kde;. </para +></listitem> +</itemizedlist> + +<note> +<orderedlist> + <listitem> + <para +>Вы можете обойти требования &autoconf; ≥ 2.52 и &automake; ≥ 1.6. Просто удалите подкаталог <filename class="directory" +>admin</filename +> в установочном каталоге &kdevelop; и введите <indexterm> + <primary +>autoconf</primary> + <secondary +>обхождение требования версий</secondary +></indexterm> + <indexterm> + <primary +>automake</primary> + <secondary +>обхождение требования версий</secondary +></indexterm> + <indexterm> + <primary +>требование версии</primary> + <secondary +>обхождение требования autoconf/automake</secondary +></indexterm> + </para> + <informalexample +><simplelist> + <member +><prompt +>(каталог-kdevelop)> </prompt +> <userinput +>ln -s $KDEDIR/share/apps/kdelibs/admin admin</userinput +></member> + </simplelist +></informalexample> + <para +>в консоли. При этом &kdevelop; будет использовать стандартные параметры в каталоге &kde; <filename class="directory" +>admin</filename +> . </para> + </listitem> + <listitem> + <para +>Убедитесь, что вы <emphasis +>не смешиваете разные версии &Qt;</emphasis +>. Всегда собирайте &kdevelop; с той версией &Qt;, с которой были собраны библиотеки &kde;. Иначе вы можете получить очень странное поведение программы. </para> + </listitem> +</orderedlist> +</note> + +</sect1 +> <!-- requirements --> + +<!-- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - --> + +<sect1 id="compile-and-install"> +<title +>Сборка и установка &kdevelop;</title> + +<indexterm zone="compile-and-install"> + <primary +>&kdevelop;</primary> + <secondary +>сборка</secondary +></indexterm> +<indexterm zone="compile-and-install"> + <primary +>&kdevelop;</primary> + <secondary +>установка</secondary +></indexterm> + +<para +>После удовлетворения всех требований, вы можете приступить к сборки и установке &kdevelop;. В приложении описаны необходимые для этого действия. </para> +<itemizedlist> + <listitem +><para +>Раздел <link linkend="compile-and-install-preliminaries" +>Подготовительные шаги</link +> содержит инструкции по установке окружения. </para +></listitem> + <listitem +><para +>Раздел <link linkend="compile-and-install-make" +>Сборка &kdevelop;</link +> расскажет как получить исходный код &kdevelop; из svn, подготовить его, скомпилировать и установить. </para +></listitem> + <listitem +><para +>Раздел <link linkend="compile-and-install-options" +>Примечания по ключам <command +>configure</command +></link +> покажет как собрать &kdevelop; не в каталог &kde; по умолчанию. </para +></listitem> +</itemizedlist> + +<sect2 id="compile-and-install-preliminaries"> +<title +>Подготовительные шаги</title> + +<indexterm zone="compile-and-install-preliminaries"> + <primary +>подготовка</primary> + <secondary +>Установка &kdevelop;</secondary +></indexterm> +<indexterm zone="compile-and-install-preliminaries"> + <primary +>KDEDIR</primary +></indexterm> +<indexterm zone="compile-and-install-preliminaries"> + <primary +>QTDIR</primary +></indexterm> +<indexterm zone="compile-and-install-preliminaries"> + <primary +>LD_LIBRARY_PATH</primary +></indexterm> +<indexterm zone="compile-and-install-preliminaries"> + <primary +>LIBRARY_PATH</primary +></indexterm> +<indexterm zone="compile-and-install-preliminaries"> + <primary +>PATH</primary +></indexterm> + +<para +>Перед началом сборки убедитесь, что все библиотеки и инструменты доступны сборочной системе make. Для этого нужно правильно выставить переменные окружения. Шаги, которые следует выполнить при этом, зависят от используемой оболочки («shell»). </para> + +<note +><para +>Чтобы не вводить все необходимые операторы по определению переменных окружения каждый раз, вы можете записать их в файл <filename +>.bashrc</filename +> или <filename +>.cshrc</filename +>. Таким образом, переменные будут иметь нужное значение каждый раз при входе в систему. </para +></note> + +<sect3 id="compile-and-install-preliminaries-bash"> +<title +>Настройка окружения в оболочке bash</title> + +<para +>Если вы используете bash, добавьте в его файл конфигурации такие строки: </para> + +<informalexample +><simplelist> + <member +><userinput +>export KDEDIR=</userinput +>(путь к KDE)</member> + <member +><userinput +>export QTDIR=</userinput +>(путь к библиотеке Qt)</member> + <member +><userinput +>export LD_LIBRARY_PATH=$QTDIR/lib:$KDEDIR/lib:$LD_LIBRARY_PATH</userinput +></member> + <member +><userinput +>export LIBRARY_PATH=$QTDIR/lib:$KDEDIR/lib:$LIBRARY_PATH</userinput +></member> + <member +><userinput +>export PATH=$QTDIR/bin:$KDEDIR/bin:$PATH</userinput +></member> +</simplelist +></informalexample> +<para +></para> + +</sect3 +> <!-- compile-and-install-preliminaries-bash --> + +<sect3 id="compile-and-install-preliminaries-tcsh"> +<title +>Настройка окружения для оболочки tcsh</title> + +<para +>Если вы используете tcsh, добавьте в его файл конфигурации такие строки: </para> +<para> +<informalexample +><simplelist> + <member +><userinput +>setenv KDEDIR </userinput +>(путь к KDE)</member> + <member +><userinput +>setenv QTDIR </userinput +>(путь к библиотеке Qt)</member> + <member +><userinput +>setenv LD_LIBRARY_PATH=$QTDIR/lib:$KDEDIR/lib:$LD_LIBRARY_PATH</userinput +></member> + <member +><userinput +>setenv LIBRARY_PATH $QTDIR/lib:$KDEDIR/lib:$LIBRARY_PATH</userinput +></member> + <member +><userinput +>setenv PATH $QTDIR/bin:$KDEDIR/bin:$PATH</userinput +></member> +</simplelist +></informalexample> +</para> + +</sect3 +> <!-- compile-and-install-preliminaries-tcs --> + +</sect2 +> <!-- compile-and-install-preliminaries --> + +<sect2 id="compile-and-install-make"> +<title +>Сборка &kdevelop;</title> + +<indexterm zone="compile-and-install-make"> + <primary +>make</primary> + <secondary +>Установка &kdevelop;</secondary +></indexterm> +<indexterm zone="compile-and-install-make"> + <primary +>сборка, компиляция</primary> + <secondary +>&kdevelop;</secondary +></indexterm> + +<note +><para +>Далее подразумевается, что исходный код &kdevelop; расположен в каталоге <filename class="directory" +>~/kde3src/kdevelop</filename +>. </para +></note> + +<sect3 id="compile-and-install-make-svn"> +<title +>Особенности сборки из SVN</title> + +<para +>Если вы собираете &kdevelop; из SVN, начальные шаги сборки зависят от того, загрузили ли вы рабочую копию (checkout) или обновили ранее загруженную копию (update). </para> + +<variablelist> +<varlistentry> +<term id="compile-and-install-make-svn-co" +>После svn checkout</term> +<listitem> +<para +>Вы должны <emphasis +>инициализировать сборочную систему</emphasis +> после скачивания рабочей копии. Тоже самое необходимо сделать если вы хотите начать сборку с нуля. Наберите: </para> + +<informalexample +><simplelist +><member +><prompt +>~/kde3src/kdevelop> </prompt +> <userinput +>make -f admin/Makefile.common svn-clean</userinput +> </member +></simplelist +></informalexample> +<para +>и выполните <emphasis +>все следующие шаги</emphasis +>. </para> +<note +><para +>Для восстановления повреждённых и отсутствующих файлов, возможно, потребуется запустить svn cleanup. </para +></note> +<important +><para +>Выполните команду <command +>svn-clean</command +> чтобы <emphasis +>удалить все файлы</emphasis +>, не имеющие соответствия в репозитории SVN. Убедитесь что вы сделали резервные копии всей ценной информации перед выполнением этой команды. </para +></important> +</listitem> +</varlistentry> + +<varlistentry> +<term id="compile-and-install-make-svn-up" +>После обновления SVN</term> +<listitem> +<para +>Следующий шаг зависит от вывода команды обновления svn update. Если в нём было U или P в начале строки — это означает изменение файла: </para> + +<screen +>U /some_directory_path/Makefile.am +</screen> +<para +>или, после загрузки рабочей копии (checkout), введите: </para> +<informalexample +><simplelist +><member +><prompt +>~/kde3src/kdevelop> </prompt +> <userinput +>make -f Makefile.svn</userinput +> </member +></simplelist +></informalexample> +<para +>перед выполнением <emphasis +>всех следующих шагов</emphasis +>. </para> +</listitem> +</varlistentry> +</variablelist> +</sect3 +> <!-- compile-and-install-make-svn --> + +<sect3 id="compile-and-install-make-basic"> +<title +>Команды сборки <command +>make</command +></title> + +<para +>Теперь вы должны решить, какую систему &kdevelop; вы хотите использовать. На следующем шаге генерируются файлы <filename +>Makefile</filename +>, который нужны для сборки командой <command +>make</command +>. </para> + +<note +><para +>Вы можете не указывать параметр <option +>--prefix</option +> при запуске <command +>configure</command +>, в этом случае &kdevelop; будет установлен в каталог &kde; по умолчанию. Подробно это изложено в разделе <link linkend="compile-and-install-options" +>Примечания по ключам <command +>configure</command +></link +>. </para +></note> + +<variablelist> +<varlistentry> +<term +>Версия с отладочной информацией</term> +<listitem> +<para +>Если вы хотите следить за тем, что &kdevelop; делает во время выполнения, выберите сборку версии с отладочной информацией. Просто запустите <command +>configure</command +> следующим образом: </para> + +<informalexample +><simplelist +><member +><prompt +>~/kde3src/kdevelop> </prompt +> <userinput +>./configure --enable-debug=full --prefix=</userinput +>(путь-к-kde3) </member +></simplelist +></informalexample> +</listitem> +</varlistentry> + +<varlistentry> +<term +>Финальная версия</term> +<listitem> +<para +>Если вы хотите просто использовать &kdevelop; как есть (с меньшим размером и более быстрой работой), запускайте <command +>configure</command +> с параметрами по умолчанию:</para> + +<informalexample +><simplelist +><member +><prompt +>~/kde3src/kdevelop> </prompt +> <userinput +>./configure --prefix=</userinput +>(путь-к-kde3) </member +></simplelist +></informalexample> + +<note> +<para +>Если вы хотите собрать также <link linkend="make-api" +>документацию по API</link +> для &kdevelop;, вам нужно указать соответствующий параметр в команде запуска <command +>configure</command +>: </para> +<informalexample +><simplelist> + <member +><prompt +>~/kde3src/kdevelop> </prompt +> <userinput +>./configure --</userinput +>(такие-же-ключи) <userinput +>\</userinput +></member +> <member +><userinput +>--with-kdelibsdoxy-dir=$KDEDIR/share/doc/HTML/en/kdelibs-apidocs</userinput +></member> +</simplelist +></informalexample> +</note> +</listitem> +</varlistentry> + +<varlistentry> +<term +>Сборка посредством make и установка</term> +<listitem> +<para +>Скрипт <command +>configure</command +> проверит систему и создаст файл <filename +>Makefile</filename +>, который будет использовать команда <command +>make</command +>. Команда <command +>make</command +> будет использовать основной файл <filename +>Makefile</filename +> по умолчанию. </para> + +<informalexample +><simplelist +><member +><prompt +>~/kde3src/kdevelop> </prompt +> <userinput +>make</userinput +> </member +></simplelist +></informalexample> +<para +>Для установки получите права суперпользователя командой: </para> +<informalexample +><simplelist +><member +><prompt +>~/kde3src/kdevelop> </prompt +> <userinput +>su</userinput +> </member +></simplelist +></informalexample> +<para +>и введите пароль пользователя root. После этого установите &kdevelop;: </para> +<informalexample +><simplelist +><member +><prompt +>~/kde3src/kdevelop> </prompt +> <userinput +>make install</userinput +> </member +></simplelist +></informalexample> +<para +>Если &kdevelop; установлен в каталог &kde; по умолчанию, вы можете сразу запустить <acronym +>IDE</acronym +>. Иначе потребуются некоторые дополнительные шаги. Подробно об этом рассказано в разделе <link linkend="compile-and-install-options-dir" +>Нестандартный каталог установки</link +>. </para> + +<note> + <para +>На самом деле будут установлены три программы: </para> + <itemizedlist> + <listitem +><para +>&kdevelop; IDE — среда разработки, в которой вы обычно работаете.</para +></listitem> + <listitem +><para +>&kdevelop; Assistant — программа автономного просмотра документации, предоставляющая всю функциональность соответствующего модуля &kdevelop; IDE.</para +></listitem> + <listitem +><para +>&kdevelop; Designer — расширение &Qt; Designer, добавляющее специфические для виджеты &kde; и интегрирующее его в &kdevelop; IDE.</para +></listitem> + </itemizedlist> +</note> +</listitem> +</varlistentry> +</variablelist> + + +</sect3 +> <!-- compile-and-install-make-basic --> +</sect2 +> <!-- compile-and-install-make --> + + +<sect2 id="compile-and-install-options"> +<title +>Примечания по ключам <command +>configure</command +></title> + +<sect3 id="compile-and-install-options-dir"> +<title +>Нестандартный каталог установки</title> + +<indexterm zone="compile-and-install-options-dir"> + <primary +>&kdevelop;</primary> + <secondary +>установка</secondary> + <tertiary +>нестандартный каталог</tertiary +></indexterm> +<indexterm zone="compile-and-install-options-dir"> + <primary +>нестандартный каталог</primary +></indexterm> +<indexterm zone="compile-and-install-options-dir"> + <primary +>KDEDIRS</primary +></indexterm> +<indexterm zone="compile-and-install-options-dir"> + <primary +>kbuildsycoca</primary +></indexterm> + +<para +>По умолчанию <acronym +>IDE</acronym +> устанавливается в каталог &kde;. Это необходимо &kdevelop; для прямого доступа к некоторым утилитам и модулям, расположенным в этом каталоге. Чтобы использовать другой каталог для установки, запустите <command +>configure</command +> с параметром <option +>--prefix</option +>: </para> +<informalexample +><simplelist +><member +><prompt +>~/kde3src/kdevelop> </prompt +> <userinput +>./configure --prefix=</userinput +>(путь-к-kde3) </member +></simplelist +></informalexample> +<para +>И всё же устанавливать программу в другой каталог не рекомендуется. Конечно, вы можете сделать это, но тогда вы получите очень ограниченную функциональность. </para> +<para +>Перед запуском &kdevelop; выполните следующие команды из командной строки: </para> + +<note +><para +><emphasis +>Обратите внимание на множественную форму:</emphasis +> <quote +><envar +>KDEDIRS</envar +></quote +>, а не <quote +><envar +>KDEDIR</envar +></quote +> </para +></note> + +<informalexample +><simplelist> + <member +><prompt +>~> </prompt +> <userinput +>export KDEDIRS=/usr/local/kde:/opt/kde3</userinput +> </member> + <member +><prompt +>~> </prompt +> <userinput +>kbuildsycoca</userinput +> </member> + <member +>Теперь запустим &kdevelop;: </member> + <member +><prompt +>~> </prompt +> <userinput +>kdevelop</userinput +> </member> +</simplelist +></informalexample> + +<note +><simplelist> + <member +>Переменная окружения <envar +>KDEDIRS</envar +> должна содержать <emphasis +>список активных каталогов &kde;</emphasis +> вашей системы. Обычно это</member> + <member +><filename class="directory" +>/usr/local/kde</filename +>:<filename class="directory" +>/opt/kde3</filename +></member> + <member +>однако в вашей системе это могут быть другие каталоги.</member> + <member +>Каталог <filename class="directory" +>/usr/local/kde</filename +>, например, может содержать неполную версию &kde;, которую вы собрали для отладки, а <filename class="directory" +>/opt/kde3</filename +> — версию &kde; из вашего дистрибутива.</member> +</simplelist +></note> + +<para +>в оболочке tcsh определение переменных окружения происходит таким образом: </para> +<informalexample +><simplelist +><member +><prompt +>~> </prompt +> <userinput +>setenv KDEDIRS /usr/local/kde:/opt/kde3</userinput +> </member +></simplelist +></informalexample> +<para +>Команда <command +>kbuildsycoca</command +> (<quote +>build system control cache</quote +> — кэш системных параметров) выполняет поиск библиотек и записывает их размещение и версию в кэш, чтобы &kdevelop; смог их найти. Это займёт некоторое время, и это нужно выполнять каждый раз перед запуском &kdevelop; из оболочки, если вы установили программу в нестандартный каталог. Конечно, из этих команд можно составить сценарий и запускать только его. </para> +<para +>Кроме того можно дополнить файлы <filename +>.bashrc</filename +> или <filename +>.cshrc</filename +>, но это не желательно, так как команда будут выполняться при каждом входе в консоль. </para> + +<note +><para +>Команду <command +>kbuildsycoca</command +> не нужно выполнять с правами суперпользователя. И вообще, заниматься разработкой под root <emphasis +>не очень хорошая идея</emphasis +>! </para +></note> +</sect3 +> <!-- compile-and-install-options-dir --> + +<!-- ### put a sect3 with other configuration options here --> + +</sect2 +> <!-- compile-and-install-options --> + +</sect1 +> <!-- compile-and-install --> + +<sect1 id="make-api"> +<title +>Как получить документацию по &API;</title> + +<indexterm zone="make-api"> + <primary +>API</primary> + <secondary +>&kdevelop;</secondary +></indexterm> +<indexterm zone="make-api"> + <primary +>&kdevelop;</primary> + <secondary +>API</secondary +></indexterm> +<indexterm zone="make-api"> + <primary +>сборка, компиляция</primary> + <secondary +>&kdevelop;</secondary> + <tertiary +>API</tertiary +></indexterm> +<indexterm zone="make-api"> + <primary +>configure</primary> + <secondary +>API &kdevelop;</secondary +></indexterm> + +<para +>API — сокращение от <quote +>Application Program Interface</quote +> (программный интерфейс приложения). Это набор описаний, по которым приложение обращается к операционной системе и другим службам. API приложения &kde; или &Qt; — описание интерфейсов классов и методов, которые используются для навигации по исходному коду приложения. </para> +<para +>Последняя версия документации по API находится на <ulink url="http://www.kdevelop.org/HEAD/doc/api/html/index.html" +>сайте KDevelop</ulink +>. Она обновляется каждые 24 часа. </para> +<para +>Чтобы собрать документацию по API из исходного кода &kdevelop; самостоятельно, нужно указать где искать API KDELIBS, добавив параметр <option +>--with-kdelibsdoxy-dir</option +> при запуске <command +>configure</command +>: </para> + +<informalexample +><simplelist> + <member +><prompt +>~/kde3src/kdevelop> </prompt +> <userinput +>./configure --</userinput +>(прочие параметры)<userinput +> \</userinput +> </member> + <member> + <userinput +>--with-kdelibsdoxy-dir=$KDEDIR/share/doc/HTML/en/kdelibs-apidocs</userinput> + </member> +</simplelist +></informalexample> + +<para +>(<command +>make</command +> заменит глобальную переменную <varname +>$KDEDIR</varname +> на каталог, где установлен &kde;). Затем запустите <command +>make</command +> <link linkend="compile-and-install-make-basic" +>как обычно</link +>. После сборки &kdevelop; можно также собрать документацию по API. Для этого выполните </para> +<informalexample +><simplelist +><member +><prompt +>~/kde3src/kdevelop> </prompt +> <userinput +>make apidocs</userinput +> </member +></simplelist +></informalexample> + +<para +>Это создаст файл <filename +>Doxyfile</filename +> в основном каталоге исходного кода &kdevelop;, который передаётся на обработку программе <application +>Doxygen</application +>, в результате чего будет создано большое количество файлов <filename +>.html</filename +> в течение некоторого времени (до часа на медленных машинах). После окончания процесса сборки нужно установить документацию. Получите права суперпользователя </para> + +<informalexample +><simplelist +><member +><prompt +>~/kde3src/kdevelop> </prompt +> <userinput +>su</userinput +> </member +></simplelist +></informalexample> + +<para +>и введите пароль пользователя root, затем установите файлы документации по API: </para> + +<informalexample +><simplelist +><member +><prompt +>~/kde3src/kdevelop> </prompt +> <userinput +>make install-apidox</userinput +> </member +></simplelist +></informalexample> + +<para +>После этого <command +>make</command +> выведет имя каталога, где установлена документация по API. </para> + +<note +><para +>Возможно, вы увидите большое количество предупреждений или сообщений об ошибках в процессе сборки документации по API программой <application +>Doxygen</application +>. Они представляют интерес только для разработчиков &kdevelop;. Если всё пройдёт нормально, файлы <filename +>.html</filename +> будут доступными для чтения. </para +></note> + +</sect1 +> <!-- make-api --> + +</appendix +> <!-- kdevelop-install --> |