BerndPol Anne-MarieMahfouf установка В этой главе описаны все этапы сборки и установки &tdevelop;: Раздел Как получить &tdevelop; содержит информацию по загрузке последней версии &tdevelop; в виде исходного кода из репозитория SVN. Раздел Требования &tdevelop; содержит список программ и библиотек, необходимых для сборки &tdevelop;. Раздел Сборка и установка &tdevelop; проведёт вас через все этапы сборки и установки &tdevelop;. Раздел Как получить документацию по &API; рассказывает что такое API и как вам получить удобный инструмент для навигации по исходникам &tdevelop;. получение &tdevelop; &tdevelop; получение &tdevelop; доступен в собранном виде во многих дистрибутивах &Linux;, таких, как SuSE, RedHat и других, чаще всего в виде пакета RPM, для упрощения процесса установки. Для установки из собранного пакета обратитесь к документации по вашему дистрибутиву. Также вы можете загрузить исходный код, собрать и установить &tdevelop; самостоятельно. Исходный код среды разработки доступен на http://www.tdevelop.org и ftp-сервер &kde;. svn Если вы хотите быть в курсе последних разработок, то доступен анонимный снимок репозитория SVN. Имя модуля tdevelop в репозитории svn co svn://anonsvn.kde.org/home/kde/branches/KDE/3.5/tdevelop. checkout &tdevelop; svn checkout Для получения версии &tdevelop;, загрузите его с анонимного репозитория SVN. Эта операция называется скачивание рабочей копии (checkout). Далее подразумевается, что исходный код &tdevelop; расположен в каталоге ~/kde3src. # Создаём конечный каталог, если необходимо: ~> mkdir kde3src ~> cd kde3src ~/kde3src> svn co svn://anonsvn.kde.org/home/kde/branches/KDE/3.5/tdevelop ~/kde3src> cd tdevelop После полной загрузки рабочей копии &tdevelop; вы можете постоянно иметь самую последнюю версию путём обновления, что описано в следующем разделе. Пожалуйста, не загружайте каждый раз все файлы заново! Используйте команду svn update. Теперь вы можете собрать &tdevelop;, как показано в разделе Сборка и установка &tdevelop;. update &tdevelop; svn update После загрузки (и сборки) &tdevelop; из SVN можно поддерживать вашу рабочую копию исходного кода в актуальном состоянии, чтобы получать все исправления. Для этого (опять же таки предполагается, что копия исходного кода &tdevelop; расположена в каталоге kde3src). Обратите внимание на использование команды up (update, обновить) вместо co (checkout). ~> cd kde3src ~/kde3src> cd tdevelop ~/kde3src> svn up Следите за сообщениями svn в процессе обновления, так как от этого зависят конкретные шаги сборки. После обновления &tdevelop;, приложение нужно собрать как описано в главе Нюансы сборки из SVN. требования &tdevelop; требования GNU требования Для успешной сборки и последующего использования &tdevelop;, необходимо установить следующие программы и библиотеки. Обычно они поставляются с дистрибутивами, а значит установить их можно просто. gcc/g++ ≥ 2.95.3 (или аналог) gcc требования g++ требования Официальный сайт: gcc.gnu.org &GNU; make (или аналог) make требования Официальный сайт: www.gnu.org/software/make &perl; 5.004 (или выше) Perl требования Официальный сайт: www.perl.com autoconf ≥ 2.52 (или выше) autoconf требования Официальный сайт: www.gnu.org/software/autoconf automake ≥ 1.6 (или выше) automake требования Официальный сайт: www.gnu.org/software/automake flex 2.5.4 (или выше) flex требования Официальный сайт: www.gnu.org/software/flex &Qt; ≥ 3.0.3 (или выше) Qt требования Официальный сайт: www.trolltech.com/products/qt KDE ≥ 3.0.2 (или выше) KDE требования Официальный сайт: www.kde.org Средство навигации по исходному коду ctags, с http://ctags.sourceforge.net, позволяющее быстрое перейти к объявлению или определению несколькими щелчками мыши на имени переменной в редакторе. ctags dot, генератор изображений, с http:/www.graphviz.org. Он нужен для &doxygen;, чтобы наглядно показать иерархию классов. dot Средство документирования &doxygen;, с http://www.doxygen.org, с помощью которого вы сможете сгенерировать лаконичную и гибкую документацию API вашего проекта. doxygen valgrind с http://developer.kde.org/~sewardj/ поможет найти утечки памяти в вашем приложении. valgrind svn с http://subversion.tigris.org/ если вы хотите использовать систему управления версиями SVN. svn требования Любой другой компилятор и/или инструмент, если вы разрабатываете программное обеспечение на языке или платформе, отличных от C++/&kde;. Вы можете обойти требования &autoconf; ≥ 2.52 и &automake; ≥ 1.6. Просто удалите подкаталог admin в установочном каталоге &tdevelop; и введите autoconf обхождение требования версий automake обхождение требования версий требование версии обхождение требования autoconf/automake (каталог-tdevelop)> ln -s $TDEDIR/share/apps/tdelibs/admin admin в консоли. При этом &tdevelop; будет использовать стандартные параметры в каталоге &kde; admin . Убедитесь, что вы не смешиваете разные версии &Qt;. Всегда собирайте &tdevelop; с той версией &Qt;, с которой были собраны библиотеки &kde;. Иначе вы можете получить очень странное поведение программы. &tdevelop; сборка &tdevelop; установка После удовлетворения всех требований, вы можете приступить к сборки и установке &tdevelop;. В приложении описаны необходимые для этого действия. Раздел Подготовительные шаги содержит инструкции по установке окружения. Раздел Сборка &tdevelop; расскажет как получить исходный код &tdevelop; из svn, подготовить его, скомпилировать и установить. Раздел Примечания по ключам configure покажет как собрать &tdevelop; не в каталог &kde; по умолчанию. подготовка Установка &tdevelop; TDEDIR QTDIR LD_LIBRARY_PATH LIBRARY_PATH PATH Перед началом сборки убедитесь, что все библиотеки и инструменты доступны сборочной системе make. Для этого нужно правильно выставить переменные окружения. Шаги, которые следует выполнить при этом, зависят от используемой оболочки («shell»). Чтобы не вводить все необходимые операторы по определению переменных окружения каждый раз, вы можете записать их в файл .bashrc или .cshrc. Таким образом, переменные будут иметь нужное значение каждый раз при входе в систему. Если вы используете bash, добавьте в его файл конфигурации такие строки: export TDEDIR=(путь к KDE) export QTDIR=(путь к библиотеке Qt) export LD_LIBRARY_PATH=$QTDIR/lib:$TDEDIR/lib:$LD_LIBRARY_PATH export LIBRARY_PATH=$QTDIR/lib:$TDEDIR/lib:$LIBRARY_PATH export PATH=$QTDIR/bin:$TDEDIR/bin:$PATH Если вы используете tcsh, добавьте в его файл конфигурации такие строки: setenv TDEDIR (путь к KDE) setenv QTDIR (путь к библиотеке Qt) setenv LD_LIBRARY_PATH=$QTDIR/lib:$TDEDIR/lib:$LD_LIBRARY_PATH setenv LIBRARY_PATH $QTDIR/lib:$TDEDIR/lib:$LIBRARY_PATH setenv PATH $QTDIR/bin:$TDEDIR/bin:$PATH make Установка &tdevelop; сборка, компиляция &tdevelop; Далее подразумевается, что исходный код &tdevelop; расположен в каталоге ~/kde3src/tdevelop. Если вы собираете &tdevelop; из SVN, начальные шаги сборки зависят от того, загрузили ли вы рабочую копию (checkout) или обновили ранее загруженную копию (update). После svn checkout Вы должны инициализировать сборочную систему после скачивания рабочей копии. Тоже самое необходимо сделать если вы хотите начать сборку с нуля. Наберите: ~/kde3src/tdevelop> make -f admin/Makefile.common svn-clean и выполните все следующие шаги. Для восстановления повреждённых и отсутствующих файлов, возможно, потребуется запустить svn cleanup. Выполните команду svn-clean чтобы удалить все файлы, не имеющие соответствия в репозитории SVN. Убедитесь что вы сделали резервные копии всей ценной информации перед выполнением этой команды. После обновления SVN Следующий шаг зависит от вывода команды обновления svn update. Если в нём было U или P в начале строки — это означает изменение файла: U /some_directory_path/Makefile.am или, после загрузки рабочей копии (checkout), введите: ~/kde3src/tdevelop> make -f Makefile.svn перед выполнением всех следующих шагов. Теперь вы должны решить, какую систему &tdevelop; вы хотите использовать. На следующем шаге генерируются файлы Makefile, который нужны для сборки командой make. Вы можете не указывать параметр --prefix при запуске configure, в этом случае &tdevelop; будет установлен в каталог &kde; по умолчанию. Подробно это изложено в разделе Примечания по ключам configure. Версия с отладочной информацией Если вы хотите следить за тем, что &tdevelop; делает во время выполнения, выберите сборку версии с отладочной информацией. Просто запустите configure следующим образом: ~/kde3src/tdevelop> ./configure --enable-debug=full --prefix=(путь-к-kde3) Финальная версия Если вы хотите просто использовать &tdevelop; как есть (с меньшим размером и более быстрой работой), запускайте configure с параметрами по умолчанию: ~/kde3src/tdevelop> ./configure --prefix=(путь-к-kde3) Если вы хотите собрать также документацию по API для &tdevelop;, вам нужно указать соответствующий параметр в команде запуска configure: ~/kde3src/tdevelop> ./configure --(такие-же-ключи) \ --with-tdelibsdoxy-dir=$TDEDIR/share/doc/HTML/en/tdelibs-apidocs Сборка посредством make и установка Скрипт configure проверит систему и создаст файл Makefile, который будет использовать команда make. Команда make будет использовать основной файл Makefile по умолчанию. ~/kde3src/tdevelop> make Для установки получите права суперпользователя командой: ~/kde3src/tdevelop> su и введите пароль пользователя root. После этого установите &tdevelop;: ~/kde3src/tdevelop> make install Если &tdevelop; установлен в каталог &kde; по умолчанию, вы можете сразу запустить IDE. Иначе потребуются некоторые дополнительные шаги. Подробно об этом рассказано в разделе Нестандартный каталог установки. На самом деле будут установлены три программы: &tdevelop; IDE — среда разработки, в которой вы обычно работаете. &tdevelop; Assistant — программа автономного просмотра документации, предоставляющая всю функциональность соответствующего модуля &tdevelop; IDE. &tdevelop; Designer — расширение &Qt; Designer, добавляющее специфические для виджеты &kde; и интегрирующее его в &tdevelop; IDE. &tdevelop; установка нестандартный каталог нестандартный каталог TDEDIRS kbuildsycoca По умолчанию IDE устанавливается в каталог &kde;. Это необходимо &tdevelop; для прямого доступа к некоторым утилитам и модулям, расположенным в этом каталоге. Чтобы использовать другой каталог для установки, запустите configure с параметром --prefix: ~/kde3src/tdevelop> ./configure --prefix=(путь-к-kde3) И всё же устанавливать программу в другой каталог не рекомендуется. Конечно, вы можете сделать это, но тогда вы получите очень ограниченную функциональность. Перед запуском &tdevelop; выполните следующие команды из командной строки: Обратите внимание на множественную форму: TDEDIRS, а не TDEDIR ~> export TDEDIRS=/usr/local/kde:/opt/kde3 ~> kbuildsycoca Теперь запустим &tdevelop;: ~> tdevelop Переменная окружения TDEDIRS должна содержать список активных каталогов &kde; вашей системы. Обычно это /usr/local/kde:/opt/kde3 однако в вашей системе это могут быть другие каталоги. Каталог /usr/local/kde, например, может содержать неполную версию &kde;, которую вы собрали для отладки, а /opt/kde3 — версию &kde; из вашего дистрибутива. в оболочке tcsh определение переменных окружения происходит таким образом: ~> setenv TDEDIRS /usr/local/kde:/opt/kde3 Команда kbuildsycoca (build system control cache — кэш системных параметров) выполняет поиск библиотек и записывает их размещение и версию в кэш, чтобы &tdevelop; смог их найти. Это займёт некоторое время, и это нужно выполнять каждый раз перед запуском &tdevelop; из оболочки, если вы установили программу в нестандартный каталог. Конечно, из этих команд можно составить сценарий и запускать только его. Кроме того можно дополнить файлы .bashrc или .cshrc, но это не желательно, так как команда будут выполняться при каждом входе в консоль. Команду kbuildsycoca не нужно выполнять с правами суперпользователя. И вообще, заниматься разработкой под root не очень хорошая идея! API &tdevelop; &tdevelop; API сборка, компиляция &tdevelop; API configure API &tdevelop; API — сокращение от Application Program Interface (программный интерфейс приложения). Это набор описаний, по которым приложение обращается к операционной системе и другим службам. API приложения &kde; или &Qt; — описание интерфейсов классов и методов, которые используются для навигации по исходному коду приложения. Последняя версия документации по API находится на сайте KDevelop. Она обновляется каждые 24 часа. Чтобы собрать документацию по API из исходного кода &tdevelop; самостоятельно, нужно указать где искать API KDELIBS, добавив параметр --with-tdelibsdoxy-dir при запуске configure: ~/kde3src/tdevelop> ./configure --(прочие параметры) \ --with-tdelibsdoxy-dir=$TDEDIR/share/doc/HTML/en/tdelibs-apidocs (make заменит глобальную переменную $TDEDIR на каталог, где установлен &kde;). Затем запустите make как обычно. После сборки &tdevelop; можно также собрать документацию по API. Для этого выполните ~/kde3src/tdevelop> make apidocs Это создаст файл Doxyfile в основном каталоге исходного кода &tdevelop;, который передаётся на обработку программе Doxygen, в результате чего будет создано большое количество файлов .html в течение некоторого времени (до часа на медленных машинах). После окончания процесса сборки нужно установить документацию. Получите права суперпользователя ~/kde3src/tdevelop> su и введите пароль пользователя root, затем установите файлы документации по API: ~/kde3src/tdevelop> make install-apidox После этого make выведет имя каталога, где установлена документация по API. Возможно, вы увидите большое количество предупреждений или сообщений об ошибках в процессе сборки документации по API программой Doxygen. Они представляют интерес только для разработчиков &tdevelop;. Если всё пройдёт нормально, файлы .html будут доступными для чтения.