CompileOnUnix/ru

From FreeCAD Documentation
Jump to: navigation, search
This page is a translated version of the page CompileOnUnix and the translation is 95% complete.

Outdated translations are marked like this.
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".

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

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

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

Git

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

git clone https://github.com/FreeCAD/FreeCAD.git freecad-code

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

GitHub

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

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

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

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

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

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

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

Debian и Ubuntu

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

  • 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

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

Обратите внимание, что t liboce*-dev включает следующие библиотеки:

  • liboce-foundation-dev
  • liboce-modeling-dev
  • liboce-ocaf-dev
  • liboce-visualization-dev
  • liboce-ocaf-lite-dev

Вам может понадобиться установить эти пакеты по одному.

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

  • libsimage-dev (to make Coin to support additional image file formats)
  • checkinstall (to register your installed files into your system's package manager, so yo can easily uninstall later)
  • python-pivy (needed for the 2D Drafting module)
  • python-qt4 (needed for the 2D Drafting module)
  • doxygen and libcoin60-doc (if you intend to generate source code documentation)
  • libspnav-dev (for 3Dconnexion devices support like the Space Navigator or Space Pilot)


sudo apt install build-essential cmake python python-matplotlib libtool libcoin80-dev 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 libeigen3-dev libqtwebkit-dev libshiboken-dev libpyside-dev libode-dev swig libzipios++-dev libfreetype6-dev liboce-foundation-dev liboce-modeling-dev liboce-ocaf-dev liboce-visualization-dev liboce-ocaf-lite-dev libsimage-dev checkinstall python-pivy python-qt4 doxygen libspnav-dev oce-draw liboce-foundation-dev liboce-modeling-dev liboce-ocaf-dev liboce-ocaf-lite-dev liboce-visualization-dev libmedc-dev libvtk6-dev libproj-dev

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

Fedora

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

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

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

  • soqt-devel
  • freetype
  • freetype-devel

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

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

Gentoo

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

emerge -pv freecad

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

OpenSUSE

Вам потребуются следующие пакеты:

  • gcc
  • cmake
  • OpenCASCADE-devel
  • libXerces-c-devel
  • python-devel
  • libqt4-devel
  • libshiboken-devel
  • python-pyside-devel
  • python-pyside-tools
  • Coin-devel
  • SoQt-devel
  • boost-devel
  • libode-devel
  • libQtWebKit-devel
  • libeigen3-devel
  • gcc-fortran
  • freetype2
  • freetype2-devel
  • Eigen3
  • swig

Для стабильного FreeCAD 0.14 и нестабильного 0.15, если библиотеки Eigen3 и swig не найдены в стандартных репозиториях, Вы можете получить их установкой в один клик здесь:

Заметьте так же, что библиотека Eigen3 из Factory Education иногда вызывает проблемы, так что используйте её из репозитория KDE 4.8 Extra

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

Arch Linux

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

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

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

  • python2-pyside-tools
  • med (Modelisation et Echanges de Donnees)
sudo pacman -S boost-libs curl hicolor-icon-theme libspnav opencascade python2-pivy python2-matplotlib python2-pyside python2-shiboken qtwebkit shared-mime-info xerces-c boost cmake coin desktop-file-utils eigen gcc-fortran med python2-pyside-tools

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

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

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

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

Pivy

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

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

Компиляция FreeCAD

Использование cMake

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

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

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

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

$ cd freecad (the folder where you cloned the freecad source)

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

Для версии Debug
$ cmake -DFREECAD_USE_EXTERNAL_PIVY=1 -DCMAKE_BUILD_TYPE=Debug .
# Note: to speed up build use all CPU cores: make -j$(nproc)
$ make
Или для версии Release
$ cmake -DFREECAD_USE_EXTERNAL_PIVY=1 -DCMAKE_BUILD_TYPE=Release .
# Note: to speed up build use all CPU cores: make -j$(nproc)
$ make

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

$ ./bin/FreeCAD

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

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

1) delete everything in your source base directory EXCEPT the hidden .git folder
2) In terminal 'git reset --hard HEAD'
//any remnants of an 'in source' build will be gone.
3) delete everything from your 'out of source' build directory and start over again with cmake and a full new clean build.

Компиляций вне исходников

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

mkdir freecad-build
cd freecad-build
cmake ../freecad-code (or whatever the path is to your FreeCAD source folder)
# Note: to speed up build use all CPU cores: make -j$(nproc)
make

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

Конфигурационные опции

Имеется несколько экспериментальных или незавершённых модулей, которые Вы можете захотеть скомпилировать, если Вы хотите работать с ними. Для этого Вам нужно установить соответствующие опции на стадии конфигурации. Сделайте это либо в командной строке, задав cMake опции -D <var>:<type>=<value>, или используя доступную оболочку с экранным интерфейсом (для Debian это пакеты cmake-qt-gui или cmake-curses-gui). Изменение опций cmake относительно значений по умолчанию гораздо проще с помощью cmake-gui или иного графического приложения, чем с помощью командной строки cmake, поскольку Вы получаете интерактивную обратную связь.

Например, чтобы сконфигурировать FreeCAD с модулем Assembly просто отметьте бокс в cmake-gui или в командной строке:

cmake -D FREECAD_BUILD_ASSEMBLY:BOOL=ON ''path-to-freecad-root''

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

Плагин к Qt designer

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

freecad/src/Tools/plugins/widget

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

qmake plugin.pro

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

make

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

Doxygen

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

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

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

dh-make
devscripts

#optional, used for checking if packages are standard-compliant
lintian

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

debuild

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

#replace by the name of the package you just created
lintian your-fresh-new-freecad-package.deb

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

Примечание для 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
# Install the dependencies needed to build FreeCAD
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

Этот скрипт устанавливает зависимости для последнего стабильного выпуска 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
# Install the dependencies needed to build 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

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

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

#!/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
# Note: to speed up build use all CPU cores: make -j$(nproc)
make

OpenSUSE 12.2

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

Posted by user [PrzemoF] in the forum.

#!/bin/bash

#ARCH=x86_64
#ARCH=i686
ARCH=$(arch)

MAIN_DIR=FreeCAD
BUILD_DIR=build

#FEDORA_VERSION=22
FEDORA_VERSION=23
#FEDORA_VERSION=24

echo "Installing packages required to build FreeCAD"
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 \
xerces-c-devel OCE-devel smesh graphviz python-pivy python-matplotlib tbb-devel \
 freeimage-devel Coin3 Coin3-devel med-devel vtk-devel

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 

# Note: to speed up build use all CPU cores: make -j$(nproc)
make

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

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

#Replace with the location where you cloned the source code the first time
cd freecad-code
#If you are using git
git pull

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

#Replace with the location of the build directory
cd ../freecad-build
cmake .
# to use all cpu cores change to: make -j$(nproc)
make

Ссылки

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