Compile on Docker/pl: Difference between revisions

From FreeCAD Documentation
(Updating to match new version of source page)
(Created page with "{{Docnav/pl |Kompilacja w systemie MacOS |Docker dla FreeCAD tryb CLI }}")
 
(37 intermediate revisions by the same user not shown)
Line 2: Line 2:
{{UnfinishedDocu{{#translation:}}}}
{{UnfinishedDocu{{#translation:}}}}


{{Docnav
{{Docnav/pl
|[[Compile_on_MacOS|Compile on MacOS]]
|[[Compile_on_MacOS/pl|Kompilacja w systemie MacOS]]
|[[FreeCAD_Docker_CLI_mode|FreeCAD Docker CLI mode]]
|[[FreeCAD_Docker_CLI_mode/pl|Docker dla FreeCAD tryb CLI]]
}}
}}


{{TOCright}}
{{TOCright}}


==Overview==
<span id="Overview"></span>
==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.
Among the options for building and installing FreeCAD, there is the option of using Docker. This method is primarily useful for FreeCAD developers, using Linux or Mac OS computers.


===Benefits===
<span id="Benefits"></span>
===Korzyści===


Wszystkie zależności FreeCAD są już zainstalowane, kompatybilne ze sobą i odpowiednio skonfigurowane, co pozwala na bardzo szybkie rozpoczęcie programowania.
All of FreeCAD's dependencies are already installed, compatible with each other, and configured appropriately, allowing you to get started developing very quickly.
* Zależności są zawarte w kontenerze docker, co zapobiega zanieczyszczeniu stacji roboczej niechcianymi pakietami i kolizji wersji.
* The dependencies are contained within the docker container, preventing any unwanted packages contaminating your workstation, and preventing any clashing versions.
* 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)''.
* The source code and build directories are outside the docker container. This allows you to use your preferred editors, versioning systems, dev tools etc, without having to set them up in the docker container. You can just use them as normal, right from your workstation. (Also, it means you don't have to rebuild the docker container each time you want to build FreeCAD.)
* For those using obscure *nix distros and [[Compile_on_Linux#Getting_the_dependencies|instructions are not available]] for fetching dependencies, all you need to install on your workstation is docker, which is quite commonly available across many distributions.
* Dla tych, którzy używają niejasnych dystrybucji *nix i [[Compile_on_Linux/pl#Pobranie_zależności|instrukcje nie 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.
* It provides a static, immutable development environment. I personally find this useful when developing to reduce the number of potential variables that could be causing an issue. You know you've not altered something esoteric in the environment between builds. For developers collaborating, and both using the same docker container, you can be sure you're both working from the same environment, which reduces communication errors caused by differences in environment.


<span id="Docker_Repository"></span>
==Docker Repository==
==Repozytorium Docker==


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


==Prerequisites==
<span id="Prerequisites"></span>
==Wymagania wstępne==


* 10 GB wolnej przestrzeni dyskowej.
* 10GB of free storage
* Docker
* Docker.


==Installation==
<span id="Installation"></span>
==Instalacja==


<span id="Download_the_source"></span>
===Download the source===
===Pobieranie źródła===


The best way to get FreeCAD's source code is to clone the [https://github.com/FreeCAD/FreeCAD Git repository]. For this you need the {{incode|git}} program which can be easily installed in most Linux and Mac OS distributions, and it can also be obtained from the [http://git-scm.com/ official website].
Najlepszym sposobem na uzyskanie kodu źródłowego FreeCAD jest sklonowanie repozytorium [https://github.com/FreeCAD/FreeCAD Git]. W tym celu potrzebny jest program {{incode|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 [http://git-scm.com/ oficjalnej strony internetowej Git].


This will place a copy of the latest version of the FreeCAD source code in a new directory called {{incode|freecad_source}}.
Poniższe polecenie umieści kopię najnowszej wersji kodu źródłowego programu FreeCAD w nowym katalogu o nazwie {{incode|freecad-source}}.


{{Code|lang=bash|code=
{{Code|lang=bash|code=
Line 43: Line 49:
}}
}}


Więcej informacji na temat używania środowiska Git i wnoszenia kodu do projektu można znaleźć na stronie [[Source_code_management/pl|Zarządzanie kodem źródłowym]].
For more information on using Git, and contributing code to the project, see [[Source code management|Source code management]].


==== Source archive ====
====Archiwum źródła====
Alternatively you can download the source as an [https://github.com/FreeCAD/FreeCAD/releases/latest archive], a {{incode|.zip}} or {{incode|.tar.gz}} file, and unpack it in the desired directory.
Alternatively you can download the source as an [https://github.com/FreeCAD/FreeCAD/releases/latest archive], a {{incode|.zip}} or {{incode|.tar.gz}} file, and unpack it in the desired directory.


<span id="Create_build_directory"></span>
===Create build directory===
===Utwórz katalog kompilacji===


Utwórz katalog do przechowywania skompilowanego źródła FreeCAD.
Create a directory to hold your compiled FreeCAD source.


{{Code|lang=bash|code=
{{Code|lang=bash|code=
Line 56: Line 63:
}}
}}


<span id="Pull_Docker_image"></span>
===Pull Docker image===
===Ściągnij obraz Docker===


Pull the Docker image. (Official image coming soon.)
Ściągnij obraz Docker. ''(Oficjalny obraz wkrótce)''.


{{Code|lang=bash|code=
{{Code|lang=bash|code=
Line 64: Line 72:
}}
}}


<span id="Allow_access_to_your_window_manager"></span>
===Allow access to your window manager===
==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.
In order for FreeCAD to launch it's GUI from within the Docker container, you need to give Docker access permissions to your window manager. In most Linux distributions, this is the X window system. You can use the below command to allow blanket access to X, until you reboot or logoff your computer.


{{Code|lang=bash|code=
{{Code|lang=bash|code=
Line 72: Line 81:
}}
}}


If you're connected to any untrusted systems, such as via {{incode|ssh}}, this will make you vulnerable to malicious code. Either close any {{incode|ssh}} connections, or look into more secure xhost permissions, which is outside the scope of this tutorial.
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].
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. [https://www.xquartz.org/ Można go znaleźć na stronie domowej].


<span id="Launch_the_docker_image"></span>
===Launch the docker image===
===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.
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.


{{Code|lang=bash|code=
{{Code|lang=bash|code=
Line 88: Line 99:
}}
}}


Launch the Docker image.
Uruchom obraz Docker.


{{Code|lang=bash|code=
{{Code|lang=bash|code=
Line 99: Line 110:
}}
}}


<span id="Build_FreeCAD"></span>
===Build FreeCAD===
===Kompilacja FreeCAD===


Możesz zbudować FreeCAD za pomocą zainstalowanego skryptu kompilacji lub przy użyciu preferowanej metody.
You can build FreeCAD using the installed build script, or using your preferred method.


{{Code|lang=bash|code=
{{Code|lang=bash|code=
Line 107: Line 119:
}}
}}


<span id="Run_FreeCAD"></span>
===Run FreeCAD===
===Uruchomienie FreeCAD===


Po zbudowaniu FreeCAD można go uruchomić w normalny sposób.
Once FreeCAD has been built, it can be run as normal.


{{Code|lang=bash|code=
{{Code|lang=bash|code=
Line 115: Line 128:
}}
}}


You can find the attached directories in the {{incode|/mnt}} directory.
Dołączone katalogi można znaleźć w katalogu {{incode|/mnt}}.


==Discussion==
<span id="Discussion"></span>
==Dyskusja==


* [https://forum.freecadweb.org/viewtopic.php?f=4&t=42954 Docker env build container]
* [https://forum.freecadweb.org/viewtopic.php?f=4&t=42954 Kontener kompilacji środowiska Docker]
* [https://forum.freecadweb.org/viewtopic.php?f=10&t=48266 VSCode setup with Docker (1)]
* [https://forum.freecadweb.org/viewtopic.php?f=10&t=48266 Konfiguracja VSCode z Dockerem (1)]
* [https://forum.freecadweb.org/viewtopic.php?p=427812#p427812 VSCode setup with Docker (2)]
* [https://forum.freecadweb.org/viewtopic.php?p=427812#p427812 Konfiguracja VSCode z Dockerem (2)]


==Related==
<span id="Related"></span>
==Powiązane==


* [[AppImage]]
* [[AppImage/pl|AppImage]]




{{Docnav
{{Docnav/pl
|[[Compile_on_MacOS|Compile on MacOS]]
|[[Compile_on_MacOS/pl|Kompilacja w systemie MacOS]]
|[[FreeCAD_Docker_CLI_mode|FreeCAD Docker CLI mode]]
|[[FreeCAD_Docker_CLI_mode/pl|Docker dla FreeCAD tryb CLI]]
}}
}}



Latest revision as of 18:19, 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

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

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.

fc_source=~/my_code/freecad_source
fc_build=~/my_code/freecad_build
other_files=~/

Uruchom obraz Docker.

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

Kompilacja FreeCAD

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

/root/build_script.sh

Uruchomienie FreeCAD

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

/mnt/build/bin/FreeCAD

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

Dyskusja

Powiązane