CompileOnUnix/ru

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

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

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

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

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

Архив исходников
Вы можете скачать архив с исходным кодом.


 * Source .tar.gz
 * Source .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

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

Если FreeCAD недоступен в portage, он доступен в оверлее waebbl. Система отслеживания ошибок на оверлее waebbl Github может помочь решить некоторые проблемы, с которыми вы можете столкнуться. Оверлей предоставляет  freecad-9999 , который вы можете выбрать для компиляции или просто использовать для получения зависимостей.

layman -a waebbl

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-matplotlib
 * shared-mime-info
 * xerces-c
 * boost
 * cmake
 * desktop-file-utils
 * eigen
 * gcc-fortran
 * swig

Так же обязательно проверьте AUR насчёт пропущенных пакетов, которые сейчас вне репозиториев:
 * coin
 * python2-pivy
 * python2-pyside
 * python2-pyside-tools
 * python2-shiboken
 * qtwebkit
 * 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

Компиляция FreeCAD
FreeCAD использует CMake в качестве основной системы сборки. CMake - это система сборки, доступная во всех основных операционных системах. Компиляция с помощью CMake обычно очень проста и происходит в два этапа.


 * 1) CMake проверяет наличие всех необходимых программ и библиотек в вашей системе и настраивает систему сборки для второго шага. Хотя FreeCAD имеет несколько вариантов конфигурации на выбор, значения по умолчанию достаточны. Некоторые альтернативные конфигурации подробно описаны ниже.
 * 2) Сама компиляция, которая создает исполняемый файл FreeCAD.

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

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

Исполняемый файл FreeCAD будет находиться в каталоге  freecad-build / bin .

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

In-source builds are fine if you are just looking at FreeCAD, and want to be able to remove it easily by just deleting that folder. However, if you are unsure where to build, do not make an in-source build. Create an out-of-source build as explained earlier. However FreeCAD can be built in-source, which means that all the files resulting from the compilation stay in the same folder as the source code.

The following commands will compile FreeCAD:

The FreeCAD executable will then reside in the freecad-source/bin directory.

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

The first line clears the .gitignore file. This ensures that the following clean and reset commands will affect everything in the directory and will not ignore items matching the expressions in .gitignore. The second line deletes all files and directories that are not tracked by the git repository, and then the reset will reset any changes to tracked files (including the first command which cleared the .gitignore file.

Configuration
By passing different options to CMake, you can change how FreeCAD is compiled. This can be useful for several purposes. For example, by calling CMake like this, you can instruct it to not build the FEM module:

All possible options are listed in FreeCAD's root CMakeLists.txt</tt> file. Try searching for the string OPTION</tt>. Alternatively, use the command cmake -LH</tt>. Below, we've listed some of the more relevant options you may want to configure.

To pass a value for an option you find in the CMakeLists.txt</tt> file, use the following flag: -D : =

External, or internal Pivy
If you want to use your system's copy of Pivy, which you most commonly will, then if not on Linux, set the compiler flag to use the correct pivy with -DFREECAD_USE_EXTERNAL_PIVY=1</tt>. Using external Pivy became the default for Linux, during development of FreeCAD 0.16, so it does not need to be manually set when compiling this version onwards, on Linux.

Building for Qt5
By default, FreeCAD builds for Qt4. It is possible to build for Qt5 by enabling the -DBUILD-QT5</tt> option.

Building for a specific Python version
By default, FreeCAD may only detect Python 2. It is possible to choose how to build for a specific version of Python (e.g. Python 2 or Python 3) by setting some cmake</tt> options. An example for Python 3 is shown below:

The locations and version numbers of your Python files and directories will be different depending on which distribution you are using. You can find them using the Unix locate</tt> or which</tt> commands.

Qt designer plugin
If you want to develop Qt stuff for FreeCAD, you'll need the Qt Designer plugin that provides all custom widgets of FreeCAD. Go to:

So far we don't provide a makefile -- but calling

creates it. Once that's done, calling

will create the library libFreeCAD_widgets.so</tt>. To make this library known to Qt Designer you have to copy the file to $QTDIR/plugin/designer</tt>

Doxygen
If you feel bold enough to dive in the code, you could take advantage to build and consult Doxygen generated FreeCAD's Source documentation

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

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

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

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

Для систем, основанных на Debian, этот обходной путь при использовании прекомпилированных пакетов не требуется, поскольку пакет OpenCASCADE собран так, чтобы всё это было уже установлено. Теперь Вам только нужно скомпилировать FreeCAD так, как описано выше.

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

Если у Вас есть такой скрипт для Вашего любимого дистрибутива, пришлите его, пожалуйста! Мы вставим его в эту статью.

Ubuntu
Эти скрипты обеспечивают надёжный путь для установки верного набора зависимостей, требуемых для сборки и запуска FreeCAD в Ubuntu. Они используют репозитории PPA Ubuntu FreeCAD, и должны работать на любой версии Ubuntu, для которой есть целевой PPA. 'Ежедневный' PPA нацелен на последнюю версию Ubuntu, а 'стабильный' PPA нацелен на все официально поддерживаемые версии Ubuntu.

Этот скрипт устанавливает зависимости для ежедневных слепков текущей разработки FreeCAD.

Этот скрипт устанавливает зависимости для последнего стабильного выпуска FreeCAD. (Для Ubuntu 12.04, уберите "--enable-source" из команды add-apt-repository.)

(Эти скрипты, кроме того, устанавливают сборки PPA самого FreeCAD. Вы можете деинсталлировать это, оставив зависимости. Однако оставив их установленными, менеджер пакетов будет поддерживать актуальность версий этих зависимостей, что полезно, если Вы будете следовать разработке в течение долгого времени.)

После установки зависимостей посмотрите общие инструкции для получения исходного кода, запуска CMake и компиляции. Следующий скрипт служит примером одного из способов сделать это.

OpenSUSE 12.2
Внешние репозитории для компиляции FreeCAD 0.13 с этим релизом не требуются. Однако есть несовместимость с python3-devel, который надо удалить. FreeCAD может быть скомпилирован из GIT так же как в 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 27/28/29
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

Обновление исходного кода
Разработка FreeCAD ведётся быстро, примерно ежедневно появляются исправления ошибок или расширение возможностей. Система cmake позволяет Вам по-умному обновить исходный код и перекомпилировать только изменения, делая последовательные компиляции очень быстрыми. Обновление исходного кода через git или subversion очень просто:

Перейдите в соответствующий каталог сборки и запустите cmake снова (поскольку cmake обновит данные номера версии из меню Help, ...about FreeCAD), но вам не нужно добавить путь к исходному коду после "cmake", только пробел и точку:

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