Compile on Linux/pl

Informacje ogólne
W ostatnich dystrybucjach Linuksa FreeCAD jest ogólnie łatwy do zbudowania, ponieważ wszystkie zależności są zwykle dostarczane przez menedżera pakietów. Zasadniczo obejmuje 3 kroki:
 * 1) Pobierz kod źródłowy FreeCAD.
 * 2) Pobierz zależności lub pakiety, od których zależy FreeCAD.
 * 3) Skonfiguruj za pomocą  i skompiluj za pomocą.

Poniżej znajdziesz szczegółowe wyjaśnienia całego procesu, niektóre skrypty do kompilacji oraz szczegóły, które możesz napotkać. Jeśli znajdziesz w poniższym tekście coś błędnego lub nieaktualnego (dystrybucje Linuksa często się zmieniają), lub jeśli używasz dystrybucji, której nie ma na liście, przedyskutuj ten problem na forum i pomóż nam go poprawić.





Git
Najlepszym sposobem uzyskania kodu jest sklonowanie repozytorium tylko do odczytu Git. Do tego celu potrzebny jest program, który można łatwo zainstalować w większości dystrybucji Linuksa. Można go również uzyskać z oficjalnej strony.

Program Git można zainstalować za pomocą następującego polecenia:

Poniższe polecenie umieści kopię najnowszej wersji kodu źródłowego programu FreeCAD w nowym katalogu o nazwie.

Więcej informacji na temat używania środowiska Git i wnoszenia kodu do projektu można znaleźć na stronie Zarządzanie kodem źródłowym.



Archiwum źródeł
Alternatywnie można pobrać źródło w postaci archiwów, pliku lub, a następnie rozpakować je w wybranym katalogu.



Pobranie zależności
Aby skompilować FreeCAD musisz zainstalować wymagane zależności wymienione w dokumencie biblioteki zewnętrzne. Pakiety, które zawierają te zależności są wymienione poniżej dla różnych dystrybucji Linuksa. Proszę zauważyć, że nazwy i dostępność bibliotek zależą od konkretnej dystrybucji; jeśli dystrybucja jest stara, niektóre pakiety mogą być niedostępne lub mieć inną nazwę. W takim przypadku należy zajrzeć do sekcji starsze i niekonwencjonalne dystrybucje poniżej.

Gdy masz już zainstalowane wszystkie zależności, przejdź do sekcji kompilacja programu.

Należy pamiętać, że kod źródłowy programu FreeCAD ma rozmiar około 500 MB; może on być trzykrotnie większy, jeśli sklonujesz repozytorium Git z całą historią modyfikacji. Pobranie wszystkich zależności może wymagać pobrania 500 MB lub więcej nowych plików. Kiedy te pliki zostaną rozpakowane, mogą wymagać 1500 MB lub więcej miejsca. Należy również pamiętać, że proces kompilacji może wygenerować do 1500 MB dodatkowych plików, ponieważ system kopiuje i modyfikuje cały kod źródłowy. Dlatego przed przystąpieniem do kompilacji należy upewnić się, że na dysku twardym jest wystarczająco dużo wolnego miejsca, co najmniej 4 GB.



Debian oraz Ubuntu
W systemach opartych na Debianie (Ubuntu, Mint itd.) dość łatwo jest zainstalować wszystkie potrzebne zależności. Większość bibliotek jest dostępna za pośrednictwem lub menedżera pakietów Synaptic.

Jeśli zainstalowałeś już FreeCAD z oficjalnych repozytoriów, możesz zainstalować jego zależności za pomocą tej jednej linijki kodu w terminalu:

Jednakże, jeśli wersja FreeCAD w repozytoriach jest stara, zależności mogą być niewłaściwe do skompilowania najnowszej wersji programu FreeCAD. Dlatego należy sprawdzić, czy zostały zainstalowane następujące pakiety.

Pakiety te są niezbędne do pomyślnego przeprowadzenia jakiejkolwiek kompilacji:
 * , instaluje kompilatory C i C++, biblioteki programistyczne C oraz program.
 * , niezbędne narzędzie do konfiguracji źródeł programu FreeCAD. Możesz również zainstalować i, aby uzyskać opcję graficzną.
 * , podstawowe narzędzia do tworzenia bibliotek współdzielonych.
 * , standardowe narzędzie do raportowania bazy danych jest zwykle już zainstalowane w systemie Debian i pozwala na programowe rozróżnienie między czystą instalacją Debiana a jego odmianą, taką jak Ubuntu czy Linux Mint. Nie należy usuwać tego pakietu, ponieważ wiele innych pakietów systemowych może od niego zależeć.

Kompilacja programu FreeCAD wykorzystuje język Python, jest on także używany w czasie pracy jako język skryptowy. Jeśli używasz dystrybucji opartej na Debianie, interpreter Python jest zazwyczaj już zainstalowany.
 * , narzędzie, które tworzy interfejsy między kodem C++ a Python.
 * , narzędzie, które tworzy interfejsy między kodem C++ a Python.

Sprawdź, czy masz zainstalowany Python 3. Python 2 został wycofany z użycia w 2019 r, więc nowe środowiska w programie FreeCAD nie są testowane z tą wersją języka.

Konieczne jest zainstalowanie bibliotek Boost:



Konieczne jest zainstalowanie bibliotek Coin:
 * , dla Debian Jessie, Stretch, Ubuntu 16.04 do 18.10, lub
 * , dla Debiana Buster, Ubuntu 19.04 i nowszych, a także dla Ubuntu 18.04/18.10 z freecad-stable/freecad-daily PPAs dodane do źródeł oprogramowania.

Kilka bibliotek zajmujących się matematyką, powierzchniami triangulowanymi, sortowaniem, siatkami, obrazowaniem komputerowym, projekcjami kartograficznymi, wizualizacją 3D, systemem okien X11, parsowaniem XML i odczytywaniem plików Zip:


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



Python 2 oraz Qt4
Nie jest to zalecane w przypadku nowszych instalacji, ponieważ zarówno Python 2, jak i Qt4 są przestarzałe. Od wersji 0.20 FreeCAD nie obsługuje ich już.

Aby skompilować FreeCAD dla Debiana Jessie, Stretch, Ubuntu 16.04, używając Pythona 2 i Qt4, należy zainstalować następujące zależności.





Python 3 oraz Qt5
Aby skompilować FreeCAD dla Debiana Buster, Ubuntu 19.04 i nowszych oraz Ubuntu 18.04/18.10 z freecad-stable/freecad-daily PPAs dodanymi do źródeł oprogramowania, zainstaluj następujące zależności.


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



kernel OpenCascade
Jądro OpenCascade jest podstawową biblioteką graficzną służącą do tworzenia kształtów 3D. Istnieje w wersji oficjalnej OCCT oraz w wersji społecznościowej OCE. Wersja społecznościowa nie jest już zalecana, ponieważ jest przestarzała.

W przypadku Debiana Buster i Ubuntu 18.10 i nowszych, a także Ubuntu 18.04 z freecad-stable/freecad-daily PPAs dodanymi do źródeł oprogramowania, należy zainstalować oficjalne pakiety.



W przypadku Debiana Jessie, Stretch, Ubuntu 16.04 i nowszych należy zainstalować pakiety edycji społecznościowej.



Biblioteki można instalować pojedynczo lub przy użyciu rozszerzenia asterisk. Zmień na, jeśli chcesz zainstalować biblioteki społecznościowe.



Pakiety opcjonalne
Opcjonalnie można również zainstalować te dodatkowe pakiety:
 * , aby Coin obsługiwał dodatkowe formaty plików graficznych.
 * i (lub  dla starszych systemów), jeśli chcesz generować dokumentację kodu źródłowego.
 * , dla obsługi maniopulatorów przestrzennych, takich jak "Space Navigator" lub "Space Pilot" firmy 3Dconnexion.
 * , jeśli chcesz zarejestrować zainstalowane pliki w systemowym menedżerze pakietów, aby móc je później odinstalować.



Pojedyncze polecenie dla środowisk Python 3 i Qt5
Wymaga Pyside2 dostępnego w Debian buster oraz freecad-stable/freecad-daily PPA.

UWAGA: W niektórych wersjach Ubuntu i niektórych wersjach Qt pojawi się błąd, że nie udało się znaleźć pakietu python3-pyside2uic - w tych systemach można go bezpiecznie pominąć. W Ubuntu 20.04 trzeba będzie dodać. Więcej informacji można znaleźć na stronie this dyskusja na forum.



Pojedyncze polecenie dla środowisk Python 2 i Qt4
Nie jest to zalecane w przypadku nowszych instalacji, ponieważ zarówno Python 2, jak i Qt4 są przestarzałe.

Użytkowników Ubuntu 16.04 prosimy o zapoznanie się również z dyskusją na temat kompilacji na forum: Compile on Linux (Kubuntu): CMake can't find VTK.



Raspberry Pi
Wykonaj te same kroki, co w przypadku dystrybucji Debian i Ubuntu.

Zgłaszane są problemy podczas próby kompilacji w systemie v przy użyciu Pythona 3 i Qt5, ale kombinacja Pythona 3 i Qt4 wydaje się działać ze starszymi wersjami programu FreeCAD (z drobnymi problemami).

W przypadku nowszych wersji (od 0.20) programu FreeCAD kompilacja z Py3/Qt5 powiedzie się, jeśli zainstalowanym systemem operacyjnym jest Raspberry Pi OS 64-bit lub Ubuntu 20.04.

Z powodu różnych problemów z Qt, w Ubuntu 20.04 nie będzie można znaleźć normalnych narzędzi PySide.

W tym przypadku możemy zainstalować pakiety z PyQt i utworzyć dowiązania symboliczne do potrzebnych narzędzi.

Teraz można przystąpić do kompilacji.

Opcja w poleceniu  nie powinna mieć parametru powyżej 3, ponieważ Raspberry Pi ma ograniczoną pamięć. Kompilacja zajmie kilka godzin, więc lepiej zrobić to w nocy.

Więcej informacji, FreeCAD i Raspberry Pi 4.

Fedora
W cmake dystrybuowanym przez Fedorę 34/35 jest błąd, który powoduje, że cmake nie znajduje bibliotek opencascade. Można to łatwo naprawić, wprowadzając jedną drobną zmianę do głównego poziomu pliku cmake programu opencascade zainstalowanego na Fedorze. Szczegóły tutaj: https://bugzilla.redhat.com/show_bug.cgi?id=2083568.

W górnej części pliku zmień następujący wiersz, aby użyć. Usuwa to błąd wprowadzony przez użycie linka symbolicznego z do  w Fedorze, co powodowało błąd w cmake.

Ten plik jest zwykle instalowany w.

zmień to na:

Tę trywialną zmianę należy wprowadzić w katalogu kompilacji po uruchomieniu cmake i niepowodzeniu. Ponowne uruchomienie cmake spowoduje prawidłowe wykrycie bibliotek OCCT w normalny sposób.

Potrzebne są następujące pakiety:


 * (or possibly another C++ compiler?)

(kwiecień 2021, Coin4 i Coin4-devel są dostępne) (jeśli coin2 jest najnowszą dostępną wersją dla twojej wersji Fedory, użyj pakietów z http://www.zultron.com/rpm-repo/)



I opcjonalnie:


 * (do obsługi urządzeń 3Dconnexion, takich jak Space Navigator czy Space Pilot),
 * (https://bugzilla.redhat.com/show_bug.cgi?id=458975 Pivy nie jest obowiązkowy, ale jest wymagany dla środowiska Rysunek Roboczy),
 * (aby Menadżer dodatków natywny markdown),
 * (aby Menadżer dodatków używał repozytorium Git do sprawdzania i aktualizowania środowisk pracy i makrodefinicji).

Aby zainstalować wszystkie zależności naraz (testowane w systemie Fedorze 36 oraz 37):

Gentoo
Najprostszym sposobem sprawdzenia, które pakiety są potrzebne do skompilowania programu FreeCAD, jest sprawdzenie ich przez portage:

emerge -pv freecad

Powinno to spowodować wyświetlenie listy dodatkowych pakietów, które należy zainstalować w systemie.

Gdy FreeCAD nie jest dostępny przez portage, jest dostępny na repozytorium waebbl overlay. Narzędzie do śledzenia problemów na nakładce waebbl Github może pomóc w rozwiązaniu niektórych z nich. Nakładka zapewnia szeroki licznik freecad-9999, dzięki temu możesz wybrać potrzebny numer do skompilowania lub po prostu użyć do pobrania zależności.

layman -a waebbl</tt>

Tumbleweed
Następujące polecenia zainstalują pakiety wymagane do zbudowania FreeCAD z Qt5 i środowiskiem Python 3.

Następujące polecenie zainstaluje program Qt Creator i GNU Project Debugger.

Jeśli brakuje jakichś pakietów, można sprawdzić plik Tumbleweed "FreeCAD.spec" na stronie Open Build Service.

Należy również sprawdzić, czy nie ma jakichś poprawek, które należy zastosować (np. 0001-find-openmpi2-include-files.patch).

Leap
Jeśli istnieje różnica między pakietami dostępnymi w programach Tumbleweed i Leap, można przeczytać plik "FreeCAD.spec" programu Leap w Open Build Service, aby określić wymagane pakiety.

Zobacz poradnik piano_jonas unnofficial "Compile On openSUSE".

<span id="Arch_Linux">

Arch Linux
Potrzebne będą następujące biblioteki z oficjalnych repozytoriów:



<span id="Older_and_non-conventional_distributions">

Dystrybucje starsze i niekonwencjonalne
Dla innych dystrybucji mamy bardzo mało informacji zwrotnych od użytkowników, więc znalezienie potrzebnych pakietów może być trudniejsze.

Spróbuj najpierw znaleźć wymagane biblioteki wymienione w bibliotekach zewnętrznych w swoim menedżerze pakietów. Zwróć uwagę, że niektóre z nich mogą mieć nieco inną nazwę pakietu. Szukaj według, ale także , , i podobnych. Jeśli to nie jest możliwe, spróbuj skompilować te biblioteki samodzielnie.

FreeCAD wymaga kompilatora GNU g++ w wersji nie mniejszej niż 3.0.0, ponieważ FreeCAD jest napisany głównie w języku C++. Podczas kompilacji wykonywane są niektóre skrypty Pythona, więc interpreter Python musi działać prawidłowo. Aby uniknąć problemów z linkerem, dobrze jest umieścić ścieżki dostępu do bibliotek w zmiennej lub w pliku. W nowoczesnych dystrybucjach Linuksa jest to już zrobione, ale w starszych może być konieczne ustawienie tej zmiennej

Pivy
Pivy (pakiet Pythona do Coin3d) nie jest potrzebny do zbudowania programu FreeCAD ani do jego uruchomienia, ale jest wymagany jako zależność runtime przez Rysunek Roboczy. Jeśli nie zamierzasz używać tego środowiska pracy, nie będziesz potrzebował Pivy. Należy jednak pamiętać, że środowisko pracy Rysunek Roboczy jest używane wewnętrznie przez inne środowiska pracy, takie jak Architektura i BIM, więc Pivy jest wymagane do korzystania z tych narzędzi.

W listopadzie 2015 roku przestarzała wersja Pivy dołączona do kodu źródłowego FreeCAD nie będzie już kompilowana na wielu systemach. Nie jest to duży problem, ponieważ zazwyczaj powinieneś pobrać Pivy z menedżera pakietów swojej dystrybucji; jeśli nie możesz znaleźć Pivy, być może będziesz musiał skompilować go samodzielnie, zobacz Instrukcje kompilacji Pivy.

<span id="Debug_symbols">

Symbole debugowania
W celu rozwiązywania problemów z awariami w programie FreeCAD, warto wprowadzić symbole debugowania ważnych bibliotek zależnych, takich jak Qt. W tym celu spróbuj zainstalować pakiety zależności, których nazwy kończą się na, , lub podobne, w zależności od dystrybucji Linuksa.

Dla Ubuntu, może być konieczne włączenie specjalnych repozytoriów, aby móc zobaczyć i zainstalować te pakiety debugowania za pomocą menedżera pakietów. Zapoznaj się ze stroną Debug Symbol Packages, aby uzyskać więcej informacji.

<span id="Compile_FreeCAD">

Kompilacja programu
FreeCAD używa CMake jako głównego systemu kompilacji, ponieważ jest on dostępny we wszystkich głównych systemach operacyjnych. Kompilacja za pomocą CMake jest zazwyczaj bardzo prosta i przebiega w dwóch krokach.


 * 1) CMake sprawdza, czy wszystkie potrzebne programy i biblioteki są obecne w systemie, a następnie generuje plik, który jest skonfigurowany do drugiego kroku. FreeCAD ma kilka opcji konfiguracyjnych do wyboru, ale posiada rozsądne ustawienia domyślne. Poniżej opisano kilka alternatywnych rozwiązań.
 * 2) Sama kompilacja, która jest wykonywana przez program, który generuje pliki wykonywalne programu FreeCAD.

Ponieważ FreeCAD jest dużą aplikacją, kompilacja całego kodu źródłowego może zająć od 10 minut do godziny, w zależności od wydajności Twojego procesora i liczby rdzeni procesora użytych do kompilacji.

Kod można budować zarówno w katalogu źródłowym, jak i poza nim. Generalnie najlepszym rozwiązaniem jest budowanie poza katalogiem źródłowym.

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

Kompilacja poza źródłami
Budowanie w osobnym folderze jest wygodniejsze niż budowanie w tym samym katalogu, w którym znajduje się kod źródłowy, ponieważ za każdym razem, gdy aktualizujesz kod źródłowy, CMake może inteligentnie określić, które pliki uległy zmianie, i przekompilować tylko to, co jest potrzebne. Jest to bardzo przydatne podczas testowania różnych gałęzi Git, ponieważ nie trzeba dezorientować systemu kompilacji.

Aby budować poza źródłem, po prostu utwórz katalog budowania,, oddzielny od folderu źródłowego FreeCAD,. Następnie z tego katalogu wskaż właściwy folder źródłowy. W poniższych instrukcjach możesz również użyć lub  zamiast. Gdy zakończy konfigurowanie środowiska, użyj, aby rozpocząć właściwą kompilację.

Uwaga: jeśli kompilujesz gałąź wydania 0.19, musisz jawnie określić, że kompilujesz z użyciem pakietów Qt5 i Python 3 -- zamień powyższe polecenie cMake na:

Opcja programu  kontroluje, ile zadań (plików) jest kompilowanych równolegle. Program wypisuje liczbę rdzeni procesora w twoim systemie. Używając go razem z opcją możesz wybrać przetwarzanie tylu plików, ile masz rdzeni, aby przyspieszyć ogólną kompilację programu. W powyższym przykładzie, użyje on wszystkich rdzeni w systemie z wyjątkiem dwóch. Dzięki temu Twój komputer będzie mógł być wykorzystany do innych celów, podczas gdy kompilacja będzie przebiegać w tle. Plik wykonywalny programu FreeCAD pojawi się ostatecznie w katalogu. Zobacz także stronę Kompilacja (przyspieszamy), aby poprawić szybkość kompilacji.

<span id="Resolving_cmake_issues">

Rozwiązywanie problemów z cmake
Jeśli już wcześniej wykonałeś kompilację poza źródłem i utknąłeś na zależności, która nie została rozpoznana lub nie można jej rozwiązać, spróbuj wykonać następujące czynności:


 * Usuń zawartość katalogu kompilacji przed ponownym uruchomieniem cmake. FreeCAD jest szybko zmieniającym się celem, możesz natknąć się na zbuforowane informacje cmake, które wskazują na starszą wersję niż ta, której może użyć nowy serwer repozytorium. Wyczyszczenie pamięci podręcznej może pozwolić cmake odzyskać i rozpoznać wersję, której rzeczywiście potrzebujesz.


 * Jeśli skarży się na brak konkretnego pliku, użyj narzędzia takiego jak  lub jego odpowiednika w innych systemach pakietów, aby dowiedzieć się, do jakiego pakietu należy ten plik i zainstalować go. Pamiętaj, że prawdopodobnie będziesz potrzebował wersji  pakietu, która zawiera pliki nagłówkowe lub konfiguracyjne wymagane do korzystania z pakietu przez FreeCAD.

<span id="Compiling_against_GNU_libc_2.34_and_later">

Kompilacja z GNU libc 2.34 i nowszymi
GNU libc 2.34 wprowadza zmianę w bibliotece, która może spowodować, że kompilacja w niektórych systemach Linux nie powiedzie się powodując następujący błąd:

Aby temu zaradzić, należy ręcznie utworzyć dowiązanie symboliczne z (pustego teraz) systemowego libdl.so.* do miejsca, w którym kompilator mówi, że szuka tego pliku. Na przykład (jeśli faktycznie zainstalowaną kopią libdl.so w systemie jest /usr/lib/x86_64-linux-gnu/libdl.so.2):

Dostosuj to polecenie do struktury swojego systemu, wyszukując libdl.so* i umieszczając je w odpowiedniej lokalizacji.

<span id="In-source_building">

Kompilacja na bazie źródeł
Kompilacje źródłowe są dobre, jeśli chcesz szybko skompilować wersję FreeCAD i nie zamierzasz często aktualizować kodu źródłowego. W takim przypadku możesz usunąć skompilowany program i źródło, usuwając tylko jeden folder.

Zmień katalog na źródłowy i wskaż na obecny katalog (oznaczony pojedynczym punktem):

Plik wykonywalny programu FreeCAD będzie wtedy znajdował się w katalogu.

<span id="How_to_repair_your_source_code_directory">

Jak naprawić swój katalog z kodem źródłowym
Jeśli przypadkowo wykonałeś kompilację wewnątrz katalogu z kodem źródłowym lub dodałeś niepotrzebne pliki i chcesz przywrócić jego zawartość tylko do oryginalnego kodu źródłowego, możesz wykonać następujące czynności.

Pierwszy wiersz usuwa zawartość pliku. Zapewnia to, że kolejne polecenia clean i reset będą dotyczyły wszystkiego w katalogu i nie będą ignorowały elementów pasujących do wyrażeń z. Druga linia usuwa wszystkie pliki i katalogi, które nie są śledzone przez repozytorium git. Następnie ostatnia komenda resetuje wszelkie zmiany w śledzonych plikach, w tym pierwszą komendę, która wyczyściła plik.

Jeśli nie wyczyścisz katalogu źródłowego, kolejne uruchomienia mogą nie wychwycić nowych opcji systemu, jeśli kod ulegnie zmianie.

Konfiguracja
Przekazując różne opcje do, możesz zmienić sposób, w jaki FreeCAD jest kompilowany. Składnia jest następująca.

Gdzie jest katalogiem zawierającym kod źródłowy. Opcję można w większości przypadków pominąć. Można też pominąć spację po opcji.

Na przykład, aby uniknąć kompilacji środowiska MES:

Wszystkie możliwe zmienne są wymienione w pliku, znajdującym się w katalogu. W pliku tym należy wyszukać słowo, aby przejść do zmiennych, które można ustawić, i przejrzeć ich wartości domyślne.


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

Alternatywnie można użyć polecenia, aby wyświetlić listę bieżącej konfiguracji, a więc wszystkich zmiennych, które można zmienić. Można również zainstalować i użyć, aby uruchomić interfejs graficzny pokazujący wszystkie zmienne, które można modyfikować. W następnych sekcjach wymienimy niektóre z ważniejszych opcji, których możesz chcieć użyć.

<span id="For_a_Debug_build">

Dla debugowania kompilacji
Utwórz kompilację do rozwiązywania problemów z awariami w programie FreeCAD. Zwróć uwagę, że w tej wersji kompilacji środowisko pracy Szkicownik przy złożonych szkicach staje się bardzo powolne.

<span id="For_a_Release_build">

Dla kompilacji Wydania
Utwórz kompilację, aby przetestować kod, który nie ulega awarii. Kompilacja będzie działać znacznie szybciej niż kompilacja.

<span id="Building_against_Python_3_and_Qt5">

Kompilacja w oparciu o Python 3 i Qt5
Wsparcie dla środowiska Python 2 i Qt4 zostało wycofane w FreeCAD 0.20 i nie jest konieczne wyraźne włączenie Qt5 i Python 3, jeśli kompilujemy najnowsze wersje. Obsługa Qt6 jest obecnie w fazie rozwoju i jeszcze nie działa. Jeśli nie planujesz pomagać w migracji Qt6, parametr FREECAD_QT_VERSION powinien być ustawiony na wartość "Auto" (domyślnie) lub jawnie na "5".

dla wersji 0.20_dev oraz 0.21_dev:

Należy pamiętać, że przy przechodzeniu między kompilacją 0.20 i 0.21_dev może być konieczne usunięcie pliku CMakeCache.txt przed uruchomieniem cmake.

<span id="Building_for_a_specific_Python_version">

Kompilacja dla określonej wersji Pythona
Jeśli domyślny plik wykonywalny w Twoim systemie jest dowiązaniem symbolicznym do Pythona 2,  będzie próbował skonfigurować FreeCAD dla tej wersji. Musisz wybrać inną wersję środowiska Python, podając ścieżkę do konkretnego pliku wykonywalnego:

Jeśli to nie zadziała, być może trzeba będzie zdefiniować dodatkowe zmienne wskazujące na żądane biblioteki Python i katalogi include:

Możliwe jest posiadanie kilku niezależnych wersji Python w tym samym systemie, dlatego lokalizacja i numery wersji plików Python będą zależały od konkretnej dystrybucji Linuksa. Użyj, aby wyświetlić wersję Python, której aktualnie używasz. Istotne są tylko dwie pierwsze liczby. Na przykład, jeśli wynikiem jest, musisz podać katalogi, które odnoszą się do wersji 3.6. Jeśli nie znasz odpowiednich katalogów, spróbuj poszukać ich za pomocą polecenia.

Możesz użyć w terminalu, aby określić katalog  lub  dla systemów Debian.

Niektóre komponenty FreeCAD, takie jak PySide, próbują automatycznie wykryć najnowszą wersję Pythona zainstalowaną w systemie, co może się nie udać, jeśli jest ona inna niż podana powyżej. Dodanie następującej opcji cMake może rozwiązać ten problem:

<span id="Building_with_Qt_Creator_against_Python_3_and_Qt5">

Kompilacja za pomocą Qt Creator + Python 3 i Qt5
1. Uruchom Qt Creator.

2. Kliknij przycisk.

3. Przejdź do katalogu, w którym znajduje się kod źródłowy,, i wybierz najwyżej położony plik.

4. Wybranie pliku spowoduje automatyczne uruchomienie na nim programu, ale może się to nie powieść, jeśli odpowiednie opcje nie zostaną poprawnie ustawione.

5. Przejdź do. Ustaw odpowiedni katalog kompilacji,.

6. Ustaw odpowiednie zmienne w oknie dialogowym Key-Value, typu i.

7. Jeżeli zmienne nie załadują projektu poprawnie, być może będziesz musiał przejść do. Następnie naciśnij przycisk i dodaj odpowiednią konfigurację, jak opisano powyżej. Być może trzeba będzie dodać więcej zmiennych dotyczących ścieżek dla środowiska Python, jeśli systemowy Python nie zostanie znaleziony.

7.1. Naciśnij przycisk, a następnie.

7.2. Upewnij się, że pozostałe opcje są prawidłowo ustawione, na przykład powinno być aktualną wersją zainstalowaną w systemie, taką jak.

Naciśnij, a następnie , aby zamknąć konfigurację.

Program powinien ponownie uruchomić się automatycznie i wypełnić całe okno dialogowe Key-Value wszystkimi zmiennymi, które można skonfigurować.

8. Przejdź do i wybierz, aby skompilować graficzną wersję FreeCAD, lub , aby skompilować wersję wiersza poleceń.

9. Na koniec przejdź do menu. Jeśli jest to nowa kompilacja, powinna ona potrwać kilka minut, a nawet godzin, w zależności od liczby dostępnych procesorów.

<span id="Qt_designer_plugin">

Wtyczka Qt designer
Jeśli chcesz opracować kod Qt dla programu FreeCAD, będziesz potrzebował wtyczki Qt Designer, która zapewnia wszystkie niestandardowe widżety programu FreeCAD.

Przejdź do katalogu pomocniczego z kodem źródłowym, uruchom ze wskazanym plikiem projektu, aby utworzyć plik. Mastępnie uruchom, aby skompilować wtyczkę.

Jeśli kompilujesz dla Qt5, upewnij się, że binarka jest tą dla tej wersji, aby wynikowy plik  zawierał niezbędne informacje dla Qt5.

gdzie to katalog, w którym przechowywane są biblioteki binarne Qt, na przykład.

Utworzona biblioteka to, którą należy skopiować do.

<span id="External_or_internal_Pivy">

Pivy zewnętrzne lub wewnętrzne
Wcześniej wersja Pivy była zawarta w kodzie źródłowym FreeCAD (wewnętrznym). Jeśli chcesz użyć systemowej kopii Pivy (zewnętrznej), musisz użyć.

Użycie zewnętrznego Pivy stało się domyślne podczas tworzenia FreeCAD 0.16, dlatego tej opcji nie trzeba już ustawiać samodzielnie.

<span id="Doxygen_documentation">

Dokumentacja Doxygen
Jeśli masz zainstalowany program Doxygen, możesz zbudować dokumentację kodu źródłowego. Przeczytaj stronę dokumentacja dla źródeł, aby uzyskać instrukcje.

<span id="Additional_documentation">

Dokumentacja dodatkowa
Kod źródłowy programu FreeCAD jest bardzo obszerny, a za pomocą CMake można skonfigurować wiele opcji. Nauczenie się pełnego wykorzystania CMake może być przydatne do wybrania odpowiednich opcji dla twoich szczególnych potrzeb.
 * CMake Reference Documentation autorstwa Kitware.
 * How to Build a CMake-Based Project (blog) autorstwa Preshinga na temat programowania.
 * Learn CMake's Scripting Language in 15 Minutes (blog) autorstwa Preshinga na temat programowania.

<span id="Making_a_debian_package">

Tworzenie paczki Debian
Jeśli planujesz zbudować pakiet systemu Debian ze źródeł, musisz najpierw zainstalować wybrane pakiety:

Przejdź do katalogu FreeCAD i wywołaj

Po zbudowaniu pakietu można użyć polecenia, aby sprawdzić, czy pakiet zawiera błędy

<span id="*.deb_package_with_checkinstall">

Pakiety *.deb z checkinstall
Skrypt Debiana pozwala na stworzenie pakietu *.deb, który może być zainstalowany i usunięty za pomocą standardowych poleceń. Może wymagać wcześniejszej instalacji (na Ubuntu użyj ). Jest on interaktywny i pyta o wymagane informacje podając użyteczne domyślne ustawienia. W trakcie procesu pakiet jest instalowany i tworzony jest plik *.deb oraz archiwum zapasowe.

Dobrym pomysłem jest zdefiniowanie nazwy i krótkiego opisu dla pakietu. Nazwa musi być wpisana, aby ponownie go odinstalować, a opis będzie wyszczególniony przez. Domyślna użyta nazwa "build" nie jest zbyt informacyjna.

Przykład:

Wynikiem jest plik *.deb w folderze freecad-build. Skrypt domyślnie zainstaluje ten build. W ten sposób można go zainstalować lub odinstalować:

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">

Aktualizacja kodu źródłowego
System CMake pozwala na inteligentne aktualizowanie kodu źródłowego i rekompilowanie tylko tego, co uległo zmianie, dzięki czemu kolejne kompilacje przebiegają szybciej.

Przejdź do lokalizacji, w której po raz pierwszy został pobrany kod źródłowy programu FreeCAD, i pobierz nowy kod:

Następnie należy przejść do katalogu build, w którym kod został pierwotnie skompilowany, i uruchomić, podając obecny katalog (oznaczony kropką). Po czym wywołać ponowną kompilację za pomocą.

<span id="Uninstalling_the_source_code">

Odinstalowanie kodu źródłowego
W przypadku, gdy skompilowany kod źródłowy został zainstalowany za pomocą polecenia (dla dystrybucji Debian) pliki zostały skopiowane do folderu  w kilku podfolderach. Do deinstalacji można użyć pliku. Został on utworzony w folderze build podczas kompilacji i zawiera wszystkie zainstalowane pliki. Tak długo jak ten plik istnieje, pakiet może zostać odinstalowany.

Rozwiązywanie problemów
<span id="For_64_bit_systems">

W systemach 64bit
Podczas kompilacji programu FreeCAD dla 64-bitów występuje znany problem z 64-bitowym pakietem OpenCASCADE (OCCT). Aby FreeCAD działał poprawnie, może być konieczne uruchomienie skryptu i ustawienie dodatkowych :

W systemach opartych na Debianie opcja ta nie jest potrzebna, gdy używamy gotowych pakietów OpenCASCADE, ponieważ te ustawiają wewnętrznie właściwe.

<span id="Automatic_build_scripts">

Skrypty automatycznej kompilacji
Tutaj znajdziesz wszystko, czego potrzebujesz, aby zbudować kompletny program FreeCAD. Jest to podejście oparte na jednym skrypcie i działa na świeżo zainstalowanej dystrybucji Linuksa. Polecenia poproszą o podanie hasła roota w celu zainstalowania pakietów i nowych repozytoriów online. Skrypty te powinny działać w wersjach 32- i 64-bitowych. Zostały napisane dla różnych wersji, ale prawdopodobnie będą działać także na nowszych wersjach z większymi zmianami lub bez nich.

Jeśli masz taki skrypt dla swojej preferowanej dystrybucji, omów go na forum FreeCAD, abyśmy mogli go uwzględnić.

Ubuntu
Skrypty te zapewniają niezawodny sposób na zainstalowanie prawidłowego zestawu zależności wymaganych do zbudowania i uruchomienia programu FreeCAD w systemie Ubuntu. Wykorzystują one osobiste archiwa pakietów Ubuntu (PPA) i powinny działać na każdej wersji Ubuntu, dla której przeznaczone jest PPA. Wersja freecad-daily PPA jest przeznaczona dla najnowszych wersji Ubuntu, podczas gdy freecad-stable PPA jest przeznaczone dla oficjalnie wspieranych wersji Ubuntu.

Ten skrypt instaluje codziennie kompilowaną wersję FreeCAD i jego zależności. Dodaje codzienne repozytorium, pobiera zależności potrzebne do zbudowania tej wersji i instaluje wymagane pakiety. Następnie zaciąga kod źródłowy do określonego katalogu, tworzy katalog build i wprowadza do niego zmiany, konfiguruje środowisko kompilacji za pomocą, a na koniec buduje cały program za pomocą. Zapisz skrypt do pliku, uczyń go wykonywalnym i uruchom go, ale nie używaj. Uprawnienia superużytkownika będą wymagane tylko dla wybranych poleceń.

Jeśli chcesz, możesz odinstalować prekompilowaną wersję programu FreeCAD, pozostawiając zależności na miejscu, jednak pozostawienie zainstalowanego pakietu pozwoli menedżerowi pakietów na aktualizowanie jego zależności. Jest to szczególnie przydatne, jeśli zamierzasz śledzić rozwój programu FreeCAD i stale aktualizować oraz kompilować źródła z repozytorium Git.

Poprzedni skrypt zakłada, że chcesz skompilować najnowszą wersję programu FreeCAD, więc używasz "codziennego" repozytorium, aby uzyskać zależności. Zamiast tego możesz jednak pobrać zależności kompilacji ze "stabilnej" wersji dla aktualnego wydania Ubuntu. W takim przypadku należy zastąpić górną część poprzedniego skryptu następującymi instrukcjami. W przypadku Ubuntu 12.04 należy pominąć w poleceniu.

Po zainstalowaniu pakietu z repozytorium, zastąpi on plik wykonywalny FreeCAD, który jest dostępny w repozytorium Universe Ubuntu. Plik wykonywalny będzie się nazywał po prostu, a nie.

openSUSE
Do kompilacji programu FreeCAD nie są potrzebne żadne zewnętrzne repozytoria. Istnieje jednak niezgodność z python3-devel, która musi zostać usunięta. FreeCAD może być skompilowany z GIT.

Ponieważ używasz Git, następnym razem, gdy będziesz chciał skompilować, nie musisz wszystkiego klonować, wystarczy, pobierzesz i skompilujesz ponownie:

<span id="Debian_Squeeze">

Debian Squeeze
<span id="Fedora_27/28/29">

Fedora 27/28/29
Wysłane przez użytkownika [PrzemoF] na forum.

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

<span id="Arch_using_AUR">

Arch using AUR
Arch User Repository (AUR) to zbiór stworzonych przez użytkowników receptur do kompilacji pakietów, które nie są oficjalnie wspierane przez opiekunów dystrybucji / społeczność. Zazwyczaj są one bezpieczne. Możesz zobaczyć kto i jak długo opiekował się danym pakietem. Zalecane jest sprawdzenie plików konstrukcyjnych. W tym obszarze dostępne jest także oprogramowanie nie będące oprogramowaniem open source, nawet jeśli jest utrzymywane przez oficjalną firmę będącą właścicielem.

Wymagania wstępne: Git

Kroki do wykonania:
 * 1) Otwórz terminal. Opcjonalnie utwórz katalog, np. . Opcjonalnie zmień katalog np..
 * 2) Sklonuj repozytorium AUR :.
 * 3) Wejdź do katalogu repozytorium AUR :.
 * 4) Kompiluj używając Arch makepkg : . Flaga -s lub --syncdeps zainstaluje również wymagane zależności.
 * 5) Instaluj utworzony pakiet: lub kliknij dwukrotnie na pkgname-pkgver.pkg.tar.xz w przeglądarce plików.

Aby zaktualizować FreeCAD do najnowszej wersji, powtórz kroki z punktu 3. Zaktualizuj repo AUR, gdy w przepisie pojawią się jakieś zmiany lub nowe funkcje, używając wewnątrz folderu.