BerndPolAnne-MarieMahfoufУстановка &tdevelop;установкаВ этой главе описаны все этапы сборки и установки &tdevelop;: Раздел Как получить &tdevelop; содержит информацию по загрузке последней версии &tdevelop; в виде исходного кода из репозитория SVN. Раздел Требования &tdevelop; содержит список программ и библиотек, необходимых для сборки &tdevelop;. Раздел Сборка и установка &tdevelop; проведёт вас через все этапы сборки и установки &tdevelop;. Раздел Как получить документацию по &API; рассказывает что такое API и как вам получить удобный инструмент для навигации по исходникам &tdevelop;. Как получить &tdevelop;получение &tdevelop;&tdevelop;получение&tdevelop; доступен в собранном виде во многих дистрибутивах &Linux;, таких, как SuSE, RedHat и других, чаще всего в виде пакета RPM, для упрощения процесса установки. Для установки из собранного пакета обратитесь к документации по вашему дистрибутиву. Также вы можете загрузить исходный код, собрать и установить &tdevelop; самостоятельно. Исходный код среды разработки доступен на http://www.kdevelop.org и ftp-сервер &kde;. Получение ежедневных снимков &tdevelop; из SVNsvnЕсли вы хотите быть в курсе последних разработок, то доступен анонимный снимок репозитория SVN.Имя модуля tdevelop в репозитории svn co svn://anonsvn.kde.org/home/kde/branches/KDE/3.5/tdevelop. Скачивание рабочей копииcheckout&tdevelop;svncheckoutДля получения версии &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;svnupdateПосле загрузки (и сборки) &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.comautoconf ≥ 2.52 (или выше) autoconfтребованияОфициальный сайт: www.gnu.org/software/autoconfautomake ≥ 1.6 (или выше) automakeтребованияОфициальный сайт: www.gnu.org/software/automakeflex 2.5.4 (или выше) flexтребованияОфициальный сайт: www.gnu.org/software/flex&Qt; ≥ 3.0.3 (или выше) QtтребованияОфициальный сайт: www.trolltech.com/products/qtKDE ≥ 3.0.2 (или выше) KDEтребованияОфициальный сайт: www.kde.orgНеобязательно:Средство навигации по исходному коду ctags, с http://ctags.sourceforge.net, позволяющее быстрое перейти к объявлению или определению несколькими щелчками мыши на имени переменной в редакторе. ctagsdot, генератор изображений, с http:/www.graphviz.org. Он нужен для &doxygen;, чтобы наглядно показать иерархию классов. dotСредство документирования &doxygen;, с http://www.doxygen.org, с помощью которого вы сможете сгенерировать лаконичную и гибкую документацию API вашего проекта. doxygenvalgrind с http://developer.kde.org/~sewardj/ поможет найти утечки памяти в вашем приложении. valgrindsvn с 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; расскажет как получить исходный код &tdevelop; из svn, подготовить его, скомпилировать и установить. Раздел Примечания по ключам configure покажет как собрать &tdevelop; не в каталог &kde; по умолчанию. Подготовительные шагиподготовкаУстановка &tdevelop;TDEDIRQTDIRLD_LIBRARY_PATHLIBRARY_PATHPATHПеред началом сборки убедитесь, что все библиотеки и инструменты доступны сборочной системе make. Для этого нужно правильно выставить переменные окружения. Шаги, которые следует выполнить при этом, зависят от используемой оболочки («shell»). Чтобы не вводить все необходимые операторы по определению переменных окружения каждый раз, вы можете записать их в файл .bashrc или .cshrc. Таким образом, переменные будут иметь нужное значение каждый раз при входе в систему. Настройка окружения в оболочке bashЕсли вы используете bash, добавьте в его файл конфигурации такие строки: export TDEDIR=(путь к KDE)export QTDIR=(путь к библиотеке Qt)export LD_LIBRARY_PATH=$QTDIR/lib:$TDEDIR/lib:$LD_LIBRARY_PATHexport LIBRARY_PATH=$QTDIR/lib:$TDEDIR/lib:$LIBRARY_PATHexport PATH=$QTDIR/bin:$TDEDIR/bin:$PATHНастройка окружения для оболочки tcshЕсли вы используете tcsh, добавьте в его файл конфигурации такие строки: setenv TDEDIR (путь к KDE)setenv QTDIR (путь к библиотеке Qt)setenv LD_LIBRARY_PATH=$QTDIR/lib:$TDEDIR/lib:$LD_LIBRARY_PATHsetenv LIBRARY_PATH $QTDIR/lib:$TDEDIR/lib:$LIBRARY_PATHsetenv PATH $QTDIR/bin:$TDEDIR/bin:$PATHСборка &tdevelop;makeУстановка &tdevelop;сборка, компиляция&tdevelop;Далее подразумевается, что исходный код &tdevelop; расположен в каталоге ~/kde3src/tdevelop. Особенности сборки из SVNЕсли вы собираете &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перед выполнением всех следующих шагов. Команды сборки makeТеперь вы должны решить, какую систему &tdevelop; вы хотите использовать. На следующем шаге генерируются файлы Makefile, который нужны для сборки командой make. Вы можете не указывать параметр при запуске 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.Примечания по ключам configureНестандартный каталог установки&tdevelop;установканестандартный каталогнестандартный каталогTDEDIRStdebuildsycocaПо умолчанию IDE устанавливается в каталог &kde;. Это необходимо &tdevelop; для прямого доступа к некоторым утилитам и модулям, расположенным в этом каталоге. Чтобы использовать другой каталог для установки, запустите configure с параметром : ~/kde3src/tdevelop> ./configure --prefix=(путь-к-kde3) И всё же устанавливать программу в другой каталог не рекомендуется. Конечно, вы можете сделать это, но тогда вы получите очень ограниченную функциональность. Перед запуском &tdevelop; выполните следующие команды из командной строки: Обратите внимание на множественную форму:TDEDIRS, а не TDEDIR~> export TDEDIRS=/usr/local/kde:/opt/kde3~> tdebuildsycocaТеперь запустим &tdevelop;: ~> tdevelopПеременная окружения TDEDIRS должна содержать список активных каталогов &kde; вашей системы. Обычно это/usr/local/kde:/opt/kde3однако в вашей системе это могут быть другие каталоги.Каталог /usr/local/kde, например, может содержать неполную версию &kde;, которую вы собрали для отладки, а /opt/kde3 — версию &kde; из вашего дистрибутива.в оболочке tcsh определение переменных окружения происходит таким образом: ~> setenv TDEDIRS /usr/local/kde:/opt/kde3Команда tdebuildsycoca (build system control cache — кэш системных параметров) выполняет поиск библиотек и записывает их размещение и версию в кэш, чтобы &tdevelop; смог их найти. Это займёт некоторое время, и это нужно выполнять каждый раз перед запуском &tdevelop; из оболочки, если вы установили программу в нестандартный каталог. Конечно, из этих команд можно составить сценарий и запускать только его. Кроме того можно дополнить файлы .bashrc или .cshrc, но это не желательно, так как команда будут выполняться при каждом входе в консоль. Команду tdebuildsycoca не нужно выполнять с правами суперпользователя. И вообще, заниматься разработкой под root не очень хорошая идея! Как получить документацию по &API;API&tdevelop;&tdevelop;APIсборка, компиляция&tdevelop;APIconfigureAPI &tdevelop;API — сокращение от Application Program Interface (программный интерфейс приложения). Это набор описаний, по которым приложение обращается к операционной системе и другим службам. API приложения &kde; или &Qt; — описание интерфейсов классов и методов, которые используются для навигации по исходному коду приложения. Последняя версия документации по API находится на сайте KDevelop. Она обновляется каждые 24 часа. Чтобы собрать документацию по API из исходного кода &tdevelop; самостоятельно, нужно указать где искать API KDELIBS, добавив параметр при запуске 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 будут доступными для чтения.