Compile on Linux/de

Überblick
Auf neuesten Linux Distributionen ist FreeCAD in der Regel einfach zu erstellen, da alle Abhängigkeiten in der Regel vom Paketmanager bereitgestellt werden. Es schliesst im Wesentlichen 3 Schritte ein:
 * 1) Besorgen des FreeCAD Quellcodes
 * 2) Ermittlung der Abhängigkeiten oder Pakete, von denen FreeCAD abhängt
 * 3) Konfigurieren mit  und kompilieren mit.

Nachfolgend finden sich detaillierte Erklärungen des gesamten Prozesses, einige Bauskripte und Besonderheiten, denen man begegnen könnte. Wenn Du im folgenden Text etwas Falsches oder Veraltetes findest (Linux-Distributionen ändern sich oft), oder wenn Du eine Distribution verwendest, die nicht aufgeführt ist, diskutieren das Problem im Forum und hilf uns, es zu korrigieren.





Git
Der beste Weg, den Code zu bekommen, ist, das schreibgeschützte Git Repositorium zu klonen. Dazu benötigst du das  Programm, das in den meisten Linux Distributionen einfach installiert werden kann. Er kann auch über die offizielle Webseite bezogen werden.

Git kann mit dem folgenden Befehl installiert werden:

Der folgende Befehl legt eine Kopie der letzten Version des FreeCAD Quellcodes in einem neuen Verzeichnis namens ab.

Weitere Informationen über die Verwendung von Git und das Einbringen von Code in das Projekt siehe Quellcodeverwaltung.



Quellarchiv
Alternativ kannst du den Quellcode als, eine oder  Datei herunterladen und in das gewünschte Verzeichnis entpacken.



Erhalten der Abhängigkeiten
Um FreeCAD zu kompilieren, musst du die unter Third Party Libraries genannten Abhängigkeiten installieren; die Pakete, die diese Abhängigkeiten enthalten, sind unten für verschiedene Linux-Distributionen aufgeführt. Bitte beachte, dass die Namen und die Verfügbarkeit der Bibliotheken von eurer jeweiligen Distribution abhängen; wenn eure Distribution alt ist, können einige Pakete nicht verfügbar sein oder einen anderen Namen haben. Schaue in diesem Fall im nachfolgenden Abschnitt older and non-conventional distributions

Sobald du alle Abhängigkeiten installiert hast, gehe weiter zu kompiliere FreeCAD.

Bitte beachte, dass der Quellcode von FreeCAD ca. 500 MB groß ist; er kann dreimal so groß sein, wenn Du das Git-Repository mit seiner gesamten Änderungshistorie klonst. Das Erhalten aller Abhängigkeiten kann das Herunterladen von 500 MB oder mehr neuer Dateien erfordern; wenn diese Dateien entpackt werden, können sie 1500 MB oder mehr Speicherplatz benötigen. Beachten auch, dass der Kompilierungsprozess bis zu 1500 MB zusätzliche Dateien erzeugen kann, wenn das System den gesamten Quellcode kopiert und ändert. Stelle daher sicher, dass genügend freier Speicherplatz auf Deiner Festplatte vorhanden ist, mindestens 4 GB, wenn Du mit dem Kompilieren beginnst.



Debian und Ubuntu
Auf Debian-basierten Systemen (Debian, Ubuntu, Mint, etc.) ist es recht einfach, alle benötigten Abhängigkeiten zu installieren. Die meisten Bibliotheken sind über oder den Synaptic Package Manager verfügbar.

Wenn du FreeCAD bereits aus den offiziellen Repositories installiert hast, kannst du seine Build Abhängigkeiten mit dieser einzigen Zeile Code in einem Terminal installieren:

Wenn die Version von FreeCAD in den Repositorien jedoch alt ist, können die Abhängigkeiten die falschen sein, um eine aktuelle Version von FreeCAD zu erstellen. Bitte überprüfe daher, ob Du die folgenden Pakete installiert hast.

Diese Pakete sind unerlässlich für jede Art von Kompilierung, um erfolgreich zu sein:
 * , installiert die C- und C++-Compiler, die C-Entwicklungsbibliotheken und das Programm.
 * , ein unverzichtbares Werkzeug zur Konfiguration der Quelle von FreeCAD. Du kannst auch und  für eine grafische Option installieren.
 * , essentielle Werkzeuge zur Erstellung von gemeinsamen Bibliotheken.
 * , das Standard Basis Reporting Dienstprogramm ist normalerweise bereits in einem Debian System installiert und ermöglicht es Dir, programmgesteuert zwischen einer reinen Debian Installation und einer Variante wie Ubuntu oder Linux Mint zu unterscheiden. Entferne dieses Paket nicht, da viele andere Systempakete davon abhängen können.

Die Kompilierung von FreeCAD verwendet die Python Sprache, und sie wird auch zur Laufzeit als Skriptsprache verwendet. Wenn du eine Debian basierte Distribution verwendest, ist der Python Interpreter normalerweise bereits installiert.
 * , das Werkzeug, das Schnittstellen zwischen C++ Code und Python schafft.
 * , das Werkzeug, das Schnittstellen zwischen C++ Code und Python schafft.

Bitte überprüfe, ob Du Python 3 installiert bist. Python 2 war 2019 veraltet, so dass die Neuentwicklung in FreeCAD mit dieser Sprachversion nicht getestet wird.

Die Verstärker Bibliotheken müssen installiert sein:



Die Coin Bibliotheken müssen installiert sein:
 * , für Debian Jessie, Stretch, Ubuntu 16.04 bis 18.10, oder
 * , für Debian Buster, Ubuntu 19.04 und neuer, sowie für Ubuntu 18.04/18.10 mit dem freecad-stable/freecad-daily PPAs zu Deinen Softwarequellen hinzugefügt.

Einige Bibliotheken, die sich mit Mathematik, dreieckigen Oberflächen, Sortieren, Netzen, Computer Vision, kartographischen Projektionen, 3D Visualisierung, dem X11-Window-System, XML-Parsing und dem Lesen von Zip-Dateien befassen:


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



Python 2 und Qt4
Dies wird für neuere Installationen nicht empfohlen, da sowohl Python 2 als auch Qt4 veraltet sind. Ab der Version 0.20 werden sie von FreeCAD nicht mehr unterstützt.

Um FreeCAD für Debian Jessie, Stretch, Ubuntu 16.04 mit Python 2 und Qt4 zu kompilieren, installiere die folgenden Abhängigkeiten.





Python 3 und Qt5
Um FreeCAD für Debian Buster, Ubuntu 19.04 und neueren, sowie Ubuntu 18.04/18.10 mit dem freecad-stable/freecad-daily PPAs zu deinen Softwarequellen hinzuzufügen, installiere die folgenden Abhängigkeiten.


 * (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 Kernel
Der OpenCascade Kern ist die zentrale Grafikbibliothek zur Erstellung von 3D-Formen. Es existiert in einer offiziellen Version OCCT und einer Community-Version OCE. Die Community-Version wird nicht mehr empfohlen, da sie veraltet ist.

Für Debian Buster und Ubuntu 18.10 und neuer, sowie Ubuntu 18.04 mit dem freecad-stable/freecad-daily PPAs zu deinen Softwarequellen hinzugefügt, installiere die offiziellen Pakete.



Für Debian Jessie, Stretch, Ubuntu 16.04 und neuer, installiere die Gemeinschafts Editionspakete.



Du kannst die Bibliotheken einzeln oder mit Hilfe der Sternchen-Erweiterung installieren. Ändere für, wenn Du die Gemeinschaftsbibliotheken installieren möchtest.



Optionale Pakete
Optional können auch diese zusätzlichen Pakete installiert werden:
 * , damit Coin zusätzliche Bilddateiformate unterstützt.
 * und (oder  für ältere Systeme), wenn du beabsichtigst, Quellcode Dokumentation zu generieren.
 * , Unterstützung für 3D-Eingabegeräte, wie "Space Navigator" oder "Space Pilot" von 3Dconnexion.
 * , wenn Du vorhast, Deine installierten Dateien im Paketmanager Deines Systems zu registrieren, damit Du sie später deinstallieren kannst.
 * , für den Addon-Manager, zum nativen Darstellen von markdown-formatierten README.md-Dateien.
 * , für den Addon-Manager, um Git für das Laden und Aktualisieren von Arbeitsbereichen und Makros zu nutzen.



Einzelbefehl für Python 3 und Qt5
Erfordert Pyside2, das in Debian Buster und dem freecad-stable/freecad-daily PPAs verfügbar ist.

HINWEIS: Auf einigen Versionen von Ubuntu und einigen Versionen von Qt erhälst du eine Fehlermeldung, dass python3-pyside2uic nicht gefunden werden kann - auf diesen Systemen kannst du es getrost weglassen. Unter Ubuntu 20.04 musst du. hinzufügen. Weitere Informationen findest du in diese Forumsdiskussion.



Einziger Befehl für Python 2 und Qt4
Dies wird für neuere Installationen nicht empfohlen, da sowohl Python 2 als auch Qt4 veraltet sind.

Ubuntu 16.04 Benutzer sehen bitte auch die Kompilierungsdiskussion im Forum: Compile on Linux (Kubuntu): CMake can't find VTK.

Raspberry Pi
Folge den gleichen Schritten wie in Debian und Ubuntu.

Es wurde von Problemen berichtet, wenn man versucht, in Raspberry-PI-OS 32-bit mit Python 3 und Qt5 zu kompilieren, aber die Kombination Python 3 und Qt4 scheint für ältere Versionen von FreeCAD (mit kleineren Problemchen) zu funktionieren.

Für neuere Versionen von FreeCAD (>= 0.20) ist die Kompilierung mit Py3/Qt5 erfolgreich, wenn das installierte Betriebssystem Raspberry-Pi-OS 64-bit oder Ubuntu 20.04 ist.

Aufgrund verschiedener Probleme mit Qt werden in Ubuntu 20.04 die normalen PySide-Werkzeuge nicht gefunden.

In diesem Fall können wir die Pakete von PyQt installieren und symbolische Links zu den benötigten Werkzeugen erstellen.

Nun kann die Kompilierung fortgesetzt werden.

Die Option für  sollte nicht mehr als 3 sein, da das Raspberry Pi einen begrenzten Speicher hat. Die Kompilierung wird mehrere Stunden dauern, daher ist es besser, sie über Nacht durchzuführen.

Weitere Informationen, FreeCAD und 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.

Folgende Pakete werden benötigt:


 * 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

(April 2021, Coin4 und Coin4-devel sind verfügbar ) (wenn coin2 die neueste verfügbare Version für deine Fedora Version ist, verwende Pakete von http://www.zultron.com/rpm-repo/)


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

Und optional:


 * libspnav-devel (für die Unterstützung von 3Dconnexion Geräten wie Space Navigator oder Space Pilot)
 * python3-pivy (https://bugzilla.redhat.com/show_bug.cgi?id=458975 Pivy ist nicht zwingend erforderlich, wird aber für den Arbeitsbereich Draft benötigt)
 * python3-markdown (für den Addon-Manager, zum Anzeigen von nativem Markdown-Code)
 * python3-GitPython (für den Addon-Manager, um Git zum Auschecken und Aktualisieren von Arbeitsbereichen und Makros zu nutzen)

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

Gentoo
Der einfachste Weg, um zu überprüfen, welche Pakete für die Kompilierung von FreeCAD benötigt werden, ist die Überprüfung über Portage:

emerge -pv freecad

Dies sollte eine schöne Liste von zusätzlichen Paketen liefern, die Du auf Deinem System installieren musst.

Wenn FreeCAD auf Portage nicht verfügbar ist, ist es auf dem waebbl overlay verfügbar. Der Issue Tracker auf dem Waebbl Overlay Github kann Dir helfen, einige Probleme zu lösen, auf die Du stoßen könntest. Das Overlay bietet freecad-9999, das Du kompilieren oder einfach verwenden kannst, um die Abhängigkeiten zu erhalten.

layman -a waebbl

Tumbleweed
Die folgenden Befehle installieren die Pakete, die für die Erstellung von FreeCAD mit Qt5 und Python 3 erforderlich sind.

Der folgende Befehl installiert den Qt Creator und den GNU Project Debugger.

Wenn Pakete fehlen, dann kannst du die Datei Tumbleweed "FreeCAD.spec" auf dem Open Build Service überprüfen.

Überprüfe auch, ob es Patches gibt, die Du installieren musst (z.B.0001-find-openmpi2-include-files.patch).

Leap
Wenn es einen Unterschied zwischen den verfügbaren Paketen auf Tumbleweed und Leap gibt, dann kannst du die Leap "FreeCAD.spec" Datei auf dem Open Build Service lesen, um die benötigten Pakete zu ermitteln.

Siehe piano_jonas unofficial "Kompiliren Unter openSUSE" Leitfaden.

Arch Linux
Du benötigst die folgenden Bibliotheken aus den offiziellen Repositorien:


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

<span id="Older_and_non-conventional_distributions">

Ältere und unkonventionelle Distributionen
Bei anderen Distributionen haben wir nur sehr wenig Feedback von Benutzern, so dass es schwieriger sein könnte, die benötigten Pakete zu finden.

Versuche zuerst, die erforderlichen Bibliotheken zu finden, die in third party libraries in deinem Paketmanager erwähnt werden. Beachte, dass einige von ihnen einen etwas anderen Paketnamen haben könnten; suche nach, aber auch , , und ähnlichem. Wenn das nicht möglich ist, versuche, diese Bibliotheken selbst zu kompilieren.

FreeCAD benötigt die GNU g++ Kompiliererversion gleich oder über 3.0.0, da FreeCAD meist in C++ geschrieben ist. Während der Kompilierung werden einige Python Skripte ausgeführt, so dass der Python Interpreter ordnungsgemäß funktionieren muss. Um Probleme mit dem Linker zu vermeiden, ist es auch eine gute Idee, die Bibliothekspfade in der Variablen oder in der Datei  zu haben. Dies geschieht bereits in modernen Linux-Distributionen, muss aber möglicherweise in älteren eingestellt werden.

Pivy
Pivy (Python Wrapper zu Coin3d) wird nicht benötigt, um FreeCAD zu bauen oder zu starten, aber es wird als Laufzeitabhängigkeit von der Draft Arbeitsbereich benötigt. Wenn Du diesen Arbeitsbereich nicht benutzt, benötigst Du Pivy nicht. Beachte jedoch, dass der Entwurfs-Arbeitsbereich intern von anderen Arbeitsbereich wie Arch Arbeitsbereich und BIM Arbeitsbereich verwendet wird, so dass Pivy installiert werden muss, um diese Arbeitsbereiche ebenfalls zu verwenden.

Bis November 2015 wird die im FreeCAD-Quellcode enthaltene veraltete Version von Pivy auf vielen Systemen nicht mehr kompiliert. Dies ist kein großes Problem, da Du normalerweise Pivy über den Paketmanager Deiner Distribution beziehen solltest; wenn Du Pivy nicht finden kannst, musst Du es möglicherweise selbst kompilieren, siehe Pivy compilation instructions

<span id="Debug_symbols">

Fehlersuch Symbole
Um Abstürze in FreeCAD zu beheben, ist es sinnvoll, die Fehlersuche Symbole wichtiger Abhängigkeitsbibliotheken wie Qt zu haben. Versuche dazu, die Abhängigkeitspakete zu installieren, die mit, , oder ähnlichem enden, abhängig von Deiner Linux-Distribution.

Unter Ubuntu musst Du möglicherweise spezielle Repositorien aktivieren, um diese Fehlersuch Pakete mit dem Paketmanager sehen und installieren zu können. Siehe Fehlersuch Symbol Pakete für weitere Informationen.

<span id="Compile_FreeCAD">

Kompiliere FreeCAD
FreeCAD verwendet CMake als Hauptbuild-System, da es auf allen gängigen Betriebssystemen verfügbar ist. Die Kompilierung mit CMake ist in der Regel sehr einfach und erfolgt in zwei Schritten.


 * 1) CMake überprüft, ob alle benötigten Programme und Bibliotheken auf Ihrem System vorhanden sind und erzeugt eine, die für den zweiten Schritt konfiguriert ist. FreeCAD hat mehrere Konfigurationsoptionen zur Auswahl, aber es wird mit sinnvollen Standardeinstellungen ausgeliefert. Einige Alternativen werden im Folgenden beschrieben.
 * 2) Die Kompilierung selbst, die mit dem Programm  durchgeführt wird, das die FreeCAD-Ausführungsdateien erzeugt.

Da FreeCAD eine große Anwendung ist, kann die Kompilierung des gesamten Quellcodes je nach CPU und Anzahl der für die Kompilierung verwendeten CPU-Kerne zwischen 10 Minuten und einer Stunde dauern.

Du kannst den Code entweder in oder aus dem Quellverzeichnis erstellen. Aus dem Quelltext heraus Erstellung ist in der Regel die beste Option.

<span id="Out-of-source_build">

Aus-der-Quelle Bau
Das Erstellen in einem separaten Ordner ist bequemer als das Erstellen in demselben Verzeichnis, in dem sich der Quellcode befindet, da CMake bei jeder Aktualisierung des Quellcodes intelligent feststellen kann, welche Dateien sich geändert haben, und nur das neu kompilieren kann, was benötigt wird. Dies ist sehr nützlich, wenn Sie verschiedene Git-Zweige testen, da Sie das Build-System nicht verwirren.

Um Out-of-Source zu erstellen, erstelle einfach ein Build-Verzeichnis,, das sich von Deinem FreeCAD-Quellordner unterscheidet, ; dann von diesem Build-Verzeichnis-Punkt zum richtigen Quellordner. Du kannst oder  anstelle von  auch in den folgenden Anweisungen verwenden. Sobald die Konfiguration der Umgebung abgeschlossen hat, verwende, um die eigentliche Kompilierung zu starten.

Hinweis: Wenn du den 0.19er Release Zweig kompilierst, musst du explizit angeben, dass du mit Qt5 und Python 3 kompilierst -- ersetze den obigen cMake Befehl durch:

Die Option von  steuert, wie viele Aufträge (Dateien) parallel kompiliert werden. Das Programm druckt die Anzahl der CPU-Kerne in Deinem System; indem Du es zusammen mit der Option  verwendest, kannst Du wählen, ob Du so viele Dateien wie möglich verarbeiten möchtest, um die Gesamtübersetzung des Programms zu beschleunigen. Im obigen Beispiel verwendet es alle Kerne in Deinem System mit Ausnahme von zwei; dies hält Deinen Computer für andere Anwendungen reaktionsschnell, während die Kompilierung im Hintergrund abläuft. Die FreeCAD-Ausführdatei wird schließlich im Verzeichnis erscheinen. Siehe auch Kompilieren (Beschleunigen), um die Kompilierungsgeschwindigkeit zu verbessern.

<span id="Resolving_cmake_issues">

Behebung von cmake Problemen
Wenn du schon einmal einen Aus-der-Quelle Bau durchgeführt hast und an einer Abhängigkeit hängen bleibyt, die nicht erkannt wird oder nicht aufgelöst werden kann, versuche Folgendes:


 * Lösche die Inhalte des Bau Verzeichnisses, vor dem erneuten ausführen von cmake. FreeCAD ist ein sich schnell veränderndes Ziel, möglicherweise stolperst du über zwischengespeicherte cmake Informationen, die auf eine ältere Version verweisen, als der neue Repositoriumdkopf verwenden kann. Leeren des Zwischenspeichers, kann cmake erlauben sich zu erholen und die Version erkennen, die du tatsächlich benötigst.


 * Wenn sich cmake darüber beschwert, dass eine bestimmte Datei fehlt, verwende ein Werkzeug wie "apt-file search" oder ein entsprechendes Werkzeug in anderen Paketsystemen, um herauszufinden, zu welchem Paket diese Datei gehört und installiere sie. Denke daran, dass du wahrscheinlich die -dev-Version des Pakets benötigst, die Kopf- oder Konfigurationsdateien enthält, die FreeCAD benötigt, um das Paket zu verwenden.

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.

<span id="In-source_building">

Im Quellcode Bau
In-source builds sind in Ordnung, wenn du eine Version von FreeCAD schnell kompilieren möchtest und nicht vorhast, den Quellcode häufig zu aktualisieren. In diesem Fall kannst Du das kompilierte Programm und die Quelle einfach durch Löschen eines einzelnen Ordners entfernen.

Wechsle in das Quellverzeichnis und zeige auf das aktuelle Verzeichnis (gekennzeichnet durch einen einzelnen Punkt):

Die FreeCAD Ausführdatei befindet sich dann im Verzeichnis.

<span id="How_to_repair_your_source_code_directory">

Wie Du dein Quellcode Verzeichnis reparieren kannst
Wenn du versehentlich eine Kompilierung im Quellcode Verzeichnis durchgeführt oder seltsame Dateien hinzugefügt hast und den Inhalt nur im ursprünglichen Quellcode wiederherstellen möchtest, kannst du die folgenden Schritte durchführen.

Die erste Zeile löscht die Datei. Dadurch wird sichergestellt, dass die folgenden Clean und Reset Befehle sich auf alles im Verzeichnis auswirken und keine Elemente ignorieren, die den Ausdrücken in  entsprechen. Die zweite Zeile löscht alle Dateien und Verzeichnisse, die nicht vom git Repository verfolgt werden; dann setzt der letzte Befehl alle Änderungen an den überwachten Dateien zurück, einschließlich des ersten Befehls, der die Datei gelöscht hat.

Wenn du das Quellverzeichnis nicht löschst, können nachfolgende Durchläufe von keine neuen Optionen für das System erfassen, wenn sich der Code ändert.

Konfiguration
Durch die Übergabe verschiedener Optionen an kannst Du ändern, wie FreeCAD kompiliert wird. Die Syntax ist wie folgt.

Wobei das Verzeichnis ist, das den Quellcode enthält. Der kann in den meisten Fällen weggelassen werden. Das Leerzeichen nach der Option kann ebenfalls weggelassen werden.

Zum Beispiel, um den Bau der FEM Arbeitsbereich zu vermeiden:

Alle möglichen Variablen sind in der Datei aufgelistet, die sich im  Verzeichnis befindet. Suche in dieser Datei nach dem Wort, um zu den einstellbaren Variablen zu gelangen und deren Standardwerte zu sehen.


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

Alternativ kannst Du den Befehl verwenden, um die aktuelle Konfiguration und damit alle Variablen aufzulisten, die geändert werden können. Du kannst auch installieren und verwenden, um eine grafische Oberfläche zu starten, die alle Variablen anzeigt, die geändert werden können. In den nächsten Abschnitten listen wir einige der wichtigsten Optionen auf, die du vielleicht verwenden möchtest.

<span id="For_a_Debug_build">

Für einen Fehlersuch Bau
Erstelle einen Build, um Abstürze in FreeCAD zu beheben. Beachte, dass mit diesem Build die Skizzierer Arbeitsbereich bei komplexen Skizzen sehr langsam wird.

<span id="For_a_Release_build">

Für ein Veröffentlichungs Bau
Erstelle einen Build, um Code zu testen, der nicht abstürzt. Ein Build wird viel schneller ausgeführt als ein  Build.

<span id="Building_against_Python_3_and_Qt5">

Bauen gegen Python 3 und Qt5
Die Unterstützung für Python 2 und Qt4 wurde aus FreeCAD 0.20 ertfernt und Qt5 und Python 3 müssen nicht extra aktiviert werden, wenn die neuesten Versionen kompiliert werden. Unterstützung für Qt6 wird zurzeit entwickelt und funktioniert noch nicht. Solange man nicht plant, die Qt6-Migration zu unterstützen, sollte FREECAD_QT_VERSION auf "Auto" (Standardeinstellung) oder ausdrücklich auf "5" gesetzt werden.

Für 0.20 und 0.21_dev:

Beachte, dass es beim Wechsel zwischen 0.20 und den 0.21_dev-Builds notwendig sein kann, CMakeCache.txt zu löschen, bevor cmake ausgeführt wird.

<span id="Building_for_a_specific_Python_version">

Bauen für eine bestimmte Python Version
Wenn die standardmäßige ausführbare -Datei auf Deinem System ein symbolischer Link zu Python 2 ist, wird versuchen, FreeCAD für diese Version zu konfigurieren. Du musst dann eine andere Version von Python wählen, indem du den Pfad zu einer bestimmten ausführbaren Datei angibst:

Wenn das nicht funktioniert, musst Du möglicherweise zusätzliche Variablen definieren, die auf die gewünschten Python Bibliotheken und Include Verzeichnisse verweisen:

Es ist möglich, mehrere unabhängige Versionen von Python im selben System zu haben, so dass die Speicherorte und Versionsnummern deiner Python Dateien von deiner jeweiligen Linux Distribution abhängen. Verwende, um die Version von Python anzuzeigen, die Du gerade verwendest; nur die ersten beiden Zahlen sind notwendig; wenn das Ergebnis beispielsweise ist, musst Du die Verzeichnisse angeben, die sich auf die Version 3.6 beziehen. Wenn Du die richtigen Verzeichnisse nicht kennst, versuche mit dem Befehl nach ihnen zu suchen.

Du kannst in einem Terminal verwenden, um das Verzeichnis  zu bestimmen, oder  für Debian Systeme.

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:

<span id="Building_with_Qt_Creator_against_Python_3_and_Qt5">

Bauen mit Qt Creator gegen Python 3 und Qt5
1. Qt Creator starten.

2. Klicke auf.

3. Wechsle zu dem Verzeichnis, in dem sich der Quellcode befindet,, und wähle die oberste Datei.

4. Durch Wahl der Datei, wird automatisch darauf ausgeführt, aber es kann fehlschlagen, wenn die geeigneten Optionen nicht korrekt eingestellt sind.

5. Gehe zu. Setze das entsprechende Build Verzeichnis,.

6. Setze die geeigneten Variablen im Schlüssel-Wert Dialogfeld und.

7. Wenn die Variablen das Projekt nicht korrekt laden, musst du möglicherweise zu gehen. Drücke dann und füge die geeignete Konfiguration wie oben beschrieben hinzu. Möglicherweise musst du weitere Variablen über die Python Pfade hinzufügen, falls das System Python nicht gefunden wird.

7.1. Drücke, dann.

7.2. Stelle sicher, dass die restlichen Optionen korrekt eingestellt sind, z.B. sollte eine im System installierte aktuelle Version sein, wie.

Drücke, dann um die Konfiguration zu schließen.

Das Programm sollte wieder automatisch ausgeführt werden, und es sollte das gesamte Schlüssel Wert Dialogfeld  mit allen konfigurierbaren Variablen füllen.

8. Gehe zu und wähle, um die grafische Version von FreeCAD zu kompilieren, oder , um nur die Befehlszeilenversion zu kompilieren.

9. Abschließend gehe zum Menü. Wenn es sich um eine neue Kompilierung handelt, sollte sie je nach Anzahl der zur Verfügung stehenden Prozessoren mehrere Minuten, inklusive Stunden, dauern.

<span id="Qt_designer_plugin">

Qt Designer Zusatzprogramm
Wenn du Qt Code für FreeCAD entwickeln möchtest, benötigst du die Qt Designer Zusatzprogramm, das alle benutzerdefinierten Widgets von FreeCAD bereitstellt.

Gehe in ein Hilfsverzeichnis des Quellcodes, den Run mit der angegebenen Projektdatei, um eine  zu erstellen; führe dann  aus, um das Zusatzprogramm zu kompilieren.

Wenn du für Qt5 kompilierst, stelle sicher, dass die Binärdatei diejenige für diese Version ist, so dass die resultierende  die notwendigen Informationen für Qt5 enthält.

wobei das Verzeichnis ist, das Qt Binärbibliotheken speichert, z.B..

Die erstellte Bibliothek ist, die nach kopiert werden muss.

<span id="External_or_internal_Pivy">

Externes oder internes Pivy
Bisher wurde eine Version von Pivy in den Quellcode von FreeCAD (intern) aufgenommen. Wenn Du die Kopie von Pivy (extern) Deines Systems verwenden möchtest, musst Du Folgendes verwenden.

Die Verwendung von externem Pivy wurde bei der Entwicklung von FreeCAD 0.16 zum Standard, so dass diese Option nicht mehr manuell gesetzt werden muss.

<span id="Doxygen_documentation">

Doxygen-Dokumentation
Wenn Du Doxygen installiert hast, kannst Du die Quellcode Dokumentation erstellen. Siehe source documentation/de für Anweisungen.

<span id="Additional_documentation">

Zusätzliche Dokumentation
Der Quellcode von FreeCAD ist sehr umfangreich, und mit CMake ist es möglich, viele Optionen zu konfigurieren. Das Erlernen der vollständigen Nutzung von CMake kann nützlich sein, um die richtigen Optionen für Ihre speziellen Bedürfnisse auszuwählen.
 * CMake Referenzdokumentation von Kitware.
 * Wie man ein CMake-basiertes Projekt erstellt (Blog) durch Preshing auf Programmierung.
 * CMakes Skriptsprache in 15 Minuten lernen (Blog) durch Preshing auf Programmierung.

<span id="Making_a_debian_package">

Ein Debian Paket erstellen
Wenn Du planst, ein Debian-Paket aus den Quellen zu erstellen, musst Du zuerst bestimmte Pakete installieren:

Gehe in das FreeCAD Verzeichnis und wähle

Sobald das Paket erstellt ist, kannst Du mit prüfen, ob das Paket Fehler enthält.

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

<span id="Updating_the_source_code">

Aktualisierung des Quellcodes
Das CMake System ermöglicht es Dir, den Quellcode intelligent zu aktualisieren und nur die Änderungen neu zu kompilieren, was spätere Kompilierungen beschleunigt.

Gehe an den Speicherort, an dem der FreeCAD Quellcode zuerst heruntergeladen wurde, und ziehe den neuen Code:

Gehe dann in das Build Verzeichnis, in dem der Code ursprünglich kompiliert wurde, und führe  unter Angabe des aktuellen Verzeichnisses (gekennzeichnet durch einen Punkt) aus; löse dann die Neukompilierung mit  aus.

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.

Fehlerbehebung
<span id="For_64_bit_systems">

Für 64 Bit Systeme
Beim Erstellen von FreeCAD für 64-Bit gibt es ein bekanntes Problem mit dem OpenCASCADE (OCCT) 64-Bit Paket. Um FreeCAD richtig zum Laufen zu bringen, musst du möglicherweise das Skript ausführen und zusätzlich  einstellen:

Für Debian basierte Systeme wird diese Option nicht benötigt, wenn die vorkompilierten OpenCASCADE Pakete verwendet werden, da diese intern die richtigen setzen.

<span id="Automatic_build_scripts">

Automatische Build Skripte
Hier findest du alles, was du für einen vollständigen Aufbau von FreeCAD benötigst. Es ist ein Ein-Skript-Ansatz und funktioniert auf einer frisch installierten Linux Distribution. Die Befehle fragen nach dem Root Passwort für die Installation von Paketen und neuen Online Repositorien. Diese Skripte sollten auf 32 und 64 Bit Versionen laufen. Sie sind für verschiedene Versionen geschrieben, werden aber wahrscheinlich auch auf einer späteren Version mit oder ohne größere Änderungen laufen.

Wenn du ein solches Skript für deine bevorzugte Distribution hast, diskutiere es bitte auf dem FreeCAD Forum, damit wir es einbauen können.

Ubuntu
Diese Skripte bieten eine zuverlässige Möglichkeit, die richtigen Abhängigkeiten zu installieren, die für die Erstellung und Ausführung von FreeCAD auf Ubuntu erforderlich sind. Sie nutzen die Ubuntu Personal Package Archives (PPA) und sollten an jeder Version von Ubuntu arbeiten, die von der PPA erfasst wird. Die freecad-tages freecad-tages PPA zielt auf aktuelle Versionen von Ubuntu ab, während die freecad-stable PPA zielt auf offiziell unterstützte Versionen von Ubuntu ab.

Dieses Skript installiert den täglich erstellten Schnappschuss von FreeCAD und seinen Abhängigkeiten. Es fügt das tägliche Repository hinzu, holt die Abhängigkeiten, um diese Version zu erstellen, und installiert die erforderlichen Pakete. Anschließend wird der Quellcode in ein bestimmtes Verzeichnis gezogen, ein Build-Verzeichnis erstellt und in dieses gewechselt, die Kompilierungsumgebung mit konfiguriert und schließlich das gesamte Programm mit  erstellt. Speichere das Skript in einer Datei, mache es ausführbar und führe es aus, verwende aber nicht ; Superuser Rechte werden nur für ausgewählte Befehle abgefragt.

Wenn du möchtest, kannst du die vorkompilierte Version von FreeCAD deinstallieren, während du die Abhängigkeiten an Ort und Stelle lässt, aber wenn du dieses Paket installiert lässt, kann der Paketmanager seine Abhängigkeiten auch auf dem neuesten Stand halten; dies ist vor allem nützlich, wenn du die Entwicklung von FreeCAD verfolgen und die Quellen aus dem Git Repository ständig aktualisieren und kompilieren willst.

Das vorherige Skript geht davon aus, dass du die neueste Version von FreeCAD kompilieren möchtest, also benutzt du das "tägliche" Repository, um die Abhängigkeiten zu erhalten. Du kannst jedoch stattdessen die Build Abhängigkeiten der "stabilen" Version für deine aktuelle Ubuntu-Version erhalten. Wenn dies der Fall ist, ersetze den oberen Teil des vorherigen Skripts durch die folgenden Anweisungen. Für Ubuntu 12.04 lasse vom Befehl aus.

Sobald du das Paket aus dem Repository  installiert hast, ersetzt es die FreeCAD Ausführdatei, die im Universe Ubuntu Repository verfügbar ist. Die ausführbare Datei wird einfach genannt und nicht.

openSUSE
Für die Kompilierung von FreeCAD werden keine externen Repositorien benötigt. Es gibt jedoch eine Inkompatibilität mit python3-devel, die entfernt werden muss. FreeCAD kann aus GIT kompiliert werden.

Da Du git verwendest, musst Du beim nächsten Mal, wenn Du kompilieren möchtest, nicht alles klonen, sondern ziehst einfach von git ab und kompilierst erneut.

Fedora 27/28/29
Veröffentlicht von Benutzer [PrzemoF] im Forum.

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

<span id="Arch_using_AUR">

Bogen mit AUR
Arch User Repository (AUR) ist eine Sammlung von benutzerdefinierten Rezepten zum Erstellen von Paketen, die nicht offiziell von Distributionsmoderatoren / Gemeinschaft unterstützt werden. Sie sind in der Regel sicher. Du kannst sehen, wer das Paket gepflegt hat und wie lange. Es wird empfohlen, die Konstruktionsdateien zu überprüfen. Auch nicht quelloffene Software ist in diesem Bereich verfügbar, auch wenn sie von der offiziellen Eigentümerfirma gepflegt wird.

Voraussetzung: git

Schritte :
 * 1) Öffne ein Terminal. Optional kann ein Verzeichnis erstellt werden, z.B. . Optional kann das Verzeichnis geändert werden, z.B..
 * 2) Klone das AUR-Repository :
 * 3) Gib den AUR-Repository-Ordner ein:
 * 4) Kompiliere mit Arch makepkg : . Das Flag -s oder --syncdeps installiert auch die erforderlichen Abhängigkeiten.
 * 5) Installiere das erstellte Paket : oder doppelklicke auf das pkgname-pkgver.pkg.tar.xz in Deinem Dateibrowser.

Um FreeCAD auf den neuesten Stand zu bringen, wird alles ab Schritt 3 wiederholt. Wenn es eine schwerwiegende Änderung im Ablaufplan oder neue Funktionen gibt, wird das AUR-Repository aktualisiert, indem im Ordner verwendet wird.