Compile on Linux/ru

Обзор
В последних дистрибутивах Linux, FreeCAD, как правило, собирается легко, поскольку все зависимости обычно предоставляются менеджером пакетов. В основном сборка включает 3 этапа:
 * 1) Получение исходного кода FreeCAD.
 * 2) Получение зависимостей, или пакетов, от которых зависит FreeCAD
 * 3) Настройка с помощью  и компиляция с помощью.

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



Git
Лучший способ получить код это клонировать Git репозиторий Git только-для-чтения. Для этого вам потребуется программа, которую легко установить в большинство дистрибутивов Linux. Скачать её можно на официальном веб-сайте.

Git может быть установлен, следующей командой:

Следующая команда, копирует последнюю версию исходного кода FreeCAD в папку.

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

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

Установка зависимостей (Dependencies)
Для компиляции FreeCAD необходимо установить требуемые зависимости (dependencies), упомянутые в сторонних библиотеках; пакеты, содержащие эти зависимости для различных дистрибутивов Linux, перечислены ниже. Обратите внимание, что имена и доступность библиотек будут зависеть от вашего конкретного дистрибутива; если ваш дистрибутив устарел, некоторые пакеты могут быть недоступны или иметь другое имя. В этом случае посмотрите раздел ↓ старые и нестандартные дистрибутивы расположенный ниже.

Как только у вас будут установлены все зависимости, приступайте к сборке FreeCAD.

Обратите внимание, что размер исходного кода FreeCAD составляет около 500 МБ; он может быть в три раза больше, если вы клонируете репозиторий Git со всей историей его изменений. Для получения всех зависимостей может потребоваться загрузка 500 МБ или более новых файлов; при распаковке этих файлов может потребоваться 1500 МБ или более места. Также имейте в виду, что в процессе компиляции может быть создано до 1500 МБ дополнительных файлов, поскольку система копирует и изменяет весь исходный код. Поэтому при попытке компиляции убедитесь, что на вашем жестком диске достаточно свободного места, по крайней мере, не менее 4 ГБ.

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

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

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

Эти пакеты необходимы для успешной компиляции в целом:
 * , устанавливает компиляторы C и C++, библиотеки разработки C и утилиту.
 * , необходимый инструмент для настройки исходников FreeCAD. Вы также можете установить и  чтобы иметь графический интерфейс для данной утилиты.
 * , необходимые инструменты для создания shared библиотек.
 * , стандартная утилита базовой отчетности обычно уже установлена в системе Debian и позволяет программно различать чистую установку Debian или ее вариант, такой как Ubuntu или Linux Mint. Не удаляйте этот пакет, так как от него могут зависеть многие другие системные пакеты.

При компиляции FreeCAD используется язык Python, и он также используется в runtime в качестве языка сценариев. Если вы используете дистрибутив на основе Debian, интерпретатор Python как правило уже установлен в нем.
 * , это инструмент, который создает интерфейсы между кодом C++ и Python.
 * , это инструмент, который создает интерфейсы между кодом C++ и Python.

Пожалуйста, убедитесь, что у вас установлен Python 3. Python 2 устарел в 2019 году, свежая разработка FreeCAD не тестируется с этой версией языка.

Boost библиотеки должны быть обязательно установлены:



Должны быть установлены Coin библиотеки:
 * , для Debian Jessie, Stretch, Ubuntu с 16.04 до 18.10, или
 * , для Debian Buster, Ubuntu 19.04 и выше, а так же Ubuntu 18.04/18.10 вместе с freecad-stable/freecad-daily PPAs должны быть добавлены в иходники.

Несколько библиотек, которые занимаются вычислениями, триангулированными поверхностями, сортировкой, мешами (meshes), компьютерным зрением, картографическими проекциями, 3D-визуализацией, оконной системой X11, парсингом XML и чтением Zip-файлов:


 * or
 * or
 * or
 * or
 * or
 * or
 * or
 * or

Python 2 и Qt4
Python 2 и Qt4 уже устарели и не рекомендуются к применению. Начиная с версии 0.20, в FreeCAD они больше не поддерживаются.

При компиляции FreeCAD в Debian Jessie, Stretch, Ubuntu 16.04, используйте Python 2 и Qt4, установив следующие зависимости:



Python 3 и Qt5
При компиляции FreeCAD в Debian Buster, Ubuntu 19.04 и выше, а также Ubuntu 18.04/18.10 с freecad-stable/freecad-daily PPAs добавленным в ваш исходный код, установите следующие зависимости.


 * (if compiling 0.20 on a machine that still has Qt4)
 * (if compiling 0.20 on a machine that still has Qt4)
 * (if compiling 0.20 on a machine that still has Qt4)

Ядро OpenCascade
Ядро OpenCascade - это основная графическая библиотека для создания 3D-фигур. Она существует в виде официальной версии OCCT и виде версии для сообщества OCE. Версия для сообщества к применению больше не рекомендуется, так как она устарела.

Для Debian Buster и Ubuntu 18.10 и выше, а так же для Ubuntu 18.04 с freecad-stable/freecad-daily PPAs добавлеными в ваши исходники, установите официальные пакеты.



Для Debian Jessie, Stretch, Ubuntu 16.04 и выше, установите community edition пакеты.



Вы можете установить библиотеки по отдельности или сразу несколько с похожим именами используя символ звездочку '*'. Замените на  если вы хотите установить community редакцию библиотек.

Необязательные к установке пакеты
При желании вы также можете установить эти дополнительные пакеты:
 * , чтобы Coin поддерживал дополнительные форматы файлов изображений.
 * и (или  для старых систем), если вы хотите автоматический генерировать документацию к исходному коду.
 * , для поддержки устройств 3D ввода, таких как 3Dconnexion "Space Navigator" или "Space Pilot".
 * , если вы хотите зарегистрировать установленные файлы в диспетчере пакетов вашей системы, чтобы вы могли удалить их позже.

Устаовка Python 3 и Qt5 одной командой
Требуется, чтобы Pyside2 был доступен в Debian buster и freecad-stable/freecad-daily PPAs.

ПРИМЕЧАНИЕ: В некоторых версиях Ubuntu и некоторых версиях Qt вы получите сообщение об ошибке, что python3-pyside2uic не может быть найден-в этих системах вы можете безопасно опустить его. В Ubuntu 20.04 вам нужно будет добавить. Более подробную информацию можно найти в это обсуждение на форуме.

Установка Python 2 и Qt4 одной коммандой
Это не рекомендуется для более новых установок, поскольку и Python 2 и Qt4 являются устаревшими.

Пользователи Ubuntu 16.04, пожалуйста, ознакомьтесь также с обсуждением компиляции на форуме: Компиляция в Linux (Kubuntu): CMake не может найти VTK.

Raspberry Pi
Выполните те же действия, что и в Debian и Ubuntu.

Сообщалось о проблемах при попытке компиляции в Raspbian с Python 3 и Qt5, но комбинация Python 3 и Qt4, похоже, работает для более старых версий FreeCAD.

Для более новых версий FreeCAD компиляция с Py3/Qt5 проходит успешно, если установлена операционная система Ubuntu 20.04.

Из-за различных проблем с Qt в этой версии обычные PySide tools не будут найдены.

В этом случае мы можем установить пакеты из PyQt и создать символические ссылки на необходимые инструменты.

Теперь компиляция может быть продолжена.

Параметр для  не должен превышать 3, поскольку Raspberry Pi имеет ограниченную память. На компиляцию уйдет несколько часов, поэтому лучше сделать это за ночь.

Дополнительная информация, FreeCAD и Raspberry Pi 4.

Fedora
There is a bug in cmake distributed by Fedora 34/35 which results in cmake failing to find the opencascade libraries. This can easily be fixed by making one minor change to the top level cmake file of opencascade installed on Fedora. Details here: https://bugzilla.redhat.com/show_bug.cgi?id=2083568.

Near the top of the file, change the following line to use. This fixes a bug introduced by the use of a symlink from to  of Fedora, which causes cmake to fail.

This file is usually installed in.

change this to:

This trivial change needs to be made inside the build directory once cmake has been run and failed. Re-running cmake will then correctly detect the OCCT libraries in the normal way.

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


 * gcc-c++ (or possibly another C++ compiler?)
 * cmake
 * doxygen
 * swig
 * gettext
 * dos2unix
 * desktop-file-utils
 * libXmu-devel
 * freeimage-devel
 * mesa-libGLU-devel
 * opencascade-devel
 * openmpi-devel
 * python3
 * python3-devel
 * python3-pyside2
 * python3-pyside2-devel
 * pyside2-tools
 * boost-devel
 * tbb-devel
 * eigen3-devel
 * qt-devel
 * qt5-qtwebengine-devel
 * qt5-qtxmlpatterns
 * qt5-qtxmlpatterns-devel
 * qt5-qtsvg-devel
 * qt5-qttools-static
 * ode-devel
 * xerces-c
 * xerces-c-devel
 * opencv-devel
 * smesh-devel
 * Coin3
 * Coin3-devel

(Не перепутайте "Coin" с "coin" - тот что с маленькой буквы это финансовый пакет. Апрельские Coin4 и Coin4-devel 2021 уже доступны) (если coin2 является последней доступной версией для вашей версии Fedora, используйте пакеты из http://www.zultron.com/rpm-repo/)


 * SoQt-devel
 * freetype
 * freetype-devel
 * vtk
 * vtk-devel
 * med
 * med-devel

Можете добавить, если требуется:


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

To install all dependencies at once (tested on fedora 36):

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

emerge -pv freecad

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

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

layman -a waebbl

Tumbleweed
Следующие команды установят пакеты, необходимые для создания FreeCAD с Qt5 и Python 3.

Следующая команда установит Qt Creator и отладчик проекта GNU.

Если какие-либо пакеты отсутствуют, вы можете проверить Tumbleweed "FreeCAD.spec" файл на  Откройте Службу сборки.

Также, проверьте, есть ли какие-либо исправления, которые вам необходимо использовать (например 0001-find-openmpi2-include-files.patch).

Leap
Если есть разница между доступными пакетами на Tumbleweed и Leap, то вы можете прочитать Leap файл "FreeCAD.spec" на  Откройте службу сборки, чтобы определить необходимые пакеты.

Смотрите piano_jonas unofficial "Compile On openSUSE" guide.

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


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

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

Сначала попробуйте найти необходимые библиотеки, упомянутые в сторонние библиотеки в диспетчере пакетов. Остерегайтесь, что у некоторых из них может быть немного другое имя пакета; ищите, но также , , и аналогичные. Если это невозможно, попробуйте скомпилировать эти библиотеки самостоятельно.

Для FreeCAD требуется версия компилятора GNU g++, равная или выше 3.0.0, так как FreeCAD в основном написан на C++. Во время компиляции выполняются некоторые сценарии Python, поэтому интерпретатор Python должен работать должным образом. Чтобы избежать каких-либо проблем с компоновщиком, также рекомендуется иметь пути к библиотеке в переменной или в файле. Это уже сделано в современных дистрибутивах Linux, но, возможно, потребуется установить в более старых.

Pivy
Pivy (обертки Python для Coin3d) не требуется для сборки FreeCAD или его запуска, но необходимы в качестве зависимости от среды выполнения для Draft Workbench. Если вы не собираетесь использовать эти инструментальные средства, вам не понадобится Pivy. Однако обратите внимание, что верстак Draft используется внутри других рабочих столов, таких как Arch и BIM, поэтому для использования этих инструментальных средств также необходимо установить Pivy.

К ноябрю 2015 года устаревшая версия Pivy, включенная в исходный код FreeCAD, больше не будет компилироваться во многих системах. Это не большая проблема, так как обычно вы должны получить Pivy от менеджера пакетов вашего дистрибутива; если вы не можете найти Pivy, вам, возможно, придется скомпилировать его самостоятельно, см. Инструкции по компиляции Pivy.

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

Для Ubuntu вам, возможно, потребуется включить специальные репозитории, чтобы иметь возможность просматривать и устанавливать эти отладочные пакеты с помощью диспетчера пакетов. См.Debug Symbol Packages для получения дополнительной информации.

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


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

Поскольку FreeCAD - это крупное приложение, компиляция всего исходного кода может занять от 10 минут до одного часа, в зависимости от вашего процессора и количества ядер процессора, используемых для компиляции.

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

Сборка вне папки исходников
Создание в отдельной папке удобнее, чем создание в том же каталоге, где находится исходный код, поскольку каждый раз, когда вы обновляете исходный код, CMake может разумно определить, какие файлы изменились, и перекомпилировались только то, что необходимо. Это очень полезно при тестировании различных ветвей Git, так как вы не путаете систему сборки.

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

Примечание: если вы компилируете ветвь выпуска 0.19, вы должны конкретно указать, что вы компилируете с Qt5 и Python 3 -- замените команду CMake выше на:

Опция  определяет, сколько задач (файлов) компилируется параллельно. Программа выводит количество ядер процессора в вашей системе; используя ее вместе с опцией, вы можете обработать столько файлов, сколько у вас ядер, чтобы ускорить общую компиляцию программы. В приведенном выше примере он будет использовать все ядра вашей системы, кроме двух; это позволит вашему компьютеру реагировать на другие виды использования, пока компиляция выполняется в фоновом режиме. Исполняемый файл FreeCAD в конечном итоге появится в каталоге. См. также Compiling (speeding up) для повышения скорости компиляции.

Resolving cmake issues
If you have done an out-of-source build before and get stuck on a dependency that is not recognized or can't seem to be resolved, try the following:


 * Delete the contents of the build directory before running cmake again. FreeCAD is a rapidly moving target, you may be tripping over cached cmake information that points at an older version than the new repository head can use. Clearing the cache may allow cmake to recover and recognize the version you actually need.


 * If cmake complains about missing a specific file, use a tool such as "apt-file search", or its equivalent in other package systems, to discover what package that file belongs to and install it. Bear in mind that you are likely to need the -dev version of the package that carries header or config files files required for FreeCAD to use the package.

Compiling against GNU libc 2.34 and later
GNU libc 2.34 introduces a change to the library that can cause builds on some Linux systems to fail with an error like:

To resolve this, a symbolic link must be manually created from the (now empty) system-installed libdl.so.* to the location your compiler says it is looking for the file. For example (if the actual installed copy of libdl.so on your system is /usr/lib/x86_64-linux-gnu/libdl.so.2):

Adapt the command for the structure of your system by searching for libdl.so* and linking it to the appropriate location.

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

Перейдите в исходный каталог и укажите на текущий каталог (обозначенный одной точкой):

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

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

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

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

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

Где - каталог, содержащий исходный код. в большинстве случаев может быть опущен. Пробел после параметра также может быть опущен.

Например, чтобы избежать создания FEM Workbench:

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


 * 1) =================   All the options for the build process    =================
 * 1) =================   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) ...

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

Для Debug сборки
Создайте сборку для устранения неполадок в FreeCAD. Имейте в виду, что при такой сборке Sketcher становится очень медленным при работе со сложными эскизами.

Для Release сборки
Создайте сборку для тестирования кода, который не завершается сбоем. Сборка будет выполняться намного быстрее, чем сборка.

Сборка на основе Python 3 и Qt5
По умолчанию FreeCAD 0.19 и более ранние версии созданы для Python 2 и Qt4. Поскольку эти два пакета устарели, лучше создавать для Python 3 и Qt5. Поддержка Python 2 и Qt4 была удалена в FreeCAD 0.20, и нет необходимости явно включать Qt5 и Python 3 при компиляции последних версий разработки.

В современном дистрибутиве Linux вам нужно указать только две переменные, указывающие использование Qt5, и путь к интерпретатору Python.

Для 0.19:

Для 0.20_dev:

Обратите внимание, что при переключении между сборками 0.19 и 0.20 может потребоваться удалить CMakeCache.txt до запуска cmake.

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

Если это не сработает, вам, возможно, придется определить дополнительные переменные, указывающие на требуемые библиотеки Python, и включить каталоги:

В одной системе, возможно, имеет несколько независимых версий Python, поэтому расположение и номера версий ваших файлов Python будут зависеть от вашего конкретного дистрибутива Linux. Используйте для отображения версии Python, которую вы используете в настоящее время; необходимы только первые два числа; например, если результатом является, вам необходимо указать каталоги, относящиеся к версии 3.6. Если вы не знаете нужных каталогов, попробуйте выполнить их поиск с помощью команды.

Вы можете использовать в терминале для определения каталога  или  для систем Debian.

Some components of FreeCAD, such as PySide, try to autodetect the most recent Python version installed on your system, which might fail if it is different from what you entered above. Adding the following cMake option might solve the issue:

Сборка в Qt Creator на основе Python 3 и Qt5
1. Запустите Qt Creator.

2. Кликните на.

3. Перейдите в каталог, в котором находится исходный код,, и выберите самый верхний файл.

4. Выбрав файл, он автоматически запустит на нем, но может выйти из строя, если соответствующие параметры установлены неправильно.

5. Перейдите в. Установите соответствующий каталог сборки,.

6. Установите соответствующие переменные в диалоговом окне Key-Value типов и.

7. Если переменные загружают проект неправильно, возможно, вам придется перейти к. Затем нажмите, и добавьте соответствующую конфигурацию, как описано выше. Возможно, вам придется добавить дополнительные переменные о путях Python, если системный Python не найден.

7.1. Нажмите, затем.

7.2. Убедитесь, что остальные параметры заданы правильно, например, должна быть текущей версией, установленной в системе, как.

Нажмите, затем , чтобы закрыть конфигурацию.

Программа должна снова запуститься автоматически, и она должна заполнить весь диалог Key-Value всеми переменными, которые можно настроить.

8. Перейдите в и выберите  для компиляции графической версии FreeCAD или  для компиляции только версии командной строки.

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

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

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

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

где - это каталог, в котором хранятся двоичные библиотеки Qt, например,.

Созданная библиотека, которую необходимо скопировать в.

Внешний или встроенный Pivy
В прошлом, версия Pivy была включена в исходный код FreeCAD (internal). Если вы хотели использовать системную копию Pivy (external), вам нужно было использовать.

Использование внешнего Pivy стало по умолчанию во время разработки FreeCAD 0.16, поэтому эту опцию больше не нужно устанавливать вручную.

Документирование посредством Doxygen
Если у вас установлен Doxygen, вы можете создать документацию по исходному коду. См. инструкции в source documentation.

Дополнительная документация
Исходный код FreeCAD очень обширен, и с помощью CMake можно настроить множество параметров. Обучение полному использованию CMake может быть полезно для выбора правильных вариантов для ваших особых потребностей. от Kitware. (блог), предварительно изучив программирование. (блог), предварительно изучив программирование.
 * CMake Reference Documentation
 * How to Build a CMake-Based Project
 * Learn CMake's Scripting Language in 15 Minutes

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

Перейдите в папку FreeCAD и выполните

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

*.deb package with checkinstall
The Debian script allows to create a *.deb package that can be installed and removed with the standard  commands. It may need to be installed first (on Ubuntu use ). It's interactive and asks for the required information providing helpful defaults. During the process the package is installed and a *.deb file and a backup archive are created.

It's a good idea to define a name and a short description for the package. The name must be entered to uninstall it again and the desription will be listed by. The default name "build" is not very informative.

Example:

The result is a *.deb file in the freecad-build folder. will install the build by default. This is how you can install or uninstall it:

grep freecad freecad-test1_20220814-1_amd64.deb sudo dpkg -i freecad-test1_20220814-1_amd64.deb  # install dkpg -l

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

Перейдите в то место, где исходный код FreeCAD был впервые загружен, и извлеките новый код:

Затем перейдите в каталог сборки, в котором код был скомпилирован изначально, и запустите, указав текущий каталог (denoted by a dot); затем запустите повторную компиляцию с помощью.

Uninstalling the source code
In case the compiled source code was installed with (for Debian) the files were copied to the  folder into several subfolders. For uninstallation the file can be used. It has been created into the build folder during compilation and contains all installed files. As long as this file exists, the installation can be uninstalled.

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

Для систем на базе Debian эта опция не требуется при использовании готовых пакетов OpenCASCADE, поскольку эти пакеты устанавливают правильно внутри.

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

Если у вас есть такой скрипт для вашего выбранного дистрибутива, пожалуйста, обсудите его на Форум FreeCAD, чтобы мы могли его включить.

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

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

При желании вы можете удалить предварительно скомпилированную версию FreeCAD, оставив зависимости на месте, однако, если этот пакет будет установлен, менеджер пакетов также сможет обновлять свои зависимости; это наиболее полезно, если вы намерены следить за развитием FreeCAD, а также постоянно обновлять и компилировать исходные тексты из репозитория Git.

Предыдущий скрипт предполагает, что вы хотите скомпилировать последнюю версию FreeCAD, поэтому вы используете репозиторий "daily" для получения зависимостей. Однако вместо этого вы можете получить зависимости сборки "стабильной" версии для вашего текущего выпуска Ubuntu. Если это так, замените верхнюю часть предыдущего сценария следующими инструкциями. Для Ubuntu 12.04 опустите в команде.

Как только вы установите пакет из репозитория, он заменит исполняемый файл FreeCAD, доступный из репозитория Ubuntu Universe. Исполняемый файл будет называться просто, а не.

openSUSE
Никаких внешних репозиториев не требуется для компиляции FreeCAD. Однако существует несовместимость с python3-devel, которую необходимо удалить. FreeCAD может быть скомпилирован из GIT

Поскольку вы используете git, в следующий раз, когда захотите скомпилировать, вам не нужно клонировать все подряд просто извлеките из git и скомпилируйте еще раз

Fedora 27/28/29
Опубликовано пользователем [PrzemoF] на форуме.

{ echo "~/$MAIN_DIR already exist. Quitting.."; exit; } cd $MAIN_DIR git clone https://github.com/FreeCAD/FreeCAD.git mkdir $BUILD_DIR

Arch с использованием AUR
Arch User Repository (AUR) - это коллекция пользовательских рецептов для создания пакетов, которые официально не поддерживаются сопровождающими распространения / сообществом. Обычно они в безопасности. Вы можете увидеть, кто поддерживал посылку и как долго он это делал. Рекомендуется проверить общестроительные файлы. Также в этой области доступно программное обеспечение с открытым исходным кодом, даже если оно поддерживается официальной компанией-владельцем.

Обязательное требование : git

Шаги :
 * 1) Откройте терминал. При необходимости создайте каталог, например. . При необходимости измените каталог, например..
 * 2) Клонировать репозиторий AUR :
 * 3) Войдите в папку репозитория AUR :
 * 4) Компиляция с использованием Arch makepkg : . Флаг -s или --syncdeps также установит необходимые зависимости.
 * 5) Установите созданный пакет : или дважды щелкните имя файла pkgname-pkgver.pkg.tar.xz в вашем браузере файлов.

Чтобы обновить FreeCAD до последней версии, просто повторите шаг 3. Обновите репозиторий, когда в рецепте произойдет какое-либо изменение или появятся новые функции, используя внутри каталога.