Compile on Docker/pl

Informacje ogólne
Wśród opcji kompilacji i instalacji FreeCAD istnieje możliwość użycia Dockera. Ta metoda jest przydatna przede wszystkim dla programistów FreeCAD korzystających z komputerów z systemem Linux lub Mac OS.

Korzyści
Wszystkie zależności FreeCAD są już zainstalowane, kompatybilne ze sobą i odpowiednio skonfigurowane, co pozwala na bardzo szybkie rozpoczęcie programowania.
 * Zależności są zawarte w kontenerze docker, co zapobiega zanieczyszczeniu stacji roboczej niechcianymi pakietami i kolizji wersji.
 * Kod źródłowy i katalogi kompilacji znajdują się poza kontenerem docker. Pozwala to na korzystanie z preferowanych edytorów, systemów wersjonowania, narzędzi deweloperskich itp. bez konieczności konfigurowania ich w kontenerze docker. Możesz po prostu używać ich normalnie, bezpośrednio ze stacji roboczej. (Oznacza to również, że nie musisz odbudowywać kontenera docker za każdym razem, gdy chcesz skompilować FreeCAD).
 * Dla tych, którzy używają niejasnych dystrybucji *nix i instrukcje nie są dostępne do pobierania zależności, wszystko, co musisz zainstalować na swojej stacji roboczej, to docker, który jest dość powszechnie dostępny w wielu dystrybucjach.
 * Zapewnia on statyczne, niezmienne środowisko programistyczne. Osobiście uważam to za przydatne podczas programowania, aby zmniejszyć liczbę potencjalnych zmiennych, które mogą powodować problemy. Wiesz, że nie zmieniłeś czegoś ezoterycznego w środowisku między kompilacjami. W przypadku deweloperów współpracujących ze sobą i korzystających z tego samego kontenera docker, można mieć pewność, że obaj pracują w tym samym środowisku, co zmniejsza liczbę błędów komunikacyjnych spowodowanych różnicami w środowisku.



Repozytorium Docker

 * Oryginał: https://gitlab.com/daviddaish/freecad_docker_env
 * Oficjalny: https://GitHub.com/FreeCAD/Docker

Wymagania wstępne

 * 10 GB wolnej przestrzeni dyskowej.
 * Docker.

Instalacja


Pobieranie źródła
Najlepszym sposobem na uzyskanie kodu źródłowego FreeCAD jest sklonowanie repozytorium Git. W tym celu potrzebny jest program, który można łatwo zainstalować w większości dystrybucji systemów Linux i Mac OS, a także można go uzyskać z oficjalnej strony internetowej Git.

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ódła
Alternatively you can download the source as an archive, a or  file, and unpack it in the desired directory.



Utwórz katalog kompilacji
Utwórz katalog do przechowywania skompilowanego źródła FreeCAD.



Ściągnij obraz Docker
Ściągnij obraz Docker. (Oficjalny obraz wkrótce).



Zezwól na dostęp do menedżera okien
Aby FreeCAD mógł uruchomić swój graficzny interfejs użytkownika z poziomu kontenera Docker, należy nadać Dockerowi uprawnienia dostępu do menedżera okien. W większości dystrybucji Linuksa jest to system okien X. Możesz użyć poniższego polecenia, aby zezwolić Dockerowi na dostęp do X, aż do ponownego uruchomienia lub wylogowania komputera.

Jeśli jesteś połączony z niezaufanymi systemami, na przykład przez, sprawi to, że będziesz podatny na złośliwy kod. Zamknij wszystkie połączenia lub sprawdź bezpieczniejsze uprawnienia xhost, co wykracza poza zakres tego samouczka.



Użytkownicy systemu Mac OS
Dla tych, którzy używają Mac OS, system okien X może nie być zainstalowany. Projekt XQuartz to długo działający projekt open source, który pozwoli ci dodać go do twojego komputera. Można go znaleźć na stronie domowej.



Uruchomienie obrazu docker
Przypisz zmienne środowiskowe, aby kontener Docker zamontował kod źródłowy FreeCAD i katalog kompilacji. Ponadto możesz zamontować dodatkowy katalog zawierający dowolne pliki, których chcesz użyć do celów testowych. W poniższym fragmencie pozostawiliśmy go jako katalog domowy jako proste ustawienie domyślne.

Uruchom obraz Docker.



Kompilacja FreeCAD
Możesz zbudować FreeCAD za pomocą zainstalowanego skryptu kompilacji lub przy użyciu preferowanej metody.



Uruchomienie FreeCAD
Po zbudowaniu FreeCAD można go uruchomić w normalny sposób.

Dołączone katalogi można znaleźć w katalogu.

Dyskusja

 * Kontener kompilacji środowiska Docker
 * Konfiguracja VSCode z Dockerem (1)
 * Konfiguracja VSCode z Dockerem (2)

Powiązane

 * AppImage