Difference between revisions of "CompileOnUnix/ru"

From FreeCAD Documentation
Jump to: navigation, search
(Updating to match new version of source page)
 
(178 intermediate revisions by 6 users not shown)
Line 1: Line 1:
Сборка FreeCAD в современных дистрибутивах Линукс, как правило, не вызывает сложностей, поскольку все зависимости можно разрешить с помощью менеджера пакетов, встроенного в дистрибутив. Сборка включает 3 этапа:
+
<languages/>
 +
<div class="mw-translate-fuzzy">
 +
{{docnav/ru|CompileOnWindows/ru|CompileOnMac/ru}}
 +
</div>
 +
 
 +
<div class="mw-translate-fuzzy">
 +
Сборка FreeCAD в современных дистрибутивах Линукс обычно не вызывает сложностей, поскольку все зависимости разрешаются менеджером пакетов, встроенным в дистрибутив. Сборка включает 3 этапа:
 
# Загрузка исходного кода FreeCAD.
 
# Загрузка исходного кода FreeCAD.
# Разрешение зависимостей (packages FreeCAD depends upon).
+
# Разрешение зависимостей (пакетов, от которых зависит FreeCAD).
 
# Настройка с помощью "cmake" и компиляция с помощью "make".
 
# Настройка с помощью "cmake" и компиляция с помощью "make".
 +
</div>
  
Ниже вы найдете подробное описание процесса сборки и особенностей, с которыми можете столкнуться. Если вы найдете ошибки или устаревшие сведения, или если вы используете дистрибутив, которого нет в списке, то мы будем благодарны, если поможете это исправить.
+
<div class="mw-translate-fuzzy">
 +
Ниже вы найдете подробное описание процесса сборки, некоторых [[#Automatic build scripts|скриптов компиляции]] и особенностей, с которыми Вы можете столкнуться. Если вы найдете ошибки, устаревшие сведения, отсутствие перевода, или если вы используете дистрибутив, которого нет в списке, то мы будем благодарны, если поможете это исправить.
 +
</div>
  
 +
[[File:FreeCAD_source_compilation_workflow.svg|800px]]
 +
 +
{{Caption|General workflow to compile FreeCAD from source. The third party dependencies must be in the system, as well as the FreeCAD source code itself. CMake configures the system so that with a single make instruction the entire project is compiled.}}
 +
 +
<div class="mw-translate-fuzzy">
 
== Загрузка исходников ==
 
== Загрузка исходников ==
Перед началом сборки вам понадобиться исходный код. Существует 3 способа получить его.
+
Перед началом сборки вам понадобится исходный код. Вы можете клонировать его через git или загрузить его в качестве архива.
 +
</div>
  
 +
<div class="mw-translate-fuzzy">
 
=== Git ===
 
=== Git ===
The quickest and best way to get the code is to clone the read-only git repository now hosted on GitHub (you need the [http://git-scm.com/ git] package installed):
+
Самый простой и быстрый способ загрузить исходники заключается в клонировании репозитория, который расположен на GitHub (перед этим нужно установить [http://git-scm.com/ git]):
{{Code|lang=bash|code=git clone https://github.com/FreeCAD/FreeCAD.git free-cad-code}}
+
</div>
  
This will place a copy of the latest version of the FreeCAD source code in a new directory called "free-cad-code".
+
<div class="mw-translate-fuzzy">
 +
Эта команда копирует последнюю версию исходного кода FreeCAD в папку "freecad-code".
 +
</div>
  
=== Github ===
+
{{Code|lang=bash|code=
The official FreeCAD repository is on Github:
+
sudo apt install git
[https://github.com/FreeCAD/FreeCAD github.com/FreeCAD/FreeCAD]
+
git clone https://github.com/FreeCAD/FreeCAD.git freecad-source
 +
}}
 +
 
 +
For more information on using Git, and contributing code to the project, see [[Source code management|Source code management]].
 +
 
 +
<div class="mw-translate-fuzzy">
 +
=== Архив исходников ===
 +
Вы можете скачать архив с исходным кодом.
 +
</div>
 +
 
 +
<div class="mw-translate-fuzzy">
 +
== Разрешение зависимостей ==
  
=== Source package ===
+
Перед компиляцией FreeCAD под Линукс вы должны установить все библиотеки перечисленные в статье [[Third Party Libraries|Сторонние библиотеки]]. Обратите внимание, что названия библиотек и их доступность зависят от вашего дистрибутива. Учтите, что в старых дистрибутивах некоторые пакеты, перечисленные ниже, могут отсутствовать в репозитории. В этом случае обратитесь к разделу [[#Older and non-conventional distributions|Старые и нетрадиционные дистрибутивы]].
Alternatively you can download a source package, but they could be already quite old so it's always better to get the latest sources via git or github.
+
</div>
  
* Official FreeCAD source packages (distribution-independent): to be advised
+
<div class="mw-translate-fuzzy">
 +
[[#Компиляция_FreeCAD|Перейти к компиляции FreeCAD]]
 +
</div>
  
== Getting the dependencies ==
+
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.
To compile FreeCAD under Linux you have to install all libraries mentioned in [[Third Party Libraries]] first. Please note that the names and availability of the libraries will depend on your distribution. Note that if you don't use the most recent version of your distribution, some of the packages below might be missing from your repositories. In that case, look in the [[#Older and non-conventional distributions|Older and non-conventional distributions]] section below.  
 
  
[[#Compile_FreeCAD|Skip to Compile FreeCAD]]
+
<div class="mw-collapsible mw-collapsed toccolours">
  
 +
<div class="mw-translate-fuzzy">
 
<div class="mw-collapsible mw-collapsed toccolours">
 
<div class="mw-collapsible mw-collapsed toccolours">
=== Debian and Ubuntu ===
+
=== Debian и Ubuntu ===
 +
<div class="mw-collapsible-content">
 +
В дистрибутивах основанных на Debian (Debian, Ubuntu, Mint и других) достаточно просто разрешить все зависимости. Большинство библиотек можно установить с помощью apt-get или менеджера пакетов Synaptic.
 +
</div>
 +
 
 +
<div class="mw-collapsible-content">
 +
 
 +
On Debian-based systems (Debian, Ubuntu, Mint, etc.) it is quite easy to get all needed dependencies installed. Most of the libraries are available via {{incode|apt}} or the Synaptic package manager.
 +
 
 +
Если вы уже установили FreeCAD из официальных репозиториев, вы можете установить его зависимости для сборки с помощью одной строки кода в терминале:
 +
 
 +
{{Code|code=
 +
sudo apt build-dep 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:
 +
*{{incode|build-essential}}, installs the C and C++ compilers, the C development libraries, and the {{incode|make}} program.
 +
*{{incode|cmake}}, essential tool to configure the source of FreeCAD. You may also wish to install {{incode|cmake-gui}} and {{incode|cmake-curses-gui}} for a graphical option.
 +
*{{incode|libtool}}, essential tools to produce shared libraries.
 +
*{{incode|lsb-release}}, 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.
 +
*{{incode|python3}}
 +
*{{incode|swig}}, 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:
 +
 
 +
*{{incode|libboost-dev}}
 +
*{{incode|libboost-date-time-dev}}
 +
*{{incode|libboost-filesystem-dev}}
 +
*{{incode|libboost-graph-dev}}
 +
*{{incode|libboost-iostreams-dev}}
 +
*{{incode|libboost-program-options-dev}}
 +
*{{incode|libboost-python-dev}}
 +
*{{incode|libboost-regex-dev}}
 +
*{{incode|libboost-serialization-dev}}
 +
*{{incode|libboost-signals-dev}}
 +
*{{incode|libboost-thread-dev}}
 +
 
 +
<div class="mw-translate-fuzzy">
 +
или:
 +
</div>
 +
 
 +
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:
 +
 
 +
*{{incode|libeigen3-dev}}
 +
*{{incode|libgts-bin}}
 +
*{{incode|libgts-dev}}
 +
*{{incode|libkdtree++-dev}}
 +
*{{incode|libmedc-dev}}
 +
*{{incode|libopencv-dev}} or {{incode|libcv-dev}}
 +
*{{incode|libproj-dev}}
 +
*{{incode|libvtk7-dev}} or {{incode|libvtk6-dev}}
 +
*{{incode|libx11-dev}}
 +
*{{incode|libxerces-c-dev}}
 +
*{{incode|libzipios++-dev}}
 +
 
 +
<div class="mw-collapsible mw-collapsed" style="background-color:#e0e0e0">
 +
 
 +
==== Python 2 and Qt4 ====
 +
This is not recommended for newer installations as both Python 2 and Qt4 are obsolete.
 +
 
 +
<div class="mw-collapsible-content">
 +
 
 +
To compile FreeCAD for Debian Jessie, Stretch, Ubuntu 16.04, using Python 2 and Qt4, install the following dependencies.
 +
 
 +
*{{incode|qt4-dev-tools}}
 +
*{{incode|libqt4-dev}}
 +
*{{incode|libqt4-opengl-dev}}
 +
*{{incode|libqtwebkit-dev}}
 +
*{{incode|libshiboken-dev}}
 +
*{{incode|libpyside-dev}}
 +
*{{incode|pyside-tools}}
 +
*{{incode|python-dev}}
 +
*{{incode|python-matplotlib}}
 +
*{{incode|python-pivy}}
 +
*{{incode|python-ply}}
 +
*{{incode|python-pyside}}
 +
 
 +
</div>
 +
</div>
 +
 
 +
==== Python 3 and Qt5 ====
 +
 
 +
<div class="mw-translate-fuzzy">
 +
или с Qt5 и Python 3 (Debian Buster, Ubuntu 19.04 и выше, а также Ubuntu 18.04/18.10 с добавленными [[Install_on_Unix # Official_Ubuntu_repository|freecad-stable/freecad-daily PPA]] источниками вашего программного обеспечения:
 +
</div>
 +
 
 +
*{{incode|qtbase5-dev}}
 +
*{{incode|qttools5-dev}}
 +
*{{incode|libqt5opengl5-dev}}
 +
*{{incode|libqt5svg5-dev}}
 +
*{{incode|libqt5webkit5-dev}} or {{incode|qtwebengine5-dev}}
 +
*{{incode|libqt5xmlpatterns5-dev}}
 +
*{{incode|libqt5x11extras5-dev}}
 +
*{{incode|libpyside2-dev}}
 +
*{{incode|libshiboken2-dev}}
 +
*{{incode|pyside2-tools}}
 +
*{{incode|python3-dev}}
 +
*{{incode|python3-matplotlib}}
 +
*{{incode|python3-pivy}}
 +
*{{incode|python3-ply}}
 +
*{{incode|python3-pyside2.qtcore}}
 +
*{{incode|python3-pyside2.qtgui}}
 +
*{{incode|python3-pyside2.qtsvg}}
 +
*{{incode|python3-pyside2.qtwidgets}}
 +
*{{incode|python3-pyside2uic}}
 +
 
 +
<div class="mw-translate-fuzzy">
 +
или:
 +
: * libocct * -dev (официальная версия opencascade, последняя версия, доступная в Debian Buster и Ubuntu 18.10 и более поздних версиях, а также в Ubuntu 18.04 с [[Install_on_Unix # Official_Ubuntu_repository | freecad-stable/freecad-daily PPA]] добавлены в ваши программные источники)
 +
: *occt-draw
 +
или же:
 +
: * liboce * -dev (версия сообщества opencascade, устаревшая, доступна в Debian jessie, stretch, Ubuntu 16.04 и более поздних версиях)
 +
: *oce-draw
 +
</div>
 +
 
 +
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 [[Install_on_Unix#Official_Ubuntu_repository|freecad-stable/freecad-daily PPAs]] added to your software sources, install the official packages.
 +
 
 +
*{{incode|libocct*-dev}}
 +
**{{incode|libocct-data-exchange-dev}}
 +
**{{incode|libocct-draw-dev}}
 +
**{{incode|libocct-foundation-dev}}
 +
**{{incode|libocct-modeling-algorithms-dev}}
 +
**{{incode|libocct-modeling-data-dev}}
 +
**{{incode|libocct-ocaf-dev}}
 +
**{{incode|libocct-visualization-dev}}
 +
*{{incode|occt-draw}}
 +
 
 +
For Debian Jessie, Stretch, Ubuntu 16.04 and newer, install the community edition packages.
 +
 
 +
*{{incode|liboce*-dev}}
 +
**{{incode|liboce-foundation-dev}}
 +
**{{incode|liboce-modeling-dev}}
 +
**{{incode|liboce-ocaf-dev}}
 +
**{{incode|liboce-ocaf-lite-dev}}
 +
**{{incode|liboce-visualization-dev}}
 +
*{{incode|oce-draw}}
 +
 
 +
<div class="mw-translate-fuzzy">
 +
Обратите внимание, что liboce*-dev/libocct*-dev включает следующие библиотеки (замените oce на oct):
 +
</div>
 +
 
 +
{{Code|code=
 +
sudo apt install libocct*-dev
 +
}}
 +
 
 +
<div class="mw-translate-fuzzy">
 +
Дополнительно Вы можете установить следующие дополнительные пакеты:
 +
</div>
 +
 
 +
<div class="mw-translate-fuzzy">
 +
'''Отдельная команда для Qt5 и Python 3 (требуется Pyside2, доступный в Debian Buster и PPC freecad-stable / freecad-daily)'''
 +
</div>
 +
 
 +
{{Code|code=
 +
sudo apt install cmake cmake-gui libboost-date-time-dev libboost-dev libboost-filesystem-dev libboost-graph-dev libboost-iostreams-dev libboost-program-options-dev libboost-python-dev libboost-regex-dev libboost-serialization-dev libboost-signals-dev libboost-thread-dev libcoin-dev libeigen3-dev libgts-bin libgts-dev libkdtree++-dev libmedc-dev libocct-data-exchange-dev libocct-ocaf-dev libocct-visualization-dev libopencv-dev libproj-dev libpyside2-dev libqt5opengl5-dev libqt5svg5-dev libqt5webkit5-dev libqt5x11extras5-dev libqt5xmlpatterns5-dev libshiboken2-dev libspnav-dev libvtk7-dev libx11-dev libxerces-c-dev libzipios++-dev occt-draw pyside2-tools python3-dev python3-matplotlib python3-pivy python3-ply python3-pyside2.qtcore python3-pyside2.qtgui python3-pyside2.qtsvg python3-pyside2.qtwidgets python3-pyside2uic qtbase5-dev qttools5-dev swig
 +
}}
 +
 
 +
<div class="mw-collapsible mw-collapsed" style="background-color:#e0e0e0">
 +
 
 +
<div class="mw-translate-fuzzy">
 +
'''Отдельная команда для Qt4 и Python 2'''
 +
</div>
 +
 
 
<div class="mw-collapsible-content">
 
<div class="mw-collapsible-content">
On Debian-based systems (Debian, Ubuntu, Mint, etc...) it is quite easy to get all needed dependencies installed. Most of the libraries are available via apt-get or synaptic package manager.
 
<!--<div style="column-count:2;-moz-column-count:2;-webkit-column-count:2">-->
 
*build-essential
 
*cmake
 
*python
 
*python-matplotlib
 
*libtool
 
either:
 
:*libcoin60-dev (Debian Wheezy, Wheezy-backports, Ubuntu 13.04 and before)
 
or:
 
:*libcoin80-dev (Debian unstable(Jesse), testing, Ubuntu 13.10 and forward)
 
*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
 
either:
 
:*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
 
<!--</div>-->
 
[http://forum.freecadweb.org/viewtopic.php?f=4&t=5096#p40018 Additional instruction] for libcoin80-dev Debian wheezy-backports, unstable, testing, Ubuntu 13.10 and forward
 
  
Note that liboce*-dev includes the following libraries:
+
{{Code|code=
*liboce-foundation-dev  
+
sudo apt install cmake debhelper dh-exec dh-python libboost-date-time-dev libboost-dev libboost-filesystem-dev libboost-graph-dev libboost-iostreams-dev libboost-program-options-dev libboost-python-dev libboost-regex-dev libboost-serialization-dev libboost-signals-dev libboost-thread-dev libcoin80-dev libeigen3-dev libgts-bin libgts-dev libkdtree++-dev libmedc-dev libocct-data-exchange-dev libocct-ocaf-dev libocct-visualization-dev libopencv-dev libproj-dev libpyside-dev libqt4-dev libqt4-opengl-dev libqtwebkit-dev libshiboken-dev libspnav-dev libvtk6-dev libx11-dev libxerces-c-dev libzipios++-dev lsb-release occt-draw pyside-tools python-dev python-matplotlib python-pivy python-ply swig
*liboce-modeling-dev  
+
}}
*liboce-ocaf-dev  
+
 
*liboce-visualization-dev  
+
<div class="mw-translate-fuzzy">
*liboce-ocaf-lite-dev
+
Пользователи Ubuntu 16.04, пожалуйста, смотрите так же эти [http://forum.freecadweb.org/viewtopic.php?f=4&t=16292 дополнительные инструкции (en)].
You may have to install these packages by individual name.
+
</div>
  
Optionally you can also install these extra packages:
 
*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)
 
 
</div>
 
</div>
 
</div>
 
</div>
 +
</div>
 +
</div>
 +
 
<div class="mw-collapsible mw-collapsed toccolours">
 
<div class="mw-collapsible mw-collapsed toccolours">
  
 
=== Fedora ===
 
=== Fedora ===
 +
 
<div class="mw-collapsible-content">
 
<div class="mw-collapsible-content">
You need the following packages:
+
 
 +
Вам нужны следующие пакеты:
 +
 
 
<!--<div style="column-count:2;-moz-column-count:2;-webkit-column-count:2">-->
 
<!--<div style="column-count:2;-moz-column-count:2;-webkit-column-count:2">-->
 
*gcc-c++ (or possibly another C++ compiler?)
 
*gcc-c++ (or possibly another C++ compiler?)
Line 123: Line 281:
 
*opencv-devel
 
*opencv-devel
 
*smesh-devel
 
*smesh-devel
*coin3-devel (if coin2 is the latest available for your version of Fedora, use packages from http://www.zultron.com/rpm-repo/ )
+
*coin3-devel
 +
 
 +
(Если в вашей версии Fedora последнее, что доступно, это coin2, используйте пакеты из http://www.zultron.com/rpm-repo/)
 +
 
 
*soqt-devel
 
*soqt-devel
 
*freetype
 
*freetype
 
*freetype-devel
 
*freetype-devel
 
<!--</div>-->
 
<!--</div>-->
And optionally:
+
 
 +
Добавьте, если нужно:  
 +
 
 
<!--<div style="column-count:2;-moz-column-count:2;-webkit-column-count:2">-->
 
<!--<div style="column-count:2;-moz-column-count:2;-webkit-column-count:2">-->
*libspnav-devel (for 3Dconnexion devices support like the Space Navigator or Space Pilot)
+
 
*pivy ( https://bugzilla.redhat.com/show_bug.cgi?id=458975 Pivy is not mandatory but needed for the Draft module )
+
*libspnav-devel (для поддержки устройств 3Dconnexion, вроде Space Navigator или Space Pilot)
 +
*pivy ( https://bugzilla.redhat.com/show_bug.cgi?id=458975 Pivy не обязателен, но нужен для модуля Draft)
 +
 
 
</div>
 
</div>
 
</div>
 
</div>
 
<div class="mw-collapsible mw-collapsed toccolours">
 
<div class="mw-collapsible mw-collapsed toccolours">
  
 +
<div class="mw-translate-fuzzy">
 
=== Gentoo ===
 
=== Gentoo ===
 
<div class="mw-collapsible-content">
 
<div class="mw-collapsible-content">
 +
Простейший путь узнать, какие пакеты нужны для компиляции FreeCAD - проверить через portage:
 +
</div>
 +
 +
<div class="mw-collapsible-content">
 +
 
Easiest way to check which packages are needed to compile FreeCAD is to check via portage:
 
Easiest way to check which packages are needed to compile FreeCAD is to check via portage:
  
 
<tt>emerge -pv freecad</tt>
 
<tt>emerge -pv freecad</tt>
  
This should give a nice list of extra packages that you need installed on your system.
+
Вы получите список дополнительных пакетов, которые следует установить на Вашей системе.
 +
 
 +
Если FreeCAD недоступен в portage, он доступен в оверлее [https://github.com/waebbl/waebbl-gentoo waebbl]. Система отслеживания ошибок на оверлее waebbl Github может помочь решить некоторые проблемы, с которыми вы можете столкнуться. Оверлей предоставляет <tt> freecad-9999 </ tt>, который вы можете выбрать для компиляции или просто использовать для получения зависимостей.
 +
 
 +
<tt>layman -a waebbl</tt>
 +
 
 
</div>
 
</div>
 
</div>
 
</div>
 +
<div class="mw-collapsible mw-collapsed toccolours">
 +
 +
=== openSUSE ===
  
<div class="mw-collapsible mw-collapsed toccolours">
 
=== OpenSUSE ===
 
 
<div class="mw-collapsible-content">
 
<div class="mw-collapsible-content">
You need the following packages:
 
*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
 
For FreeCAD 0.14 stable and 0.15 unstable you need to add Eigen3 and swig libraries, that don't seem to be in standard repos. You can get them with a one-click install here:
 
*[http://software.opensuse.org/search?q=eigen3&baseproject=openSUSE%3A12.1&lang=en&exclude_debug=true Eigen3]
 
*[http://software.opensuse.org/search?q=swig&baseproject=openSUSE%3A12.1&lang=en&exclude_debug=true swig]
 
  
Also, note that the Eigen3 Library from Factory Education was causing problems sometimes, so use the one from the KDE 4.8 Extra repo
+
==== Tumbleweed ====
 +
 
 +
The following commands will install the packages required for building FreeCAD with Qt5 and Python 3.
 +
 
 +
{{Code|code=
 +
zypper in --no-recommends -t pattern devel_C_C++ devel_qt5
 +
 
 +
zypper in libqt5-qtbase-devel libqt5-qtsvg-devel libqt5-qttools-devel boost-devel swig libboost_program_options-devel libboost_mpi_python3-devel libboost_system-devel libboost_program_options-devel libboost_regex-devel libboost_python3-devel libboost_thread-devel libboost_system-devel libboost_headers-devel libboost_graph-devel python3 python3-devel python3-matplotlib python3-matplotlib-qt5 python3-pyside2 python3-pyside2-devel python3-pivy gcc gcc-fortran cmake occt-devel libXi-devel opencv-devel libxerces-c-devel Coin-devel SoQt-devel freetype2-devel eigen3-devel libode6 vtk-devel libmed-devel hdf5-openmpi-devel openmpi2-devel netgen-devel freeglut-devel libspnav-devel f2c doxygen dos2unix glew-devel
 +
}}
 +
 
 +
The following command will install Qt Creator and the GNU Project Debugger.
 +
 
 +
{{Code|code=zypper in libqt5-creator gdb}}
 +
 
 +
If any packages are missing, then you can check the Tumbleweed [https://build.opensuse.org/package/view_file/openSUSE:Factory/FreeCAD/FreeCAD.spec "FreeCAD.spec"] file on the [https://build.opensuse.org/package/show/openSUSE:Factory/FreeCAD Open Build Service].
 +
 
 +
Also, check to see if there are any patches you need to apply (such as [https://build.opensuse.org/package/view_file/openSUSE:Factory/FreeCAD/0001-find-openmpi2-include-files.patch 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 [https://build.opensuse.org/package/view_file/openSUSE:Leap:15.0/FreeCAD/FreeCAD.spec "FreeCAD.spec"] file on the [https://build.opensuse.org/ Open Build Service] to determine the required packages.
 +
 
 
</div>
 
</div>
 
</div>
 
</div>
 
 
<div class="mw-collapsible mw-collapsed toccolours">
 
<div class="mw-collapsible mw-collapsed toccolours">
  
 
=== Arch Linux ===
 
=== Arch Linux ===
 +
 
<div class="mw-collapsible-content">
 
<div class="mw-collapsible-content">
 +
 
You will need the following libraries from the official repositories:
 
You will need the following libraries from the official repositories:
 
<!--<div style="column-count:2;-moz-column-count:2;-webkit-column-count:2">-->
 
<!--<div style="column-count:2;-moz-column-count:2;-webkit-column-count:2">-->
 
*boost-libs
 
*boost-libs
 
*curl
 
*curl
 +
*desktop-file-utils
 +
*glew
 
*hicolor-icon-theme
 
*hicolor-icon-theme
 +
*jsoncpp
 
*libspnav
 
*libspnav
 +
*med
 
*opencascade
 
*opencascade
*python2-pivy
+
*shiboken2
*python2-matplotlib
 
*python2-pyside
 
*python2-shiboken
 
*qtwebkit
 
*shared-mime-info
 
 
*xerces-c
 
*xerces-c
 +
*pyside2
 +
*python-matplotlib
 +
*python-netcdf4
 +
*qt5-svg
 +
*qt5-webkit
 +
*qt5-webengine
 
*boost
 
*boost
 
*cmake
 
*cmake
*coin
 
*desktop-file-utils
 
 
*eigen
 
*eigen
 +
*git
 
*gcc-fortran
 
*gcc-fortran
 +
*pyside2-tools
 
*swig
 
*swig
*xerces-c
+
*qt5-tools
 +
*shared-mime-info
 
<!--</div>-->
 
<!--</div>-->
Also, make sure to check the AUR for any missing packages that are not on the repositories, currently:
+
 
*python2-pyside-tools
+
Так же обязательно проверьте AUR насчёт пропущенных пакетов, которые сейчас вне репозиториев:
 +
 
 +
*coin
 +
*python-pivy
 +
*med
 +
 
 +
{{Code|code=
 +
sudo pacman -S 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 cmake eigen git gcc-fortran pyside2-tools swig qt5-tools shared-mime-info coin python-pivy med
 +
}}
 
<!--T:139-->
 
<!--T:139-->
 
</div>
 
</div>
 
</div>
 
</div>
 +
 
<div class="mw-collapsible mw-collapsed toccolours">
 
<div class="mw-collapsible mw-collapsed toccolours">
=== Older and non-conventional distributions ===
+
 
 +
<div class="mw-translate-fuzzy">
 +
=== Старые и нетрадиционные дистрибутивы ===
 
<div class="mw-collapsible-content">
 
<div class="mw-collapsible-content">
On other distributions, we have very few feedback from users, so it might be harder to find the required packages. Try first locating the required libraries mentioned in [[Third Party Libraries]]. Beware that some of them might have a slightly different package name in your distribution (such as name, libname, name-dev, name-devel, etc...).
+
В других дистрибутивах у нас слишком мало откликов от пользователей, так что может оказаться трудно найти требуемые пакеты. Сначала попробуйте найти требуемые пакеты, упомянутые в [[Third Party Libraries/ru|Сторонних библиотеках]]. Учтите, что некоторые из них могут иметь в вашем дистрибутиве немного другие имена пакетов (Вроде name, libname, name-dev, name-devel, и так далее...).
 +
</div>
 +
 
 +
<div class="mw-collapsible-content">
 +
 
 +
On other distributions, we have very few feedback from users, so it might be harder to find the required packages.
 +
 
 +
Try first locating the required libraries mentioned in [[Third Party Libraries|third party libraries]] in your package manager. Beware that some of them might have a slightly different package name; search for {{incode|name}}, but also {{incode|libname}}, {{incode|name-dev}}, {{incode|name-devel}}, and similar. If that is not possible try compiling those libraries yourself.
 +
 
 +
<div class="mw-translate-fuzzy">
 +
Вам так же нужен [https://ru.wikipedia.org/wiki/GNU_Compiler_Collection компилятор GNU GCC] версии 3.0.0 или выше. Так же нужен g++, поскольку FreeCAD полностью написан на C++. Во время компиляции исполняются некоторые скрипты Python, поэтому ваш интерпретатор Python должен работать правильно. Во избежание проблем компоновки во время процесса сборки системы, хорошо бы иметь путь к библиотекам или в переменной ''LD_LIBRARY_PATH'', или в конфигурационном файле ''ld.so.conf''. Это обычно уже так в последних дистрибутивах.
 +
</div>
 +
 
 +
</div>
 +
</div>
 +
 
 +
<div class="mw-translate-fuzzy">
 +
==== Pivy ====
 +
Pivy не обязателен ни для компиляции, ни для работы FreeCAD. Он нужен для работы [[Draft Module|Draft модуля]] . Если Вы не собираетесь использовать этот модуль, Вам не нужен pivy. С ноября 2015 устаревшая версия Pivy включённая в исходные коду FreeCAD более не компилируется на многих системах из-за устаревания. Если Вы не можете найти Pivy в своём дистрибутиве, Вы можете скомпилировать pivy самостоятельно:
 +
</div>
 +
 
 +
[[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 Module|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 Workbench|Arch]] and [[BIM Workbench|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 [[Extra_python_modules#Pivy|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 {{incode|-dbg}}, {{incode|-dbgsym}}, {{incode|-debuginfo}} 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 [https://wiki.ubuntu.com/Debug_Symbol_Packages Debug Symbol Packages] for more information.
 +
 
 +
== Компиляция FreeCAD ==
 +
 
 +
<div class="mw-translate-fuzzy">
 +
FreeCAD использует CMake в качестве основной системы сборки. CMake - это система сборки, доступная во всех основных операционных системах. Компиляция с помощью CMake обычно очень проста и происходит в два этапа.
 +
</div>
 +
 
 +
<div class="mw-translate-fuzzy">
 +
# CMake проверяет наличие всех необходимых программ и библиотек в вашей системе и настраивает систему сборки для второго шага. Хотя FreeCAD имеет несколько вариантов конфигурации на выбор, значения по умолчанию достаточны. Некоторые альтернативные конфигурации подробно описаны ниже.
 +
# Сама компиляция, которая создает исполняемый файл FreeCAD.
 +
</div>
 +
 
 +
<div class="mw-translate-fuzzy">
 +
Так как FreeCAD большое приложение, компиляция может занять от 10 до 30 минут, в зависимости от мощности оборудования, выполняющего компиляцию.
 +
</div>
 +
 
 +
You can build the code either in or out of the source directory. Out-of-source building is generally the best option.
 +
 
 +
<div class="mw-translate-fuzzy">
 +
==== Компиляций вне исходников ====
 +
Если Вы намерены следовать за быстрой эволюцией FreeCAD, сборка в отдельном каталоге подходит лучше. Каждый раз, когда Вы обновляете исходные коды, СMake интеллектуально отметит изменённые файлы и перекомпилирует только то, что нужно. Сборка вне исходников особо полезно при использовании системы Git, поскольку Вы можете запросто попробовать другие ветви исходных кодов, не приводя в смущение систему сборки. Для сборки вне исходников создайте сборочный каталог, и внутри него укажите СMake каталог исходников (при использовании графического интерфейса замените в нижеследующем коде "cmake" на "cmake-gui"):
 +
</div>
 +
 
 +
To build out-of-source, simply create a build directory, {{incode|freecad-build}}, distinct from your FreeCAD source folder, {{incode|freecad-source}}; then from this build directory point {{incode|cmake}} to the right source folder. You can use {{incode|cmake-gui}} or {{incode|ccmake}} instead of {{incode|cmake}} in the instructions below as well. Once {{incode|cmake}} finishes configuring the environment, use {{incode|make}} to start the actual compilation.
 +
 
 +
{{Code|lang=bash|code=
 +
mkdir freecad-build
 +
cd freecad-build
 +
cmake ../freecad-source
 +
make -j$(nproc --ignore=2)
 +
}}
 +
 
 +
<div class="mw-translate-fuzzy">
 +
Исполняемый файл FreeCAD будет находиться в каталоге <tt> freecad-build / bin </ tt>.
 +
</div>
  
You also need the [[wikipedia:GNU Compiler Collection|GNU gcc compiler]] version equal or above 3.0.0. g++ is also needed because FreeCAD is completely written in C++. During the compilation some Python scripts get executed. So the Python interpreter has to work properly. To avoid any linker problems during the build process it is also a good idea to have the library paths either in your ''LD_LIBRARY_PATH'' variable or in your ''ld.so.conf'' file. This is normally already the case in recent distributions.
+
==== Сборка внутри древа исходников ====
  
For more details have also a look to ''README.Linux'' in your sources.
+
<div class="mw-translate-fuzzy">
 +
Сборки внутри древа исходников хороши, если вы хотите просто посмотреть на FreeCAD, и хотите с лёгкостью удалить его прямо с этим каталогом. Однако, если вы не знаете какой способ выбрать, не делайте сборку внутри древа исходников. Создайте сборку вне исходного кода, как описано ранее. Однако FreeCAD может быть собран внутри исходного кода, что означает, что все файлы, полученные в результате компиляции, остаются в той же папке, что и исходный код.
 
</div>
 
</div>
 +
 +
<div class="mw-translate-fuzzy">
 +
Для компиляции FreeCAD используйте следующие команды:
 
</div>
 
</div>
Below is additional help for a couple of libraries that might not be present in your distribution repositories
 
  
==== OpenCASCADE community edition (OCE) ====
+
{{Code|lang=bash|code=
OpenCasCade has recently been forked into a [http://github.com/tpaviot/oce Community edition], which is much, much easier to build. FreeCAD can use any version installed on your system, either the "official" edition or the community edition. The OCE website contains detailed build instructions.
+
cd freecad-source
 +
cmake .
 +
make -j$(nproc --ignore=2)
 +
}}
  
==== OpenCASCADE official version ====
+
<div class="mw-translate-fuzzy">
'''Note''': You are advised to use the OpenCasCade community edition above, which is easier to build, but this one works too.
+
Исполняемый файл FreeCAD будет находиться в каталоге <tt>freecad-source/bin</tt>.
Not all Linux distributions have an official OpenCASCADE package in their repositories. You have to check for yourself if one is available for your distribution. At least from Debian Lenny and Ubuntu Intrepid an official .deb package is provided. For older Debian or Ubuntu releases you may get unofficial packages from [http://lyre.mit.edu/~powell/opencascade here]. To build your own private .deb packages follow these steps:
+
</div>
{{Code|lang=bash|code=  
+
 
wget http://lyre.mit.edu/~powell/opencascade/opencascade_6.2.0.orig.tar.gz
+
<div class="mw-translate-fuzzy">
wget http://lyre.mit.edu/~powell/opencascade/opencascade_6.2.0-7.dsc
+
==== Как восстановить каталог исходных кодов после случайного запуска компиляции внутри исходников. ====
wget http://lyre.mit.edu/~powell/opencascade/opencascade_6.2.0-7.diff.gz
+
Для восстановления каталога исходных кодов после случайного запуска компиляции внутри исходников существует метод с использованием Git. Если вы не очистите его, последующие запуски <tt>cmake</ tt> могут не учитывать все ваши новые параметры.
 +
</div>
 +
 
 +
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.
 +
 
 +
{{Code|lang=bash|code=
 +
> .gitignore
 +
git clean -df
 +
git reset --hard HEAD
 +
}}
 +
 
 +
<div class="mw-translate-fuzzy">
 +
Первая строка очищает файл <tt> .gitignore </ tt>. Это гарантирует, что следующие команды clean и reset будут влиять на все в каталоге и не будут игнорировать элементы, соответствующие выражениям в <tt> .gitignore </ tt>. Во второй строке удаляются все файлы и каталоги, которые не отслеживаются репозиторием git, а затем reset сбрасывает все изменения в отслеживаемых файлах (включая первую команду, которая очистила файл <tt> .gitignore </ tt>.
 +
</div>
 +
 
 +
If you do not clear the source directory, subsequent runs of {{incode|cmake}} may not capture new options to the system if the code changes.
 +
 
 +
=== Конфигурация ===
 +
 
 +
<div class="mw-translate-fuzzy">
 +
Передавая различные параметры в CMake, вы можете изменить способ компиляции FreeCAD. Это может быть полезно для нескольких целей. Например, запустив CMake следующим образом, вы можете отменить сборку модуля FEM:
 +
</div>
  
dpkg-source -x opencascade_6.2.0-7.dsc
+
{{Code|code=
 +
cmake -D <var>:<type>=<value> $SOURCE_DIR
 +
}}
  
# Install OCC build-deps
+
Where {{incode|$SOURCE_DIR}} is the directory that contains the source code. The {{incode|<type>}} may be omitted in most cases. The space after the {{incode|-D}} option may also be omitted.
sudo apt-get install build-essential devscripts debhelper autoconf automake libtool bison libx11-dev tcl8.4-dev tk8.4-dev libgl1-mesa-dev libglu1-mesa-dev java-gcj-compat-dev libxmu-dev
 
  
#Build Opencascade packages. This takes hours and requires
+
For example, to avoid building the [[FEM Workbench|FEM Workbench]]:
# at least 8 GB of free disk space
 
cd opencascade-6.2.0 ; debuild
 
  
# Install the resulting library debs
+
{{Code|lang=bash|code=
sudo dpkg -i libopencascade6.2-0_6.2.0-7_i386.deb
+
cmake -D BUILD_FEM:BOOL=OFF ../freecad-source
libopencascade6.2-dev_6.2.0-7_i386.deb
+
cmake -DBUILD_FEM=OFF ../freecad-source
 
}}
 
}}
  
Alternatively, you can download and compile the latest version from [http://www.opencascade.org opencascade.org]:
+
<div class="mw-translate-fuzzy">
 +
Все возможные параметры перечислены в главном файле <tt> CMakeLists.txt </tt> FreeCAD . Попробуйте найти строку <tt> OPTION </tt>. Или используйте команду <tt> cmake -LH </tt>. Ниже приведен список наиболее важных параметров, которые вы можете настроить.
 +
</div>
 +
 
 +
<!--NOT CHANGE THE <pre> </pre> BALISE-->
 +
<pre>
  
Install the package normally, be aware that the installer is a java program that requires the official java runtime edition from Sun (package name: sun-java6-jre), not the open-source java (gij) that is bundled with Ubuntu. Install it if needed:
+
# ==============================================================================
{{Code|lang=bash|code=  
+
# =================  All the options for the build process    =================
sudo apt-get remove gij
+
# ==============================================================================
sudo apt-get install sun-java6-jre
+
 
 +
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)
 +
...
 +
</pre>
 +
<!--NOT CHANGE THE <pre> </pre> BALISE-->
 +
 
 +
Alternatively, use the command {{incode|cmake -LH}} to list the current configuration, and thus all variables that can be changed. You may also install and use {{incode|cmake-gui}} 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 {{incode|Debug}} build to troubleshoot crashes in FreeCAD. Beware that with this build the [[Sketcher Workbench|Sketcher]] becomes very slow with complex sketches.
 +
 
 +
{{Code|lang=bash|code=
 +
cmake -DCMAKE_BUILD_TYPE=Debug ../freecad-source
 
}}
 
}}
Be careful, if you use gij java with other things like a browser plugin, they won't work anymore. If the installer doesn't work, try:
 
{{Code|lang=bash|code=java -cp path_to_file_setup.jar <-Dtemp.dir=path_to_tmp_directory> run}}
 
Once the package is installed, go into the "ros" directory inside the opencascade dir, and do
 
{{Code|lang=bash|code=./configure --with-tcl=/usr/lib/tcl8.4 --with-tk=/usr/lib/tk8.4}}
 
Now you can build. Go back to the ros folder and do:
 
{{Code|lang=bash|code=make}}
 
It will take a long time, maybe several hours.
 
  
When it is done, just install by doing
+
<div class="mw-translate-fuzzy">
{{Code|lang=bash|sudo make install}}
+
===== Для версии Release =====
The library files will be copied into /usr/local/lib which is fine because there they will be found automatically by any program. Alternatively, you can also do
+
Сборка Release будет работать намного быстрее, чем сборка Debug. Sketcher становится очень медленным со сложными набросками для Debug сборки FreeCAD.
{{Code|lang=bash|code=sudo checkinstall}}
+
</div>
which will do the same as make install but create an entry in your package management system so you can easily uninstall later.
 
Now clean up the enormous temporary compilation files by doing
 
{{Code|lang=bash|code=make clean}}
 
Possible error 1: If you are using OCC version 6.2, it is likely that the compiler will stop right after the beginning of the "make" operation. If it happens, edit the "configure" script, locate the CXXFLAGS="$CXXFLAGS " statement, and replace it by CXXFLAGS="$CXXFLAGS -ffriend-injection -fpermissive". Then do the configure step again.
 
  
Possible error 2: Possibly several modules (WOKSH, WOKLibs, TKWOKTcl, TKViewerTest and TKDraw) will complain that they couldn't find the tcl/tk headers. In that case, since the option is not offered in the configure script, you will have to edit manually the makefile of each of those modules: Go into adm/make and into each of the bad modules folders. Edit the Makefile, and locate the lines CSF_TclLibs_INCLUDES = -I/usr/include and CSF_TclTkLibs_INCLUDES = -I/usr/include and add /tcl8.4 and /tk8.4 to it so they read: CSF_TclLibs_INCLUDES = -I/usr/include/tcl8.4 and CSF_TclTkLibs_INCLUDES = -I/usr/include/tk8.4
+
Create a {{incode|Release}} build to test code that doesn't crash. A {{incode|Release}} build will run much faster than a {{incode|Debug}} build.
  
==== SoQt ====
 
The SoQt library must be compiled against Qt4, which is the case in most recent distributions. But at the time of writing this article there were only SoQt4 packages for Debian itself available but not for all Ubuntu versions. To get the packages built do the following steps:
 
 
{{Code|lang=bash|code=
 
{{Code|lang=bash|code=
wget http://ftp.de.debian.org/debian/pool/main/s/soqt/soqt_1.4.1.orig.tar.gz
+
cmake -DCMAKE_BUILD_TYPE=Release ../freecad-source
wget http://ftp.de.debian.org/debian/pool/main/s/soqt/soqt_1.4.1-6.dsc
 
wget http://ftp.de.debian.org/debian/pool/main/s/soqt/soqt_1.4.1-6.diff.gz
 
dpkg-source -x soqt_1.4.1-6.dsc
 
sudo apt-get install doxygen devscripts fakeroot debhelper libqt3-mt-dev qt3-dev-tools libqt4-opengl-dev
 
cd soqt-1.4.1
 
debuild
 
sudo dpkg -i libsoqt4-20_1.4.1-6_i386.deb libsoqt4-dev_1.4.1-6_i386.deb libsoqt-dev-common_1.4.1-6_i386.deb
 
 
}}
 
}}
If you are on a 64bit system, you will probably need to change i386 by amd64.
 
  
==== Pivy ====
+
==== Building against Python 3 and Qt5 ====
Pivy is not needed to build FreeCAD or to run it, but it is needed for the 2D Drafting module to work. If you are not going to use that module, you won't need pivy. By November 2015 the obsolete version of Pivy included with FreeCAD source code will no longer compile on many systems, due to its age. If you cannot find Pivy in your distribution's packages repository ort elsewhere, you can compile pivy yourself:
 
  
[[Extra_python_modules#Pivy|Pivy compilation instructions]]
+
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.
  
== Compile FreeCAD ==
+
In a modern Linux distribution you only need to provide two variables specifying the use of Qt5, and the path to the Python interpreter.
  
=== Using cMake ===
+
{{Code|lang=bash|code=
cMake is a newer build system which has the big advantage of being common for different target systems (Linux, Windows, MacOSX, etc). FreeCAD is now using the cMake system as its main building system. Compiling with cMake is usually very simple and happens in 2 steps. In the first step, cMake checks that every needed programs and libraries are present on your system and sets up all that's necessary for the subsequent compilation. You are given a few alternatives detailed below, but FreeCAD comes with sensible defaults. The second step is the compiling itself, which produces the FreeCAD executable. 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 the graphical applications will give you interactive feed back.
+
cmake -DBUILD_QT5=ON -DPYTHON_EXECUTABLE=/usr/bin/python3 ../freecad-source
 +
}}
  
Since FreeCAD is a heavy application, compiling can take a bit of time (about 10 minutes on a fast machine, 30 minutes (or more) on a slow one)
+
<div class="mw-translate-fuzzy">
 +
==== Сборка для конкретной версии Python ====
 +
По умолчанию FreeCAD может обнаруживать только Python 2. Можно выбрать способ сборки для конкретной версии Python (например, Python 2 или Python 3), установив некоторые параметры <tt>cmake</tt>. Пример для Python 3 показан ниже:
 +
</div>
  
==== In-source building ====
+
If the default {{incode|python}} executable in your system is a symbolic link to Python 2, {{incode|cmake}} will try to configure FreeCAD for this version. You can choose another version of Python by giving the path to a specific executable:
If you are unsure then, due to its limitations, do not make an in-source build, create an out-of-source build as explained in the next section. 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. This is fine if you are just looking at FreeCAD, and want to be able to remove it easily by just deleting that folder. But in case you are planning to compile it often, you are advised to make an out-of-source build, which offers many more advantages. The following commands will compile FreeCAD:
 
{{Code|lang=bash|code=$ cd freecad (the folder where you cloned the freecad source)}}
 
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 (via FREECAD_USE_EXTERNAL_PIVY=1). 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. Also, set the build type to Debug if you want a debug build or Release if not. A Release build will run much faster than a Debug build. Sketcher becomes very slow with complex sketches if your FreeCAD is a Debug build. (NOTE: the space and "." after the cmake flags are CRITICAL!):
 
  
For a Debug build
 
 
{{Code|lang=bash|code=
 
{{Code|lang=bash|code=
$ cmake -DFREECAD_USE_EXTERNAL_PIVY=1 -DCMAKE_BUILD_TYPE=Debug .
+
cmake -DPYTHON_EXECUTABLE=/usr/bin/python3 ../freecad-source
$ make
 
 
}}
 
}}
Or for a Release build
+
 
 +
If that doesn't work, you may have to define additional variables pointing to the desired Python libraries and include directories:
 +
 
 
{{Code|lang=bash|code=
 
{{Code|lang=bash|code=
$ cmake -DFREECAD_USE_EXTERNAL_PIVY=1 -DCMAKE_BUILD_TYPE=Release .
+
cmake -DPYTHON_EXECUTABLE=/usr/bin/python3.6 \
$ make
+
    -DPYTHON_INCLUDE_DIR=/usr/include/python3.6m \
 +
    -DPYTHON_LIBRARY=/usr/lib/x86_64-linux-gnu/libpython3.6m.so \
 +
    -DPYTHON_PACKAGES_PATH=/usr/lib/python3.6/site-packages/ \
 +
    ../freecad-source
 +
}}
 +
 
 +
<div class="mw-translate-fuzzy">
 +
Расположение и номера версий ваших файлов и каталогов Python будут различаться в зависимости от того, какой дистрибутив вы используете. Вы можете найти их, используя команды Unix <tt>locate</tt> или <tt>which </tt>.
 +
</div>
 +
 
 +
{{Code|code=
 +
locate python3.6
 +
}}
 +
 
 +
You may use {{incode|python3 -m site}} in a terminal to determine the {{incode|site-packages}} directory, or {{incode|dist-packages}} 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 {{MenuCommand|Projects → Manage Kits → Kits → Default (or your kit) → CMake Configuration}}. Again, specify the correct paths and Python version that you want to use.
 +
 
 +
{{Code|code=
 +
PYTHON_EXECUTABLE=/usr/bin/python3.7
 +
PYTHON_INCLUDE_DIR=/usr/include/python3.7m
 +
PYTHON_LIBRARY=/usr/lib/x86_64-linux-gnu/libpython3.7m.so
 +
PYTHON_PACKAGES_PATH=/usr/lib/python3.7/site-packages
 +
BUILD_QT5=ON
 
}}
 
}}
Your FreeCAD executable will then reside in the "bin" folder, and you can launch it with:
 
{{Code|lang=bash|code=$ ./bin/FreeCAD}}
 
  
 +
Go to {{MenuCommand|Projects → Run → Run Configuration}} and choose {{incode|FreeCADMain}} to compile the graphical version of FreeCAD, or {{incode|FreeCADMainCMD}} to compile only the command line version.
 +
 +
<div class="mw-translate-fuzzy">
 +
==== Плагин Qt Designer ====
 +
Если вы хотите разрабатывать Qt вещи для FreeCAD, вам понадобится плагин Qt Designer, который предоставляет все пользовательские виджеты FreeCAD. Следуйте по ссылке:
 +
</div>
 +
 +
Go into an auxiliary directory of the source code, the run {{incode|qmake}} with the indicated project file to create a {{incode|Makefile}}; then run {{incode|make}} to compile the plugin.
  
==== How to repair your source code directory after accidentally running an in-source build. ====
 
This is a method, using Git, to repair your source code directory after accidentally running an in-source build.
 
 
{{Code|lang=bash|code=
 
{{Code|lang=bash|code=
1) delete everything in your source base directory EXCEPT the hidden .git folder
+
cd freecad-source/src/Tools/plugins/widget
2) In terminal 'git reset --hard HEAD'
+
qmake plugin.pro
//any remnants of an 'in source' build will be gone.
+
make
3) delete everything from your 'out of source' build directory and start over again with cmake and a full new clean build.
 
 
}}
 
}}
  
==== Out-of-source build ====
+
If you are compiling for Qt5, make sure the {{incode|qmake}} binary is the one for this version, so that the resulting {{incode|Makefile}} contains the necessary information for Qt5.
If you intend to follow the fast evolution of FreeCAD, building in a separate folder is much more convenient. Every time you update the source code, cMake will then intelligently distinguish which files have changed, and recompile only what is needed. Out-of-source builds are specially handy when using the Git system, because you can easily try other branches without confusing the build system. To build out-of-source, simply create a build directory, distinct from your FreeCAD source folder, and, from the build folder, point cMake (or if using cmake-gui replace "cmake" in the code below with "cmake-gui") to the source folder:
+
 
 
{{Code|lang=bash|code=
 
{{Code|lang=bash|code=
mkdir freecad-build
+
cd freecad-source/src/Tools/plugins/widget
cd freecad-build
+
$QT_DIR/bin/qmake plugin.pro
cmake ../freecad (or whatever the path is to your FreeCAD source folder)
 
 
make
 
make
 
}}
 
}}
The FreeCAD executable will then reside in the "bin" directory (within your freecad-build directory).
 
  
==== Configuration options ====
+
where {{incode|$QT_DIR}} is the directory that stores Qt binary libraries, for example, {{incode|/usr/lib/x86_64-linux-gnu/qt5}}.
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 <nowiki>-D <var>:<type>=<value></nowiki> 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.
+
 
 +
The library created is {{incode|libFreeCAD_widgets.so}}, which needs to be copied to {{incode|$QT_DIR/plugins/designer}}.
 +
 
 +
{{Code|lang=bash|code=
 +
sudo cp libFreeCAD_widgets.so $QT_DIR/plugins/designer
 +
}}
 +
 
 +
<div class="mw-translate-fuzzy">
 +
==== Внешний или встроенный Pivy ====
 +
</div>
  
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:
+
<div class="mw-translate-fuzzy">
{{Code|lang=bash|code=cmake -D FREECAD_BUILD_ASSEMBLY:BOOL=ON ''path-to-freecad-root''}}
+
Если вы хотите использовать системную копию Pivy, что обычно и происходит для Linux-систем, установите флаг компилятора для использования правильного pivy с <tt> -DFREECAD_USE_EXTERNAL_PIVY = 1 </ tt>. Использование внешнего Pivy стало стандартом для Linux при разработке FreeCAD 0.16, поэтому его не нужно настраивать вручную при компиляции этой и более новой версии в Linux.
Possible options are listed in FreeCAD's root CmakeLists.txt file.
+
</div>
  
==== Qt designer plugin ====
+
Using external Pivy became the default during development of FreeCAD 0.16, therefore this option does not need to be set manually anymore.
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
 
{{Code|lang=bash|code=freecad/src/Tools/plugins/widget}}
 
So far we don't provide a makefile -- but calling
 
{{Code|lang=bash|code=qmake plugin.pro}}
 
creates it. Once that's done, calling
 
{{Code|lang=bash|code=make}}
 
will create the library libFreeCAD_widgets.so. To make this library known to Qt Designer you have to copy the file to $QTDIR/plugin/designer
 
  
 +
<div class="mw-translate-fuzzy">
 
==== Doxygen ====
 
==== 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]]
+
Если вы чувствуете себя достаточно смелым, чтобы погрузиться в код, вы могли бы воспользоваться возможностью для создания и изучения сгенерированной Doxygen FreeCAD [[Source documentation|исходной документации]]
 +
</div>
 +
 
 +
=== 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.
 +
* [https://cmake.org/documentation/ CMake Reference Documentation] by Kitware.
 +
* [https://preshing.com/20170511/how-to-build-a-cmake-based-project/ How to Build a CMake-Based Project] (blog) by Preshing on programming.
 +
* [https://preshing.com/20170522/learn-cmakes-scripting-language-in-15-minutes/ Learn CMake's Scripting Language in 15 Minutes] (blog) by Preshing on programming.
 +
 
 +
<div class="mw-translate-fuzzy">
 +
=== Создание пакета debian ===
 +
Если Вы планируете создать пакет Debian вне исходников, Вам следует сначала установить следующие пакеты:
 +
</div>
  
=== Making a debian package ===
 
If you plan to build a Debian package out of the sources you need to install those packages first:
 
 
{{Code|lang=bash|code=
 
{{Code|lang=bash|code=
dh-make
+
sudo apt install dh-make devscripts lintian
devscripts
+
}}
  
#optional, used for checking if packages are standard-compliant
+
<div class="mw-translate-fuzzy">
lintian  
+
Для сборки пакета откройте консоль, перейдите в каталог FreeCAD и вызовите
 +
</div>
 +
 
 +
{{Code|lang=bash|code=
 +
debuild
 +
}}
 +
 
 +
<div class="mw-translate-fuzzy">
 +
Когда пакет построен, Вы можете использовать lintian для проверки, содержит ли пакет ошибки
 +
</div>
 +
 
 +
{{Code|lang=bash|code=
 +
lintian freecad-package.deb
 +
}}
 +
 
 +
<div class="mw-translate-fuzzy">
 +
== Обновление исходного кода ==
 +
Разработка FreeCAD ведётся быстро, примерно ежедневно появляются исправления ошибок или расширение возможностей. Система cmake позволяет Вам по-умному обновить исходный код и перекомпилировать только изменения, делая последовательные компиляции очень быстрыми. Обновление исходного кода через git или subversion очень просто:
 +
</div>
 +
 
 +
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:
 +
 
 +
{{Code|lang=bash|code=
 +
cd freecad-source
 +
git pull
 
}}
 
}}
To build a package open a console, simply go to the FreeCAD directory and call
+
 
{{Code|lang=bash|code=debuild}}
+
<div class="mw-translate-fuzzy">
Once the package is built, you can use lintian to check if the package contains errors
+
Перейдите в соответствующий каталог сборки и запустите cmake снова (поскольку cmake обновит данные номера версии из меню Help, ...about FreeCAD), но вам не нужно добавить путь к исходному коду после "cmake", только пробел и точку:
 +
</div>
 +
 
 
{{Code|lang=bash|code=
 
{{Code|lang=bash|code=
#replace by the name of the package you just created
+
cd ../freecad-build
lintian your-fresh-new-freecad-package.deb}}
+
cmake .
 +
make -j$(nproc --ignore=2)
 +
}}
  
== Troubleshooting ==
+
== Разрешение проблем ==
  
=== Note for 64bit systems ===
+
<div class="mw-translate-fuzzy">
When building FreeCAD for 64-bit there is a known issue with the OpenCASCADE 64-bit package. To get FreeCAD running properly you might need to run the ./configure script with the additional define _OCC64 set:
+
=== Примечание для 64-битных систем ===
{{Code|lang=bash|code=./configure CXXFLAGS="-D_OCC64"}}
+
При компиляции 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.
+
</div>
  
== Automatic build scripts ==
+
{{Code|lang=bash|code=
Here is all what you need for a complete build of FreeCAD. It's a one-script-approach
+
./configure CXXFLAGS="-D_OCC64"
and works on a fresh installed distro. The commands will ask for root password
+
}}
(for installation of packages) and sometime to acknowledge a fingerprint for
 
an external repository server or https-subversion repository. These scripts should
 
run on 32 and 64 bit versions. They are written for different versions, but are
 
also likely to run on a later version with or without major changes.
 
  
If you have such a script for your preferred distro, please send it! We will
+
<div class="mw-translate-fuzzy">
incorporate it into this article.
+
Для систем, основанных на Debian, этот обходной путь при использовании прекомпилированных пакетов не требуется, поскольку пакет OpenCASCADE собран так, чтобы всё это было уже установлено. Теперь Вам только нужно скомпилировать FreeCAD так, как описано выше.
 +
</div>
 +
 
 +
<div class="mw-translate-fuzzy">
 +
== Скрипты автоматической компиляции ==
 +
Это всё, что Вам нужно для полной компиляции FreeCAD. Это односкриптовое решение, работающее на свежеустановленном дистрибутиве. Команда запросит пароль root
 +
(для установки пакетов) и порой для подтверждения входа на внешний сервер репозитория. Эти скрипты должны запускаться на 32- 64-битных версиях. Они написаны для разных версий, но, скорее всего, будут работать для позднейший версий с небольшими изменениями или без них.
 +
</div>
 +
 
 +
<div class="mw-translate-fuzzy">
 +
Если у Вас есть такой скрипт для Вашего любимого дистрибутива, пришлите его, пожалуйста! Мы вставим его в эту статью.
 +
</div>
  
 
<div class="mw-collapsible mw-collapsed toccolours">
 
<div class="mw-collapsible mw-collapsed toccolours">
 +
 
=== Ubuntu ===  
 
=== Ubuntu ===  
 +
 
<div class="mw-collapsible-content">
 
<div class="mw-collapsible-content">
  
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 [https://launchpad.net/~freecad-maintainers/+archive/ubuntu/freecad-daily 'daily' PPA] targets recent versions of Ubuntu, and the [https://launchpad.net/~freecad-maintainers/+archive/ubuntu/freecad-stable 'stable' PPA] targets all officially supported versions of Ubuntu.
+
<div class="mw-translate-fuzzy">
 +
Эти скрипты обеспечивают надёжный путь для установки верного набора зависимостей, требуемых для сборки и запуска FreeCAD в Ubuntu. Они используют репозитории PPA Ubuntu FreeCAD, и должны работать на любой версии Ubuntu, для которой есть целевой PPA. [https://launchpad.net/~freecad-maintainers/+archive/ubuntu/freecad-daily 'Ежедневный' PPA] нацелен на последнюю версию Ubuntu, а [https://launchpad.net/~freecad-maintainers/+archive/ubuntu/freecad-stable 'стабильный' PPA] нацелен на все официально поддерживаемые версии Ubuntu.
 +
</div>
  
This script installs dependencies for the daily development snapshot of FreeCAD.
+
<div class="mw-translate-fuzzy">
 +
Этот скрипт устанавливает зависимости для ежедневных слепков текущей разработки FreeCAD.
 +
</div>
  
 
{{Code|lang=bash|code=
 
{{Code|lang=bash|code=
 
#!/bin/sh
 
#!/bin/sh
 
sudo add-apt-repository --enable-source ppa:freecad-maintainers/freecad-daily && sudo apt-get update
 
sudo add-apt-repository --enable-source ppa:freecad-maintainers/freecad-daily && sudo apt-get update
# Install the dependencies needed to build FreeCAD
 
 
sudo apt-get build-dep freecad-daily
 
sudo apt-get build-dep freecad-daily
# Install the dependencies needed to run FreeCAD (and a build of FreeCAD itself)
 
 
sudo apt-get install freecad-daily
 
sudo apt-get install freecad-daily
 +
 +
git clone https://github.com/FreeCAD/FreeCAD.git freecad-source
 +
mkdir freecad-build
 +
cd freecad-build
 +
cmake -DBUILD_QT5=ON -DPYTHON_EXECUTABLE=/usr/bin/python3 ../freecad-source
 +
make -j$(nproc --ignore=2)
 
}}
 
}}
  
This script installs dependencies for the latest stable release of FreeCAD.
+
<div class="mw-translate-fuzzy">
(For Ubuntu 12.04, omit "--enable-source" from the add-apt-repository command.)
+
(Эти скрипты, кроме того, устанавливают сборки PPA самого FreeCAD. Вы можете деинсталлировать это, оставив зависимости. Однако оставив их установленными, менеджер пакетов будет поддерживать актуальность версий этих зависимостей, что полезно, если Вы будете следовать разработке в течение долгого времени.)
 +
</div>
 +
 
 +
<div class="mw-translate-fuzzy">
 +
Этот скрипт устанавливает зависимости для последнего стабильного выпуска FreeCAD.
 +
(Для Ubuntu 12.04, уберите "--enable-source" из команды add-apt-repository.)
 +
</div>
  
 
{{Code|lang=bash|code=
 
{{Code|lang=bash|code=
 
#!/bin/sh
 
#!/bin/sh
 
sudo add-apt-repository --enable-source ppa:freecad-maintainers/freecad-stable && sudo apt-get update
 
sudo add-apt-repository --enable-source ppa:freecad-maintainers/freecad-stable && sudo apt-get update
# Install the dependencies needed to build FreeCAD
 
 
sudo apt-get build-dep freecad
 
sudo apt-get build-dep freecad
# Install the dependencies needed to run FreeCAD (and a build of FreeCAD itself)
 
 
sudo apt-get install freecad
 
sudo apt-get install freecad
 
}}
 
}}
  
(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.)
+
Once you install the {{incode|freecad}} package from the {{incode|freecad-stable}} repository, it will supersede the FreeCAD executable that is available from the Universe Ubuntu repository. The executable will be named simply {{incode|freecad}}, and not {{incode|freecad-stable}}.
  
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.
 
 
{{Code|lang=bash|code=
 
#!/bin/sh
 
 
# checkout the latest source
 
git clone https://github.com/FreeCAD/FreeCAD.git freecad
 
 
# go to source dir
 
cd freecad
 
 
# open cmake-gui window
 
cmake-gui .
 
 
# build configuration
 
cmake .
 
 
# build FreeCAD
 
make
 
}}
 
 
</div>
 
</div>
 
</div>
 
</div>
 
 
<div class="mw-collapsible mw-collapsed toccolours">
 
<div class="mw-collapsible mw-collapsed toccolours">
  
 
=== OpenSUSE 12.2 ===
 
=== OpenSUSE 12.2 ===
 +
 
<div class="mw-collapsible-content">
 
<div class="mw-collapsible-content">
 +
 
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
 
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
 +
 
{{Code|lang=bash|code=
 
{{Code|lang=bash|code=
 
# install needed packages for development
 
# install needed packages for development
Line 476: Line 833:
 
./FreeCAD -t 0
 
./FreeCAD -t 0
 
}}
 
}}
 +
 
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
 
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
 +
 
{{Code|lang=bash|code=
 
{{Code|lang=bash|code=
 
# go into free-cad dir created earlier
 
# go into free-cad dir created earlier
Line 497: Line 856:
 
   
 
   
 
# build FreeCAD
 
# build FreeCAD
 +
# Note: to speed up build use all CPU cores: make -j$(nproc)
 
make
 
make
 
   
 
   
Line 507: Line 867:
  
 
<div class="mw-collapsible mw-collapsed toccolours">
 
<div class="mw-collapsible mw-collapsed toccolours">
 +
 
=== Debian Squeeze ===
 
=== Debian Squeeze ===
 +
 
<div class="mw-collapsible-content">
 
<div class="mw-collapsible-content">
 
{{Code|lang=bash|code=
 
{{Code|lang=bash|code=
Line 530: Line 892:
 
   
 
   
 
# build FreeCAD
 
# build FreeCAD
 +
# Note: to speed up build use all CPU cores: make -j$(nproc)
 
make
 
make
 
   
 
   
Line 539: Line 902:
 
</div>
 
</div>
 
<div class="mw-collapsible mw-collapsed toccolours">
 
<div class="mw-collapsible mw-collapsed toccolours">
=== Fedora 22/23/24 ===  
+
 
 +
=== Fedora 27/28/29 ===  
 +
 
 
<div class="mw-collapsible-content">
 
<div class="mw-collapsible-content">
 +
 
Posted by user [[http://forum.freecadweb.org/memberlist.php?mode=viewprofile&u=3666 PrzemoF]] in the forum.
 
Posted by user [[http://forum.freecadweb.org/memberlist.php?mode=viewprofile&u=3666 PrzemoF]] in the forum.
  
Line 546: Line 912:
 
#!/bin/bash
 
#!/bin/bash
  
#ARCH=x86_64
 
#ARCH=i686
 
 
ARCH=$(arch)
 
ARCH=$(arch)
  
Line 553: Line 917:
 
BUILD_DIR=build
 
BUILD_DIR=build
  
#FEDORA_VERSION=22
+
#FEDORA_VERSION=27
FEDORA_VERSION=23
+
#FEDORA_VERSION=28
#FEDORA_VERSION=24
+
FEDORA_VERSION=29
  
echo "Installing packages required to build FreeCAD"
+
PACKAGES="gcc cmake gcc-c++ boost-devel zlib-devel swig eigen3 qt-devel \
sudo dnf -y install gcc cmake gcc-c++ boost-devel zlib-devel swig eigen3 qt-devel \
 
 
shiboken shiboken-devel pyside-tools python-pyside python-pyside-devel xerces-c \
 
shiboken shiboken-devel pyside-tools python-pyside python-pyside-devel xerces-c \
 
xerces-c-devel OCE-devel smesh graphviz python-pivy python-matplotlib tbb-devel \
 
xerces-c-devel OCE-devel smesh graphviz python-pivy python-matplotlib tbb-devel \
  freeimage-devel Coin3 Coin3-devel med-devel vtk-devel
+
  freeimage-devel Coin3 Coin3-devel med-devel vtk-devel"
  
 +
FEDORA_29_PACKAGES="boost-python2 boost-python3 boost-python2-devel boost-python3-devel"
 +
 +
if [ "$FEDORA_VERSION" = "29" ]; then
 +
    PACKAGES="$PACKAGES $FEDORA_29_PACKAGES"
 +
fi
 +
 +
echo "Installing packages required to build FreeCAD"
 +
sudo dnf -y install $PACKAGES
 
cd ~
 
cd ~
 +
mkdir $MAIN_DIR <nowiki>||</nowiki> { echo "~/$MAIN_DIR already exist. Quitting.."; exit; }
 +
cd $MAIN_DIR
 +
git clone https://github.com/FreeCAD/FreeCAD.git
 +
mkdir $BUILD_DIR <nowiki>||</nowiki> { echo "~/$BUILD_DIR already exist. Quitting.."; exit; }
 +
cd $BUILD_DIR
 +
cmake ../FreeCAD
 +
make -j$(nproc)
 +
}}
 +
</div>
 +
</div>
  
mkdir $MAIN_DIR <nowiki>||</nowiki> { echo "~/$MAIN_DIR already exist. Quitting.."; exit; }
+
<div class="mw-collapsible mw-collapsed toccolours">
  
cd $MAIN_DIR
+
=== Arch using AUR ===
  
git clone https://github.com/FreeCAD/FreeCAD.git
+
<div class="mw-collapsible-content">
  
mkdir $BUILD_DIR <nowiki>||</nowiki> { echo "~/$BUILD_DIR already exist. Quitting.."; exit; }
+
[https://aur.archlinux.org/ 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.
  
cd $BUILD_DIR
+
Prerequisite : git
  
cmake ../FreeCAD && make
+
Steps :
 +
#Open a terminal. Optionally create a directory eg. {{incode | mkdir git}}. Optionally change directory eg. {{incode|cd git}}.
 +
#Clone the AUR repository : {{incode|git clone http://aur.archlinux.org/packages/freecad-git}}
 +
#Enter AUR repository folder : {{incode|cd freecad-git}}
 +
#Compile using [https://wiki.archlinux.org/index.php/Makepkg Arch makepkg] : {{incode|makepkg -s}}. The -s or --syncdeps flag  will also install required dependencies.
 +
#Install created package : {{incode|makepkg --install}} 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 {{incode|git checkout -f}} inside the folder.
  
 +
</div>
 
</div>
 
</div>
  
== Updating the source code ==
+
<div class="mw-translate-fuzzy">
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:
+
{{docnav/ru|CompileOnWindows/ru|CompileOnMac/ru}}
{{Code|lang=bash|code=
+
</div>
#Replace with the location where you cloned the source code the first time
 
cd freecad
 
#If you are using git
 
git pull
 
}}
 
  
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:
+
{{Userdocnavi/ru}}
{{Code|lang=bash|code=
 
#Replace with the location of the build directory
 
cd ../freecad-build
 
cmake .
 
make
 
}}
 
{{docnav/ru|CompileOnWindows/ru|CompileOnMac/ru}} [[Category:Developer Documentation/ru]]
 
  
<languages/>
+
[[Category:Developer Documentation/ru]]

Latest revision as of 11:17, 13 November 2019

Other languages:
български • ‎čeština • ‎Deutsch • ‎English • ‎español • ‎français • ‎italiano • ‎한국어 • ‎polski • ‎português • ‎português do Brasil • ‎română • ‎русский • ‎svenska • ‎Türkçe • ‎中文(中国大陆)‎

Сборка FreeCAD в современных дистрибутивах Линукс обычно не вызывает сложностей, поскольку все зависимости разрешаются менеджером пакетов, встроенным в дистрибутив. Сборка включает 3 этапа:

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

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

FreeCAD source compilation workflow.svg

General workflow to compile FreeCAD from source. The third party dependencies must be in the system, as well as the FreeCAD source code itself. CMake configures the system so that with a single make instruction the entire project is compiled.


Загрузка исходников

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

Git

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

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

sudo apt install git
git clone https://github.com/FreeCAD/FreeCAD.git freecad-source

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

Архив исходников

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

Разрешение зависимостей

Перед компиляцией 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.

On Debian-based systems (Debian, Ubuntu, Mint, etc.) it is quite easy to get all needed dependencies installed. Most of the libraries are available via apt or the Synaptic package manager.

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

sudo apt build-dep 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:

  • build-essential, installs the C and C++ compilers, the C development libraries, and the make program.
  • cmake, essential tool to configure the source of FreeCAD. You may also wish to install cmake-gui and cmake-curses-gui for a graphical option.
  • libtool, essential tools to produce shared libraries.
  • lsb-release, 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.

  • python3
  • swig, 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:

  • libboost-dev
  • libboost-date-time-dev
  • libboost-filesystem-dev
  • libboost-graph-dev
  • libboost-iostreams-dev
  • libboost-program-options-dev
  • libboost-python-dev
  • libboost-regex-dev
  • libboost-serialization-dev
  • libboost-signals-dev
  • libboost-thread-dev

или:

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:

  • libeigen3-dev
  • libgts-bin
  • libgts-dev
  • libkdtree++-dev
  • libmedc-dev
  • libopencv-dev or libcv-dev
  • libproj-dev
  • libvtk7-dev or libvtk6-dev
  • libx11-dev
  • libxerces-c-dev
  • libzipios++-dev

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.

  • qt4-dev-tools
  • libqt4-dev
  • libqt4-opengl-dev
  • libqtwebkit-dev
  • libshiboken-dev
  • libpyside-dev
  • pyside-tools
  • python-dev
  • python-matplotlib
  • python-pivy
  • python-ply
  • python-pyside

Python 3 and Qt5

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

  • qtbase5-dev
  • qttools5-dev
  • libqt5opengl5-dev
  • libqt5svg5-dev
  • libqt5webkit5-dev or qtwebengine5-dev
  • libqt5xmlpatterns5-dev
  • libqt5x11extras5-dev
  • libpyside2-dev
  • libshiboken2-dev
  • pyside2-tools
  • python3-dev
  • python3-matplotlib
  • python3-pivy
  • python3-ply
  • python3-pyside2.qtcore
  • python3-pyside2.qtgui
  • python3-pyside2.qtsvg
  • python3-pyside2.qtwidgets
  • python3-pyside2uic

или:

* 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.

  • libocct*-dev
    • libocct-data-exchange-dev
    • libocct-draw-dev
    • libocct-foundation-dev
    • libocct-modeling-algorithms-dev
    • libocct-modeling-data-dev
    • libocct-ocaf-dev
    • libocct-visualization-dev
  • occt-draw

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

  • liboce*-dev
    • liboce-foundation-dev
    • liboce-modeling-dev
    • liboce-ocaf-dev
    • liboce-ocaf-lite-dev
    • liboce-visualization-dev
  • oce-draw

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

sudo apt install libocct*-dev

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

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

sudo apt install cmake cmake-gui libboost-date-time-dev libboost-dev libboost-filesystem-dev libboost-graph-dev libboost-iostreams-dev libboost-program-options-dev libboost-python-dev libboost-regex-dev libboost-serialization-dev libboost-signals-dev libboost-thread-dev libcoin-dev libeigen3-dev libgts-bin libgts-dev libkdtree++-dev libmedc-dev libocct-data-exchange-dev libocct-ocaf-dev libocct-visualization-dev libopencv-dev libproj-dev libpyside2-dev libqt5opengl5-dev libqt5svg5-dev libqt5webkit5-dev libqt5x11extras5-dev libqt5xmlpatterns5-dev libshiboken2-dev libspnav-dev libvtk7-dev libx11-dev libxerces-c-dev libzipios++-dev occt-draw pyside2-tools python3-dev python3-matplotlib python3-pivy python3-ply python3-pyside2.qtcore python3-pyside2.qtgui python3-pyside2.qtsvg python3-pyside2.qtwidgets python3-pyside2uic qtbase5-dev qttools5-dev swig

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

sudo apt install cmake debhelper dh-exec dh-python libboost-date-time-dev libboost-dev libboost-filesystem-dev libboost-graph-dev libboost-iostreams-dev libboost-program-options-dev libboost-python-dev libboost-regex-dev libboost-serialization-dev libboost-signals-dev libboost-thread-dev libcoin80-dev libeigen3-dev libgts-bin libgts-dev libkdtree++-dev libmedc-dev libocct-data-exchange-dev libocct-ocaf-dev libocct-visualization-dev libopencv-dev libproj-dev libpyside-dev libqt4-dev libqt4-opengl-dev libqtwebkit-dev libshiboken-dev libspnav-dev libvtk6-dev libx11-dev libxerces-c-dev libzipios++-dev lsb-release occt-draw pyside-tools python-dev python-matplotlib python-pivy python-ply swig

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

Easiest way to check which packages are needed to compile FreeCAD is to check via portage:

emerge -pv freecad

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

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

<tt>layman -a waebbl

openSUSE

Tumbleweed

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

zypper in --no-recommends -t pattern devel_C_C++ devel_qt5

zypper in libqt5-qtbase-devel libqt5-qtsvg-devel libqt5-qttools-devel boost-devel swig libboost_program_options-devel libboost_mpi_python3-devel libboost_system-devel libboost_program_options-devel libboost_regex-devel libboost_python3-devel libboost_thread-devel libboost_system-devel libboost_headers-devel libboost_graph-devel python3 python3-devel python3-matplotlib python3-matplotlib-qt5 python3-pyside2 python3-pyside2-devel python3-pivy gcc gcc-fortran cmake occt-devel libXi-devel opencv-devel libxerces-c-devel Coin-devel SoQt-devel freetype2-devel eigen3-devel libode6 vtk-devel libmed-devel hdf5-openmpi-devel openmpi2-devel netgen-devel freeglut-devel libspnav-devel f2c doxygen dos2unix glew-devel

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

zypper in libqt5-creator gdb

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
sudo pacman -S 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 cmake eigen git gcc-fortran pyside2-tools swig qt5-tools shared-mime-info coin python-pivy med

Старые и нетрадиционные дистрибутивы

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

On other distributions, we have very few feedback from users, so it might be harder to find the required packages.

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 name, but also libname, name-dev, name-devel, 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 -dbg, -dbgsym, -debuginfo 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, freecad-build, distinct from your FreeCAD source folder, freecad-source; then from this build directory point cmake to the right source folder. You can use cmake-gui or ccmake instead of cmake in the instructions below as well. Once cmake finishes configuring the environment, use make to start the actual compilation.

mkdir freecad-build
cd freecad-build
cmake ../freecad-source
make -j$(nproc --ignore=2)

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

Сборка внутри древа исходников

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

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

cd freecad-source
cmake .
make -j$(nproc --ignore=2)

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

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

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

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
git clean -df
git reset --hard HEAD

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

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

Конфигурация

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

cmake -D <var>:<type>=<value> $SOURCE_DIR

Where $SOURCE_DIR is the directory that contains the source code. The <type> may be omitted in most cases. The space after the -D option may also be omitted.

For example, to avoid building the FEM Workbench:

cmake -D BUILD_FEM:BOOL=OFF ../freecad-source
cmake -DBUILD_FEM=OFF ../freecad-source

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


# ==============================================================================
# =================   All the options for the build process    =================
# ==============================================================================

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 cmake -LH to list the current configuration, and thus all variables that can be changed. You may also install and use cmake-gui 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 Debug build to troubleshoot crashes in FreeCAD. Beware that with this build the Sketcher becomes very slow with complex sketches.

cmake -DCMAKE_BUILD_TYPE=Debug ../freecad-source
Для версии Release

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

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

cmake -DCMAKE_BUILD_TYPE=Release ../freecad-source

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.

cmake -DBUILD_QT5=ON -DPYTHON_EXECUTABLE=/usr/bin/python3 ../freecad-source

Сборка для конкретной версии Python

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

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

cmake -DPYTHON_EXECUTABLE=/usr/bin/python3 ../freecad-source

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

cmake -DPYTHON_EXECUTABLE=/usr/bin/python3.6 \
    -DPYTHON_INCLUDE_DIR=/usr/include/python3.6m \
    -DPYTHON_LIBRARY=/usr/lib/x86_64-linux-gnu/libpython3.6m.so \
    -DPYTHON_PACKAGES_PATH=/usr/lib/python3.6/site-packages/ \
    ../freecad-source

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

locate python3.6

You may use python3 -m site in a terminal to determine the site-packages directory, or dist-packages 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 Projects → Manage Kits → Kits → Default (or your kit) → CMake Configuration. Again, specify the correct paths and Python version that you want to use.

PYTHON_EXECUTABLE=/usr/bin/python3.7
PYTHON_INCLUDE_DIR=/usr/include/python3.7m
PYTHON_LIBRARY=/usr/lib/x86_64-linux-gnu/libpython3.7m.so
PYTHON_PACKAGES_PATH=/usr/lib/python3.7/site-packages
BUILD_QT5=ON

Go to Projects → Run → Run Configuration and choose FreeCADMain to compile the graphical version of FreeCAD, or FreeCADMainCMD 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 qmake with the indicated project file to create a Makefile; then run make to compile the plugin.

cd freecad-source/src/Tools/plugins/widget
qmake plugin.pro
make

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

cd freecad-source/src/Tools/plugins/widget
$QT_DIR/bin/qmake plugin.pro
make

where $QT_DIR is the directory that stores Qt binary libraries, for example, /usr/lib/x86_64-linux-gnu/qt5.

The library created is libFreeCAD_widgets.so, which needs to be copied to $QT_DIR/plugins/designer.

sudo cp libFreeCAD_widgets.so $QT_DIR/plugins/designer

Внешний или встроенный Pivy

Если вы хотите использовать системную копию Pivy, что обычно и происходит для Linux-систем, установите флаг компилятора для использования правильного pivy с <tt> -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.

Создание пакета debian

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

sudo apt install dh-make devscripts lintian

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

debuild

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

lintian freecad-package.deb

Обновление исходного кода

Разработка 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:

cd freecad-source
git pull

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

cd ../freecad-build
cmake .
make -j$(nproc --ignore=2)

Разрешение проблем

Примечание для 64-битных систем

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

./configure CXXFLAGS="-D_OCC64"

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

Скрипты автоматической компиляции

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

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

Ubuntu

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

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

#!/bin/sh
sudo add-apt-repository --enable-source ppa:freecad-maintainers/freecad-daily && sudo apt-get update
sudo apt-get build-dep freecad-daily
sudo apt-get install freecad-daily

git clone https://github.com/FreeCAD/FreeCAD.git freecad-source
mkdir freecad-build
cd freecad-build
cmake -DBUILD_QT5=ON -DPYTHON_EXECUTABLE=/usr/bin/python3 ../freecad-source
make -j$(nproc --ignore=2)

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

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

#!/bin/sh
sudo add-apt-repository --enable-source ppa:freecad-maintainers/freecad-stable && sudo apt-get update
sudo apt-get build-dep freecad
sudo apt-get install freecad

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

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

# install needed packages for development
sudo zypper install gcc cmake OpenCASCADE-devel libXerces-c-devel \
python-devel libqt4-devel python-qt4 Coin-devel SoQt-devel boost-devel \
libode-devel libQtWebKit-devel libeigen3-devel gcc-fortran git swig
 
# create new dir, and go into it
mkdir FreeCAD-Compiled 
cd FreeCAD-Compiled
 
# get the source
git clone https://github.com/FreeCAD/FreeCAD.git free-cad
 
# Now you will have subfolder in this location called free-cad. It contains the source
 
# make another dir for compilation, and go into it
mkdir FreeCAD-Build1
cd FreeCAD-Build1 
 
# build configuration 
cmake ../free-cad
 
# build FreeCAD
make
 
# test FreeCAD
cd bin
./FreeCAD -t 0

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

# go into free-cad dir created earlier
cd free-cad
 
# pull
git pull
 
# get back to previous dir
cd ..
 
# Now repeat last few steps from before.
 
# make another dir for compilation, and go into it
mkdir FreeCAD-Build2
cd FreeCAD-Build2
 
# build configuration 
cmake ../free-cad
 
# build FreeCAD
# Note: to speed up build use all CPU cores: make -j$(nproc)
make
 
# test FreeCAD
cd bin
./FreeCAD -t 0

Debian Squeeze

# get the needed tools and libs
sudo apt-get install build-essential python libcoin60-dev libsoqt4-dev \
libxerces-c2-dev libboost-dev libboost-date-time-dev libboost-filesystem-dev \
libboost-graph-dev libboost-iostreams-dev libboost-program-options-dev \
libboost-serialization-dev libboost-signals-dev libboost-regex-dev \
libqt4-dev qt4-dev-tools python2.5-dev \
libsimage-dev libopencascade-dev \
libsoqt4-dev libode-dev subversion cmake libeigen2-dev python-pivy \
libtool autotools-dev automake gfortran
 
# checkout the latest source
git clone https://github.com/FreeCAD/FreeCAD.git freecad
 
# go to source dir
cd freecad
 
# build configuration 
cmake .
 
# build FreeCAD
# Note: to speed up build use all CPU cores: make -j$(nproc)
make
 
# test FreeCAD
cd bin
./FreeCAD -t 0

Fedora 27/28/29

Posted by user [PrzemoF] in the forum.

#!/bin/bash

ARCH=$(arch)

MAIN_DIR=FreeCAD
BUILD_DIR=build

#FEDORA_VERSION=27
#FEDORA_VERSION=28
FEDORA_VERSION=29

PACKAGES="gcc cmake gcc-c++ boost-devel zlib-devel swig eigen3 qt-devel \
shiboken shiboken-devel pyside-tools python-pyside python-pyside-devel xerces-c \
xerces-c-devel OCE-devel smesh graphviz python-pivy python-matplotlib tbb-devel \
 freeimage-devel Coin3 Coin3-devel med-devel vtk-devel"

FEDORA_29_PACKAGES="boost-python2 boost-python3 boost-python2-devel boost-python3-devel"

if [ "$FEDORA_VERSION" = "29" ]; then
    PACKAGES="$PACKAGES $FEDORA_29_PACKAGES"
fi

echo "Installing packages required to build FreeCAD"
sudo dnf -y install $PACKAGES
cd ~
mkdir $MAIN_DIR || { echo "~/$MAIN_DIR already exist. Quitting.."; exit; }
cd $MAIN_DIR
git clone https://github.com/FreeCAD/FreeCAD.git
mkdir $BUILD_DIR || { echo "~/$BUILD_DIR already exist. Quitting.."; exit; }
cd $BUILD_DIR
cmake ../FreeCAD 
make -j$(nproc)

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. mkdir git. Optionally change directory eg. cd git.
  2. Clone the AUR repository : git clone http://aur.archlinux.org/packages/freecad-git
  3. Enter AUR repository folder : cd freecad-git
  4. Compile using Arch makepkg : makepkg -s. The -s or --syncdeps flag will also install required dependencies.
  5. Install created package : makepkg --install 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 git checkout -f inside the folder.