Compile on Docker/pl: Difference between revisions
(Created page with "Jeśli jesteś połączony z niezaufanymi systemami, na przykład przez {{incode|ssh}}, sprawi to, że będziesz podatny na złośliwy kod. Zamknij wszystkie połączenia {{incode|ssh}} lub sprawdź bezpieczniejsze uprawnienia xhost, co wykracza poza zakres tego samouczka.") |
(Created page with "====Użytkownicy systemu Mac OS====") |
||
Line 83: | Line 83: | ||
Jeśli jesteś połączony z niezaufanymi systemami, na przykład przez {{incode|ssh}}, sprawi to, że będziesz podatny na złośliwy kod. Zamknij wszystkie połączenia {{incode|ssh}} lub sprawdź bezpieczniejsze uprawnienia xhost, co wykracza poza zakres tego samouczka. |
Jeśli jesteś połączony z niezaufanymi systemami, na przykład przez {{incode|ssh}}, sprawi to, że będziesz podatny na złośliwy kod. Zamknij wszystkie połączenia {{incode|ssh}} lub sprawdź bezpieczniejsze uprawnienia xhost, co wykracza poza zakres tego samouczka. |
||
<span id="Mac_OS_users"></span> |
|||
====Mac OS users==== |
|||
====Użytkownicy systemu Mac OS==== |
|||
For those using Mac OS, the X window system may not be installed. The XQuartz project is a long running open source project that will allow you to add it to your computer. [https://www.xquartz.org/ You can find it here]. |
For those using Mac OS, the X window system may not be installed. The XQuartz project is a long running open source project that will allow you to add it to your computer. [https://www.xquartz.org/ You can find it here]. |
Revision as of 18:06, 18 November 2023
Ta dokumentacja nie jest ukończona. Prosimy o pomoc w tworzeniu dokumentacji.
Strona Model polecenia GUI wyjaśnia jak powinny być dokumentowane polecenia. Przejrzyj stronę Category:UnfinishedDocu, aby zobaczyć więcej niekompletnych stron, takich jak ta. Zobacz stronę Category:Command Reference aby poznać wszystkie komendy.
Zobacz stronę wytycznych Wikidla FreeCAD aby dowiedzieć się, jak edytować strony Wiki, i przejdź do strony Pomóż w rozwoju FreeCAD, aby dowiedzieć się o innych sposobach, w jakie możesz wnieść swój wkład.
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 git
, 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 freecad-source
.
git clone https://github.com/FreeCAD/FreeCAD.git ~/my_code/freecad_source
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 .zip
or .tar.gz
file, and unpack it in the desired directory.
Utwórz katalog kompilacji
Utwórz katalog do przechowywania skompilowanego źródła FreeCAD.
mkdir ~/my_code/freecad_build
Ściągnij obraz Docker
Ściągnij obraz Docker. (Oficjalny obraz wkrótce).
docker pull registry.gitlab.com/daviddaish/freecad_docker_env:latest
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.
xhost +
Jeśli jesteś połączony z niezaufanymi systemami, na przykład przez ssh
, sprawi to, że będziesz podatny na złośliwy kod. Zamknij wszystkie połączenia ssh
lub sprawdź bezpieczniejsze uprawnienia xhost, co wykracza poza zakres tego samouczka.
Użytkownicy systemu Mac OS
For those using Mac OS, the X window system may not be installed. The XQuartz project is a long running open source project that will allow you to add it to your computer. You can find it here.
Launch the docker image
Assign environment variables so the Docker container will mount FreeCAD's source code, and build directory. In addition, you can mount an extra directory to contain any files you'd like to use for testing purposes. In the below snippet, we've left it as your home directory as a simple default.
fc_source=~/my_code/freecad_source
fc_build=~/my_code/freecad_build
other_files=~/
Launch the Docker image.
docker run -it --rm \
-v $fc_source:/mnt/source \
-v $fc_build:/mnt/build \
-v $other_files:/mnt/files \
-e "DISPLAY" -e "QT_X11_NO_MITSHM=1" -v /tmp/.X11-unix:/tmp/.X11-unix:ro \
registry.gitlab.com/daviddaish/freecad_docker_env:latest
Build FreeCAD
You can build FreeCAD using the installed build script, or using your preferred method.
/root/build_script.sh
Run FreeCAD
Once FreeCAD has been built, it can be run as normal.
/mnt/build/bin/FreeCAD
You can find the attached directories in the /mnt
directory.
Discussion
Related
- Jak zacząć
- Instalacja: Pobieranie programu, Windows, Linux, Mac, Dodatkowych komponentów, Docker, AppImage, Ubuntu Snap
- Podstawy: Informacje na temat FreeCAD, Interfejs użytkownika, Profil nawigacji myszką, Metody wyboru, Nazwa obiektu, Edytor ustawień, Środowiska pracy, Struktura dokumentu, Właściwości, Pomóż w rozwoju FreeCAD, Dotacje
- Pomoc: Poradniki, Wideo poradniki
- Środowiska pracy: Strona Startowa, Architektura, Assembly, CAM, Rysunek Roboczy, MES, Inspekcja, Siatka, OpenSCAD, Część, Projekt Części, Punkty, Inżynieria Wsteczna, Robot, Szkicownik, Arkusz Kalkulacyjny, Powierzchnia 3D, Rysunek Techniczny, Test Framework