CompileOnUnix/ru

Сборка FreeCAD в современных дистрибутивах Линукс обычно не вызывает сложностей, поскольку все зависимости разрешаются менеджером пакетов, встроенным в дистрибутив. Сборка включает 3 этапа:
 * 1) Загрузка исходного кода FreeCAD.
 * 2) Разрешение зависимостей (пакетов, от которых зависит FreeCAD).
 * 3) Настройка с помощью "cmake" и компиляция с помощью "make".

Ниже вы найдете подробное описание процесса сборки, некоторых скриптов компиляции и особенностей, с которыми Вы можете столкнуться. Если вы найдете ошибки, устаревшие сведения, отсутствие перевода, или если вы используете дистрибутив, которого нет в списке, то мы будем благодарны, если поможете это исправить.

Загрузка исходников
Перед началом сборки вам понадобится исходный код. Существует 3 способа получить его.

Git
Самый простой и быстрый способ загрузить исходники заключается в клонировании репозитория, который расположен на GitHub (перед этим нужно установить git):

Эта команда копирует последнюю версию исходного кода FreeCAD в папку "free-cad-code".

GitHub
Официальный репозиторий FreeCAD на GitHub: github.com/FreeCAD/FreeCAD

Архив исходников
Вы можете скачать архив с исходным кодом, но он может содержать старую версию, поэтому рекомендуется скачивать последнюю версию с помощью Git или GitHub.


 * Официальный архив исходников FreeCAD (платформонезависимый): FreeCAD-0.17_pre.zip.

Разрешение зависимостей
Перед компиляцией FreeCAD под Линукс вы должны установить все библиотеки перечисленные в статье Сторонние библиотеки. Обратите внимание, что названия библиотек и их доступность зависят от вашего дистрибутива. Учтите, что в старых дистрибутивах некоторые пакеты, перечисленные ниже, могут отсутствовать в репозитории. В этом случае обратитесь к разделу Старые и нетрадиционные дистрибутивы.

Перейти к компиляции FreeCAD

Debian и Ubuntu
В дистрибутивах основанных на Debian (Debian, Ubuntu, Mint и других) достаточно просто разрешить все зависимости. Большинство библиотек можно установить с помощью apt-get или менеджера пакетов Synaptic.

either:
 * build-essential
 * cmake
 * python
 * python-matplotlib
 * libtool
 * libcoin60-dev (Debian Wheezy, Wheezy-backports, Ubuntu 13.04 and before)

or:
 * libcoin80-dev (Debian unstable(Jesse), testing, Ubuntu 13.10 and forward)

either:
 * libsoqt4-dev
 * libxerces-c-dev
 * libboost-dev
 * libboost-filesystem-dev
 * libboost-regex-dev
 * libboost-program-options-dev
 * libboost-signals-dev
 * libboost-thread-dev
 * libboost-python-dev
 * libqt4-dev
 * libqt4-opengl-dev
 * qt4-dev-tools
 * python-dev
 * python-pyside
 * pyside-tools
 * libopencascade-dev (official opencascade version)

or:
 * liboce*-dev (opencascade community edition)
 * oce-draw


 * libeigen3-dev
 * libqtwebkit-dev
 * libshiboken-dev
 * libpyside-dev
 * libode-dev
 * swig
 * libzipios++-dev
 * libfreetype6
 * libfreetype6-dev

Допольнительные инструкции для libcoin80-dev в Debian wheezy-backports, unstable, testing, Ubuntu 13.10 и так далее

Обратите внимание, что t liboce*-dev включает следующие библиотеки: Вам может понадобиться установить эти пакеты по одному.
 * liboce-foundation-dev
 * liboce-modeling-dev
 * liboce-ocaf-dev
 * liboce-visualization-dev
 * liboce-ocaf-lite-dev

Дополнительно Вы можете установить следующие дополнительные пакеты:
 * libsimage-dev (to make Coin to support additional image file formats)
 * checkinstall (to register your installed files into your system's package manager, so yo can easily uninstall later)
 * python-pivy (needed for the 2D Drafting module)
 * python-qt4 (needed for the 2D Drafting module)
 * doxygen and libcoin60-doc (if you intend to generate source code documentation)
 * libspnav-dev (for 3Dconnexion devices support like the Space Navigator or Space Pilot)

Пользователи Ubuntu 16.04, пожалуйста, смотрите так же эти дополнительные инструкции (en).

Fedora
Вам нужны следующие пакеты:


 * gcc-c++ (or possibly another C++ compiler?)
 * cmake
 * doxygen
 * swig
 * gettext
 * dos2unix
 * desktop-file-utils
 * libXmu-devel
 * freeimage-devel
 * mesa-libGLU-devel
 * OCE-devel
 * python
 * python-devel
 * python-pyside-devel
 * pyside-tools
 * boost-devel
 * tbb-devel
 * eigen3-devel
 * qt-devel
 * qt-webkit-devel
 * ode-devel
 * xerces-c
 * xerces-c-devel
 * opencv-devel
 * smesh-devel
 * coin3-devel

(Если в вашей версии Fedora последнее, что доступно, это coin2, используйте пакеты из http://www.zultron.com/rpm-repo/)
 * soqt-devel
 * freetype
 * freetype-devel

Добавьте, если нужно:


 * libspnav-devel (для поддержки устройств 3Dconnexion, вроде Space Navigator или Space Pilot)
 * pivy ( https://bugzilla.redhat.com/show_bug.cgi?id=458975 Pivy не обязателен, но нужен для модуля Draft)

Gentoo
Простейший путь узнать, какие пакеты нужны для компиляции FreeCAD - проверить через portage:

emerge -pv freecad

Вы получите список дополнительных пакетов, которые следует установить на Вашей системе.

OpenSUSE
Вам потребуются следующие пакеты: Для стабильного FreeCAD 0.14 и нестабильного 0.15, если библиотеки Eigen3 и swig не найдены в стандартных репозиториях, Вы можете получить их установкой в один клик здесь: Заметьте так же, что библиотека Eigen3 из Factory Education иногда вызывает проблемы, так что используйте её из репозитория KDE 4.8 Extra
 * gcc
 * cmake
 * OpenCASCADE-devel
 * libXerces-c-devel
 * python-devel
 * libqt4-devel
 * libshiboken-devel
 * python-pyside-devel
 * python-pyside-tools
 * Coin-devel
 * SoQt-devel
 * boost-devel
 * libode-devel
 * libQtWebKit-devel
 * libeigen3-devel
 * gcc-fortran
 * freetype2
 * freetype2-devel
 * Eigen3
 * swig
 * Eigen3
 * swig

Начиная с 0.17pre, Opensuse 13.2 слишком стара для компиляции из-за слишком старой версии boost.

Arch Linux
Вам нужны следующие библиотеки из официальных репозиториев:


 * boost-libs
 * curl
 * hicolor-icon-theme
 * libspnav
 * opencascade
 * python2-pivy
 * python2-matplotlib
 * python2-pyside
 * python2-shiboken
 * qtwebkit
 * shared-mime-info
 * xerces-c
 * boost
 * cmake
 * coin
 * desktop-file-utils
 * eigen
 * gcc-fortran
 * swig

Так же обязательно проверьте AUR насчёт пропущенных пакетов, которые сейчас вне репозиториев:
 * python2-pyside-tools
 * med (Modelisation et Echanges de Donnees)

Старые и нетрадиционные дистрибутивы
В других дистрибутивах у нас слишком мало откликов от пользователей, так что может оказаться трудно найти требуемые пакеты. Сначала попробуйте найти требуемые пакеты, упомянутые в Сторонних библиотеках. Учтите, что некоторые из них могут иметь в вашем дистрибутиве немного другие имена пакетов (Вроде name, libname, name-dev, name-devel, и так далее...).

Вам так же нужен компилятор GNU GCC версии 3.0.0 или выше. Так же нужен g++, поскольку FreeCAD полностью написан на C++. Во время компиляции исполняются некоторые скрипты Python, поэтому ваш интерпретатор Python должен работать правильно. Во избежание проблем компоновки во время процесса сборки системы, хорошо бы иметь путь к библиотекам или в переменной LD_LIBRARY_PATH, или в конфигурационном файле ld.so.conf. Это обычно уже так в последних дистрибутивах.

Для дополнительных деталей смотрите так же в исходных кодах README.Linux.

Pivy
Pivy не обязателен ни для компиляции, ни для работы FreeCAD, а нужен для работы модуля двумерного эскизирования Draft. Если Вы не собираетесь использовать этот модуль, Вам не нужен pivy. С ноября 2015 устаревшая версия Pivy включённая в исходные коду FreeCAD более не компилируется на многих системах из-за устаревания. Если Вы не можете найти Pivy в своём дистрибутиве, Вы можете скомпилировать pivy самостоятельно:

Инструкции по компиляции Pivy

Использование cMake
cMake это новейшая система построения программ, её широкое применение на различных операционных системах (Linux, Windows, MacOSX, etc) является преимуществом. FreeCAD теперь использует систему cMake как главную. Компиляция с помощью cMake обычно очень просто и происходит в два шага. На первом шаге cMake проверяет, что все необходимые программы и библиотеки имеются на Вашей системе и настраивает всё необходимое для последующей компиляции. У Вас будет несколько альтернатив, описанных ниже, но в принципе FreeCAD поставляется с разумными настройками по умолчанию. Следующий шаг это сама компиляция, которая создаёт исполняемые файлы FreeCAD. Изменение любых опций cmake относительно умолчательных значений проще всего с cmake-gui или другим графическим приложением cmake, нежели с командной строкой cmake, поскольку графическое приложение даёт интерактивность.

FreeCAD сложное приложение, поэтому компиляция может занять много времени (около 10 минут на быстром компьютере, 30 минут и более на медленном).

Сборка внутри древа исходников
Если Вы не уверены, не делайте сборку внутри древа исходников ввиду его ограничений, лучше сделайте сборку вне исходников, как показано в следующем разделе. Тем не менее, FreeCAD может собираться и внутри исходников, что значит, что все файлы, полученные в результате компиляции, останутся внутри каталога исходников. Это удобно если Вы хотите только посмотреть на FreeCAD, и хотите с лёгкостью удалить его прямо с этим каталогом. НО если Вы планируете компилировать его часто, советуем сделать сборку за пределами исходников, что даёт большие преимущества. Компиляцию FreeCAD выполнят следующие команды:

Если Вы хотите использовать системную копию Pivy, как это происходит в большинстве случаев, даже не в Linux, установите флаг компилятора для использования правильного pivy (через FREECAD_USE_EXTERNAL_PIVY=1). Использование внешнего Pivy стало для Linux умолчательным, во время разработки FreeCAD 0.16, так что это не требуется устанавливать при компиляции этой версии под Linux. Так же, установите тип построения на Debug, если Вы хотите отладочную версию, или Release, если нет. Версия Release работает намного быстрее чем Debug. Если FreeCAD в версии Debug, верстак Sketcher со сложными эскизами становится очень медленным. (Примечание: пробел и "." после флагов cmake КРИТИЧНЫ!):

Или для версии Release
Ваш исполняемый файл FreeCAD тогда размещается в папке "bin", и Вы можете вызвать его с помощью:

Как восстановить каталог исходных кодов после случайного запуска компиляции внутри исходников.
Для восстановления исходных кодов после случайного запуска компиляции внутри исходников существует метод с использованием Git.

Компиляций вне исходников
Если Вы намерены следовать за быстрой эволюцией FreeCAD, сборка в отдельном каталоге подходит лучше. Каждый раз, когда Вы обновляете исходные коды, cMake интеллектуально отметит изменённые файлы и перекомпилирует только то, что нужно. Построение вне исходников особо полезно при использовании системы Git, поскольку Вы можете запросто попробовать другие ветви исходных кодов, не приводя в смущение систему сборки. Для сборки вне исходников создайте сборочный каталог, и внутри него укажите cMake каталог исходников (при использовании графического интерфейса замените в нижеследующем коде "cmake" на "cmake-gui"):

Исходный код FreeCAD появится в каталоге "bin" внутри каталога сборки.

Configuration options
There are a number of experimental or unfinished modules you may have to build if you want to work on them. To do so, you need to set the proper options for the configuration phase. Do it either on the command line, passing -D : = options to cMake or using one of the availables gui-frontends (eg for Debian, packages cmake-qt-gui or cmake-curses-gui). Changing any options for cmake away from their default values, is much easier with cmake-gui or other graphical cmake applications than with cmake on the command line, as they will give you interactive feed back.

As an example, to configure FreeCAD with the Assembly module built just tick the box in a cmake gui application (e.g. cmake-gui) or on the command line issue:

Возможные опции перечислены в файле CmakeLists.txt из корневого каталога FreeCAD.

Плагин к Qt designer
Если Вы хотите создать приложения Qt для FreeCAD, Вам нужен плагин к Qt Designer, который даёт все пользовательские виджеты FreeCAD. Перейдите к

Поэтому мы не даём makefile -- но вызов

создаёт его. Когда это сделано, вызов

создаст libFreeCAD_widgets.so. Чтобы познакомить эту библиотеку с Qt Designer, Вам надо скопировать файл в $QTDIR/plugin/designer

Doxygen
Если Вы чувствуете себя достаточно уверено для погружения в код, можете использовать достоинства создания и изучения создаваемой с помощью Doxygen документации исходниковFreeCADа.

Создание пакета debian
Если Вы планируете создать пакет Debian вне исходников, Вам следует сначала установить следующие пакеты:

Для сборки пакета откройте консоль, перейдите в каталог FreeCAD и вызовите

Когда пакет построен, Вы можете использовать lintian для проверки, содержит ли пакет ошибки

Примечание для 64-битных систем
При компиляции FreeCAD на 64-бит известна проблема с 64-битным пакетом OpenCASCADE. Чтобы FreeCAD правильно заработал, Вам нужно запустить скрипт ./configure с дополнительно установленным define _OCC64:

For Debian based systems this workaround is not needed when using the prebuilt package because there the OpenCASCADE package is built to set internally this define. Now you just need to compile FreeCAD the same way as described above.

Скрипты автоматической компиляции
Это всё, что Вам нужно для полной компиляции FreeCAD. Это односкриптовое решение, работающее на свежеустановленном дистрибутиве. Команда запросит пароль root (для установки пакетов) и порой для подтверждения входа на внешний сервер репозитория. Эти скрипты должны запускаться на 32- 64-битных версиях. Они написаны для разных версий, но, скорее всего, будут работать для позднейший версий с небольшими изменениями или без них.

If you have such a script for your preferred distro, please send it! We will incorporate it into this article.

Ubuntu
These scripts provide a reliable way to install the correct set of dependencies required to build and run FreeCAD on Ubuntu. They make use of the FreeCAD Ubuntu PPA repositories, and should work on any version of Ubuntu targeted by the PPA. The 'daily' PPA targets recent versions of Ubuntu, and the 'stable' PPA targets all officially supported versions of Ubuntu.

This script installs dependencies for the daily development snapshot of FreeCAD.

This script installs dependencies for the latest stable release of FreeCAD. (For Ubuntu 12.04, omit "--enable-source" from the add-apt-repository command.)

(These scripts also install the PPA build of FreeCAD itself, as a side effect. You could then uninstall that while leaving the dependencies in place. However, leaving it installed will enable the package manager to keep the set of dependencies up to date, which is useful if you are following the development for a long time.)

After installing the dependencies, please see the generic instructions for getting the source code, running CMake, and compiling. The following script is an example of one way to do this.

OpenSUSE 12.2
No external Repositories are needed to compile FreeCAD 0.13 with this release. However, there is an imcompatability with python3-devel which needs to be removed. FreeCAD can be compiled from GIT similar to in OpenSUSE 12.2

Since you are using git, next time you wish to compile you do not have to clone everything, just pull from git and compile once more

Fedora 22/23/24
Posted by user [PrzemoF] in the forum.

{ echo "~/$MAIN_DIR already exist. Quitting.."; exit; }

cd $MAIN_DIR

git clone https://github.com/FreeCAD/FreeCAD.git

mkdir $BUILD_DIR

Updating the source code
FreeCAD development happens fast, everyday or so there are bug fixes or new features. The cmake systems allows you to intelligently update the source code, and only recompile what has changed, making subsequent compilations very fast. Updating the source code with git or subversion is very easy:

Move into the appropriate build directory and run cmake again (as cmake updates the version number data for the Help menu, ...about FreeCAD), however you do not need to add the path to source code after "cmake", just a space and a dot:

Ссылки
Смотрите так же Ускорение компиляции.