CompileOnUnix/ru

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

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



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

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

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

For more information on using Git, and contributing code to the project, see Source code management.

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

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

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

Please note that FreeCAD's source code is around 500 MB in size; it may be three times as big if you clone the Git repository with its entire modification history. Getting all dependencies may require downloading 500 MB or more of new files; when these files are unpacked they may require 1500 MB or more in space. Also beware that the compilation process may generate up to 1500 MB of additional files as the system copies and modifies the entire source code. Therefore, be sure you have enough free space in your hard drive, at least 4 GB, when attempting compilation.

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

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

However, if the version of FreeCAD in the repositories is old, the dependencies may be the wrong ones to compile a recent version of FreeCAD. Therefore, please verify that you have installed the following packages.

These packages are essential for any sort of compilation to succeed:
 * , installs the C and C++ compilers, the C development libraries, and the program.
 * , essential tool to configure the source of FreeCAD. You may also wish to install and  for a graphical option.
 * , essential tools to produce shared libraries.
 * , the standard base reporting utility is normally already installed in a Debian system, and allows you to programmatically distinguish between a pure Debian installation or a variant, such as Ubuntu or Linux Mint. Do not remove this package, as many other system packages may depend on it.

Compilation of FreeCAD uses the Python language, and it's also used at runtime as a scripting language. If you are using a Debian based distribution the Python interpreter is normally already installed.
 * , the tool that creates interfaces between C++ code and Python.
 * , the tool that creates interfaces between C++ code and Python.

Please check that you have Python 3 installed. Python 2 was obsoleted in 2019, so new development in FreeCAD is not tested with this version of the language.

The Boost libraries need to be installed:

или:

Several libraries that deal with mathematics, triangulated surfaces, sorting, meshes, computer vision, cartographic projections, 3D visualization, the X11 Window system, XML parsing, and Zip file reading:
 * or
 * or
 * or
 * or
 * or
 * or
 * or
 * or

Python 2 and Qt4
This is not recommended for newer installations as both Python 2 and Qt4 are obsolete. To compile FreeCAD for Debian Jessie, Stretch, Ubuntu 16.04, using Python 2 and Qt4, install the following dependencies.

Python 3 and Qt5
или с Qt5 и Python 3 (Debian Buster, Ubuntu 19.04 и выше, а также Ubuntu 18.04/18.10 с добавленными freecad-stable/freecad-daily PPA источниками вашего программного обеспечения:
 * or
 * or
 * or
 * or
 * or

или:
 * * libocct * -dev (официальная версия opencascade, последняя версия, доступная в Debian Buster и Ubuntu 18.10 и более поздних версиях, а также в Ubuntu 18.04 с freecad-stable/freecad-daily PPA добавлены в ваши программные источники)
 * *occt-draw

или же:
 * * liboce * -dev (версия сообщества opencascade, устаревшая, доступна в Debian jessie, stretch, Ubuntu 16.04 и более поздних версиях)
 * *oce-draw

The OpenCascade kernel is the core graphics library to create 3D shapes. It exists in an official version OCCT, and a community version OCE. The community version is no longer recommended, as it's outdated.

For Debian Buster and Ubuntu 18.10 and newer, as well as Ubuntu 18.04 with the freecad-stable/freecad-daily PPAs added to your software sources, install the official packages.

For Debian Jessie, Stretch, Ubuntu 16.04 and newer, install the community edition packages.

Обратите внимание, что liboce*-dev/libocct*-dev включает следующие библиотеки (замените oce на oct):

Дополнительно Вы можете установить следующие дополнительные пакеты:

Отдельная команда для Qt5 и Python 3 (требуется Pyside2, доступный в Debian Buster и PPC freecad-stable / freecad-daily)

Отдельная команда для Qt4 и Python 2

Пользователи 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

Tumbleweed
The following commands will install the packages required for building FreeCAD with Qt5 and Python 3.

The following command will install Qt Creator and the GNU Project Debugger.

If any packages are missing, then you can check the Tumbleweed "FreeCAD.spec" file on the Open Build Service.

Also, check to see if there are any patches you need to apply (such as 0001-find-openmpi2-include-files.patch).

Leap
If there is a difference between the available packages on Tumbleweed and Leap, then you can read the Leap "FreeCAD.spec" file on the Open Build Service to determine the required packages.

Arch Linux
You will need the following libraries from the official repositories:


 * boost-libs
 * curl
 * desktop-file-utils
 * glew
 * hicolor-icon-theme
 * jsoncpp
 * libspnav
 * med
 * opencascade
 * shiboken2
 * xerces-c
 * pyside2
 * python-matplotlib
 * python-netcdf4
 * qt5-svg
 * qt5-webkit
 * qt5-webengine
 * boost
 * cmake
 * eigen
 * git
 * gcc-fortran
 * pyside2-tools
 * swig
 * qt5-tools
 * shared-mime-info

Так же обязательно проверьте AUR насчёт пропущенных пакетов, которые сейчас вне репозиториев:
 * coin
 * python-pivy
 * med

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

Try first locating the required libraries mentioned in third party libraries in your package manager. Beware that some of them might have a slightly different package name; search for, but also , , , and similar. If that is not possible try compiling those libraries yourself.

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

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

Pivy (Python wrappers to Coin3d) is not needed to build FreeCAD or to start it, but it is needed as a runtime dependency by the Draft Workbench. If you are not going to use this workbench, you won't need Pivy. However, do notice that the Draft Workbench is used internally by other workbenches, like Arch and BIM, so Pivy needs to be installed to use these workbenches as well.

By November 2015 the obsolete version of Pivy included with the FreeCAD source code will no longer compile on many systems. This isn't a big problem as normally you should get Pivy from your distribution's package manager; if you cannot find Pivy, you may have to compile it yourself, see Pivy compilation instructions.

Debug symbols
In order to troubleshoot crashes in FreeCAD, it is useful to have the debug symbols of important dependency libraries such as Qt. For this, try installing the dependency packages that end with, , or similar, depending on your Linux distribution.

For Ubuntu, you may have to enable especial repositories to be able to see and install these debug packages with the package manager. See Debug Symbol Packages for more information.

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


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

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

You can build the code either in or out of the source directory. Out-of-source building is generally the best option.

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

To build out-of-source, simply create a build directory,, distinct from your FreeCAD source folder, ; then from this build directory point to the right source folder. You can use or  instead of  in the instructions below as well. Once finishes configuring the environment, use  to start the actual compilation.

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

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

Для компиляции FreeCAD используйте следующие команды:

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

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

If you accidentally performed a compilation inside the source code directory, or added strange files, and would like to restore the contents to only the original source code, you can perform the following steps.

Первая строка очищает файл  .gitignore . Это гарантирует, что следующие команды clean и reset будут влиять на все в каталоге и не будут игнорировать элементы, соответствующие выражениям в  .gitignore . Во второй строке удаляются все файлы и каталоги, которые не отслеживаются репозиторием git, а затем reset сбрасывает все изменения в отслеживаемых файлах (включая первую команду, которая очистила файл  .gitignore </ tt>.

If you do not clear the source directory, subsequent runs of may not capture new options to the system if the code changes.

Конфигурация
Передавая различные параметры в CMake, вы можете изменить способ компиляции FreeCAD. Это может быть полезно для нескольких целей. Например, запустив CMake следующим образом, вы можете отменить сборку модуля FEM:

Where is the directory that contains the source code. The may be omitted in most cases. The space after the option may also be omitted.

For example, to avoid building the FEM Workbench:

Все возможные параметры перечислены в главном файле  CMakeLists.txt </tt> FreeCAD. Попробуйте найти строку  OPTION </tt>. Или используйте команду  cmake -LH </tt>. Ниже приведен список наиболее важных параметров, которые вы можете настроить.

option(BUILD_FORCE_DIRECTORY "The build directory must be different to the source directory." OFF) option(BUILD_GUI "Build FreeCAD Gui. Otherwise you have only the command line and the Python import module." ON) option(FREECAD_USE_EXTERNAL_ZIPIOS "Use system installed zipios++ instead of the bundled." OFF) option(FREECAD_USE_EXTERNAL_SMESH "Use system installed smesh instead of the bundled." OFF) ... }}

Alternatively, use the command to list the current configuration, and thus all variables that can be changed. You may also install and use to launch a graphical interface showing all the variables that can be modified. In the next sections we list some of the more relevant options that you may want to use.

Для версии Debug
Create a build to troubleshoot crashes in FreeCAD. Beware that with this build the Sketcher becomes very slow with complex sketches.

Для версии Release
Сборка Release будет работать намного быстрее, чем сборка Debug. Sketcher становится очень медленным со сложными набросками для Debug сборки FreeCAD.

Create a build to test code that doesn't crash. A build will run much faster than a  build.

Building against Python 3 and Qt5
By default, FreeCAD builds for Python 2 and Qt4. Since these two packages are obsolete, it is better to build for Python 3 and Qt5.

In a modern Linux distribution you only need to provide two variables specifying the use of Qt5, and the path to the Python interpreter.

Сборка для конкретной версии Python
По умолчанию FreeCAD может обнаруживать только Python 2. Можно выбрать способ сборки для конкретной версии Python (например, Python 2 или Python 3), установив некоторые параметры cmake</tt>. Пример для Python 3 показан ниже:

If the default executable in your system is a symbolic link to Python 2,  will try to configure FreeCAD for this version. You can choose another version of Python by giving the path to a specific executable:

If that doesn't work, you may have to define additional variables pointing to the desired Python libraries and include directories:

Расположение и номера версий ваших файлов и каталогов Python будут различаться в зависимости от того, какой дистрибутив вы используете. Вы можете найти их, используя команды Unix locate</tt> или which </tt>.

You may use in a terminal to determine the  directory, or  for Debian systems.

Building with Qt Creator against Python 3 and Qt5
To compile in Qt Creator add the appropriate variables to the bottom of. Again, specify the correct paths and Python version that you want to use.

Go to and choose  to compile the graphical version of FreeCAD, or  to compile only the command line version.

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

Go into an auxiliary directory of the source code, the run with the indicated project file to create a ; then run  to compile the plugin.

If you are compiling for Qt5, make sure the binary is the one for this version, so that the resulting  contains the necessary information for Qt5.

where is the directory that stores Qt binary libraries, for example,.

The library created is, which needs to be copied to.

Внешний или встроенный Pivy
Если вы хотите использовать системную копию Pivy, что обычно и происходит для Linux-систем, установите флаг компилятора для использования правильного pivy с  -DFREECAD_USE_EXTERNAL_PIVY = 1 </ tt>. Использование внешнего Pivy стало стандартом для Linux при разработке FreeCAD 0.16, поэтому его не нужно настраивать вручную при компиляции этой и более новой версии в Linux.

Using external Pivy became the default during development of FreeCAD 0.16, therefore this option does not need to be set manually anymore.

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

Additional documentation
The source code of FreeCAD is very extensive, and with CMake it's possible to configure many options. Learning to use CMake fully may be useful to choose the right options for your particular needs.
 * CMake Reference Documentation by Kitware.
 * How to Build a CMake-Based Project (blog) by Preshing on programming.
 * Learn CMake's Scripting Language in 15 Minutes (blog) by Preshing on programming.

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

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

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

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

The CMake system allows you to intelligently update the source code, and only recompile what has changed, making subsequent compilations faster.

Move to the location where the FreeCAD source code was first downloaded, and pull the new code:

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

Примечание для 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.

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

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

Once you install the package from the  repository, it will supersede the FreeCAD executable that is available from the Universe Ubuntu repository. The executable will be named simply, and not.

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

Arch using AUR
Arch User Repository (AUR) is a collection user made recipes to build packages which are not officially supported by distribution maintainers / community. They are usually safe. You can see who maintain the package and for how long he did. It is recommended to check construction files. Also non open source software are available in this area even if maintained by the official owning company.

Prerequisite : git

Steps :
 * 1) Open a terminal. Optionally create a directory eg. . Optionally change directory eg..
 * 2) Clone the AUR repository :
 * 3) Enter AUR repository folder :
 * 4) Compile using Arch makepkg : . The -s or --syncdeps flag will also install required dependencies.
 * 5) Install created package : or double click on the pkgname-pkgver.pkg.tar.xz inside your file browser.

To update FreeCAD to latest build just repeat from step 3. Update AUR repo when there is some breaking change in the recipe or new features using inside the folder.